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

18 KiB
Raw Blame History

round2 对照矩阵:新版 15 页对齐旧版(除店铺撞款监控)

用途:task-284 之后的新一轮逐子菜单对齐执行清单。列 = 旧版基准(reference/old-admin/admin.html+admin.js 恢复物)↔ 新版现状 ↔ 差异动作 ↔ 断言。 范围:15 页。例外页 shop-center/duplicate-check(DuplicateCheckPage)不改。 公共项(所有页适用,批次 5 统一处理,逐页批次只负责把"页面特有"差异做掉):

  • A. 操作提示条(旧版 guides 表 14 项+fallback 原文在 admin.js)→ 布局单点实现 + 各页文案表。
  • B. 行内操作按钮形态:旧版 .btn-sm 实心小按钮 → 逐页把 link/text 判定为实心/保持。
  • C. 空态/确认/成功文案核对(旧版原文见下方基准摘录)。 状态列:待办 / 进行中 / 已改 / 目检。

1 UsersPage account/users admin_users

旧版要点:h3"用户列表";右上"新建用户";筛选 用户名+所属管理员(仅超管)+查询;列 ID/用户名/角色/所属管理员/创建时间/操作;行 编辑/删除;删除确认"确定删除用户 “xxx” 吗?";空态"暂无用户";guides 文案"先用筛选定位账号…步骤 筛选账号/编辑权限/确认保存"。 新版现状:h2"用户管理"+desc;卡内 table-toolbar"新建用户";筛选同;6 列 min-width;行内 link 编辑/删除(禁删原因提示);分页 sizes;CreateUserDialog/EditUserDialog+UserMenuAuthTree;无 guides。 差异动作:

  • 行内 编辑/删除 形态对照旧版(公共项 B)。
  • 删除确认句核对旧版"确定删除用户 “xxx” 吗?"。
  • 空态"暂无用户"核对。
  • guides 接线(公共项 A,文本见上)。 断言:align-user-* 源码测试更新。

2 MenusPage account/menus admin_columns

旧版要点:h3"菜单列表";右上"新增菜单";提示"拖动每行左侧的手柄…松开后自动保存";列 拖动手柄/ID/菜单名称/菜单类型/上级菜单/创建时间/操作;行 编辑/删除;确认"确定删除菜单“xx”吗?";空态"暂无菜单,请先在上方新增";页面下拉 COLUMN_PAGE_CATALOG 44 项;guides"菜单会影响后台和软件端的可见范围…步骤 新增或调整菜单/设置层级/拖动排序"。 新版现状:h2"菜单管理";已有拖拽手柄提示;树形表格(类型 tag app=info/后台=primary);新增/编辑 dialog 名称/类型/父/排序;客户端分页 10;行内 link。 差异动作:

  • 行内按钮形态(B)。
  • 删除确认/空态文案核对。
  • "类型"文案 后台/软件 vs 新版 tag"后台/app"(旧版菜单类型=后台/软件,核对是否与数据同义)。
  • guides 接线(A)。 断言:align-menu-* 更新。

3 GroupsPage account/groups admin_group_manage

旧版要点:顶部摘要 chips(超管"全部分组·N 个";成员"分组名 · 组长/组员",最多 4+另 N 个;无分组"未加入分组");h3"分组列表"+"新建分组";列 序号/分组名称/组长/组员数量/组员chips/创建/修改/操作;操作 仅组长或超管 编辑/删除;确认"确定删除分组“x”吗?";空态"暂无分组"。 新版现状:h2+desc;统计卡(分组总数/组员总数);分组名称/组长/组员数/组员tag墙/创建/修改/操作;行内 link;仅组长/超管可改;客户端分页;GroupEditorDialog。 差异动作:

  • 摘要区形态:新版"统计卡(总数/总人数)" vs 旧版"分组 chips 摘要"——执行期目检裁决是否改 chips 形态。
  • 行内按钮(B);确认/空态文案核对。
  • 序号列(旧版有,新版无?核对)。
  • guides fallback 接线(A:通用 fallback 文案)。 断言:align-group-editor 更新。

4 DedupeRegistryPage asin-center/registry admin_dedupe_total_data

旧版要点:摘要同分组 chips;h3"ASIN列表";右上 新增导入/删除导入;筛选 2 行(ASIN/用户名/分组/国家 DE..ES + 查询;开始/结束日期 + 导出 XLSX);列 ID/ASIN/国家中文/用户名/分组/创建/操作;导出全屏遮罩"已等待 N 秒";导入轮询 1s 进度"已处理 a/b,新增 x,跳过 y";删除总数据确认"确定删除总数据“xx”吗?";guides 文案见 admin.js。 新版现状:分组汇总卡(近似 chips);筛选 6 项;新增导入/删除导入/导出 table-toolbar;导出全屏遮罩+秒表;导入 dialog 进度 alert 轮询 300×1s 超时;编辑/删除 link;分组选项源 /shop-manage-groups。 差异动作:

  • 删除确认文案"删除总数据“x”"与导入轮询文案与旧版逐字核对。
  • 行内按钮形态(B)。
  • guides 接线(A)。 断言:align-dedupe-summary 更新。

