ATC 診所藥物分類系統 (ATC Clinic Drug System)

這是一個專為診所設計的藥物管理與 ATC 分類系統。提供直觀的樹狀分類瀏覽、詳細的藥物網格視圖，以及 AI 輔助的藥物摘要功能。

🎯 主要功能

• ATC 藥物分類樹 (ATC Tree View)

  • 完整呈現 5 層 ATC 架構。
  • 專注模式 (Focus Mode)：展開主分類時自動隱藏其他無關分類，保持介面清爽。
  • 支援延遲加載 (Lazy Loading) 以優化效能。

• 直觀的藥物瀏覽 (Detailed Grid View)

  • 全大類預覽：上方分類區自動調整高度，一次預覽所有 14 大類 (A-V)。
  • 智慧網格排列：
    • 藥物數量少時 (<5) 單列顯示。
    • 數量多時 (6-10) 自動切換為雙列顯示。
  • 詳細卡片：顯示藥代碼、中文名稱、成分劑量。

• AI 藥物摘要 (AI Summary)

  • 藥物卡片標題列整合 🤖 AI 摘要按鈕。
  • 點擊即彈出可滾動的視窗，查看該藥物的詳細 AI 分析筆記。

• 藥物管理

  • 新增藥物：支援手動輸入 AC 代碼新增。
  • 刪除藥物：直接從列表中移除藥物。
  • 批量導入：支援上傳 CSV 檔案批量匯入藥物資料。

🛠️ 技術棧

• Backend: Python (Flask), SQLite
• Frontend: Vanilla JavaScript, HTML5, CSS3 (Modern Flexbox/Grid)
• Tooling: uv (Python Package Manager)

🚀 快速開始

1. 安裝依賴

本專案使用 uv 進行套件管理。

# 安裝依賴
uv sync

2. 初始化資料庫

系統首次啟動時會自動建立 SQLite 資料庫。如果需要重新初始化：

# 也會在 app 啟動時自動檢查
uv run run.py

3. 啟動應用程式

uv run run.py

啟動後，瀏覽器將自動開啟 http://127.0.0.1:5000。

📂 專案結構

• src/: 後端原始碼 (Flask API, Services, Models)
• frontend/: 前端資源 (HTML, CSS, JS)
• data/: 資料庫與上傳檔案儲存位置
• logs/: 系統日誌

🔗 資源

• GitHub Repository: ATCcodeTW