EMS

討論 #1460

是由 陳國瑋 於 28 天 前更新

## 討論目的 

 確認 Dashboard mockup 既有「結算流程」區塊在正式 V1 的顯示與資料需求。本票只定義 Dashboard 的唯讀呈現，不修改既有結算、帳單或請款作業。 的顯示規則。本票目前只做需求釐清，不代表已確認要改版。 

 ## Source Mockup 原始內容（Source of Truth Truth） 

 Redmine attachment #1110 `a17-operations-dashboard.html` 的既有設計為「6 月結算流程」四步驟面板： 實際包含一個標題為「6 月結算流程」的四步驟面板： 

 1. Connector 結算。 結算：設備電量與費率計算，範例 `11 / 11`。 
 2. 門牌結算。 門牌結算：私人與公用費用歸戶，範例 `11 筆`。 
 3. 帳務覆核。 帳務覆核：範例 `7 paid・4 pending`，顯示「進行中」。 
 4. 發票結算。 發票結算：範例狀態 `draft`，顯示「未完成」。 

 附件中的月份與數字是展示假資料；正式功能必須由 API 回傳實際資料。 Mockup 另在 Needs Attention 區顯示「結算待確認／6 月帳務流程未完成」。附件中沒有名為「本月帳務摘要」的三行摘要卡。 

 ## BIL-DEC-001：V1 沿用 Mockup 四步驟結算流程 更正紀錄 

 **狀態：已確認（2026-09-03，Ken）** 2026-09-03 的前一版需求誤把 Agent 新提出的「本月帳務摘要」方案描述成 mockup 既有內容，造成 Ken 在錯誤前提下回覆同意。因此： 

 ### 使用者會看到什麼 

 - 保留 attachment #1110 的四列 layout、名稱與順序，不改成另一張「本月帳務摘要」卡。 前一版 `BIL-DEC-001` 不視為已確認，亦不得交付 FE／BE 實作。 
 - 標題格式維持「{資料月份} 結算流程」；顯示哪一個月份將另案逐題確認。 `cancelled` 顯示問題一併撤回，目前不需要回答。 
 - 四列顯示內容： 
   1. **Connector 結算**：設備電量與費率計算的完成數／總數。 
   2. **門牌結算**：完成歸戶的門牌結算筆數。 
   3. **帳務覆核**：既有 Billing status 數量，例如 paid／pending。 
   4. **發票結算**：既有 Invoice status，例如 draft／pending／settled。 Parent #1422 與架構票 #1424 已恢復為「帳務區塊待本票確認」。 
 - 假月份、假數字及假狀態全部改由正式 Dashboard API 提供。 
 - 提供前往既有帳務功能的導覽；每列的實際連結目標另案逐題確認。 本票維持 `New／0%`。 

 ### Backend 要開發的內容 ## 目前尚未定案 

 - 在 Dashboard overview read model 提供四列所需的唯讀彙整結果。 
 - 優先重用既有 settlement、billing、invoice repository／service 查詢概念，不複製帳務計算公式。 
 - Connector settlement、unit settlement、Billing status、Invoice status 必須分欄位回傳，不合併成新的共同業務狀態。 
 - 回傳資料月份、各列數值、原始 status code、顯示所需的 source status／updatedAt。 
 - 任一子來源失敗時，該區塊標示 partial／error，但不得拖垮 Dashboard 其他區塊。 
 - 所有查詢皆為 read-only；不得更新、重算或改變 settlement、billing、invoice、payment 狀態。 以下三個方向尚未選擇： 

 ### Frontend 要開發的內容 

 - 依 1. 完全沿用 attachment #1110 實作同一個四列 responsive 面板。 的四步驟「結算流程」。 
 - 將月份、數字、status 與完成／待處理樣式綁定正式 API，而不是保留 fixture。 2. 經 Ken 明確同意後，才簡化或修改該區塊。 
 - 補齊 loading、empty、partial、error 與 `null` 狀態；未知值不得顯示成 0 或已完成。 
 - 狀態同時以文字與視覺樣式表達，不只使用顏色。 
 - 導向既有 `/bill/list`／`/invoice/list`，Dashboard 本身不提供修改操作。 3. 從 Dashboard V1 移除此區塊。 

 ## V1 不開發 Backend／Frontend 狀態 

 在本票定案前： 

 - 不新增「本月帳務摘要」版型。 Backend 不固定新的 Billing Summary DTO 或 aggregation contract。 
 - 不新增帳務趨勢圖或歷史月份比較。 Frontend 不新增「本月帳務摘要」元件。 
 - 不在 Dashboard 顯示住戶或逐筆帳單清單。 既有帳務、結算、請款作業與 route 不變。 
 - 不在 Dashboard 提供付款、覆核、重算或修改 Invoice status。 
 - 不新增 Dashboard 專用帳務資料表、排程或 WebSocket。 最終需求文件與 mockup 暫不修改。 

 ## Acceptance Criteria 待確認事項 

 - [ ] 畫面保留四列及既定順序：Connector 結算、門牌結算、帳務覆核、發票結算。 
 - [ ] 展示月份、數字與狀態均由正式 API 提供，不殘留 A17 fixture。 
 - [ ] 四種資料語意不互相替代或混用。 
 - [ ] `null`／無資料與數值 0 有不同呈現。 
 - [ ] 單一帳務來源失敗時可顯示 partial，其他 Dashboard 區塊仍可使用。 
 - [ ] Dashboard 不送出任何帳務 mutation request。 
 - [ ] 可導向既有帳務頁。 

 ## 更正紀錄 

 2026-09-03 曾將 Agent 新提出的「本月帳務摘要」誤述為 mockup 內容；該版提案及 cancelled 顯示問題均已撤回。本決策以 V1 是否依 attachment #1110 的四步驟面板重新確認並取代前一版。 保留四步驟「結算流程」面板，只將假月份／假數字替換為正式 API 資料？ 

 ## 待確認事項 

 - [ ] 標題與資料應顯示「目前日曆月份」，還是「最近一個可結算月份」？ 
 - [ ] 四列各自應導向哪一個既有頁面？ 

 ## 需求管理狀態 

 - Parent：#1422 
 - Requirement status：**待確認** 
 - Confirmed decision：BIL-DEC-001 status：**待重新確認** 
 - Final specification：所有 Dashboard 區塊確認後再整併至 #1422 v1.0 文件 
 - Implementation tickets：需求鎖定後才建立 FE／BE／QA child issues

返回