官網轉換 + ERP 串接 · 規格寫作進度總覽
Handoff dashboard · 更新：2026-07-01 · 給新 thread 接手用
給接手的 Taco
這份是翠翠（
U06UJ7RN7B9）交接用文件。她要開新 thread 繼續寫規格，看完這份即可無縫接續。詳細寫作原則、規格 template、Notion 操作習慣見接手 brief v2：
spec_handoff_brief_v2.md。
進度儀表板
1. 專案背景
Check2Check 官網從現行廠商 莫筆克 轉換到新廠商 康德，並串接 鼎新 ERP。
翠翠 2025-12-20 加入專案，負責寫規格給康德工程師做開發依據。目標里程碑：
- M1 官網上線：2027-01-01（元旦）
- M2 ERP 串接上線：2027-05-01（原 4/1，已往後 1 個月）
Vendor lock：康德 7/15 前、鼎新 9/1 前。
廠商角色
- 康德（未來官網廠商）：負責訂單處理到出貨完成。窗口：邱先生（老闆）、Kevin（前端 PM）、百吉（後端 PM）
- 鼎新（ERP 廠商）：負責帳務。窗口：Amelia（顧問）
- 快電商（超電廠商）：另一個電商網站。窗口：Tutu（副總）、Vic（老闆）、Tracy（資訊）
2. Layer 1 / Layer 2 分層思維
翠翠這次進度中頓悟的核心分層概念（見接手 brief v2 §3）：
- Layer 1（單點規格）：每個欄位／功能獨立一份。例：「空運違禁品」「排除物流」「結帳設定」欄位定義
- Layer 2（串接流程規格）：把 Layer 1 各個欄位串起來的判斷邏輯／流程。例：「結帳物流選擇規則」「訂單接入與成立」
2026-06-30 進一步釐清：Layer 2 spec 不寫「值是怎麼來的」，只寫「怎麼用這些值做判斷」。值的定義回到 Layer 1 spec。這樣未來規則異動只改一份。
重要邊界
規格
只寫業務需求，不寫廠商實作（DB schema、程式變數名、UI 框架都不寫）。翠翠 2026-06-30 這天 internalize 了這條原則，且反過來影響 3 份已完成 spec 都做了「越界清理」。
3. 已完成規格（3 份 Layer 1）
① 空運違禁品
Layer 1 · 已完成
Sheet row 17 · 平台：官網 · 分類：訂單 · 必要性：G
某些商品（鋰電池、噴霧罐、易燃品）依航空法規不能空運。上架時勾選「空運違禁品 = 是」→ 排除物流欄位自動加勾 2 項（超取 7-11 / 超取全家）。
2026-06-30 修正：自動連動從 3 項改成 2 項（海外配送不勾，因為海外配送 = 假物流）
② 排除物流
Layer 1 · 已完成（Layer 2 拆離後瘦身版）
Sheet row 14 · 平台：官網 · 分類：訂單 · 必要性：G
人員於商品上架頁勾選「排除物流」（可複選，預設全不勾，不可 4 項全勾）。4 個選項：超取 7-11 / 超取全家 / 宅配 / 海外配送。
2026-06-30 瘦身：把「結帳時判斷」相關內容從此份移出，搬到 Layer 2「結帳物流選擇規則」。這份現在只講上架欄位定義 + 上架行為。
③ 拆分結帳（結帳時拆分購物車，含「結帳設定」欄位）
Layer 1 · 已完成
Sheet row 16 · 平台：官網 · 分類：訂單 · 必要性：R · 康德報價：7 天 / NT$112,000
購物車拆分結帳邏輯。商品有「結帳設定」欄位（3 選 1）：
- 不指定（預設）：合併同結帳區塊
- 單獨配送：強制獨立（兩個單獨配送也不合併）
- 指定配送群組編號（01-20）：相同編號合併、不同編號拆分
拆完每張結帳區塊獨立算：金額、免運、促銷、發票、物流、優惠／折扣、付款。優惠不可跨區塊。
這份還沒做 Layer 2 拆離（Layer 2 spec 停在暫停狀態）。之後拉 Layer 2 時，「拆分後的結帳區塊」相關的結帳邏輯要考慮是否搬。目前先擱著。
4. 進行中規格（Layer 2，暫停）
④ 結帳物流選擇規則（Layer 2）
Layer 2 · 進行中 · 2026-07-01 暫停
Sheet 上待新增 row · 平台：官網 · 分類：訂單 · 時數：0 天（邏輯說明用，不單獨開發）
「結帳時能選哪些物流」的判斷邏輯總綱。整合三個輸入：商品的空運違禁品屬性、商品的排除物流設定、收件地址（本島／外島／海外），產出可選物流清單。
判斷對照表（核心）
| 收件地址 |
區塊含空運禁品 |
地理可行物流 |
| 本島 | 是 | 黑貓（陸運）、超取 7-11、超取全家 |
| 本島 | 否 | 黑貓（陸運）、超取 7-11、超取全家 |
| 外島 | 是 | 黑貓（海運） |
| 外島 | 否 | 黑貓（空運）、超取 7-11、超取全家 |
| 海外 | 是 | 海外配送（人工） |
| 海外 | 否 | 海外配送（人工） |
再套用「排除物流聯集」做第二層過濾。若結果為空 → 顯示提示，請消費者拆單／移除商品／換地址。
Review 狀態
- ✅ 主流程 step 5+6 合併（她指出兩條實為一個動作+結果，已合併）
- ⬜ 我發現另外 4 處類似重複，還沒動：
- 其他情況 #3「全部物流被排除」重複主流程 step 6 → 建議刪
- 其他情況 #4「海外配送本質」重複判讀說明「海外」 → 建議刪
- 其他情況 #5「外島黑貓分流」重複判讀說明「外島」 → 建議刪
- 「排除物流的第二層過濾」section 第一條 redundant → 改名「舉例說明」保留兩個例子
- ⬜ 剩餘段落（前置條件、UI／畫面影響、驗收標準、關聯規格）尚未逐一 review
暫停原因
翠翠 2026-07-01 決定先停下 Layer 2。原因未明說，可能是想沉澱一下 / 想拉別人一起 review / 想先開新 thread 用清爽的 context。
Notion 頁面待翠翠開好後補上連結
Layer 2 上 Sheet 的處理方式（她 2026-06-30 拍板）
- Sheet 補一個新 row（標題例：
結帳時物流選擇判斷邏輯）
- 時數 = 0，Note 標「邏輯說明用，不單獨開發」
- Notion 開對應區塊放內容
- 康德工程師整合「空運違禁品」「排除物流」「拆分結帳」時，看這份當判斷依據
5. 待寫規格清單（32 項）
依 brief v2 §7 建議寫作順序，Cluster 分組如下。下一組建議寫的：物流（黑貓相關）4 項。
C. 物流（黑貓相關）· 4 項 · ← 建議下一組
- 物流增加黑貓（此份 2026-06-29 起草到一半，因發現需引入「收件地址」維度而擱下）row 3
- 物流設定（黑貓）綁多個廠商客代row 2
- 訂單綁大宗單後黑貓客代判斷（含黑貓海運／空運分流邏輯）row 4
- 訂單貨態查詢物流商連結row 15
D. 訂單管理 · 5 項
- 交易拆單row 10
- 訂單管理頁面增加篩選row 12
- 訂單自定義標籤row 11
- 每日出貨明細報表row 48
- 海外配送，配送編號的更新row 13
E. 金流 · 3 項
- 未付款訂單，重新付款 20 分鐘row 7
- 新增金流：街口支付row 8
- 線上刷卡換中信銀行row 9
F. 退貨／發票 · 2 項
- 退貨流程「會計執行退款」改自動row 23
- 開立發票時點修改row 51
G. 通知 · 4 項
- Mail 工具串接row 28
- 官網特定情境通知信／簡訊（3 個情境）row 43-45
H. 會員／註冊 · 3 項
- 黑名單 有範例row 54
- Google 快速登入row 52
- 驗證碼簡訊按鈕視覺強化 有範例row 53
有範例的 2 項可放在「零碎時間」寫，難度低。範例見 spec_template.md 中的範例 A（黑名單，中等複雜度）與範例 B（驗證碼按鈕，5 格極簡）。
I. 商品／UI · 8 項
- 商品列表頁文字呈現調整row 25
- 商品下架倒數計時器row 26
- 置頂 (Pin) 功能row 55
- 購物車滿額升等提醒row 19
- 加入購物車按鈕滾動固定row 27
- DPA 圖片抓取邏輯row 57
- 獨立 SEO 設定欄位row 56
- 全域訂單最低 100 元row 18
J. 跨平台（快電商） · 2 項
- 超電串接 (API)row 5, 58, 59
- 超電串接 (物流)row 6
K. 門市（Q2 上線，不急） · 1 項
Layer 2 / 支援類 · 2 項（Sheet 上待補）
- 結帳物流選擇規則（Layer 2）Layer 22026-07-01 進行中，暫停
- 收件地址定義（本島／外島清單，供 Layer 2 引用）Layer 2 支援尚未開始
6. 關鍵決策記錄
Review 過程中拍板的業務規則，避免重寫時忘記脈絡。
Q：排除物流選項有幾個？
A：4 個（超取 7-11 / 超取全家 / 宅配 / 海外配送），不可全部勾選
Why：翠翠 2026-06-29 貼畫面確認實際 4 選項，糾正我原本以為的 3 選項
Q：空運違禁品自動連動勾選幾項？
A：2 項（超取 7-11 / 超取全家），海外配送不勾、宅配不勾
Why：海外配送 = 假物流（人工處理），跟空運禁品是 disjoint 邏輯；宅配走陸運不會有空運問題（2026-06-30 修正）
Q：拆分結帳的群組編號範圍？
A：01-20（兩位數字串）
Why：翠翠 2026-06-29 拍板
Q：拆分後的多個結帳區塊，付款方式？
A：必須分別結算，不可合併付一次
Why：翠翠 2026-06-29「5 個購物車是必須拆分結帳的」；優惠／折扣只能套用單一區塊，不可跨區共用
Q：宅配 vs 黑貓的關係？
A：系統的「宅配」就是「黑貓」（1:1）。未來新增新竹物流等，另開獨立項目「宅配-新竹物流」，不動原黑貓項目
Why：翠翠 2026-06-29 拍板不做「物流類別」抽象層，走扁平擴充
Q：消費者看到的物流名稱？
A：消費者端 = 「宅配」；內部端（後台、出貨單）= 「黑貓」
Why：翠翠 2026-06-29「消費者只會看到宅配的文字，不會看到貓」
Q：海外配送是真的物流商嗎？
A：否，是假物流。人工寄貨，系統不會跟物流商連動取號
Why：翠翠 2026-06-30「海外配送=其它物流=假物流」
Q：本島／外島／海外的判斷規則？
A：台灣 = 本島；離島（金門、馬祖、澎湖、蘭嶼等）= 外島；台灣以外 = 海外。
細節放新開的「收件地址定義」spec
Why：翠翠 2026-06-30 拍板；超取（7-11／全家）寄外島走空運，所以「空運禁品 + 外島」不能選超取
Q：Layer 2 spec 要不要進 Sheet？
A：要（不然康德看不到 = 不會做），但時數 = 0，Note 標「邏輯說明用，不單獨開發」
Why：翠翠 2026-06-30 反問「不放入 sheet，康德不會照著作」讓我修正原本的立場
7. 待確認事項
要跟康德／黑貓 API 確認
- 外島黑貓的海運／空運分流：黑貓 API 是「同客代不同取號類別」還是「不同客代」？影響 Layer 2 判斷規則細節
要跟內部確認
- 排除物流被擋下時的顯示文案：目前佔位「此訂單包含不可走 7-11 商品」等 → 應由行銷康妮定案
- 「收件地址定義」spec 內容：本島／外島縣市清單（郵遞區號規則或縣市清單）
- Layer 2 spec 是否恢復 review：翠翠 2026-07-01 暫停，還沒說何時回來
Canva 畫面連結（待翠翠提供）
- 拆分結帳 UI 位置（結帳頁區塊呈現）
- 結帳物流選擇頁的被排除項目顯示樣式
8. 寫作原則（翠翠已內化）
- 一個項目一份規格，不合併
- 卡住先標
[待確認]，不中斷思路
- 規格只寫自己的範圍，相關邏輯用「關聯規格」串連
- 不寫實作細節（DB schema、UI 框架、程式變數名、Y/N 這種格式），改用中文業務語言
- 規格邊界判斷：寫完問自己「廠商沒問就能照做嗎？」→ 不行就補
- 每份規格長短按複雜度決定：簡單 UI 微調 5 格就夠、複雜邏輯填滿 8 格
- 翠翠用零碎時間寫規格，一份 review 完再開下一份，不推太多
- 翠翠 Notion 用 bullet outline，markdown 直接貼不會自動對齊，我要給「以條為單位」的 diff 指引，不整片替換
- 寫規格時避免 jargon：「邊界條件／例外／異常」→「其他情況」；不用「出包」
給接手 Taco 的操作提醒
- Notion 內容看不到（沒登入權限），要 review 內容請翠翠截圖或貼文字
- 接手先
curl Sheet 拉即時狀態（指令見 brief v2 §6.1）
- R2 上傳預設用 r2.qtracychen.net（2026-06-30 起，非 r2.shinychang.net）
- Slack 訊息 URL 前後留空白，否則會被中文/標點吃掉
- 翠翠是
U06UJ7RN7B9，先生是 UCWS8JU3Y（先生不主動找）
9. 相關資源與連結
核心文件
Spec 內容（canonical = Notion）
2026-07-01 翠翠拍板：規格內容以 Notion 為主（canonical）。本地 md 為工作副本，比對衝突時以 Notion 為準。
康德相關參考
- 康德 0608 拆單／拆分規格：
/home/node/workspace/vendor_kanto/0608_購物車拆分拆單結帳421_更新.md
- 康德 0608 交易拆單規格：
/home/node/workspace/vendor_kanto/0608_交易拆單_待出貨訂單一拆多__421更新.md
- 康德合約 OCR：
/home/node/workspace/vendor_kanto/原合約_*.md
- 康德決策 tracker HTML v3：
/home/node/workspace/website_erp_vendor_kanto.html
相關 memory（auto-load）
project_work_website_erp_migration.md：專案主 memory（進度、廠商、里程碑）reference_work_monthly_reports.md：月報產出慣例feedback_r2_uploads_use_qtracychen_domain.md：R2 domain 改成 r2.qtracychen.net