feat: 환산계수 모달 구현 전 백업
This commit is contained in:
thug0bin
193
docs/DRYSYRUP_CONVERSION.md
Normal file
193
docs/DRYSYRUP_CONVERSION.md
Normal file
@@ -0,0 +1,193 @@
|
||||
# 건조시럽 환산계수 기능
|
||||
|
||||
## 개요
|
||||
|
||||
건조시럽(dry syrup)은 물로 희석하여 복용하는 시럽 형태의 의약품입니다. 복용량을 mL로 표시하지만, 실제 약 성분의 양은 g(그램)으로 환산해야 정확합니다.
|
||||
|
||||
**환산계수(conversion_factor)**를 사용하여 총 복용량(mL)을 실제 성분량(g)으로 변환합니다.
|
||||
|
||||
### 예시
|
||||
- 오구멘틴듀오시럽 228mg/5ml
|
||||
- 환산계수: 0.11
|
||||
- 총량 120mL × 0.11 = **13.2g**
|
||||
|
||||
## 아키텍처
|
||||
|
||||
```
|
||||
┌─────────────────────────────────────────────────────────────┐
|
||||
│ Flask Backend (7001) │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ /api/drug-info/conversion-factor/<sung_code> │
|
||||
│ /pmr/api/label/preview (sung_code 파라미터 추가) │
|
||||
├─────────────────────────────────────────────────────────────┤
|
||||
│ DatabaseManager │
|
||||
│ ├── MSSQL (192.168.0.4) - PIT3000 │
|
||||
│ │ └── CD_GOODS.SUNG_CODE (성분코드) │
|
||||
│ ├── PostgreSQL (192.168.0.39:5432/label10) │
|
||||
│ │ └── drysyrup 테이블 (환산계수 23건) │
|
||||
│ └── SQLite - 마일리지 등 │
|
||||
└─────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
## 데이터베이스
|
||||
|
||||
### PostgreSQL 연결 정보
|
||||
```
|
||||
Host: 192.168.0.39
|
||||
Port: 5432
|
||||
Database: label10
|
||||
User: admin
|
||||
Password: trajet6640
|
||||
```
|
||||
|
||||
### drysyrup 테이블 스키마
|
||||
| 컬럼명 | 타입 | 설명 |
|
||||
|--------|------|------|
|
||||
| ingredient_code | VARCHAR | 성분코드 (SUNG_CODE와 매칭) |
|
||||
| conversion_factor | DECIMAL | 환산계수 (mL → g) |
|
||||
| ingredient_name | VARCHAR | 성분명 |
|
||||
| product_name | VARCHAR | 대표 제품명 |
|
||||
|
||||
### 매핑 관계
|
||||
- MSSQL `PM_DRUG.CD_GOODS.SUNG_CODE` = PostgreSQL `drysyrup.ingredient_code`
|
||||
|
||||
## API 명세
|
||||
|
||||
### 1. 환산계수 조회 API
|
||||
|
||||
**Endpoint:** `GET /api/drug-info/conversion-factor/<sung_code>`
|
||||
|
||||
**응답 (성공):**
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"sung_code": "535000ASY",
|
||||
"conversion_factor": 0.11,
|
||||
"ingredient_name": "아목시실린수화물·클라불란산칼륨",
|
||||
"product_name": "일성오구멘틴듀오시럽 228mg/5ml"
|
||||
}
|
||||
```
|
||||
|
||||
**응답 (데이터 없음/연결 실패):**
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"sung_code": "NOTEXIST",
|
||||
"conversion_factor": null,
|
||||
"ingredient_name": null,
|
||||
"product_name": null
|
||||
}
|
||||
```
|
||||
|
||||
> ⚠️ 연결 실패나 데이터 없음에도 에러 없이 null 반환 (서비스 안정성 우선)
|
||||
|
||||
### 2. 라벨 미리보기 API (확장)
|
||||
|
||||
**Endpoint:** `POST /pmr/api/label/preview`
|
||||
|
||||
**Request Body:**
|
||||
```json
|
||||
{
|
||||
"patient_name": "홍길동",
|
||||
"med_name": "오구멘틴듀오시럽",
|
||||
"dosage": 8,
|
||||
"frequency": 3,
|
||||
"duration": 5,
|
||||
"unit": "mL",
|
||||
"sung_code": "535000ASY"
|
||||
}
|
||||
```
|
||||
|
||||
**Response:**
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"image": "data:image/png;base64,...",
|
||||
"conversion_factor": 0.11
|
||||
}
|
||||
```
|
||||
|
||||
### 라벨 출력 예시
|
||||
|
||||
환산계수가 있는 경우:
|
||||
```
|
||||
총120mL (13.2g)/5일분
|
||||
```
|
||||
|
||||
환산계수가 없는 경우:
|
||||
```
|
||||
총120mL/5일분
|
||||
```
|
||||
|
||||
## 코드 위치
|
||||
|
||||
### 수정된 파일
|
||||
1. **dbsetup.py** - PostgreSQL 연결 관리
|
||||
- `DatabaseConfig.POSTGRES_URL` 추가
|
||||
- `DatabaseManager.get_postgres_engine()` 추가
|
||||
- `DatabaseManager.get_postgres_session()` 추가
|
||||
- `DatabaseManager.get_conversion_factor(sung_code)` 추가
|
||||
|
||||
2. **app.py** - 환산계수 조회 API
|
||||
- `GET /api/drug-info/conversion-factor/<sung_code>`
|
||||
|
||||
3. **pmr_api.py** - 라벨 미리보기
|
||||
- `preview_label()` - sung_code 파라미터 추가
|
||||
- `create_label_image()` - conversion_factor 파라미터 추가
|
||||
|
||||
## 유료/무료 버전 구분 설계 (추후)
|
||||
|
||||
환산계수는 추후 유료 기능으로 분리 가능합니다.
|
||||
|
||||
### 설계 방안
|
||||
1. **라이선스 체크**
|
||||
- 환산계수 조회 전 라이선스 확인
|
||||
- 무료 버전: `conversion_factor: null` 반환
|
||||
- 유료 버전: 실제 값 반환
|
||||
|
||||
2. **API 분리**
|
||||
- `/api/drug-info/conversion-factor` → 유료 전용
|
||||
- 무료 버전은 API 자체를 비활성화
|
||||
|
||||
3. **현재 구현**
|
||||
- 환산계수가 없어도 라벨 출력 정상 동작
|
||||
- null 체크 후 기존 포맷 유지
|
||||
|
||||
## 예외처리
|
||||
|
||||
| 상황 | 동작 |
|
||||
|------|------|
|
||||
| PostgreSQL 연결 실패 | null 반환, 에러 로그 |
|
||||
| 데이터 없음 | null 반환 |
|
||||
| sung_code 미전달 | 환산계수 조회 skip |
|
||||
| 환산계수 0 또는 음수 | 적용 안 함 (기존 포맷) |
|
||||
|
||||
## 테스트 방법
|
||||
|
||||
```bash
|
||||
# 환산계수 조회 테스트
|
||||
curl http://localhost:7001/api/drug-info/conversion-factor/535000ASY
|
||||
|
||||
# 존재하지 않는 코드 테스트
|
||||
curl http://localhost:7001/api/drug-info/conversion-factor/NOTEXIST
|
||||
|
||||
# 라벨 미리보기 테스트 (PowerShell)
|
||||
$body = @{
|
||||
patient_name = "홍길동"
|
||||
med_name = "오구멘틴듀오시럽"
|
||||
dosage = 8
|
||||
frequency = 3
|
||||
duration = 5
|
||||
unit = "mL"
|
||||
sung_code = "535000ASY"
|
||||
} | ConvertTo-Json
|
||||
|
||||
Invoke-RestMethod -Uri "http://localhost:7001/pmr/api/label/preview" `
|
||||
-Method Post -ContentType "application/json" -Body $body
|
||||
```
|
||||
|
||||
## 변경 이력
|
||||
|
||||
| 날짜 | 내용 |
|
||||
|------|------|
|
||||
| 2026-03-12 | 최초 구현 |
|
||||
Reference in New Issue
Block a user