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

53 lines
10 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-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 执行时回填)
- [x] 已新增 `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 摘除)。