🔄 1. 核心業務四階段串接管線 (Business Pipeline)
在 @[DEV] 中，教務、財務與課務不再是孤立的模組，而是透過資料庫外鍵與流水號 ID 深度貫通的連續性業務閉環：
🤝 階段 1：家教案件指派成案 (Case Matching)
案件填寫期望時段 ➔ 智慧比對名師破碎排課時段 ➔ 完成名師指派成案。
📝 階段 2：已授課堂回報 (Session Report)
名師完成實授 ➔ 主任回報堂數與時數 ➔ 頂部統計累加 ➔ 自動生成待核銷學費帳單。
🏧 階段 3：學費轉帳末五碼核帳 (Tuition Verification)
家長 ATM 轉帳 ➔ 填報末五碼 ➔ 主任一鍵核帳入帳 ➔ 產生采心官方正式電子收據。
💰 階段 4：月度課酬放款憑單 (Payroll Payout)
依已核帳單據自動歸戶 ➔ 精準三方分帳分拆 ➔ 正式放款開立采心放款憑單。
🤝 2. 階段 1：家教案件指派成案與智慧適配
主任代開學生需求案件時，填寫學生姓名、年級、科目與 期望授課時段 (expectedTimes)。
點選「🎯 指派名師」時，系統後端自動透過 SQL JOIN 查詢全體審查合格師資，並比對其每週可授課時段（teacher_availability）。
成案後案件狀態更新為已媒合，並鎖定授課名師。
📝 3. 階段 2：已授課堂回報與應收學費單動態生成
完課後，主任於案件列表中點選 「📝 已授課堂回報」。 彈窗自動帶入該案名師專屬定價（家長時薪、老師時薪、中心服務費與車馬費）。 主任確認回報堂數（如 4 堂）與時數後點擊送出，系統同時觸發兩項核心連動：
- 頂部統計卡累加：「全平台已授課堂回報」即刻累加本次回報之實際堂數。
- 動態生成待核銷帳單：在「學費轉帳核帳中心」自動開立
tuition_payments單據（狀態為PENDING_VERIFICATION），金額精準計算，並於notes嵌入三方分帳標籤。
🏧 4. 階段 3：學費轉帳末五碼核帳與電子收據
家長轉帳後，主任於學費中心選取該筆單據填入轉帳末五碼（驗證必須為 5 位數字）或標記現金，點擊「✅ 核對入帳」：
- 單據狀態更新為
CONFIRMED，開立采心官方電子收據編號（CX-YYYYMM-XXXX）。 - 頂部統計卡「未核銷學費」扣減該筆金額，「本月預估總發放薪資」增加。
- 該筆已核銷金額即刻具備放款資格，流入月度課酬發放池！
💰 5. 階段 4：月度薪資結算與采心放款憑單
在月度薪資中心，主任選取名師與結算月份，系統自動抓取該師資於該月份所有狀態為 CONFIRMED 之學費繳費單據，
依照采心教育三方分帳法定公式進行透明拆分：
下方清晰條列每筆已入帳之繳費單號、學員姓名與實收拆解。點選「🧾 核准放款並開立采心放款憑單」即可寫入 payroll_records 並彈出具備法律效力之正式放款憑單。
🛡️ 6. 軟刪除安全閉環與零實體刪除 API
在教育媒合與財務管理系統中，開放後端實體刪除端點 (DELETE FROM) 存在致命資安風險（惡意毀損、破壞財務證據鏈、導致歷史完課外鍵破碎）。
@[DEV] 採取業界最高防護標準：
- 全面拔除後端硬刪除 API：後端無任何實體抹除端點，外部惡意呼叫一律回傳 404。
- 狀態生命週期控管 (Soft Delete)：人員除名改用
SUSPENDED凍結；師資停權改用FROZEN；案件異動改用RESET。 - 歷史存證 100% 完整：歷史課堂打卡、繳費收據與薪資放款憑單永久保留審計軌跡。
🔑 7. 唯一流水號 ID 與防同名同姓機制
為防範老師、學員出現同名同姓時發生帳務錯置或改名誤蓋，全站資料鏈關聯一律使用流水號 ID：
- 學生學籍：以
stu-xxx為唯一主鍵；改名時僅更新含有該studentId之學費單。 - 名師資產：以
tch-prof-xxx綁定費率、排課與課酬，絕不單憑文字姓名比對。 - 下拉選單防呆：所有選單均同時顯示「姓名 + 流水號 ID / Email」，讓主任在視覺上 100% 精準區隔。
🚨 8. 衝堂與跨行政區趕場車程雙重預警
排課引擎即時運算兩類潛在交通與時段風險：
- 🔴 衝堂衝突 (CONFLICT)：同一名師同日兩堂課時段重疊，立即標註紅色衝突框。
- 🟠 跨區車程不足 (DISTANCE_WARNING)：同一名師同日連續兩堂課位於新竹不同行政區（如東區到竹北），間隔小於 40 分鐘時自動觸發橘色趕場預警，防範名師疲勞奔波。