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{로그인}
    D -- 취소/닫기 --> E([프로그램 종료])
    D -- 로그인 성공 --> F[상단바 우측에 작업자/모델/라인 정보 표출 및 메인 활성화]
    F --> G[▶ 검사 시작 START 버튼 클릭]
    G --> H[UI 화면 상태 및 측정 수치 -.-- 로 강제 초기화]
    H --> I[메모리로부터 S/N를 자동으로 읽어서 입력받음]
    I --> J[데이터베이스에서 이전 검사 결과 조회]
    J --> K{이전 검사 결과 확인}
    K -- 이전 단계 중 FAIL 불합격 존재 --> L[경고 팝업 창 출력 및 검사 중단]
    L --> G
    K -- 이전 단계 모두 PASS 합격 --> M[자동으로 검사 시작 및 2초간 수치 측정]
    M --> N[측정 완료 및 최종값 소수점 둘째 자리 표시]
    N --> O{측정 전압/전류가 기준범위 이내인가?}
    O -- 합격 범위 내 PASS --> P[대형 화면 PASS 표시 및 최종 합격 판정]
    O -- 범위 이탈 FAIL --> Q[대형 화면 FAIL 표시 및 최종 불합격 판정]
    P --> R[데이터베이스에 측정값 3,2 포맷팅 반올림 및 PASS 저장]
    Q --> S[데이터베이스에 측정값 3,2 포맷팅 반올림 및 FAIL 저장]
    R --> T[최종 설비에 SUCCESS 신호 전달]
    S --> U[시스템 대기 상태 복구 및 다음 검사 준비]
    T --> U
    U --> G

---

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

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

1. 메인 화면 로드 및 로그인 팝업: 프로그램을 실행하면 백그라운드에 메인 모니터링 화면이 먼저 켜져서 깔리며, 그 위에 [시스템 시작 설정 & 로그인] 화면이 화면 정중앙에 팝업(모달) 형태로 활성화됩니다.
2. 설정값 기입: 제조사, 모델명, 색상 코드, 라인 번호, LOT 번호, 지그 번호를 확인 및 기입하고, 담당 작업자명과 비밀번호를 입력합니다. (빠른 실행을 위해 테스트 계정 test / test가 미리 기입되어 있습니다.)
3. 팝업 취소 시 앱 종료: 최초 로그인 시 창을 그냥 닫거나 취소를 누르면 프로그램 전체가 안전하게 종료됩니다.
4. 정보 연동 및 로그아웃: 로그인이 완료되면 로그인 창이 닫히며 메인 화면 상단바 우측 영역에 [작업자: test] [모델: MOBI-EV-01 | 라인: LINE-3] 형태로 정돈되어 정보가 표시됩니다. 또한 바로 우측에 빨간색 [로그아웃] 버튼이 생성됩니다.
   • [로그아웃] 버튼을 클릭하면 현재 화면의 수치들이 초기화되고 로그인 팝업창이 다시 정중앙에 호출됩니다.

---

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

1. 검사 시작 및 UI 초기화: [▶ 검사 시작 (START)] 버튼(기본 활성화 상태)을 클릭합니다. 클릭 즉시 이전 제품의 수치와 결과가 오인되는 것을 방지하기 위해 화면의 전압/전류 수치(-.--), 최종 판정(대 기 중), 이전 공정 단계(대기)가 깨끗이 초기화됩니다.
2. 메모리 자동 읽기: UI 초기화가 끝나면 시스템은 메모리로부터 바코드(S/N) 정보를 자동으로 읽어와 S/N 입력 창에 자동으로 입력합니다. (조회 버튼은 완전히 제거되었으며 수동 입력을 거치지 않습니다.)
3. 이전 단계 자동 검증: 조회된 S/N으로 데이터베이스를 즉시 탐색하여 이전 공정 단계 결과를 확인합니다.
   • 합격 제품 테스트 (S/N: PASS1234): Housing, Calibration, EOL 단계가 모두 초록색 PASS로 채워지며, 별도 조작 대기 없이 최종 성능 검사를 자동으로 바로 가동합니다.
   • 불합격 제품 테스트 (S/N: FAIL5678): 이전 단계 중 실패한 항목이 빨간색 FAIL로 표시되며, 즉시 경고 팝업 창이 출력되고 검사 시작을 전면 차단합니다.

---

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

1. 자동 계측 시작: 이전 공정 결과가 모두 합격인 경우, 상태창이 파란색 **'측정 중'**으로 자동 변경되고 전압 및 전류 측정 영역의 수치가 소수점 둘째 자리(-.--) 상태에서 약 2초간 흔들리며 측정 동작을 연출합니다.
2. 측정 완료 및 판정: 2초가 지나면 측정이 끝나고 최종 검출된 전압과 전류 수치가 소수점 둘째 자리 포맷(F2)으로 화면에 표시됩니다.
   • 측정된 전압(디폴트 4.00V ~ 6.00V)과 전류(디폴트 8.00A ~ 10.00A)가 모두 가이드 범위 이내이면 대형 판정 영역이 초록색 배경의 **PASS**로 표시됩니다. 범위를 벗어날 경우 빨간색 배경의 FAIL 판정을 내립니다.
3. 데이터베이스 적재 (3,2 포맷팅): 최종 판정이 이루어지는 순간, 측정된 전압과 전류 수치를 소수점 이하 2자리(3,2 포맷에 대응)로 반올림 처리하여 최종 판정 결과(PASS/FAIL) 및 S/N 정보와 함께 데이터베이스에 안전하게 기록합니다.
4. SUCCESS 완료 신호 전달: 최종 합격(PASS) 판정 건에 한하여, 데이터베이스 저장이 끝난 후 외부 설비 제어기(PLC 등) 측 메모리에 최종 SUCCESS 완료 신호를 송신하여 제품 이동 및 라인 흐름을 자동 제어하도록 구성했습니다.
5. 자동 대기 복구: 모든 저장 및 신호 전달 프로세스가 완료되면 시스템은 자동으로 대기 상태로 복구되어 다음 제품 검사를 진행할 준비를 마칩니다.

---

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

1. 설정창 열기: 최하단 바 좌측에 있는 파란색 [⚙ 파라미터 설정] 버튼을 클릭합니다.
2. 기준값 수정: 화면에 팝업창이 나타나며 전압의 최소/최대값 및 전류의 최소/최대 기준 범위를 키보드로 입력하여 수정할 수 있습니다.
3. 유효성 체크 및 저장:
   • 입력한 값은 음수여서는 안 되며, 최소값이 최대값보다 작아야 저장할 수 있습니다.
   • **[저장]**을 누르면 변경 사항이 적용되며, 메인 화면 전압/전류 카드 하단에 표시되는 가이드 문구(기준범위: X.XXV ~ Y.YYV)가 실시간으로 자동 변경되어 즉시 새로운 판정 기준으로 적용됩니다.

---

4. GUI

메인 화면

!

작동화면

!

이전 시험 단계 실패 화면

!

파라미터 설정 화면

!