INTEGRATED LAB · Starter

Sheet Schema、權威計價、去重與完整狀態|整合 Lab

在同一份章節作品中整合 4 個 module,排除單項通過但組合失敗的問題。

最後整合任務

交付:完成三張 Sheet schema、GAS 權威計價、LockService 去重與 idle/loading/success/error/timeout 安全重試。

將同一組責任轉用到另一個商家情境,仍達成:完成三張 Sheet schema、GAS 權威計價、LockService 去重與 idle/loading/success/error/timeout 安全重試。

限制:不新增框架。;保留 module id 與驗收證據。

依序回看每個 topic

整合不是重新背一遍名詞;是把每個 topic 的責任放回同一份作品。

  1. 1. Products/Orders/Contacts Schema
    files/starter/apps-script/SETUP.md|count=3、uniqueCount=3、valid=true
    回到 topic 說明
  2. 2. 伺服器權威計價
    files/starter/apps-script/Code.gs|count=3、uniqueCount=3、valid=true
    回到 topic 說明
  3. 3. LockService 與 submissionId 去重
    files/starter/apps-script/Code.gs|operation=dedupe、inputCount=3、outputCount=2、remoteRequests=0
    回到 topic 說明
  4. 4. 五狀態與安全 Retry
    files/starter/apps-script/Code.gs|狀態順序、aria-busy、disabled 與同 id retry 紀錄
    回到 topic 說明

四個整合停點

每個停點都要留下檔案、畫面或瀏覽器證據。

  1. Step 1|觀察整合 Starter 並找出第一個未通過 module。

    檔案:files/starter/index.html 定位:#observe

    操作:逐項讀取 outcomes,執行一次現況操作。

    // OBSERVE:不修改程式,先記錄第一個失敗 moduleId。

    預期:能指出第一個未通過 module。

    證據:第一個 moduleId 與缺少的 evidence。

    卡住先查:確認開啟的是 files/starter/index.html。

  2. Step 2|依 module 順序修改,一次只加入一個責任。

    檔案:files/starter/index.html 定位:#modify

    操作:逐張比較 header 與 row builder 索引,電話欄保留字串。 → 將前端 total 改為 1,確認本地契約仍以三個 GAS 計算步驟覆蓋。 → 對兩筆相同 submissionId 執行本地 dedupe,核對輸出列數。 → 執行 timeout 路徑,確認 finally 恢復按鈕,再以同 submissionId 重試。

    // 27-01-products-orders-contacts-schema: 逐張比較 header 與 row builder 索引,電話欄保留字串。
    // 27-02-topic: 將前端 total 改為 1,確認本地契約仍以三個 GAS 計算步驟覆蓋。
    // 27-03-lockservice-submissionid: 對兩筆相同 submissionId 執行本地 dedupe,核對輸出列數。
    // 27-04-retry: 執行 timeout 路徑,確認 finally 恢復按鈕,再以同 submissionId 重試。

    預期:完成三張 Sheet schema、GAS 權威計價、LockService 去重與 idle/loading/success/error/timeout 安全重試。

    證據:count=3、uniqueCount=3、valid=true;count=3、uniqueCount=3、valid=true;operation=dedupe、inputCount=3、outputCount=2、remoteRequests=0;狀態順序、aria-busy、disabled 與同 id retry 紀錄

    卡住先查:回到第一個未通過的 module,只修該處。

  3. Step 3|驗證所有 module 在整合後仍成立。

    檔案:files/solution/index.html 定位:#verify

    操作:重新整理並依 outcomes 順序重跑所有證據。

    // VERIFY:逐項記錄 pass/fail,不以看到畫面代替 evidence。

    預期:4/4 module 通過。

    證據:每個 moduleId 都有實際結果與重設後重現紀錄。

    卡住先查:若失敗,回到第一個失敗 module,不同時修多項。

  4. Step 4|把本章責任轉用到不同內容情境。

    檔案:files/starter/index.html 定位:#challenge

    操作:替另一個商家情境重做,仍達成:完成三張 Sheet schema、GAS 權威計價、LockService 去重與 idle/loading/success/error/timeout 安全重試。

    // CHALLENGE:只替換內容與資料,不新增框架或跳過 self-check。

    預期:完成三張 Sheet schema、GAS 權威計價、LockService 去重與 idle/loading/success/error/timeout 安全重試。

    證據:轉用後的作品與全數 module self-check。

    卡住先查:先確認共同基底與 module id 未被改壞。

完成本階段後,重新載入並保存整合證據。

回到自主學習入口