211 lines
5.8 KiB
Markdown
211 lines
5.8 KiB
Markdown
# 회원 상세 기능 구현 계획
|
|
|
|
> 작성일: 2026-02-27
|
|
> 상태: 계획 중
|
|
|
|
## 개요
|
|
|
|
회원 검색 페이지(`/admin/members`)에서 "상세" 버튼 클릭 시, 해당 회원의 구매 이력 및 QR 적립 내역을 조회하는 기능.
|
|
|
|
## 현재 상태
|
|
|
|
- ✅ 회원 검색 API (`/api/members/search`) - 완료
|
|
- ✅ 회원 기본정보 조회 (`/api/members/<cuscode>`) - 완료
|
|
- ❌ 회원 구매 이력 조회 - 미구현
|
|
- ❌ QR 적립 내역 연동 - 미구현
|
|
|
|
## 데이터 소스
|
|
|
|
### 1. 마일리지 DB (SQLite)
|
|
```
|
|
파일: backend/db/mileage.db
|
|
테이블: transactions (적립/사용 내역)
|
|
|
|
주요 컬럼:
|
|
- phone: 전화번호 (010XXXXXXXX)
|
|
- points: 적립/사용 포인트
|
|
- type: earn (적립) / use (사용)
|
|
- amount: 구매금액
|
|
- created_at: 거래일시
|
|
- receipt_id: 영수증 ID (연동용)
|
|
```
|
|
|
|
### 2. POS DB (MSSQL - PM_PRES)
|
|
```
|
|
테이블: SALE_MAIN (판매 메인)
|
|
테이블: SALE_SUB (판매 상세 - 품목별)
|
|
|
|
SALE_MAIN:
|
|
- SL_NO_order: 거래번호
|
|
- SL_NM_custom: 고객명
|
|
- SL_CD_custom: 고객코드
|
|
- SL_MY_total: 총액
|
|
- SL_DT_appl: 거래일자
|
|
|
|
SALE_SUB:
|
|
- SL_NO_order: 거래번호 (FK)
|
|
- DrugCode: 상품코드
|
|
- QUAN: 수량
|
|
- SL_TOTAL_PRICE: 금액
|
|
```
|
|
|
|
### 3. 회원 DB (MSSQL - PM_BASE)
|
|
```
|
|
테이블: CD_PERSON
|
|
|
|
주요 컬럼:
|
|
- CUSCODE: 고객코드
|
|
- PANAME: 이름
|
|
- PHONE, TEL_NO, PHONE2: 전화번호 3곳
|
|
```
|
|
|
|
## 연동 전략
|
|
|
|
### 문제점
|
|
- POS(SALE_MAIN)에는 `SL_CD_custom`(고객코드) 사용
|
|
- 마일리지 DB에는 `phone`(전화번호) 사용
|
|
- **전화번호 → 고객코드** 또는 **고객코드 → 전화번호** 매핑 필요
|
|
|
|
### 해결 방안
|
|
|
|
#### 방안 1: 전화번호 기반 통합 (권장)
|
|
```
|
|
1. CD_PERSON에서 전화번호로 CUSCODE 조회
|
|
2. CUSCODE로 SALE_MAIN 조회
|
|
3. 마일리지 DB에서 전화번호로 적립 내역 조회
|
|
4. 두 결과 병합하여 표시
|
|
```
|
|
|
|
#### 방안 2: 마일리지 테이블에 CUSCODE 추가
|
|
```sql
|
|
ALTER TABLE users ADD COLUMN cuscode TEXT;
|
|
```
|
|
- QR 적립 시 POS 고객코드 연동
|
|
|
|
## API 설계
|
|
|
|
### GET /api/members/<cuscode>/history
|
|
|
|
**Response:**
|
|
```json
|
|
{
|
|
"success": true,
|
|
"member": {
|
|
"cuscode": "0000012345",
|
|
"name": "김영빈",
|
|
"phone": "01027027390"
|
|
},
|
|
"mileage": {
|
|
"balance": 19005,
|
|
"total_earned": 25000,
|
|
"total_used": 5995,
|
|
"transactions": [
|
|
{
|
|
"date": "2026-02-27 01:29",
|
|
"type": "earn",
|
|
"points": 555,
|
|
"amount": 18500,
|
|
"products": ["투엑스벤포파워", "마데카솔"]
|
|
}
|
|
]
|
|
},
|
|
"purchases": [
|
|
{
|
|
"date": "20260227",
|
|
"order_no": "20260227001234",
|
|
"total": 18500,
|
|
"items": [
|
|
{"name": "투엑스벤포파워", "qty": 1, "price": 9000},
|
|
{"name": "마데카솔연고", "qty": 1, "price": 9500}
|
|
]
|
|
}
|
|
]
|
|
}
|
|
```
|
|
|
|
## UI 설계
|
|
|
|
### 회원 상세 모달
|
|
|
|
```
|
|
┌─────────────────────────────────────────────┐
|
|
│ 👤 김영빈 │
|
|
│ 📱 010-2702-7390 │
|
|
│ 💰 잔여 포인트: 19,005P │
|
|
├─────────────────────────────────────────────┤
|
|
│ [QR 적립 내역] [POS 구매 이력] │
|
|
├─────────────────────────────────────────────┤
|
|
│ 📅 2026-02-27 01:29 │
|
|
│ +555P (18,500원 구매) │
|
|
│ └ 투엑스벤포파워, 마데카솔연고 │
|
|
│ │
|
|
│ 📅 2026-02-27 01:25 │
|
|
│ +360P (12,000원 구매) │
|
|
│ └ 벤포파워Z x2 │
|
|
├─────────────────────────────────────────────┤
|
|
│ [ 메시지 발송 ] [ 닫기 ] │
|
|
└─────────────────────────────────────────────┘
|
|
```
|
|
|
|
## 구현 단계
|
|
|
|
### Phase 1: 마일리지 내역 연동 (우선)
|
|
1. [ ] `/api/members/<phone>/mileage` API 추가
|
|
2. [ ] SQLite에서 전화번호로 적립/사용 내역 조회
|
|
3. [ ] 회원 상세 모달 UI 구현
|
|
|
|
### Phase 2: POS 구매 이력 연동
|
|
1. [ ] 전화번호 → CUSCODE 매핑 로직
|
|
2. [ ] SALE_MAIN/SALE_SUB 조회 API
|
|
3. [ ] 품목 상세 표시
|
|
|
|
### Phase 3: 통합 뷰
|
|
1. [ ] 마일리지 + POS 데이터 병합
|
|
2. [ ] 타임라인 형태로 통합 표시
|
|
3. [ ] 상품 추천 (자주 구매 품목)
|
|
|
|
## 예상 쿼리
|
|
|
|
### 마일리지 내역 (SQLite)
|
|
```sql
|
|
SELECT
|
|
t.created_at, t.type, t.points, t.amount,
|
|
u.name, u.phone, u.balance
|
|
FROM transactions t
|
|
JOIN users u ON t.user_id = u.id
|
|
WHERE u.phone = '01027027390'
|
|
ORDER BY t.created_at DESC
|
|
LIMIT 50;
|
|
```
|
|
|
|
### POS 구매 이력 (MSSQL)
|
|
```sql
|
|
-- 1. 전화번호로 고객코드 조회
|
|
SELECT CUSCODE FROM PM_BASE.dbo.CD_PERSON
|
|
WHERE PHONE = '01027027390' OR TEL_NO = '01027027390';
|
|
|
|
-- 2. 고객코드로 구매 이력 조회
|
|
SELECT
|
|
M.SL_NO_order, M.SL_DT_appl, M.SL_MY_total,
|
|
S.DrugCode, G.GoodsName, S.QUAN, S.SL_TOTAL_PRICE
|
|
FROM PM_PRES.dbo.SALE_MAIN M
|
|
JOIN PM_PRES.dbo.SALE_SUB S ON M.SL_NO_order = S.SL_NO_order
|
|
LEFT JOIN PM_DRUG.dbo.CD_GOODS G ON S.DrugCode = G.DrugCode
|
|
WHERE M.SL_CD_custom = '0000012345'
|
|
ORDER BY M.SL_DT_appl DESC;
|
|
```
|
|
|
|
## 참고
|
|
|
|
- 마일리지 테이블 구조: `backend/db/dbsetup.py`
|
|
- POS 테이블 가이드: `docs/alimipharm-set-product-structure.md`
|
|
- 회원 검색 API: `backend/app.py` → `/api/members/search`
|
|
|
|
---
|
|
|
|
## 히스토리
|
|
|
|
| 날짜 | 내용 |
|
|
|------|------|
|
|
| 2026-02-27 | 계획 문서 작성 |
|