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

10 KiB
Raw Blame History

13-Panel Checklist:15 页面观感/交互对齐验收清单(模板)

用途:module-13 250-267 每页对齐的验收清单 + 268 逐页自查用。 源基准:backend/web_source/admin.html 现行蓝白浅色皮肤 + backend/static/admin.js / admin-interactions.js(冻结参照)。 例外页:shop-center/duplicate-check(店铺撞款监控 / DuplicateCheckPage)不在本清单,本模块不改。 状态列取值:待办 / 进行中 / 对齐 / 已补齐 / 待人工目检。

运行结论(task-249 真实验收占位)

  • e2e 壳层 smoke(npm run test:browser):按下方「验证记录」填写。
  • 浏览器人工目检(壳层换皮为蓝白浅色):待人工目检 —— dev http://127.0.0.1:5174/admin-vue/(mock:18100 或 Java:18080)。
  • 每页最终勾选结果:任务 268 回填。

面板 × 页面 × 待办任务对照与检查项

# admin.html panel Vue 路由 / menuKey 对齐任务 面板头文案 页头描述 筛选字段 主要列 操作列 确认文案 成功提示 空/错/loading 分页形态 缺失交互补齐
1 panel-users 用户管理 /account/users admin_users 250-251 用户列表 无开放注册入口说明 用户名(模糊)、所属管理员(仅超管) ID/用户名/角色(中文)/所属管理员/创建时间 删除 删除“X”二次确认(245) 创建成功/删除成功 空/错误+重试 共N条+上/下+跳页 新建/编辑/角色+菜单授权弹窗(接线孤儿模块)
2 panel-columns 菜单权限配置 /account/menus admin_columns 252 菜单列表 拖动同级排序提示 无 拖动列/ID/菜单名称/菜单类型/上级/创建时间 新增/编辑/删除/上移下移(或拖动) 删除菜单“X”(245) 排序保存失败回滚 空/错 树全展开无分页 route 白名单下拉42项、删除后刷新权限树/侧栏
3 panel-group-manage 分组管理 /account/groups admin_group_manage 253 分组列表 摘要「数据权限分组」 无(只读筛选不必要) 序号/分组名称/组长/组员数/组员chips/创建/修改 新建/编辑/删除(仅组长/超管) 删除分组“X”(245) 保存成功 空/错 无 分组编辑器+通讯录选人面板(接线)
4 panel-dedupe-total-data 去重数据汇总 /asin-center/registry admin_dedupe_total_data 254 ASIN列表 分组摘要条 ASIN/用户名/分组/国家/开始/结束日期 ID/ASIN/国家(中文)/用户名/分组/创建时间 编辑/删除 + 页头导入/删除导入/导出 删除总数据“X”(245)、删除导入确认 导入完成…/导出下载 导出等待弹窗 共N条+跳页 新增导入/删除导入(轮询)/导出XLSX(接线孤儿)
5 panel-invalid-asin-data 品牌数据库 /asin-center/invalid admin_invalid_asin_data 255 品牌数据列表 — ASIN/品牌/分组 ID/ASIN/品牌/分组/来源(手动/自动)/创建时间 新增/编辑/删除 删除“X”(245) 保存成功 空/错 共N条+跳页 分组锁定/自动记录分组区隐藏等规则
6 panel-query-asin 查询ASIN /asin-center/query admin_query_asin 257 店铺列表 — 分组/店铺/国家/ASIN 店铺/分组/5国ASIN(可复制) 配置(抽屉) + 导入/删除导入/导出 删除导入确认 已复制X 该分组暂无店铺 共N条+跳页 行内配置抽屉 per-country、导入(接线孤儿)
7 panel-product-categories 商品类目 /asin-center/categories admin_product_categories 256 商品类目 顶部搜索框 名称/编码/备注搜索 类目(树展开)/层级路径/排序/来源/备注 新增/编辑/删除(有子禁用)/导出 删除“X”(245) 保存成功 加载更多/已加载a/b 树懒加载 懒加载树/搜索态/导出(接线孤儿)
8 panel-skip-price-asin 最低价ASIN设置 /asin-center/skip-price admin_skip_price_asin 258 店铺列表 — 分组/店铺/国家/ASIN/最低价≥≤ 店铺/分组/5国(ASIN+最低价) 配置(抽屉) + 导入/删除导入/导出 删除导入确认 最低价校验文案 空/错 共N条+跳页 价格范围筛选/配置抽屉/导入(接线孤儿)
9 panel-shop-keys 店铺密钥管理 /shop-center/keys admin_shop_keys 262 店铺密钥列表 — 无 序号/备注/紫鸟账号/令牌(掩码)/白名单药丸/创建/修改 新增/编辑/删除 删除密钥“X”(245) 保存成功 空/错 共N条+跳页 令牌留空=不修改语义、白名单title帮助
10 panel-shop-manage 店铺管理 /shop-center/shops admin_shop_manage 263 店铺列表 — 分组/店铺名 序号/分组/店铺名/商城名/自动化账号/账号/密码(掩码+眼睛)/创建/修改 新增/编辑/删除/凭证明文 删除店铺“X”(245) 保存成功 空/错 共N条+跳页 密码眼睛实时读凭证/凭证明文复制/必填校验修正
11 panel-shop-data-crawl-tasks 店铺数据记录 /shop-center/data-tasks admin_shop_data_crawl_tasks 266-267 店铺数据记录 筛选条件(form) 店铺/分组/国家/创建时间 每店铺卡片(店名/任务号/状态/分组/国家/文件/行数) 下载/删除/批量下载 删除任务“X”(245) 下载已开始 空态 卡片网格分页 卡片网格化/批量下载/合计“共N家店铺”/权限弹窗
12 panel-history 生成记录 /records/history admin_history 259 生成记录 筛选条件(form) 指定用户/开始/结束 datetime ID/用户/类型中文/创建时间/结果预览(≤3缩略图) 查看预览 — — 暂无记录 共N条+跳页 筛选select+datetime、缩略图预览布局
13 panel-version 软件版本管理 /records/software-version admin_version 260 版本列表 — 无 版本号/下载链接/创建时间 上传(弹窗)/下载 无删除 发布成功… 空 共N条+跳页 上传校验zip/发布文案
14 panel-digital-human-version 数字人版本管理 /records/digital-human-version digital_human_version 261 版本列表 — 无 版本/状态/最新★/大小/MD5(截12)/更新日志/发布时间 发布/设最新/下载/删除 删除“X”(245) 上传成功…(草稿提示) 空 数字页码 状态色/操作矩阵/上传进度
15 panel-image-video-tasks 视频任务记录 /records/image-video-tasks admin_image_video_tasks 264-265 视频任务记录筛选 筛选条件(form) 用户名/提交开始/结束 datetime 卡片网格(视频/任务状态) 单卡下载/复制链接/批量下载/权限配置 删除确认(admin无) 已复制(1.6s) 视频生成中/失败 卡片网格分页 卡片网格+video播放/批量下载/权限弹窗/合计

