ZZIPFORCE 差异概览 任务清单 修复顺序 ✅ 执行日志(24/24 完成) ↩ 系统手册

Hub ← UVPVP 对齐修复方案 ✅ 24/24 已完成(2026-09-12)

基于双系统审计台账(见系统手册)输出的修复闭环:使 ZIPFORCE Hub 的页面、按钮、表格、图表与调优完成的 UVPVP 完全对齐。Hub 已反超的能力(SKU 43 列深度表、盈利矩阵、四维矩阵、AI、RLS 多租户)保留不删。执行结果与事故记录见 执行日志

生成于 2026-09-12 16 项差异 · 24 个任务 · 全部完成 数据层共库 · 无需核对底层数据
第一部分

差异概览

UVPVP 为调优完成基准。唯一新增采集需求是 Noon FBN 库存入 Hub(其余图表均可由 Hub 现有表派生)。

#模块UVPVP 基准Hub 现状缺口判定
1通用图表交互每图 Download CSV / 独立日期范围 / 跟随全局;拖拽排序+锁定,按账号持久化 /api/layout无逐图导出/日期控件,无布局定制全缺(影响全部看板)🔴 P0
2通用表格交互列头排序 + 列级筛选(文本 / 数字 Min-Max / 区间)+ 每表 Excel 导出部分列排序、部分表 CSV列级筛选与 Excel 全缺🔴 P0
3Amazon 主看板ZF 81 / ONNO 84 / FG 77 chart × 8 区块(含链接健康度 4 图、数据表格)工作台 ~6 固定图 + 动态图表墙 + Top15~250 chart 缺;链接健康度区块缺;看板内订单明细表缺🔴 P0
4今日页4 KPI + 4 chart(小时/国家/SKU TOP20/小时×国家堆叠)+ 2 表 + 国家/SKU 筛选5 KPI + 小时折线 + 2 表SKU TOP20 图、堆叠图、小时×国家明细表缺🟡 P1
5排名页产品/市场双下拉 + 评分/评论/BSR大类/小类/星级分布 5 图 + 表市场 tab + 行内 90 天 BSR 趋势评分/评论趋势图、星级分布堆叠图、产品级切换缺🟡 P1
6FG 产品分析Series→Product→Country→Color→Size 5 级下钻 + 日/周/月粒度 + 库存列 + CSV平面 30 天表(排序)5 级下钻与粒度切换缺🟡 P1
7财务页13 表:KPI 汇总 16 列、月度 P&L 31 列、SKU 38 列、国家表现 24 列、2024/2025 SKU、产品月度、年度、对账、5 张口径 legend;每表 Excel7 tab:月度矩阵 22 列、盈利矩阵、四维、产品损益、Noon SKU 43 列、对账 17 列、年度 4 列月度 P&L 差 9 列;国家表现 24vs7 列;年度 SKU 表、口径 legend、Excel 缺(SKU 深度已反超,保留)🟡 P1
8Noon 主看板36 chart:CIR/Cancel 系列、广告 9 图(ROAS/ACOS/CTR/CVR/CPS by SKU)、Country→SKU 下钻、FBN 预警卡/noon 页仅 GMV 趋势 + 月度明细 + 对账单~30 chart 缺;FBN 预警卡缺🔴 P0
9Noon FBN 库存ZF/ONNO 各 1 页:7 KPI + 预警表 8 列 + 搜索/状态/国家筛选无(仅 Amazon FBA)整页缺🔴 P0
10Noon 利润表15 列(含 Del/Ship/Canc/Und 四态、Cost、TACOS、Mgn%)财务 noon tab 产品×月 10 列差 5 类列🟡 P1
11物流5 tab(同构)+ 燕文运费计算器(体积重/多行/最低价高亮)5 tab 同构运费计算器缺🟡 P1
12推广5 tab + KOL 数据分析表 + 记录投稿/申请投放表单 + 产品线子 tab4 tab + KOL 3 类KOL 分析表、投稿/投放表单缺🟡 P2
13库存 ERP9 单据类型(含供应商/关联 PO/批次/序列号/合计)+ 报表 tab + 供应商资料单据台账(类型/过账/红冲/盘点/基础资料)供应商、关联 PO、批次/序列号、报表 tab 缺🟡 P2
14数据接入3 子页含 Handsontable 映射编辑器(增删行列/列重命名/导入 Excel/导出 CSV+Excel)只读映射 + API 字段编辑器整块缺🔴 P2
15上传页Amazon A+ 内容管理(多国草稿/媒体库 OCR/文档状态/操作历史)通用文件上传+外链A+ 管理整块缺🟡 P2
16外围静态页research / tools / vocabulary(术语+图表指南)/ investor / software / noon-helpcenter仅 training可选(非 Amazon/Noon 经营模块)⚪ P3
第二部分

修复任务清单

每项含修复方案与验收标准。总验收口径:逐页对照系统手册第三部分(UVPVP 逐元素台账)——tab 数、chart 数及标题、表格列名顺序、筛选器、按钮文案与 UVPVP 一致即通过。

阶段 0 · 基础设施(先行,解锁后续全部任务)

