pharmacy-pos-qr-system/docs/MEMBER_MEMO_SYSTEM.md

환자 메모/특이사항 시스템 설계 문서

📅 작성일: 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)

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

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}

{
  "pos_customer": {
    "cuscode": "0000000004",
    "name": "김영빈",
    "cusetc": "개발약사2"
  }
}

수정: PUT /api/members/{cuscode}/cusetc

// Request
{ "cusetc": "새로운 특이사항" }

// Response
{
  "success": true,
  "message": "특이사항이 저장되었습니다.",
  "cusetc": "새로운 특이사항"
}

E2E 테스트 완료

# 검색
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) 주의