GX-中醫藥大學策略聯盟醫院-亞大醫院

[v0.26.09.1702] 2026-09-17¶

文件與 API 文件 (Swagger)¶

• Swagger 中文註解全面補齊：
  • 於 Program.cs 啟用 c.EnableAnnotations() 支援控制器與模型 Swagger 標籤。
  • 成人健檢模組全面補齊繁體中文 API 摘要（Summary）、參數說明與標準回傳格式描述：
    • AdultHealthCheckCaseController.cs：個案詳情查詢、個案建立、單表儲存/送出、整份健檢批次送出與歷史比對端點。
    • AdultHealthCheckResultController.cs：健檢完整結果查詢端點。
    • AdultHealthCheckOutputPdfController.cs：成人健檢三頁式 PDF 匯出與下載端點。
    • AdultHealthCheckReviewController.cs：醫師與個管師表單審查、數位簽章送出與覆核狀態端點。
    • AdultHealthCheckImportController.cs：Excel 批次匯入檢驗與建案端點。

套件與建置環境 (Playwright)¶

• PDF 渲染驅動套件：於 WebApi.csproj 新增 Microsoft.Playwright (v1.62.0) 套件依賴，確保後端三頁式成人健檢 PDF 輸出之渲染核心正常運作。

[v0.26.09.1701] 2026-09-17¶

新增 (成人健檢 AI 判讀諮詢 Evaluate API 串接與背景即時觸發)¶

• 外部 AI 服務串接：新增 IEvaluateApiClient 與 EvaluateApiClient，串接成人健檢外部 AI 判讀端點（POST /api/v1/adult-health-check/evaluate），支援連線逾時、批次量設定與敏捷指數退避重試機制（300ms ➔ 600ms ➔ 1200ms）。
• AI 諮詢衛教服務與資料落盤：新增 IAdultHealthCheckAiConsultationService 與 AdultHealthCheckAiConsultationService，綜整前三張表單（問卷、身體檢查、實驗室）為結構化 JSON Payload，並於 AI 判讀完成後自動寫入第四張表單健康諮詢（ADULT_HEALTH_CHECK_COUNSELING）衛教指導項目與內容。
• 實驗室表單即時非同步觸發：修改 AdultHealthCheckCaseService.SaveFormAsync，當送出實驗室檢查（ADULT_HEALTH_CHECK_LABORATORY 且 isFinalSubmit = true）交易成功後，立即透過 IServiceScopeFactory 建立獨立 Scope 於背景非同步啟動 AI 分析與結果產生，前端請求零等待、即刻回傳。
• 組態設定與 DI 注入：於 appsettings.json 與 appsettings.Development.json 新增 EvaluateApiConfig，並於 Program.cs 完成 DI 註冊。

[v0.26.09.1816] 2026-09-18¶

修復 (照護評估單服務範圍鎖定與問卷去重)¶

• 修正 CooperatorAssessmentFormService 與 CitizenAssessmentFormService：將成人健檢等獨立評估服務（ADULT_HEALTH_CHECK）依 Id 進行 Bundle 範圍隔離，避免因相同 Code 導致跨服務範本自動建檔與問卷重複查詢（10 筆）。
• 於個管師端取得填寫頁表單時加入 FormTemplateId 去重機制，杜絕重複問卷顯示。

[v0.26.09.1812] 2026-09-18¶

報表與輸出 (PDF / HTML 高清 Logo 最佳化)¶

• 成人健檢報告 Logo 標楷體高清向量化 (方案 B)：
  • 依據官方標準 header_logo.png 字型風格，精準採用 Windows 官方標準標楷體（kaiu.ttf）與 Arial 粗體，以官方深藍配色（#00418D）及 1016x1018 高清院徽，重新封裝為 4K Retina 超高解析度 SVG Logo。
  • 於 template.html 將 Logo 樣式固定為 height: 35px; width: auto;，確保三頁 A4 報表之垂直高度與版面完全不跑版。
  • 於 PlaywrightAdultHealthCheckPdfRenderer.cs 啟用 DeviceScaleFactor = 2 視網膜光柵化渲染，徹底解決 PDF 與 HTML 預覽時 Logo 與文字邊緣模糊、毛邊問題。

[v0.26.09.1811] 2026-09-18¶

CI/CD 與部署 (Playwright Chromium 瀏覽器)¶

• 修正 IIS 網站目錄 Playwright Chromium 自動安裝邏輯：

[v0.26.09.1811] 2026-09-18¶

CI/CD 與部署 (Playwright Chromium 瀏覽器)¶

• 修正 IIS 網站目錄 Playwright Chromium 自動安裝邏輯：
  • 修改 .github/workflows/dev.yml，移除在暫存發布目錄之錯誤安裝步驟。
  • 改為在所有檔案複製至 IIS 站台目錄（$sitePath）後、IIS 上線前，直接在網站目錄設定 $env:PLAYWRIGHT_BROWSERS_PATH = "0" 並執行 playwright.ps1 install chromium。
  • 確保無頭瀏覽器實體檔案完整就定位於 $sitePath\.playwright\package\.local-browsers\，徹底解決成人健檢 PDF 報表產製時拋出 Executable doesn't exist 的錯誤。

修復 (成人健檢個案關聯)¶

• 修正一般表單同步時 AssessmentServiceId 誤填：
  • 修正 CooperatorAssessmentFormService.cs，將 AdultHealthCheckCase.AssessmentServiceId 賦值由 assessmentService.Id（實例流水號）更正為 assessmentService.ComprehensiveAssessmentId（評估專案範本主檔 ID）。
  • 確保與主範本綁定之成人健檢五張表單完全相符，避免後續產製 PDF 報表時表單關聯檢查失敗。