腎入學習 — 兒童 CKD 教學門診

Tags: Vue 3, TypeScript, Vite, Supabase, Vitest, Vercel

緣由

兒童慢性腎臟病的衛教多半停留在紙本與口頭說明，門診時間有限，學員與家屬難以確認「學會了沒有」。臺北榮總兒童免疫腎臟科的教學門診希望有一個能在診間或課後使用的工具，讓學習成效可以被看見、被比較，也能作為教學評比的佐證。

第一版是只有五題前後測的純前端網站；2026 下半年擴充成完整的臨床教學平台。

學習流程

1. 課前檢測：15 題、五大知識面向（腎功能計算、分期判讀、常見病因、合併症辨識、治療選擇）各 3 題，找出自己的起點。
2. 教學門診：輸入病人數據，練習判讀 CKD 分期，產生門診報告。
3. 檢驗判讀練習：100 位合成模擬病人，每例先看身高體重、腎功能與尿液、血壓電解質、貧血與骨礦物質等數據，再完成 9 項判斷，提交後看解析；錯題可重練、可下載備份與產生報告。
4. 臨床推理任務：與模擬病童及母親問診，在不同資訊階段記錄假說、證據與修正；核心檢驗在第一次推理快照後才揭露，練習「依新資料重新排序假說」。
5. 課後評估：回測檢視自己的進步。

教師端與帳號

• 學員以 邀請碼 註冊雲端帳號，測驗與推理紀錄完成後可提交到班級；教師資格由管理者指派。
• 教師後台可搜尋學員、檢視原始作答快照，以 六維量規 評分，給分必須引用學員原文；每次發布保留為新版本，另有不納入平均的「安全覆核」。
• 舊版本機紀錄不會自動歸屬到新帳號，避免資料錯置。
• 「功能展示」頁用展示帳號與虛構同學呈現前後測、門診報告與教師報表，不顯示真實學員資料（下圖皆為模擬資料）。

歷史成績與學習資源

• 舊五題版（滿分 10 分）歷史原始成績：前測 166 筆、平均 6.14／中位數 6；後測 162 筆、平均 7.98／中位數 8。以分布圖與百分位表呈現，並註明前後測非配對、樣本單位是作答筆數。
• 學習資源依五大面向整理 PubMed 文獻與臨床指引（Schwartz 公式、CKiD U25、KDIGO 2024 等），每筆標註出處、年份與查核日期。

技術

• 前端：Vue 3 + TypeScript + Vite，hash 路由、頁面按需載入
• 後端：Supabase（Email 帳號、資料表與 RPC：班級、邀請碼、門診報告、作答與評分版本）
• 圖表：自繪 SVG 雷達圖與分布圖元件
• 測試：Vitest、vue-tsc 型別檢查
• 資料處理：Python 把歷史 Excel 轉成匿名統計（僅分布、平均、中位數）
• 部署：Vercel；頁尾顯示建置版本與更新歷程
• 模型：臨床推理使用 規則式腳本，確保回覆與病例設定一致，尚未連接生成式 AI

限制

• 模擬病人與檢驗資料為純合成教學資料，非真實病人或盛行率，不作醫療用途。
• 練習進度存在瀏覽器，跨裝置不同步；需要保存的紀錄要提交到雲端帳號或下載備份。
• 規則式問診遇到未辨識的問句只會給中性回覆。

連結

• 線上網站：https://frontend-two-chi-30.vercel.app/
• 原始碼：私有儲存庫（未公開）