验证记录(任务 249 执行时回填)

  • 已新增 e2e/13-shell.spec.ts(蓝白浅色 CSS 变量/角色胶囊/次级退出/代表页无 pageerror 断言)。
  • npm run test:browser —— 本次尝试被环境阻塞:5174 上残留指向 Java(18080) 的旧 dev server,被 playwright 以 reuseExistingServer 复用后 401 重定向 /login(既有 task-20 spec 同样受影响,非本模块回归)。干净环境(起 mock:18100 + dev VITE_API_TARGET=18100)下应通过。
  • 人工目检:侧栏浅色/主色蓝灰/表格筛选分页按钮观感/空错loading
  • admin.html vs dev 截图并排自查

254-258 执行备注(module 13 收口复查用)

  • 254 去重汇总:筛选含用户名/分组/日期、行编辑+删除、新增/删除导入(轮询)、导出(日期校验+anchor 下载)已接。分组选项源用 /api/admin/shop-manage-groups。页头原样 admin 的「新增导入/删除导入」+「导出」。
  • 255 品牌数据库(不符合ASIN):分组筛选、来源列 recordSourceLabel + el-tag、自动导入记录编辑隐藏分组(update includeGroup=false)、删除文案用模型 invalidAsinDeleteText。业务命名保留「不符合ASIN」。
  • 256 商品类目:树 + 关键字搜索独立分页(加载更多) + 行/工具栏删除(有子类目禁用, 确定删除“X”?)、导出(buildProductCategoryExportUrl)。已知偏差:未做 admin 的懒加载逐级拉取(/product-categories/children 分页),仍整树加载(后端已返回嵌套树);未做编辑时父级只读。可在 268 复查或按后端支持补。
  • 257 查询ASIN:行内「配置」抽屉(逐国 ASIN 大写、留空=删除该站点 DELETE)、导入添加/删除导入(前置确认+轮询)、导出(/query-asins/export)。未做「新增单条(分组→店铺级联)」创建弹窗。
  • 258 最低价ASIN:价格区间筛选(toSkipPriceParams 生效)、行内配置抽屉(ASIN+最低价、低价格式/低价必带ASIN 校验、留空删除)、导入添加/删除导入(group_id 必选)、导出(/skip-price-asins/export)。未做「新增单条」创建弹窗。
  • 通用:删除/提示均走统一确认与反馈;ASIN 自动大写;宽表 ASIN 改为可读等宽字体(去掉无点击 el-link 的误导观感)。

task 264-267 实现备注(fork 记录)

  • 视频任务(264/265):视图改为任务卡片网格 + 原生 video(displayUrl) 播放;单卡下载走 /image-video-tasks/download-zip 单键 zip(后端无逐视频直链端点,文件名 task-{id}-video-{n}.zip,失败降级新窗口打开 displayUrl);复制链接用 clipboard;空态按状态区分文案;合计「共 N 个任务 · 本页 M 个视频」。
  • 店铺数据任务(266/267):视图改为每店铺卡片;单文件下载接 GET /api/admin/shop-data-crawl/results/{resultId}/download(Content-Disposition 文件名,回退 shop-data-task-{id}.xlsx);删除接 DELETE /api/admin/shop-data-crawl/history/{resultId}(仅终态可删,确认含店铺/任务号,删除中提示);批量走 /shop-data-crawl-tasks/download-zip(X-Archive-Error-Count 提示包内错误清单);合计「共 N 家店铺 · 本页 M 个结果文件」。
  • 待 268 复查:视频任务筛选仍保留 userId/status/执行ID 等既有字段(admin 仅有 用户名+提交时间);权限配置弹窗为「列表勾选+已授权计数」而非 admin 的 tabs/搜索形态;删除结果文件在旧 admin 属旧交互,按 Java 端点接(若非产品所需可在 268 摘除)。