P1
US-1：查詢與維護顧客資料
manage-customer-profiles
As a 管理員, I want 搜尋顧客並查看、編輯他們的基本資料, So that 我能在顧客來電或到店時快速確認身分與聯絡方式.
Acceptance Scenarios
- WHEN 管理員開啟顧客管理頁, THEN 上方顯示三格統計：顧客總數、以 LINE 註冊的人數、以帳號註冊的人數
- WHEN 管理員在搜尋框輸入姓名、手機或會員編號, THEN 清單只留下符合的顧客
- WHEN 管理員點選「全部／LINE 註冊／帳號註冊」, THEN 清單依註冊方式篩選
- WHEN 清單顯示, THEN 每列有姓名、註冊方式、手機、Email、性別、生日、地址、是否同意行銷、持有卡券數（含使用中張數）
- WHEN 管理員點「編輯」, THEN 可修改該顧客的基本資料
- WHEN 管理員點「新增顧客」, THEN 可建立一筆新的顧客資料
- WHEN 管理員點「匯出名單」, THEN 下載目前篩選結果的顧客清單（格式化 CSV）
- WHEN 顧客數超過單頁可顯示的數量, THEN 提供分頁
Independent Test
用已知顧客的手機號搜尋，確認找得到且欄位正確；切換「LINE 註冊」篩選，確認清單與上方統計對得起來；編輯一筆資料後確認有存進去；匯出名單並確認中文不亂碼。
設計稿
顧客管理 — 三格統計、搜尋、註冊方式篩選、顧客清單、編輯、匯出名單
開啟互動原型 ↗
Edge Cases
- 同名顧客：清單需能以手機或會員編號分辨
- 沒有 Email 的顧客（LINE 註冊者常見）：欄位顯示「—」而非空白或錯誤
- 手機格式：輸入含或不含分隔線都要搜得到
- 顧客持有 0 張卡券：正常顯示 0，不是空白
- 刪除顧客：本期不提供刪除功能（設計稿只有編輯）。顧客資料涉及既有卡券與交易紀錄，刪除的連帶影響需另行評估
Functional Requirements
- FR-001: 提供顧客搜尋，支援姓名、手機（含／不含分隔線）、會員編號三種條件
- FR-002: 提供依註冊方式（全部／LINE 註冊／帳號註冊）的篩選
- FR-003: 頁面上方顯示三格統計：顧客總數、LINE 註冊人數、帳號註冊人數
- FR-004: 顧客清單欄位：姓名、註冊方式、手機、Email、性別、生日、地址、是否同意行銷、持有卡券數（含使用中張數）
- FR-005: 提供新增顧客與編輯顧客資料
- FR-006: 提供「匯出名單」，輸出格式化 CSV，內容為目前篩選結果
- FR-007: 清單支援分頁
- FR-008: 本期不提供刪除顧客
Open Questions
- NEEDS CLARIFICATION（個資處理，重要）: 這頁集中呈現手機、Email、生日、地址等個人資料——
- 哪些角色可以看到這頁？（推定僅管理員，待確認）
- 是否需要記錄「誰在什麼時候查看／匯出了顧客名單」的存取紀錄？
- 匯出的 CSV 含完整個資，是否需要額外的確認步驟或浮水印？
- NEEDS CLARIFICATION（行銷同意）: 「是否同意行銷」這個欄位——
- 顧客在哪裡表示同意？（註冊時？另有同意書？）
- 管理員可以在這頁修改它嗎，還是唯讀？
- 顧客要撤回同意時走什麼流程？
- NEEDS CLARIFICATION: 「會員編號」與顧客卡券頁的「卡券序號（MP-…）」是不同的東西，會員編號的格式與產生規則需確認
- NEEDS CLARIFICATION: 新增顧客時，哪些欄位必填？手機是否需要驗證唯一性？