marking_gui/program_flow.md

양산형 테스트 기기 모니터링 시스템 사용자 설명서 (User Manual)

본 문서는 양산형 테스트 기기 모니터링 시스템을 사용하는 작업자 및 검사자를 위한 운영 설명서입니다. 프로그램의 시작부터 제품 조회, 성능 검사 수행, 판정 기준 설정까지 내부 프로그램 코드를 몰라도 누구나 쉽게 작동법을 이해할 수 있도록 사용자 화면 관점에서 기술되었습니다.

---

1. 시스템 개요 (Introduction)

본 시스템은 제조 라인의 최종 단계에서 제품의 전기적 성능(측정 전압 및 전류)을 검사하고 최종 합격/불합격 여부를 판정하는 모니터링 프로그램입니다.

• 이전 단계 확인: 제품의 바코드(S/N)를 조회하여 이전 주요 공정(Housing, Calibration, EOL)을 모두 통과했는지 자동으로 검증합니다.

• 실시간 계측 및 판정: 검사를 시작하면 전기적 신호가 측정되며, 설정된 범위 이내인 경우 최종 PASS(합격), 범위를 벗어나면 FAIL(불합격) 판정을 내립니다.

• 파라미터 조율: 생산 제품 사양에 맞춰 합격 판정 기준 범위(최소/최대 전압 및 전류)를 간편하게 변경할 수 있습니다.

---

2. 전체 동작 흐름도 (Operational Flow)

검사자가 프로그램을 구동하여 최종 검사를 완료하기까지의 전체 프로세스는 다음과 같습니다.

graph TD
    A([1. 프로그램 실행]) --> B[시작 설정 및 로그인 팝업]
    B --> C{로그인 및 설정 완료?}
    C -- 취소/종료 --> D([프로그램 종료])
    C -- 로그인 완료 클릭 --> E[메인 모니터링 화면 기동]
    E --> F[상단바에서 작업자 및 모델 정보 확인]
    F --> G[S/N 입력 칸에 바코드 스캔 또는 직접 입력]
    G --> H[조회 버튼 클릭 또는 엔터 키 입력]
    H --> I{이전 검사 결과 확인}
    I -- 이전 단계 중 불합격 존재 --> J[경고 팝업 창 출력 및 진행 불가 표시]
    J --> K[START 버튼 비활성화 상태 유지 -> 검사 불가]
    K --> G
    I -- 이전 단계 모두 합격 PASS --> L[상태: 검사 가능 표시 및 START 버튼 활성화]
    L --> M[▶ 검사 시작 START 버튼 클릭]
    M --> N[상태: 검사 진행 중 표시 및 수치 측정 시작]
    N --> O[전압/전류 계측값이 2초간 흔들리며 측정 동작 연출]
    O --> P[측정 완료 및 최종값 표시]
    P --> Q{측정 전압/전류가 기준범위 이내인가?}
    Q -- 합격 범위 내 --> R[대형 화면에 PASS 녹색 표시 및 합격 판정]
    Q -- 범위 이탈 --> S[대형 화면에 FAIL 적색 표시 및 불합격 판정]
    R --> T[시스템 원상 복구 및 다음 제품 검사 대기]
    S --> T
    T --> G

---

3. 상세 기능별 동작 가이드

3.1. 시스템 시작 설정 및 로그인

1. 프로그램 기동: 프로그램을 켜면 메인 화면이 뜨기 전, [시스템 시작 설정 & 로그인] 화면이 화면 중앙에 먼저 나타납니다.

2. 설정값 기입: 제조사, 모델명, 색상 코드, 라인 번호, LOT 번호, 지그 번호를 확인 및 기입하고, 담당 작업자명과 비밀번호를 입력합니다.

3. 빠른 테스트 실행 (테스트 계정):

   - 검사 편의를 위해 작업자(test)와 비밀번호(test)가 미리 입력되어 있습니다.

   - 별도 수정 없이 곧바로 하단의 [시스템 시작 및 로그인] 단추를 누르면 로그인이 완료됩니다.

4. 정보 연동: 로그인이 완료되면 로그인 창이 닫히고 메인 화면이 자동으로 최대화되어 열립니다. 메인 화면 좌측 상단바 영역에 입력했던 정보가 [작업자: test | 모델: MOBI-EV-01 | 라인: LINE-3] 형태로 상시 노출됩니다.

---

3.2. 제품 조회 및 이전 공정 이력 검증

1. S/N(시리얼 번호) 스캔: 메인 화면 좌측의 'S/N 입력' 상자에 제품 바코드를 스캔하거나 입력합니다. (키보드의 엔터 키 또는 [조회] 버튼 클릭)

2. 이전 단계 확인: 시스템이 이전 공정 단계들의 결과를 불러와 화면 좌측 '이전 시험 단계 결과' 표에 표시합니다.

   - 합격 제품 테스트 (S/N: PASS1234): Housing, Calibration, EOL 단계가 모두 초록색 PASS로 채워지며, 하단의 대형 [▶ 검사 시작 (START)] 버튼이 초록색으로 활성화되어 성능 검사를 수행할 수 있습니다.

   - 불합격 제품 테스트 (S/N: FAIL5678): 이전 단계 중 실패한 항목이 빨간색 FAIL로 표시되며, 경고 창이 나타납니다. 하단의 검사 시작 버튼은 비활성화되어 최종 검사 진행이 전면 차단됩니다.

---

3.3. 최종 성능 검사 및 합불 판정

1. 검사 시작: 초록색으로 활성화된 [▶ 검사 시작 (START)] 버튼을 클릭합니다.

2. 측정 중 상태 (2초간):

   - 검사가 시작되면 상태창이 파란색 **'측정 중'**으로 변경되고 전압 및 전류 측정 영역의 수치들이 약 2초간 측정됩니다.

3. 최종 판정:

   - 2초가 지나면 측정이 끝나고 최종 검출된 전압과 전류 수치가 화면에 고정됩니다.

   - 합격 (PASS): 측정된 전압(디폴트 4.0V ~ 6.0V)과 전류(디폴트 8.0A ~ 10.0A)가 모두 가이드 범위 내에 도달하면 대형 판정 영역이 초록색 배경의 **PASS**로 갱신되며 최종 합격 판정이 완료됩니다.

   - 불합격 (FAIL): 전압이나 전류 중 하나라도 기준 범위를 벗어나면 해당 측정 텍스트와 대형 판정 영역이 빨간색 배경의 **FAIL**로 변하여 경보를 나타냅니다.

   - 판정이 종료되면 시스템은 자동으로 대기 상태로 복구되어 다음 제품 검사를 진행할 준비를 마칩니다.

---

3.4. 판정 기준 파라미터 설정

1. 설정창 열기: 최하단 바 좌측에 있는 파란색 [⚙ 파라미터 설정] 버튼을 클릭합니다.

2. 기준값 수정: 화면에 팝업창이 나타나며 전압의 최소/최대값 및 전류의 최소/최대 기준 범위를 키보드로 입력하여 수정할 수 있습니다.

3. 유효성 체크 및 저장:

   - 입력한 값은 음수여서는 안 되며, 최소값이 최대값보다 작아야 저장할 수 있습니다.

   - **[저장]**을 누르면 변경 사항이 적용되며, 메인 화면 전압/전류 카드 하단에 표시되는 가이드 문구(기준범위: X.XV ~ Y.YV)가 실시간으로 자동 변경되어 즉시 새로운 판정 기준으로 적용됩니다.

---

4. GUI

메인 화면

!

작동화면

!

이전 시험 단계 실패 화면

!

파라미터 설정 화면

!