Appearance
S9 車隊管理
概述
管理車輛、司機和車隊組織的完整生命週期，確保有足夠的運力資源來執行各類路線服務。涵蓋從車輛新增、司機註冊、證件審核、狀態管理到指派路線的全流程，同時支援 B2B 管理員集中管理與 C2C 司機自助註冊兩種模式。
執行者：平台管理員、車隊管理員（B2B）、司機（C2C 自助註冊）
觸發條件
- 管理員需要新增或管理車隊資源
- 新司機申請加入平台
- 車輛證件到期需要更新
- 路線規劃時需要指派車輛與司機
- 批次匯入車輛或司機資料
Happy Path
步驟 1：新增車輛/司機
路徑 A：B2B 管理員新增
管理員在後台逐筆新增或 CSV 批次匯入車輛與司機資料。
車輛資訊：
- 車牌號碼、車輛類型（巴士/廂型車/轎車）、座位容量
- 車輛顏色、車輛特色（如輪椅無障礙）
- 保險到期日、保養日期
司機資訊：
- 姓名、電話、Email
- 駕照號碼、駕照有效期
- 緊急聯絡人
- 角色：司機 / 隨車人員
路徑 B：C2C 司機自助申請（三步驟表單）
表單一 — 基本資料：
| 欄位 | 規則 | 必填 |
|---|---|---|
| 姓名（中文） | — | 是 |
| 英文姓名 | — | 是 |
| 電話 | 09 開頭 10 碼 | 是 |
| — | 否 | |
| 邀請碼 | 格式 HD + 末 4 碼電話 | 否 |
| 車輛服務類型 | 計程車 / 租賃車 | 是 |
| 主要服務範圍 | 至少選一個地區 | 是 |
表單二 — 服務資料：
| 欄位 | 規則 | 必填 |
|---|---|---|
| 車牌號碼 | 大寫英數 | 是 |
| 車行名稱 | — | 否 |
| 車型 | 如 Toyota Altis | 是 |
| 車色 | — | 是 |
| 出廠年份 | 限近 15 年內 | 是 |
| 最大可載客人數 | 1-9 人（不含司機） | 是 |
| 行李限制 | 24/26/28 寸各別 min-max，0-8 件 | 是 |
| 外語服務意願 | 「願意但需平台協助」/「願意可自行應對」 | 否 |
| 特別服務 | 兒童座椅(+數量)、衝浪板/潛水設備、腳踏車、寵物(+上限數量)、減碳綠能車 | 否 |
表單三 — 上傳驗證文件：
| 文件類型 | 計程車 | 租賃車 | 需設到期日 |
|---|---|---|---|
| 身份證正反面 | 必須 | 必須 | 否 |
| 職業駕照正反面 | 必須 | 必須 | 是 |
| 執業登記證 | 必須 | 選填 | 是（若上傳） |
| 車輛行照 | 必須 | 必須 | 是 |
| 車輛保險證明（需含旅客責任險） | 必須 | 必須 | 是 |
| 存摺封面 | 必須 | 必須 | 否 |
送出申請後：
- 審核狀態設為「審核中」
- Slack 通知管理員有新申請
- LINE 通知司機「已收到申請」
步驟 2：證件審核
B2B 審核
- 上傳必要證件（駕照、行照、保險單、營業登記）
- 系統自動檢查證件有效期
- 管理員審核證件真實性
- 審核通過後啟用帳號
C2C 審核（含狀態流轉）
管理員在司機審核頁面查看申請列表，可依以下條件篩選：
- 狀態：填寫中 / 審核中 / 審核通過 / 審核不通過
- 載客人數範圍：1-3 人 / 4-6 人 / 7-9 人 / 10 人以上
- 特別服務：衝浪板、腳踏車、寵物、兒童座椅、綠能車
- 服務地區
- 車輛類型：經典小黃 / 租賃車
- 搜尋：姓名 / 電話 / 車牌
審核狀態流轉：
審核中 → 通過 → 設定 isDriver=true，LINE Flex 訊息通知可開始接單
→ 拒絕 → LINE 通知附拒絕原因與修改連結
→ 重新審核 → 司機修改已通過資料後自動觸發- 審核中：表單全部禁用，司機無法修改
- 通過：司機可開始接單
- 拒絕：司機可修改資料後重新提交
- 重新審核：通過後若司機修改資料，狀態自動回到此狀態
其他管理操作：
- 刪除司機申請（需二重確認：輸入司機名稱驗證）
- 發送 LINE 訊息給司機
- 匯出所有司機資料 CSV
- 證件到期日 30 天內 → 警告標記
步驟 3：合作政策簽署與帳號啟用
C2C 合作政策簽署
審核通過後，司機需完成合作政策簽署才能開始接單：
- 閱讀服務條款 + Canvas 數位簽名板簽名
- 勾選個人資料同意書 + 確認簽名
- 系統儲存：
已同意合作政策 = true、簽名圖片（base64）、簽名時間 - 完成後自動導航至司機錢包頁面，可開始接單
B2B 帳號啟用
- 司機完成 App 註冊與登入
- 綁定通訊帳號（LINE 等）以接收派單通知
- 車輛關聯到所屬車隊組織
步驟 4：接單（C2C 兩階段確認機制）
此步驟僅適用於 C2C 開放搶單場景。B2B 場景由管理員在 S10 路線規劃中直接指派。
第一階段 — 暫時接單
- 司機在接單中心瀏覽可接訂單（篩選條件：狀態=未出行、無正式/暫時司機、車型匹配、人數≤最大可載客、未過期）
- 點擊訂單進入詳情頁，點擊「立即接單」
- 系統前端檢查：
- 審核狀態是否正常（非「重新審核」）
- 訂單是否已被搶（taxiDriverUid 已存在）
- 行程衝突檢查：透過 Google Maps API 計算前後行程間的距離與車程時間，若時間重疊或銜接不足則阻止接單
- 檢查通過後，系統以事務寫入：
driverConfirmationStatus = 'pending'tentativeDriverUid = 司機 UIDdriverConfirmationTime = 當前時間 + 5 分鐘
- 此時乘客資訊不可見，顯示「請等待系統確認後才能聯絡乘客（約 5 分鐘）」
- 介面顯示確認期倒計時
第二階段 — 正式確認
- 司機在 5 分鐘確認期內點擊確認
- 系統以事務更新：
- 移除暫時接單欄位（tentativeDriverUid、driverConfirmationTime 等）
- 設定正式欄位（taxiDriverUid、taxiDriverInfo、taxiDriverTime）
- 通知：LINE Flex 訊息通知乘客「司機已接單」+ Email、Slack 通知管理員
- 聊天功能解鎖，乘客資訊完全可見
超時或取消
- 5 分鐘內未確認：暫時接單自動取消，訂單重新開放給其他司機
- 司機主動取消：訂單回到「可接單」狀態
- 正式接單後棄單：訂單重新開放，LINE 通知乘客，Slack 通知管理員
車型篩選規則
| 司機類型 | 可見訂單 |
|---|---|
| 計程車司機 | 僅「經典小黃」訂單 |
| 租賃車司機 | 僅非「經典小黃」訂單 |
步驟 5：指派路線（B2B）
- 管理員在路線規劃中選擇可用車輛與司機
- 系統檢查車輛容量與司機資格是否符合需求
- 確認指派，司機收到行程通知
步驟 6：司機錢包與收入管理（C2C）
司機可在錢包頁面查看收入資訊：
| 項目 | 說明 |
|---|---|
| 單趟收入 | 實收金額（taxiDriverIncome）vs 原始金額（taxiDriverIncomeOrigin） |
| 累計收入 | 歷史總收入統計 |
| 提現功能 | 申請將累計收入匯入指定銀行帳戶（以存摺封面驗證） |
| 對帳單 | 管理員可查看司機收入統計與訂單明細 |
步驟 7：持續管理
- 車輛狀態管理（可用 → 使用中 → 保養中 → 退役）
- 司機排班管理
- 證件到期提醒與更新（30 天內到期自動警告）
- 車隊組織營運狀態管理（待審核 → 營運中 → 停用）
Worst Case
WC-1：證件過期
- 觸發條件：車輛保險、司機駕照或行照到期
- 系統行為：標記提醒管理員，到期車輛/司機暫停指派
- 處理方式：上傳更新的證件，審核通過後恢復可用
WC-2：車輛維修需求
- 觸發條件：車輛需要維修保養，暫時無法使用
- 系統行為：車輛狀態設為「保養中」，從可指派列表移除
- 處理方式：維修完成後更新狀態為「可用」
WC-3：司機無法出勤
- 觸發條件：已指派的司機臨時無法出勤
- 系統行為：通知管理員需要更換司機
- 處理方式：管理員從可用司機中重新指派
WC-4：車牌或電話重複
- 觸發條件：新增車輛或司機時資料與現有記錄衝突
- 系統行為：阻擋新增操作，提示資料已存在
- 處理方式：確認是否為重複建立，或修正資料後重新提交
WC-5：批次匯入格式錯誤
- 觸發條件：CSV 匯入檔案格式不正確或資料有誤
- 系統行為：先顯示預覽，標記有問題的資料列
- 處理方式：管理員修正資料後重新匯入
WC-6：無可用車輛
- 觸發條件：路線規劃時所有車輛都在使用中或保養中
- 系統行為：提示管理員目前無可用車輛
- 處理方式：新增車輛、調整排程或協調外部車隊支援
WC-7：司機審核未通過
- 觸發條件：C2C 司機自助註冊後證件審核不通過
- 系統行為：LINE 通知司機審核未通過及原因，附修改資料連結
- 處理方式：司機可補充或更正資料後重新提交，狀態回到「審核中」
WC-8：行程衝突（C2C 接單）
- 觸發條件：司機嘗試接單，但與已接行程的時間/距離衝突
- 系統行為：透過 Google Maps API 計算前後行程間距離與車程時間，顯示衝突詳情（行程號、時間、距離），阻止接單
- 處理方式：司機需等現有行程完成，或放棄接單
WC-9：暫時接單超時（C2C 接單）
- 觸發條件：司機暫時接單後 5 分鐘內未點擊正式確認
- 系統行為：自動取消暫時接單，訂單重新開放給其他司機
- 處理方式：司機需重新搶單
WC-10：司機棄單（C2C 正式接單後）
- 觸發條件：司機正式接單後主動棄單
- 系統行為：訂單重新開放，LINE 通知乘客「司機已取消」，Slack 通知管理員
- 處理方式：等待其他司機搶單，或管理員強制派單
WC-11：司機修改已通過資料
- 觸發條件：審核通過後司機修改個人或車輛資料
- 系統行為：審核狀態自動變為「重新審核」，暫停接單與通知
- 處理方式：管理員重新審核，通過後恢復接單能力
場景差異表
| 維度 | C2C 共乘 | 活動接駁 | 企業接駁 | 校車 | 旅遊包車 |
|---|---|---|---|---|---|
| 發起人 | 司機本人（自助申請） | 車隊管理員 | 車隊管理員 | 車隊管理員 | 司機本人或車隊 |
| 註冊方式 | App 三步驟表單 + 證件上傳 | 後台新增或 CSV 匯入 | 後台新增或 CSV 匯入 | 後台新增或 CSV 匯入 | App 申請或後台新增 |
| 審核流程 | 平台審核（含政策簽署） | 車隊管理員審核 | 車隊管理員審核 | 車隊管理員審核（加強背景查核） | 平台審核 |
| 車輛數量 | 通常 1 輛 | 多輛，批次管理 | 多輛，批次管理 | 多輛，批次管理 | 通常 1 輛 |
| 組織歸屬 | 獨立司機 | 歸屬車隊組織 | 歸屬企業車隊 | 歸屬學校車隊 | 獨立或車隊 |
| 接單/指派 | 兩階段搶單確認 | 管理員排程指派 | 管理員排程指派 | 管理員排程指派 | 搶單或指派 |
| 行程衝突檢查 | Google Maps 距離時間計算 | 管理員排程時檢查 | 管理員排程時檢查 | 管理員排程時檢查 | Google Maps 距離時間計算 |
| 證件管理 | 司機自行更新，30 天到期警告 | 管理員統一追蹤 | 管理員統一追蹤 | 管理員統一追蹤（更嚴格） | 司機自行更新 |
| 收入結算 | 平台抽成 + 司機錢包 + 提現 | 依合約結算 | 依合約結算 | 依合約結算 | 平台抽成 + 司機錢包 |
所屬主流程
| 主流程 | 關聯 | 說明 |
|---|---|---|
| M1 服務設計 | 前置 | 服務方案定義車輛需求 |
| M3 媒合排程 | 被呼叫 | 排程時查詢可用車輛與司機 |
| M4 行程執行 | 被呼叫 | 執行時更新車輛狀態為「使用中」 |