Files
docs/Admin通用资料样式核对记录.md
T
2026-10-21 07:37:26 +08:00

12 KiB
Raw Blame History

Admin 通用资料样式核对记录

范围为 adminNavigation.ts 的通用组 10 个可见菜单,沿正式路由定位到 14 个页面。10 个菜单的 14 个页面已完成代码样式核对;全部修改后页面尚待人工截图确认。隐藏产品信息、税率和旧库位页面不恢复。

原型目录为 docs/悦/货代SAAS平台后台/prototype-src/。列表操作依据当前用户确认:不超过 3 个全部显示,超过 3 个才折叠,折叠入口只显示省略号。新增、编辑、详情、文件和确认逐项检查,不能从某一弹框推断其他操作。

菜单 正式页面入口(apps/admin-web/src/modules/ 下) 原型入口 已定位操作 / 下一步
供应商列表 suppliers/pages/SuppliersView.vue、SupplierDetailView.vue、SupplierFormView.vue 05-suppliers.html:列表 34 行、编辑 108 行 独立新增/编辑/详情;实际引用 components/SupplierLicenseDialog.vue 560px;核对返回、资质信息与操作权限
快递公司 master-data/express-companies/pages/ExpressCompaniesView.vue 05-suppliers.html:2 行 批量导入、580px 编辑抽屉;原型静态列表仅列出新增/导入/导出,具体表单原型未定义,保留当前承载
往来单位 master-data/counterparties/pages/PartnersView.vue 05-suppliers.html:8 行 680px 编辑/详情抽屉、批量导入;详情、编辑、启停均已显式接入,保留真实权限
费用项目 fee-items/pages/FeeItemsView.vue 10-general.html:8 行 620px 编辑抽屉;启停与删除分别使用确认框;核对表单分组和危险操作
汇率管理 overseas-master-data/pages/ExchangeRatesView.vue 10-general.html:21 行 560px 月度汇率新增/编辑框,保留月份和汇率校验
仓库管理 warehouses/pages/WarehousesView.vue 10-general.html:44、51、58、65 行 多类仓库列表;650px 新增/编辑框、760px 导入框,无独立详情入口;保留仓库类型、版本、导入文件和状态操作
海外仓报价 overseas-master-data/pages/OverseasQuotesView.vue 10-general.html:167 行 980px 详情、1180px 新增/编辑框;保留报价与计费字段
船期价格表 fba-pricing/carrier-rates/pages/CarrierRatesView.vue、CarrierRateDetailView.vue 10-general.html:273 行;当前价格簿接口与应用指引优先 560px 上传框、独立版本详情、仓库映射/确认;价格行只读,不恢复旧原型手工计价能力
车辆列表 overseas-master-data/pages/VehiclesView.vue、VehicleDetailView.vue 10-general.html:314、442 行 760px 新增/编辑、480px 状态变更、独立详情;核对关联派送及更换记录
下载中心 downloads/pages/DownloadCenterView.vue 10-general.html:228 行 720px 任务详情框、下载与重试;保留任务状态/退避/文件权限

共享批量导入组件与供应商资质组件须沿实际调用逐项检查是否能显式接入密度样式。不能仅在父页面增加类名就声称 Teleport 弹框已覆盖。

本轮先实施供应商、汇率、海外仓报价、车辆四个菜单(7 个页面及供应商资质组件)。供应商新增/编辑/详情继续独立路由;资质 560px、汇率 560px、报价详情 980px/编辑 1180px、车辆编辑 760px/状态 480px 保留承载和宽度,车辆详情继续独立页面。海外资料操作证据补充见应用内 overseas-master-data/PROTOTYPE_MATRIX.md:modal-gen-overseas-quote-detail、modal-gen-overseas-quote、modal-exchange-rate-edit、modal-vehicle-edit。供应商资质来自 overlays.html:660,保留其证照版式。供应商分类数量合并到同一组彩色页签,保留四类数量与筛选事件;连续详情使用公共页头与字段网格,列表行内操作均不超过三个,全部直显。状态和停用确认只接入外观,保留原权限、版本与请求。

