49c3fc1491
`.gitignore` 原先把 docs/plans/ 与 backend-java/docs/plans/ 记成「本地不入库」, 代价有两头:干净 worktree 出包时这些文件根本不存在(门禁要读它们的用例先假红), 跨会话的实施计划也没有留存通道。改为入库,本批把 34 个 md 落进仓库。
10 KiB
10 KiB
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 摘除)。