業務代訂操作手冊
已完成
Part 8
維運與疑難排解
這一章收整部署與維運要點、常見狀況的排查方向，讓代訂在正式環境穩定運作。多數問題來自付款前置與伺服器 worker 設定。
A. 部署層設定（正式環境必套）
| 設定 | 值 | 為什麼 |
|---|---|---|
| workers | ≥ 2 | 「寄送付款單／下載 portal PDF」會回連 Odoo 算圖；單 worker 下會deadlock |
| max_cron_threads | 1 | 搭配上項，避免資源競用 |
| report.url | http://localhost:8069 | PDF 算圖走內部埠，較快且穩 |
| SMTP | 正式郵件伺服器 | 「寄送付款單」要能真的寄出 |
| dbfilter | 對應網站的 DB | 多 DB 共用時，未登入前台也要解析得到網站，否則 /shop 404 |
💡 為何複製連結很快、寄信較慢「複製連結／LINE」只產 portal 連結、不寄信，約 0.02–0.03 秒秒回；而「寄送付款單」要算 PDF 並寄信，需數秒且吃 worker。兩者已解耦，寄信慢不會拖累複製連結。
B. 常見狀況排查
| 狀況 | 可能原因 → 對策 |
|---|---|
| 業務看不到代訂工具列 | 登入者不屬「銷售」群組 → 加入群組；或不在 /shop 路徑（Part 0、8） |
| 看不到「新增客戶」 | 後台「允許業務建立客戶」未開 → 開啟並儲存（Part 1） |
| 產生連結失敗／很慢 | worker < 2 或 report 設定不對；改用「複製連結」（不寄信）先應急（Part 8） |
| 寄送付款單失敗 | SMTP 未設好 → 設定外寄郵件伺服器並測試；客戶 email 缺 → 現場補填 |
| 客戶點付款沒反應 | 未接金流服務商 → 顯示「即將開通」stub（Part 6）；接上金流即可 |
| LINE 內開連結付款卡住 | 內建瀏覽器擋 3-D 驗證 → 請客戶改用系統瀏覽器開連結 |
| 換客戶後價格沒變 | 前台已手動選過價目表 → 以手選為準；清掉即回客戶預設（Part 3） |
| 送貨地址選不到某地址 | 該地址不屬此客戶家族 → 系統會擋；用「修改／新增」建到該客戶下（Part 3） |
C. 安全與資料
⚠️ 注意事項
- 付款連結是 access token URL：持有者免登入即可看/付（信任模型同 Email 報價單）。敏感訂單設報價單有效期限讓連結過期。
- 每個代訂端點都會重新驗證業務身分（不只信任 session）；非授權者呼叫會被擋（Forbidden）。
- 送貨地址一律限制在該客戶家族內，避免被塞入他人地址。
- LINE 按鈕使用內嵌官方綠色 LINE 標誌 SVG（FontAwesome 4.7 無
fa-line字符）；正式站可換官方品牌素材。
如何查到
部署設定在伺服器
odoo.conf 與 系統參數（report.url）。問題排查先確認：業務身分、後台開關、SMTP／worker、金流是否接上。連結有效期在報價單「有效期限」。