시골약사
5339204fca
- 프로젝트 구조에 app.py 명시 - Phase 2 완료 상태로 업데이트 (QR 토큰 생성, Flask API) - 시스템 구성 및 연계 구조 설명 추가 - Flask API 엔드포인트 11개 문서화 (고객용 4개, 관리자용 7개) - 전체 시스템 실행 방법 상세 가이드 추가 - backend/gui/README.md에 app.py 연동 관계 추가 - OpenAI 기반 AI 분석 기능 안내 추가 Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2.8 KiB
2.8 KiB
POS 판매 조회 GUI
PyQt5 기반 POS 판매 내역 조회 프로그램
기능
- 날짜별 판매 내역 조회
- 실시간 총 매출 집계
- 판매 상세 품목 조회 (더블클릭)
- QR 생성 및 라벨 인쇄
- 적립 정보 실시간 표시 (Flask app.py 연동)
실행 방법
# 의존성 설치
pip install -r requirements.txt
# GUI 실행
python pos_sales_gui.py
데이터베이스 연결
MSSQL
PM_PRES 데이터베이스에 연결합니다.
- SALE_MAIN: 판매 헤더
- SALE_SUB: 판매 상세
SQLite
mileage.db 데이터베이스에 연결합니다.
- claim_tokens: QR 토큰 정보
- users: 적립 사용자 정보
연결 설정은 ../db/dbsetup.py에서 관리됩니다.
Flask 웹 서버 연동
필수 사전 실행
이 GUI를 사용하기 전에 Flask 웹 서버(app.py)를 먼저 실행해야 합니다.
# 1단계: Flask 서버 실행 (필수)
cd backend
python app.py
# 2단계: POS GUI 실행
cd backend/gui
python pos_sales_gui.py
연계 흐름
1. POS GUI에서 판매 내역 조회
↓
2. QR 생성 버튼 클릭
↓
3. SQLite에 claim_token 저장
↓
4. QR 라벨 인쇄
↓
5. 고객이 QR 스캔 → Flask 웹 페이지 접속
↓
6. 전화번호 + 이름 입력 → 적립 완료
↓
7. POS GUI에서 적립 정보 실시간 확인 (적립자명, 포인트)
주요 기능
QR 생성
- 선택한 판매 내역에 대해 QR 코드 생성
- claim_token을 SQLite에 저장
- Zebra 프린터로 라벨 인쇄
적립 정보 표시
- 판매 내역 테이블에 적립 상태 표시
- 적립 완료 시 사용자 정보 표시 (이름, 전화번호, 포인트)
스크린샷
┌─────────────────────────────────────────────────┐
│ POS 판매 조회 [_] [□] [X] │
├─────────────────────────────────────────────────┤
│ 날짜: [2026-01-23] [새로고침] [QR 생성] │
├─────────────────────────────────────────────────┤
│ 주문번호 시간 금액 고객명 품목수 │
│ 20260123000042 14:30 45,000원 김철수 3 │
│ 20260123000041 14:15 12,000원 [비고객] 1 │
├─────────────────────────────────────────────────┤
│ 상태: 3건 조회 완료 | 총 매출: 125,500원 │
└─────────────────────────────────────────────────┘