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

166 lines
5.4 KiB
Markdown

# 데이터베이스 구조 (2025-06-30 정리)
## 개요
양구청춘약국 시스템은 3개의 데이터베이스를 사용합니다:
| DB | 용도 | 위치 |
|----|------|------|
| **MSSQL (PM_DRUG)** | POS 제품/재고/판매 | localhost (팜IT3000) |
| **MSSQL (PM_PRES)** | 처방전/조제 | localhost (팜IT3000) |
| **PostgreSQL** | 동물약 상세 정보 (RAG) | 192.168.0.87:5432 |
| **SQLite** | 마일리지 시스템 | backend/db/mileage.db |
---
## MSSQL 테이블 구조 (PM_DRUG)
### 핵심 테이블 관계
```
┌─────────────────────────────────────────────────────────────┐
│ CD_GOODS (제품 마스터) - 178,182개 │
│ └── DrugCode (PK): LB000003157 │
│ │ │
│ ┌─────────┴─────────────┬──────────────────────────┐ │
│ ▼ ▼ ▼ │
│ CD_SALEGOODS CD_ITEM_UNIT_MEMBER CD_BARCODE│
│ (대표 바코드) (바코드 N개) ★ (인체용) │
│ 3,053개 N:1 관계 306,565개│
└─────────────────────────────────────────────────────────────┘
```
### CD_GOODS (제품 마스터)
팜IT3000 전체 제품 DB. 약국이 개별 등록한 제품은 `LB`, `S`로 시작.
| 컬럼 | 타입 | 설명 |
|------|------|------|
| DrugCode | nvarchar | PK. `LB000003157` (약국등록), `050000010` (표준) |
| GoodsName | nvarchar | 제품명 |
| Saleprice | decimal | 판매가 |
| BARCODE | nvarchar | (보통 비어있음 - CD_SALEGOODS 사용) |
| POS_BOON | nvarchar | 분류코드. `010103` = 동물약 |
| GoodsSelCode | nvarchar | `B` = 판매용 |
### CD_SALEGOODS (판매용 제품)
약국에서 실제 판매하는 제품. **대표 바코드 1개** 저장.
| 컬럼 | 타입 | 설명 |
|------|------|------|
| DrugCode | nvarchar | FK → CD_GOODS |
| GoodsName | nvarchar | 제품명 |
| BARCODE | nvarchar | **대표 바코드** (자체생성: `999000000xxxx`) |
| SplCode | nvarchar | 공급처 코드 |
| SplName | nvarchar | 공급처명 |
### CD_ITEM_UNIT_MEMBER (바코드 N개) ★
**한 제품에 여러 바코드** 저장. APC 코드는 여기에 저장됨!
| 컬럼 | 타입 | 설명 |
|------|------|------|
| DRUGCODE | nvarchar | FK → CD_GOODS.DrugCode |
| CD_CD_BARCODE | nvarchar | **바코드** (APC: `0230237810109`) |
| CD_CD_UNIT | nvarchar | 단위코드 (13, 015 등) |
| CD_MY_UNIT | decimal | 판매가 |
| CD_IN_UNIT | decimal | 입고가 |
| CHANGE_DATE | nvarchar | 변경일 (YYYYMMDD) |
| SN | bigint | 일련번호 |
### CD_BARCODE (인체용 표준)
식약처 인체용 의약품 표준 바코드. **동물약은 없음!**
| 컬럼 | 타입 | 설명 |
|------|------|------|
| DRUGCODE | nvarchar | 제품코드 |
| BARCODE | nvarchar | 표준 바코드 |
| BASECODE | nvarchar | 표준코드 |
| ETCNAME | nvarchar | 제품명 |
| CL_GUBUN | nvarchar | 구분 (전문의약품 등) |
---
## PostgreSQL 구조 (apdb_master)
동물약품 상세 정보. 농림축산검역본부 데이터 + LLM 가공.
### apc 테이블 (핵심)
| 컬럼 | 타입 | 설명 |
|------|------|------|
| apc | varchar | **PK**. `0230237810109` |
| product_name | varchar | 제품명 |
| company_name | varchar | 제조사 |
| main_ingredient | varchar | 주성분 |
| efficacy_effect | text | 효능/효과 (HTML) |
| dosage_instructions | text | 용법/용량 (HTML) |
| precautions | text | 주의사항 (HTML) |
| **llm_pharm** | jsonb | **LLM 가공 정보** ★ |
| image_url1 | varchar | 앞면 이미지 |
| image_url2 | varchar | 뒷면 이미지 |
| weight_min_kg | float | 최소 체중 |
| weight_max_kg | float | 최대 체중 |
### llm_pharm JSON 구조 (핵심!)
```json
{
"사용가능 동물": "개, 고양이",
"분류": "내부구충제",
"성분1": "메벤다졸",
"성분2": "프라지콴텔",
"체중/부위": "체중 5~9kg: 1정, 10~19kg: 2정...",
"기간/용법": "1일 1회, 1~2일간 경구투여",
"월령금기": "생후 1주 미만 사용 금지",
"반려인주의": "사람이 복용 시 즉시 의사의 조치 필요",
"앞이미지": "https://...",
"뒤이미지": "https://..."
}
```
---
## 바코드 체계
| 패턴 | 설명 | 예시 |
|------|------|------|
| `023xxxxxxxx` | **APC (동물약 표준)** | `0230237810109` |
| `999000000xxxx` | 약국 자체 생성 | `9990000001134` |
| `880xxxxxxxxx` | 일반 GS1 바코드 | `8809989000009` |
---
## 연결 예시
**안텔민킹(5kg이상) 조회:**
```sql
-- MSSQL: 바코드 조회
SELECT CD_CD_BARCODE
FROM CD_ITEM_UNIT_MEMBER
WHERE DRUGCODE = 'LB000003157'
AND CD_CD_BARCODE LIKE '023%';
-- → 0230237810109
-- PostgreSQL: 상세 정보 조회
SELECT llm_pharm->>'사용가능 동물', efficacy_effect
FROM apc
WHERE apc = '0230237810109';
-- → 개, 고양이
```
---
## 이미지 URL 규칙
```
https://ani.0bin.in/img/{APC}_F.jpg # 앞면
https://ani.0bin.in/img/{APC}_B.jpg # 뒷면
https://ani.0bin.in/img/{APC}_D.jpg # 상세
```
예: `https://ani.0bin.in/img/0230237810109_F.jpg`