docs: 프로젝트 README 업데이트 - Flask app.py 및 API 문서 추가
- 프로젝트 구조에 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>
This commit is contained in:
@@ -7,7 +7,8 @@ PyQt5 기반 POS 판매 내역 조회 프로그램
|
||||
- 날짜별 판매 내역 조회
|
||||
- 실시간 총 매출 집계
|
||||
- 판매 상세 품목 조회 (더블클릭)
|
||||
- QR 생성 버튼 (Phase 2 준비)
|
||||
- QR 생성 및 라벨 인쇄
|
||||
- 적립 정보 실시간 표시 (Flask app.py 연동)
|
||||
|
||||
## 실행 방법
|
||||
|
||||
@@ -21,12 +22,62 @@ python pos_sales_gui.py
|
||||
|
||||
## 데이터베이스 연결
|
||||
|
||||
MSSQL PM_PRES 데이터베이스에 연결합니다.
|
||||
### 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 프린터로 라벨 인쇄
|
||||
|
||||
#### 적립 정보 표시
|
||||
- 판매 내역 테이블에 적립 상태 표시
|
||||
- 적립 완료 시 사용자 정보 표시 (이름, 전화번호, 포인트)
|
||||
|
||||
## 스크린샷
|
||||
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user