對外（B2C）家教課程系統
紙本與 Excel 的報名、收費與排課，集中到一套接進 LINE 的線上系統
把紙本與 Excel 上的家教課務，整合成一套接進 LINE 的自建系統。
- 成果
- 報名、收費與排課紀錄集中到同一套系統；主要課務作業改在線上處理
- 角色
- 從需求建立：架構、開發、部署與維運
- 時間
- 2026.05 上線
- 技術
- React · Node.js · Express · PostgreSQL · LINE LIFF · Ragic API
問題 報名、收費與排課靠紙本與 Excel，紀錄各自分散
報名、收費與排課原本靠紙本與 Excel，另有一部分在第三方系統，紀錄各自分散。權限也無法依角色劃分。
角色 從需求、架構到部署與維運
從需求與架構開始建立，負責開發、部署與維運。
整合成自建系統後，串接 LINE LIFF 與 Ragic，並新增角色權限設定頁面，可依職務設定權限。
使用流程 家長從 LINE 報名，櫃檯確認繳費後排課
- 家長從 LINE 進入，完成課程報名。
- 櫃檯確認繳費後，接續安排課程。
- 報名、收費與排課紀錄留在同一套系統。
教練另有 LINE 登入的教練端。後台供櫃檯、救生員與主管使用，依職務區分功能。
LINE 整合 家長報名、教練登入與推播
家長從 LINE 進入報名；教練用 LINE 登入教練端；LINE 推播設有 6 道安全閥。
效益 主要課務作業改在線上處理
主要課務作業改在線上處理，課程與流程可由內部自行調整。
家長從 LINE 進入就能完成報名；報名、收費與排課紀錄留在同一套系統，不再分散在紙本、Excel 與外部系統。
技術決策 權限改讀後台設定；LINE 推播加 6 道安全閥
權限原本寫死在程式裡，改成讀後台的角色設定。一人兼多職時，權限取所有身分的聯集。分四期完成。
LINE 推播加上 6 道安全閥，條件不明時一律不送：分成總開關、事件開關與每小時上限，另有去重、演練模式與測試收訊者。
上線後 三次問題排查與根因
- 2026 年 6 月｜修復 Ragic 員工同步逾時。 根因是迴圈內逐筆查詢，冷啟動時容易逾時；改成迴圈前一次撈齊兩張表，用 Map 對照。
- 同一天｜修復手動同步按鈕固定失敗。 前端送出空值，被伺服器的格式檢查擋下；修掉根因後恢復可用。
- 2026 年 9 月｜修復部分同步長期卡在處理中。 對正式站那筆資料實跑一次，才取得完整錯誤：遮蔽姓名時把 emoji 切成半個字。分三層修正，並把每一筆同步失敗都寫進資料庫；原本一批失敗，資料庫只留得住第一筆。
規模 265 個 API 路由、125 支測試腳本
依 GitHub 主線清點：265 個 API 路由、約 100 張資料表、13 個排程工作。
測試共 125 支腳本，分 unit、DB、E2E 等層。