LESSON-26 · TOPIC 03
能以 form-urlencoded 的 action=createOrder 與 payload JSON 字串傳 submissionId、五個購買人欄位與 items。
能以 form-urlencoded 的 action=createOrder 與 payload JSON 字串傳 submissionId、五個購買人欄位與 items。
訂單路由與輸入必須完整，但前端金額不得成為保存依據。
要修改的檔案：files/starter/apps-script/Code.gs
定位：先確認 action 與 payload 是 form-urlencoded 參數，items 僅含 productId/qty。｜依 starter-3 定位，只修改「訂單 POST 契約」的責任。
先結果，再原理；完成後要能說出自己看見的證據。
學生正在累積 project/e-commerce，必須在不碰外部服務的前提下完成「訂單 POST 契約」。
起始狀態：本地 fixture 已準備 訂單 POST 契約 的最小資料，尚未執行驗收。
createOrder 的八個輸入責任完整，不含可信任的 total。
驗收證據：count=8、uniqueCount=8、valid=true
第 23–28 章運動器材電商在修改 js/checkout.js／apps-script/Code.gs 時。
常見混淆：看到畫面不等於契約通過；仍要核對欄位、操作與證據。
這段程式是理解起點，不是要你直接跳過 Starter。
能以 form-urlencoded 的 action=createOrder 與 payload JSON 字串傳 submissionId、五個購買人欄位與 items。
正式說法：Order POST contract 是把 訂單 POST 契約 的輸入、責任、輸出與證據固定成可重現契約。
new URLSearchParams({ action:'createOrder', payload:JSON.stringify({ submissionId,buyer,gender,phone,address,email,items:[{ productId,qty }] }) })每一步都留下可觀察結果；如果沒看到，先看「卡住先查」。
檔案：files/starter/apps-script/Code.gs 定位：先確認 action 與 payload 是 form-urlencoded 參數，items 僅含 productId/qty。
要做：先重新載入 Starter，記錄目前畫面、DOM、Computed、Console 或文件內容。
預期：能指出「先確認 action 與 payload 是 form-urlencoded 參數，items 僅含 productId/qty。」目前的缺口。
證據：保存 files/starter/apps-script/Code.gs 的目前狀態，並指出下一步只會修改哪個檔案責任。
卡住先查：確認開啟的是 files/starter/apps-script/Code.gs，且定位到 先確認 action 與 payload 是 form-urlencoded 參數，items 僅含 productId/qty。。
檔案：files/starter/apps-script/Code.gs 定位：先確認 action 與 payload 是 form-urlencoded 參數，items 僅含 productId/qty。
要做：展開 Network Form Data，先核對 action/payload，再 JSON.parse payload 核對 keys。
預期：createOrder 的八個輸入責任完整，不含可信任的 total。
證據：count=8、uniqueCount=8、valid=true
卡住先查：先確認 action 與 payload 是 form-urlencoded 參數，items 僅含 productId/qty。
檔案：files/starter/apps-script/Code.gs 定位：先確認 action 與 payload 是 form-urlencoded 參數，items 僅含 productId/qty。
要做：重新整理頁面，再逐項比對預期結果與 evidence。
預期：createOrder 的八個輸入責任完整，不含可信任的 total。
證據：count=8、uniqueCount=8、valid=true
卡住先查：先確認 action 與 payload 是 form-urlencoded 參數，items 僅含 productId/qty。
這個示範只讓你看懂概念，不會替你修改 Starter，也不會自動宣告完成。
勾選只是學習紀錄；真正完成仍要回到 Starter 的實際結果。
方向提示：先只找出「訂單 POST 契約」的輸入與可觀察輸出，不同時修改別的責任。
關鍵片段：new URLSearchParams({ action:'createOrder', payload:JSON.stringify({ submissionId,buyer,gender,phone,address,email,items:[{ productId,qty }] }) })
完整解答與原因：展開 Network Form Data，先核對 action/payload，再 JSON.parse payload 核對 keys。；驗收必須得到「count=8、uniqueCount=8、valid=true」，因為這項證據直接對應本 module 的成功條件。