|
77 | 77 | - [🗓️ 預約司機+常用地點(跨端新功能,含 debug 兩個)](#-預約司機常用地點2026-07-31跨端新功能) |
78 | 78 | - [📜 第二十四輪:「我的行程」只看得到最近 20 趟](#-2026-07-31-第二十四輪我的行程只看得到最近-20-趟本批修掉) |
79 | 79 | - [🔁 第二十五輪:分頁尾巴會卡死在轉圈(回頭 debug 第二十四輪自己)](#-2026-08-01-第二十五輪分頁的尾巴會卡死在轉圈回頭-debug-第二十四輪自己本批修掉-2-個) |
| 80 | +- [🔤 第二十六輪:App 的字數上限與後端數的不是同一種單位](#-2026-08-01-第二十六輪app-的字數上限與後端數的不是同一種單位本批修掉-6-個欄位) |
80 | 81 |
|
81 | 82 | **四、維護、決策與待辦** |
82 | 83 | - [🧹 清開發殘留 worktree/舊分支(維護項 5)](#-清開發殘留-worktree舊分支維護項-52026-07-28-完成) |
|
93 | 94 | - **UI/UX 翻新(2026-07-10)**:LINE 綠亮暗雙主題;司機駕駛情境 UI;乘客地圖為底+卡片降級。靜態驗收 49 tests 通過;模擬器主鏈路待後端 docker 可起後補跑。 |
94 | 95 | **登入/註冊頁 2026-07-23 補齊翻新**(先前是唯一漏網畫面),詳見下方「🔐 登入頁 UI/UX 翻新+驗證」。 |
95 | 96 | - **座標導航(2026-07-10)**:司機端目的地導航改吃後端 `dropoff_point` 座標,地址僅供顯示與退路。 |
96 | | -- 單元測試:**54 個測試檔、`flutter test` 425 passed**(2026-08-01 第二十四輪併回 main 並修完尾巴那兩個洞後實測; |
| 97 | +- 單元測試:**55 個測試檔、`flutter test` 434 passed**(2026-08-01 第二十六輪後實測; |
97 | 98 | `flutter analyze` 無 issue、`flutter build apk --debug --flavor customer` 成功)。 |
98 | 99 | ~~(54 項)~~ 是 2026-07-10 的數字,長期沒更新,已更正——**本節的數字請跟著最後盤點日一起改**。 |
99 | 100 | - 遠端:`github.com/thothawei/fleet-app`。**2026-07-29 實查**:`git ls-remote --heads origin` 只有 `main`、 |
@@ -2461,9 +2462,93 @@ PSQL_DSN='postgres://fleet:change_me@127.0.0.1:5433/fleet?sslmode=disable' \ |
2461 | 2462 |
|
2462 | 2463 | --- |
2463 | 2464 |
|
| 2465 | +## 🔤 2026-08-01 第二十六輪:App 的字數上限與後端數的不是同一種單位(本批修掉 6 個欄位) |
| 2466 | + |
| 2467 | +> 本輪掃的族是**跨端輸入邊界對帳**——App 的欄位上限 vs 後端 validator。 |
| 2468 | +> 從沒掃過,而且掃出來的東西比預期硬:不只有三個欄位沒擋, |
| 2469 | +> **有擋的那三個擋的單位也是錯的**。 |
| 2470 | +
|
| 2471 | +### 根因一句話 |
| 2472 | + |
| 2473 | +Flutter 的 `TextField.maxLength` 數的是 **grapheme cluster**(使用者感知的「一個字」), |
| 2474 | +後端每一支上限數的都是 **rune**(`utf8.RuneCountInString` / `len([]rune(...))`)—— |
| 2475 | +對 ASCII 與中文相同,對 emoji 差到 7 倍。 |
| 2476 | + |
| 2477 | +### 取證(不是查文件,是實跑探針) |
| 2478 | + |
| 2479 | +``` |
| 2480 | +「👨👩👧👦」characters=1 runes=7 「🇹🇼」characters=1 runes=2 「👍🏽」characters=1 runes=2 |
| 2481 | +TextField(maxLength: 5) 擋完後 → characters=5 runes=35 |
| 2482 | +``` |
| 2483 | + |
| 2484 | +`maxLength: 5` 放行了 **35 個 rune**。於是評分畫面的計數器顯示「200/200 沒超過」, |
| 2485 | +送出卻被後端以 400 擋下,而錯誤訊息(「評論長度超過上限」)**不會說上限是多少**—— |
| 2486 | +對照著計數器看只會更困惑。 |
| 2487 | + |
| 2488 | +### 六個欄位的對帳表 |
| 2489 | + |
| 2490 | +| 欄位 | 後端上限(rune) | 修改前的 App | 判定 | |
| 2491 | +|---|---|---|---| |
| 2492 | +| 評分評論 | `ratingCommentMaxRunes` 200 | `maxLength: 200`(數 cluster) | ❌ 單位錯 | |
| 2493 | +| 遺失物描述 | `lostItemDescMaxRunes` 300 | `maxLength: 300`(數 cluster) | ❌ 單位錯 | |
| 2494 | +| 預約備註 | `maxScheduleNoteRunes` 200 | `maxLength: 200`(數 cluster) | ❌ 單位錯 | |
| 2495 | +| 聊天訊息 | `chatMaxRunes` 500 | **完全沒有上限** | ❌ 只能送出後才知道 | |
| 2496 | +| 常用地點名稱 | `maxPlaceLabelRunes` 40 | **完全沒有上限** | ❌ 同上 | |
| 2497 | +| 常用地點地址 | `maxPlaceAddressRunes` 200 | 唯讀(地圖選點反查) | ⚠️ 見下 | |
| 2498 | + |
| 2499 | +### 修法 |
| 2500 | + |
| 2501 | +- 新增共用的 [`RuneLimitingTextInputFormatter`](../lib/shared/widgets/rune_limit.dart) |
| 2502 | + + `runeCounter()`:**擋的單位與顯示的數字都與後端一致**。 |
| 2503 | +- **裁切落在 cluster 邊界**,不是直接砍 rune 陣列——從 ZWJ 序列中間切下去會留下 |
| 2504 | + 半個字(孤立的修飾符/ZWJ 尾巴),畫面會出現使用者沒打過的東西。寧可少收一個完整的字。 |
| 2505 | +- 保留 `maxLength` 只為了讓 Flutter 畫出計數器的位置,實際強制交給 formatter |
| 2506 | + (`maxLengthEnforcement: none`)——兩套同時生效會先被 cluster 那套擋掉。 |
| 2507 | +- 聊天輸入框**不放計數器**:訊息框下面多一行 `x/500` 太吵,而 500 字平常打不到。 |
| 2508 | +- **常用地點「地址」刻意不加限制器**:它是唯讀的、由地圖選點反查填入。 |
| 2509 | + 真的超過 200 rune 時應該讓後端拒絕,而不是在客戶端把地址默默截短—— |
| 2510 | + **截短過的地址是錯的地址**,司機會開到別的地方去。 |
| 2511 | + |
| 2512 | +### 驗收 |
| 2513 | + |
| 2514 | +- `flutter analyze` 無 issue、`flutter test` **434 passed**(425 +新 9)。 |
| 2515 | +- **反向驗證兩個半邊各一次**: |
| 2516 | + - 拿掉聊天輸入框的 formatter(回到先前無上限)→ 700 個 rune 整段進得去,該案 FAIL。 |
| 2517 | + - 把限制器改回數 cluster(=`maxLength` 的行為)→ **5 案 FAIL**。 |
| 2518 | +- **有一個案子專門驗「真畫面接上去了」**(常用地點名稱:開編輯表單→輸入 30 面旗子 |
| 2519 | + →只留 20 面、計數器顯示 `40/40`)——只驗共用元件本身的話, |
| 2520 | + 某個畫面漏接 `inputFormatters` 不會有任何測試變紅。 |
| 2521 | +- `flutter build apk --debug --flavor customer` 成功。 |
| 2522 | + |
| 2523 | +### 同族還沒碰的角落 |
| 2524 | + |
| 2525 | +- **遺失物描述/預約備註/評分評論這三個畫面沒有各自的「真畫面接上去了」測試** |
| 2526 | + (只有常用地點與聊天室有)。三個接法完全相同、`analyze` 也綠, |
| 2527 | + 但嚴格說它們的接線目前靠 review 不靠測試。**條件**:下次動到這三個畫面時順手補。 |
| 2528 | +- **司機端沒有任何自由輸入欄位**(車牌走後端驗證、聊天共用同一個元件),所以本輪不必動司機端。 |
| 2529 | + |
| 2530 | +--- |
| 2531 | + |
2464 | 2532 | ## 下次任務 |
2465 | 2533 |
|
2466 | | -> **🎯 2026-08-01 第二十五輪之後的狀態(開工先看這段)** |
| 2534 | +> **🎯 2026-08-01 第二十六輪之後的狀態(開工先看這段)** |
| 2535 | +> |
| 2536 | +> 1. **`gh pr list`(三個 repo)照樣是第一件事**——本輪開工時三個 repo 的 open PR 皆為 0。 |
| 2537 | +> 2. **第九次實查三個外部卡點:依然都不在**(`android/app/google-services.json`、 |
| 2538 | +> `ios/Runner/GoogleService-Info.plist` 不存在、`xcrun devicectl list devices` → No devices found)。 |
| 2539 | +> 3. **這一輪學到的一條(值得單獨記住)**: |
| 2540 | +> **「兩邊都有做限制」不等於「限制得住」——要先問兩邊數的是不是同一種單位。** |
| 2541 | +> 評分/協尋/預約那三個欄位的 `maxLength` 數字與後端**完全相同**(200/300/200), |
| 2542 | +> 程式碼上看起來對得整整齊齊,實際上一個數 grapheme、一個數 rune。 |
| 2543 | +> 對帳跨端契約時,**單位與數值要分開問兩次**。 |
| 2544 | +> 4. **下一輪候選**(依價值排序): |
| 2545 | +> - **同族收尾**:遺失物描述/預約備註/評分評論三個畫面補「真畫面接上去了」的測試 |
| 2546 | +> (本輪只補了常用地點與聊天室)。**條件**:下次動到那三個畫面時順手做,不必為它單開一輪。 |
| 2547 | +> - **數值與金額格式**(從沒掃過):`formatCentsAsNtd` 的 0/負數/大數、 |
| 2548 | +> 車資與清潔費相加的邊界、收入頁的月聚合。與本輪同一類(跨端表示法對帳)。 |
| 2549 | +> - **狀態機**(從沒掃過):後端新增 ride status code 時 App 的退路 |
| 2550 | +> (目前 `statusLabel` 有 default,但「未知狀態要不要給操作鈕」沒有統一答案)。 |
| 2551 | +
|
2467 | 2552 | > |
2468 | 2553 | > 1. **`gh pr list`(三個 repo)照樣是第一件事。** 本輪開工時:app 只有 #97(就是本輪在收的那支)、 |
2469 | 2554 | > dispatch #72(redis 讓開埠號)、admin 0。 |
|
0 commit comments