leak_test/leak_test_project/Manual/HomeView_Manual.md

Leak Tester 메인 화면 (HomeView) 사용 설명서

본 문서는 Leak Tester 애플리케이션의 메인 실시간 모니터링 화면인 HomeView의 모든 기능과 인터페이스 구성 요소에 대해 상세히 설명합니다.

---

1. 개요 (Overview)

HomeView는 좌측(LEFT)과 우측(RIGHT) 두 개의 독립적인 채널로 구성되어 있으며, 각 채널은 동일한 구조의 실시간 데이터 필드와 판정 결과를 제공합니다.

---

2. 화면 구성 요소 (Component Details)

A. 타이틀 바 (Title Bar)

• 명칭: LEFT LEAK TESTER / RIGHT LEAK TESTER
• 기능: 현재 모니터링 중인 채널의 위치를 나타냅니다. 짙은 회색(#34495E) 배경에 흰색 굵은 텍스트로 강조되어 있습니다.

B. 실시간 데이터 필드 (Real-time Data Fields)

시험 공정과 관련된 핵심 정보가 표시되는 영역입니다.

1. 시작 시간 (Start Time)
   • 시험이 시작된 정확한 시각(HH:mm:ss)을 표시합니다.
2. ID (Sensor ID)
   • ZMDI 센서로부터 읽어온 상위 ID 값입니다.
3. LOW ID
   • ZMDI 센서로부터 읽어온 하위 상세 ID 값입니다. (개별 구분을 위해 ID와 분리하여 표시)
4. DATE
   • 하드웨어 센서 내부에 기록된 제조 또는 검사 날짜 정보입니다.
5. SERIAL (Serial Number)
   • 제품의 고유 일련번호를 나타냅니다.
6. MC/LINE
   • 장비가 가동 중인 호기 또는 라인 번호를 표시합니다.
7. ITEM
   • 현재 검사 중인 제품의 항목이나 모델명을 나타냅니다.

C. 측정 및 스펙 영역 (Measurement & SPEC)

실질적인 누설량 데이터가 표시되는 핵심 영역입니다.

• 측정값 (Measured Value):
  • 중앙에 가장 크게 표시되는 숫자로, 실시간 누설량(sccm 단위)을 나타냅니다.
  • 가독성을 위해 고대비 블루 계열(#2980B9) 폰트가 적용되었습니다.
• SPEC (스펙 설정값):
  • UL (Upper Limit): 누설량의 상한치입니다. 측정값이 이 값보다 크면 NG 판정됩니다.
  • LL (Lower Limit): 누설량의 하한치입니다. (일반적으로 -1.00 등으로 설정)

D. 판정 영역 (Judgment Area)

검사 결과에 따라 전체 배경색과 텍스트가 다이내믹하게 변화합니다.

• OK (Pass): 초록색(#27AE60) 배경과 텍스트로 표시됩니다. 공정 결과가 정상(Pass)임을 의미합니다.
• NG (Fail): 빨간색(#C0392B) 배경과 텍스트로 표시됩니다. 공정 결과가 불량(Fail)이거나 기준치(SPEC)를 벗어났음을 의미합니다.

E. 메시지 영역 (Message System)

1. 진행 메시지 (Status Message)
   • 현재 시험의 진행 단계(시작 대기, 센서 정보 읽는 중, LEAK 시험중, 시험 완료 등)를 파란색으로 표시합니다.
2. 오류 메시지 (Error Message)
   • 통신 실패, 센서 데이터 길이 부족 등 비정상 상황 발생 시 상세한 원인을 빨간색으로 표시합니다.

---

3. 주요 자동화 프로세스

1. 시작 신호 대기: 하드웨어 I/O(LEFT_START 등) 신호 입력을 감지하면 시험이 자동으로 시작됩니다.
2. ZMDI 센서 판독: 시험 시작 직후 시리얼 통신을 통해 센서의 고유 ID 및 제조 정보를 읽어옵니다.
3. LEAK 시험 실행: Sentinel C28 기기와 연동하여 누설 데이터를 수신합니다.
4. 결과 기록: 판정 완료와 동시에 내부 로그 파일 및 DB(CSV)로 데이터가 자동 저장됩니다.
5. I/O 출력: 판정에 따라 하드웨어 램프(OK/NG) 신호를 제어합니다.

---

4. UI 특징 (Design Philosophy)

• 반응형 레이아웃: 공정 순서에 따라 시선이 상단(정보 확인) -> 중앙(측정값) -> 하단(판정 결과)으로 자연스럽게 흐르도록 설계되었습니다.
• 상태 기반 색상 변화: 판정 결과와 진행 상태에 따라 UI 색상이 변화하여 작업자가 멀리서도 상태를 즉각 파악할 수 있습니다.
• 고해상도 텍스트: 핵심 데이터인 측정값과 판정 결과는 특수 폰트 크기를 적용하여 시인성을 극대화했습니다.

---

본 메뉴얼은 Leak Tester 시스템의 V1.0 기준으로 작성되었습니다.