# Nelydo POS Receipt Agent Demo 설명서 R9

## 1. 이 데모의 목적

이 데모는 여러 매장 POS 환경에서 영수증 출력 데이터를 본사 집계용 표준 매출 데이터로 정리할 수 있는지 검토하기 위한 대표 매장 파일럿 설명용 데모입니다.

공개 데모는 실제 POS, 실제 프린터, 실제 고객 식별정보 원문, 실제 서버 전송을 사용하지 않습니다.  
브라우저 안의 합성 영수증 데이터만 사용해 다음 흐름을 보여줍니다.

- 영수증 텍스트를 표준 매출 payload로 변환
- 네트워크 단절 시 local outbox에 임시 보관
- 복구 후 누락 없이 재전송하는 구조
- 중복 전송을 막기 위한 payload hash/idempotency 개념
- 파일럿에서 확인해야 할 Windows 인쇄 출력 경로 후보
- 계약 전 공개 데모와 계약 후 실제 POC의 경계

## 2. 데모 확인 순서

### 2.1 합성 영수증 파싱 확인
1. 표준형, 압축형, 레거시형 샘플 중 하나를 선택합니다.
2. `파싱 실행`을 눌러 합성 영수증이 표준 데이터로 바뀌는지 확인합니다.
3. 메뉴명, 수량, 단가, 합계, 결제수단이 payload에 들어가는지 확인합니다.

### 2.2 네트워크 단절/outbox 확인
1. `네트워크 끊김`을 누릅니다.
2. 새 영수증 이벤트가 outbox에 남는지 확인합니다.
3. `복구·재전송`을 눌러 pending 데이터가 처리되는지 확인합니다.

### 2.3 서버 ACK 시뮬레이션 확인
R9 기준 데모에는 다음 모의 응답 흐름이 포함되어야 합니다.

- `ACK 200`: 서버 수신 성공
- `HTTP 500`: 서버 오류, outbox 유지
- `Timeout`: 재시도 대기
- `Duplicate ACK`: payload hash로 중복 방지
- `Network Offline`: SQLite outbox 저장 후보

### 2.4 인쇄 출력 경로 검증표 확인
다음 후보가 별도로 표시되어야 합니다.

- 프린터 큐 감시
- 가상 프린터
- 포트 모니터 후보
- 전자 출력/파일 출력 후보
- POS export, 정산 리포트, DB/API 등 대체 연동 후보

중요한 점은 공개 데모가 “무조건 텍스트 추출 가능”을 보장하지 않는다는 것입니다.  
실제 가능 범위는 고객사가 승인한 테스트 매장/프린터/POS 조합에서 파일럿으로 확인해야 합니다.

## 3. 공개 데모에서 하지 않는 것

공개 데모는 다음을 하지 않습니다.

- 실제 POS 프로그램 접근
- 실제 Windows Print Spooler 내부 비승인 연동
- 실제 프린터 드라이버 또는 port monitor 설치
- 실제 고객 영수증 사용
- 카드번호, 승인번호 등 결제 민감정보 원문 처리
- 고객 식별정보 원문 처리
- 실제 서버 전송
- 백그라운드 자동 업데이트 실행

## 4. 계약 후 POC에서 확인할 것

계약 후에는 고객사가 승인한 범위에서 다음을 확인합니다.

### 4.1 인쇄 출력 경로
- 실제 프린터 출력 ON/OFF
- 가상 프린터만 사용
- 출력 취소/실패
- 재출력/중복 출력
- 프린터 없음 상태
- 코드페이지/제어문자/QR/바코드 처리

### 4.2 파싱 정확도
- 메뉴명
- 수량
- 단가
- 할인
- 취소/환불
- 세금/봉사료
- 복합 결제
- 합계
- 매장/단말 식별자

### 4.3 오프라인 대응
- 네트워크 단절 감지
- SQLite outbox 저장
- 복구 후 재전송
- 중복 전송 방지
- 실패 응답 재시도
- 로그 보존

### 4.4 운영 안정성
- POS 프로그램 속도 영향
- 영수증 출력 지연
- 백신 오탐
- Windows 권한
- 설치/삭제/rollback
- 업데이트 실패 복구

## 5. 2주 파일럿 권장 구성

권장 파일럿 범위:

- 대표 매장 3곳 또는 POS 유형 3개
- POS별 샘플 영수증 30건 이상
- 전체 샘플 100건 이상
- Windows 7/10/11/Embedded 32비트·64비트 확인
- 네트워크 단절/복구 시나리오 재현
- 출력 지연과 POS 충돌 여부 측정
- 파일럿 리포트 제공

## 6. PASS 판단 기준

파일럿 종료 시 다음 기준으로 판단합니다.

| 구분 | 판단 기준 |
|---|---|
| 파싱 정확도 | 필드별 성공률과 예외 유형 확인 |
| 누락 방지 | 단절 후 outbox 저장과 복구 후 재전송 확인 |
| 중복 방지 | payload hash/idempotency 기준으로 중복 처리 확인 |
| 성능 | POS 동작과 출력 속도 지연이 허용 범위 안인지 확인 |
| 충돌 | POS, 프린터 드라이버, 백신과의 충돌 여부 확인 |
| 운영 | 설치, 업데이트, 로그, rollback 절차 확인 |
| 확장성 | 추가 POS/매장 전개 시 필요한 샘플 수와 규칙 추가 비용 확인 |

## 7. Windows 7/Embedded 주의

Windows 7과 Windows Embedded 환경은 매장별로 오래된 드라이버, 제조사 커스텀 이미지, TLS/SQLite/권한 문제가 있을 수 있습니다.

따라서 공개 데모에서는 호환을 보장하지 않고, 계약 후 실제 장비에서 별도 검증합니다.

## 8. 고객사에서 준비하면 좋은 자료

- POS 프로그램명과 버전
- 프린터 모델명
- 운영체제 버전
- 32비트/64비트 여부
- 실제 영수증 샘플
- 물리 출력 차단/가상 출력 사용 여부
- 서버 API 수신 방식
- 보안/개인 식별정보 원문 제외 기준
- 설치 권한과 운영 정책

## 9. 최종 제안 방향

이 데모의 목적은 “즉시 전국 배포 가능”을 주장하는 것이 아닙니다.

목적은 다음입니다.

1. 승인된 대표 매장에서 텍스트 추출 가능 경로를 찾는다.
2. POS별 영수증 양식을 표준 매출 payload로 정리한다.
3. 네트워크 장애에도 매출 누락을 막는 구조를 검증한다.
4. 충돌과 보안 위험을 파일럿에서 먼저 확인한다.
5. 파일럿 결과를 기준으로 60일 상용화 범위를 확정한다.