所有修改后页面仍需人工在 1920×1080、100% 缩放下提供截图核对。

其余六菜单逐操作核对

  • 快递公司:编辑、启停最多两项直显;580px 编辑抽屉和共享批量导入 720px。原型未定义的具体编辑承载按当前实现保留,不擅自改为独立页。
  • 往来单位:详情、编辑、启停最多三项直显;680px 详情/编辑抽屉和共享批量导入 720px。
  • 费用项目:编辑、启停、删除最多三项直显;620px 编辑抽屉,启停和删除各有确认框。
  • 仓库管理:编辑、启停最多两项直显;650px 编辑和 760px 导入框。不要把 AppDialog 内表单误认为独立页面。
  • 船期价格表:列表详情、原文件、待确认版本作废最多三项直显;560px 上传框;独立详情页头保留下载与确认生效操作,不按列表行内按钮压缩。
  • 下载中心:详情、成功后下载、符合条件时重试;详情 720px 弹框,按状态保留后端重试资格。

共享 BatchImportDialog.vue 保持单一 el-dialog 为根;挂载测试已验证父传 class 实际到达 Teleport 根。组件直接引用密度变量并保留未接入时的默认值,无需新增参数。

已实施四菜单的检查结果

2026-09-14:7 个页面和供应商资质组件显式接入公共密度。供应商分类数量并入彩色页签;汇率四项摘要保留为紧凑一行;三个独立详情/表单页使用公共 density-detail-layout、同行返回与业务标题,供应商路由关闭重复页头。报价详情采用两组连续键值表,供应商及车辆长字段跨列;车辆标题不再回退内部 ID,筛选、列表、表单与详情统一使用原中文状态名称。

  • 原字段及作业入口保留:供应商表单 14 项、报价表单 8 项及两组 10 个表格列、车辆表单 10 项、汇率表单 3 项;供应商详情 12 项、车辆详情 11 项。已有资质版式和六个弹框的宽度、关闭与提交逻辑保留。
  • 定向测试 60 项通过,包含长供应商名称/地址、返回目标、车辆详情失败不展示内部 ID、最多三个操作直接显示;原有版本冲突、长 ID、汇率精度和失败保留表单测试继续通过。
  • 全量测试 251 个文件、1956 项通过。随后仅统一车辆状态中文名称,再次运行上述 60 项定向检查和 pnpm build(含类型检查),均通过;git diff --check 通过。
  • 本地 5173 开发服务返回这 7 个页面的已编译密度代码,HTTP 均为 200。该检查证明正在提供新代码,不代替真实页面视觉验收。

四菜单均待人工在 1920×1080、100% 缩放下核对修改后截图。

其余六菜单的检查结果

2026-09-14:七个页面和共享批量导入组件完成显式密度接入。列表操作使用白底描边纯文字,最多三项全部直显;抽屉根同时接入页面密度和抽屉密度,弹框根显式接入对话框密度。公共 FormSection 样式覆盖独立浮层,修正只依赖父页面造成的样式遗漏。仓库新增菜单的浮层间距限定在自身,不再覆盖其他菜单。

  • 维持前表逐操作承载与尺寸。往来单位详情和下载详情采用两组连续键值网格,长地址、备注与文件跨列;船期价格详情使用同行返回、版本号、状态及主要操作,摘要保留报价范围和上传时间,正文为连续白底。渠道页签使用公共彩色图标,预览表保留在页签正文外,价格行继续只读。
  • 七页脚本语法树比对(排除样式导入、已移除装饰图标与确认框外观参数)及所有表单绑定比对均一致,原业务处理、权限、版本、仓库映射、导入预检与下载重试逻辑保留。
  • 定向检查 94 项通过,包含排车六组权限下的操作数量、往来单位详情浮层、下载详情 11 个字段、批量导入普通/密度模式及成功提交;类型检查通过。
  • 全量测试 251 个文件、1957 项通过;构建(含类型检查)和差异空白检查通过。
  • 本地 5173 返回这七页及排车列表的新密度代码,HTTP 均为 200。排车列表已是纯省略号入口;代码与开发服务验证不能代替页面截图。

