시골약사
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>
96 lines
2.8 KiB
Markdown
96 lines
2.8 KiB
Markdown
# POS 판매 조회 GUI
|
|
|
|
PyQt5 기반 POS 판매 내역 조회 프로그램
|
|
|
|
## 기능
|
|
|
|
- 날짜별 판매 내역 조회
|
|
- 실시간 총 매출 집계
|
|
- 판매 상세 품목 조회 (더블클릭)
|
|
- QR 생성 및 라벨 인쇄
|
|
- 적립 정보 실시간 표시 (Flask app.py 연동)
|
|
|
|
## 실행 방법
|
|
|
|
```bash
|
|
# 의존성 설치
|
|
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)를 먼저 실행**해야 합니다.
|
|
|
|
```bash
|
|
# 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원 │
|
|
└─────────────────────────────────────────────────┘
|
|
```
|