50825c597e
- 사용자 상세 모달에 특이사항 표시 (생일 옆 칸)
- 인라인 수정 UI (수정 버튼 → textarea → 저장/취소)
- PUT /api/members/{cuscode}/cusetc API 추가
- CD_PERSON.CUSETC 직접 UPDATE
Docs: MEMBER_MEMO_SYSTEM.md 문서 추가
- DB 구조, API 명세, 구현 현황 정리
273 lines
6.8 KiB
Markdown
273 lines
6.8 KiB
Markdown
# 환자 메모/특이사항 시스템 설계 문서
|
|
|
|
## 📅 작성일: 2026-03-04
|
|
|
|
---
|
|
|
|
## 1. DB 접속 정보
|
|
|
|
| 항목 | 값 |
|
|
|------|-----|
|
|
| 서버 | `192.168.0.4\PM2014` |
|
|
| 드라이버 | ODBC Driver 17 for SQL Server |
|
|
| 인증 | Windows 인증 (Trusted_Connection) |
|
|
| 데이터베이스 | PM_BASE (환자정보), PM_PRES (처방), PM_DRUG (약품) |
|
|
|
|
### 접속 코드 (pharmacy-pos-qr-system)
|
|
```python
|
|
from db.dbsetup import DatabaseManager
|
|
db = DatabaseManager()
|
|
session = db.get_session('PM_BASE')
|
|
```
|
|
|
|
---
|
|
|
|
## 2. 테이블 구조
|
|
|
|
### 2.1 CD_PERSON.CUSETC (특이참고사항)
|
|
|
|
**용도:** 단일 필드, 간단한 메모 (덮어쓰기 방식)
|
|
|
|
| 칼럼 | 타입 | 설명 |
|
|
|------|------|------|
|
|
| CUSETC | VARCHAR(2000) | 특이/참고사항 텍스트 |
|
|
|
|
**특징:**
|
|
- 한 환자당 하나의 값만 저장
|
|
- 새로 입력하면 기존 값 덮어씀
|
|
- 주로 미수금, 간단한 주의사항 등 기록
|
|
|
|
---
|
|
|
|
### 2.2 CD_PERSON_MEMO (메모 - 날짜별 누적)
|
|
|
|
**용도:** 별도 테이블, 상세 메모 이력 관리
|
|
|
|
| 칼럼 | 타입 | 설명 |
|
|
|------|------|------|
|
|
| CUSCODE | VARCHAR(10) | 고객코드 (PK) |
|
|
| MEMO_CODE | VARCHAR(5) | 메모코드 (PK) - 00001, 00002... |
|
|
| PHARMA_ID | VARCHAR(10) | 작성자명 (약사 이름 직접 저장) |
|
|
| MEMO_DATE | VARCHAR(8) | 작성일 (YYYYMMDD) |
|
|
| MEMO_TITLE | VARCHAR(40) | 메모 제목 |
|
|
| MEMO_Item | TEXT | 메모 내용 |
|
|
|
|
**특징:**
|
|
- 한 환자당 여러 메모 가능 (날짜별 누적)
|
|
- 복합 PK: CUSCODE + MEMO_CODE
|
|
- 작성자/날짜 추적 가능
|
|
|
|
---
|
|
|
|
## 3. PHARMA_ID 분석
|
|
|
|
### 현재 저장된 값 (2026-03-04 기준)
|
|
```
|
|
[김영빈] - 2448건
|
|
[박혜령] - 63건
|
|
[이충섭] - 4건
|
|
[시스템] - 2건
|
|
[이수지] - 1건
|
|
[지민구] - 1건
|
|
[PHARM001] - 1건
|
|
```
|
|
|
|
### 결론
|
|
- **직접 이름 저장 방식** (마스터 테이블 조인 불필요)
|
|
- 대부분 한글 이름, 일부 코드 형태 존재
|
|
- 별도 약사 마스터 테이블 연결 없이 독립적으로 저장
|
|
|
|
---
|
|
|
|
## 4. 실제 데이터 예시
|
|
|
|
### 예시 1: 김미성 (0000014615)
|
|
```
|
|
[특이사항 - CD_PERSON.CUSETC]
|
|
25/1 미수금:200
|
|
|
|
[메모 - CD_PERSON_MEMO]
|
|
메모코드: 00001
|
|
작성자: 김영빈
|
|
날짜: 20260304
|
|
제목: (없음)
|
|
내용: 신장투석.이식 가족력
|
|
```
|
|
|
|
### 예시 2: 박상호 (0000024142)
|
|
```
|
|
[특이사항 - CD_PERSON.CUSETC]
|
|
25/1 미수금:1400
|
|
|
|
[메모 - CD_PERSON_MEMO]
|
|
메모코드: 00003
|
|
작성자: 김영빈
|
|
날짜: 20260303
|
|
제목: 가루약
|
|
내용: 사미온만 아침,저녁
|
|
나머지 저녁으로
|
|
카나브는 알약으로 포장
|
|
```
|
|
|
|
### 예시 3: 안동옥 (0000001030)
|
|
```
|
|
[특이사항 - CD_PERSON.CUSETC]
|
|
25/1 미수금:200
|
|
|
|
[메모 - CD_PERSON_MEMO]
|
|
메모코드: 00001
|
|
작성자: 김영빈
|
|
날짜: 20260224
|
|
제목: (없음)
|
|
내용: 26.2.23-에터미 해모임과 고지혀약 피타로우에프 먹은지 한달 만에
|
|
간수피가 20대에서 120대로 수치가 오름.
|
|
고덱스 처방과 약 끊고 변화 확인 요망(010-6209-0796)
|
|
```
|
|
|
|
---
|
|
|
|
## 5. 기존 API 현황
|
|
|
|
### GET /api/members/search?q={검색어}
|
|
- 회원 검색 (이름 2자 이상, 전화번호)
|
|
- 응답에 `memo` (CUSETC 100자 미리보기) 포함
|
|
|
|
### GET /api/members/{cuscode}
|
|
- 회원 상세 조회
|
|
- `member.memo`: CUSETC 전체
|
|
- `memos[]`: CD_PERSON_MEMO 배열 (author, date, title, content)
|
|
|
|
---
|
|
|
|
## 6. 구현 계획
|
|
|
|
### 6.1 약사/직원 테이블 (신규 - SQLite)
|
|
|
|
**위치:** `backend/db/pharmacy_staff.db`
|
|
|
|
```sql
|
|
CREATE TABLE staff (
|
|
id INTEGER PRIMARY KEY AUTOINCREMENT,
|
|
name VARCHAR(20) NOT NULL, -- 이름 (PHARMA_ID에 저장될 값)
|
|
role VARCHAR(20), -- 역할 (약사, 직원 등)
|
|
is_active BOOLEAN DEFAULT 1, -- 활성 여부
|
|
created_at DATETIME DEFAULT CURRENT_TIMESTAMP
|
|
);
|
|
|
|
-- 초기 데이터
|
|
INSERT INTO staff (name, role) VALUES ('김영빈', '약사');
|
|
INSERT INTO staff (name, role) VALUES ('박혜령', '약사');
|
|
```
|
|
|
|
**용도:**
|
|
- 메모 작성 시 드롭다운 목록 제공
|
|
- 향후 로그인 시스템 확장 대비
|
|
- 기본 작성자 설정 가능
|
|
|
|
### 6.2 UI 구현 방향
|
|
|
|
```
|
|
[회원 상세 페이지]
|
|
├── 기본 정보 (이름, 전화번호, 주민번호 등)
|
|
├── 특이(참고)사항
|
|
│ └── [단일 텍스트 영역] - 저장 시 덮어쓰기
|
|
└── 메모 (날짜별 누적)
|
|
├── [메모 목록] - 날짜순 정렬
|
|
│ └── 각 메모: 날짜, 작성자, 제목, 내용 미리보기
|
|
├── [새 메모 추가]
|
|
│ ├── 작성자 드롭다운 (staff 테이블에서)
|
|
│ ├── 제목 입력
|
|
│ └── 내용 입력
|
|
└── [메모 수정/삭제]
|
|
```
|
|
|
|
---
|
|
|
|
## 7. 현재 구현 현황 (2026-03-04)
|
|
|
|
### 7.1 특이(참고)사항 - 구현 완료 ✅
|
|
|
|
**위치:** https://mile.0bin.in/admin → 사용자 클릭 → 상세 모달
|
|
|
|
#### UI
|
|
```
|
|
┌──────────────────┬──────────────────┐
|
|
│ 🎂 생일 │ ⚠️ 특이사항 [✏️ 수정]│
|
|
│ 07월 12일 │ 개발약사2 │
|
|
└──────────────────┴──────────────────┘
|
|
```
|
|
|
|
- 생일 옆 칸에 표시 (공간 효율적 활용)
|
|
- 30자 초과 시 truncate, 클릭하면 펼침
|
|
- [✏️ 수정] 버튼 → 인라인 textarea → [저장] / [취소]
|
|
|
|
#### API
|
|
|
|
**조회:** `GET /admin/user/{userId}`
|
|
```json
|
|
{
|
|
"pos_customer": {
|
|
"cuscode": "0000000004",
|
|
"name": "김영빈",
|
|
"cusetc": "개발약사2"
|
|
}
|
|
}
|
|
```
|
|
|
|
**수정:** `PUT /api/members/{cuscode}/cusetc`
|
|
```json
|
|
// Request
|
|
{ "cusetc": "새로운 특이사항" }
|
|
|
|
// Response
|
|
{
|
|
"success": true,
|
|
"message": "특이사항이 저장되었습니다.",
|
|
"cusetc": "새로운 특이사항"
|
|
}
|
|
```
|
|
|
|
#### E2E 테스트 완료
|
|
```bash
|
|
# 검색
|
|
GET /api/members/search?q=김영빈 → cuscode: 0000000004
|
|
|
|
# 수정
|
|
PUT /api/members/0000000004/cusetc
|
|
Body: { "cusetc": "개발약사2 - 테스트 수정" }
|
|
→ 성공 ✅
|
|
|
|
# 확인
|
|
GET /api/members/search?q=김영빈
|
|
→ memo: "개발약사2 - 테스트 수정" ✅
|
|
```
|
|
|
|
---
|
|
|
|
### 7.2 메모 (날짜별 누적) - 미구현 ⏳
|
|
|
|
**다음 단계:**
|
|
1. staff 테이블 생성 (SQLite)
|
|
2. 메모 CRUD API 구현
|
|
3. UI 구현 (메모 목록, 추가, 수정, 삭제)
|
|
|
|
---
|
|
|
|
## 8. 관련 파일
|
|
|
|
| 파일 | 설명 |
|
|
|------|------|
|
|
| `backend/app.py` | Flask API (3740행~ 회원 관련, CUSETC 수정 API 포함) |
|
|
| `backend/db/dbsetup.py` | DB 연결 설정 |
|
|
| `backend/templates/admin.html` | 어드민 대시보드 (사용자 상세 모달, 특이사항 UI) |
|
|
| `backend/templates/admin_members.html` | 회원 관리 페이지 |
|
|
| `person-lookup-web-local/models.py` | SQLAlchemy 모델 정의 |
|
|
|
|
---
|
|
|
|
## 9. 참고사항
|
|
|
|
- PIT3000 원본 테이블은 직접 수정 (INSERT/UPDATE)
|
|
- 마일리지 시스템(SQLite)과 별개로 MSSQL에 저장
|
|
- CD_PERSON_MEMO는 복합키(CUSCODE + MEMO_CODE) 주의
|