docs(plans): 下发 K9 首页剧目网格改造
This commit is contained in:
1 parent
ad13692b5d
commit
b434f6594b
1 file changed
+48
@@ -20,6 +20,54 @@
|
||||
|
||||
---
|
||||
|
||||
## [待处理] 2026-10-17 | K9 首页剧目列表改造(2 列全部剧目)
|
||||
|
||||
**用户指令(2026-10-17)**:「优化首页,要有全部剧目的列表,一行 2 个,不用显示继续观看的」。
|
||||
|
||||
> 只改首页(发现页)信息流布局与卡片,不改接口、不改业务逻辑、不动后端。
|
||||
> 依赖 K5 主题 token 与现有 `RemoteImage` / 卡片视觉。
|
||||
|
||||
### 〇、开工前必读
|
||||
|
||||
1. `AGENTS.md`、`CODING_STANDARDS.md`、`GIT_WORKFLOW.md`
|
||||
2. 当前首页 `lib/pages/discover/discover_view.dart`(649 行)
|
||||
3. K5 主题 token、K7 轮播实现
|
||||
4. 本 INBOX 条目
|
||||
|
||||
### 一、PM 已勘察的现状(实测)
|
||||
|
||||
- 首页结构(`discover_view.dart`):顶部 header → 轮播(home feed banners)→ 分类 chips(为你推荐/热门/最新/服务端分类)→「继续观看」标题 + 横向卡片列表(高 196、卡片宽 132,`_dramaContent` / `_continueHeader` / `_continueTile`)。
|
||||
- 数据源:`CategoryController.visibleDramas`(当前选中分类的剧目);`_cardsFor(...)` 生成展示卡片;分类切换已有过滤逻辑。
|
||||
- 「继续观看」区块使用 l10n `continueWatching`;横向列表不展示播放进度,本质是分类剧目横滑。
|
||||
|
||||
### 二、本批范围(首页单页改造)
|
||||
|
||||
1. **移除「继续观看」区块**:删除 `_continueHeader` 调用与其标题;`_continueTile` 若不再被使用则一并删除(不留死代码)。
|
||||
2. **新增「全部剧目」2 列网格**:
|
||||
- 位置:分类 chips 下方,占据原「继续观看」位置;
|
||||
- 标题:新增 l10n `allDramas`(中文「全部剧目」/ English「All Dramas」/ Bahasa Indonesia「Semua Drama」);
|
||||
- 网格:每行 2 个,左右边距 16、列间距 12、行间距 16;封面竖版比例 2:3,圆角 14;
|
||||
- 卡片内容:封面、标题(最多 2 行)、分类/类型(最多 1 行),沿用现有深色渐变与文字层级;
|
||||
- 数据:当前选中分类下的全部剧目(沿用 `visibleDramas`,去重后全量渲染);「为你推荐」显示全部;
|
||||
- 点击:沿用 `logic.openCard(...)` 进详情;
|
||||
- 长列表性能:外层改为 `CustomScrollView` + `SliverGrid`(或等价的懒构建方案),不要用 `GridView(shrinkWrap: true)` 嵌套整页;图片沿用 `RemoteImage` 懒加载。
|
||||
3. **保留**:header、轮播、分类 chips、底部导航、现有三态(加载/失败重试/空态)与空态文案(无分类剧目/无搜索结果)。
|
||||
4. **明确不做**:不动接口与数据模型、不改观看记录/收藏/下载、不改轮播与通知、不新增分页(feed 一次返回全量)、不改底部导航。
|
||||
|
||||
### 三、测试与门禁
|
||||
|
||||
- 新增/更新 widget 测试:首页不再出现「继续观看」;出现 `allDramas` 标题;网格为 2 列(断言 `SliverGridDelegateWithFixedCrossAxisCount.crossAxisCount == 2`);分类切换后网格内容更新;空态与失败态保持。
|
||||
- `dart analyze lib test` 零告警;`flutter test` 全过;`flutter build apk --debug` 通过;构建前确认无并发 `flutter run`/`build` 占用 `build/`。
|
||||
- 真机验收由用户执行:首页滚动、2 列布局、分类切换、点击进详情。
|
||||
|
||||
### 四、Git 与留痕
|
||||
|
||||
- 从干净 `develop` 拉 `feature/flutter-k9-home-grid`;完成后 `git merge --no-ff` 回 `develop` 并 push;不动 `main`。
|
||||
- 先写 `FruitServer/docs/plans/2026-10-17-K9.md`;每步「叙述 + 命令 + 原始输出 + 解读」追加到 `PROGRESS.md`;完成后停住写回执。
|
||||
- 提交作者与提交者统一 `Zhou Weidong <502333560@qq.com>`。
|
||||
|
||||
---
|
||||
|
||||
## [已处理·待用户验收] 2026-10-17 | K8 登录页视觉重设计
|
||||
|
||||
**用户指令(2026-10-17)**:「接下来做登录页面 ui 优化,现在这个 ui 不好看」。
|
||||
|
||||
Reference in new issue
Block a user