thug0bin/pharmacy-pos-qr-system

Fork 0

thug0bin 9531b74d0e feat: 환산계수 모달 구현 전 백업

2026-03-12 10:14:17 +09:00

5.6 KiB

Raw Blame History

건조시럽 환산계수 기능

개요

건조시럽(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>

응답 (성공):

{
  "success": true,
  "sung_code": "535000ASY",
  "conversion_factor": 0.11,
  "ingredient_name": "아목시실린수화물·클라불란산칼륨",
  "product_name": "일성오구멘틴듀오시럽 228mg/5ml"
}

응답 (데이터 없음/연결 실패):

{
  "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:

{
  "patient_name": "홍길동",
  "med_name": "오구멘틴듀오시럽",
  "dosage": 8,
  "frequency": 3,
  "duration": 5,
  "unit": "mL",
  "sung_code": "535000ASY"
}

Response:

{
  "success": true,
  "image": "data:image/png;base64,...",
  "conversion_factor": 0.11
}

라벨 출력 예시

환산계수가 있는 경우:

총120mL (13.2g)/5일분

환산계수가 없는 경우:

총120mL/5일분

코드 위치

수정된 파일

dbsetup.py - PostgreSQL 연결 관리
- DatabaseConfig.POSTGRES_URL 추가
- DatabaseManager.get_postgres_engine() 추가
- DatabaseManager.get_postgres_session() 추가
- DatabaseManager.get_conversion_factor(sung_code) 추가
app.py - 환산계수 조회 API
- GET /api/drug-info/conversion-factor/<sung_code>
pmr_api.py - 라벨 미리보기
- preview_label() - sung_code 파라미터 추가
- create_label_image() - conversion_factor 파라미터 추가

유료/무료 버전 구분 설계 (추후)

환산계수는 추후 유료 기능으로 분리 가능합니다.

설계 방안

라이선스 체크
- 환산계수 조회 전 라이선스 확인
- 무료 버전: conversion_factor: null 반환
- 유료 버전: 실제 값 반환
API 분리
- /api/drug-info/conversion-factor → 유료 전용
- 무료 버전은 API 자체를 비활성화
현재 구현
- 환산계수가 없어도 라벨 출력 정상 동작
- null 체크 후 기존 포맷 유지

예외처리

상황	동작
PostgreSQL 연결 실패	null 반환, 에러 로그
데이터 없음	null 반환
sung_code 미전달	환산계수 조회 skip
환산계수 0 또는 음수	적용 안 함 (기존 포맷)

테스트 방법

# 환산계수 조회 테스트
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	최초 구현

5.6 KiB Raw Blame History Unescape Escape