5 AsinInvalidPage asin-center/invalid admin_invalid_asin_data

旧版要点:h3"品牌数据列表";右上"新增";筛选 ASIN/品牌/分组;来源列 手动新增(MANUAL)/自动导入(AUTO);分组锁定(非超管强制其组,AUTO 编辑隐藏分组);确认"确定删除“xx”吗?";空态"暂无数据"。 新版现状:h2"不符合ASIN数据"(业务命名保留);来源 tag MANUAL 无 type / AUTO info;新增/编辑 520;AUTO 行编辑 includeGroup=false;分组 disabled 锁定非超管。 差异动作:

  • 删除确认/空态文案核对("确定删除“xx”吗?")。
  • 行内按钮(B)。
  • guides 接线(A)。 断言:align-invalid-asin-lock 更新。

6 QueryAsinPage asin-center/query admin_query_asin

旧版要点:h3"店铺列表";右上 新增 ASIN/导入添加/导入删除;筛选 分组/店铺名/国家/ASIN + 查询 + 导出 XLSX(裸下载);列 序号/分组/店铺名/ASIN(可复制)/国家/操作(配置 每店 rowspan 合并);新增 ASIN 级联 分组→店铺;导入两种 Excel 格式+轮询 1s;删除导入确认"确定按 Excel 中的分组、店铺名和国家 ASIN 批量删除吗?";空态"暂无数据";guides"查询 ASIN 以店铺为单位维护…点右侧「配置」可一次维护该店铺所有站点"。 新版现状:新增/导入添加/导入删除/导出 toolbar;筛选同;rowspan 矩阵+CopyText;行内配置 link;新增 560 级联;导入 dialog 分组可选兜底;导出裸 a 跳转(与旧版一致)。 差异动作:

  • 确认"新增 ASIN/导入添加/导入删除"三按钮文案与校验语义(含导入删除确认句)核对。
  • 序号列/国家列顺序核对。
  • 空态"暂无数据"核对。
  • guides 接线(A)。 断言:align-query-asin 更新。

7 ProductCategoryPage asin-center/categories admin_product_categories ★重点

旧版要点:搜索条(占位"搜索类目名称、编码或备注")+ 搜索/清空/导出(btn-sm)/新增类目;树列 名称 24px/级缩进+[+/-]折叠+加粗;层级路径/排序/来源 tag(内置/自定义)/备注/操作;懒加载逐级 /children 分页 +"加载更多 已加载 a/b";行 编辑/删除(有子禁用 title 提示);编辑态 h3"编辑商品类目"+按钮"保存类目"+出现"取消编辑";校验"请填写类目名称";删除确认"确定删除“xx”?";导出 product-categories.xlsx;guides"类目树支持展开查看层级…步骤 搜索类目/展开层级/新增或编辑"。 新版现状:双视图(树视图 toolbar 新增/新增子类目/导出 + 已选提示;搜索视图分页);手写树形表格缩进+[+/−]+加粗+内置来源 tag;懒加载合成"加载更多 已加载 x/y";列 名称320/层级路径/排序/来源/说明/操作 link;弹窗 新增/编辑 560(父级/名称/排序/说明);折叠钮色 indigo #6366f1/#eef0fe 残留;后端整树加载未逐级分页;编辑时父级只读未做。 差异动作:

  • 树折叠钮 indigo → 蓝白基线(grep 6366f1/eef0fe)。
  • 编辑弹窗"父级只读"(已存在父级时)核对后端能力后补。
  • 树逐级懒加载 /product-categories/children 分页:核对后端是否已支持(不支持另开 Java 小任务)。
  • 编辑态标题/按钮文案("编辑商品类目/保存类目/取消编辑")核对。
  • 删除禁用(有子)title 提示核对。
  • guides 接线(A)。 断言:align-product-category / align-category-tree 更新。

8 SkipPricePage asin-center/skip-price admin_skip_price_asin

旧版要点:h3"店铺列表";右上 新增 ASIN/导入文件新增/导入文件删除;筛选 分组/店铺名/国家/ASIN/最低价范围(≥ ≤ 两 number)+查询+导出;列 多一列"最低价";新增 ASIN 级联+最低价选填;导入删除确认"确定按 Excel 中的删除ASIN批量删除该店铺跳过跟价 ASIN 吗?";轮询 1.5s;空态"暂无数据"。 新版现状:同 Query 骨架+最低价区间同行双输入+最低价列右对齐;新增 560;导入 dialog 分组必选;配置 drawer 每国 ASIN+最低价 双列;复制/空态。 差异动作:

  • 三按钮文案(新增 ASIN/导入文件新增/导入文件删除)与导入删除确认句核对。
  • 行内按钮(B)。
  • guides 接线(A)。 断言:align-skip-price 更新。

