49c3fc1491
`.gitignore` 原先把 docs/plans/ 与 backend-java/docs/plans/ 记成「本地不入库」, 代价有两头:干净 worktree 出包时这些文件根本不存在(门禁要读它们的用例先假红), 跨会话的实施计划也没有留存通道。改为入库,本批把 34 个 md 落进仓库。
26 KiB
26 KiB
00 Plan Overview:后台管理前端 Vue 化任务总览
依据
docs/specs/全部 Spec 生成。本文件只提供全量任务索引;每个模块的详细 TDD 用例和验证步骤分别写入同编号 plan 文件。
执行约束
- 所有任务单线程串行执行:先测试、确认 RED,再实现、确认 GREEN,最后 lint/format、验证、commit。
- 每个任务目标耗时 8-15 分钟,按一个可验收功能点拆分,不按类或函数拆分。
- 每个任务至少 8 个测试用例:正常路径 3 个、边界 3 个、异常/错误 2 个;纯配置类任务可按对应 plan 的最低要求执行。
- 涉及 HTTP、数据库、Nginx、文件或外部进程时,必须同时有 mock 测试和至少一个真实集成/真实请求验证。
- 当前仓库已有其他未提交变更,执行任务时不得覆盖或重置无关工作树修改。
模块与任务数量
| Plan | 对应 Spec | 模块 | 任务数 |
|---|---|---|---|
01-admin-shell-routing |
docs/specs/01-admin-shell-routing.md |
后台壳层与路由 | 20 |
02-session-menu-permission |
docs/specs/02-session-menu-permission.md |
登录态、菜单树与菜单级权限 | 20 |
03-account-permission-pages |
docs/specs/03-account-permission-pages.md |
账号与权限页面 | 20 |
04-asin-data-center |
docs/specs/04-asin-data-center.md |
ASIN 数据中心 | 20 |
05-shop-center |
docs/specs/05-shop-center.md |
店铺中心 | 20 |
06-task-and-duplicate-center |
docs/specs/06-task-and-duplicate-center.md |
任务与重复分析中心 | 20 |
07-records-and-version |
docs/specs/07-records-and-version.md |
记录与版本中心 | 20 |
08-java-menu-and-flyway |
docs/specs/08-java-menu-and-flyway.md |
Java 菜单树与 Flyway 权限迁移 | 20 |
09-public-version-compatibility |
docs/specs/09-public-version-compatibility.md |
客户端公开版本接口兼容 | 20 |
10-static-deployment-nginx |
docs/specs/10-static-deployment-nginx.md |
静态资源部署与 Nginx History 托管 | 20 |
11-flask-removal-cutover |
docs/specs/11-flask-removal-cutover.md |
Flask 管理能力移除与入口切换 | 20 |
12-testing-acceptance |
docs/specs/12-testing-acceptance.md |
测试、回归与最终验收 | 20 |
13-admin-html-visual-alignment |
docs/specs/13-admin-html-visual-alignment.md |
AdminHtml 观感与交互对齐(蓝白浅色) | 32 |
| 合计 | 13 个模块 | 后台管理 Vue 化全链路 | 272 |
全量任务表
| ID | 功能点 | 模块 | 依赖 |
|---|---|---|---|
| 1 | 确认独立后台工程依赖、构建、测试和工作区边界 | 后台壳层与路由 | 无 |
| 2 | 冻结 /admin-vue/ base 与 History 路由约定 | 后台壳层与路由 | 1 |
| 3 | 定义 AdminLayout 页面容器职责 | 后台壳层与路由 | 2 |
| 4 | 定义深色侧边栏与浅色内容区设计 token | 后台壳层与路由 | 3 |
| 5 | 定义顶部栏用户信息和页面标题模型 | 后台壳层与路由 | 4 |
| 6 | 定义后端菜单树到侧边栏节点的映射规则 | 后台壳层与路由 | 5 |
| 7 | 实现根路由到首个可见页面的跳转规则 | 后台壳层与路由 | 6 |
| 8 | 实现业务域路由注册表 | 后台壳层与路由 | 7 |
| 9 | 实现路由 meta 菜单 key 约定 | 后台壳层与路由 | 8 |
| 10 | 实现页面级异步组件加载边界 | 后台壳层与路由 | 9 |
| 11 | 实现无菜单权限空状态 | 后台壳层与路由 | 10 |
| 12 | 实现路由级错误页面 | 后台壳层与路由 | 11 |
| 13 | 实现全局请求错误提示容器 | 后台壳层与路由 | 12 |
| 14 | 实现侧边栏折叠和窄屏布局行为 | 后台壳层与路由 | 13 |
| 15 | 实现页面标题与面包屑规则 | 后台壳层与路由 | 14 |
| 16 | 实现退出登录入口的壳层交互 | 后台壳层与路由 | 15 |
| 17 | 实现桌面端壳层响应式验收 | 后台壳层与路由 | 16 |
| 18 | 实现壳层键盘焦点和可访问性语义 | 后台壳层与路由 | 17 |
| 19 | 验证首批页面从壳层正确挂载 | 后台壳层与路由 | 18 |
| 20 | 完成壳层真实浏览器 smoke 验收 | 后台壳层与路由 | 19 |
| 21 | 定义 AdminUser 和 AdminMenuNode 类型契约 | 登录态、菜单树与菜单级权限 | 20 |
| 22 | 定义 API 响应解包和错误归一化规则 | 登录态、菜单树与菜单级权限 | 21 |
| 23 | 实现当前用户请求适配 | 登录态、菜单树与菜单级权限 | 22 |
| 24 | 实现菜单树请求适配 | 登录态、菜单树与菜单级权限 | 23 |
| 25 | 实现 Cookie/Session 请求配置 | 登录态、菜单树与菜单级权限 | 24 |
| 26 | 实现 401 登录跳转行为 | 登录态、菜单树与菜单级权限 | 25 |
| 27 | 实现 Pinia admin-session store 初始状态 | 登录态、菜单树与菜单级权限 | 26 |
| 28 | 实现当前用户初始化动作 | 登录态、菜单树与菜单级权限 | 27 |
| 29 | 实现菜单树初始化动作 | 登录态、菜单树与菜单级权限 | 28 |
| 30 | 实现初始化失败和重试状态 | 登录态、菜单树与菜单级权限 | 29 |
| 31 | 实现超级管理员菜单判定 | 登录态、菜单树与菜单级权限 | 30 |
| 32 | 实现普通用户菜单 key 查找 | 登录态、菜单树与菜单级权限 | 31 |
| 33 | 实现路由菜单权限守卫 | 登录态、菜单树与菜单级权限 | 32 |
| 34 | 实现无权限路由回退 | 登录态、菜单树与菜单级权限 | 33 |
| 35 | 实现无菜单用户状态 | 登录态、菜单树与菜单级权限 | 34 |
| 36 | 实现退出登录和状态清理 | 登录态、菜单树与菜单级权限 | 35 |
| 37 | 实现菜单树父子关系校验 | 登录态、菜单树与菜单级权限 | 36 |
| 38 | 实现菜单排序和空 route 处理 | 登录态、菜单树与菜单级权限 | 37 |
| 39 | 验证后端树形响应兼容边界 | 登录态、菜单树与菜单级权限 | 38 |
| 40 | 完成真实登录态与权限路由 smoke 验收 | 登录态、菜单树与菜单级权限 | 39 |
| 41 | 定义用户列表 DTO 和分页 DTO | 账号与权限页面 | 40 |
| 42 | 实现用户列表查询适配 | 账号与权限页面 | 41 |
| 43 | 实现用户筛选条件状态 | 账号与权限页面 | 42 |
| 44 | 实现用户分页边界行为 | 账号与权限页面 | 43 |
| 45 | 实现新建用户表单模型 | 账号与权限页面 | 44 |
| 46 | 实现新建用户请求适配 | 账号与权限页面 | 45 |
| 47 | 实现编辑用户表单回填 | 账号与权限页面 | 46 |
| 48 | 实现用户角色字段映射 | 账号与权限页面 | 47 |
| 49 | 实现用户菜单授权数据加载 | 账号与权限页面 | 48 |
| 50 | 实现用户菜单授权提交 | 账号与权限页面 | 49 |
| 51 | 实现用户删除确认和刷新 | 账号与权限页面 | 50 |
| 52 | 实现用户列表加载/空/错状态 | 账号与权限页面 | 51 |
| 53 | 定义菜单管理 DTO | 账号与权限页面 | 52 |
| 54 | 实现后台菜单列表加载 | 账号与权限页面 | 53 |
| 55 | 实现菜单新增表单 | 账号与权限页面 | 54 |
| 56 | 实现菜单编辑表单 | 账号与权限页面 | 55 |
| 57 | 实现菜单删除前置校验 | 账号与权限页面 | 56 |
| 58 | 实现同级菜单排序交互 | 账号与权限页面 | 57 |
| 59 | 实现数据权限分组列表和摘要 | 账号与权限页面 | 58 |
| 60 | 完成账号权限三页面真实 API 验收 | 账号与权限页面 | 59 |
| 61 | 定义 ASIN 中心共享分页和筛选类型 | ASIN 数据中心 | 60 |
| 62 | 实现去重汇总列表查询 | ASIN 数据中心 | 61 |
| 63 | 实现去重汇总日期和国家筛选 | ASIN 数据中心 | 62 |
| 64 | 实现去重汇总导出等待状态 | ASIN 数据中心 | 63 |
| 65 | 实现去重汇总导入任务创建 | ASIN 数据中心 | 64 |
| 66 | 实现去重汇总导入轮询和终态 | ASIN 数据中心 | 65 |
| 67 | 实现去重汇总删除导入流程 | ASIN 数据中心 | 66 |
| 68 | 实现品牌数据库列表查询 | ASIN 数据中心 | 67 |
| 69 | 实现品牌数据库新增/编辑表单 | ASIN 数据中心 | 68 |
| 70 | 实现品牌数据库删除确认 | ASIN 数据中心 | 69 |
| 71 | 实现查询 ASIN 列表和筛选 | ASIN 数据中心 | 70 |
| 72 | 实现查询 ASIN 导入与轮询 | ASIN 数据中心 | 71 |
| 73 | 实现查询 ASIN 删除导入 | ASIN 数据中心 | 72 |
| 74 | 实现查询 ASIN 详情抽屉 | ASIN 数据中心 | 73 |
| 75 | 实现最低价 ASIN 列表和筛选 | ASIN 数据中心 | 74 |
| 76 | 实现最低价 ASIN 导入与删除导入 | ASIN 数据中心 | 75 |
| 77 | 实现最低价 ASIN 详情编辑抽屉 | ASIN 数据中心 | 76 |
| 78 | 实现商品类目树加载和搜索 | ASIN 数据中心 | 77 |
| 79 | 实现商品类目新增/编辑/导出 | ASIN 数据中心 | 78 |
| 80 | 完成 ASIN 数据中心真实流程验收 | ASIN 数据中心 | 79 |
| 81 | 定义店铺和店铺密钥 DTO | 店铺中心 | 80 |
| 82 | 实现店铺密钥列表加载 | 店铺中心 | 81 |
| 83 | 实现店铺密钥筛选和分页 | 店铺中心 | 82 |
| 84 | 实现新增店铺密钥表单 | 店铺中心 | 83 |
| 85 | 实现编辑店铺密钥表单 | 店铺中心 | 84 |
| 86 | 实现密钥敏感字段掩码 | 店铺中心 | 85 |
| 87 | 实现密钥删除确认和刷新 | 店铺中心 | 86 |
| 88 | 实现店铺列表加载 | 店铺中心 | 87 |
| 89 | 实现店铺筛选和分页 | 店铺中心 | 88 |
| 90 | 实现店铺分组选项加载 | 店铺中心 | 89 |
| 91 | 实现新增店铺表单 | 店铺中心 | 90 |
| 92 | 实现编辑店铺表单 | 店铺中心 | 91 |
| 93 | 实现店铺凭证字段分离 | 店铺中心 | 92 |
| 94 | 实现店铺凭证明文短时展示 | 店铺中心 | 93 |
| 95 | 实现店铺删除确认 | 店铺中心 | 94 |
| 96 | 实现店铺账号字段校验 | 店铺中心 | 95 |
| 97 | 实现店铺数据空状态和错误状态 | 店铺中心 | 96 |
| 98 | 实现店铺中心通用筛选栏 | 店铺中心 | 97 |
| 99 | 实现店铺中心响应式表格 | 店铺中心 | 98 |
| 100 | 完成店铺中心真实 API 验收 | 店铺中心 | 99 |
| 101 | 定义统一任务状态和结果文件类型 | 任务与重复分析中心 | 100 |
| 102 | 实现视频任务筛选状态 | 任务与重复分析中心 | 101 |
| 103 | 实现视频任务列表/卡片加载 | 任务与重复分析中心 | 102 |
| 104 | 实现视频任务详情展示 | 任务与重复分析中心 | 103 |
| 105 | 实现视频任务批量选择 | 任务与重复分析中心 | 104 |
| 106 | 实现视频任务批量下载任务 | 任务与重复分析中心 | 105 |
| 107 | 实现视频任务下载失败摘要 | 任务与重复分析中心 | 106 |
| 108 | 实现视频任务数据范围配置 | 任务与重复分析中心 | 107 |
| 109 | 实现店铺数据任务筛选 | 任务与重复分析中心 | 108 |
| 110 | 实现店铺数据任务列表 | 任务与重复分析中心 | 109 |
| 111 | 实现店铺数据任务分页刷新 | 任务与重复分析中心 | 110 |
| 112 | 实现店铺数据任务批量选择 | 任务与重复分析中心 | 111 |
| 113 | 实现店铺数据任务批量下载 | 任务与重复分析中心 | 112 |
| 114 | 实现店铺数据任务权限配置 | 任务与重复分析中心 | 113 |
| 115 | 实现重复检查总览指标 | 任务与重复分析中心 | 114 |
| 116 | 实现重复检查分布视图 | 任务与重复分析中心 | 115 |
| 117 | 实现重复检查明细列表 | 任务与重复分析中心 | 116 |
| 118 | 实现重复检查详情抽屉 | 任务与重复分析中心 | 117 |
| 119 | 实现重复检查导入/导出状态 | 任务与重复分析中心 | 118 |
| 120 | 完成任务与重复检查真实流程验收 | 任务与重复分析中心 | 119 |
| 121 | 定义历史记录 DTO | 记录与版本中心 | 120 |
| 122 | 实现历史记录筛选条件 | 记录与版本中心 | 121 |
| 123 | 实现历史记录分页加载 | 记录与版本中心 | 122 |
| 124 | 实现历史结果预览抽屉 | 记录与版本中心 | 123 |
| 125 | 实现历史记录空/错状态 | 记录与版本中心 | 124 |
| 126 | 定义软件版本 DTO | 记录与版本中心 | 125 |
| 127 | 实现软件版本列表加载 | 记录与版本中心 | 126 |
| 128 | 实现软件版本上传表单 | 记录与版本中心 | 127 |
| 129 | 实现软件版本上传进度和错误 | 记录与版本中心 | 128 |
| 130 | 实现软件版本下载链接展示 | 记录与版本中心 | 129 |
| 131 | 定义数字人版本 DTO | 记录与版本中心 | 130 |
| 132 | 实现数字人版本列表加载 | 记录与版本中心 | 131 |
| 133 | 实现数字人版本上传 | 记录与版本中心 | 132 |
| 134 | 实现数字人版本状态展示 | 记录与版本中心 | 133 |
| 135 | 实现数字人版本发布操作 | 记录与版本中心 | 134 |
| 136 | 实现数字人版本设为最新操作 | 记录与版本中心 | 135 |
| 137 | 实现版本页面统一时间和文件格式化 | 记录与版本中心 | 136 |
| 138 | 实现版本页面权限路由接入 | 记录与版本中心 | 137 |
| 139 | 实现客户端公开版本接口回归夹具 | 记录与版本中心 | 138 |
| 140 | 完成记录与版本中心真实流程验收 | 记录与版本中心 | 139 |
| 141 | 冻结 Java 菜单树响应 DTO | Java 菜单树与 Flyway 权限迁移 | 140 |
| 142 | 定义 menu_type=admin 过滤规则 | Java 菜单树与 Flyway 权限迁移 | 141 |
| 143 | 实现有效菜单节点索引 | Java 菜单树与 Flyway 权限迁移 | 142 |
| 144 | 实现 parent_id 树组装 | Java 菜单树与 Flyway 权限迁移 | 143 |
| 145 | 实现菜单 sort_order 排序 | Java 菜单树与 Flyway 权限迁移 | 144 |
| 146 | 实现空父节点和脏数据处理 | Java 菜单树与 Flyway 权限迁移 | 145 |
| 147 | 实现分组节点 route 处理 | Java 菜单树与 Flyway 权限迁移 | 146 |
| 148 | 实现页面节点 route 输出 | Java 菜单树与 Flyway 权限迁移 | 147 |
| 149 | 实现 column_key 到 key 映射 | Java 菜单树与 Flyway 权限迁移 | 148 |
| 150 | 实现当前用户菜单树控制器响应 | Java 菜单树与 Flyway 权限迁移 | 149 |
| 151 | 覆盖超级管理员菜单树 | Java 菜单树与 Flyway 权限迁移 | 150 |
| 152 | 覆盖普通管理员菜单树 | Java 菜单树与 Flyway 权限迁移 | 151 |
| 153 | 覆盖无权限用户菜单树 | Java 菜单树与 Flyway 权限迁移 | 152 |
| 154 | 定义 route_path Flyway 迁移矩阵 | Java 菜单树与 Flyway 权限迁移 | 153 |
| 155 | 实现后台账号菜单 route 迁移 | Java 菜单树与 Flyway 权限迁移 | 154 |
| 156 | 实现 ASIN 和店铺菜单 route 迁移 | Java 菜单树与 Flyway 权限迁移 | 155 |
| 157 | 实现任务和记录菜单 route 迁移 | Java 菜单树与 Flyway 权限迁移 | 156 |
| 158 | 验证 column_key 和授权关系不变 | Java 菜单树与 Flyway 权限迁移 | 157 |
| 159 | 验证 Flyway 唯一约束和幂等性 | Java 菜单树与 Flyway 权限迁移 | 158 |
| 160 | 完成 Java 菜单树真实接口验收 | Java 菜单树与 Flyway 权限迁移 | 159 |
| 161 | 冻结 /api/version 响应契约 | 客户端公开版本接口兼容 | 160 |
| 162 | 冻结 /api/version/latest 响应契约 | 客户端公开版本接口兼容 | 161 |
| 163 | 定义 web_config 最新记录排序规则 | 客户端公开版本接口兼容 | 162 |
| 164 | 实现 Java 当前版本配置读取 | 客户端公开版本接口兼容 | 163 |
| 165 | 实现 Java 最新版本查询服务 | 客户端公开版本接口兼容 | 164 |
| 166 | 实现空版本表 null 语义 | 客户端公开版本接口兼容 | 165 |
| 167 | 实现版本字段空字符串语义 | 客户端公开版本接口兼容 | 166 |
| 168 | 实现公开接口不使用 ApiResponse 包装 | 客户端公开版本接口兼容 | 167 |
| 169 | 实现版本接口数据库错误处理 | 客户端公开版本接口兼容 | 168 |
| 170 | 验证多版本记录取最新 | 客户端公开版本接口兼容 | 169 |
| 171 | 验证同时间记录按 id 稳定排序 | 客户端公开版本接口兼容 | 170 |
| 172 | 验证 file_url 原样返回 | 客户端公开版本接口兼容 | 171 |
| 173 | 验证 desc/url 字段保留 | 客户端公开版本接口兼容 | 172 |
| 174 | 验证旧客户端请求路径不变 | 客户端公开版本接口兼容 | 173 |
| 175 | 验证公开接口与后台上传解耦 | 客户端公开版本接口兼容 | 174 |
| 176 | 验证 Java 接口替代 Flask 后响应一致 | 客户端公开版本接口兼容 | 175 |
| 177 | 补充版本接口控制器测试 | 客户端公开版本接口兼容 | 176 |
| 178 | 补充版本接口数据库集成测试 | 客户端公开版本接口兼容 | 177 |
| 179 | 完成真实客户端更新链路 smoke | 客户端公开版本接口兼容 | 178 |
| 180 | 完成 Flask 版本蓝图删除前置验收 | 客户端公开版本接口兼容 | 179 |
| 181 | 确认后台 dist 发布目录约定 | 静态资源部署与 Nginx History 托管 | 180 |
| 182 | 确认 Vite base 和 Router base 一致 | 静态资源部署与 Nginx History 托管 | 181 |
| 183 | 定义 index.html 缓存策略 | 静态资源部署与 Nginx History 托管 | 182 |
| 184 | 定义 hashed assets 缓存策略 | 静态资源部署与 Nginx History 托管 | 183 |
| 185 | 定义 /admin 重定向规则 | 静态资源部署与 Nginx History 托管 | 184 |
| 186 | 定义 /admin-vue/ 静态 location | 静态资源部署与 Nginx History 托管 | 185 |
| 187 | 定义 assets 优先匹配规则 | 静态资源部署与 Nginx History 托管 | 186 |
| 188 | 定义 History fallback 规则 | 静态资源部署与 Nginx History 托管 | 187 |
| 189 | 定义静态资源 404 规则 | 静态资源部署与 Nginx History 托管 | 188 |
| 190 | 定义 /api/ Java upstream 代理 | 静态资源部署与 Nginx History 托管 | 189 |
| 191 | 定义 Cookie 和转发请求头规则 | 静态资源部署与 Nginx History 托管 | 190 |
| 192 | 定义临时发布目录结构 | 静态资源部署与 Nginx History 托管 | 191 |
| 193 | 定义原子切换和回滚结构 | 静态资源部署与 Nginx History 托管 | 192 |
| 194 | 实现构建产物清单校验 | 静态资源部署与 Nginx History 托管 | 193 |
| 195 | 实现静态资源 MIME 验证 | 静态资源部署与 Nginx History 托管 | 194 |
| 196 | 实现桌面路由刷新验收脚本 | 静态资源部署与 Nginx History 托管 | 195 |
| 197 | 实现不存在资源 404 验收脚本 | 静态资源部署与 Nginx History 托管 | 196 |
| 198 | 验证生产 base URL 引用完整 | 静态资源部署与 Nginx History 托管 | 197 |
| 199 | 验证 Nginx 与 Java API 联通 | 静态资源部署与 Nginx History 托管 | 198 |
| 200 | 完成真实 Nginx 部署 smoke | 静态资源部署与 Nginx History 托管 | 199 |
| 201 | 盘点 Flask 管理页面和 API 流量 | Flask 管理能力移除与入口切换 | 200 |
| 202 | 盘点 Flask 版本接口调用方 | Flask 管理能力移除与入口切换 | 201 |
| 203 | 冻结 Flask 删除清单 | Flask 管理能力移除与入口切换 | 202 |
| 204 | 确认 Java 管理 API 覆盖矩阵 | Flask 管理能力移除与入口切换 | 203 |
| 205 | 确认 Vue 页面覆盖矩阵 | Flask 管理能力移除与入口切换 | 204 |
| 206 | 完成旧后台权限快照 | Flask 管理能力移除与入口切换 | 205 |
| 207 | 完成旧后台 API 响应快照 | Flask 管理能力移除与入口切换 | 206 |
| 208 | 完成 Java 菜单树回归 | Flask 管理能力移除与入口切换 | 207 |
| 209 | 完成 Java 公开版本回归 | Flask 管理能力移除与入口切换 | 208 |
| 210 | 完成 Nginx /admin-vue 回归 | Flask 管理能力移除与入口切换 | 209 |
| 211 | 切换 /admin 到 /admin-vue | Flask 管理能力移除与入口切换 | 210 |
| 212 | 验证旧 admin 页面无生产流量 | Flask 管理能力移除与入口切换 | 211 |
| 213 | 停止 Flask 管理路由注册 | Flask 管理能力移除与入口切换 | 212 |
| 214 | 删除 Flask admin blueprint | Flask 管理能力移除与入口切换 | 213 |
| 215 | 删除 Flask 管理页面模板 | Flask 管理能力移除与入口切换 | 214 |
| 216 | 删除旧 admin.js 和 interactions.js | Flask 管理能力移除与入口切换 | 215 |
| 217 | 删除 Java static 旧后台副本 | Flask 管理能力移除与入口切换 | 216 |
| 218 | 清理旧菜单扁平响应逻辑 | Flask 管理能力移除与入口切换 | 217 |
| 219 | 清理部署和文档旧入口引用 | Flask 管理能力移除与入口切换 | 218 |
| 220 | 完成 Flask 管理移除后真实 HTTP 验收 | Flask 管理能力移除与入口切换 | 219 |
| 221 | 建立独立后台前端测试命令 | 测试、回归与最终验收 | 220 |
| 222 | 建立后台前端类型检查门禁 | 测试、回归与最终验收 | 221 |
| 223 | 建立后台前端构建门禁 | 测试、回归与最终验收 | 222 |
| 224 | 真实启动 Java 后端并验证健康检查 | 测试、回归与最终验收 | 223 |
| 225 | 真实访问 /admin 与 /admin-vue 页面入口 | 测试、回归与最终验收 | 224 |
| 226 | 真实执行首批菜单加载与用户查询交互 | 测试、回归与最终验收 | 225 |
| 227 | 建立菜单树转换和权限守卫测试夹具 | 测试、回归与最终验收 | 226 |
| 228 | 建立 Session 初始化、401 和退出登录测试夹具 | 测试、回归与最终验收 | 227 |
| 229 | 建立账号权限页面 API 与表单回归测试 | 测试、回归与最终验收 | 228 |
| 230 | 建立 ASIN 数据中心 API 与导入导出回归测试 | 测试、回归与最终验收 | 229 |
| 231 | 建立店铺中心 API 与敏感字段回归测试 | 测试、回归与最终验收 | 230 |
| 232 | 建立任务中心、下载和重复检查回归测试 | 测试、回归与最终验收 | 231 |
| 233 | 真实验证 /api/version 与 /api/version/latest | 测试、回归与最终验收 | 232 |
| 234 | 建立 Flyway 菜单迁移集成测试 | 测试、回归与最终验收 | 233 |
| 235 | 真实验证 Nginx History fallback、assets 和 404 | 测试、回归与最终验收 | 234 |
| 236 | 建立 Playwright 核心交互、错误重试和响应式验收 | 测试、回归与最终验收 | 235 |
| 237 | 运行全量测试并记录覆盖率门禁 | 测试、回归与最终验收 | 236 |
| 238 | 运行 lint、format 和接口一致性检查 | 测试、回归与最终验收 | 237 |
| 239 | 验证每个任务均有对应 git commit 和 progress 状态 | 测试、回归与最终验收 | 238 |
| 240 | 执行最终发布验收并确认 check_progress 返回 all tasks done | 测试、回归与最终验收 | 239 |
模块 13 任务表(241-272,详见 13-admin-html-visual-alignment.md)
| ID | 功能点 | 依赖 |
|---|---|---|
| 241 | 冻结 admin.html 蓝白浅色 token 基线并迁移 theme/main.css | 240 |
| 242 | Element Plus 全局主题变量对齐蓝白浅色 | 241 |
| 243 | 壳层换皮(侧栏/顶栏/菜单)对齐蓝白浅色 | 242 |
| 244 | 页面公共区块样式收敛(panel/filter/table/footer/空错态) | 242 |
| 245 | 二次确认对话框共享组件 | 244 |
| 246 | 表单反馈/Toast/loading 语义统一 | 245 |
| 247 | 行内工具组件化(徽章/掩码/复制/白名单药丸) | 244 |
| 248 | 模态与抽屉容器统一 | 244 |
| 249 | 壳层与公共样式真实验收 + 每页检查清单模板 | 243-248 |
| 250 | 用户管理页面对齐(列表/筛选/文案/分页) | 249 |
| 251 | 用户管理补齐新建/编辑/角色+菜单授权弹窗 | 250 |
| 252 | 菜单管理页面对齐 | 250 |
| 253 | 数据权限分组页面对齐(选人通讯录编辑器) | 251 |
| 254 | 去重汇总页面对齐(筛选扩充+行编辑+导入/删除导入/导出) | 253 |
| 255 | 品牌数据库(不符合ASIN)页面对齐 | 254 |
| 256 | 商品类目页面对齐(懒加载树/搜索/导出/删除/新增编辑) | 255 |
| 257 | 查询ASIN页面对齐(配置抽屉与导入) | 255 |
| 258 | 最低价ASIN页面对齐(价格范围+配置抽屉+导入) | 257 |
| 259 | 生成记录页面对齐(筛选+缩略图预览布局) | 258 |
| 260 | 软件版本页面对齐 | 259 |
| 261 | 数字人版本页面对齐(状态色/发布/设最新/删除) | 260 |
| 262 | 店铺密钥页面对齐(白名单药丸/令牌留空语义) | 261 |
| 263 | 店铺管理页面对齐(掩码眼睛/凭证明文/校验) | 262 |
| 264 | 视频任务视图对齐(卡片网格+播放+单卡下载) | 263 |
| 265 | 视频任务筛选/权限配置/批量下载 对齐 | 264 |
| 266 | 店铺数据任务视图对齐(每店卡片网格) | 265 |
| 267 | 店铺数据任务筛选/批量下载/权限 对齐 | 266 |
| 268 | 15 页逐页对齐自查与修正 | 250-267 |
| 269 | e2e 换皮/对齐冒烟 | 268 |
| 270 | 本地 Java+Vue 全链路真实 smoke | 269 |
| 271 | 全量门禁与收尾提交 | 270 |
| 272 | module 收尾(progress 闭合 + 一致性校验) | 271 |
模块执行顺序
- 后台壳层与路由:任务 1-20;完成后进入下一模块。
- 登录态、菜单树与菜单级权限:任务 21-40;完成后进入下一模块。
- 账号与权限页面:任务 41-60;完成后进入下一模块。
- ASIN 数据中心:任务 61-80;完成后进入下一模块。
- 店铺中心:任务 81-100;完成后进入下一模块。
- 任务与重复分析中心:任务 101-120;完成后进入下一模块。
- 记录与版本中心:任务 121-140;完成后进入下一模块。
- Java 菜单树与 Flyway 权限迁移:任务 141-160;完成后进入下一模块。
- 客户端公开版本接口兼容:任务 161-180;完成后进入下一模块。
- 静态资源部署与 Nginx History 托管:任务 181-200;完成后进入下一模块。
- Flask 管理能力移除与入口切换:任务 201-220;完成后进入下一模块。
- 测试、回归与最终验收:任务 221-240;完成后进入下一模块。
- AdminHtml 观感对齐:任务 241-272;DuplicateCheckPage 为例外页不动。
每个任务的统一 TDD 准出标准
- 先写 plan 中列出的全部测试,运行项目测试命令确认目标测试 RED;如果测试一开始通过,必须修正测试使其能证明缺失行为。
- 实现功能,运行同一测试集确认 GREEN。
- 运行类型检查、lint、format 和相关真实集成验证。
- 检查无 stub、纯 echo、空实现、硬编码业务结果或未处理的错误分支。
- commit 后才能开始下一个任务;提交信息必须包含 task 编号。
最终验收目标
- 运行
admin-frontend-vue的 build、test 和 E2E smoke。 - 运行 Java 全量测试、菜单迁移测试和版本接口测试。
- 真实验证
/admin、/admin-vue/、History 刷新、assets 404、/api/version/latest。 - 确认 17 个后台业务面板完成 Vue 页面迁移。
- 壳层与 15 个后台页面观感/交互对齐
backend/web_source/admin.html现行蓝白浅色皮肤;DuplicateCheckPage(店铺撞款监控)为例外页不变。 - 确认 Flask 管理页面/API/版本蓝图已按 Spec 删除或迁移。
- 确认客户端
frontend-vue/和new_web_source/没有后台代码或构建产物。
总任务数:272