本頁只練什麼
能固定三張 Sheet headers 與 row builder 順序。
欄序是 API、人工查帳與去重的共同契約。
要修改的檔案:files/starter/apps-script/SETUP.md
定位:先從 Orders 的 orderNo 逐欄比對到 itemsJson,再核對 Products 與 Contacts。|依 starter-1 定位,只修改「Products/Orders/Contacts Schema」的責任。
LESSON-27 · TOPIC 01
能固定三張 Sheet headers 與 row builder 順序。
能固定三張 Sheet headers 與 row builder 順序。
欄序是 API、人工查帳與去重的共同契約。
要修改的檔案:files/starter/apps-script/SETUP.md
定位:先從 Orders 的 orderNo 逐欄比對到 itemsJson,再核對 Products 與 Contacts。|依 starter-1 定位,只修改「Products/Orders/Contacts Schema」的責任。
先結果,再原理;完成後要能說出自己看見的證據。
學生正在累積 project/e-commerce,必須在不碰外部服務的前提下完成「Products/Orders/Contacts Schema」。
起始狀態:本地 fixture 已準備 Products/Orders/Contacts Schema 的最小資料,尚未執行驗收。
Products 6 欄、Orders 13 欄、Contacts 9 欄的名稱與順序完全一致。
驗收證據:count=3、uniqueCount=3、valid=true
第 23–28 章運動器材電商在修改 apps-script/SETUP.md/apps-script/Code.gs 時。
常見混淆:看到畫面不等於契約通過;仍要核對欄位、操作與證據。
這段程式是理解起點,不是要你直接跳過 Starter。
能固定三張 Sheet headers 與 row builder 順序。
正式說法:Spreadsheet schemas 是把 Products/Orders/Contacts Schema 的輸入、責任、輸出與證據固定成可重現契約。
Products: productId,name,image,price,salePrice,active;Orders: orderNo,submissionId,timestamp,buyer,gender,phone,address,email,subtotal,shipping,total,status,itemsJson;Contacts: contactNo,submissionId,timestamp,name,gender,phone,email,message,status每一步都留下可觀察結果;如果沒看到,先看「卡住先查」。
檔案:files/starter/apps-script/SETUP.md 定位:先從 Orders 的 orderNo 逐欄比對到 itemsJson,再核對 Products 與 Contacts。
要做:先重新載入 Starter,記錄目前畫面、DOM、Computed、Console 或文件內容。
預期:能指出「先從 Orders 的 orderNo 逐欄比對到 itemsJson,再核對 Products 與 Contacts。」目前的缺口。
證據:保存 files/starter/apps-script/SETUP.md 的目前狀態,並指出下一步只會修改哪個檔案責任。
卡住先查:確認開啟的是 files/starter/apps-script/SETUP.md,且定位到 先從 Orders 的 orderNo 逐欄比對到 itemsJson,再核對 Products 與 Contacts。。
檔案:files/starter/apps-script/SETUP.md 定位:先從 Orders 的 orderNo 逐欄比對到 itemsJson,再核對 Products 與 Contacts。
要做:逐張比較 header 與 row builder 索引,電話欄保留字串。
預期:Products 6 欄、Orders 13 欄、Contacts 9 欄的名稱與順序完全一致。
證據:count=3、uniqueCount=3、valid=true
卡住先查:先從 Orders 的 orderNo 逐欄比對到 itemsJson,再核對 Products 與 Contacts。
檔案:files/starter/apps-script/SETUP.md 定位:先從 Orders 的 orderNo 逐欄比對到 itemsJson,再核對 Products 與 Contacts。
要做:重新整理頁面,再逐項比對預期結果與 evidence。
預期:Products 6 欄、Orders 13 欄、Contacts 9 欄的名稱與順序完全一致。
證據:count=3、uniqueCount=3、valid=true
卡住先查:先從 Orders 的 orderNo 逐欄比對到 itemsJson,再核對 Products 與 Contacts。
這個示範只讓你看懂概念,不會替你修改 Starter,也不會自動宣告完成。
勾選只是學習紀錄;真正完成仍要回到 Starter 的實際結果。
方向提示:先只找出「Products/Orders/Contacts Schema」的輸入與可觀察輸出,不同時修改別的責任。
關鍵片段:Products: productId,name,image,price,salePrice,active;Orders: orderNo,submissionId,timestamp,buyer,gender,phone,address,email,subtotal,shipping,total,status,itemsJson;Contacts: contactNo,submissionId,timestamp,name,gender,phone,email,message,status
完整解答與原因:逐張比較 header 與 row builder 索引,電話欄保留字串。;驗收必須得到「count=3、uniqueCount=3、valid=true」,因為這項證據直接對應本 module 的成功條件。