docs(home): 回填首页网格改版记录

This commit is contained in:
Zhou Weidong committed 2026-10-22 17:04:03 +08:00
1 parent dd96792e33
commit 1bb227e083
1 file changed
+40
+40
View File
@@ -863,3 +863,43 @@ $ flutter test
解读:四等分、56 内容高度、安全区、26 图标、4 间距、精确色值和无分割线
均有测试覆盖;645 项测试全部通过。`pubspec.lock` 未提交,未操作真机。
## 2026-10-22 首页改为三列探索网格
- 分支:`feature/home-grid-layout`
- 基线:`develop` / `origin/develop` = `6dea9d4`
- 实现提交:`dd96792 feat(home): 首页改为三列探索网格`
### 布局与数据
- 首页按参考图改为纯黑探索页:搜索框、皇冠、礼物入口、一级分类、
二级标签与三列封面网格。
- `HomeFeedController` 继续使用 10 条游标分页;支持下拉刷新、触底加载、
空态与失败重试,没有全量拉取。
- 一级固定项为精选/新剧/分类/榜单;古装/社群仅在 `/app/categories`
名称匹配时显示。新剧/分类/榜单复用现有页面。
- 二级标签按分类与题材可用性显示,筛选按钮复用 `FilterPage`。
- 卡片封面 5:6、圆角 8、间距 8;包含真实热剧/新剧/漫剧角标、
播放量、最多两行标题与最多两个题材标签。
- `Drama` 增加 `dramaType` 和可选 `createdAt`;卡片未下发上架时间时
从 Snowflake id 解析,不使用假数据。
- 原 `PlayerPage(homeMode: true)` 保留并迁至推荐 tab,播放器文件与测试未删除。
- 首页顶部中性色、卡片与描边 token 已沉淀到 `AppColors/AppDimens`,
后续 P14 复用。
### 门禁命令与原始输出
```text
$ flutter analyze
Analyzing reelshort-bottom-nav...
No issues found! (ran in 2.7s)
```
```text
$ flutter test
02:32 +651: All tests passed!
```
解读:三列网格、分类顺序、动态入口隐藏、角标、卡片信息、分页大小、
下一页追加和卡片进入播放器均有测试覆盖。`home_view.dart` 为 478 行,
其余新增组件均低于 500 行。`pubspec.lock` 未提交,未操作真机。