leak_test/leak_test_project/Manual/03_메인_화면.md

# 3. 메인 화면 (Home View)

[← 메뉴얼 목차로 돌아가기](사용자_메뉴얼.md)

---

프로그램 실행 시 기본으로 표시되는 화면입니다. 좌/우 채널의 누설 시험 결과를 실시간으로 모니터링합니다.

## 3.1 전체 화면 레이아웃
![[Pasted image 20260626093617.png]]


---

## 3.2 상단 타이틀 바

프로그램 최상단에 위치한 타이틀 영역입니다.
![[Pasted image 20260626093648.png]]

| 위치 | 요소 | 설명 |
|------|------|------|
| 좌측 | **프로그램 제목 & 버전** | `Pressure Leak System` 및 버전 정보 표시 |
| 중앙 | **현재 날짜/시간** | `yyyy-MM-dd [요일] HH:mm:ss` 형식, 1초 주기로 실시간 갱신 |
| 우측 | **작업 정보 배지** | 현재 로그인된 `작업자 ID`, `검사 모델`, `생산 라인` 정보 표시 |
| 우측 | **로그아웃 버튼** | 현재 세션을 로그아웃하고 로그인 창을 호출합니다 |
| 최우측 | **창 제어 버튼** | 최소화(─) / 최대화·복원(□) / 종료(X) 창 제어 아이콘 |

### 타이틀 바 조작

| 조작 | 동작 |
|------|------|
| 타이틀 바 **드래그** | 창 이동 |
| 타이틀 바 **더블 클릭** | 최대화 ↔ 일반 크기 전환 |
| **─** 버튼 클릭 | 작업표시줄로 최소화 |
| **□** 버튼 클릭 | 최대화 ↔ 일반 크기 전환 |
| **X** 버튼 클릭 | 종료 확인 대화상자 표시 → "예" 선택 시 종료 |

---

## 3.3 메인 영역 - 채널 모니터링

화면은 좌측(`LEFT LEAK TESTER`)과 우측(`RIGHT LEAK TESTER`)으로 균등 분할되며, 각 채널은 동일한 구조입니다.
![[Pasted image 20260626093712.png]]

### 각 채널의 구성 요소 (위에서 아래 순서)

#### ① 채널 타이틀
- **LEFT LEAK TESTER** 또는 **RIGHT LEAK TESTER** 채널 구분을 명시합니다.

#### ② 시작/종료 시간
| 항목 | 설명 |
|------|------|
| 라벨 | `시작/종료` |
| 값 | `시작시간 / 종료시간` 형식 (예: `2026-05-08 10:30:15 / -` 또는 `2026-05-08 10:30:15 / 10:30:45`) |
| 갱신 시점 | 시험이 시작될 때 `시작시간 / -` 형태로 갱신되며, 시험 완료(DB 저장) 시점에 종료 시간이 기록됩니다. |

#### ③ IC_SN / PCB_Barcode
| 항목 | 설명 |
|------|------|
| 라벨 | `IC_SN` / `PCB_Barcode` |
| 값 | 제품의 IC 일련번호 및 이에 매핑되는 PCB 바코드 고유 식별 정보 |
| 데이터 소스 | **IC_SN**: 4251 보드로 제품 ID 센서에서 판독한 값<br>**PCB_Barcode**: 판독한 `IC_SN`을 기준으로 데이터베이스에서 조회한 바코드 값 |
| 갱신 시점 | 시험 시작 시 빈 값(`-`)으로 초기화, 판독 및 조회 완료 시 표시 |

> **참고**: IC_SN과 PCB_Barcode를 별도의 행으로 나누어 표시합니다.

#### ④ 측정값 + SPEC
좌측에 측정값, 우측에 SPEC 규격이 함께 표시됩니다.

**측정값 영역:**

