LESSON-27 · TOPIC 01

Products/Orders/Contacts Schema

能固定三張 Sheet headers 與 row builder 順序。

code-editSheet Schema、權威計價、去重與完整狀態|Products/Orders/Contacts Schema本頁只練一個責任

本頁只練什麼

能固定三張 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。

Products/Orders/Contacts Schema Spreadsheet schemas

能固定三張 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

三步完成本主題

每一步都留下可觀察結果;如果沒看到,先看「卡住先查」。

  1. Step 1|先看見目前缺口,不急著貼答案。

    檔案: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。。

  2. Step 2|只修改本主題的一個責任。

    檔案: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。

  3. Step 3|重新載入並以證據驗收,不以『看起來差不多』判定完成。

    檔案: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,也不會自動宣告完成。

Products/Orders/Contacts Schemaruntime fixture · read-only demo
本主題示範畫面:
  • Products-6-columns
  • Orders-13-columns
  • Contacts-9-columns
尚未執行

驗收證據

勾選只是學習紀錄;真正完成仍要回到 Starter 的實際結果。

提示 1|方向

方向提示:先只找出「Products/Orders/Contacts Schema」的輸入與可觀察輸出,不同時修改別的責任。

提示 2|關鍵片段

關鍵片段: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

提示 3|完整解答與原因

完整解答與原因:逐張比較 header 與 row builder 索引,電話欄保留字串。;驗收必須得到「count=3、uniqueCount=3、valid=true」,因為這項證據直接對應本 module 的成功條件。

完成後進入下一階段,或回到入口選下一個 topic。

開始 Starter →回到主題清單