title = "바코드 스캔 및 이벤트 코드 관리"

content = """
바코드 스캔은 화물의 현재 위치와 상태를 실시간으로 추적 시스템에 반영하는 핵심 절차입니다.
모든 스캔 이벤트는 타임스탬프·직원 ID·스캔 장비 ID와 함께 기록되어 감사 추적이 가능합니다.

**주요 스캔 이벤트 코드:**

| 코드  | 명칭             | 발생 시점                           |
|------|-----------------|-----------------------------------|
| IN   | 집화 완료        | 집배원이 발송인에서 화물 수거 완료       |
| HUB1 | 입고 스캔        | 허브 터미널 입고 컨베이어 통과 시        |
| SORT | 분류 완료        | DPS 자동 분류 또는 수작업 분류 완료     |
| HUB2 | 출고 스캔        | 허브 출고 차량 적재 전 스캔            |
| SUB  | 거점 입고        | 배달 서브 터미널 도착 시              |
| OUT  | 배달 출발        | 배달 기사가 차량에 적재 후 출발 시      |
| DEL  | 배달 완료        | 수취인 전달 또는 안전 투함 완료        |
| ATT  | 배달 시도        | 수취인 부재 등으로 배달 미완료         |
| RET  | 반송 처리        | 화물이 발송인 방향으로 반환 시작        |
| LOST | 분실 접수        | 화물 위치 불명 상태로 조사 개시        |

**스캔 누락 처리:**
- IN 스캔 후 4시간 이내 HUB1 스캔이 없으면 '미입고 알림'이 담당 집배원에게 발송됩니다.
- SUB 스캔 후 24시간 이내 OUT 스캔이 없으면 거점 관리자에게 경고 알림이 전송됩니다.
- 스캔 누락이 확인되면 사후 보정 스캔을 실시하고 누락 사유를 시스템에 기록합니다.

**스캔 장비 관리:**
핸드헬드 스캐너는 매일 시작 전 동기화 상태를 확인합니다.
배터리 잔량이 20% 이하인 경우 즉시 교체하여 스캔 누락을 방지합니다.
스캐너 오류(불량 바코드 읽기 실패)의 경우 운송장 번호를 수동 입력하고 오류 로그를 남깁니다.
"""

version = "0.0.1"
