From eb46ce1b0caec67b3af7df0a0ba8a95ca411b1a8 Mon Sep 17 00:00:00 2001 From: awei Date: Tue, 21 Jul 2026 22:01:03 +0800 Subject: [PATCH] =?UTF-8?q?feat(driver):=20=E6=96=B0=E5=A2=9E=20PUT=20/api?= =?UTF-8?q?/driver/profile=20=E8=AE=93=E5=8F=B8=E6=A9=9F=E8=83=BD=E5=A1=AB?= =?UTF-8?q?=E8=81=AF=E7=B5=A1=E9=9B=BB=E8=A9=B1?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 乘客端「撥打司機電話」按鈕(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 --- cmd/server/main.go | 1 + internal/constants/phone.go | 48 ++++++++++++++ internal/constants/phone_test.go | 45 +++++++++++++ internal/handler/driver.go | 31 +++++++++ internal/repository/repository.go | 10 +++ internal/service/driver_phone_test.go | 96 +++++++++++++++++++++++++++ internal/service/driver_registry.go | 26 ++++++++ internal/service/errors.go | 1 + 8 files changed, 258 insertions(+) create mode 100644 internal/constants/phone.go create mode 100644 internal/constants/phone_test.go create mode 100644 internal/service/driver_phone_test.go diff --git a/cmd/server/main.go b/cmd/server/main.go index 8d057bb..96f9b31 100644 --- a/cmd/server/main.go +++ b/cmd/server/main.go @@ -247,6 +247,7 @@ func main() { authed.Use(middleware.DriverAuth(cfg.JWTSecret)) { authed.GET("/driver/me", driverHandler.Me) + authed.PUT("/driver/profile", driverHandler.UpdateProfile) authed.GET("/driver/vehicle", driverHandler.Vehicle) authed.PUT("/driver/vehicle", driverHandler.UpdateVehicle) authed.GET("/driver/earnings", driverHandler.Earnings) diff --git a/internal/constants/phone.go b/internal/constants/phone.go new file mode 100644 index 0000000..db91606 --- /dev/null +++ b/internal/constants/phone.go @@ -0,0 +1,48 @@ +package constants + +import ( + "strings" + "unicode" +) + +const ( + // MinPhoneLen / MaxPhoneLen 為正規化後的長度界線(不含 `+`)。 + // 下界取 8:台灣市話最短為 8 碼(不含區碼的台北號碼)。 + // 上界取 15:E.164 規定的國際號碼最大長度。 + MinPhoneLen = 8 + MaxPhoneLen = 15 +) + +// NormalizePhone 去掉空白與人類可讀的分隔符號(`-`、`(`、`)`),保留開頭的 `+`。 +// 乘客端是拿這個值直接組 `tel:` 撥號用的,留著分隔符號不影響撥號, +// 但正規化後才好做長度與字元驗證,也避免同一支號碼存成多種寫法。 +func NormalizePhone(s string) string { + var b strings.Builder + for _, r := range s { + if unicode.IsSpace(r) || r == '-' || r == '(' || r == ')' { + continue + } + b.WriteRune(r) + } + return b.String() +} + +// IsValidPhone 寬鬆驗證(比照 IsValidPlateNumber 的取捨):只檢查長度與字元集, +// 不綁「09 開頭」這類特定樣式——司機可能留市話或國際號碼,硬綁會誤擋真號碼。 +// 傳入值須為 NormalizePhone 的輸出(全形數字不會被轉半形,會在此被判為非法)。 +// 空字串代表「清除電話」,由呼叫端自行決定是否允許,不在這裡放行。 +func IsValidPhone(s string) bool { + digits := s + if strings.HasPrefix(digits, "+") { + digits = digits[1:] + } + if len(digits) < MinPhoneLen || len(digits) > MaxPhoneLen { + return false + } + for _, r := range digits { + if r < '0' || r > '9' { + return false + } + } + return true +} diff --git a/internal/constants/phone_test.go b/internal/constants/phone_test.go new file mode 100644 index 0000000..2693f2b --- /dev/null +++ b/internal/constants/phone_test.go @@ -0,0 +1,45 @@ +package constants + +import "testing" + +func TestNormalizePhone(t *testing.T) { + cases := map[string]string{ + " (02) 2345-6789 ": "0223456789", + "0912-345-678": "0912345678", + "+886 912 345 678": "+886912345678", + "": "", + } + for in, want := range cases { + if got := NormalizePhone(in); got != want { + t.Errorf("NormalizePhone(%q) = %q,預期 %q", in, got, want) + } + } +} + +func TestIsValidPhone(t *testing.T) { + valid := []string{ + "0223456789", // 市話含區碼 + "0912345678", // 手機 + "+886912345678", // 國際格式 + "23456789", // 8 碼市話(下界) + } + for _, s := range valid { + if !IsValidPhone(s) { + t.Errorf("IsValidPhone(%q) 應為 true", s) + } + } + + invalid := []string{ + "", // 空字串由呼叫端決定是否放行,這裡一律 false + "1234567", // 7 碼,短於下界 + "1234567890123456", // 16 碼,超過 E.164 上界 + "0912345678", // 全形數字(NormalizePhone 不轉半形) + "0912345678a", // 夾雜英文字母 + "09123+45678", // `+` 只允許出現在開頭 + } + for _, s := range invalid { + if IsValidPhone(s) { + t.Errorf("IsValidPhone(%q) 應為 false", s) + } + } +} diff --git a/internal/handler/driver.go b/internal/handler/driver.go index cbb4292..be9c16d 100644 --- a/internal/handler/driver.go +++ b/internal/handler/driver.go @@ -68,6 +68,37 @@ func (h *DriverHandler) Me(c *gin.Context) { c.JSON(http.StatusOK, driverPublic(d)) } +// UpdateProfile PUT /api/driver/profile — 司機自己的聯絡電話。 +// driver_id 一律取自 token,司機只能改自己的。 +// +// **刻意與 PUT /driver/vehicle 分開**:那支會把車輛審核重置為 pending(O5), +// 改電話若走同一支,司機每改一次號碼就會被鎖出接單。 +// +// `phone` 傳空字串=清除號碼(乘客端撥號按鈕隨之消失),故不加 `binding:"required"`。 +func (h *DriverHandler) UpdateProfile(c *gin.Context) { + driverID := middleware.DriverIDFromCtx(c) + var req struct { + Phone string `json:"phone"` + } + if err := c.ShouldBindJSON(&req); err != nil { + c.JSON(http.StatusBadRequest, gin.H{"error": "參數錯誤"}) + return + } + d, err := h.drivers.SetPhone(driverID, req.Phone) + if err != nil { + switch { + case errors.Is(err, service.ErrInvalidPhone): + c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()}) + case errors.Is(err, service.ErrNotFound): + c.JSON(http.StatusNotFound, gin.H{"error": "找不到司機"}) + default: + c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()}) + } + return + } + c.JSON(http.StatusOK, driverPublic(d)) +} + // driverVehicle 車輛資訊的回應形狀(O2/O5)。 // `has_vehicle`=填了沒(App 決定是否顯示強制設定頁); // `review_status`=審核狀態(App 四態路由:pending 審核中/rejected 已退回+原因); diff --git a/internal/repository/repository.go b/internal/repository/repository.go index 42699a9..d3b15b2 100644 --- a/internal/repository/repository.go +++ b/internal/repository/repository.go @@ -250,6 +250,16 @@ func isPlateConflict(err error) bool { return pgErr.Code == pgUniqueViolation && pgErr.ConstraintName == "uq_drivers_plate_number" } +// UpdatePhone 只更新聯絡電話。**刻意不與 UpdateVehicle 共用**—— +// 那條路徑會把 vehicle_review_status 重置為 pending,若把電話併進去, +// 司機改一次電話就會被 O5 gate 踢回「審核中」而無法接單。 +func (r *DriverRepository) UpdatePhone(id int64, phone string) error { + return r.db.Model(&model.Driver{}).Where("id = ?", id).Updates(map[string]interface{}{ + "phone": phone, + "updated_at": time.Now(), + }).Error +} + func (r *DriverRepository) SetPassword(id int64, passwordHash string) error { return r.db.Model(&model.Driver{}).Where("id = ?", id).Updates(map[string]interface{}{ "password_hash": passwordHash, diff --git a/internal/service/driver_phone_test.go b/internal/service/driver_phone_test.go new file mode 100644 index 0000000..93cb1e5 --- /dev/null +++ b/internal/service/driver_phone_test.go @@ -0,0 +1,96 @@ +package service + +import ( + "errors" + "testing" + + "line-fleet-dispatch/internal/constants" + "line-fleet-dispatch/internal/repository" +) + +// TestDriverSetPhone 驗證司機聯絡電話的寫入路徑。 +// 這條路徑在此之前不存在——乘客端的撥號按鈕(O7)讀 drivers.phone, +// 但沒有任何 API 能寫它,所以按鈕永遠不顯示。 +func TestDriverSetPhone(t *testing.T) { + db := newServiceTestDB(t) + driversRepo := repository.NewDriverRepository(db) + reg := NewDriverRegistry(driversRepo) + + newDriver := func(t *testing.T, lineID string) int64 { + t.Helper() + d, err := driversRepo.FindOrCreate(lineID, "電話測試司機") + if err != nil { + t.Fatalf("建立司機失敗:%v", err) + } + return d.ID + } + + t.Run("寫入前先正規化分隔符號", func(t *testing.T) { + id := newDriver(t, "U_phone_norm") + got, err := reg.SetPhone(id, " (02) 2345-6789 ") + if err != nil { + t.Fatalf("設定電話應成功:%v", err) + } + if got.Phone != "0223456789" { + t.Fatalf("電話未正規化,得到 %q", got.Phone) + } + // 重讀確認真的落地,而不是只改了回傳的物件 + reread, err := driversRepo.FindByID(id) + if err != nil { + t.Fatalf("重讀司機失敗:%v", err) + } + if reread.Phone != "0223456789" { + t.Fatalf("DB 裡的電話是 %q", reread.Phone) + } + }) + + t.Run("空字串代表清除電話", func(t *testing.T) { + id := newDriver(t, "U_phone_clear") + if _, err := reg.SetPhone(id, "0912345678"); err != nil { + t.Fatalf("先設定電話應成功:%v", err) + } + got, err := reg.SetPhone(id, "") + if err != nil { + t.Fatalf("清除電話應成功:%v", err) + } + if got.Phone != "" { + t.Fatalf("電話應被清空,得到 %q", got.Phone) + } + }) + + t.Run("格式錯誤要擋下", func(t *testing.T) { + id := newDriver(t, "U_phone_bad") + for _, bad := range []string{"12345", "09一二三四五六七八", "0912-345-678a"} { + if _, err := reg.SetPhone(id, bad); !errors.Is(err, ErrInvalidPhone) { + t.Fatalf("%q 應回 ErrInvalidPhone,得到 %v", bad, err) + } + } + }) + + // 這是本功能存在的理由之一:電話若併進 SetVehicle, + // 司機改一次號碼就會被 O5 gate 踢回「審核中」而無法接單。 + t.Run("改電話不影響車輛審核狀態", func(t *testing.T) { + id := newDriver(t, "U_phone_no_review_reset") + if _, err := reg.SetVehicle(id, "sedan", "PHN-0001"); err != nil { + t.Fatalf("設定車輛應成功:%v", err) + } + if err := driversRepo.UpdateVehicleReview(id, constants.VehicleReviewApproved, ""); err != nil { + t.Fatalf("模擬審核通過失敗:%v", err) + } + + if _, err := reg.SetPhone(id, "0912345678"); err != nil { + t.Fatalf("設定電話應成功:%v", err) + } + + after, err := driversRepo.FindByID(id) + if err != nil { + t.Fatalf("重讀司機失敗:%v", err) + } + if after.VehicleReviewStatus != constants.VehicleReviewApproved { + t.Fatalf("改電話後審核狀態變成 %q,司機會被鎖出接單", after.VehicleReviewStatus) + } + if !after.VehicleApproved() { + t.Fatal("改電話後 VehicleApproved() 應仍為 true") + } + }) +} diff --git a/internal/service/driver_registry.go b/internal/service/driver_registry.go index fe8f4f1..0d13509 100644 --- a/internal/service/driver_registry.go +++ b/internal/service/driver_registry.go @@ -58,6 +58,32 @@ func (s *DriverRegistry) Me(driverID int64) (*model.Driver, error) { return s.drivers.FindByID(driverID) } +// SetPhone 設定司機聯絡電話。乘客端在「司機前往上車點」階段用這支號碼撥打(O7), +// 在此之前 drivers.phone 沒有任何寫入路徑,撥號按鈕因而永遠不顯示。 +// +// **與 SetVehicle 分開是刻意的**:SetVehicle 會把車輛審核重置為 pending, +// 而改電話不該讓司機被 O5 gate 鎖出接單。 +// +// 傳入空字串代表「清除電話」(司機不想公開號碼),此時乘客端整塊撥號按鈕不顯示。 +func (s *DriverRegistry) SetPhone(driverID int64, phone string) (*model.Driver, error) { + normalized := constants.NormalizePhone(phone) + if normalized != "" && !constants.IsValidPhone(normalized) { + return nil, ErrInvalidPhone + } + d, err := s.drivers.FindByID(driverID) + if err != nil { + if errors.Is(err, gorm.ErrRecordNotFound) { + return nil, ErrNotFound + } + return nil, err + } + if err := s.drivers.UpdatePhone(driverID, normalized); err != nil { + return nil, err + } + d.Phone = normalized + return d, nil +} + // SetVehicle 設定司機車輛資訊(O2):車種須為白名單 code,車牌正規化後做寬鬆格式檢查。 // 兩者皆必填——留空等同「未設定」,會讓司機繞過 O3 的接單 gate。 // 車牌與其他司機重複時回 repository.ErrPlateTaken。 diff --git a/internal/service/errors.go b/internal/service/errors.go index 4cc39b2..3fe1c93 100644 --- a/internal/service/errors.go +++ b/internal/service/errors.go @@ -16,6 +16,7 @@ var ( ErrLastSuperadmin = errors.New("不可移除最後一個 superadmin") ErrInvalidVehicleType = errors.New("車種無效") ErrInvalidPlateNumber = errors.New("車牌格式錯誤") + ErrInvalidPhone = errors.New("電話格式錯誤") // ErrDriverNoVehicle O3 gate:未填車輛資訊者不得接單。訊息會原樣回給司機 // (API 走 statusForErr → 409;LINE 走 webhook 的 err.Error() 文字回覆)。 ErrDriverNoVehicle = errors.New("請先填寫車種與車牌才能接單")