9 ShopKeysPage shop-center/keys admin_shop_keys

旧版要点:h3"店铺密钥列表";新增店铺密钥;无筛选;列 序号/备注名/紫鸟账号名称/紫鸟令牌(掩码)/白名单状态(title 检测详情)/创建/修改/操作;白名单 正常(绿)/未加白名单(红)/未检测(灰);确认"确定删除店铺密钥“xx”吗?";空态"暂无店铺密钥";guides"紫鸟令牌属于敏感配置…步骤 新增或筛选密钥/查看白名单状态/编辑或删除"。 新版现状:备注名/紫鸟账号名称/令牌掩码+tooltip/白名单状态 tag+tooltip/创建/修改/操作(text 小按钮 编辑/删除);新增/编辑 560(编辑留空令牌=沿用);无筛选。 差异动作:

  • 行内按钮 text→对照 .btn-sm(B)。
  • 序号列核对。
  • 白名单状态文案"正常/未加白名单/未检测"与 title 检测时间核对。
  • guides 接线(A)。 断言:align-shop-columns 更新。

10 ShopManagePage shop-center/shops admin_shop_manage

旧版要点:新增店铺;筛选 分组/店铺名;列 序号/分组/店铺名/商城名/自动化账号/账号/密码(******+眼睛→读取中...→明文+隐藏密码)/创建/修改/操作;长文本省略 title;分组锁定;确认"确定删除店铺“xx”吗?";空态"暂无店铺";guides"店铺信息按分组管理…步骤 选择分组/维护店铺信息/筛选核对结果"。 新版现状:筛选(自绘 label 上置 div);9 列 min-width;密码眼睛实时拉明文(读一次缓存只显一行);新增/编辑 600(编辑密码必填重填);明文凭据 dialog+复制;操作 text 编辑/凭证/删除。 差异动作:

  • 行内按钮 text→.btn-sm(B)。
  • 密码眼睛交互文案核对(读取中.../隐藏密码)。
  • 序号列核对。
  • guides 接线(A)。 断言:align-shop-columns 更新。

11 ShopDataTasksPage shop-center/data-tasks admin_shop_data_crawl_tasks ★重点

旧版要点:h3"店铺数据记录"+内 h4"筛选条件"(店铺/分组/国家/创建起止+查询/重置);toolbar 权限配置(仅超管)/批量下载(N)/全选当前页+进度+汇总"共 N 家店铺";每店铺卡片网格(卡头店铺名+勾选行"任务 {taskNo}"+状态徽章+信息行 分组/最新/国家/文件);操作 下载文件(仅 file_ready)/删除(终态才可删);删除确认"确认删除店铺“x”的任务 {id} 及结果文件?";批量 zip 进度"正在打包 N 个文件...";分页 20/页(无二级卡分页);guides"店铺数据任务按状态和时间筛选…步骤 筛选任务/检查状态/执行批量操作"。 新版现状:h2 已改名"店铺数据记录"(无"任务");筛选卡 店铺/分组/国家 5 国/创建 datetimerange;list-toolbar 全选(半选 indeterminate)/批量下载/权限配置+汇总"共 N 家店铺·本页 M 个结果文件";3 列宫格卡 9/页(task-273 用户亲定保留);卡脚 下载/删除 实心小按钮;底部两级分页叠放(店铺 20/页 + 卡片 9/页)观感 bug;无 el-card 外套;权限 dialog"列表勾选+已授权计数";删除结果文件=旧版无(新版独有,保留)。 差异动作:

  • 两级分页叠放整合:保 9 卡宫格,店铺级分页与卡片分页不叠放(单级 9/页 或卡区内独立不邻叠)→ 本地目检定案。
  • 无 el-card:补卡壳(旧版上下双卡 form-box+panel-box)。
  • 权限弹窗形态核对(旧版 tabs 已分配/全部+搜索+全选 vs 新版勾选)→ 交互等价则保留,汇总行文案"当前显示已分配用户,共 N 人"补。
  • 文件头注释残留"任务/记录"清理。
  • guides 接线(A)。 断言:align-shop-data-cards/grid 更新。

12 RecordsHistoryPage records/history admin_history

