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([프로그램 종료])
    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
#### 메인 화면
![[Pasted image 20260605142629.png]]

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

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

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