docs(plans): 记录 K11 首页三列网格实施回执

This commit is contained in:
Zhou Weidong committed 2026-10-17 22:35:19 +08:00
1 parent f97574b57e
commit 73292ba74d
2 files changed
+159 -1

No files matched your search

+136
View File
@@ -2359,6 +2359,142 @@ Running Gradle task 'assembleDebug'... 6.9s
---
## 2026-10-17 K11 首页 3 列与全部分类
### 27.1 范围、分支与计划
叙述:在 K9 首页「全部剧目」网格上做最小修订,每行 3 个,分类首项从
`For You` 改为「全部」。只改网格参数、首个分类 label 和对应测试。
- 客户端分支:`feature/flutter-k11-home-grid-3col`,基线 `0466b4b`。
- 文档分支:`docs/k11-home-grid-3col`,基线任务书 `2a06190`。
开工前先写并提交计划:
```text
f97574b docs(plans): 增加 K11 首页三列网格实施计划
```
### 27.2 先红:3 列与全部文案
先更新 K9 网格测试的期望值并执行:
```text
$ flutter test test/discover/home_all_dramas_grid_test.dart
Expected: exactly one matching candidate
Actual: _TextWidgetFinder:<Found 0 widgets with text "All": []>
00:01 +0 -1: Some tests failed.
```
解读:分类首项仍显示旧文案,3 列断言在首个失败处之后尚未执行;红灯与 K11
目标一致。
### 27.3 实现
`home_drama_grid.dart`:
```text
crossAxisCount: 3
mainAxisSpacing: 14
crossAxisSpacing: 10
childAspectRatio: 2 / 3
```
`discover_view.dart`:
```text
(code: CategoryController.allCode, label: l10n.all)
```
已核对三份 ARB 原本已有 `all`:
```text
lib/l10n/app_en.arb:49: "all": "All",
lib/l10n/app_zh.arb:49: "all": "全部",
lib/l10n/app_id.arb:49: "all": "Semua",
```
解读:直接复用现有三语 getter,未添加重复 JSON key,也未改动 l10n 生成文件。
### 27.4 定向绿灯
```text
$ flutter test test/discover/home_all_dramas_grid_test.dart
00:01 +5: All tests passed!
```
测试同时断言:
- `crossAxisCount == 3`
- `crossAxisSpacing == 10`
- `mainAxisSpacing == 14`
- `childAspectRatio == 2/3`
- 首个 chip 为 `All`,且位于 `Hot` 左侧
- 320px 小屏 3 列布局无溢出
两个既有首页壳层用例仍保留,只更新旧分类断言:
```text
$ flutter test test/widget_test.dart
00:05 +17: All tests passed!
```
### 27.5 全量门禁与构建
```text
$ dart analyze lib test
Analyzing lib, test...
No issues found!
```
```text
$ flutter test
00:18 +302 ~1: All tests passed!
```
解读:302 项通过,1 项联调测试因客户端接口服务未启动按设计跳过。
用户 Android `flutter run` 仍在运行,未终止该会话。为避免争用原项目
`build/`,将当前工作区同步到独立临时副本后执行:
```text
$ flutter build apk --debug
Running Gradle task 'assembleDebug'... 21.8s
✓ Built build/app/outputs/flutter-apk/app-debug.apk
```
### 27.6 Git
```text
f0db631 feat(flutter): 首页网格改为三列并首位显示全部
b5a8656 merge: 合并 K11 首页三列网格
0466b4b..b5a8656 develop -> develop
```
功能提交与合并提交 author/committer 均为
`Zhou Weidong <502333560@qq.com>`。
### 27.7 用户真机验证步骤与预期
以下设备侧取证由用户执行,Codex 未跑真机。
1. 使用最新客户端 `develop` 进入首页。
预期:分类 chips 第一项显示「全部 / All / Semua」,其后仍是热门、最新和
服务端分类。
2. 查看「全部剧目」列表。
预期:每行 3 个剧目,列间距 10、行间距 14,左右边距保持 16。
3. 检查长标题和类型。
预期:标题最多 2 行、类型最多 1 行,不横向或纵向溢出。
4. 点击「全部」及其他分类。
预期:网格内容按现有逻辑更新,点击卡片仍进入对应详情。
5. 在 320px 宽设备或小屏模拟器滚动列表。
预期:3 列布局稳定,无卡片重叠或整页溢出。
设备侧截图、滚动和分类切换结果由用户执行。
---
## 2026-10-17 iOS 构建阻塞:固定 shared_preferences_foundation 2.5.6
### 25.1 现象与根因