| 항목 | 설명 |
|------|------|
| 라벨 | `측정값` |
| 값 | Sentinel C28에서 수신한 누설량 (소수점 4자리, 예: `0.5234`) |
| 단위 | `sccm` (우측 하단에 표시) |
| 갱신 시점 | C28 센서 스트리밍 데이터 수신 시 실시간 갱신 |

**SPEC 영역 (우측):**

| 항목 | 설명 |
|------|------|
| `UL` | 상한 규격값 (예: `1.00`) |
| `LL` | 하한 규격값 (예: `-1.00`) |
| 갱신 시점 | Parameters에서 저장 시 즉시 반영 |

#### ⑤ 판정

| 항목 | 설명 |
|------|------|
| 라벨 | `판정` |
| 값 | **OK** 또는 **NG** |

> **판정 기준**: `SPEC LL ≤ 측정값 ≤ SPEC UL` → **OK**, 그 외 → **NG**

#### ⑥ 진행 메시지

| 항목 | 설명 |
|------|------|
| 라벨 | `진행 메시지` |
| 값 | 현재 시험 단계 메시지 표시 |

표시되는 메시지 목록:

| 메시지 | 의미 |
|--------|------|
| `시험 시작` | DIO 시작 신호 감지, 시험 프로세스 시작 |
| `대기중` | 다른 채널이 시험 중이어서 순서 대기 |
| `센서 정보 읽는 중` | 4251 보드를 통해 제품 ID 판독 중 |
| `LEAK 시험중` | Sentinel C28 센서의 측정 결과 대기 중 |
| `시험 완료` | 판정 완료 및 결과 출력 완료 |
| `오류 발생` | 시험 중 오류 발생 (상세 내용은 오류 메시지 참조) |
| `ID 테스트 완료` | 수동 ID 테스트 정상 완료 |
| `ID 테스트 실패` | 수동 ID 테스트 실패 |
| `통신 대기 중` | 통신 설정 변경 후 재연결 대기 |

#### ⑦ 오류 메시지

| 항목 | 설명 |
|------|------|
| 라벨 | `오류 메시지` |
| 값 | 발생한 오류 상세 내용 표시 |
| 초기화 시점 | 새 시험 시작 시 자동 초기화 |

---

## 3.4 SPEC 교차 검증 경고

프로그램의 판정 결과(SPEC UL/LL 기준)와 Sentinel C28 센서의 자체 판정 결과가 서로 다를 경우:

1. 해당 채널의 **오류 메시지** 영역에 `SPEC 불일치 - 프로그램: OK, 센서: NG` 등의 메시지가 표시됩니다.
2. **팝업 경고 대화상자**가 표시됩니다: "프로그램 스팩과 센서의 스팩이 서로 맞지 않습니다."

> **조치**: 센서 측의 SPEC 설정과 프로그램의 SPEC UL/LL 설정이 동일한지 확인하세요. (통신설정 참조)

---

## 3.5 하단 메뉴 바

프로그램 하단 메뉴 영역입니다. 5개의 버튼이 수평으로 배치됩니다.
![[Pasted image 20260624104445.png]]

| 순서 | BUTTON | 부제 | 동작 | 동작 방식 |
|------|------------|------|------|----------|
| 1 | **Data** | (측정 데이터) | 검사 기록 조회 화면 전환 | 토글 (다시 클릭 시 Home으로 복귀) |
| 2 | **Parameters** | (시험 설정) | 시험 설정 팝업 창 열기 | 모달 팝업 (설정 후 자동 닫힘) |
| 3 | **Comm. Settings** | (통신 설정) | 통신 설정 팝업 창 열기 | 모달 팝업 (설정 후 자동 닫힘) |
| 4 | **ID Test (L)** | (좌측 ID 테스트) | 좌측 채널 센서 ID 수동 판독 | 즉시 실행 |
| 5 | **ID Test (R)** | (우측 ID 테스트) | 우측 채널 센서 ID 수동 판독 | 즉시 실행 |

---

[← 이전: 초기 설정](02_초기_설정.md) | [다음: 통신 설정 →](04_통신_설정.md)