feat: 의약품 마스터 DB 연동 및 한약재/OTC 구분 체계 구축

- herb_items 테이블에 product_type, standard_code 컬럼 추가 - POST /api/purchase-receipts/from-cart API 구현 (표준코드 기반 입고) - 5개 API에 product_type/standard_code 필드 추가 - 프론트엔드 전역 구분 표시: 한약재/OTC 배지, 보험코드/표준코드 구분 - 경방신약 주문 매핑 문서 작성 (38건, 총액 1,561,800원) - DB 스키마 백업 추가 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
2026-02-23 13:39:59 +00:00
parent 9dd1f41bbb
commit 2ca5622bbd
8 changed files with 771 additions and 31 deletions
--- a/docs/DB_매핑_의약품마스터_한약재코드.md
+++ b/docs/DB_매핑_의약품마스터_한약재코드.md
@@ -0,0 +1,124 @@
+# DB 매핑 구조: 의약품 마스터 ↔ 한약재 코드 테이블
+
+> 의약품 마스터(medicine_master.db)와 기존 한약재 테이블(kdrug.db)은
+> **`representative_code`(대표코드)** 로 연결된다.
+
+---
+
+## 1. 테이블 관계도
+
+```
+herb_masters (454개 약재, 공통 성분 마스터)
+  │  ingredient_code (PK)  예: 3033H1AHM = 계지
+  │
+  ├─→ herb_products (53,769건, 제품별 코드)
+  │     ingredient_code (FK)
+  │     representative_code  ← 매핑 키
+  │     standard_code
+  │     product_code (보험코드 9자리)
+  │
+  └─→ herb_items (29건, 우리 약국 보유 약재)
+        ingredient_code (FK)
+        insurance_code
+        herb_name  예: "휴먼계지"
+
+medicine_master.db (305,522건, 의약품표준코드 마스터)
+  │  representative_code  ← 매핑 키
+  │  standard_code
+  │  item_std_code (품목기준코드)
+  │  product_name, company_name, spec, category, ...
+```
+
+---
+
+## 2. 매핑 키: `representative_code` (대표코드)
+
+| 구분 | herb_products | medicine_master |
+|------|:---:|:---:|
+| 대표코드 수 | 17,356 | 13,771 (한약재) |
+| **매칭 수** | **13,188 (95.8%)** | |
+| 표준코드 수 | 53,769 | - |
+| 표준코드 매칭 | **40,364 (75.1%)** | |
+
+- 풀체인 매칭 약재: **447 / 454개 (98.5%)**
+- medicine_master에만 있는 한약재 대표코드: 6개 (무시 가능)
+- herb_products에만 있는 대표코드: 4,168개 (취소/폐지 제품 등)
+
+---
+
+## 3. 매핑 예시: 계지
+
+```sql
+-- herb_masters: 공통명
+ingredient_code = '3033H1AHM', herb_name = '계지'
+
+-- herb_products: 제품들 (57개 제조사)
+  휴먼계지     rep: 8800624003904  std: 8800624003911 (500g)
+  대효계지     rep: 8800628002200  std: 8800628002224 (500g)
+  광명계지     rep: 8800640000505  std: 8800640000512 (500g)
+  ...
+
+-- medicine_master: 동일 대표코드로 매칭
+  휴먼계지     rep: 8800624003904  item_std: 200406389  category: 한약재
+  대효계지     rep: 8800628002200  item_std: 200406525  category: 한약재
+  ...
+```
+
+---
+
+## 4. 매핑 SQL
+
+### 특정 약재의 전체 제품 + 의약품 마스터 정보 조회
+```sql
+SELECT hm.herb_name AS 공통명,
+       hp.product_name, hp.company_name,
+       hp.representative_code, hp.standard_code,
+       mm.spec, mm.form_type, mm.package_type,
+       mm.item_std_code, mm.category
+FROM herb_masters hm
+JOIN herb_products hp ON hp.ingredient_code = hm.ingredient_code
+LEFT JOIN med_master.medicine_master mm
+  ON mm.representative_code = hp.representative_code
+  AND (mm.cancel_date IS NULL OR mm.cancel_date = '')
+WHERE hm.herb_name = '계지';
+```
+
+### herb_items(보유 약재) → 의약품 마스터 연결
+```sql
+SELECT hi.herb_name, hi.ingredient_code,
+       mm.item_std_code, mm.representative_code, mm.standard_code,
+       mm.spec, mm.package_type
+FROM herb_items hi
+JOIN herb_products hp ON hp.ingredient_code = hi.ingredient_code
+JOIN med_master.medicine_master mm
+  ON mm.representative_code = hp.representative_code
+  AND mm.product_name = hi.herb_name
+WHERE mm.category = '한약재'
+  AND (mm.cancel_date IS NULL OR mm.cancel_date = '');
+```
+
+---
+
+## 5. 코드 체계 정리
+
+| 코드 | 출처 | 예시 | 설명 |
+|------|------|------|------|
+| `ingredient_code` | herb_masters | 3033H1AHM | 성분코드 (약재 공통) |
+| `product_code` | herb_products | 062400390 | 보험 제품코드 9자리 |
+| `representative_code` | 양쪽 | 8800624003904 | **대표 바코드 (매핑 키)** |
+| `standard_code` | 양쪽 | 8800624003911 | 규격별 바코드 |
+| `item_std_code` | medicine_master | 200406389 | 식약처 품목기준코드 |
+| `insurance_code` | herb_items | 062400390 | = product_code와 동일 체계 |
+
+---
+
+## 6. 활용 가능 시나리오
+
+1. **바코드 스캔 입고**: 제품 바코드(standard_code) → herb_products → ingredient_code → herb_items 자동 매칭
+2. **제품 비교**: 같은 ingredient_code의 다른 업체 제품 가격/규격 비교
+3. **마스터 검색 → 입고 연동**: 의약품 마스터에서 검색 → representative_code로 herb_products 조회 → 입고 등록
+4. **유효성 검증**: 취소(cancel_date) 제품 식별, 현행 유통 제품만 필터링
+
+---
+
+*최종 수정: 2026-02-19*
--- a/docs/경방신약_주문매핑_20260219.md
+++ b/docs/경방신약_주문매핑_20260219.md
@@ -0,0 +1,72 @@
+# 경방신약 주문 매핑 결과 (2026-02-19)
+
+## 조건
+- 제약사: 경방신약(주)
+- 규격: 500그램
+- 포장: 병/통
+- DB: medicine_master (의약품 표준코드)
+
+## 매핑 결과: 38/38건 전체 매칭 완료 (한방 OTC 37건 + 일반 OTC 1건)
+
+### 한방 OTC (37건) — 소계 1,531,300원
+
+| # | 주문 약품명 | 수량 | 단가(원) | 매칭 제품명 | 표준코드 | 비고 |
+|---|-----------|------|---------|-----------|---------|------|
+| 1 | 가미귀비탕 | 1 | 53,400 | 진경안신엑스과립(가미귀비탕엑스과립) | 8806613031439 | 500g 통 (수동매핑) |
+| 2 | 가미소요산 | 1 | 35,000 | 경방가미소요산엑스과립 | 8806613001012 | |
+| 3 | 가미온담탕 | 1 | 69,600 | 자양심간탕엑스과립(가미온담탕) | 8806613030616 | |
+| 4 | 갈근탕 | 1 | 27,700 | 치감엑스과립(갈근탕엑스과립) | 8806613032337 | |
+| 5 | 계지복령환 | 1 | 35,000 | 모시나엑스과립(계지복령환) | 8806613023816 | |
+| 6 | 곽향정기산 | 1 | 31,800 | 씨즌쿨엑스과립(곽향정기산) | 8806613027531 | |
+| 7 | 당귀작약산 | 1 | 36,200 | 경방당귀작약산엑스과립 | 8806613004716 | |
+| 8 | 대시호탕 | 1 | 37,300 | 경방대시호탕엑스과립 | 8806613004914 | |
+| 9 | 마행감석탕 | 1 | 28,500 | 사브엑스과립(마행감석탕) | 8806613025438 | |
+| 10 | 맥문동탕 | 1 | 35,800 | 윤폐탕엑스과립(맥문동탕엑스과립) | 8806613030234 | |
+| 11 | 반하백출천마탕 | 1 | 57,200 | 경방반하백출천마탕엑스과립 | 8806613007717 | |
+| 12 | 반하사심탕 | 1 | 49,000 | 스토마큐(반하사심탕엑스과립) | 8806613026541 | |
+| 13 | 방풍통성산 | 1 | 33,600 | 경방방풍통성산엑스과립 | 8806613008219 | |
+| 14 | 배농산급탕 | 1 | 26,700 | 오메가엑스과립(배농산급탕) | 8806613028439 | |
+| 15 | 보중익기탕 | 1 | 58,800 | 경방보중익기탕엑스과립 | 8806613008912 | |
+| 16 | 사물탕 | 1 | 35,000 | 경방사물탕엑스과립 | 8806613009612 | |
+| 17 | 소건중탕 | 1 | 25,000 | 포키드엑스과립(소건중탕) | 8806613033617 | |
+| 18 | 소경활혈탕 | 1 | 40,300 | 경방소경활혈탕엑스과립 | 8806613011110 | |
+| 19 | 소시호탕 | 1 | 55,000 | 정해탕(소시호탕엑스과립) | 8806613030937 | |
+| 20 | 소청룡탕 | 1 | 41,400 | 소폐탕엑스과립(소청룡탕) | 8806613026138 | 500g 통 (수동매핑) |
+| 21 | 시함탕 | 1 | 49,800 | 폐활탕엑스과립(시함탕) | 8806613033433 | |
+| 22 | 시호가용골모려탕 | 1 | 46,200 | 브아피엑스과립(시호가용골모려탕엑스) | 8806613024738 | |
+| 23 | 십미패독산 | 1 | 48,700 | 해스킨엑스과립(십미패독탕) | 8806613034430 | 산→탕 명칭차이 (수동매핑) |
+| 24 | 오령산 | 1 | 37,200 | 자리투엑스과립(오령산엑스과립) | 8806613030531 | |
+| 25 | 오적산 | 1 | 50,400 | 경방오적산엑스과립 | 8806613014814 | |
+| 26 | 용담사간탕 | 1 | 37,100 | 용패탕(용담사간탕엑스과립) | 8806613029436 | |
+| 27 | 월비가출탕 | 1 | 40,400 | 마이진탕엑스과립(월비가출탕) | 8806613023618 | |
+| 28 | 육미지황탕 | 1 | 40,300 | 경방육미지황탕엑스과립 | 8806613015613 | |
+| 29 | 인삼패독산 | 1 | 52,300 | 가쁘레엑스과립(인삼패독산) | 8806613000138 | 500g 통 (수동매핑) |
+| 30 | 자음강화탕 | 1 | 41,500 | 자활탕(자음강화탕엑스과립) | 8806613030715 | |
+| 31 | 저령탕 | 1 | 36,700 | 바디스엑스과립(저령탕엑스) | 8806613024332 | |
+| 32 | 청화보음탕 | 1 | 34,200 | 디휘버엑스과립(청화보음탕) | 8806613023038 | |
+| 33 | 팔미지황환 | 1 | 41,700 | 경방팔미지황환엑스과립 | 8806613019710 | |
+| 34 | 평위산 | 1 | 28,000 | 위제나과립(평위산엑스과립) | 8806613029818 | |
+| 35 | 향사육군자탕 | 1 | 58,400 | 스토비엑스과립(향사육군자탕) | 8806613026817 | |
+| 36 | 형개연교탕 | 1 | 35,600 | 노넥스엑스과립(형개연교탕) | 8806613022314 | |
+| 37 | 황련해독탕 | 1 | 40,500 | 오브스과립(황련해독탕엑스과립) | 8806613028613 | |
+
+### 일반 OTC (1건) — 소계 30,500원
+
+| # | 주문 약품명 | 수량 | 단가(원) | 매칭 제품명 | 표준코드 | 비고 |
+|---|-----------|------|---------|-----------|---------|------|
+| 1 | 미소그린에스과립 | 1 | 30,500 | 미소그린에스과립 | 8806613066615 | 420g 병. 한방 OTC 아님 |
+
+### 총액: 1,561,800원 (한방 OTC 1,531,300 + 일반 OTC 30,500)
+
+---
+
+### 수동 매핑 처리 완료 (4건)
+
+초기 자동매칭 시 누락되었으나, 수동 확인으로 전부 매칭 완료.
+
+| # | 주문 약품명 | 매칭 제품명 | 표준코드 | 사유 |
+|---|-----------|-----------|---------|------|
+| 1 | 가미귀비탕 | 진경안신엑스과립(가미귀비탕엑스과립) | 8806613031439 | 500g 통. 브랜드명이 달라 자동매칭 실패 |
+| 2 | 소청룡탕 | 소폐탕엑스과립(소청룡탕) | 8806613026138 | 500g 통. 포장이 "통"이라 "병" 필터에서 누락 |
+| 3 | 십미패독산 | 해스킨엑스과립(십미패독탕) | 8806613034430 | 500g 병. DB에 "산"이 아닌 "탕"으로 등록 |
+| 4 | 인삼패독산 | 가쁘레엑스과립(인삼패독산) | 8806613000138 | 500g 통. 포장이 "통"이라 "병" 필터에서 누락 |
--- a/docs/주문마이페이지.md
+++ b/docs/주문마이페이지.md
@@ -0,0 +1,59 @@
+약재명	보험코드	원산지	수량	단가	금액	현재고
+휴먼갈근
+갈근.각	062401050	한국	2500g	₩17	₩42,000	2500g
+휴먼감초
+감초.1호[야생](1kg)	062400740	중국	5000g	₩22	₩110,500	4610g
+휴먼건강
+건강	062400730	페루	5000g	₩12	₩62,000	4880g
+휴먼건강
+건강.土	062400730	한국	1500g	₩51	₩77,100	1390g
+휴먼계지
+계지	062400390	베트남	2500g	₩6	₩14,500	2500g
+휴먼구기자
+구기자(영하)(1kg)	062400090	중국	3000g	₩18	₩53,700	3000g
+휴먼길경
+길경.片[특]	062400980	중국	1500g	₩11	₩15,900	1500g
+휴먼대추
+대추(절편)(1kg)	062401120	한국	5000g	₩20	₩100,000	4650g
+휴먼마황
+마황(1kg)	062401400	중국	5000g	₩10	₩48,000	4970g
+휴먼반하생강백반제
+반하생강백반제(1kg)	062401790	중국	3000g	₩34	₩101,100	2850g
+휴먼백출
+백출.당[1kg]	062402150	중국	2000g	₩12	₩23,600	1560g
+휴먼복령
+복령(1kg)	062402310	중국	5000g	₩12	₩57,500	4760g
+휴먼석고
+석고[통포장](kg)	062402650	중국	4000g	₩5	₩18,800	4000g
+휴먼세신
+세신.中	062402860	중국	1500g	₩129	₩193,500	1500g
+신흥숙지황
+숙지황(9증)(신흥.1kg)[완]	060600050	중국	5000g	₩20	₩100,000	4360g
+휴먼오미자
+오미자<토매지>(1kg)	062402800	중국	2000g	₩18	₩35,000	2000g
+휴먼용안육
+용안육.名品(1kg)	062403120	태국	3000g	₩21	₩62,100	3000g
+휴먼육계
+육계.YB	062403210	베트남	2500g	₩15	₩36,500	2400g
+휴먼일당귀
+일당귀.中(1kg)	062403450	중국	5000g	₩13	₩64,500	4640g
+휴먼자소엽
+자소엽.土	062403350	한국	1500g	₩14	₩20,700	1410g
+휴먼작약
+작약(1kg)	062403380	한국	3000g	₩19	₩56,100	2460g
+휴먼작약주자
+작약주자.土[酒炙]	062403470	한국	1500g	₩25	₩36,900	1500g
+휴먼전호
+전호[재배]	062403490	중국	1500g	₩14	₩21,000	1500g
+휴먼지각
+지각	062402220	중국	1500g	₩10	₩15,000	1500g
+휴먼지황
+지황.건[회](1kg)	062402030	중국	1000g	₩12	₩11,500	1000g
+휴먼진피(陳皮)
+진피.비열[非熱](1kg)	062401950	한국	5000g	₩14	₩68,500	5000g
+휴먼창출
+창출[북창출.재배](1kg)	062401830	중국	3000g	₩14	₩40,500	3000g
+휴먼천궁
+천궁.일<토매지>(1kg)	062401810	중국	3000g	₩12	₩35,700	2560g
+휴먼황기
+황기(직절.小)(1kg)	062400040	중국	3000g	₩10	₩29,700	2500g