Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions cmd/server/main.go
Original file line number Diff line number Diff line change
Expand Up @@ -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)
Expand Down
48 changes: 48 additions & 0 deletions internal/constants/phone.go
Original file line number Diff line number Diff line change
@@ -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
}
45 changes: 45 additions & 0 deletions internal/constants/phone_test.go
Original file line number Diff line number Diff line change
@@ -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)
}
}
}
31 changes: 31 additions & 0 deletions internal/handler/driver.go
Original file line number Diff line number Diff line change
Expand Up @@ -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 已退回+原因);
Expand Down
10 changes: 10 additions & 0 deletions internal/repository/repository.go
Original file line number Diff line number Diff line change
Expand Up @@ -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,
Expand Down
96 changes: 96 additions & 0 deletions internal/service/driver_phone_test.go
Original file line number Diff line number Diff line change
@@ -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")
}
})
}
26 changes: 26 additions & 0 deletions internal/service/driver_registry.go
Original file line number Diff line number Diff line change
Expand Up @@ -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。
Expand Down
1 change: 1 addition & 0 deletions internal/service/errors.go
Original file line number Diff line number Diff line change
Expand Up @@ -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("請先填寫車種與車牌才能接單")
Expand Down
Loading