快速開始 Quick Start
🟢 模式 A — 純擴充功能（最快，約 2 分鐘）
不會程式也能用，不需要 Docker / Node / 任何指令。
- 安裝擴充功能 —— 到 Chrome Web Store 按「加到 Chrome」，安裝後在工具列把 NHI-FHIR Bridge 釘上來。
- 取得資料 —— 點工具列圖示，popup 是四步驟精靈（預設「下載到電腦」）：
- ① 登入 —— 偵測你是否已在健康存摺分頁登入；沒有會帶你過去。
- ② 您的資料 —— 填性別 + 生日 + 姓名（三項必填）→「儲存資料」。身分證不用填（取得時自動帶入）。
- ③ 取得 —— 按「取得健康存摺資料」，約 40 秒（慢時可達 2 分鐘）後出現「下載健康紀錄檔」。勾「一併下載影像」會多花時間。
- ④ 查看（選用） —— 可把檔案拖進 醫析 MediPrisma 看圖表。
下載檔名範例：nhi-P12345XXXX-20250517-20260517-vX.Y.Z.json
:::tip 進階：手動安裝（開發者 / 最新版）
想用最新開發版或自己 build：到 GitHub Releases 下載 nhi-fhir-bridge-extension-vX.Y.Z.zip 解壓縮 → chrome://extensions → 開「開發人員模式」→「載入未封裝項目」→ 選裡面直接有 manifest.json 的資料夾。
:::
🔵 模式 B — 擴充功能 + 本機後端
需要把多次同步累積到本機 FHIR Server、用 Dashboard 看多病人、或一鍵 launch SMART App 時才需要。前置：安裝 Docker。
git clone https://github.com/voho0000/NHI-FHIR-BRIDGE.git
cd NHI-FHIR-BRIDGE
docker compose up -d
| 服務 | 網址 |
|---|---|
| Dashboard | http://localhost:3010 |
| 後端 FHIR API | http://localhost:8010 |
擴充功能 popup → 右上 ⚙️ 進階設定 → 勾「啟用本機伺服器模式」（Chrome 會跳權限視窗要求存取 localhost，按「允許」）。popup 上方出現綠色「🟢 已連線」才表示後端就緒。
之後同步會同時寫進後端 FHIR Store（Dashboard 立刻看到）並產生下載按鈕。Dashboard 每個病人可 Export / Launch（走完整 SMART on FHIR OAuth2）/ Delete。
:::warning 外部 SMART App 的 CORS
外部（非 localhost）SMART App —— 包含 GitHub Pages 上的 demo「醫析 MediPrisma」—— 需後端先設 SYNC_API_KEY 才拿得到 CORS（v0.18.4+）。
:::
環境變數（模式 B，全部選填）
本機自用直接 docker compose up -d 即可，不用設任何變數。需要時 cp .env.example .env 編輯：
| 變數 | 預設 | 用途 |
|---|---|---|
SYNC_API_KEY | （空） | 保護所有 PHI 端點。任何網路可達的部署必設 |
ALLOWED_EXTENSION_IDS | （空） | 允許走 CORS 的 chrome-extension ID（逗號分隔） |
BIND_HOST | 127.0.0.1 | 綁定 host；對 LAN 開放才設 0.0.0.0 |
FHIR_BASE_URL | http://localhost:8010/fhir | 對外公開的 FHIR base URL |
常見問題 Troubleshooting
- 同步顯示「0 筆」 —— 多半是健康存摺 session 過期（回該分頁重新登入再按一次），或日期範圍裡沒看病。
- 影像沒抓到 —— NHI 備圖需要時間；過幾分鐘再同步一次即可補齊。
- 模式 B 顯示「連不上本機伺服器」 —— 後端沒起、Backend URL 設錯、或剛啟動還在 migration（等 30 秒按「重試」）。
- 想清空重來 —— 模式 B：
docker compose down -v && docker compose up -d；模式 A：popup 下載按鈕旁的 🗑️ 清掉暫存。