業務流程
目的
這裡放完整 business flow 的入口文件。
業務流程文件回答「一個使用者動作從 API 到 DB / queue / payment / log 會經過哪些階段」。它可以引用資料表流程、付款流程、queue 文件與身份驗證文件，但不應把每張 table 的欄位細節全部重寫一次。
目前文件
| 流程 | 說明 |
|---|---|
| search_add | consumer 發案、建立 quote_request、配對 quote_services、建立 quote_bids、送 downstream queue |
| quote_bid_list_fee_discount | 找新客戶列表的手動報價 fee、manual_fee_discount、限時6折 / 限時8折 顯示規則 |
| provider_送出報價 | provider 送出報價時的資格檢查、付款、通知、coupon、template、referral 共通流程 |
| quote_bid_contact | consumer 從 quote card 正式聯絡 provider，進入 contact / charge / activity / queue 主線 |
| narrow_match | consumer 邀請 narrow match provider 報價，以及 provider accept / reject invitation 的雙向流程 |
| users_delete | 使用者刪除帳號時的停用、服務/案件歸檔、session 清除、queue/event 與不可逆性 |
| quote_service_categories_add_edit | provider 建立或修改服務分類設定，說明 add 與 edit 的用途、輸入、duplicate 與 response 差異 |
寫作邊界
業務流程文件適合放：
- 主流程 trace
- actor / auth / session 判讀
- 主要資料表的進場順序
- downstream queue / payment / log 的跳轉點
- 排查時的第一輪 SQL 與閱讀順序
不適合放：
- 單一 table 所有欄位定義
- queue payload 完整 schema
- 金流分支的所有細節
- 一次性測試資料
這些應該連到 資料表流程/、Queue 與 Event 系統/、付款與扣款流程/ 或 案例/。