Skip to content

feat(driver): 新增 PUT /api/driver/profile 讓司機能填聯絡電話 - #42

Closed
thothawei wants to merge 1 commit into
mainfrom
claude/driver-phone-profile
Closed

thothawei wants to merge 1 commit into
mainfrom
claude/driver-phone-profile

Conversation

@thothawei

Copy link
Copy Markdown
Owner

問題

乘客端「撥打司機電話」按鈕(O7)2026-07-17 就上線了,資料讀 driver_phone。但 drivers.phone 沒有任何寫入路徑——註冊不收、沒有更新端點,只有測試碼直接寫 DB。結果正式流程下號碼恆為空字串,App 端 hasPhone 永遠 false,這顆按鈕從來沒有真正出現過。

做法

新開 PUT /api/driver/profile(driver JWT,driver_id 取自 token)。

刻意不把電話併進既有的 PUT /driver/vehicle:那條路徑的 UpdateVehicle 會把 vehicle_review_status 原子地重置為 pending(O5),司機每改一次電話就會被審核 gate 踢出接單池。

  • constants: NormalizePhone/IsValidPhone——8–15 碼、允許開頭 +。比照車牌的取捨不綁「09 開頭」樣式,否則市話與國際號碼會被誤擋
  • repository.UpdatePhone: 只寫 phone 與 updated_at
  • service.SetPhone: 空字串=清除號碼(司機可收回不公開)
  • handler.UpdateProfile + 路由

驗證

  • go build ./... OK
  • TestDriverSetPhone(正規化/清除/格式錯誤/改電話不影響車輛審核狀態)、TestNormalizePhone、TestIsValidPhone 全綠
  • 反向確認:讓 UpdatePhone 也重置審核 → 「改電話不影響車輛審核狀態」如預期 FAIL,已還原
  • live 全鏈路(docker):存 0912-345-678 → 回 0912345678;存完再查車輛 → review_status:"approved"、can_accept:true;存 12345 → 400「電話格式錯誤」;存 "" → 清除成功
  • 走完整叫車鏈路後,乘客端 GET /customer/rides/active 首次真的帶出 "driver_phone":"0912345678"

相依

App 端對應 PR:thothawei/fleet-app(司機端填寫入口)。後端可先合,App 端沒有這支端點只會存不了電話,不影響既有功能。

🤖 Generated with Claude Code

乘客端「撥打司機電話」按鈕(O7)讀 drivers.phone,但這個欄位在此之前
沒有任何寫入路徑——註冊不收 phone、沒有更新端點,只有測試碼直接寫 DB。
結果是正式流程下號碼恆為空字串,撥號按鈕永遠不顯示,功能形同不存在。

刻意不把電話併進既有的 PUT /driver/vehicle:那條路徑的 UpdateVehicle
會把 vehicle_review_status 原子地重置為 pending(O5),司機每改一次
電話就會被審核 gate 踢出接單池。

- constants: NormalizePhone/IsValidPhone,寬鬆驗證(8–15 碼、允許開頭 +),
  比照車牌的取捨不綁「09 開頭」樣式,以免誤擋市話與國際號碼
- repository: UpdatePhone 只寫 phone 與 updated_at
- service: SetPhone,空字串=清除號碼(司機可收回不公開)
- handler + route: PUT /api/driver/profile,driver_id 取自 token

測試:TestDriverSetPhone(含「改電話不影響車輛審核狀態」,已反向確認
注入迴歸後會 FAIL)、TestNormalizePhone/TestIsValidPhone。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
thothawei added a commit that referenced this pull request Jul 27, 2026
PR #42 的產品程式碼後來由別的 PR 進了 main,但它帶的兩個測試檔從未落地。
比對後只救這一個:internal/constants/phone_test.go。

main 目前對 NormalizePhone/IsValidPhone 的覆蓋只在 handler 層的
driver_profile_test.go,且只驗「4 碼失敗、正常手機通過」兩點。
本檔補上真正的邊界:
- 有效:8 碼市話(下界)、市話含區碼、手機、+886 國際格式
- 無效:7 碼(短於下界)、16 碼(超過 E.164 上界)、全形數字、
  夾雜英文字母、`+` 出現在開頭以外的位置、空字串

**刻意沒救 PR #42 的 internal/service/driver_phone_test.go**:它編碼的是當時的
行為假設,與 main 後來的決策衝突,跑起來會 FAIL——
- 它斷言 SetPhone("") 可清除電話,但 main 後來拍板「電話必填」而刻意擋空字串;
- 它斷言 "0912-345-678a" 會被擋,但 main 是「先正規化再驗證」,字母會被
  NormalizePhone 濾掉——這是 TODO 記載的刻意寬鬆(只驗位數不驗樣式,
  硬綁格式會誤擋市話與境外號碼)。
把它救回來等於用過時的測試去推翻現行決策,所以丟棄。

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
@thothawei

Copy link
Copy Markdown
Owner Author

2026-07-27 逐一比對後關閉:本 PR 的產品程式碼已全數在 main(由後續 PR 帶入)。

內容 main 狀態
PUT /api/driver/profile 路由 ✅ 已有
constants.NormalizePhone / IsValidPhone ✅ 已有
DriverRegistry.SetPhone ✅ 已有
service.ErrInvalidPhone ✅ 已有
internal/constants/phone_test.go ❌ 從未落地 → 已救回(#49)
internal/service/driver_phone_test.go ❌ 從未落地 → 刻意不救

不救 service 測試的理由:它編碼的是當時的行為假設,與 main 後來的決策衝突,實測 FAIL——
它斷言 SetPhone("") 可清除電話,但 main 後來拍板「電話必填」而刻意擋空字串;
它斷言 "0912-345-678a" 會被擋,但 main 是「先正規化再驗證」,字母會被 NormalizePhone 濾掉
(TODO 載明只驗位數不驗樣式,硬綁格式會誤擋市話與境外號碼)。
救回來等於用過時的測試推翻現行決策。

分支 claude/driver-phone-profile 保留,未刪除。

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant