Excel 病歷資料 → FHIR R4 Bundle
研究型 proof-of-concept：把 XLS / XLSX / CSV / JSON 結構化成 HL7 FHIR R4 Bundle。 批次處理幾百個檔、Web Worker Pool 並行、結構驗證、PWA 離線。 面向研究者 / 學生 / 工程展示，不是診所即用工具。
🔒 檔案結構上不可能上傳 · Content Security Policy 鎖定 outbound · 瀏覽器內處理 · PWA 可離線安裝
💡 完整整理包內含：依 resource type 分組、依病人分組、統計報告 (README)、錯誤列表 (errors.csv)、未匹配範本 (unmatched.csv) ── 診所直接用這個。
🔐 加密匯出：用 AES-256-GCM + PBKDF2 加密 Bundle（passphrase 從不上傳）。 適合「下載後寄 email / 雲端備份」等需要傳輸的場景。 忘記 passphrase 就無法解開。
🏥 進階：上傳到 FHIR server（HAPI / 衛福部中台等）
把 Bundle POST 到 FHIR server，整合到大架構。本機測試請先跑
docker-compose up（內含 HAPI FHIR + PostgreSQL），啟動後 endpoint 是
http://localhost:8080/fhir。
預覽 JSON（前 5000 字）
使用方式
- 上傳檔案 / 資料夾
XLS / XLSX / CSV / JSON。可一次拖拉幾百個檔，或直接拖整個資料夾。每個 sheet / array 視為一個 dataset。
- 自動套用範本
依檔名與 sheet 名稱自動推薦對應 FHIR resource 範本（ExClinCalc / 健保處方箋 / KDIGO 體檢 四種）。Web Worker Pool 並行處理。
- 下載 FHIR Bundle
所有 resource 合併成單一 Bundle；或每檔分開、各自獨立的 Bundle 打包成 zip。
支援的 FHIR Resource（v1）
Patient· 身分、姓名、性別、生日、聯絡方式 · HL7 specEncounter· 就診紀錄、狀態、時間段 · HL7 specObservation· 檢驗值、生命徵象（LOINC 編碼） · HL7 spec
規劃中（v2 / v3）
Medication/Condition/Procedure- HL7 v2 message → FHIR R4
- 反向轉換：FHIR → XLS
- 對接 HAPI FHIR public test server 做 round-trip 驗證
- CLI 版本（給診所 IT 跑 batch script）
關於這個工具（定位與限制）
台灣衛福部正在推動以 FHIR R4 作為國家醫療資訊互通標準，目前中山、長庚、馬偕等示範醫院已導入； 未來政策路線圖涵蓋區域醫院與診所，但現階段仍處於少數大型醫院實作階段。
clinconvert 是研究型的 proof-of-concept ── 目的不是成為診所現用工具。真正的診所場景目前還沒在做 FHIR 轉檔， 而且醫療資料傳輸有嚴格的合規與加密要求，需要在更大的 HIS / EMR 架構下整合才能落實。
本工具聚焦的問題是「Excel 資料 → FHIR Bundle」的 pre-step ── 給整理輸入資料的研究者 / 學生用， 跟 FHIR server（如 HAPI）/ LLM 應用層的工具是不同層次、互補而非取代。 完整的開源生態系比較見 研究 note。
本工具的工程展示 / 研究議題：
- 7 個 plug-in interface（input / encryption / transport / auth / validator / audit / consent）── 模塊化 reference architecture、未來接合規層只換 module
- 瀏覽器本地處理 ── 對應「強調隱私的醫療資料應在 local 端處理」的設計原則、Content Security Policy 鎖定 outbound
- Web Crypto 零知識加密匯出 ── AES-256-GCM + PBKDF2 100k iter（OWASP 2023）
- HAPI FHIR server 對接 ── docker-compose.yml + 上傳面板、demo「整合到大架構」
- Web Worker Pool 並行 ── 探索 client-side 大批檔處理的可行界線
- 結構驗證 + Bundle reference integrity ── FHIR R4 必填、enum、cross-reference 完整性檢查
- STRIDE 威脅模型 ── ExClinCalc 已寫 24 威脅安全分析（公開文件）
⚠️ 正式臨床使用前需通過 HAPI FHIR validator 等專業驗證，並符合台灣個資法與醫療資訊相關規範。本工具不對輸出做臨床安全保證。
🤝 合作邀請
若有以下需求、歡迎來信討論：
- 補上 production 接口（HSM、HIPAA / 個資法 audit、SMART on FHIR OAuth2、醫院 HIS schema 對接） ── 我們可以一起做 Tauri 桌面版本，把這套架構真的落地到臨床環境
- 研究合作：FHIR pre-step / 多租戶醫療安全 / browser-only privacy 等議題
- FHIR Profile 定制（台灣 NHI / 機構特定 profile）
- 新 input adapter（HL7 v2、CCDA、Cerner / Epic schema）
📧 yuyulsc881209@icloud.com · 💻 GitHub Issues · 🌐 個人網站
📄 研究 note + 加密檔案解密工具 → Research / FHIR Pre-step