出團準備與線控
出團準備是逐梯次（per-departure）的批次作業——你不是一張訂單一張訂單處理，而是鎖定一個梯次，把這團要辦的事一次辦完。所有準備作業的入口都是「線控」。
本篇說明線控怎麼運作，以及分房、證件、裝備、領隊與各項營運清單各自接哪個 API。
從線控進入
先用 GET /departures/control 取得待辦梯次清單（可依 range / trip / status 篩選，或只看需要關注的梯次）。點進某個梯次後，所有準備作業都掛在 /departures/{depId}/... 之下：
- 一份出團名單（旅客、應收、收款）由
GET /departures/{depId}/manifest取得；名單體檢（缺證件 / 缺同意書等）看.../validation-summary。 - per-departure 作業一律從線控進，不是各自獨立的功能頁。
行前總檢查與模組界線
每個梯次有一份固定的行前總檢查清單（收款、領隊、交通、餐食、保險、證件、裝備、名單八項），逐項勾稽完成度，經 PUT /departures/{depId}/prep/checklist 切換。
準備作業分兩層：
| 區塊 | 是否受模組 gate |
|---|---|
| 分房、領隊、對款、派車、餐食、投保、行前檢查 | 核心骨幹——永遠可用 |
| 證件追蹤、期限警戒、裝備需求 | 登山模組專屬——關閉時不出現 |
讀取準備工作台需 departure_prep.read；寫入（分房以外的各軸）走 departure_prep.manage。證件 / 期限 / 裝備三項另受租戶的登山模組開關控制——租戶沒開登山模組時，這些子路由不適用。權限與模組詳見 總覽。
分房（含自動配對預覽）
分房分兩階段：下單時登記偏好（自動配房 / 指定房友 / 加價單人房），線控才權威排房。
GET .../rooms/auto-pair-preview依同團同性別與指定房友只回建議分組，不直接寫入；你拿建議的旅客分組去.../rooms/auto-pair-apply一次建房並整組指派。- 也可手動
POST .../rooms建房後逐位指派 / 取消指派。房間不可超過床位數、性別為硬約束。 - 把旅客排進升級 / 單人房型會新增一筆應收並產生補款入口（不會靜默改大已付訂單），金流規則見 訂單與金流模型。
GET .../rooming-export匯出分房表（CSV / JSON）給山屋、嚮導、保險文件用；敏感欄位依遮罩規則。
證件與文件（登山）
登山團要追蹤入山證、入園證、床位核准證、營位核准證。經 PUT .../prep/documents 記每種證件的申請狀態（todo → applying → approved）、檔案是否就緒與雲端連結。
期限警戒由 PUT .../prep/deadlines 設定入山申請 / 入山證下載 / 登山險 / 旅責險四個期限；系統以工作天倒數（扣週末與國定假日）派生緊迫程度，提醒你別錯過送件窗口。
裝備需求
線控在梯次盤點要借多少裝備，經 POST .../prep/equipment-needs 逐品項登記需求量（同品項再送為覆寫）。
回應會帶跨梯次彙總警示：把同日期窗各梯次對同款裝備的需求加總，比對可租庫存——需求超過庫存標為缺（shortage），剩餘 ≤ 2 標為低水位（lowStock）。這讓你在排某梯次時就看到鄰近梯次會不會把同款裝備借光。旅客真正借出走訂單的租借流程（見 裝備管理），與這裡的需求調查並存不重複扣庫存。
領隊指派
經 PUT .../prep/guides 把嚮導指派為領隊或隨隊，狀態分暫定（tentative）與確認（confirmed）。確認的領隊可登入嚮導 portal 回填現場成本與資料。
各項營運清單：派車 · 餐食 · 投保
派車、餐食、投保是三組 per-departure 的營運資訊（記安排狀態，不存成本）：
| 軸 | API | 記什麼 |
|---|---|---|
| 派車 | .../prep/transport | 路段、駕駛、車輛、車資備註、狀態 |
| 餐食 | .../prep/catering | 供應商、餐食方案、人數備註、狀態 |
| 投保 | .../prep/insurance | 險種（旅平 / 旅責）、保險公司、保單號、狀態 |
這三軸只記營運安排，不是成本。實際車資 / 餐費 / 保費等成本一律走梯次成本登記（下節），別把金額塞進這裡的備註欄。
對款與請款入口
線控的「對款」是唯讀對帳視圖：GET .../finance-summary 派生團費收齊度，以及供應商 / 裝備住宿的應付未付（已付 / 已轉未付 / 未轉）。它不寫任何成本。
成本的登記與請款是另一條路：
- 用
POST .../costs登記梯次成本，再用.../payables把選定成本轉成對供應商 / 嚮導 / 佣金的出款請款。 - 請款單的核簽流程見 payment-requests；對客人收款與退款是另一回事，見 付款流程。
下一步
- 行程與梯次：梯次怎麼來、席次與分配模式。
- 訂單與金流模型：房升補款、應收與三軸狀態。
- 付款流程 · departures API。