# 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. **后台壳层与路由**:任务 1-20;完成后进入下一模块。 2. **登录态、菜单树与菜单级权限**:任务 21-40;完成后进入下一模块。 3. **账号与权限页面**:任务 41-60;完成后进入下一模块。 4. **ASIN 数据中心**:任务 61-80;完成后进入下一模块。 5. **店铺中心**:任务 81-100;完成后进入下一模块。 6. **任务与重复分析中心**:任务 101-120;完成后进入下一模块。 7. **记录与版本中心**:任务 121-140;完成后进入下一模块。 8. **Java 菜单树与 Flyway 权限迁移**:任务 141-160;完成后进入下一模块。 9. **客户端公开版本接口兼容**:任务 161-180;完成后进入下一模块。 10. **静态资源部署与 Nginx History 托管**:任务 181-200;完成后进入下一模块。 11. **Flask 管理能力移除与入口切换**:任务 201-220;完成后进入下一模块。 12. **测试、回归与最终验收**:任务 221-240;完成后进入下一模块。 13. **AdminHtml 观感对齐**:任务 241-272;DuplicateCheckPage 为例外页不动。 ## 每个任务的统一 TDD 准出标准 1. 先写 plan 中列出的全部测试,运行项目测试命令确认目标测试 **RED**;如果测试一开始通过,必须修正测试使其能证明缺失行为。 2. 实现功能,运行同一测试集确认 **GREEN**。 3. 运行类型检查、lint、format 和相关真实集成验证。 4. 检查无 stub、纯 echo、空实现、硬编码业务结果或未处理的错误分支。 5. 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**