LESSON-23 · TOPIC 03
Order 與 Contact 資料模型
能把訂單與聯絡的所有需求欄位分配給前端輸入、GAS 產生或 GAS 計算,並把技術欄位另列。
content-model運動器材電商需求、資料模型與驗收矩陣|Order 與 Contact 資料模型本頁只練一個責任
本頁只練什麼
能把訂單與聯絡的所有需求欄位分配給前端輸入、GAS 產生或 GAS 計算,並把技術欄位另列。
ownership 不清會讓前端偽造金額、後端漏存欄位或誤算需求數。
要修改的檔案:files/starter/data-contract.md
定位:先找 orderNo、buyer、gender、phone、address、email、subtotal、shipping、total、status 是否齊全。|依 starter-3 定位,只修改「Order 與 Contact 資料模型」的責任。
任務情境
先結果,再原理;完成後要能說出自己看見的證據。
現在的問題
學生正在累積 project/e-commerce,必須在不碰外部服務的前提下完成「Order 與 Contact 資料模型」。
起始狀態:本地 fixture 已準備 Order 與 Contact 資料模型 的最小資料,尚未執行驗收。
完成後要看到
訂單 10 個使用者必備欄與聯絡 5 個必備欄均可追蹤;submissionId、timestamp、itemsJson 另列為技術欄位。
驗收證據:count=15、uniqueCount=15、valid=true
何時會用到
第 23–28 章運動器材電商在修改 data-contract.md 時。
常見混淆:看到畫面不等於契約通過;仍要核對欄位、操作與證據。
觀念與最小範例
這段程式是理解起點,不是要你直接跳過 Starter。
Order 與 Contact 資料模型 Order and contact contracts
能把訂單與聯絡的所有需求欄位分配給前端輸入、GAS 產生或 GAS 計算,並把技術欄位另列。
正式說法:Order and contact contracts 是把 Order 與 Contact 資料模型 的輸入、責任、輸出與證據固定成可重現契約。
Order.subtotal/shipping/total 由 GAS 計算;Contact.message 對應內容。
三步完成本主題
每一步都留下可觀察結果;如果沒看到,先看「卡住先查」。
Step 1|先看見目前缺口,不急著貼答案。
檔案:files/starter/data-contract.md 定位:先找 orderNo、buyer、gender、phone、address、email、subtotal、shipping、total、status 是否齊全。
要做:先重新載入 Starter,記錄目前畫面、DOM、Computed、Console 或文件內容。
預期:能指出「先找 orderNo、buyer、gender、phone、address、email、subtotal、shipping、total、status 是否齊全。」目前的缺口。
證據:保存 files/starter/data-contract.md 的目前狀態,並指出下一步只會修改哪個檔案責任。
卡住先查:確認開啟的是 files/starter/data-contract.md,且定位到 先找 orderNo、buyer、gender、phone、address、email、subtotal、shipping、total、status 是否齊全。。
Step 2|只修改本主題的一個責任。
檔案:files/starter/data-contract.md 定位:先找 orderNo、buyer、gender、phone、address、email、subtotal、shipping、total、status 是否齊全。
要做:逐字對照需求,先驗訂單 10 欄,再驗聯絡 5 欄與 owner;最後另核對技術欄位。
預期:訂單 10 個使用者必備欄與聯絡 5 個必備欄均可追蹤;submissionId、timestamp、itemsJson 另列為技術欄位。
證據:count=15、uniqueCount=15、valid=true
卡住先查:先找 orderNo、buyer、gender、phone、address、email、subtotal、shipping、total、status 是否齊全。
Step 3|重新載入並以證據驗收,不以『看起來差不多』判定完成。
檔案:files/starter/data-contract.md 定位:先找 orderNo、buyer、gender、phone、address、email、subtotal、shipping、total、status 是否齊全。
要做:重新整理頁面,再逐項比對預期結果與 evidence。
預期:訂單 10 個使用者必備欄與聯絡 5 個必備欄均可追蹤;submissionId、timestamp、itemsJson 另列為技術欄位。
證據:count=15、uniqueCount=15、valid=true
卡住先查:先找 orderNo、buyer、gender、phone、address、email、subtotal、shipping、total、status 是否齊全。
觀察示範
這個示範只讓你看懂概念,不會替你修改 Starter,也不會自動宣告完成。
Order 與 Contact 資料模型runtime fixture · read-only demo
本主題示範畫面:
- Order.orderNo
- Order.buyer
- Order.gender
- Order.phone
- Order.address
- Order.email
- Order.subtotal
- Order.shipping
- Order.total
- Order.status
- Contact.name
- Contact.gender
- Contact.phone
- Contact.email
- Contact.message
驗收證據
勾選只是學習紀錄;真正完成仍要回到 Starter 的實際結果。
提示 1|方向
方向提示:先只找出「Order 與 Contact 資料模型」的輸入與可觀察輸出,不同時修改別的責任。
提示 2|關鍵片段
關鍵片段:Order.subtotal/shipping/total 由 GAS 計算;Contact.message 對應內容。
提示 3|完整解答與原因
完整解答與原因:逐字對照需求,先驗訂單 10 欄,再驗聯絡 5 欄與 owner;最後另核對技術欄位。;驗收必須得到「count=15、uniqueCount=15、valid=true」,因為這項證據直接對應本 module 的成功條件。