規格與設計稿落差清單：7 頁逐頁核對，標出「規格有但設計稿沒畫」與「設計稿有但規格沒寫」
prospec 流程進度
跨 repo 進度
design-spec-gap-audit
規格與設計稿落差清單 — 2026-08-23 逐頁核對 這張卡不含功能需求，只記錄「規格寫的」與「設計稿畫的」對不上的地方，供團隊決定要補設計稿、補規格、還是排除在本期範圍外。處置完即可歸檔。
Background
2026-08-22 團隊會議後，規格陸續補上決議。核對時發現規格與設計稿（M+ Admin 原型，7 頁）有多處對不上——有些是規格寫了設計稿沒畫的功能，有些是設計稿畫了但規格完全沒提。
原本這些落差散落在各張 change 的 Open Questions 裡，難以一眼看出全貌。集中成這張卡。
原則：以規格為主。 設計稿沒畫到的不代表不做，可能是要補設計稿。但需要團隊逐項確認，不能默認。
核對範圍
| 設計稿頁面 | 對應 change |
|---|---|
| 今日營運 | voucher-operational-reports US-1 |
| 顧客卡券 | manage-customer-vouchers |
| 歷史統計 | voucher-operational-reports US-2 |
| 月度財報 | voucher-operational-reports US-3 |
| 顧客管理 | 無對應 change |
| 卡券方案 | manage-voucher-products |
| 帳號與權限 | manage-account-permissions |
📌 2026-08-24 處置進度：17 項中 15 項已決議
決議者 項目 Jacky（2026-08-24） A-1 做、A-2 CSV、A-4 照設計稿、B-1 本期不做、C-1～C-6 Ci（2026-08-24） A-3 補進規格、B-2 用文字計數、B-3 不做、B-4 不做、B-5 只做 CSV 未決 A-1 的個資與行銷同意處理方式（已移入 manage-customer-profiles的 Open Questions）
A. 設計稿有，規格完全沒寫（需補規格）
A-1【重大】「顧客管理」整頁沒有規格
側邊欄 7 個功能頁裡，這頁完全沒有對應的變更單。設計稿內容：
- 三格統計：顧客總數、LINE 註冊人數、帳號註冊人數
- 顧客清單欄位：姓名、註冊方式（LINE／帳號）、手機、Email、性別、生日、地址、是否同意行銷、持有卡券數（含使用中張數）
- 操作：新增顧客、編輯、匯出名單、搜尋、依註冊方式篩選、分頁
⚠️ 這頁涉及個資（手機／Email／生日／地址）與行銷同意紀錄，處理方式需要另外確認法遵要求，不是單純的 CRUD 頁面。
✅ 2026-08-24 Jacky 決議：要做。 依畫面開發，主要呈現資料庫中現有的會員資訊，可透過手機／姓名／會員卡號搜尋顧客並呈現其資訊。需新開一張 change。
⚠️ 仍未決：個資（手機／Email／生日／地址）與「是否同意行銷」的處理方式未答——誰能看、是否需要存取紀錄、行銷同意如何使用。
A-2 四個匯出功能規格都沒寫
| 頁面 | 按鈕 |
|---|---|
| 卡券方案 | 匯出清單 |
| 顧客卡券 | 匯出名單 |
| 今日營運 | 匯出今日報表 |
| 顧客管理 | 匯出名單 |
只有月度財報的匯出寫進了規格（voucher-operational-reports FR-004）。
✅ 2026-08-24 Jacky 決議：四個匯出一律輸出「格式化的 CSV」。 連帶確定月度財報不做 Excel 格式（見 B-5）。
附帶好處：卡券方案頁同時有「匯入清單(.csv)」與「匯出清單」，匯出的格式就是匯入的範本，原本「匯入的欄位格式與範本要另外定義」的問題自動解決。
A-3 今日營運的「即時更新」按鈕
規格只寫「系統自動計算今日至今的資料」，沒提到手動觸發更新的入口。
✅ 2026-08-24 Ci 決議：直接補進規格（Jacky 未特別答覆此項，屬設計稿已有的小功能，照做）。
A-4 今日營運明細的搜尋與篩選
設計稿有「搜尋顧客、卡券序號或服務人員」＋「全部類別」＋「全部專員」兩個下拉。規格的 US-1 完全沒提。
✅ 2026-08-24 Jacky 決議：依設計稿開發。
B. 規格有，設計稿沒畫（需補設計稿或排除）
B-1【重大】權限頁的規格遠大於設計稿
manage-account-permissions 寫了一整套帳號管理，但設計稿只有兩個區塊。
| 規格寫的 | 設計稿 |
|---|---|
| 三張角色 KPI 卡（管理員／設計師／顧客帳號數） | ❌ 沒有 |
| 搜尋框（姓名／英文名／Email／手機／帳號 ID） | ❌ 沒有 |
| 統一帳號列表，含顧客 | ❌ 只有設計師清單 |
| 列表欄位：頭像、姓名/英文名、角色標籤、聯絡方式、職稱/備註、最後登入、啟用狀態 | ❌ 只有：姓名、UUID、操作 |
| US-3 權限對照表視窗（四大群組 ✓／—） | ❌ 整個 Story 沒畫 |
| 管理員之間可互改共用密碼 | ⚠️ 設計稿是單一管理員帳號 + 「變更密碼」 |
設計稿實際結構：
- 管理員帳號：單一帳號（顯示姓名、上次登入）、「變更密碼」、提示「密碼異動後需要重新登入」
- 設計師管理：共用密碼列（遮蔽顯示＋顯示切換）、「變更共用密碼」、「新增設計師」、設計師清單（姓名／UUID／編輯／移除）
設計稿上的說明文字：「所有設計師使用同一組密碼登入，開卡辨識以 UUID 區分／操作設計師」
→ 這回答了「共用密碼怎麼知道是誰開的卡」：靠 UUID。規格完全沒提到 UUID 這個機制。
✅ 2026-08-24 Jacky 決議：本期不做。 權限頁縮到設計稿範圍——只有「管理員帳號（單一）」與「設計師管理（共用密碼＋UUID 清單）」兩區。
規格中的角色 KPI 卡、搜尋框、顧客帳號管理、權限對照表視窗（US-3）皆標為本期不做，保留於規格供日後參考。
注意：此處「不做顧客管理」指的是權限頁裡的顧客帳號管理（密碼、啟用狀態），與 A-1 的獨立「顧客管理」頁是兩件事，後者要做。
B-2 顧客卡券頁的 KPI 卡
規格 FR-003 要求「頁面上方顯示『流通中卡券數』與『剩餘未核銷金額』」，設計稿只有標題列的文字計數「共 18 張卡券 · 已篩選 18 筆」。
✅ 2026-08-24 Ci 決議：以設計稿為準，改為標題列文字計數，不做 KPI 卡。
B-3 今日營運的「需要關注」面板
規格 US-1 有這個面板（剩餘次數 < 2 的提醒），設計稿沒有。 （「續卡記事」已於 2026-08-22 依 Jacky 決議移除，但剩餘次數提醒仍在規格中。）
✅ 2026-08-24 Ci 決議：本期不做，整塊面板已自 voucher-operational-reports 移除。
B-4 歷史統計的 30 日趨勢圖
規格 US-2 要求「底部顯示最近 30 日『販賣 vs 使用』雙曲線」，設計稿沒有這張圖。
✅ 2026-08-24 Ci 決議：本期不做，已自 voucher-operational-reports 移除。
B-5 月度財報的 Excel 匯出
規格 FR-004 要求 CSV 與 Excel 兩種格式，設計稿只有一個「匯出月度財報」按鈕。
✅ 2026-08-24 決議：只做 CSV（依 Jacky 對 A-2 的答覆「會出成格式化的 csv 資訊」），Excel 格式不做。
C. 兩邊都有，但描述對不上（需統一）
| # | 項目 | 規格寫的 | 設計稿 |
|---|---|---|---|
| C-1 | 歷史統計的三個指標名稱 | 販賣／使用／剩餘金額 | 開卡／核銷／未使用金額 |
| C-2 | 顧客卡券的狀態值 | 未定義 | 使用中／已用畢／已退費 |
| C-3 | 今日營運的兩份明細 | 兩份清單並列 | 分頁切換（今日核銷明細／今日開卡明細） |
| C-4 | 月度財報的趨勢圖 | 雙長條圖 | 雙折線圖 |
| C-5 | 時段核銷分布的標示 | 峰值單筆金額 | 峰值單時段金額 |
| C-6 | 設計師身分識別 | 未提及 | UUID（開卡時據此辨識操作者） |
✅ 2026-08-24 Jacky 決議：全部六項以設計稿為準。
- C-1／C-2／C-4／C-5：直接改規格用詞，已完成
- C-3：採分頁切換（今日核銷明細／今日開卡明細）
- C-6：採 UUID，開卡時據此辨識操作者
處置建議
| 類別 | 項目 | 狀態 |
|---|---|---|
| 補規格 | A-2 四個匯出（CSV）、A-3 即時更新、A-4 明細搜尋篩選 | ✅ 已補 |
| 補規格 | C-1／C-2／C-4／C-5 用詞統一 | ✅ 已改 |
| 補規格 | C-3 分頁切換、C-6 UUID 機制 | ✅ 已補 |
| 新開 change | A-1 顧客管理頁 | ✅ 已建立 manage-customer-profiles |
| 縮範圍 | B-1 權限頁本期不做的部分 | ✅ 已於 manage-account-permissions 標記 |
| 移出本期 | B-2 KPI 卡、B-3 關注面板、B-4 趨勢圖、B-5 Excel | ✅ 已移除 |
Open Questions
-
A-1 顧客管理頁本期是否納入範圍— 2026-08-24 Jacky：要做，依畫面開發，可用手機／姓名／會員卡號搜尋 - NEEDS CLARIFICATION（A-1 未答部分）: 顧客管理頁的個資（手機／Email／生日／地址）與「是否同意行銷」欄位——誰有權限查看？是否需要存取稽核紀錄？行銷同意的用途與撤回機制為何？
-
B-1 權限頁以規格為準還是設計稿為準— 2026-08-24 Jacky：本期不做，縮到設計稿範圍 -
B-2～B-5 四項規格有設計稿沒有的功能— 2026-08-24 決議全部本期不做 -
C-3 今日營運的兩份明細如何呈現— 分頁切換 -
C-6 設計師 UUID 機制— 開卡時據 UUID 辨識操作者；細部定義（UUID 從哪來、開卡時如何選擇、是否對顧客可見）留待/prospec-plan
Constitution Check
- Reviewed against
prospec/CONSTITUTION.md - P1（owl 是產品層）：PASS — 本卡只盤點規格與設計的一致性，未涉及實作
- P2（契約意圖在 owl、實體在 cockatiel）：PASS — 無實作指定
- P3/P4（兩軌分離、協調點）：PASS — 本卡即為協調點的顯性化
UI Scope
Scope: none
（本卡為規格盤點，不產生新畫面。）