← 打包 thread 首頁
規格撰寫(規格 ①-⑥)
Slack Thread @ 2026-07-01 ~ 2026-07-02 | 用途:帶到新 thread 接續使用,保留 context
Thread 主題:翠翠寫 6 份規格給康德工程師(①-⑥),同時建立 qtracychen.net /projects/ 私有專案文件區、CF Access 保護、22:00 backup cron、Mermaid 子流程圖。
1. 觸發事件
- 2026-07-01 早上:翠翠開新 thread,說「繼續專案規格處理」。原 dashboard 已於前一天產出用於 handoff(3 完成 / 1 進行中)
- 目標:先確認 ① ② 是否正確,再寫 ③ 拆分結帳,完稿才寫 ④ Layer 2 結帳邏輯
- 寫作節奏:翠翠貼 Notion → 我對照本地 md → 找出差異 + 踩線 → 她修 → 我 sync
2. 已完成規格(6 份)
| # | 名稱 | Layer | 工時 | HTML 版 |
| ① | 空運違禁品 | 1 | - | 連結 |
| ② | 排除物流(瘦身版) | 1 | - | 連結 |
| ③ | 拆分購物車(結帳設定) | 1 | 7 天 / NT$112,000 | 連結 |
| ④ | 結帳物流選擇規則 | 2 | 0 天(邏輯說明) | 連結 |
| ⑤ | 物流增加黑貓 | 1 | 待估 | 連結 |
| ⑥ | 物流設定(黑貓)綁多個廠商客代 | 1 | 3 天 | 連結 |
3. 關鍵決策(已 landed)
規格 ① ② ③ ④
- ①空運違禁品自動連動 2 項(超取 7-11 + 超取全家),不含海外配送
- ②排除物流 4 選項,不可 4 項全勾
- ③結帳設定三選一(不指定 / 單獨配送 / 指定配送群組編號 01-20),tooltip 進 spec
- ③拆分後獨立結算:金額、免運、促銷、發票、物流、優惠、付款;優惠不跨區塊
- ④判斷表從 6 列(陸/海/空 × 地址)簡化為 3 列(只看地址)
- ④地址類別定義:本島 = 台灣本島;外島 = 澎湖、金門、馬祖、蘭嶼、綠島、小琉球;海外 = 上述以外
- ④收件地址定義 spec 不開,直接內嵌 Layer 2 判讀說明
物流實務層決策(不進 spec,走 SOP)
- 黑貓從不空運(本島陸運、外島海運),陸/海/空分流不進 spec
- 海外配送 = 郵局(港澳外)+ 順豐(港澳),倉庫看地址判斷,SOP 不進 spec
- 海運提醒貼紙(外島 + 選宅配),倉庫看訂單判斷,SOP 不進 spec
- 宅配 = 黑貓 1:1;消費者看到「宅配」、內部看到「黑貓」
規格 ⑤
- ⑤PDF 出貨標籤走「黑貓官方格式」(非自訂)
- ⑤訂單新增 3 欄位:物流商 / 客代 / 配送編號
- ⑤取號失敗處理、收件人變更 → 康德依黑貓規範處理,spec 不定義細節
規格 ⑥(pivot 三次)
- ⑥初稿 → 資料鏈路+執行邏輯混合 → pivot 為「客代管理頁面設計」
- ⑥三種客代:主客代
5433646801(買斷/自有/寄倉品)、借名 5433646802-20(19 個,拋單品)、廠商客代(例:5929222101、5390560201)
- ⑥綁定方向:一客代對多個供應商代號(同實體廠商在系統中多代號,例:亞尼克),一供應商代號只能綁一個客代
- ⑥取號執行差異:主 / 借名走系統呼叫黑貓 API;廠商客代走 export → 廠商自取 → 我方索取配送編號後 Excel 匯入
- ⑥拿掉合約期間欄位、拿掉冷卻期規則(改 SOP)
- ⑥加「適用平台」多選 + 「各平台獨立顯示名稱」(因為 Check2Check / 蝦皮 / momo 可能有各自命名習慣)
- ⑥供應商頁面康德既有,本 spec 不動;供應商代號用下拉選單防呆(不允許自由輸入)
- ⑥UI 加「可匯出 CSV」(對帳用)
寫作流程規則
- Spec canonical source = Notion;本地 md 為工作副本;比對衝突以 Notion 為主(見記憶
feedback_spec_notion_canonical)
- 網站更新晚上批次做(Taipei 18:00 後),白天不打斷寫作 flow(見
feedback_website_sync_batch_evening)
- 命名詞對齊:不寫實作術語(DB / 主檔 / 表單 / 字串 / 接口)→ 改業務語言(頁面 / 資料 / 畫面 / 名稱 / 連動)
- 翠翠貼內容給我 review → 我找踩線 + 差異 → 她修 Notion → 貼回對照 → 我 sync 本地 md
4. 產出
網站(qtracychen.net,需 CF Access 登入)
R2 keep(公開連結,可分享)
基礎建設
- Cloudflare Access 保護
/projects/*,team domain shiny-tw,allowlist qtracy.chen@gmail.com(Shiny 設定)
- Cron
qtracychen-sync 每日 22:00 Taipei,dirty → deploy + push + DM 摘要;clean → silent
- 記憶新增:
feedback_spec_notion_canonical、feedback_website_sync_batch_evening、reference_qtracychen_sync_cron
5. 待處理項目
下一組(Cluster C 剩 2 項)
⑦ 訂單綁大宗單後黑貓客代判斷(Sheet row 4,5 天,必要性 R)
Briefing 已給,5 questions 待翠翠答:
- 客代選擇的預設邏輯(訂單跨供應商時怎處理)
- 一個大宗單只能綁一個客代嗎
- 廠商客代訂單走「大宗單」流程還是完全不同 flow
- 配貨處理、集中撿貨表 是⑦範圍嗎
- 訂單可否被拆到多個大宗單
- ⑧訂單貨態查詢物流商連結(Sheet row 15)
Cluster D-K 待寫 27 項
詳見 dashboard §4 待寫規格清單,含訂單管理、金流、退貨/發票、通知、會員/註冊、商品/UI、跨平台、門市等 group。
其他 hold 中
- Notion URL 全部 spec 卡片待補:翠翠會逐步提供,dashboard §3 + §8 已預留 placeholder
- 排除物流被擋下時的顯示文案:目前佔位「此商品組合的排除物流設定,此物流不可選」,等行銷康妮定案
- Miro A0 主流程圖 spec 標籤:A0 太密不加,用 A1-A5 子流程 + spec 標籤取代(A1+A2 已產初稿,A3-A5 等 spec 寫完再擴充)
6. 給下一 thread 的 context
如果繼續寫 spec
- 從 ⑦ 開始,翠翠需先回答 briefing 中的 5 個 questions(在 §5 上方)
- 寫作模式:draft → 貼 Notion → 找踩線 + 差異 → 修 → sync 本地 md
- 寫完的 spec 走 HTML 版於
/projects/spec-*(Notion-friendly 格式)
關鍵資料 (⑥ 建立的 baseline)
- 主客代
5433646801(不綁供應商)
- 借名客代
5433646802-5433646820(19 個)
- 廠商客代(例:
5929222101、5390560201)
- 供應商代號 → 客代(1 供應商代號綁 1 客代)
- 訂單有「供應商」屬性(從商品同步過來)
- 訂單新增欄位(⑤ 定義):物流商 / 客代 / 配送編號
流程配合
- 網站同步走 晚上批次(22:00 cron 或翠翠說「同步」)
- Spec 內容以 Notion 為主;本地 md / R2 / HTML 都是次要
- 不寫實作術語(主檔 / 表單 / 字串 / 接口 / 資料綁定 / DB)→ 用業務語言
- 「亞尼克」不是「亞西克」(先前誤讀)
7. 名詞說明(買斷/自有/寄倉/拋單/預購)
- 買斷/自有品:所有權為快電商,貨放汐止倉(買斷 = 向廠商買斷;自有 = 自家設計外包生產)
- 寄倉品:所有權在廠商,貨放汐止倉
- 拋單品:所有權在廠商,貨放廠商倉
- 預購品:任何商品都可開放預購(是銷售狀態,不是類型)