Files
crawler-plugin/docs/plans/admin-front-vue/13-admin-html-visual-alignment.md
T
huangzd1997 49c3fc1491 docs(仓库): 规划文档改为入库,落盘品牌库/去重库每公司一套二期方案
`.gitignore` 原先把 docs/plans/ 与 backend-java/docs/plans/ 记成「本地不入库」,
代价有两头:干净 worktree 出包时这些文件根本不存在(门禁要读它们的用例先假红),
跨会话的实施计划也没有留存通道。改为入库,本批把 34 个 md 落进仓库。
2026-10-04 13:51:16 +08:00

280 lines
31 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 13-AdminHtml 观感对齐:任务计划(本地规划文件,不入库)
> 对应 Spec:`docs/specs/13-admin-html-visual-alignment.md`
> 模块范围:把 `admin-frontend-vue` 的壳层与 15 个业务页面(用户/菜单/分组、ASIN 五个页面、店铺密钥/店铺管理、生成记录/软件版本/数字人版本、视频任务/店铺数据任务)的观感与交互对齐旧 Flask 后台 `backend/web_source/admin.html`(现行蓝白浅色皮肤),**DuplicateCheckPage(店铺撞款监控,menuKey admin_shop_data_duplicate_check)为例外页,本次不动**。
> 任务号:全局续编 **241-272**(前 240 已完成)。每任务结束 commit 形如 `task-NNN(admin.html观感对齐): 描述`。
> 默认验证命令:`cd admin-frontend-vue; node --test tests/task-NNN.test.ts`(或 `npm test`);类型+构建门禁 `npm run build`。
## 统一测试与准出规则
- 每任务先写测试并确认 RED → 实现 → GREEN → `npm run build` 通过 → commit(信息含 task 编号)。
- 每个任务至少 8 条测试:正常路径 ≥3、边界 ≥3、异常 ≥2;涉及 HTTP/浏览器/DOM 时至少 1 条真实或 mock-request 验证;纯 token/常量类任务可降至 4-6 条,但必须以「能证明行为缺口」为前提,禁止空跑/桩断言。
- 只 stage 本任务改动的文件(`git add` 精确到文件),不得覆盖工作树中他人未提交改动。
- 本模块源基准 = `backend/web_source/admin.html` 现行「蓝白浅色」皮肤(CSS 末层 L4477-4830 生效)+ `backend/static/admin.js` / `admin-interactions.js` 的交互与文案;两者作为冻结参照,**不改动**。
---
## 任务 241:冻结 admin.html 蓝白浅色视觉 token 基线并迁移 theme/main.css
- **所属模块**:13 AdminHtml 观感对齐 / A 换皮与共享基线
- **依赖**:240
- **功能点要求**:以 admin.html 末层 :root(`--c-primary:#4f78a5`、`--c-primary-strong:#2f5d8b`、`--c-primary-soft:#e7f0f8`、`--c-bg:#f4f7fb`、浅色侧栏 `--c-sidebar:#edf3f9`/`#f8fbfe`、danger `#b35f6a`、success `#4e806d`、warning `#a8793e`、border `#d8e3ee`、radius 14/9、阴影)改写 `src/styles/theme.ts` 与 `main.css` 的 `--admin-*`/`:root`;侧栏从深色翻转为浅色。更新依赖 token 的不变量测试(原「侧栏为暗」断言改为「侧栏为浅色亮面 + 主色对比度」语义)。禁止 stub:所有改动点均要有测试覆盖与真实样式断言。
- **测试用例**:正常(3) token 值精确匹配基线的 hex;theme→cssVarName 与 :root 实际渲染值一致;边界(3) 空/未知 key 报错保留、主色/侧栏对比度达到 WCAG AA;异常(2) token 非法 hex 报错、不变量与旧深色断言冲突时给出可操作迁移信息。至少 1 条 readSource 校验 main.css 已写浅色侧栏。
- **验证方法**:`node --test tests/task-241.test.ts`;`npm run build`。
## 任务 242:Element Plus 全局主题色与组件默认值对齐蓝白浅色
- **所属模块**:13 / A
- **依赖**:241
- **功能点要求**:在 main.css 统一覆写 `--el-color-primary` 及 light-3~9/dark-2(取 #4f78a5 家族推导)、`--el-color-danger/success/warning`、`--el-border-radius-base`、el-button/el-input/el-select/el-table/el-pagination/el-tag/el-dialog 的圆角、边框、hover 态等,使 Element Plus 组件观感贴近 admin.html 的 .btn/.form-group input/.table-scroll/.pagination/.tag。建立「el 组件默认值映射表」到测试可读的常量文件(styles/ep-overrides.ts),页面直接受益。
- **测试用例**:正常(3) primary/danger 等 el 变量等于基线推导值;radius-base 生效;边界(3) 变量前缀完整(light-3…dark-2)、不受 light-3..9 越界覆盖影响;异常(2) 颜色不满足对比度、缺变量时测试报错提示。readSource 断言 el-button/el-input 关键值写入。
- **验证方法**:`node --test tests/task-242.test.ts`;`npm run build`。
## 任务 243:壳层换皮(侧栏/顶栏/菜单)对齐 admin.html 蓝白浅色
- **所属模块**:13 / A
- **依赖**:241,242
- **功能点要求**:AdminLayout 与相关 layout css:侧栏宽度 252px、浅色渐变底(#f8fbfe→#edf3f9)、菜单项高度/圆角/激活态「90deg 浅蓝渐变+inset 3px #5f85ad 竖条」、分组标题 12px 字距、品牌区高度与 logo;顶栏 76px、半透明白+blur、kicker「运营管理控制台」、面包屑「管理后台 / 页面名」、h1 18px、角色胶囊、退出按钮(secondary 形态)。保持折叠 64px 与窄屏行为。复用 sidebar-collapse/title-breadcrumb/logout 模块。
- **测试用例**:正常(3) 壳层类名/布局结构与浅色底存在;激活态含蓝条规则;顶栏高度=76px;边界(3) 折叠宽度、窄屏自动折叠、面包屑两级;异常(2) 缺菜单用户空态、菜单树异常降级。
- **验证方法**:`node --test tests/task-243.test.ts`;`npm run build`;dev 截图自查。
## 任务 244:页面公共区块样式收敛(panel/filter/table/footer/空错态)
- **所属模块**:13 / A
- **依赖**:241,242
- **功能点要求**:在 main.css 建立对齐 admin.html 的公共类:`.admin-panel-box`(白卡 radius14/阴影/头 h3+按钮同行)、`.admin-filter`(label 上、控件 min-height42、输入 focus 蓝 ring)、`.admin-table`(外框 1px #dbe5ee radius10、th #edf4fa 12.5px 600、tr hover #f1f7fb)、`.table-footer` 统一「共 N 条」+ 分页、空态 `.empty-tip`/错误重试统一。把 B 系 12 页 scoped 复制的 `.filter-grid/.f-item/.table-footer` 收敛为全局引用,逐页删 scoped 冗余(页面内联 style 一并清理),并保证 15 页观感一致。
- **测试用例**:正常(3) 公共类定义存在且值符合基线;footer 文案统一;边界(3) 空表/无数据/单页时页脚表现;异常(2) 某页仍残留 scoped 重复定义时 readSource 报错;全局类不被误删。
- **验证方法**:`node --test tests/task-244.test.ts`;`npm run build`。
## 任务 245:二次确认对话框共享组件(对齐 admin confirm 规则)
- **所属模块**:13 / A
- **依赖**:244
- **功能点要求**:实现共享 `confirm-action` 组件/组合(居中遮罩 blur、橙底感叹图标、标题/描述、取消 secondary + 确认 danger/primary),默认文案拼接规则对齐 admin-interactions:优先显式 message,否则由行名拼接「确认删除“X”吗?此操作可能影响已有数据。」;删除类按钮默认自动绑定。替换各页零散 ElMessageBox.confirm 为统一确认组件(保留既有逻辑)。危险操作=删除/清空/删除导入类。
- **测试用例**:正常(3) 标题/键文案拼接正确;danger 变体确认键「确认删除」;边界(3) 无名称时默认文案、Esc/遮罩关闭、异步 then/catch 不泄漏;异常(2) 无回调、并发多开被拒绝或排队。
- **验证方法**:`node --test tests/task-245.test.ts`;`npm run build`。
## 任务 246:表单反馈与请求反馈统一(msg/toast/loading 语义)
- **所属模块**:13 / A
- **依赖**:244,245
- **功能点要求**:统一成功/错误/警告反馈语义与文案规范(对齐 admin:成功常为绿 msg+toast、错误红、待办提示黄);表单提交按钮 loading/is-busy 态(防重复、文案如「保存中…」「导出中…」);全局请求进度(可选顶部进度条 + 右上 spinner,对齐 admin request-loading 文案「请求处理中...」)。做成共享 composable/组件(如 useAdminFeedback / AppFeedback),页面收敛调用。
- **测试用例**:正常(3) 成功/错误/警告通道独立可用且带语义 class;is-busy 置灰+防重入;边界(3) 连续错误不堆积、成功清错、文案兜底;异常(2) 网络失败给出可行动文案、非 Error 异常容错。
- **验证方法**:`node --test tests/task-246.test.ts`;`npm run build`。
## 任务 247:行内工具组件化(状态徽章/掩码/复制/白名单药丸)
- **所属模块**:13 / A
- **依赖**:244
- **功能点要求**:把散落的行内展示对齐 admin.html 语义并组件化:状态药丸(success/failed/running/warning 圆角999 三态色,供视频/店铺数据/数字人版本复用);掩码+显示(店铺密码/令牌,眼睛切换实时读取);复制文本(ASIN/链接,成功 toast「已复制 X」);白名单状态药丸+前置圆点与 title 帮助。放到 `src/components/` 共享并逐页替换手写实现。
- **测试用例**:正常(3) 三种状态渲染对应色/文案;复制成功回调 toast 文案;掩码切换状态;边界(3) 空值、长文本截断+title、复制失败降级文案;异常(2) 缺回调参数、DOM 不存在时安全降级。
- **验证方法**:`node --test tests/task-247.test.ts`;`npm run build`。
## 任务 248:模态与抽屉容器统一(居中 modal vs 右侧 drawer)
- **所属模块**:13 / A
- **依赖**:244
- **功能点要求**:统一两种承载容器:居中 `.admin-modal`(width min(920px,100vw-48)、radius14、头 h3+副标题+关闭、body 滚动、底部按钮行 gap8)与右侧 `.admin-drawer`(width min(460px,100%)、三段式),遮罩 blur,Esc/遮罩关闭语义对齐 admin;把 15 页 el-dialog/el-drawer 的宽度/头尾结构/关闭行为收口(不清除各页业务字段)。
- **测试用例**:正常(3) modal 尺寸/头尾结构;drawer 尺寸/三段式;Esc/遮罩关闭;边界(3) 内容超高内部滚动、窄屏宽度下限、多实例叠加 z-index;异常(2) 无标题页头兜底、关闭回调异常容错。
- **验证方法**:`node --test tests/task-248.test.ts`;`npm run build`。
## 任务 249:壳层与公共样式真实验收 + 每页检查清单模板
- **所属模块**:13 / A
- **依赖**:243-248
- **功能点要求**:本地起 dev(VITE_API_TARGET=18100 mock 或 Java 18080),对壳层+至少 2 个代表页(用户管理、店铺管理)做浏览器截图与 admin.html 并排自查:侧栏浅色、主色蓝灰、表格/筛选/按钮/分页观感、空/错/loading 态;生成 `docs/plans/…/13/13-panel-checklist.md` 模板(每页行:面板头/描述/筛选/列/操作/确认文案/成功文案/空错态/分页形态/是否补齐交互 各勾选项),作为后续 250-267 每页对齐与 268 自查的验收清单。
- **测试用例**:真实 HTTP/浏览器:起 mock+dev 后断言页面 title/壳层元素与 CSS 变量(浅色侧栏、主色)生效;Playwright 无 pageerror;清单模板文档存在且含全部 15 页。
- **验证方法**:`npm run test:browser -- e2e/13-shell.spec.ts`;人工截图对照。本任务可用真实浏览器代替纯单测,但仍需 ≥1 条断言脚本化。
## 任务 250:用户管理页面对齐(列表/筛选/文案/分页形态)
- **所属模块**:13 / B account
- **依赖**:249
- **功能点要求**:UsersPage 列表观感对齐 admin panel-users:页头描述「当前没有开放注册入口…层级:超级管理员->管理员->普通账号」;筛选含「用户名(模糊搜索)」与「所属管理员」(超管才显示,含「全部」);列 ID/用户名/角色(中文 roleLabel)/所属管理员/创建时间/操作,行尾固定;删除确认走 245 组件,禁删条件保留;分页「共 N 条 + 上/下+跳页」。createdByAdminId 筛选建模补接线。
- **测试用例**:正常(3) 列表渲染列与角色中文、筛选参数映射(含 created_by);删除禁删提示;分页跳页;边界(3) 空结果、页码越界回钳、超管/普通管理员 filter 显隐;异常(2) 加载失败错误态+重试、删除失败提示不清列表。
- **验证方法**:`node --test tests/task-250.test.ts`;`npm run build`。
## 任务 251:用户管理补齐新建/编辑/角色+菜单授权弹窗
- **所属模块**:13 / B
- **依赖**:250
- **功能点要求**:把已建模孤儿模块接线为 UI(对齐 admin.js users L325-1087 交互与文案):新建用户弹窗(用户名≥2/密码≥6 校验、角色、菜单授权树),成功 msg「创建成功」弹窗不关并清空刷新;编辑用户(密码留空不改、admin 登录者不能改角色)、用户菜单授权弹窗(菜单树两段:后台菜单/软件菜单,勾父清子、结构受限禁用、已选胶囊)。复用 user-create-model/adapter、user-edit-model、user-menu-auth(-api)、user-role-map、user-menu-auth.ts。
- **测试用例**:正常(3) 新建校验通过→POST 载荷正确、编辑回填、授权树提交;边界(3) 用户名<2/密码<6 报错、留空不改密码、勾父清子;异常(2) 权限树未加载不能保存、接口失败给可行动文案。
- **验证方法**:`node --test tests/task-251.test.ts`;`npm run build`。
## 任务 252:菜单管理页面对齐
- **所属模块**:13 / B
- **依赖**:250
- **功能点要求**:MenusPage 对齐 admin panel-columns:树表格列(拖动/ID/菜单名称/菜单类型/上级菜单/创建时间/操作)观感;排序交互决策对齐 admin(admin 用原生拖拽手柄仅同级同类型,失败回滚+「排序保存失败」);新增/编辑须选「页面」白名单(route 下拉含 column_key::route_path 42 项);删除确认+成功后刷新列表/权限树/侧栏;树默认展开。拖动或用现有上移下移以 admin 为准。
- **测试用例**:正常(3) 列表/弹窗字段/route 白名单选项、删除确认刷新联动;边界(3) 同类型限制、仅同级可排、白名单为空提示;异常(2) 排序保存失败回滚、删除父级有子保护。
- **验证方法**:`node --test tests/task-252.test.ts`;`npm run build`。
## 任务 253:数据权限分组页面对齐(含选人通讯录编辑器)
- **所属模块**:13 / B
- **依赖**:251
- **功能点要求**:GroupsPage 对齐 admin panel-group-manage:顶部「数据权限分组」摘要(shopManageGroupSummary 语义:各组组长/人数);分组列表(序号/分组名称/组长/组员数量/组员 chips/创建/修改/操作);新建/编辑分组弹窗含「通讯录选人面板」(搜索用户名/拼音首字母、按字母分组联系人、8 色首字母头像、A-Z 索引、底部已选 N 人);组长/超管才可编辑删除;删除「确定删除分组“X”吗?」并级联刷新 5 处;校验「请输入分组名称」。复用 shop-group-api/model、account/shop-group-*。
- **测试用例**:正常(3) 摘要渲染、选人面板搜索/勾选计数、保存载荷(组长+成员);边界(3) 空组员、拼音首字母检索、组长本人不可改;异常(2) 未授权不可编辑、删除失败提示。
- **验证方法**:`node --test tests/task-253.test.ts`;`npm run build`。
## 任务 254:去重汇总页面对齐(筛选扩充 + 行编辑 + 导入/删除导入/导出)
- **所属模块**:13 / C asin
- **依赖**:253
- **功能点要求**:DedupeRegistryPage 对齐 admin panel-dedupe-total-data:页头分组摘要条;筛选按「ASIN/用户名/分组/国家 + 开始/结束日期」排列(现仅 keyword+country);列表行可编辑(ASIN+分组)与删除「确定删除总数据“X”吗?」;新增导入/删除导入(Excel+分组,进度轮询「处理中:已处理 a/b,新增 x,跳过 y」→ 完成文案;删除导入前置「确定按 Excel 中的 ASIN 批量删除…」);导出 XLSX(日期校验「开始日期不能晚于结束日期」+「导出中…/正在生成导出文件…已等待 N 秒」等待弹窗)。接线 dedupe-total-export/import/total-* 孤儿模块。
- **测试用例**:正常(3) 筛选参数字段映射、导入轮询到终态文案、导出等待与下载;边界(3) 日期逆序校验、进度 0/N 与 100%、删除导入空 excel;异常(2) 轮询超时提示刷新、导出接口失败可行动文案。
- **验证方法**:`node --test tests/task-254.test.ts`;`npm run build`。
## 任务 255:品牌数据库(不符合ASIN)页面对齐
- **所属模块**:13 / C
- **依赖**:254
- **功能点要求**:AsinInvalidPage 对齐 admin panel-invalid-asin-data:筛选含 ASIN/品牌/分组;来源列「手动新增/自动导入」tag;手动记录可改分组、自动记录编辑时分组区隐藏;普通账号分组锁定(只显示所属组);新增/编辑校验与删除「确定删除“X”吗?」;分页形态/空错态统一。名称沿用 Vue「不符合ASIN数据」,仅观感与交互对齐。
- **测试用例**:正常(3) 筛选三字段、来源 tag、编辑分组显隐规则;边界(3) 自动记录分组只读、普通账号锁定、空分组下拉;异常(2) 删除失败、保存校验文案。
- **验证方法**:`node --test tests/task-255.test.ts`;`npm run build`。
## 任务 256:商品类目页面对齐(懒加载树/搜索/导出/删除/新增编辑)
- **所属模块**:13 / C
- **依赖**:255
- **功能点要求**:ProductCategoryPage 对齐 admin panel-product-categories:懒加载树(默认根层,± 展开拉子层,每层「加载更多」+已加载 a/b);顶部搜索框(placeholder「搜索类目名称、编码或备注」,独立分页结果);导出按钮;行删除有子类时禁用+「确定删除“X”?」;新增根/子类目 + 编辑弹窗标题切「编辑商品类目」按钮变「保存类目」+「取消编辑」;校验/排序/说明字段。
- **测试用例**:正常(3) 根层加载、展开拉子、搜索态分页「加载更多」;边界(3) 空子层、有子类禁删、搜索无结果;异常(2) 加载失败可重试、保存失败不清树。导出接线 product-category-export.ts。
- **验证方法**:`node --test tests/task-256.test.ts`;`npm run build`。
## 任务 257:查询ASIN页面对齐(含行内配置抽屉与导入)
- **所属模块**:13 / C
- **依赖**:255
- **功能点要求**:QueryAsinPage 对齐 admin panel-query-asin:筛选(分组/店铺/国家/ASIN);列表(店铺/分组/5 国 ASIN 可点击复制);行内「配置」右侧抽屉(5 国×[ASIN],留空删除该站点语义提示);导入新增(支持两种 Excel 格式 label)/删除导入(确认「确定按 Excel 中的分组、店铺名和国家 ASIN 批量删除吗?」);导出;任务级联店铺选择与空态文案。接线 query-asin-detail/import/delete-import 孤儿模块。
- **测试用例**:正常(3) 配置抽屉 diff→PUT/DELETE 逐国、复制 ASIN toast、导入轮询;边界(3) 留空=删除、分组无店铺「该分组暂无店铺」、多国家部分失败逐国拼接错误;异常(2) 删除导入前置确认、超时刷新提示。
- **验证方法**:`node --test tests/task-257.test.ts`;`npm run build`。
## 任务 258:最低价ASIN页面对齐(价格范围筛选 + 配置抽屉 + 导入)
- **所属模块**:13 / C
- **依赖**:257
- **功能点要求**:SkipPricePage 对齐 admin panel-skip-price-asin:筛选含最低价范围(≥/-/≤ 两个 number, step.01);列表列含 5 国 ASIN+最低价 与更新时间;行内「配置」抽屉(ASIN+最低价 双列,留空删除,最低价校验「最低价格式不正确」「填写最低价时必须填写 ASIN」);导入新增/删除 + 导出。接线 skip-price-import/detail 孤儿模块。ASIN 自动大写。
- **测试用例**:正常(3) 价格范围参数映射、配置抽屉双字段、导入流程;边界(3) 低价>高价、仅填低价无 ASIN 报错、ASIN 大小写归一;异常(2) 删除导入确认、导出失败文案。
- **验证方法**:`node --test tests/task-258.test.ts`;`npm run build`。
## 任务 259:生成记录页面对齐(筛选 + 缩略图预览布局)
- **所属模块**:13 / D records
- **依赖**:258
- **功能点要求**:RecordsHistoryPage 对齐 admin panel-history:筛选「指定用户 select(全部用户)+开始/结束 datetime-local」;列表(ID/用户/记录类型中文/创建时间/结果预览≤3 缩略图 56px + 操作查看);预览与详情布局对齐;空态「暂无记录」;分页形态统一。接线 history-filter/preview 孤儿模块(或保留页面自写但观感对齐)。
- **测试用例**:正常(3) 筛选参数、类型中文映射、缩略图≤3 计数;边界(3) 无缩略图、>3 张截断、空结果;异常(2) 用户下拉加载失败、图片加载失败占位。
- **验证方法**:`node --test tests/task-259.test.ts`;`npm run build`。
## 任务 260:软件版本页面对齐
- **所属模块**:13 / D
- **依赖**:259
- **功能点要求**:RecordsSoftwareVersionPage 对齐 admin panel-version:上传弹窗校验「请填写版本号/请选择 zip 压缩包/仅支持 .zip 格式」,成功「发布成功。版本:v,链接:url」;列表列(版本号/下载链接/创建时间/操作=下载外链);空态;分页形态。admin 无删除,删除相关 UI 移除(若 Vue 有)保持一致。
- **测试用例**:正常(3) 上传校验通过→请求、列表渲染下载外链、成功文案含版本与链接;边界(3) 空版本号、非 zip、上传超时进度;异常(2) 发布失败文案、下载不可用提示。
- **验证方法**:`node --test tests/task-260.test.ts`;`npm run build`。
## 任务 261:数字人版本页面对齐(状态色/最新★/发布/设最新/删除)
- **所属模块**:13 / D
- **依赖**:260
- **功能点要求**:RecordsDigitalHumanVersionPage 对齐 admin panel-digital-human-version:列(版本号/状态[已发布|草稿]色:草稿#999 已发布#52c41a 已废弃#ff4d4f/最新★/文件大小/MD5 截 12/更新日志/发布时间/操作);操作仅按状态显隐:草稿→发布、已发布非最新→设为最新、已发布→下载、非最新→删除(危险二次确认);上传(版本/zip/最低客户端/changelog)进度与成功文案「上传成功!版本:v(状态:草稿,请在列表中点击“发布”按钮)」。
- **测试用例**:正常(3) 状态→操作按钮矩阵、最新★/MD5 截断展示、上传成功文案;边界(3) 已废弃不可发布/删除保护、无发布时间、0 字节包;异常(2) 发布/设最新失败可行动文案、删除确认取消。
- **验证方法**:`node --test tests/task-261.test.ts`;`npm run build`。
## 任务 262:店铺密钥页面对齐(白名单药丸/令牌留空语义/删除文案)
- **所属模块**:13 / E shop
- **依赖**:261
- **功能点要求**:ShopKeysPage 对齐 admin panel-shop-keys:列表列(序号/备注名/紫鸟账号名称/紫鸟令牌[掩码]/白名单状态药丸+悬停 title 检测信息/创建/修改/操作);新增/编辑(账号、令牌,校验「请完整填写紫鸟账号名称、紫鸟令牌」,编辑令牌留空=不修改 用占位与提示统一风格);删除「确定删除店铺密钥“X”吗?」;整页筛选栏缺失补齐(按 admin 无筛选保持无筛选,若做则对齐);分页形态统一。
- **测试用例**:正常(3) 列表列含白名单药丸、新增校验、令牌留空语义;边界(3) 空白名单「未加白名单」、令牌自动去 Bearer、悬停 title;异常(2) 删除确认取消、保存失败文案。
- **验证方法**:`node --test tests/task-262.test.ts`;`npm run build`。
## 任务 263:店铺管理页面对齐(掩码眼睛实时读凭证/凭证明文/校验)
- **所属模块**:13 / E
- **依赖**:262
- **功能点要求**:ShopManagePage 对齐 admin panel-shop-manage:筛选(分组/店铺名);列表列(序号/分组/店铺名/商城名/自动化账号/账号/密码[******+眼睛实时读]/创建/修改/操作);密码眼睛点击实时请求 /credential 显示真值「读取中…」;凭证明文弹窗(含复制按钮)+点击复制 toast;必填校验「请完整填写分组、店铺名、店铺商城名、账号、密码」,编辑密码语义与后端一致(占位文案修正,不再自相矛盾);删除「确定删除店铺“X”吗?」;分组下拉 30s 缓存。
- **测试用例**:正常(3) 掩码默认/眼睛实时读取、凭证明文复制、分组下拉加载;边界(3) 无凭证、密码显示中断「读取中…」、编辑密码占位语义;异常(2) 必填校验逐条、删除确认、凭证接口失败。
- **验证方法**:`node --test tests/task-263.test.ts`;`npm run build`。
## 任务 264:视频任务视图对齐(卡片网格 + 播放 + 单卡下载/复制链接)
- **所属模块**:13 / F tasks
- **依赖**:263
- **功能点要求**:ImageVideoTasksPage 由表格+抽屉改为对齐 admin panel-image-video-tasks 的「任务卡片网格」:form-box「筛选」+卡片网格(每任务卡:状态中文 tag、用户/执行ID/时间、video 标签可播放、缩略图、单卡「下载」=fetch blob→task-{id}-video-{n}.mp4 失败降级新窗口、复制链接(1.6s 已复制)、空态「视频生成中或暂无结果」「任务失败,未生成视频」、加载失败「视频加载失败,可尝试下载」);合计「共 N 个任务 · 本页 N 个视频」。复用 image-video-* 模块,接线 selection/download-feedback。
- **测试用例**:正常(3) 卡片渲染/状态中文、video 地址、单卡下载 blob 名;边界(3) 空态两分支、下载失败降级新窗、复制链接计时;异常(2) 网络失败文案、video 加载失败占位。
- **验证方法**:`node --test tests/task-264.test.ts`;`npm run build`。
## 任务 265:视频任务筛选/权限配置/批量下载 对齐
- **所属模块**:13 / F
- **依赖**:264
- **功能点要求**:筛选对齐(用户名模糊/提交开始/结束 datetime-local + 查询/重置);权限配置弹窗对齐(已分配/全部用户 tabs、搜索、行内分配/取消分配/待保存态、变更汇总行、保存「保存中…」);批量下载(勾选当前页 checkbox、POST zip 进度「正在打包 N 个视频...」→「压缩包下载已开始」/部分失败提示);分页 20/页。
- **测试用例**:正常(3) 筛选参数与重置、权限弹窗保存汇总、批量下载进度终态;边界(3) 0 选中禁用、部分失败提示、待保存变更态;异常(2) 权限接口失败、zip 打包失败可行动文案。
- **验证方法**:`node --test tests/task-265.test.ts`;`npm run build`。
## 任务 266:店铺数据任务视图对齐(每店卡片网格)
- **所属模块**:13 / F
- **依赖**:265
- **功能点要求**:ShopDataTasksPage 由 flatMap 表格改为对齐 admin panel-shop-data-crawl-tasks 的「每店铺一卡片」:卡片=店铺名/分组小 tag/任务号+状态(三态药丸)/站点国 chips/最新文件/文件行数/下载/删除;下载=服务端原文件名(回退 shop-data-task-{id}.xlsx);删除仅终态可点、进度条文本「正在删除任务 N...」、确认「确认删除店铺“X”的任务 N 及结果文件?」;空态;复用 shop-data-* 接线 selection/list-state。
- **测试用例**:正常(3) 卡片分组渲染(results 分组)、下载文件名回退、终态可删/非终态禁用;边界(3) 无结果文件、删除中进度、多文件店卡;异常(2) 下载失败、删除失败提示。
- **验证方法**:`node --test tests/task-266.test.ts`;`npm run build`。
## 任务 267:店铺数据任务筛选/批量下载/权限 对齐
- **所属模块**:13 / F
- **依赖**:266
- **功能点要求**:筛选对齐(店铺模糊/分组模糊/国家 select/创建时间 datetime 范围 + 查询/重置);批量下载 zip(X-Archive-Error-Count 提示包内错误清单);合计「共 N 家店铺」;权限配置弹窗同 265;分页 20/页与刷新。
- **测试用例**:正常(3) 筛选字段映射、批量下载 zip 头、合计文本「共 N 家店铺」;边界(3) 0 店铺、空筛选、部分失败;异常(2) 打包失败提示、权限接口失败。
- **验证方法**:`node --test tests/task-267.test.ts`;`npm run build`。
## 任务 268:15 页逐页对齐自查与修正
- **所属模块**:13 / G 收尾
- **依赖**:250-267
- **功能点要求**:按任务 249 建立的每页检查清单,对 15 页逐页过(对照 admin.html 观感与交互),修正残留不一致;验证 DuplicateCheckPage 不受影响;记录偏离项与原因到清单文档(如业务命名差异 invalid-asin、分页无页码等已知容忍项)。
- **测试用例**:readSource/集成断言:抽查每页无 scoped 残留重复样式、无死按钮、无 ElMessageBox.confirm 直连(已走统一组件)、关键文案存在于页面。
- **验证方法**:`npm test`;`npm run build`。
## 任务 269:e2e 换皮/对齐冒烟
- **所属模块**:13 / G
- **依赖**:268
- **功能点要求**:补 e2e/13-*.spec.ts:壳层浅色 token(侧栏底色、主色变量)、壳层跳转、代表页(用户/店铺管理/商品类目)渲染与筛选/删除确认可用、无 pageerror、viewport 响应式。用 mock server 提供最小 API。
- **测试用例**:真实浏览器 ≥4 场景(壳层、用户列表+确认、类目树、响应式),断言 DOM/样式/CSS 变量,禁纯截图无断言。
- **验证方法**:`npm run test:browser`(自动起 mock+dev 5174)。
## 任务 270:本地 Java+Vue 全链路真实 smoke
- **所属模块**:13 / G
- **依赖**:269
- **功能点要求**:起本地 Java(18080)与 dev(VITE_API_TARGET=18080),以 live 账号真跑 15 页核心交互(登录、进页、查询、打开弹窗/抽屉、删除确认打开与取消、导入/导出入口可达性),补 tests/live/task-270-live.test.ts(AIIMAGE_LIVE_* 门控,同既有 live 约定);记录每页真实验收勾选。
- **测试用例**:真实接口 + 浏览器;无 env 时 skip 并说明。
- **验证方法**:`npm run test:live`。
## 任务 271:全量门禁与收尾提交
- **所属模块**:13 / G
- **依赖**:270
- **功能点要求**:`npm run build`(vue-tsc 类型门禁)、`npm test` 全量、检查无 stub/echo/死按钮/硬编码;对涉及 Java 旧后台文档/部署说明(deploy/release-structure、nginx conf 注释等)如有需要同步「蓝白浅色换皮」说明;RELEASE_SMOKE=1 时跑 240 收尾验收。
- **测试用例**:类型检查 + 全量 test + 构建产物校验(deploy/verify-dist.mjs)。
- **验证方法**:`npm run build && npm test`;`node deploy/verify-dist.mjs`。
## 任务 272:module 收尾(progress 闭合 + 一致性校验)
- **所属模块**:13 / G
- **依赖**:271
- **功能点要求**:校验 overview 总任务数=272 且含 module 13 行、plan 13 任务 241-272 与 progress.json 一一对应、全部 done;`check_progress.py` 返回 0;更新 docs/plans/…/13/13-panel-checklist.md 的最终验收列;module 收尾 commit。
- **测试用例**:check_progress 一致性 + 无遗留 RED 测试。
- **验证方法**:`python check_progress.py`(应退出 0)。
---
## 模块完成条件
1. 任务 241-272 串行全部 done 且有对应 commit;DuplicateCheckPage 页面文件无改动(git 校验例外页不变)。
2. 15 个页面按 249 清单逐项对齐,缺失交互补齐,壳层为蓝白浅色;admin.html/admin.js 未被改动。
3. `npm test`、`npm run build`、`npm run test:browser` 通过,live smoke 有记录;check_progress 返回 all tasks done。