訂單證據
後台查得到編號、品項、狀態與金額。
延續自己的購物車,讓店主即時收到訂單通知,也能定期收到可核對的報表。
先決定店主應查哪一筆紀錄,再決定是否重新下單。
店主看到顧客的成功畫面,自己的 LINE 卻沒有訊息。現在先做什麼?
每筆訂單即時通知,彙總數字定期寄送;兩者都能回查原始訂單。
| 管道 | 何時送出 | 內容 | 店主如何核對 |
|---|---|---|---|
| LINE 通知 | 每筆模擬訂單保存後 | 訂單摘要與後台連結 | 手機訊息對照後台訂單 |
| Gmail 報表 | 店主選定期間後 | 摘要、PDF 與試算表連結 | PDF 數字對照試算表 |
先完成一種事件、一位接收者與一個可查核的結果。
| 要決定的事 | 第一版設定 |
|---|---|
| 什麼時候通知? | 一筆新的模擬訂單保存成功後 |
| 通知誰? | 店主自己的 LINE 帳號 |
| 通知什麼? | 店名、訂單編號、品項、金額與需登入的後台連結 |
| 失敗怎麼辦? | 保留訂單、記錄原因,再處理通知 |
訂單存在、平台接受與手機收到,回答的是不同問題。
後台查得到編號、品項、狀態與金額。
通知紀錄留下接收者、時間與 LINE 平台回應。
本人手機看到的內容與時間,遮住不必要個資。
商店發出事件,官方帳號傳送訊息,個人 LINE 接收訊息。
| 名稱 | 這次的用途 |
|---|---|
| 自己的商店 | 保存訂單與通知紀錄,決定何時通知 |
| LINE 官方帳號 | 代表商店發訊息,手機上可加好友 |
| 自己的個人 LINE | 扮演店主,實際看手機驗收 |
| Business ID | 登入官方帳號管理服務的身分 |
| Provider | 在開發者控制台管理自己服務的單位 |
| Messaging API channel | 讓網站對官方帳號發訊息的連接 |
參考:LINE 官方文件 · 從官方帳號啟用 Messaging API 與選擇 ProviderLINE 官方文件 · 營運者自己的使用者識別碼與 Provider 範圍
用電腦建立官方帳號;已有帳號則確認自己有管理權限。
在官方帳號管理介面啟用,再到開發者控制台確認同一個帳號。
店主的手機必須是好友,網站才能把通知送到這支手機。
U 開頭;它不是暱稱、電話、加好友用的 LINE ID,也不是 Channel ID。參考:LINE 官方文件 · 通道、加入好友與機器人設定LINE 官方文件 · 營運者自己的使用者識別碼與 Provider 範圍
本頁不用改字;沿用自己的商店,只建立通知功能。
請在目前購物車加入「LINE 店主通知」。沿用已完成功能,保留原資料。 【建立功能】 - 店主後台新增設定狀態、發送測試通知按鈕及通知紀錄。 - 模擬訂單保存成功後,由後端通知店主。 - 訊息包含店名、訂單編號、品項、數量、金額及需登入的訂單連結,標示「模擬訂單成立」。 - 通知失敗仍保留訂單;重試同一事件不重複下單或通知。LINE 已接受就停止重送,結果不明先留待本人核對。 - 設定、發送及紀錄限店主使用;開啟頁面不發訊息。 【設定位置】 - 發送憑證存後端私密設定:LINE_CHANNEL_ACCESS_TOKEN。 - 店主 Your user ID 存後端設定:LINE_OWNER_USER_ID,已有就沿用。 - 真實值由我在私密設定填入,不貼聊天、前端、Git 或日誌。 【完成後回報】 - 告訴我原專案的私密設定位置、部署方式與店主後台網址。 - 本頁只建功能,先不發送真實訊息,測試另做。
欄位全名是 Channel access token (long-lived),位於開發者控制台。
紅字填在網站私密設定;不貼進 AI 指令,已有設定沿用。
設定名稱:LINE_CHANNEL_ACCESS_TOKEN。
設定名稱:LINE_OWNER_USER_ID。
參考:LINE 官方文件 · 通道存取憑證類型、長效憑證發行與撤銷OpenAI 官方文件 · 在原 Site 的 Settings 設定私密執行期值
本頁不用改字;先由本人手動送一則測試訊息。
請測試目前商店的 LINE 通知,沿用原功能與設定。 【先檢查】 - 確認後端的發送憑證及店主接收者已設定,只回報有/無,不顯示真實值。 - 確認只有店主能使用發送按鈕;權限檢查不發真實 LINE。 【由我操作】 - 提供後台網址,讓我本人按一次「發送測試通知」。 - 只送到既有店主接收者,內容標示店名與「LINE 連線測試」,不自動連續重送。 【回報】 - 分開記錄「設定齊全」、「LINE 已接受」、「手機已實收」。手機由我核對。 - 失敗就留下錯誤與下一步;本頁先不改程式,也不把模擬測試當成實收成功。
複製後先補必填欄位;修好後回到原本的測試頁重跑。
請修正目前專案這一個問題,保留已完成的功能與資料。
【我的問題】
- 操作與錯誤:【必填:我做了什麼、實際看到的錯誤;先遮住密鑰與個資】。
【這次處理】
- 先查這個錯誤的原因,再做必要修改,不重建整個專案。
- 需要我操作帳號或私密設定時,指出畫面與欄位,不要求貼回密鑰。
- 修改後說明改了哪裡,以及我要回哪一步重測。
- 不自動發真實 LINE 或 Gmail。必填欄位未填時,先提醒我補上。參考:LINE 官方文件 · 主動推播與訊息計數LINE 官方文件 · 營運者自己的使用者識別碼與 Provider 範圍LINE 官方文件 · 重送識別碼、平台接受與投遞限制
本人先當顧客下單,再回店主後台與手機核對同一筆訂單。
| 操作 | 預期看見 | 對應證據 |
|---|---|---|
| 在自己的商店建立模擬訂單 | 顧客畫面取得訂單編號 | 訂單 |
| 登入店主後台查該編號 | 品項、數量與金額一致 | 訂單 |
| 開啟對應通知紀錄 | 接收者與平台回應對應原訂單 | 發送 |
| 查看自己的手機並點連結 | 收到摘要,登入後可查原訂單 | 實收 |
記下自己的訂單編號、通知狀態與手機實收結果。
網站送出訂單,試算表保存與計算,Apps Script 產生 PDF 並寄給店主。
參考:Google 官方文件 · 綁定在試算表中的 Apps ScriptGoogle 官方文件 · 將 Apps Script 部署為網頁應用程式Google 官方文件 · Apps Script MailApp 寄送含附件郵件
同一個日期與狀態範圍,在試算表、PDF 與信件中必須一致。
| 項目 | 計算規則 |
|---|---|
| 有效訂單數 | 選定期間內已成立、未取消的模擬訂單 |
| 有效訂單金額 | 上述訂單的折扣後應付金額合計 |
| 取消訂單數 | 同一期間內標示取消的訂單,另列 |
| 商品件數 | 有效訂單明細中的各商品數量合計 |
人先寫下預期結果,才能判斷 AI 建立的報表是否正確。
| 訂單 | 品項 | 狀態 | 應付金額 | 是否計入有效 |
|---|---|---|---|---|
| A | 商品甲 2 件 | 模擬訂單成立 | 1,200 元 | 是 |
| B | 商品乙 1 件 | 模擬訂單成立 | 900 元 | 是 |
| C | 商品甲 1 件 | 已取消 | 600 元 | 否,另列 |
本頁不用改字;AI 同時寫好網站端與 Apps Script 端,部署在下一頁。
請為目前商店加入「訂單同步到 Google 試算表」與「Gmail 營運報表」,沿用既有訂單、登入與資料。 【Apps Script 程式】 - 在專案中建立 apps-script/orders-report.gs,供我貼到試算表的 Apps Script 編輯器。 - 程式開頭留兩個由我填寫的常數:我的信箱與私密金鑰。 - 以網頁應用程式接收訂單;金鑰放在請求內容並驗證,錯誤就拒絕。 - 「訂單」工作表以訂單編號更新同一列,使用鎖避免同時寫入重複。 - 欄位:訂單編號、日期、品項、數量、應付金額、狀態;不存買家姓名、電話或信箱。 - 「報表」工作表以公式計算選定期間的有效訂單數、有效金額、取消單數及各商品件數;只計入已成立且未取消的訂單,取消單另列。 - 試算表選單新增「營運報表 → 寄出報表」:把「報表」工作表輸出成 PDF,寄到我的信箱;正文列摘要數字,附 PDF 與試算表連結。時區用 Asia/Taipei。 【網站端】 - 訂單保存或狀態改變後,由後端送出該筆訂單;送出失敗仍保留訂單並記錄,可在店主後台重送。 - 店主後台新增「同步全部訂單」,補送既有訂單,重複送出不產生重複列。 - 腳本網址存後端私密設定 REPORT_SCRIPT_URL,金鑰存 REPORT_SCRIPT_SECRET。 【完成後回報】 - 告訴我腳本檔位置、要填的兩個常數,以及後台按鈕位置。 - 本頁只建置,不送出訂單也不寄信,測試另做。
參考:Google 官方文件 · 將 Apps Script 部署為網頁應用程式Google 官方文件 · 在試算表加入自訂選單Google 官方文件 · Apps Script MailApp 寄送含附件郵件
紅字由本人填寫;金鑰與網址不貼進 AI 對話。
orders-report.gs,在開頭填入【必填:自己的信箱】與【必填:自己設定的 32 字以上隨機金鑰】。REPORT_SCRIPT_URL、REPORT_SCRIPT_SECRET,重新部署網站。參考:Google 官方文件 · 綁定在試算表中的 Apps ScriptGoogle 官方文件 · 將 Apps Script 部署為網頁應用程式Google 官方文件 · Apps Script 服務配額
本頁不用改字;由本人下單與取消,再到試算表核對。
請測試訂單同步到 Google 試算表,沿用既有功能與設定,本頁不改程式、不寄信。 【準備資料】 - 在隔離教學範圍依現有商品建立 3 筆 GM815_W10_TEST 訂單:A 買商品甲 2 件、B 買商品乙 1 件,兩筆有效;C 買商品甲 1 件,建立後取消。沿用實際價格,不改原商品或正式訂單。 【檢查結果】 - 讓我開啟試算表,核對三筆的編號、品項、金額與狀態;C 為同一列改成取消。 - 在後台按一次「同步全部訂單」,確認沒有重複列。 - 金鑰錯誤的請求被拒絕;試算表內沒有買家姓名、電話或信箱。 【回報】 - 列出通過、失敗、未測及證據;試算表內容由我確認。
本頁不用改字;由本人在試算表選單寄出一次,再開信核對。
請協助我驗收 Gmail 營運報表,沿用既有試算表與程式,本頁不改程式。 【由我操作】 - 告訴我在「報表」工作表哪裡設定期間;我選包含 GM815_W10_TEST 訂單的日期。 - 由我在試算表按一次「營運報表 → 寄出報表」,不自動重寄。 【核對內容】 - 先依試算表的訂單列出預期:有效筆數、有效金額、取消單數與各商品件數。 - 由我開啟信件與 PDF 附件,核對正文、PDF 與試算表三者數字一致,中文可讀,試算表連結可開啟。 【回報】 - 分開記錄「已寄出」、「已收信」、「附件與數字正確」及證據;未看到就標待本人確認。 - 只有連結、沒有 PDF 附件,不算本項通過。失敗時記錄原因,修正另用修正指令。
由本人展示自己的網站、手機、試算表與信箱,將證據連起來。
| 交付 | 最少保留的證據 |
|---|---|
| 店主 LINE 通知 | 訂單、通知紀錄、手機實收結果 |
| 錯誤處理 | 一次錯誤紀錄與修正後重測 |
| 訂單同步 | 新增、取消與補送後的試算表列 |
| Gmail 報表 | 同一期間的正文、PDF 附件與試算表數字核對 |
| 延伸 | 規則變體或會員綁定的實測或受阻紀錄 |
複製後先改兩個必填欄位;本頁只改規則,下一頁再測試。
自己決定達到多少金額才通知。
有庫存或名額的商品,決定何時提醒。
訂單取消時通知店主。
請修改目前商店的一項 LINE 通知規則,沿用已完成的通知功能。 【我先決定】 - 規則:【必填:我要修改的提醒規則】。 - 條件:【必填:通知門檻與觸發條件】。 【這次修改】 - 只套用這一項規則,不更動商品價格、原訂單或接收者。 - 在後台清楚顯示已儲存的條件;沒有庫存的數位商品不套用庫存提醒。 - 必填欄位未填時先問我,不自行猜門檻。 - 完成後回報改了哪裡。本頁只修改,不發真實訊息,測試另做。
本頁不用改字;沿用剛儲存的規則,只測試並留下結果。
請測試目前已儲存的通知規則,本頁不改規則、不修程式。 【測試案例】 - 有數字門檻時,測低於、等於及高於門檻;其他規則列出應通知與不應通知的案例。 - 重送同一張教學訂單,確認訂單與相同通知事件不重複。 - 模擬 LINE 失敗及逾時,確認訂單仍保留。LINE 已接受就停止重送,未知結果交本人核對。 - 確認非店主不能發送、改接收者或查看通知紀錄。 【回報】 - 列出每例的預期、實際、通過/失敗/未測與證據。 - 使用隔離教學資料;除本人核准的一次實收外,不發真實 LINE。 - 只回報問題;需要修正時,另用修正指令,再重跑同一案例。
加好友只建立 LINE 關係,網站仍須確認對方是哪一位會員。
| 對象 | 可以收到 | 必須查核 |
|---|---|---|
| 店主 | 營運摘要、訂單及報表提醒 | 連結只允許店主查看 |
| 已綁定買家 | 自己的訂單成立與異動 | 不能看到別人的訂單 |
| 未綁定買家 | 綁定說明與一般服務資訊 | 不依暱稱猜測個人訂單 |
讓下一個執行者知道能做什麼、何時停下,以及如何查核。
甲、乙都不願單獨出發,於是開始互相寄確認信。
先猜需要幾封確認,再檢查最後一封可能發生什麼事。
信件可能遺失。往返幾封確認,才能保證兩人同時出發?
前兩封都已送達;第三封的結果,甲還不知道。
| 信件 | 收到後,多知道了什麼? |
|---|---|
| ① 甲 → 乙:明早六點出發 | 乙知道甲提出的時間 |
| ② 乙 → 甲:收到,同意 | 甲知道乙收到了計畫 |
| ③ 甲 → 乙:收到你的確認 | 乙知道甲收到了第二封 |
只靠可能遺失的信件,有限次往返無法保證這種同步行動。
回到今天的網站,把每個完成說法對應到實際觀察。
| 實際證據 | 可以說明 | 尚不能據此宣稱 |
|---|---|---|
| 後台查到原訂單 | 訂單已保存 | 手機已收到通知 |
| LINE API 回傳 HTTP 200 | LINE 已接受請求 | 店主手機已收到 |
| 本人手機看到該則通知 | 本次已實收,可核對內容 | 所有未來通知都會成功 |
為每個重要結果,指定可接受的證據、停止條件與負責人。