ID任务修复方案验收标准优先级
T0-1ChartCard 通用组件新建 ChartCard(标题+图表+右上角 Download CSV + 日期控件三态:跟随全局/独立起止/清除);替换现有 EChart 直用点任意图表可逐图导出 CSV(文件名=图表标题);独立日期只影响本图;「跟随全局」随页面时间窗联动P0
T0-2看板布局拖拽持久化移植 UVPVP dashboard-layout.js 语义:chart 卡拖拽排序、🔒锁定、↺重置;新增 GET/POST /api/layoutPOST /api/layout/reset(按用户账号+页面 key 存 user_dashboard_prefs)拖动后刷新/换浏览器登录同账号顺序保持;锁定后不可拖;重置恢复默认;不同账号互不干扰P0
T0-3TableKit 列级筛选+ExcelDataTable 增强:列头点击排序(全列);表头下注入列筛选(文本包含 / 数字 Min-Max / > <);每表 ⬇ Excel(导出当前可见行 .xls)订单明细表任一数字列可填 Min/Max 即时过滤;文本列模糊;导出文件与页面所见行一致P0

阶段 1-2 · P0 经营主看板

ID任务修复方案验收标准优先级
T1-1品牌主看板页组
/dashboard/[brand]
amazon: zf/onno/fg
按 UVPVP 8 区块复刻:📊核心指标 / 📈销售趋势 / 📋订单趋势 / 💰财务 / 🌍国家 / 🏷SKU / 🔗链接健康度 / 📋数据表格。数据由 Hub 库派生:amazon_orders(趋势/取消/FBA-MFN/Prime/时段)、order_fees×amazon_orders(国家费率/佣金)、sales_daily/hourly、ads_sku_daily(SKU 图)、rankings_daily(链接健康度)。每区块 chart 用 T0-1 卡片;区块可折叠ZF=81 / ONNO=84 / FG=77 个 chart,区块标题与 chart 清单与 UVPVP 逐一对齐(以手册台账为验收基线);每图可 CSV+独立日期P0
T1-2看板内订单明细表移植 UVPVP 14 列明细(Order ID/Date/Country/Currency/Status/List Price/Price/Promotion/Commission/FBA Fees/Settlement/Settled/Rate%/SKUs)+ Country/SKU 汇总表,挂 T0-3 + 分页 Prev/Next列名/顺序与 UVPVP 一致;14 列全部可列级筛选(金额列 Min-Max);分页显示 共 N 行·第 x/y 页P0
T1-3Noon 主看板
/dashboard/noon/[brand]
复刻 36 chart:CIR+Cancel Trend、CIR Rate%、Cancel Rate%(noon_orders.item_status)、广告 9 图(noon_sku_ads)、Country→SKU 下钻、FBN Inventory Alert 卡、数据审计说明卡ZF/ONNO 各 36 chart 与 UVPVP 清单一致;FBN 预警卡显示 Total SKUs/Stock/三级计数/Shortage/92dP0
T1-4Noon FBN 库存页+采集① ingest222 加 spec:zipforce_noon/onno_noon FBN 快照 → 新表 noon_inventory(RLS+GRANT);② /inventory 增「Noon FBN」tab:KPI×7 + 表 8 列(Partner SKU/Country/Sellable/90d Sales/Vel/d/90d Need/Shortage/Status badge)+ 搜索/状态/国家筛选两品牌 KPI 数值与 mercury 源一致;表列名与 UVPVP 完全一致;三级状态筛选即时生效P0
T1-5工作台入口工作台品牌卡/顶部加「进入品牌主看板」直达链从工作台 1 跳可达新看板P0

阶段 3-4 · P1 财务与分析页补齐

ID任务修复方案验收标准优先级
T2-1月度 P&L 列补齐品牌×月矩阵 22→31 列:补 Valid Units(Cost)/Failed Cost/Unsaleable(Cost)/Referral/Fulfill/FirstMile/Views/Clicks/CTR%/CVR%/CPC/CPS/Opening·Closing Balance(Amazon 16 列版本并存,按平台切换)列名/顺序=UVPVP Noon 31 列、Amazon 16 列;列头可排序+列级筛选P1
T2-2KPI Summary 表新增 16 列 ×(All USD/SA/AE/年度)行结构表(Orders/Units/Canceled/Undeliverable/Return Units/NetProceeds/Settlement/Ad/Gross Profit/Margin%/Product Cost/First_Mile/Net Profit/Payout)行列结构与 UVPVP #kpiTable 一致P1
T2-3国家表现表分市场 KPI 7→24 列(补 Canceled/Undeliverable/Valid Orders/Referral/Fulfill/Views/Clicks/CTR/CVR/ACOS/TACOS/FirstMile/Settlement/Gross Net/Margin%)+ 月份筛选24 列与 UVPVP #cpTable 一致P1
T2-4年度 SKU 表 + 口径 legend① 年度对比 tab 增 SKU 级年度表(复用 38 列 schema,年份切换);② 每张主表下加可折叠「指标说明」4 列表(指标/含义/计算方法/数据来源),内容移植 UVPVP legend每表有 legend 且可折叠;SKU 年度表按年份切换P1
T2-5全财务表 Excel 导出挂 T0-3(文件名 finance_{brand}_{表名}_{date}.xls)13 类表全部可导出,与页面所见一致P1
T2-6Noon 利润表列补齐noon 产品×月 10→15 列:补 Del/Ship/Canc/Und(noon_orders.item_status 聚合)、Cost(noon_procurement_cost)、Cost/U、TACOS、Mgn%15 列与 UVPVP .prof-table 一致,分组月×国家带汇总行P1
T2-7今日页补图补 🏷SKU TOP20 水平柱状图、🔥小时×国家堆叠柱状图、📋小时×国家明细表(时段×国家列+合计)4 chart + 2 表与 UVPVP today 一致;国家/SKU 筛选联动(SKU 图不受国家筛选影响)P1
T2-8排名页补图行内展开区增:评分/评论趋势折线(+ZF 星级分布 5★~1★ 堆叠柱,rankings_daily.rating/review_count/star_pct);产品下拉切换展开后图数:ZF 5 / FG 4 / Noon 3(seller_rating),与 UVPVP 一致P1
T2-9FG 产品 5 级下钻products 页加「下钻视图」:Series→Product→Country→Color→Size 可展开行 + 粒度日/周/月 + 起止日期 + TOTAL/AVG/📦Stock 列 + Expand/Collapse/CSV五级行结构、粒度切换、汇总列与 UVPVP products.html 一致P1

