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

158 lines
18 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.
# 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 更新。