旧版要点:h3"筛选条件"(指定用户(全部)/开始/结束 datetime-local+查询);h3"生成记录";列 ID/用户/类型中文映射/创建时间/结果预览(≤3 缩略图 长图优先);空态"暂无记录";无删除交互;分页 15 无数字页码;guides"生成记录可按用户和时间范围回溯…步骤 设置时间范围/筛选记录/查看结果预览"。 新版现状:筛选卡 用户下拉(远程)+开始/结束 datetime;table-toolbar"清理数据"(task-278 用户亲定保留);列 ID/用户/类型中文/创建时间/结果预览(≤3 张 56px 缩略图+el-image 大图);空态按有无筛选区分;分页 pageSize 15 无 sizes;操作 text 查看大图。 差异动作:

  • "清理数据"按钮形态/位置核对(保留,确认 danger plain 二次确认)。
  • 行内按钮 text→.btn-sm(B)。
  • guides 接线(A)。 断言:align-history-copy/clear 更新。

13 RecordsSoftwareVersionPage records/software-version admin_version

旧版要点:h3"版本列表";上传新版本;列 版本号/下载链接/创建时间/操作(下载);全量无分页;上传弹窗"上传软件 ZIP 包,系统会自动计算 MD5 并存储到 OSS",提交"上传软件版本",成功"发布成功。版本:{v},链接:{url}";校验 版本号必填/.zip;空态"暂无版本记录";guides"上传版本后请核对版本号和下载链接,再通知用户更新…步骤 上传压缩包/检查版本记录/维护历史版本"。 新版现状:table-toolbar 上传新版本;客户端分页 10(仅 prev/pager/next/jumper);上传 dialog 成功留驻弹窗含链接;空态"暂无版本记录";仅 .zip。 差异动作:

  • 分页:旧版全量无分页 vs 新版客户端分页——执行期目检裁决(spec13 容忍"Vue 保留跳页",倾向保留分页,仅核观感)。
  • 成功文案"发布成功。版本:v,链接:url"核对。
  • guides 接线(A)。 断言:align-software-version 更新。

14 RecordsDigitalHumanVersionPage records/digital-human-version digital_human_version

旧版要点:h3"版本列表";上传新版本;列 版本号/状态(草稿#999/已发布#52c41a/已废弃#ff4d4f)/最新(★红)/文件大小(MB)/MD5(截12)/更新日志(截50)/发布时间/操作(240);操作矩阵 草稿→发布/已发布且非最新→设为最新/已发布→下载/非最新→删除(danger);确认文案(发布"确认发布版本 {v} 吗?"/设最新"确认将版本 {v} 设为最新吗?客户端会自动检测更新。"/删除"确认删除版本 {v} 吗?该操作会删除对应文件,无法恢复。");数字页码分页;上传说明(草稿→手动发布)+按钮"上传(草稿状态)";成功"上传成功!版本:{v}(状态:草稿…)"。 新版现状:table-toolbar 上传(草稿状态);9 列 min-width(状态 tag/最新★/文件大小/MD5 截12/更新说明省略+title/发布时间/操作列 240 text 彩色小按钮 发布/设最新/下载/删除 按状态矩阵显隐 行级 loading);客户端分页 20;上传 dialog 进度 alert;行级 ElMessageBox。 差异动作:

  • 操作列按钮形态(彩色 text → 对照 .btn 体系语义/危险色)目检。
  • 状态色/确认句逐字核对(上方原文)。
  • 分页形态核对(数字页码 vs 新版 background 分页,容忍一致化即可)。
  • guides 接线(A)。 断言:align-digital-human 更新。

15 ImageVideoTasksPage records/image-video-tasks admin_image_video_tasks

旧版要点:h3"视频任务记录筛选"(用户名/提交开始/提交结束 datetime-local+查询/重置);toolbar 权限配置(仅超管)/批量下载(N)/全选当前页+进度+汇总"共 N 个任务 · 本页 N 个视频";任务卡片网格(勾选+video controls+状态徽章+用户名/分组/模式/生成时间/调试链接复制+下载);无视频不可用提示;video 加载失败替换"视频加载失败,可尝试下载";状态 label 映射(PENDING 待执行…前缀兜底);批量进度"正在打包 N 个视频..."→"压缩包下载已开始"或失败清单;复制链接"已复制"1.6s;guides"可先使用筛选缩小任务范围…步骤 设置筛选/查看任务结果/按需处理任务"。 新版现状:筛选卡 用户名+datetimerange(+额外 userId/status/执行ID 字段——增强保留);list-toolbar 全选/批量下载(N)/权限配置+汇总;自绘 section.task-card(视频+下载/复制/明细);el-drawer 720 明细;权限授权 dialog 620;底部 table-footer 分页;无 el-card。 差异动作:

  • 无 el-card 外套:补卡壳。
  • 筛选额外字段保留,布局与旧版(用户名+时间)核对主次。
  • 批量下载进度文案/状态映射核对。
  • guides 接线(A)。 断言:align-image-video 更新。