通用 10 菜单代码检查完成,全部待人工在 1920×1080、100% 缩放下核对修改后截图。首页、系统管理另行继续。

2026-10-20 客户财务基础组蓝白接入

本组覆盖供应商列表/独立新增/编辑/详情及资质弹框、快递公司列表/580px 编辑抽屉/批量导入、往来单位列表/680px 详情与编辑抽屉/批量导入、费用项目列表/620px 编辑抽屉/各自确认、仓库列表/650px 编辑/760px 导入、下载中心列表/720px 任务详情。另按实际入口覆盖 warehouse-resources 的库位与托盘列表及原居中编辑弹框;不扩展当前页面没有的业务操作。

各页面保留现有密度类并显式接入 admin-workbench;DataTable 的外层接入 workbench-table,Teleport 弹框及批量导入自身带 admin-workbench is-dialog,抽屉自身带 admin-workbench is-drawer。局部普通配色使用公共主题变量,危险色、状态、下载/重试资格和打印流程保持。当前公共批量导入消费者通过父传 class 显式接入,不修改共享组件。

上述本组页面、弹框及抽屉的定向回归通过,仍待人工截图确认。全量门禁由总控统一执行;没有部署、推送或真实业务写入。海外资料和国内价格簿属于另组,其结论以对应任务为准。

2026-10-20 用户追加修正:整页主列表与详情外壳使用 is-page-surface 取消外围整圈边框、圆角与阴影,页面保持连续白底;本组共 22 处主列表和 6 处详情容器,内部子表、指标/图表卡片、独立并列面板及弹框保持原边界。布局、内边距和脚本不因本修正改变;公共规则与全量门禁由总控统一收口。财务相关三文件 41 项定向复验通过,视觉仍待人工截图确认。

列表顶部紧凑化

依据 2026-10-20 用户整柜截图的最新要求,减少列表标题、操作和页签叠层;本组按实际结构核对如下,视觉待人工截图确认。

页面或范围 当前结构与操作证据 本轮收敛
供应商列表 suppliers/pages/SuppliersView.vue 标题与新增在工具栏;分类、统计数量和筛选另占下方区域,分类通过 switchCategory 切换 原分类导航整块移入 toolbar-start,保留 supplier-tabs density-status-tabs 并加 workbench-list-tabs;新增仍在 toolbar-actions,QueryToolbar 仍在 filters。分类图标、数量、ARIA 和事件保持
PDA 版本 pda-releases/pages/PdaReleasesView.vue 国内/海外 radio 与当前 APK/WGT 信息在单独上下文行;刷新、上传在工具栏 原应用切换与版本事实整块移入 toolbar-start 并加 workbench-list-tabs,保留原类、radio 键盘语义、绑定、当前版本与未发布状态;刷新、上传及发布/停发确认保持
客户、财务及本组其余标准列表 已有标题、操作同处工具栏,没有独立列表分类页签 复用总控维护的公共紧凑尺寸,不批量删除标题,不改客户费用特殊入口、汇总、状态或警告;客户详情内审计面板不参与此次列表合并

只调整上述两页列表模板及对应既有结构断言,不改脚本、API、权限、详情或弹框。通过 local-check.ps1 运行 SuppliersView.test.ts、SupplierRouteReuse.behavior.test.ts、PdaReleasesView.test.ts,3 个文件、17 项测试通过;公共尺寸和全量门禁由总控统一维护。

2026-10-21 浮层回归抽查:供应商资质、仓库创建/导入、快递公司编辑/导入、费用项目编辑、下载任务详情与审计详情的选定组件回归通过;本批不因静态检查未见问题就批量改写这些页面。与财务/IAM/客户费用一起,选定 12 文件 200 项回归通过;另客户与消息局部修复 56 项通过。长内容、校验、关闭重开、全屏与页脚的真实排版仍待截图,不能由挂载结果推定视觉通过。