marking_gui/program_flow.md

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

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

---

## 1. 시스템 개요 (Introduction)

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

- **이전 단계 확인:** 제품의 바코드(S/N)를 조회하여 이전 주요 공정(Housing, Calibration, EOL)을 모두 통과했는지 자동으로 검증합니다.
- **실시간 계측 및 판정:** 검사를 시작하면 전기적 신호가 측정되며, 설정된 범위 이내인 경우 최종 `PASS`(합격), 범위를 벗어나면 `FAIL`(불합격) 판정을 내립니다.
- **파라미터 조율:** 생산 제품 사양에 맞춰 합격 판정 기준 범위(최소/최대 전압 및 전류)를 간편하게 변경할 수 있습니다.

---

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

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

```mermaid
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
#### 메인 화면
![[Pasted image 20260605142629.png]]

#### 작동화면
![[Pasted image 20260605142747.png]]

#### 이전 시험 단계 실패 화면
![[Pasted image 20260605142804.png]]

#### 파라미터 설정 화면
![[Pasted image 20260605142845.png]]