阶段 5 · P2 操作与工具页补齐

ID任务修复方案验收标准优先级
T3-1物流运费计算器Pricing tab 增计算器:目的国/泡比(默认6000) + 产品行(数量/L/W/H/实重→体积重实时)→「计算运费」结果表(#/渠道/类别/计价/计费重/运费),最低价高亮与 UVPVP 计算器交互一致;最低价行高亮P2
T3-2推广补齐① KOL tab 增「数据分析」4 表(平台效果/量级性价比/品类分布/国家分布);② 渠道行「投稿」/「下单」→ 记录投稿(产品/渠道/结果/单量/备注)与申请投放(产品/渠道/金额/货币/备注)表单 → /api/promotion/submission·order表与表单字段与 UVPVP 一致,提交后计数刷新P2
T3-3库存 ERP 字段补齐单据抽屉补:供应商(PO)、关联 PO(GRN/PRETURN 拉已审 PO)、明细行批次/序列号、金额合计;单据列表增「报表」(近 7/30/90 天入库/出库柱状+表);基础资料增供应商维护字段与 UVPVP 一致;GRN 只可选已审 PO;报表三档切换P2
T3-4映射编辑器/mapping 增「编辑」tab:表格化编辑(增删行/加列/列重命名/单元格编辑/行复选删/导入 Excel/导出 CSV+Excel/保存),POST /api/mapping/{brand}(RLS+审计)编辑保存后 mapping 列表即时反映;导入 xlsx 替换后需点保存才落库P2
T3-5A+ 内容管理/upload 增「A+」区:草稿创建(ASIN 多个/站点多选/模板经典·简洁/模块 header·3图文·4宫格·对比表/每图从媒体库选)、媒体库登记(引用路径/语言/标签/OCR 校验)、文档状态表+提交审核、操作历史Tab 结构与字段与 UVPVP upload 一致;语言缺失警告条逻辑一致P2

阶段 6 · P3 可选外围(非经营模块,默认不做)

ID任务说明
T4-1vocabulary(术语+图表指南)直接搬运 UVPVP 静态内容,零接口
T4-2research / tools / investor / software / noon-helpcenter纯静态,按需单页搬
第三部分

修复顺序建议

阶段0 T0-1/2/3 通用组件 + TableKit + 布局持久化 ← 一切前提,先做 阶段1 T1-1 → T1-2 → T1-5 ZF Amazon 看板打样(81图跑通全部交互) 打样验收后 → ONNO/FG 平铺复制(仅换数据源) 阶段2 T1-3 → T1-4 Noon 看板 + FBN 库存(FBN ingest 先行,等数据回流) 阶段3 T2-7 → T2-8 → T2-9 today / rankings / products(小而快) 阶段4 T2-1→2-2→2-3→2-4→2-5→2-6 财务逐表补列(legend 随表走) 阶段5 T3-1→3-2→3-3→3-4→3-5 工具页(相互独立,可并行分包) 阶段6 T4 按需

排序依据

  • 通用件先行:否则每个页面重复造交互(CSV/日期/拖拽/筛选)
  • ZF Amazon 打样再平铺:81 图覆盖 8 区块全部形态,验证完直接复制到 ONNO/FG
  • FBN 采集早启动:有采集延迟,阶段 0 期间即可并行准备 ingest spec
  • 财务放后:Hub 已有 7 tab 骨架,是补列不是重建,风险低
  • P2 各项相互独立:可并行分包

总验收口径

逐页对照系统手册第三部分(UVPVP 逐元素台账):每页 tab 数、chart 数及标题、表格列名顺序、筛选器、按钮文案与 UVPVP 一致即通过。Hub 已反超的能力(SKU 43 列深度表、盈利矩阵、四维矩阵、AI、RLS)保留不删