Acceptance Base · 验收标准库

Zipforce Hub 验收标准库(audit-base)

每个功能 / 每个页面元素 / 每条口径,单独一条恒定验收标准。验收只对本库,不对任何单轮审计叙事。定位定谳(用户 2026-10-24 原话):本库是一切审计验收的基础,以最细的颗粒度描述每一个信息;姊妹页 audit.html 是审计后的记录,记录历史审计内容和结果。初版 2026-10-21 v1(净利口径二轮收口当日建立)· 姊妹页 独立审计报告 audit.html(链接不变原则,两页互相独立)
79标准条目
79生效中
0待修(已挂账)
2待用户拍板
0本轮新增争议
§11逐页元素全册在册(§11.1–§11.41)
本页三条根本纪律(2026-10-21 用户令,源于"每次验收标准不一样、一个问题翻来覆去改"的复盘):
① 标准先于代码——改任何数字相关代码前,先在本库写/改验收标准条目,再动代码;代码与条目不一致=缺陷,不是"标准过时"。
② 审计数字先复算后采纳——任何审计线(含本库验证方法引用的数字)必须独立 SQL 复算通过才可驱动修复。已实证的审计误判三例:promo"未扣"(订单层已扣)、服务费 4844.11(混币裸加,真值 −728.73)、fx_rates"停更24天"(两层均当日新)。
③ 同口径跨层必相等,不同口径差值必须带标签——caliber_recon 门禁机器判定(AC-GATE-01),不许"两边都对"和稀泥。
本库变更纪律(2026-10-24 用户裁定改立):本库=最终标准,不需要只增不删——标准文本可直接改写、合并、收敛为当前有效形态,不作历史层积;过程记录与历史沿革一律归姊妹页 audit.html(审计档案),本页不载任何记录。条目作废可直接删改或标 废止 并注明替代条目。ID 永不复用不变。

§1 口径类标准(AC-CAL)

ID口径验收标准(恒定)验证方法状态
AC-CAL-01净利 net_profit
(Amazon)
净利 = 订单层净额(非取消单:revenue_usd − commission − fba − promo − other − vat)+退款净流出(amount_usd 恒为负)−广告费(cleaned_ads_sku_daily ∪ cleaned_amazon_ads_daily 双源并集,SKU级∪campaign级)+服务费(usd 恒为负;mars 月账 Σamount/fxd(posted_date,currency) 折 USD;排除 1970-01 与非法 fee_month)。促销在订单层已扣,任何"promo 未扣"论断先复算订单层。审计线数字必须 fxd 折算后同币比较(JPY 不得当 USD)。caliber_recon 月/品牌粒度独立复算 vs /api/finance/summary,|Δ|≤$1;基准锚点:zf 2026-09 服务费 −728.73、fg 2026-09 −8979.62生效 reg:id3,14,15,17
AC-CAL-02有效订单 orders
(KPI 总体)
orders = 有效订单(order_status NOT IN ('Canceled','Cancelled')),与 revenue/units 同总体同过滤;orders_all = 全量含取消,单独随行下发。两者禁混。cancel_rate 分母 = orders_all(防 >100%);AOV = 营收÷有效订单;CPS = 广告花费÷有效订单。kpi-cards SQL 复算;接口含 orders_all 字段且脚注标分母生效 reg:id4,5,25
AC-CAL-03Noon 广告归因分层总额/国家维度 = cleaned_noon_ads_daily(agg_shadow:有 'all' 聚合行的日子,其余 ad_type 行整组不入层);产品/SKU 维度 = 主表未遮蔽 SKU 行 ∪ 归集层 cleaned_noon_ads_sku_attr 被遮蔽行(EXISTS 同 brand/country/day 'all' 行 AND NOT EXISTS 同六键行)。归集层行只进产品/SKU 两维,禁进 totals/国家(防与 'all' 双计)。1–7 月归集层 product+sp 并存(product 真值 + sp 残留=61,289 双计陷阱),EXISTS 'all' 闸整组挡在外。SKU 维度合计 < 国家维度合计属归集口径覆盖率(58–90%),不是丢数。7 日窗 /api/ads/analysis?platform=noon:SKU 维度行数>0 且 totals_noon 与 'all' 行合计相等(v1 实测:totals 826.83 / SKU 维度 40 行 739.58)生效 reg:id2,18,19
AC-CAL-04Amazon 广告归因campaign 级行(无 SKU)只进平台汇总与国家维度,禁进产品/SKU 明细(防伪归因空 SKU 组);SKU 级双源并集(sku 日表 + campaign 表 advertised_sku 非空行)。ads_analysis 产品/SKU 维度无空 SKU 组;双源合计=平台汇总生效 reg:id1
AC-CAL-05Noon 本币折 USDNoon 金额行级按国家(SA=SAR / AE=AED)经 fx_rates 锚定汇率折 USD;跨平台/跨国家混排必须折 USD;SAR/AED 禁当 USD 裸加(17/4.2 倍虚高实证);本币值与币种标注随行下发。matrix/ads 各端点 local_spend/local_sales + currency 字段在;混排值与 Σ(国家折算) 相等生效 reg:id6
AC-CAL-06ACOS 健康线 / BID_CALC健康线阈值单源 metric_calibers.health_line,任何代码禁内联 25/40;BID_CALC = 有效ACOS × CVR × AOV,利润封顶;预算花尽才许加预算(R24)。公式语义锚 reg:id26(批A 2026-10-25 注册):参数族(target_acos/margin_keep/min_clicks/win_days/diff_pct/floor_imps/max_cut/max_raise、护栏 [0.01,200])真源=ads_rule_config(grp=advisor, rule=BID_CALC,平台/品牌可覆盖),advisor 全派生零内联。grep 代码无内联阈值;建议引擎输出与公式复算一致;ads_rule_config 行值=id26 defaults 逐位相等生效 reg:id16,26
AC-CAL-07fm 三方对账口径finance_monthly / monthly_pl 属 settlement 基准三方对账口径,与订单层口径(AC-CAL-01)是两条口径;差值必须带标签呈现(caliber_recon WARN),禁静默、禁和稀泥。/api/finance/monthly 读 fm 侧,不随总览口径改动。caliber_recon B 组 WARN 输出差值清单生效 reg:id21,22
AC-CAL-08回款层口径cleaned_amazon_settlement_monthly.payout_usd vs 订单层净额差值=回款滞后/储备金,属业务事实;差值带标签呈现,禁当缺陷修平。2026-11-01 批二b 追记(reg:id7/id8 行 as-built 校正):is_abnormal 为 RLS 表列,写入方单点=sync_source._ORDERS_MASTER_TPL;公式含 NOT is_removal 豁免(2026-10-31 拍板①·audit.html 9.107:移除单永无回款,>14 天不再误报——本行此前漏登,批二b 补记);消费端(ai/notify/ops/finance)一律读列零复写;id7 起点列模块名同步校正(sync_mercury→sync_source,2026-10-03 改名)。caliber_recon C 组 WARN生效 reg:id7,8
AC-CAL-09汇率源fx_rates 每日 12 币种(worker 06:05),全量镜像 mars public.fx_daily;浮动币 >3 天无新行 → dirty_data_log(fx_fallback_constant)。"汇率停更"结论必须同查两层(saas fx_rates + mars fx_daily)才可下(2026-10-21 审计线只查一层得出错误"停更24天")。SQL 两层 max(rate_date)/max(day) 均=今日或昨日;dirty 日志无新增生效 reg:id6,13
AC-CAL-10SKU 宇宙ASIN/SKU 事实源=sku_mapping,不另造清单;所有 SKU 层数据源端血缘过滤(EXISTS sku_mapping)+ brand_fix 纠正后再判;排名/建议等名称字段=sku_mapping 规范名(product_name 优先,空则 ASIN),禁把 ASIN 当名称入库。层外行计数=0;rankings 行 name ≠ asin 抽样生效 reg:id3
AC-CAL-11品牌归属账号即宪法键兜底 + advertised_products × sku_mapping 多数投票纠正(经 zf 账号投放的 onno EU campaign→onno);onno 代卖走 zf 卖家账号的行归并属主 onno(铁律2)。结构语义锚 reg:id30(批A 2026-10-25 注册):三路=brand_fix(amazon_orders.sku_list / ads_sku_daily.sku / amazon_ads_daily.advertised_sku,精确命中他品牌才纠正、多 SKU 逗号列表不动、raw 不动)+campaign_brand_fix(多数投票)+fees_brand_fix(zf 行×onno 订单按形态分两路防双计);单实现=api/clean_audit.py SPECIAL_TABLES。campaign_brand_fix 后品牌计数与账号×mapping 复算一致;clean_audit 三路与 id30 filters 语义逐项对得上生效
AC-CAL-12noon SKU 月表币种cleaned_noon_sku_pl_monthly gmv/settlement=国家本币(AE=AED/SA=SAR),跨国家禁直加(roas 币种中性可直比);任何汇总层跨国家必须先折 USD。ads_by_country/sales_summary 各行带币种;无 AED+SAR 混加值生效 reg:id19
AC-CAL-13矩阵幽灵维平台维只认 Amazon/Noon(eMAG/其他无数据源不出现);维度选项全部来自源表 DISTINCT,禁硬编码品牌清单(RLS 已按企业品牌域过滤,代码内 IN 清单=幽灵维温床)。/api/matrix/dimensions 无无源维度;grep 代码无 brand IN 硬清单生效 reg:—
AC-CAL-14口径级联三处口径改动三处必须同批级联,缺一即缺陷:① metric_calibers 注册表先行登记 → ② 全部读面同步(同字段全站同值:KPI 总览 / finance·full 矩阵 / 国家块)→ ③ 门禁基准同步(dashboard_audit 基准 SQL)。当日 final 门禁后禁再部署数字代码而不补跑(P2a 2026-10-22 教训:22:47 部署漏级联未补跑,nightly 首跑抓 6 FAIL)。现状披露:剔取消集合两变体/三变体字面量并存(2026-10-22 实测数据仅 'Canceled'×2670,行为等价),字面量统一归 AC-PEND-02 结构化方案。nightly dashboard_audit 跨页一致性检查;注册表 vs 代码 diff 对账生效 reg:—
AC-CAL-15口径视图族单实现
(2026-10-22 拍板:最优解=最根本解)
【速览导航层】——本块即本条标准的全部正文(恒则+as-built 清单)。
  • 标准恒则(4 条,与批次无关):① 三高危口径(广告费/订单/净利)唯一实现=audit schema 视图族,security_invoker=true 保企业 RLS 铁律(PG16);② 消费端(api routers/门禁/内部工具/MCP)一律读视图——代码中出现第二处口径 SQL 即缺陷;③ 视图定义变更=先本条新行登记+metric_calibers 注册再动 DDL,扩列只许列尾追加(115 实证 cannot change name);④ 换源四纪律(B4/B5a/B5b 三轮事故沉淀):查 SELECT 全列名|查条件模板串内嵌列名|CTE 聚合列显式别名|带窗/无窗双形态线上回归。
视图(as-built 9 枚)平台 · 粒度口径要点caliber idDDL
v_amz_orders_dailyamz · 日×企业×国orders=剔取消 3 拼/orders_all=全量/unitsid=4(P2a)114
v_amz_order_net_dailyamz · 日订单层净额组件+units—114
v_amz_ad_spend_dailyamz · 日双源守卫并集(ads_sku_daily ∪ amazon_ads_daily;onno 双计由清洗层 onno_country_dedup 根治)id=1114
v_noon_orders_dailynoon · 日orders=COUNT(DISTINCT order_nr) 与 units=count(*) 并列双列(4849 教训:单数禁件级 count(*))id=5114/116
v_noon_ad_spend_dailynoon · 日×国三型 ad_type+fx 最新日;本币列 sales_local/views/clicks/atcid=2114/116/117
v_amz_net_profit_monthlyamz · 月AC-CAL-01 全式+unitsid=17115
v_amz_ad_spend_sku_dailyamz · 日×品牌×国×SKU×campaign双源各剔空 SKU+空 campaign 补洞行(守卫中性,防回归保留)id=1 SKU 扩展118
v_noon_ad_sku_dailynoon · 日×品牌×国×SKU×campaign×ad_type源=sku_attr 本币,结构性无 '[daily_total]' 哨兵id=18118
v_noon_ad_sku_monthlynoon · 月×品牌×SKU×国源=cleaned_noon_sku_adsid=19118
  • 公共属性:9 枚全部 security_invoker=true+GRANT portal_app/mcp_read;RLS 三企业穿视图隔离实测。
  • 口径分派(两源不可互掺):聚合面恒用 daily 族(id=2);SKU/campaign 面恒用 sku_attr 族(id=18/19);同窗 77/1046 组漂移实证,两层各自成口径、禁止互校对齐。metric_calibers 权威源 id=1/2/4/5/17/18/19 全部=视图(v5.10 收官)。
  • 豁免类目速查(逐条原文见 B4/B5/B6 段):行级/标量面 · 无守卫并集前体(amz 臂)· 覆盖元数据 · 状态集差异 · fee-coverage · XOR 混合/带闸修复 · finest 导出面 · P&L LATERAL · _SKU 平摊 · 数据清单行计数 · 全局窗 DISTINCT 单数(_kpi_deck:1017 不迁)· D9 含税 ×(1+VAT) 维持。
  • 换源批次索引:一期 v5.5(B1/B2/B3)→ B4 v5.6(17 处)→ B4d v5.7(ads.py 3 处)→ B5a v5.8(finance 9+ads 1)→ B5b v5.9(缺陷修 4+收编 2)→ B6 v5.10(mcp+id=2/5 权威源收官)。零调用孤本 metrics.noon_ads_union 已于 2026-10-23 拍板删除。
  • 余量:audit_nodes 基线独立复算纪律保留手写(其视图化另议);豁免类消费端如语义变化须重新甄别。
grep 源表直查(cleaned_ads_sku_daily 等)仅存于视图 DDL 与 ingest/clean 写面;caliber_recon 视图 vs 消费端 |Δ|≤$1;frontend_e2e+dashboard_audit 全过生效
AC-CAL-16Noon 有效件口径
(undeliverable)
Noon 有效件 = units − cancelled,不剔 undeliverable(2026-10-24 用户拍板);妥投口径需求一律走 delivered 权威直读,禁用状态列减法派生(状态列会计恒等式不闭合、残差≈8.6%,诊断列非分区键);重派成功件误剔与财务后果由退款净额面(P3-9)捕捉,不双重惩罚。noon KPI 有效件复算=units−cancelled;妥投数=delivered 直读生效 reg:id5
AC-CAL-17市场表现页展现口径
(采集原值直读,2026-10-24 用户三次拍板)
市场表现页(BSR/评分与评论各 tab)一切数字 = 采集字段原值直读(用户原话:「直接按照采集的数据,展现在web就好了,不许添加任何公式」)。每行 = 一条采集记录(平台/品牌/国家/ASIN/名称/评分/评论数/店铺评分/BSR),值与源表逐字段相等。禁任何公式派生:加总(sum)、平均(avg)、加权、分布分桶计数、净增等一律禁(此前教训:13 站共享评论池一把 sum 放大 ~7×、页面曾显 40,036;国家内/品牌内 sum/avg 同禁——「谁叫你平均的」「我那句叫你把评论汇总了?」)。允许:筛选(品牌/国家/平台)、排序、分页(BSR 榜前 60 截断与截断提示维持,2026-09-12 D批P3-10)。数据源血缘:Amazon=Keepa 产品接口(无店铺评分字段,seller_rating 恒 NULL 如实显 —);noon=卖家后台 portal API(BSR 全 NULL 如实显 —,店铺评分有值)。评论正文另由 评论内容 tab 原文列出(Amazon=crawlbase、noon=portal seller_reviews,均原文直读)。/api/rankings/rating-review-analytics 响应仅含采集字段原值,无任何聚合/派生字段;页面任意单元格 vs 源表 SELECT 该行该列相等生效 reg:id64,65(零单间隔报警/断保本 ACOS 窗两口 2026-11-09 挂靠,纪律伞下原值直读)
AC-CAL-18月度仓储费对账口径
(报表 ⊗ 专表,2026-10-24 用户拍板「干就是了」)
月度仓储费(FBAStorageFee)对账基准=报表(计费月/不含税) ⊗ 专表(入账月/含税),两侧按「专表 fee_month−1(入账月→计费月回退一月)+ 税前折算(JP 消費税 10%/SA VAT 15%/AE VAT 5%,EU/US 无税差)」对齐后 ±1 USD 视为平;US/SA/AE 2026-05-01 一次性 true-up 大额(US −28.41/SA −73/AE −71)单独挂行不计入月度偏差。两口径各自为真不互改:报表=不含税计费月,专表=含税入账月。报表缺月(2024-09/10、US 2024-11→2025-02)金额以专表为准。LTSF(FBALongTermStorageFee)与 Vine(Vine Enrollment Fee/VineFee)=独立账户级 fee_type:不掺 FBAStorageFee 行、不入本对账、禁发明 SKU 分摊(两者均无 seller_sku 轴且专用报表类型实测不存在,AC-CAL-17 同纪律);SKU 级真值待 app 获 Finance 角色后经 V2 结算/Ledger 报表补(未授权前不追)。逐区×月:align 后 |Δ|≤1 USD(EU 双币 22/23+21/23 实证基线);2026-05 US/SA/AE 三行单独挂账对上;LTSF/Vine 行不出现在月度仓储对账任何一侧数值真源 reg:id27(fee_month−1/税差 JP 10·SA 15·AE 5/平阈 ±1 USD/trueup 挂行全量入注册表,批A 2026-10-25 注册;消费端=审计时对账,暂无常驻脚本——未来建仓储对账门禁须派生 id27 禁内联)生效
AC-CAL-19月度开销视图 adjustment 过滤口径
(v_monthly_overhead Reserve 排除,2026-10-25 用户拍板「1,2执行」②)
amazon_analytics.v_monthly_overhead 的 adjustments 分量(zipforce_amazon_spapi_adjustments 取负汇总)中,adjustment_type ∈ {ReserveCredit, ReserveDebit} 的储备金调整行不计入月度开销(<> ALL 排除)。储备金=Amazon 资金池往返科目(后续月份对冲回转),计入会虚增/虚减当月 overhead。as-built 烘焙于视图(值建迁移时写死,与批F 分层真源拍板一致),2026-10-25 注册前的既有行为=本口径,注册不改变量值。视图另有的固定结构字面量(月序 2026-01…05、107.98、224.60、transaction_type='Charge')属页面固定结构值,不在本条过滤口径范围。哨兵执法:三库任何视图新烘焙 Reserve 字面量而未挂 id37=当晚红(ruler_recon R7b)。id37 filters.exclude_adjustment_type ↔ 视图 adjustment_type 比较位字面量集恒等(R7b 逐比较位);三库含 Reserve 字面量视图 ∈ 注册面唯一(v_monthly_overhead)数值真源 reg:id37(exclude_adjustment_type 全量入注册表;消费端=烘焙视图,无 REST 内联)生效
AC-CAL-20Noon 评分/评论数口径
(product-reviews 目录级,2026-10-24 用户拍板)
Noon 评分与评论总数唯一正确源=noon-reputation 目录级端点 product-reviews/list(/_vs/mp/mp-trust-api-partners/reputation-dashboard/):评分=avgProductRating、评论数=totalCount、名称=productTitle;AE/SA 两市场逐字段同值,无国家拆分(sa/ae 字节级一致实证)。链路 {schema}_rankings → rankings_daily(_RNK_NOON 折叠) → audit.cleaned。两旧口径均废止:①seller-reviews 365 天窗(窗内计数≠总数)②卖家级总数错盖。历史不回改:旧口径 6,023 行 2026-10-24 物理清除,源表起点=当日;店铺评分(shop rating)恒 NULL(真实源未提供,9.33⑤ 挂账)。内键预滤=#148 三集判据(adapter mapped_keys + _RNK_NOON 折叠谓词 1,319 键 + clean 血缘 + face_recon 门)。端点 AE/SA 同值断言;cleaned 评分/评论数与目录级端点逐字段相等;旧口径行=0;shop_rating 全 NULL数值真源 reg:id39(markets/同值/字段映射/历史策略/预滤全量入注册表,2026-10-27「全批」入册;消费端=rankings 链路清洗,无 REST 内联;id38 序列空号——首插回滚烧号,只增不删记录在案)生效
AC-CAL-21Amazon 星级分布(star_pct)口径
(无 API 源恒 NULL,2026-10-27 用户拍板)
拍板「ranking 数据不自采,全部走 API;没有 API 的国家持续报警」:star_pct 星级分布五元组全市场无 API 源(Keepa 官方 11 站均不提供直方图数据)→ rankings_daily.star_pct 恒 NULL(页面五元组缺失为 None、hasStars=False,不派生不估算)。9.58 直方图自采线(crawlbase dp 页窗口法+sum∈{99,100,101} 闸)同日废止:03:43 arq cron 移除+adapter star_pct 回写剥离(product_reviews 评论通路属 10-07 指定面、非 ranking 数据,保留挂起)。历史不回改:≤2026-09-29 一代(评论页百分比)冻结值保留;2026-10-26~27 二代(直方图)4 行保留为史。rankings_daily 零 star_pct 写入路径(writer 清点实证);巡检每轮含 star_pct 持续报警行(三品牌 market=ALL);Keepa 无站市场报警本批扩 UAE/KSA(AU/NL 既有——amazon.ae/.sa 同不在官方 11 站,此前空集静默 skipped)数值真源 reg:id40(disposition/alarm/history_policy/banned_channel 全量入注册表,迁移 157;消费端=rankings 页面原值直读,无 REST 内联)生效
AC-CAL-22财务舱 v2 判定线口径
(用户拍板 2026-10-28「都拍板同意」,拍板③⑤)
财务舱 MoneyStrip 判定面=用户逐项拍板的展示判定(口径经拍板故非执行层发明)。净利率=月 net/月 revenue×100:≥15 ok / 0~15 warn / <0 danger(拍板⑤);退货率=件口径 月退货件/月售出件×100:<20 ok / 20~30 watch / ≥30 alert(拍板③,amazon 侧)。取值单源=注册表 id42(semantics/阈值/refund_basis/grounding 全量入册);前端 useThresholds 单源消费 /api/metric-thresholds;行缺失/键缺失回退同值(冻结锚)。grounding 实证:fg 2026-08 真异常月退货 30.5%/净利率 −3.7% 被捕获;zf 月退货基线 2.7~14% 与 fg 服装基线 15~20% 不误报;zf 2026-04 弱月净利率 1.9% 落 warn 带。改 id42 阈值 → /api/metric-thresholds 与页面判定色同步变化;断网回退恒同值;grounding 三锚复算数值真源 reg:id42(消费端=finance 页 useThresholds 单源,无 REST 内联)生效
AC-CAL-23滚动窗环比基线口径
(用户总指令§五,2026-10-30)
环比基线=主窗等长前移区间:主窗 [d1,d2] 与基线窗 [d1−N, d2−N] 等长(N=d2−d1+1;rolling=近30天,d2=北京业务日;month=完整月对完整月 k 月窗回推 k 月;平移步长=窗长本身,禁重叠窗)。先聚后除:主窗/基线窗分别各自窗口内先聚合后对比,禁逐日对比再聚合。取值单源=注册表 id45;工作台 _period_win pf/pt 既有语义(2026-09-07 起)收编入册(注册不改量值)。消费端=/api/dashboard/kpi compare.prev 块后端下发,前端零派生。业绩速览完整月环比(id42 拍板①原值对,不算%)与本行并存(C 拍板5 双口径:id42 留业绩速览与财务同源,滚动窗作新基线行)。compare.prev.base ≡ 基线窗独立 SQL 聚合值;窗口等长断言(ct−cf == pt−pf);前端无派生对比计算(grep 断言)数值真源 reg:id45(消费端=dashboard.kpi compare.prev,无 REST 内联字面量)生效
AC-CAL-24同比平移一年基线口径
(用户总指令§五,2026-10-30)
同比基线=主窗平移一年等长区间:基线窗=主窗各日期−1年(闰日 2-29 映射 2-28)。各窗先聚合后对比(同 id45)。数据覆盖外的基线(如 Noon PL 月表 2025-02 前)为空 → 禁百分比显「不可用」=正确行为(显式披露非缺失),禁以 0 充基线。取值单源=注册表 id46;消费端=/api/dashboard/kpi compare.yoy 块。compare.yoy 基线窗日期 ≡ 主窗−1年逐位;noon 同比窗落 2025-02 前 → pct=null 且显式 unavailable 语义;闰日窗不 500数值真源 reg:id46(消费端=dashboard.kpi compare.yoy,无 REST 内联)生效
AC-CAL-25差值与变化率呈现口径
(用户总指令§五/§六,2026-10-30)
绝对差值=主窗聚合−基线聚合(数值类;基线窗无数据行→abs=null);变化率=(主−基)/|基|×100,基线=0 或任一侧窗口无数据行 → pct=null 显「不可用」(禁 0 分母、禁以 0 充基线);百分比类指标(率/比率,如净利率/ACOS)只展示百分点差值 pp=主−基,不出变化率。取值单源=注册表 id47;abs/pct 由后端统一下发(compare 各 metric 条目),前端禁自算。base=0 场景 pct=null;base 无行场景 abs=null+pct=null;率类指标无 pct 键(只有 pp);手算复算 (cur−base)/|base|×100 逐位数值真源 reg:id47(消费端=dashboard.kpi compare.*,无 REST 内联)生效
AC-CAL-26归集基准日口径
(用户总指令§五,2026-10-30)
各数据域归集基准日随响应下发:每域 as_of=该域源表 max(业务日)(Amazon=cleaned_amazon_orders max(purchase_date);Noon=PL 月表 max(mon) 月末/日财务表 max(d))。跨域对比须披露各自 as_of 差异,禁静默拼接不同基准日的域;大盘卡片口径水印含归集基准日。取值单源=注册表 id48;/api/dashboard/kpi as_of 既有字段(2026-09-07 起)收编入册,compare.win_desc 一并下发窗口描述。as_of ≡ 源表 max(业务日) 复算;compare.win_desc 含窗界+基线窗界描述;跨 as_of 域不并列合成单值数值真源 reg:id48(消费端=dashboard.kpi as_of/win_desc)生效
AC-CAL-27Amazon 销量件数移除单过滤口径
(退回剔除/弃置保留,2026-10-31 用户拍板「弃置是弃置,退还是退还」)
FBA 移除订单在 Orders API 的影子单(sales_channel=Non-Amazon,seller_order_id=移除订单编号)此前整单计入 sales_daily 件数。拍板口径:退回型(order_type=Return,货回自己仓可二次销售)从销量件数剔除——退还的货还能再卖,剔除后再次售出才计销量;弃置/清算型(Disposal/Liquidations,不可二次销售)保留在件数中计为损耗成本。真源=官方移除报告 GET_FBA_FULFILLMENT_REMOVAL_ORDER_DETAIL_DATA 专表 {schema}_spapi_removal_orders(zf 四区 AE/SA/US/DE,采集器 zf-removal-orders 每日 0 2 UTC 全窗 DO UPDATE);消费端=sync_source._IT_BRANCH 谓词(30 天增量窗每日自愈)。移除单行 revenue 本就=0,剔除仅动件数不动营收。历史校正一次性批(2026-10-31):2025-02→2026-10 共 −5,381 件/66 键全命中(峰 2025-09 −1,058、2025-04 与 2026-02 各 −715、2025-12 −631),幂等标记 public.audit_caliber_patches。fg/onno schema 同构空表(谓词模板共享,防 SQL 崩)。旧披露注「件数含站外履约件(MCF·Non-Amazon)」废止,MCF 定性已翻案(audit.html 9.106)。
2026-10-31 结算面扩展(拍板①「1.2.3都拍板」,audit.html 9.107):同一签名扩到结算面——标志列 public.amazon_orders.is_removal(staging 落列=单一真源,cleaned 全列跟随;迁移 165+一次性回填 156 行,90 天增量窗内行由 sync 模板 EXISTS 每日自愈)。结算面全类型同标:Return/Disposal/Liquidations 影子单一律=移除单——「不是销售、永无回款」不分类(与件数面仅剔 Return 分工:件数面区分可否二次销售,结算面无回款可谈)。执法=①移出待回款分母(_P)也不入僵尸单(_Z,僵尸线 GREATEST(品牌财务基准, now−730d) 不变)②豁免 is_abnormal(>14 天回款异常不再误报)③settlement_status 标签「移除单」(原提案「站外履约」废止)④/settlement 页独立 filter=removal 桶+KPI 卡。2024-08-15 首对 2 笔曾被 730 天保留线误转僵尸,本批回正入移除单桶。证据边界:fg 47 笔 S03- 影子单无移除报告证据(fg 专表空)不入桶,待 fg 采集点亮后自动跟随(模板同签名)。fg 已点亮(同日 16:07 UTC,用户「开」批准,audit.html 9.109):采集器 fg-removal-orders(AU+US+IT 全窗)首拉 508 行/183 单;47/47 全命中(26 笔 seller_order_id 直配 + 21 笔 request_date 同秒配且每秒单值无歧义);21 笔 raw 缺失的 seller_order_id 按官方报告回写(模板 EXISTS 对 47/47 可自愈);fg 待回款 668→625 / 异常 1700→1660 / 移除桶 47,zf 156 / onno 0 零外溢。
欧洲区 MCF 费用行边界(2026-10-31 用户「同意」处置 A,audit.html 9.108):欧洲区 8 笔 S0x Shipment 费用行(2024-09-26→2026-04-12,合计 54.77 USD/26 个月)判真=真 MCF 履约费非移除费(三重证据:移除报告专表零命中+事件类型全 Shipment+Orders API 查无)——费行照常入成本/净利面(真实成本),MCF 订单无影子行=不入结算面不占回款分母(MCF 营收在商家自有渠道,亚马逊侧本就=0);不开 Fulfillment Outbound 采集(补拉只能拿收件人/物流明细拿不回营收,拍板维持现状)。
专表 order_type 与影子单 sales_channel+seller_order_id 逐笔对账(156/156 匹配实证);sales_daily 逐月差与校正批恒等;revenue 前后不变;结算面 zf 前后=待回款 244→94(清理后当日 1 笔恰回款落账→93)/僵尸 600→598/异常 750→600(同笔→599)/移除单桶 156(回填前快照 150 待回款+异常 / 2 待回款+僵尸 / 3 已取消 / 1 其他);cleaned 层复算三品牌四桶(fg/onno 零变化=证据边界生效);verify_finance 80/80(含移除单 tab/KPI/口径注/badge 端到端 4 断言)数值真源 reg:id50(exclude/keep/影子单签名/历史校正/供血层全量入注册表;消费端=sync_source 清洗谓词,无 REST 内联)生效
AC-CAL-28Amazon 退款月表口径与国家码单源
(净额公式 2026-10-14 FIN-03;国家码单源+补臂修键 2026-11-01 AC-PEND-02 批二a,等价双证 B1/B2)
月表 audit.cleaned_amazon_refund_monthly=(brand,sku,mon,country) 键;净额=principal+tax+shipping_charge+total_fees(本币带符号,退款流出为负,逐行精确);USD=net_refund/当日汇率逐日折算;窗口 posted_date≥2025-01-01。country=core.AMZ_MP_TO_CC 单源派生(GB 词表 19 市场,码对齐 amazon_orders.country——co.uk→GB 非 UK 面)——批二a 前退款 13 臂/财务 SKU 日面 8 臂+LIKE 泛化两份内联 CASE 并存=漂移面,本批收口单源(消费端 sync_source._REFUND_BRANCH/_MP_TO_CC 均派生,禁再写第二份)。补臂 CA/AU/IE:实测 2025+ 退款源 776+650+13 行裸名(country 落地 'Amazon.ca' 等,违 FIN-03 码对齐既定口径);一次性修键 863 行(裸名→码,金额零变、无键冲突——表内无 CA/AU/IE 码行);未登记名 coalesce 透传不虚构(空名 23 行/预归一 JP 1 行原样保留)。等价双证:B1 旧13臂 vs 新单源差异恰=CA/AU/IE 三市场、B2 财务 SKU 面全域 0 差。数值真源 reg:id51(消费端=sync_source._REFUND_BRANCH 物化+_MP_TO_CC 财务日面,同派生 core.AMZ_MP_TO_CC)生效
AC-CAL-29专表费用面国别标签完整性与正副本账勾稽
(2026-11-08 用户拍板「这些问题都要写到 audit_base 和 audit 里面。同时正本帐和副本帐要拉起」,audit.html 9.163~9.166)
正本/副本边界(单源):正本=finances 财务面(国家从事件 MarketplaceName 经 MP_NAME 单源派生,未知名→NULL 不虚构,amz_finances_core P2 2026-10-29)——每平台/每国家/每 SKU 利润成本对账一律用正本;副本={schema}_spapi_service_fees 专表面——下游仅限仓储费对账门+费用摊分(摊分只取 fee_month 非空行),禁止任何国别/SKU 利润面直接消费副本。fg 副本 region=逐国码(storage_fees_core 2026-11-04 头注既有约定,US|CAD/GB|EUR 组式标签=违规);zf 副本=池标签 US/EU(DE)/JP/SA/AE(各表约定不得互串)。池化费豁免:FBAStorageFee/FBALongTermStorageFee 欧洲池账户级收费天生无单一国(fg 无单号池化行计数披露不红;EU 池标签方案待拍板)。结构验名四核(执法=storage_fee_recon 结构核,2026-11-08 起):①空 region 非池化行>0 红(订单级费必须有国)②region∉本品牌市场集(finances 国家集∪报表面 region 单源)红③同费型同单同日同额重复组>50 红(同面/跨流双写侦测)④正副本勾稽:副本全费型月总额 vs 结算明细面 ServiceFee 月总额(同源两本,±1% 且 >5 才红;结算明细 ServiceFee 行 posted_date 全 NULL 以 settlement_end 归月)。历史债(本条生效时在册,修复后随册换状态):fg 空 region 非池化 6,356 行+同键重复 8,044 组(跨流双写嫌疑,去重待拍板);onno 专表断流——已收口(2026-11-08 用户令「onno 清」truncate 重建 48 行 2026-05→2026-11,币↔国一致+VineFee 入库;当时压出的三伴债亦已 9.171 全收口:核② MX/BR/CA 行=统一账号订阅计费(用户拍板非在售市场,币国一致放行)、报表⊗专表 AU GST 0.10 入 strip+SA 2026-09 缺月豁免、核④ 重造 v2 逐币累计勾稽——onno AED/SAR 双平,USD/MXN 待周一结算链吸,AUD 79.81 真缺收挂账);zf 结算明细面历史覆盖不全(专表 ~4,000/月 vs 明细 200~400/月,回填欠账);周一旁路写入者待 11-09 结算链回潮观察锁定。【2026-11-09 拍板「不要求平,要求对齐,不平给出理由就可以」】:核④/报表段差额在 id27 gap_reasons/report_residuals 备案册(brand×币/区×月→理由+证据指针)者 WARN 放行、未备案者 FAIL——对齐=可比切片内平+切片外逐条备案,禁硬磨平(磨平=发明数字)。storage_fee_recon 结构核四项每夜执法(宿主 cd saas && python3 tools/storage_fee_recon.py;夜跑 four_gates_nightly 第7道);2026-11-08 手术档案=备份表×2(service_fees_dirty_retag_backup_20261108/service_fees_emptyregion_backup_20261108)+对照表 service_fees_region_resolution_20261108,61,494 行归位前后分布可复算数值真源 reg:id60(结构核四检查+正副本边界+池化豁免入注册表; id59 为失败尝试烧号空号)生效·历史债挂账
AC-CAL-30ServiceFee 专表国别标签口径(货币定标)
(2026-11-08 用户拍板「EU和GB不是一个东西,EU是欧洲,GB是英国」;onno 首采实证 audit.html 9.170)
新采面(onno/fg 2026-11-08 起):每 token 区池拉一次(NA/EU/AU 三拉,禁逐市场拉——ServiceFeeEventList 账户级返回、MarketplaceId 过滤不生效,逐市场=同费换标 N 国重复入库);region=按费用自带货币定国标,general_service_fees.CUR2CC 单源(USD→US/MXN→MX/CAD→CA/BRL→BR/GBP→GB/AUD→AU/SAR→SA/AED→AE/SEK→SE/PLN→PL),EUR 欧元共币不可分国→EU(欧洲),未知币兜底池名;壳禁持映射副本(label_by_currency 共用)。zf 存量池标签已按本条迁移统一(9.174:订单国47+币国860+EUR→EU 1226)。【行级国别第三读(2026-11-09 9.187 用户怒斥后定谳):批是打款池物理事实、行才是归属单元——任何「批级标签当行国别」的设计(含旧主键 country NOT NULL)都是结构级违规;费用分项面=币定国/订单定国/无据 NULL 不虚构】。【量感摄入键约定(2026-11-09 9.188/9.189):同键(批,单,型,日,额,币)第 N 笔真费记 fee_seq=N(fg)/指纹#N后缀(zf/onno)——同单同额×N 件不得被唯一键吞 N-1】。已知债:fg 存量旧写入真国标(ES/FR/DE/IT/NL/BE/IE)与 EUR→EU 混排+14,345 空 region+1970-01 垃圾月→清理案挂账;onno 面已清重建(2026-11-08 用户令「onno 清」,48 行全窗 2026-05→2026-11,废案备份 onno_amazon_spapi_service_fees_bak_20261108)。general_service_fees.label_by_currency 落库前执法(label_fn 钩子;不传=zf 行为不变);采集器 onno-service-fees/fg-service-fees night 39/52 分档,首采档案 9.170数值真源 reg:id61生效·fg 混排债挂账

§2 财务功能(AC-FIN)

ID对象验收标准验证方法状态
AC-FIN-01财务总览 /api/finance/summary响应含 net_basis 字段且与 AC-CAL-01 定义逐字一致(口径说明与代码同步演化);months 12 个月 + brands 各品牌最新月 + top/loss SKU×5;refund/ad/service_fee 缺省 None 有值才出现。接口字段比对 + caliber_recon 全绿生效 reg:—
AC-FIN-02净利率红旗连续月净利率 >50% 自动视为口径嫌疑(8月 onno +59%/69% 教训),须人工复核口径而非发布。常设门=AC-GATE-09 FIN-02(阈值派生 id34 禁再发明,2026-11-15 起);豁免册={fittingirls,onno,zipforce}——三品牌口径定谳 AC-CAL-35(回款净额率,50%+ 属常见区间)复核通过(2026-11-15 拍板「豁免」),豁免册外新红旗仍 FAIL生效 reg:id34
AC-FIN-03月度财务 /api/finance/monthly读 fm 三方对账口径(AC-CAL-07),不随总览口径改动;两口径差值经 caliber_recon 在案。caliber_recon B 组生效 reg:—
AC-FIN-04SKU P&L ad 列Amazon=双源并集;Noon=归集层(AC-CAL-03 同源);9–10 月不得恒 0(agg_shadow 回归的教训,10-05 已修)。P&L 页 9–10 月 ad 列非全 0生效 reg:id25
AC-FIN-05服务费链路mars 月账 → worker 摄取 amazon_service_fees(fxd 折 USD,负数)→ staging(RLS)→ audit.cleaned_amazon_service_fees;onno fee_month 全空=零行为已知事实(披露非缺陷);fg fm 侧无 svc 摊分=fm 口径披露项。ingest 行数>0;cleaned 值与 mars 独立复算相等(zf 2026-09=−362.28;建条时点旧值 −728.73 2026-11-15 复核修正修注,常设门 FIN-05 锚=−362.28)生效 reg:—

§3 广告功能(AC-ADS)

ID对象验收标准验证方法状态
AC-ADS-01广告深度分析 /api/ads/analysis平台汇总分列(totals_amz/totals_noon 不混算);ACOS 阈值单源;时间窗北京锚(noon 用 SA 时区锚);from/to 精确窗优先,days 滚动窗兜底。端点 totals_amz+totals_noon 分列值复算;对账门生效 reg:id2,16,35
AC-ADS-02广告清洗层停更报警Amazon 侧 audit.cleaned_ads_sku_daily ∪ audit.cleaned_amazon_ads_daily(finance 报表 ads CTE 同源直读)逐活跃企业任一品牌 max(day) 距今 > stale_days(数值真源 reg:id28,现值 7 天,批A 2026-10-25 注册)→ ads_staleness_alarm 品牌信箱告警+数据回补自动消警。阈值消费端 api/tasks.py ads_staleness_alarm 派生 id28(表不可达回退冻结锚 7),禁内联字面量。
2026-10-25 批A 改写收敛:原文「Noon 表+26h/11d」系 P1-2 设计稿口径,as-built 自始为 Amazon 两表+7 天(第二份口径即缺陷);onno Amazon 人工 CSV 断供(SKU 层停 11d/campaign 层停 26d 历史实证)改由晨检第 6 面完整性序列覆盖,不走本告警。
alarm 任务日志;stale 天数 SQL;注册表 id28 filters.stale_days=代码派生值逐位相等生效
AC-ADS-03导入面 ads_imports创建即拒链:平台→品牌→模式→active→扩展名/大小/预览,全部 400 带原因;无"入库后 doomed job"模式(P2-17 由 P2-2 关闭)。ads_imports 历史无 doomed 行;创建链 curl 400 复测生效 reg:—
AC-ADS-04广告规则引擎调参层(分层真源)分层真源(2026-10-25 拍板「做」):metric_calibers=口径层(定义/公式/基准),ads_rule_config=调参层(只存 per-brand 覆盖,全局行=基准;新键须先迁移入 id36 键目录);BID_CALC 基准=id26 defaults(advisor._BID_DEF 派生+冻结锚回退);视图谓词=建迁移烘焙(改册必须新迁移重建,R7 恒等执法)ruler_recon R5 契约 19/R7 视图烘焙恒等/R8 键目录+BID 基准+镜像恒等生效 reg:id36

§4 看板 / KPI(AC-KPI)

ID对象验收标准验证方法状态
AC-KPI-01KPI 卡池每卡 desc 必含口径一句话;脚注必标分母/分子构成(如"取消÷全量订单");orders30 脚注含全量数;aov/cps 标"÷有效订单"。kpi-cards 响应 desc/foot 字段全量断言(dashboard_audit)生效 reg:—
AC-KPI-02今日页对账cur.orders = DB 同日计数(企业账号轴 seller_owner 过滤);day=订单最大日。five_layer_audit 今日页对账(每企业)生效 reg:—
AC-KPI-03merged-kpi 双模rolling 与 calendar 两模式禁混标;切换即整体换基准。双模式响应基准字段断言生效 reg:—

§5 数据管道与清洗(AC-PIPE)

ID对象验收标准验证方法状态
AC-PIPE-01清洗层三去重case_twin(大小写孪生,小写变体优先)/ agg_shadow('all' 聚合行遮蔽同组)/ product_covers(product 真值遮蔽 sp 残留)——三规则语义见 clean_audit 注释,验收恒等式:任一 (brand,country,day) 组:Σ(ads_daily 入层行) + Σ(被遮蔽行) = Σ(staging 同组行)(无丢无重)。抽样组 SQL 恒等式复算生效 reg:—
AC-PIPE-02原子交换每表单事务 commit 时 swap;失败整表挂(旧层保持可用);keepa_product_raw 类大表退出 swap 直写。clean run 日志 + 中断注入复盘生效 reg:—
AC-PIPE-03RLS 三件套每张 cleaned 表:表 + brand_isolation policy(tenant_brands + app.brand_scope)+ portal_app grant,brand:true 配置缺一即隔离缺口(2026-10-21 amazon_service_fees 首建漏 brand:true 被自查抓获的教训)。【2026-11-15 拍板「补policy」迁移 182:共享面 14 张(字典/审计元数据/keepa 池/webhook 日志等零企业品牌维列表)=ENABLE+shared_read(FOR SELECT USING(true))显式化,访问面零变化,豁免册清零】DDL 审计 SQL:policy 数=1、grant 在(AC-GATE-09 PIPE-03 常设:全 144 表恰 1 policy,shared_read 型 cmd=SELECT)生效 reg:—
AC-PIPE-04staging 最细键noon_ads_daily_finest_uk 9 列与 cleaned 唯一索引同构(brand,report_date,country,ad_type,campaign_name,sku,offer_code,id_target,target_value,NULL 键 coalesce 归一)。两索引 DDL 比对生效 reg:—
AC-PIPE-05动态规格注册表品牌分支由 brands_source.source_map 注册表生成;新品牌接入=注册表加行,禁代码字面量(onno 字面量仅 DB 未就绪兜底初值);f-string 模板内正则量词必须双写 {{n}}(2026-10-21 svc 分支 {4} 冲突 Format 占位实证)。模板单测 format() 成功;grep 新字面量分支生效 reg:—
AC-PIPE-06docker exec heredoc凡 docker exec 送 SQL 必带 -i——不带时静默空跑且退出码 0(两次实证),DDL 后必须 to_regclass 回验。操作规程(AGENTS.md 同条)生效 reg:—

§6 权限与隔离(AC-SEC)

本节兼为全册铁律登记处(2026-10-25 用户令「铁律也要放到 audit-base,它是尺子」):用户亲定/成文铁律全集在册=AC-SEC-07~17(07 横向一致/08~11 隔离四条/12 五维五段+ABA 豁免/13 AI 边界/14 上线前审计核心铁律/15 库存账户归属/16 第一铁律·企业隔离无条件最高优先/17 sku_mapping 属性唯一真源与四层结构);新铁律立规即入尺——未决子项以行内挂账 pill 承载,不等闭合。

ID对象验收标准验证方法状态
AC-SEC-01数据浏览器表浏览三端点(列表/结构/行):_BLOCKED_TABLES 精确集 ∪ bak_ 前缀模式双拦(运维备份表免列名);表名标识符白名单 ^[A-Za-z_][A-Za-z0-9_]{0,62}$ 先于一切 f-string 内插;_require_admin。bak_* 表三端点 403/不出现;带引号表名 400生效 reg:—
AC-SEC-02源库数据字典只回本企业账号 schema + shared/public/sourcing;他企业品牌名经 foreign_brand_names strpos 排除(含 public/shared 内嵌他企业对象)。跨企业表名检索零结果生效 reg:—
AC-SEC-03上传面扩展名白名单 14 类 + 50MB 上限 + uuid 文件名 + 存储路径仅取自 DB 行(防穿越);raw 读取=会话+模块+RLS 三重。非法类型/超限 400;路径穿越 payload 404生效 reg:id33
AC-SEC-04端点快照API 端点 202 个入库快照,增删即 FAIL(部署后 --refresh-snapshot 重建)。audit_nodes ALL PASS生效 reg:—
AC-SEC-05停用企业断流企业停用→采集/摄取/清洗各面即断(P1-9 修复后行为)。停用企业数据 fresh 断言生效 reg:—
AC-SEC-06特权通道saas_admin 特权调用统一强制层过滤(P1-3),手写过滤仅存量、新调用走强制层。强制层单测 + 抽查调用点生效 reg:—
AC-SEC-07同平台横向结构强制一致
(铁律,2026-10-25 用户原话「这是铁律。是为了 saas 的一致性」)
同一平台上,全部已注册该平台的企业横向结构必须恒等——表集、列构、web 页面结构三面一致(Amazon/Noon 两平台,三企业×两平台=6 组合,未注册组合除外)。唯一豁免=企业未注册该平台:未注册=整个平台面不存在、不参与比较(如 fg 无 noon——平台级不渲染即合规形态,见 AC-EL-TODAY-003 注册表驱动)。只要注册,结构就要一样,数据面差异不豁免结构:无 API 通道的走替代通道保持数据一致(如 onno Amazon 无 Ads API → 上传 ads report 入库);数据断供时报错提醒(告警面),禁隐藏、降级或静默。web 强制一致:注册平台内禁止按企业数据有无做结构分支,空态按拉齐铁律显「暂无数据」不隐藏结构。执法面=ruler_recon R10(列签名恒等+实体集差异豁免册):实体级豁免(缺表/缺列)仅为镜像建表落地前的过渡态,清零为终态;平台级「未注册不比」留域判定。历史缺表豁免拍板(如 ADEF-C onno Ads 暂停)自本条生效起在结构面被取代。ruler_recon R10 三企业×两平台签名恒等 PASS;豁免册实体级条目清零(终态);替代通道断供→告警在册(ads_staleness_alarm 形态);web 注册平台页结构三企业同构(空态不隐藏结构)生效 reg:—
AC-SEC-08铁律1·绝对独立(唯一属主)
(用户 2026-10-17 原话「企业/品牌/国家/SKU 绝对独立」,2026-10-19 升格含平台维「企业/平台/品牌/国家/SKU 绝对隔离,第一优先级」)
品牌全局唯一属主:UNIQUE(brand) 物理约束+品牌向导撞名 409+注册加固三层缺一即缺陷;一个品牌只属于一个企业,撞名在物理层不可能。平台维度入隔离维后=已注册组合物理分 schema(3 企业×2 平台=5 组合:zipforce_amazon / zipforce_noon / onno_amazon / onno_noon / fittingirls_amazon)。撞名建品牌断言 409;UNIQUE(brand) 约束在库实测;业务 schema 集=已注册平台组合恒等生效 reg:—
AC-SEC-09铁律2·直营/代理区分
(用户原话「直营和代理的区分也是铁律」)
seller_owner / sku_mapping.mode / brands_source.consign_schema 三级登记直营与代理;代卖收入归并属主且属主可见(如 onno 经 zf 账号代卖的订单归 onno);账号(渠道)不越权看品牌(zf 账号永远看不到 onno 品牌行)。品牌归因唯一实现=AC-CAL-11 三路纠正。(范围澄清 2026-10-27:本条归并口径仅限收入/订单面;库存面归属=AC-SEC-15 库存账户归属)代卖行属主归并复算(AC-CAL-11 口径);跨账号品牌可见性=零(RLS+品牌域断言)生效 reg:—
AC-SEC-10铁律3·级联/隔离/自动生成(全部企业含新企业)
(用户原话「所有企业包括新企业都要满足级联/隔离/自动生成」)
新企业/新品牌/新 noon/新 SKU 四触发器自动生成档位与可见性(brand_onboarding_flow 7/7 零残留);新企业入册即满足全部隔离面,不存在「先上线后补隔离」。级联纯净度双向零:既无孤儿(子行无主)也无正向缺口(主行缺子行),R9 执法。brand_onboarding_flow 7/7;ruler_recon R9 孤儿/正向缺口双 0生效 reg:—
AC-SEC-11铁律4·不可误删
(用户原话「不可误删」)
触发器/RLS 策略/双约束等隔离结构不许误伤;可删的仅可见性镜像与死行,且删除前必须结构盘点在档。品牌删除只走三段式引用计数级联(AC-EL-TEAM-030),禁裸全局按 brand DELETE(曾险波及他企业同名品牌)。删除类操作仅级联路径且审计留痕;结构盘点在档;级联后他企业同名品牌毫发无损生效 reg:—
AC-SEC-12隔离五维×五段全链+唯一豁免 ABA
(2026-10-19 用户亲定补充口径)
①五维隔离(企业/平台/品牌/国家/SKU)第一优先级;②数据流五段(①源凭证→②采集→③落库清洗→④服务→⑤呈现)段段硬边界——各企业自有凭证/按企业采集+账号→企业映射/物理分 schema+清洗品牌归因/RLS 强制/子域名即企业边界,不存在「哪段只是兜底」;③唯一豁免=ABA 公共语料(一份 LWA 凭证、全局一份、企业无差别,属市场公共数据,不适用铁律1;末端扇出 aba_radar_* 后即入隔离管辖)。RLS 三件套全 cleaned 表(AC-PIPE-03);凭据/采集/schema/RLS/子域名五段逐段隔离抽查;ABA 单凭证+扇出面企业隔离实测生效 reg:—
AC-SEC-13AI 边界(指定 AI 面外全代码执行)
(铁律,2026-10-26 用户原话「指定ai,按照指定操作,没有指定ai的,全是代码执行。这也是铁律」)
只有效果上明确指定为 AI 的功能允许调用 LLM,且行为按用户指定的操作执行——指定 AI 面=ai.py 族(数据问答/选品建议/广告文案/广告优化)+三页浮窗+listing 规格书 AI 兜底(_ai_kv_extract,响应带 ai_added 标记;2026-10-26 用户拍板「算指定 AI 面」)。其余一切功能 100% 纯代码执行——数据/计算/采集/对账/建议/告警禁止任何 LLM 参与,不存在「暗中调 LLM 补数据/做判断」的路径。模型生成内容不得当事实源(起因=Keepa 域表误定 AU/NL 教训:探测推理与搜索返回的编造内容皆不可为据,产品运行时确定性全靠代码×登记数据源)。LLM 调用点盘点与指定 AI 面清单逐一对应(新增 LLM 调用点必须先扩指定面清单再落码,未入清单=违规);非指定面代码静态扫描零 LLM 引用;listing AI 兜底响应 ai_added 标记与实际 LLM 采纳一致生效 reg:—
AC-SEC-14铁律·上线前审计核心铁律(8 条)
(《上线前全量审计与测试规范》20 节文档头部核心铁律原文;Step 1–16 方法尺=AC-AUD-01~16、上线需求尺=AC-REQ-01~26,本条=铁律层总纲)
①只审计,不修改——只输出问题/证据/风险等级/影响范围/核验依据,不生成修复代码不直接变更(→AC-AUD-01);②先测绘,再校验——不预设容器/页面/指标/任务数量,先测绘真实架构再执行校验(→AC-AUD-06);③全页面、全元素、全维度组合——遍历非抽查(→AC-AUD-06/07);④横向一致性——相同指标/时间/维度定义下,不同企业/平台/品牌/销售模式/国家/SKU 计算逻辑必须一致(业务数值可不同,公式与聚合规则必须一样)(→AC-AUD-03+AC-SEC-07);⑤纵向业务流核验——业务流/数据流自上而下单向流转,不允许逆向推导或越界访问(→AC-AUD-02/09+AC-REQ-14);⑥强隔离——企业/平台/品牌/销售模式/国家/SKU 六维任意组合正确切分,不出现跨维泄漏或错误聚合(→AC-AUD-03+AC-SEC-08~12+AC-REQ-02~08);⑦单一指标事实源——所有指标/公式/图表/表格/导出/结算/回溯/REST API 由指标注册表驱动,业务公式禁散落接口/前端/定时任务(→AC-AUD-08/10+AC-REQ-09);⑧全链路可追溯——TraceID/RequestID 生成后全程透传,前端/API/内部服务/异步队列/定时任务/日志/DB 记录全部可串联检索(→AC-AUD-04+AC-REQ-22)。审计任务产出对照 AC-AUD-16 八件套+本条 8 项逐项勾稽;as-built 差距挂账面(AC-REQ-18 日志维度五列/AC-REQ-24 formula_version 列)修复后随册换状态生效 reg:—
AC-SEC-15铁律·库存账户归属
(2026-10-27 用户原话「所有库存都是属于企业的」「不仅仅 onno,是所有的企业,所有的代码都要按照这个逻辑……不是针对某个企业改」)
库存行的 brand=持有该卖家账号的企业(账户级归属),所有企业×所有平台×所有代码路径通用;品牌归集(brand_fix/AC-CAL-11 三路纠正)范围=仅收入/订单面,库存面一律禁用。代卖对(如 onno 经 zf 账号代卖)的库存行留在账号属主(zf)名下——zf 企业可见自账号全部库存行(含代卖货),onno 企业只见自己账号的库存。(可见性裁定 2026-10-27 第一铁律/AC-SEC-16:归属≠可见——代卖货 SKU 若系仅外域注册,企业面按 AC-SEC-16 对双方均不可见,仅管理面/门禁信息位可见;归属口径不变)实现三面:①sync 属主字面量(视图分支记(属主品牌,视图名)对盖字面量,废 SELECT m.brand 映射盖品牌;fba 分支本就 '{b}' 字面量)②clean 层库存面零 brand_fix(api/clean_audit.py+tools/audit_clean_all.py 双文件)③过渡幽灵按 synced_at 一次性清扫(零企业名)。附带收口:旧口径下 zf 账号分支与 onno 自有分支可写同一中央键 (onno,SKU,UK) 两账号数量互相覆盖,账户归属后键天然分离。R13 门禁双面:代码面=库存面(inventory_health/noon_inventory/amazon_inventory_aging/noon_sku_unsaleable/noon_sku_status)spec 内 brand_fix 出现即 FAIL(双文件);数据面=代卖对见证集(现网唯一对 zf→onno:cleaned_inventory_health 中 onno×非 onno 账号市场行=0 且 zipforce×代卖 SKU 行>0)+三企业页面实测生效 reg:id41
AC-SEC-16第一铁律·企业隔离无条件最高优先
(2026-10-27 用户原话「企业是最高优先级,不管什么情况企业之间的数据都是隔离且不可见的,即使品牌一样,sku 一样,产品名称一样,产品型号一样,也是不可见的。这是第一铁律」)
①企业维度为全部铁律中的最高优先级——与其他任何规则(含 AC-SEC-15 库存账户归属的可见性推论)冲突时,跨企业不可见性一律胜出;②不可见性无条件——品牌相同/SKU 相同/产品名称相同/产品型号相同,任何「同物」事实都不构成跨企业可见理由,不存在按内容相似度开可见性的路径;③裁定 9.81⑦(代卖库存可见性三选一):维持现状=注册表 SKU 保密条款(迁移 101 registry_sku_visibility,仅外域注册 SKU 集合)胜出——代卖库存行(账号属主 zf 名下 10 行)在企业面对双方均不可见,仅管理面/门禁信息位可见;SKU 双登记开可见(P2-32 口径维持=双企业重复登记为异常)与 consign_schema 可见性豁免两案否决;④归属≠可见:AC-SEC-15 定的是行的属主(brand 列),本条定的是企业眼里的可见集,两层正交叠加;⑤as-built 执法现状即本条语义=RLS 双层(brand∈tenant_brands × registry_sku_visibility 仅外域注册 SKU 挡),本裁定零代码改动。三企业 RLS 模拟(portal_app+app.tenant_id)跨企业行=0;代卖 SKU(ON*)在 zf 企业视图=0 且 onno 企业视图=0(9.81⑤⑥ 已实测在案);R13 的 zf 代卖行恒为信息位不入违约生效 reg:—(id41 filters.visibility_first_iron_rule 裁记·迁移 159)
AC-SEC-17铁律·sku_mapping 属性唯一真源与四层结构
(2026-11-10 用户三令「隔离最高优先级 企业,第二优先级品牌,第三优先级国家,第四优先级 sku,品牌下面分为直营和代理,所有的 sku 都是基于 sku_mapping 表格来分配属性」「一个企业下面可以多个品牌。所有页面都要执行这个需求,代码都要围绕这个规则写」)
①四层结构=企业>品牌>国家>SKU——全部页面/接口/看板/导出按此层级切分与下钻,一企业可挂多品牌;②SKU 属性唯一分配源=sku_mapping——品牌、国家、直营/代理(mode='Distribute'→代理,否则直营)一律由 (seller_owner, sku/asin)→sku_mapping 行分配;展示面有效品牌=coalesce(nullif(mj.brand,''), 行.brand) 的 sku_mapping LATERAL(reg:id63 v1·9.224 定稿:排名/评分面键=asin、库存/报表面键=sku),数据行 brand 列不动(展示口径与数据行正交);禁逆向(拿数据行 brand 反推属性当真源)、禁旁路(sku_mapping 之外硬编码品牌/国家/模式分配);③无 sku/nsku 键的采集表归属=auto_seller_owner 触发器 (asin,market)→sku_mapping country 解析(9.225 注册:精确国>EU 伞 GB/UK/DE/FR/IT/ES #145 口径,EU→zipforce_amazon 代卖、US→onno_amazon 直营,带 sku/nsku 的表行为零变化);④与本册既有条正交叠加:行可见性=AC-SEC-16(第一铁律仍最高)、库存账户归属=AC-SEC-15、收入/订单面归集=AC-CAL-11+AC-SEC-09;⑤所有页面执行:品牌档选到代卖品牌(如 zf 企业×onno)时各面应见 sku_mapping country 覆盖站点的数据,未覆盖面按拉齐铁律显「暂无数据」不隐藏结构。本条起因=9.224 修 dashboard.py LATERAL 恒真式(同企业任意 mapping 行误配品牌致 markets 空面)后用户追问「之前审计很多次,为什么没有发现」——根因=尺子缺条目:mapping 铁律从未入 AC 册,审计无此验收项可 FAIL;本条即补尺(扩墙同批补册 reg:id63)。①展示面有效品牌复算:全部 LATERAL 位点(dashboard.py _rmj/_imj/_eb·reports.py _ebr/_ebi·listing.py·brandboard.py·inventory_po.py·ai.py·mcp.py)SQL 复算与页面口径一致+代码 grep 无 sku_mapping 之外的属性分配源;②页面探针:zf 企业 brand=onno 各面国家域=sku_mapping country 域(9.224 LIVE 9 项在案:markets 6 国/history/rating-review 129 直营+92 代理/alerts 7+16=23 精确切分/reports stock+rank/listing 5 SKU/跨企业探针 0;9.225 终验:zf×onno markets EU 五站 latest=2026-11-10·GB list 5 行全代理·onno 企业 US 4 行全直营且 EU 退场·zf zipforce 回归不变·触发器活函数实弹 ROLLBACK 模拟 DE/GB→zipforce_amazon·US→onno_amazon);③三企业 RLS 回归跨企业=0生效 reg:id63
AC-SEC-18平台运营后台·跨企业管理面
(2026-11-14 用户整套批「干」上线 #117,同日批登记;此前跨企业管理面不存在·五路证据在案)
①门=独立子域 ops.zipforcehub.com+文件密钥:secrets/ops_console_key(constant-time 比对、未配置/不可读=fail closed 恒拒〔时序对哑串归一〕、登录限速 10 次/600s、失败也落审计);不入 users 表平台角色——密钥文件即身份,会话=伪企业 slug="ops"/uid=0 复用 core 会话件(_tk 签名+Redis sess:* 可吊销 fail closed);②会话 cookie zf_saas_ops host-only 仅落 ops 子域,与企业登录零共享(企业账号被盗拿不到平台钥匙);③暴露面三层收窄:端点硬校验 Host=ops.zipforcehub.com(其余宿主一律 404 不暴露存在)+Caddy apex/企业通配块 @opsblock /ops 404 双保险+独立 origin 显式站点块(不走 on_demand、/mcp 不暴露);④跨企业读唯一通道=_admin_conn 显式管理连接(RLS 表池连接无企业上下文恒空,同 auth._pending_tenant_for 先例);⑤写操作唯一=激活 pending_verification(UPDATE 带原状态条件防竞态),暂停/恢复/改 plan 未批前=禁区;⑥平台动作全量落 audit_log(user_id=NULL·tenant_id=被操作企业);⑦付款状态=tenants.plan 原值直读+subscriptions/billing_events 佐证列,禁推导(AC-CAL-17 同精神;Stripe 未通电挂徽标)。线上矩阵 7/7(#117⑤在案:apex/企业子域 /ops=404·ops 根 308→/ops·无 cookie API=401·错钥=403·真钥全链 200→总览三企业→退出→401·跨 Host 打 API=404)+audit_log ops.* 行复核;复跑=curl 矩阵+audit_log 只读查询;三层登记=§12 接口册 4 行+AC-EL-OPS-G01+endpoint_registry 4 行(2026-11-14, 照 9.102 P3-2);密钥文件权限=坑 28(644 惯例)生效 reg:—(changelog #117)

§7 对账与门禁(AC-GATE)

ID对象验收标准验证方法状态
AC-GATE-01caliber_recon 跨层对账近 3 完整月+当月,每企业品牌域内:同口径(订单层净利)独立复算 vs API |Δ|≤$1(FAIL);fm/回款差口径 WARN 带标签;企业域=tenant_brands(禁 admin 全品牌假 FAIL)。首跑 v1:12/12 PASS Δ=+0.00。python3 tools/caliber_recon.py 退出码 0;日志 logs/gate-caliber-*.log生效 reg:—
AC-GATE-02四道门禁deploy_gate 六门 + dashboard_audit(178+) + chart_value(81图) + audit_nodes(202端点);门禁不接管道、日志留档 logs/gate-*;数字相关代码改动后必跑。门禁日志文件存在且 PASS生效 reg:—
AC-GATE-03五层审计rawdata→cleandata→regression→api→web 每日 06:35 全代码零 LLM;他企业品牌名逐条遮蔽/打码(R4b P3-8:regression 层自 P2a 批入库但展示面漏列,已补齐五层)。audit_results 最新批次 FAIL=0生效 reg:—
AC-GATE-04e2e 串行律frontend_e2e 与页面遍历禁并行(redis 共享限速桶 429 实证);four_layer L4 前排空等待 120s。调度检查(过程纪律)生效 reg:—
AC-GATE-05门禁夜跑 nightly(P1-13)crontab 19:10 UTC 顺次五门:pen_tests → dashboard_audit → frontend_e2e → audit_nodes → priv_channel_audit(P1-3 第5道);每门独立日志 logs/gate-run-nightly-*.log,汇总 logs/cron-audit/gate-nightly-latest.txt;任一 FAIL → monitor SMTP 告警;secrets/monitor_smtp_pass 未落位时打印降级说明并以退出码 1 兜底,禁假成功(2026-10-22 首跑实证)。cron 产物存在;首跑日志 gate-nightly-20261021-2348.log生效 reg:—
AC-GATE-06浏览器门禁跨会话互斥浏览器驱动任务(e2e / 页面遍历 / 元素探针)
跨会话互斥——开跑前互查其他会话是否有浏览器任务在跑(AC-GATE-04 串行律的跨会话扩展;2026-10-21 爬虫事故:审计线 element_test.py 误关三企业×9模块+49 写配置,21:50 pg_dump 全量恢复,档案=audit.html 10.4)。只读 SQL/API 型门禁不受此限。
过程纪律 + 事故档案(audit.html 10.4)生效 reg:—
AC-GATE-07门禁三企业覆盖(2026-10-23 立,round2 P2-28/P2-29 销项)企业隔离铁律的机器验证必须覆盖全部三企业(zipforce/onno/fittingirls),不许长期存在「某企业零自动门禁」。现状登记(2026-10-23 实测):pen_tests 三企业登录+跨企业令牌拒绝+RLS 品牌域(既有);chart_value_audit 无参遍历 secrets/audit_tenants/*.env 三企业(fittingirls.env 在册,:39 陈旧注记已更正);dashboard_audit 三件套C 新增——fg today 品牌域==[fittingirls] 非空/sku-matrix items 品牌域⊆{fittingirls}/noon 品牌看板优雅空态(empty=true, fg 无 noon 注册)+8.3 趋势求和=KPI 卡 fg 臂(30d trend ad_spend/revenue 双恒等, 实测 2425.76/32206.13 口径下成立)+8.4 Top15 子集 fg US 臂,检查数 192+→198+;frontend_e2e 第 21 节新增——fg 独立 context 登录+filters 品牌域⊆{fittingirls}+品牌看板双页(/dashboard/fittingirls 实数据 + /dashboard/noon/fittingirls 空态)无「请求失败」无 ≥400 API(ALL PASS 实证)。
残余缺口在册:audit_nodes.py BASAL 全部内嵌 tenant_id=1(40+ SQL 模板+快照机制整体三企业化=重构级,挂下批,其跨企业隔离由 pen_tests/dashboard_audit 兜住)
——2026-10-23 #62 交付残余缺口清零:audit_nodes.py 三企业化——凭据目录 secrets/audit_tenants/*.env 遍历+tenant_id 从 tenants 表查得+AB/NR/SO/promotion 基准 tid 参数化+空态双侧皆空规则(节点缺失且基准 0/NULL=通过)+NULL 吞没修复 3 处+finance months[0] 数据驱动月轴重锚;终验三企业 ALL PASS(zf 32/onno 31/fg 29+3 空,断言总量 32→92,节点面 3054→8794);迁移 109 endpoint_registry tenant_scope 202 行→all。至此四门禁全部三企业;pipe_audit 为 DB 层天然全品牌。门禁日志 tools/_gate_p228_*_20261023.log。
每门禁脚本 grep 企业凭据覆盖面;新企业入册时同批检查三件套探针是否需扩展生效 reg:—
AC-GATE-08选择器联动门(2026-11-15 立,用户令「添加」;#129 缺口直系防线)每页顶部选择器 state ↔ 该页全部数据 fetch 参数的对照为机械断言面:tools/audit_selector_linkage.py 三册——LINKS 32 行(页×文件×端点串×参数串共现断言,含 /ads #128 三维下推与工作台 CountryPnL #129 修复本体两腿)、EXEMPTS 13 行(拍板豁免卡在册登记:AlertsPanel 平台级·docstring 拍板 / MonthlyCompare 全景卡 / merged-kpi 模式卡 / 财务全年逐月图 / 库存结构卡·后端原值 / promotion summary·无品牌维 / aba overview·全局统计 / 评分展现型 AC-CAL-17 / noon reviews / logistics appendix / mapping edit·写通道——超集合规:日后给豁免卡加参数不违规)、NO_SELECTOR 29 页(静态/工具/管理/向导面逐页 grep 定性:listings=任务工具页·onboarding=向导表单·backfill/pipeline/settings=运维操作面等);分母强制:web/app 下每个 page.tsx 必须三册有其一,新页未登记=FAIL——新卡上线流程=过本门+扩表,props 漏传类静默缺口(#129 CountryPnL 教训:组件单独验收全绿而组合面漏)从此结构上不可漏。期望值硬编码永不自动更新(AC-AUD 硬编码断言令);纯源码 grep 不打 API 不占 gate_lock 浏览器互斥族(AC-GATE-06 该族限浏览器任务)。python3 tools/audit_selector_linkage.py → ALL PASS(LINKS 32/32 · EXEMPTS 13/13 · 43 页分母全覆盖);负例自测在案:临时撤 CountryPnL country 参数 → FAIL×2 精确指位两腿,还原 → ALL PASS生效 reg:—(changelog #130)
AC-GATE-09基线常设执法门(2026-11-15 立,用户令「干」;audit-base 触发式断言常设化批)audit-base 基线↔审计覆盖盘点(同日交付:常设自动执法/注册表对账/触发式/过程律令四类分型,结论=非每条基线都有常设审计)后用户拍板「干」:把验证列写着具体断言手法但无常设调度的基线收编为常设。tools/audit_baseline_gate.py 九组断言(期望值 2026-11-15 逐条实测锚定,硬编码永不自动更新):SEC-01 数据浏览器三端点(表列表无 bak_*/11 张敏感表·结构端点 403·引号非法表名 400)/SEC-02 源库字典 ISO-01(foncye 登录态搜他企业品牌名零结果,品牌名真源=foreign_brand_names 禁脚本自造)/SEC-03 上传白名单(.exe→400,白名单单源 id33 不重抄)/PIPE-03 RLS 三件套(audit schema 144 表·业务表 policy 恰 1 条·brand_isolation 三构件 tenant_brands+brand_scope+seller_owner·tenant_isolation 含 app_tenant_id·portal_app grant 144/144·14 张共享元数据/原始日志表豁免清单硬编码=现状登记,与 AC-PIPE-03 册面「每张 cleaned 表三件套」的偏差已上报待拍板,豁免册外新表无 policy=FAIL)/PIPE-04 索引同构(staging noon_ads_daily_finest_uk 与 cleaned bizuniq0 剥 COALESCE 后 9 列序列逐项相等)/FIN-01 summary 含 net_basis/FIN-02 净利率红旗(阈值从 metric_calibers id34 filters.flag_ratio 派生禁再发明——册子自认「无自动门…未来复盘门禁须派生本行」即本门;连续≥2 月超阈:豁免册内 WARN 存量披露、册外新红旗 FAIL;存量豁免册={fittingirls, onno} 2026-11-15 现状锚定待人工复核)/FIN-04 广告列恒 0 回归(amz SKU+noon 两视图 2026-09/10 非全 0,agg_shadow 教训月)/FIN-05 服务费链路锚(zf 2026-09 SUM=-362.28 行数=1 实测锚定;册面 -728.73 系建条时点值已过期,差异已上报)。不收面如实:SEC-05 停用断流(副作用)/SEC-06 强制层单测(CI 面)/PIPE-01 三去重恒等式+PIPE-05 模板 format(复刻清洗与模板逻辑=造二源,真源在 clean_audit 与 /opt/collection)/PIPE-02 中断注入(破坏性)/PIPE-06 规程(纪律)/AC-CAL 无 reg 条目(口径定义性质)。HTTP 登录复用 pen_tests.login;纯 API+只读 SQL 不占 gate_lock。python3 tools/audit_baseline_gate.py → 18/19 PASS + WARN×2(fittingirls/onno 存量红旗披露);FAIL×1=FIN-02b 新红旗 zipforce 2026-04/05 净利率 52.56%/50.01% 连续两月超阈——门首跑抓到的册外真红旗,如实红待用户拍板(复核确认口径→加豁免册转绿 / 判真问题→修数);负例自测在案:豁免册撤 cleaned_keepa_daily→PIPE-03b FAIL 精确指位、期望值漂移→FIN-05 FAIL 报实际值,还原→如初生效 reg:—(changelog #131)

§8 页面元素(AC-UI)

ID对象验收标准验证方法状态
AC-UI-01口径说明元素凡展示金额/比率/订单数的页面元素,同屏必带口径说明(脚注或 tooltip),且文案与 AC-CAL 条目一致——口径说明是 UI 的一部分,不是可选装饰。frontend_e2e 文案断言生效 reg:—
AC-UI-02NoonTab 品牌参数Noon 页签数据请求必带品牌 prop(硬编码死锁 P1-1 修复后)。e2e 请求参数断言生效 reg:—
AC-UI-03Settings 凭据面Settings 页凭据卡片必须渲染(字段齐全可保存)。tab 作用域:凭据列表只挂平台/服务商 tab,字段 tab 挂数据字典(ApiFieldsTab),大模型 tab 挂供应商卡(2026-10-21 #33 修复补述)。frontend_e2e 渲染断言(8b 随 tab 断言);2026-10-21 探针 PASS生效 reg:—
AC-UI-04768 宽布局首页 768px 视口无横向溢出。根因记录:5 列 KPI deck 卡内宽装不下换槽 select(108px 不可缩);≤980px 降 3 列,≤700px 降 2 列(2026-10-21 #33 修复补述)。e2e 视口断言;2026-10-21 探针 overflow=0px生效 reg:—
AC-UI-05frm/to 日期区间标注双闭区间语义([frm,to] 拼接重叠 1 天属设计)必须前端标注"含首尾";非法日期输入 400 带原因(P3-2 已修后端)。frm=2026-13-45 → 400;UI 标注存在(首页+订单页 2026-10-21 探针 PASS)生效 reg:—
AC-UI-06ASN 输入校验Noon 物流 ASN 输入非法字符拒绝并汇总 bad_asn 返回(^[A-Za-z0-9._:-]{1,64}$)。接口 payload 复测生效 reg:id32
AC-UI-07品牌色级联品牌展示色一律走 brandColor() 级联(TenantInfo.brand_colors 注册表注入 > BRAND_COLORS 兜底 > #667085),页面禁止散写品牌色三元/十六进制(P3-5:首页告警面板 fg 落灰 #999 修复后立此条)。grep 页面无品牌色硬编码残留;fg 色点 ≠ 灰生效 reg:—

§9 运维红线(AC-OPS)

ID对象验收标准验证方法状态
AC-OPS-01部署窗口部署避开 19–22 UTC、整/半点分钟、02:00 UTC 日档;先 tar 快照到 backups/ 再改代码。部署记录时间戳 + backups/ 文件生效 reg:—
AC-OPS-02部署顺序新增 staging/cleaned 表的版本:worker 先行(ingest+clean 完成且回验)→ api 后上;乱序=缺表 500(amazon_service_fees 部署序列实证)。部署序列记录 + 端点抽查生效 reg:—
AC-OPS-03回滚锚点每批次 VERSION + tag + slim tar + pg_dump;回滚按锚点不手改。锚点清单(P1-20 台账)生效 reg:—
AC-OPS-04git 纪律不经允许不 commit/不 push;门禁不接管道;secrets 只编程使用不打印值。过程纪律生效 reg:—
AC-OPS-05发布面audit.html 链接不变、描述只增不删(审计档案);changelog 子域不动;本页(audit-base.html)=最终标准,可直接改写收敛、不作历史层积(2026-10-24 用户裁定),ID 永不复用。diff 审查生效 reg:—
AC-OPS-06破坏性 SQLclassifier 阻塞的破坏性 SQL(如 mars X2 16G UPDATE)一律挂起用户决定,禁绕过;库外操作不入 audit_log 的历史窗口披露在案。pending-db-ops 台账生效 reg:—
AC-OPS-07异地备份保留mercury /opt/backups/saas 每系列保留最新 5 份(2026-10-24 用户拍板,数值真源 reg:id29,批A 2026-10-25 注册),当日/未来日期文件永不清;mars 本地 14 天主备份集不受影响。prune_offsite_backups.sh=外部脚本无 DB 直连:调整保留数须先改注册行 id29 再人工同步脚本(手动同步动作,勿反序)。prune_offsite_backups 04:40 UTC 日档执行;各系列 ls | wc -l = 5=id29 keep_per_series生效

§10 待用户拍板项(AC-PEND,禁自行决定)

ID事项挂起内容状态
AC-PEND-01六维规格偏差 + P2 六项(P2-7/15/19/22/25/27)已全部拍板处置(2026-10-24):六维=不落结构、tenant_accounts 账号桥即口径;财务按品牌分账=账户级费用按营收份额分摊(_SVC_BRANCH_CONSIGN);P2-7=共享单份目录维持、购买制授权挂二期、tenants 四权限各有合法用主零收权;P2-15=代理费用可拆走结算 sku 轴、账户级无轴类目维持专表并按销售额分摊;P2-19=DB 记录全链路已满足;P2-22=mercury 定名+备份推送零失败+探测白名单;P2-25=internal 三条 brand 参数路由 _check_brand_scope(非本企业品牌 403);P2-27=MCP 面 6 断言/企业入第四道门。分摊语义锚 reg:id31(批A 2026-10-25 注册):账户级服务费按销售额分品牌、一份基数=finances revenue_usd、无收入月全归宿主、尾差归宿主月总额逐分不变;单实现=api/sync_source.py _SVC_BRANCH_CONSIGN。生效
AC-PEND-02口径统一结构化方案(views 单实现 + metric_calibers 扩展全指标)本库为文本标准(人读);views/注册表方案=机器单实现(代码读),需用户排期后立项。。
2026-10-22 用户拍板「只找最优解=最根本解」:走 views 单实现——分期迁移,一期收编净利/广告费/订单数三口径(audit schema 视图族,PG16 security_invoker 保企业 RLS 铁律),消费端 api/门禁迁读视图、禁第二处口径 SQL;metric_calibers 注册表转「视图目录」拍板台账,本库文本与视图逐条对齐。回滚锚点 backups/code-20261022-views/(git HEAD 645bdab+脏路径 49+双库 schema+页面,2026-10-22 14:28 UTC)立案动因:口径说明分散各页是三轮审计口径漂移的结构根因。
生效 reg:—

§11 逐页元素标准全册(AC-EL,§11.1–§11.41 全量)

2026-10-25 迁回说明(用户澄清):本库=验收总尺子——所有公式/图型/表格列级标准必须在册,验收照此进行(用户原话要旨:「所有的公式,所有的chart,所有的表格这里面的公式都要写到这个里面去,以后验收的时候就照着这个验收」)。§11 全册 2026-10-24 曾迁往 audit.html,按本澄清迁回;audit.html #sec11 保留当日快照作档案不再更新。计数约定:§11 元素条目单独计数(本节清单表随建随更),顶层计数卡仍计 §1–§10。
v4 扩建纪律(2026-10-22 用户令:"每一页的所有元素的描述和定义都写清楚,全量,最细颗粒度"):每个页面每个可见元素(卡片 / 表格 / 列 / 图表 / 筛选 / 页签 / 按钮 / 弹层 / 脚注 / 色点 / 徽标 / 空态…)单列一条 AC-EL-<页>-<序号>。七列结构:ID / 元素(含 tab·区块位置)/ 类型 / 描述(是什么·给谁看)/ 定义(数据来源·口径·公式·边界·交互,口径直接引用 §1 AC-CAL 条目号)/ 验证方法 / 状态。条目一律从源码实证生成(web/app·web/components + 对应 API router 逐行核对),禁凭空撰写;页面出现而库中无条目的元素 = 验收缺口。状态流:待建 → 生效(条目落地并经一次验证)→ 变更时新增带日期新行不覆盖原句。§11 元素条目单独计数(下表"元素条目"列随建随更),顶层计数卡仍计 §1–§10。
路由页面(ID 前缀)源码规模元素条目状态
/首页看板 AC-EL-HOME(KPI deck/告警面板/图组/分市场)702 行176 条(结构 49 + 图 80+22 + SKU 表 25)已建 v4.1
/today今日页 AC-EL-TODAY459 行32 条(校对通过·全生效)已建 v4.5
/orders订单页 AC-EL-ORDER175 行26 条(校对通过·全生效)已建 v4.5
/finance财务页 AC-EL-FIN(总览/月度/SKU P&L)1858 行64 条(62 生效 / 2 待核);§11.27 列级 173 条(173 生效)v5.0已建 v5.0
/ads广告页 AC-EL-ADS(深度分析/日表/导入)2475 行169 条(168 生效 / 1 待深化)已建 v4.7
/sourcing选品页 AC-EL-SRC(explore/情报台 charts)2200 行82 条(82 生效);§11.28 六外部 tab 187 条(全生效)v5.0;§11.38/§11.39 图表墙逐图 153 条(148 生效 / 5 废止)v5.3已建 v5.2
/noonNoon 专页 AC-EL-NOON495 行42 条(42 生效)已建 v4.4
/logistics物流页 AC-EL-LOG(ASN)759 行51 条(50 生效 / 1 待核)已建 v5.1
/listingsListings 页 AC-EL-LST1162 行159 条(158 生效 / 1 未上线保留)已建 v5.1
/rankings排名页 AC-EL-RANK718 行84 条(84 生效)已建 v5.1
/products产品页 AC-EL-PRD299 行40 条(40 生效)已建 v5.1
/inventory库存页 AC-EL-INV278 行57 条(57 生效)已建 v5.1
/mapping映射表页 AC-EL-MAP317 行47 条(47 生效)已建 v5.1
/poPO 页 AC-EL-PO413 行76 条(76 生效)已建 v5.1
/projects项目页 AC-EL-PRJ709 行64 条(64 生效)已建 v5.1
/offsitepromotion站外促销页 AC-EL-OFF389 行§11.37 全页 65 条(65 生效)v5.1;§11.40 子组件列级 446 条(全生效)v5.4已建 v5.4
/settlement结算页 AC-EL-STL130 行43 条(全生效·校对通过)已建 v5.0
/settings设置页 AC-EL-SET(凭据/字段/大模型 tabs)236 行24 条(全生效·校对通过)已建 v5.0
/billing账单页 AC-EL-BIL205 行33 条(31 生效 / 2 待核·校对通过)已建 v5.0
/backfill回填页 AC-EL-BKF238 行31 条(全生效·校对通过)已建 v5.0
/database数据浏览器 AC-EL-DB183 行20 条(全生效·校对通过)已建 v5.0
/dictionary数据字典页 AC-EL-DIC145 行23 条(全生效·校对通过)已建 v5.0
/documents文档页 AC-EL-DOC140 行24 条(全生效·校对通过)已建 v5.0
/account账号页 AC-EL-ACC111 行44 条(全生效·校对通过)已建 v5.0
/team团队页 AC-EL-TEAM291 行17 条(全生效·校对通过)已建 v5.0
/aiAI 助手页 AC-EL-AI110 行48 条(47 生效 / 1 待核·校对通过)已建 v5.0
/pipeline管道页 AC-EL-PIPE334 行46 条(全生效·校对通过)已建 v5.0
/dashboard总览大盘 AC-EL-DASH(四层:异常带/业绩速览/域卡矩阵/大图带)~900 行§11.41 页级 28 条(023~026 批2 · 027 批3 · 028 批4 追加·2026-10-30)已建 v5.5
/dashboard/[brand]品牌看板 AC-EL-BRD(BrandBoard)39 行+组件22 条(全生效·校对通过)已建 v5.0
/dashboard/noon/[brand]Noon 品牌看板 AC-EL-BRDN(NoonBoard)39 行+组件31 条(全生效·校对通过)已建 v5.0
/onboarding入驻页 AC-EL-ONB310 行13 条(12 生效 / 1 待拍板·校对通过)已建 v5.0
/offboarding离场页 AC-EL-OFB80 行55 条(全生效·校对通过)已建 v5.0
/register ·/login ·/verify ·/welcome认证四页 AC-EL-AUTH388 行3 条(2 生效 / 1 待深化·校对通过)已建 v5.0
/promotion ·/upload跳转页 AC-EL-REDIR18 行42 条(全生效·校对通过)已建 v5.0
/en ·/training帮助两页 AC-EL-HLP238 行41 条(40 生效 / 1 待核=价格分歧坐实·校对通过)已建 v5.0
/privacy ·/terms ·/feishu法务/集成三页 AC-EL-LEGAL347 行41 条(41 生效)已建 v5.0
(全局)AppShell 导航壳 AC-EL-SHELL(品牌切换/企业信息/模块菜单/告警入口)组件16 条(全生效·校对通过)已建 v5.0
(全局)共享组件 ×19 AC-EL-CMP(KpiDeck/DataTable/ChartCard/EChart/GChart/ChartGrid/MatrixSection/BrandBoard/NoonBoard/NoonStatement/AdsAdvice/SkuMasterTable/AIChat/AIContext/CustomModules/RegGate/BrandContext/kit/…)组件55 条(52 条目+3 引用行·校对通过)已建 v5.0

§11.1 首页工作台(/ · AC-EL-HOME,源码 web/app/page.tsx 702 行 + dashboard.py 后端)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-HOME-01工具栏·平台切换按钮组筛选Amazon / Noon 两个平台 tab,全页数据的平台轴选项由 /api/dashboard/filters 判定:该品牌 Noon 无业务则隐藏 Noon 按钮并自动纠正 platform;platform=noon 时 period 强制 rolling(Noon 无日粒度,day 返回空);"全部平台"合并视图按钮 2026-09-16 用户拍板下架(代码保留,见 AC-EL-HOME-15..21)e2e 点选联动 + 无 Noon 品牌不渲染按钮生效
AC-EL-HOME-02工具栏·国家下拉筛选"全部国家"+当前平台国家列表选项=filters.countries[platform];未选平台=两平台并集去重;切换平台后当前国家不在新选项内自动清空回"全部国家"filters 端点 vs 下拉选项逐字一致生效
AC-EL-HOME-03工具栏·时间窗预设组(7/30/60/90/全部)筛选统一时间选择器预设档,同时驱动 KPI 卡与图表墙"全部"=2020-01-01 起;点预设清空自定义日期;窗口天数换算 boardDays(自定义=起止天数,上限 3650);2026-09-16 用户拍板为全局统一选择器e2e 切档后 KPI/墙请求参数 date/date2 断言生效
AC-EL-HOME-04工具栏·自定义起止日期双输入 + "~含首尾"标注筛选date 输入×2,双闭区间语义前端标注max=今日;起改晚于止→止自动跟随;北京时区今日锚(filters.max_day 覆盖,与后端 bg_today 对齐,修 0-8 点窗口标签差一天 P3-7);双闭区间=AC-UI-05(相邻窗拼接日重叠属设计)e2e 输入框值/边界;标注文案存在生效
AC-EL-HOME-05智能报警·面板卡(总)卡片⚡ 智能报警 + 总数/🔴/🟡/⚪ 计数行,工作台首要异常入口/api/dashboard/alerts?brand&platform;边框规则 high>0 红/medium>0 黄;total=0 整卡不渲染(非空态文案);请求失败兜底空对象不报错alerts 端点 JSON vs 面板计数;空告警企业页面无此卡生效 reg:id23,24
AC-EL-HOME-06智能报警·展开/收起按钮按钮面板折叠开关,头部整行可点按钮 stopPropagation 防与头部点击双触发;默认展开e2e 点击切换生效
AC-EL-HOME-07智能报警·店铺分组头分组按店铺(Amazon/Noon)分组的头部条店铺→品牌→SKU 三级分组(2026-10-08 用户令"先按店铺再按品牌再按SKU");店铺头=emoji+品牌数+报警数+店铺内红标数;背景色店铺含 high→danger-weak 否则 warn-weak分组结构与 alerts platform/brand 字段一致生效
AC-EL-HOME-08智能报警·品牌分组行分组店铺内按品牌聚合的行头:色点+品牌名+项数色点=brandColor() 级联(AC-UI-07);组内按 severity high→low 排序;红标计数随行色点色值=注册表/兜底级联;排序断言生效
AC-EL-HOME-09智能报警·单条报警行列表项 severity 图标 + 标题 + 详情 + 建议 action + category 角标规则集(dashboard.py 2549-2710,11 条):AMZ ACOS>100% high 否则 medium(🎯广告)|AMZ ROAS 回收<花费 high(🎯广告)|AMZ 断货风险<3 天 high 否则 medium(📦库存)|AMZ 长期仓储>366 天 medium|AMZ 零动销 low|AMZ 低分 SKU(<3★ 占比)medium(🏥账号)|Noon 高 ACOS|Noon 零转化(14 天有点击零销售)|Noon 断货(可售=0)/低库存|Noon Buy Box 丢失 medium;high 标题红字各规则触发条件独立 SQL 复算 vs 端点输出生效 reg:id23,24
AC-EL-HOME-10KPI 概览·标题行标题📊 KPI 概览 + 使用说明 + ⓘ 口径说明折叠钮说明文案="每张卡片右上 ▾ 可换指标 · 选择即保存到你的账号 · 随品牌 / 国家筛选联动";Ⓘ切换口径表显隐e2e 文案存在生效
AC-EL-HOME-11KPI 卡槽 ×10(2 行×5)卡片可自定义指标的 KPI 卡组,工作台唯一 KPI 区每卡右上指标切换 select(aria-label=第 N 张);池内互斥(选已在别卡的指标→toast 拒绝);选中即 PUT /api/dashboard/kpi-cards 持久化 user_dashboard_prefs(账号级,校验 10 槽且 key∈池);未保存返回 KPI_DEFAULT(orders30/rev30/profit30/fees30/commission/fba/margin/aov/ad_spend/acos);加载=10 skeleton;失败=错误卡换卡后刷新保持;互斥 toast;dashboard_audit 卡池断言生效
AC-EL-HOME-12KPI 指标池(19 项)数据可上卡的全量指标清单KPI_POOL:rev30/units30/profit30/commission/fba/margin/pending/cancelled/undeliverable/return/ad_spend/ad_sales/acos/tacos/cps/orders30/fees30/aov/cancel_rate;orders30=有效订单(剔取消)·aov=营收÷有效订单·cps=广告花费÷有效订单·cancel_rate=取消÷全量订单(AC-CAL-02);acos/tacos desc 健康线占位下发回填=metric_calibers.health_line 单源(AC-CAL-06);值随品牌/国家/平台/窗联动(period rolling 近30天/day/month/year;noon rolling 也吃工具栏窗换算,金额按触月对齐)kpi-cards 响应 pool 19 项逐条比对;健康线值=注册表生效 reg:id11
AC-EL-HOME-13KPI 卡值/脚注/tone数据卡主体:数值+着色+脚注fmtVal 按 unit usd/pct/int 格式化;null→"—";tone 条件染色;foot 必标分子/分母构成(AC-KPI-01,如 orders30 脚注含全量数、aov/cps 标"÷有效订单");label"近30天"随窗口标签替换dashboard_audit kpi-cards desc/foot 全量断言生效
AC-EL-HOME-14KPI ⓘ 口径说明折叠表表格Ⓘ 展开的"各卡片计算方式"19 行表+3 脚注恒定标准:表内每行文案必须与 AC-CAL-02/KPI_POOL desc 一致(口径说明是 UI 的一部分,AC-UI-01)。现状 5 处过时待修:①"订单 AMZ count(*)(全状态, 含 Pending/Cancelled)"→实现为有效订单剔取消;②"客单价 营收÷订单"→÷有效订单;③"CPS 广告花费÷订单"→÷有效订单;④"取消率 取消÷订单"→分母=全量订单 orders_all;⑤脚注"② 订单数含全状态"→全量仅作取消率分母。前端 KpiDeck.tsx,修复后本条带日期转生效。

2026-10-22 已修复上线:5 处文案对齐 AC-CAL-02(订单=有效订单剔取消 / 客单价÷有效订单 / CPS÷有效订单 / 取消率分母=全量订单 / 脚注②改「仅取消率分母用全量」);web 镜像 31f9b5812522,部署前后 frontend_e2e 各一轮 ALL PASS(201 / 0 FAIL),公网 chunk page-56691201d80f3d61.js 字节验证
表文案 vs KPI_POOL desc 逐行 diff(本库新增机器可查项)生效
AC-EL-HOME-15合并视图·订单卡卡片全部平台合并 KPI:订单=AMZ+Noon 之和+件数脚注/api/dashboard/merged-kpi?brand&mode&date&date2;全部=各平台之和单位 USD(2026-09-15 用户拍板);mode rolling/calendar 禁混标(AC-KPI-03);每卡脚注=平台拆分(相加即合计,可直接对账);日级窗口金额跨平台不可加→显示"日级金额跨平台不可加"+ref 参考月合计;
当前未上线:platform="" 入口按钮 2026-09-16 下架,代码保留(AC-EL-HOME-01),复活=恢复按钮
merged-kpi 端点 vs 两平台页相加对账(脚本可复算)未上线保留
AC-EL-HOME-16合并视图·营收 USD 卡卡片AMZ 营收+Noon GMV 折 USD 合计未上线保留
AC-EL-HOME-17合并视图·净利 USD 卡卡片净利+净利率副注未上线保留
AC-EL-HOME-18合并视图·费用 USD 卡卡片AMZ 佣金FBA促销广告 + Noon 佣金配送广告未上线保留
AC-EL-HOME-19合并视图·回款 USD 卡卡片AMZ payout + Noon payout 折 USD未上线保留
AC-EL-HOME-20合并视图·取消率/ACOS 卡卡片恒"—":跨平台口径不同不展示(防混合口径失真)未上线保留
AC-EL-HOME-21合并视图·口径说明行+平台页跳转双按钮说明+按钮"合并口径: …·每卡脚注=两平台拆分"+📦Amazon/🌍Noon 平台页按钮(Noon 按钮随 hasNoon)同上;跳转=setPlatform 不换路由e2e 按钮存在与跳转未上线保留
AC-EL-HOME-22图表墙·容器卡卡片"品牌深析图表墙" + 平台口径 sub/api/dashboard/charts?brand&country&platform&(days|frm&to|mons);sub:amazon="订单级单遍聚合"/noon="月度结算口径 · 折 USD";空态 data.empty→reason 文案;加载 skeleton;错误 role=alert;墙内 KPI 卡已取消(2026-10-02 拍板 A:与 KpiDeck 重叠+费用口径分叉);全部图展开 1 行 3 个不分 tab、key 去重(2026-09-28 用户令)端点 groups/charts 结构 vs 墙渲染数(#chartwall-count)生效
AC-EL-HOME-23图表墙·品牌快切 tabs筛选墙内品牌切换(顶栏"全部品牌"时出现)顶栏选具体品牌→显示跟随标签"品牌·国家";顶栏全部→账号品牌列表 tabs(tenant_brands,铁律),记忆 pick 默认第一个;品牌永不聚合混排(2026-09-28 用户令)品牌列表=账号品牌;切换墙请求 brand 参数生效
AC-EL-HOME-24图表墙·Noon 月窗按钮组(近6/12/24月/全部)筛选Noon 墙月粒度窗口控制跟随顶部统一时间选择器(2026-10-02 台账§4-26 方案A):工具栏窗口换算涉及月份数(自定义=月份差+1;天数窗=ceil(days/31));窄窗不足 6 月按下限 6 月(2026-10-16 用户令"月度chart默认显示6个月");"全部"(0)与≥6 月窗不受影响;工具栏变→清墙内手动覆盖切工具栏窗后墙 mons 参数断言生效
AC-EL-HOME-25图表墙·排序锁按钮(🔒排序/🔓拖拽中)按钮账号级图表排序锁默认锁;解锁=图卡可 HTML5 拖拽换位,drop 即 PUT /api/dashboard/chart-order 持久化;锁定=保存当前序+locked;初始 GET 载入;新图(不在 order)排末尾;拖拽后 50ms 抑制 click 误弹模态(2026-10-02 用户令)拖拽后刷新序保持;e2e 拖放模拟生效
AC-EL-HOME-26图表墙·计数条(#chartwall-count)说明range 起→止 · 订单数 · 图数 · 窗标签 · 平台口径说明id=chartwall-count 为 e2e/审计锚点;Amazon 附"利润=结算净额−平台费用(spapi 财务事件聚合,本币按单折 USD)"、Noon 附"月度结算口径 · 本币按锚定汇率折 USD"计数条数值 vs 端点 range/orders/chart_count生效
AC-EL-HOME-27图表墙·图卡网格布局repeat(3,1fr) 一行三图事件委托点击弹模态;draggable=!locked;≤980px 3 列、≤700px 2 列(768 溢出修复 AC-UI-04 联动)768px 视口 overflow=0(AC-UI-04 探针)生效
AC-EL-HOME-28图表墙·图卡本体卡片图标题+hint+sub+GChart 渲染sub 为 YYYY-MM-DD 时显示"· 数据日";title 属性提示"点击放大/拖拽换位·点击放大";spec 全部来自 charts 端点(前端不造图)卡内容 vs 端点 spec 逐字生效
AC-EL-HOME-29图表墙·放大模态容器弹层点图卡弹出的放大层(遮罩+标题+hint+✕)fixed inset 遮罩 zIndex=1000;点遮罩关闭;✕ aria-label=关闭;标题=spec.title 回退 chartKey(2026-10-02 用户令)e2e 点卡弹出/关闭生效
AC-EL-HOME-30放大模态·品牌 select筛选弹层内独立品牌切换选项=账号品牌列表;改动→重查 charts 按 key 取 spec改品牌后图数据变化生效
AC-EL-HOME-31放大模态·国家 select筛选弹层内国家过滤,"全部国家"+动态选项选项=filters 端点 countries[platform] 随品牌联动选项 vs filters 端点生效
AC-EL-HOME-32放大模态·时间组筛选弹层内时间窗:noon=月窗四档;amazon=7/30/90/365时间窗语义与墙一致(amazon=days,noon=mons)切档后请求参数生效
AC-EL-HOME-33放大模态·图区与空态图表GChart height=420;筛选下无此图→"该筛选下无此图数据"重查后按 chartKey 找 spec,找不到=空态文案(不白屏)e2e 极端筛选空态生效
AC-EL-HOME-34Amazon 区块头标题"📦 Amazon 平台 · USD · 订单级"仅 data.amazon 存在时渲染e2e生效
AC-EL-HOME-35Noon 区块头标题"🟡 Noon 平台 · SA / AE 本币分列 · 折USD 合计"仅 data.noon 存在时渲染e2e生效
AC-EL-HOME-36Amazon 无数据空态卡空态"该筛选下无 Amazon 平台数据"platform≠noon 且无 amazon 数据时e2e 空品牌筛选生效
AC-EL-HOME-37Noon 无数据空态卡空态"该品牌无 Noon 平台业务(Noon 为 SA / AE 两国)"platform=noon 且无数据;NoonSection 内层空态(per_country/ads_30d/trend 全空)另有文案e2e生效
AC-EL-HOME-38Noon 分国家·结算明细表(表级)表格按国家分列的结算金额表,"本币分列不混加"数据=k.per_country(/api/dashboard/kpi noon 块);本币主显+折 USD 副列(AC-CAL-12);折算汇率 filters.noon_fx 单源(AC-CAL-05,锚定汇率 SA=3.75/AE=3.6725 默认值仅请求前兜底,P3-7)kpi 端点 per_country vs 表行;无混加值生效
AC-EL-HOME-39结算明细·列"国家/币种"列国家代码+币种缩写(SAR/AED)country+currency 随行;Noon 仅 SA/AE行数=有业务国家数生效
AC-EL-HOME-40结算明细·列"订单"列分国家订单数(int 千分位)Noon 月表订单口径Σ国家=总计生效
AC-EL-HOME-41结算明细·列"营收 本币/折USD" ×2列GMV 本币主显+折 USD 副显(灰)gmv_usd=null→"—"(无锚定汇率时诚实空值)本币×汇率=折USD 抽样生效
AC-EL-HOME-42结算明细·列"净额 本币/折USD" ×2列结算净额本币+折 USDnet_usd=null→"—"同上生效
AC-EL-HOME-43Noon 分国家·广告明细表(表级)表格近 30 天分国家广告表,"本币分列 · 折USD 为锚定汇率"数据=k.ads_30d(cleaned_noon_ads_daily 单源,AC-CAL-03 总额层);30 天固定窗kpi 端点 ads_30d vs 表行生效
AC-EL-HOME-44广告明细·列"国家/币种"列同结算明细——生效
AC-EL-HOME-45广告明细·列"花费 本币/折USD" ×2列广告花费本币+折 USDspends/spends_usd(锚定汇率)×汇率抽样生效
AC-EL-HOME-46广告明细·列"销售 本币"列广告销售(本币)sales;Noon 广告销售不折 USD 副显(口径仅花费折算随行)端点一致生效
AC-EL-HOME-47广告明细·列"曝光/点击"列views/clicks(int 灰显)—端点一致生效
AC-EL-HOME-48广告明细·列"订单"列广告订单数—端点一致生效
AC-EL-HOME-49自定义模块区区块CustomModules page="dashboard":账号自定义报表模块区端点 /api/reports/defs?page、/api/reports/fields、/api/reports/query、defs POST/PUT;明细元素条目归 AC-EL-CMP 深化(本库待建行)defs 列表渲染;查询表格出数待深化
AC-EL-HOME-50工作台·综合视图(6 指标叠加)
(2026-11-01 用户令「照抄 review.onnotek.com 一模一样」)
双轴柱线混合(左=金额 USD·右=订单数): 柱=收入(蓝)/广告销售(紫)/广告花费(红), 线=结算净额(琥珀)/日利润(绿)/订单数(右轴绿)。数据零新口径零新端点: 订单面序列=图表墙既有 dailyRev/dailyCnt/dailySettle/dailyProfit/dailyFee(墙口径在案: 利润=营收−平台费用·结算净额=已回款订单营收), 广告序列=/api/ads/charts daily(广告舱 12 图墙同源); 两源按日(MM-DD)对齐, 广告源缺日=null 不虚构 0(实测 30 天窗 27 共同日)。段内筛选: 平台(Amazon·Noon=月度口径空态说明)/国家; 形态逐参数复刻参照页(Chart.js 色值/顶部图例/悬停 $ 格式)。2026-11-01 同日修订(用户检视三连: 去平台选择/加产品与SKU筛选/Noon 无曲线): 平台选择移除——双平台曲线常并入(收入/订单/结算/广告=Amazon+Noon 折USD 对照 _noon_usd 锚定; 日利润/费用/累计/客单价=Amazon 面); 筛选=国家/产品/SKU 三级(产品→sku_mapping 解析 SKU 集, SKU→订单 sku_list 分解求交, 产品→SKU 级联下拉); 数据源改单端点=/api/dashboard/charts 扩 kpi_series 块+sku/product 参数(Amazon 日序列=墙单遍聚合原值, 利润沿用结算中日置 None; noon=官方日财务流水折USD+订单/广告视图; amazon 广告=id1 视图), 前端砍第二端点; SKU/产品筛选仅 Amazon 订单面(noon 日粒无 SKU 维, 筛选激活时 noon 序列整体不掺入+页面注记); 空产品集→干净空分支(实证 Airfirt Neo 90 天零单)。呈现层纯重组 · 序列口径=图表墙单遍聚合+id1/id2 视图生效
AC-EL-HOME-51工作台·单独指标(九键切换)
(同上用户令)
metric-toggle 九键: 收入/订单数/结算净额/日利润/平台费用/广告花费/广告销售/累计营收/客单价——序列全部来自上列既有面(cumRev/aovTrend 墙图同源), 单指标柱图按指标配色(参照页 metricColors 风格), 悬停 $/单 格式; 默认=日利润。同日修订: 九键中收入/订单数/结算净额/广告花费/广告销售=双平台并入(折USD 对照), 日利润/平台费用/累计营收/客单价=Amazon 面; 筛选随 HOME-50 三级。呈现层纯重组 · 序列口径同 HOME-50生效

§11.2 图表墙图型清单(AC-EL-HOME-A##/N##,由 /api/dashboard/charts spec 驱动;标准=端点下发 key/title/hint/kind 与本表逐字一致、墙内去重全展开;验证=charts 响应机器比对)

2026-10-27 补 N23–N28 六行:noon 财务六图(广告花费/广告销售/TACOS/累计营收/月度利润/月度退款)live 在墙而册缺(peer 挂账),六键 live spec 逐字核录入册(audit.html 9.79「全批」①);补行后 noon 墙↔册 28/28、amazon 80/80 双向零差。

2026-10-31 补 N29–N73 四十五行(R4b P3-3,audit-aa 元素面补测挂账):§11.2 成文时 noon 墙 28 图与册两平,其后墙扩至六组 73 图(📈 销售趋势 12/📋 订单趋势 12/💰 财务 14/🌍 国家 23/🏷 SKU 10/🔗 链接健康度 2)而册未随动——45 键 live spec(_noon_wall 全参空筛 mons=0,chart_count=73)逐字核录入册;补行后 noon 墙↔册 73/73、amazon 80/80 双向零差(计数口径=端点 chart_count 对 N##/A## 行数)。国家组 23 图 key 均为静态键,横轴国家序列数据驱动(随在售国家集变化);修复期间墙零改动——后续扩墙须同批补册(铁律:墙↔册双向零差)。

ID元素(key·标题)图型描述(hint 原文)定义验证方法状态
AC-EL-HOME-A01dailyRev·每日营收图·line按天看销售额走势,识别增长或下滑拐点/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A02dailyCnt·每日订单数图·bar按天看订单量走势,配合营收判断客单价变化;* = 当日进行中(半日)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A03dailyProfit·每日利润走势图·line每天净利润(营收−平台费用)变化/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A04monthlyGmv·月度 GMV图·barUSD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A05monthlyNet·月度结算净额图·barUSD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A06weeklyOrders·每周订单图·bar件 · ISO 周/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A07weeklyRev·每周营收图·bar按周看销售趋势,平滑日常波动/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A08cumRev·累计营收图·line从区间起点到当前的累计销售额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A09aovTrend·客单价趋势图·line平均订单金额随时间变化/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A10hourly24·24小时订单分布 · 按品牌图·bar最新数据日(订单表最大日)的逐小时单量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图;x=00–23 时,series=品牌逐线,无品牌数据时补零线charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A11statusPie·订单状态构成图·pieShipped / Canceled / Pending 等状态占比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A12statusTime·订单状态随时间图·stack各状态数量按月变化/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A13cancelRate·每日取消率图·line取消订单占比走势,异常升高需排查/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A14shipCancel·发货 vs 取消趋势图·line发货量增 + 取消量降 = 健康/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A15dow·星期订单分布图·bar一周中哪天单量最高(广告投放参考)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A16hourDist·24小时订单分布 · 按品牌图·bar最新数据日(订单表最大日)的逐小时单量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A17promoTime·促销订单趋势图·line促销订单(促销费>0)随时间变化/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A18fbaMfn·每日 FBA vs MFN 订单图·stack两种配送方式每日单量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A19valueDist·订单金额分布图·bar订单金额区间统计/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A20multiSku·单 SKU vs 多 SKU 订单图·pie一单买一个 vs 一单买多个/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A21aging·发货时效分布图·bar已发货订单从下单到发货的等待天数/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A22monthCancel·月度取消数图·bar每月取消订单量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A23fulfillPie·配送渠道占比图·pieFBA vs MFN(自发货)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A24salesChan·销售渠道占比图·pie各销售渠道订单比例/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A25promoPie·促销 vs 非促销订单图·pie依赖促销出单的程度/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A26itemsPerOrder·单均件数趋势图·line平均每笔订单购买件数/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A27ordersPerItem·每单件数分布图·bar1件/2件/3件…订单数分布/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A28revPerItem·单品营收趋势图·line总营收 ÷ 商品件数(单件产出)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A29monthProfit·月度利润走势图·bar每月净利润变化/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A30monthSettle·月度结算总额图·bar每月 Amazon Settlements 实际打款/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A31monthFee·月度费用走势图·bar每月平台扣费(佣金+FBA+促销+其他)变化/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A32monthSettleRate·月度回款率图·line已回款订单营收 ÷ 总营收(派生口径)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A33avgFee·单均费用趋势图·line平均每笔订单的平台扣费/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A34feeVsSettle·费用 vs 回款(月)图·line同一时间轴对比平台扣费与实际打款/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A35feeComp·费用构成图·pie佣金 / FBA / 促销 / 其他占比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A36settleStatus·回款状态金额图·pie已回款 vs 待回款 vs 其他(订单营收口径)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A37dailyFee·每日费用图·bar每天平台扣费金额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A38monthFeeRatio·月度费用占比图·line费用 ÷ 营收/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A39dailySettle·每日回款口径营收图·line已回款订单的每日营收(派生)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A40curRev·分币种营收图·pieUSD / SAR / AED 等币种销售分布(本币)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A41settleCur·分币种回款图·pie已回款订单各币种营收(本币,派生)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A42orderCur·分币种订单数图·pie各币种订单量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A43revChan·分渠道营收图·hbar各销售渠道销售额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A44profChan·分渠道利润图·hbar各渠道净利润/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A45settleRateChan·分渠道回款率图·hbar各渠道已回款营收占比(派生)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A46last24Country·最近数据日分国家订单图·pie各站点最近一天的单量分布/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A47countryRev·分国家营收图·hbar各国销售额对比,找出主力市场/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A48countryProfit·分国家利润图·hbar卖得多不一定赚得多/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A49countrySettle·分国家结算金额图·hbar各国实际结算净额(回款)对比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A50countryShare·国家订单占比图·pie各国订单份额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A51countryAov·分国家客单价图·hbar各国平均每单金额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A52countryMargin·国家利润率图·hbar各国净利润率/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A53countryFeeRate·国家费率图·hbar各国平台扣费比例/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A54countrySettleRate·国家回款率图·hbar各国结算净额 ÷ 营收,回款效率对比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A55countryCancelRate·国家取消率图·hbar各国取消订单比例/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A56countryCancel·分国家取消订单数图·hbar各国取消订单量,找出异常站点/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A57countryFba·FBA 费用分国家图·hbar各国 FBA 物流费对比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A58countryComm·佣金分国家图·hbar各国平台佣金对比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A59countryCommRate·分国家佣金率图·hbar各国佣金比例/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A60countryPromo·分国家促销返点图·hbar各国促销补贴金额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A61countryRefund·分国家退款件数图·hbar各国退款退货量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A62countryFbaMix·FBA vs MFN 分国家图·stack各国配送方式占比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A63countryItems·分国家单均件数图·hbar各国平均每单件数/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A64countryShipDays·分国家平均发货天数图·hbar各国物流时效(下单→发货)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A65countryFbaUnit·分国家单件 FBA 费图·hbar各国每件物流费/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A66top3FeeTrend·Top 3 国家费率趋势图·line(f-string 动态) f"营收前三({'、'.join(top3c)})费率按月变化"/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A67top5CountryDaily·Top 5 国家每日订单图·line单量最高的 5 个国家每日走势/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A68fbaMonthly·FBA 费用按月图·bar物流费月度走势(spapi 财务事件四项合计)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A69skuMargin·SKU 利润率图·hbar负值 = 亏损品(营收 Top,费用事件已到)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A70skuFeeRate·SKU 费率图·hbar每个产品的平台扣费比例(营收 Top,费用事件已到)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A71skuUnits·热卖 SKU(按件数)图·hbar畅销品排行,快速了解主力产品/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A72skuRev·营收 Top SKU图·hbar贡献销售额最多的产品/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A73skuProfit·利润 Top SKU图·hbar与营收榜对比可发现高营收低利润品/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A74skuSettle·回款口径 Top SKU图·hbar已回款订单营收最多的产品(派生)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A75skuCnt·SKU 订单数 Top 15图·hbar订单量最高的 15 个产品/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A76top3SkuDaily·Top 3 SKU 每日营收图·line(f-string 动态) f"营收前三({'、'.join(sku_label(k) for k in sku_rev_top)})每日表现"/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A77rating·产品评分分布图·hbar各 Listing 当前星级(rankings 快照)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A78reviews·评论数对比图·hbar各产品评论数量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A79bsrSmall·小类 BSR图·hbar细分类目排名(越低越好)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-A80bsrBig·大类 BSR图·hbar大类目排名(越低越好)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N01nGmvBar·月度 GMV图·bar折 USD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N02nNetBar·月度结算净额图·bar折 USD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N03nWeeklyOrders·每周订单图·bar件 · ISO 周/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N04nDailyRev·每日营收图·line折 USD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N05nDailyCnt·每日订单数图·bar件/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N06nDailyProfit·每日利润走势图·line折 USD · 结算净额−佣金−履约费/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N07nWeeklyRev·每周营收图·bar折 USD · ISO 周/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N08nAovTrend·客单价趋势图·line折 USD · 营收÷订单/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N09nStatusPie·订单状态构成图·pie件 · 近180天/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N10nCancelRate·每日取消率图·line% · 取消件÷订单/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N11nCountryCancel·分国家取消订单数图·hbar件 · 近180天/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N12nFeeStack·月度费用构成图·stack折 USD · 8 项平台费用拆解/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N13nCurRev·分币种营收图·pie本币 · SAR/AED/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N14nCountryMon·国家 × 月营收图·stack折 USD · 堆叠/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N15nCountryGmv·国家营收排名图·hbar折 USD · 窗口合计/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N16nCountryShare·国家营收份额图·pie折 USD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N17nCountryOrders·国家 × 月订单数图·stack堆叠/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N18nTopSku·Top 15 SKU 营收图·hbar本币 · 按营收排序/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N19nTopSkuTrend·Top 5 SKU 月度营收图·line折 USD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N20nBrandMon·品牌 × 月营收图·stack折 USD · 堆叠/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N21nModelTop·Top 10 型号营收图·hbar本币 · sku_mapping 归并型号/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N22nSkuUnits·热卖 SKU(按件数)图·hbar件 · 近180天/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N23nAdSpend·月度广告花费图·line折 USD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N24nAdSales·月度广告销售图·line折 USD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N25nAdRate·月度 TACOS图·line广告花费 ÷ 营收 %/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N26nCumGmv·累计营收图·line折 USD · 窗口内累计/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N27nProfitTrend·月度利润走势图·line折 USD · 结算净额 − 广告花费/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N28nRefundTrend·月度退款图·line折 USD/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N29nHourly24·24小时订单分布 · 按品牌图·bar最新数据日(订单表最大日)的逐小时单量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N30nStatusTime·订单状态随时间图·stack各状态件数按月变化 · 近180天/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N31nShipCancel·发货 vs 取消趋势图·line件 · 已发货(含已送达) vs 取消 · 近似: 无发货时间戳按下单日/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N32nDow·星期订单分布图·bar一周中哪天单量最高(广告投放参考)· 近180天/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N33nHourDist·24小时订单分布 · 按品牌图·bar最新数据日(订单表最大日)的逐小时单量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N34nMultiSku·单 SKU vs 多 SKU 订单图·pie一单买一个 SKU vs 买多个 SKU · 近180天/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N35nMonthCancel·月度取消数图·bar件 · 订单表(月表 cancelled 列恒 0 不可用)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N36nItemsPerOrder·单均件数趋势图·line平均每笔订单购买件数 · 近180天/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N37nOrdersPerItem·每单件数分布图·bar1件/2件/3件…订单数分布 · 近180天/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N38nRevPerItem·单品营收趋势图·line折 USD · 月度 · GMV÷件(近似 Amazon 日级)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N39nMonthFee·月度费用走势图·bar折 USD · 月表 8 项平台费用合计/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N40nMonthSettleRate·月度回款率图·line折 USD · 结算净额÷GMV/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N41nAvgFee·单均费用趋势图·line折 USD · 费用÷订单(件口径)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N42nFeeVsSettle·费用 vs 回款(月)图·line折 USD · 平台扣费与结算净额同轴对比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N43nDailyFee·每日费用图·bar折 USD · 日级仅佣金+履约费(月表 8 项全)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N44nMonthFeeRatio·月度费用占比图·line折 USD · 费用÷GMV/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N45nDailySettle·每日回款口径营收图·line折 USD · 日表结算净额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N46nSettleCur·分币种回款图·pie本币 · SAR/AED · 月表结算净额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N47nOrderCur·分币种订单数图·pie件 · 各币种订单量/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N48nLast24Country·最近数据日分国家订单图·pie件 · 各站点最近一天的单量分布/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N49nCountryProfit·分国家利润图·hbar折 USD · 结算净额−广告 · 卖得多不一定赚得多/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N50nCountrySettle·分国家结算金额图·hbar折 USD · 各国结算净额(回款)对比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N51nCountryShareOrd·国家订单占比图·pie件 · 各国订单份额/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N52nCountryAov·分国家客单价图·hbar折 USD · GMV÷订单(件口径)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N53nCountryMargin·国家利润率图·hbar折 USD · 利润÷GMV/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N54nCountryFeeRate·国家费率图·hbar折 USD · 8项费用÷GMV/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N55nCountrySettleRate·国家回款率图·hbar折 USD · 结算净额÷GMV/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N56nCountryCancelRate·国家取消率图·hbar件 · 取消÷全部 · 近180天(订单表)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N57nCountryFba·履约费分国家图·hbar折 USD · delivery_fee(对应 Amazon FBA 费用图)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N58nCountryComm·佣金分国家图·hbar折 USD · 各国平台佣金对比/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N59nCountryCommRate·分国家佣金率图·hbar折 USD · 佣金÷GMV/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N60nCountryPromo·分国家订单补贴图·hbar折 USD · order_subsidies(对应 Amazon 促销返点图)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N61nCountryRefund·分国家退款金额图·hbar折 USD · 月表 refund(对应 Amazon 退款件数图)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N62nCountryItems·分国家单均件数图·hbar件/单 · 近180天(订单表)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N63nCountryFbaUnit·分国家单件履约费图·hbar折 USD · 履约费÷订单件(对应 Amazon 单件FBA费)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N64nTop3FeeTrend·Top 3 国家费率趋势图·line营收前三(SA、AE)费率按月变化/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N65nTop5CountryDaily·Top 5 国家每日订单图·line件 · 单量最高的 5 个国家每日走势 · 近180天/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N66nFbaMonthly·履约费按月图·bar折 USD · delivery_fee(对应 Amazon FBA 费用按月)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N67nSkuProfit·利润 Top SKU图·hbar折 USD · 结算净额−SKU广告 · 与营收榜对比可发现高营收低利润品/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N68nSkuSettle·回款口径 Top SKU图·hbar折 USD · 结算净额最多/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N69nSkuMargin·SKU 利润率图·hbar折 USD · 利润÷GMV · 负值=亏损品(营收 Top15)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N70nSkuFeeRate·SKU 费率图·hbar折 USD · 8项费用÷GMV(营收 Top15)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N71nSkuCnt·SKU 订单数 Top 15图·hbar件 · 月表口径/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N72nRating·产品评分分布图·hbar各 Listing 当前星级(rankings 快照 · noon AE/SA)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效
AC-EL-HOME-N73nReviews·评论数对比图·hbar各产品评论数量(rankings 快照)/api/dashboard/charts 下发 spec(title/hint/kind),前端不造图charts 响应与本行 key/title/hint/kind 逐字比对(机器可查)生效

§11.3 SKU 主表(AC-EL-SKU,web/components/SkuMasterTable.tsx 268 行 + /api/dashboard/sku-matrix;2026-10-12 三卡合并用户拍板:Top15×2+SKU销量明细+四维矩阵→一张全量表)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-SKU-01表卡标题标题"SKU 主表 · 平台 × 国家 × 品牌 × SKU 全量 · 15 列含税口径 · 默认营收降序 · 独立时间选择器"位于页面最底部(自定义模块之前,2026-09-28 用户令);时间选择器独立于工作台全局选择器e2e 标题渲染生效
AC-EL-SKU-02时间预设(7/30/90 天)+起止双输入筛选表内独立时间窗预设=北京锚 daysAgo(n)~bjToday();改动翻页重置 page=1;双输入 type=date请求 date_from/date_to 断言生效
AC-EL-SKU-03平台组(全部/Amazon/Noon)筛选表内平台过滤默认全部请求 platform 断言生效
AC-EL-SKU-04国家下拉筛选跟随工作台国家选项,且随全局选择联动countryOpts 传入;全局 country 变化→表内同步(useEffect)联动断言生效
AC-EL-SKU-05⬇ 导出 CSV 按钮按钮按当前筛选导出全量 CSV请求带 export=1;22 列 CSV(BOM 头防 Excel 乱码);文件名 sku_master_{brand}_{from}_{to}.csv;含引号/逗号转义导出行数=total;列头 22 项生效
AC-EL-SKU-06数据质量警示条(⚠ chips)徽标六类口径/覆盖警示黄条flags:ads_note(广告覆盖说明)/ads_sku_note/fee_lag_brands(费用滞后品牌)/old_seg_brands(旧段品牌)/onno_gap(onno 缺口:日期段+缺单数+缺金额)/noon_unsettled_months(Noon 未出账月)sku-matrix flags vs chips 渲染生效
AC-EL-SKU-07列·平台列📦 Amazon / 🟡 Noon——生效
AC-EL-SKU-08列·国家列国家代码空→"—"—生效
AC-EL-SKU-09列·品牌列色点+品牌名branddot=brandColor()(AC-UI-07)色值级联生效
AC-EL-SKU-10列·SKU(可排序)列SKU + 行级标记flags 含 fees_alloc→"·近似分摊";含 unsettled→"·未出账"排序请求;标记渲染生效
AC-EL-SKU-11列·产品名列sku_mapping 规范名product_name 优先(AC-CAL-10);空→"—"名称≠ASIN 抽样生效
AC-EL-SKU-12列·ASIN列ASIN(灰显)空→"—"—生效
AC-EL-SKU-13列·售价(可排序)列AMZ=$两位小数;Noon=本币price=null→"—"币种正确生效
AC-EL-SKU-14列·销量(可排序)列件数(加粗)AMZ=行级 items⋈orders 订单日切;Noon=行级订单事件日切(金额才月对齐,销量不月对齐)抽样 SQL 复算生效
AC-EL-SKU-15列·订单数(可排序)列行级订单数同上行级日切抽样复算生效
AC-EL-SKU-16列·营收(可排序)列AMZ=USD 单值;Noon=本币主显+$折USD 副行AMZ=行级订单日切;Noon=pl P&L 月对齐(§89 方案A:窗口触月整月计入)两口径脚注在案;抽样对账生效
AC-EL-SKU-17列·广告费(可排序)列同上双币显示AMZ=ads_sku_daily∪amazon_ads_daily 并集原值(AC-CAL-04;未全覆盖约29%披露);Noon=花费×(1+SA15%/AE5%) 含税上浮并集合计=平台汇总生效
AC-EL-SKU-18列·佣金(含税)(可排序)列结算实扣=天然含税AMZ=fin_daily 费用;Noon=月表 commission抽样复算生效
AC-EL-SKU-19列·尾程(含税)(可排序)列FBA/配送费,结算实扣Noon=delivery_fee抽样复算生效
AC-EL-SKU-20列·利润(可排序)列=营收−佣金−尾程−其他−代扣VAT−广告;负值红字加粗AMZ/Noon 同公式异源(见 16-19)公式复算抽样生效
AC-EL-SKU-21列·利润率(可排序)列利润÷营收,pct 一位小数null→"—"复算生效
AC-EL-SKU-22合计行(tfoot)行全量合计:件/单/营收/广告/佣金/尾程/利润(两平台 USD 折算相加)营收合计下 Noon 本币分项副行(如"1,234,567 SA + 567,890 AE");利润合计负值红;利润率列合计恒"—"Σ列=合计;分项币种直加禁生效
AC-EL-SKU-23分页条分页上一页/下一页 + "第 x / y 页 · 共 N 行"page_size=50;total≤50 不渲染翻页请求 page生效
AC-EL-SKU-24空态/加载态空态"该筛选组合暂无数据"/"加载中…"items=0→空态;未载→加载态e2e生效
AC-EL-SKU-25口径脚注(表底)说明AMZ/Noon 两段完整口径说明+数据窗口+Noon 触月列表AMZ:行级订单日切·结算实扣天然含税·广告已授权账户原值(未全覆盖约29%)·利润公式;Noon:本币 SA=SAR/AE=AED 锚定汇率折USD·金额月对齐§89 方案A·销量订单日切·广告×(1+SA15%/AE5%)·valid_units 源头恒0不采用;动态尾缀=数据窗口 from~to+触月脚注文案逐字(AC-UI-01)生效

§11.4 今日页(/today · AC-EL-TODAY,32 条 · 2026-10-22 源码实证,建档·待验)

ID元素类型描述定义(来源·口径·公式·边界·交互)验证方法状态
AC-EL-TODAY-001页标题/面包屑 @页头静态「今日 · 今日经营 · 数据每 2 小时增量更新」AppShell title/crumb;「每 2 小时」=worker 增量拉取节奏;页级数据日锚 day=max(purchase_date)(AMZ)/max(order_placed_at::date)(Noon)——对齐订单最大日而非 sales_hourly 最大日(2026-09-09 fittingirls 零订单日案例在案)e2e 断言 crumb 文案生效
AC-EL-TODAY-002错误横幅 @页顶反馈接口失败时红条展示错误消息err state ← getJson catch断网/坏参数 e2e 断言 role=alert生效
AC-EL-TODAY-003平台筛选标签组 @工具条筛选全部平台/Amazon/Noon 三标签platform state;选项经 /api/dashboard/filters?brand= 推导,Noon 按钮仅 platforms.noon 非空时渲染(brands_source 注册表 platform='noon' 品牌非空);切品牌后当前平台无数据自动回落「全部平台」(page.tsx:53-54) |交互:单击切换,触发重拉SQL brands_source noon 品牌数 vs 按钮 presence;纯 Amazon 企业无 Noon 按钮生效
AC-EL-TODAY-004国家下拉 @工具条筛选平台后级联国家单选options=filters.countries[platform](Amazon=cleaned_amazon_orders DISTINCT country;Noon=cleaned_noon_sku_pl_monthly DISTINCT country);platform="" 时 disabled 显示「先选平台」;选项变更后已选国家不在列表则清空(:72-74) |交互:change 重拉选 Amazon→下拉列出订单表实有国家生效
AC-EL-TODAY-005更新于时间戳 @工具条右侧状态「更新于 HH:MM:SS」loadedAt=每次成功响应时 toLocaleTimeString('zh-CN',{hour12:false})肉眼/快照生效
AC-EL-TODAY-006自动刷新开关 @工具条右侧开关「◉ 自动刷新开 / ○ 自动刷新关」auto state;开时 60s interval 且仅 document.visibilityState==='visible' 才 setTick(切后台暂停,page.tsx:63-69) |交互:单击切换e2e 点按后 class 变化生效
AC-EL-TODAY-007手动刷新按钮 @工具条右侧按钮「↻ 刷新」setTick+1 触发 useEffect 重拉 /api/today |交互:单击e2e生效
AC-EL-TODAY-008全部平台提示卡 @工具条下(仅 platform="")提示⚠ 「全部平台」视图当前仅聚合 Amazon 订单数据;Noon 实时数据请切换 Noon 标签条件渲染 platform==="";诚实披露聚合边界e2e 默认视图文案存在生效
AC-EL-TODAY-009Noon 数据源说明卡 @Noon 视图顶部说明卡h2「Noon 平台 · 今日实时」+ sub「数据源 noon_orders · 按日数据 · 订单=去重单号 · 件数=件级行 · 状态标注」+ 今日/昨日日期行 + 状态词释义(cancelled=取消, cir=客户主动退货, undeliverable=无法送达)day=max(order_placed_at::date),prev_day=day−1;无数据返回 noon_no_realtime=true 且全空文案断言;API 空态响应生效
AC-EL-TODAY-010Noon KPI·今日订单 @Noon KPI 行KPI卡今日订单数+昨日对比+环比%/api/today platform=noon → audit.cleaned_noon_orders count(DISTINCT order_nr)(2026-09-26 D批P2-2:件级行误当订单数修正);delta=(cur−prev)/prev,prev=0/缺失显「—」,升绿降红SQL 同日 count(DISTINCT order_nr) 对拍生效
AC-EL-TODAY-011Noon KPI·今日件数 @Noon KPI 行KPI卡件数+昨日+环比%同表 count(*)(件级行数)SQL count(*) 对拍生效
AC-EL-TODAY-012Noon KPI·取消 cancelled @Noon KPI 行KPI卡取消件数(红)count(*) FILTER (WHERE item_status='cancelled');foot=昨日同口径SQL FILTER 对拍生效
AC-EL-TODAY-013Noon KPI·客户退货 cir @Noon KPI 行KPI卡退货件数(橙 warn)count(*) FILTER (item_status='cir')同上生效
AC-EL-TODAY-014Noon KPI·无法送达 @Noon KPI 行KPI卡undeliverable 件数(红)count(*) FILTER (item_status='undeliverable')同上生效
AC-EL-TODAY-015Noon KPI·已送达 @Noon KPI 行KPI卡delivered 件数(绿)count(*) FILTER (item_status='delivered')同上生效
AC-EL-TODAY-016Noon KPI·已发货 @Noon KPI 行KPI卡shipped 件数(默认色)count(*) FILTER (item_status='shipped')同上生效
AC-EL-TODAY-017Noon KPI·已导出 @Noon KPI 行KPI卡exported 件数count(*) FILTER (item_status='exported')同上生效
AC-EL-TODAY-018Noon 分品牌表 @Noon 双卡左表格品牌×(订单/件数/取消/退货/无法送达)day 当日 GROUP BY brand ORDER BY 订单 DESC;品牌列带 brandColor() 色点(AC-UI-07);空态行「今日暂无数据」colSpan=6SQL 分组对拍生效
AC-EL-TODAY-019Noon 分国家表 @Noon 双卡右表格国家×同五列GROUP BY country ORDER BY 订单 DESC;空态「本月暂无数据」(文案沿用)SQL 分组对拍生效
AC-EL-TODAY-020KPI·今日订单(Amazon) @主 KPI 行(platform≠noon)KPI卡「今日订单(MM-DD)」+昨日+环比%+Pending 附注/api/today Amazon 分支:audit.cleaned_amazon_orders purchase_date=day count(*)(当日全量含取消/Pending,实时口径非 AC-CAL-02 有效订单);canceled 另卡呈现;pending>0 时附「含 Pending N 单 · 金额待结算」(warn 色)SQL 当日 count(*) 对拍;与「今日订单=有效订单」误用区分(页面无剔取消声明,验收按全量)生效
AC-EL-TODAY-021KPI·今日件数 * @主 KPI 行KPI卡件数+昨日+环比%,标签带 *sum(coalesce(nullif(items_count,0), array_length(string_to_array(sku_list,','),1), 1))——Pending 单 Amazon 不回传件数按 SKU 清单估、皆缺按 1(2026-09-12 修,2026-09-26 E批P3-6 全站口径) |交互:悬停 title「Pending 未确认单按 SKU 清单估算」SQL 同式对拍生效
AC-EL-TODAY-022KPI·今日营收 @主 KPI 行KPI卡营收 USD+昨日+环比%sum(revenue_usd)(当日全量,usd() 千分位 2 位);pending>0 附「N 单 Pending 金额未计入」SQL sum 对拍生效
AC-EL-TODAY-023KPI·今日净利 @主 KPI 行KPI卡净利 USD+昨日(无环比)sum(net_usd) 当日全量;净利口径见 AC-CAL-01SQL sum(net_usd) 对拍生效
AC-EL-TODAY-024KPI·Prime/取消 @主 KPI 行KPI卡Prime 占比%(取整)+「取消 N 单」prime% = round(count(is_prime)/count(*)*100);orders=0 显「—」;canceled=count(order_status='Canceled')(仅美式拼写单值过滤)SQL 复算生效
AC-EL-TODAY-025分国家小时订单图 @主视图卡1折线图每国家今日实线+昨日合计虚线,x=0–23 时EChart;hourly_today=cleaned_sales_hourly day=当日 GROUP BY hour,country sum(orders)(北京时间);昨日合计=day−1 同表 sum(hour);颜色 COUNTRY_COLORS 7 色循环;虚线 #94a3b8 无点;空态「暂无小时数据」/加载态 |交互:legend 滚动、tooltip axisSQL sales_hourly 对拍生效
AC-EL-TODAY-026SKU TOP20 条形图 @grid2c 左条形图今日件数 TOP20 SKU(hbar)by_sku:当日剔取消单(NOT IN ('Canceled','Cancelled','cancelled'))sku_list 拆分,件数按订单内 SKU 数均摊 est=items_count>0?items_count:len(parts),每 SKU += est/len(parts),round 取整,取前 20(T2-7) |交互:GChart 渲染SQL 均摊复算对拍生效
AC-EL-TODAY-027小时×国家堆叠柱 @grid2c 右堆叠柱图24 小时×国家堆叠订单量同 hourly_today 数据;bar stack='t' barMaxWidth=18,x 轴「N时」;空态「暂无小时数据」 |交互:tooltip/legend对拍 25生效
AC-EL-TODAY-028小时×国家明细表 @主视图卡4表格行=小时(该时合计 0 整行跳过),列=国家(排序)+合计列,末行合计行cell=hourly_today find(hour,country) orders ?? 0;0 值格显 muted「·」;表头国家列来自数据 DISTINCT行/列/总和 SQL 三向对拍生效
AC-EL-TODAY-029分国家今日表 @grid2c(下方)左表格国家×(今日/昨日/变化%)by_country=cleaned_amazon_orders 当日与昨日 count(*) FILTER(purchase_date=...) GROUP BY country ORDER BY 今日 DESC;country 空→「—」;delta 着色SQL 对拍生效
AC-EL-TODAY-030分品牌今日表 @grid2c(下方)右表格品牌×(订单/件数/营收 USD/Pending)by_brand=当日 count(*)、件数兜底同 21、sum(revenue_usd)、count FILTER(Pending);品牌色点 branddot;Pending>0 warn 色;空态「暂无数据」SQL 对拍生效
AC-EL-TODAY-031Pending 脚注 @分品牌表下脚注「Pending = 平台尚未确认结算的订单(金额暂缺属正常);长期不转化=采集侧状态回刷问题,见数据管道页水位」静态口径文案文案断言生效
AC-EL-TODAY-032页脚数据链路说明 @页底脚注SP-API 采集库→每 2 小时增量(今日订单+小时销量)→只读库;「今日」=最新数据日北京时间;* 件数估算口径静态文案断言生效

源码实证注记:待核:0。注:今日页 Amazon KPI 口径=当日全量(含取消/Pending),与 AC-CAL-02 看板 30 天有效订单口径不同属页面定位差异,验收按本表口径。

§11.5 订单页(/orders · AC-EL-ORDER,26 条 · 2026-10-22 源码实证,建档·待验)

ID元素类型描述定义(来源·口径·公式·边界·交互)验证方法状态
AC-EL-ORDER-001页标题/面包屑 @页头静态「订单 · Amazon 订单明细 · 三品牌统一(订单主表口径)」AppShell title/crumbe2e 文案断言生效
AC-EL-ORDER-002错误横幅 @页顶反馈接口失败红条err ← getJson catchrole=alert生效
AC-EL-ORDER-003KPI·订单数(当前筛选) @KPI 行KPI卡当前筛选总单数+有效/已取消拆分total=筛选内 count(*)(含取消);foot「有效订单 N · 已取消 M」M=total−valid;valid=count FILTER(order_status NOT IN ('Canceled','Cancelled','cancelled'))(D批P3-1 三拼写对齐)SQL 同 where 复算 total/valid生效
AC-EL-ORDER-004KPI·营收 USD @KPI 行KPI卡筛选内有效订单营收sum(revenue_usd) FILTER 剔取消;valid=0 显「—」不显误导 $0.00(D批P3-4),foot「当前筛选无有效订单(全为取消单)」;正常 foot「有效订单口径(不含取消)」SQL 对拍;全取消筛选下断言「—」生效
AC-EL-ORDER-005KPI·件数 @KPI 行KPI卡筛选内有效订单件数sum(items_count) FILTER 剔取消;valid=0 显「—」SQL 对拍生效
AC-EL-ORDER-006KPI·客单价 @KPI 行KPI卡AOV=营收/有效订单aov=sum(rev)/valid(valid=0 为 0.0 前端显「—」),usd 2 位;foot「营收 / 有效订单」复算生效
AC-EL-ORDER-007KPI·状态分布 @KPI 行(仅 by_status 非空首项渲染)KPI卡每状态一行「status:N 单 · 金额」by_status=GROUP BY order_status count(*)+sum(revenue_usd)+sum(items_count)+rev_missing(revenue_usd IS NULL 计数);Pending/Unshipped 且 rev_missing>0 → 全缺显「金额待结算」、部分缺显「$X · N/M 单待结算」(2026-10-01 拍板②-B2 误导性 0 铁律)SQL 复算 rev_missing生效
AC-EL-ORDER-008状态筛选按钮组 @明细卡工具条筛选全部/已发货/待发货/未发货/已取消key=空/Shipped/Pending/Unshipped/Canceled,SQL o.order_status=精确等值 |交互:单击重置页码点「已取消」→ total=取消单数生效
AC-EL-ORDER-009快捷天数下拉 @工具条筛选全部时间/近1年/近90天/近30天days=N → purchase_date >= 北京时区 today−(N−1)(含界 N 自然日,2026-09-28 A1 与 KPI 对齐;D批P3-2 北京日切) |交互:change 清空 frm/to 重置页码30 天窗 SQL 边界日对拍生效
AC-EL-ORDER-010国家下拉 @工具条筛选全部国家+固定 17 国清单COUNTRIES=US,CA,MX,GB,DE,FR,IT,ES,SE,BE,NL,PL,IE,AU,JP,SA,AE(2026-09-28 C7 与库存页同源;无数据国家=0 行如实显示) |交互:change 重置页码选无数据国家→空表生效
AC-EL-ORDER-011自定义日期区间 frm/to @工具条筛选起止日期双输入(title 含首尾)frm/to=YYYY-MM-DD 双闭区间;非法非空输入 API 400「日期格式非法」(P3 补验轮,原静默忽略);设区间自动 days=0(两窗不并存);to min=frm / frm max=to |交互:change 互斥快捷窗frm=2026-13-45 → 400 断言生效
AC-EL-ORDER-012清除区间按钮 @工具条(仅 frm/to 非空)按钮清空自定义区间setFrm/setTo 空串+重置页码 |交互:单击出现/消失条件断言生效
AC-EL-ORDER-013搜索框+搜索按钮 @工具条右筛选「搜索订单号 / SKU」search → amazon_order_id ILIKE %q% OR sku_list ILIKE %q%;form submit 才置 query(输入不即搜) |交互:回车/点搜索输入部分单号断言结果集生效
AC-EL-ORDER-014订单明细表容器 @主卡DataTable明细表+CSV 导出+分页+口径脚注exportCsv="orders";pager page/pages/total pageSize=20(API 上限 100);caliber 行=「金额=USD(订单级)|数据源=订单主表+order_fees…|营收=revenue_usd(非取消单)」;empty=「无匹配订单」;排序 purchase_date DESC, amazon_order_id |交互:列头排序/翻页/导出 CSV翻页断言 total 不变生效
AC-EL-ORDER-015列·订单号 @明细表列brandColor 色点+订单号amazon_order_id;色点=brandColor(brand)(AC-UI-07) |交互:可排序色点颜色=品牌注册色生效
AC-EL-ORDER-016列·下单日期 @明细表列muted 数字日期purchase_date 字符串;可排序 |交互:排序格式断言生效
AC-EL-ORDER-017列·国家 @明细表列国家码country |交互:排序—生效
AC-EL-ORDER-018列·状态 @明细表列状态徽章badge class=ST_BADGE[status]:Shipped=ok(绿)/Pending·Unshipped=warn(橙)/Canceled=dim(灰),未知=dim;文案=status_cn||status(中文缺失回退英文原值)status生效
AC-EL-ORDER-019列·渠道 @明细表列履约渠道+Prime 标fulfillment_channel + is_prime 时「 · Prime」;CSV 同款—生效
AC-EL-ORDER-020列·件数 @明细表列整数右对齐items_count;可排序 |交互:排序—生效
AC-EL-ORDER-021列·本币金额 @明细表列「CUR N,NNN.NN」或「—」currency=coalesce(o.currency, marketplaces.currency, 'USD')(GB→UK 映射);local_amount null→「—」;toLocaleString 2 位抽样 JP 单显 JPY生效
AC-EL-ORDER-022列·营收 USD @明细表列加粗 USD 金额revenue_usd=本币/锚定汇率(fx 链在 ingest),usd 2 位;null→usd(null);可排序(null 排 −1) |交互:排序—生效
AC-EL-ORDER-023列·回款状态 @明细表列回款徽章is_abnormal→「回款异常」bad(红);否则 settlement_status 映射 已回款=ok/待回款=warn/已取消=dim/空=「—」异常单红徽章断言生效
AC-EL-ORDER-024列·SKU @明细表列SKU 清单截断sku_list 逗号清单,260px ellipsis 单行截断,空=「—」;CSV 全量 |交互:悬停看全(title 无,视觉截断)长清单截断样式生效
AC-EL-ORDER-025表脚注 @主卡底脚注数据源与口径说明「订单主表+按品牌分表财务明细视图;营收 USD=本币/fx();无财务明细列品牌回款状态按订单状态推导;快捷窗口=N 自然日(北京时区·含首尾,2026-09-28 起与工作台 KPI 30 天口径一致)」文案断言生效
AC-EL-ORDER-026自定义模块挂载位 @页底组件CustomModules page="orders"企业自定义模块位(见 AC-EL-CMP) |交互:随企业配置—生效

源码实证注记:待核:0。权限:require_module("orders")——未开通模块企业 403。注:状态筛选 status=精确匹配 order_status 原值('Cancelled' 英式拼写单在已取消筛选下不命中,仅影响三拼写并存历史数据,验收时以 SQL 实值为准)。

§11.6 财务页(六张大表列级条目下一批逐列展开)(/finance · AC-EL-FIN,64 条 · 2026-10-22 源码实证,建档·待验)

ID元素类型描述定义(来源·口径·公式·边界·交互)验证方法状态
AC-EL-FIN-001AppShell 标题/面包屑 @顶栏导航标题"财务"+面包屑"资金流水 · 问题雷达 · 全维度损益(品牌 × 月 × 费用 × 回款 × Noon 官方结算口径)"(page.tsx:2761;R4b P4 对齐)page.tsx 静态常量,路由 /finance |交互:面包屑回上级浏览器开页标题可见生效
AC-EL-FIN-002错误横幅 @页首提示条data.error 时红条 role=alertuseFullBlock('hero') error 态;触发= /api/finance/full 非200断网/mock 观察生效
AC-EL-FIN-003⚠数据质量提示条 @页首提示条"N 个 SKU 缺采购成本映射(COGS按0计,毛利高估)"+去维护按钮/full 返回 unmapped_sku_count(cost CTE 中 coalesce(m.cost_rmb,pc.cost_rmb,0)=0 计数) |交互:按钮→/mapping构造缺映射 SKU 观察条出现生效
AC-EL-FIN-004平台选择器 @全局分段按钮Amazon/Noon 两枚,默认 amazon;无 all(2026-09-27 用户令砍掉)前端 state platform;控制 KpiSection 分支与页签可见性 |交互:切换重载noon 下 monthly/years 页签隐藏生效
AC-EL-FIN-005全局时间范围 @全局下拉全部/今年/本月/上月/近3月/近12月 6档timeParams 折算 mstart/mend 传 /full |交互:切档刷新请求参数随档变化生效
AC-EL-FIN-006财务 AI 分析师 @侧栏AI入口useAIContext('finance') 3 预设前端 hook 注入页面上下文 |交互:打开面板面板含财务预设生效
AC-EL-FIN-007盈利总览块 BlockBar @卡头筛选器国家pills+时间pills(7档+自定义起止date)独立 useFullBlock('hero'),参数 country/time |交互:pill 切换请求参数同步生效
AC-EL-FIN-008卡标题行 @卡头标题"盈利总览"+sub(品牌·Amazon·月·USD·环比)brand/platform/时间档拼装静态核对生效
AC-EL-FIN-009KPI卡1 净收款 @六卡KPINet Proceeds 值+Delta环比%+foot"未扣平台费·上月对比"/full rows.rev=Σrevenue_usd(未扣平台费);AC-CAL-01 起点项;环比=(当期−上期)/上期SQL Σrevenue_usd 同窗相等生效
AC-EL-FIN-010KPI卡2 结算净额 @六卡KPI值+Delta+foot"已扣佣金FBA促销"fin.net=rev−comm−fba−promo−other−vat;AC-CAL-01SQL 复算相减生效
AC-EL-FIN-011KPI卡3 毛利润 @六卡KPI值+Delta+毛利率footgross=net−ad;毛利率=gross/rev;AC-CAL-01复算生效
AC-EL-FIN-012KPI卡4 净利润 @六卡KPI值+Delta+净利率foot;底色正绿负红net2=gross−cost;cost=件数×(sku_mapping.cost_rmb 回退 procurement)÷RMB_USD(2026-09-26 C批P1-6 拍板);AC-CAL-01复算+正负换色生效
AC-EL-FIN-013KPI卡5 广告 @六卡KPI广告花费+广告销售 foot+上月ads=cleaned_ads_sku_daily ∪ cleaned_amazon_ads_daily 双源并集(P1-17/18 修)双源并集复算生效
AC-EL-FIN-014KPI卡6 平台回款 @六卡KPIPayout+foot"Settlements 月度打款"pay=Σcleaned_amazon_settlement_monthly.payout_usd;AC-CAL-08 回款层SQL 对表相等生效
AC-EL-FIN-015瀑布 flowbar @①资金流水卡图10步(用户令 2026-10-29「GMV 佣金 尾程 广告 采购 vat(vat无值可以是0)都要加到瀑布」):GMV(净收款)→−佣金→−尾程(FBA)→−促销及其他→−VAT→结算净额→−广告→毛利→−采购→净利润GMV(净收款)=Σrevenue_usd;佣金/尾程/VAT=order_fees.commission/fba/vat 原值直读(VAT 无值=0);促销及其他=平台费(rev−net)−佣金−尾程−VAT 余额项(四步恒等旧平台费一步,#55b 链数值不变);后段 #55b:结算净额−广告=毛利、毛利−采购=净利润;每步 title 源注+卡底「瀑布口径」显性行;API 零改动(matrix commission/fba/promo/vat 原值列)末值=净利润 KPI;十步代数和=首值;verify_finance 瀑布断言生效 reg:id43
AC-EL-FIN-016底部指标行 @卡底指标条7项:订单/销售件数/取消订单/退款件/ACOS/TACOS/VAT订单=aord FILTER 剔取消三变体(AC-CAL-02);取消=can WHERE order_status='Canceled' 单变体;退款件=ret Σunits;ACOS=ad/ad_sales、TACOS=ad/rev 均 mon_ratios 后端单源(C3批#60);色=阈值 API /api/metric-thresholds(AC-CAL-06 健康线);VAT=order_fees.vat 官方税额SQL 复算+阈值改 API 色变生效
AC-EL-FIN-017分市场块 BlockBar @卡头筛选器国家+时间 pillsuseFullBlock('ckB') |交互:同007同007生效
AC-EL-FIN-018月份下拉 @卡头下拉2026-01→当前月,默认最新月由 rows 月份集合生成;控制 kpi-wall mon 参数 |交互:切月刷新参数同步生效
AC-EL-FIN-019分市场表 @卡体表格表头18列:市场/订单/已结算/销售件数/在途 Pending/取消订单/本土币营收/净收款/佣金/尾程配送FBA/结算净额/广告/VAT/毛利润/毛利率/采购成本/净利润/回款;行=全市场+countries;本币列显 local 无则USD;采购成本原生 RMB¥;净利润全程 USD/api/finance/kpi-wall;订单=aord 剔取消(AC-CAL-02);已结算=has_finance 计数;取消=can 'Canceled';在途=ship CTE 分国 count(order_status IN ('Shipped','Exported'),五态归并与 WallRow.pending 注释/Noon 六态同口径)+全市场行 aord FILTER 计数。

2026-10-22 补翻换绿:表头已补「在途 Pending」(finance/page.tsx:729,表头 18=行渲染 18),_gate_fin_th_20261022 门禁已过;待核① 系早间修复后本行漏翻,今对账补正。

2026-10-31 R4b P2-2 落地(用户拍板「补 Shipped/Exported 计数」):在途列补真源——此前表头在而数据恒 0(后端 amz_countries/amz_all 无 pending 键,page.tsx r.pending ?? 0 兜 0);修=finance.py ship CTE+全市场 FILTER 计数;DB 锚点 zf 2026-09 Shipped=367;h2 sub 同批加在途口径+MCF 披露注「件数含站外履约件(MCF·Non-Amazon,revenue 计 0)」(MCF 件数拍板=维持计入+披露注) |交互:行悬停
th 数=td 数;抽行 SQL 复算生效
AC-EL-FIN-020Amazon 销量柱状图 @卡体图Orders bar+Net Profit line,dataZoom同 kpi-wall 月份序列 |交互:缩放图值=表值生效
AC-EL-FIN-021Annual Summary 卡 @卡体表格10列:产品/订单/件数/净收款/结算/广告/毛利润/净利润/毛利率/Net per Unit;空态"无数据"kpi-wall annual 段(按产品年聚合)年合计=12月和生效
AC-EL-FIN-022页签行 @主区tabs5枚:品牌月度矩阵(默认)/📈盈利矩阵/产品损益/月度对账/年度对比前端 state tab;monthly/years 仅 amazon 渲染 |交互:切tabnoon 下仅3枚生效
AC-EL-FIN-023趋势块 BlockBar @卡头筛选器国家+时间 pillsuseFullBlock('trendB') |交互:同007同007生效
AC-EL-FIN-024月度营收·净利·回款图 @卡体双轴图月度营收 bar+净利润 line+回款 dashed line/full matrix 段逐月 rows与027表逐月相等生效
AC-EL-FIN-025费用结构堆叠图 @卡体堆叠图佣金/FBA/促销/广告/VAT 五层同上字段五层和=净收款−其他费生效
AC-EL-FIN-026矩阵卡 BlockBar+年份下拉+导出 @卡头筛选器/按钮国家+时间 pills;年份下拉;导出ExceluseFullBlock('mxB');导出=前端xlsx |交互:导出文件行数=表行数生效
AC-EL-FIN-027品牌×月度全维度矩阵 @卡体表格23列:月份/品牌/订单/已结算/销售件数/取消订单/有效订单/净收款/佣金/FBA/促销/广告/广告销售/ACOS/TACOS/VAT/采购成本/结算净额/毛利润/毛利率/净利润/回款/退款件/full matrix:订单=aord 剔取消(AC-CAL-02);有效订单=订单−取消 前端派生;gross=net−ad;ACOS=ad/ad_sales;TACOS=ad/rev;AC-CAL-01 |交互:导出Excel抽1月 SQL 复算全列生效
AC-EL-FIN-028分市场 KPI 卡 @卡体表格8列:市场/币种/订单/销售件数/本地营收/本地VAT/本地净利润/净利润率;最新月份;导出Excel/full countries 块(源表直读,2026-09-18 注释:finance_monthly 漏 onno 不用);local_net=local_amount×(net_usd/revenue_usd) 拍板折算;订单剔取消两变体 |交互:导出折算公式复算;币种=marketplace 本币生效
AC-EL-FIN-029资金流水瀑布(noon 侧) @①资金流水卡图10步(v2 起 noon 渲染自有资金流水卡,用户令同 015):GMV→−佣金→−尾程→−其他平台费→−VAT 0→结算净额→−广告→毛利→−采购→净利;SA·SAR / AE·AED 各一行本币GMV/佣金/尾程=PL 月表 gmv/commission/delivery_fee 原值(负值列聚合端取绝对值,#56 同市场同币跨品牌求和);其他平台费=GMV−佣金−尾程−结算净额 差额闭合项(其他订单费/非订单费/补贴/credits/noon 未列项);VAT 恒 0 展示=noon 无官方 VAT 列、税内嵌含税费用列不重复扣(vat_est 法率推算仅 VAT 并列卡不入链);结算净额=官方 settlement 列原值(非派生,残差实证 audit.html 9.85①);后段 #55b 同 015;每步 title 源注+卡底「瀑布口径」显性行

2026-10-29 拍板改源(用户裁定「对齐月度经营总表」):−广告=广告日表 spend_local×(1+VAT) 含税实扣(#55b/noon-ops 同源同系数;原 PL 月表 ad_cost 列退役——原始报表层 2026-02~06 归集缺口全 0,SA/AE 同构);−采购=cost_local=有效件(件−取消−未妥投−CIR)×采购价折本币(#55b 同基,原全部件×成本)——资金流水与「累计·分市场」表净利同源一致(原差 SA −170,804 SAR/AE −51,264 AED 消除)

2026-10-29 同日续拍板三连(9.89/9.90):①默认时间档「全部时间」→「今年」(page.tsx timeRange useState 初始值)——窗口差非口径差(全部=35个月和 221,128 vs 今年=2026段 206,456 SAR);②数据覆盖警示:/full 下发 noon_pl_gap/noon_ads_gap 两表直读对账(PL=有订单月∩无正GMV月;广告=有正GMV月∩无广告日表月),MF 注脚 ⚠ 按与当前窗口相交才渲染(今年档无);同批修滚动档漏传 months 缺陷(近3/12月原拿全历史,近12月 SA 净利 221,128→311,511 更正);COGS 快照起点注脚改无条件常显(noon_cost_cov 由 ncov 直出);③全部档窗口截断起点 _NOON_TRUST_START="2025-02"(拍板「截到 2025-02 起」,audit 9.90):/full 无窗口(_tp 空∧_mstart 空)时 noon 行 mon≥2025-02——此前 PL 残缺月(2023-12~2024-11 仅退换残行 GMV 全 0)/疑点月(2024-12 残缺 1,646 件仅 8,795 GMV;2025-01 广告日表仅单日 239,181 无法核实)不入瀑布;显式窗口(今年/单月/滚动)不受限,单月档仍可查明细;全部档 SA 净利 221,128→742,608 SAR / AE 177,308→330,369 AED;MF 注脚披露「全部档自 2025-02 起」
双市场十步代数闭合;本币不混(SAR/AED 分行);verify_finance noon 瀑布断言生效 reg:id44
AC-EL-FIN-030Noon SKU P&L 卡 @主区卡国家/月份/型号 3筛选下拉+21列 SKU 表(本币)+caliber 说明+SKU 销量柱状图(型号堆叠 bar+Units line+GMV dashed,dataZoom)/api/finance/noon-pnl;源 cleaned_noon_monthly+noon_statement+noon_sku_status+noon_sku_pl_monthly+noon_ads_daily+noon_sku_ads;VAT 推算 SA 15/115 AE 5/105;AC-CAL-05/12 |交互:下拉筛选本币列标注 SAR/AED 不混生效
AC-EL-FIN-031Noon SKU 深度表 @主区表格年份pills(今年/去年/前年)+国家下拉(全部/SA/AE)+汇总行(行数/订单/GMV/广告/净利润)+44列 NOON_SPEC+caliber+DataTable(排序/筛选/CSV/Excel,minWidth 3400)/api/finance/noon-sku?year&country;源 cleaned_noon_sku_status+sku_pl_monthly+noon_ads_daily;金额列头加(本币)后缀(2026-10-03 用户令),汇总行=USD;ACOS>50/TACOS>30 红色;margin 正绿负红;待核②:卡头文案"39 列深度表" vs NOON_SPEC 实际 44 项 → 文案与代码不符。

2026-10-22 补翻换绿:卡头文案已改「Noon SKU 表现 · 44 列深度表」(finance/page.tsx:966,「39 列」全文件 0 处),_gate_lst3_fin49_20261022 门禁已过;待核② 系早间修复后本行漏翻,今对账补正 |交互:pills/下拉/排序/导出
导出列数=44;文案列数核对生效
AC-EL-FIN-032Noon 产品×月损益卡 @主区表格18列:月份/品牌/国家币种/订单/Del/Ship/Canc/Und/GMV本币/GMV折USD/佣金/履约/广告/VAT推算/Cost$/结算净额/TACOS/Mgn;BlockBar(SA/AE);导出Excel/api/finance/noon-ops;GMV折USD=fx 换算(AC-CAL-05);本币/USD 两列并存 |交互:pills/导出两币列不混生效
AC-EL-FIN-033Noon 账户余额卡 @主区表格6列:月份(·派生标记)/品牌/市场/期初/打款/期末;BlockBar;导出Excel/full noon_balances;cleaned_noon_statement DISTINCT ON (market, stmt_month);AC-CAL-08 |交互:pills/导出期初(n)=期末(n−1) 链条守恒生效
AC-EL-FIN-034期间下拉 @卡头下拉期间6档(今年/本月/上月/近3月/近12月/去年)+单月24项OPS_PERIODS+periodRange(单月窗口=[月,月],NoonStatement.tsx) |交互:切换刷新参数同步生效
AC-EL-FIN-035GMV 月柱状图 @卡体图SA(SAR)/AE(AED) 双 bar 本币跨品牌/api/noon/summary;AC-CAL-12 禁跨币直加,图例分币种两币不合并生效
AC-EL-FIN-036环比图 @卡体图SA/AE 环比% 双 line(当月−上月)/上月 分市场;#56b 修复=前置月纳入窗口首月环比可算生效
AC-EL-FIN-037官方对账单 26字段表 @卡体表格粒度tabs(M/Q/Y)+期间下拉;26列=8基础(月份/品牌/市场/期初/净入账/总费用/打款/期末)+8费项×(含税,VAT)(ads广告/referral佣金/fbn出库/returns退回退款/warranty保修/ret_admin退货管理/damaged破损退/promo促销)+银行转账+余额转账/api/noon/summary;cleaned_noon_statement;VAT 内拆 SA=15/115 AE=5/105;银行/余额转账=钱包划转非应税;聚合规则=期初取期内首月/期末取末月/其余 SUM_KEYS 求和;全量口径不随品牌筛选(脚注披露);数据层=SOA totals 全账户层 reg:id49(noon+nooninstant+fbn 合同合并;打款=账户级=银行转账·合同间余额划转不入;覆盖 2024-01 起·2026-10-30 拍板 v2) |交互:tabs/下拉M→Q→Y 聚合守恒(期初期末取端点)生效
AC-EL-FIN-038月度经营总表 20字段表 @卡体表格3标签列(月份/品牌/市场)+17指标列:Orders/Units Sold/Valid Units/Delivered/Pending/Cancel Order/未妥投/CIR/GMV/Commission/Delivery/Ad Spend/Gross Profit/COGS/Net Profit/Settlement净额/Payout;两段口径脚注/api/finance/noon-ops;Orders=订单号去重;六态口径(Valid/Delivered/Pending/Cancel/未妥投/CIR);广告含 VAT 对齐;COGS=Valid×单价;Payout=对账单打款去重求和;gross=结算−广告;net=gross−cogs |交互:下拉脚注公式逐列复算生效
AC-EL-FIN-039行维度 chips @卡头chips国家/产品/品牌/api/finance/profit-matrix dim 参数 |交互:切换重载参数同步生效
AC-EL-FIN-040平台 chips @卡头chips全部折USD/Amazon/Noon前端 plat state 客户端过滤(不落请求参数;全部=mxMerge 客户端两平台折 USD 融合 AC-CAL-05,page.tsx:93;R4b P4 对齐:原记「plat 参数」与码不符) |交互:切换融合行=两平台和生效
AC-EL-FIN-041汇总条 @卡头汇总近N月·维度行数+CountryPills+六指标(Revenue/毛利润/广告/VAT/成本/净利润)+净利润率进度条/profit-matrix pm-stat 段 |交互:pills六指标=列合计生效
AC-EL-FIN-042口径说明行 @卡头脚注单元格=净利润热力(绿赚红亏深浅∝金额);毛利=结算净额−广告;净利=毛利−COGS(头程恒0);Noon 折 USD静态披露与后端公式一致生效
AC-EL-FIN-043热力矩阵表 @卡体热力表行=维度值+平台来源标;列=逐月净利润(热力色)+合计净利润+毛利率;hover tip 9指标构成/profit-matrix:ord=orders×fees sku_list unnest × sku_mapping 定维;ads 双源并集;cost 同012 |交互:hover/点击行下钻抽1格 SQL 复算生效
AC-EL-FIN-044下钻明细 @行展开表格13列:月份/订单/件数/营收/结算净额/广告/VAT/毛利/成本/净利润/毛利率/Amazon/Noon同端点 drill 段,双平台分列 |交互:展开明细和=行合计生效
AC-EL-FIN-045合计行 @表底合计逐月合计热力+总净利润+总毛利率列聚合合计=列和生效
AC-EL-FIN-046显示更多 @表底按钮15 行→+30前端分页 |交互:点击行数递增生效
AC-EL-FIN-047平台子tabs @卡头tabsAmazon USD / Noon 本币platform 子 state,随顶部 |交互:切换币种标注切换生效
AC-EL-FIN-048RangePills @卡头筛选器时间档 pillstimeParams |交互:切换参数同步生效
AC-EL-FIN-049月份下拉+搜索 @卡头筛选器月份 select+SKU/标题搜索框+搜索按钮q 参数(SKU/标题模糊) |交互:输入+回车/按钮命中集变化生效
AC-EL-FIN-050排序下拉 @卡头下拉6 种 PL_SORTS(net/net_asc/revenue/margin/units/sku,page.tsx:273-277),仅 amazon 显示(R4b P4 对齐:原记 5 种漏 net_asc)sort 参数 |交互:切换首行随排序变生效
AC-EL-FIN-051Amazon 14列表 @卡体表格SKU/标题两级行头+品牌/订单/件数/退款件/净收款/佣金/FBA/广告/VAT/毛利润/毛利率/采购成本/净利润/api/finance/product-pl?platform=amazon;gross/net2 后端下发;USD |交互:排序/翻页抽行复算生效
AC-EL-FIN-052分页器 @卡底分页共N行·第x/y页·月份+上一页/下一页;20行/页limit=20 offset |交互:翻页行数=20生效
AC-EL-FIN-053Noon 10列表 @卡体表格SKU/品牌/市场/订单/GMV/佣金/履约/广告/VAT推算/结算净额;SAR/AED 本币标注/product-pl?platform=noon;AC-CAL-12 |交互:翻页本币不混生效
AC-EL-FIN-054年份 pills @卡头pills全部+数据年份year 参数 |交互:切换参数同步生效
AC-EL-FIN-055RangePills @卡头筛选器时间档timeParams |交互:切换同上生效
AC-EL-FIN-056口径说明 @卡头脚注账单总额=平台账单;结算到账/打款=Settlements 月度;差额=对账缺口AC-CAL-07 fm 三方对账(与订单层两条口径,差值带标签披露)与注册表口径一致生效
AC-EL-FIN-057项目×月对账表 @卡体表格17列:月份/项目(品牌)/订单/退款单/营收/退款/佣金/履约/VAT/其他费/净利润/账单总额/结算到账/差额/打款/差额/广告;两差额列 |差|>1 标 warn 色/api/finance/monthly差额=账单−结算 代数复算生效
AC-EL-FIN-058Noon Model×月表 @卡体表格12列:月份/品牌/国家币种/型号/订单/GMV/佣金/履约/广告/广告销售/VAT推算/结算净额;本币/monthly noon 段;AC-CAL-05/12本币列核对生效
AC-EL-FIN-059BlockBar @卡头筛选器国家+时间 pillsuseFullBlock('yrB') |交互:切换参数同步生效
AC-EL-FIN-060年度图 @卡体图营收 bar+净利润 line+VAT dashed/full years 段与表一致生效
AC-EL-FIN-061年度对比表 @卡体表格6列:年份/订单/营收USD/净利润USD/净利率/VAT USD;导出Excel/full years;净利率=净利/营收 |交互:导出抽年复算生效
AC-EL-FIN-062页面级口径脚注 @页脚脚注"官方财务结算事件聚合…"披露文本静态文本在渲染中生效
AC-EL-FIN-063四维矩阵分析卡 @页脚卡平台×国家×品牌×SKU MatrixSection在 /full 数据外独立;full 加载失败也恒渲染;2026-09-14 用户指定置底断 API 仍渲染生效
AC-EL-FIN-064CustomModules @页尾模块区page="finance" 自定义模块前端组件按 page 键渲染配置模块出现生效

源码实证注记:- 全部条目源自上述三文件实读;未实测浏览器渲染。 - 待核①(019):kpi-wall 分市场表 th17 vs td18 错位 —— 需浏览器/ DOM 验收确认(候选缺陷,勿凭代码定罪)。 - 待核②(031):卡头"39 列" vs NOON_SPEC 44 项 —— 文案数字与代码不符。 - 待核③(027 有效订单 vs 016 订单):027 有效订单=订单−canceled('Canceled'单变体) 前端派生;016 订单=aord 三变体 FILTER。同义不同实现,canceled 仅 'Canceled' 变体时两值相等(实测 2026-10-22 仅 'Canceled'×2670),差异归 AC-PEND-02 统一。 - 大表逐列明细以源码列定义为准(027→23列、031→44列、037→26列、038→20列、057→17列),父任务转 AC-EL 条目时逐列展开。

§11.7 Noon 平台页(/noon · AC-EL-NOON,源码 web/app/noon/page.tsx + NoonStatement.tsx;2026-10-22 校对修正版 v4.4)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-NOON-01页标题/面包屑静态「Noon 平台 · 中东 Noon · 月度财务(原币口径)+ 官方对账单」AppShell 面包屑e2e 文案断言生效
AC-EL-NOON-02错误横幅反馈接口失败红条err ← catchrole=alert生效
AC-EL-NOON-03无数据空态空态「当前品牌无 Noon 数据」居中卡months 与 statements 均空时整页空态(/api/noon/summary 空结果)纯 Amazon 品牌视角断言生效
AC-EL-NOON-04KPI·最新月 GMV(每币种一张)KPI卡最新月 GMV + 订单/件数/费用 footlatest=mons 末位;months=audit.cleaned_noon_monthly(RLS 企业域,不随全局品牌筛选);money()=「CUR N,NNN」千分位 0 位(NoonStatement.tsx)SQL 最新月 gross 对拍(按币种分行)生效
AC-EL-NOON-05KPI·累计(每币种一张)KPI卡全期累计 GMV + 累计打款/费用 footΣ gross / Σ payouts / Σ fees 按币种分列(未采集月按 0 计入,口径披露在明细表)SQL Σ 对拍生效
AC-EL-NOON-06全局时间窗条筛选全部 / 近6月 / 近12月 / 近24月win=月数(0=全部),windowMons=mons 尾部 N 月;与看板 Noon 墙同款月窗语义;单击切换切近6月→图表/摘要月数=6生效
AC-EL-NOON-07窗口摘要(#noon-window-strip)状态「窗口 X(N 个月)· CUR: GMV n · 净额 n」(每币种一段)id=noon-window-strip(e2e 断言锚点);GMV=Σ gross、净额=Σ(gross+updates−fees)(窗口内;未采集费用月净额未扣费用)e2e 断言 id 文案;SQL 窗口 Σ 对拍生效
AC-EL-NOON-08月度 GMV 趋势卡图表ChartCard 双轴柱:每月×币种柱(AED=#4f46e5 左轴 / SAR=#0e9384 右轴)cleaned_noon_monthly per (mon,currency);sub「原币口径(AED=阿联酋 / SAR=沙特,未折 USD)」=AC-CAL-05;独立日期区间三态(global/独立/清除);CSV=noon_gmv(月份×币种矩阵);区间选择/CSV/tooltip 交互SQL 月×币 gross 对拍生效
AC-EL-NOON-09月度净额趋势卡图表每月净额柱(同上双轴)netOf=gross+updates−fees(客户端同式);sub「净额 = gross + 冲回 − 费用(原币口径)· 未采集费用月净额未扣费用」;CSV=noon_netSQL netOf 复算生效
AC-EL-NOON-10主页签组页签📊 财务概览 / 💬 评论 / 👁 流量转化noonTab state;默认财务概览;单击切换e2e 三 tab 断言生效
AC-EL-NOON-11月度财务明细表表格月度×品牌×币种明细,列可排序/筛选,CSV+Excel 导出rows=months 全量;exportCsv/exportExcel=noon_monthly;caliber=「金额=本币(SAR/AED 按行币种)|gross=订单入账 · 冲回=order_update · 净额=gross+冲回−费用|数据源=noon_monthly|未采集=首费用/打款交易月之前月份」;空态=无数据导出文件行数=months生效
AC-EL-NOON-12明细表·列「月份」列YYYY-MMmon;text 筛选—生效
AC-EL-NOON-13明细表·列「品牌」列色点+品牌名brandColor 色点(AC-UI-07);排序/筛选—生效
AC-EL-NOON-14明细表·列「币种」列AED/SARcurrency;筛选—生效
AC-EL-NOON-15明细表·列「订单」列整数orders;num 筛选—生效
AC-EL-NOON-16明细表·列「件数」列整数items;num 筛选—生效
AC-EL-NOON-17明细表·列「GMV」列加粗本币money(gross, cur) 0 位;num 筛选—生效
AC-EL-NOON-18明细表·列「冲回」列muted 本币updates(order_update 类交易);num 筛选—生效
AC-EL-NOON-19明细表·列「费用」列「未采集」或本币uncov(m)=mon<fee_cov[brand|currency] → 显「未采集」(muted);否则 money(fees);fee_cov 真源=源库 transactions 首个 statement_fee/payment/balance_transfer 交易月(finance.py:266-295,R4b P3-6 行号核正;API 直读源库,失败回落 cleaned 首个非零月启发式);num 筛选fee_cov SQL 复算;早月显未采集断言生效
AC-EL-NOON-20明细表·列「净额」列绿色本币 + * 标netOf=gross+updates−fees;uncov 带「*」=未扣费用;num 筛选复算生效
AC-EL-NOON-21明细表·列「打款」列「未采集」或本币payouts;uncov 判定同 AC-EL-NOON-19—生效
AC-EL-NOON-22未采集脚注脚注「未采集」语义说明+行数(uncovCount>0 时显示)「=该品牌×币种首个费用/打款交易月之前月份…非真零;净额带 *=未扣费用(=毛额+冲回)。R9 扩采回填后自愈。共 N 行」行数=SQL uncov 计数生效
AC-EL-NOON-23官方对账单表(statements 非空)表格月×品牌×市场全分项对账单,8 费项×(含税,VAT) 双层表头;粒度 tab 月/季/年+期间下拉(R4b P3-5 同步)数据=audit.cleaned_noon_statement DISTINCT ON (brand,market,left(stmt_month,7)) 归一去重(双格式月份);行序=reverse(最新月在前);金额 money() 0 位无币种前缀(市场即币种:SA=SAR/AE=AED,AC-CAL-12 本币分列);只读表;26 字段原序=月份|品牌|市场|期初余额|净入账|总费用|打款|期末余额|8费项×(含税|VAT)|银行转账|余额转账;粒度聚合=客户端 STMT_GRAINS M/Q/Y(源恒月粒度行):期初/期末取期内首/末月原值、其余列(净入账/总费用/打款/8费项/银行转账/余额转账)期内求和(季/年=月值求和)、VAT 不聚合渲染层按市场税率内拆(NoonStatement.tsx aggregateStmts);期间下拉=OPS_PERIODS inWindow 过滤(AC-EL-FIN-C-102 同源)(brand,market,mon) 无重复行 SQL 断言生效
AC-EL-NOON-24对账单·汇总块列组列组月份/品牌/市场/期初余额/净入账/总费用/打款/期末余额opening_balance/net_proceeds/total_fees/payouts/closing_balance 快照值;净入账 strong;粒度/期间语义同 AC-EL-NOON-23(aggregateOps 同规则:季/年=月值求和、期初期末取首末月)(R4b P3-5 同步)Σ net+fees−payouts=closing−opening 抽行复算生效
AC-EL-NOON-25对账单·8 费项含税列组列组广告费/佣金/FBN 出库/退回退款/保修/退货管理/破损退/促销(各=含税实扣)STMT_FEES 顺序(NoonStatement.tsx);值=快照原值(贷记冲减为正、扣款为负);muted 样式与源单字段对拍生效
AC-EL-NOON-26对账单·VAT 内拆列组列组每费项右列 VAT(绿显)前端 vat=v×STMT_VAT_RATE[market](SA=15/115、AE=5/105 内拆系数,#47 拍板;noon 无官方税额列);v=null→「—」抽行 v×系数复算生效 reg:id20
AC-EL-NOON-27对账单·转账双列列组银行转账/余额转账bank_transfer/balance_transfer=钱包划转非应税—生效
AC-EL-NOON-28对账单脚注脚注原币未折 USD + 去重说明 + 品牌过滤边界「对账单为平台原币口径(未折 USD);官方账单快照;同月按(品牌×市场)归一(双格式月份已去重);本页暂不随全局品牌筛选」文案断言生效
AC-EL-NOON-29评论 KPI 六卡KPI卡总评论数(accent) / 平均评分(≥4 绿 else 橙) / 好评率(4-5★ 绿) / 差评率(1-2★ 红) / 如实描述✓ / 与描述不符✗(红)/api/noon/reviews-analytics:源库 {schema}_seller_reviews 全量(本企业 noon 品牌聚合,qsource 直读);total=有效评分数、avg=round(均值,2)、positive_pct/negative_pct=round(pct,1)、as_described 布尔计数;随品牌筛选刷新analytics 复算对拍生效
AC-EL-NOON-30评分分布卡图表5→1★ 分布横条(≥4 绿/3 橙/≤2 红)dist=Counter(rating);条宽=count/total×100%;右端计数分布 Σ=total生效
AC-EL-NOON-31评论趋势(月)卡图表月度评论数柱(CSS 柱图,非 EChart)trend=substring(review_date) 计数;柱高=count/max×80px(min 4px);title 悬停「mon: n 条」;x 标签旋转 −45°trend SQL 对拍生效
AC-EL-NOON-32评论最多 SKU Top15表格SKU×评论数 Top15sku_count Counter 取 15;SKU 截 25 字符对拍生效
AC-EL-NOON-33评论卡标题+sub标题「卖家评论 · N 条全量 · noon reputation API 自动拉取」total 同 AC-EL-NOON-29;「757 条(365 天窗)」为写死固定文案(历史快照数字)——待核①:采集扩窗后总数变化文案不随动,验收以 API total 为准,缺陷候选;只记录未拍板。

2026-10-22 换绿:写死「757 条」实仅评论表脚注一处(本行描述的标题/sub 本已动态绑定 total);脚注已改 {total} 动态绑定(noon/page.tsx:175,与头卡/标题同源 reviews-analytics total),采集扩窗后文案随动,验收仍以 API total 为准——探针 PASS(757 清零/动态「N 条(365 天窗)」在场)+frontend_e2e ALL PASS(tools/_gate_noon3_pipe_20261022_frontend_e2e.log)
文案断言;写死 757 vs API total 差异核生效
AC-EL-NOON-34评论品牌筛选筛选全品牌 + 本企业 noon 品牌 tabnoonBrands=info.noon_brands(brands_source 注册表 platform='noon')∩ brands(H9 2026-10-13 单源,不散写 zipforce/onno)=AC-UI-02 同族;单击重拉两接口注册表 vs 按钮 presence生效
AC-EL-NOON-35评论评分筛选筛选全部 / 5★…1★rating=精确等值(SQL r.rating=N);0=全部;单击重拉5★ 列表全 5★ 断言生效
AC-EL-NOON-36评论搜索框筛选「搜索评论内容或 SKU…」客户端过滤comment/sku toLowerCase includes(不重拉,本地过滤当前 200 条)输入无结果词→0 条生效
AC-EL-NOON-37评论计数状态「N / M 条」filtered.length / items.length;随筛选更新—生效
AC-EL-NOON-38评论列表表表格7 列:日期/评分/评论/SKU/订单/国家/描述date='DD Mon YYYY' 原文;评分=★repeat(rating)(≥4 绿/≤2 红/3 橙);comment 服务端截 200 字符;sku 截 20;country upper;as_described true/t→✓ false/f→✗ else —;ORDER BY to_date(review_date,'DD Mon YYYY') DESC(2026-10-10 修字典序乱序);limit≤200;容器 maxHeight 500 滚动首行日期≥次行断言生效
AC-EL-NOON-39评论表脚注脚注「数据源=noon-reputation seller-reviews · 757 条(365 天窗) · 评分/评文/SKU/订单号/如实描述 · 每日刷新」静态文案——待核①(同 AC-EL-NOON-33):「757 条」写死不随采集扩窗变化;只记录未拍板。

2026-10-22 换绿:脚注 757→{total}(page.tsx:175 绑定 reviews-analytics total,与 NOON-33 同源同修);文案随采集扩窗自动变化;探针+门禁记录同 NOON-33
文案断言;与 API total 差异核生效
AC-EL-NOON-40流量国家筛选筛选全部 / AE / SAcountry → SQL upper(country_code) 等值;days 固定 30(API 上限 90);单击重拉—生效
AC-EL-NOON-41SKU 流量表现表表格7 列:SKU/浏览量/总浏览(含竞品)/出货/营收/Buy Box%/转化率%/api/noon/catalog-sales:源库 {schema}_catalog_sales(Impex productviewsandsalesdata)visit_date≥today−30;前端按 SKU 聚合:v/tv/s=Σ,bb/cv=日均均值(Σ/n),r=Σ revenue_shipped(本币,toLocaleString 0 位,未折 USD——AC-CAL-05 披露);排序营收 DESC top30;总浏览 0→「—」;转化率>3 绿;SKU 截 25;API LIMIT 200——待核②:营收列未随行标注币种(AE 行 SAR 行混排仅本币数字,依赖读者知道市场=币种);只记录未拍板。

2026-10-22 换绿:口径修复=聚合键 sku→市场|SKU(新增「市场」列),营收列随行 AED/SAR 后缀;顺带修复比原披露更重一级的真缺陷——原「全部」页签把 AED 与 SAR 直接 Σ(违反本币不可跨币种相加惯例);排序仍按本币数值(跨币种排序近似,AC-CAL-05 未折 USD 披露继续适用);h2 sub 补「按市场分行 · 营收本币(AED/SAR)」;探针 PASS(市场列在场/表头与首行 8=8/营收后缀 AED|SAR 在场)+frontend_e2e ALL PASS
源库 30 天 Σ 对拍生效
AC-EL-NOON-42流量表脚注脚注数据源与字段口径「数据源=Impex productviewsandsalesdata · 月窗(年窗会被 noon 静默截断) · 浏览量=Your_Visitors · 转化率=Conversion_Visitors_Percentage」文案断言生效

§11.8 选品页(/sourcing · AC-EL-SRC,源码 web/app/sourcing/page.tsx 2200 行 + sourcing.py)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-SRC-01KeepaTokenChip(tab 栏右端)chipKeepa token 池余额+今日配额常驻显示GET /api/sourcing/keepa-status,60s 轮询;tokens_left=最近一次真实调用后 Keepa 返回;今日配额=quota_limit−quota_used(套餐 PLAN_KEEPA_QUOTA);未返回显 —curl 端点返回 tokens_left/quota_used;chip 文本断言(数字非 …)生效
AC-EL-SRC-02主 tab 栏(页首)tab×11选品情报台/数据探索/AI选品/畅销榜/促销流/产品查找/类目树/价格历史/卖家/监控池/决策台mtab query state(useQueryState);默认 charts;交互:点击切 mtab;URL ?mtab= 深链curl /sourcing?mtab=explore 各 tab 渲染断言生效
AC-EL-SRC-03站点/国家 select(charts·工具栏)select15 站选择(COUNTRIES,chartCatalog 单源;批D 2026-10-25 语义抽检纠偏:原文 16 站含 IN 印度,git 史已删而数字未随改)本地 state,无请求;交互:切换即 ABA 模式自动重查(F2-1)e2e 切站点后图表刷新生效
AC-EL-SRC-04数据源 select(charts·工具栏)selectABA 词分析(快照+词库)/ Keepa 实时搜索(耗配额)双模式smode=aba|keepa;keepa 模式每次耗 1 配额不自动发;切回 aba 恢复一次免费重查e2e 切 keepa 后按钮文案含「耗」生效
AC-EL-SRC-05搜索词 input+datalist(charts·工具栏)input+补全精确搜索词;Keepa 模式=关键词补全:350ms 防抖 GET /api/sourcing/aba/terms?country&q(≥2 字符,前缀索引);空/失败回退 overview.terms 本地 Top50;交互:Enter 触发搜索抓包 /aba/terms 仅 ≥2 字符触发生效
AC-EL-SRC-06近 N 月 select(charts·工具栏)select月窗 3/6/12/18/24(默认 12),仅 ABA 模式传 /api/sourcing/explorer?months=;交互:切换即自动重查(ABA)—生效
AC-EL-SRC-07搜索按钮(charts·工具栏)button双文案:aba「搜索并生成图表」/keepa「搜索 Keepa 实时库(耗 1 次配额)」run() 分派 load()/keepaLoad();keepa 且站点无 KEEPA_DOM 时禁用e2e 按钮禁用态断言(AE/SA/SE+keepa)生效
AC-EL-SRC-08数据水位行(charts·卡内)脚注行ABA 快照/ABA 全库/Keepa 档案/机会雷达四源截至日期,超 3 天 ⚠️N 天前GET /api/sourcing/aba/overview meta(ba_search_terms_fetched_at/keepa_raw_fetched_at/radar_computed_at/snapshot_at);full=countries_n+last_period停更>3 天时 ⚠️ 出现(2026-09-26 E2)生效
AC-EL-SRC-09精确词未命中提示(charts·卡内)提示「精确词未命中,已按最接近的 X 显示」explorer 返回 term_exact=false 且 available输入近似词断言提示生效
AC-EL-SRC-10词宇宙死胡同卡(charts·卡内)卡本站无此词→自动级联 Keepa(有域)或明示无兜底(AE/SA/SE)+可搜词 chipsdata.available=false 触发 keepaLoad("cascade");country_terms chips 点击即以此词 load;交互:点 chip 换词搜索造无词断言级联触发+kres 渲染生效
AC-EL-SRC-11Keepa 实时搜索卡(charts)卡实时结果容器;级联触发时顶部 ⚡ 转向说明条件渲染 smode=keepa 或 kres/kLoading/kErr 存在—生效
AC-EL-SRC-12实时配额/来源行(实时卡内)脚注行⚡实时数据·站·今日剩余配额·匹配 N 个(显示前 M)·已并入池 P 条·🧊缓存命中(0 token)/api/sourcing/search 响应字段 quota_left/_finder_total/pooled/cached;缓存 10 分钟窗口二次同词检索断言 cached 徽标生效
AC-EL-SRC-13实时 5 KPI(实时卡内)kpi×5结果数/BuyBox 中位价/BSR 中位/平均评分/评论总数前端对 items 派生:中位数(buybox_price??price_new/salesrank)、rating 均值、reviews 求和;币种=首行 currencyJS 复算中位数 vs 显示生效
AC-EL-SRC-14实时商品表(实时卡内)表(14 列+#)商品[图36px/标题/品牌/ASIN viewer 深链/🛒 amzUrl 外链/卖家数/已监控]/Buybox/BSR[+subcat 副行]/30/90 掉榜/FBA 卖家/FBM≈[New−FBA 推算]/月销30[Amazon 近30日已购口径]/90均BSR/自营价/二手价/断货30/上架日期/评分/评论数/search 或 /finder+/enrich 全字段映射;BSR=大类口径,小类作副行;rankMode(畅销榜/AI)按 BSR 升序加 # 列;viewer 深链 SPA 无刷新(Ctrl/中键保留新标签);交互:行内 ASIN 点击→viewer;🛒新开 Amazon列头 tooltip 断言;ASIN 点击 mtab=viewer生效
AC-EL-SRC-15ABA 8 KPI(charts·KPI 行)kpi×8所选月份/ABA 有快照月[脚注]/理论席位(=快照月×3)/有效席位(Σappearances)/去重 ASIN/Keepa 覆盖[脚注 x/y]/品牌(大小写空白归一)/类目computeKPIs 前端算自 /explorer 响应(timeline+rotation);F2-4 已删恒重复的「有效 ASIN」卡复算 rotation Σappearances生效
AC-EL-SRC-16子 tab 栏(charts)tab×6ABA 图表[20]/Keepa 图表[39+22]/ABA×Keepa[32]/全部产品与原始行/分析报告总结/🎯机会雷达subtab query state;图表计数取 chartCatalog 常量—生效
AC-EL-SRC-17ABA 图表墙(charts·aba)图墙20 张 ABA 图(份额/趋势等)<ABACharts data>;GET /api/sourcing/explorer(aba_terms_full+aba_search_terms+aba_keepa_full);逐图清单在 charts/ABACharts.tsx+chartCatalog,需另册展开。

2026-10-22 换绿:另册已建=§11.38 SRC-AB 系列 20 条(v5.2 独立校对通过,图题逐字/行号/口径全核)
待另册逐图比对生效
AC-EL-SRC-18单 ASIN 39 图(charts·keepa)图墙rotation 选 ASIN 切换的单品 Keepa 图<KeepaSingleCharts rotation>;快照表无原始时序→历史类图仅窗口聚合近似(卡头明示);逐图清单在 charts/KeepaSingleCharts.tsx,需另册展开。

2026-10-22 换绿:另册已建=§11.39 SRC-KS 系列 39 条(v5.2 独立校对通过;含 5 张恒空卡 other-condition-prices/deal-events/coupon-events/seller-offers/content-assets 记为空态卡)
待另册逐图比对生效
AC-EL-SRC-19池级 22 图(charts·keepa)图墙全部去重 ASIN 聚合图<KeepaPoolCharts rotation>;逐图清单在 charts/KeepaPoolCharts.tsx,需另册展开。

2026-10-22 换绿:另册已建=§11.39 SRC-KP 系列 22 条(v5.2 独立校对通过)
待另册逐图比对生效
AC-EL-SRC-20ABA×Keepa 32 图(charts·joint)图墙联合图<JointCharts data>;逐图清单在 charts/JointCharts.tsx,需另册展开。

2026-10-22 换绿:另册已建=§11.39 SRC-JT 系列 34 条(v5.2 独立校对通过)——计数更正:JT 实为 34 图非本行原述 32(chartCatalog.ts counts.joint:32 注释过时,JointCharts.tsx 头注「34 图」为准;属源码注释文案候选)
待另册逐图比对生效
AC-EL-SRC-21搜索历史全字段台账(charts·raw)卡+表(10 列)+分页该站全部检索词席位 ASIN×Keepa 档案;列 ASIN/品牌/标题/BSR/drops30/drops90/monthly_sold/BuyBox/评分/评论GET /api/sourcing/aba/ledger?page&page_size(50/100/200);共 N·覆盖·缺计数;口径徽标 full+pool|本地企业池(scope 字段);2026-09-17 P0 修复=前端读 items+keepa 嵌套;交互:每页 select/查询按钮/上下页ledger total=SQL count;scope 徽标断言生效
AC-EL-SRC-22ABA 逐月原始行表(charts·raw)表(12 列)月份/状态(✓|缺月)/SFR/Top1-3(ASIN+点击%+成交%)explorer timeline 数据本地渲染,pct() 百分比格式与 aba_terms_full 抽行比对生效
AC-EL-SRC-23分析报告总结(charts·report)卡AI 总结当前词 ABA+Keepa 数据POST /api/ai/sourcing {country,term};每次耗当日 AI 配额 1;基于本地已抓数据;交互:生成/重新分析按钮配额扣减断言(调前后 quota)生效
AC-EL-SRC-24机会雷达五类 chips(charts·radar)tab×5📈上升词/🧩碎片化词/💎黑马 ASIN/🧺同购搭配/🔁复购 ASIN,各带 totalGET /api/sourcing/radar?country&limit=50(&offset 翻页);源表 aba_radar_rising/fragmented/gem/basket/repeat+aba_meta(radar_computed_at);期号/源计算日期在卡头;交互:点击切换 kindSQL count vs chip 数字生效
AC-EL-SRC-25上升词表(radar·rising)表(8 列)搜索词[可点击跳回 ABA 图]/当前排名/上期排名/变化[+绿]/Top1 ASIN/点击/成交/分数同 AC-EL-SRC-24 源表;rank_change>0 绿色;交互:词点击→setTerm+load+切 aba 子 tab抽行 SQL 复算生效
AC-EL-SRC-26碎片化表(radar·fragmented)表(6 列)词/SFR/碎片化分(3 位小数)/Top1 ASIN/点击/成交同 AC-EL-SRC-24 源表;交互:词可点击抽行 SQL 复算生效
AC-EL-SRC-27黑马表(radar·gem)表(7 列)词/SFR/ASIN/点击份额/成交份额/成交÷点击/分数同 AC-EL-SRC-24 源表;交互:词可点击抽行 SQL 复算生效
AC-EL-SRC-28同购表(radar·basket)表(7 列)ASIN/共购 1-3(ASIN+占比%)同 AC-EL-SRC-24 源表抽行 SQL 复算生效
AC-EL-SRC-29复购表(radar·repeat)表(4 列)ASIN/总订单/复购订单/复购率%同 AC-EL-SRC-24 源表抽行 SQL 复算生效
AC-EL-SRC-30雷达加载更多(radar 卡尾)button+脚注展示 Top N/共 M·加载更多服务端 offset 分页只并入当前 kindtotal 与行数关系断言生效
AC-EL-SRC-31页头说明(explore·卡头)脚注全部条件平铺直选·零下拉·选完点底部搜索静态文案—生效
AC-EL-SRC-32站点 chips(explore)chips×1313 站(KEEPA_COUNTRIES,Keepa 后端;非 charts 的 16 站)2026-10-06 F2/F3:AE/SA/SE 档案池永远 0 行已收窄;交互:点击切站选项数=13 断言生效
AC-EL-SRC-33数据范围三档(explore)chips×3⚡实时检索(默认,界面不出现 Keepa 字样)/📚全库(本地档案池 N 条)/当前词池(Top3 去重)GET /explore/fields?scope 拿 pool_total;2026-10-07 用户令默认 live;实时结果 UPSERT 增量并入 aba_keepa_full;交互:点击切 scope全库 chip 显示 pool_total生效
AC-EL-SRC-34live 提示条(explore·live)提示条琥珀底:配额规则+38 项条件在全库档生效说明静态—生效
AC-EL-SRC-35live 根类目 select(explore·live)select全类目(活跃榜)+根类目列表GET /api/sourcing/category-tree(源表 keepa_category_tax,2026-10-19 口径切市场公共维度)选项与 category-tree 响应一致生效
AC-EL-SRC-36live 关键词 input(explore·live)input占位=完整口径说明:纯词=Top30 快照;+任意筛选=自动切全市场条件检索(标题含词);留空=按筛选+类目检索2026-10-21 二次升级口径统一(bsr<80 只 2 个→条件全走 /finder)占位文案断言生效
AC-EL-SRC-37live 筛选行 1(explore·live)控件×18品牌(逗号分隔≤50)/价格类型(NEW|AMAZON|USED)/价≥≤/型号/颜色/尺码/评分≥≤/评论≥≤/月销≥/掉榜30·180·365≥/优惠券三态/秒杀三态组装 POST /finder body;任一筛选回车即检索输入+Enter生效
AC-EL-SRC-38live 筛选行 2(explore·live)控件×10BSR≥≤/卖家数≤/卖家≥/FBA 卖家≥/均价30·90≥/自营可购四态/BuyBox=Amazon 三态/排序(销量/价格↑↓/评论/月销)同 AC-EL-SRC-37;sort=sales 等输入+Enter生效
AC-EL-SRC-39live 更多筛选网格(explore·live)input×~40(7 组)价窗与价格$/排名与掉榜/报价库存/BuyBox 属性 9 布尔/产品标识 4/重量尺寸 9/时间 4白名单直通 extra 字段;价格型 ×100 分币转换;⚠️行披露实时源不可筛字段(180/365 全价型/reviews_avg90/卖家 ID/长尾属性/fetched_at)⚠️披露行存在断言生效
AC-EL-SRC-40实时检索按钮+脚注(explore·live)button「⚡实时检索(所有条件选完后点击, 耗 1 次配额)」+口径脚注(缓存 10 分钟)keepaSearch(0):纯词→GET /search;否则 POST /finder→/enrich 组装 kres(_byCat)抓包仅显式触发不自动烧生效
AC-EL-SRC-41站点不支持提示(explore·live)提示AE/SA/SE 无数据源提示+按钮禁用KEEPA_DOM 映射缺切 AE 断言生效
AC-EL-SRC-42kwNote 动态口径行(explore·live)脚注快照模式:「TopN 已按筛选过滤 X→Y · 未生效(需清词走条件检索): 字段清单」;条件模式:命中 N 个第 M 页;修改后:「已修改——回车重查(10 分钟缓存)」kwApply 纯前端过滤(0 配额)+skipped 字段清单派生;_fsig 与 filterSig 比对检测已修改改筛选后提示行断言生效
AC-EL-SRC-43live 结果区+分页(explore·live)结果区KeepaLiveResults+LiveCharts+上一页/第 N 页/共 ≤200 页/下一页/finder page 翻页(50/页,上限 200 页);交互:翻页按钮翻页请求 body.page 断言生效
AC-EL-SRC-44LiveCharts 实时图墙(explore·live)图墙 19 项10 分布 bar(价格/BSR 对数/评分/评论对数/月销/卖家数/FBA/掉榜30/90均BSR/断货30)+7 散点(价格×BSR/评分×评论/掉榜×BSR/评论×BSR/价格×评论/当前×90均BSR)+上架年份 bar+BuyBox 自营占比大数字卡(>30% 红)+品牌构成 pie(Top8+其他)纯前端聚合 0 token;样本 <3 不渲染该图;n= 计数在卡头抽一图桶计数 JS 复算生效
AC-EL-SRC-45字段组筛选墙(explore·all/pool)控件组×17 组 38 项GROUP_HINT 17 组提示(标识/类目排名/价格/报价库存/评论评分/费用尺寸/快照时间/R1~R10 扩采集)/explore/fields 返回 groups+labels(类目 ID→可读名 reference↔display_group);FieldControl 四型:bool 三态/枚举 chips(低基数优先于数字,2026-09-26 C 修)/number ge~le/date 起~止/text like(### 分隔 ≤50,Keepa 同款);空补丁=不限清除(2026-10-20 修)枚举 chips 与 /fields values 一致生效
AC-EL-SRC-46标识组三件(explore·标识组)input×2+textarea🔍关键词(标题/品牌/型号/ASIN 任一包含)/标题排除词(空格逗号分隔)/批量 ASIN(≤300,换行逗号空格分隔)term 进 POST body;exclude/asins 同;textarea 回车不触发asinCount 正则 [A-Z0-9]{10} 断言生效
AC-EL-SRC-47明细显示列选择(explore·all/pool)chips 卡结果表动态列选择,已选 N/M;图墙字段固定全取不受影响selFields state,默认 8 列表头=选中列顺序生效
AC-EL-SRC-48排序 chips(explore·all/pool)chipssort_fields 白名单(来自 /fields)+↑升/↓降sortF/sortDir 进 body—生效
AC-EL-SRC-49筛选摘要+清空(explore·all/pool)行+button已设 N 项:label≥/≤/含/N 选+排序↑↓+排除+批量 N 个;清空全部筛选按钮filters state 派生 summary摘要与实选一致生效
AC-EL-SRC-50全宽搜索按钮(explore·all/pool)button「🔍 搜 索(所有条件选完后点击)」POST /api/sourcing/explore(body: country/scope/term/fields/conds f|ge|v 拼接/sort/dir/exclude/asins/page/200 页)conds 语法抓包断言生效
AC-EL-SRC-51结果 6 KPI(explore·结果)kpi×6匹配总数[脚注:图表基于前 200 行]/品牌数/类目组数/中位 BuyBox/中位月销/BuyBox FBA 占比%kpi=前端算 result.rows 前 200 行;F2-3:加载更多只扩明细图墙恒 200复算中位数生效
AC-EL-SRC-52ExploreCharts 图墙(explore·结果)图墙 38 图固化维度图墙(全字段+明细列)<ExploreCharts rows 前页 200>;EXPLORE_FIELDS 固定全取;逐图清单在 charts/ExploreCharts.tsx,需另册展开。

2026-10-22 换绿:另册已建=§11.38 SRC-EC 系列 38 条(v5.2 独立校对通过,EXPLORE_CHART_GROUPS 7 组 38 图)
待另册逐图比对生效
AC-EL-SRC-53结果明细卡(explore·结果)卡+表CSV 导出按钮+cond_note ⚠️(被拒条件显式亮出 F1-7)+动态列表[ASIN viewer 深链+🛒]+AU 无数据特文案(快照池未采集披露)+keepa_live 琥珀兜底行(本地无匹配→实时结果)+加载更多POST /explore page+1 追加;AU 特例披露;keepa_live=服务端实时兜底已入池;交互:导出/加载更多/行内链接0 行时 X-Export-Rows 提示不下载空文件生效
AC-EL-SRC-54CSV 导出(explore·结果)button同条件同排序导出,上限 1 万行POST /api/sourcing/explore/export;响应头 X-Export-Rows=0 时不下载报「无匹配」;文件名 sourcing_explore_YYYYMMDD.csv(blob)抓包+行数头断言生效
AC-EL-SRC-55搜索按钮口径注释(explore·live 尾)脚注纯关键词=Top30 快照(仅排序本页)·+筛选或留空=全市场条件检索·回车即查·缓存 10 分钟静态口径文案文案存在断言生效
AC-EL-SRC-56数据源双模式 chips(bsr·卡头)chips×2📚档案池 BSR 榜(本地)/⚡Keepa 实时(耗配额)mode=pool|live;pool 自动载,live 永不自动发—生效
AC-EL-SRC-57站点 chips(bsr)chips×1313 站(两模式全 Keepa 后端,F2 修统一收窄)KEEPA_COUNTRIES13 断言生效
AC-EL-SRC-58根类目 chips(bsr·pool)chips全类目+Top15 根类目(带产品计数,title=ID)category-tree 同源;seed 跳转带入 root/ref(首挂载不重置,切站才清);交互:点击切榜conds=sales_rank_reference|eq 或 root_category|eq 抓包生效
AC-EL-SRC-59参考类目子 chips(bsr·pool)chips选中根类目后展开其参考类目子类(带计数)同 AC-EL-SRC-58—生效
AC-EL-SRC-60导出 CSV+当前行(bsr·pool)button+行「⬇导出 CSV(当前榜最多 1 万行)」+当前: 类目名·共 N 产品POST /explore/export 同 body;文件名 sourcing_bestseller_国_日期.csv同 AC-EL-SRC-54生效
AC-EL-SRC-61关键词跳探索(bsr·pool)input+btn搜产品关键词→跳「数据探索」带完整筛选onSearch(kw)=setExploreSeed+切 mtab=explore(key 强制重挂载)URL mtab=explore 且种子生效生效
AC-EL-SRC-62榜单明细表(bsr·pool)表(9 列)#/ASIN[viewer 深链+🛒]/标题/品牌/当前 BSR/月销量/新品价($2 位)/评分(1 位)/评论数POST /explore scope=all sort=bsr_current dir=asc Top100;fields 8 列;空态「无数据」;交互:行内链接BSR 升序断言生效
AC-EL-SRC-63live 刷榜控件(bsr·live)select+input+btn根类目 select(全类目活跃榜)+关键词(优先)+「🔄刷新榜单(耗配额)」有词→/search Top30;无词→/finder(类目 sort=sales;全类目=drops30≥0 活跃榜)+/enrich;二选一说明脚注;缓存 10 分钟不自动发请求断言生效
AC-EL-SRC-64实时榜卡(bsr·live)卡KeepaLiveResults rankMode(# 名次列,BSR 升序)_byCat 按 Keepa 估算销量排序/词榜按 BSR 升序(副标题明示)副标题口径断言生效
AC-EL-SRC-65AI 站点 chips(ai)chips×1212 站全覆盖(US/UK/DE/FR/JP/CA/IT/ES/IN/MX/BR/NL;AU 已删=Keepa 无数据)10 站走 Keepa 官方 MCP;NL/BR 走平台 REST 直连(FBA 费估算不可用)12 断言+AU 缺席生效
AC-EL-SRC-66通道说明行(ai)脚注10 站 MCP·NL/BR REST·中东/瑞典不采集静态—生效
AC-EL-SRC-67问题 textarea+预设(ai)textarea+chips×3自由问题+3 预设(竞争格局/促销甄别/FBA 利润估算)静态预设填入 q;交互:点击预设填入—生效
AC-EL-SRC-68AI 分析按钮(ai)button「🤖AI 分析(1 次 AI 配额+Keepa ≤3 次)」+1-3 分钟勿重复点击提示POST /api/ai/sourcing-agent {question,country};GLM agent 循环调 Keepa MCP;配额门/审计/日志全在服务端;永不自动发quota_left 前后断言生效
AC-EL-SRC-69AI 分析结论卡(ai·结果)卡副标题: 站·model·Keepa 调用 N 次·今日剩余配额 N 次+pre-wrap 答案AgentResp.answerkeepa_calls 与 steps 数关系生效
AC-EL-SRC-70工具调用轨迹卡(ai·结果)卡agent 实际调用的 Keepa MCP 工具逐条(✓/✗ tool+参数截断 40 字+note),副标题「全部经过配额门与审计」AgentResp.stepsok=false 显示 ✗生效
AC-EL-SRC-71AI 检索的商品卡(ai·结果)卡KeepaLiveResults rankMode(BSR 升序)AgentResp.products同 AC-EL-SRC-14生效
AC-EL-SRC-72AI 检索的促销表(ai·结果)表(5 列)ASIN[深链+🛒]/标题/现价/均价/降幅%(降序)AgentResp.deals;Keepa 官方促销流;交互:行内链接降幅降序断言生效
AC-EL-SRC-73站点 chips(cat)chips×1313 站(类目聚合读 Keepa 后端,F2 修收窄)KEEPA_COUNTRIES13 断言生效
AC-EL-SRC-74统计行(cat·卡头)行共 N 产品·根类目 M 个·另有 K 产品未返回类目(不成树节点披露)category-tree total/roots.length/unclassifiedSQL sum(n) 比对生效
AC-EL-SRC-75关键词跳探索(cat·卡头)input+btn同 AC-EL-SRC-61同 AC-EL-SRC-61同 AC-EL-SRC-61生效
AC-EL-SRC-76根类目卡×N(cat)卡列表📁名+N 产品·M 参考类目·ID+「🏆看根类目榜」按钮+子 chips(名+计数,title=ID);无参考类目空态文案category-tree roots/children;onPick({country,root[,ref]})跳畅销榜(seed);交互:点子 chip/按钮跳转后 bsr conds 断言生效
AC-EL-SRC-77👁监控池 tab(mtab=watch)tab→组件WatchTab 组件GET /api/sourcing/watchlist(keepa_watch+keepa_daily LATERAL);POST /watch;DELETE;POST /watch/alert;上限 KEEPA_WATCH_LIMIT;内部元素需另册展开(WatchTab.tsx,归后续批次)。

2026-10-22 换绿:另册已建=§11.28 SRC-W 系列 30 条(v5.0 独立校对通过)
待另册展开后逐元素比对生效
AC-EL-SRC-78📈价格历史 tab(mtab=viewer)tab→组件ViewerTab 组件;深链参数 vasin/vcountry(全文 5 处 ASIN 链接目标)GET /api/sourcing/price-history(keepa_csv_series SECURITY DEFINER 白名单投影)+keepa-graph+aba_keepa_full;内部元素需另册展开(ViewerTab.tsx)。

2026-10-22 换绿:另册已建=§11.28 SRC-V 系列 31 条(v5.0 独立校对通过)
待另册展开后逐元素比对生效
AC-EL-SRC-79🏪卖家 tab(mtab=seller)tab→组件SellerTab 组件GET /api/sourcing/sellers/top(aba_keepa_full BuyBox 赢家榜+aba_seller_full)+/seller-lookup+POST /seller-finder;内部元素需另册展开(SellerTab.tsx)。

2026-10-22 换绿:另册已建=§11.28 SRC-S 系列 43 条(v5.0 独立校对通过)
待另册展开后逐元素比对生效
AC-EL-SRC-80⚡促销流 tab(mtab=deals)tab→组件DealsTab 组件GET /api/sourcing/deals+/lightning;内部元素需另册展开(DealsTab.tsx)。

2026-10-22 换绿:另册已建=§11.28 SRC-D 系列 29 条(v5.0 独立校对通过)
待另册展开后逐元素比对生效
AC-EL-SRC-81🎯产品查找 tab(mtab=finder)tab→组件FinderTab 组件POST /api/sourcing/finder+/enrich(与 explore live 同引擎);内部元素需另册展开(FinderTab.tsx)。

2026-10-22 换绿:另册已建=§11.28 SRC-F 系列 30 条(v5.0 独立校对通过)
待另册展开后逐元素比对生效
AC-EL-SRC-82⚖决策台 tab(mtab=verdicts)tab→组件VerdictsTab 组件路由端点未见 verdicts 专属(可能在 ai.py 或本地渲染);内部元素需另册展开(VerdictsTab.tsx+端点归属)。

2026-10-22 换绿:另册已建=§11.28 SRC-X 系列 24 条(v5.0 独立校对通过);端点归属实证=专列 router api/routers/verdicts.py(POST /verdicts/materialize @280、GET /verdicts/pareto @408、另有 candidates/legacy/decision;前端 VerdictsTab.tsx:52-105 调用)——原「路由端点未见」系端点在专列文件而非 sourcing.py
待另册展开后逐元素比对生效

§11.9 广告页(/ads · AC-EL-ADS,源码 web/app/ads/page.tsx 2475 行 + AdsAdvice.tsx 787 行 + api/routers/ads.py;2026-10-22 实证清单全量转档,ID 沿用三位编号)

全页通用:口径引用 AC-CAL-03(Noon 广告归因分层)·AC-CAL-04(Amazon 归因 campaign 级禁进 SKU)·AC-CAL-05(Noon 本币折 USD,SAR/AED 禁裸加,合计 USD 走 fx_rates 市场价)·AC-CAL-06(ACOS 阈值单源 /api/metric-thresholds,禁内联 25/40);通用公式 ACOS=花费/收入×100 · ROAS=收入/花费 · CTR=点击/曝光 · CVR=订单/点击 · CPC=花费/点击 · AOV=收入/订单 · CPS=花费/订单;时间窗 全部/今年/本月/上月/近3月/近12月(from/to 自然区间 _daywin 优先);Noon 数据 SA 时区锚、本币行禁跨币种裸加;空态按拉齐铁律显示"暂无数据"不隐藏结构。写操作九层护栏全页一致:EXECUTE_ADS_ACTION 确认串 + X-Idempotency-Key + idempotent_replay 消息 + role 门(owner/admin) + ops_ready 逐按钮解锁 + 数值护栏(bid [0.02,10]USD / Noon 定向 [0.01,200]本币 / AMZ 预算 [1,10000]USD·日 / Noon 预算 [1,30000]本币·日·克隆下限 5 / 活动名 1-128 同名拒建 / Noon 创建仅 AE·SA·SKU 1-50 在售 / Noon 建议采纳走 adopt)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-ADS-001页标题+面包屑(全局/顶栏)文本「广告」+「投放分析(概览/明细)· 关键词优化 · 建议决策 · 监测 · 晨报(Noon/Amazon 双线)」AppShell 静态文案目检生效
AC-EL-ADS-002平台选择器(全局/选择器卡)按钮Amazon/Noon 两钮,全页唯一(2026-10-09 删「全部」,用户拍板:主体与 Amazon 相同,深度分析改为分别切换)state platform 默认 amazon;不混平台;交互:点击切换,所有 tab 联动重查切换后各 tab 网络请求 platform 参数=所选值生效
AC-EL-ADS-003平台切换 tab 自动跳转(全局/规则)逻辑当前 tab 属对方平台特有时自动跳对应 tab:bids↔noonkwNOON_ONLY_TABS=[noonkw,noonrec,noonfees];AMAZON_ONLY_TABS=[bids,optlog](page.tsx:2402-2407)Noon 下停留 bids 再切 Amazon,观察 URL tab=platform 映射生效
AC-EL-ADS-004时间选择器(全局/选择器卡)下拉全部/今年/本月/上月/近3月/近12月,所有 tab 共享timeRange state(page.tsx:2409);换算见 005;交互:选择后各 tab 重查切档后请求 days/from/to 变化生效
AC-EL-ADS-005timeParams 换算(全局/逻辑)映射全部=days:0(不限);今年=365d+from:01-01;本月=当月第N日+from:月初;上月=60d+精确自然月 from/to;近3月=90d;近12月=365dpage.tsx:2410-2427;2026-09-21 修「上月=近60天」近似,from/to 传接口由 _daywin 优先采用选上月看请求含 from/to=上月首末日生效
AC-EL-ADS-006tab 条(全局/tab条)页签基座7:morning🌅晨报/advice🧭建议/monitor🩺监测/terms🔍搜索词/hourly🕐分时/platform投放分析/upload📤数据上传;Amazon 插 bids🎯关键词/出价(terms后)+optlog关键词优化(platform后);Noon 插 noonkw🎯+noonrec💡Noon建议+noonfees💰Noon费用;严格同序(2026-10-12 用户令)BASE_TABS/AMAZON_TABS/NOON_TABS(page.tsx:2384-2386);tab 写入 URL query 默认 morning;camp/analysis 旧链接回退 platform;交互:点击/URL 直达双平台各数 tab 数(7/9/10)与顺序生效
AC-EL-ADS-007广告 AI 分析师(全局/AI入口)侧栏page=ads,3 预设问句:最近哪些天赚钱/亏钱?哪些活动有问题怎么调?哪个产品广告效率最高?useAIContext(page:"ads"),getContext 带 {brand,tab,platform,timeRange};交互:点预设提问AI 面板出现 3 预设且上下文含当前 tab生效
AC-EL-ADS-008自定义模块区(全局/底部)容器品牌可配置模块挂载点CustomModules page="ads"(组件本体属 AC-EL-CMP 共享组件范畴,此处登记引用)见 AC-EL-CMP 清单待深化
AC-EL-ADS-009晨报头卡(晨报/头卡)卡片「🌅 晨报 · {bj_date}」+「数据截至 {as_of}(昨日全档入库后)」+去决策按钮GET /api/ads/morning(ads.py:3241);北京 08:00 视角,数据截至昨日;交互:「去决策(N)」跳 advice tab。待核:handler 源表未逐行读。

2026-10-22 换绿:源表已逐行核=audit.cleaned_amazon_ads_campaigns(昨日 USD 合计 :3253)+audit.cleaned_noon_ads_campaign(分国本币 AE/SA :3263)+ads_advice(队列 :3273/计数 :3288/昨日决策 :3293/回访 :3311)+ads_advice_checkin(昨夜回访结论 :3341)+ads_campaign_monitor(:3347)+人工操作单计数(:3350);北京 08:00=timezone(+8) :3245,全代码聚合零 LLM
对比接口 bj_date/as_of 字段;核对 morning 建议存储源表(ads.py:3241 起 SQL)生效
AC-EL-ADS-010KPI 待决策建议(晨报/KPI行)KPI卡queue.total,>0 红色;脚注「escalated 优先 · 去处理」链接同 009;queue.total=pending+escalated 计数;交互:点「去处理」跳 advice值=advice tab 决策队列两态之和生效
AC-EL-ADS-011KPI 昨日决策执行(晨报/KPI行)KPI卡executed_yesterday.length;脚注「API 直连 + 人工兜底」昨日(北京日) decision 落库数与 advice tab 昨日决策数对生效
AC-EL-ADS-012KPI 到期/逾期回访(晨报/KPI行)KPI卡followups.due.length;脚注 逾期 N 项/无逾期检查点 3/7/15/30/60/90d 到期集合;overdue 单列到期日期≤今日的行数生效
AC-EL-ADS-013KPI monitor 告警(晨报/KPI行)KPI卡monitor.by_monitor.alert;脚注 watch N · 观察中 N与 monitor tab 同源计数(ads.py:3131)与监测 tab alert tab 计数相等生效
AC-EL-ADS-014KPI 人工操作单(晨报/KPI行)KPI卡ops_pending;脚注「noon 渠道无 API 直连」executed_by=manual-ops 未回执数(POST /api/ads/ops/{aid}/done 核销,ads.py:3206)Noon 采纳建议后+1,回执后-1生效
AC-EL-ADS-015昨日投放概览表(晨报/表)表格列:品牌/平台国家/花费/销售/ACOS。Amazon 行 USD(全站);Noon 行本币分国({spend} {currency}),副题「Amazon USD / Noon 本币分国」AC-CAL-05:Noon 本币行不折算、禁跨币种裸加;ACOS=花费/销售×100,null 显「—」Amazon 行 SQL 对 cleaned 源表昨日(北京日)复算;Noon 行对 cleaned_noon_ads_daily 分国生效
AC-EL-ADS-016回访检查点表(晨报/条件表)表格仅 due>0 渲染。列:campaign/品牌国家/检查点(Nd)/到期/建议状态;到期≤bj_date 行红字;副题含逾期数followups.due;3/7/15/30d+月度60/90d红行=到期日≤今日生效
AC-EL-ADS-017昨夜回访结论(晨报/条件列表)列表仅 verdicts_yesterday>0。verdict badge(improved绿/flat灰/worse红/no-spend绿/no-data灰)+campaign+品牌国家+规则+检查点+note改前7d vs 改后Nd 全代码判定与 CheckinModal(038/044)同建议记录对生效
AC-EL-ADS-018待决策队列 Top 12(晨报/列表)列表escalated 行加「催办」红 badge;rule badge+campaign+品牌·平台·国家+→动作+reason+花费USD;空态「队列为空」queue.items 前12,副题「共 N 条」与 advice tab 队列前12一致生效
AC-EL-ADS-019状态页签(建议/toolbar)页签决策队列(status=pending,escalated)/全部状态(status 不传)GET /api/ads/advice?status&platform(ads.py:2966);引擎零 LLM。待核:建议存储表名未逐行读;交互:切换重查。

2026-10-22 换绿:存储表=ads_advice(企业 schema,读写同表,决策落同表状态机);status 支持逗号多状态 ANY(:2987,决策队列=pending,escalated;无参默认五状态 :2991);排序 escalated 优先(:3019);引擎=advisor.run_advisor(每日 23:10 UTC,全代码零 LLM)
请求 status 参数;核对 advice 存储源表 SQL生效
AC-EL-ADS-020状态统计行(建议/toolbar)文本「pending N · escalated N · …」+「API 直连: 品牌列表」stats.by_status;api_brands=有 API 直连能力的品牌与全部状态列表计数对生效
AC-EL-ADS-021⚙参数按钮(建议/toolbar)按钮title「规则参数配置(grp=advisor 阈值)」onGoto("config") → RuleConfigTab;交互:点击跳 configURL tab=config生效
AC-EL-ADS-022空态卡(建议/空态)卡片「当前筛选无建议(检测 23:10 UTC / 北京 07:10 每日刷新)」items.length===0新品牌/清队列后目检生效
AC-EL-ADS-023建议卡骨架(建议/列表卡)卡片每建议一卡;escalated 加 danger 边框渲染 data.items见 024-038 各元素生效
AC-EL-ADS-024卡头 badges(建议/卡头)徽标状态badge(ST_COLOR:pending黄/escalated红/rejected灰/monitoring蓝/executed青…)+规则名+campaign 粗体+品牌·平台·国家;hit_count>1 加「连续命中 N天」status_cn/rule_cn/hit_countbadge 色与状态枚举对生效
AC-EL-ADS-025建议行(建议/卡身)文本「建议: {action_cn} → ${new_budget} (×{factor}) — {reason}」budget 类动作附新预算与系数与卡决策历史对生效
AC-EL-ADS-026近N天指标行(建议/卡身)文本「近{win||window_days||7}天: 花费 X · ACOS x% · CTR x% · 曝光 N · 日预算 N · TACOS(月,活动SKU集) x% · 目标ACOS x% · ⚠人工操作单待办 · 冷却至 日期」花费 spendCell:有 currency+spend_local 显本币,否则 USD;TACOS=月广告花费/活动SKU集总销售有币种行显「1,234 SAR」式生效
AC-EL-ADS-027改价明细展开(建议/卡身·条件)折叠表action=update_keyword_bids 且 changes>0:「▸ 展开 N 条改价明细」+「已勾 x/N(不勾选的行不执行)」R23/R24(2026-10-19) 逐条勾选;Amazon 行={keyword,match_type,current_bid,suggested_bid},Noon 行={target_value,current_bid,new_bid};交互:展开见表 028;勾选行切换勾选数进执行载荷生效
AC-EL-ADS-028改价明细表(建议/卡身)表格列:勾/#/关键词定向/匹配/现价/建议价(绿粗+(现价×倍数))/[dim 时+]曝光/点击/点击率/订单/转化率/GMV/花费/ACOS/利润率(负红,带*估算标)/利润/依据(官方: reason_en 或 basis)dim=行带 gmv/clicks 维度(BID_CALC R24);利润率=(结算净额−采购成本×销量)/GMV 按目标内SKU收入加权,*=缺采购成本用品牌×国家均值估算;交互:勾选(仅 pending/escalated 可改);未勾行 opacity .45未勾行不出现在 decision 请求 changes生效
AC-EL-ADS-029利润率脚注(建议/卡身)脚注利润率公式+*估算说明+TACOS 见卡面dim 时显示目检公式句生效
AC-EL-ADS-030加词明细展开(建议/卡身·条件)折叠表action=add_keyword 且 suggestions>0:「▸ 展开 N 个推荐词明细」+已勾 x/N(不勾选的词不添加)R24 推荐词逐条+勾选;交互:展开见表 031同 027生效
AC-EL-ADS-031加词明细表(建议/卡身)表格列:勾/#/关键词/匹配/建议出价(绿粗)/依据交互:勾选(仅 open 态);建议价>0 才可执行全不勾点执行→alert「没有可添加的词」生效
AC-EL-ADS-032加词平台脚注(建议/卡身)脚注Noon:「采纳即按建议出价逐词加词到该 noon 活动; 建议价=有效ACOS×CVR×AOV(活动毛利率封顶)」;Amazon:「逐条加词到广告组 {ad_group_id}(官方建议价, 词史为依据)」;✎可逐词改价BID_CALC 口径(R24,2026-10-19)公式句与 R24 拍板一致生效
AC-EL-ADS-033回访行(建议/卡身·条件)文本monitoring/executed 且有 base_date:「回访: 日期 起 · 3d 7d 15d 30d 60d 90d」,已完成检查点加粗着色followup.checkpoints/donedone 与 CheckinModal 记录对生效
AC-EL-ADS-034✔执行按钮(建议/卡尾)按钮pending/escalated 显示;window.confirm(含品牌/国家/活动/理由/勾选计数);accept 后 exec_result.ok=false → alert「决策已记录, 但 API 执行失败(已转人工兜底)」POST /api/ads/advice/{id}/decision {decision:"accept", suggestions?/changes?};add_keyword 需≥1 个有出价勾选词;update_keyword_bids 需≥1 勾选行DevTools 看载荷含勾选子集生效
AC-EL-ADS-035✎修改按钮(建议/卡尾)按钮打开 EditModal(040-043)仅 open 态;交互:点击开弹层弹层预填卡数据生效
AC-EL-ADS-036✕驳回按钮(建议/卡尾)按钮confirm「驳回该建议? (7 天冷却, 跨级恶化才会重提)」POST decision {decision:"reject"};rejected_until 冷却驳回后卡灰、显示冷却至日期生效
AC-EL-ADS-037✓已办回执(建议/卡尾·条件)按钮monitoring 且 executed_by=manual-ops;confirm 后核销人工操作单并起 3/7/15/30/60/90d 回访POST /api/ads/ops/{id}/done晨报 ops_pending 减 1生效
AC-EL-ADS-038📋回访按钮(建议/卡尾·条件)按钮monitoring/executed/resolved 显示,打开 CheckinModalGET /api/ads/advice/{aid}/checkins(ads.py:3227);交互:点击开弹层弹层列出各检查点生效
AC-EL-ADS-039分页脚注(建议/尾)文本「显示前 N 条 / 共 M 条(按花费降序)」total>items.length 时显示计数与接口 total 对生效
AC-EL-ADS-040EditModal·动作/预算(建议/弹层)表单动作 select:暂停/降预算/加预算/检查创意定向/按建议改关键词出价/按建议加推荐词;budget 类出「预算系数(×)」「新日预算 $(留空用系数算)」7.6 决议:数字/动作/理由都可改,保存即按新值执行;POST decision {decision:"edit",…}修改后卡动作变 modified 语义生效
AC-EL-ADS-041EditModal·改价表(建议/弹层)表格列:勾/关键词定向/现价/建议价/新出价(input step0.01, min Noon 0.01 / Amazon 0.02)/依据;护栏提示 Noon [0.01,200]本币 / Amazon [0.02,100]站点货币勾选行必填价且>0,空/非法报行号错误提交载荷 changes 含新价生效
AC-EL-ADS-042EditModal·加词表(建议/弹层)表格列:勾/关键词/匹配/建议价/新出价/依据;护栏同 041同 041;至少勾一词同 041生效
AC-EL-ADS-043EditModal·理由/备注(建议/弹层)表单理由 textarea(预填)+决策备注(可选)随 decision 提交载荷 reason/note生效
AC-EL-ADS-044CheckinModal(建议/弹层)弹层标题「建议 #N 回访记录 · 改前 7 天 vs 改后 N 天, 全代码判定」;每检查点:Nd 检查点+verdict badge(五色)+到期/记录时间+「改前: ACOS x% · 花费 x · 销售 x → 改后: …」+note;空态「尚无到期检查点(3/7/15/30/60/90 天逐个回访)」GET checkins;before/after 指标集与晨报昨夜结论(017)互证生效
AC-EL-ADS-045monitor 状态页签(监测/toolbar)页签「全部」+按计数降序的状态页签「{中文名} (N)」:告警/建议暂停/观察/观察中/健康GET /api/ads/monitor?monitor&platform(ads.py:3131);by_monitor/monitor_cn;全部 active campaign。待核:monitor 存储源表未逐行读。

2026-10-22 换绿:存储表=ads_campaign_monitor(企业 schema,:3153 GROUP BY monitor);「全 active 常驻」由写入侧 advisor._refresh_monitor 保证——PAUSED 无建议不进表(:1079)、停投剔除(:1105)、30 天未刷新且无关联建议 DELETE(:1119-1124)
计数和=总数;核对 ads.py:3131 起源表 SQL生效
AC-EL-ADS-046监测表(监测/表)表格副题「近 7 天窗口 · 每日 23:10 UTC 刷新 · 共 N 条」。列:状态badge(MON_COLOR:alert红/paused-by-advice青/watch黄/observation蓝/healthy灰)/campaign(非 ENABLED 附注状态)/品牌·平台·国家/日预算 USD/7d花费(本币优先否则USD)/7d ACOS/曝光/更新时间近7天窗口口径;spendCell 同 026;同 045 源(待核同 045)。

2026-10-22 换绿:7 天窗实证(advisor.py:1075 w7 / :1093 window_days=7);每日 23:10 UTC 刷新(pipe_morning_check.py:75);本币优先=noon 行 metrics 带本币(:1109-1113)、amazon 行 USD;底层日线=cleaned_amazon_ads_campaigns+cleaned_noon_ads_campaign 载 14 天算 7 天窗(advisor.py:67/89)
23:10 UTC 跑批后 updated_at 前滚生效
AC-EL-ADS-047视图页签(投放分析/头)页签概览(ov)/明细(国家/产品/SKU)(detail),默认概览page.tsx:759,996-997;交互:切换明细视图出三表生效
AC-EL-ADS-048明细·数据拉取(明细/逻辑)接口明细三表与头部合计的数据源GET /api/ads/analysis?days&brand&platform&from_date&to_date(ads.py:70);Amazon=cleaned_ads_sku_daily(zf/fg)+cleaned_amazon_ads_daily(onno)+ad_campaigns(zf/fg 30d快照);Noon=cleaned_noon_ads_daily(ad_type IN product/sp/all)+归集层 cleaned_noon_ads_sku_attr(2026-10-21 P2 SKU 归因修复,覆盖≈99.8%,AC-CAL-03)切时间档看请求参数;源表名与本行一致生效
AC-EL-ADS-049明细·头部合计行(明细/头)合计三表各自的窗口合计后端聚合(同 048 源)SQL 同窗 SUM 复算生效
AC-EL-ADS-050明细·空态卡(明细/空态)卡片data_through 提示「采集依赖站外侧源表」data_through=max(day) across sources新品牌目检生效
AC-EL-ADS-051明细·三表(明细/主体)表格×3分国家前50 / 分产品前50 / 分SKU前100,均按花费降序同 048 源表分组行数上限与排序生效
AC-EL-ADS-052明细·13列指标头(明细/表列)列集曝光/点击/CTR/花费/订单/收入/CVR/CPC/AOV/ACOS/ROAS/CPS/判定公式见全页通用;CTR/ACOS 百分比列名与顺序生效
AC-EL-ADS-053明细·本币双行(明细/表行)格式local_spend+currency 存在时:本币主行 + USD 副行(小字 t2)AC-CAL-05 变体:Noon 行本币为主 USD 为辅,禁裸加Noon 行见双行生效
AC-EL-ADS-054明细·ACOS 三色(明细/表列)着色ACOS 按阈值三色AC-CAL-06:阈值来自 /api/metric-thresholds 单源,禁内联改阈值配置后颜色分界移动生效
AC-EL-ADS-055明细·判定 badge(明细/表列)徽标HEALTH:healthy健康(绿)/watch观察(黄)/poor超标(红)/zero无转化(红)/idle无花费(灰)/paused已暂停(灰)page.tsx:43-49 判定口径各态构造数据目检生效
AC-EL-ADS-056明细·脚注(明细/脚注)文本数据源+判定口径说明静态(含源表名)目检含源表名生效
AC-EL-ADS-057概览·角色门(概览/逻辑)权限canOps=owner|admin 才显示写操作/api/tenant/info 角色判定viewer 角色无操作钮生效
AC-EL-ADS-058概览·KPI 广告花费(概览/KPI)KPI卡窗口广告花费合计GET /api/ads/platform(ads.py:482);合计后端单源(C3批#60);Noon 合计折 USD 走 fx_rates 市场价(AC-CAL-05)SQL 复算生效
AC-EL-ADS-059概览·KPI 广告销售(概览/KPI)KPI卡窗口广告销售(折USD)+ROAS(健康线着色)+ACOS同 058;ROAS=sales/spend;健康线色同 054同 058生效
AC-EL-ADS-060概览·KPI 曝光·活动数(概览/KPI)KPI卡曝光合计+在投活动数ad_campaigns 计数活动表行数对生效
AC-EL-ADS-061概览·KPI 点击·CTR·CPC(概览/KPI)KPI卡点击合计+CTR+CPC公式全页通用复算生效
AC-EL-ADS-062概览·KPI 广告订单·CVR(概览/KPI)KPI卡广告订单合计+CVR公式通用复算生效
AC-EL-ADS-063月度投放表(概览/表)表格月×花费/销售/ROAS 等;Noon 多国家/币种行+活动数列;尾行「合计 USD」归一AC-CAL-05:分国本币行+合计 USD 行合计行=分国折USD之和生效
AC-EL-ADS-064投放活动表·Amazon 列(概览/表)列集活动/品牌/状态/健康度badge/花费/销售(7天归因,AC-CAL-04 campaign级禁进SKU)/ACOS(色同054)/ROAS=spend?sales:spend/曝光/点击/CTR/订单/操作ad_campaigns 30d 快照+ads_sku_daily;操作列见 066-070ROAS 无销售时=花费值语义生效
AC-EL-ADS-065投放活动表·Noon 列(概览/表)列集国家(币种)/状态/…(指标同 064,本币口径)+操作cleaned_noon_ads_daily(AC-CAL-03 分层)AE/SA 行币种标注生效
AC-EL-ADS-066操作·暂停/启用(概览/操作列)按钮暂停⇄启用活动,EXECUTE_ADS_ACTION 确认串POST /api/ads/campaign-ops(ads.py:1669)+X-Idempotency-Key;交互:弹确认请求含确认串与幂等键生效
AC-EL-ADS-067操作·预算(概览/操作列)按钮「新预算 {单位}(当前 N)」;AMZ [1,10000] USD/日;Noon [1,30000] 本币/日同 066+数值护栏;交互:填值确认越界值被拒生效
AC-EL-ADS-068操作·改名(概览/操作列)按钮新名称 1-128 字符且须与当前不同同 066同名/超长被拒生效
AC-EL-ADS-069操作·克隆(概览/操作列)按钮AMZ:「将以 {名}-copy 克隆(创建即暂停)」;Noon:新名称留空自动 Dup-<原名>-<时间戳>+日预算本币留空继承(下限5);护栏 Noon [5,30000]同 066克隆后活动列表新增暂停态行生效
AC-EL-ADS-070操作·归档(概览/操作列)按钮归档活动(含警告文案+确认串)同 066归档后入折叠区生效
AC-EL-ADS-071ops_ready 逐按钮解锁(概览/逻辑)权限Noon budget/rename/create/clone/archive、Amazon create 等能力旗标逐按钮解锁ops_ready flags(/api/tenant/info 能力面);未解锁按钮隐藏/禁用缺旗标时对应钮不出现生效
AC-EL-ADS-072创建 Amazon 活动(概览/创建)表单国家代码(品牌在投市场如 US/DE/UK)/活动名 1-128 同名拒建/日预算 USD [1,10000] 默认10/投放方式 AUTO|MANUAL;创建即暂停POST campaign-ops create 分支;交互:多步输入+确认串新活动为 PAUSED 态生效
AC-EL-ADS-073创建 Noon 活动(概览/创建)表单国家 AE 或 SA/活动名 1-128/日预算本币 [5,30000](Noon 服务端下限5)/SKU 列表 1-50 个需在 Noon 目录在售同 066 create 分支非在售 SKU 被拒生效
AC-EL-ADS-074零活动/归档折叠区(概览/折叠)折叠区零活动与归档活动收纳,snapshot_only 行默认收起R23b:避免快照行淹没在投列表;交互:展开/收起归档活动默认不可见生效
AC-EL-ADS-075健康度统计副题(概览/表头)文本活动健康度分布统计后端统计分布数=表内 badge 计数生效
AC-EL-ADS-076概览·脚注(概览/脚注)文本数据源说明静态(含源表名)目检源表名生效
AC-EL-ADS-077图·国家筛选(图区/头)下拉国家 selectGET /api/ads/charts?brand&platform&country&days(ads.py:721);交互:选择重查请求 country 参数生效
AC-EL-ADS-078图·天数页签(图区/头)页签7/14/30/60/90/全部(0)CHART_DAYS;交互:切换days 参数生效
AC-EL-ADS-079c1 花费/收入(图区/图)双bar图花费(红)bar+收入(绿)bar,日粒度charts 接口 series;Noon 副题「本币口径」series 数=2生效
AC-EL-ADS-080c2 ROAS(图区/图)折线图ROAS 日趋势=收入/花费与 c1 导出数互算生效
AC-EL-ADS-081c3 CTR(图区/图)折线图CTR 日趋势=点击/曝光复算生效
AC-EL-ADS-082c4 CVR(图区/图)折线图CVR 日趋势=订单/点击复算生效
AC-EL-ADS-083c5 CPC(图区/图)折线图CPC 日趋势=花费/点击复算生效
AC-EL-ADS-084c6 花费Top20(图区/图)横bar图花费 Top20(SKU/ASIN)降序截断20行数≤20生效
AC-EL-ADS-085c7 ROAS by ASIN(图区/图)bar图ASIN 维 ROAS分组聚合与明细表对生效
AC-EL-ADS-086c8 月度双bar(图区/图)双bar图月度花费+收入月聚合月桶数生效
AC-EL-ADS-087c9 月度ROAS(图区/图)bar图月度 ROAS月聚合同 086生效
AC-EL-ADS-088c10 ATC(图区/图)bar图·占位加购紫 bar;Amazon 平台显占位文案「源无ATC数据恒0请切Noon」Amazon 源表无 ATC 列(诚实占位,不造数)Amazon 下显示占位说明生效
AC-EL-ADS-089c11 CPS(图区/图)折线图CPS 日趋势=花费/订单复算生效
AC-EL-ADS-090c12 曝光/点击(图区/图)双线图曝光+点击双线两 seriesseries=2生效
AC-EL-ADS-091断更 badge(图区/头)徽标「数据止于 MM-DD」(最新点>3天前)data_through 判定人为断更后出现生效
AC-EL-ADS-092国家探测回退(图区/逻辑)逻辑选中国家无数据自动回退「全部」+banner「显示全部时段」probe 请求+fullCache 防重查冷门国家验证生效
AC-EL-ADS-093KPI 花费(搜索词/KPI)KPI卡窗口搜索词花费合计GET /api/ads/search-terms?days&brand&platform&min_spend&sort&page_size=30(ads.py:818);Amazon SP 搜索词报告(7天归因,AC-CAL-04)+Noon 查询词报告日更SQL 复算生效
AC-EL-ADS-094KPI ROAS·ACOS(搜索词/KPI)KPI卡ROAS+ACOS公式通用复算生效
AC-EL-ADS-095KPI 点击·CPC(搜索词/KPI)KPI卡点击+CPC公式通用复算生效
AC-EL-ADS-096KPI 搜索词数(搜索词/KPI)KPI卡去重搜索词数count distinct对表行数生效
AC-EL-ADS-097KPI 零转化浪费(搜索词/KPI)KPI卡danger 色「N 个词花费≥$20 无销售」waste 判定:spend≥20 且 sales=0构造词复算生效
AC-EL-ADS-098kpi_note(搜索词/KPI)注释ℹ️ 口径说明静态目检生效
AC-EL-ADS-099月净贡献热力表(搜索词/热力表)表格Top搜索词×月:绿赚红亏,alpha=0.08+|net|/maxAbs×0.47;净贡献=销售−花费;hover 金额;stFmt k 格式;合计列净贡献口径单源单元格色深与金额绝对值单调生效
AC-EL-ADS-100否词候选卡(搜索词/卡)卡片≥$20 零销售词列表+「复制否词列表」按钮(clipboard);脚注「粘贴到亚马逊后台否定投放,竞品词优先」waste 词集;交互:复制粘贴内容=列表词生效
AC-EL-ADS-101明细表(搜索词/表)表格15 列,双平台 badge;判定 ST_VERDICT:star高效/healthy健康(绿)/watch观察(黄)/waste烧钱(红)page.tsx:1156-1158四态目检生效
AC-EL-ADS-102投放分析表格(平台投放 tab · 2026-10-26 用户令 15 列口径)表格19 列:投放时间/国家/广告活动/广告组/关键词·定位/搜索词/产品/SKU/曝光/点击/CTR/花费(站点本币+Ccy 标注)/CPC/广告订单/广告销量/广告销售额/CVR/ACoS/TACoS;筛选=粒度(日/月/年)+活动+产品+SKU 四下拉;spend DESC+分页(50/页);「—」=该行无该数据API GET /api/ads/placement-rows(ads.py):主行=audit.cleaned_ads_search_terms_daily(keyword/term 级);SKU 桥=audit.cleaned_amazon_ads_advertised_products(活源, campaign 级);产品名=sku_mapping;TACoS 分母=amazon_order_items.price(本币)×amazon_orders(≠Cancelled)同币种相除;派生公式=用户拍板(CTR/CPC/CVR/ACoS/TACoS 分母 0→—);Noon 面=cleaned_noon_ads_daily(现采仅 [daily_total] 日汇总, 明细降级如实)e2e(2026-10-26):amazon month=627 行+TACoS 31 行有值(ASIN 定位行挂 ZFH24T0SAB/ZFT11TSABE+产品名);amazon day=151;noon month=4;bundle 含表格 chunk+/ads 200。挂账:广告销量(units)采集清洗层无列(采集层 unitsSold* 在, 清洗投影缺);Noon 明细待采集;cleaned_amazon_ads_daily 已停更弃用生效
AC-EL-ADS-170排序/分页(搜索词/表尾)(原行误用 ADS-102 与投放分析表格两义复用,R4b P3-4 换新 ID——ID 永不复用铁律)控件sort(spend/sales/roas/clicks/term)+min_spend+分页 page_size=30请求参数;交互:切换请求参数变化生效
AC-EL-ADS-103Noon 占位提示(bids·Noon 进入时)提示引导去 noonkw tab平台特有;交互:跳转Noon 下无此 tab(自动跳转 003)生效
AC-EL-ADS-104匹配页签(bids/头)页签EXACT精确/PHRASE词组/BROAD广泛/Auto投放/定投MATCH_CN;GET /api/ads/keyword-bids?match&action&country&days=30&sort&page_size=30(ads.py:933);交互:筛选match 参数生效
AC-EL-ADS-105KPI×6(bids/KPI)KPI卡关键词投放目标/花费→销售/整体ACOS·目标N%·CPC/建议提价(绿)/建议降价(黄)/暂停观察sort=impact/spend/acos/cut/raise与明细计数对生效
AC-EL-ADS-106动作筛选(bids/toolbar)页签↑提价/↓降价/⏸暂停参考/·观察KB_ACTION(page.tsx:1347);交互:筛选action 参数生效
AC-EL-ADS-107明细表(bids/表)表格14 列:含当前bid/建议bid(粗体)/幅度±%/动作badge/依据规则脚注见 109幅度=(建议−当前)/当前生效
AC-EL-ADS-108导出 CSV(bids/表尾)按钮导出当前筛选前端生成;交互:下载行数=表行数生效
AC-EL-ADS-109规则脚注(bids/脚注)文本花费≥$15零销售→暂停(半价参考);ACOS>40%→降价至目标25%(下限4折);ACOS≤25%且点击≥5→加价(上限1.25倍);无SP报告品牌不在列引擎规则;阈值联动 config(165-169)无 SP 品牌确实不在列生效
AC-EL-ADS-110无数据声明 banner(分时/头)横幅「广告侧仅日粒度无小时数据——订单侧分时分布,分时花费与分时ACOS无数据源不展示」口径诚实声明(不造数)目检生效
AC-EL-ADS-111总量+高峰(分时/头)徽标总订单+高峰小时 badges+覆盖 metaGET /api/ads/dayparting(ads.py:1031);近60天;北京小时。待核:订单侧源表未逐行读。

2026-10-22 换绿:订单侧源表=企业 sales_hourly(Amazon,sync_source 60 天滚动,spapi 下单时间→北京小时 :1058)+audit.cleaned_noon_orders(Noon,order_placed_at AT TIME ZONE Asia/Shanghai :1067);窗口 clamp 7..60 默认 60(:1053);广告侧无小时数据→ads_hourly_available:False+note 明示(:1095-1098)
覆盖日期范围;核对 ads.py:1031 起源表 SQL生效
AC-EL-ADS-112堆叠柱图(分时/图)图表24h 堆叠 bar:Amazon #f59e0b + Noon #7c3aed北京时区小时桶两段和=表合计生效
AC-EL-ADS-113分时表(分时/表)表格列:小时/Amazon订单/Noon订单/合计/占比;占比条 share×4 cap100% brand 色;高峰行高亮share_pct=小时订单/总订单占比列和≈100%生效
AC-EL-ADS-114Noon 占位卡(optlog·Noon)卡片「Amazon 特有」说明卡平台特有 tabNoon 下自动跳转不显示生效
AC-EL-ADS-115RecEngine·KPI 待审建议(optlog/建议引擎)KPI卡warn 色;脚注「规则引擎·每日23:00 UTC·最新跑批·待审7天自动过期」GET /api/ads/recommendations?status&rule&win&brand&limit=50(ads.py:1084)7天前 pending 不再显示生效
AC-EL-ADS-116RecEngine·KPI×4(optlog/建议引擎)KPI卡已接受/已拒绝/已修改/规则分布前4 badgestats 聚合与列表计数对生效
AC-EL-ADS-117RecEngine·窗口页签(optlog/引擎toolbar)页签全部/1d昨日/3d/7d/30dwin 参数;交互:筛选win 参数生效
AC-EL-ADS-118RecEngine·规则/状态筛选(optlog/引擎toolbar)select+页签规则 select+状态页签rule/status 参数;交互:筛选参数生效
AC-EL-ADS-119⟳立即重跑(optlog/引擎toolbar)按钮手动触发跑批POST /api/ads/recommendations/run(ads.py:1301);交互:点击跑批后列表刷新生效
AC-EL-ADS-120⚙参数(optlog/引擎toolbar)按钮跳 config(grp 联动)onGoto("config");交互:点击URL生效
AC-EL-ADS-121RecEngine·建议表(optlog/引擎表)表格列:窗口/规则(RULE_TONE:emergency_stop 行红底/max_clicks_alert 黄底)/目标/品牌平台/花费/建议动作(modified=删除线原动作+修改版)/依据/状态/决策引擎零 LLM;决策列见 122色带规则目检生效
AC-EL-ADS-122RecEngine·决策三按钮(optlog/引擎表)按钮pending:✓接受/✗拒绝/✎修改,均强制理由(usePrompt)POST /api/ads/recommendations/{rid}/decision(ads.py:1162);交互:弹理由框空理由被拒生效
AC-EL-ADS-123RecEngine·⚡执行(optlog/引擎表·条件)按钮accepted+Amazon+keyword级+未执行;新bid USD 预填 suggested,护栏 [0.02,10],确认串 EXECUTE_ADS_ACTIONPOST /api/ads/recommendations/{rid}/execute(ads.py:1388)+X-Idempotency-Key+idempotent_replay 消息;actionMap: bid_raise/bid_lower→update_bid, pause_keyword→pause_keyword载荷含确认串/幂等键/护栏拒越界生效
AC-EL-ADS-124RecEngine·脚注(optlog/引擎)脚注「23:00 UTC 三窗口·零LLM·活动级并入 advisor(23:10 UTC)」与 advice 引擎分工声明目检生效
AC-EL-ADS-125AI 优化日志折叠区(optlog/折叠)details归档折叠;2026-10-11 E 源已停更历史数据只读;交互:展开默认收起生效
AC-EL-ADS-126LogTab·KPI×5(optlog/日志头)KPI卡日志总数(停更标注「⚠️最近一条 N天前(日期)」基准2026-09-26)/待审/已执行/已忽略/人工反馈(本页)GET /api/ads/optlog?limit=50&offset&status&platform&brand&q(ads.py:244)停更天数=今天−最新log日期生效
AC-EL-ADS-127日志搜索(optlog/toolbar)输入活动名/详情/原因/ASIN 关键词q 参数;交互:输入过滤命中高亮生效
AC-EL-ADS-128日志导出 CSV(optlog/toolbar)按钮导出当前筛选前端生成;交互:下载行数一致生效
AC-EL-ADS-129日志表(optlog/表)表格8 列optlog 存储—生效
AC-EL-ADS-130日志展开行(optlog/表行)展开原因/建议动作JSON/执行结果/反馈备注行数据;交互:展开JSON 可读生效
AC-EL-ADS-131反馈四按钮(optlog/展开行)按钮user_status 四态反馈POST /api/ads/optlog/{log_id}/feedback(ads.py:294);交互:点击状态落库刷新生效
AC-EL-ADS-132日志分页(optlog/表尾)分页limit=50+offset参数;交互:翻页offset 变化生效
AC-EL-ADS-133否词·状态页签(optlog/否词)页签全部/生效中/已驳回(带计数)GET /api/ads/neg-keywords?status&q&brand&limit=200(ads.py:1198,250ms debounce);交互:筛选计数对生效
AC-EL-ADS-134否词·添加表单(optlog/否词)表单否词(≤250字符)/站点(空=全部)/类型 negativeExact精准|negativePhrase词组/备注POST /api/ads/neg-keywords(ads.py:1239);交互:提交超长被拒;新词入表生效
AC-EL-ADS-135否词·表(optlog/否词)表格9 列;来源 ORIGIN_CN manual手动/accepted建议采纳/migrated迁移否定;备注行内编辑;驳回↔恢复切换;🗑删除PATCH /api/ads/neg-keywords/{nid}(ads.py:1266)/DELETE(1288);交互:行内操作状态切换即时反映生效
AC-EL-ADS-136否词·单一事实源脚注(optlog/否词)脚注+空态F3-2:注册表为单一事实源,表内词引擎不再重提;空态文案口径声明添加词后建议引擎不再提同名生效
AC-EL-ADS-137主表(noonkw/表)表格Campaign/AdGroup/关键词/匹配/出价/状态(live badge);exportCsv;caliber「admanager campaign details 每日拉取」GET /api/noon/keywords?limit=200。待核:源表未逐行读(Noon 侧 router);交互:导出。

2026-10-22 换绿:handler=noon_data.py:35;源表={品牌schema}.{bs}_ads_keywords(最新 snapshot_date 快照)+{bs}_ads_skus(ad_type=target 近 7 天定向层,effective_bid/recommended_bid);企业隔离=tenant_noon_schemas 路由(ISO-01 2026-10-14 修,模块头注);limit Query(50,le=200) 与前端 200 一致
行数与接口对;核对 noon router 源表 SQL生效
AC-EL-ADS-138🎯定向明细表(noonkw/定向表)表格品牌/国家/活动/定向类型(accent badge)/定向值/搜索词/出价/实际出价(粗体)/激活✓✗/改价入口(canEdit)target 层近7天;effective_bid=实际扣取;交互:见 140实际出价≠出价行存在生效
AC-EL-ADS-139定向脚注(noonkw/脚注)文本「target层近7天·effective_bid=实际扣取·改价走 adgroup-target/update+回读验证·建议出价列从未填充已隐去」口径诚实声明目检生效
AC-EL-ADS-140NoonBidEditModal(noonkw/弹层)弹层新出价护栏 [0.01,200] 本币;原生 window.confirm/alert(非 kit);确认串 EXECUTE_ADS_ACTIONPOST /api/ads/noon-keyword-bid(ads.py:2080)+幂等键+回读验证越界拒;改后表内回读值更新生效
AC-EL-ADS-141类型 badge(noonrec/表)徽标increase_bid加价/add_target加词/remove_target删词GET /api/noon/recommendations;raw JSON 解析(乱码根因见组件注释)。待核:源端表未逐行读。

2026-10-22 换绿:源表={品牌schema}.{bs}_ads_recommendations(最新快照,raw 原样透传 :81=乱码根因)+SaaS 侧 ads_noon_rec_adoptions 关联采纳标记(R21-P2,采集表每日 DROP+CREATE 标记不丢);同经 tenant_noon_schemas 路由
三类型各见行;核对 noon recommendations 源表生效
AC-EL-ADS-142建议表(noonrec/表)表格Campaign/关键词定向/建议出价 X→Y/理由(Noon官方英文)/生成日出价单位市场本币 SA=SAR/AE=AED—生效
AC-EL-ADS-143已采纳 badge(noonrec/表)徽标已采纳行 badge;add_target 行显「待通道」采纳标记存 SaaS 库,采集表每日重建不丢。待核:add_target 加词端点待抓包实证。

2026-10-22 换绿:核验结果——UI「待通道」至今仍准确(一键采纳 add_target 故意 400,ads.py:1990);但「加词端点待抓包」已过时:加词执行端点已实证并投产=noon_exec.exec_rec_accept:785(POST /_svc/productads/v2/recommendations/accept/{recId}),建议队列 add_keyword 决策经 advisor.py:1682 走此通道(含 recId 轮换解析 :765-782+采纳后 update_bid 回读校正 :1696-1703);increase_bid/remove_target 一键采纳走 adgroup-target/update 回读验证;幂等+审计=ads_decision_request/ads_decision_audit(:2002/:2030)
次日仍显示已采纳;抓包实证 adopt 通道生效
AC-EL-ADS-144采纳按钮(noonrec/表)按钮increase_bid/remove_target 可采纳;确认串POST /api/ads/noon-recommendations/{rec_id}/adopt(ads.py:1965);交互:确认采纳后转 badge生效
AC-EL-ADS-145类型页签(noonfees/头)页签referral佣金/storage仓储/outbound出库/fbp直发GET /api/noon/fees?fee_type;按类型解析 JSON 列。待核:源表未逐行读;交互:切换。

2026-10-22 换绿:源表={品牌schema}.{bs}_fees_{fee_type} 四选一(referral/storage/outbound/fbp,最新快照,fee_data JSON 原样回传 :110-113);fee_type pattern 校验 :103;模块门=require_module("finance") 非 ads(:104);同经 tenant_noon_schemas 路由
列集随类型变;核对 noon fees 源表生效
AC-EL-ADS-146referral 列集(noonfees/表)列集履约badge/SKU/市场+SAR/AED/周期/基础价/佣金率%/佣金额佣金=基础价×佣金率单行验算生效
AC-EL-ADS-147storage 列集(noonfees/表)列集月仓储费——生效
AC-EL-ADS-148outbound 列集(noonfees/表)列集出库费/计费重/实重/尺寸L×W×H cm/分类——生效
AC-EL-ADS-149fbp 列集(noonfees/表)列集均值费/取件费/送仓费——生效
AC-EL-ADS-150导出+脚注(noonfees/尾)按钮+文本exportCsv noon_fees_<type>;caliber「noon catalog 费用接口·市场本币·佣金=基础价×佣金率」本币口径(AC-CAL-05 伴生);交互:下载文件名生效
AC-EL-ADS-151数据源模式矩阵(upload/矩阵卡)矩阵品牌×通道 auto自动(ok)/manual手动(warn)/none无此通道(dim badge);当前品牌高亮GET /api/ads/sources(ads.py:2890)高亮行=当前品牌生效
AC-EL-ADS-152上传卡·品牌/平台(upload/上传卡)徽标+下拉品牌 badge+平台 select(Amazon/Noon)平台可手选亦由文件自动识别;交互:选择识别结果覆盖手选生效
AC-EL-ADS-153上传卡·Noon国家(upload/上传卡)下拉SA/AE/ALL(④A 新导出 ALL 无国家段时用);亦可文件名识别文件名优先;交互:选择ALL 文件走 ALL生效
AC-EL-ADS-154文件选择(upload/上传卡)inputaccept .csv,.xlsx,.zip—;交互:选文件非许可扩展名不可选生效
AC-EL-ADS-155①预览解析(upload/上传卡)按钮解析并出预览面板POST /api/ads/upload/preview(ads.py:2762);交互:点击见 156生效
AC-EL-ADS-156预览面板(upload/预览)面板✅平台识别/xlsx/zip member/文件数/国家(重传=覆盖该日该国全部行警告)/行数/日期范围/列映射 k←「列名」/未匹配可选列预览响应渲染;交互:核对后导入列映射与文件头一致生效
AC-EL-ADS-157②确认导入(upload/预览)按钮执行入库POST /api/ads/upload(ads.py:2782);覆盖规则:Amazon 同键(国家+日期+ASIN+活动+广告组)覆盖;Noon 按 日+国 整体替换;交互:点击导入任务出现生效
AC-EL-ADS-158auto 模式提示(upload/上传卡)文本「断供应急补数 SKU 取广告名称」断供降级口径目检生效
AC-EL-ADS-159支持格式脚注(upload/脚注)文本Amazon 中英文报告含 zip;Noon xlsx _OVERVIEW_*_Report_日_日 单日单国可 zip 多日静态目检生效
AC-EL-ADS-160导入任务卡(upload/任务卡)列表5s 轮询刷新GET /api/ads/imports(ads.py:2849);交互:自动轮询导入后≤5s 状态变 done生效
AC-EL-ADS-161任务状态 badges(upload/任务卡)徽标done完成/error失败/running执行中/queued排队中+elapsed_s状态机构造错误文件出 error❌生效
AC-EL-ADS-162任务明细列(upload/任务卡)列集error❌/同步 counts/适配器适配器名与通道对—生效
AC-EL-ADS-163🔁立即重算(upload/任务卡)按钮手动触发重算POST /api/ads/imports/recompute(ads.py:2871);交互:点击重算后聚合更新生效
AC-EL-ADS-164数据归因卡(upload/归因卡)卡片「重新归因近90天」→返回 ads_sku_updated/amazon_ads_updated 计数POST /api/ads/reattribute?brand&days=90(ads.py:2902);交互:点击返回计数>0生效
AC-EL-ADS-165参数分组(config/表)分组14 组 GRP_CN:advisor⓪~rank⑬GET /api/ads/rule-config(ads.py:1319)组数=14生效
AC-EL-ADS-166参数行(config/表)行label/key(⚠未接线 warn badge)/value 行内编辑(Enter保存 Esc取消)POST /api/ads/rule-config(ads.py:1339);交互:行内编辑Esc 不落库生效
AC-EL-ADS-167作用域 badge(config/表)徽标品牌覆盖(warn)/全局默认(dim)存储层判定品牌行显覆盖生效
AC-EL-ADS-168✏️/🗑(config/表)按钮编辑/删除(删除品牌级需 kit confirm)DELETE /api/ads/rule-config/{key}(ads.py:1355);交互:确认弹层删后回全局默认生效
AC-EL-ADS-169生效脚注(config/脚注)文本「次日 23:00 UTC 生效或立即重跑」与 119 联动改参+立即重跑即时生效生效

§11.10 结算页(/settlement · AC-EL-STL,24 条 · 2026-10-22 源码实证 web/app/settlement/page.tsx 130 行 + api/routers/finance.py /api/settlement,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-STL-001页面标题/面包屑导航AppShell title=回款跟踪,面包屑"Amazon 回款/结算跟踪 · 回款跟踪口径"路由 /settlement;接口权限 require_module("finance");数据经 tenant_conn+brand_scope 企业/品牌隔离e2e 登录财务模块账号断言标题与面包屑逐字一致生效
AC-EL-STL-002错误横幅反馈接口失败时红色横幅 role="alert"getJson 异常 setErr 后渲染;无错误时不占位e2e mock 500 断言出现且带 alert 角色生效
AC-EL-STL-003KPI 卡①待回款KPI 卡数量(warn 色)+ foot 金额 usd(pending_amount)(Shipped/Pending 未回款·基准后)summary.pending_count=count(*) FILTER(_P);金额=sum(revenue_usd) 同过滤;源表 audit.cleaned_amazon_orders;2026-10-01 ⑥拍板:行级 0 占位清洗不影响 KPI(0 不改变 sum)。
2026-10-28 修法 B(拍板#60)补记:_P=Shipped/Pending 且 NOT has_finance 且 purchase_date≥僵尸线 GREATEST(品牌财务基准 min(purchase_date WHERE has_finance), now−730d)(foot 注「基准后」);2026-10-31(AC-CAL-27 拍板①):_P 追加 AND NOT coalesce(is_removal,false)——移除单影子单移出待回款分母(zf 244→94)
SQL 直连按同口径复算 count/sum 与接口 summary 比对(|Δ|=0)生效
AC-EL-STL-004KPI 卡②回款异常(>14 天)KPI 卡数量(danger 色)+ 金额 + 文案"需优先核查"abnormal_count=count(*) FILTER(is_abnormal);金额=sum(revenue_usd) FILTER(is_abnormal);异常口径=已发货且超 14 天未回款(is_abnormal 同步层置位)SQL 复算 abnormal 两值;抽异常行断言 >14 天生效
AC-EL-STL-005KPI 卡③已回款率KPI 卡pct 百分比;null 显"—";foot"已发货X单中已回款Y单"settled_rate=settled/shipped(shipped=0 时接口返 null);shipped=count FILTER(order_status='Shipped'),settled=count FILTER(order_status='Shipped' AND has_finance);2026-09-21 测试缺陷修复:接口返 0~1 比例,前端需 ×100 后 pct 显示复算 settled/shipped×100 与页面一致;0 发单企业断言显"—"生效
AC-EL-STL-006KPI 卡④等待天数KPI 卡最长等待 max_wait;foot"待回款平均 avg_wait 天 · 健康线 14 天"max_wait=coalesce(max(days_waiting),0);avg_wait=coalesce(round(avg(days_waiting) FILTER(待回款口径)),0);14 天健康线与异常口径同源SQL 复算 max/avg 两值比对生效
AC-EL-STL-007回款明细卡标题卡片h2"回款明细"+ sub"按等待天数倒序"排序 ORDER BY days_waiting DESC, purchase_date DESC(次键下单日期倒序)抽首页数据断言两键单调生效
AC-EL-STL-008状态筛选 tabs筛选待回款/僵尸单/移除单/回款异常/已回款/全部 六 tab(2026-10-28 增僵尸单、2026-10-31 增移除单),默认"待回款",点击重置第 1 页filter→SQL 条件:pending=_P(STL-003 现行口径);zombie=_Z(同 _P 但 purchase_date<僵尸线,2026-10-28 拍板#60 B);removal=coalesce(is_removal,false)(2026-10-31 AC-CAL-27 拍板①);abnormal=is_abnormal;settled=has_finance;all=无条件。_P/_Z 均排除移除单e2e 逐 tab 断言 total 与行集符合条件生效
AC-EL-STL-009搜索框+搜索按钮筛选placeholder"搜索订单号 / SKU",submit 后 setQuery 并回第 1 页amazon_order_id ILIKE %kw% OR sku_list ILIKE %kw%(大小写不敏感);空串=不过滤搜已知单号/SKU 断言命中;搜不存在串断言空态生效
AC-EL-STL-010数据接口接口GET /api/settlement?filter&search&brand&page&page_size前端 pageSize=20;服务端 page=max(1,page)、page_size=min(100,max(1,page_size));响应含 total/page/summary/items接口直调断言分页边界(page=0→1;page_size=999→100)生效
AC-EL-STL-011表格列-订单号表格列等宽 sku 样式展示amazon_order_id,等宽 span.sku 纯文本,无行链接(本页未传 onRowClick,page.tsx:33)抽行比对源表订单号生效
AC-EL-STL-012表格列-品牌表格列品牌色点(branddot + brandColor)+ 品牌名brand;色点颜色由品牌映射函数决定,跨页一致同一品牌在首页/结算页断言同色生效
AC-EL-STL-013表格列-国家表格列国家码文本country 直显抽行比对生效
AC-EL-STL-014表格列-发货日期表格列日期文本shipped_date 为空回退 purchase_date(源无发货列品牌按订单时间推导,同脚注口径)造无发货日期行断言显下单日期生效
AC-EL-STL-015表格列-营收表格列本土币存在→本土币主显+USD 副行小字;否则仅 USDlocal_amount+currency 双字段存在时主显(2026-09-18 本土货币注释);2026-10-01 ⑥:未回款行(has_finance=false)revenue=0 系 local_amount=0 折算占位→接口置 null→前端显"—";settled 区 $0.00 为真值保留造 revenue=0 未回款行断言显"—";settled 区 $0.00 断言保留生效
AC-EL-STL-016表格列-净额 USD表格列muted 色净额net_usd;未回款行 net=0 同为同步占位(fg 2952/zf 1126 单全 0、onno 同位 NULL 实证)→null→"—";已回款区真值照显同 015 断言规则生效
AC-EL-STL-017表格列-回款状态表格列/badgebadge 四态:异常 bad"异常"/已回款 ok/待回款 warn/其他 dim;CSV 导出同款文案coalesce(settlement_status,'') 驱动;异常叠加 is_abnormal 优先;"待回款"=Shipped/Pending 且 NOT has_finance;2026-10-31(AC-CAL-27 拍板①)新标签「移除单」落 dim 态(sync 模板 CASE 首支,原提案「站外履约」废止)构造四态行断言样式;导出 CSV 断言文案一致生效
AC-EL-STL-018表格列-等待天数表格列天数数字;>14 时 danger 色+700 加粗days_waiting;14 天分界与 KPI 健康线/异常口径同源断言 14 天正常色、15 天红色加粗生效
AC-EL-STL-019表格列-SKU表格列多 SKU 逗号串,ellipsis 截断 maxWidth 220pxsku_list 原串;超宽 CSS 截断不换行长 SKU 串断言截断显示生效
AC-EL-STL-020加载态/导出按钮状态/按钮加载中骨架;exportCsv("settlement") 导出 CSVCSV 列=表列同序同文案(含状态列文案与页面一致)断言 CSV 首行表头与页面列名一致生效
AC-EL-STL-021空态空态"无匹配记录"total=0(含筛选/搜索无命中)时整表替换无命中搜索断言空态文案生效
AC-EL-STL-022分页器分页page/pages/total 展示与切页服务端 LIMIT/OFFSET 分页;切页保持当前 filter/search/brand末页/越界页断言行为正确生效
AC-EL-STL-023表上口径说明条口径caliber 常量文案:"结算明细表口径:金额=USD|数据源=结算明细(settlement 应计金额,非计数)|已结算 Settlement=已回款订单营收(settled_orders 计数口径不同)|回款状态=已回款/已退款+已回款。"UI 文案即验收标准(AC-UI-01),逐字受保护;计数/金额双口径区分声明页面文案与库内记录逐字 diff生效
AC-EL-STL-024底部口径脚注口径"Shipped/Pending 且无结算回款 = 待回款;已发货且超 14 天未回款 = 异常(各品牌一律要求未回款)。等待天数随每日同步实时重算(起点按品牌配置;源无发货列的品牌按订单时间推导)。回款状态来自财务明细视图,或按订单金额是否入账推导(入账=已回款)。"前两句已由 /api/settlement SQL 证实;"起点按品牌配置/订单时间推导"与"财务明细视图/入账推导"逻辑在同步层生成 days_waiting/has_finance/is_abnormal,本页源码未含其实现。

2026-10-22 换绿:同步层实证(只读 fork 逐行):起点推导=api/sync_source.py:283-289——zf=last_update_date(OrderLastUpdatedAt≈发货时点)、fg=coalesce(shipped_date,order_date)、onno=purchase_date,口径由 source_map 注册表显式键注入(:288-289);has_finance:zf 取 v_order_master(:306)、fg 取 v_fittingirls_order_finance_detail settlement_status=已回款(:333)、onno=LATERAAL settled(:374-376)=Shipped 且有金额(语义微差注记:是「有金额」非「有入账记录」);is_abnormal=Shipped AND 未回款 AND 等待>14 天(master:309/fg:341/onno:364);落表 _ORDERS_COLS(:1405-1414) 写企业 orders 表即本页数据源

2026-10-28/10-31 脚注增段:底部口径注在原文后追加两段(逐字受保护,同 AC-UI-01)——①僵尸单段(拍板#60 B, 2026-10-28):僵尸线=品牌财务基准与 SP-API 保留线 now−730 天较晚者,采集纪元前/保留线外订单不在待回款内、永不回款(过线当天自动转僵尸),如实呈现不硬修;②移除单段(AC-CAL-27 结算面, 2026-10-31 拍板①):影子单命中官方移除报告专表(退回/弃置/清算同标)不是销售永无回款——不占待回款分母、不入僵尸单(2024-08-15 首对 2 笔误转僵尸已回正)、豁免回款异常;营收本就=0;原「站外履约」标签废止
待核:读同步层 days_waiting 起点品牌配置项与 has_finance 入账推导实现,证实脚注三句与代码一致后转 p-ok生效
AC-EL-STL-025KPI 卡②僵尸单(永不回款)+ 僵尸单 tabKPI 卡/筛选数量(有值 danger/零 ok 色)+ foot"金额 usd · 永不回款 · 点「僵尸单」tab 看明细";title 悬停=僵尸线口径全文2026-10-28 拍板#60 修法 B 补记(本批 2026-10-31 随 AC-CAL-27 结算面批入册):zombie_count=count(*) FILTER(_Z)=Shipped/Pending 且 NOT has_finance 且 purchase_date<GREATEST(品牌财务基准, now−730d);与待回款互斥分母;接口 summary 返 zombie_count/zombie_amount;口径注僵尸单段(STL-024①);_Z 自 2026-10-31 起排除移除单SQL 按 _Z 复算比对;verify_finance「僵尸单 tab/KPI/口径注/可切」4 断言生效
AC-EL-STL-026KPI 卡③移除单(永不回款)+ 移除单 tab + 标签KPI 卡/筛选/badge数量(muted 色)+ foot"非销售 · 金额 usd · 点「移除单」tab 看明细";title 悬停=AC-CAL-27 结算面口径全文;明细行 badge=「移除单」dim 态2026-10-31 AC-CAL-27 拍板①:removal_count=count(*) FILTER(coalesce(is_removal,false))+removal_amount;filter=removal 独立桶;settlement_status 标签「移除单」(sync 模板 CASE 首支,回填 156 行+90 天窗自愈);zf 实测 156;fg 47 笔 S03- 同日采集点亮后入桶(audit.html 9.109);口径注移除单段(STL-024②)SQL 复算 removal 两值;verify_finance「移除单 tab/KPI/口径注/badge 端到端」4 断言;回填前后快照对账(STL-003 记录)生效

§11.11 API 接入(/settings · AC-EL-SET,源码 web/app/settings/page.tsx 237 行 + settings/ApiFieldsTab.tsx 91 行 + api/routers/settings.py·ai.py·collab.py 后端)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-SET-001页面框架·标题与面包屑布局AppShell title=「API 接入」,crumb=「平台 API 与服务商凭据 · 加密存储 · 仅管理员 · 全程审计」web/app/settings/page.tsx:100;页头注释 2026-09-16 立项:企业自助管理平台 API(SP-API/Ads/Noon) 与服务商(货代等)凭据e2e 断言标题与 crumb 文本;组件本体见 AC-EL-CMP(AppShell)生效
AC-EL-SET-002顶部 Tab 组(4 个)导航🔌 平台 API / 🚚 服务商(货代等)/ 📖 API 字段 / 🤖 大模型;默认 platform;切 tab 时 setEditing(null) 关闭编辑卡page.tsx:101-106;tab 状态 ∈ {platform, logistics, fields, llm}e2e 逐个点选断言 on 类切换与内容区联动生效
AC-EL-SET-003Tab·🔌 平台 API筛选只显示 category=platform 的接入类型与凭据page.tsx:64-65 过滤式 p.category === tab;provider 目录来自 GET /api/settings/providers(settings.py:109, 仅 owner/admin)e2e 切到本 tab,列表不应出现货代/other 类条目生效
AC-EL-SET-004Tab·🚚 服务商(货代等)筛选显示 category=logistics 与 category=other 两类(货代/物流/其他第三方服务接口凭据)page.tsx:64-65 tab === "logistics" && p.category === "other" 一并纳入e2e 断言 other 类凭据在本 tab 可见、platform tab 不可见生效
AC-EL-SET-005Tab·📖 API 字段挂载本 tab 渲染 ApiFieldsTab 组件(全库数据字典),详见 AC-EL-SET-036…043page.tsx:108 {tab === "fields" && <ApiFieldsTab />};组件本体 web/app/settings/ApiFieldsTab.tsxe2e 切 tab 断言「API 字段参考」标题出现生效
AC-EL-SET-006Tab·🤖 大模型挂载本 tab 渲染大模型供应商卡(#83),进入即拉取 GET /api/ops/llm/providers(ai.py:924)page.tsx:37 useEffect(tab==="llm" → loadLlm);权限门在后端(仅平台主企业 owner/admin),前端 tab 按钮对所有登录者可见e2e 切 tab 断言卡标题;非主企业账号断言出现无权限提示(SET-028)生效
AC-EL-SET-007凭据区·头部卡容器「平台凭据/服务商凭据 N 条」计数 + 按 tab 切换的说明文字 + 右侧「+ 新增接入」按钮;仅 platform/logistics 两 tab 且非编辑态渲染page.tsx:178-189;platform 说明=「SP-API 凭据支持一键 LWA 连通验证(真换 access token)」,logistics 说明=「货代/物流/其他第三方服务的接口凭据, 供运费/轨迹/对账集成」;N=catItems.length(当前 tab 过滤后条数)e2e 断言计数与列表行数一致;点新增进入编辑卡生效
AC-EL-SET-008凭据列表·表头表格7 列:名称/类型/掩码/状态/验证时间/更新/操作page.tsx:194;数据源 GET /api/settings/credentials(settings.py:117, 仅 owner/admin, 返回掩码 preview 不回明文)e2e 断言 7 个 th 文本生效
AC-EL-SET-009凭据列表·名称列列用户自起凭据名,strong 样式page.tsx:198;创建时必填且 trim 非空(page.tsx:69「类型与名称必填」),maxLength=80(SET-022)e2e 断言与新增时输入名一致生效
AC-EL-SET-010凭据列表·类型列列接入类型的展示名(provider label),目录中查不到时回退裸 keypage.tsx:199 providers.find(...)?.label || c.providere2e 断言与新增时选的类型 label 一致生效
AC-EL-SET-011凭据列表·掩码列列后端生成的掩码串,空值显「—」;任何接口不回明文page.tsx:200 c.preview || "—";掩码由 settings.py _mask(cfg) 生成;本库条目禁止出现任何真实凭据值或样例值e2e 断言掩码格式且与明文无子串重叠;抓包断言响应无明文字段生效
AC-EL-SET-012凭据列表·状态列列badge 四态:draft=草稿(warn)/verified=已验证(ok)/failed=验证失败(bad)/disabled=已停用(dim),未知值回退显原始 status;下方 t2 行显 status_msg 前 60 字符page.tsx:20-23 STATUS map + 201-202 slice(0,60);status/status_msg 来自列表接口与 verify 结果e2e 断言四态 badge 类名与文案;构造超 60 字 status_msg 断言截断生效
AC-EL-SET-013凭据列表·验证时间列列last_verified_at 截断到分钟(yyyy-MM-dd HH:mm),未验证显「—」page.tsx:203 slice(0,16).replace("T"," ")e2e LWA 验证成功后断言本列从「—」变为时间生效
AC-EL-SET-014凭据列表·更新列列updated_at 截断到分钟,恒有值page.tsx:204 同上截断式e2e 重录保存后断言时间刷新生效
AC-EL-SET-015操作列·🔍 验证按钮操作仅当该凭据所属 provider 规格 verify==="lwa" 时渲染(SP-API 类);点击 POST /api/settings/credentials/{id}/verify(settings.py:202),toast「✅/❌ + msg」,完成后刷新列表page.tsx:206-208, 84-91;后端 settings.py:215 同判 verify == "lwa" 才走真换 access token 的 LWA 连通验证e2e 断言非 LWA 类型无此按钮;LWA 类型点击后状态列变化与 toast 文案生效
AC-EL-SET-016操作列·✎ 重录按钮操作进入编辑卡,config 清空待整包重录(掩码即旧值,接口不回明文)page.tsx:210-213 setForm({provider, name, config:{}})e2e 点重录断言编辑卡打开且字段输入框为空生效
AC-EL-SET-017操作列·删除按钮操作danger 确认框「删除凭据?/关联的采集/推送将失效, 不可恢复。」(「采集/推送」为全角斜杠原文,page.tsx:94)确认后 DELETE /api/settings/credentials/{id}(settings.py:187),toast 已删除并刷新page.tsx:93-97, 215;删除走原生 fetch DELETE(postJson 无 DELETE 封装)e2e 删除测试凭据断言行消失与审计落账生效
AC-EL-SET-018凭据列表·空态行空态colSpan=7 居中行「还没有接入 — 点右上「新增接入」录入你的平台 API 或服务商凭据」page.tsx:219-223 catItems.length === 0e2e 空企业断言文案;新增后消失生效
AC-EL-SET-019凭据列表·安全脚注说明「安全:AES 加密存储 · 明文提交后即丢弃, 任何接口不回明文 · 变更全程只追加审计 · 仅 owner/admin 可见可操作。阶段边界:凭据自动接入采集管线为下一期(当前为管理与验证闭环)。」page.tsx:227-230;与页头注释(2026-09-16)阶段边界一致;审计走 settings.py _event() 只追加e2e 断言脚注全文;audit 表断言增删改各留一条且无 UPDATE 痕迹(只追加)生效
AC-EL-SET-020编辑卡·标题容器新增态「新增接入」,编辑态「编辑 #{id}」;副标显当前接入类型 label + hint(有则拼「 · 」)page.tsx:146-149 editing === "new" ? "新增接入" : \`编辑 #${editing}\`;curSpec 来自 providers 目录e2e 两种进入路径断言标题与副标生效
AC-EL-SET-021编辑卡·接入类型下拉输入选项=当前 tab 过滤后的 catProviders;编辑态 disabled(类型不可改);新增态切换类型时 config 清空重填page.tsx:151-155 disabled={editing !== "new"} + onChange 重置 confige2e 编辑态断言 select 不可交互;新增态切换断言已填字段清空生效
AC-EL-SET-022编辑卡·名称输入输入label 文本「名称(便于识别, 如 "US 主账号")」(input 无 placeholder 属性,page.tsx:157-158),maxLength=80,必填(trim 空则保存被拦)page.tsx:157-158 + 69 前置校验 toast「类型与名称必填」e2e 空名保存断言拦截 toast;81 字符断言截到 80生效
AC-EL-SET-023编辑卡·动态字段组输入按 provider 规格 fields 动态渲染:secret 字段 type=password,全部 autoComplete="new-password";optional 字段 label 后缀「(选填)」page.tsx:160-166;字段清单由 GET /api/settings/providers 下发(Field={key,label,secret?,optional?}),前端不硬编码e2e 断言 secret 字段 input.type=password 与 autocomplete 属性;选填后缀生效
AC-EL-SET-024编辑卡·💾 保存按钮操作新增 POST /api/settings/credentials、编辑 PUT /api/settings/credentials/{id};toast「已保存(加密存储)」/「已更新(整包替换)」;成功后关卡、表单重置、列表刷新;busy 期间 disabledpage.tsx:68-82;整包重录=PUT 携带全量 config(旧密文不参与合并)e2e 新增+重录各走一遍断言 toast 与列表行变化生效
AC-EL-SET-025编辑卡·取消按钮操作关闭编辑卡并把表单重置为当前 tab 首个 provider + 空名称/空 configpage.tsx:170e2e 填一半点取消,再点新增断言表单为干净态生效
AC-EL-SET-026编辑卡·明文丢弃提示说明保存/取消按钮旁灰字「提交后明文即刻丢弃(AES 加密落库, 列表只显掩码; 编辑需整包重录)」page.tsx:171-173;对应后端 _enc AES 加密落库、列表接口只回 _mask 结果e2e 断言文案存在;保存后再次编辑断言输入框为空(非回显明文)生效
AC-EL-SET-027LLM 卡·标题容器「大模型供应商」副标「平台级 AI 出口 · 仅平台主企业 owner/admin · 切换前自动连通自检(失败即回滚)」;出处 #83(2026-09-27)「大模型供应商自由切换 — 平台主企业(zipforce) owner/admin 专属卡」page.tsx:16 注释 + 112;权限强制层在后端 GET /api/ops/llm/providers(ai.py:924)e2e 主企业 admin 断言卡渲染;普通企业断言 SET-028 提示生效
AC-EL-SET-028LLM 卡·无权限态空态llmErr 时灰字「无权限或加载失败:{err}(仅平台主企业管理员可管理)」page.tsx:113;请求 403/失败均落此态,不弹全局错误e2e 普通企业 owner 打开 🤖 tab 断言本文案生效
AC-EL-SET-029LLM 表·表头表格6 列:供应商/模型/协议/端点/Key/操作(无验证时间等列,区别于凭据表)page.tsx:117;行数据=LlmState.providers(LlmP={id,label,model,format,endpoint,key_ok})e2e 断言 6 个 th生效
AC-EL-SET-030LLM 表·供应商列列label + badge:id===active 显「当前」(ok)、id===default 显「默认」(dim),二者互斥优先当前page.tsx:121-123 三元链 active > default > 无e2e 断言当前行恰一枚「当前」badge;默认行(非当前)显「默认」生效
AC-EL-SET-031LLM 表·模型/协议/端点列列model(sku 样式)/format/endpoint 三列纯展示page.tsx:124-126e2e 断言与 providers 接口返回一致生效
AC-EL-SET-032LLM 表·Key 列列badge:key_ok=true「就绪」(ok)/false「缺失」(bad);不显示任何 Key 内容page.tsx:127;key_ok 由后端判定(配置存在性),Key 值不出后端e2e 断言 badge 二态;页面源码/网络面板无 Key 值生效
AC-EL-SET-033LLM 表·切换按钮操作三态文案:busy=「探针中…」/当前行=「当前使用」/其余=「⇄ 切换到此」;disabled 条件 llmBusy || id===active || !key_okpage.tsx:129-132e2e 断言当前行与缺 Key 行均 disabled生效
AC-EL-SET-034LLM·切换流程操作确认框「切换大模型供应商?」正文含「切换到「{pid}」前会先实测一发连通探针, 失败自动回滚保持当前供应商。全平台 AI 立即走新供应商。」确认后 POST /api/ops/llm/switch(ai.py:938) {provider};changed=true toast「已切换 → {active}(探针回声: {probe_answer})」,false toast「已是当前供应商 {active}」page.tsx:39-48;探针+失败自动回滚在后端 switch 内实现,前端只呈现结果e2e 切换到另一供应商断言 badge 迁移与 toast;再切回断言幂等文案生效
AC-EL-SET-035LLM 卡·脚注说明「切换即时生效(下一次 AI 调用即走新供应商, 无需重启); 探针失败自动回滚保持原供应商; 全程审计。」page.tsx:140-142e2e 断言文案;切换后立即问一句 AI 断言走新供应商(audit 记录)生效
AC-EL-SET-036API 字段 Tab·标题容器「API 字段参考」副标「全库数据字典 · {total} 张表/视图 · 点击行展开列定义」;total 千分位ApiFieldsTab.tsx:28;total 来自 GET /api/mapping/api-fields(collab.py:105) 响应e2e 断言标题与 total 数与本节脚注(SET-043)快照数一致生效
AC-EL-SET-037API 字段 Tab·分组 Tab 组筛选「全部({N} 组)」+ 各分组按钮「{group} · {sub}({tables})」(sub===group 时只显 group);点分组即带 group&sub 重查,点全部清空两筛选ApiFieldsTab.tsx:30-38;groups 元数据(group/sub/tables/rows)由接口下发;点选后 setAf(null) 显加载态e2e 点任一分组断言表清单只剩该组;点全部恢复生效
AC-EL-SET-038API 字段 Tab·搜索表单筛选输入框 placeholder「表名 / 列名 / 描述」+「搜索」按钮;submit 才触发查询(输入过程不实时搜)ApiFieldsTab.tsx:39-44 onSubmit → setAfQuery(afSearch),afQuery 入参 search=e2e 输入已知列名提交,断言结果含该列所在表生效
AC-EL-SET-039API 字段 Tab·表头表格6 列:表 / 视图、schema、分组、列数(右对齐)、行数(右对齐千分位)、说明ApiFieldsTab.tsx:50;列数=columns.length,行数=接口 rows 字段e2e 断言 th 与数值格式生效
AC-EL-SET-040API 字段 Tab·表行与展开表格行尾 ▸/▾ 指示;点击行 toggle 展开(expanded===id),展开行背景 #f8f8ff;说明列超长省略号;schema 空显「—」ApiFieldsTab.tsx:53-62 expanded === t.id ? " ▾" : " ▸";单展开(再点同行收起,点他行切换)e2e 点行断言列定义区出现、再点收起、点第二行断言首行收起生效
AC-EL-SET-041API 字段 Tab·列定义展开区表格colSpan=6 子行,grid 卡片式列出每列「列名[红*] …… 类型」;红 *= !nullable(非空/主键列)ApiFieldsTab.tsx:63-76;columns={name,type,nullable} 由接口下发e2e 展开一张已知非空列的表断言红 * 出现生效
AC-EL-SET-042API 字段 Tab·空态行空态搜索/筛选无结果时 colSpan=6「无匹配」ApiFieldsTab.tsx:79e2e 搜乱码串断言文案生效
AC-EL-SET-043API 字段 Tab·脚注说明「数据源:数据字典快照(2026-09-06,Amazon/Noon/视图/共享库/选品库 8 组 181 张)。红色 * 为主键/非空列;本平台日更采集已覆盖其中 17 张核心表(见 数据管道)。」ApiFieldsTab.tsx:84-87;快照口径为静态文案,181 张为 2026-09-06 时点数(total 为接口实时数,二者允许不一致=快照定义)e2e 断言脚注全文含 2026-09-06/8 组 181 张/17 张生效

§11.12 账单页(/billing · AC-EL-BIL,24 条 · 2026-10-22 源码实证 web/app/billing/page.tsx 205 行 + api/routers/billing.py,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-BIL-001Suspense 兜底状态加载中占位useSearchParams 需 Suspense 边界,加载期整页兜底e2e 慢网断言加载文案出现后消失生效
AC-EL-BIL-002页面标题/面包屑导航AppShell title=计费,面包屑"套餐与订阅 · Stripe Checkout"路由 /billing;登录即可见(无模块门)e2e 断言标题与面包屑生效
AC-EL-BIL-003支付成功卡反馈?upgraded={plan} 回跳后 ok 边框卡"已订阅X,配额即时生效"checkout success_url=/billing?upgraded={plan};webhook checkout.completed 置 UPDATE tenants SET plan 后回跳才见带 query 直访断言卡片出现且套餐名正确生效
AC-EL-BIL-004错误横幅反馈接口失败红条仅 plans 失败 setErr(page.tsx:37);status 与 modules 失败静默吞掉 catch(()=>{})(page.tsx:33/38)不显红条mock plans 500 断言出现;mock modules 500 断言不出红条生效
AC-EL-BIL-005KPI 当前套餐KPI 卡套餐名;foot"支付通道已配置/支付通道未配置(演示模式)"GET /api/billing/status:plan=tenants.plan;stripe_configured=bool(STRIPE_KEY),两值同响应接口比对;未配 key 环境断言演示模式文案生效
AC-EL-BIL-006KPI AI 助手额度KPI 卡ai_ask 次/企业/天按当前 plan 取 PLAN_AI_QUOTA(core.py 单一事实源,与执行层限额共用同常量)断言显示值与 AI 问答实际拦截限额同源同值生效
AC-EL-BIL-007KPI 选品搜索/关注池KPI 卡keepa_search 次/天 · keepa_watch 个上限PLAN_KEEPA_QUOTA / KEEPA_WATCH_LIMIT(core.py 单源)断言与选品页实际限额一致生效
AC-EL-BIL-008未配置提示卡提示"联系平台管理员开通,无需您做任何配置"!stripe_configured 时展示演示模式断言出现生效
AC-EL-BIL-009模块超市卡标题卡片h2"模块超市"+ sub"八大模块按需采购 · 演示模式(免费开通/关闭,Stripe 接入后转正式计费)/正式计费"demo_mode 时演示分支文案,否则"正式计费"两种模式各断言 sub 文案生效
AC-EL-BIL-010info 说明横幅提示卡内 ok 色 info 横幅(ok-banner role=status,page.tsx:113)非静态:模块开关操作成功的结果反馈(setInfo 由 toggleMod 置值,初始为空不占位)切换模块断言横幅出现且文案含模块名生效
AC-EL-BIL-011模块卡网格布局grid minmax(215px,1fr),每模块一卡,卡头=模块名模块清单来自 MODULES(core.py),与导航/接口同源断言卡片数=MODULES 条数且名称一致生效
AC-EL-BIL-012模块状态 badgebadge已开通(ok)/未开通(dim)GET /api/billing/modules 返回企业开通态接口比对逐模块生效
AC-EL-BIL-013模块覆盖页面文本该模块覆盖页面列表 join(" · ")MODULES 定义内 pages 字段与 core.py MODULES 逐字比对生效
AC-EL-BIL-014模块开关按钮按钮demo_mode:开通/关闭(busy"处理中…";成功仅 info 横幅"X 已开通/关闭(导航与接口即时生效)",本页无 toast);非 demo:联系开通 disabledPOST /api/billing/modules/toggle body {module,enabled};demo 模式免 Stripe 即时生效e2e 切换后断言 badge 翻转、导航菜单与模块接口同步变化生效
AC-EL-BIL-015模块高亮定位反馈?mod={key} query→目标模块卡 brand 色边框+高亮(params.get("mod"),page.tsx:24)参数名为 mod;全仓 grep 未发现仓库内调用方,保留为外部直链入口带 mod=query 断言仅目标卡高亮生效
AC-EL-BIL-016套餐卡网格布局grid minmax(240px,1fr),四卡=Trial/Starter/Growth/EnterpriseGET /api/billing/plans 返回 BILLING_PLANS(billing.py 常量)+stripe_configured接口断言四档齐全生效
AC-EL-BIL-017当前套餐 badgebadge当前套餐卡显"当前"(ok)status.plan==plan.key 判定切换套餐后断言 badge 跟随生效
AC-EL-BIL-018套餐价格文本"$price/月"BILLING_PLANS:trial 0/starter 49/growth 199/enterprise 499与常量逐字比对生效
AC-EL-BIL-019套餐权益列表文本features 逐条 ulBILLING_PLANS.features 数组原文(含各档 AI/搜索/关注池次数文案)与常量逐字比对;文案内次数须与 022 表数字一致生效
AC-EL-BIL-020套餐按钮三态按钮trial→"默认套餐"disabled;当前→"使用中"disabled;其他→"升级到X"(disabled=!stripe_configured||busy;busy"跳转中…")三态状态机由 status.plan 与 busy 派生e2e 断言三态渲染与禁用条件生效
AC-EL-BIL-021升级跳转动作接口点击升级→POST /api/billing/checkout {plan}→取 url 整页跳转 Stripe;失败显 detail定价=STRIPE_PRICE_{PLAN} env;client_reference_id=tenant.slug、metadata[plan];审计 billing.checkout 留痕;plan 白名单 starter/growth/enterprise未配通道断言按钮禁用;已配环境断言跳转 url 为 stripe.com 域生效
AC-EL-BIL-022配额对比表表格列:套餐/价格$/AI 天/选品搜索天/关注池上限;当前行底色 #f8f8ff+"(当前)"数字同 PLAN_AI_QUOTA/PLAN_KEEPA_QUOTA/KEEPA_WATCH_LIMIT 单源(与 006/007/018 一致)断言表内 4×3 配额数字与 KPI 卡、features 文案三处同值生效
AC-EL-BIL-023底部脚注口径"订阅由 Stripe Checkout 托管,本平台不接触卡号;回调经 HMAC 验签后即时变更套餐与配额。降级 / 退订在 Stripe 客户门户操作,webhook 同步生效。"HMAC 已证:hmac.compare_digest(sig, hmac.new(STRIPE_WHSEC,...))(billing.py:131-132);降级/退订=客户门户操作,subscription 结束事件置 plan 回退 trial,billing_events 留痕文案逐字比对;webhook 无效签名请求断言 400 拒绝生效
AC-EL-BIL-024页面 loading状态"加载中…"plans/status 未回时整页占位慢网断言出现后消失生效

§11.13 回填页(/backfill · AC-EL-BKF,33 条 · 2026-10-22 源码实证 web/app/backfill/page.tsx 238 行 + api/routers/backfill.py,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-BKF-001页面标题/面包屑导航AppShell title=回溯任务,面包屑"三类回溯 · dry-run 预演 · 快照可回滚 · 死信队列 · 仅管理员"路由 /backfill;GET 类接口仅 current_user 鉴权;POST 类(runs/cancel)有 _require_admin 强制(见 013/026)e2e 断言标题与面包屑生效
AC-EL-BKF-002错误横幅反馈limits/runs 拉取失败红条 role="alert"Promise.all 任一失败 setErr;DLQ 拉取失败静默不报错mock 500 断言出现生效
AC-EL-BKF-003发起回溯卡标题卡片h2"发起回溯"+ sub"高危财务操作 · 全程审计留痕 · P2 低优队列(不挤占日常采集)"文案即风险声明;P2 低优=worker 队列优先级文案逐字比对生效
AC-EL-BKF-004平台下拉表单Amazon/Noon 二选,切换联动品牌与任务类型可选集limits 按平台过滤;brands=该平台去重品牌切平台断言品牌列表与上限 badge 重算生效
AC-EL-BKF-005品牌/店铺下拉表单该平台品牌列表;空显"—";默认取首个GET /api/backfill/limits:brands_source 启用品牌聚合(bool_or(enabled)),max(platform)接口比对品牌集生效
AC-EL-BKF-006任务类型下拉表单广告归因回溯/订单/退款补采/本地指标重算;选项取该品牌平台注册的 types(无则回退全量 TASK_META)TASK_TYPES=(backfill_ad, backfill_order_refund, recalc_order_metric) 白名单;每品牌平台 types 来自注册表合并不同品牌断言选项集差异;非法 task_type 提交断言 422生效
AC-EL-BKF-007时间口径下拉表单订单创建时间(order_created)/退款发生时间(refund_posted)time_basis 原样入 backfill_runs 并透传 worker 分片依据断言记录回显口径列正确生效
AC-EL-BKF-008起日期表单date 输入,max=今天;默认 30 天前todayStr(-30);spanDays=今天−起(自然日)断言默认值与 max 属性生效
AC-EL-BKF-009止日期表单date 输入,max=昨天;默认昨天todayStr(-1)——不允许选当日(回填不含今天)断言 max=昨天生效
AC-EL-BKF-010dry-run 复选框表单默认勾选;文案"只出差异报表,不写业务库"dry_run=true 入库;按钮文案/进度列/删除权限均随 dry_run 变化勾选提交断言 toast"(dry-run 预览)"生效
AC-EL-BKF-011规则版本 badgebadge"规则版本 {NEXT_PUBLIC_BACKFILL_RULE ?? 2026-10-v1}"构建时环境变量注入,未设回退"2026-10-v1";版本随回溯规则修订升级断言当前构建显示值与发布配置一致生效
AC-EL-BKF-012平台上限 badgebadgemaxDays 存在时显"平台上限 N 天 · 本次回看 M 天";超窗变 bad 追加"· 超窗将被拒绝"上限=注册表 brands_source.source_map.backfill(*_max_days 键)合并代码 DEFAULT_LIMITS(Amazon:广告 60/订单退款 731/重算 731;Noon:订单退款 180/重算 180);服务端超窗 400 拒绝不入队(前端预判+后端强制双层)超窗提交断言前端禁用+直接调接口断言 400;边界值 N 天断言放行生效
AC-EL-BKF-013提交按钮按钮disabled=busy||无品牌||超窗||止<起;文案 dry-run"预演出报表"/正式"正式执行(快照可回滚)";busy"提交中…"POST /api/backfill/runs(_require_admin,backfill.py:93):校验企业品牌归属→INSERT backfill_runs→审计 backfill.create→arq 入队(_job_id=backfill:{id});成功 toast"任务 #N 已入队"e2e dry-run 全流程:提交→toast→记录出现;非本企业品牌断言拒绝生效
AC-EL-BKF-014发起卡脚注口径"平台最大回溯窗口注册表驱动(brands_source.source_map.backfill):Amazon 广告 60 天 / 订单退款 731 天,Noon 订单退款 180 天。单企业同类任务同时仅 1 个在跑(排队自动延迟);补采走既有幂等 UPSERT 主干,报文另存 JSONB 快照表供溯源/断点续传。"窗口数字已证(DEFAULT_LIMITS+注册表合并);"同类仅 1 个在跑/幂等 UPSERT 主干/JSONB 快照表"在 worker 执行层,本页与 router 创建段未含其实现。

2026-10-22 换绿:worker 执行层实证(只读 fork 逐行):同类仅 1 在跑=Redis 企业信号量 api/tasks.py:50-68 tenant_sem(limit=1, ttl=86400, INCR 超限 DECR 拒绝、崩溃次日 TTL 自愈),调用点 backfill.py:216/:336/:586 三类均 limit=1,:5 docstring 单企业同类并发=1;幂等主干=窗口回写先按 brand+窗口 DELETE 再逐行 INSERT…ON CONFLICT DO NOTHING(:746-757)、快照分片已存跳过(:153-160)、:3/:10 常规链路 UPSERT 主干零改动;JSONB 快照表=public.backfill_snapshots(:158-160 写 run_id/tenant_id/table_name/kind/range_key/payload,溯源/回滚用不进业务读路径)
待核:读 worker 回溯执行体,证实同类互斥排队、UPSERT 幂等与快照表写入三句后转 p-ok生效
AC-EL-BKF-015任务记录卡标题卡片h2"任务记录"+ sub"{N} 条 · 进度/差异报表实时"GET /api/backfill/runs limit=50(服务端 min(limit,200)),created_at 倒序接口比对条数与排序生效
AC-EL-BKF-016列-序号表格列"#id"加粗backfill_runs.id 自增主键抽行比对生效
AC-EL-BKF-017列-品牌/平台表格列品牌名 + muted 小字"· 平台"brand/platform 入库原值抽行比对生效
AC-EL-BKF-018列-任务表格列TASK_META 中文名;dry_run 行追加"dry"badge未知 task_type 回退显示原始键断言三种类型名与 dry badge生效
AC-EL-BKF-019列-区间表格列"date_from~date_to"等宽 12px入库区间原值抽行比对生效
AC-EL-BKF-020列-口径表格列refund_posted→"退款",其他→"下单"time_basis 二值映射断言两口径回显生效
AC-EL-BKF-021列-状态 badge表格列/badgedone=ok/running=warn/queued=dim/error=bad/cancelled=bad;未知回退 dimSTATUS_TONE 前端映射;状态由 worker 经 backfill_runs.status 更新造各状态记录断言五态样式生效
AC-EL-BKF-022列-进度表格列"N 片"(chunks);无 chunks 时 dry_run→"预演"/"—";追加"· N 行"(rows)与"· 快照N"(snapshot_rows)progress JSONB(chunks/rows/dry_run)由 worker 实时更新;snapshot_rows=快照表行数跑一次 dry-run 断言进度字段渲染生效
AC-EL-BKF-023列-操作人表格列操作人邮箱,空显"—"创建时 users.email(_op_email)写入 operator_email断言当前账号提交后回显其邮箱生效
AC-EL-BKF-024列-时间表格列created_at"T"换空格截 16 位(分钟)UTC 入库时间抽行比对格式生效
AC-EL-BKF-025差异报表按钮按钮/弹层diff_report!=null 才显示;点击展开/收起,JSON 缩进 2 空格 pre(pre-wrap、break-all、maxHeight 320 滚动)diff_report JSONB 由 dry-run/正式执行产出dry-run 完成断言按钮出现、JSON 可读展开收起生效
AC-EL-BKF-026取消按钮按钮仅 queued/running 行显示"取消"POST /api/backfill/runs/{id}/cancel(_require_admin,backfill.py:146)→UPDATE status='cancelled'+审计 backfill.cancel;后端另有 DELETE /api/backfill/runs/{id}(仅 dry_run 记录可删,未在本页暴露 UI)e2e 取消排队任务断言状态翻转为 cancelled生效
AC-EL-BKF-027错误详情反馈status=error 且 error 非空→行内 danger 色文本截前 220 字backfill_runs.error 全量入库,展示截断造失败任务断言前 220 字显示生效
AC-EL-BKF-028记录空态空态"暂无回溯任务"(colSpan=10 跨全列)runs=[] 时渲染新企业断言空态生效
AC-EL-BKF-029死信队列卡标题卡片h2"死信队列"+ sub"arq:dlq · 重试耗尽的任务 · 重投原样参数"GET /api/ops/dlq(Redis arq:dlq,lrange(0,99) 上限 100 条,backfill.py:198);接口失败静默置 null 不阻塞页面断言正常加载;接口挂断时页面其余功能不受影响生效
AC-EL-BKF-030死信空态空态"队列为空,无死信。"dlq 为 null 或 count=0空队列断言文案生效
AC-EL-BKF-031死信表格列表格列列:#index/任务(function+args JSON 截 60 字)/job_id 等宽/错误(error_code+message,danger 色)/时间(ts 截 19 秒)arq DLQ 条目结构 {index,ts,job_id,function,args,error_code,message};缺省字段显"—"造死信断言各列渲染与截断生效
AC-EL-BKF-032死信重投按钮按钮"重投"→toast"死信已重投队列"POST /api/ops/dlq/retry {index}:原样参数重新入队e2e 重投断言条目离开 DLQ 且任务重新出现生效
AC-EL-BKF-033死信丢弃按钮按钮"丢弃"→toast"死信已丢弃"POST /api/ops/dlq/drop {index}:从 DLQ 移除(不可恢复)e2e 丢弃断言条目消失生效

§11.14 数据浏览(/database · AC-EL-DB,源码 web/app/database/page.tsx 183 行 + api/routers/collab.py 355-483)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-DB-001页框架·AppShell框架title=数据浏览,crumb=「表结构 · 数据浏览(只读)」AppShell 共享组件(§11 组件批);本页无独立工具栏,品牌过滤经顶栏 BrandContext 注入(AC-EL-DB-031)e2e 路由可达 + 标题/crumb 逐字生效
AC-EL-DB-002错误横幅反馈err 非空时 div.error role=alert 渲染三个数据端点(tables/table/rows)任一 catch 均写 err=String(e.message);marginBottom 16断端点/403 场景横幅出现生效
AC-EL-DB-003布局容器 .db-layout布局左表清单 + 右结构/数据双栏2026-10-01 像素审计 P3 缺陷㊱修复:原 inline width:280+flexShrink:0 在 390px 视口把右栏压到 94px 且横向溢出 2px(截图 392px 实证)→ 布局参数移入 CSS 类 + 移动端断点改上下堆叠390px 视口无横向滚动条(截图比对)生效
AC-EL-DB-004左栏·表清单卡容器card db-tree,全部可浏览表的入口内容=/api/db/tables items;敏感表/备份表在后端被拦(AC-EL-DB-026),清单内不可见端点 JSON 行数 vs 清单行数一致生效
AC-EL-DB-005搜索表名输入框筛选placeholder「搜索表名…」,即时前端过滤filter 非空时 tables.filter(t.table.includes(filter)) 子串匹配,不发请求;不 trim、大小写敏感(原样 includes)输入子串清单实时收缩生效
AC-EL-DB-006表清单行列表行每行=表名+右侧元信息,点击选中该表选中态:背景 var(--brand-weak,#e0f2e9)+fontWeight 700;行 padding 6px 10px fontSize 13,space-betweene2e 点选后右侧加载结构卡生效
AC-EL-DB-007🏷 品牌列徽标徽标has_brand 表名前显 🏷,title=「有品牌列」has_brand=后端查 information_schema.columns 存在 brand 列的表集合有 brand 列的行悬停提示存在生效
AC-EL-DB-008行数估算数值清单行右侧 int(rows_est)pg_class.reltuples 估算(后端 max(0,reltuples)),非精确 count——避免逐表全表 count;空态 legend 明示「行数为估算值」(AC-EL-DB-011)与 pg_class 直查值一致生效
AC-EL-DB-009无匹配表空态空态filtered.length=0 时 p.muted「无匹配表」仅前端过滤结果为空触发输入不存在子串显示该行生效
AC-EL-DB-010右栏·未选空态卡空态sel 为空时居中卡「选择表名查看结构和数据」padding 40 textAlign center初始进入页面显示生效
AC-EL-DB-011空态 legend说明「🏷 = 有品牌列(可随顶栏品牌切换过滤)· 行数为估算值」🏷 语义 + 估算行数双重声明(fontSize 12)文案逐字存在生效
AC-EL-DB-012表结构卡标题标题h2=表名 + sub「{N} 列 · {total} 行{ · 🏷 品牌过滤}」N=columns.length;total=后端 count(*) 精确值(此处非估算);has_brand 才追加 🏷 段结构端点 JSON vs 标题三段生效
AC-EL-DB-013列徽标墙徽标每列一枚 badge dim:列名+灰色小字号类型title={type} · {可空|非空}{ · 默认 X}(default 非空才追加);flex wrap gap 4悬停 title 与 information_schema 一致生效
AC-EL-DB-014数据卡·搜索表单筛选input「搜索…」maxWidth 300 + 「搜索」按钮onSubmit:preventDefault + setPage(1)+setQuery(search)——提交才生效(非即时);搜索范围=后端 ILIKE 前 8 列(任意类型,AC-EL-DB-028)e2e 提交后 rows 请求带 search 参数生效
AC-EL-DB-015行数/页码计数器数值rows 就绪「{total} 行 · 第 {page}/{pages} 页」,否则「加载中…」total=过滤后 count(*);pages=max(1, ceil(total/50))翻页/搜索后计数联动断言生效
AC-EL-DB-016结果表容器表格.tbl-wrap maxHeight 55vh overflow auto,fontSize 12行/列双向滚动,表头 sticky(AC-EL-DB-017)滚动行为 + 表头吸附生效
AC-EL-DB-017表头 sticky表头每列 th nowrap + position sticky top 0列名=rows.columns(后端 ordinal_position 顺序);背景 var(--card,#fff) zIndex 1端点 columns vs 表头逐字一致生效
AC-EL-DB-018单元格 NULL格式值 null/undefined → span.muted「NULL」区分空字符串(空串原样显示为空白)含 null 列的行显示 NULL生效
AC-EL-DB-019单元格长值截断格式String 值长度 >80 → slice(0,80)+「…」仅显示层截断;全值经 title 悬停可见(AC-EL-DB-020)长文本列悬停得全文生效
AC-EL-DB-020单元格 ellipsis格式maxWidth 200 + overflow hidden + ellipsis + nowraptitle=String(r[c] ?? "")——悬浮给完整值悬停 title=完整值生效
AC-EL-DB-021空数据行空态items 空 → colSpan 全列居中提示brand 非空「品牌 {brand} 无数据」否则「无数据」——品牌过滤是空因之一选品牌后空表显示品牌提示生效
AC-EL-DB-022翻页器翻页「← 上一页」「下一页 →」两按钮page≤1 / page≥pages 时 disabled;点击 setPage(∓1) 触发重载首末页禁用态 e2e生效
AC-EL-DB-023页大小常量口径pageSize=50(前端常量)后端 page_size 钳制 [1,200],50 在界内;pages 由 total/50 向上取整rows 请求参数断言 page_size=50生效
AC-EL-DB-024换表重置行为交互sel 变更 → detail/rows 置空 + page=1 + query/search 清空先渲染空/加载态再拉新表,避免旧表数据残留e2e 连续切换两表无残留生效
AC-EL-DB-025后端·表清单端点APIGET /api/db/tables_require_admin 门禁(仅管理员);public schema BASE TABLE 全集去敏感表;has_brand=information_schema DISTINCT brand 列表;rows_est=pg_class.reltuples端点响应 vs information_schema/pg_class 直查生效
AC-EL-DB-026后端·敏感表黑名单安全_BLOCKED_TABLES 精确集 11 表 + bak_ 前缀双拦11 表=users/tenants/tenant_brands/audit_log/usage_daily/tenant_credentials/tenant_credential_events/credentials/mcp_keys/billing_events/subscriptions(凭证/密码/token/计费身份绝不进浏览器;D批P3-15 删 4 死条目补 6 后上线表);P2-9(2026-10-21):bak_ 前缀拦手工备份表(bak_ 表常含跨企业全集,精确集漏列即整表可浏览),后续备份表按 bak_<表>_<日期> 命名自动被拦逐表请求 403「敏感表不可浏览」;bak_ 造名同拦生效
AC-EL-DB-027后端·表结构端点APIGET /api/db/table/{table}admin 门禁+表名白名单(AC-EL-DB-029)+黑名单三重;columns=information_schema(name/type/nullable/default,ordinal_position 序);无列 404「表 {t} 不存在」;total=精确 count(*);has_brand=列中有 brand结构 JSON vs pg 直查生效
AC-EL-DB-028后端·数据行端点APIGET /api/db/table/{table}/rowsbrand 过滤仅 has_brand 表生效(brand=%s);search=前 8 列任意类型(排除 id/tenant_id,非按类型筛选,collab.py:459-460)coalesce ::text ILIKE %kw% OR 组;ORDER BY 1 DESC(首列倒序);page=max(1,page),page_size 钳 [1,200]请求参数 vs SQL 语义逐项生效
AC-EL-DB-029后端·表名白名单正则安全^[A-Za-z_][A-Za-z0-9_]{0,62}$P2-9 纵深防御:table_name 拼 f-string SQL,白名单先于一切;结构/行两端点同拦注入载荷(引号/分号/空格/超长)返回 400「非法表名」生效
AC-EL-DB-030后端·行值序列化口径datetime→isoformat()[:19];dict/list→json.dumps(ensure_ascii=False)[:200];float→round(,4)三类规整后下发,jsonb 截 200 字符防大对象含 jsonb/浮点列的行值形态生效
AC-EL-DB-031品牌过滤联动筛选顶栏品牌(BrandContext)→ rows?brand= 参数仅 has_brand 表后端加 brand= 条件;无 brand 列表忽略该参数(返回全量行);tenant_conn 带 request.state.brand_scope(RLS 双保险)切品牌后行数变化 + 空态文案联动生效

§11.15 数据字典(/dictionary · AC-EL-DIC,源码 web/app/dictionary/page.tsx 145 行 + api/routers/collab.py 512-550 + api/data_dict_meta.py)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-DIC-001页框架·AppShell框架title=数据字典;crumb=「全部业务表 × 字段含义 · 按业务域分组 · 语义注释与 changelog 归档同源」2026-09-24 用户令「所有字段按业务输出到 zipforcehub」立页e2e 路由可达 + crumb 逐字生效
AC-EL-DIC-002双 tab 切换导航「字段字典(系统口径)」「电商词汇(行业口径)」两 tabview state fields|gloss,tab.on 选中态;两视图共用同一 q 搜索词 state(切 tab 不清空)e2e 切换渲染对应视图生效
AC-EL-DIC-003计数行数值fields:「{total_tables} 张业务表 · {total_columns} 个字段 · {N} 个业务域」;gloss:「{total} 个词条 · {N} 个业务域」;未就绪「加载中…」站内不展示行数(多企业规模不泄露;md 归档版含行数——AC-EL-DIC-019)端点 totals vs 计数行生效
AC-EL-DIC-004字段 tab·搜索框筛选placeholder「搜索表名 / 列名 / 含义(如 settlement、净利、acos)」maxWidth 380即时 useMemo 过滤(输入即生效,无提交按钮)输入即过滤生效
AC-EL-DIC-005字段过滤逻辑口径q.trim().toLowerCase() 后 includes 匹配命中面:表名/表描述/任一列名/任一列含义;域内表全不命中则整域卡隐藏大小写不敏感子串命中抽测生效
AC-EL-DIC-006加载失败行反馈「加载失败: {err}」p.muted仅 /api/dictionary 失败显示;glossary 失败静默(AC-EL-DIC-017)不影响字段面断 dictionary 端点显示该行生效
AC-EL-DIC-007业务域卡容器h2=域名(fontWeight 800)+「 · {N} 张表」域序=/api/dictionary domains 顺序(data_dict_meta.DOMAINS 定义;立页时 12 域)域数/域序与端点一致生效
AC-EL-DIC-008表行列表行mono 表名 + muted 表描述 + badge「{N} 列」+「展开 ▼/收起 ▲」点击 toggle,open=domain+"/"+table——单开互斥(同时只展开一张表);desc 空则不渲染描述段展开互斥行为 e2e生效
AC-EL-DIC-009展开字段表表格3 列:列(sku mono,宽 190)/类型(muted,宽 150)/含义(fontSize 13)minWidth 480 横向滚动;列序=information_schema ordinal_position展开后列名序列 vs 端点 cols生效
AC-EL-DIC-010含义空值格式c.desc 空 → muted「—」desc 三级回退:SPECIFIC[表][列] → COMMON[列] → ""(后端)无注释列显示 —生效
AC-EL-DIC-011其他表(未分域)卡容器h2「其他表(未分域)」+ other_tables 以「 · 」连接仅 other_tables 非空且无搜索词(!q)时渲染;other_tables=不在 DOMAINS 的库表排序集搜索时该卡隐藏生效
AC-EL-DIC-012词汇 tab·搜索框筛选placeholder「搜词条 / 英文 / 释义(如 ACOS、跟卖、IPI)」maxWidth 380即时过滤(与字段 tab 同一 q)输入即过滤生效
AC-EL-DIC-013词汇过滤逻辑口径五字段 lowercase includes命中面:term/en/abbr/desc/sys;空域整卡隐藏任一字段子串命中抽测生效
AC-EL-DIC-014词汇域卡容器h2=域名+「 · {N} 条」域序=glossary_domains() 顺序域数/条数与端点一致生效
AC-EL-DIC-015词汇表表格5 列:词条(strong,120)/英文全称(190)/官方缩写(sku mono,90)/释义(13)/系统落点(sku,220)minWidth 520 横向滚动;系统落点 whiteSpace normal 可换行列头与端点字段一一对应生效
AC-EL-DIC-016系统落点空值格式e.sys 空 →「—」sys=后端 attach_sys 注入(term_field_map:词条→库表/页面落点)无落点词条显示 —生效
AC-EL-DIC-017词汇加载态/静默失败反馈g 未就绪「加载中…」;glossary 请求失败静默catch 空函数——词汇面缺席不阻断字段面断 glossary 端点页面仍可用生效
AC-EL-DIC-018后端·字典端点APIGET /api/dictionaryinformation_schema 全 public 列按表分组;DOMAINS 分域 + SPECIFIC/COMMON/TABLE_DESC 语义注释;total_tables=有列表数、total_columns=列总数;不在 DOMAINS 的表进 other_tables(sorted)端点 vs pg 直查计数生效
AC-EL-DIC-019语义层单一事实源口径api/data_dict_meta.py = 字典语义唯一源站内 /api/dictionary 与 tools/gen_data_dictionary.py(md 导出)共用;站内无行数、md 归档版含行数;立页时 12 业务域 × 113 表(页内计数实时取端点);现值 12 域 × 114 唯一表(115 token 中 1 重复,2026-10-22 校对数);changelog 归档同源(crumb 声明)md 归档版与站内字段/含义抽测一致生效
AC-EL-DIC-020后端·词汇端点APIGET /api/glossaryglossary_domains()+attach_sys 注入系统落点;total=Σ各域词条;与 MCP glossary 工具共用同源;changelog 归档版 /audit/ecommerce-glossary-2026-09-24.md 同步维护端点 total vs 页面计数生效

§11.16 文档中心(/documents · AC-EL-DOC,源码 web/app/documents/page.tsx 140 行 + api/routers/collab.py 75-103)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-DOC-001页框架·AppShell框架title=文档;crumb=「文档中心 · 飞书云盘链接树」require_module("collab") 门禁(AC-EL-DOC-023)e2e 路由可达 + crumb 逐字生效
AC-EL-DOC-002错误横幅反馈err 非空时 div.error role=alertload/doSearch catch 均写 err=String(e.message)断端点场景横幅出现生效
AC-EL-DOC-003KPI 卡·根目录KPIint(kpi?.roots);foot「品牌 / 部门 / 运营资料分区」roots=documents_nodes 中 parent='' 行数(后端 FILTER);kpi 仅 parent="" 根请求返回(AC-EL-DOC-022);kpi null → int=0端点 kpi vs 卡值生效
AC-EL-DOC-004KPI 卡·文档链接KPIint(kpi?.files);foot「飞书云文档 / 表格 / 上帝视角」files=type='file' 行数(FILTER 计数)同上生效
AC-EL-DOC-005KPI 卡·节点总数KPIint(kpi?.total);foot「含全部文件夹层级(去重后)」total=documents_nodes count(*)(path 唯一——去重口径声明)同上生效
AC-EL-DOC-006文档树卡标题标题h2「文档树」+ sub「点击文件夹展开 · 文件跳转飞书原链」交互语义声明:树内导航 + 文件外跳文案逐字存在生效
AC-EL-DOC-007搜索表单筛选input「搜索路径或文件夹名」maxWidth 380 + 「搜索」按钮onSubmit→doSearch()(提交才请求);输入框清空(!trim)时即时 setResults(null) 回树e2e 提交后切结果表生效
AC-EL-DOC-008搜索 P0 修复注记缺陷史2026-09-17 修(P0):原 doSearch 读 query 但 setQuery 全文件零调用(死 state),搜索永远短路现版本 doSearch(kw?) 提交即 setQuery+请求;空 q 直接回树搜索可用 e2e(历史缺陷不回归)生效
AC-EL-DOC-009清除按钮交互ghost「清除」,仅 results 存在时渲染点击 setResults(null)+setSearch("") 回树视图有结果才显示;点击回树生效
AC-EL-DOC-010搜索结果表表格3 列:路径(sku mono)/类型/操作类型 badge:文件夹 dim「文件夹」/文件 ok「文件」;操作列 url 有值才渲染「打开 ↗」(brand 色 target _blank)结果行 vs 端点 items生效
AC-EL-DOC-011无匹配空态空态results 空 → colSpan 3「无匹配」居中 padding 28total=0 或 items 空均触发无结果关键词显示生效
AC-EL-DOC-012结果计数行数值「匹配 {resultTotal} 条,显示前 {results.length} 条」resultTotal=ILIKE 命中总数(count(*));items 上限 min(500, limit)、默认 limit=300——总数与显示上限分离计数 vs 端点 total生效
AC-EL-DOC-013树容器容器border 圆角容器 maxHeight 560 overflowY auto根未载入时 p.muted「加载中…」长树纵向滚动生效
AC-EL-DOC-014树行·文件夹按钮列表行btn inline ghost「{…|−|+} 📁 {name}」,点击 toggleloading 中显示 …;isOpen=−;未展开=+;fontSize 13e2e 展开加载子级生效
AC-EL-DOC-015树行·文件链接列表行a「📄 {name}」跳 url 新窗口target _blank rel noreferrer;颜色 var(--text) 无下划线点击打开飞书原链生效
AC-EL-DOC-016文件夹子项计数数值文件夹行右 muted「{children} 项」P3 缺陷⑤ polish:原守卫 children>0 使空文件夹无计数——快照 82% 文件夹为空,显示「0 项」区分「真空文件夹」与「未展开」;API 侧 children 始终真计数(含根级)空文件夹显示 0 项生效
AC-EL-DOC-017缩进规则布局marginLeft = depth×18每层级 18px 表达树深多层展开缩进递增生效
AC-EL-DOC-018惰性加载交互toggle 展开且 children[path] 无缓存才 load(path)loading 中子级不渲染(null 防闪旧数据);已缓存直接复用二次展开不重发请求生效
AC-EL-DOC-019数据源脚注说明「数据源:飞书云盘文档树快照(按本企业品牌范围过滤)。链接目标为飞书域,访问权限跟随飞书账号;树为企业自有资产(RLS 隔离)。」三层边界声明:快照按企业品牌过滤 / 飞书侧权限独立 / RLS 企业隔离文案逐字存在生效
AC-EL-DOC-020后端·树端点 children 模式APIGET /api/documents/tree?parent=单层子节点:WHERE parent=%s,ORDER BY (type='folder') DESC, name(文件夹优先);children=子路径 count 真计数;total=len(items)parent 逐层请求 vs SQL 直查生效
AC-EL-DOC-021后端·树端点 search 模式APIGET /api/documents/tree?search=path ILIKE %kw%;total=count(*) 全命中;items LIMIT min(500,limit);search 项 children 恒 0;kpi=null搜索总数/上限语义验证生效
AC-EL-DOC-022后端·kpi 口径口径仅 parent="" 根请求返回 kpikpi={total: count(*), files: FILTER(type='file'), roots: FILTER(parent='')};非根请求 kpi=null(前端仅根 load 存 kpi)根/子请求响应对比生效
AC-EL-DOC-023模块门禁安全require_module("collab")需 collab 模块授权账号;tenant_conn 企业库(documents_nodes 表)未授权账号 403生效

§11.17 账户安全(/account · AC-EL-ACC,源码 web/app/account/page.tsx 111 行 + api/routers/auth.py 后端)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-ACC-001页面框架·标题与面包屑布局AppShell title=「账户安全」,crumb=「会话管理 · 修改密码 · 服务端会话可吊销」account/page.tsx:51;组件本体见 AC-EL-CMP(AppShell)e2e 断言标题与 crumb生效
AC-EL-ACC-002错误横幅反馈红色 error 条,role="alert",marginBottom 16;err 非空时渲染account/page.tsx:52;内容为接口异常 message 原文e2e 构造改密失败(旧密码错)断言横幅出现生效
AC-EL-ACC-003成功横幅反馈ok-banner 条,role="status";改密成功后显示回执(见 ACC-010)account/page.tsx:53e2e 改密成功断言横幅文案生效
AC-EL-ACC-004修改密码卡·标题容器「修改密码」副标「改密后其他设备全部下线,当前设备保持登录」account/page.tsx:56e2e 断言标题与副标生效
AC-EL-ACC-005修改密码·当前密码输入输入type=password,受控 pwd.oldaccount/page.tsx:58e2e 断言 input.type=password生效
AC-EL-ACC-006修改密码·新密码输入输入label「新密码(≥8 位)」type=password,受控 pwd.new1account/page.tsx:59;≥8 位为前后端一致约束(前端 ACC-008 先拦)e2e 断言 label 文本生效
AC-EL-ACC-007修改密码·确认新密码输入输入type=password,受控 pwd.new2account/page.tsx:60e2e 断言三输入框齐备生效
AC-EL-ACC-008修改密码·客户端校验校验两次提交前检查:new1≠new2 →「两次输入的新密码不一致」;new1.length<8 →「新密码至少 8 位」;均写 err 横幅不发请求account/page.tsx:38-39e2e 两种非法输入各断言拦截文案且网络面板无 POST生效
AC-EL-ACC-009修改密码·按钮操作文案 busy=「提交中…」/常态「修改密码」;disabled = busy || !old || !new1(new2 空可点但会被一致性校验拦)account/page.tsx:62-64e2e 空表单断言 disabled;填齐断言可点生效
AC-EL-ACC-010修改密码·成功反馈反馈POST /api/auth/password(auth.py:559) {old,new};成功回执「密码已修改;其他 {revoked_other} 个设备会话已吊销,当前设备保持登录」,三个输入框清空account/page.tsx:42-45;revoked_other 由后端统计并吊销的其他会话数,当前会话豁免e2e 双会话账号改密:另一会话刷新即 401 跳登录,当前会话保持;回执数=另一会话数生效
AC-EL-ACC-011在册会话卡·标题容器「当前在册会话」副标「8 小时滑动有效期 · 每次访问自动续期」account/page.tsx:68;8h 滑动=会话机制卡口径(ACC-023)e2e 断言标题与副标生效
AC-EL-ACC-012在册会话卡·加载态空态items 未返回时灰字「加载中…」account/page.tsx:69e2e 弱网断言先显加载态生效
AC-EL-ACC-013会话表·表头表格3 列:会话/登录时间/状态account/page.tsx:73;数据源 GET /api/auth/sessions(auth.py:151) → items: Sess[]e2e 断言 3 个 th生效
AC-EL-ACC-014会话表·会话标识列列sid 打码展示(前 8 位+「…」,sid[:8]+"…" auth.py:157;sku 样式),每行 key=sidaccount/page.tsx:77;sid 为服务端在册会话 ID,非令牌本体e2e 断言至少一行 sid 非空生效
AC-EL-ACC-015会话表·登录时间列列created 原样展示(muted),不做时区/格式转换account/page.tsx:78e2e 断言与登录时刻一致生效
AC-EL-ACC-016会话表·状态列列badge:current=true「当前设备」(ok)/false「其他设备」(dim)account/page.tsx:79e2e 断言恰一行「当前设备」生效
AC-EL-ACC-017会话表·空态行空态colSpan=3「无在册会话」(登出后立即回显场景)account/page.tsx:82e2e 退出全部后未跳转前断言(或 mock 空 items)生效
AC-EL-ACC-018刷新按钮操作「刷新」重拉 GET /api/auth/sessions;busy 期间 disabledaccount/page.tsx:88e2e 另开登录后点刷新断言新行出现生效
AC-EL-ACC-019退出全部设备按钮操作danger 确认框「退出全部设备?/所有已登录会话立即作废。」确认后 POST /api/auth/logout-all(auth.py:165),成功即 router.replace("/login");失败显 err 且 busy 复位account/page.tsx:26-34, 89-91;成功路径不 reset busy(直接离开页面)e2e 双会话账号执行:两处均被登出且旧 Cookie 复用请求 401生效
AC-EL-ACC-020会话机制卡·标题容器「会话机制」副标「2026-09-06 安全加固」account/page.tsx:96;静态说明卡,无接口调用e2e 断言标题与副标生效
AC-EL-ACC-021会话机制·令牌形态行说明「HMAC 签名(防伪造)+ Redis 服务端在册(可吊销),双校验缺一不可」account/page.tsx:100e2e 断言文案;渗透测试矩阵含伪造签名/未在册令牌双拒用例生效
AC-EL-ACC-022会话机制·登出生效行说明「服务端即刻吊销,旧 Cookie 立即作废(此前仅删浏览器 Cookie,令牌仍有效 8h)」account/page.tsx:101e2e 登出后用旧 Cookie 重放断言 401生效
AC-EL-ACC-023会话机制·有效期行说明「8 小时滑动;Redis 故障时按未认证处理(fail closed)」account/page.tsx:102e2e 断言文案;故障注入 Redis 不可用断言全部 401(fail closed 不放行)生效
AC-EL-ACC-024会话机制·防跨企业行说明「令牌绑定企业 slug,跨子域使用直接拒绝(渗透测试矩阵覆盖)」account/page.tsx:103e2e 持 A 企业令牌访问 B 企业子域断言 401生效

§11.18 团队(/team · AC-EL-TEAM,源码 web/app/team/page.tsx 291 行 + api/routers/org.py·auth.py 后端)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-TEAM-001页面框架·标题与面包屑布局AppShell title=「团队」,crumb=「员工账号 · 模块×品牌授权 · 品牌管理」team/page.tsx:151;组件本体见 AC-EL-CMP(AppShell)e2e 断言标题与 crumb生效
AC-EL-TEAM-002非管理员拒绝态权限meta 拉取 403 时整页替换为居中卡「仅管理员可见」+「员工账号管理需要 owner / admin 权限。{err}」,无任何管理功能渲染team/page.tsx:47-49, 137-146;权限门在 GET /api/team/meta(org.py:62, _require_admin),前端以请求成败表达e2e 普通员工账号访问 /team 断言只出拒绝卡生效
AC-EL-TEAM-003错误横幅反馈error 条 role="alert";各写操作失败时填入后端 message 原文team/page.tsx:152e2e 重复邮箱建员工断言 409 文案上横幅生效
AC-EL-TEAM-004成功横幅反馈ok-banner 条 role="status";建/改/删员工、品牌增删恢复各写各自回执(见对应条目)team/page.tsx:153e2e 各操作后断言回执文案生效
AC-EL-TEAM-005员工账号卡·标题容器「员工账号」副标「席位 {used}/{limit} · 权限实时生效:改动后该员工全部会话立即吊销」team/page.tsx:157-158;seats 来自 GET /api/team/meta(org.py:62):used=count(users.status=active),limit=PLAN_SEATS[plan](未配计划默认 5)e2e 断言 used/limit 与库内 active 用户数一致;改员工权限后其会话立即 401生效
AC-EL-TEAM-006+ 添加员工按钮操作打开新增抽屉,品牌授权预勾选全部在营品牌(modules 空)team/page.tsx:53 openNew brands: meta?.brands ?? [],161e2e 点开断言抽屉品牌 chips 全 on生效
AC-EL-TEAM-007员工表·加载态空态members 未返回时灰字「加载中…」team/page.tsx:163e2e 弱网断言先显加载态生效
AC-EL-TEAM-008员工表·表头表格9 列:姓名/邮箱/职能/角色/模块/品牌/状态/最后登录/操作team/page.tsx:167;数据源 GET /api/team/users(org.py:75):owner 排最前(ORDER BY role='owner' DESC, id),modules=已授权模块数组、brands=授权品牌数组e2e 断言 9 个 th 与 owner 首行生效
AC-EL-TEAM-009员工表·姓名列列strong 样式,空值显「—」team/page.tsx:171 m.name || "—"e2e 无名员工断言「—」生效
AC-EL-TEAM-010员工表·邮箱列列登录邮箱,muted 样式team/page.tsx:172e2e 断言与库内一致生效
AC-EL-TEAM-011员工表·职能列列job_label 展示,空值显「—」team/page.tsx:173e2e 断言与抽屉保存值一致生效
AC-EL-TEAM-012员工表·角色列列badge dim 展示 role(owner/admin/member)team/page.tsx:174e2e 断言 badge 文本生效
AC-EL-TEAM-013员工表·模块列列owner/admin 显「全部」;其余显授权模块名(key→meta.modules[k].name,查不到回退 key)「、」连接,空显「(未授权)」;列宽上限 220team/page.tsx:175-178e2e 三种角色/空授权断言三种呈现生效
AC-EL-TEAM-014员工表·品牌列列owner/admin 显「全部」;其余显授权品牌「、」连接,空显「(无)」team/page.tsx:179e2e 同上三态生效
AC-EL-TEAM-015员工表·状态列列badge:active=「在职」(ok)/其他=「停用」(bad)team/page.tsx:180e2e 停用员工断言 badge 翻转生效
AC-EL-TEAM-016员工表·最后登录列列last_login_at 截「yyyy-MM-dd HH:mm」(slice(0,16) T→空格),从未登录显「从未」team/page.tsx:181e2e 新建未登录员工断言「从未」生效
AC-EL-TEAM-017员工表·操作列·编辑操作打开编辑抽屉(回填 email/name/job_label/modules/brands,密码置空),见 TEAM-035…044team/page.tsx:54-58, 184e2e 点编辑断言抽屉回填值生效
AC-EL-TEAM-018员工表·操作列·停用/启用操作按钮文案随状态翻转(在职→「停用」/停用→「启用」);停用需 danger 确认「停用 {email}?/其会话立即吊销。」;PUT /api/team/users/{id} {status}team/page.tsx:91-96, 185;后端 org.py:125;启用无需确认直接发e2e 停用后该员工请求 401;重新启用可登录生效
AC-EL-TEAM-019员工表·操作列·删除操作danger 确认「删除员工 {email}?/其所有会话立即作废。」确认后 DELETE /api/team/users/{id}(org.py:179),回执「已删除 {email}」team/page.tsx:84-89, 186e2e 删测试员工断言行消失+审计落账生效
AC-EL-TEAM-020员工表·owner 行保护边界role=owner 的行不渲染任何操作按钮(编辑/停用启用/删除全无)——owner 不可被他人改动team/page.tsx:183 m.role !== "owner" && <>…</>e2e 断言 owner 行操作列为空生效
AC-EL-TEAM-021品牌管理卡·标题容器「品牌管理」副标「运营公司可挂多个品牌,数据按品牌隔离(RLS)」team/page.tsx:198;数据源 GET /api/tenant/brands(auth.py:407):行=tenant_brands 全量(含停用),排序 is_active DESC, brande2e 断言标题;品牌清单与库一致生效
AC-EL-TEAM-022品牌名输入框输入placeholder「品牌名(小写字母/数字/连字符, 2-40 位)」;提交前 trim+toLowerCase 归一team/page.tsx:99-101;后端 auth.py:420 同规则强制 ^[a-z0-9-]{2,40}$ fullmatch,违例 400;重复 409「品牌已存在」e2e 大写输入断言被归一保存;非法字符断言 400 上横幅生效
AC-EL-TEAM-023+ 添加品牌按钮操作POST /api/tenant/brands(auth.py:420) {brand};成功清空输入、回执「品牌 {brand} 已添加」并整页刷新;审计 tenant.brand.addteam/page.tsx:98-103e2e 添加测试品牌断言三卡(员工抽屉品牌 chips/品牌表)同步出现生效
AC-EL-TEAM-024品牌表·表头表格4 列:品牌/商品数/数据截至/操作team/page.tsx:206e2e 断言 4 个 th生效
AC-EL-TEAM-025品牌表·品牌列列品牌名 strong;停用品牌追加 badge dim「已停用」且整行 opacity 0.5team/page.tsx:209-210 is_active === falsee2e 停用后断言 badge+变淡生效
AC-EL-TEAM-026品牌表·商品数列列该品牌 products 行数计数后端 auth.py:411 子查询 (SELECT count(*) FROM products WHERE brand=…)e2e 与库内 count 对账生效
AC-EL-TEAM-027品牌表·数据截至列列该品牌最新销售日,空显「—」后端 auth.py:412 max(day) FROM sales_daily WHERE brand=…(销售最大日,非今日)e2e 与库内 max(day) 对账生效
AC-EL-TEAM-028品牌表·停用按钮操作仅当企业品牌总行数(含停用)>1 时渲染(brands.length>1,page.tsx:214;「至少一个在营」校验仅 permanent 注销分支有——1 在营+1 停用时在营品牌仍可停用);确认框非 danger「停用品牌 {b}?/品牌将从所有页面隐藏,数据保留在数据库中,可随时恢复。」;DELETE /api/tenant/brands/{b}?mode=archive(auth.py:435)team/page.tsx:214-216;后端 archive=is_active=false+审计 tenant.brand.archive;②C(2026-09-26):全部品牌停用→自动暂停该企业调度(pause_tenant_jobs)并广播 ShopConfigUpdated——级联自动生成/停摆,不需人工接线e2e 停用品牌断言各页隐藏、可恢复;仅剩 1 行品牌(任意状态)断言无停用按钮生效
AC-EL-TEAM-029品牌表·恢复按钮操作仅停用品牌渲染(ok 色);PUT /api/tenant/brands/{b}/activate(auth.py:523),回执「品牌 {b} 已恢复」无需确认框team/page.tsx:217-219e2e 停用→恢复断言行态复原且各页数据回归生效
AC-EL-TEAM-030品牌表·彻底删除按钮操作仅停用品牌渲染(danger 色);UI-07(2026-10-14) 接线两步走定稿(2026-09-22)第二步——先停用才可彻底删除;danger 确认「彻底删除品牌 {b}?/将永久删除该品牌的所有商品、订单、库存数据,不可恢复!」;DELETE ?mode=permanentteam/page.tsx:113-117, 220-222;后端 ⑬(2026-10-01) 三段式引用计数级联重写:企业间绝对隔离、跨企业操作绝对禁止(业务表无 tenant_id 列,旧按 brand 全局 DELETE 曾险些波及他企业同名品牌)——铁律:企业/品牌绝对独立、不可误删;级联按依赖顺序清全部业务数据e2e(仅测试企业)彻底删除测试品牌:断言其商品/订单/库存清零且他企业同名品牌毫发无损;审计 tenant.brand.* 留痕生效
AC-EL-TEAM-031注销企业卡·标题容器「注销企业(危险区)」副标「注销整个企业 · 与单个品牌的停用无关」;卡片红边框 borderColor=var(--danger) 独立于其余卡team/page.tsx:232-233e2e 断言标题与红边样式生效
AC-EL-TEAM-032注销企业卡·流程说明文说明「注销流程:先完整归档本企业全部数据 → 子域停用、全员会话吊销 → 进入 30 天冷静期。冷静期内业主可随时在恢复页一键撤回(数据原样回归);届满后系统自动物理清除,不可恢复。注销/恢复/清除全程写入审计日志,永久留存。」team/page.tsx:234-238;#62(2026-10-10) 注销流程入口注释:成功后全员会话已被吊销,直接落在 /offboarding 自助恢复页e2e 断言说明文全文(恢复页本体见 /offboarding 页条目)生效
AC-EL-TEAM-033注销企业卡·slug 确认输入输入placeholder「输入 {meta.slug} 以确认」——回显本企业 slug 作双重确认team/page.tsx:240-241;slug 由 GET /api/team/meta 下发(org.py:62,#62);后端 org.py:258 再校验 confirm===slug 否则 400e2e 输错 slug 断言按钮仍 disabled/后端 400生效
AC-EL-TEAM-034注销企业卡·发起注销按钮操作danger 色;disabled = 确认框空 || busyOff || 无 slug;busy 文案「归档中…」;danger 确认「确认注销企业 {slug}?/全部数据先归档,随后子域停用、全员会话吊销并登出。30 天冷静期内可随时自助恢复;届满后数据永久清除。」确认后 POST /api/org/tenant/offboard(org.py:252) {confirm} → 跳 /offboarding?due={purge_due}&just=1team/page.tsx:119-135, 242-245;后端:confirm≠slug 400;已在冷静期 409;状态非 active 409;_archive_tenant 先行(归档是清除的前置铁条件,任一步失败 status 不动)→ status=offboarding → 吊销全员会话;审计 tenant.offboard 含归档文件名/行数/冷静期天数e2e(仅测试企业)发起注销断言跳恢复页、全员 401、审计留痕;重复发起断言 409生效
AC-EL-TEAM-035员工抽屉·标题容器新增态「添加员工」/编辑态「编辑 · {email}」;drawer-mask 点遮罩关抽屉,drawer 内 stopPropagation 防误关team/page.tsx:250-253e2e 点遮罩空白处断言抽屉关闭、点内容区不关生效
AC-EL-TEAM-036抽屉·邮箱输入输入新增态可输入(登录账号);编辑态 disabled(邮箱不可改)team/page.tsx:255-256 disabled={edit !== "new"}e2e 编辑态断言不可交互生效
AC-EL-TEAM-037抽屉·姓名输入输入自由文本,可空(列表显「—」)team/page.tsx:257e2e 留空保存断言列表「—」生效
AC-EL-TEAM-038抽屉·职能输入输入自由文本 job_label;点职能预设 chip 会覆盖此值(TEAM-040)team/page.tsx:258e2e 手填+预设各试一次断言联动生效
AC-EL-TEAM-039抽屉·密码输入输入label 随态:新增「初始密码(≥8 位)」/编辑「重置密码(留空不改)」;type=passwordteam/page.tsx:259-260;新增前端先拦 <8 位(page.tsx:68),后端 org.py:93 同判 400;编辑态仅填了才随 PATCH 带 passworde2e 新增 7 位密码断言双端拦截;编辑留空保存断言密码未变生效
AC-EL-TEAM-040抽屉·职能预设 chips输入分区标题「职能预设(一键勾选模块,可逐项微调)」;每个预设 chip 点击=setForm(job_label=预设名, modules=meta.presets[预设]),选中 chip 高亮 on(判据 job_label===预设名)team/page.tsx:59-61, 262-267;presets=ROLE_PRESETS 由 meta 下发e2e 点预设断言模块 chips 自动勾成预设集合再手工微调一项保存成功生效
AC-EL-TEAM-041抽屉·模块授权 chips输入分区标题「模块授权」;每个模块 chip 点击 toggle 进/出 form.modules,选中 onteam/page.tsx:268-274;模块清单=meta.modules(key→{name,pages}),chip 显 namee2e 勾/退各一次保存后断言列表模块列与库内授权一致生效
AC-EL-TEAM-042抽屉·品牌授权 chips输入分区标题「品牌授权(不选 = 该员工看不到任何品牌数据)」;chip=各在营品牌 toggleteam/page.tsx:275-281;铁律边界:品牌数据按品牌授权隔离,不选任何品牌=零品牌可见(白名单式拒绝默认)e2e 全不选保存后以该员工登录断言各数据页空/无品牌生效
AC-EL-TEAM-043抽屉·取消/保存按钮操作取消=关抽屉不改;保存 busy 文案「保存中…」disabled;新增 POST /api/team/users(org.py:93) 全量表单→回执「已创建员工 {email}」;编辑 PUT /api/team/users/{id}(org.py:125) 仅 patch name/job_label/modules/brands(+password 若填)→回执「已更新 {email}(其已登录会话已被吊销,需重新登录)」;成功后关抽屉+整页刷新team/page.tsx:64-82, 282-285;编辑必吊销该员工全部会话=权限实时生效(TEAM-005 副标承诺)e2e 双端各存一遍;编辑后断言该员工旧会话 401、新权限生效生效
AC-EL-TEAM-044抽屉·遮罩与层级布局drawer-mask 全屏遮罩居中抽屉;点击遮罩=setEdit(null)(未保存内容丢弃不提示)team/page.tsx:251-252e2e 填一半点遮罩断言直接关闭无确认生效

§11.19 AI 助手(/ai · AC-EL-AI,源码 web/app/ai/page.tsx 110 行 + api/routers/ai.py 后端)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-AI-001页面框架·标题与面包屑布局AppShell title=「AI 助手」,crumb=「四大 AI 能力 · 数据经 RLS 隔离 · 全量审计」ai/page.tsx:58;组件本体见 AC-EL-CMP(AppShell)e2e 断言标题与 crumb生效
AC-EL-AI-002Tab 组(4 个)导航数据问答/选品建议/广告文案/广告优化;默认 insight;切 tab 即清空 answer 与 err(不保留旧答案)ai/page.tsx:6-13 TABS, 63-65 setTab(k); setAnswer(""); setErr("")e2e 生成答案后切 tab 断言输出区清空生效
AC-EL-AI-003Tab·数据问答(insight)能力desc=「用自然语言问经营数据,AI 只依据本企业真实数据回答。」ai/page.tsx:9;后端 POST /api/ai/insight(ai.py:323, require_module("ai")),审计 ai.insight(截 question 前 100 字)e2e 断言 tab 文案;问一句断言审计行生效
AC-EL-AI-004Tab·选品建议(sourcing)能力desc=「基于毛利率 / 营收趋势 / 广告效率 / 库存可售天数,给出加码、止损与补货建议。」ai/page.tsx:10;后端 POST /api/ai/sourcing(ai.py:432):F3-6(2026-09-26) 权限拆分——sourcing 或 ai 任一模块即放行;未开通 ai 的企业走降级路径(审计 ai.sourcing.degraded)e2e 仅 sourcing 模块企业断言可用;未开通 ai 走降级不 403生效
AC-EL-AI-005Tab·广告文案(adcopy)能力desc=「输入 SKU,生成 3 组英文广告标题 + 五点卖点。」ai/page.tsx:11;后端 POST /api/ai/adcopy(ai.py:350, require_module("ai")),审计 ai.adcopye2e 传入有效 SKU 断言回答含 3 组标题结构生效
AC-EL-AI-006Tab·广告优化(ads)能力desc=「逐广告活动分析 ACOS,给出加预算 / 降竞价 / 否定词 / 暂停建议。」ai/page.tsx:12;前端 path 映射 ads→POST /api/ai/ads-optimize(ai.py:804, require_module("ai")),审计 ai.ads-optimizee2e 断言请求落在 ads-optimize 端点生效
AC-EL-AI-007insight·问题输入框输入textarea rows=3;默认问题「最近哪个 SKU 营收下滑最严重?跌了多少?」;placeholder「如:上个月哪个 SKU 毛利跌了?为什么这个 SKU 的广告没有花费?」ai/page.tsx:31, 70-71e2e 断言默认值与 placeholder生效
AC-EL-AI-008insight·快捷问题按钮组输入6 个 ghost 小按钮,点击将问题填入 textarea(不自动触发生成):最近哪个 SKU 营收下滑最严重?/最新月各品牌赚了还是亏了?/库存有哪些断货风险?/回款有没有异常订单?/各品牌近 30 天营收对比如何?/哪些 SKU 有广告花费但没有转化?ai/page.tsx:73-77 onClick={() => setQuestion(q)}e2e 点任一按钮断言 textarea 同步生效
AC-EL-AI-009adcopy·SKU 输入输入placeholder「SKU(见商品页)」,随 body.sku 提交ai/page.tsx:83e2e 断言占位文本生效
AC-EL-AI-010adcopy·侧重点输入输入placeholder「侧重点(可选),如:户外场景」,空则不约束生成角度ai/page.tsx:84e2e 断言占位文本生效
AC-EL-AI-011sourcing/ads·说明段落说明两 tab 无输入控件,仅 muted 小字展示 active.desc(即 TEAM 对应 desc 文案)ai/page.tsx:87-89e2e 切两 tab 断言无输入框且段落文案正确生效
AC-EL-AI-012生成按钮操作文案 busy=「分析中…(大模型思考约 10–30 秒)」/常态「生成」;busy 期间 disabled;点击时先清空旧答案/元信息/错误再发请求ai/page.tsx:39-40, 91-93;请求体:insight={question}、adcopy={sku,angle}、sourcing/ads=无 body;端点 ads-optimize 其余=tab 名(page.tsx:42-44)e2e 断言 busy 文案与 disabled;抓包断言四 tab 各落对端点生效
AC-EL-AI-013错误提示条反馈error 样式 role="alert";后端 detail 为字符串时原样透传,否则「调用失败」ai/page.tsx:22-24, 48-49, 95e2e 未授权模块账号生成断言 detail 上屏生效
AC-EL-AI-014回答元信息行反馈回答区上方灰字「{model} · tokens: {input_tokens} → {output_tokens}」,usage 缺失字段显「-」ai/page.tsx:46-47, 98;响应契约 {answer, model, usage?{input_tokens,output_tokens}}e2e 生成成功断言元信息行含模型名与两个 token 数生效
AC-EL-AI-015回答输出区反馈ai-out 样式块渲染 answer 全文(Markdown 由样式类承接,页面不做二次加工)ai/page.tsx:99e2e 断言回答文本出现于 .ai-out生效
AC-EL-AI-016页脚口径说明说明「AI 数据上下文取自本企业(RLS 行级安全强制隔离);业务口径与财务模块一致:利润模型、ACOS/TACOS/ROAS 健康线、人民币成本 ×0.1471 折算。」ai/page.tsx:104-106;口径一致性承诺对齐 §11.6 FIN 同源定义(AC-CAL 系列);RLS=企业行级隔离(铁律:企业/品牌绝对独立)e2e 断言脚注全文;跨企业数据不得出现在回答中(抽问企业专属 SKU 验证)生效
AC-EL-AI-017组件挂载关系·边界边界本页未挂载 AIChat/AIContext 组件(页面自含问答 UI,仅引 AppShell);AIChat/AIContext 的逐元素条目归 §11.26 共享组件库ai/page.tsx:1-5 import 清单实证;组件本体见 AC-EL-CMP静态检查 import 断言无 AIChat/AIContext 引用生效

§11.20 管道任务(/pipeline · AC-EL-PIPE,源码 web/app/pipeline/page.tsx 334 行 + api/routers/collab.py 207-352 + api/metrics.py 160-276 + web/lib/fmt.ts)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-PIPE-001页框架·AppShell框架title=管道任务;crumb=「采集任务注册表 · 数据新鲜度巡检 · 外部生产工具」current_user 门禁(任意登录用户可看状态;执行按钮另有 admin 门——AC-EL-PIPE-047)e2e 路由可达 + crumb 逐字生效
AC-EL-PIPE-002错误横幅反馈err 非空时 div.error role=alert仅 /api/pipeline/status 失败写 err;/api/pipeline/audit 失败静默 catch(审计面缺席不阻断)断 status 端点横幅出现生效
AC-EL-PIPE-003KPI 卡·定时任务KPIjobs.length,未就绪「—」;foot「worker 定时调度 · UTC」jobs=PIPELINE_JOBS 代码常量(29 条,AC-EL-PIPE-022);调度时刻全部 UTC 口径卡值=29 vs 注册表生效
AC-EL-PIPE-004KPI 卡·数据表在管KPItables.length,未就绪「—」;foot「RLS 企业可见范围行数」tables=后端 22 表 UNION ALL 常量行(AC-EL-PIPE-025);行数在 RLS 企业可见范围内统计卡值=22 vs 巡检表行数生效
AC-EL-PIPE-005KPI 卡·Keepa 关注池KPIint(keepa_watch);foot「每日 05:10 UTC 快照补拉」keepa_watch=keepa_watch 表 count(*);KEEPA_REFRESH_UTC 常量(web/lib/fmt.ts)=「05:10 UTC」,与 refresh_keepa_watch 任务 05:10 一致卡值 vs count(*);foot 文案逐字生效
AC-EL-PIPE-006KPI 卡·状态页日期KPIas_of(fontSize 19 文本卡);foot「任务定义代码化」as_of=后端 date.today()(响应生成日);「代码化」=任务清单非 DB 存档而是 collab.py 常量卡值=当日 ISO 日期生效
AC-EL-PIPE-007五层审计卡标题标题h2「🧭 五层审计」+ sub「rawdata → cleandata → regression → api → web · 每日 06:35 全代码自动跑(零 LLM)· 部署时另有六道门」(R4b P3-8 由四层改五层并补 regression)06:35=host-crontab.txt「35 6 * * * tools/five_layer_audit.py」(实证);零 LLM=全代码判定;六道门=deploy_gate(含 pipe_audit/chart_value 两门)crontab 行逐字;sub 文案逐字生效
AC-EL-PIPE-008审计空态空态audit 未就绪或 batch=null → 「暂无审计批次(每日 06:35 自动生成,或 python3 tools/five_layer_audit.py 手动触发)」audit_results 表无批次时整卡只出此行空库企业显示该行生效
AC-EL-PIPE-009层卡片·五层定义卡片L1 源头采集 / L2 清洗层 / L3 回归层 / L4 端点层 / L5 前端层 五卡(LAYER_META;R4b P3-8 补 regression 卡并重编号,原 L3/L4→L4/L5)L1「源表新鲜度 · 财务独立源交叉 · Pending 回刷」;L2「断流扫描 · 订单vs小时两表一致 · 清洗标记」;L3「KPI 口径回归 · 停用品牌隔离 · 广告双计/粒度守卫 · 探活与透传」(=five_layer_audit regression 层检查键全集:KPI orders 口径/停用品牌/Noon rolling/广告双计/粒度守卫/视图裸::date/API 探活/错误透传);L4「KPI 对账 · hourly24 基准日 · 全量 81 图在部署门」;L5「核心页登录态探活 · SSR 载荷」五卡名称/描述逐字 vs LAYER_META生效
AC-EL-PIPE-010层卡片·状态灯指示层名左 10px 圆点颜色fail>0 → var(--danger,#dc2626);否则 warn>0 → var(--warn,#b54708);否则 var(--ok,#0e9384)造 FAIL 批次圆点变红生效
AC-EL-PIPE-011层计数行数值「FAIL n · WARN n · PASS n」(FAIL 红粗/WARN 黄)FAIL/WARN 段条件渲染(=0 不显示);PASS 恒显计数 vs audit 端点聚合生效
AC-EL-PIPE-012层展开明细交互点击层卡片 toggle(openLayer 单开互斥)非 PASS 项全列(FAIL 红/WARN 黄粗 + key + detail);PASS 项仅前 3 条(75% 透明度);pass>3 → 「…其余 {pass-3} 项 PASS(明细见 audit_results 表)」展开后明细 vs audit_results 直查生效
AC-EL-PIPE-013审计脚注说明「最近批次 {batch} · 检查于 {checked_at} · 点击层卡片展开明细 · 结果只追加存 audit_results 表」+ 趋势 + 外链趋势(trend.length>1 才显):「近 7 天 {N} 批次,累计 FAIL {Σfails}」(8 天窗口);外链「📘 注册表架构文档」=changelog.zipforcehub.com/audit/registry-architecture-2026-09-24.md(八张注册表/接入流程/挂账与阈值运维速查)脚注批次号 vs audit_results 最新 batch_id生效
AC-EL-PIPE-014注册表卡标题标题h2「定时任务注册表」+ sub「worker 容器内定时调度 · {N} 个任务」N=jobs.length=29sub 计数 vs 注册表生效
AC-EL-PIPE-015任务分组分组按 group 聚合渲染,组名下边框 2px 品牌色9 组:数据采集 3 / Amazon 采集 9 / Noon 采集 3 / Keepa/排名 2 / 汇率 1 / 源库同步 3 / 监控报警 3 / 广告规则 3 / 系统 2(含 1 手动);组序=首次出现序组数/各组任务数 vs PIPELINE_JOBS生效
AC-EL-PIPE-016任务表表格4 列:任务 / 调度(UTC) / 说明 / 操作每组一张表(tbl-wrap);行 key=name列头逐字生效
AC-EL-PIPE-017任务行·名称与说明列名称 strong;说明 muted(whiteSpace normal 可换行)名称/说明=PIPELINE_JOBS name/desc 字面(含口径注记如「零 LLM」「剔取消」等)行值 vs 常量逐字生效
AC-EL-PIPE-018任务行·调度列列badge ok 显示 cron_utc人类可读 UTC 时刻串(04:30 / 周日 02:00 / 每 15 分钟 / 每 2h :43 / 手动 等),非标准 cron 表达式;与 worker 实际调度一致为准badge 值 vs 常量;抽样 vs worker 日志时刻生效
AC-EL-PIPE-019▶ 执行按钮操作btn inline sm「▶ 执行」,running 时「⏳」+disabled点击 postJson /api/pipeline/run/{func};成功 toast ok「{name} 已入队 ({job_id 前 8}…)」;失败 toast err(端点报错原文);仅入队不等待完成e2e 点击后 toast + audit_log 出现 pipeline.run生效
AC-EL-PIPE-020手动任务行列func="" 的任务无执行按钮现仅「ABA 情报快照」(cron_utc=「手动」;desc 注明日更待专用受限 key)——按钮渲染条件 j.func 非空该行无按钮、调度显「手动」生效
AC-EL-PIPE-021任务执行载体架构执行发生在 worker 容器,页面按钮仅经 ARQ 入队采集引擎代码位于 /opt/collection(worker 容器内挂载只读 :ro,事实源);run.py 透传 argv;ads_attr_core 按 31 天分片;错误在 stdoutdocker inspect worker 挂载含 /opt/collection:ro生效
AC-EL-PIPE-022任务注册表数据源口径PIPELINE_JOBS 代码常量(collab.py 207-237,29 条 9 组)非 DB 注册——改任务=改代码发版(「任务定义代码化」);run 端点白名单也取此常量集(AC-EL-PIPE-047)常量行数 vs KPI 卡值生效
AC-EL-PIPE-023新鲜度巡检卡标题标题h2「数据新鲜度巡检」+ sub「各表行数与数据截至日(当前企业可见范围)」企业可见范围=RLS 口径声明文案逐字生效
AC-EL-PIPE-024巡检表表格4 列:数据表(strong)/行数(r num int)/数据截至(sku,null→「—」)/新鲜度(badge)行=tables 顺序(后端 UNION ALL 定序)列头与行序 vs 端点生效
AC-EL-PIPE-025巡检表·22 表清单口径后端 UNION ALL 固定 22 行商品/日销量/小时销量/广告日耗/广告SKU×日/广告活动/月度财务/订单明细/月度回款/月度退货/Noon产品月度/SKU映射/库存健康/BSR排名/物流船票/Keepa快照/推广渠道/ABA情报/供应商/PO单/Noon投放日表/Amazon投放日表;行数=count(*),数据截至=各表时间列 max(广告活动/SKU映射/供应商为 NULL)端点 tables 长度=22 且名称逐字生效
AC-EL-PIPE-026新鲜度·快照口径判定last=null → badge dim「快照」适用:广告活动 / SKU映射 / 供应商(后端显式 NULL)——不做天数判定三表行 badge=快照生效
AC-EL-PIPE-027新鲜度·月度表判定last 为 YYYY-MM(长 7):本月/上月 ok,更早 warn「滞后」适用:月度财务/月度回款/月度退货/Noon产品月度/ABA情报(max(mon)/max(period));与浏览器本地时区当前月比较(new Date()/getMonth(),pipeline/page.tsx:33-35——非 UTC,北京用户月末/月初边界会差一天口径)月度行 badge 口径抽测生效
AC-EL-PIPE-028新鲜度·日表阈值判定FRESH_OK_DAYS 表别阈值,age=now-last(UTC 日)日销量 3/小时销量 3/广告日耗 3/广告SKU×日 3/订单明细 4/库存健康 3/Keepa快照 3/BSR排名 4/物流船票 90/推广渠道 90,未列默认 30;age≤days → ok「n 天前」;≤3×days → warn;再超 → bad阈值表 vs 常量逐项生效
AC-EL-PIPE-029巡检脚注说明「月度表(财务/回款/退货/Noon)按月粒度判定;快照口径表(SKU 映射/广告活动/物流)不做新鲜度判定。表行数随 04:30 UTC 日更自动变化。」⚠ 文案-代码不一致:脚注称「物流」不做判定,但 FRESH_OK_DAYS 实含「物流船票: 90」(代码做判定仅阈值宽,90 天 ok/270 天 bad)——判定归属需拍板:改脚注或删物流阈值。

2026-10-22 换绿:拍板落地(2026-10-22 用户令"除了外部事件 都修",选改脚注对齐代码真值、行为不动):pipeline/page.tsx:212 改为「…快照口径表(SKU 映射/广告活动)无数据截至日、不做新鲜度判定;物流船票/推广渠道为低频表,按 90 天宽阈值判定(≤90 天前正常、≤270 天前预警、更久异常)」;API 侧实证=collab.py:246 表清单(广告活动/SKU映射 last=NULL→前端显「快照」确不判定;物流船票 max(ship_date) 日粒度走 FRESH_OK_DAYS 90 阈值);探针 PASS(新文案在场/旧文案清零)+frontend_e2e ALL PASS
物流船票行 badge 实际渲染 vs 脚注声明生效
AC-EL-PIPE-030骤降巡检块标题标题「⚠ 数量骤降巡检」红字 + 说明行说明「对比日 vs 前 7 日日均(广告按站点日 T+1 取 D-2),双门槛:降幅 ≥50% 且超绝对差下限」文案逐字生效
AC-EL-PIPE-031骤降表表格5 列:品牌/指标(· 表名小字)/7日日均/对比日/降幅降幅列红粗「-{drop_pct}%」;行 key=brand-table-metric行值 vs drops 端点生效
AC-EL-PIPE-032骤降空态空态「数量骤降巡检:近窗口无超阈值项。」drops 空数组时渲染正常日显示该行生效
AC-EL-PIPE-033骤降后端口径口径volume_drop_rows(metrics.py)品牌面=brands_source enabled+platform=amazon+source_map 非空;4 检查项:订单数(amazon_orders,lag1)/销量单(sales_hourly,lag1)/日销量件(sales_daily,lag1)/广告行数(ads_sku_daily,lag2);对比日=北京时区日-lag;双门槛 drop/base≥0.50 且 drop≥floor=max(2, min(mindiff, 30%×base))(2026-09-29 门槛自适应——固定绝对差≥10 漏小体量品牌整段断流,onno 订单基线日均~6 单实证);base≤0 无基线跳过(新管道免误报);onno 广告走 amazon_ads_daily 专表(pipe_domains.brand_override,查表失败同值兜底)SQL 复算 vs 页面行生效
AC-EL-PIPE-034排名巡检块标题标题「⚠ 排名分市场巡检」红字 + 说明行说明「各市场最新快照在榜数 vs 前 7 日日均(塌缩 ≤30%);停更按各市场自身节律判定,不被品牌级最新快照掩盖」文案逐字生效
AC-EL-PIPE-035排名表表格6 列:品牌/市场/最新快照/在榜(strong)/7日日均(muted)/异常(红 reason)noon 平台市场名前缀「Noon 」(如 Noon AE);lag>0 时最新快照后缀 warn 色「(停{lag}天)」;行 key=brand-platform-market行值 vs rank_markets 端点生效
AC-EL-PIPE-036排名空态空态「排名分市场巡检:各市场在榜数与快照节律正常。」rank_markets 空数组时渲染正常日显示该行生效
AC-EL-PIPE-037排名口径·塌缩口径在榜数塌缩判定n_now≤30%×avg7 且 avg7-n_now≥2 → reason 追加「在榜 {n_now} ← 7日均 {avg7}」;avg7=0 新市场跳过(BR/MX 首日入列属清单变更走需求单)SQL 复算(cleaned_rankings_daily)生效
AC-EL-PIPE-038排名口径·停更口径分市场停更判定lag>tol → 「快照停更{lag}天(同平台最新 {gmd}, 节律容忍{tol})」;tol=ceil(7/近7天快照天数)-1:日采市场(days7=7→tol=0)停 1 天即报,隔日采(zf noon days7=4→tol=1)不误报;2026-09-29 盲区修复——原品牌级 max(snap_date) 水位被最大市场掩盖(onno EU 停 10 天不报实证);KEEPA_SOURCE_DEAD 市场 reason 前缀「源断供(keepa 站点无数据, 非采集缺口): 」(metrics.py:270-273,2026-10-21 加入)——排名表异常列区分上游断供与采集缺口SQL 复算 tol/lag生效
AC-EL-PIPE-039排名口径·市场白名单口径amazon 域=RANKING_MARKETS 白名单2026-10-16 对齐 #49/#60,与采集器/_family_groups/排名页市场芯片同口径;白名单外(SE/BE/IE/PL/AE/SA/EU、UK→GB 归一、空 country)历史行保留但采集器永不更新不进巡检;白名单内 keepa 全空市场(zf CA/AU 代表 ASIN 疑下架)仍报——真实在榜变化属巡检职责;noon 平台不限白名单白名单常量 vs 巡检行市场集生效
AC-EL-PIPE-040外部生产工具卡标题标题h2「外部生产工具」+ sub「独立系统 · 各自账号体系」边界声明:与本平台账号不相通文案逐字生效
AC-EL-PIPE-041外部工具行列表行整行 a 外链(target _blank),左名称+↗+描述,右裸域名2 项(PIPELINE_EXTERNAL 常量):AI Listing 工厂(factory.zipforcetek.com,项目/SKU→标题/五点/A+/图片/视频 AI 生成与版本管理,需工厂账号)/ 工厂管道状态(factory.zipforcetek.com/pipeline,公开只读)行数/名称/域名 vs 常量生效
AC-EL-PIPE-042外部工具脚注说明「Listing 文案生成已内置于本平台(智能 → AI 助手 → 广告文案);工厂为独立生产工具(图片/视频/A+ 模块化生成),后续按企业需求评估是否产品化并入。」内置/外置边界声明文案逐字生效
AC-EL-PIPE-043词汇速查卡卡片GlossaryCard 子组件:「📖 电商词汇速查」+ sub「{domains.length} 域 × {total} 词条 · 同源数据字典 · 完整版在 /dictionary」(域数/词条数均端点动态下发;R4b P3-7 前写死「12 域」与源漂移——实 18 域,已改派生)2026-09-24 用户令「加到 /pipeline」;fetch /api/glossary(credentials include);失败静默 catchsub 计数 vs glossary 端点 total生效
AC-EL-PIPE-044词汇速查搜索与结果筛选input「搜词条 / 英文 / 缩写(如 ACOS、IPI、FBN)」maxWidth 380term/en/abbr/desc/sys 五字段 lowercase includes;命中 slice(0,12) 上限 12 条;q 空不渲染结果区;结果表 5 列(词条 120/英文全称 180/缩写 90/释义/系统落点 200,minWidth 480);空命中「无匹配词条」过滤命中与 12 条上限抽测生效
AC-EL-PIPE-045后端·status 端点APIGET /api/pipeline/statuscurrent_user 门禁;22 表 UNION ALL(count+max 时间列)+ keepa_watch count(*) + drops(volume_drop_rows)+ rank_markets(rankings_market_rows)+ external(PIPELINE_EXTERNAL)+ as_of=date.today();metrics 两函数在企业连接上下文内执行(RLS 生效)端点 JSON vs 各源表直查生效
AC-EL-PIPE-046后端·audit 端点APIGET /api/pipeline/auditaudit_results 最新 batch_id(无批次→batch=null 触发前端空态);4 层固定序聚合 pass/fail/warn;趋势=8 天窗口按 batch GROUP BY(batch/日/fails/total);ISO-01(2026-10-14) 遮蔽:detail 含他企业品牌名→「(含他企业信息, 已遮蔽)」,check_key 内品牌名就地打码 ■(计数保留——平台健康面不因遮蔽失真)端点 vs audit_results 直查(含打码抽测)生效
AC-EL-PIPE-047后端·run 端点APIPOST /api/pipeline/run/{func_name}_require_admin 门禁(非管理员 403);func 必须在 PIPELINE_JOBS 注册集否则 404「未知任务 {func}」;经 ARQ Redis enqueue(SAAS_REDIS_URL,redis://redis:6379/0 兜底)异步执行不阻塞请求;audit 日志记 pipeline.run + job_id非 admin 403;未知 func 404;成功后 audit_log 有行生效
AC-EL-PIPE-048页面数据时序交互挂载即并行拉 status+audit 两端点(一次 useEffect)status 失败→错误横幅(AC-EL-PIPE-002);audit 失败→静默;无轮询/自动刷新——刷新页面才更新网络面板两请求各一次生效

§11.21 品牌主看板(/dashboard/[brand] · AC-EL-BRD-001…,源码 web/app/dashboard/[brand]/page.tsx 39 行 + components/BrandBoard.tsx 323 行 · API GET /api/dashboard/charts + /api/brandboard/orders + /api/brandboard/country-sku,routers/brandboard.py)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-BRD-001路由页壳页壳动态路由 /dashboard/[brand],URL 段即 brandKey;AppShell title={brandLabel(brandKey)} Amazon 主看板,crumb=对齐 UVPVP 8 区块 · 数据源 /api/dashboard/charts + /api/brandboardtitle 展示名=fmt.brandLabel(brands_source.source_map.label 注入,H9 2026-10-13);title/crumb 为页面固定文案e2e 访问 /dashboard/zipforce 断言标题与面包屑生效
AC-EL-BRD-002未知品牌守卫卡守卫brandKey 不在本企业品牌列表时整页换居中卡:未知品牌 {brandKey} + muted 品牌不存在或无权访问 · 从工作台进入(Link → /)合法性=useBrand().brands(本企业注册品牌)——铁律①企业/品牌绝对独立;P3 缺陷⑱(2026-10 修):原文案列全品牌名单泄露他企业品牌名,改后不列名单e2e 访问 /dashboard/他企业品牌名 断言守卫卡且页面无品牌名单生效
AC-EL-BRD-003主体挂载组件挂载通过守卫后渲染 <BrandBoard brandKey brandLabel={brandLabel(brandKey)} />BrandBoard 为共享组件:独立路由(自治时间窗)与工作台内嵌(compact 受控)同一主体;展示名经 fmt.brandLabel代码走查 + e2e 工作台品牌区展开与独立页数据一致生效
AC-EL-BRD-004时间窗预设组按钮组标题条内 7天/30天/90天/全部 tab,选中 on 高亮;ownDays 默认 90「全部」=3650 天;compact 模式不渲染按钮组,改显提示 窗口随顶部时间选择器 · 近 {N 天|全部}(受控 props days/from/to/country)e2e 点 7天 断言请求 days=7;compact 内嵌断言无按钮组生效
AC-EL-BRD-005独立区间→拖尾天数语义卡片独立日期区间换算天数:round((end−start)/86400000)+1clamp 1..3650;非法区间(NaN/end<start)回落全局窗口;独立区间仍是拖尾天数语义代码走查 + e2e 卡片选 2026-10-01→2026-10-08 断言按 8 天窗口请求生效
AC-EL-BRD-006墙数据加载APIGET /api/dashboard/charts?brand&platform=amazon&country&days(有精确区间时 +frm/to)返回 Wall{groups, kpis, chart_count, range, empty};失败→err 横幅;命中缓存不重复请求e2e 断言请求参数;API 报错注入断言横幅生效
AC-EL-BRD-007墙缓存缓存内存 cache 按 {days}|{from}|{to}|{country} 键brandKey 变更即整体清空(内嵌实例不重挂载,不清则永远旧品牌);country 已入缓存键(2026-09-16 修「切国家看板不变」)e2e 同窗切换国家断言新请求;切品牌断言无旧数据残留生效
AC-EL-BRD-008错误横幅横幅.error role=alert,置顶显示墙加载错误文本仅墙加载失败触发;数据表错误不触发(各自静默)e2e 断言 role=alert生效
AC-EL-BRD-009标题条标题条{brandLabel} + 时间窗组(或 compact 提示)+ 加载中…(loading 时)+ 右缘计数单卡布局;品牌展示名与守卫口径一致e2e 断言品牌名与加载态生效
AC-EL-BRD-010#brandboard-count计数条右缘 {chart_count} 图 · {range.orders} 单({from} → {to})2026-10-01 像素审计P3:from/to 均 null 时省略括号段(原渲染「( → )」箭头残片);未加载=—e2e 空品牌断言无「( → )」残片生效
AC-EL-BRD-011KPI 卡×5KPI 卡订单(foot {units} 件)/营收 USD(foot 客单价 ${aov})/净利 USD(foot 利润率 {margin}%)/费用 USD(foot 已回款 ${settled})/取消率 %(foot 区间 {from} → {to})值=wall.kpis(/api/dashboard/charts);订单口径=有效订单剔取消、取消率分母=全量订单(AC-CAL-02);compact 内嵌不渲染(由工作台 KPI 区承担)e2e 断言 5 卡标签与 foot;SQL 复核对 AC-CAL-02生效
AC-EL-BRD-012空墙卡空态卡wall.empty 时整板换居中卡 该品牌窗口内无订单数据 + 试试「全部」窗口,或检查采集管道empty 由 API 判定(窗口内无订单);空墙时不渲染图组/表格/导航e2e 空窗口品牌断言空态卡生效
AC-EL-BRD-013错误引导卡错误卡墙从未加载且已报错(!wall && err)时整板换 无法加载该品牌看板 + {err} · 请从工作台品牌区进入P3 缺陷㊴(2026-10-01 修):brandboard/* 的 catch(()=>{}) 吞错导致骨架永卡、订单表空分页「第1/1页·0条」误导;墙失败即整板引导卡不再渲染残板e2e 403 品牌(他牌)断言引导卡而非骨架生效
AC-EL-BRD-014锚点导航锚点导航每组一个 tab {g.label} {n} → #sec-{g.key},末尾固定 📋 数据表格 → #sec-tables组集=wall.groups(API 返回,对齐 UVPVP 8 区块);图数=组内 charts.lengthe2e 断言锚点跳转与组标签生效
AC-EL-BRD-015图组区块区块每组 <section id="sec-{g.key}">,h2 {g.label} + sub {n} 图 · 卡片可拖拽排序(🔓 状态),排序按账号记忆组与图由 /api/dashboard/charts 返回(8 区块 81 图口径,逐图条目见 §11.1 工作台图表条目同源)e2e 断言区块标题与 sub 文案生效
AC-EL-BRD-016ChartGrid 拖拽持久化持久化每组独立 ChartGrid,pageKey=/dashboard/{brandKey}:{g.key}拖拽排序按账号持久化(user_dashboard_prefs);pageKey 区分独立页与工作台内嵌(内嵌 pageKey 见 §11.1)e2e 拖拽后刷新断言顺序保持生效
AC-EL-BRD-017ChartCard 标题图表卡标题title=CHART_TITLES[c.key]?.title ?? c.key标题字典=lib/chartTitles;无字典项时裸 key 兜底e2e 断言卡标题生效
AC-EL-BRD-018ChartCard 副题图表卡副题sub=spec.hint 优先 → CHART_TITLES 静态 hint 兜底;spec.sub 为日期形态时追加 · 数据日 {YYYY-MM-DD}P3 缺陷⑯(2026-10 修):hint 优先 API 动态值(本企业真前三),静态表仅兜底e2e 断言副题含数据日生效
AC-EL-BRD-019空图兜底空图兜底spec 缺失时 option=EMPTY_OPT(居中「暂无数据」)P3 缺陷⑰(2026-10 修):原为裸空坐标系 {series:[]} 误导e2e 空图断言「暂无数据」生效
AC-EL-BRD-020ChartCard CSV导出csvName={brandKey}_{c.key},内容由 specCsv 生成(pie=项/值;直角=维度+各系列)独立区间生效时用独立 spec,否则用原始 ce2e 下载断言文件名与首行表头生效
AC-EL-BRD-021ChartCard 独立区间区间选择每卡 range 下拉(默认 global,globalLabel=当前窗标签);选区间→onCardRange 按换算天数加载对应窗口墙并取同 key 图独立区间未加载时回落全局 spec;语义同 BRD-005e2e 卡片选区间断言新墙请求与卡内数据变化生效
AC-EL-BRD-022订单明细表容器表格容器DataTable:GET /api/brandboard/orders?brand&days(+frm/to/country)&page&page_size=20;loading=!ord;empty=无数据;分页条 page/pages/total行键=oid;失败静默(catch(()=>{}),墙层已兜错误面);随 brandKey/days/区间/country/页码联动e2e 翻页断言 page 参数;断言 20 行/页生效
AC-EL-BRD-023订单列·Order ID列订单号,文本筛选源字段 oid;rowKey 同源e2e 列头筛选断言过滤生效
AC-EL-BRD-024订单列·Date列下单日期源字段 date;表整体按下单时间倒序(API 排序)e2e 断言首行日期≥末行生效
AC-EL-BRD-025订单列·Country列国家代码,文本筛选源字段 countrye2e 筛选 US生效
AC-EL-BRD-026订单列·Currency列本币币种,文本筛选源字段 currency(List Price 的币种)e2e 断言币种与 List Price 对应生效
AC-EL-BRD-027订单列·Status列订单状态,文本筛选源字段 status(含取消态,本表为全量明细非剔取消口径)e2e 筛选 Cancelled生效
AC-EL-BRD-028订单列·List Price列挂牌价,右对齐,数值筛选=本币金额(无挂牌价源)——见 BRD-037 口径脚注e2e 断言与 Currency 同币种生效
AC-EL-BRD-029订单列·Price列成交金额,右对齐加粗,数值筛选源字段 revenue_usd(折 USD)e2e 断言加粗样式与数值生效
AC-EL-BRD-030订单列·Promotion列促销金额,右对齐,数值筛选源字段 promo(折 USD)e2e 断言列存在生效
AC-EL-BRD-031订单列·Commission列佣金,右对齐,数值筛选源字段 commission(折 USD)e2e 断言列存在生效
AC-EL-BRD-032订单列·FBA Fees列FBA 费用,右对齐,数值筛选源字段 fba(折 USD)e2e 断言列存在生效
AC-EL-BRD-033订单列·Settlement列回款状态,文本筛选取值=已回款/已退款+已回款(见 BRD-037);非金额列e2e 筛选 已回款生效
AC-EL-BRD-034订单列·Settled列回款金额,右对齐,数值筛选源字段 settled(折 USD);KPI「已回款」同源(BRD-011 foot)e2e 断言与 KPI 已回款一致生效
AC-EL-BRD-035订单列·Rate%列汇率,右对齐,数值筛选源字段 rate(本币→USD 换算率)e2e 抽一行核 List Price×Rate≈Price生效
AC-EL-BRD-036订单列·SKUs列订单内 SKU 列表,文本筛选;超 22 字符截断加 …,title 悬停显全文源字段 skus(拼接串);CSV 导出含全文e2e 长串断言截断与 title生效
AC-EL-BRD-037订单明细口径脚注口径脚注表底固定:订单明细表口径(UVPVP 14 列):金额=折 USD(费用为折 USD)|按下单时间倒序|List Price=本币金额(无挂牌价源)|Settlement=回款状态(已回款/已退款+已回款)|数据源=cleaned_amazon_orders + order_fees。14 列=BRD-023…036;卡片 sub 同口径缩写版;口径与 AC-CAL-02 不冲突(本表=全量明细,KPI=汇总剔取消)e2e 断言脚注全文;SQL 对 cleaned_amazon_orders 复核生效
AC-EL-BRD-038订单明细导出导出exportCsv/exportExcel 均为 {brandKey}_orders导出内容=当前筛选/排序结果全量列(含 SKUs 全文)e2e 下载断言文件名与行数生效
AC-EL-BRD-039Country/SKU 表容器表格容器DataTable:GET /api/brandboard/country-sku?brand&days(+frm/to/country)&limit=200;loading=!cs.length && !wall;empty=无数据;行键=country+sku无分页(limit=200 截断);失败静默(墙层兜错误面)e2e 断言 200 上限与列头生效
AC-EL-BRD-040C/S 列·Country列国家代码,文本筛选分组维度=国家×SKUe2e 断言分组正确生效
AC-EL-BRD-041C/S 列·SKU列SKU,文本筛选SKU 宇宙事实源=sku_mapping(不另造清单)e2e 筛选已知 SKU生效
AC-EL-BRD-042C/S 列·Qty列件数,右对齐,数值筛选按订单内 SKU 数均摊(见 BRD-045)SQL 复核均摊合计=订单件数生效
AC-EL-BRD-043C/S 列·Revenue (Local)列本币营收,右对齐,数值筛选源字段 rev_local;均摊口径同上e2e 断言与 Country 币种一致生效
AC-EL-BRD-044C/S 列·Revenue (USD)列美元营收,右对齐加粗,数值筛选源字段 rev_usd;均摊口径同上e2e 断言加粗与折算一致生效
AC-EL-BRD-045Country/SKU 口径脚注口径脚注表底固定:Country/SKU 汇总表口径:金额=折 USD|件数与金额按订单内 SKU 数均摊(items 级粒度未 ingest 的近似口径)|按国家×SKU 分组。卡片 sub 同口径缩写版;近似口径声明为恒定标准(items 级 ingest 落地前不改)e2e 断言脚注全文生效
AC-EL-BRD-046Country/SKU 导出导出exportCsv/exportExcel 均为 {brandKey}_country_sku导出内容=当前 200 行内筛选结果e2e 下载断言文件名生效

§11.21(续) Noon 品牌主看板(/dashboard/noon/[brand] · AC-EL-BRDN-001…,源码 web/app/dashboard/noon/[brand]/page.tsx 39 行 + components/NoonBoard.tsx 248 行 · API GET /api/brandboard/noon + /api/noon-inventory,routers/brandboard.py L141/L428)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-BRDN-001路由页壳页壳动态路由 /dashboard/noon/[brand];AppShell title={brandLabel} Noon 主看板,crumb=对齐 UVPVP Noon(按日) · FBN 预警联动 /inventory展示名=fmt.brandLabel(H9 2026-10-13 注册表注入)e2e 访问断言标题与面包屑生效
AC-EL-BRDN-002未知品牌守卫卡守卫brandKey 不在合法集时居中卡 未知品牌 {brandKey} + 品牌不存在或无权访问 · 从工作台进入合法性=(info.noon_brands ∩ useBrand().brands)——noon 注册表品牌且属本企业(H9 2026-10-13:散写 noon 品牌名单已删);守卫文案缺陷⑱同款修复(不列名单)e2e 访问非 noon 品牌断言守卫卡生效
AC-EL-BRDN-003主体挂载组件挂载通过守卫后渲染 <NoonBoard brandKey brandLabel />NoonBoard 为共享组件(2026-09-15 抽出):独立页自治窗口;工作台内嵌 compact 受控(days/from/to/country),数据/交互/ChartGrid pageKey 两态一致代码走查 + e2e 两态数据一致生效
AC-EL-BRDN-004时间窗预设组按钮组7天/30天/90天/全部 tab;ownDays 默认 90「全部」=3650;compact 不渲染按钮组,显 窗口随顶部时间选择器 · 近 {N 天|全部}e2e 点窗断言 days 参数生效
AC-EL-BRDN-005独立区间→拖尾天数语义round((end−start)/86400000)+1,clamp 1..3650非法区间回落全局;与 BRD-005 同实现同语义代码走查生效
AC-EL-BRDN-006墙数据加载APIGET /api/brandboard/noon?brand&days&country(+frm/to)返回 Wall{groups, kpis, chart_count, range, empty};失败→err 横幅e2e 断言请求与渲染生效
AC-EL-BRDN-007墙缓存缓存内存 cache 键 {days}|{from}|{to}|{country};brandKey 变更整体清空与 BRD-007 同实现;内嵌实例切品牌不残留旧数据e2e 切品牌断言无残留生效
AC-EL-BRDN-008错误横幅横幅.error role=alert 置顶显示墙错误仅墙加载失败触发e2e 注错断言 role=alert生效
AC-EL-BRDN-009标题条标题条{brandLabel} · Noon + 时间窗组(或 compact 提示)+ 加载中… + 右缘计数布局与 BRD-009 同构e2e 断言文案生效
AC-EL-BRDN-010#noonboard-count计数条{chart_count} 图 · {range.orders} 件({from} → {to})单位=件(Noon 件级口径);2026-10-01 像素审计P3:from/to 均 null 省略括号段;未加载=—e2e 空墙断言无残片生效
AC-EL-BRDN-011空墙卡空态卡该品牌窗口内无 Noon 数据 + 试试「全部」窗口,或检查采集管道empty 由 API 判定;空墙时不渲染图组/审计卡e2e 空品牌断言空态卡生效
AC-EL-BRDN-012KPI 卡×4KPI 卡窗口订单(件)(foot 最新日 {last_day_orders} 件)/取消率 %(foot CIR 率 {cir_rate}%)/最新月 GMV $(foot 折 USD · 月度结算口径)/最新月利润 $(foot 结算净额−广告)值=wall.kpis;金额卡显式标注月度口径(Hub 无 Noon 日级金额源的已知偏差,卡内注明=恒定要求);取消率口径 AC-CAL-02;compact 内嵌不渲染 KPI 行(仅 FBN 卡常驻)e2e 断言 4 卡与月度口径脚注生效
AC-EL-BRDN-013FBN 库存预警卡KPI 卡id=nsec-fbn;k-value=FBN 总库存;foot=🔴 {urgent} · 🟡 {watch} · 🟢 {ok} · 缺口 {shortage_units}u · {period_days}d(快照 {snapshot}) 或 暂无快照(等待每日 08:00 采集);尾链 明细 → → /inventoryGET /api/noon-inventory?brand(brandLabel 就绪后拉取);urgent>0 卡边框转 danger 红;compact 与全屏两态均渲染(UVPVP 同位)e2e 断言分级数与 /inventory 链接;urgent>0 断言红边生效
AC-EL-BRDN-014锚点导航锚点导航每组 tab {g.label} {n} → #nsec-{g.key}组集=wall.groups(核心指标/销售/订单状态/财务/国家/SKU+广告 对齐 UVPVP Noon)e2e 断言锚点生效
AC-EL-BRDN-015图组区块区块每组 <section id="nsec-{g.key}">,h2 + sub {n} 图 · 卡片可拖拽排序(🔓 状态),排序按账号记忆组与图由 /api/brandboard/noon 返回e2e 断言区块文案生效
AC-EL-BRDN-016ChartGrid 拖拽持久化持久化pageKey=/dashboard/noon/{brandKey}:{g.key}账号级记忆,与内嵌实例共用同 pageKey(两态排序互通)e2e 拖拽刷新断言保持生效
AC-EL-BRDN-017ChartCard 标题图表卡标题title=CHART_TITLES[c.key]?.title ?? c.key与 BRD-017 同源字典e2e 断言标题生效
AC-EL-BRDN-018ChartCard 副题图表卡副题sub={EN[c.key] 原图名}{ · hint};无 EN 项时仅 hintEN 名册=32 个墙 key(NoonBoard.tsx L39-54 实数)→UVPVP 英文原图名(nDailyOrders→Daily Orders … nCpsTrend→Ad Spend per Order (CPS),验收台账对照);月度替代图(nMonthlyAov/nSettleRate/nMonthlyProfit)原图名内含 → Monthly 标注偏差e2e 断言副题含英文原图名生效
AC-EL-BRDN-019空图兜底空图兜底spec 缺失→EMPTY_OPT 居中「暂无数据」P3 缺陷⑰同款修复(原裸空坐标系)e2e 空图断言生效
AC-EL-BRDN-020ChartCard CSV导出csvName=noon_{brandKey}_{c.key}specCsv 同 BRD-020 实现e2e 下载断言文件名生效
AC-EL-BRDN-021ChartCard 独立区间区间选择range 下拉默认 global;选区间按换算天数加载对应墙取同 key 图,未加载回落全局语义同 BRD-005/BRD-021e2e 选区间断言数据变化生效
AC-EL-BRDN-022数据审计说明卡说明卡id=nsec-audit;五条口径声明:①订单/状态/CIR/取消/时段=noon_orders 件级按日(92 天滚动窗,每日 04:30 ingest)②金额类(GMV/结算/费用/利润/广告 ROI)=月度结算口径折 USD——Hub 无 Noon 日级金额源,UVPVP 的 Daily GMV/AOV/Profit/SettlementRate 以月度替代(图题已标注)③利润=结算净额−广告(与工作台 Noon 月墙同口径,唯一实现)④广告日趋势(CTR/CVR/CPS/花费)=noon_ads_daily;SKU 级广告=noon_sku_ads 月表 ⑤FBN 库存=fbn_inventoryv2_aging 最新快照(SALEABLE 口径),92 天销速分级 35d/90d 线UVPVP 同位卡;月度替代为已声明恒定偏差(非缺陷),落库口径以本卡文字为准e2e 断言五条全文;SQL 对 noon_orders/noon_ads_daily 复核生效

§11.22 品牌入驻向导(/onboarding · AC-EL-ONB-001…,源码 web/app/onboarding/page.tsx 310 行 · API routers/onboarding.py L42-L269;铁律核心场景:企业/品牌创建 + 注册表级联)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-ONB-001页壳页壳AppShell title=品牌管理,crumb=开户自动化 · 注册表驱动 · 新品牌/新产品零建表零发版三块(web/库/采集)以注册表为合同:本页只写注册表与主数据,管道与健康由注册表驱动,零 LLMe2e 断言标题与面包屑生效
AC-EL-ONB-002元数据加载APIGET /api/onboarding/meta → platforms/marketplaces/categories/tenant_brands/brands_source失败→toast err;tenant_brands=本企业品牌(铁律①,RLS 限定)e2e 断言选项渲染生效
AC-EL-ONB-003管道健康加载APIGET /api/onboarding/pipeline → pipelines(水位表数据源)失败静默 catch(()=>{})(表显空态,不阻断向导)e2e 断言表渲染生效
AC-EL-ONB-004三步向导步骤头步骤头stepHead(n):22px 圆号(当前=品牌色/其他=边框色)+标题;step>n 显 ✓步骤 1 品牌与平台 / 2 类目与 SKU 导入 / 3 完成态;step 只进不退(再接入按钮重置)e2e 断言步骤流转与 ✓生效
AC-EL-ONB-005品牌标识输入输入input placeholder=品牌标识(小写字母/数字, 如 mybrand);提交时 trim().toLowerCase()服务端 _BRAND_RE:2-31 位小写字母/数字/-/_,字母或数字开头,违者 400 品牌名 2-31 位, 小写字母/数字/-/_, 字母或数字开头;空值前端 toast 请填写品牌名e2e 提交非法名断言 400 文案生效
AC-EL-ONB-006已有品牌补登记下拉下拉仅 tenant_brands 非空渲染;占位 选择已有品牌补登记…,选项=本企业品牌选中即回填品牌输入框;名单=meta.tenant_brands(本企业口径,铁律①)e2e 断言仅本企业品牌可选生效
AC-EL-ONB-007平台多选 tab 组多选meta.platforms 渲染 tab {name} · {ads_model},选中 on;可多选可取消提交前空选 toast 请至少选择一个平台;服务端校验 platform∈platforms(active),未开放 400 平台未开放: {p}e2e 空选提交断言 toast生效
AC-EL-ONB-008店铺账号输入输入可选;placeholder=如 zf-us-main(多店铺区分用)填写时随品牌提交 channels(每平台一条,marketplace 取该平台首个选中站点);留空则不带 channelse2e 填写提交断言 brands_source/brand_channels 落库生效
AC-EL-ONB-009直营/代卖下拉下拉mode 选择:直营=direct / 代卖=consignment铁律②直营/代理区分的登记入口;服务端 mode 仅 direct/consignment,违者 400 mode 仅 direct/consignment: {v};写入 brand_channels.modee2e 两 mode 提交断言落库值生效
AC-EL-ONB-010经营站点多选多选仅唯一平台选中时渲染;activeMks=marketplaces 按该平台过滤;tab {country} {currency} 可多选服务端校验 (platform,country)∈marketplaces,坏站点 400 平台 {p} 无站点: {列表};多平台时隐藏(站点仅单平台语义)e2e 双平台断言隐藏;单平台勾选断言提交生效
AC-EL-ONB-011登记品牌按钮按钮登记品牌, 下一步(busy=登记中…);POST /api/onboarding/brandbody={brand, entries[{platform, marketplaces}], channels?};成功 toast 品牌已登记(,下一步导入 SKU)→step2+meta/pipeline 重载e2e 提交断言 toast 与步骤流转生效
AC-EL-ONB-012跨企业品牌占用防线防线(铁律)ISO-08 铁律修复(2026-10-17):品牌名是全局命名空间(products 主键 (brand,sku) 无企业维度),已被其他企业持有的品牌 409 该品牌已被其他租户持有, 无法自助注册; 如需跨租户共享请联系平台管理员查重走 saas_admin 直连(tenant_brands FORCED RLS,portal 请求上下文看不见外企业行);受控共享(如 onno 演示镜像)走管理员手工登记;修复前任意企业可用同名 SKU 覆写他企业主数据(实测复现)e2e 企业 B 注册企业 A 已持品牌断言 409生效
AC-EL-ONB-013登记级联(单事务四连)级联(铁律)铁律③级联自动生成:①tenant_brands 品牌授权插入(RLS WITH CHECK 仅本企业,已存在跳过)②brands_source 注册表 upsert(冲突 (tenant_id,brand,platform) 时 UPDATE marketplaces/collector/note 且 enabled=true)③inv_warehouses 无仓则种子 MAIN 主仓 ④brand_channels 渠道 upsert(冲突 (tenant_id,brand,platform,marketplace,account) 时 UPDATE mode/note 且 enabled=true)一个事务完成 品牌授权+管道注册+默认仓种子+审计;幂等=重复提交即更新注册;全程 _prov 置备事件 + audit(onboarding.brand)e2e 新品牌提交后 SQL 断言四表级联落库生效
AC-EL-ONB-014管道自动装配声明文案响应 hint=品牌已登记; 采集管道将于注册表驱动下自动装配(P2), 数据到位后全站页面自动带出;step3 文案=采集管道按注册表自动装配(P2 接管),数据回流后订单/广告/财务分析自动带出——全程无需任何前端发布注册表=brands_source 是采集装配的合同;hint 非空时 toast 追加「,下一步导入 SKU」e2e 断言 hint 文案生效
AC-EL-ONB-015步骤1回显文案step>1 时卡内显 {brand} · {plats 以 " / " 连接} · 站点 {逗号列表|全部}回显已登记选择,不可再编辑(重走需 step3 重置)e2e 断言回显生效
AC-EL-ONB-016类目下拉下拉选项=meta.categories(value=category 显 name)+ 固定尾项 ➕ 新建类目…(__new__)选已有→setCategory;选 __new__→展开新建面板e2e 断言选项与面板切换生效
AC-EL-ONB-017默认站点下拉下拉占位 默认站点(空值)+ activeMks 选项值随 SKU 导入提交 country;多平台时 activeMks 为空(同 ONB-010 单平台语义)e2e 断言选项生效
AC-EL-ONB-018新建类目标识/名称输入标识 placeholder=标识(英文, 如 fishing);名称 placeholder=名称(如 渔具)前端校验 /^[a-z][a-z0-9_]{1,29}$/,违者 toast 类目标识: 小写字母开头, 2-30 位字母/数字/_;空名 toast 请填写类目名称;服务端 category 2-30 同 pattern、name 1-20e2e 非法标识断言 toast生效
AC-EL-ONB-019类目属性行输入组每行:key(placeholder key(英文))/名称/类型下拉(文本=text/数字=number/单选=select)/单位(≤8 字符)/select 时选项输入(placeholder 选项,逗号分隔,split /[,,、]/ trim 去空)/必填 checkbox服务端 AttrDef:key 1-32 ^[a-z][a-z0-9_]*$、label 1-20、type 无枚举校验(type: str="text" 默认,text/number/select 三值仅前端下拉约束,API 直调可传他值,onboarding.py:165)、unit≤8、options≤20 项、required 布尔;attrs≤20 条;留空 key/label 的行忽略e2e 构造 select 类目含选项断言落库生效
AC-EL-ONB-020加属性/保存类目按钮按钮+ 加属性(追加空行);保存类目→POST /api/onboarding/categorybody={category, name, attrs};成功 toast 类目已保存、自动选中新类目、meta 重载;busy 期间禁用e2e 保存断言下拉出现新类目生效
AC-EL-ONB-021类目属性提示文案选中类目有 attr_schema 时显 类目属性: {label}{必填加 *} · … — 属性可经 API attrs 字段导入引导 API 导入路径(attrs 字段);general 等无属性类目不显e2e 选有属性类目断言提示生效
AC-EL-ONB-022SKU 粘贴框输入textarea rows=8,placeholder=每行一条: SKU, 品名, ASIN, 成本RMB 例: BN-001, BrainNews 智能台灯, B0XXXXXXXX, 45.5;等宽字体行分隔 /\n+/;列分隔 /\t|,/(制表符或逗号);列序=SKU,品名,ASIN,成本RMBe2e 粘贴样例断言解析生效
AC-EL-ONB-023即时解析规则校验逐行解析:缺 SKU 行整体丢弃(filter(r=>r.sku),page.tsx:59——err=缺 SKU 赋值后即被滤掉从不显示,系死代码);成本缺省容忍(0);成本为负标 err=成本为负badRows=err 行计数;err 行仍入预览(红字)但阻断提交(实际仅「成本为负」触发红字/阻断)e2e 负成本行断言红字与阻断生效
AC-EL-ONB-024解析预览表表格解析 {N} 行(有误时追加红字 · {n} 行有误);表 4 列 SKU/品名/ASIN/成本RMB;最多显前 50 行(maxHeight 200 滚动);err 行红字预览≠提交集(50 行截断仅显不截断提交)e2e 60 行粘贴断言 50 行显示、按钮显 60生效
AC-EL-ONB-025导入 SKU 按钮按钮导入 {N} 个 SKU(busy=导入中…);POST /api/onboarding/skus空清单 toast 请先粘贴 SKU 清单;有误行 toast 有 {n} 行无法解析,请修正;body={brand, platform: plats[0], country, category, rows[{sku,title,asin,cost_rmb}]};成功 setDone(imported)→step3e2e 导入断言 imported 数与 step3生效
AC-EL-ONB-026步骤3完成态完成态✓ 已导入 {imported} 个 SKU + 说明(商品页 /products 链接与工作台品牌筛选立即可见;管道自动装配文案)级联效果声明:主数据入库即全站可见,数据回流后分析自动带出e2e 导入后断言完成态文案与 /products 可见生效
AC-EL-ONB-027再接入一个品牌按钮按钮step3 显 再接入一个品牌;点击重置 step/brand/plats/csv/done→步骤1mks/category/account 不重置(保留上次选择)e2e 点击断言回到步骤1且品牌输入为空生效
AC-EL-ONB-028品牌管道健康表表格h2 品牌管道健康 sub 注册表驱动 · 水位实时 · 断更 > 2 天标红;列=品牌/平台/6 水位列/状态水位列=WM_LABELS:订单=amazon_orders、广告(SKU)=ads_sku_daily、广告(活动)=amazon_ads_daily、Noon广告=noon_ads_daily、财务=finance_monthly、小时销=sales_hourly;行=brands_source 注册的品牌×平台e2e 断言表头与注册行生效
AC-EL-ONB-029水位单元格单元格显 watermark 原值(空=—);daysSince>2 红字+⚠daysSince=now−watermark 天数;YYYY-MM 形态补 -28 计月龄;每列独立判红e2e 断旧水位标红生效
AC-EL-ONB-030状态列单元格三态:未启用(enabled=false,灰)/断更 {days} 天(红,加粗)/正常(绿,加粗)days=该行全部水位 daysSince 最大值(空水位不计;Math.max(0,…,-1) 含字面 0,实际下限 0,-1 仅为空集兜底,page.tsx:288);判红线=2 天e2e 构造断更行断言红态生效
AC-EL-ONB-031空管道行空态pipelines 空 时单行 暂无注册品牌管道(colSpan=10,居中)新企业/接口静默失败共用户面e2e 新企业断言空态行生效

§11.22(续) 注销冷静期(/offboarding · AC-EL-OFB-001…,源码 web/app/offboarding/page.tsx 80 行 · API routers/org.py L252-L295(offboard@252、restore@280,全文 295 行)+ core.py OFFBOARD_COOLDOWN_DAYS;铁律核心场景:不可误删)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFB-001页面形态页壳不挂 AppShell;独立居中卡(min(460px,100%),全屏 flex 居中)#62(2026-10-10):offboarding 企业的中间件只放行 login+restore 两条 API,本页不得发起任何其他数据请求(AppShell 的 /api/me 等探测会 404)e2e offboarding 企业访问断言渲染且网络面板无其他 API生效
AC-EL-OFB-002query 参数吸收交互挂载时从 URL query 读 due(届满日期)与 just=1(刚发起)来源两路:登录自救(login 响应)或团队页危险区发起注销(offboard 响应)由入口带入e2e 带 due/just 访问断言渲染生效
AC-EL-OFB-003警示图标+标题图标44px 红底圆角「!」图标 + h1 注销冷静期 + 企业已停止服务,数据已完整归档danger 色变量(fallback #c0392b)e2e 断言标题与图标生效
AC-EL-OFB-004just 横幅横幅just=1 时 ok-banner role=status:注销已发起:全部数据归档完成,子域与全员会话已停用。仅刚发起路径渲染;与恢复路径(无 just)互斥e2e ?just=1 断言横幅生效
AC-EL-OFB-005冷静期说明三行文案①本企业处于 30 天注销冷静期,期间数据只读封存、业务面已停用 ②届满日期 {due | 自注销发起日起 30 天},届时数据将被永久清除 ③冷静期内业主可随时一键恢复,数据与账号原样回归,无任何损失OFFBOARD_COOLDOWN_DAYS=30(core.py L423,auth 共享);due 由服务端 purge_due 传入e2e 断言三行文案与 due 日期生效
AC-EL-OFB-006恢复按钮(恢复路径)按钮恢复企业,撤回注销(busy=恢复中…);POST /api/org/tenant/restore成功→info 横幅 已恢复,正在进入工作台…+router.replace(/);失败→err 横幅;服务端:status offboarding→active、suspended_at 置空、审计 tenant.offboard.restore(cooled=N d);非 offboarding 409 不在注销冷静期, 无需恢复;_require_admine2e 冷静期企业点恢复断言回 active 可进工作台生效
AC-EL-OFB-007重新登录后可恢复按钮(just 路径)按钮just=1 时改显 a.btn 重新登录后可恢复(href=/login)+ 说明 注销时全员会话已吊销——登录后会被自动带回本页,再点「恢复企业」即可撤回。会话已吊销故不能直接恢复;登录后被中间件带回本页走 OFB-006e2e ?just=1 断言登录按钮与说明生效
AC-EL-OFB-008权限说明脚注文案恢复需要 owner / admin 权限;如你不是业主,请联系业主在本页操作。审计记录(注销/恢复)永久留存。与 _require_admin 服务端契约一致;审计永久留存=不可误删的反向保障e2e 断言脚注;SQL 断言审计行生效
AC-EL-OFB-009err/info 横幅横幅err=.error role=alert;info=.ok-banner role=status恢复失败/成功两条反馈通道;busy 期间按钮禁用e2e 注错断言 role=alert生效
AC-EL-OFB-010注销前置归档(不可误删铁律)契约(铁律)POST /api/org/tenant/offboard:归档→offboarding→吊销全员会话;归档是清除的前置铁条件,任何一步失败则 status 不动confirm 必须回显本租户 slug(400 confirm 必须回显本租户 slug);已 offboarding 409 已在注销冷静期;非 active 409 当前状态 {s} 不可发起注销;_archive_tenant 逐表 COPY 写 gzip SQL 流+sidecar manifest(逐表行数),gzip 魔数+尺寸校验不过即抛错;吊销全员会话;审计 tenant.offboard(archive/rows/cooldown)e2e 发起注销断言归档文件生成+审计行;破坏归档断言 status 不变生效
AC-EL-OFB-011归档去向归档_archive_tenant 落盘 /srv/offboarding/{slug}/{slug}-archive-{YYYYmmdd-HHMMSS}.sql.gztenant_conn RLS + 显式 tenant_id 过滤双保险逐表导出;备份长期去向(含届满清除后留存策略)2026-10-18 用户待拍板挂账(隔离审计 VII),未拍板前不得迁移/清理该目录。

2026-10-22 对账闭环:留存策略已由 #63(2026-10-10 用户拍板「那就优化好」)落地——api/tasks.py ARCHIVE_RETENTION_DAYS=90,offboarding_archive_retention 每日 07:17 对非 offboarding 企业的满 90 天归档整目录回收并写 tenant.archive.retire 审计;/srv/offboarding 当前不存在=零注销常态(audit_log tenant.offboard*/archive.retire 0 行,tenants 3 全 active);目录由 org.py _archive_tenant makedirs 按需创建。2026-10-18 挂账系与 #63 未对账之重复挂账,据此换绿
ls /srv/offboarding/{slug}/ 断言文件与 manifest 行数生效
AC-EL-OFB-012届满物理清除声明契约purge_due=发起时刻+30 天(随 offboard 响应下发为本页 due);届满数据将被永久清除,无手工捷径本条为页面文案+org.py 契约声明;届满清除执行器在管道/cron 侧(非本页源码),其条目归管道章节e2e 断言 due=发起日+30;清除执行器另册验证生效
AC-EL-OFB-013双向审计留存审计注销=tenant.offboard(archive 文件名/rows/cooldown);恢复=tenant.offboard.restore(cooled=N d)审计永久留存,恢复不删注销记录(追加式);与 OFB-008 脚注互证SQL 断言双向审计行齐备生效

§11.23 认证四页(/register /login /verify /welcome · AC-EL-AUTH,源码 web/app/register/page.tsx 120 行 + login/page.tsx 80 行 + verify/page.tsx 56 行 + welcome/page.tsx 132 行 + web/components/RegGate.tsx 23 行,后端 api/routers/auth.py)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-AUTH-001注册门 RegGate(页面级)守卫/register 整页内容外包 RegGate,注册关闭时显示关闭文案,页面路由本身保留可见机制:客户端挂载后 fetch /api/auth/registration-status(credentials include),open=false → 渲染 closedText「注册暂未开放,如需开通请联系 support@zipforcehub.com」;接口异常/拿不到状态 → 放行显示原入口(fail-open,API 层 403 兜底);开关真值=运行时 SAAS_REGISTRATION_OPEN,营销页预渲染读不到构建时 env读 web/components/RegGate.tsx:1-23;curl -s https://zipforce.zipforcehub.com/api/auth/registration-status 看当前 open 真值生效
AC-EL-AUTH-002Z logo 品牌块结构注册页顶部 44×44、圆角 10、var(--brand) 底白字「Z」,无「ZIPFORCE Hub」品牌字(register/page.tsx:61-65)纯静态展示,无数据依赖;welcome/en/privacy/terms 四页为另一形态(30×30、圆角 8、#4f46e5+品牌字,welcome:52/en:53/privacy:119/terms:96)——两形态并存非同组件;#4f46e5=globals.css:2 --brand读 register/page.tsx 品牌块段;浏览器看渲染生效
AC-EL-AUTH-003标题「注册 ZIPFORCE」文本注册页主标题 h1静态文案;页面 document title 与 h1 分离,h1 不变读 register/page.tsx h1 段生效
AC-EL-AUTH-004副标题「Amazon 卖家的电商数据 AI 工作台 · 14 天试用」文本注册页副标题,声明试用口径「14 天」与 terms §二「14 天全功能免费试用,无需绑定支付方式」同口径(跨层一致);静态文案读 register/page.tsx;对照 terms/page.tsx §二首条生效
AC-EL-AUTH-005公司/店铺名字段表单注册表单字段:label「公司/店铺名」必填;minLength=2 maxLength=60;值作为 company 提交(后端据此生成企业 slug 与子域)读 register/page.tsx 公司字段段;提交 1 字符公司名应被前端拦生效
AC-EL-AUTH-006邮箱字段表单注册表单字段:邮箱type=email 必填;autoComplete=username;提交名 email;为验证邮件投递目标读 register/page.tsx 邮箱字段段生效
AC-EL-AUTH-007密码字段表单注册表单字段:label「密码(至少 8 位)」规则仅此一条:必填、最少 8 字符(minLength=8)、type=password、autoComplete=new-password;本条只描述校验规则,不录入任何真实或样例密码;存储侧=不可逆散列(见 privacy §二「仅存储不可逆散列值」)读 register/page.tsx 密码字段段;读 privacy/page.tsx §二首条口径行生效
AC-EL-AUTH-008注册错误提示区交互表单下方错误提示,role=alert失败显示「注册失败」+后端 detail;网络异常 fallback「网络错误,请重试」;无障碍语义=alert读 register/page.tsx err 段;断网提交看 fallback生效
AC-EL-AUTH-009同意条款复选框表单必选复选框 + 两个法务链接勾选为提交前置条件(见 010 禁用逻辑);链接《服务条款》→/terms、《隐私政策》→/privacy,均 target=_blank 新窗打开读 register/page.tsx agree 段;未勾选时提交按钮应禁用生效
AC-EL-AUTH-010提交按钮「创建账号」交互注册表单提交按钮,双态文案禁用条件=busy || !agree(提交中或未勾选条款);busy 态文案「注册中…」,常态「创建账号」读 register/page.tsx 按钮段;未勾选+点按钮验证不可点生效
AC-EL-AUTH-011注册接口 POST /api/auth/registerAPI提交 {email, password, company},credentials: include后端 api/routers/auth.py:236 起;成功返回 {ok:true, subdomain:"{slug}.zipforcehub.com"}(auth.py:291);有限速(注册 IP 维度 Redis 键,auth.py:243 expire 3600)grep -n "auth/register" api/routers/auth.py;读 auth.py:236-291生效
AC-EL-AUTH-012成功态提示「验证邮件已发送到 {email}(24 小时内有效)」交互注册成功后绿色提示,role=status「24 小时内有效」声明在两层一致:页面文案 + 验证邮件正文(auth.py:204 纯文本 / auth.py:209 HTML 均「24 小时内有效」);验证链接形如 https://zipforcehub.com/verify?token={token}(auth.py:203)读 register/page.tsx 成功态段;grep -n "24 小时" api/routers/auth.py;token 实际 TTL 常量在 parse_token 侧复核生效
AC-EL-AUTH-013子域展示文本成功态展示分配到的企业子域值来自注册响应 subdomain 字段(后端拼 {slug}.zipforcehub.com,auth.py:291),前端不自行拼接读 register/page.tsx 成功态 subdomain 段;对照 auth.py:291生效
AC-EL-AUTH-014重发验证邮件按钮交互成功态内「重新发送」按钮POST /api/auth/resend {email}(auth.py:319 起);后端限速键 resend:{email}(auth.py:324,Redis expire 3600);成功 toast/文案「验证邮件已重新发送,请查收」读 register/page.tsx resend 段;读 auth.py:319-326生效
AC-EL-AUTH-015「返回登录」链接链接成功态内回登录页链接指向 /login;静态读 register/page.tsx 成功态链接段生效
AC-EL-AUTH-016页脚「已有账号?登录」链接注册页底部切换入口指向 /login;在 form 内、RegGate 包裹范围内(register:70-116,链接在 111-113)——注册关闭时该链接同样被隐藏,非独立于开关读 register/page.tsx 页脚段生效
AC-EL-AUTH-017登录页标题「ZIPFORCE Portal」+ 副标题文本h1「ZIPFORCE Portal」,副标题「多企业电商数据平台 · 登录」静态文案;与注册页「注册 ZIPFORCE」命名体系并列读 login/page.tsx 标题段生效
AC-EL-AUTH-018登录邮箱字段表单登录表单邮箱输入必填;autoComplete=username(浏览器密码管理器配对用)读 login/page.tsx 邮箱段生效
AC-EL-AUTH-019登录密码字段表单登录表单密码输入必填;type=password;autoComplete=current-password(与注册页 new-password 区分);本条只描述交互属性,不涉及任何密码值读 login/page.tsx 密码段生效
AC-EL-AUTH-020登录接口 POST /api/auth/loginAPI提交邮箱+密码,credentials: include后端校验账号 active 且密码散列匹配(auth.py:113);成功种会话 Cookie(httponly secure samesite=lax max_age=SESSION_TTL,auth.py:127);登录失败限速 Redis 键 expire 600(auth.py:117)读 login/page.tsx 提交段;读 auth.py:113-132生效
AC-EL-AUTH-021登录后分流跳转交互登录成功按企业状态路由j.tenant_status==="offboarding" → router.replace(j.purge_due ? /offboarding?due=… : /offboarding),否则 → /;后端依据:offboarding 企业登录是自救通道(#61 挂账②,auth.py:122-123),响应带 tenant_status/purge_due,purge_due=offboard 时间+OFFBOARD_COOLDOWN_DAYS(auth.py:132)读 login/page.tsx on-ok 分支;读 auth.py:122-132生效
AC-EL-AUTH-022登录错误提示交互登录失败提示,role=alert展示后端错误信息;网络异常 fallback;无障碍语义=alert读 login/page.tsx err 段生效
AC-EL-AUTH-023登录按钮交互登录提交按钮,双态文案busy 态「登录中…」,常态「登 录」(半角空格 U+0020 分隔,login/page.tsx:67)读 login/page.tsx 按钮段生效
AC-EL-AUTH-024登录页注册入口(RegGate)守卫页脚「还没有账号?注册(14 天试用)」→ /register,外包 RegGateclosedText=「注册暂未开放」(短版,区别于注册页长版文案);机制同 AC-EL-AUTH-001;「14 天试用」口径同 004读 login/page.tsx RegGate 段;对照 RegGate.tsx 默认 closedText生效
AC-EL-AUTH-025登录页脚法务链接链接页脚淡色「服务条款 · 隐私政策」链接分别指向 /terms、/privacy;静态读 login/page.tsx 页脚段生效
AC-EL-AUTH-026verify token 参数读取交互/verify 从 URL 查询串读 tokennew URLSearchParams(window.location.search) 取 token 作为验证唯一凭证;无 token 走失败态读 verify/page.tsx token 段生效
AC-EL-AUTH-027验证接口 GET /api/auth/verify?token=…API页面加载即请求验证后端 auth.py:293 起;结果二值化驱动页面三态(loading/ok/fail)读 verify/page.tsx fetch 段;grep -n "auth/verify" api/routers/auth.py生效
AC-EL-AUTH-028验证 loading 态状态请求期间显示「正在验证邮箱…」初始态;接口返回后必然离开此态(ok 或 fail)读 verify/page.tsx loading 段生效
AC-EL-AUTH-029验证成功态状态h1「邮箱验证成功 🎉」+「你的工作台已开通,正在前往登录页…」仅当接口 ok 进入;文案声明工作台开通事实(企业激活完成)读 verify/page.tsx ok 段生效
AC-EL-AUTH-030自动跳转登录(2500ms)交互成功态 setTimeout 2500ms 后跳登录目标=响应里的 login_url 字段(前端不硬编码);倒计时期间用户可先点「立即登录」(见 031)读 verify/page.tsx setTimeout 段;改本地时钟不可绕过(服务端已验证)生效
AC-EL-AUTH-031「立即登录」按钮交互成功态手动跳转按钮,不等 2500ms目标同 030 的 login_url;静态文案读 verify/page.tsx 按钮段生效
AC-EL-AUTH-032验证失败态状态h1「验证失败」+ role=alert 错误区展示后端 detail,无 detail 时 fallback「验证失败」/「网络错误,请重试」;常见触发=token 过期/已用/缺失读 verify/page.tsx fail 段;用过期 token 访问 /verify 复现生效
AC-EL-AUTH-033「重新注册」链接链接失败态出口 → /register静态;失败态唯一主动出口读 verify/page.tsx fail 态链接段生效
AC-EL-AUTH-034welcome 页 metadata(SEO)元数据中文营销首页 SEO 元数据组title「亚马逊卖家店铺与广告数据分析平台 · SP-API / Ads API 官方对接」;canonical /;alternates:zh-CN /、en /en、x-default /;openGraph siteName ZIPFORCE Hub、locale zh_CN(与 /en 页 en_US 互为 hreflang 对)读 welcome/page.tsx metadata 段;view-source 看 canonical/hreflang生效
AC-EL-AUTH-035welcome header 导航导航顶栏:功能(#features)/ 数据安全(#security)/ EN(→/en)/ 免费注册(→/register,RegGate 包裹)锚点两项页内滚动;EN 切英文版;注册 CTA 受 RegGate 管控(机制同 001)读 welcome/page.tsx header 段生效
AC-EL-AUTH-036hero 徽章「亚马逊店铺 + 广告一体化数据分析 · SaaS」文本hero 区胶囊徽章静态定位语;与 /en 页英文徽章互译对应读 welcome/page.tsx hero 徽章段生效
AC-EL-AUTH-037hero 主标题文本h1「连接你的亚马逊店铺与广告数据,AI 一句诊断广告赚没赚」静态;核心价值主张一句话(店铺+广告数据接入 → AI 诊断)读 welcome/page.tsx h1 段生效
AC-EL-AUTH-038hero 主 CTA「免费开始 —— 14 天全功能试用」交互主按钮 → /register,外包 RegGateclosedText=联系 support@zipforcehub.com 版本;「14 天全功能试用」口径同 004/terms §二读 welcome/page.tsx CTA 段生效
AC-EL-AUTH-039hero 已有账号提示文本「已有账号?访问 你的公司名.zipforcehub.com」提示企业子域登录路径;与 auth.py:291 子域格式 {slug}.zipforcehub.com 同构读 welcome/page.tsx hint 段生效
AC-EL-AUTH-040功能卡 1「广告活动分析」卡片FEATURES 卡:广告活动分析描述=活动级花费/销售/ACOS 趋势与健康度;对应站内 /ads 能力区(§11.9)读 welcome/page.tsx FEATURES[0];对照 §11.9 广告组条目生效
AC-EL-AUTH-041功能卡 2「SP 店铺数据」卡片FEATURES 卡:SP 店铺数据描述=订单明细/FBA 库存健康/月度财务结算,经官方 SP-API;对应 /orders、/finance 等能力区读 welcome/page.tsx FEATURES[1]生效
AC-EL-AUTH-042功能卡 3「AI 广告洞察」卡片FEATURES 卡:AI 广告洞察描述=基于真实业绩数据的 AI 广告诊断+预算/定向建议;对应 /ai 能力区读 welcome/page.tsx FEATURES[2]生效
AC-EL-AUTH-043功能卡 4「利润报表」卡片FEATURES 卡:利润报表描述=每 SKU 每月收入/费用/回款/净利,跨市场统一折 USD;对应 /finance(§11.6)读 welcome/page.tsx FEATURES[3]生效
AC-EL-AUTH-044功能卡 5「广告告警」卡片FEATURES 卡:广告告警描述=高 ACOS/零销售活动/低 CTR 自动告警+每日优化清单读 welcome/page.tsx FEATURES[4]生效
AC-EL-AUTH-045功能卡 6「Listing 分析」卡片FEATURES 卡:Listing 分析描述=标题/五点/关键词覆盖与 Listing 变更追踪;对应 /listings 能力区读 welcome/page.tsx FEATURES[5]生效
AC-EL-AUTH-046场景卡 1「亚马逊多站点卖家」卡片CASES 卡:多站点卖家描述=北美/欧洲/日本店铺与广告账户一屏统管,利润与 ACOS 分市场核算读 welcome/page.tsx CASES[0]生效
AC-EL-AUTH-047场景卡 2「品牌大卖」卡片CASES 卡:中文实题「品牌大卖」(welcome:34;英文卡 title「品牌组合卖家」系回译对照)描述=多品牌管理,品牌级利润报表与广告预算矩阵分配读 welcome/page.tsx CASES[1]生效
AC-EL-AUTH-048场景卡 3「代运营团队」卡片CASES 卡:代运营团队描述=每客户独立隔离企业工作区,数据完全分离,仅展示各客户授权范围读 welcome/page.tsx CASES[2]生效
AC-EL-AUTH-049安全卡 1「独立企业身份」卡片SECURITY 卡:企业隔离描述=每公司独立企业 ID+子域,行级访问隔离,对其他企业不可见;与铁律「企业绝对独立」及 privacy §七 RLS 声明同口径读 welcome/page.tsx SECURITY[0];对照 privacy §七生效
AC-EL-AUTH-050安全卡 2「官方 API 授权接入」卡片SECURITY 卡:官方授权描述=仅经官方 Amazon SP-API/Ads API,卖家 LWA OAuth 授权后拉数;与 privacy §四同口径读 welcome/page.tsx SECURITY[1]生效
AC-EL-AUTH-051安全卡 3「授权可随时撤销」卡片SECURITY 卡:撤销即停描述=卖家在亚马逊后台撤销授权后自动停止拉新数据;与 privacy §四「授权撤销」条同口径读 welcome/page.tsx SECURITY[2]生效
AC-EL-AUTH-052安全卡 4「数据删除流程」卡片SECURITY 卡:删除流程描述=清晰的删除流程(取消/撤销后可请求数据移除);与 privacy §四「30 天内完成删除」同口径读 welcome/page.tsx SECURITY[3]生效
AC-EL-AUTH-053安全卡 5「令牌加密存储」卡片SECURITY 卡:令牌加密描述=授权令牌静态加密+严格访问控制,全站 TLS;与 privacy §二「AES-GCM 信封加密」、§七「传输加密」同口径读 welcome/page.tsx SECURITY[4]生效
AC-EL-AUTH-054安全卡 6「每日备份」卡片SECURITY 卡:每日备份描述=每日备份+异常访问/操作全审计轨迹;与 privacy §七「数据库每日备份」同口径读 welcome/page.tsx SECURITY[5]生效
AC-EL-AUTH-055welcome 页脚脚注© 2026 ZIPFORCE + 隐私政策/服务条款链接链接 → /privacy、/terms;版权年份硬编码 2026读 welcome/page.tsx footer 段生效

§11.24 跳转页 + 帮助页 + 法务页(AC-EL-REDIR /promotion /upload · AC-EL-HLP /en /training · AC-EL-LEGAL /privacy /terms /feishu,源码 web/app/ 下 7 文件共 603 行 + api/routers/ops.py + collab.py)

AC-EL-REDIR 跳转/薄壳路由

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-REDIR-001/promotion 路由壳结构AppShell 壳页:title「站内促销」,crumb「平台促销 · noon deals/coupons · Amazon promotions(即将)」薄壳路由,自身无业务逻辑,内容整体委托 NoonPromoTab;crumb 声明 Amazon promotions 为「即将」(未上线能力,边界明确)读 promotion/page.tsx(12 行全文)生效
AC-EL-REDIR-002NoonPromoTab 承载组件/promotion 唯一内容区=子组件 NoonPromoTab(站内促销 deals/coupons 面)本组只立壳层条目;NoonPromoTab 内部逐元素(表格/筛选/操作)未在本组展开,属促销组件另册待后续批次录入读 promotion/page.tsx import;ls web/app/promotion/ 看子组件文件待深化
AC-EL-REDIR-003/upload 308 重定向重定向访问 /upload 永久重定向到 /listingsredirect("/listings")(next/navigation);代码注释载明缘由:2026-09-15 页面合并,上传(文件+A+)并入 /listings;旧链接/书签兼容通道读 upload/page.tsx(6 行全文);curl -sI /upload 看 308 Location生效

AC-EL-HLP 帮助/营销页(/en /training)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-HLP-001/en metadata(SEO)元数据英文营销页 SEO 元数据组title「Amazon Seller Analytics — Official SP-API / Ads API Integration」;canonical /en;alternates:en /en、zh-CN /、x-default /;openGraph locale en_US、type website(与 welcome 页 zh_CN 互为 hreflang 对,canonical 各自独立不互指)读 en/page.tsx metadata 段;view-source /en 验 hreflang生效
AC-EL-HLP-002/en header 导航导航顶栏:Features(#features)/ Data security(#security)/ 中文(→/)/ Start free(→/register,RegGate 包裹)closedText=「Registration closed」(导航短版);语言切换双向(中文页 EN ↔ 英文页 中文)读 en/page.tsx header 段生效
AC-EL-HLP-003/en hero 徽章文本「Amazon store + ads analytics in one platform · SaaS」静态;welcome 页中文徽章的英文对应读 en/page.tsx hero 段生效
AC-EL-HLP-004/en hero 主标题文本h1 含高亮短语「let AI tell you if your ads actually pay off」(紫色强调)静态;中文页 h1 的英文对应;高亮为内联样式不拆组件读 en/page.tsx h1 段生效
AC-EL-HLP-005/en hero 段落文本卖家授权数据说明段(orders, inventory, settlements, ad campaigns, ACOS, AI diagnostics, isolated tenant)静态能力总述;与中文页 hero 副文口径一致(官方 API+授权+企业隔离)读 en/page.tsx hero p 段生效
AC-EL-HLP-006/en 主 CTA「Start free — 14-day full trial」交互主按钮 → /register,外包 RegGateclosedText=「Registration is currently closed — contact support@zipforcehub.com」(英文长版);「14-day full trial」口径同中文页/terms §二读 en/page.tsx CTA 段生效
AC-EL-HLP-007/en 已有账号提示文本「Have an account? Visit yourcompany.zipforcehub.com」子域格式示例与 {slug}.zipforcehub.com 同构;静态读 en/page.tsx hint 段生效
AC-EL-HLP-008功能卡 1「Ad Campaign Analysis」卡片FEATURES 英文卡:广告活动分析描述=campaign 级 impressions/clicks/spend/sales/ACOS 趋势+分国分品牌健康分;中文对应 AC-EL-AUTH-040读 en/page.tsx FEATURES[0]生效
AC-EL-HLP-009功能卡 2「SP Store Data」卡片FEATURES 英文卡:SP 店铺数据描述=订单明细/FBA 库存健康/月度结算,官方 SP-API;中文对应 041读 en/page.tsx FEATURES[1]生效
AC-EL-HLP-010功能卡 3「AI Ad Insights」卡片FEATURES 英文卡:AI 广告洞察描述=基于真实业绩的 AI 诊断+预算/定向建议;中文对应 042读 en/page.tsx FEATURES[2]生效
AC-EL-HLP-011功能卡 4「Profit Reports」卡片FEATURES 英文卡:利润报表描述=每 SKU 每月收入/费用/回款/净利,跨市场统一 USD;中文对应 043读 en/page.tsx FEATURES[3]生效
AC-EL-HLP-012功能卡 5「Ad Alerts」卡片FEATURES 英文卡:广告告警描述=高 ACOS/零销售/低 CTR 自动告警+每日优化清单;中文对应 044读 en/page.tsx FEATURES[4]生效
AC-EL-HLP-013功能卡 6「Listing Analysis」卡片FEATURES 英文卡:Listing 分析描述=标题/五点/关键词覆盖/变更追踪;中文对应 045读 en/page.tsx FEATURES[5]生效
AC-EL-HLP-014场景卡 1「Multi-marketplace sellers」卡片CASES 英文卡:多站点卖家描述=NA/EU/JP 一屏统管,利润与 ACOS 分市场核算;中文对应 046读 en/page.tsx CASES[0]生效
AC-EL-HLP-015场景卡 2「Brand portfolio sellers」卡片CASES 英文卡:品牌组合卖家描述=多品牌利润报表+广告预算矩阵;中文对应 047读 en/page.tsx CASES[1]生效
AC-EL-HLP-016场景卡 3「Agency teams」卡片CASES 英文卡:代运营团队描述=每客户独立隔离企业工作区;中文对应 048读 en/page.tsx CASES[2]生效
AC-EL-HLP-017安全卡 1「Isolated tenant identity」卡片SECURITY 英文卡:企业隔离描述=独立企业 ID+子域+行级隔离;中文对应 049读 en/page.tsx SECURITY[0]生效
AC-EL-HLP-018安全卡 2「Official API authorization」卡片SECURITY 英文卡:官方授权描述=仅官方 SP-API/Ads API,LWA OAuth 后拉数;中文对应 050读 en/page.tsx SECURITY[1]生效
AC-EL-HLP-019安全卡 3「Revoke anytime」卡片SECURITY 英文卡:撤销即停描述=撤销授权自动停拉新数据;中文对应 051读 en/page.tsx SECURITY[2]生效
AC-EL-HLP-020安全卡 4「Data deletion process」卡片SECURITY 英文卡:删除流程描述=取消/撤销后可请求删除;中文对应 052读 en/page.tsx SECURITY[3]生效
AC-EL-HLP-021安全卡 5「Encrypted token storage」卡片SECURITY 英文卡:令牌加密描述=令牌静态加密+严格访问控制+全站 TLS;中文对应 053读 en/page.tsx SECURITY[4]生效
AC-EL-HLP-022安全卡 6「Daily backups」卡片SECURITY 英文卡:每日备份描述=每日备份+异常访问审计轨迹;中文对应 054读 en/page.tsx SECURITY[5]生效
AC-EL-HLP-023/en 页脚脚注© 2026 ZIPFORCE · zipforcehub.com · 定位语 + Privacy/Terms 链接链接 → /privacy、/terms;含英文长定位句(seller-authorized data…solely for each seller's own analysis)读 en/page.tsx footer 段生效
AC-EL-HLP-024/training 路由壳结构AppShell 壳页:title「培训」,crumb「运营培训中心 · 内部培训资料({体量})」crumb 内嵌体量数字来自接口(见 026),非硬编码;页面 2026-09-06 内部培训站整体搬运而来、2026-09-17 UVPVP 内容按用户指定「复制内容不是挂链接」入站读 training/page.tsx 壳段与头注释生效
AC-EL-HLP-025KPI「培训模块」KPI值=SECTIONS.length=10前端常量数组长度(十模块:amazon/noon/ai-design/gpt-image2/seedance2/nano-views/brainews-ui/listings/projects/scripts);foot「Amazon / Noon / AI 工具链 / 项目实战」读 training/page.tsx SECTIONS 数组+KPI 段;数组成员数应=10生效
AC-EL-HLP-026KPI「内容体量」+ stats 接口KPI显示「{mb} MB」;foot「{files} 个文件 · PPT / HTML 教程 / 设计切图 / 视频」UI-01(2026-10-14):体量真值来自 GET /api/training/stats(后端 ops.py:40,api 侧 du /srv/training 实测),不硬编码;接口失败/挂载缺失降级显示「—」与静态 foot 文案,不显示编造数字读 training/page.tsx stats useEffect 段;grep -n "training/stats" api/routers/ops.py;curl 接口比对 mb/files生效
AC-EL-HLP-027KPI「主推课程」KPI值「Amazon 全攻略」,foot「运营 + 广告深耕 + 广告 SOP + 核心词汇」静态文案;指向 amazon 模块聚合读 training/page.tsx 主推课程 KPI 段生效
AC-EL-HLP-028课程卡 1「Amazon 运营」卡片SECTIONS 卡:amazon 目录desc「运营全攻略 PPT / 广告深耕 / 广告 SOP / 核心词汇」;tone=ok;链接 /training/amazon/ 新窗直出静态内容读 training/page.tsx SECTIONS[0]生效
AC-EL-HLP-029课程卡 2「Noon 运营」卡片SECTIONS 卡:noon 目录desc「Noon 平台运营全攻略 / 平台培训 PPT」;tone=warn;链接 /training/noon/读 training/page.tsx SECTIONS[1]生效
AC-EL-HLP-030课程卡 3「AI 设计工具」卡片SECTIONS 卡:ai-design 目录desc「AI 设计工作流与工具指引」;tone=ok;链接 /training/ai-design/读 training/page.tsx SECTIONS[2]生效
AC-EL-HLP-031课程卡 4「GPT-Image 生图」卡片SECTIONS 卡:gpt-image2 目录desc「文生图提示词与出图案例」;tone=ok;链接 /training/gpt-image2/读 training/page.tsx SECTIONS[3]生效
AC-EL-HLP-032课程卡 5「Seedance 视频」卡片SECTIONS 卡:seedance2 目录desc「AI 视频生成脚本与成品」;tone=ok;链接 /training/seedance2/读 training/page.tsx SECTIONS[4]生效
AC-EL-HLP-033课程卡 6「NANO 外观图库」卡片SECTIONS 卡:nano-views 目录desc「BraiNews NANO 设备三视图 / 尺寸图」;tone=dim;链接 /training/nano-views/读 training/page.tsx SECTIONS[5]生效
AC-EL-HLP-034课程卡 7「BraiNews UI 规格」卡片SECTIONS 卡:brainews-ui 目录desc「NANO 18 页设计规格与全套 UI 切图(89MB)」;tone=dim;链接 /training/brainews-ui/;89MB 为静态声明值读 training/page.tsx SECTIONS[6]生效
AC-EL-HLP-035课程卡 8「Listing 模板副本」卡片SECTIONS 卡:listings 目录desc「A+ 模板本地副本(主库见 Listing 入口)」;tone=dim;边界=副本非主库,主入口在 /listings读 training/page.tsx SECTIONS[7]生效
AC-EL-HLP-036课程卡 9「项目实战」卡片SECTIONS 卡:projects 目录desc「视频 / 图文项目工作区」;tone=dim;链接 /training/projects/读 training/page.tsx SECTIONS[8]生效
AC-EL-HLP-037课程卡 10「辅助脚本」卡片SECTIONS 卡:scripts 目录desc「幻灯片排序等整理脚本」;tone=dim;链接 /training/scripts/读 training/page.tsx SECTIONS[9]生效
AC-EL-HLP-038UVPVP 卡 1「核心词汇」卡片UVPVP_SECTIONS 卡:vocabdesc「运营核心词汇表(ACOS/BSR/冗语等术语速查)」;tone=warn;链接 /training/uvpvp/vocab.html(静态直出,无 UVPVP 账号依赖)读 training/page.tsx UVPVP_SECTIONS[0]生效
AC-EL-HLP-039UVPVP 卡 2「运营 SOP」卡片UVPVP_SECTIONS 卡:sopdesc「标准作业流程(Listing 上架 / 广告 / 客服)」;tone=warn;链接 /training/uvpvp/sop.html读 training/page.tsx UVPVP_SECTIONS[1]生效
AC-EL-HLP-040UVPVP 卡 3「Listing 教程」卡片UVPVP_SECTIONS 卡:listingdesc「Listing 编写教程(标题/五点/A+ 要领)」;tone=warn;链接 /training/uvpvp/listing.html读 training/page.tsx UVPVP_SECTIONS[2]生效
AC-EL-HLP-041UVPVP 卡 4「Listing 设计规范」卡片UVPVP_SECTIONS 卡:listing-designdesc「设计规范 + 13 个真实案例图解」;tone=warn;链接 /training/uvpvp/listing-design.html;源=旧版 /opt/uvpvp templates+static/cases 去 Jinja 本地化读 training/page.tsx UVPVP_SECTIONS[3] 与头注释生效
AC-EL-HLP-042培训页脚说明脚注「数据源:内部培训站整体搬运(2026-09-06)。新员工入职路径:Amazon 运营 → 广告深耕 → Noon 运营 → AI 设计工具 → 项目实战;PPT 可直接下载。」静态说明;载明搬运时间与推荐学习顺序读 training/page.tsx 页脚段生效

AC-EL-LEGAL 法务页(/privacy /terms /feishu)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-LEGAL-001/privacy metadata元数据title「隐私政策」+ description(收集哪些数据/如何使用保护/AI 处理/子处理方/权利)静态 SEO 元数据;description 为十三节内容摘要句读 privacy/page.tsx metadata 段生效
AC-EL-LEGAL-002/privacy header导航顶栏 logo + 「首页」(→/)「服务条款」(→/terms)静态互链;无登录态元素读 privacy/page.tsx header 段生效
AC-EL-LEGAL-003/privacy 标题与生效日期文本h1「隐私政策」;生效日期「2026 年 10 月 14 日(补充运营主体与存储地域)」生效日期为政策版本锚点;括注载明该版变更性质读 privacy/page.tsx 日期段生效
AC-EL-LEGAL-004§一 运营主体与适用范围区块适用 zipforcehub.com 及企业子域;运营主体深圳优艾谱科技有限公司;联系 support@zipforcehub.com三要素:适用范围(主域+企业子域)/主体名称/联系渠道;主体名与 terms §一同一口径读 privacy/page.tsx §一;对照 terms §一生效
AC-EL-LEGAL-005§二 我们收集的信息区块五类:账号信息(密码仅存不可逆散列)/店铺授权凭证(AES-GCM 信封加密)/业务数据/上传文件/日志信息(IP+时间戳+审计)密码处理口径=仅散列不存明文(与 AC-EL-AUTH-007 呼应,本条同样只述规则不涉任何密码值);凭证加密算法明示 AES-GCM读 privacy/page.tsx §二五条生效
AC-EL-LEGAL-006§三 AI 功能的数据处理区块AI 助手(数据问答/选品/文案/广告优化)将必要数据片段发第三方大模型 API;不用于训练(以当时 API 条款为准);可不用 AI,核心面板不依赖边界三条:发送范围最小必要/训练用途排除/可选性;与 terms §四「AI 处理方式见隐私政策第三节」互引读 privacy/page.tsx §三;对照 terms §四第三条生效
AC-EL-LEGAL-007§四 Amazon 平台数据区块四条:仅 SP-API/Ads API + LWA OAuth 后获取;仅用于向你提供分析服务不外流;授权撤销自动停拉(已入库数据按 §八处理);删除请求 30 天内完成与 welcome/en 安全卡 2/3/4(AC-EL-AUTH-050~052、HLP-018~020)营销口径同源;30 天删除时限与 §八注销口径一致读 privacy/page.tsx §四四条;对照 §八生效
AC-EL-LEGAL-008§五 使用目的区块四条:服务运维/交易验证与通知(阿里云企业邮箱)/安全保障(限流+审计+企业隔离校验);不投广告不出售数据「不投广告不出售」与 terms §四第二条同口径读 privacy/page.tsx §五生效
AC-EL-LEGAL-009§六 子处理方区块清单:云服务器与数据库托管/Stripe(订阅支付)/第三方大模型 API(仅 AI)/阿里云企业邮箱(事务邮件)/Amazon·Noon 平台 API(数据来源方)+ 签数据处理协议声明子处理方封闭清单,页面枚举即全量口径;新增须改本节(政策更新机制 §十二)读 privacy/page.tsx §六生效
AC-EL-LEGAL-010§七 存储与安全区块四条:全站强制 HTTPS(TLS)/敏感凭证静态加密+数据库每日备份/企业隔离=独立子域+独立数据模式+RLS 行级安全+品牌级数据范围/存储地域美国加州圣何塞RLS+品牌级范围=铁律「企业/品牌绝对独立」的法务表述;每日备份与 VERSION 登记 crontab 实操对应读 privacy/page.tsx §七;对照 VERSION 备份登记生效
AC-EL-LEGAL-011§八 数据保留区块业务数据账号存续期内保留;注销后 30 天内删除或匿名化(法定保留除外)30 天窗口与 §四删除时限、terms §八导出窗口三处同口径读 privacy/page.tsx §八生效
AC-EL-LEGAL-012§九 你的权利区块访问/更正/导出(产品内导出入口,未覆盖部分人工处理);删除与注销;经 support@zipforcehub.com 行使导出入口边界如实声明「暂未覆盖的部分可联系我们」读 privacy/page.tsx §九生效
AC-EL-LEGAL-013§十 Cookie区块仅必要会话 Cookie(HttpOnly、Secure、SameSite=Lax),无跟踪类 Cookie,无第三方统计脚本三属性与 auth.py:127 登录 Cookie 实参(httponly/secure/samesite=lax)跨层一致读 privacy/page.tsx §十;对照 auth.py:127生效
AC-EL-LEGAL-014§十一 跨境传输区块数据可能在中国境外处理(指回 §五/§六),采取措施保障传输安全合规与 §七存储地域(美国圣何塞)事实对应读 privacy/page.tsx §十一生效
AC-EL-LEGAL-015§十二 政策更新区块更新在本页公布并更新生效日期;重大变更站内或邮件通知更新机制=页面公布+日期锚点(见 003)读 privacy/page.tsx §十二生效
AC-EL-LEGAL-016§十三 联系我们区块疑问联系 support@zipforcehub.com单一联系渠道,与 §一/§四/§九同址读 privacy/page.tsx §十三生效
AC-EL-LEGAL-017/privacy 页脚脚注© 2026 ZIPFORCE + 服务条款(/terms)+ zipforcehub.com(/)链接静态;与 header 互链闭环读 privacy/page.tsx footer 段生效
AC-EL-LEGAL-018/terms metadata元数据title「服务条款」+ description(服务内容/试用订阅/数据所有权/公平使用/终止/责任限制)静态 SEO 元数据读 terms/page.tsx metadata 段生效
AC-EL-LEGAL-019/terms header导航顶栏 logo + 「首页」(→/)「隐私政策」(→/privacy)静态互链;与 privacy header 镜像对称读 terms/page.tsx header 段生效
AC-EL-LEGAL-020/terms 标题与生效日期文本h1「服务条款」;生效日期「2026 年 10 月 14 日(补充运营主体与法律适用条款)」与 privacy 同日版本(2026-10-14 双政策同步更新)读 terms/page.tsx 日期段生效
AC-EL-LEGAL-021§一 服务描述区块面向跨境电商(以 Amazon 卖家为主)的多企业数据分析与 AI 工作台 SaaS;每公司独立子域+物理隔离数据空间;运营主体深圳优艾谱科技有限公司「物理隔离」为条款级声明(实现层=独立 schema+RLS,见 privacy §七);主体名与 privacy §一同口径读 terms/page.tsx §一生效
AC-EL-LEGAL-022§二 试用与订阅区块14 天全功能试用无需绑卡;Starter $49/月(单品牌,AI 50 次/天)、Growth $199/月(多品牌母账号,AI 200 次/天)、Enterprise $499/月(白标/BYOK/专属支持,AI 500 次/天);Stripe 按月续费,随时取消至当期止,当期不退;调价提前通知仅对后续周期生效「14 天」与注册/登录/营销页四处同口径;AI 配额三档已对上(core.py:262 PLAN_AI_QUOTA starter 50/growth 200/enterprise 500);2026-10-22 校对实证价格分歧:条款页 Growth $149(terms/page.tsx:20)vs 计费源 growth=199(billing.py:44),且条款页 Enterprise「定制」无价 vs billing.py:47 price=499。2026-10-22 用户拍板以 billing.py 为准:条款页已改 Growth $199/月、Enterprise $499/月(terms/page.tsx:20),web 重建上线(47/47 页编译),线上 /terms 核验两侧一致,frontend_e2e 门禁 ALL PASS(日志 _gate_terms_price_20261022_frontend_e2e.log),待核转生效读 terms/page.tsx §二;billing.py:44/47 对账;复检两侧一致(2026-10-22 已通过)生效
AC-EL-LEGAL-023§三 账号与安全义务区块注册信息真实准确;妥善保管凭证不共享;对上传/接入数据有合法权利用户侧义务三条;无系统实现对应项(纯条款)读 terms/page.tsx §三生效
AC-EL-LEGAL-024§四 数据所有权区块业务数据归用户;授予平台必需处理许可;不出售不投广告;终止后有导出窗口(见 §八)与 privacy §五「不投广告不出售」同口径;导出窗口 30 天见 §八读 terms/page.tsx §四生效
AC-EL-LEGAL-025§五 AI 输出免责区块AI 生成内容按「现状」提供仅供参考,不构成财务/经营/投资建议,决策前自行核实免责边界单条;覆盖分析/建议/文案全部 AI 输出读 terms/page.tsx §五生效
AC-EL-LEGAL-026§六 公平使用区块AI 配额按套餐执行以产品内展示为准;禁止逆向工程/爬取/未授权压测/转售/规避企业隔离与权限控制;违规可暂停终止「规避企业隔离」明列禁止项=铁律的条款化表述读 terms/page.tsx §六生效
AC-EL-LEGAL-027§七 服务变更与维护区块功能持续更新;计划内维护提前通知,突发故障以官网公告为准;不可抗力与第三方平台(Amazon/Noon/支付/邮件)故障免责但尽力减损第三方依赖清单与 privacy §六子处理方口径相容读 terms/page.tsx §七生效
AC-EL-LEGAL-028§八 终止区块可随时注销终止;注销后 30 天数据导出窗口,逾期按隐私政策删除或匿名化;严重违规可暂停终止并通知30 天导出窗口与 privacy §八 30 天删除窗口衔接同口径读 terms/page.tsx §八;对照 privacy §八生效
AC-EL-LEGAL-029§九 责任限制区块适用法律允许范围内:间接损失/利润损失/数据损失(含平台数据同步缺失)不担责;累计责任上限=终止前 12 个月实付订阅费责任上限公式=「终止前 12 个月内实际支付订阅费」读 terms/page.tsx §九生效
AC-EL-LEGAL-030§十 法律适用与争议解决区块中华人民共和国法律管辖;先协商,不成则本公司住所地(广东省深圳市)有管辖权法院诉讼管辖锚点=公司住所地深圳;与 §一运营主体对应读 terms/page.tsx §十生效
AC-EL-LEGAL-031§十一 通知与变更区块通知经站内公告/注册邮箱/本页发出;重大变更提前公告,继续使用视为接受,不同意应停止使用并注销变更接受机制=继续使用推定接受读 terms/page.tsx §十一生效
AC-EL-LEGAL-032/terms 页脚脚注© 2026 ZIPFORCE + 隐私政策(/privacy)+ zipforcehub.com(/)链接静态;与 header 互链闭环读 terms/page.tsx footer 段生效
AC-EL-LEGAL-033/feishu 路由壳结构AppShell 壳页:title「飞书」,crumb「飞书资产导航 · 云盘根目录直达(深度集成待企业凭据)」crumb 即边界声明:当前能力=导航直达,深度集成待企业 BYOK 凭据读 feishu/page.tsx 壳段生效
AC-EL-LEGAL-034文档树接口 GET /api/documents/treeAPI页面加载拉取云盘树:响应 {mode, items[], kpi{total,files,roots}}后端 collab.py:75;items 节点含 path/name/type/url/children;失败静默(catch 空处理,kpi=null → int(undefined) 显「—」而非 0(fmt.ts:19-20)、列表显示加载中)grep -n "documents/tree" api/routers/collab.py;读 feishu/page.tsx useEffect 段生效
AC-EL-LEGAL-035KPI「云盘根目录」KPI值=kpi.roots(int 格式化)来源=documents/tree 响应;foot「品牌 / 部门分区直达」;接口失败显「—」非 0(见 034 降级边界)读 feishu/page.tsx 根目录 KPI 段生效
AC-EL-LEGAL-036KPI「镜像文档链接」KPI值=kpi.files(int 格式化)来源同上;foot「文档中心内可搜索浏览」指向文档中心能力读 feishu/page.tsx 镜像 KPI 段生效
AC-EL-LEGAL-037KPI「API 集成」KPI值固定文案「P2 · BYOK」,foot「企业自建应用授权后开放」静态状态卡非数值;P2=优先级档,BYOK=企业自持密钥模式读 feishu/page.tsx API 集成 KPI 段生效
AC-EL-LEGAL-038云盘根目录卡片网格卡片每个 folder 型且有 url 的根节点一张卡:「📁 {name}」+「{children} 个子项」+「打开 ↗」新窗跳飞书过滤条件=type==="folder" && url 非空;权限跟随飞书账号(本平台不代持);空数组显示「加载中…」(见 039)读 feishu/page.tsx 卡片网格段生效
AC-EL-LEGAL-039云盘列表空态状态roots 为空时显示「加载中…」加载中与加载失败共用此态(catch 静默不清错)——边界:失败也永远显示「加载中…」,无失败专属提示读 feishu/page.tsx 空态段;断网访问复现生效
AC-EL-LEGAL-040集成路线表表格四行三列(能力/说明/状态):云盘目录导航=可用(已上线);文档树镜像日更=待凭据;报表定时推送=P2;审批/请假联动=P2状态徽章 ok/dim 区分已上线与未上线;「代码已预留」为副标题声明读 feishu/page.tsx 集成路线表段生效
AC-EL-LEGAL-041开通方式说明脚注「企业在飞书开放平台自建应用(云盘只读+消息推送权限)后,在计费页提交 App ID/Secret(BYOK,平台不代持密钥)」BYOK 边界明示:平台不代持密钥;提交入口=计费页读 feishu/page.tsx 说明段生效

§11.25 AppShell 导航壳(全局壳 · AC-EL-SHELL,源码 web/components/AppShell.tsx 291 行 + web/app/layout.tsx + web/components/BrandContext.tsx;2026-10-22 批次二实证转档,三位编号)

全壳通用:品牌名单单源=/api/tenant/info(user_brands ?? brands),顶栏切换器、导航、AI 面板、自定义模块一律经 useBrand() 消费,禁散写品牌名单(H9 2026-10-13 已清);品牌拆开铁律贯穿——brand=""(全部聚合)仅显式点击「全部」时生效,多品牌账号默认落在自己的品牌;模块购买门控 require_module 前后端一致;页面主组件在 AppShell 父级,brand 状态走模块级 store 非 context。组件级联:BrandProvider>AIProvider>页面,KitProvider 在根布局(2026-09-17 上移)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-SHELL-001品牌切换器(顶栏右)全局控件顶栏右侧品牌切换按钮组:「全部」(brand="")+ 逐品牌按钮,每按钮带 branddot 色点(background=brandColor(b))名单单源=useBrand().brands(info.user_brands ?? info.brands);brands.length<2 时整组不渲染(return null);色点=brand_colors 注册表(D类 2026-10-08 级联);选择持久化 localStorage zf:brand:<slug>;「全部」聚合仅显式点击生效(铁律)源码 AppShell.tsx TopBarRight;单品牌企业顶栏无切换器;多品牌切换后刷新记忆保持生效
AC-EL-SHELL-002brandReady 初始化门门控AppShell 的 children 仅在品牌 store 完成初始化(useBrandReady()===true)后挂载防品牌拆开铁律违例——初始化前以 brand=""(全部聚合)打出首渲染请求;源码两处注释明示;BrandContext 渲染期同步初始化(先于子组件首渲染,消灭竞态)源码 AppShell.tsx brandReady 门 + BrandContext.tsx:59-74;首屏网络面板无 brand="" 聚合请求生效
AC-EL-SHELL-003通知铃铛·轮询全局控件顶栏运营通知铃铛,GET /api/notifications/summary,5 分钟 setInterval 轮询仅 document.visibilityState==="visible" 时拉取(后台标签页暂停);NotifSummary 字段=inv_urgent/inv_watch/settle_abnormal/po_aging/pipe_stale/vol_drop/rank_abnormal?;summary 为 null 时铃铛整个隐藏源码 NotificationBell;network 面板见 5min 周期请求;切后台标签暂停生效
AC-EL-SHELL-004铃铛徽章状态铃铛右上角待处理计数徽章,danger 底色总数=inv_urgent+settle_abnormal+po_aging+pipe_stale+vol_drop+rank_abnormal(不含 inv_watch 观察级);≥100 封顶显示「99+」;总数 0 不显示徽章源码 badge 渲染;构造告警计数核对封顶与 0 隐藏生效
AC-EL-SHELL-005下拉告警 6 项导航点铃铛展开下拉,固定 6 项运营告警,每项含文案/计数/跳转/tone①库存紧急补货(→/inventory,bad,extra「另有 N 个观察级」=inv_watch)②回款异常(>14 天)(→/settlement?filter=abnormal,bad)③PO 滞留(>7 天未推进)(→/po,warn)④数据管道断更(>2 天)(→/pipeline,bad,extra「采集侧断流,看板口径可能缺数」)⑤数量骤降(vs 7日均值)(→/pipeline,bad,extra「采集在跑但量级掉崖」)⑥排名市场异常(塌缩/停更)(→/rankings,bad);n=0 项仍渲染计数 0源码 6 项数组逐字比对;逐项点击跳转路由核对生效
AC-EL-SHELL-006下拉头部/遮罩/刷新文案反馈下拉头部「运营通知 · N 项待处理」或「一切正常」;底部「每 5 分钟自动刷新」fixed 全屏遮罩 zIndex 39 点击关闭下拉;header N=徽章同口径总数源码 header/footer/overlay;点遮罩关闭生效
AC-EL-SHELL-007NAV_GROUPS 导航总纲(7 组)导航侧栏导航 7 组:工作台〔/、/today〕经营分析〔/finance·mod:finance、/ads·mod:ads、/sourcing·mod:sourcing、/rankings〕业务管理〔/products、/orders·mod:orders、/inventory·mod:inventory、/po·mod:inventory、/settlement·mod:finance、/logistics·mod:logistics、/promotion·mod:ads、/offsitepromotion·mod:ads、/projects·mod:collab、/listing·mod:listing〕渠道〔/noon·mod:finance〕数据〔/mapping、/pipeline、/backfill·adminOnly、/dictionary、/database·adminOnly、/onboarding·adminOnly〕协作〔/documents·mod:collab、/training·mod:collab、/feishu·mod:collab、/ai·mod:ai〕账户〔/team、/account、/billing、/settings·adminOnly〕mod=模块购买门控键;adminOnly=角色过滤;菜单项与路由一一对应,禁散写源码 NAV_GROUPS 常量逐项比对侧栏 UI生效
AC-EL-SHELL-008navState 三态门控门控每个菜单项按 (mod) 渲染三态:ok 正常 / unpurchased 未购 / forbidden 未授权!mod→ok;info.modules 不含 mod→unpurchased(Link→/billing?mod=<mod> + 🔒「开通」标签);user_modules!==null 且不含→forbidden(span.nav-lock 灰字「未授权,请联系管理员开通」,不可点);与后端 require_module 门一致未购模块账号见 🔒 开通跳账单页;无权限子账号见灰字锁生效
AC-EL-SHELL-009adminOnly 角色过滤门控backfill/database/onboarding/settings 四项仅 role==="owner"||"admin" 可见渲染层直接滤除(非灰显);名单与 NAV_GROUPS 标注一一对应member 角色登录侧栏无此四项;owner 全显生效
AC-EL-SHELL-010企业信息加载三态状态AppShell 挂载先 GET /api/tenant/info:ok→渲染壳;401 noauth→router.replace("/login");notenant→「未知的企业域名」卡片;等待期 loading 态info=BrandContext.TenantInfo(slug/name/plan/modules/brands/user_brands/brand_colors/brand_labels/noon_brands/user{id,role,name,job_label}/user_modules)源码三态分支;错误域名头访问复现 notenant 卡生效
AC-EL-SHELL-011侧栏品牌区与页脚导航侧栏顶部 logo「Z ZIPFORCE」;页脚 side-foot:企业名、用户名+slug、job_label/role、plan chip、退出登录退出登录 POST /api/auth/logout 成功后跳 /login;plan chip=info.plan;用户字段=/api/tenant/info user 对象源码 side-foot;点退出验证登出与跳转生效
AC-EL-SHELL-012汉堡抽屉(≤768)交互窄屏(≤980px 断点,globals.css:232 @media(max-width:980px)——非 AC-UI-04 的 768 首页溢出标准)顶栏汉堡按钮(aria-label「打开导航」)开抽屉导航 + drawer-mask 遮罩(globals.css:291)pathname 变化自动关闭抽屉(AppShell.tsx:186)980/981 视口分侧实测开合;路由跳转后抽屉自闭生效
AC-EL-SHELL-013顶栏标题与面包屑标题顶栏 h1=AppShell props.title;crumb=props.crumb 面包屑逐元素渲染title/crumb 由各页包裹 AppShell 时传入,壳不硬编码;面包屑与路由层级一致源码 h1/crumb 渲染;任意页核对与路由一致生效
AC-EL-SHELL-014顶栏右侧 6px 缓冲样式顶栏右容器 paddingRight:6,为铃铛徽章 absolute right:-5 悬挂留缓冲2026-10-01 像素审计 P3 缺陷㊳修复——徽章悬挂致横向溢出(fittingirls 实测 scrollWidth 395),留 6px 后 body 不横向滚动源码注释+实测 document.scrollWidth==clientWidth生效
AC-EL-SHELL-015全局 Provider 包裹与 AI 挂载ProviderAppShell 将页面内容包 BrandProvider>AIProvider,尾部全局挂 <AIChat/>;KitProvider(Toast/Confirm/Prompt 宿主)在 app/layout.tsx 根布局挂载页面主组件是 AppShell 的父级,brand 走模块级 store 而非 Provider context(2026-09-09 修复:context 只能向下传播致品牌切换对全部页面不生效);KitProvider 2026-09-17 上移根布局源码 AppShell.tsx:231-289 + layout.tsx:19生效
AC-EL-SHELL-016图标体系 Icon静态导航/按钮图标=内联 SVG path 映射,共 29 键:grid/clock/shield/trophy/box/receipt/megaphone/coins/wallet/layers/globe/sparkles/search/truck/share/key/flow/board/doc/tag/book/up/seed/chip/msg/users/lock/db/history零第三方图标依赖,全部内联 path源码 Icon path map;页面无外部图标资源请求生效

§11.26 共享组件(web/components/ ×19 · AC-EL-CMP,源码逐文件实证;2026-10-22 批次二转档;已录组件只立引用行不重复展开,AppShell 见 §11.25)

全组件通用:图表 spec 驱动(/api/dashboard/charts 等 API 下发 {key,title,hint,kind,x,series});数据缺失须可视化兜底(EMPTY_OPT「暂无数据」,禁裸空轴,P3 ⑰);空态显示「暂无数据/该筛选下无数据(不显示误导性 0)」不隐藏结构;导出文件名 zf_<scope>_<YYYYMMDD> 统一;弹层复用 globals.css .pm-ov/.pm-modal/.pm-toast;所有组件零第三方 UI 依赖(echarts 除外)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-CMP-001KpiDeck(引用行)引用工作台唯一 KPI 区:2 行×5 卡、右上 ▾ 换指标、ⓘ 口径说明已录 §11.1 AC-EL-HOME-10..14;2026-10-22 口径文案×5 对齐 AC-CAL-02(订单/客单价/CPS/取消率/脚注②)并部署(镜像 31f9b5812522)见 §11.1;线上 ⓘ 展开逐字核对生效
AC-EL-CMP-002SkuMasterTable(引用行)引用SKU 主表(全量列与口径)已录 §11.3 AC-EL-SKU(2026-10-12 三卡合并拍板:Top15×2+SKU销量明细+四维矩阵→一张全量表)见 §11.3生效
AC-EL-CMP-003AdsAdvice(引用行)引用广告建议组件(R24 算法/预算护栏/EXECUTE_ADS_ACTION 确认串)已录 §11.9 AC-EL-ADS 对应条目(bid 建议三源、九层写护栏、挂账项)见 §11.9生效
AC-EL-CMP-004EChart 渲染容器图表ECharts 封装:div 容器 + init/dispose 生命周期;height 默认 280、width 100%容器尺寸变化(栅格重排/抽屉开合)走 ResizeObserver 100ms 防抖 resize + window.resize 兜底;卸载即 dispose 防泄漏;merge=true 时 setOption notMerge:false + replaceMerge:["series"](保留用户 dataZoom/legend 交互态、序列整体替换),缺省整图重绘;option.dataZoom 渲染后丢失 console.warn(2026-09-28 调试桩);渲染异常 catch 后 warn 不崩页源码 EChart.tsx(52 行);拖动抽屉/缩窗图自适应生效
AC-EL-CMP-005GChart·specToOption 唯一转换图表ChartSpec{key,title,hint,kind,x,series,sub,valueLabels} → ECharts option 的唯一实现kind=line/area/bar/stack/pstack/dual/pie/hbar 八种(2026-10-29 前五种 line/bar/stack/pie/hbar;area=线+0.15 面积;dual=首度量柱左轴其余度量线右轴 yAxisIndex 1 白边圆点;pstack=归一后按 stack "t" 堆叠——归一在 CustomModules 呈现层逐 X 列 ÷列合计×100,不碰查询值);valueLabels=true 柱顶/条尾(hbar right/top)10px 灰数值标签(2026-10-29 自定义分析参数批);色环=fmt.PALETTE 循环取色;pie 只画 value>0 扇区+底部滚动例;hbar=值轴横置+类目 inverse;类目轴 showMaxLabel:true 强制显示最末标签(2026-09-24:抽稀吞掉最后一天「当日进行中」标注);数值轴缩写 ≥1M→x.xM、≥1k→x.xk;barMaxWidth 18、非堆叠圆角 竖柱 [5,5,0,0]/横条 [0,3,3,0];多序列顶部例;亮色图表语言(2026-10-29 与大盘 v2 同批):白底圆角阴影 tooltip 千分位/axisPointer 阴影/渐变柱 barGrad(c+"55")/roundRect 9×9 图例;品牌主看板 ChartCard 复用本转换不另写一份源码 GChart.tsx specToOption;对照 charts API spec 渲染生效
AC-EL-CMP-006GChart·dataZoom 规则交互时间序列图加可拖动 dataZoom(slider+inside),固定维度图不加2026-09-28 用户令——判断=数据点>12 且非 hbar/pie 才加(月度 3 点/星期 7 点不加;周度 14 点/日度 90 点加);slider height 22 bottom 4月度图无 zoom、日度 90 点图有 zoom生效
AC-EL-CMP-007GChart·EMPTY_OPT 空图兜底空态spec 缺失/加载中统一渲染居中灰字「暂无数据」常量 EMPTY_OPTP3 缺陷⑰(2026-10-01)——原裸 {series:[]} 渲染空坐标系无提示,违反「数据缺失须可视化兜底」铁律;BrandBoard/NoonBoard 均引用无数据品牌墙图显示「暂无数据」而非空轴生效
AC-EL-CMP-008GChart·单点线补大圆点图表线图仅 1 个非空数据点时 symbol:"circle" symbolSize:10,≥2 点纯线 symbol:"none"2026-09-29——30 天全局窗下月度图只剩当月一点,symbol:none 画不出线成「有轴无线」伪装空白(e2e 像素扫描当场抓获)窗内单点月度图显示圆点生效
AC-EL-CMP-009ChartCard 图卡本体图卡图卡容器:标题+副题+EChart+右上工具组;data-chart-id=<id>props 契约 id/title/sub/option/height(默认280)/range/onRange/globalLabel/csvName/csv/footer;组件不 fetch,数据过滤在父级(父级用 range 决定该图数据窗口);id=ChartGrid 布局持久化键源码 ChartCard.tsx(145 行)生效
AC-EL-CMP-010ChartCard·日期三态筛选每图独立日期控件三态:global 跟随页面全局窗 / {start,end} 独立区间 / null 未设;📅 展开起止 date 输入,独立区间显示「✕ 清除」跟随态 tab 显示「跟随全局 · <globalLabel>」;start≤max(end)、end≥min(start) 互约束;清除回 global 并收起控件设独立区间图卡重查独立窗数据;清除回全局生效
AC-EL-CMP-011ChartCard·⬇CSV导出右上「⬇ CSV」导出本图数据缺省 extractCsv 从 option 提取(类目 x 轴×各 series);业务可传 csv() 覆盖;文件名 zf_chart_<name>_<YYYYMMDD>.csv(name=csvName||id,非 [\w-] 字符替换 _);含引号/换行字段 RFC 转义+BOM任意图卡导出打开核对行列与图一致生效
AC-EL-CMP-012ChartGrid·拖拽/锁定/重置交互图卡栅格:拖拽排序(指针 Y 找插入点 insertBefore 语义)+「🔓 可拖动/🔒 已锁定」切换 +「↺ 重置」(confirm「恢复默认布局?(你的自定义排序会被清除)」)栅格 auto-fill minmax(min(420px,100%),1fr);锁定态 draggable=false;style prop 可覆盖布局(如单列 flex)拖动换序、锁定后不可拖、重置回默认序生效
AC-EL-CMP-013ChartGrid·布局持久化交互顺序与锁定态按登录账号+页面 key 服务端持久化GET /api/layout?page=<pageKey> 载入(未识别新卡 id 追加尾部,与 UVPVP applyOrder 同语义);拖拽结束/锁定切换 POST /api/layout {page,layout,locked};重置 POST /api/layout/reset {page}排序后换浏览器同账号顺序保持;重置后清除生效
AC-EL-CMP-014DataTable·通用表契约表格泛型数据表 DataTable cols/rows/rowKey;Col{key,head,align(l/r),cell,sortValue?,csv?,filter?,sticky?}列头点击排序——传 onSort 则受控透传(服务端排序),否则纯客户端;首击降序(dir:-1)再击反转;数字按数值比、其余 localeCompare zh-CN numeric;onRowClick 行指针态;增量包裹既有 .tbl 表格用,不重写业务列渲染源码 DataTable.tsx(211 行);任意使用页点列头核序生效
AC-EL-CMP-015DataTable·列级筛选行筛选表头下筛选行:filter:"text" 文本包含(不区分大小写)/ filter:"num" 数字 Min-Max 双输入(step any)取值=csv??sortValue;num 列非数字行仅在无 min/max 时保留;筛选先于排序且作用于导出(WYSIWYG);语义对齐 UVPVP colf(T0-3 2026-09-12)设 Min/Max 后表行与导出行数一致生效
AC-EL-CMP-016DataTable·导出 CSV+Excel导出右上「⬇ 导出 CSV」「⬇ 导出 Excel」按钮(分别传 exportCsv/exportExcel scope 才出现)CSV=zf_<scope>_<YYYYMMDD>.csv(RFC 引号转义+BOM);Excel=.xls HTML 表格 WYSIWYG(与页面所见筛选+排序后一致,office:x 命名空间);两导出均只含当前筛选可见行 shown导出文件行数==页面筛选后行数生效
AC-EL-CMP-017DataTable·分页条分页表底 pager:上一页 / 第 N / M 页 · 共 T 条 / 下一页page≤1 禁用上一页、page≥pages 禁用下一页;total 可选缺省省略「· T 条」翻页请求 page 参数递变生效
AC-EL-CMP-018DataTable·口径说明卡 caliber脚注表上方「📖 口径说明(点击展开)」details/summary 折叠卡2026-10-03 用户令,全栈表格统一;传 caliber ReactNode 即渲染;展开态浅底圆角块任意带 caliber 表展开核对文案生效
AC-EL-CMP-019DataTable·加载/空态空态loading 时表体内嵌 Skeleton(行 4×列=cols×高 30);无数据渲染 empty 或默认 EmptyState「暂无数据」空态不隐藏表结构(列头常驻)慢网见骨架;空数据表显示空态生效
AC-EL-CMP-020kit·基础展示件静态Spinner(zf-spin+「加载中…」可自定义文案)/ Skeleton(rows×cols 网格、行透明度 1−r×0.08 递减、aria-busy)/ EmptyState(◍ 图标+title+hint+action)零第三方依赖;全站加载/空态统一件源码 kit.tsx(179 行)生效
AC-EL-CMP-021kit·Delta 环比状态环比涨跌组件:((cur−prev)/prev)×100,好=绿/差=红(invert=true 成本类反转——下降为好)cur/prev 为 null 或 prev===0 → 灰「—」;输出 +x.x%/−x.x% 一位小数传参断言渲染色与符号生效
AC-EL-CMP-022kit·Toast反馈useToast()(msg,kind) 轻提示,pm-toast 样式kind=ok(✓ 默认)/err(✕ danger 底)/info(ℹ brand 底);2800ms 自动消失;KitProvider 宿主根布局挂载一次触发保存成功/失败看 toast 色与前缀、2.8s 消失生效
AC-EL-CMP-023kit·Confirm弹窗useConfirm()({title,body,confirmText,danger}) → Promise<boolean> 弹窗,替代 window.confirmdanger=true 确认键 danger 红;遮罩/取消均 resolve(false);同时只留一个(新开先 resolve 旧为 false)删除流程确认/取消两分支行为生效
AC-EL-CMP-024kit·Prompt弹窗usePrompt()({title,fields}) → Promise<string[]|null> 多字段弹窗,替代 window.prompt字段{label,initial,placeholder,multiline};Enter 提交 / Esc 或遮罩取消(null);副题「确认后提交;取消则不做任何改动」;multiline=textarea rows 3多字段表单提交取值/取消 null生效
AC-EL-CMP-025RegGate·注册门门控SAAS_REGISTRATION_OPEN=0 时把注册入口替换为灰字「注册暂未开放,请联系 support@zipforcehub.com」开关状态以 API /api/auth/registration-status 为准(营销页预渲染,构建时读不到运行时 env);拿不到状态时放行显示原入口(API 层 403 兜底),避免状态接口故障误藏入口关闭注册后入口页显示关闭文案;模拟状态接口故障入口仍在生效
AC-EL-CMP-026BrandContext·brand 模块级 storeProvider当前品牌选择=模块级外部 store(useSyncExternalStore),localStorage zf:brand:<slug> 持久化;info/brands 走 Provider context页面主组件在 AppShell 父级、context 只能向下传播——brand 若走 Provider 页面恒读空串(2026-09-09 修复:此前品牌切换对全部页面不生效);外部 store Provider 内外一致;隐私模式 localStorage 写失败静默忽略源码 BrandContext.tsx:27-29 注释;页首切换品牌全页联动生效
AC-EL-CMP-027BrandContext·初始化优先级门控登录后 info 到达时同步初始化当前品牌,优先级:localStorage 记忆 > 单品牌自动选中 > 账号同名品牌品牌拆开铁律——多品牌账号默认落在自己的品牌而非「全部」聚合,「全部」仅显式点击生效;namesake=brands.includes(slug)?slug:(brands[0]??"");记忆品牌被删回退账号同名;初始化幂等(inited ref 按 slug)多品牌新登录默认选中自己品牌非「全部」生效
AC-EL-CMP-028BrandContext·注册表级联注入Provider每次 info 到达幂等注入品牌色/展示名覆盖表 setBrandColorOverrides(info.brand_colors) / setBrandLabelOverrides(info.brand_labels)D类(2026-10-08)注册即级联 source_map.color + H9(2026-10-13) source_map.label 同款;展示名统一走 fmt.brandLabel,BrandBoard/NoonBoard 散写品牌名单已删企业改注册表色/名后全站点名即时生效生效
AC-EL-CMP-029BrandContext·useBrandReady门控品牌 store 初始化完成信号 hook;页面级请求 effect 必须等其为 true否则初始化前以 brand=""(全部聚合)打出请求——品牌拆开铁律下禁止(与 SHELL-002 门配套)源码 :79-87;新页面接入检查项生效
AC-EL-CMP-030AIContext·页面上下文注册ProvideruseAIContext({page,title,presets,getContext}) 声明「我是谁、能问什么、当前选择是什么」,供 AppShell 挂载的 🤖 面板消费栈式(LIFO)注册——同页多视图(如 sourcing 两个主 tab)各自入栈、卸载即弹出、栈顶生效;getContext 经 ref 恒取最新源码 AIContext.tsx;切 tab 面板标题/预设随之变生效
AC-EL-CMP-031AIChat·悬浮球与面板交互右下角固定悬浮球「🤖 AI 分析」(fixed right:20 bottom:20 zIndex 80,品牌底色圆角胶囊);点开面板 min(460px,100vw−32)×min(600px,100vh−110)无页面注册(cfg=null)时悬浮球不渲染;面板头「🤖 <title>」+「基于本页真实数据」+ ✕ 关闭;空会话列 presets 问题按钮;气泡 user 右对齐品牌底白字 / assistant 左对齐 bg 底;busy「🤖 正在分析数据…」;新消息自动滚底未注册页无球;注册页开面板提问往返生效
AC-EL-CMP-032AIChat·问答链路交互提问 POST /api/ai/page-chat {page: cfg.page||"generic", context: getContext(), question},回 {answer} 入气泡切页面(cfg.page 变)清空会话与错误;Enter 发送(e.nativeEvent.isComposing 防中文输入法组字误发);busy 期输入与发送禁用;失败红字错误条源码 send;中文输入法组字中回车不发送生效
AC-EL-CMP-033MatrixSection·四维矩阵本体表格平台×国家×品牌×SKU 全组合矩阵区:三下拉筛选(平台/国家/品牌,选项来自数据去重)+ DataTable 9 列 + 4 图数据 GET /api/matrix/data?brand= + /api/matrix/charts?brand=(仅随 brand prop 重查);列=平台/国家/品牌/SKU/收入(usd)/利润(红绿)/订单(int)/件数(int)/利润率(红绿 pct);受控排序先对筛选后全量排序再切片(pageSize 20)——分页下点列头是全局排序;工具栏尾「N 组 · 第 x/y 页」源码 MatrixSection.tsx(251 行);末页点排序核全局序生效
AC-EL-CMP-034MatrixSection·四图图表收入趋势图(线)/ 利润对比图(柱,x=品牌-国家)/ SKU 分布图(饼,收入)/ 国家热力图(横条,收入+利润双系列),高 286趋势 2026-09-28 修复——API 内层 key 为「{brand}/amz|{brand}/noon」非裸品牌名,原按裸名取值恒 0 趋势整条贴零;系列按真实 key 生成(两系列均 USD,Noon 侧 API 已按锚定汇率折算);数据未到整区 Skeleton趋势线 Noon 系列非全零生效
AC-EL-CMP-035MatrixSection·口径说明脚注表上方 caliber:四维矩阵分析口径金额=折 USD(Amazon=订单级,Noon=月度结算折 USD)|平台×国家×品牌×SKU 全组合矩阵|订单=count(Amazon 订单表+Noon 订单表)|营收=sum(Amazon revenue_usd + Noon gmv 折 USD)|广告=sum(Amazon ad_cost + Noon spends 折 USD)展开卡逐字核对生效
AC-EL-CMP-036BrandBoard·主看板主体契约引用品牌主看板(Amazon)共享主体,2026-09-15 从 /dashboard/[brand] 路由页抽出:独立路由壳与工作台内嵌复用同一主体(数据/交互/ChartGrid pageKey 不变)props{brandKey,brandLabel,compact,days?,from?,to?,country?}——compact=true 工作台内嵌受控(窗口随顶部时间选择器、KPI 区不渲染),全屏页自治时间窗 7/30/90/全部(3650);页面级条目在 §11.21(品牌看板路由批次)源码 BrandBoard.tsx(323 行)生效
AC-EL-CMP-037BrandBoard·数据源与缓存表格墙 GET /api/dashboard/charts?brand&platform=amazon&country&days[&frm&to];表格 GET /api/brandboard/orders(page_size 20)+ /api/brandboard/country-sku?limit=200墙按 winKey=days|from|to|country 缓存;品牌切换清墙缓存(内嵌实例不重挂载,不清则永显旧品牌数据);国家入缓存键与请求参数(2026-09-16 修「切国家看板不变」)切品牌/国家后请求重发、数据换生效
AC-EL-CMP-038BrandBoard·核心指标 5 卡KPI卡订单(foot=N 件)/ 营收 USD(foot=客单价 $)/ 净利 USD(foot=利润率 %)/ 费用 USD(foot=已回款 $)/ 取消率 %(foot=区间 from→to)值=墙 kpis 字段;仅全屏页渲染(compact 无);空值渲染「—」与墙响应 kpis 对算生效
AC-EL-CMP-039BrandBoard·图题与 EN 对照图表每图题=CHART_TITLES 中文题(EN 映射 80 键系 BrandBoard.tsx:42-73 声明的台账对照常量,全文件零引用未接线——「英文原名小字」仅 NoonBoard 渲染,见 CMP NoonBoard 条)sub=spec.hint 优先 API 动态值(本企业真前三)、CHART_TITLES 静态表兜底 + spec.sub 数据日「· 数据日 YYYY-MM-DD」(P3 ⑯);对齐 UVPVP Amazon 主看板 8 区块 81 图(6 图组+锚点导航+数据表格);锚点导航 tab「组名 N」+「📋 数据表格」抽图核对中英双题与 hint生效
AC-EL-CMP-040BrandBoard·图卡交互交互每图 ⬇CSV(specCsv:pie=项/值两列,其余=维度×系列矩阵)+ 独立日期区间 + ChartGrid 拖拽持久化独立区间仍是拖尾天数语义(rangeDays=区间天数 clamp [1,3650],独立窗墙按需加载、未加载回落全局);pageKey=/dashboard/<brand>:<组>设独立区间图卡换窗数据;CSV 打开核对生效
AC-EL-CMP-041BrandBoard·数据表格区表格📋 数据表格区:订单明细表(UVPVP 14 列:Order ID/Date/Country/Currency/Status/List Price/Price/Promotion/Commission/FBA Fees/Settlement/Settled/Rate%/SKUs,text/num 列筛混布,CSV+Excel)+ Country/SKU 汇总表(5 列:Country/SKU/Qty/Revenue Local/Revenue USD)caliber①订单明细:金额=折 USD|按下单时间倒序|List Price=本币金额(无挂牌价源)|Settlement=回款状态|源=cleaned_amazon_orders+order_fees;caliber②Country/SKU:件数与金额按订单内 SKU 数均摊(items 级粒度未 ingest 的近似口径);SKUs 列超 22 字截断+title 悬浮全文两表 caliber 展开逐字;列头 14/5 项核对生效
AC-EL-CMP-042BrandBoard·空态/被拒态空态墙 empty→「该品牌窗口内无订单数据」引导卡(试试「全部」窗口,或检查采集管道);墙未载且 err→「无法加载该品牌看板」引导卡(请从工作台品牌区进入)P3 缺陷㊴(2026-10-01)——品牌被拒(403/他牌)时 brandboard/* 的 catch(()=>{}) 吞错致骨架永卡/「第1/1页·0条」误导;chart_count 行空墙 from/to 为 null 时省略「( → )」括号段(P3 残片修复)越权品牌直达路由看引导卡不卡骨架生效
AC-EL-CMP-043NoonBoard·主看板主体契约引用Noon 品牌主看板共享主体(2026-09-15 抽出):独立路由壳与工作台内嵌复用;props 同 BrandBoard数据 GET /api/brandboard/noon?brand&days&country[&frm&to] + /api/noon-inventory?brand=(FBN 摘要);墙缓存/品牌切换清缓存逻辑同 BrandBoard;pageKey=/dashboard/noon/<brand>:<组>;页面级条目在 §11.21源码 NoonBoard.tsx(248 行)生效
AC-EL-CMP-044NoonBoard·KPI 与 FBN 卡KPI卡4 KPI 卡(窗口订单件·foot 最新日件 / 取消率·foot CIR 率 / 最新月 GMV(折 USD·月度结算口径)/ 最新月利润(结算净额−广告))+ 📦 FBN Inventory Alert 卡FBN 卡值=summary.stock,foot「🔴urgent · 🟡watch · 🟢ok · 缺口 Nu · Pd(快照 date)」+「明细 →」链 /inventory;urgent>0 卡红边框;无快照「暂无快照(等待每日 08:00 采集)」;KPI 仅全屏页渲染、FBN 卡两种形态均渲染FBN 数字与 /inventory 明细对算生效
AC-EL-CMP-045NoonBoard·EN 对照与审计说明脚注EN 映射 32 键(nDailyOrders…nCpsTrend,UVPVP 验收台账对照);尾部「📋 数据审计说明」卡 5 条已知偏差——Hub 无 Noon 日级金额,Daily GMV/AOV/Profit/结算率以月度口径替代(图题已标注);5 条=①订单/状态/CIR/取消/时段=noon_orders 件级按日(92 天滚动窗,每日 04:30 ingest)②金额类=月度结算折 USD ③利润=结算净额−广告(与工作台 Noon 月墙同口径唯一实现)④广告日趋势=noon_ads_daily、SKU 级=noon_sku_ads 月表 ⑤FBN=fbn_inventoryv2_aging 最新快照(SALEABLE 口径)92 天销速 35d/90d 线说明卡逐条与 §11.6 口径一致生效
AC-EL-CMP-046NoonStatement·表①官方对账单表格财务页 Noon 表①:官方对账单 26 字段整表(截图原序不拆分):月份|品牌|市场|期初余额|净入账|总费用|打款|期末余额|8 费项×(含税|VAT)|银行转账|余额转账#55b 用户令「按照这两个表格来」(2026-10-09);8 费项=广告费/佣金/FBN 出库/退回退款/保修/退货管理/破损退/促销(STMT_FEES 顺序);源=api/routers/finance.py /api/noon/summary + #47 拍板——各费项=含税实扣、贷记冲减为正;/noon 页同源引用本组件常量(26 列全分项见 §11.6)列头 26 字段逐字比对用户截图原序生效
AC-EL-CMP-047NoonStatement·VAT 内拆列组每费项拆「含税|VAT」两列,VAT=含税×市场税率,税率写死 STMT_VAT_RATE={SA:15/115, AE:5/105}VAT>0 绿色显示;聚合层不先拆——渲染层按市场税率对聚合后含税值内拆(率恒定,与逐月拆后求和等价);期初/期末/打款等非费项列不拆SA 行 VAT=含税×15/115 手算核对生效
AC-EL-CMP-048NoonStatement·月/季/年聚合表格STMT_GRAINS 月/季/年聚合 aggregateStmts(客户端,源=月粒度行),分组键=品牌|市场|期间期初=期内首月期初、期末=期内末月期末,其余 13 列(净入账/总费用/打款/8 费项/银行转账/余额转账)期内求和;组内全 null 保持 null;排序 mon 降序→品牌→市场;表② aggregateOps 同法(15 量列求和)季行=三月行手算对(期初取首月、期末取末月)生效
AC-EL-CMP-049NoonStatement·表②月度经营总表表格表②:月度经营总表 20 字段(用户字段清单逐字):月份|品牌|市场|Orders|Units Sold|Valid Units|Delivered|Pending|Cancel Order|未妥投|CIR|GMV|Commission|Delivery|Ad Spend|Gross Profit|COGS|Net Profit|Settlement 净额|PayoutOPS_COLS 17 数据列(英文 head 逐字+未妥投/CIR/Settlement 净额中英混合);gross=settlement−ad、net=gross−cogs(聚合后推导列);net<0 红字、gross/net strong 加粗;金额列 muted、计数列裸数字(toLocaleString 0 位小数)列头逐字比对清单;net 手算生效
AC-EL-CMP-050NoonStatement·期间下拉筛选#56 期间下拉(墙钟锚定):今年/本月/上月/近3月/近12月/去年 + #56b 单月键(YYYY-MM 合法,窗口=[该月,该月])periodRange 返回 [起月,止月](this_year=YYYY-01~YYYY-12 等);标题 periodLabel——单月→「2026-09」、月度→月键、年→「YYYY 全年」、近3月→「YYYY-MM~MM」;未知键回本月选上月窗口=上个自然月整月生效
AC-EL-CMP-051CustomModules·模块本体与 CRUD表格每页尾部「🧩 自定义分析」区(h2 副注「本页自建图表 · 企业共享 · 跟随页首品牌」):模块网格 +「+添加自定义图表」卡;模块=企业共享,卡片署创建者清单 GET /api/reports/defs?page=<page>;新建 POST /api/reports/defs;编辑 PUT /api/reports/defs/{id}(挂账⑤全量预填,原先只能删了重建;域已下线回退 daily);删除 DELETE /api/reports/defs/{id}——确认弹窗露创建人防误删他人图表(挂账⑫);数据域清单 GET /api/reports/fields 拉取失败显式报错+可重试(挂账③,原「添加」静默死点);后端=白名单引擎 5 域 report_defs 注册表(企业 RLS);卡头两行制(2026-10-29 标题重排批:行1=标题+图型徽章 badge.dim+创建者+品牌/国家下拉+图表/表格切换+编辑/删除,行2=meta「N 度量 × 维度 · 筛后行数 · Top n/共 m · 排序标注 · 每列归一 100%(仅 pstack)」);长宽自由设定——宽度=config.w(1 标准/2 gridColumn span 2/3 1/-1 整行,auto-fill 栅格超列数自动收敛不溢出)、高度=config.h clamp 160–720 默认 240、多度量饼图高度=min(h,320)增/改/删全链路 + 刷新持久 + 他账号可见共享生效
AC-EL-CMP-052CustomModules·编辑器弹窗添加/编辑弹窗:数据域 tab(5 域 daily/stock/rank/noon/noon_daily)→ 维度 chip 多选(第 1 个为 X 轴)→ 度量 chip 多选 → 图型 9 选(折线/面积/柱状/堆叠/占比堆叠/柱线双轴/饼图/横向条形/表格)→ 时间窗(7/14/30/60/90/180/365 天)→ 排序(维度原序/按首度量降序·升序,NaN 沉底)→ Top-N(0=不限)→ 宽度档(标准/双宽/全宽)→ 高度 160–720px 滑杆 → 柱顶标数 toggle → 标题(留空自动生成「度量×度量 按 维度/维度」)维度/度量不限量(上限即白名单);时间窗仅 daily 域可选,其余四域固定窗/全量置灰+WIN_HINT 说明防死选项(2026-10-20);品牌联动——def 不烘焙品牌,渲染期套用查看者页首品牌(页首切换→覆盖卡片级选择的主从语义);域切换重置维度度量为默认;daily 域特殊维提示(sku=广告侧仅广告指标/status=订单侧含取消/词维活动与搜索词互斥);新参数 2026-10-29 批:config 透传 w/h/sort/topn/labels(sort/topn 作用于列筛选后数据=纯呈现变换不碰查询,AC-CAL-17 不涉),旧 def 无新键全走默认(w=1/h=240/sort=dim/topn=0/labels=false)兼容;后端 chart_type 白名单同步扩 9 种(reports.py _validate,原 6 种拦新图型 400 已修);dual/pstack/area 选中时行内中文语义提示建图保存后刷新在列;切页首品牌卡片数据随变生效
AC-EL-CMP-053CustomModules·卡片查询与筛选筛选模块卡片:POST /api/reports/query {domain,dims,metrics,chart_type,filters}(叠页首品牌/国家);表头筛选行——维度列=下拉精确选值(级联:先选国家 SKU 下拉只剩该国 SKU)、度量列=Min-Max 区间;「图表/表格」切换;「筛后 N/M 行」计数筛选同时作用于表格与图表;无数据「该筛选下无数据(不显示误导性 0)」,note「该图表暂不可计算…」红字;表格仅显示前 100 行并提示总数;筛后 0 行仍渲染表头筛选行(否则筛选框随表卸载无法清筛回退);下拉选项跨查询记忆(useRef 累积见过的取值防选项塌缩,2026-10-20);品牌/国家下拉仅选项>1 时出现选维度值图表联动;筛至 0 行可清筛恢复生效
AC-EL-CMP-054CustomModules·成图规则图表dims[0]=X 轴,其余维度组合拆系列(多度量时系列名「组合·度量」);饼图=全维度组合为扇区×首个度量多度量饼图不再只画首度量——逐度量各一饼、各自量纲独立成图(挂账①);顺带修复裸数字数组被 d.value>0 滤空的隐性 bug;渲染走 GChart specToOption 单源两维×两度量图系列数=组合数×2生效
AC-EL-CMP-055CustomModules·Noon 本币提醒脚注noon 域选金额度量且未选「国家/站点」维时编辑器行内提醒挂账⑥——NOON_LOCAL={noon_gmv,noon_net,noon_ad,noon_commission} 站点本币(AE=AED/SA=SAR)未拆国家维直接相加;文案「…两种币种直接相加——建议勾选国家维拆分」构造该组合看提醒文案出现生效

§11.27 财务页六大表列级展开(/finance · AC-EL-FIN-C 系列,源码 web/app/finance/page.tsx + web/components/NoonStatement.tsx + api/routers/finance.py;六表=019 分市场/027 矩阵/031 Noon SKU 深度/037 官方对账单/038 月度经营总表/057 项目×月对账)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-FIN-C-001卡头 h2卡头「Amazon {月} 累计 · 分市场」+ sub 结算净额/毛利润/净利润三公式/api/finance/kpi-wall;page.tsx:718文案断言生效
AC-EL-FIN-C-002月份下拉筛选器monOpts select 切 amzMonpage.tsx:720-724;kpi-wall?month 联动切月行值变生效
AC-EL-FIN-C-003表头行(17 th)表头市场/订单/已结算/销售件数/取消订单/本土币营收/净收款/佣金/尾程配送FBA/结算净额/广告/VAT/毛利润/毛利率/采购成本/净利润/回款原 17 th(page.tsx:729-731)vs amzRow 18 td(page.tsx:693-710)列数不等的表头缺陷已修:2026-10-22 用户拍板补表头,th 序列插入「在途 Pending」(现 page.tsx:729),18 th=18 td;web 重建上线,浏览器 DOM 探针实测 thead th=18/首行 td=18(tools/_gate_fin_th_20261022.log),frontend_e2e 门禁 ALL PASS浏览器 DOM 数列:thead th=18 / tbody tr td=18(2026-10-22 实测通过)生效
AC-EL-FIN-C-004列1 市场+币种列市场名 + cur3 灰字小号amzRow td1(page.tsx:693);全市场行=「全市场 USD」首行文案生效
AC-EL-FIN-C-005列2 订单列int(orders)orders=aord 剔取消(AC-CAL-02);td2(694)SQL aord 对拍生效
AC-EL-FIN-C-006列3 已结算列int(settled_orders),null→—has_finance 计数;td3(695)SQL 对拍生效
AC-EL-FIN-C-007列4 销售件数列int(units)td4(696)SQL 对拍生效
AC-EL-FIN-C-008列5 pending 在途(无表头列)列int(pending??0),muted2026-09-27 五态归并:在途=shipped/exported;原 td5(:697)无表头致其后错位一格——2026-10-22 已补「在途 Pending」th(列序:销售件数/在途/取消订单),错位消除,本列转有头常规列浏览器 DOM 断言 th5=在途 Pending、th6=取消订单(探针实测通过)生效
AC-EL-FIN-C-009列6 取消订单列int(canceled),有取消红字canceled=can 'Canceled' 单变体;td6(698)实际位于表头「本土币营收」名下(错位见上条)SQL 对拍+DOM 数列生效
AC-EL-FIN-C-010列7 本土币营收列local_revenue null→—否则 localCur2026-09-18/19 本土币列;td7(699)SA 行=SAR 标注生效
AC-EL-FIN-C-011列8 净收款列local_revenue 有→本币否则 usd(net_proceeds)td8(700)对拍生效
AC-EL-FIN-C-012列9 佣金列local_commission 优先,回退 usd(commission),mutedtd9(701)对拍生效
AC-EL-FIN-C-013列10 尾程配送 FBA列local_fba 优先,回退 usd(fba),mutedtd10(702);noon 尾程=delivery(2026-09-27)对拍生效
AC-EL-FIN-C-014列11 结算净额列localSettle=本土币营收−佣金−尾程−促销−其他;USD 路径=净收款−…;title 悬停展开实算式td11(703)悬停公式=列值生效
AC-EL-FIN-C-015列12 广告列local_ad 优先,币种=ad_ccy||cur3td12(704)对拍生效
AC-EL-FIN-C-016列13 VAT列local_vat 优先,回退 usd(vat??0),title=order_fees.vat 本币优先td13(705)对拍生效 reg:id14
AC-EL-FIN-C-017列14 毛利润列gross=settlement−ad;本币路径 localGross=localSettle−local_ad;posColortd14(706)复算生效
AC-EL-FIN-C-018列15 毛利率列mgn=gross/net_proceeds×100,.1f%;null→—td15(707)复算生效
AC-EL-FIN-C-019列16 采购成本列product_cost_rmb 原生 ¥ 千分位 0 位,null→—,title=采购成本(RMB)td16(708);不折 USDRMB 原值生效
AC-EL-FIN-C-020列17 净利润列net=gross−product_cost,全程 USD 计算(严禁币种混算),strong+posColortd17(709)复算生效
AC-EL-FIN-C-021列18 回款列usd(payout),null→—td18(710)对拍生效
AC-EL-FIN-C-022全市场行行首行「全市场 USD」底色 #fbfcfdamzRow(wA.amazon.all,…,true)(734)首行样式生效
AC-EL-FIN-C-023销量柱状图图Orders bar + Net Profit line + dataZoom 可拖动amzChartOpt(741)EChart h=280切月联动生效
AC-EL-FIN-C-024卡头+年份下拉卡头矩阵标题 + 「全部年份」select/full matrix;matRef 供导出 Excel导出列数=23生效
AC-EL-FIN-C-025列1 月份列r.mon,num strong行键=brand+mon(1541)排序断言生效
AC-EL-FIN-C-026列2 品牌列branddot 色点+品牌名brandColor(r.brand)色点恒渲染生效
AC-EL-FIN-C-027列3 订单列int(orders)/full matrix;AC-CAL-02 aord 剔取消抽月 SQL 对拍生效
AC-EL-FIN-C-028列4 已结算列int(settled),stronghas_finance 计数对拍生效
AC-EL-FIN-C-029列5 销售件数列int(units)—对拍生效
AC-EL-FIN-C-030列6 取消订单列int(canceled),有值红字'Canceled' 变体对拍生效
AC-EL-FIN-C-031列7 有效订单列int(valid),valid=orders−canceled 前端派生与 016 订单(aord 三变体 FILTER)同义不同实现;2026-10-22 实测 canceled 仅 'Canceled' 两值相等;差异归 AC-PEND-02 统一抽行复算+AC-PEND-02 跟踪生效
AC-EL-FIN-C-032列8 净收款列usd(revenue,2)—对拍生效
AC-EL-FIN-C-033列9 佣金列usd(|commission|,2),muted绝对值化对拍生效
AC-EL-FIN-C-034列10 FBA列usd(|fba|,2),muted—对拍生效
AC-EL-FIN-C-035列11 促销列usd(|promo|,2),muted—对拍生效
AC-EL-FIN-C-036列12 广告列usd(ad,2),muted—对拍生效
AC-EL-FIN-C-037列13 广告销售列usd(ad_sales,2),mutedAMZ 侧 7 天归因对拍生效
AC-EL-FIN-C-038列14 ACOS列ad/ad_sales×100 .1f%;ad_sales≤0→——复算生效
AC-EL-FIN-C-039列15 TACOS列ad/revenue×100 .1f%;revenue≤0→——复算生效
AC-EL-FIN-C-040列16 VAT税列usd(vat??0,2),muted;title=Amazon 官方税额(已含在平台费扣减中)order_fees.vat对拍生效
AC-EL-FIN-C-041列17 采购成本 COGS列usd(cost,2)—对拍生效
AC-EL-FIN-C-042列18 结算净额列usd(net,2)/full net对拍生效
AC-EL-FIN-C-043列19 毛利润列gross=net−ad,正绿负红AC-CAL-01复算生效
AC-EL-FIN-C-044列20 毛利率列pct(margin(revenue,gross))—复算生效
AC-EL-FIN-C-045列21 净利润列net2=gross−cost,strong 正绿负红—复算生效
AC-EL-FIN-C-046列22 回款列usd(payout,2)—对拍生效
AC-EL-FIN-C-047列23 退款件列int(refunds),muted—对拍生效
AC-EL-FIN-C-048空态行空态「无数据」colSpan=23 居中matrix.length===0(1567)断数据渲染生效
AC-EL-FIN-C-049卡头文案「39 列深度表」卡头h2 固定文案「Noon SKU 表现 · 39 列深度表」原 page.tsx:966「39 列」与 NOON_SPEC 实际 44 项不符的文案缺陷已修:2026-10-22 用户令全修,改「44 列深度表」,web 重建上线,编译产物 39 列零残留/44 列在场,frontend_e2e 门禁 ALL PASS导出列数=44 复核(编译产物字符串核验通过)生效
AC-EL-FIN-C-050年份 pills筛选器YEAR_OPTS 今年/去年/前年 tab/api/finance/noon-sku?year切年重载生效
AC-EL-FIN-C-051国家下拉筛选器全部国家/SA/AEcountry 参数(973-976)过滤生效生效
AC-EL-FIN-C-052副标口径静态「本币(SAR/AED)· 头程按拍板以 0 录入」page.tsx:977文案断言生效
AC-EL-FIN-C-053汇总行汇总年窗口·合并(型号×颜色×国家)行数·订单·GMV·广告·净利润(正绿负红)items=品牌过滤后 reduce(960-963);净利润色按正负合计=Σ行生效
AC-EL-FIN-C-054错误横幅反馈红条 role=alerterr←catch(980)role=alert生效
AC-EL-FIN-C-055DataTable 容器表格排序/筛选/CSV=noon_sku/Excel=noon_sku/minWidth 3400/rowKey=brand+model+color+countryNOON_COLS 由 NOON_SPEC 生成;21 个金额列头加(本币)后缀(2026-10-03 用户令)导出列数=44生效
AC-EL-FIN-C-056caliber 口径块脚注6 个分句(|分隔,page.tsx:996 逐段数):金额本币(汇总行折USD)/毛净=结算净额/净利润=结算净额−广告−COGS(头程恒0)/广告=noon_ads_daily F2-6 单源 nsku 映射/有效件=件数−取消−不可投递−CIR/无销售有广告 SKU 不显示(PL 月表驱动)DataTable caliber prop(996)文案断言生效
AC-EL-FIN-C-057列1 型号列key=model,格式化 kind=strNOON_SPEC 第 1 项(数组 page.tsx:903–917,每行 4 项);行键组成抽行对拍生效
AC-EL-FIN-C-058列2 颜色列key=color,格式化 kind=mutedNOON_SPEC 第 2 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-059列3 品牌列key=brand,格式化 kind=brandNOON_SPEC 第 3 项(数组 page.tsx:903–917,每行 4 项);行键组成+品牌过滤键抽行对拍生效
AC-EL-FIN-C-060列4 国家列key=country,格式化 kind=mutedNOON_SPEC 第 4 项(数组 page.tsx:903–917,每行 4 项);SA=SAR / AE=AED 分行抽行对拍生效
AC-EL-FIN-C-061列5 SKU数列key=skus,格式化 kind=numNOON_SPEC 第 5 项(数组 page.tsx:903–917,每行 4 项);合并 SKU 数抽行对拍生效
AC-EL-FIN-C-062列6 订单 Orders列key=orders,格式化 kind=numNOON_SPEC 第 6 项(数组 page.tsx:903–917,每行 4 项);订单号去重抽行对拍生效
AC-EL-FIN-C-063列7 销售件数 Units Sold列key=units,格式化 kind=numNOON_SPEC 第 7 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-064列8 取消订单 Cancel Order列key=cancelled,格式化 kind=absNOON_SPEC 第 8 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-065列9 不可投递列key=undeliverable,格式化 kind=absNOON_SPEC 第 9 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-066列10 CIR列key=cir,格式化 kind=absNOON_SPEC 第 10 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-067列11 有效件 Valid Units列key=valid_orders,格式化 kind=numBNOON_SPEC 第 11 项(数组 page.tsx:903–917,每行 4 项);=件数−取消−不可投递−CIR抽行对拍生效
AC-EL-FIN-C-068列12 GMV列key=gmv,格式化 kind=numNOON_SPEC 第 12 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-069列13 佣金 Commission列key=commission,格式化 kind=absNOON_SPEC 第 13 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-070列14 履约费列key=delivery_fee,格式化 kind=absNOON_SPEC 第 14 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;noon 尾程抽行对拍生效
AC-EL-FIN-C-071列15 运费补贴列key=shipping_credits,格式化 kind=absNOON_SPEC 第 15 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-072列16 其他订单 Orders费列key=other_order_fees,格式化 kind=absNOON_SPEC 第 16 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-073列17 订单 Orders补贴列key=order_subsidies,格式化 kind=absNOON_SPEC 第 17 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-074列18 非订单 Orders费列key=non_order_fees,格式化 kind=absNOON_SPEC 第 18 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-075列19 非订单 Orders补贴列key=non_order_subsidies,格式化 kind=absNOON_SPEC 第 19 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-076列20 其他列key=others,格式化 kind=absNOON_SPEC 第 20 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-077列21 VAT(推算)列key=vat_est,格式化 kind=absNOON_SPEC 第 21 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;五费×市场税率内拆+广告×外加(finance.py)抽行对拍生效
AC-EL-FIN-C-078列22 结算 Settlement净额列key=settlement,格式化 kind=numBNOON_SPEC 第 22 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-079列23 退款 Refund列key=refund,格式化 kind=absNOON_SPEC 第 23 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-080列24 曝光量 Impression列key=views,格式化 kind=numNOON_SPEC 第 24 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-081列25 点击列key=clicks,格式化 kind=numNOON_SPEC 第 25 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-082列26 CTR列key=ctr,格式化 kind=pctNOON_SPEC 第 26 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-083列27 ATC列key=atc,格式化 kind=numNOON_SPEC 第 27 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-084列28 广告花费 Ad Spend订单 Orders列key=ad_orders,格式化 kind=numNOON_SPEC 第 28 项(数组 page.tsx:903–917,每行 4 项);表头文案为源码原样(双语拼接),勿当错字改抽行对拍生效
AC-EL-FIN-C-085列29 CVR列key=cvr,格式化 kind=pctNOON_SPEC 第 29 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-086列30 广告花费 Ad Spend花费 Spend列key=ad_cost,格式化 kind=numNOON_SPEC 第 30 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-087列31 广告花费 Ad Spend销售列key=ad_revenue,格式化 kind=numNOON_SPEC 第 31 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-088列32 ACOS列key=acos,格式化 kind=pctDNOON_SPEC 第 32 项(数组 page.tsx:903–917,每行 4 项);>50% 红标抽行对拍生效
AC-EL-FIN-C-089列33 TACOS列key=tacos,格式化 kind=pctDNOON_SPEC 第 33 项(数组 page.tsx:903–917,每行 4 项);>30% 红标抽行对拍生效
AC-EL-FIN-C-090列34 CPC列key=cpc,格式化 kind=d2NOON_SPEC 第 34 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-091列35 CPS列key=cps,格式化 kind=d2NOON_SPEC 第 35 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-092列36 单件成本 Cost列key=cost_per_unit,格式化 kind=d2xNOON_SPEC 第 36 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-093列37 有效件 Valid Units成本 Cost列key=valid_orders_cost,格式化 kind=numNOON_SPEC 第 37 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-094列38 头程列key=first_mile,格式化 kind=absNOON_SPEC 第 38 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;按拍板恒 0 录入抽行对拍生效
AC-EL-FIN-C-095列39 不可售件列key=unsaleable,格式化 kind=absNOON_SPEC 第 39 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-096列40 不可售成本 Cost列key=unsaleable_cost,格式化 kind=absNOON_SPEC 第 40 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-097列41 毛净列key=gross_net,格式化 kind=numNOON_SPEC 第 41 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;=结算净额抽行对拍生效
AC-EL-FIN-C-098列42 净利润 Net Profit列key=net_profit,格式化 kind=signBNOON_SPEC 第 42 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;正绿负红抽行对拍生效
AC-EL-FIN-C-099列43 净利润 Net Profit率列key=margin,格式化 kind=pctSNOON_SPEC 第 43 项(数组 page.tsx:903–917,每行 4 项)抽行对拍生效
AC-EL-FIN-C-100列44 单件履约列key=unit_fulfill,格式化 kind=d2NOON_SPEC 第 44 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀抽行对拍生效
AC-EL-FIN-C-101卡头 h2卡头「官方对账单 · Noon {期间} 累计 · 分市场」+ sub 26 字段全分项·本币口径(未折 USD)/api/noon/summary(finance.py:295,cleaned_noon_statement)文案断言生效
AC-EL-FIN-C-102期间下拉筛选器OPS_PERIODS 6 档(今年/本月/上月/近3月/近12月/去年)+ 单月 optgroup(#56b 用户令)opsPeriod 两表共用;periodRange 墙钟锚定切期行集变生效
AC-EL-FIN-C-103粒度 tabs筛选器月/季/年(STMT_GRAINS)stmtGrain 两表共用;stmtPeriodKey Q 分桶M→Q→Y 聚合守恒生效
AC-EL-FIN-C-104双行表头表头第一行 rowSpan=8 基础列+8 费项 colSpan=2+银行/余额;第二行 8×(含税/VAT)NoonStatement.tsx:124-137;物理列=26(8+16+2)DOM 数列=26生效
AC-EL-FIN-C-105列1 月份列label;Q→「2026 Q3」格式aggregateStmts 输出分桶断言生效
AC-EL-FIN-C-106列2 品牌列brand;分组键=brand|market|期全量口径不随全局品牌筛选(脚注披露)切品牌行不变生效
AC-EL-FIN-C-107列3 市场列market(SA/AE)币种由市场决定对拍生效
AC-EL-FIN-C-108列4 期初余额列money() 千分位 0 位聚合=期内首月期初(opening 取 first)M→Q 守恒(端点)生效
AC-EL-FIN-C-109列5 净入账列money()SUM_KEYS 求和M→Q→Y=Σ月生效
AC-EL-FIN-C-110列6 总费用列money()SUM_KEYS 求和M→Q→Y=Σ月生效
AC-EL-FIN-C-111列7 打款列money()SUM_KEYS 求和M→Q→Y=Σ月生效
AC-EL-FIN-C-112列8 期末余额列money()聚合=期内末月期末(closing 取 last)M→Q 守恒(端点)生效
AC-EL-FIN-C-113列9 广告费·含税列money(v) muted含税实扣(源=cleaned_noon_statement.ads);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-114列10 广告费·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-115列11 佣金·含税列money(v) muted含税实扣(源=cleaned_noon_statement.referral);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-116列12 佣金·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-117列13 FBN 出库·含税列money(v) muted含税实扣(源=cleaned_noon_statement.fbn);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-118列14 FBN 出库·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-119列15 退回退款·含税列money(v) muted含税实扣(源=cleaned_noon_statement.returns);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-120列16 退回退款·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-121列17 保修·含税列money(v) muted含税实扣(源=cleaned_noon_statement.warranty);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-122列18 保修·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-123列19 退货管理·含税列money(v) muted含税实扣(源=cleaned_noon_statement.ret_admin);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-124列20 退货管理·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-125列21 破损退·含税列money(v) muted含税实扣(源=cleaned_noon_statement.damaged);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-126列22 破损退·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-127列23 促销·含税列money(v) muted含税实扣(源=cleaned_noon_statement.promo);SUM_KEYS 求和对拍生效
AC-EL-FIN-C-128列24 促销·VAT列money(vat),vat>0 绿字内拆=v×STMT_VAT_RATE[market](SA 15/115 · AE 5/105,贷记冲减为正);渲染层对聚合值内拆(率恒定与逐月拆等价)抽行复算生效
AC-EL-FIN-C-129列25 银行转账列money(bank_tr) muted钱包划转(非应税);SUM_KEYS对拍生效
AC-EL-FIN-C-130列26 余额转账列money(bal_tr) muted钱包划转(非应税);SUM_KEYS对拍生效
AC-EL-FIN-C-131聚合口径条目口径期初/期末取端点,其余 13 键(净入账/总费用/打款/8费项/银行/余额)期内求和NoonStatement.tsx:84-85 SUM_KEYS+aggregateStmtsM→Q→Y 聚合守恒复算生效
AC-EL-FIN-C-132全量口径脚注脚注各费项左列=含税实扣·右列=VAT 内拆…本区块为 Noon 全量口径,暂不随全局品牌筛选page.tsx:834-838文案断言生效
AC-EL-FIN-C-133卡头 h2卡头「月度经营总表 · Noon {期间} 累计 · 分市场」+ sub Orders → Payout 20 字段·本币口径/api/finance/noon-ops(finance.py:2122)文案断言生效
AC-EL-FIN-C-134期间下拉(共用)筛选器同表① opsPeriod 同 state#56 两表共用期间下拉两表同步切生效
AC-EL-FIN-C-135粒度 tabs(共用)筛选器同表① stmtGrain 同 state两表共用粒度两表同步切生效
AC-EL-FIN-C-136列1 月份列label;Q 格式同表①aggregateOps分桶断言生效
AC-EL-FIN-C-137列2 品牌列brand;分组键=brand|market|期—对拍生效
AC-EL-FIN-C-138列3 市场列market(SA/AE)币种由市场决定对拍生效
AC-EL-FIN-C-139列4 Orders列int 千分位订单号去重;OPS_SUM_KEYS 求和SQL 去重对拍生效
AC-EL-FIN-C-140列5 Units Sold列int件数对拍生效
AC-EL-FIN-C-141列6 Valid Units列int六态:Valid=Units−Cancel−未妥投−CIR复算生效
AC-EL-FIN-C-142列7 Delivered列int件数六态对拍生效
AC-EL-FIN-C-143列8 Pending列int件数六态对拍生效
AC-EL-FIN-C-144列9 Cancel Order列int件数六态对拍生效
AC-EL-FIN-C-145列10 未妥投列int件数六态(undeliverable)对拍生效
AC-EL-FIN-C-146列11 CIR列int件数六态对拍生效
AC-EL-FIN-C-147列12 GMV列money 本币实值—对拍生效
AC-EL-FIN-C-148列13 Commission列money含税实扣对拍生效
AC-EL-FIN-C-149列14 Delivery列money含税实扣对拍生效
AC-EL-FIN-C-150列15 Ad Spend列money广告源为净额,按市场加 VAT(SA 15% · AE 5%)对齐对账单实扣对拍生效
AC-EL-FIN-C-151列16 Gross Profit列money,stronggross=Settlement 净额−Ad Spend(聚合后派生)复算生效
AC-EL-FIN-C-152列17 COGS列moneyCOGS=Valid Units×采购单价(SKU 映射表为准回退采购表,折本币)复算生效
AC-EL-FIN-C-153列18 Net Profit列money,strong,<0 红字net=gross−COGS复算生效
AC-EL-FIN-C-154列19 Settlement 净额列money 本币实值—对拍生效
AC-EL-FIN-C-155列20 Payout列money官方对账单打款(同表①,各账号对账单去重后求和)对拍生效
AC-EL-FIN-C-156脚注口径脚注六态口径/广告含 VAT 对齐/COGS 折本币/季/年=月值求和page.tsx:868-873文案断言生效
AC-EL-FIN-C-157列1 月份列月份/api/finance/monthly排序断言生效
AC-EL-FIN-C-158列2 项目(品牌)列项目=品牌—对拍生效
AC-EL-FIN-C-159列3 订单列订单数—对拍生效
AC-EL-FIN-C-160列4 退款单列退款单数—对拍生效
AC-EL-FIN-C-161列5 营业收入列USD—对拍生效
AC-EL-FIN-C-162列6 退款列金额—对拍生效
AC-EL-FIN-C-163列7 佣金列金额—对拍生效
AC-EL-FIN-C-164列8 履约列金额—对拍生效
AC-EL-FIN-C-165列9 VAT列金额—对拍生效
AC-EL-FIN-C-166列10 其他费列金额—对拍生效
AC-EL-FIN-C-167列11 净利润列金额fm 口径(AC-CAL-07)复算生效
AC-EL-FIN-C-168列12 账单总额列平台账单—对拍生效
AC-EL-FIN-C-169列13 结算到账列Settlements 月度—对拍生效
AC-EL-FIN-C-170列14 差额①列账单−结算,|差|>1 标 warn 色对账缺口代数复算差额=账单−结算生效
AC-EL-FIN-C-171列15 打款列金额—对拍生效
AC-EL-FIN-C-172列16 差额②列打款侧差额,|差|>1 标 warn 色—代数复算生效
AC-EL-FIN-C-173列17 广告列金额—对拍生效

§11.28 选品六外部 tab 组件内部元素(/sourcing · AC-EL-SRC-W/V/S/D/F/X 系列,源码 web/app/sourcing/{WatchTab,ViewerTab,SellerTab,DealsTab,FinderTab,VerdictsTab}.tsx;Keepa 配额池口径与缓存说明随元素记录)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-SRC-W-001Keepa 未配置空态空态EmptyState「Keepa 通道未配置」keepa_configured=false 整 tab 替换(112-118)断配置渲染生效
AC-EL-SRC-W-002KPI 监控池KPI卡count / watch_limit上限按套餐(可升级)SQL 对拍生效
AC-EL-SRC-W-003KPI 今日搜索配额KPI卡quota_left每次搜索/拉历史消耗 1 次(配额池口径)搜索后 -1生效
AC-EL-SRC-W-004KPI 每日自动刷新KPI卡KEEPA_REFRESH_UTC 常量worker 自动抓取池内全部 ASIN文案断言生效
AC-EL-SRC-W-005实时搜索卡头卡头「实时搜索 · 加入监控」+ Keepa 实时数据·消耗当日搜索配额/api/sourcing/search文案断言生效
AC-EL-SRC-W-006站点 select筛选器13 域(US…NL,WatchTab.tsx:13 逐项数;12=BR/13=AU 2026-10-21 回滚勘误)DOMAINS(13)13 项断言生效
AC-EL-SRC-W-007关键词 input输入≥2 字符校验<2 报「关键词至少 2 个字符」空/1 字符报错生效
AC-EL-SRC-W-008搜索按钮按钮搜索中…禁用态GET /search?q&domain;返回 quota_left 并 load()点击出结果生效
AC-EL-SRC-W-009错误横幅反馈红条 role=alerterr←catchrole=alert生效
AC-EL-SRC-W-010Spinner反馈「实时查询 Keepa…」searching 态加载中出现生效
AC-EL-SRC-W-011无结果空态空态EmptyState「无结果」results.length===0冷词断言生效
AC-EL-SRC-W-012结果表 8 列表格商品/Buybox/BSR/30·90 天掉榜(断货)/FBA 卖家/评分/评分数/操作SearchItem 全字段列序断言生效
AC-EL-SRC-W-013+监控按钮按钮POST /api/sourcing/watchpulled=true→「已加入监控并完成首次抓取」否则每日任务补齐点击变已监控生效
AC-EL-SRC-W-014已监控 badge徽章badge ok「已监控」watched=true 行不再显按钮重复加被拦生效
AC-EL-SRC-W-015监控池卡头卡头「监控池」每日自动刷新·近 7 日趋势迷你图/api/sourcing/watchlist文案断言生效
AC-EL-SRC-W-016池空空态空态EmptyState 引导用上方搜索items.length===0空池断言生效
AC-EL-SRC-W-017监控池表 11 列表格商品/站点/Buybox/BSR/30 天掉榜/FBA/评分/近 7 日价格/🔔提醒/快照/操作WatchItem 全字段列序断言生效
AC-EL-SRC-W-018ASIN 深链 viewer链接点击 SPA 无刷新跳价格历史 tabsetQs({mtab:viewer,…});中键/Ctrl 新开(F6);保留 href左键无刷新生效
AC-EL-SRC-W-019🛒 Amazon 外链链接amzUrl(domain,asin) 新标签stopPropagation 不触发行点击新开商品页生效
AC-EL-SRC-W-020近 7 日 sparkline图EChart h=34 线图 #4f46e5trend≥2 点否则「数据不足」悬停不抖生效
AC-EL-SRC-W-021提醒 badge徽章「监控中/已触发 ≤/≥ 目标价」每日 05:10 评估;title=已触发时间;触发后可清除重设设价后次日评估生效
AC-EL-SRC-W-022目标价 input+方向 select输入number 目标价 + ≤/≥ 下拉回车提交;价必须>0;POST /api/sourcing/watch/alert非法价报错生效
AC-EL-SRC-W-023清除提醒按钮按钮清除 badge 下的 ghost 按钮alert price=null清后回输入态生效
AC-EL-SRC-W-024快照日期列列as_of 取 MM-DD—对拍生效
AC-EL-SRC-W-025移除按钮按钮confirm「移除监控 {asin}?历史快照保留」DELETE /api/sourcing/watch/{wid}移除后行消失生效
AC-EL-SRC-W-026详情 drawer弹层行点击开 drawer-mask maxWidth 640setDetail(it)点遮罩关闭生效
AC-EL-SRC-W-027drawer 元信息静态站点·ASIN·Buybox·BSR·评分detail 字段对拍生效
AC-EL-SRC-W-02890 天历史图图新品价线(#4f46e5)+BSR 副轴(#d97706 反转)GET /product?asin&domain(耗 1 配额);无序列提示拉后 load()生效
AC-EL-SRC-W-029零配额说明+拉取按钮按钮「详情默认展示池内已有快照(零配额消耗);拉取 90 天完整历史会消耗 1 次搜索配额」配额披露文案(281-283)文案断言生效
AC-EL-SRC-W-030drawer 移除/关闭按钮底部 ghost 移除监控/关闭—关闭清 detail生效
AC-EL-SRC-V-001国家 select筛选器KEEPA_COUNTRIES 13 站AE/SA/SE 不采集被收窄(F2 修,选中必 400)13 项断言生效
AC-EL-SRC-V-002ASIN input输入mono 大写自动转,10 位校验^[A-Z0-9]{10}$ 否则报错(67)非法 ASIN 报错生效
AC-EL-SRC-V-003查看价格历史按钮按钮载入中…禁用GET /api/sourcing/price-history?country&asin&range&live点击出档案生效
AC-EL-SRC-V-004时间档 pills筛选器全部/3年/1年/90天/30天RANGES;source≠none 才显示切档重载生效
AC-EL-SRC-V-005错误横幅反馈红条;失败时清空旧 data 防残留误导(F4 修)err←catch;setData(null)断网断言生效
AC-EL-SRC-V-006Spinner反馈「读取时序…」busy 态加载中出现生效
AC-EL-SRC-V-007无数据空态空态EmptyState「该 ASIN 尚未采集入库(无数据)」+ 实时拉取按钮(1 配额,24h 缓存)+ 🛒 外链source=none(205-216);live=1 重查点拉取出图生效
AC-EL-SRC-V-008档案卡头卡头标题(回退 ASIN)+ 国家·ASIN + 🛒 小外链meta.title||asin对拍生效
AC-EL-SRC-V-009🛒 在 Amazon 打开按钮按钮数据视图保留醒目外链2026-10-07 用户令「拉取完历史后 Amazon 按钮不能消失」拉后仍在生效
AC-EL-SRC-V-010KPI 品牌KPI卡meta.brand 回退 ——对拍生效
AC-EL-SRC-V-011KPI 当前 BSRKPI卡bsr_current,foot=月销 monthly_sold—对拍生效
AC-EL-SRC-V-012KPI BuyBoxKPI卡buy_box_price 本币,foot=offers 已采/未 offers 采集csv[18] 三元组(分期三 A)未采显「未 offers 采集」生效
AC-EL-SRC-V-013KPI New/AmazonKPI卡price_new / price_amazon,foot=Used·List—对拍生效
AC-EL-SRC-V-014KPI 评分/评论KPI卡rating .1f / reviews,foot=上市 listed_since—对拍生效
AC-EL-SRC-V-015KPI 时序覆盖KPI卡首日→末日,foot=N 序列·M 点span=全部序列 min/max对拍生效
AC-EL-SRC-V-016数据源 badge徽章「本库 csv 时序(零 token)」ok /「Keepa 实时拉取(1 配额)」+「·缓存」source=local|live;cached冷/热查对比生效
AC-EL-SRC-V-017BuyBox 时序 badge徽章「已解锁(offers 采集)」/「无数据(待 offers 采集铺开)」series.buy_box_price≥2 点判未铺开 ASIN 显灰生效
AC-EL-SRC-V-018价格历史图图7 线:Amazon 橙/New 蓝/Used 绿/List 紫/收藏棕/秒杀红/BuyBox 黑;dataZoom 滚轮+滑条PRICE_LINES 配色对照 Keepa;≥2 点才画线图例可切换生效
AC-EL-SRC-V-019Keepa 官方原图卡图90/365 天 tab + /api/sourcing/keepa-graph 代理 PNG w900 h3201 配额/图;同参数 90min Keepa 侧免配额;redis 5400s;key 不出后端;截不到=无价格记录二次加载 0 配额生效
AC-EL-SRC-V-020BSR 排名历史图图y 轴反转(小=好)#d97706rank 序列方向断言生效
AC-EL-SRC-V-021报价数历史图图New/Used/收藏品卖家数三线count_* 序列图例断言生效
AC-EL-SRC-V-022评分·评论增长图图左轴评分 0-5 紫 / 右轴评论数灰rating+reviews 双序列双轴断言生效
AC-EL-SRC-V-023🔔 价格提醒卡头卡头worker 每日 05:10 刷新后评估·触发邮件企业 owner·改价重新武装/api/sourcing/watch/alert文案断言生效
AC-EL-SRC-V-024已设 badge徽章「已设: 现价 ≤/≥ 目标价 · 已触发时间(改价可重新提醒)/监控中(每日评估)」alert_active;notified_at触发后显示生效
AC-EL-SRC-V-025未设提醒 badge徽章「未设提醒(已关注)」watch 存在但无提醒对拍生效
AC-EL-SRC-V-026目标价+方向+设置按钮输入number+below/above select+设置/更新价>0 校验;POST alert非法价报错生效
AC-EL-SRC-V-027清除提醒按钮按钮仅 alert_active 时显示price=null清后回未设生效
AC-EL-SRC-V-028一键「关注+设提醒」按钮未关注 ASIN:目标价+方向+「🔔 关注 + 设提醒」POST /watch 再 /watch/alert 链式;meta 缺失则提示先去监控池未关注流程生效
AC-EL-SRC-V-029无档案提示空态「该 ASIN 不在干净层档案(仅时序),请在监控池…」watch=null 且 meta=null对拍生效
AC-EL-SRC-V-030初始空态空态EmptyState「输入 ASIN 查看价格历史」!data&&!busy;其他 tab 可深链跳入冷启动断言生效
AC-EL-SRC-V-031提醒口径脚注脚注现价=最新快照 BuyBox(缺省回退 New);一次性触发;重设自动重新武装—文案断言生效
AC-EL-SRC-S-001卖家情报卡头卡头「🏪 卖家情报」+ 热销商家列表/卖家查询对照声明口径脚注:热销榜=本站已铺开 ASIN 池 BuyBox 赢家数(零 token);/seller Δ1 token/家;不冒充 pro/sellerfinder 内部端点文案断言生效
AC-EL-SRC-S-002站点 pills筛选器KEEPA_COUNTRIES 13 站F2 修:AE/SA/SE 选中必 400 已收窄13 项断言生效
AC-EL-SRC-S-003口径脚注脚注热销榜/卖家档案/官网类目筛选三段口径page 190-194文案断言生效
AC-EL-SRC-S-004错误横幅反馈红条 role=alerterr←catchrole=alert生效
AC-EL-SRC-S-005热销商家列表卡头卡头按池内 BuyBox 赢家数降序·点行查档案·未拉档案显「未入库」/api/sourcing/sellers/top?country&limit=50文案断言生效
AC-EL-SRC-S-006热销表 11 列表格#/卖家 ID/名称/池内 BuyBox 赢家/均值价/样本 ASIN/评分/评分数/FBA/中国发货/店铺在架TopResp.sellers列序断言生效
AC-EL-SRC-S-007未入库占位空态名称列 muted「未入库」seller_name null对拍生效
AC-EL-SRC-S-008样本 ASIN 链接链接前 2 个 ASIN:深链 viewer+🛒goViewer SPA 无刷新点击跳 viewer生效
AC-EL-SRC-S-009热销空态行空态colSpan=11「该站点池内尚无 BuyBox 卖家数据(需 offers 采集铺开)」sellers.length===0冷站断言生效
AC-EL-SRC-S-010卖家查找卡头卡头/sellerquery 官网检索同款 — 10 配额+1/百家·至少一个筛选·10 分钟缓存POST /api/sourcing/seller-finder?country文案断言生效
AC-EL-SRC-S-011全文检索 input输入名称/商号/地址/VAT/邮箱/ID(官网同款)search 字段词命中生效
AC-EL-SRC-S-012好评率≥ input输入0-100rating_gte阈值生效生效
AC-EL-SRC-S-013终身评分数≥ input输入—rating_count_gte阈值生效生效
AC-EL-SRC-S-014近30日评分数≥ input输入—rating_count30_gte阈值生效生效
AC-EL-SRC-S-015店铺在架≥ input输入—storefront_gte阈值生效生效
AC-EL-SRC-S-016FBA select筛选器不筛/用过 FBA/没用过 FBAhas_fba true/false筛选生效生效
AC-EL-SRC-S-017排序 select筛选器评分数最多/好评率最高/店铺在架最多sort=count|rating|storefront首行随排序变生效
AC-EL-SRC-S-018公司地址国 pills筛选器14 国 ISO 多选=任一,全不选=不筛address_country 小写数组多选生效生效
AC-EL-SRC-S-019查找按钮按钮「🔍 查找卖家(10 配额+1/百家)」postJson seller-finder点击出 ID 表生效
AC-EL-SRC-S-020命中计数+缓存徽标反馈「命中 N 家」+「缓存命中(0 token)」绿字total+cached10min 内复点 0 token生效
AC-EL-SRC-S-021结果 ID 表表格#/卖家 ID/查档案按钮(3 列)ids 每页 100对拍生效
AC-EL-SRC-S-022查档案按钮按钮逐家调卖家查询解析lookupQuery(id)点开出档案生效
AC-EL-SRC-S-023翻页器分页上一页/下一页,第 N 页·本页 X 家;上限 1 万page*per_page≥10000 禁下一页末页禁用生效
AC-EL-SRC-S-024无命中说明空态「Keepa 对无值字段不索引——『无评分』和『0% 好评』不同」ids.length===0空条件断言生效
AC-EL-SRC-S-025最高评分卖家榜卡头卡头/topseller 全库按评分数排序(日更)— 固定 50 配额·24h 缓存命中零配额GET /api/sourcing/topsellers?country文案断言生效
AC-EL-SRC-S-026BR 不可用提示空态「BR 域该端点官方不可用,请换站点」country===BR 分支选 BR 断言生效
AC-EL-SRC-S-027拉取/刷新按钮按钮「🏅 拉取最高评分卖家榜(50 配额)」/「刷新榜单(50 配额)」loadTs点击出榜生效
AC-EL-SRC-S-028全库计数+缓存徽标反馈全库 N 家·展示前 M + 缓存命中(0 token)total_ids+ids.length24h 内复点 0 token生效
AC-EL-SRC-S-029榜 ID 表表格#/卖家 ID/查档案(前 200 控制体积)ids对拍生效
AC-EL-SRC-S-030榜单口径脚注脚注全库口径(非本站池内)·日更·可达 10 万 ID 取前 200—文案断言生效
AC-EL-SRC-S-031卖家查询卡头卡头13~14 位 ID 直查(零 token)·名称检索已拉库·未入库可实时拉取(1 配额)GET /api/sourcing/seller-lookup?country&q&live文案断言生效
AC-EL-SRC-S-032ID/名称 input输入mono 大写;ID 正则 ^A[A-Z0-9]{12,13}$ 种子跳入vseller 深链对拍生效
AC-EL-SRC-S-033⚡实时拉取档案按钮按钮「1 配额, Δ1 token」入库常驻live=1;found 后标记「刚实时入库」点击入档案生效
AC-EL-SRC-S-034名称无匹配提示反馈hint+「当前已拉 N 家」mode=name&&!found对拍生效
AC-EL-SRC-S-035ID 未命中 hint反馈hint 文本mode=id&&!found对拍生效
AC-EL-SRC-S-036名称匹配表表格卖家 ID/名称/池内赢家/评分/评分数(5 列)行点击转 ID 查matches[]点行出档案生效
AC-EL-SRC-S-037档案 KPI×6KPI卡卖家(商号·刚实时入库)/评分评分数(近30天评价)/池内赢家+ASIN 链/BuyBox 新品占有率(二手·均竞争)/FBA·中国发货(店铺在架·追踪自)/档案更新(评分更新)Profile 全字段对拍生效
AC-EL-SRC-S-038评分历史图图0-100 线图;Amazon 自营 ATVPDKIKX0DER 空态=真值说明rating_series(Keepa csv[0])自营显真值提示生效
AC-EL-SRC-S-039评价数四窗表表格30/90/180/365 天评价数+好评%rating_count_*+positive_*对拍生效
AC-EL-SRC-S-040主营品牌 Top 表表格品牌/产品数/均 BSR(30d)/含自营(前 8)brand_stats对拍生效
AC-EL-SRC-S-041主营类目 Top 表表格类目/catId/产品数/均 BSR(30d)/含自营(前 10);池外类目显「池内未收录」缺名不猜category_stats缺名断言生效
AC-EL-SRC-S-042BuyBox 竞争者 chips按钮组sellerId+percent% 点击查档案competitors[]点 chip 出档案生效
AC-EL-SRC-S-043地址/电话行静态地址 · 电话(Keepa 公开档案)address/phone 有则显对拍生效
AC-EL-SRC-D-001促销流卡头卡头「⚡ 促销流」Keepa /deal 实时降幅榜 — 近 12 小时内有变价的产品/api/sourcing/deals文案断言生效
AC-EL-SRC-D-002站点 pills筛选器Keepa 13 域全集(AE/SA/SE 无 Keepa 域显式不提供)DEAL_COUNTRIES=KEEPA_COUNTRIES 单源13 项断言生效
AC-EL-SRC-D-003价格类型 select筛选器9 项:新品市场价/Amazon 自营价/BuyBox 含运费/New FBA/二手价/秒杀/仓储/翻新/销量排名price_type 1/0/18/10/2/8/9/6/3切换列头变(排名型)生效
AC-EL-SRC-D-004时间窗 select筛选器近 24 小时/7 天/31 天/90 天date_range 0-3切换重拉生效
AC-EL-SRC-D-005排序 select筛选器百分比降幅/绝对降幅/最新变价/销量排名sort 4/2/1/3首行随排序变生效
AC-EL-SRC-D-006拉取按钮按钮「⚡ 拉取促销流(5 配额/页)」GET /deals?country&price_type&date_range&sort&page点击出表生效
AC-EL-SRC-D-007口径脚注脚注只含近 12h 变价品;每页≤150 条、单查询最多翻 1 万 ASIN;时间窗越短降幅越显著;结果缓存 30 分钟命中不耗配额—文案断言生效
AC-EL-SRC-D-008当前条件+缓存徽标反馈「当前: 价格类型·窗口·排序」+ 缓存命中(0 token)绿字price_type_name+cached30min 内复点 0 token生效
AC-EL-SRC-D-009错误提示反馈红字 ⚠err←catch对拍生效
AC-EL-SRC-D-010结果表 12 列表格#/图/ASIN/标题/类目/现价(现排名)/窗口均价(均排名)/降幅/降幅%/BSR/变价时间/操作DealRow 全字段;is_rank 切换列头与格式列序断言生效
AC-EL-SRC-D-011行缩略图图36×36 containimg null→—对拍生效
AC-EL-SRC-D-012秒杀至标记标记「⚡秒杀至{end}」橙字lightning_end 有则显对拍生效
AC-EL-SRC-D-013📈 历史按钮按钮跳价格历史 tab(种子 viewer)setQs({mtab:viewer,…})点击跳转生效
AC-EL-SRC-D-014🛒 行外链链接ASIN 合法才显^[A-Z0-9]{10}$新开商品页生效
AC-EL-SRC-D-015翻页器分页上一页/下一页;第 N 页·本页 X 条(<150=已到末页)page 150/页末页禁用生效
AC-EL-SRC-D-016无变价空态空态「该站点×组合近 12 小时没有变价产品(非站点不可用)」+ 三条建议rows.length===0冷组合断言生效
AC-EL-SRC-D-017初始空态空态「选好站点与条件后点拉取…30 分钟内重复拉取走缓存不耗配额」!data冷启动断言生效
AC-EL-SRC-D-018秒杀专场卡头卡头/lightningdeal 近 4 天 Lightning Deals(含过期),全表一次 500 配额/api/sourcing/lightning?country&state&asin文案断言生效
AC-EL-SRC-D-019状态过滤 select筛选器6 态:进行中/候补中/已抢完/候补满/已结束/已下架LT_STATES切换重拉生效
AC-EL-SRC-D-020单 ASIN input输入mono 大写 B0XXXXXXXX;回车查单条asin 参数(1 配额)对拍生效
AC-EL-SRC-D-021查单条按钮按钮「查单条(1 配额)」仅填 ASIN 时显示loadLightning(asin)点击出单行生效
AC-EL-SRC-D-022全表二次确认按钮按钮两段式:先「⚡ 拉取秒杀全表(500 配额,需二次确认)」→「⚠ 再点一次确认拉全表(500 配额)」橙底ltArmed armed 态;Keepa 最贵端点首点不拉生效
AC-EL-SRC-D-023秒杀口径脚注脚注全表=近 4 天全部(含过期)固定 500 配额;缓存 60 分钟零配额;dealPrice「—」=未开始(官方 -1 哨兵)—文案断言生效
AC-EL-SRC-D-024秒杀表 13 列表格#/图/ASIN/标题(+变体)/秒杀价/现价/折扣/已领/状态(🅿)/起止 UTC/卖家(·FBA)/评分/操作LightningRow 全字段列序断言生效
AC-EL-SRC-D-025秒杀价哨兵列列deal_price null→「—」=秒杀未开始官方 -1 哨兵转 null未开始断言生效
AC-EL-SRC-D-026Prime 标记标记🅿 角标 title=Prime 资格is_prime对拍生效
AC-EL-SRC-D-027卖家列列seller_name||seller_id(title=ID)+·FBAis_fba对拍生效
AC-EL-SRC-D-028秒杀行操作按钮📈 历史 + 🛒同促销流跳 viewer生效
AC-EL-SRC-D-029无秒杀空态空态「该站点×状态×ASIN 近 4 天没有秒杀记录」deals.length===0对拍生效
AC-EL-SRC-F-001产品查找卡头卡头Keepa Product Finder 官方筛选 — 10 配额+1/百 ASIN,同条件 10 分钟缓存POST /api/sourcing/finder?country文案断言生效
AC-EL-SRC-F-002站点 pills筛选器Keepa 13 域全集(AE/SA/SE 无 Keepa 域)FINDER_COUNTRIES 单源13 项断言生效
AC-EL-SRC-F-003标题关键词 input输入引号=短语,-词=排除title 字段短语命中生效
AC-EL-SRC-F-004品牌 input输入逗号/中文逗号分隔=任一brand[] 数组多品牌命中生效
AC-EL-SRC-F-005价格类型 select筛选器新品价/Amazon 自营价/BuyBox 含运费/二手价/New FBAprice_type切换生效生效
AC-EL-SRC-F-006价格区间 min/max输入本币两位 inputprice_min/price_max区间生效生效
AC-EL-SRC-F-007BSR 排名区间输入大类 min/maxbsr_min/bsr_max→Keepa current_SALES;2026-10-20 用户报「BSR 区间不可选」补 UI(后端早支持)区间生效生效
AC-EL-SRC-F-008近30日月销≥ input输入Amazon 搜索页口径,多数 ASIN 无值monthly_sold_gte对拍生效
AC-EL-SRC-F-00930天掉榜≥ input输入估算销量口径drops30_gte对拍生效
AC-EL-SRC-F-010评分≥ input输入0-5 星 step 0.1rating_gte对拍生效
AC-EL-SRC-F-011评论数≥ input输入—reviews_gte对拍生效
AC-EL-SRC-F-012总报价数≤ input输入竞争热度offers_lte对拍生效
AC-EL-SRC-F-013Amazon 自营状态 select筛选器不筛/自营现货/无自营报价/自营预售/自营补货amazon_offer对拍生效
AC-EL-SRC-F-014BuyBox 归属 select筛选器不筛/BuyBox=Amazon 自营/BuyBox≠自营buybox_is_amazon对拍生效
AC-EL-SRC-F-015排序 select筛选器销量最好(BSR)/月销最高/价格低→高/价格高→低/评论最多sort首行随排序变生效
AC-EL-SRC-F-016查找按钮按钮「🎯 查找产品(10 配额 + 1/百ASIN)」至少填一个筛选(否则 Keepa 400)load(0)点击出结果生效
AC-EL-SRC-F-017默认窗提示提示「不填上架时间默认限近 6 个月;完整筛选族(60+)见官方文档,此处为精选白名单」—文案断言生效
AC-EL-SRC-F-018错误提示反馈红字 ⚠err←catch对拍生效
AC-EL-SRC-F-019结果卡头卡头「命中 N 个 ASIN · 第 N 页(每页 50, 上限 1 万)」+ 缓存命中(0 token)FinderResp.total/page/cached10min 复点 0 token生效
AC-EL-SRC-F-020翻页+导出工具条上一页/下一页 + ⬇ 导出 Excel(enrich 成功才显)exportTableXls(tblRef,'finder')导出行数=本页生效
AC-EL-SRC-F-021详情配额提示提示「详情 1 配额/ASIN(逐 ASIN 24h 缓存,翻页复查 0 配额);点 ASIN/标题跳价格历史」/api/sourcing/enrich 自动链式复拉 0 配额生效
AC-EL-SRC-F-022详情加载/失败提示反馈⏳ 拉取五字段中… / ⚠ 失败(仍显示 ASIN 网格)eloading/eerr失败回退网格生效
AC-EL-SRC-F-023品牌销量占比条汇总本页 N 品·近30日月销合计·X/N 有月销值 + 12 个品牌 chip(占比%)EnrichResp.brands/sold_coveragechip 合计≈100%生效
AC-EL-SRC-F-024五字段产品表 10 列表格#/图/产品/ASIN/品牌/现价/细分类目排名/近30日销量/品牌占比/操作Enriched 全字段列序断言生效
AC-EL-SRC-F-025细分类目排名列列#rank·类目;缺失回退根类目 BSR(title 披露);再缺→—subcat_rank→salesrank 回退链回退标注生效
AC-EL-SRC-F-026近30日销量列列≥10万显「10万+」;无值显灰「无值」不计分母monthly_sold封顶断言生效
AC-EL-SRC-F-027ASIN 跳转按钮按钮tab sku 样式「{asin} 📈」+行尾「📈 历史」setQs viewer 种子点击跳 viewer生效
AC-EL-SRC-F-028ASIN 网格回退态空态enrich 未就绪/失败时纯 ASIN chip 网格rows.map chip失败仍可跳生效
AC-EL-SRC-F-029无命中空态空态「该条件组合未命中任何 ASIN(近 6 个月内上架)」+ 放宽建议rows.length===0严条件断言生效
AC-EL-SRC-F-030口径脚注脚注现价=BuyBox(缺失回退新品价);细分类目排名=类目树最深层节点;月销=Amazon 搜索页口径上限 10 万;品牌占比=品牌月销合计÷本页有值 ASIN 合计—文案断言生效
AC-EL-SRC-X-001重算窗口按钮按钮「⬇ 重算窗口(雷达物化)」confirm 五类雷达去重合入+ABA≥3 期播种关注池;10 分钟冷却POST /api/sourcing/verdicts/materialize;429 时 owner/admin 可二次确认强制冷却拦截生效
AC-EL-SRC-X-002强制重算分支逻辑冷却中 owner/admin 弹「强制重算?」→ force=trueisAdmin←/api/tenant/info role429 复现生效
AC-EL-SRC-X-003Pareto 排序按钮按钮「⚖ Pareto 排序 Top30」GET /api/sourcing/verdicts/pareto?limit=30点击出表生效
AC-EL-SRC-X-004状态筛选 select筛选器全部状态/跟进/观察/放弃/主攻/杀state 参数过滤生效生效
AC-EL-SRC-X-005搜候选词 input输入回车触发 loadq 参数命中集变生效
AC-EL-SRC-X-006Pareto 卡表格排名/候选词/可用维度;四维(周期数↑ 月销↑ 评论↓ BSR↓)缺维省略不充零·仅跟进/观察候选available_dimensions join ·缺维断言生效
AC-EL-SRC-X-007决策台卡头卡头「机器永不给『主攻』;终裁必填备注;审计只追加」—文案断言生效
AC-EL-SRC-X-008候选池空态空态EmptyState 引导点「从雷达物化候选」items.length===0空池断言生效
AC-EL-SRC-X-009决策台表 12 列表格候选词/来源/周期/趋势/竞对/评论中位/月销中位/门禁/机器建议/旧裁决/状态/操作GET /api/sourcing/verdicts/candidates?state&q&limit=60列序断言生效
AC-EL-SRC-X-010来源 badges徽章上升/碎片化/隐蔽宝石/篮子/复购(SRC_CN)dimsources[]对拍生效
AC-EL-SRC-X-011趋势列列rank_slope<0 绿「变热」/>0 红「变冷」/null→—斜率符号对拍生效
AC-EL-SRC-X-012月销中位 ≈ 标记列own_src=keepa_daily 时显「≈N」title=日档回退·drops30 估算口径null 不充 0 纪律≈ 断言生效
AC-EL-SRC-X-013门禁 badge徽章「全过」ok /「6−N/6 过」warn;title=全部门禁 k:vgates PENDING 计数;缺据=PENDING 不误杀悬停列全生效
AC-EL-SRC-X-014机器建议 badge徽章有潜力 ok/数据不足 warn/观望 dim(永不 QUALIFIED)machine_rec无主攻项生效
AC-EL-SRC-X-015旧裁决 badge徽章杀 bad/副攻 warn/其余 dim+score;title=kill_reasonlegacy 历史旁证避免重复翻案对拍生效
AC-EL-SRC-X-016状态 badge徽章跟进 ok/观察 warn/放弃 dim/主攻 ok/杀 bad(state_cn)STATE_TONE对拍生效
AC-EL-SRC-X-017裁决按钮按钮行尾 ghost;打开 drawer 默认 watch→followsetDecide(c)点开 drawer生效
AC-EL-SRC-X-018加载更多按钮分页「加载更多(已显示 N 条)」60/页 offset 翻页;不满页显「已到底」items.length%PAGE!==0 禁用分页累计生效
AC-EL-SRC-X-019脚注脚注证据缺数据显 — 不按 0 计算;月销 ≈ 为 Keepa 日档回退;财务与合规门禁永久留人工;旧裁决计数动态(杀 X/副攻 Y/待验 Z)legCnt←/verdicts/legacy total_by_verdict(2026-09-26 去硬编码)计数=SQL生效
AC-EL-SRC-X-020裁决 drawer弹层「裁决 · {term}」+ 国家·来源·机器建议(机器永不终裁)decide 态 maxWidth 520点遮罩关闭生效
AC-EL-SRC-X-021状态选择按钮组输入跟进/观察/放弃/主攻/杀 五钮单选dState单选断言生效
AC-EL-SRC-X-022终裁必填警告反馈主攻/杀时橙字「⚠ 终裁必须填写备注理由(入库强校验),审计记录不可修改删除」qualified|rejected空备注提交被拦生效
AC-EL-SRC-X-023备注 textarea输入3 行;rejected placeholder=为什么杀?(写入 kill_reason)note 必填校验对拍生效
AC-EL-SRC-X-024记录/取消按钮按钮「记录裁决」POST /decision(审计不可篡改)toast「已记录」candidate_id+state+note+kill_reason提交后行状态变生效

§11.29 物流页(/logistics · AC-EL-LOG,51 条 · 2026-10-22 源码实证 web/app/logistics/page.tsx 759 行 + web/lib/logiSteps.ts 99 行 + api/routers/logistics.py 496 行,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-LOG-001页壳/面包屑导航AppShell title=物流,面包屑「国际物流跟踪 · 双清订单(公司级货代)」路由 /logistics;整页 Suspense 包裹(useQueryState 需边界);全端点 require_module("logistics")(logistics.py 各 Depends);数据经 tenant_conn(tenant, brand_scope)(铁律:企业/品牌绝对独立)e2e 登录物流模块账号断言标题与面包屑逐字一致;未开通企业断言 403生效
AC-EL-LOG-002tab 状态 URL 同步导航五 tab 选中态同步进 URL query(tab 参数)useQueryState({ tab: "tracking" }) 默认 tracking;2026-09-21 起 tab 不再是纯前端 state——刷新/分享链接不回默认 tabe2e 切到 pricing 后刷新断言仍停 pricing生效
AC-EL-LOG-003数据接口·船票列表接口GET /api/logistics/shipments?badge&search&brand&page&page_sizelogistics.py:141-195;前端 pageSize=20,服务端 page_size=min(100,max(1,·));search 六字段 ILIKE(awb/remark/products_text/city/product_name/model_number);排序 stage_overdue DESC, ship_date DESC(超期置顶);响应含 total/page/page_size/stats/by_badge/items接口直调断言分页 clamp(page_size=999→100);翻页 total 不变生效
AC-EL-LOG-004KPI·在途KPI 卡卡面标签「在途」·运输中票数(badge=TRANSIT)stats.transit=count(*) FILTER(badge='TRANSIT');foot=「待离港 {awaiting} · 清关中 {customs}」两计数并列展示(page.tsx:96,非相加);stats 为与明细同源实时聚合(2026-09-26 B批P2-3,logistics.py:156-170;旧 logistics_stats 快照表停在 09-05 与 RLS 品牌键不可见两问题一并消除,旧表退役留档)SQL 同口径复算 transit/awaiting/customs 与接口 stats 比对生效 reg:id10
AC-EL-LOG-005KPI·累计签收KPI 卡卡面标签「累计签收」·已签收票数(ok 色)+ foot「历史累计 N 票 · 截至 as_of」stats.delivered=count FILTER(badge='DELIVERED');total=筛选品牌内全部票;as_of=max(coalesce(nullif(latest_event_time,''), ship_date::text))(logistics.py:166)SQL 复算三值;断言 as_of=最新轨迹时间或发货日兜底生效 reg:id10
AC-EL-LOG-006KPI·阶段超时KPI 卡卡面标签「阶段超时」·超期票数(danger 色)+ foot「需跟进货代 · 在册 N 票」stats.stage_overdue=count FILTER(stage_overdue);foot 在册数=by_badge 各档 count 合计;stats=null(企业 0 票,st[0] 真值判断)时 KPI 显「—」不显 0(P3 缺陷④polish:误导性 0 同禁)空企业断言「—」;SQL 复算 stage_overdue 计数生效 reg:id10
AC-EL-LOG-007KPI·动态徽章卡KPI 卡by_badge 前两档各一卡:label + count + 「{int(weight)} kg 合计」by_badge=GROUP BY badge,badge_label ORDER BY count DESC(logistics.py:171-175),weight=sum(weight)::float8;前端 slice(0,2) 取前两卡SQL 复算 by_badge 顺序与 weight 合计生效 reg:id10
AC-EL-LOG-008状态筛选 BADGES筛选TRANSIT 运输中/CUSTOMS 清关中/AWAITING 待离港/INF 已收件/DELIVERED 已签收/空=全部BADGES 常量六项;badge→SQL s.badge=· 精确等值;与 KPI/表格同请求e2e 逐项断言 items 全部行 badge 一致生效
AC-EL-LOG-009徽章配色 BADGE_CLS样式TRANSIT:ok CUSTOMS:warn AWAITING:warn INF:dim DELIVERED:ok;未知回退 dim文案=badge_label 空则回退 badge;映射表驱动非逐条 if构造未知 badge 行断言 dim生效
AC-EL-LOG-010搜索框筛选按运单号/备注/产品/城市/型号等检索search 六字段 ILIKE(同 003 where);提交后过滤表格与计数搜已知 AWB 断言命中;搜不存在串断言空态生效
AC-EL-LOG-011⬆ 导入运单 CSV 按钮按钮/上传上传货代运单报表;title=「上传货代运单报表 CSV(列名中英文均可:运单号/品牌/目的国/发货日期/最新轨迹…),按 运单号+品牌 幂等去重」;成功 toast「导入完成:处理 N 票」,skipped>0 时追加「 · 跳过 M(缺运单号/品牌)」(page.tsx:70 d.skipped 三元,0 跳过则无此段)POST /api/logistics/shipments/import?brand=(FormData file);logistics.py:71-138;2026-09-21 补采集缺口:燕文 API 凭据未到位前数据通道=货代报表手动上传(与广告上传同模式)e2e 上传样例 CSV 断言 toast 数字与 DB 行数一致;重复上传断言幂等(不增行)生效
AC-EL-LOG-012导入后端契约接口列名映射/幂等/归一规则logistics.py:35-52 _SHIP_COL_MAP 标准列↔中英别名(匹配小写去空格,首个命中生效);限 10MB(超限 400「文件超限(10MB)」)、空文件 400;utf-8-sig 解码容错 BOM;缺运单号列 400(回显支持别名清单);ship_date/latest_event_time 解析失败保原串;weight 正则剔除非数字;未登记品牌(tenant_brands is_active)行跳过——RLS 对越权 INSERT 抛 InsufficientPrivilege 裸 500 的前置防护;ON CONFLICT (brand,awb) DO UPDATE UPSERT 幂等;badge 归一 _ship_badge 关键词(签收/delivered→DELIVERED、清关/customs→CUSTOMS、awaiting/待取/待派→AWAITING、转运/运输/transit 等→TRANSIT、默认 INF);audit logistics.shipments.import中英列名双份 CSV 各传一次断言同结果;未登记品牌行断言 skipped 计数;audit 表留痕生效
AC-EL-LOG-013Tracking 表·列 产品名/型号表格列两行:product_name(strong)+ t2「型号 · AWB」product_name/model_number 为产品对齐核心(同全站);空 product_name 回退型号行展示抽行与源表 product_name/model_number 比对生效
AC-EL-LOG-014Tracking 表·列 AWB 提单号表格列AWB + overdue 时叠加「超时」bad badgeawb 直显;stage_overdue 服务端置位(同步层),前端只渲染超期行断言 badge 出现;正常行断言无生效
AC-EL-LOG-015Tracking 表·列 路线表格列「from → to · city」from_country/to_country/city 三字段拼接抽行比对生效
AC-EL-LOG-016Tracking 表·列 重量kg表格列右对齐 toFixed(1)weight float8;null 显「—」无重票断言「—」生效
AC-EL-LOG-017Tracking 表·列 发货日表格列muted 日期文本ship_date 字符串直显(YYYY-MM-DD)抽行比对生效
AC-EL-LOG-018Tracking 表·列 状态表格列/badge状态徽章(同 009 配色)BADGE_CLS 回退 dim;文案 badge_label 空则回退 badge同 009生效
AC-EL-LOG-019Tracking 表·列 载货表格列ellipsis 单行截断 maxWidth 220pxproducts 空则回退 remark 再空显「—」;title=remark 悬停看全长品名断言截断样式与 title生效
AC-EL-LOG-020Tracking 表·列 最新轨迹表格列event 文本 + 时间latest_event + latest_event_time(T 换空格、截前 16 字符)抽行断言格式生效
AC-EL-LOG-021Tracking 表·空态空态「无匹配船票」items 空时整行替换 colSpan=8(含筛选/搜索无命中)无命中搜索断言文案生效
AC-EL-LOG-022Tracking 表·分页器分页「共 {total} 行 · 第 {page} / {pages} 页」+ 上一页/下一页服务端 LIMIT/OFFSET;边界页按钮 disabled;切页保持 badge/search/brand末页断言下一页 disabled生效
AC-EL-LOG-023行点击·轨迹抽屉抽屉drawer-mask + maxWidth 760 抽屉;标题「运单 {awb} · 轨迹详情」+ 路线摘要行行 onClick setDetail;traces 来自接口 rows[].traces(time/st/desc/loc 四字段,logistics.py:191-192)e2e 点行断言抽屉开、AWB 正确生效
AC-EL-LOG-024抽屉·15 段节点 stepper(logiSteps.ts:15-20 实 15 项,文件头「14 段」注释陈旧)可视化全流程节点横向圆点条buildSteps(web/lib/logiSteps.ts:69-99,纯函数移植旧系统权威映射表);STAGE_LABELS 15 段(0 收件→14 签收,含出口/进口申报·查验·放行·离港到港·海外总仓·派送·零售仓);STAGE_MAP 燕文状态码→段;缺状态码走 KW 关键词兜底(签收/派送/清关/查验/运输/收件);轨迹先按时间倒序规范化;每节点 time/note 小字;cls:current=brand 色+boxShadow、inspect=warn(INSPECT_STAGES={3,9} 出/进口查验段)、done=ok、pending=#e4e7ec、overdue=danger构造含查验码(91/92)与 ETA 轨迹断言 warn 标注与 ETA note;单测 buildSteps 纯函数逐码表抽验生效
AC-EL-LOG-025节点·超期判定口径节点「超期」徽标规则未签收且已到节点 >7 自然日未推进(OVERDUE_DAYS=7)且非运输段(TRANSIT_STAGE=6 豁免——海运以 ETA note 提示代替);delivered=reached≥14 或 =13(已入零售仓视同妥投);与页脚口径句逐字一致造 8 天前「已离港」未签收票断言 overdue;运输中 8 天断言不 overdue生效
AC-EL-LOG-026抽屉·原始轨迹列表列表新→旧时间序;maxHeight 260 滚动traces 按 time 倒序渲染;空态「无轨迹明细」断言首行时间≥次行;无轨迹票断言空态生效
AC-EL-LOG-027抽屉·关闭按钮mask 点击与关闭按钮双通道关抽屉setDetail(null);无路由变化e2e mask 点击+关闭按钮断言关闭(无 Esc 监听,page.tsx:193-241)生效
AC-EL-LOG-028页脚口径(受保护文案)口径「数据源:货代运单报表(⬆ 导入运单 CSV 手动导入 · KPI 实时聚合;货代 CSS 双清渠道,公司级发货,归母账号品牌隔离)。状态:已收件 → 待离港 → 运输中 → 清关中 → 已签收;表格/KPI「超时」= 超过货代时效节点,节点「超期」= >7 自然日未推进且未签收(运输段豁免)。采集管道接入后自动刷新。」(page.tsx:243 起)前两句已由源码证实(手动导入=011/012、实时聚合=004、状态机=008、超期=025);末句「采集管道接入后自动刷新」为承诺句——当前采集管道未接(数据通道=手动导入,logistics.py:74-76 注释),「自动刷新」尚无实现载体;2026-10-22 用户确认管道规划=燕文 API 接入(与 logistics.py 文档串「燕文 API 凭据到位前的数据通道=货代报表手动上传」一致;/opt/collection 无燕文代码)——承诺句保留,待凭据到位+管道接通回验自动刷新兑现后转生效文案与库内记录逐字 diff;待核:燕文 API 管道接通后回验自动刷新是否兑现,届时本条转 p-ok待核
AC-EL-LOG-029五 tab 导航导航📦 Tracking/➕ Create Shipment/⚙️ Parameters/📊 Pricing 报价/📚 参考附录 Referencetab 值同步 URL(002);五 tab 分别对应下列 030-050 组e2e 逐 tab 断言渲染容器生效
AC-EL-LOG-030Create·地址 select输入空选项=默认地址;选项「{label 空取 id} · {country} {cityName}」地址簿来自 params.addresses(默认地址 is_default=true);提交时 address_id 传后端(见 035 合并顺序)e2e 切地址下单 dry-run 断言返回 address 变化生效
AC-EL-LOG-031Create·产品 select输入选项「{code} — {name}」默认首项GET /api/logistics/products(logistics.py:243-246)返 LOGISTICS_PRODUCT_CATALOG 19 型号(199-219 行:Airfit/Luna Neo/T03/T11/J80/H24/Clip04 系列,各含 weight/hs=8543709990/value 申报值)接口断言 19 项且 code 唯一生效
AC-EL-LOG-032Create·数量输入number input min=1 默认 100qty≤0 后端 400「Quantity must be > 0」;非法串归 0 同 400submit qty=0 断言 400生效
AC-EL-LOG-033Create·虚线预览卡反馈「{code} × {qty} = {weight} kg · HS {hs} · 申报 ${value} · 合计 ${(value×qty).toFixed(2)}」weight=product.weight×qty(与后端 round(·,2) 同式);HS/value 取目录常量改数量断言合计随动且与 dry-run 返回 weight 一致生效
AC-EL-LOG-034Create·🔍 校验 Dry-Run按钮只校验不外呼;成功显「✓ 校验通过: {product} × {qty} = {weight}kg」/失败「✗ {detail}」POST /api/logistics/create body dry_run=1(logistics.py:425-427):返回 ok/dry_run/product/qty/weight/address,不调 Vnlin、不占幂等锁断言响应无 order_id;网络层断言无外呼生效
AC-EL-LOG-035Create·🚀 真实下单按钮/接口两步创建双清运单;成功「✓ 下单成功: 订单号 {order_id}」logistics.py:383-496:①POST {OMS}/api/doubleClearance/create 取 orderId ②POST /api/doubleClearance/packageBox 提交箱单(cartonNumber=1、hsCode、price=value、totalAmount=value×qty、箱规 60×40×30cm、volume=60×40×30/1e6、Brand/NonBattery);参数合并顺序=默认→logistics_params 存档→body.params→地址簿(address_id→is_default→首个,九字段覆盖);weight=round(weight×qty,2);幂等锁 Redis SET NX 600s 指纹 sha1(order_body)(B批P2-4 2026-09-26),窗口内重复提交 409;VNLIN 凭据缺失 503;步骤②失败=502 如实报错带 order_id(「请勿重复下单,请在 Vnlin 后台…补录箱单」,半成功不再 ok:True)+ audit 记 HALF_FAIL同参双击断言第二笔 409;mock 箱单失败断言 502 带 order_id;audit 留痕 HALF_FAIL生效
AC-EL-LOG-036Create·警示文案文案「真实下单会调 Vnlin OMS 外部 API 创建运单, 谨慎点击」(page.tsx:332,半角逗号+空格)常驻 muted 提示;下单按钮在 busy 或未选产品时禁用文案逐字 diff;未选产品断言按钮禁用生效
AC-EL-LOG-037Parameters·读接口接口GET /api/logistics/paramslogistics.py:248-272:存档与 LOGISTICS_DEFAULT_PARAMS(221-229:origin=CN/serviceCode=shuangqing/transport=A/platform=NOON FLEX/storeLocation=STW/country=SA/cityName=Riyadh/destCode=Badaya/transportMode=5101/packageType=XPS/is_solely=NO/battery=0/documents=2/shopName=ONNO/shortAddressTypes=NSA)合并保证字段齐全;地址簿空时注入 addr_default(is_default=true);另返 service_codes/platforms/transports 元数据(231-239 行常量)新企业首拉断言返回默认值+默认地址生效
AC-EL-LOG-038Parameters·12 固定字段输入组origin 文本/country select(SA·AE·QA·KW 四国)/cityName/destCode/transport←meta.transports/serviceCode←meta.service_codes/platform←meta.platforms/storeLocation/shopName/packageType/battery number/documents number下拉源=接口 meta 三数组(37);文本源=params 合并结果;保存走 042e2e 断言各字段初值=默认参数生效
AC-EL-LOG-039Parameters·地址簿卡输入组label(maxWidth 200)/默认地址 checkbox(互斥)/删除按钮 + country·cityName·destCode·area·contact·mobile·address 七输入地址簿=params.addresses 列表;默认地址唯一(勾选互斥逻辑在前端 state)勾 B 默认断言 A 失去默认生效
AC-EL-LOG-040Parameters·➕ 新增地址按钮追加空白地址卡id="addr_"+Date.now() 前缀防撞;country 默认 SA;shortAddressTypes=NSA点击断言新卡出现且九输入可填生效
AC-EL-LOG-041Parameters·Remark textarea输入备注多行文本remark 字段随参数保存,下单时进 Vnlin order_body.remark存 remark 后 dry-run 响应/后台参数含该值生效
AC-EL-LOG-042Parameters·💾 保存参数按钮/接口POST /api/logistics/params;前端「✓ 已保存」/「✗」logistics.py:274-296:读旧档→白名单字段覆盖(只保留 LOGISTICS_DEFAULT_PARAMS 已知键,未知字段丢弃)→addresses 列表整体替换→UPSERT logistics_params(tenant 级 ON CONFLICT);audit logistics.params.save带未知键提交断言被过滤;audit 留痕生效
AC-EL-LOG-043Pricing·报价接口接口GET /api/logistics/pricinglogistics.py:298-304:静态读 api/data/yamwen_pricing.json(106 渠道 8 分类,公司级共享只读、不分企业);文件缺失 404「pricing data not found」接口断言渠道分组数;删文件场景(测试环境)断言 404生效
AC-EL-LOG-044Pricing·🧮 运费计算器计算器副标题「体积重 = 长×宽×高 ÷ 泡比 · 计费重 = max(实重, 体积重) · 全渠道比价」输入实重/长宽高/泡比(默认 6000);体积重=长×宽×高÷泡比、计费重=max(实重,体积重);A 模式 charged=max(计费重,min_kg)、freight=charged×per_kg+fee;B 模式 units=ceil((计费重−首重)/续重−1e-9)、freight=首重价+units×续重价+fee+干线费×计费重;结果按运费升序 top30、最低价绿色高亮(T3-1 2026-09-12 对齐 UVPVP)手算样例对拍(A/B 模式各一);断言排序与首行绿标生效
AC-EL-LOG-045Pricing·报价表 A 模式列表格列4 列:重量段 Weight(kg)/公斤运费 ¥/kg/处理费 ¥/件/最小计费 Min(kg)列集随渠道计费模式切换(A/B 二选一渲染,page.tsx:639)A 渠道断言恰 4 列表头生效
AC-EL-LOG-046Pricing·报价表 B 模式列表格列7 列:重量段 Weight(kg)/首重(kg)/首重价 ¥/续重(kg)/续重价 ¥/处理费 ¥/干线费 ¥/kg同 045 条件渲染;续重进位公式见 044B 渠道断言恰 7 列表头生效
AC-EL-LOG-047Pricing·分组/空态/脚注表格配件🌍 大洲·国家(code) 分组头行;空态「无匹配报价行」;脚注「共 {n} 行报价 · {m} 国家」;<details> 展开「价格说明 Notes ({n})」分组按报价单结构渲染;Notes 折叠块默认收起过滤无命中国家断言空态;脚注计数 SQL/JSON 对拍生效
AC-EL-LOG-048Reference·附录接口接口GET /api/logistics/appendix?ds=&limit=800&q=logistics.py:306-365:12 数据集 20.6 万行经 sync_source.qsource 只读通道查 mars 本地 amazon_analytics(shared.yanwen_appendix_dataset/row,2026-09-29 起);无 ds=meta 模式(dataset_key/title/stype/note/extra/row_count);有 ds=行模式 searchtext ILIKE;limit clamp [1,5000];字符白名单拒绝(ds=[a-z0-9_]{1,40}、q=[a-zA-Z0-9 '&.\-]{0,80}——拼 SQL 面收敛纵深防御;2026-09-17 P0 修:空 ds=合法 meta 模式原被 400);未知 dataset 404;DB 凭据未配 503ds=bad-name! 断言 400;ds=state_city&q=Riyadh 断言命中;空 ds 断言 12 节 meta生效
AC-EL-LOG-049Reference·10 类列头映射表格列REF_COLS 按数据集类型出列state_city 省份/城市/地区、uk_postcode 邮编/分类、ca_postcode 邮编/分区、aus_postcode 分区/邮编、reachable 区域/邮编、remote_reach 邮编、remote_unreach 邮编/性质、prohibited 类别/明细、vat 国家/VAT税率(小数)/无IOSS税率(小数)、hpra 类型/说明/归类/监管机构;rowToArr 按类型取值(prohibited/vat/hpra/state_city 专用分支;含中文键 区域/邮编/不通达性质;兜底 vals 前 4 或非 _search 键)逐类型抽验表头与行值列数一致生效
AC-EL-LOG-050Reference·搜索防抖与空态交互q 输入 300ms debounce 后自动刷新;空态「无数据」+「匹配「q」」回显;ℹ️ note 条默认 limit=800;note 取数据集 meta.note快速连打断言仅末次请求;无命中断言空态文案生效
AC-EL-LOG-051权限与隔离总则口径模块门+企业隔离logistics.py 全端点 Depends(require_module("logistics"));列表/导入均 tenant_conn(tenant, brand_scope);导入越权品牌行前置跳过(012)——铁律:企业/品牌绝对独立;公司级货代数据按归母账号品牌隔离(页脚口径句)跨企业 brand 参数断言空集;未开通模块断言 403生效

§11.30 Listing 页(/listings · AC-EL-LST,159 条 · 2026-10-22 源码实证 web/app/listings/page.tsx 1162 行 + listings/NoonListingTab.tsx 591 行 + upload/FilesTab.tsx 126 行 + upload/AplusTab.tsx 334 行 + web/lib/listingStatus.ts + api/routers/listing.py 1894 行·aplus.py·collab.py·noon_data.py 对应端点随条目引,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-LST-001页框架·AppShell框架title=Listing,crumb=「型号上架 · 建任务 → 规格书 → 生成 → 审核 → 批准 → 上传(全部 SKU 一次走完)」AppShell 共享组件(AC-EL-SHELL 系列);page.tsx:477 逐字;品牌上下文来自顶栏 BrandContext(page.tsx:83)e2e 路由可达 + title/crumb 逐字比对生效
AC-EL-LST-002页级 tab 条(7 键)页签顺序固定:任务 / 导出回流 / 资源(模板 / 文件 / A+) / 体检 / 📋 noon SKU 清单 / 🚀 noon 建品向导 / 🗂 noon 任务与 QC;点击切换,选中加 on 态Tab 类型 7 值数组 page.tsx:85,481;B2(2026-10-14) 新旧并轨——原 NoonListingTab 自带第二套 tab 栏提升进本页(page.tsx:84 注释);tab 不写 URL渲染数 tab 数=7 与顺序逐字;点击切换内容区生效
AC-EL-LST-003?edit= 深链初始 tab路由URL 带 edit 参数时初始落在「🚀 noon 建品向导」tab,否则「任务」page.tsx:86-87 useState 惰性初始化读 location.search;配合 NoonListingTab 编辑态(LST-130)带/不带 ?edit= 各访问一次断言初始 tab生效
AC-EL-LST-004目录加载·/api/listing/meta数据源页面挂载即取目录:platforms/marketplaces/categories/brands/model_numbers/templates 六段GET /api/listing/meta(page.tsx:115-117;listing.py:422-459);platforms/marketplaces/categories 来自全局库表,brands=tenant_brands is_active 且按员工品牌范围收敛(listing.py:440-443);model_numbers=sku_mapping 按品牌 DISTINCT coalesce(model_number,model_name,product_name)(listing.py:448-451);templates=listing_library 表按企业品牌过滤(listing.py:454-457)响应六键齐备;brands ⊆ tenant_brands;model_numbers 键=brands生效
AC-EL-LST-005任务列表加载·逐页取满数据源任务 tab 数据:page_size=100 起取,不足 min(total,1000) 则逐页 concat 至取满GET /api/listing/tasks(page.tsx:118-133;listing.py:667-698);型号分组视图依赖全量行(page.tsx:120 注释);失败保持旧值不toast(page.tsx:132);tasksTotal=接口 total构造 >100 行任务断言一次取满;total 与表头计数一致生效
AC-EL-LST-006型号上架卡头标题h2「型号上架」+ sub「第 0 步建任务 → 规格书 → 生成 → 审核 → 批准 → 上传 · 全部 SKU 一次走完(title/五点/描述共用)」page.tsx:489 逐字文案逐字比对生效
AC-EL-LST-007品牌徽标徽标已选品牌=绿色 badge 显示品牌名;未选=红 badge「先在顶栏选品牌」顶栏 BrandContext brand(page.tsx:83,491-492);2026-09-21 品牌继承顶栏——新建任务少一个下拉且不可能串品牌(page.tsx:83 注释);铁律:品牌绝对独立切换顶栏品牌断言徽标随动;未选时创建按钮 disabled生效
AC-EL-LST-008型号下拉下拉占位「型号 model_number…」,选项=当前品牌的型号列表meta.model_numbers[brand](page.tsx:493-499);onChange 清空已选 SKU(page.tsx:495);SKU 列表随 selModel 自动加载(page.tsx:152-161,原写在 onChange 不触发「进入流程」的修复)选项与 meta 响应一致;改型号后 SKU 下拉复位生效
AC-EL-LST-009SKU 下拉下拉占位「SKU…」,选项文案=「{sku} · {color} · {size} · {country}」(空段省略);单 SKU 自动选中GET /api/listing/skus-by-model?brand=&model=(page.tsx:500-506,152-161;listing.py:462-480,sku_mapping 按 model_number/model_name/product_name 三匹配);恰 1 行时自动填 sku 与 market(page.tsx:157-158);onChange 选行带出 country→market(page.tsx:502)选项数=接口 items;单 SKU 型号断言自动选中生效
AC-EL-LST-010平台下拉下拉占位「平台…」,选项=meta.platforms(platform+name)page.tsx:507-510;onChange 清空 market;服务端二次校验平台开放与平台×站点组合(listing.py:623-626)选项与 platforms 表 active 行一致生效
AC-EL-LST-011创建任务按钮按钮「创建任务」;必填缺失 toast「型号/SKU/平台必填」,未选品牌 toast「请先在顶栏选择品牌」;成功 toast「任务已创建」POST /api/listing/tasks(page.tsx:277-287;listing.py:608-664);服务端:品牌登记+产品存在+类目存在校验,产品×平台×站点唯一键冲突 409「该产品×平台×站点已有任务」(listing.py:646-647);Amazon 自动带出 listing_pt_suggest 建议 PT(listing.py:651-660);audit listing.task.create;事件 create重复提交同产品×平台×站点断言 409;audit_log 与 listing_events 各落一条生效
AC-EL-LST-012⚡ 批量建任务按钮按钮「⚡ 批量建任务({modelSkus.length 或 …})」;confirm「为 {型号} 的 {N} 个 SKU 批量创建 {平台} 任务?」;完成 toast「批量创建完成:新增 X · 跳过已存在 Y · 失败 Z」前端循环逐个 POST /api/listing/tasks(page.tsx:290-310);错误串含 409 或「已有任务」计 skip(page.tsx:303);title 提示「为该型号带出的全部 SKU 各建一个任务(已存在的自动跳过)」(page.tsx:513);disabled=busy 或未选品牌或 SKU 列表空对含已存在 SKU 的型号执行,断言 skip 计数与 409 数一致生效
AC-EL-LST-013高级选项折叠折叠summary「高级选项(站点 / 类目 / 关键词,一般不用改)」<details> 原生折叠 page.tsx:515-529默认收起;点击展开三控件生效
AC-EL-LST-014站点下拉(高级)下拉占位「默认(SKU 国家)」,选项=所选平台的 marketplaces.countriesmks=meta.marketplaces.filter(platform=nu.platform)(page.tsx:461,518-521)换平台断言站点选项集随动生效
AC-EL-LST-015类目下拉(高级)下拉占位「默认类目」,选项=meta.categories(显示 name)page.tsx:522-525;不选时后端取产品当前类目否则 general(listing.py:635)选项与 product_categories 全集一致生效
AC-EL-LST-016关键词输入(高级)输入placeholder「关键词(逗号分隔, 标题用)」,宽度 240nu.keywords page.tsx:526-527;TaskIn.keywords max_length=200(listing.py:605);生成时取前 4 个非空词作 K1/K2 等模板词(listing.py:316,339)超 200 字提交断言 422生效
AC-EL-LST-017未选型号引导提示提示「选好型号并建任务后,下面 6 步走完整个型号的上架(不用一个 SKU 一个 SKU 弄)。」显示条件 !selModel 或 modelSkus 空(page.tsx:530-531);选中后替换为流程区两种前置态各断言互斥渲染生效
AC-EL-LST-018型号摘要条状态行badge 型号 + 「{N} 个 SKU · 任务 {M} 条(已生成 {X} · 就绪 {Y} · 已上传 {Z})」;执行中显示 badge warn「执行中…」flowTasks=GET /api/listing/tasks?page_size=100&q={型号}&brand={品牌}[&platform=](page.tsx:145-149;q 匹配 sku/title/product_title/model_number ILIKE,listing.py:674-675);已生成=title 非空数;就绪=status=ready 数;已上传∈{submitted,imported,exported}(page.tsx:537-540)四计数与接口行逐项复算一致生效
AC-EL-LST-019流程①·规格书上传(型号级)按钮+隐文件文案「上传规格书(一次,自动同步全部 SKU):」+ 按钮「选择文件上传」;hidden input accept=.docx,.pdf,.xlsx,.txt,.csvPOST /api/listing/models/spec FormData(brand,model,file)(page.tsx:543-547,237-252;listing.py:555-581):同一 parsed_kv 落到该型号全部 SKU 的 listing_specs 行;成功 toast「规格书已同步到 {N} 个 SKU(解析 {M} 条键值)」;文件≤10MB(listing.py:135,487);支持类型 docx/pdf/xlsx/txt,.doc 400「旧版 .doc 请先另存为 .docx 再上传」(listing.py:179-192);kv 行级解析冒号/竖线/tab 二段式+单位尾缀(listing.py:210-228)xlsx 上传后断言该型号每 SKU 均落 listing_specs 行且 parsed_kv 相同生效
AC-EL-LST-020AI 抽取兜底(规格书)口径规则命中 <8 条且原文 >200 字时 LLM 补键值对(每条带 ai:true 标记,最多 20 条)LISTING_AI 开关(env,默认开,listing.py:42);_ai_kv_extract(listing.py:74-86);AI 用量计数 rds aiusage:{date} slug 维 hincrby(listing.py:104-108);任一失败静默回退纯规则短规则文本样例断言 ai_added>0 或正常回退;aiusage 键递增生效
AC-EL-LST-021流程②·生成全部按钮按钮「生成全部」;toast「模板任务已生成(LLM 约10~60s), 正在同步到其余 SKU…」;全部 ready 时先 toast「任务全部为就绪态,已自动撤回模板任务以便重新生成」page.tsx:220-235,548-550:POST /api/listing/tasks/{id}/generate?ai=1(模板任务=首条有 title 否则首条);生成接口仅收 draft/failed,全 ready 自动先 revert 首条(page.tsx:225-230);随后 batch generate_sync全 ready 型号点生成断言先产生 revert 事件再 generate 事件生效
AC-EL-LST-022生成端点·规则+AI 双引擎口径规则引擎确定性打底(同义词映射+模板渲染);AI 增强做属性映射与标题/五点,失败回退规则结果POST generate ai=1(listing.py:732-837):规则 _generate_content(312-361,同义词表 _SYN 234-262,模板 _pick_template 精确优先通配 287-298);AI 属性映射防幻觉三重校验=映射数>2×kv 整批丢弃/值引用字段名单条拒绝/含竖线「|」的多段拼接拒绝(listing.py:779-794);AI 标题 20~200 字才采纳、五点 3~6 条取前 5(listing.py:804-813);gen_meta.engine=rules-v1 或 rules-v1+ai-v1;attrs 统一过 _clean_attrs 防幻觉清洗(listing.py:116-132,817);version+1gen_meta.ai 三标记与实际 LLM 采纳一致;脏 attrs(含字段名清单值)写入被拒生效
AC-EL-LST-023流程③·审核编辑器加载数据源编辑器摊开模板任务全部字段(用户要求不收起);version 变化即刷新GET /api/listing/tasks/{id}(page.tsx:170-179;listing.py:701-729:task+product+schema+spec+events LIMIT 10);bullets 补空串至 5 条 slice(0,5)(page.tsx:174);flowSnap 记 attrs 快照供保存前比对;useEffect 依赖 [flowTplId, flowTplVer]——生成/同步/他处保存后自动刷新(page.tsx:179)他处保存同任务后本编辑器字段自动更新生效
AC-EL-LST-024流程③·标题编辑文本域label「标题 {n}/200」;textarea rows=2 maxLength=200page.tsx:554-558;TITLE_MAX=200(listing.py:136)计数=n/200 实时;粘贴超长截断生效
AC-EL-LST-025流程③·五点编辑输入组label「五点描述(≥3 条)」;5 行编号输入 maxLength=500page.tsx:559-568;BULLET_MAX=500/BULLET_MIN=3(listing.py:137-138);保存时空行被滤除(page.tsx:195)5 行恒渲染;空行不入库生效
AC-EL-LST-026流程③·长描述与关键词文本域+输入「长描述」textarea rows=4 maxLength=5000;「关键词」inputpage.tsx:569-579;description 上限 5000(listing.py:843)超长截断与计数一致生效
AC-EL-LST-027流程③·必填参数网格表单「必填参数({N} 个,有未填|已填齐)」;未填项 label 变红flowSchema 过滤 required 且排除 DEDICATED 7 专用键 item_name/product_description/brand_name/bullet_point1-5(page.tsx:582-584,607-612);「有未填/已填齐」由任一必填空判定(page.tsx:610)schema required 集与网格行集一致(扣除 7 键)生效
AC-EL-LST-028流程③·可选参数网格表单「可选参数({N} 个,按需补充)」非 required 且非 DEDICATED(page.tsx:613-614)计数=总属性-必填-7生效
AC-EL-LST-029参数单元格控件控件label={label}{必填*}{(unit)};type=select 或有 enum→下拉(空选项+枚举/选项),否则文本 inputpage.tsx:587-606;enum 优先 options(page.tsx:598)枚举字段渲染下拉且取值∈枚举生效
AC-EL-LST-030💾 保存并注入全部 SKU 按钮按钮「💾 保存并注入全部 SKU」;防过期覆盖:服务器 attrs 与快照不一致时拒绝保存并 toast「服务器上的参数已更新,编辑器已刷新为最新内容,请确认后再保存」flowSave(page.tsx:181-200):先 GET 比对 flowSnap→PUT /api/listing/tasks/{id}→batch generate_sync;PUT 端点 draft/failed/ready 可编、已推送四态 409(listing.py:848-887);attrs key 必须在类目 schema 内否则 400(listing.py:874-876);bullets 截 5 条、各值截 500;version 随变更递增;audit listing.edit;事件 edit并发他处保存后本侧保存断言被拦且编辑器刷新;schema 外 key 断言 400生效
AC-EL-LST-031流程③加载中占位占位编辑器未就绪且模板存在时显示「加载中…」!flowForm && flowTpl(page.tsx:623)慢网断言占位出现后替换生效
AC-EL-LST-032流程④·批量批准按钮按钮文案「全部批准就绪(质量门逐条校验):」+「批量批准」batch("approve")(page.tsx:624-626)→ POST /api/listing/tasks/batch action=approve(listing.py:1372-1514,1439-1466 段):逐条质量门同单批口径(标题/五点≥3/必填缺失,derived 豁免 item_name/product_description,listing.py:1453);非 draft 记 skip;audit listing.batch.approve混合状态批次断言 ok+skip 分桶正确生效
AC-EL-LST-033流程⑤·类目绑定行控件组仅当首任务未绑 PT 时内联显示:站点下拉(占位「站点」)+ 品名输入(占位「品名(英文)」)+「搜类目」按钮显示条件 flowTasks[0] 无 product_type(page.tsx:628-651);ptMarkets=GET /api/listing/pt-markets?brand=(page.tsx:162-165;listing.py:1137-1143,品牌校验 _brand_ok);搜类目 disabled=未选站点或词<3 字符已绑 PT 型号断言整组不渲染生效
AC-EL-LST-034搜类目·pt-search 回退口径toast「搜到 {N} 个类目」或「搜到 0 个类目(换个品名试试,如 bras / shirt)」GET /api/listing/pt-search?brand=&market=&q=(page.tsx:357-379;listing.py:1146-1165);词<3 服务端 400;前端复数回退 bra→bras、去尾 s 回退(page.tsx:365-374);SP-API Product Type Definitions,redis 缓存 24h(listing.py:1155-1164)单数词命中复数回退路径断言二次请求发起生效
AC-EL-LST-035类目选择+绑定到全部下拉+按钮命中后追加:类目下拉(占位「选类目…」,文案 display_name (name))+「绑定到全部({N})」按钮batch("bind_pt")(page.tsx:641-647)→ POST batch action=bind_pt(listing.py:1491-1503):需 product_type+market,逐任务 UPDATE product_type/market(market 归一大写);事件 bind_pt batch=true;audit listing.batch.bind_pt;元数据缓存按 brand+market+PT 共用(listing.py:1492 注释)绑定后全部任务 product_type/market 落库且事件齐生效
AC-EL-LST-036批量预检按钮按钮「批量预检」;首任务未绑 PT 时 disabledbatch("submit", true)(page.tsx:653-654)→ batch action=submit dry_run(listing.py:1467-1490):noon 走 _submit_noon(dry)、amazon 走 _submit_amazon(dry);不真推平台dry 结果 ok[].note 含「预检载荷N字段」生效
AC-EL-LST-037🚀 批量提交推送按钮按钮confirm「确认把 {N} 个任务批量推送到平台?」;真推间隔 0.2s 防限速batch("submit", false)(page.tsx:206,655-656);listing.py:1489-1490 time.sleep(0.2);单任务异常入 fail 桶不中断批次(listing.py:1485-1488)批次推送事件时间间隔≥0.2s;单失败不断批生效
AC-EL-LST-038批量结果 toast反馈「{预检|操作}完成: 成功 {ok} · 跳过 {skip} · 未通过 {fail}(如: {首条失败原因})」;有失败为 err 态page.tsx:209-215;fail 首条 note 透出构造一缺必填批次断言三桶计数生效
AC-EL-LST-039批量端点护栏护栏批量操作统一 owner/admin 门 + ids 1~200 上限 + 结果三桶 {ok,skip,fail}_require_admin(listing.py:1378);ids 校验(listing.py:1380-1381);action 白名单 generate_sync/approve/submit/revert/bind_pt(listing.py:1382-1383);任务不存在入 fail「不存在」;audit 各分支;铁律:tenant_conn+brand_scope 全程企业隔离(listing.py:1385)非 admin 调用断言 403;201 ids 断言 400生效
AC-EL-LST-040generate_sync 智能覆盖口径口径模板 title/五点/描述/关键词整体下发;attrs 分两种:各 SKU 值一致=共用参数随模板覆盖(支持人工修正下发),值各异=SKU 差异参数只补空保留自身listing.py:1408-1437;sibling_vals 判定(1413-1418):其余任务该 key 非空值集合 ≤1 视共用;gen_meta.copied_from=模板 id;version+1;已推送四态 skip「已推送」;无任何已生成任务 400「所选任务中无已生成内容…」;事件 generate copy_from;audit listing.batch.sync尺码各异型号同步后断言尺码保留、共用字段被覆盖生效
AC-EL-LST-041上传流程条步骤条amazon 4 步「生成内容/绑定亚马逊类目/批准就绪/预检提交」,noon 3 步「生成内容/批准就绪/提交 Noon」;完成步 ✓ 绿、当前步黄加粗、未到灰状态机 page.tsx:669-675:cur 由 title/product_type/status 推导;done∈{submitting,submitted,imported,exported} 全步 ✓draft/ready/imported 三任务断言步骤着色生效
AC-EL-LST-042下一步主按钮按钮随状态机切换:draft 未生成=「⚙ 规则生成 →」→ amazon 未绑 PT=「🔍 按品名自动搜类目 →」→「✓ 批准就绪 →」→「🔍 预检(不推送) →」;done 后不渲染page.tsx:681-685,705;autoBind 取 product_name(空则 product.title)首词、兜底 SKU 填 ptQ 并搜索(page.tsx:676-680)四状态各断言按钮文案与动作生效
AC-EL-LST-043流程完成徽标徽标done 后显示绿 badge「流程完成[ · ASIN {asin}]」page.tsx:703imported 任务断言徽标与 ASIN生效
AC-EL-LST-044任务详情头卡卡头「{brand} · {sku}」+ 灰字「{platform} · {market} · {category} · v{version}」+ 状态 badgeopenTask 经「编辑内容 →」触发(page.tsx:254-274):GET 详情→setTab(tasks)→150ms 后滚动至详情锚点;2026-09-21 tab 收纳 6→3 详情内联任务 tab(page.tsx:269 注释)点列表「编辑内容」断言滚动定位与字段渲染生效
AC-EL-LST-045任务状态中文/色调单源口径7 状态:draft 草稿(无色) / ready 待提交(ok) / exported 已导出(ok) / submitted 已提交(warn) / submitting 提交中(warn) / imported 已建品(ok) / failed 失败(bad)lib/listingStatus.ts LISTING_STATUS_LABEL/LISTING_TONE(page.tsx:37-39 引入;UI-05 2026-10-14 单源化,此前 page.tsx 与 NoonListingTab 两套各自为政);语义按 listing.py 状态机两 tab 同 status 显示同中文同色生效
AC-EL-LST-046⚙ 规则生成按钮(详情头)按钮toast「已生成: {title 前 40}…」;ready 态点击被服务端 409 拒POST /api/listing/tasks/{id}/generate(默认 ai=1)(page.tsx:312-321;listing.py:732-837);409 文案「状态 {status} 不可生成(ready 请先撤回)」(listing.py:739-740)ready 任务直点断言 409 toast生效
AC-EL-LST-047✓ 批准(ready) 按钮按钮仅 draft 显示;toast「已批准 → ready」POST approve(page.tsx:718,343-348;listing.py:890-923):_require_admin;质量门=标题非空且≤200+五点≥3+必填属性齐(derived 豁免 item_name/product_description,listing.py:911);不合格 400 分号拼接问题清单;落 approved_by/approved_at;audit listing.approve缺必填断言 400 且列出缺失 label;通过断言 status=ready生效
AC-EL-LST-048↩ 撤回按钮按钮仅 ready 显示;toast「已撤回 → draft」POST revert(page.tsx:719,349-354;listing.py:926-938):_require_admin;仅 ready 409 其它;清 approved_by/approved_at;audit listing.revert撤回后编辑器可改、批准按钮重现生效
AC-EL-LST-049保存修改按钮(详情头)按钮toast「已保存 · 已自动注入同型号 {N} 个任务」;同步失败不阻塞保存(静默)PUT 后自动 batch generate_sync 以本任务为模板(page.tsx:323-341,注释「编辑一次直接注入就好了」);det 任务的型号组=flowTasks保存后同型号任务 title 一致、version+1生效
AC-EL-LST-050编辑锁提示提示非 draft/failed 状态显示「当前状态 {label},编辑需先撤回(ready)或等待回流处理」page.tsx:722-723;服务端锁=已推送四态 409(listing.py:855-856)exported 任务保存断言 409生效
AC-EL-LST-051详情·标题卡卡h2「标题」sub「{n}/200」;textarea + 关键词 input(placeholder「关键词(逗号分隔)」)page.tsx:729-735编辑即时计数;关键词随保存提交生效
AC-EL-LST-052生成引擎说明行口径行「生成引擎: {engine|rules-v1} · {纯规则|AI映射 {n} 项 + AI标题 + AI五点} · 已填属性: {keys 逗号|无}」gen_meta.engine/ai/filled_attrs(page.tsx:736-748;listing.py:358-361,818-822)纯规则任务断言「纯规则」;AI 任务断言标记组合生效
AC-EL-LST-053详情·五点描述卡卡h2「五点描述」sub「≥3 条 · 批准门校验」;5 行编号输入page.tsx:751-759;与 LST-025 同限值(BULLET_MIN=3)文案与批准门一致生效
AC-EL-LST-054详情·长描述卡卡h2「长描述」;textarea rows=8 maxLength=5000page.tsx:761-765计数与截断一致生效
AC-EL-LST-055详情·PT 绑定卡(amazon)卡仅 amazon 任务渲染;已绑定=badge PT + 「@ {market} · 官方字段 {schema 数} 个(必填 {required 数})」;未绑定=「未绑定 — 用本地静态类目;绑定后可直推亚马逊」page.tsx:769-779;任务生效 schema=绑 PT→listing_category_meta 官方元数据,否则本地 product_categories(listing.py:1118-1128 _task_schema 期2b 全链统一)绑/未绑两任务断言文案与字段数生效
AC-EL-LST-056详情·PT 绑定控件行控件组仅 draft/failed 显示:站点下拉/品名输入(placeholder「品名搜官方类目(英文)」,Enter 触发搜索)/「搜索类目」按钮/类目下拉/「绑定」按钮bindPt→POST /api/listing/tasks/{id}/bind-pt {product_type,market}(page.tsx:380-389,780-802;listing.py:1210-1243):仅 draft/failed 可绑;market 必填(缺=400);拉官方 schema 落 listing_category_meta 缓存 7 天;畸形 schema 422 不绑定(listing.py:1228-1229);toast「已绑定 {pt} · 官方字段 {N} 个」;audit listing.bind-pt绑定后属性编辑器切换官方字段集生效
AC-EL-LST-057提交到亚马逊卡卡仅 amazon+ready 显示;h2 sub「步骤⑨⑩⑪ SP-API putListingsItem · PT {pt}@{market} 或 未绑PT(不可提交)」;「🔍 预检(不推送)」「🚀 提交推送」未绑 PT 均 disableddoSubmit→POST /api/listing/tasks/{id}/submit?dry_run=(page.tsx:390-409,805-811;listing.py:1272-1284→_submit_amazon 1287-1358):需 ready+PT+类目元数据缓存;dry 返回 payload_keys/missing_required;真推缺必填 422未绑 PT 断言双按钮 disabled;dry 后预览面板出现生效
AC-EL-LST-058预检结果面板(amazon)面板「缺失必填属性 {N} 项: {清单}」缺失红/「 ✅ 可提交」绿;「载荷字段 {N} 个: {前 14}…」submitPreview 状态(page.tsx:113,812-822);toast「预检完成: 载荷 {N} 字段, 缺必填 {M} 项」(page.tsx:401)缺项数与 missing_required 数组一致生效
AC-EL-LST-059ASIN 行与提交结果 JSON展示「ASIN: {asin}」加粗;submit_result 以 pre 呈现 JSON.stringify 缩进 1,截 900 字page.tsx:824-829;submit_result 服务端存 result/issues 前 20/submission_id(listing.py:1331-1335)或错误 hint(listing.py:1354-1355)面板字符数≤900;结构与库内 submit_result 一致生效
AC-EL-LST-060Amazon 推送结果与 403 指引口径成功 toast「✅ 推送成功 · ASIN {asin}」;失败「推送返回 {status} · {N} 个错误」;403 时错误文案为中文 Seller Central 重新授权指引doSubmit(page.tsx:403-405);listing.py:1316-1344:put_listing→issues 取 ERROR 级→get_listing 回读 ASIN→status imported/failed;403/Unauthorized 中文指引(listing.py:1346-1351);ASIN 回写 _cascade_asin_to_mapping:sku_mapping 补空 asin + keepa_watch ON CONFLICT 入池(listing.py:45-72,1336-1339);提交前置 status=submitting成功推后 sku_mapping.asin 与 keepa_watch 各落一行;403 mock 断言指引全文生效
AC-EL-LST-061提交确认弹窗(单任务)护栏confirm「确认推送 {brand}/{sku} 到{Noon|亚马逊} {market}?」;取消不请求doSubmit 非 dry 分支(page.tsx:392-393);平台名按 platform 映射取消断言无网络请求生效
AC-EL-LST-062提交到 Noon 卡卡仅 noon+ready 显示;h2 sub「Content API /content/v1/product/upsert · 同步建品 · 预检为 dry 校验」;「🔍 预检(不推送)」「🚀 提交推送」(无 PT 要求)page.tsx:832-838,396-408→_submit_noon(listing.py:1659-1725):实际通道=Content API /content/v1/product/upsert 同步建品(listing.py:1692),旧 impex 通道已废弃(listing.py:1517-1521 注释)——sub 文案与实现不符的待修缺陷已修:2026-10-22 用户令全修,sub 改标实际通道 Content API upsert(现 page.tsx:834),web 重建上线(编译产物 Impex 引用清零,noon 页 Impex=官方报表族名合法保留),frontend_e2e 门禁 ALL PASS代码走查 sub 文案 vs listing.py:1692 upsert;e2e 断言实际请求域名/路径为 content/v1/product/upsert生效
AC-EL-LST-063Noon 预检 csv_preview面板submitPreview 呈现 csv_preview pre(muted 11px 滚动)原 page.tsx:839-844 死分支已删(2026-10-22 用户令全修):submitPreview 的 csv_preview pre 连同类型字段整体移除,dry 结果本就经 toast「预检完成: 载荷 N 字段, 缺必填 M 项」与缺失必填面板(page.tsx:812-821)透出,无信息损失;编译产物 csv_preview 零残留,frontend_e2e 门禁 ALL PASSdry 响应键集断言无 csv_preview(已删分支,编译产物零残留)生效
AC-EL-LST-064NSKU 行(Noon 详情)展示「NSKU: {值}」;值取 det.task.asin 字段page.tsx:846;noon 通道服务端把 variants[0].sku 写入 listing_tasks.asin 列(listing.py:1703-1705 UPDATE asin=nsku)——字段名 asin 承载 NSKU,展示标签正确noon imported 任务断言 asin 列=NSKU 且展示为 NSKU生效
AC-EL-LST-065详情·类目属性卡卡h2 sub:绑 PT=「官方 PT 字段 · {pt}」,未绑=「{类目显示名} · * 必填」;逐属性行 label{*=必填}{(unit)}+select/inputpage.tsx:849-871;schema=详情接口 schema 段(PT 官方或本地,LST-055 口径);required 未填 label 变红(page.tsx:853-856)绑 PT 前后字段集切换比对生效
AC-EL-LST-066类目属性空态空态schema 为空显示「该类目无属性定义」page.tsx:851空 schema 类目断言文案生效
AC-EL-LST-067① 规格书卡(单 SKU)卡h2「① 规格书」sub「docx / pdf / xlsx / txt」;file input(无 accept 限制)+「上传解析」按钮;toast「规格书已解析: {N} 条键值」POST /api/listing/specs FormData(file,brand,sku)(page.tsx:411-425,873-877;listing.py:509-552):产品须存在否则 404「先在 品牌接入 导入 SKU」;解析同 LST-019 口径;audit listing.spec上传 docx 断言 listing_specs 落行+kv_count toast生效
AC-EL-LST-068规格书已上传块展示「{filename} {file_type} · {N} 条键值」+ 键值表(项/值 两列,前 40 行,值带单位)det.spec=该产品最新一条 listing_specs(listing.py:716-721);parsed 截 40 行渲染(page.tsx:879-893)行数=min(40, parsed 长度)生效
AC-EL-LST-069展开/收起原文按钮toggle 文案「展开原文/收起原文」;raw_preview pre 展示raw_preview=raw_text 前 2000 字(listing.py:721;page.tsx:894-900)pre 字符数≤2000生效
AC-EL-LST-070规格书未上传提示空态「未上传。规格书键值会在「规则生成」时自动匹配到类目属性(同义词表 + 包含匹配)。」page.tsx:902-905;匹配=_match_attr 同义词精确→双向包含(listing.py:269-284)文案逐字;生成后必填命中可复算生效
AC-EL-LST-071操作轨迹卡审计每条=时间(截 16 字 T→空格)+action 加粗+detail JSON 省略;空态「暂无」;sub「只追加审计」详情接口 events=listing_events 该任务最近 10 条倒序(listing.py:722-723 LIMIT 10);listing_events 只追加——触发器拦截 UPDATE/DELETE(listing.py:7 模块 docstring);detail 截 4000 字(listing.py:402)UPDATE listing_events 断言被触发器拒;页面至多 10 条生效
AC-EL-LST-072任务列表卡头计数标题「任务列表」sub「{N} 条」+ 超出时「 · 共 {M} 条(首 1000)」page.tsx:925-926;N=已取回行数,M=tasksTotal;上限 1000(LST-005)>1000 任务断言两数同显生效
AC-EL-LST-073任务筛选·状态下拉占位「全部状态」,选项=7 状态中文(LISTING_STATUS_LABEL)page.tsx:928-931;筛选变化即触发 loadTasks(useEffect 依赖 f)选项与状态单源一致生效
AC-EL-LST-074任务筛选·平台/品牌下拉平台=全部平台/amazon/noon;品牌=全部品牌+meta.brandspage.tsx:932-939选项集与 meta 一致生效
AC-EL-LST-075任务筛选·搜索框输入placeholder「搜索 型号/SKU/标题」f.q → 服务端 ILIKE 四字段:sku/title/product_title/model_number(page.tsx:940;listing.py:674-675)型号词命中该型号全部行生效
AC-EL-LST-076任务表头表头7 列:型号 / 平台/站点 / SKU 数 / 内容进度 / 上传进度 / 最近更新 / 空page.tsx:944列序逐字生效
AC-EL-LST-077型号分组口径口径行=型号×平台×站点分组;model=model_number 空则回退 sku;组内行=各 SKU 任务分组键 brand|model|platform|market(page.tsx:463-472);显示=「{model} {brand}」分组数=四元组去重数生效
AC-EL-LST-078内容进度条进度条宽=已生成/总数百分比(品牌色填充)+ 文案「内容 {gen}/{total}」page.tsx:1055-1061;gen=title 非空数(page.tsx:1045)宽度%与比值一致生效
AC-EL-LST-079上传进度条+待推送徽标进度条宽=已上传/总数(ok 色)+「已上传 {done}/{total}」;ready>0 加 badge warn「待推送 {ready}」done∈{submitting,submitted,imported,exported}(page.tsx:1044,1063-1071);ready=status=ready 计数三计数复算一致生效
AC-EL-LST-080最近更新列列组内最新 updated_at(截 16 字)page.tsx:1048,1072=组内 max(updated_at)生效
AC-EL-LST-081进入流程 ↑ 按钮按钮stopPropagation;带入品牌/型号/平台至顶部流程(顶栏未选品牌时 SKU 加载被空值守卫拦——先 setBrand)并平滑滚顶onOpenFlow(page.tsx:947-951,1074-1075);market 清空;60ms 后 scrollTo top点击后顶栏品牌=组品牌、型号下拉=组型号生效
AC-EL-LST-082SKU 明细/收起按钮与行展开交互分组行点击或按钮切换展开;展开行背景 bg,行首缩进显示「{model} / {sku}」page.tsx:1051,1076-1077,1080-1081行点击与按钮均触发开合生效
AC-EL-LST-083明细行内容行SKU+ASIN/NSKU 绿 badge(有则);状态 badge+「v{version}」;title 空显示灰「未生成」;「编辑内容 →」按钮page.tsx:1082-1086;asin 有显 ASIN 否则 nsku 显 NSKU两平台任务各断言 badge 形态生效
AC-EL-LST-084任务列表空态空态「暂无任务,先在上方选型号并建任务」colSpan=7 居中page.tsx:953无任务断言文案与跨列生效
AC-EL-LST-085④ 导出 CSV 卡头标题「④ 导出 CSV」sub「仅 ready 任务 · UTF-8 BOM · Excel 直开」page.tsx:963-964;BOM=EF BB BF 前缀(listing.py:1026);行尾 CRLF(listing.py:1013)下载文件头三字节 BOM 断言生效
AC-EL-LST-086导出平台下拉下拉占位「按平台导出全部 ready」+ amazon/noon;切换清空勾选page.tsx:966-969切换后勾选数=0生效
AC-EL-LST-087下载 CSV 按钮按钮勾选与平台二选一(都空 toast「勾选任务或选平台」);成功 toast「CSV 已下载」并清勾选刷新GET /api/listing/export?ids= 或 platform=(page.tsx:427-444;listing.py:959-1029 _require_admin):ids 模式状态须 ready/exported 否则 409;跨平台混导 400;文件名 listing_{平台}_{YYYY-MM-DD}.csv(content-disposition,前端 fallback listing.csv,page.tsx:437);导出行置 exported+事件 export;列集=平台基础列+各任务类目 schema attr 列并集保序(listing.py:366-374,1004-1011);noon 基础列 sku/item_number/name_en/brand/bullet_points/description/item_type,amazon 含 bullet_point1-5表头与列集口径一致;导出后任务状态=exported生效
AC-EL-LST-088导出范围提示提示三态文案:选平台=「将导出该平台全部 ready」;有勾选=「已勾选 {N} 条」;否则「或在下方勾选」page.tsx:971-973三前置态文案断言生效
AC-EL-LST-089导出勾选表表5 列:勾选框 / 品牌+SKU / 平台·站点 / 标题(省略)/ 状态 badge;行集=ready ∪ exportedreadyTasks.concat(tasks.filter(exported))(page.tsx:979-990)——exported 行可再次勾选导出(重复导出允许)行集与任务集差集为空生效
AC-EL-LST-090导出表空态空态「暂无 ready/exported 任务」colSpan=5显示条件=tasks.length===0(page.tsx:991)——任务全空才显;有任务但无 ready 时表格仅无行(边界如实记录)两前置态分别断言生效
AC-EL-LST-091⑤ 结果回流卡卡sub「平台回执 CSV: sku[,status][,asin][,message]」;平台下拉(「不限平台」+两平台,此处切换不清勾选)+ .csv 文件选择 +「上传回流」按钮POST /api/listing/import-results FormData(file[,platform])(page.tsx:446-459,996-1005;listing.py:1032-1090 _require_admin):文件≤10MB;sku 列名兼容 sku/item_sku/item_number;成功 toast「回流完成: 更新 {u}/{total} 行,跳过 {k}」兼容列名三态各测一文件生效
AC-EL-LST-092回流判定口径口径提示文案「成功行(status 空/success/ok/active) → 已回流;失败行 → 回流失败(点任务「编辑内容」可见原因,修复后可重新导出)。」服务端成功值全集=空/success/ok/active/done/成功 六值(listing.py:1063)——页面提示列 4 值为子集(done/成功 未列,如实记录不判缺陷);任务定位=同 sku 最新 exported 优先(listing.py:1064-1067);前置状态须 exported/failed/imported 否则 skip「状态X」;成功→imported 失败→failed;ASIN 列回流写 asin 并触发 _cascade_asin_to_mapping(listing.py:1075-1084);事件 import_result 含 message 截 500done/成功 两值行断言仍 imported;skip 原因落 skipped 前 10生效
AC-EL-LST-093体检 tab 加载态状态错误=「加载失败: {err}」;加载中=「加载中…」page.tsx:1100,1105-1106;GET /api/listing/health?brand={顶栏品牌}&limit=200(listing.py:1765-1893)断网/慢网两态呈现生效
AC-EL-LST-094体检卡头标题「🩺 Listing 运营健康度体检」sub「9 维 · 零 LLM 规则评分 · nodata 不计分({note 动态})」page.tsx:1103-1104;note=接口原样(listing.py:1893)sub 括号内=响应 note 逐字生效
AC-EL-LST-095体检说明段口径行「共 {total} 个在架 SKU×ASIN(跟随顶栏品牌筛选)。评分=有数据维的均值(ok 100 / warn 60 / bad 20)。评分从低到高优先处理;灰点=无该维数据(不显示误导性 0)。悬停色点看明细,点击行展开。」page.tsx:1109-1112;总分=有数据维均值四舍五入,全 nodata=null(listing.py:1883-1886);排序低分在前、null 垫底(listing.py:1888)行序与分值复算一致生效
AC-EL-LST-096体检表头表头「SKU / 名称」「总分」+9 维动态列(dims_meta 顺序):销量活跃/销量趋势/评分/评论规模/BSR 排名/库存风险/退货信号/价格稳定/内容覆盖page.tsx:1114-1121;dims_meta 逐字(listing.py:1890-1892);minWidth 760 横向滚动列名 9+2 与 dims_meta 逐字生效
AC-EL-LST-097体检 SKU 单元格单元格SKU 加粗+名称灰小字+ASIN sku 小字两行page.tsx:1125-1126;行集=sku_mapping asin 非空行按品牌过滤 LIMIT 200(listing.py:1771-1773)行集与口径一致生效
AC-EL-LST-098体检总分单元格单元格null=灰「—」;≥80 绿 / ≥60 黄 / <60 红 加粗数字page.tsx:1127-1128阈值三段着色断言生效
AC-EL-LST-099体检维度色点单元格每维 badge:ok=✓ / warn=! / bad=✗ / nodata=—(dim 灰);title=「{status} · {note}」page.tsx:1129-1138;TONE 映射(page.tsx:1101)悬停 title 与接口 note 一致生效
AC-EL-LST-100体检行展开明细交互点击行展开 colSpan=11 明细:每维「badge 中文名 + note 灰字」逐行列出;再点收起page.tsx:1124,1141-1154;colSpan=11 硬编码=9 维+2 固定列展开行维数=9生效
AC-EL-LST-101体检九维规则·销量类口径①销量活跃:无数据=nodata;0 件=bad;<10=warn;≥10=ok。②销量趋势:环比窗口不足=nodata;周环比≤-50%=bad、≤-20%=warn、其余 ok(近 7 天 vs 前 7 天)listing.py:1776-1781(sales_daily 近 30 天聚合)、1813-1829;趋势分母 uprev7=0 视为不足(listing.py:1823)构造已知销量序列复算两维判定生效
AC-EL-LST-102体检九维规则·排名类口径③评分:<3.5=bad、<4.0=warn、≥4.0=ok,无快照=nodata。④评论规模:<15=warn(冷启动)、≥15=ok。⑤BSR:>50000=warn、其余 oklisting.py:1783-1786(rankings_daily ASIN 级最新快照 DISTINCT ON)、1830-1849三阈值边界值各复算一例生效
AC-EL-LST-103体检九维规则·库存/退货口径⑥库存风险(最差市场口径):断货=bad、低库存=warn、其余 ok,note=「{worst}(最短可售 {天数|?} 天)」。⑦退货信号:上月退货率>12%=bad、>8%=warn、≤8%=ok,分母=近 30 天销量,无数据=nodatalisting.py:1788-1795(inventory_health min(stock_days) 最差口径;amazon_refund_monthly 上月)、1850-1870断货 SKU 断言 bad;退货率边界复算生效
AC-EL-LST-104体检九维规则·价格/内容口径⑧价格稳定:仅 Keepa 关注池 ASIN,30 天 buybox 波动=(max-min)/avg>25%=warn 否则 ok,非关注池=nodata。⑨内容覆盖:aplus_docs 计数=0=nodata「未接入(扩展位)」,>0=ok「A+ 文档 {N} 份」listing.py:1797-1802(keepa_daily 近 30 天极差/均值;aplus_docs 全表计数)、1871-1882非关注池断言 nodata 不计分生效
AC-EL-LST-105资源 tab·区块标题标题三区:「📄 A+ 内容」「📁 文件」「模板库」+ 模板库尾注「静态 A+ 模板库(目录动态按本企业品牌生成,HTML 由 Caddy 直出)。生成文案请用上方「工作台 → 规则生成」。」page.tsx:1015-1027三标题顺序与尾注逐字生效
AC-EL-LST-106模板库分组卡卡每组一卡:h2={grp}+sub「{N} 套模板」;组=templates 按 brand::grp 归并;仅显示本企业已选品牌集合内的组TemplateLib(page.tsx:47-79):brands 取自子组件内 useBrand(BrandProvider 在 AppShell 内,根组件外读到空默认值——page.tsx:45-46 注释);目录源=meta.templates←listing_library 按企业品牌过滤(listing.py:454-457,D 类注册即级联 79 号种子)brands.includes 过滤后组集与 listing_library 行集一致生效
AC-EL-LST-107模板卡链接链接每模板一卡:标题+slug 灰字+badge「预览 ↗」;整卡链接 /listings/{slug}.html 新窗口打开page.tsx:62-73;target=_blank rel=noreferrer;tone 徽标色随库 tone 字段链接可达(Caddy 直出 HTML 200)生效
AC-EL-LST-108NoonListingTab 承载组件挂载页级 noon 三 tab(LST-002 后三键)渲染 NoonListingTab,sub=tab 去前缀,setSub 回写页级 tabpage.tsx:1029-1032;NoonListingTab.tsx:39-42;受控挂载(原常驻底部自带第二套 tab 栏已并轨,page.tsx:1029 注释)三 tab 切换页级高亮同步生效
AC-EL-LST-109noon 内层 sub-tab 条页签三键:「📋 SKU 清单」「🚀 建品向导」「🗂 任务与 QC」NoonListingTab.tsx:65-69三键顺序逐字生效
AC-EL-LST-110noon SKU 清单卡卡h2「noon SKU 清单」sub「在线状态 · Buy Box · 广告问题 · API key 自动拉取」;加载中/无数据两占位NoonListingTab.tsx:71-79;GET /api/noon/offers?limit=200(NoonListingTab.tsx:46-48;noon_data.py:119);失败静默置空文案逐字;两占位互斥生效
AC-EL-LST-111noon 清单表 8 列表Partner SKU / noon SKU(截 12 灰)/ 标题(截 45,悬停全文,空显 —)/ 价格(右对齐 2 位小数)/ 前台状态(在线 ok·不可见 bad badge)/ Buy Box(✓/✗)/ FBN(整数千分位)/ 问题(N 个 warn badge 或 —)cols 定义 NoonListingTab.tsx:50-61;Partner SKU 列文本筛选;价格/FBN 可排序;exportCsv=noon_listings(NoonListingTab.tsx:75-77);DataTable 通用能力见 AC-EL-CMP8 列表头与渲染规则逐项;CSV 导出文件名 noon_listings生效
AC-EL-LST-112noon 清单口径注口径行表脚 caliber:「数据源=noon-catalog offer/list · 前台状态=live_status · Buy Box=is_winning_buybox · 问题=offer_issues(blocking 原因)。」NoonListingTab.tsx:76-77文案逐字生效
AC-EL-LST-113向导①·基础信息卡卡h2「① 基础信息」sub「SKU 须已存在于商品库(四维隔离同轴) · 保存为 noon 建品任务」;6 字段栅格NoonListingTab.tsx:241-271文案逐字;6 字段齐生效
AC-EL-LST-114向导·品牌/SKU/noon品牌/尺码/阿语标题/任务号字段组品牌下拉(默认第一个品牌);「SKU (partner_sku)」*(自动大写,编辑态锁死,placeholder「如 ZFT03WHX000ME」);「noon 品牌(展示名)」(默认品牌大写);「尺码/规格(可选)」(placeholder「如 Large / 42 / S」);「阿拉伯语标题(暂存, 单语言通道)」(rtl);「任务号」=#N 或「未保存」NoonListingTab.tsx:244-269;品牌源 /api/listing/meta brands(113-117);SKU 服务端校验产品存在(listing.py:1611-1615)小写输入断言自动大写;编辑态 SKU disabled生效
AC-EL-LST-115向导②·类目搜索框输入placeholder「搜索类目, 如 headphone / kitchen / cable…」;输入防抖 350ms 后搜索NoonListingTab.tsx:123-133,276-278;GET /api/listing/noon/categories?q=&limit=12&brand=(listing.py:1567-1574:网关全量类目缓存 24h 服务端子串过滤,limit 夹 1~200);q 等于已选类目时不搜连续输入仅 350ms 后一次请求生效
AC-EL-LST-116向导②·类目下拉浮层浮层至多 12 条候选;悬停高亮;点击选中;点击页面任意处关闭;已选类目与词相同时不弹NoonListingTab.tsx:118-121,279-293;document click 关闭监听;sub 文案「网关真实类目 {N} 个 · 三段式 family-type-subtype」(274)外点关闭与 12 条上限生效
AC-EL-LST-117向导②·已选类目行状态行「已选: {类目} · {N} 个属性(必填 {M})」或「 · 属性表单加载中…」NoonListingTab.tsx:295-301;属性源 GET /api/listing/noon/category-attrs?category=&brand=(141-148;listing.py:1577-1584:ListCategoryAttributes 按类目缓存 7 天);选新类目重置 attributes/dry/submit/qc 状态(135-139)换类目断言表单与三结果区复位生效
AC-EL-LST-118向导③·动态属性表单表单h2 sub「按网关 schema 动态生成 · 红*=必填 · 多值=每行一条 · 双语属性填英语」;必填项红 * 前缀;缺必填时底部红字「缺必填: {codes 顿号连接}」NoonListingTab.tsx:304-319;AttrDef=网关 schema(is_mandatory/attribute_type/options/min-max)必填标记与 schema is_mandatory 一致生效
AC-EL-LST-119向导·属性控件五型控件SELECT 单值=下拉(—空项+options);SELECT 多值=textarea「每行一条, 可选: 前 6 项」;NUMERIC/METRIC=number 输入(placeholder ≥min ≤max);BOOL=true/false 下拉;多值或 >200 字=textarea;默认 input(maxLength=max_characters)AttrField(NoonListingTab.tsx:397-440);类型标注「单选/数字/布尔/文件URL/文本 · 多值 · 双语位 · ≤N字」(399-408)各类型字段各断言一控件形态生效
AC-EL-LST-120向导④·图片卡表单sub「至少 1 张 · sort 为展示顺序(0 起)」;每行=URL 输入(placeholder https://…/image.jpg)+sort 数字+44px 预览缩略(加载失败隐藏)+✕ 删除;「+ 加图片」追加(sort=当前行数)NoonListingTab.tsx:321-335;保存过滤空 URL(195)坏 URL 缩略隐藏不断行生效
AC-EL-LST-121向导⑤·提交工具条按钮组「💾 保存任务/💾 保存修改/保存中…」(必填品牌/SKU/类目,缺则 toast「品牌/SKU/类目必填」)→「🔍 Dry-run 预检」(需已保存)→「确认真实提交」checkbox(需预检结果才可用)→「⚠️ 提交建品」(需勾选确认)→「🗂 看任务列表」NoonListingTab.tsx:337-354;busy 互斥禁用;保存类型归一:多值→数组(按行拆)、NUMERIC/METRIC→Number(179-187);title_en 取 product_title 属性截 500(190-194)未预检勾选框 disabled;数字属性入参为 number 型生效
AC-EL-LST-122noon 任务保存端点口径保存=upsert:无 task_id 插入、有则归属校验后更新;标题+noon品牌+≥1 图齐备→ready,否则 draft;重复建 409「该产品已有 noon 任务(打开任务列表编辑)」POST /api/listing/noon/task(listing.py:1600-1656);noon 专有字段存 gen_meta(noon_category/noon_brand/title_ar/size/images);空值属性剔除;status 仅 draft/ready 可变其余保持;audit listing.noon.task.save已 imported 任务保存断言状态不变生效
AC-EL-LST-123向导·Dry-run 结果面板面板「预检: 类目 {c} · 属性 {N} 个 · 必填 {M} 项 · 缺 {K} 项: {清单}(红) 或 · 必填齐备 ✓(绿)」;折叠「载荷 JSON 预览」pre 全量 payloadNoonListingTab.tsx:356-370;dry 端点=LST-062 同端点 dry_run=1,noon 返回 category/attribute_total/mandatory_total/missing_required/payload(listing.py:1681-1686);缺项 toast「缺必填 {N} 项」/「预检通过, 可提交」面板计数与响应三数一致生效
AC-EL-LST-124向导·建品成功面板面板绿框「✅ 建品成功 · sku_parent {x} · NSKU {y} · 已回写 sku_mapping」+variants 表 4 列(NSKU/partner_sku/psku_code/size);toast「建品成功 · NSKU {n}」NoonListingTab.tsx:372-388,217-227;成功=HTTP 200 且 variants 非空(listing.py:1699-1702);NSKU 回写 sku_mapping.nsku(_cascade_asin_to_mapping,noon 无 keepa,listing.py:52-65,1709-1711);失败 502「Noon 建品失败: {status.message 截 300}」成功后 sku_mapping.nsku 落值;失败断言任务置 failed+submit_result.error生效
AC-EL-LST-125向导⑥·QC 审核状态卡卡h2 sub「GetContent · EN/AR 独立审核 · PENDING→APPROVED/REJECTED · 驳回原因逐条列示」;「🔄 查询 QC 状态」需提交成功后可用(否则灰字「提交成功后可查询」)QcPanel(NoonListingTab.tsx:455-464);GET /api/listing/noon/content/{tid}(listing.py:1728-1757):须 noon 任务+有 sku_parent;快照合并回 submit_result.qc,任务状态保持 imported(QC 终态只呈现不改任务机,listing.py:1730-1731);audit listing.noon.qcQC 后任务状态仍 imported;submit_result.qc 更新生效
AC-EL-LST-126QC 语言卡内容展示每语言卡:{语言}+状态 badge(APPROVED ok/PENDING warn/REJECTED bad/其余无色,去 QC_STATUS_ 前缀)+「完整度 {n|—}」;缺属性=warn badge 列表;无效属性=bad badge 列表;驳回原因红字(;连接);评语灰字;errors「[code] message」红字NoonListingTab.tsx:466-495;QC_COLOR 映射(31-34)四状态色映射与文案格式生效
AC-EL-LST-127QC 图片审核块展示「图片审核 ({N})」前 6 张:review_status badge(VALID ok/INVALID bad/其余 warn,去前缀)+URL 省略灰字NoonListingTab.tsx:496-508超 6 图仅显前 6生效
AC-EL-LST-128QC 失败呈现错误态HTTP 非 200=红 pre「查询失败 HTTP {n}: {raw 截 200}」NoonListingTab.tsx:510-514mock 非 200 断言格式生效
AC-EL-LST-129向导编辑深链路由?edit={id} 打开即载入该 noon 任务回填全部字段+submit_result/qc,并按其类目拉属性表单NoonListingTab.tsx:151-170;配合 LST-003 初始 tab带参访问断言回填与 tab 落位生效
AC-EL-LST-130noon 任务与 QC 卡卡h2「noon 建品任务」sub「B1 通道任务流 · 编辑跳转向导 · imported 后可查 QC」;空态「暂无 noon 任务 — 去「建品向导」创建第一个」;caliber「通道=Content API product/upsert(2026-10-08 B1);状态机 draft→ready→imported/failed;QC 终态经 GetContent 呈现不改任务状态。」NoonTasks(NoonListingTab.tsx:523-589);GET /api/listing/tasks?platform=noon&page_size=100;exportCsv=noon_tasks文案逐字;仅 noon 行生效
AC-EL-LST-131noon 任务表列表7 列:# 灰 / SKU(文本筛选)/ 品牌 / 标题(截 40 悬停全文,空 —)/ 状态 badge(单源 LST-045,文本筛选)/ 更新(截 16)/ 操作NoonListingTab.tsx:559-576列序与渲染逐项生效
AC-EL-LST-132noon 任务行操作按钮组「编辑」=写 ?edit= 后整页 reload 进向导;「预检」=dry toast(缺 N 项: 清单 或 预检通过 ✓);「提交」仅 ready 显示,confirm「真实提交任务 #{id} 到 noon 建品?」;「QC」仅 imported 显示,toast 逐语言「{lang}:{状态}({完整度})」或「无状态」NoonListingTab.tsx:532-557,568-575四按钮状态门各断言生效
AC-EL-LST-133A+ tab 条页签三键:「📄 A+ 创建」「🖼️ 媒体库」「📋 文档 & 历史」AplusTab.tsx:85-89三键顺序逐字生效
AC-EL-LST-134A+ ①·基本信息卡卡h2「① 基本信息」sub「ASIN 多个逗号分隔 · 站点多选」;「文档名称(后台识别用)」(placeholder「如 T11 A+ 2026-09」)与「ASIN(多个逗号分隔)」两输入AplusTab.tsx:93-101;保存前必填校验:名称空 toast「文档名称必填」、ASIN 空「至少一个 ASIN」(66-68)两必填 toast 各断言生效
AC-EL-LST-135A+ ①·站点多选 toggle按钮组站点 pill 点击切换选中(on 态);来源 /api/aplus/meta marketsAplusTab.tsx:103-111,51;GET /api/aplus/meta(aplus.py:14)点击切换与 markets 集一致生效
AC-EL-LST-136A+ ①·语言缺失警告提示选了站点且媒体库全为 none 语言时黄字「⚠ 媒体库暂无非英文图 → 将用英文图打底(UVPVP 同语义警告)」AplusTab.tsx:56-58,113-117;判定=所选站点 locale 无对应语言图(UVPVP 同语义)媒体库仅 none 语言断言警告出现生效
AC-EL-LST-137A+ ②·模板布局单选三 radio pill:「经典版(推荐)」「简洁版」「自定义」+ 说明「经典版=Header大图+3图文+4宫格+对比表 · 简洁版=无对比表 · 自定义=按需填模块」AplusTab.tsx:120-134;TEMPLATES:classic=header+three+quad+compare / simple=无 compare / custom=全四模块(28-32)选简洁版断言 compare 模块不渲染生效
AC-EL-LST-138A+ ③·模块内容与图片槽表单按模板渲染模块:① Header 大图+标题(1 图 1 文)/ ② 3 图文并排 / ③ 4 宫格 / ④ 对比表(0 图);图片槽 input 带 datalist 联想(媒体库引用);文本槽 textarea;compare 另有「对比的 ASIN(逗号分隔,不含本 ASIN)」输入AplusTab.tsx:136-172;MODULES 定义(22-27);datalist id=aplus-media-refs 选项=media.media_ref(138-140)模块槽位数=MODULES imgs/texts 定义生效
AC-EL-LST-139A+ ④·保存卡按钮「💾 保存草稿」toast「草稿已保存(#{id})」;下方预览行「预览:{N|—} 站点 · {N|—} ASIN · 模板 {key} · 模块 {a+b}」;已保存显示「当前草稿 #{id}(再次保存=更新)」AplusTab.tsx:66-79,175-185;POST /api/aplus/draft {name,asins[],market 逗号,template,content,doc_id}(aplus.py:81);ASIN 按逗号/空白拆分二次保存同 doc_id 更新不新建生效
AC-EL-LST-140A+ ④·提交审核(禁用)按钮「🚀 提交审核(未接凭证)」恒 disabled,title「SP-API 凭证未接入(需求单)」AplusTab.tsx:179;本期闭环=草稿+媒体库+登记+历史(AplusTab.tsx:3-4 注释)按钮恒禁用;无网络请求未上线保留
AC-EL-LST-141A+ 媒体库·登记卡表单h2「登记媒体库图片」sub「引用=Amazon 媒体库路径或本站上传 URL · 语言标记手动(OCR 校验未接入)」;字段=媒体引用路径(placeholder aplus-media-library-service-media/xxx.jpg 或 https://…)/语言下拉 9 项/标签(placeholder 如 T11-主卖点-1)/「登记」按钮;空引用 toast「媒体引用路径必填」AplusTab.tsx:221-238,205-213;LANGS=en/ar/de/fr/es/it/nl/ja/none(20);POST /api/aplus/media(aplus.py:42);成功 toast「已登记」语言选项 9 项逐字生效
AC-EL-LST-142A+ 媒体库·已登记表表h2「已登记图片({N})」;5 列:媒体引用(省略)/语言 chip/标签(空 —)/登记时间/「删」按钮(confirm「删除媒体登记」)AplusTab.tsx:239-258,214-218;DELETE /api/aplus/media/{id}(aplus.py:61);空态 EmptyState「暂无登记」提示「上方登记第一条媒体引用」删除后行消失并 toast生效
AC-EL-LST-143A+ 文档表表h2「A+ 文档」sub「草稿闭环 · 提交审核未接凭证」;站点过滤 input(placeholder「按站点过滤 如 US」);7 列:名称/站点(空 —)/ASIN(逗号连接省略)/模板/状态(恒 badge warn draft)/更新/操作(编辑·删)AplusTab.tsx:282-310,268-272;GET /api/aplus/documents[?market=](aplus.py:127);「编辑」回填创建 tab 全字段(192);「删」confirm「删除草稿」「{name}」?(仅草稿可删)」DELETE /api/aplus/docs/{id}(aplus.py:115),失败 toast「删除失败(仅草稿可删)」;空态「暂无文档/在「A+ 创建」保存第一份草稿」过滤参数透传;编辑回填各字段生效
AC-EL-LST-144A+ 操作历史表表h2「操作历史」sub「只追加」;6 列:时间/操作/ASIN(空 —)/站点(空 —)/状态(成功 ok·失败 bad badge)/明细(省略,空 —);空态「暂无历史」AplusTab.tsx:311-331;GET /api/aplus/history(aplus.py:140)列序与空态文案生效
AC-EL-LST-145文件 tab·错误横幅错误态err 非空时红条 role=alert 呈现错误文本FilesTab.tsx:58断言 role=alert生效
AC-EL-LST-146文件 tab·三 KPI 卡指标卡「文件总数」(foot「企业内共享(RLS 隔离)」)/「占用空间」(fmtSize:>1MB 一位小数 MB、>1KB 取整 KB、否则 B;foot「宿主卷存储 · P2 换 S3」)/「支持类型」(静态文案「图片 / PDF / Office」,foot「xlsx·docx·pptx·csv·mp4·zip·txt·json」)FilesTab.tsx:12-16,59-75;数据 GET /api/upload/files(26-29;collab.py:177):total/total_size/items换算阈值三段各验一值生效
AC-EL-LST-147文件 tab·拖拽上传区上传卡头 h2「上传文件」sub「拖拽或选择 · 上传后复制外链用于 Listing / 文档」(FilesTab.tsx:78);虚线框 📤+「拖拽文件到此处,或点击选择」(busy 显「上传中…」)+「单文件 ≤ 50MB · 存储路径按 企业/月份 归档」;支持拖拽与点击(隐 multiple input);成功行内绿字「已上传 {N} 个文件 ·」FilesTab.tsx:77-92,31-48;逐文件 POST /api/upload FormData(collab.py:149);单文件失败仅该文件红条不停批多文件混合成败断言计数与红条生效
AC-EL-LST-148文件 tab·文件列表表表h2「文件列表」sub「{N} 个文件」;6 列:文件名(加粗)/大小(右对齐 fmtSize)/类型(空 —)/上传时间/外链(a 新窗口,url 文本)/「删除」按钮;空态「还没有文件」colSpan=6FilesTab.tsx:94-116;外链=鉴权 raw 接口地址(UI-08 2026-10-14:Caddy /uploads 公开直出已永久关闭 404,统一走 /api/collab/files/{id}/raw 会话鉴权+RLS,FilesTab.tsx:118-121 注释与正文);表脚说明「外链仅登录会话可读…上传统一走 /api/upload 鉴权接口。存储为宿主卷(对象存储迁移列入 P2)。」外链未登录访问断言 401/404;登录可读生效
AC-EL-LST-149文件 tab·删除护栏护栏「删除」confirm「删除文件?/ 关联外链将立即失效。」danger 红字按钮FilesTab.tsx:50-54,109;DELETE /api/upload/files/{fid}(collab.py:192);确认后才请求取消断言无请求生效
AC-EL-LST-150规格书/任务/事件三端点(清单类)数据源配套只读端点:GET /api/listing/specs(规格书列表最新在前 limit≤50)、GET /api/listing/tasks、GET /api/listing/events?task_id=(审计轨迹 limit≤200)listing.py:584-596(specs)、667-698(tasks)、1093-1109(events);页面当前仅消费 tasks,specs/events 为 API 层完备性登记(页面出现即须有标准)三端点鉴权+企业隔离各验一发生效
AC-EL-LST-151PT 元数据端点(pt-schema)数据源GET /api/listing/pt-schema?brand=&market=&pt=&refresh=:官方属性元数据,listing_category_meta 缓存 7 天,畸形 schema 422 不缓存空元数据listing.py:1168-1202;bind_pt 内部同源拉取(LST-056);本页未直接调用(绑定经 bind-pt 端点),API 层完备性登记7 天内二次调用 cached=true生效
AC-EL-LST-152任务删除端点(未上界面)护栏DELETE /api/listing/tasks/{tid}:仅 draft/failed/imported 可删(建错清理/归档);事件保留为审计残迹(无 FK);_require_adminlisting.py:941-956;本页无删除按钮(页面未暴露)——API 存在而 UI 无入口,如实登记防误删边界(铁律:不可误删)ready 任务 DELETE 断言 409;删除后 listing_events 仍在生效
AC-EL-LST-153企业隔离与模块门控护栏全端点 require_module('listing');approve/revert/export/import-results/submit/batch 另需 owner/admin;全部数据访问走 tenant_conn(tenant_id, brand_scope)listing.py:9(模块 docstring)、111、各端点 Depends(_mod)+_require_admin(893,927,962,1037,1276,1378);meta 品牌按员工范围收敛(442-443);铁律:企业/品牌绝对独立无 listing 模块企业访问断言 403;跨企业 task id 断言 404生效
AC-EL-LST-154审计与事件全覆盖护栏写操作全部双落:audit()(企业审计日志)+listing_events(任务轨迹);事件动作集=create/edit/generate/approve/revert/delete/export/import_result/submit/bind_pt/qcaudit 调用 listing.py:549,578,663,835,886,922,937,955,1025,1089,1305,1342,1357,1242,1384-1513 各分支,1655,1682,1714,1756;_event 写入 399-402 detail 截 4000每写操作后两日志各断言一条生效
AC-EL-LST-155常量与限值集中定义口径MAX_UPLOAD=10MB / TITLE_MAX=200 / BULLET_MAX=500 / BULLET_MIN=3 / MAX_RAW=100000(规格书文本截断)/ 前端同步限值(maxLength 200/500/5000)listing.py:134-138;前端 page.tsx:556,564,571,730,756,763 一致;同口径跨层必相等前后端限值逐项比对相等生效
AC-EL-LST-156级联回写口径(ASIN/NSKU)口径推送/回流取得 ASIN 或 NSKU 后回写 sku_mapping(仅补空值不覆盖已有)+Amazon 进 keepa_watch 关注池(auto_cascade 源,ON CONFLICT 跳过);noon 无 keepa_cascade_asin_to_mapping(listing.py:45-72);market 精确匹配 country 行优先,未匹配则补该 SKU 全部空行(56-65);触发点=import 回流(1079-1084)/amazon 提交(1336-1339)/noon 提交(1709-1711);GB→UK 域映射(68);铁律:宇宙事实源=sku_mapping 不另造清单已有非空 asin 的行不被覆盖;keepa_watch 无重复行生效
AC-EL-LST-157型号分组行首列单元格「{model} {brand 灰}」;平台/站点列「{platform}[ · {market}]」(market 空省略段);SKU 数列右对齐整数page.tsx:1052-1054三单元格格式断言生效
AC-EL-LST-158批量生成链路口径口径型号流程「生成全部」=模板任务 generate(AI)→ 其余任务 batch generate_sync(拷贝,非逐任务再生成);单任务「规则生成」按钮同端点page.tsx:220-235(flowGenerate 先 generate 再 batch);模板选择=首条有 title 任务(page.tsx:166-168,204);batch 内模板任务自身记 ok note=模板(listing.py:1403)63 SKU 型号断言仅 1 次 LLM generate+62 次同步拷贝生效
AC-EL-LST-159三子组件归属边界边界NoonListingTab(listings/NoonListingTab.tsx 591 行)、FilesTab 与 AplusTab(upload/ 两文件)为本页专属子组件,随本节全量登记;/upload 路由本身=308 重定向本页(AC-EL-REDIR-003);DataTable 通用能力归 AC-EL-CMP 不逐列展开page.tsx:7-9 import 实证;upload/page.tsx:5 redirect("/listings")import 走查无第三处挂载点生效

§11.31 排名页(/rankings · AC-EL-RANK,84 条 · 2026-10-22 源码实证 web/app/rankings/page.tsx 718 行 + api/routers/dashboard.py 排名端点,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-RANK-001页面标题/面包屑导航AppShell title=市场表现,面包屑「排名 · 评分 · 评论 · AI 分析 — Amazon/Noon 在榜产品全景(大类/小类 BSR · 90 天趋势)」路由 /rankings(page.tsx:518);AppShell 壳层归 AC-EL-CMP 共享组件条目,此处只立本页定制文案e2e 登录后断言标题与面包屑逐字一致生效
AC-EL-RANK-002页级错误横幅反馈红色横幅 role="alert",展示最近一次接口异常 messagepage.tsx:519;markets 清单或榜单任一 getJson 失败 setErr 触发;无错误不占位e2e mock /api/rankings 500 断言横幅出现且带 alert 角色生效
AC-EL-RANK-003四视图 Tab 组导航「📊 BSR 排名 / ⭐ 评分与评论 / 💬 评论内容 / 🤖 AI 评论分析」四 tab,默认 BSR 排名page.tsx:520-524,view state=bsr∣rating∣reviews∣ai 默认 bsr(2026-10-07 用户令四合一,page.tsx:389-390);tab 只切前端视图不发请求e2e 依次点四个 tab 断言各视图容器出现生效
AC-EL-RANK-004品牌选择器筛选顶栏品牌下拉(共享组件,本页不重复展开)useBrand() 单源(H9 2026-10-13),brand 参数贯穿 markets/榜单/analytics/评论各请求;共享元素归 AC-EL-CMPe2e 切品牌断言 markets 与榜单请求均带新 brand 参数生效
AC-EL-RANK-005🔄 更新数据按钮按钮tab 行右端「🔄 更新数据」,运行中变「采集更新中…」并 disabled;title 提示「立即采集排名/评分/review数量(Keepa)并回报各源新鲜度」page.tsx:526-528;POST /api/rankings/refresh(dashboard.py:2917-2946)同步 asyncio.run(tasks.daily_amazon_rankings_keepa),写完自动触发清洗;限 owner/admin,否则 403「仅 owner/admin 可手动更新数据」以 viewer 角色点按钮断言 403 提示;owner 点后断言 refreshNote 出现生效
AC-EL-RANK-006采集回报条反馈成功:「✅ 采集 N ASIN 写入 M 行 · Amazon排名至 D1 · noon评论至 D2 · Amazon评论 X 条」;失败:「❌ + 错误信息」page.tsx:394-408、531;N/M 取 refresh.asins/written,D1/D2/X 取 sources.amazon_rankings/noon_reviews/amazon_reviews.count(noon 取各企业 schema 最新,ISO-01)e2e 点更新数据断言回报条格式与字段齐全生效
AC-EL-RANK-007KPI①快照日期KPI大数字=as_of 日期,foot=「Amazon/Noon · 市场码」或「选择市场」page.tsx:537-541;as_of=/api/rankings 回传该平台×市场 max(snap_date)(dashboard.py:2060-2061)SQL 查该市场 max(snap_date) 与页面比对相等生效
AC-EL-RANK-008KPI②在榜产品(截断披露)KPI值=当前展示行数;筛选后总数超 60 时 foot=「按BSR/评论总量显示前 60(筛选后共 N 个)」,否则「最新快照(N 个站点行)」page.tsx:542-550;D批P3-10(2026-09-26)截断显式披露——服务端 LIMIT 60 并回传 total_matched(dashboard.py:2056-2059),不让用户误以为榜上只有 60 个 SKU;N 个站点行=markets 卡该市场 productscurl /api/rankings 断言 total>items.length 时 foot 出现「筛选后共」字样生效
AC-EL-RANK-009KPI③平均评分/总评论KPI值=平均评分(两位小数),foot=「N 条评论」page.tsx:472-476、551-555;客户端口径=当前 60 行内 rating 非空行均值 toFixed(2)(无评分行不计分母),总评论=Σreview_count;边界=仅统计展示行,非全市场口径取 /api/rankings items 手工复算均值与页面相等生效
AC-EL-RANK-010KPI④当前品牌KPI值=品牌名或「全部」,foot=「Amazon X · Noon Y 个市场」page.tsx:556-560;X/Y=markets 清单按平台计数(含无快照市场);品牌过滤后为该品牌有数据的市场数切品牌断言 foot 两数与 markets 清单分组计数一致生效
AC-EL-RANK-011市场选择卡标题标题「市场选择」+ 副题「平台 · 站点(产品数 / 快照日)」page.tsx:564;副题即 chip 内容承诺(产品数+快照日两元素必须同时在 chip 上,见 RANK-013)e2e 断言标题与副题文本生效
AC-EL-RANK-012平台双 Tab筛选「Amazon(N 市场)/ Noon(N 市场)」两 tab,各只列本平台市场 chippage.tsx:565-575;2026-10-12 用户令分平台双 tab;切平台 pickPlat 自动选中该平台首个市场(page.tsx:453-460),无数据则置空走空态并清空展开态e2e 切 Noon 断言首个 noon 市场自动选中生效
AC-EL-RANK-013市场 chip筛选每市场一枚 chip:「市场码 · 产品数 · MM-DD 快照日」;快照落后全场最新的标琥珀色,无快照显「· 无快照」page.tsx:578-590;2026-09-29 修——各市场计数取自各自最新快照日,断流市场(如 UK 停 09-27)与当日市场混排无标识会误导,故 chip 必须带快照日且 latest<maxLatest 标 var(--warn)(page.tsx:436-438 注释)e2e 断言含停更市场的环境里该 chip 颜色为 warn生效
AC-EL-RANK-014市场清单加载与选中数据进入页面/切品牌即拉市场清单,自动选中首个市场GET /api/rankings/markets?brand=(page.tsx:422-432;dashboard.py:1926-1954)——audit.cleaned_rankings_daily 按平台×市场取 max(snap_date)+当日计数;排序=有真实数据(rating/bsr 非空)优先(2026-09-19 修:domain1/5/6 等全 NULL 占位行不再排首致默认选中空白);brand 切换重取并自动选该品牌首个有数据市场(2026-09-19 修,如 onno 在 DE 无快照不停留)curl markets 断言排序首个市场 real_cnt>0;SQL 造占位行复现排序修复生效
AC-EL-RANK-015amazon 市场白名单口径amazon 平台市场只出 keepa 真实域站点#49(2026-10-09,dashboard.py:1934-1938 注释/1971-1972 白名单拦截):RANKING_MARKETS 白名单过滤 EU 假市场(FBA 报表残留 country=EU)、UK(目录改码 GB 后 09-29 冻结)与历史 domain 占位行;SE/BE/IE/PL 曾用 US 域冒牌数据一并退场;noon 不受影响;巡检侧同口径见 §11.20 AC-EL-PIPE-039curl markets?platform=amazon 断言无 EU/SE/BE/IE/PL 市场生效
AC-EL-RANK-016平台无市场空态空态「该品牌暂无 Amazon/Noon 平台市场数据」page.tsx:591-593;该品牌此平台 markets 过滤后为空时渲染e2e 选无 noon 数据品牌切 Noon tab 断言空态文案生效
AC-EL-RANK-017产品搜索框筛选placeholder「搜索产品名 / ASIN」+「搜索」按钮page.tsx:595-598;submit 把 search 存入 query 触发重拉;服务端匹配=name ILIKE 或 sku_mapping 解析名 sm.product_name ILIKE 或 asin ILIKE(dashboard.py:2042),三路任一命中curl /api/rankings?search=ASIN 断言命中行;e2e 搜已知 ASIN 断言表内出现生效
AC-EL-RANK-018榜单卡标题(双态)标题Amazon=「BSR 排名」副题「点击行展开 90 天 BSR 趋势(Y 轴反向 = 越上越好)· 每行 = 家族代表 ASIN…」;Noon=「卖家反馈全景」副题「noon 无类目排名数据源——按评论总量排序,点击行展开 90 天评分/评论趋势」page.tsx:603-605;2026-10-14 noon 口径B(用户拍板,page.tsx:512-513 注释):noon 源表实为卖家评论日快照、BSR 四列全 NULL,表格/卡片/展开图按平台分支e2e 分别在 amazon/noon 市场断言对应标题与副题生效
AC-EL-RANK-019Amazon 表头 10 列表格#/产品/品牌/BSR 大类/小类/评分/评论/卖家评分/90 天变化/区间page.tsx:616-620;列集为 amazon 平台专属,noon 切 8 列(见 RANK-020)e2e 断言 thead 列名与列数生效
AC-EL-RANK-020Noon 表头 8 列表格#/产品/品牌/评论总量/评分/卖家评分/90 天净增/快照次数page.tsx:613-615;colN=8(page.tsx:517);口径B 不展示无意义的 BSR 列e2e 切 noon 市场断言 8 列且无 BSR 字样生效
AC-EL-RANK-021行主键口径口径一行=一(品牌, 行键);展开态以「品牌+行键」标识_RANK_KEY=coalesce(nullif(asin,''),name)(dashboard.py:1958):ASIN 缺失时(Noon Z 码等)回退产品名,与历史趋势 join 同口径; DISTINCT ON (brand,行键) 去重SQL 抽 noon 行断言 key=Z 码产品名、amazon 行 key=ASIN生效
AC-EL-RANK-022列·产品名表格加粗显示名服务端 coalesce(nullif(sm.product_name,''),c.name)——2026-10-14 修(用户报障「排名没有产品名称」):源 name 列是机器键(amazon=ASIN、noon=Z码),显示名经 sku_mapping LATERAL 解析(amazon 按 (brand,asin);noon 按 (brand,nsku 前缀=Z码-序号)),无映射回退机器键(dashboard.py:1975-1981 注释与 name_on/2010/2022-2024 sm LATERAL)SQL 对今日快照 amazon 行断言 100% 可映射出显示名生效
AC-EL-RANK-023列·产品底行 SKU·ASIN表格产品名下小字「渠道SKU · ASIN」,无 SKU 回退 ASIN 或「—」page.tsx:633;2026-09-28 C9——SKU 同样经 sku_mapping 解析(LATERAL 取 LIMIT 1),无映射回退机器键e2e 断言已映射行底行含「·」连接的 SKU+ASIN生效
AC-EL-RANK-024列·家族代表徽标表格Amazon 行产品下方胶囊「家族代表 {家族键} · 家族 N 个 ASIN」(仅 N>1 且非 noon)page.tsx:632-638;2026-10-20 方案A(用户问询 fg 在榜 9 ASIN vs mapping 208):#57-g 起采集每(品牌,家族,市场)只拉 1 个代表 ASIN,行内标注家族防观感断层;fam/fam_asins 由 sku_mapping 静态 LATERAL 计算(dashboard.py:2029-2041),家族键=型号>归一化产品名>~asin 与采集器 _family_groups 同口径,平台限 Amazon(noon 无 asin 自然落空)SQL 取 fg Amazon 某家族断言 fam_asins=sku_mapping 同家族 DISTINCT asin 数生效
AC-EL-RANK-025列·品牌表格品牌色点+品牌名page.tsx:643;brandColor 共享调色(AC-EL-CMP)e2e 断言多品牌行色点颜色随品牌变化生效
AC-EL-RANK-026列·BSR 大类表格加粗整数 BSR 值+灰色后缀「 · 大类类目名」;NULL 显「—」page.tsx:657-663;类目名后缀=2026-10-10 #60挂账③(与小类横向统一,有的都要);bsr_big/bsr_big_category 取自最新快照 cur CTEe2e 断言有类目名的行后缀存在且以「 · 」分隔生效
AC-EL-RANK-027列·小类表格灰字整数+「 · 小类类目名」;NULL 显「—」page.tsx:664-668;bsr_small/bsr_small_category 同快照口径e2e 断列存在与格式生效
AC-EL-RANK-028列·评分/评论/卖家评分(Amazon)表格评分、评论数各一位小数/整数;卖家评分灰字;NULL 均「—」page.tsx:665-667;rating/seller_rating toFixed(1)、review_count intSQL 抽行比对三值与页面渲染一致生效
AC-EL-RANK-029列·90 天变化(Amazon)表格「±N (±P%)」;改善(d≤0)绿、恶化红;基准缺失显「—」page.tsx:22-27 trend():d=bsr_big−first_bsr、pct=d/first_bsr×100——BSR 数值降=名次升=改善故 d≤0 绿;first_bsr=90 天窗口首值(hist CTE array_agg 首日,dashboard.py:2002);首值 NULL/0 显「—」取一行 90 天快照手工差分比对 txt 与颜色生效
AC-EL-RANK-030列·区间(Amazon)表格灰字「min90~max90 · N次」;无 90 天数据显「—」page.tsx:671-673;min90/max90=90 天窗口 bsr_big 极值、snapshots=窗口内快照行数(hist CTE,窗口=最新日−90)SQL 复算窗口极值与快照数比对生效
AC-EL-RANK-031列·评论总量(Noon)表格加粗整数;NULL 显「—」page.tsx:645;口径B 排序列=review_count DESC NULLS LAST(dashboard.py:1984)curl noon 榜断言行按评论总量降序生效
AC-EL-RANK-032列·90 天净增(Noon)表格「+N」绿色(>0)、「N」无色、「—」(无法计算)page.tsx:649-652;net90=90 天评论净增(dashboard.py:2008 骤降检出/2014-2020 CASE):源端 09-30 全线计数重置(旧口径聚合值不可比)——服务端检出最近一次骤降(降至前值一半以下)为纪元起点 era_cnt,net90=现值−era_cnt;无重置走窗口首值差分;现值<基准时 NULL 显「—」SQL 取 09-30 前后有快照的 noon 行复算 net90=现值−重置日值生效
AC-EL-RANK-033列·快照次数(Noon)表格灰字「N 次」page.tsx:652;snapshots=hist 90 天窗口内该行快照数,coalesce(h.n,1) 至少 1SQL 复算窗口计数比对生效
AC-EL-RANK-034行点击展开交互点行切换展开行(colSpan 整行),再点收起;切换市场/平台收起展开态page.tsx:461-470/681;展开即 GET /api/rankings/history?platform&market&brand&key(dashboard.py:2065-2087):返回 date/bsr_big/bsr_small/rating/reviews/stars;market+brand+key 任一缺失返回空;失败静默置空图表e2e 点行断言展开行出现且图表 canvas 挂载生效
AC-EL-RANK-035展开图①BSR 趋势线图平滑折线+浅面积,Y 轴反向标注「BSR(升)」page.tsx:502-513(histOption);Y 轴 inverse=BSR 数值越小越靠上;noon 展开跳过此图(口径B 无 BSR 源);T2-8(2026-09-12)五图 UVPVP 对齐e2e amazon 行展开断言首图为 BSR 图、noon 行展开无生效
AC-EL-RANK-036展开图②评分线/③评论数线图两图并排网格:「评分」「评论数」平滑折线(X 轴 MM-DD)page.tsx:481-490(lineOpt 复用);双平台共用e2e 展开断言两图节点数=快照日数生效
AC-EL-RANK-037展开图④星级分布堆叠柱图5★~1★ 五色堆叠柱(Y 轴上限 100%),仅当历史含 star_pct 五元组时渲染page.tsx:479/491-504;star_pct=[5★,4★,3★,2★,1★]% 数组,缺失为 None(T2-8,dashboard.py:2084-2086);hasStars=任一快照 stars 长度≥5SQL 抽有 star_pct 的行展开断言堆叠图出现生效
AC-EL-RANK-038展开加载态加载展开行内「加载趋势…」page.tsx:694;hist 未返回前渲染e2e 慢网络断言过渡文案出现生效
AC-EL-RANK-039表空态空态居中「该市场暂无快照」(colSpan=列数)page.tsx:702-704;items 为空时渲染;市场本身无数据(market 为空)则显示「该品牌在 X 平台暂无市场数据」(page.tsx:606)e2e 选空市场断言两种空态各自出现生效
AC-EL-RANK-040表加载态加载「加载中…」page.tsx:607;!data 且 market 非空时渲染(切市场即置 null 重拉)e2e 断言切市场瞬间出现加载文案生效
AC-EL-RANK-041榜单排序与截断口径口径Amazon 按 BSR 大类升序、Noon 按评论总量降序;均 LIMIT 60dashboard.py:1984 rank_expr=bsr_big ASC NULLS LAST(amazon)/ review_count DESC NULLS LAST(noon,口径B 2026-10-14 用户拍板);LIMIT 60+total_matched 回传(D批P3-10,page.tsx:546 注释)curl 断言 items≤60 且 total 字段存在生效
AC-EL-RANK-042UK→GB 归一口径查询 UK 自动归一 GB,GB 榜单并入历史 UK 行#49(2026-10-09,dashboard.py:1969-1970/2073-2074):目录改码 co.uk→ISO GB 后 UK 断更(09-29 冻结),GB 查询 market IN ('GB','UK') 保 90 天趋势连续;归一仅榜单+历史两处,markets 端点无归一(其市场白名单本身滤 UK)curl /api/rankings?market=GB 断言含 09-29 前快照行的趋势数据生效
AC-EL-RANK-043榜单口径脚注(双态)口径通用句「数据源:平台榜采集(amazon/noon),AE/SA 高频更新,其余站点周期快照;趋势 = 90 天窗口内 BSR 大类对比。」;noon 追加「noon 侧为卖家评论日快照…源端于 09-30 全线重置计数,净增自重置日起算。」page.tsx:709-712;追加句仅 isNoon 渲染,与 RANK-032 net90 口径互证e2e 双平台断言脚注句式切换生效
AC-EL-RANK-044⭐视图数据加载数据切评分视图即拉聚合,失败红横幅,未返回「加载中…」page.tsx:48-55;GET /api/rankings/rating-review-analytics?brand=(dashboard.py:2805-2889)单端点回 as_of/distribution/review_distribution/brands/bsr_distribution/trend/top_review_skus/noon_reviewscurl 端点断言八键齐全生效
AC-EL-RANK-045⭐KPI①快照日期KPIas_of 日期,foot=「{Amazon|Noon} · {市场}」(未选市场时「选择市场」)page.tsx:405-407(BSR 视图 KPI①;R4b P4 核正:原 foot「Amazon 全站点」全树不存在,行号同步漂移);as_of=amazon 平台(白名单市场)max(snap_date)(dashboard.py:2818-2821)SQL 复算白名单内 max(snap_date) 比对生效
AC-EL-RANK-046⭐KPI②在榜 SKU/平均评分KPI[2026-10-24 已删——评分面按 AC-CAL-17 改采集原值直读(市场表现 7×放大事故拍板), 聚合区块全删; 2026-10-25 批E 陈账清点随修随换]「N · X.XX」,foot「M 个品牌」page.tsx:59-60/93-97;N=Σdistribution.count、均值=Σ(avg_rating×skus)/Σskus 客户端加权(按品牌 SKU 数加权,非简单平均)取 brands 数组手工加权复算比对已删·AC-CAL-17
AC-EL-RANK-047⭐KPI③评论总量(Amazon)KPI[2026-10-24 已删——评分面按 AC-CAL-17 改采集原值直读(市场表现 7×放大事故拍板), 聚合区块全删; 2026-10-25 批E 陈账清点随修随换]总量,foot「零评论 SKU N 个」page.tsx:98-102;Σbrands.total_reviews、零评论=Σzero_reviews(review_count=0 行)SQL 复算两值比对已删·AC-CAL-17
AC-EL-RANK-048⭐KPI④noon 卖家评论KPI[2026-10-24 已删——评分面按 AC-CAL-17 改采集原值直读(市场表现 7×放大事故拍板), 聚合区块全删; 2026-10-25 批E 陈账清点随修随换]总量,foot「差评(≤2星) N 条」page.tsx:103-110;Σnoon_reviews.reviews、差评=Σnegative(rating≤2 计数);数据源=各企业 noon schema seller_reviews 经 qsource 聚合(ISO-01 企业品牌路由,dashboard.py:2861-2885),异常时该品牌记零不炸页qsource 复算某企业 seller_reviews 总数与 ≤2 星计数已删·AC-CAL-17
AC-EL-RANK-049⭐卡·评分分布图[2026-10-24 已删——评分面按 AC-CAL-17 改采集原值直读(市场表现 7×放大事故拍板), 聚合区块全删; 2026-10-25 批E 陈账清点随修随换]横条图:档位「4.5-5/4-4.5/3.5-4/3-3.5/<3」★+计数+「均N条」page.tsx:112-126;分桶=服务端 CASE(dashboard.py:2823-2829),条宽=count/全图最大 count;avg_reviews=该档平均评论数;空态「无评分数据」SQL 复算各档计数与均值比对已删·AC-CAL-17
AC-EL-RANK-050⭐卡·评论数量分布图[2026-10-24 已删——评分面按 AC-CAL-17 改采集原值直读(市场表现 7×放大事故拍板), 聚合区块全删; 2026-10-25 批E 陈账清点随修随换]横条图:档位「0/1-10/11-100/101-1k/1k+」条+计数page.tsx:127-139;2026-10-07 用户令「review 数量」维度;分桶=服务端 CASE(dashboard.py:2829-2835);空态「无数据」SQL 复算五桶计数比对已删·AC-CAL-17
AC-EL-RANK-051⭐卡·BSR 大类分布图[2026-10-24 已删——评分面按 AC-CAL-17 改采集原值直读(市场表现 7×放大事故拍板), 聚合区块全删; 2026-10-25 批E 陈账清点随修随换]横条图:档位「<1K/1K-10K/10K-50K/50K-100K/>100K」page.tsx:140-154;只统计 bsr_big 非空行(dashboard.py:2845-2850);2026-10-07 起采集器补写 BSR 大类后开始积累,无数则 EmptyState「暂无 BSR 数据」hint「2026-10-07 起排名采集已补写 BSR 大类,点右上「🔄 更新数据」立即拉一次,数据从此日起积累。」如实空不造数SQL 复算五桶计数;空库断言 EmptyState 文案已删·AC-CAL-17
AC-EL-RANK-052⭐表·品牌对比 9 列表格[2026-10-24 已删——评分面按 AC-CAL-17 改采集原值直读(市场表现 7×放大事故拍板), 聚合区块全删; 2026-10-25 批E 陈账清点随修随换]品牌/SKU/平均评分/评论总量/平均评论/≥4★(绿)/<3★(红)/零评论/优良率page.tsx:158-176;优良率=round(good/skus×100)%(客户端);good=rating≥4、poor=rating<3、zero=review_count=0(服务端 FILTER,dashboard.py:2836-2843);空态「无数据」colSpan=9SQL 复算某品牌 good/poor/zero 与优良率已删·AC-CAL-17
AC-EL-RANK-053⭐品牌对比·noon 追加行表格[2026-10-24 已删——评分面按 AC-CAL-17 改采集原值直读(市场表现 7×放大事故拍板), 聚合区块全删; 2026-10-25 批E 陈账清点随修随换]浅底(#fafbfc)行:品牌+「· noon卖家评论」标签,品牌列下国家拆分行「AE N条·X.X★ / SA …」,SKU/平均评论/≥4★/零评论列「—」,<3★列=差评数(红),优良率列=「最新 日期」page.tsx:177-193;只追加 reviews>0 的 noon 品牌;国家拆分=seller_reviews 按 upper(country) 分组(2026-10-10 修复后可用,dashboard.py:2867-2885 循环内);与 amazon 行同表不同源不混算qsource 复算某品牌国家拆分与差评数比对已删·AC-CAL-17
AC-EL-RANK-054⭐图·评分与评论趋势(近30天)图[2026-10-24 已删——评分面按 AC-CAL-17 改采集原值直读(市场表现 7×放大事故拍板), 聚合区块全删; 2026-10-25 批E 陈账清点随修随换]双轴:平均评分紫折线(Y 左轴 3~5 定区间)+评论总量灰柱(Y 右轴)page.tsx:63-79/204-206;数据=snap_date≥current_date−30 按日 avg(rating)/sum(review_count)(dashboard.py:2851-2857);快照日<2 个 → EmptyState「趋势点不足」hint「少于 2 个快照日,无法画线。」SQL 复算 30 天逐日均值比对;单快照日断言空态已删·AC-CAL-17
AC-EL-RANK-055⭐表·评论最多的 SKU(Top 15)表格[2026-10-24 已删——评分面按 AC-CAL-17 改采集原值直读(市场表现 7×放大事故拍板), 聚合区块全删; 2026-10-25 批E 陈账清点随修随换]列 #/ASIN/品牌/评论数/评分;仅 Top15 非空时整卡渲染page.tsx:209-222;服务端最新快照 review_count 非空行 ORDER BY review_count DESC LIMIT 15(dashboard.py:2856-2859)SQL 复算 Top15 顺序比对已删·AC-CAL-17
AC-EL-RANK-056⭐分析页口径脚注口径「数据源:rankings_daily(Amazon,Keepa 日采)+ noon seller_reviews(portal API);评论正文在「💬 评论内容」tab,AI 分析在「🤖 AI 评论分析」tab。」page.tsx:229-231;三视图互链说明e2e 断言脚注逐字生效
AC-EL-RANK-057⭐聚合白名单口径口径评分视图全部聚合只算 RANKING_MARKETS 白名单内市场#60(2026-10-10,dashboard.py:2812-2816):历史占位/冒牌市场行(EU/SA/AE/PL/IE/BE/SE/UK/domain1 共 4,439 行,≤10-09)不再混入分布/品牌对比/30天趋势;实证 fg 趋势 10-09 SKU 441→2319、评论 109,973→470,112 假尖峰;与 RANK-015 榜单侧白名单同源同口径SQL 造 domain1 历史行断言不进 distribution/trend生效
AC-EL-RANK-058💬卡标题标题「💬 评论内容」副题「noon=卖家评论(portal API 直采) · Amazon=商品评论(crawlbase 采集)」page.tsx:258;2026-10-07 用户令双源合一列表(page.tsx:236-237)e2e 断言标题与副题生效
AC-EL-RANK-059💬源切换双 Tab筛选「Noon 卖家评论 / Amazon 商品评论」,默认 noonpage.tsx:260-261;src state 切换即重拉;两源字段名不同(comment vs body、count vs total)由前端兼容e2e 切源断言请求 URL 与列表重拉生效
AC-EL-RANK-060💬星级筛选筛选下拉「全部星级/5 星/4 星/3 星/2 星/1 星」page.tsx:262-265;rating=0 表全部,作为 rating 参数下发两源curl 断言 rating=5 只回 5 星评论生效
AC-EL-RANK-061💬刷新按钮与计数按钮「刷新」按钮重拉当前源;右侧「共 N 条」page.tsx:266-267;N=noon 源 count / amazon 源 total(page.tsx:251)e2e 点刷新断言计数与返回 total 相等生效
AC-EL-RANK-062💬数据源 URL数据noon 源=/api/noon/reviews?rating&limit=200&brand;amazon 源=/api/rankings/amazon-reviews?rating&brandpage.tsx:246-249;amazon 端点(dashboard.py:2892-2915)查 product_reviews 表(2026-10-07 起 crawlbase 采集器填充,未采集前如实返回空),filters brand/country/rating/q,ORDER BY review_date DESC NULLS LAST,limit 服务端默认 100 上限 200,另回全表 total+last_fetched;noon 端点实现属 noon 路由,本组不展开(页面侧调用已实证)curl amazon-reviews 断言 items/total/last_fetched 三键生效
AC-EL-RANK-063💬评论卡·星标展示「★★★☆☆」实星+空星共 5 位;≤2 星红色、其余绿色page.tsx:254/279;星数=round(rating)e2e 断言 1 星评论星标红且空星补足 5 位生效
AC-EL-RANK-064💬评论卡·meta 行展示「日期 · 品牌(或 order/asin) · 国家 · ✓已验证购买 · N人觉得有用」(按字段有无拼接)page.tsx:278-283;verified/helpful 缺省不渲染对应片段e2e 断言已验证评论含「✓已验证购买」生效
AC-EL-RANK-065💬评论卡·正文展示「标题 — 正文」,无标题省略前缀,无正文显「(无正文)」page.tsx:285-287;正文取 comment(noon)或 body(amazon),word-break 换行e2e 断言无正文评论显「(无正文)」生效
AC-EL-RANK-066💬评论卡·SKU 底行展示小字「SKU: xxx · 与描述相符: N」(有 sku 字段时)page.tsx:288;as_described=null 时不渲染该段;noon 卖家评论特有字段e2e 断言 noon 评论卡底行格式生效
AC-EL-RANK-067💬空态(双源)空态amazon:「暂无 Amazon 评论数据」hint「Amazon 商品评论采集自 2026-10-07 启动…」;noon:「无匹配评论」hint「调整星级筛选或点刷新。」page.tsx:272-275;amazon 空态如实告知采集起点不造数e2e 各源空结果断言对应文案生效
AC-EL-RANK-068💬加载/错误态加载「加载中…」过渡;失败红色错误块page.tsx:269-271e2e mock 500 断言错误块出现生效
AC-EL-RANK-069🤖卡标题标题「🤖 AI 评论分析」副题「noon 卖家评论 + Amazon 商品评论 → 问题清单 / 优点 / 缺点 / 建议 · 每次运行耗 1 次 AI 配额」page.tsx:326;2026-10-07 用户令;配额扣减见 RANK-081 服务端口径e2e 断言标题与配额提示生效
AC-EL-RANK-070🤖品牌下拉筛选「全部品牌」+本企业品牌列表page.tsx:304-305/327-330;H9(2026-10-13)单源=useBrand().brands,不再散写 zipforce/onno;顶栏品牌切换联动默认值e2e 断言下拉项=顶栏品牌集生效
AC-EL-RANK-071🤖站点下拉筛选「全部站点」+AE/SA/US/UK/DE/CA/MX/FR/IT/ES 十项page.tsx:331-334;country 上行服务端转大写并过白名单(见 RANK-081)e2e 断言十国选项生效
AC-EL-RANK-072🤖运行分析按钮按钮「🤖 运行分析」,运行中变「AI 分析中…(约 30-90 秒)」并 disabledpage.tsx:336;POST /api/rankings/review-ai body={brand,country}(page.tsx:311-318)e2e 触发后断言按钮禁用与等待文案生效
AC-EL-RANK-073🤖样本说明口径工具栏小字「分析样本=两源最新评论各 ≤150 条」page.tsx:337;与 RANK-081 服务端 LIMIT 150 采样口径一致( noon 与 amazon 各 ≤150)e2e 断言说明文案存在生效
AC-EL-RANK-074🤖结果头展示「分析样本 N 条,结果按重要性排序:」page.tsx:342-344;N=res.samples=实际进入语料条数(>150 时随机抽样后计数)断言 N≤150(>150 时服务端 random.sample 降采样后计数,dashboard.py:2987-2988)生效
AC-EL-RANK-075🤖⚠️问题清单展示每条=左侧色条+问题主题+[severity]+描述;色条 high=红/mid=琥珀/其他灰;空显「无」page.tsx:346-355;severity 由 GLM 输出三档;borderLeft 3px 按档变色e2e 断言 high 条目左色条为 danger 色生效
AC-EL-RANK-076🤖✅优点/❌缺点展示双卡并排,条目「· 文本」列表;空显「无」page.tsx:356-367;pros/cons 由 GLM 输出 3-8 条中文e2e 断言两卡标题与列表结构生效
AC-EL-RANK-077🤖💡给卖家的建议展示编号列表「1. 2. 3. …」;空显「无」page.tsx:368-374;suggestions 可执行建议按重要性排序e2e 断言编号前缀生效
AC-EL-RANK-078🤖原文兜底展示AI 未返回结构化 JSON 时:「AI 未返回结构化结果,原文如下:」+ pre-wrap 原文page.tsx:376-380;analysis=null 时走 raw(服务端截 2000 字,dashboard.py:3005)mock LLM 返回非 JSON 断言兜底渲染生效
AC-EL-RANK-079🤖错误态反馈失败红色错误块(如样本不足 400 文案)page.tsx:316-317/338;样本<5 条服务端 400「评论样本不足(当前 N 条, 需 ≥5)——先点「更新数据」或等采集积累」(dashboard.py:2984-2985)e2e 空库运行断言 400 文案透出生效
AC-EL-RANK-080🤖配额前置口径每次运行消耗 1 次 AI 配额dashboard.py:2956 _ai_quota(t) 入口即校验,配额不足直接拒绝;副题与说明双处披露(page.tsx:326/337)耗尽配额运行断言拒绝响应生效
AC-EL-RANK-081🤖服务端口径口径样本汇聚与安全边界dashboard.py:2948-3005:①country 白名单 ^[A-Z]{2,3}$ 否则 400(P0-1 2026-10-21 补真白名单——qsource 无参数化,10-14 立案的假白名单并不存在);②noon=brand 属本企业 noon schema 才取(ISO-01),comment 非空按 review_date DESC LIMIT 150,country 过滤为白名单后安全内插;③amazon=product_reviews body 非空 LIMIT 150;④合计<5 拒绝;⑤>150 random.sample 均衡两源;⑥GLM llm_chat 严格 JSON system prompt(问题/优点/缺点各 3-8 条中文按重要性排序);⑦regex 提取 JSON 失败走 raw;⑧audit rankings.review-ai 记 brand/country/ncode review 逐条比对;注入 country=AE' OR '1 断言 400生效
AC-EL-RANK-082更新数据源新鲜度回报口径refresh 回报三源:amazon_rankings/noon_reviews/amazon_reviews(count+last)dashboard.py:2926-2946;amazon_rankings=cleaned_rankings_daily max(snap_date);noon_reviews=各企业 noon schema 最新评论日取最大(ISO-01,不硬编码 zipforce_noon);amazon_reviews=product_reviews 全表 count+max(fetched_at);仅 noon_reviews 源带 try/except 兜底(dashboard.py:2932-2942),amazon_rankings/amazon_reviews 两路无保护SQL 三源复算与 sources 回报比对生效
AC-EL-RANK-083排名源断供口径(跨页引用)口径上游 keepa 断供与采集缺口的区分不在本页判定,本页只呈现快照日滞后(RANK-013 琥珀标)断供判定与「源断供(keepa 站点无数据, 非采集缺口): 」reason 前缀归管道巡检口径(§11.20 AC-EL-PIPE-034~039,metrics.py:270-273,KEEPA_SOURCE_DEAD);两页共用 cleaned_rankings_daily,同口径跨层必相等对同一停更市场比对巡检 reason 与本页 chip 琥珀标一致生效
AC-EL-RANK-084数据底表与企业隔离口径本页全部读路径经企业+品牌双隔离八端点(markets/list/history/analytics/amazon-reviews/refresh/review-ai+noon reviews)全部走 tenant_conn(tenant_id, brand_scope);noon 侧按 tenant_noon_schemas 路由(ISO-01 一企业一公司,不向他牌企业披露组合);写路径仅 refresh(owner/admin)与 review-ai(配额+audit)跨企业账号访问断言只见本企业品牌数据生效

§11.32 产品页(/products · AC-EL-PRD,40 条 · 2026-10-22 源码实证 web/app/products/page.tsx 299 行 + api/routers/ops.py /api/products(62-113 行)+ api/routers/brandboard.py /api/brandboard/product-drill(481-533 行)+ api/routers/ads.py /api/ads/price-suggestions(1137 行),建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-PRD-001页壳/面包屑导航AppShell title=商品,面包屑「产品本体 × 渠道 SKU · product_name + model_number 为对齐核心」路由 /products;权限=current_user(登录即可,无模块门,ops.py:63);产品对齐核心=(brand, product_name, model_number),SKU/ASIN/NSKU 是渠道呈现(ops.py:68 docstring)e2e 登录断言标题与面包屑逐字生效
AC-EL-PRD-002错误横幅反馈接口失败红色横幅 role="alert"仅 /api/products 失败 setErr;调价建议接口失败静默(见 019)mock 500 断言横幅出现生效
AC-EL-PRD-003视图切换 tab导航「📋 商品清单(30 天)」默认 /「🗂 下钻视图(Series→…→Size)」本地 useState 切 flat/drill(不进 URL);两视图独立数据流e2e 切 tab 断言容器互换生效
AC-EL-PRD-004flat·搜索框筛选placeholder「搜索 产品名 / 型号 / SKU / ASIN / 类目」+ 搜索按钮submit 才 setQuery 并回第 1 页(输入不即搜);SQL:p.sku/p.title/p.category ILIKE + m.product_name/m.model_number ILIKE(LEFT JOIN LATERAL sku_mapping)搜型号断言命中映射行;搜不存在串断言空态生效
AC-EL-PRD-005flat·排序 select筛选SORTS 五项:按营收/按销量/按售价/按毛利率/按 SKUops.py:71-73 sort_sql 映射:revenue→rev30 DESC NULLS LAST、units→u30、price→p.price、margin→_PROFIT_EXPR、sku→p.sku;change 重置第 1 页逐排序断言首页单调生效
AC-EL-PRD-006flat·国家筛选筛选「全部国家」+ data.countries 动态选项语义=sku_mapping 中该 (brand,sku) 在该国上架(2026-09-28 C8;products 表无国家列,EXISTS 子查询 ops.py:77-78);countries=DISTINCT sku_mapping.country 非空(109-112 行)选国断言全部行在该国有映射;countries 与 SQL DISTINCT 对拍生效
AC-EL-PRD-007flat·数据接口接口GET /api/products?search&sort&country&brand&page&page_sizeops.py:62-113;agg CTE=sales_daily 30 天窗(day > current_date−30)GROUP BY brand,sku 聚 u30/rev30/sp30;LEFT JOIN LATERAL sku_mapping LIMIT 1 取产品本体;page_size 前端 25、服务端 clamp [1,100];COALESCE 聚合空档为 0接口直调断言 clamp;30 天窗边界日 SQL 对拍生效
AC-EL-PRD-008flat·列 产品名/型号表格列两行:product_name(strong,fallback title→「—」)+ t2「model_name · model_number · color · size」product_name/model_name/model_number/color/size 均来自 sku_mapping 映射(空段省略);CSV 三段拼接抽行与 sku_mapping 比对生效
AC-EL-PRD-009flat·列 品牌表格列branddot 色点 + 品牌名brandColor(brand) 跨页一致(AC-UI-07);可排序同品牌多页断言同色生效
AC-EL-PRD-010flat·列 渠道 SKU表格列等宽 sku 样式p.sku 直显;可排序;rowKey=brand+sku抽行比对生效
AC-EL-PRD-011flat·列 ASIN / NSKU表格列「{asin} / {nsku}」muted;空 asin 显「—」asin/nsku 来自 sku_mapping;CSV 两值斜杠拼接抽行比对映射表生效
AC-EL-PRD-012flat·列 类目表格列muted 文本category→platform→「—」三级回退;排序键同回退链无类目行断言显 platform 或 —生效
AC-EL-PRD-013flat·列 售价 USD表格列右对齐 usd 2 位p.price::float8;null 由 fmt 层显「—」;排序 null 计 −1无价行断言 —生效
AC-EL-PRD-014flat·列 成本 RMB表格列右对齐整数p.cost:truthy 显 int(cost) 否则「—」;成本口径=sku_mapping.cost_rmb(映射优先,采购表回退,见 021 caliber)缺成本 SKU 断言 —(与 3 SKU 缺成本主数据挂账联动)生效
AC-EL-PRD-015flat·列 30 天销量表格列右对齐整数units30=COALESCE(a.u30,0)(agg CTE,007)SQL 同窗复算生效
AC-EL-PRD-016flat·列 30 天营收表格列strong usd 2 位revenue30=COALESCE(a.rev30,0);金额=USD(caliber)SQL 同窗复算生效
AC-EL-PRD-017flat·列 30 天广告费表格列右对齐 usd 2 位ad_spend30=COALESCE(a.sp30,0)(sales_daily 同源广告聚合)SQL 同窗复算生效
AC-EL-PRD-018flat·列 估算毛利率 *表格列pct 百分比;null 显「—」_PROFIT_EXPR(ops.py:59-60)=(price − cost×0.1471 − 0.12×price)/price×100,ROUND 1 位;price 或 cost 空/0→NULL→「—」不兜底假值(D批P3-14:删与实现相悖的「缺失按 0.25×售价」旧注);人民币成本 ×0.1471 折算与 FIN 同源利润模型同口径(AC-EL-AI-016 脚注同源引用);排序 null 计 −999手算样例对拍;缺成本行断言 —;与财务模块同 SKU 毛利率跨层一致(Δ 绝对值≤0.1)生效
AC-EL-PRD-019flat·列 💰 调价建议表格列badge warn=action + t2「毛利 X%」「库存 Y 天(status)」;title=reason 悬停看依据GET /api/ads/price-suggestions?brand=(ads.py:1137)取每 SKU 最新一期未驳回建议;无建议显「—」;无广告模块权限静默留空(catch 置空表不显红条);CSV=action;2026-10-11 A 从 /ads 建议列表迁入本页有建议 SKU 断言 badge+悬停依据;无权限企业断言列全 —生效
AC-EL-PRD-020flat·DataTable 契约组件复用表格容器/CSV/分页/口径行复用 AC-EL-CMP-014(通用表)/016(导出 CSV)/017(分页)/018(caliber)/019(加载空态);本页仅传参:exportCsv="products"、empty=「无匹配商品」、pager pageSize=25、loading=!data&&!err断言空态文案与导出文件名生效
AC-EL-PRD-021flat·caliber 口径行口径「产品表口径:金额=USD|数据源=产品主表(sku_mapping/products)|30 天聚合(销量/营收/广告)|成本=sku_mapping.cost_rmb(映射优先,采购表回退)。」UI 文案即验收标准(AC-UI-01),逐字受保护;与 007-017 各列实现一一对应页面文案与库内记录逐字 diff生效
AC-EL-PRD-022flat·底部脚注口径三行:①「* 官方口径估算:(售价 − 采购成本×0.1471 − 0.12×售价) / 售价;未维护成本的 SKU 显示 —」②「💰 调价建议来自广告规则引擎(每日 23:00 UTC,库存/毛利率护栏),悬停看依据;接受/拒绝到「广告 → 关键词优化」处理。」③「产品本体 = product_name + model_number(全站对齐核心);SKU/ASIN/NSKU 是渠道呈现。」①与 _PROFIT_EXPR 同式(018);②规则引擎调度 23:00 UTC 属广告模块口径(AC-CAL 系列域);③与 ops.py:68 docstring 同义逐字 diff;公式与 018 实现对拍生效
AC-EL-PRD-023drill·粒度 tabs筛选周(默认)/月/日gran 白名单 day/week/month,非法值后端回落 week(brandboard.py:485-486)gran=year 直调断言响应 gran=week生效
AC-EL-PRD-024drill·窗口 tabs筛选30/90/180/365 天(默认 90)days 服务端 clamp [1,3650](brandboard.py:487)days=9999 直调断言响应 days=3650生效
AC-EL-PRD-025drill·计数条反馈「{rows} SKU · 共 {total_units} 件」/「加载中…」rows=接口明细行数;total_units=round(sum(r.total))(brandboard.py:532-533)与接口响应两值对拍生效
AC-EL-PRD-026drill·Expand/Collapse按钮全展开/全收起allOpen 布尔覆盖单节点 open 记录;Collapse 同时清空 open 表Expand 后断言全部叶行可见生效
AC-EL-PRD-027drill·⬇ CSV按钮导出 zf_product_drill_YYYYMMDD.csvBOM 头 Excel 直开;列=系列/产品/国家/颜色/尺码/SKU+全桶列(不截断,区别于展示 26 桶)+TOTAL;esc 处理引号/逗号/换行断言文件名日期、表头全桶数=buckets.length生效
AC-EL-PRD-028drill·数据接口接口GET /api/brandboard/product-drill?brand&days&granbrandboard.py:481-533;数据源=audit.cleaned_amazon_orders(剔 'Canceled','Cancelled' 两拼写)+ sku_mapping 层级映射(series=product_name/product=model_name/color/size/国家,缺省回退「(无系列)/(无色)/(无码)/?」或 sku 本身)+ audit.cleaned_inventory_health 库存快照;无 SKU 单记「(无SKU)」桶接口直调对拍三源行数;剔取消单口径 SQL 复算生效
AC-EL-PRD-029drill·件数均摊口径口径每订单 items_count 按 SKU 数均摊sku_list 逗号拆分 n 份,每份 +(ic or 1)/n(items 级粒度未 ingest 的近似口径,脚注原文);桶值/total 均 round 取整两 SKU 单各记 0.5 再 round 对拍手算生效
AC-EL-PRD-030drill·bucket 格式口径桶标签三种粒度月=YYYY-MM、周=ISO 年-Www(周数补零,brandboard.py:503-509 bucket())、日=MM-DD;桶全集升序跨年周断言 ISO 年正确生效
AC-EL-PRD-031drill·五级树构建逻辑Series→Product→Country→Color→Size 层级树buildTree(page.tsx:14-40):叶=bucket 求和+total;rollup 自底向上累加、同级按 total 降序单测:给定行集断言父级=子级和且排序生效
AC-EL-PRD-032drill·26 桶展示截断边界表体只显示最近 26 个桶buckets.slice(-26) + off 偏移取值(page.tsx:60-61);防横向爆炸;CSV 导出不受限(027)365 天日粒度断言列数=26生效
AC-EL-PRD-033drill·表头表格列「Series → Product → Country → Color → Size」+桶列+TOTAL+AVG+📦Stock首列表头为层级链说明文字;桶列右对齐表头文案断言生效
AC-EL-PRD-034drill·行渲染表格列缩进=8+depth×16 px;▾/▸ 折叠钮;depth0 背景加深;叶行附 SKU muted 小字无子级行 26px 占位符对齐;名称加粗 depth0=700 其余 500视觉断言缩进梯度与折叠交互生效
AC-EL-PRD-035drill·AVG 列表格列桶均销量 toFixed(1);0 显「·」avg=total/max(1, 非零桶数)(分母只计值>0 的桶,page.tsx:70)单桶有值行 avg=total 对拍生效
AC-EL-PRD-036drill·📦Stock 列表格列叶行库存数;无映射/非叶显「—」stock[leaf.sku]=cleaned_inventory_health.total_qty(FBA 快照口径,与 037 脚注一致)抽 SKU 与库存页总库存对拍生效
AC-EL-PRD-037drill·TOTAL 行表格列表底根合计行(背景加深 700 加粗)各桶列=根节点子树合计;TOTAL=全部 total 和;AVG/Stock 显「—」(跨 SKU 加总无意义)断言 TOTAL 行各桶=列求和生效
AC-EL-PRD-038drill·空态空态「无数据」/「加载中…」data 有值且树空=无数据;data=null=加载中;colSpan=buckets.length+4空品牌断言「无数据」生效
AC-EL-PRD-039drill·脚注口径「件数按订单内 SKU 数均摊(items 级粒度未 ingest 的近似口径);层级名取 SKU 映射(系列=产品名 / 产品=型号名);📦Stock = FBA 快照 total_qty。Expand 展开全部层级。」与 029/028/036 实现一一对应;逐字受保护逐字 diff生效
AC-EL-PRD-040隔离与品牌联动口径两接口均吃全局品牌选择器/api/products 与 /api/brandboard/product-drill 均经 tenant_conn(tenant, brand_scope)+brand 参数(铁律:企业/品牌绝对独立);调价建议请求同带 brand切品牌断言两视图数据集与 KPI 计数随之切换且无跨企业行生效

§11.33 库存页(/inventory · AC-EL-INV,57 条 · 2026-10-22 源码实证 web/app/inventory/page.tsx 278 行 + inventory/DocsTab.tsx 575 行 + inventory/NoonTab.tsx 256 行 + api/routers/inventory_po.py /api/inventory/*(44-182 行)+ api/routers/inv.py 台账端点(60/72/92/126/149/182/235/275/291/320/352/370/387 行)+ api/routers/brandboard.py /api/noon-inventory(428 行)+ api/routers/noon_data.py(102/119 行)+ api/routers/noonops.py(123/274/283/304 行),建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-INV-001页壳/面包屑导航AppShell title=库存,面包屑「亚马逊 FBA 库存健康 · 每日快照」路由 /inventory;FBA 域端点 require_module("inventory")(inventory_po.py:45/133);2026-09-19 起接入全局品牌选择器(与其他页一致)e2e 断言标题面包屑;未开通企业 403生效
AC-EL-INV-002主 tab×3导航「FBA 库存快照(补货预警)」默认/「🧾 单据台账(国内仓/在途)」/「📦 Noon FBN 预警」(条件渲染)mtab 本地 state(fba/docs/noon);docs→DocsTab、noon→NoonTab、fba→本页 FBA 区e2e 逐 tab 断言容器生效
AC-EL-INV-003Noon tab 可见性探测守卫品牌无 Noon 数据时隐藏 Noon tab 并回落 fbabrand 非空时 GET /api/noon-inventory?brand=&page_size=1(brandboard.py:428)探测 rows 非空;失败=隐藏;brand 空=显示;mtab=noon 且 hasNoon=false 时 useEffect 拉回 fba(2026-09-22 用户令:fittingirls 没 Noon 不需要 Noon tab)fittingirls 断言无 Noon tab;onno 断言有生效
AC-EL-INV-004FBA·KPI 状态卡组KPI 卡每 stock_status 一卡:count + foot「可售 N · 在途 M」断货 danger/无销售 warn/其余 ok 色(page.tsx:169);by_status=GROUP BY stock_status(count+sum(total_qty)+sum(inbound)+sum(good_qty),inventory_po.py:84-94);吃 status/brand/search 筛选、不吃国家(后端注释明示)SQL 复算各状态四值;断言色规生效
AC-EL-INV-005FBA·体检卡空态KPI 卡「暂无数据」(拉取中=「正在拉取最新数据…」)hs 空时渲染 fallback 不裸空白(AmazonCabin.tsx:320;R4b P4 对齐:2026-10-28 供应链舱重构,旧 KPI 瓦片空卡并入库存体检卡,原「库存数据 — 当前品牌暂无 FBA 库存快照」文案随重构退役)无快照品牌断言该卡生效
AC-EL-INV-006FBA·合计可售/在途卡KPI 卡totalGood 大数 + foot「在途 N 件」totalGood/totalInbound=by_status 求和(前端 reduce,page.tsx:149-150)断言=by_status good/inbound 列总和生效
AC-EL-INV-007FBA·国家筛选与结构面筛选明细卡国家筛选=select 下拉「全部国家 + {国}({count})」;③ 结构卡=分国家双图+表(在管行/在库行两列)主数=stocked(total_qty>0 的 SKU 数)/count=在管行数(上架即统计,2026-09-22 口径保留为辅注;C批C1 2026-09-26 两数并列不推翻旧拍板);双数口径注脚在明细卡 caliber「国家筛选计数:主数=在库 SKU,/后=在管行数」(AmazonCabin.tsx:522-523);EU 显示「EU·共享」(下拉与结构表同规则);R4b P4 对齐:2026-10-28 重构后旧「各国在库 SKU:」标签按钮行已并入结构表与下拉点国断言明细只剩该国行;结构表两列 SQL 对拍生效 reg:id9
AC-EL-INV-008FBA·by_country 后端口径口径站点归一+固定国家清单inventory_po.py:62-83:_MP_NORM 13 个 marketplace 原始 ID→国家码(ATVPDKIKX0DER→US…A2VIGQ35RCS4UG→AE,与 sync_source ingest 归一化一致);_FIXED_COUNTRIES=US,UK,DE,FR,IT,ES,SE,BE,NL,PL,IE,CA,MX,AU,JP,SA,AE 固定列出(无数据写 0);非固定码(EU 聚合桶等)单列追加——2026-09-28 A5:原 skip 把 onno 5 行/zipforce 38 行静默藏掉已修SQL 按 _MP_NORM 复算 stocked/count;断言 17 固定国全出现生效 reg:id9
AC-EL-INV-009FBA·库存明细接口接口GET /api/inventory/health?status&search&brand&country&page&page_sizeinventory_po.py:44-120;page_size clamp [1,10000](前端首拉 10000 全量,保客户端排序/列筛选/导出);搜索四字段 ILIKE(sku/asin/m.product_name/m.model_number);排序 stock_status 断货1/无销售2/正常3/充足4/ELSE 5 + daily_sales DESC NULLS LAST(断货优先)接口直调断言 clamp 与排序首行断货生效
AC-EL-INV-010FBA·状态筛选筛选全部状态/断货/无销售/正常/充足/低库存 六枚STATUS_FILTERS 常量(2026-09-17 修:KPI 有 5 态而筛选原缺低库存);status→stock_status 精确等值;「低库存」不在列头 BADGE 映射内→badge 回退 dim;点选重置第 1 页选断货断言全行断货;低库存筛选按 DB 实值验收生效
AC-EL-INV-011FBA·国家下拉筛选「全部国家」+ 各国({count})与国家 tab 同 state 同步(双向一致);选项文案 EU·共享;change 重置第 1 页tab 与下拉互切断言同步生效
AC-EL-INV-012FBA·搜索框筛选placeholder「搜索 产品名 / 型号 / SKU / ASIN」+ 搜索按钮submit 才 setQuery 回第 1 页;四字段 ILIKE 同 009搜 ASIN 断言命中生效
AC-EL-INV-013FBA·⬇ 导出 CSV按钮按当前筛选导出全量明细(跨页)exportDetailCsv(page.tsx:125-148):动态翻页 1000/页按 total 翻到底,50 页=5 万行防御上限触顶显式报错「导出不完整…请缩小筛选范围后重试」(B批P2-8 2026-09-26:原 50 页×100 行=5000 静默截断 t3 8809 行丢 3809 已修);文件名 inventory_{品牌名或 all}_{国家码或 all}.csv;BOM 头;13 列表头(品牌,国家,产品名,型号,SKU,ASIN,总库存,可售,预留,在途,日均销量,可售天数,状态);exporting 时禁用+「…」fg 全量导出断言行数=total;CSV 表头 13 列断言生效
AC-EL-INV-014FBA·明细表 11 列表格列产品名/型号(两行:product_name→title→sku 回退 + 型号·SKU/ASIN)·品牌色点·站点·ASIN·总库存·可售·预留·在途·日均销量·可售天数·状态INV_COLS(page.tsx:37-52):站点=marketplace 归一码(008);可售 strong;日均 null→「—」否则 toFixed(1);天数 null→「—」否则 Math.round;状态 badge BADGE={断货:bad,无销售:warn,正常:ok,充足:ok} 未知 dim;列头排序(DataTable 客户端)抽行比对源表;null 销速行断言 —生效
AC-EL-INV-015FBA·70vh 限高滚动容器边界明细表容器 maxHeight 70vh 滚动2026-10-01 像素审计 P3 缺陷㊲:首拉 10000 行在 fittingirls 8500 SKU 把页面撑到 62 万 px——限高兜底(mapping 页同模式);服务端分页方案列 P4 待拍板fg 全量加载断言页高正常、容器内滚动生效
AC-EL-INV-016FBA·明细空态空态「无匹配库存」data 加载且 items=0(含筛选无命中)时渲染;loading 期不显无命中搜索断言文案生效
AC-EL-INV-017FBA·明细 caliber 与脚注口径「库存健康表口径:数量=件|数据源=FBA 库存健康每日快照(cleaned_inventory_health,约 04:00 UTC 更新)|仅含在管 SKU|断货=优先补货或清仓决策|无销售=有库存但无动销|销速=近 30/90 天日均销量。」+ 卡底脚注同源UI 文案即验收标准(AC-UI-01)逐字受保护;04:00 UTC 更新属采集管道口径文案逐字 diff;更新时刻对采集日志核验生效
AC-EL-INV-018预警卡标题与口径 sub口径「补货预警」+ sub「补货口径:有销速 → 可售 < 35 天需求线 = 紧急,< 90 天 = 观察;无销速 → 断货 = 紧急,其余单列「无动销」(2026-09-28 重构,销速缺失不再冒充健康)」2026-09-28 A4 重构(fittingirls 取证:原算法 daily_sales=0→天线=0→恒落 ok,健康桶 6307 断货+2053 无销售=93% 错分);与 020 _ALERT_CTE 分桶一致逐字 diff;分桶规则对拍 020生效 reg:id12
AC-EL-INV-019预警·级别 tabs筛选紧急/观察/无动销/健康 +「({count})」;默认 urgentLEVEL_LABEL 映射(urgent 紧急/watch 观察/nosale 无动销/ok 健康);count=summary[l].count 无数据显示「—」;page_size=15(无分页器仅取首页)切级断言表行 level 全一致生效
AC-EL-INV-020预警·接口与分桶接口GET /api/inventory/alert?level&search&brand&countryinventory_po.py:132-182 + _ALERT_CTE(core.py 共享,ARC-02 2026-10-14 迁移,notify 同源)分桶四规则:①有销速行才参与 35/90 天线(urgent=可售<n35、watch=可售<n90、ok=其余)②无销速且断货或可售≤0→urgent ③其余无销速→nosale ④need/shortage 无销速=NULL 不可算;need=ceil(日均销速×35/90);shortage=max(0,n90−可售);销速=v_inventory_health 30 天口径;po_inbound=本企业在途 PO(submitted/confirmed/in_transit)未收数量按 brand+SKU+市场关联(D批P3-7 2026-09-26 市场维:pi.marketplace 空=不限国/非空=精确匹配);排序 urgent→watch→nosale→else + shortage DESC NULLS LAST + daily_sales DESC NULLS LASTSQL 按 CTE 复算各级 count/shortage;断货无销速行断言落 urgent生效 reg:id12
AC-EL-INV-021预警·summary 汇总口径口径{level:{count,good,inbound,shortage,po_inbound}}与明细同 CTE 同参数(brand+country);D批P3-6 2026-09-26:原只吃 brand——选国家后 urgent/watch 数字仍全量与页面自相矛盾已修选国后 summary 与明细同筛选复算一致生效
AC-EL-INV-022预警·缺口合计行反馈「紧急缺口合计 N 件 · 90 天线缺口合计 M 件」紧急合计=summary.urgent.shortage;90 天线=urgent+watch shortage 相加;urgent 桶全为无销速行时 shortage=NULL→整体显「—」(分量未知即整体 —,??0 会显误导性 0;误导性 0 禁则同 AC-EL-ORDER-004 系)全无销速 urgent 桶断言「—」非 0生效
AC-EL-INV-023预警表 12 列表格列产品名/型号(map_asin)·品牌·站点·可售·在途·在途(PO)·日均销量·35 天线·90 天线·缺口·级别·操作ALERT_COLS(page.tsx:58-76):可售在 level≠ok 且 good<need35 时 danger 色;在途>0 brand 色;po_inbound>0 ok 色;日均 null「—」;两天线 muted int;缺口>0 warn 色 700 加粗;级别 badge LEVEL_TONE={urgent:bad,watch:warn,nosale:dim,ok:ok};列头排序构造行断言四色规则与 null 显 —生效
AC-EL-INV-024预警·下PO 按钮操作行内「下PO」链接Link href=/po?prefill={encodeURIComponent(sku)}——跨页预填 /po 新建(AC-EL-PO 域联动)点下PO 断言跳转且 prefill=该 SKU生效
AC-EL-INV-025预警·空态与导出空态「该级别无 SKU」;exportCsv="inventory_alerts"DataTable 复用(AC-EL-CMP-014/016/019);loading=!alert健康级空断言文案;导出文件名断言生效
AC-EL-INV-026预警·caliber口径「库存预警表口径:数量=件|数据源=cleaned_inventory_health(SKU×marketplace 库存快照)|90 天销速算缺货分级(urgent/watch/ok)|缺口=按 90 天销速×当前库存推算的缺货件数。」逐字受保护(AC-UI-01);与 020 实现对应逐字 diff生效
AC-EL-INV-027预警·脚注口径「补货算法:需求线 = ⌈日均销速 × 35/90⌉(销速取 30 天口径,随日内增量任务每 2h 刷新);缺口 = 90 天线 − 可售。无销速行不参与天数线(需求线/缺口显 — ):断货即紧急,其余入「无动销」——销速源头覆盖稀疏(约 5% 行有值),补齐取数见采集需求单。紧急 SKU 建议结合在途量决策补货。」公式与 020 一致;「约 5% 行有值」为覆盖率披露(采集缺口挂账);2h 刷新属采集调度逐字 diff;SQL 复算销速非空占比≈5%生效
AC-EL-INV-028CustomModules 挂载位组件页底 CustomModules page="inventory"企业自定义模块位(AC-EL-CMP 域);随企业配置渲染配置模块企业断言出现生效
AC-EL-INV-029DocsTab·子 tab×5导航单据(默认)/库存余额/流水/📈 报表/基础资料;docs sub 显「+ 新建单据」、stock sub 显「📋 盘点录入」sub 本地 state;数据按需懒加载(stock/base 首开加载、ledger 每开刷新);台账引擎在 api/routers/inv.py(DocsTab.tsx:2-3 文件头注释:移动加权平均/单事务/红冲按台账净额反向)e2e 逐 sub 断言容器与按钮生效
AC-EL-INV-030DocsTab·单据筛选双下拉筛选「全部类型」+DOC_TYPES 6(GRN 采购入库/PRETURN 采购退货/OUT 其他出库/TRANSFER 调拨/STOCKTAKE 盘点/ADJUST 报损溢);「全部状态」+草稿/已过账/已红冲/取消GET /api/inv/docs?doc_type&status&brand(inv.py:92);STATUS 三态=draft/approved/cancelled选类型+状态断言行集双条件成立生效
AC-EL-INV-031DocsTab·单据表 9 列表格列单据号·类型·日期·仓库·关联 PO·行数·金额·状态·操作docCols(DocsTab.tsx:113-131):单据号 sku strong;类型 badge dim 中文;仓库 TRANSFER 显「仓 → 目标仓」;关联 PO ref_no 空显「—」;金额 toLocaleString 2 位(0 显「—」);状态 badge approved ok/cancelled dim/draft warn;exportCsv=inv_docs抽单据与台账表比对九列生效
AC-EL-INV-032DocsTab·操作列操作详情(恒显)+ 过账(仅 draft)+ 红冲(仅 approved,danger 色)详情=openDetail GET /api/inv/docs/{id}(inv.py:126);过账/红冲见 033/034;操作后刷新列表并置空余额缓存approved 行断言无过账钮;draft 行断言无红冲钮生效
AC-EL-INV-033DocsTab·过账确认操作confirm「过账 {doc_no}?」正文「过账后写入台账并计算移动平均成本;已过账单据只能红冲。」POST /api/inv/docs/{id}/approve(inv.py:182);成功 toast「{doc_no} 已过账」e2e(测试企业)过账草稿断言状态翻已过账+余额变动生效
AC-EL-INV-034DocsTab·红冲确认操作confirm「红冲 {doc_no}?」正文「按台账净额反向冲回;草稿直接取消。操作会留审计记录。」POST /api/inv/docs/{id}/cancel(inv.py:235);danger 色确认钮;成功 toast「{doc_no} 已红冲」过账→红冲断言余额回到过账前(净额反向)生效
AC-EL-INV-035DocsTab·单据空态空态EmptyState「暂无单据」hint「点右上「新建单据」录入入库/出库/调拨;PO 收货会自动生成入库单。」PO 收货自动 GRN 联动(inventory_po.py:429-439 auto_grn_for_po_receive)新企业断言空态文案生效
AC-EL-INV-036DocsTab·单据 caliber口径「库存单据表口径:数量=件|数据源=台账单据(入库/出库/调拨,手工录入+PO 收货自动生成入库单)|状态=草稿/已过账/已作废。」逐字受保护(AC-UI-01)逐字 diff生效
AC-EL-INV-037DocsTab·详情抽屉抽屉maxWidth 640;标题「{doc_no} · {doc_type_cn}」+状态 badge;muted 行「日期 · 仓库 · 关联 · 备注」;明细表 SKU/产品/数量/单价/金额;底部过账/红冲/关闭明细项数量附「(账面 {count_qty})」当盘点单有账面数;单价/金额空显「—」开盘点单详情断言账面数显示生效
AC-EL-INV-038新建抽屉·表头字段输入组类型 select(DOC_TYPES)/仓库 select(warehouses);条件字段:TRANSFER 目标仓、ADJUST 方向(报溢(+)/报损(−))、GRN/PRETURN 关联 PO(approved 且 PO- 前缀前 50 条);源码另有 dtype=「PO」供应商分支(GET /api/po/suppliers,DocsTab.tsx:328/387-394)但类型下拉仅 DOC_TYPES 6 项无 PO=死代码永不渲染仓库源 GET /api/inv/warehouses(inv.py:60);关联 PO 下拉按类型懒加载(dtype 变化触发);「供应商」懒加载分支同属死代码切类型断言条件字段出现/消失生效
AC-EL-INV-039新建抽屉·物料行编辑输入组行内 SKU/产品名/数量/单价(仅 GRN·TRANSFER·ADJUST)/批次/序列号/删行(多行时);「+ 加行」;合计 ¥;备注输入合计=Σ qty×unit_price(仅非空 SKU 行)toFixed(2) 实时计算;数量 type=number、单价 step=0.01改行数断言合计随动生效
AC-EL-INV-040新建抽屉·保存两钮操作「保存草稿」/「保存并过账」校验「至少一行有效物料(SKU + 正数量)」;保存=POST /api/inv/docs(inv.py:149)body 含 doc_type/warehouse_id/target_warehouse_id/supplier_id/ref_no/adj_sign/remark/items;过账=连调 approve;toast「{doc_no} 已存草稿/已保存并过账」;引擎行为=移动加权平均成本(services.py:113-150)、单事务幂等(inv.py:186-194)、净额反向冲销(inv.py:248-269)e2e 双路径各建一单断言状态;inv.py 端点体已逐行核(单事务+幂等+反向三行为实证)v5.1生效
AC-EL-INV-041新建抽屉·类型说明文案口径按类型切换的 muted 说明五种GRN「入库按单价计入移动平均成本;可在备注写 PO 号关联。」/PRETURN「退货出库按当前均价扣减。」/TRANSFER「调拨出按均价、入按填写的单价(默认填转移价值)。」/STOCKTAKE「盘点请用「库存余额」页的 📋 盘点录入(自动带账面与标准成本)。」/ADJUST「报损出库、报溢入库(可带成本)。」逐类型断言文案生效
AC-EL-INV-042余额 sub·台账库存表表格列10 列:SKU·产品·仓库·在库·在途·预留·预计可售·ROP·移动均价·库存总价GET /api/inv/stock?page_size=200&brand(inv.py:291);预计可售 low=true 时 danger 700;ROP 空显「—」;均价 2 位;总价 toLocaleString 2 位;exportCsv=inv_stock;caliber「…与 FBA/FBN 快照独立(手工台账)」;空态「暂无台账库存」hint「过账第一张入库单后这里会出现余额。」过账入库单后断言余额行出现且数值=单据量生效
AC-EL-INV-043盘点录入抽屉操作仓库 select(切换重拉计划);表 SKU/账面/实盘输入/差异(+ok/−danger/0 muted/空「—」);「提交盘点 & 过账」计划 GET /api/inv/stocktake/plan?warehouse_id(inv.py:275)带 on_hand/avg_cost/std_cost;提示「只提交实盘≠账面的行;过账时服务端重算差异」;提交=STOCKTAKE create+approve 两连调(unit_price=std_cost 空则 avg_cost);无差异 toast「没有差异行(实盘与账面一致或未填写)」e2e 盘点一 SKU 实盘±N 断言差异过账进台账生效
AC-EL-INV-044流水 sub表格列搜索「搜 SKU / 单据号 / 备注」(Enter/按钮)+ 表 8 列:时间·SKU·仓库·变动·结存·单价·单据·备注GET /api/inv/ledger?q&brand(inv.py:320);变动正+绿/负−红 600 加粗;加载 Spinner/空 EmptyState「无流水」过账一单后搜单据号断言流水行生效
AC-EL-INV-045报表 sub·出入库报表图表近 7/30/90 天 tabs(默认 30)+ 双色柱条 + 表 4 列(日期·入库量+绿·出库量−红·流水笔数)GET /api/inv/report?days&brand(inv.py:387);柱高=值/窗口最大值、minHeight 2px、title「{date} 入 X / 出 Y · Z 笔」;表 reverse 最新在前;空态「窗口内无流水/加载中…」;副标题「库存流水按日聚合 · 入库=正变动 / 出库=负变动」(T3-3 2026-09-12 UVPVP 对齐)造已知流水断言柱与表数值生效
AC-EL-INV-046基础资料·产品主数据表单/表格录入行(SKU/产品名/标准成本/ROP/补货量/安全库存+保存)+ 表 6 列POST /api/inv/products(inv.py:370);空值列显「—」;exportCsv=inv_products;caliber「…ROP=补货点(库存低于此值触发预警)|补货量=单次补货件数|安全库存=最低保有件数。」;空态 hint「过账单据时 SKU 会自动登记;补全 ROP 后库存预警才会生效。」录 ROP 后余额表 low 触发断言生效
AC-EL-INV-047基础资料·仓库表单/表格录入行(代码/名称/类型 select 国内仓·在途仓·平台仓·退货仓+新增仓库)+ 表 4 列(代码·名称·类型·状态)POST /api/inv/warehouses(inv.py:72);kind→中文映射;状态 badge 启用 ok/停用 dim;副标题「国内仓 / 在途仓 / 平台仓」建仓断言列表新增且下拉可选生效
AC-EL-INV-048NoonTab·子 tab×5导航📊 库存总览(默认)/📋 FBN 明细/🏭 直发仓/📦 ASN 入库/⚙️ 库存管理平台隔离:本 tab 只在品牌含 noon 时显示(页面级 003 控制,NoonTab.tsx:2-3 注释);2026-10-04 增强版(预警+明细+仓库+设库存)e2e 逐 sub 断言容器生效
AC-EL-INV-049NoonTab·数据源接口offers+fees 双请求GET /api/noon/offers?limit=200(noon_data.py:119)与 GET /api/noon/fees?fee_type=outbound(noon_data.py:102);失败静默空数组(不显红条);fees 按 sku 建 feeMap 供分类/费率列接口直调对拍行数;断言失败静默生效
AC-EL-INV-050Noon·总览表 10 列表格列Partner SKU·产品·价格·MSRP·FBN 库存·销量·GMV·Buy Box·前台可见·尺寸分类offerCols(NoonTab.tsx:31-44):Partner SKU 带列筛选(AC-EL-CMP-015);产品 title 截 40 字;价格 2 位/MSRP 0 位 null「—」;FBN 库存 <20 danger、<50 warn、其余 ok 且 700 加粗;GMV toLocaleString 0 位;Buy Box「✓ 赢得」ok/「✗ 未赢得」warn;前台可见「在线」ok/「不可见」bad;尺寸分类 feeMap 回退「—」构造库存 19/49/51 行断言三色阈值生效
AC-EL-INV-051Noon·总览 caliber/导出/空态口径「数据源=noon-catalog offer/list API · gmv/units=当前累计 · BuyBox=是否赢得购物车 · FBN 库存=FBN 仓净库存。」;exportCsv="noon_fbn_overview";空态「无数据」/「加载中…」逐字受保护;gmv/units=当前累计(非滚动窗)口径声明文案 diff;导出文件名断言生效
AC-EL-INV-052Noon·FBN 明细表 10 列表格列SKU·长(cm)·宽(cm)·高(cm)·重(kg)·分类·出库费·FBN 库存·库存状态·首次入库尺寸/重量/分类/出库费取 fees 行(feeMap),无费率行显「—」;库存状态 condition=SALEABLE「可售」ok/UNSALEABLE「不可售」bad/其余「—」;首次入库 muted 12px有费率 SKU 断言尺寸四列数值生效
AC-EL-INV-053Noon·直发仓清单表格列4 仓表 5 列(仓库代码·名称·国家·模式·状态)前端硬编码常量(NoonTab.tsx:46-51):W00751249AE Vnlin WH-03 AE active/W00751251SA Vnlin JV85 KSA active/W00805734AE Cititrans AE active/W00778783EG EG inactive;模式 directship_v2;Active ok/Inactive dim;副标题「4 仓 · directship_v2 模式」断言四行逐字段(静态清单逐字核)生效
AC-EL-INV-054Noon·ASN 创建面表单/操作类型 select(SHIPMENT_TYPE_FBN/SHIPMENT_TYPE_FBN_GLOBAL)+仓库 select(SA W00751251SA/AE W00751249AE)+确认执行 checkbox+「创建 ASN」+「刷新」POST /api/noonops/asn/create(noonops.py:304)body {shipment_type,warehouse_code,confirm,reason=UI ASN+ISO 时间戳};默认 dry-run(勾选才真调);刷新=GET asn/shipments(noonops.py:274)+ eligible-items(:283);结果 pre JSON 截 600 字dry-run 断言无 ASN 产生;确认执行断言列表新增生效
AC-EL-INV-055Noon·ASN 列表与可入库 SKU表格列「ASN 列表 ({n})」表 4 列(ASN 号·状态·仓库·类型)+「可入库 SKU ({n})」表 3 列(SKU·品名截 50·仓储类型)状态 badge INBOUNDED ok/CREATED warn/其余 dim;ASN 空态「暂无 ASN(点击「创建 ASN」建首单)」;可入库列表截前 50 行 maxHeight 300 滚动;生命周期脚注「创建(CREATED)→加货项→SEAL→预约时段→SCHEDULED→noon 收货→INBOUNDED(自动 GRN 入台账) · dry-run 默认(勾选确认才真调)」文案 diff;INBOUNDED 断言 ok 色与台账联动生效
AC-EL-INV-056Noon·库存管理(设库存)表单/操作Partner SKU+仓库 select 3 仓+数量+确认执行 checkbox;按钮文案随 confirm 切「⚠️ 设库存」/「🔍 Dry-run 预览」POST /api/noonops/stock/set(noonops.py:123)body {brand,warehouse,sku,qty,confirm,reason=UI 库存管理+ISO};未选品牌报「请先在品牌选择器选定 noon 品牌(库存设置需具体品牌)」;SKU/数量必填;结果 pre JSON 截 500 字;确认成功 toast「库存已设置」;口径脚注「SET 绝对值(非增量) · FBN 库存由 noon 管理(不可设) · 此处仅设直发仓库存 · 全部操作记审计日志」dry-run 断言无变更;确认后 API 复查库存=设定值;audit 留痕生效
AC-EL-INV-057权限/铁律/写面护栏总则口径隔离与写操作边界FBA 域两接口 require_module("inventory")+tenant_conn(brand_scope)(铁律:企业/品牌绝对独立);本页 FBA/预警/明细为只读+导出,无删除面(库存不可误删边界);Noon 写操作(设库存/ASN)dry-run 默认+确认执行+审计(写面护栏同 §11.7 Noon 专页 AC-EL-NOON 系列);台账域(DocsTab)写操作有过账/红冲确认+审计跨企业 brand 断言空集;全部写操作断言审计留痕生效
AC-EL-INV-058Amazon 舱 · 紧急/观察 SKU×站点 原值矩阵(2026-10-28 供应链舱③带重构,R4 P3-2 补登)卡片紧急/观察 SKU × 站点矩阵;数量列=inventory_health 表内原值直读;stock_days=快照原值列(v_inventory_health)非请求期计算;色阶阈值=35/90 线(metric_calibers id12 经 /api/metric-thresholds 下发,色阶=呈现非新口径);Noon FBN 无销速线口径不入本矩阵(FBN 面见 /inventory/noon)GET /api/inventory/matrix?brand=(inventory_po.py:193;判定/排序=ALERT_CTE 与预警表/铃铛同源同序,默认 limit=300;AmazonCabin.tsx:149 消费)矩阵行 level 全∈{urgent,watch};色阶与 35/90 阈值线一致生效

§11.34 映射表页(/mapping · AC-EL-MAP,47 条 · 2026-10-22 源码实证 web/app/mapping/page.tsx 317 行 + api/routers/collab.py:35-73 + api/routers/ops.py:202-365,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-MAP-001页面标题/面包屑导航AppShell title=产品建档,面包屑「SKU 映射」路由 /mapping(page.tsx:48);本页=sku_mapping 宇宙事实源的读面+写面入口e2e 断言标题与面包屑生效
AC-EL-MAP-002页级错误横幅反馈红色横幅 role="alert"page.tsx:49;只读面 getJson 失败触发;编辑器内错误走 toast 不走横幅e2e mock /api/mapping/skus 500 断言横幅生效
AC-EL-MAP-003Tab 组(单 tab)导航仅一枚「SKU 映射」tabpage.tsx:51-53;2026-09-20 起 SKU 映射+新品建档合并为一个 tab,editMode 切换只读/编辑两形态(page.tsx:25-26);tab 本身不可切换e2e 断言 tab 唯一且无第二 tab生效
AC-EL-MAP-004KPI·平台卡(每平台一枚)KPI标签=平台名(空平台显「未标平台」),值=行数,foot「ASIN x · NSKU y · 成本 z」page.tsx:56-62;by_platform=/api/mapping/skus 聚合(collab.py:50-58):sku_mapping GROUP BY platform,count(asin)/count(nsku)/count(cost_rmb) 非空计数;受 platform/search/brand 当前筛选影响SQL 按同筛选 GROUP BY 复算四值生效
AC-EL-MAP-005KPI·映射总行KPI值=total,foot「当前品牌可见范围」page.tsx:63-68;total=同 where 计数(collab.py:59);「当前品牌可见范围」明示品牌过滤口径(全部品牌时为本企业全量)SQL 复算 total;切品牌断言随 brand_scope 变化生效
AC-EL-MAP-006卡标题(双态)标题「SKU 映射表」副题「SKU ↔ ASIN(Amazon) / NSKU(Noon)」;编辑模式追加「· 编辑模式(单元格点击直接编辑 · 保存=该品牌+平台分支整体替换)」page.tsx:71;副题随 editMode 联动e2e 双形态断言副题切换生效
AC-EL-MAP-007编辑模式切换按钮按钮「✏️ 编辑」↔「↩ 退出编辑」page.tsx:72-74;切换只换前端形态,编辑器进入时另行拉取编辑数据;未保存修改退出无拦截(拦截只在编辑器内目标切换,见 MAP-023)e2e 断言两态文案与形态切换生效
AC-EL-MAP-008平台 Tab筛选「全部平台 / Amazon / Noon」三 tabpage.tsx:75-79;PLATFORMS=["","Amazon","Noon"](page.tsx:20);切换即 setPage(1) 回第一页e2e 切 Amazon 断言请求 platform=Amazon 且页码复位生效
AC-EL-MAP-009搜索框筛选placeholder「搜索 SKU / ASIN / NSKU / 产品名 / 型号」+「搜索」按钮page.tsx:80-84;submit 置 page=1 并生效 query;服务端五路 ILIKE:sku/asin/nsku/product_name/model_number(collab.py:41-46),空值列 coalesce 防 NULL 漏配curl 按型号片段搜索断言命中生效
AC-EL-MAP-010只读表头 9 列(2026-10-26 用户令删「广告活动模式」列, 10→9)表格SKU/产品/品牌/平台/国家/ASIN/NSKU/UPC/成本 ¥page.tsx:90-92e2e 断言列名与列数生效
AC-EL-MAP-011列·SKU表格等宽字体加粗 SKU 码page.tsx:97;行 key=brand+sku+platform+country(page.tsx:96,与保存行键同口径)e2e 断等宽样式类生效
AC-EL-MAP-012列·产品表格主行产品名(空显「—」)+次行小字「型号 · 颜色 · 尺寸」(按有值拼接)page.tsx:98-101;model_no/color/size 空值过滤后「 · 」连接e2e 断言次行拼接格式生效
AC-EL-MAP-013列·品牌表格品牌色点+品牌名page.tsx:102;brandColor 共享(AC-EL-CMP)e2e 断色点渲染生效
AC-EL-MAP-014列·平台表格徽标:Amazon=绿(ok)、其余=灰(dim)、空=「—」page.tsx:103e2e 断 Amazon 行绿徽 Noon 行灰徽生效
AC-EL-MAP-015列·国家/ASIN/NSKU/UPC表格灰字等宽,空值均显「—」page.tsx:104-107e2e 断空值占位符生效
AC-EL-MAP-016列·成本 ¥表格「¥xx.xx」两位小数;未录显「—」page.tsx:108;cost_rmb 数值列 NULL→「—」(部分补录状态如实展示,见 MAP-022 脚注)SQL 抽 NULL 成本行断言页面显「—」生效
AC-EL-MAP-017列·广告活动模式(2026-10-26 用户令删列下线, ID 留档不复用)表格灰字 campaign_pattern,空显「—」page.tsx:109e2e 断列不存在(下线后)下线
AC-EL-MAP-018只读排序口径固定排序:platform, country, skucollab.py:65-66 ORDER BY;无前端排序交互SQL 同序复算首页 20 行比对顺序生效
AC-EL-MAP-019表空态空态居中「无匹配映射」(colSpan=10)page.tsx:112;筛选无命中时渲染e2e 搜不存在串断言空态生效
AC-EL-MAP-020分页器分页「共 N 行 · 第 p / P 页」+「上一页/下一页」(边界禁用)page.tsx:45/115-120;pageSize=20 固定(page.tsx:33),服务端 clamp 1~100(collab.py:42);P=ceil(total/20)e2e 断首页上一页禁用/末页下一页禁用生效
AC-EL-MAP-021只读加载态加载「加载中…」(编辑模式或已有错误时不显示)page.tsx:85-87e2e 断过渡文案生效
AC-EL-MAP-022只读口径脚注口径「数据源:官方映射表(本企业各品牌分支)。成本(人民币采购价)当前部分补录,未录显示 —;补录完整后商品页毛利率列自动生效。」page.tsx:123-126;明示 sku_mapping=官方映射表+成本补录状态+下游联动(商品页毛利率依赖 cost_rmb)e2e 断脚注逐字生效
AC-EL-MAP-023编辑目标选择器筛选左上下拉「品牌 · 平台」,选项=本企业各品牌×其平台分支;有未保存修改时切换弹 confirm「有未保存修改,切换将丢弃,继续?」page.tsx:142-151/275;targets=brands.flatMap——注册表 noon_brands 含该品牌才给 Noon 分支(H9 2026-10-13 单源=注册表 TenantInfo.noon_brands;一企业一公司 2026-10-02 不向他牌企业披露品牌×平台组合);target 越界自动钳回e2e 造 dirty 后切换断言 confirm 文案;无 noon 品牌断言无 Noon 选项生效
AC-EL-MAP-024编辑数据加载数据进入编辑/切目标即拉该分支全量网格page.tsx:153-159;GET /api/mapping/edit?brand&platform(ops.py:202-222):brand/platform 必填否则 400;2026-10-01 像素审计缺陷⑮修——GET 补 allowed_brands 前置校验(与 POST 对称),未登记/跨企业品牌 400「品牌未登记或不属于当前租户: {brand}」不再静默空表;columns=information_schema 全列(除 id)、rows=该分支 ORDER BY sku跨企业 brand 请求断言 400 文案生效
AC-EL-MAP-025编辑器标题标题「新品建档」副题「单元格点击直接编辑 · 保存=该品牌+平台分支整体替换(事务) · 行键 brand+sku+platform+country · 保存自动级联创建产品主数据+库存主数据」page.tsx:273;四要素一句明示(整体替换/行键/级联/交互)e2e 断副题逐字生效
AC-EL-MAP-026+加行按钮新行插入网格首行,brand/platform 预填当前目标,其余列空page.tsx:166-169;加行即 dirtye2e 点加行断言首行出现预填行生效
AC-EL-MAP-027编辑网格表格id=mapping-edit-table 全列可编辑输入框网格;表头吸顶;容器 maxHeight 62vh 内滚page.tsx:292-308;列宽 sku/product_name 130 其余 84;每格 input defaultValue+onChange 写回行状态(setCell,page.tsx:162-165);input key 含 rows.length 使加/删行后重挂载取新默认值e2e 改单元格断 dirty 徽标出现生效
AC-EL-MAP-028行删除按钮行尾红色「删」按钮移除该行page.tsx:306(delRow page.tsx:170);删除即 dirty;实际落库在保存整分支替换时生效e2e 删一行保存后断言只读表无该行生效
AC-EL-MAP-029●未保存徽标与行数反馈dirty 时琥珀徽标「● 未保存」;右侧灰字「N 行」实时计数page.tsx:286-288e2e 任一编辑动作后断言徽标出现生效
AC-EL-MAP-030💾保存到数据库按钮「💾 保存到数据库」(busy 显「保存中…」);未 dirty 或 busy 时 disabledpage.tsx:289;前端预拦:rows>2000 直接 toast「当前 N 行超出单次保存上限 2000 行,请筛选/分批后保存(超出部分服务端会忽略)」不发包(page.tsx:173-177,D批P3-12 2026-09-26)造 2001 行点保存断言预警且无网络请求生效
AC-EL-MAP-031保存成功 toast(双态)反馈正常:「已保存 N 行」;被截断:「已保存 N 行(⚠ 超上限,后 M 行被忽略,请分批保存)」(红)page.tsx:178-186;M=truncated 回传值;成功后 setDirty(false) 并 onSaved 联动刷新只读表(2026-09-21 修——否则退出编辑显示编辑前旧数据,刚保存的行「消失」)e2e 保存新行退出编辑断言只读表含新行生效
AC-EL-MAP-032保存端点·整分支替换口径保存=DELETE 该 brand+platform 分支后逐行 INSERT(整体替换,事务内)POST /api/mapping/edit(ops.py:271-339):①allowed_brands 校验(未登记 400);②schema 动态取列;③DELETE WHERE brand+platform;④body.rows[:2000] 截断并显式回传 truncated(不再静默丢弃);⑤冲突键列(brand/sku/platform/country/account/mode)空值写 '' 非 NULL——NULL 会绕过唯一索引判重且违反 NOT NULL;⑥空 SKU 行跳过(无业务含义且污染映射表);⑦行级品牌指向未登记品牌跳过(RLS 会拒);⑧ON CONFLICT (tenant_id,brand,sku,platform,country) DO NOTHING=行键重复仅留首条造重复行键保存断言库中仅一条;造 2001 行断言 truncated=1生效
AC-EL-MAP-033保存·tenant_id 会话盖章口径归属企业由服务端会话写入,客户端不可指定ops.py:291-293;row 内 tenant_id 列被 t["id"] 强制覆盖(注册表宪法:归属企业不可客户端指定)构造含伪造 tenant_id 的行保存断言库中仍为本企业生效
AC-EL-MAP-034保存·级联创建口径每行 INSERT 后自动级联创建 products+inv_products 主数据(存在即跳过)ops.py:321-333;products(brand,sku,title=product_name,category='',price=0,cost=cost_rmb) 与 inv_products(tenant_id,sku,product_name,standard_cost=cost_rmb or 0) 均 ON CONFLICT DO NOTHING;回传 cascaded_products/cascaded_inv 新建计数;2026-09-19 用户拍板——新 SKU 创建完所有业务流自动创建(铁律:级联自动生成)保存全新 SKU 断言 products/inv_products 各 +1 且重复保存计数为 0生效
AC-EL-MAP-035保存·审计留痕口径每次保存写 audit 事件ops.py:334 mapping.edit.save "{brand}/{platform}: N rows, cascade products=X inv=Y"保存后查 audit 表断言事件与行数生效
AC-EL-MAP-036编辑器口径脚注口径「保存整分支替换并跳过行键冲突(brand+sku+platform+country 重复行仅留首条);改动写入审计日志(mapping.edit.save)。」page.tsx:312-314;与 MAP-032⑤⑧ 服务端行为互证e2e 断脚注逐字生效
AC-EL-MAP-037↺重载按钮「↺ 重载」放弃网格改动重拉当前分支page.tsx:290(load page.tsx:153-159);重载后 dirty 复位e2e 改动后点重载断言改动消失徽标熄灭生效
AC-EL-MAP-038⬇CSV 导出按钮导出 mapping_{brand}_{platform}.csvpage.tsx:191-198;前端本地生成——BOM()+表头+逐行 CSV(含逗号/引号/换行的值加引号转义);同时 POST /api/mapping/edit/export {fmt:csv,rows} 留审计(见 MAP-040)e2e 下载断言文件名与 BOM 首三字节生效
AC-EL-MAP-039⬇Excel 导出按钮导出 mapping_{brand}_{platform}.xls(HTML 表格流派 Excel 文件)page.tsx:199-207;Blob type=application/vnd.ms-excel;charset=utf-8 带 BOM;单元格经 he() 转义 &<> 防 Excel 公式/标签注入;audit fmt=xlse2e 下载断言文件头含 <table 与转义生效生效
AC-EL-MAP-040导出审计端点口径导出文件虽前端生成,导出动作服务端留痕POST /api/mapping/edit/export(ops.py:350-362);UI-09(2026-10-14):SKU 映射含成本等敏感列,导出与保存同权级留审计——fmt 白名单 csv/xls 否则 400、allowed_brands 校验、audit mapping.edit.export "{brand}/{platform}: N rows fmt=x";文件本体不下发导出后查 audit 表断言事件;fmt=pdf 断言 400生效
AC-EL-MAP-041📥导入 xlsx 入口按钮「📥 导入 xlsx」label 包隐藏 file input,accept=.xlsx,.xls,.csvpage.tsx:281-285;选文件即 importXlsx,input 值即时清空可重复选同一文件e2e 连续导入同一路径文件两次断言均触发生效
AC-EL-MAP-042导入·服务端解析口径xlsx/xls 服务端 openpyxl 解析,csv 服务端 DictReader 解析,回 {rows} 字典行集POST /api/mapping/edit/import FormData(ops.py:225-268);2026-09-21 从浏览器 SheetJS(CDN) 挪服务端——部分 WPS 系 xlsx 触发 SheetJS「e.replace is not a function」崩溃且 CDN 脆弱;边界:>10MB 400「文件超限(10MB)」、xlsx 无法解析 400、取首 sheet 表头驱动、日期值格式化为 YYYY-MM-DD、'none' 归空、跳全空行导入 WPS xlsx 样本断言不崩;超限文件断言 400生效
AC-EL-MAP-043导入·空表守卫校验解析结果 0 行 → toast「空表」page.tsx:219e2e 导入只有表头的文件断言提示生效
AC-EL-MAP-044导入·表头守卫校验表头与编辑器已知列零交集 → toast「表头无已知列(需要 {前4列名}/…)」page.tsx:221-223;提示取 cols 前 4 列名e2e 导入无关表断言提示含列名生效
AC-EL-MAP-045导入·分支守卫校验文件 brand/platform 列唯一值与当前目标不符 → toast「文件是 X·Y,请先把左上目标切到该分支再导入(当前 …)」page.tsx:229-238;防串分支(如 fittingirls 文件导进 zipforce 分支);文件两列各自唯一才判定,缺列放行(由预填兜底)e2e 在 zipforce·Amazon 目标导入 fg 文件断言拒绝文案生效
AC-EL-MAP-046导入·合并语义口径导入=按「sku+country」键合并进当前网格(非整网格替换):已有行按列覆盖(文件空值不覆盖),新行插首行;brand/platform 强制当前目标;完成 toast「已合并 N 行:更新 u · 新增 a · 保留其余 r 行(点「保存」落库)」,合并后总数>2000 追加「⚠ 当前共 N 行超单次保存上限 2000,请分批保存」page.tsx:239-266;新行 added.slice().reverse() 前插保持文件行序;id 列不参与覆盖;不自动保存——落库仍走保存按钮(D批P3-12 预警)e2e 导入半空值文件断言已有值不被清空;造超限合并断言 ⚠ 提示生效
AC-EL-MAP-047宇宙事实源定位口径本页=sku_mapping(ASIN/SKU 宇宙事实源)的唯一读写工作台铁律「所有动作基于 mapping table」:读面=/api/mapping/skus(分页只读)+ /api/mapping/edit(分支网格);写面=整分支替换保存(级联创建 products/inv_products);消费方(排名页显示名/家族、商品页毛利率、库存主数据等)均经同一表解析,不另造清单code review 断言各页 SKU 解析均 LATERAL sku_mapping 而非独立清单生效
AC-EL-MAP-048列·广告活动模式(编辑面, 2026-10-26 用户令「编辑怎么还有 campaign_pattern 列」下线)编辑器编辑器列清单与行集均无该列(服务端 GET 面过滤);保存=DELETE+全量重写下按冲突键 (sku,country) 删除前快照回填——列编辑不可见亦不可抹;只读端点 /api/mapping/skus 同步去 campaign 死字段。2026-10-26 #142 重建列物理删除, 本条快照保值语义终结(列既不存, 无值可保)ops.py mapping_edit_get 列过滤+显式列 SELECT(防过滤列致 zip 与 SELECT * 错位);ops.py mapping_edit_save 快照回填(段已随列删移除);collab.py mapping/skus 删死字段e2e(2026-10-26 全绿 9/9):GET 列清单/行集无该列+全量保存 roundtrip 后 112 行逐字保值+尾六列 116 行 API/DB 零差异+审计留痕下线
AC-EL-MAP-049导入表头归一化(2026-10-26 用户令修「导入 excel 报错·表头无已知列」)编辑器导入文件表头支持中文标签+大小写/空白变体,服务端解析层归一化为物理列名(品牌→brand/产品名称→product_name/成本¥→cost_rmb/UPC 码→upc 等);归一只改行集键,不改数据值;归一后未知列保留原键(前端合并时自然丢弃)。2026-10-26 #142 列删后:campaign_pattern/parent_asin/account 三条映射随列退役, 新增 颜色简称→color_short_code/尺码全称→size_full_nameops.py mapping_edit_import _H 映射表+_norm_head(先原串后去空白小写),xlsx/csv 两分支共用;零用户负担——中文表头文件直接可导,不再触发前端「表头无已知列」e2e(2026-10-26 PASS):中文表头 xlsx(品牌/产品名称/型号/颜色/尺码/平台/国家/SKU/NSKU/ASIN/成本/UPC 码/账号/模式)导入返回行集 14 键全物理列名+值正确生效
AC-EL-MAP-050表为准全量重建(2026-10-26 用户令「彻底从建 sku 映射表, 和提供的表格一摸一样, 不一样的数据和列都删除」)注册表上传 5 xlsx(zf/Amazon 120 含 onno 5 行 Distribute、zf/Noon 92、onno/Amazon 20、onno/Noon 14、fg/workspace 1021)=唯一事实源 1267 行;列删 campaign_pattern/parent_asin/account(表无, 活值 112/197/1424 随列删, 048 保值语义终结);列增 color_short_code/size_full_name;NOON PSKU→sku、NOON NSKU→nsku;mode 值域 ('','direct','consignment')→('','Direct','Distribute');country 形态迁移 AE→UAE/SA→KSA/GB 等 9 欧洲单国→EU 聚合+新增 BR/JP/AU/CA;行 2424→1267(fg -132 旧前缀 SKU、zf/Noon -24 旧系+country 空串脏行、onno -1 ONY2002US);brand 小写企业键+tenant_id 盖章 1/2/3迁移 147(DDL+约束, pg-init);tools/_sku_rebuild_20261026.py+rebuild.sql(放行缝事务: 删全表→插 1267→级联 DISTINCT ON (brand,sku) 防 ON CONFLICT 二次更新→孤儿 DELETE 42+42, 139 先例);ops.py 048 快照回填段随列删移除;tasks.py #57-e keepa parent_asin 回填段移除(keepa 自有表仍采);data_dict_meta 标签更新e2e(2026-10-26 三企业 17/17):五组合 GET 列 17+行数=表、roundtrip 保存零漂移、placement-rows 31/627 产品名回归、导入中文头含新列、R9 孤儿 0/0;RULER_RECON PASS(R5-R11 全绿含 R10 横向三企业同构)生效
AC-EL-MAP-051全业务面按 mapping 收敛(2026-10-26 用户令「基于最新的Sku映射表往下梳理所有的业务…如果有多sku的全部删除。少的都补全」)血缘执法public 业务面 26 表 mapping 外行删除≈29,133 行(快照先行 59MB)+cleaned 镜像 23 面同口径收敛;判据=SKU 血缘并集(amazon sku 面 sku∈mapping 全品牌/ASIN 面 asin∈mapping/noon 面 nsku 精确∪剥 -N 后缀∪psku 三集);rankings_daily 分平台支(noon 行键在 name 列);豁免=noon_ads_daily 聚合行 202(账号级总额真值)+ads_sku_daily campaign 级行+promotion_products 候选清单(asin 可空)+raw 归档/audit_log/品牌级调度表引擎血缘过滤铺开(孪生两文件 api/clean_audit.py+tools/audit_clean_all.py):noon 表族 9 面+3 虚拟层三集判据(R-KEY-NOON 禁令随 nsku 列解除)+ASIN 面 7 表+listing/采购 5 表——防夜间重建/档内增量回灌;孪生积欠补同步三笔(key_disp 标量 key 修补/unique_indexes 9 列最细键/promotion 排除口径);迁移 148 断言式(26 表 outside 恒 0)public 26 表断言绿(迁移 148);cleaned 23 面 mapping 外全 0(sku_mapping 镜像 1267/products 1213/noon_ads 16604+142780 遮蔽/finest 121847/campaign 7622);keepa/aba 池 pool_outside 0+缺 9 ASIN=KSA/UAE/EU 机制性排除(04:40 seed 持续);RULER_RECON PASS;e2e 三企业 12/12(mapping 17 列×3+placement×2+orders/kpi/charts/noon×3)生效
AC-EL-MAP-052排名面市场维度按登记国收敛(2026-10-26 用户拍板「严格按照mapping table, 没有登记的不用做」)血缘执法rankings_daily(平台=amazon)合法 (brand,market)=mapping 登记国抓取展开:US/CA/AU/JP/BR→自身、EU→GB/DE/FR/IT/ES/NL 六域(EFN 泛欧)、UAE/KSA→空集(无 keepa 域机制性不采);UK 行=GB 旧码历史保留(#49 归一);noon 面不涉(asin 天然无);家族代表制(#57-g 每品牌×家族×市场 1 代表)不变采集面 api/tasks.py:COUNTRY_MARKETS 常量=展开唯一事实源(迁移 149 为其 SQL 镜像,改展开须两处同步);_rankings_family_rows 去掉「未登记市场回退全市场代表」;public 删 7150 行(UAE/KSA 旧形 3981+假市场 2459+未登记国 560+zf/AU 旧宇宙 21,快照 rank-pre-144-20261026.dump);cleaned 定向重建 18,387 行;部署 api+worker build采集目录 216 行/26 组合全登记(与 SQL 模拟期望逐项相符);cleaned 未登记市场 0;迁移 149 断言 PASS(合法集动态派生自 mapping,未来企业/新国登记不误伤);e2e 三企业 13 面:未登记国全空(zf IN/MX/AU、fg BR/IN、onno MX=0)+登记国数值不变(zf US 6/DE 10/BR 3、fg US 9/CA 9、onno US 3/GB 5)+市场芯片自动收敛;AU 全线与 fg/JP Keepa 源断供挂告警账(源缺口非采集缺口)生效
AC-EL-MAP-053Keepa 官方 11 站收敛(2026-10-26 用户 keepa.com 域名切换器截图实证+拍板「amazon只抓取这11国, 没有的持续报警」)血缘执法Keepa 支持集=11 站(US/CA/MX/BR/UK/DE/FR/IT/ES/JP/IN)={1..6,8..12},无 AU 无 NL——域号身份只认官方站点集,禁「探测有无数据」推断;合法 (brand,market)=登记国×COUNTRY_MARKETS 展开:US/CA/JP/BR→自身、EU→GB/DE/FR/IT/ES 五域(去 NL)、AU/UAE/KSA→空集(keepa 无站机制性不采);无站市场(fg/AU 208+onno/AU 5 ASIN)巡检持续告警「Keepa 无此站点——数据源缺口, 非采集故障」,与行存在无关每轮必报;UK 行=GB 旧码保留(#49)keepa_client.py:ABA_DOMAIN 11 键+KEEPA_NO_SITE_MARKETS={AU,NL}(取代 KEEPA_SOURCE_DEAD「源断供」义);core.py RANKING_MARKETS 11 站;tasks.py COUNTRY_MARKETS AU 空集+EU 5 域(迁移 150=SQL 镜像);冒牌兜底封死两处(listing keepa_watch 入池/sourcing keepa_live 对 AU/NL 跳过,防默认域 1 冒牌 US);metrics.py 无站持续告警动态派生;public 删 AU 898+NL 744=1642 行(domain13/14 假数据)+AE/SA/SE 4502 行回灌复删(快照 rank-aunl-pre-145-20261026.dump);Keepa 上线新站时四处同步(ABA_DOMAIN/NO_SITE/COUNTRY_MARKETS/RANKING_MARKETS+迁移镜像)迁移 150 断言 PASS(outside=0+AU/NL 残留 0,台账 158 行);容器内 RANKING_MARKETS/ABA_DOMAIN 11 键验证;e2e 三企业市场芯片全 11 站内(zf 8/fg 7/onno 6 市场,NL/AU 芯片消失);巡检告警恰 2 行=fg/AU+onno/AU 无站持续告警;AE/SA/SE 回灌写入方未明 Monitor 盯防挂账生效

§11.35 采购页(/po · AC-EL-PO,76 条 · 2026-10-22 源码实证 web/app/po/page.tsx 413 行 + api/routers/inventory_po.py 440 行 + api/routers/po_pdf.py 363 行,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-PO-001页面标题/面包屑导航AppShell title=PO 采购,面包屑「进销存 · 采购单全生命周期(草稿→提交→确认→在途→收货)」路由 /po(page.tsx:176);接口权限 require_module("inventory")(inventory_po.py 全端点);数据经 tenant_conn 企业隔离e2e 登录 inventory 模块账号断言标题与面包屑逐字一致生效
AC-EL-PO-002Suspense 加载壳反馈useSearchParams 依赖深链,页面组件以 Suspense 包裹,fallback 居中「加载中…」page.tsx:38,75;仅深链参数解析期短暂显示e2e 直开 /po?prefill=X 断言不抛 useSearchParams 错生效
AC-EL-PO-003错误横幅反馈接口失败红色横幅 role="alert"(page.tsx:177)getJson 异常 setErr;操作失败复用同横幅;无错误不占位e2e mock 500 断言出现且带 alert 角色生效
AC-EL-PO-004成功信息横幅反馈操作成功蓝色 ok-banner role="status"(page.tsx:178)创建/流转/收货/删除/导入/发邮件成功均 setInfo;仅 createPO 在提交前先清空 err/info(page.tsx:109),transition/delPO/sendMail/submitReceive/addSupplier 均直接覆写不清空e2e 建单成功断言「已创建 PO-…(草稿)」生效
AC-EL-PO-005采购单卡标题容器卡片 h2「采购单」(page.tsx:182)含状态页签+搜索+双按钮+列表+分页;列表数据源 /api/po/liste2e 断言卡片标题文本生效
AC-EL-PO-006卡片口径子说明口径声明sub 文案「收货不回写 FBA 库存快照;在途数量会体现在补货预警「在途(PO)」列」页面级口径边界(page.tsx:182):收货录入不修改库存快照;PO 在途量仅进 /api/inventory/alert 的 po_inbound 列(_ALERT_CTE 已迁 core.py 常量集中,ARC-02 2026-10-14;inventory_po.py:29 仅 import)收货后比对 FBA 快照无变化+预警页 po_inbound 增量生效
AC-EL-PO-007状态页签组筛选7 个页签:全部/草稿/已提交/已确认/在途/已收货/已取消,各带计数(page.tsx:25-27,184-189)STATUSES=["","draft","submitted","confirmed","in_transit","received","cancelled"];切换即重查并回到第 1 页e2e 逐个点击断言列表状态过滤正确生效
AC-EL-PO-008「全部」页签计数计数全部=各状态 count 求和(page.tsx:187)前端 Object.values(summary).reduce(count 求和);与服务端 total 同源应相等对账 summary 各态之和 = 无过滤 total生效
AC-EL-PO-009页签计数数据源口径计数来自 /api/po/list 响应 summary 字段服务端按状态聚合 {count,qty} 两值(inventory_po.py /api/po/list);qty 未在页签展示仅 countSQL 直查各状态 PO 数比对页签数字生效
AC-EL-PO-010搜索框筛选placeholder「搜 PO 号 / 供应商」,宽 200(page.tsx:191-192)输入即触发重查(onChange setStatus 前先回第 1 页);参数 search 服务端 ILIKE 匹配 po_no 与供应商名e2e 输入 PO 号片段断言列表收敛生效
AC-EL-PO-011「+ 新建 PO」按钮操作主按钮打开新建抽屉(page.tsx:193)setCreating(true);抽屉见 AC-EL-PO-037e2e 点击断言抽屉出现生效
AC-EL-PO-012「从补货预警导入」按钮操作secondary 按钮开建单视图并拉预警(page.tsx:194,90-95)/api/inventory/alert?level=urgent&page_size=50 懒加载一次(alertItems null 才拉,失败落空数组不报错)e2e 点击后网络面板断言 alert 请求恰好一次(重复开不重拉)生效
AC-EL-PO-013列表加载占位反馈items 为 null 时「加载中…」(page.tsx:196)与空态区分:null=加载中,[]=「无采购单」e2e 慢网络断言占位先现后表生效
AC-EL-PO-014列表表头表格9 列:PO 号/供应商/状态/目的市场/行数/总量/总成本(RMB)/创建/更新(page.tsx:200)列序固定;行数据来自 /api/po/list itemse2e 断言表头 9 列文本与顺序生效
AC-EL-PO-015PO 号列列sku strong 样式展示 po_no(page.tsx:204)格式 PO-{yymmdd}-{pid:04d}(inventory_po.py /api/po/create,token_hex 占位后回填真 id)建单后断言编号格式正则 ^PO-\d{6}-\d{4}$生效
AC-EL-PO-016供应商列列供应商名,空显「—」(page.tsx:205)PO 未指定供应商(supplier_id null)合法,展示占位符建不指定供应商的 PO 断言显示 —生效
AC-EL-PO-017状态徽章 tone 映射列badge 四色映射(page.tsx:206)received=ok(绿)/cancelled=bad(红)/draft=dim(灰)/submitted·confirmed·in_transit=warn(黄);文本=status_cn 服务端中文名逐状态建 PO 断言四类颜色生效
AC-EL-PO-018目的市场列列muted 展示 dest_market,空显「—」(page.tsx:207)自由文本(建单 placeholder「如 US / AE / EU」),无枚举校验填写任意市场字符串断言原样回显生效
AC-EL-PO-019行数列列item_count(page.tsx:208)服务端聚合该 PO 物料行数;服务端建单时 qty≤0 行被静默跳过,行数按落库行计建 3 行(1 行 qty=0)断言行数=2生效
AC-EL-PO-020总量列列qty_total(page.tsx:209)服务端 sum(qty_ordered);口径=有效行数量和对账单行 qty 之和生效
AC-EL-PO-021总成本列列·金额「¥」+ toLocaleString(page.tsx:210),null 显「—」口径=total_cost_rmb=round(sum(qty×unit_cost_rmb),2) 服务端计算落库(inventory_po.py /api/po/create,unit null 按 0);RMB 计价,无汇率换算;前端千分位本地化不改数值SQL 直算 sum(qty×unit_cost) 与列值相等(分位四舍五入)生效
AC-EL-PO-022创建时间列列created_at.slice(0,10) 即 YYYY-MM-DD(page.tsx:211)服务端 timestamptz 原样返回,前端截日期比对 DB created_at 日期位生效
AC-EL-PO-023更新时间列列updated_at.slice(0,16) 且 T 替换为空格(page.tsx:212)精度到分钟;秒位截断流转状态后断言该列前移生效
AC-EL-PO-024行点击开详情交互行 cursor pointer,onClick 调 /api/po/{id} 开详情抽屉(page.tsx:203,119-122)详情 404「PO 不存在」走错误横幅e2e 点击行断言抽屉打开生效
AC-EL-PO-025列表空态空态colSpan=9 居中「无采购单」(page.tsx:215)仅 items=[] 时显示新企业首访断言空态文案生效
AC-EL-PO-026分页器分页上一页/「x / y」/下一页,仅 pages>1 显示(page.tsx:220-226)固定 20 条/页(请求 page_size=20,page.tsx:66;服务端上限 min(100,…)=20 生效);pages=ceil(total/20)造 21 条 PO 断言分页器出现且翻页正确生效
AC-EL-PO-027列表请求参数口径/api/po/list?status&search&brand&page&page_size=20(page.tsx:66)brand 取自 useBrand() 品牌上下文随请求透传;页签/搜索/翻页/品牌变化即重查(useCallback 依赖)网络面板断言参数完整生效
AC-EL-PO-028品牌过滤铁律口径·铁律带 brand 时服务端以 EXISTS(purchase_order_items pi WHERE pi.po_id=p.id AND pi.brand=brand) 过滤inventory_po.py /api/po/list;跨品牌 PO 绝不互见(铁律:品牌绝对独立);summary/total 同过滤口径双品牌账号切换断言列表互不可见生效
AC-EL-PO-029列表排序口径ORDER BY created_at DESC(inventory_po.py /api/po/list)最新创建在最上;无二次排序键建两单断言新单在前生效
AC-EL-PO-030供应商卡容器卡片 h2「供应商」(page.tsx:229-230)含添加表单+6 列表;数据源 /api/po/suppliers(随主列表 load 一并拉取)e2e 断言卡片渲染生效
AC-EL-PO-031供应商表单表单名称/联系人/邮箱(email 型,placeholder「邮箱(PO 确认后自动发 PDF)」)/电话 +「+ 添加」(page.tsx:232-236)仅名称必填(trim 非空,page.tsx:160);其余可空空名称点添加断言无请求生效
AC-EL-PO-032添加供应商写操作POST /api/po/suppliers,成功清空表单并刷新(page.tsx:159-163)重名返回 409「供应商已存在」走错误横幅;护栏=名称去重,无需确认弹窗(低风险可改项)重复添加同名断言 409 横幅生效
AC-EL-PO-033供应商表列表格6 列:名称/联系人/电话/邮箱/未完成 PO/操作(page.tsx:240)空字段统一「—」;行键 s.ide2e 断言表头 6 列生效
AC-EL-PO-034「未完成 PO」列列·计数open_pos 数值(page.tsx:248)服务端=该供应商名下未取消 PO 计数(inventory_po.py /api/po/suppliers GET);口径含全部非 cancelled 态为供应商建 2 单(1 已取消)断言显示 1生效
AC-EL-PO-035删除供应商写操作红字「删除」按钮 + danger 确认「被未取消 PO 引用时会被拒绝。」(page.tsx:164-168,249)DELETE /api/po/suppliers/{id};服务端护栏=存在未取消 PO 返回 409「供应商仍有未取消 PO, 不能删除」(tenant_id 域内)引用中删除断言 409 横幅;取消全部 PO 后删除成功生效
AC-EL-PO-036供应商空态与静默失败空态「暂无供应商」colSpan=5(page.tsx:252);列表加载失败静默 catch(()=>{})(:70)供应商面失败不打错误横幅(不阻塞主列表);空态含=0 与失败两种情形mock suppliers 500 断言页面无横幅且表空生效
AC-EL-PO-037新建抽屉容器抽屉drawer-mask + drawer 宽 760(page.tsx:261-262)点遮罩关闭;点内容区 stopPropagation;标题「新建采购单(保存为草稿)」e2e 断言抽屉宽 760 与遮罩关闭行为生效
AC-EL-PO-038新建表单三字段表单供应商下拉(首项「(不指定)」→null)/目的市场(placeholder「如 US / AE / EU」)/备注(page.tsx:264-273)供应商选项来自本企业供应商表;三字段均可空不选供应商保存断言成功且列表显 —生效
AC-EL-PO-039补货预警块容器建单抽屉内嵌块,标题「补货预警(urgent)· 勾选导入,数量=90 天缺口」(page.tsx:275-277)alertItems 非 null 才渲染(openAlertImport 或预填流程触发加载);表体 maxHeight 200 滚动e2e 开导入断言块出现与 200px 滚动生效
AC-EL-PO-040预警表列表格7 列:勾选/品牌/SKU/市场/可售/缺口/在途PO(page.tsx:280)数据源 /api/inventory/alert urgent 级前 50 条;可售=good,缺口=shortage,在途PO=po_inbound(_ALERT_CTE)与 /inventory 页 urgent 行对账一致生效
AC-EL-PO-041缺口列样式列红字加粗 var(--danger)(page.tsx:287)shortage=max(0, 90 天线−可售)(inventory_po.py _ALERT_CTE:need=ceil(日均×90))断言缺口>0 行红色加粗生效
AC-EL-PO-042预警勾选框交互行首 checkbox,状态存 Set<index>(page.tsx:284-285)勾选仅本地态;跨筛选不保留(关闭抽屉不重置 checked,重开保留——已知轻量实现)e2e 勾选两行断言按钮计数=2生效
AC-EL-PO-043「导入选中(N)」按钮操作按钮文案实时反映勾选数,无勾选禁用(page.tsx:294-296)disabled=!checked.size;导入后清空勾选并 setInfoe2e 无勾选断言 disabled生效
AC-EL-PO-044导入行为口径口径勾选行追加为物料行:qty=max(1,shortage),带入 brand/sku/asin/marketplace(page.tsx:96-106)提示文案「已导入 N 条缺货 SKU(数量=90 天缺口,可修改)」;shortage=0 时数量=1;重复 SKU 不去重(直接追加)导入 shortage=7 行断言物料行 qty=7生效
AC-EL-PO-045预警空态空态「当前无 urgent 预警」colSpan=7(page.tsx:290)alertItems=[] 时显示;与未加载(块隐藏)区分无 urgent 企业断言文案生效
AC-EL-PO-046物料行表列表格7 列:品牌/SKU/ASIN/市场/数量/单价(RMB)/删(page.tsx:303)全部行内编辑(input);空表也可先加行e2e 断言 7 列表头生效
AC-EL-PO-047数量输入输入number 型 min=1(page.tsx:311)onChange Number(e.target.value) 非数值落 0;保存时 qty≤0 行被客户端过滤(:111)+服务端跳过(双护栏)清空数量保存断言该行不落库生效
AC-EL-PO-048单价输入输入·金额number 型 min=0 step=0.01,空串=null(page.tsx:312)unit_cost_rmb null 语义=未定价;服务端 null→0 计总额(AC-EL-PO-021 口径);RMB 计价留空保存断言总成本按 0 计生效
AC-EL-PO-049删行按钮操作行内「删」按钮移除该物料行(page.tsx:313)仅本地态,无确认弹窗;保存前不落库e2e 删行断言行数减一生效
AC-EL-PO-050「+ 加一行」按钮操作追加 emptyItem(qty=1,unit null,其余空)(page.tsx:35,319-320)新行默认数量 1e2e 连点两次断言两行 qty=1生效
AC-EL-PO-051取消/保存草稿按钮操作底部 toolbar 右对齐:取消关抽屉 / 保存草稿提交(page.tsx:321-324)取消不落库不确认;保存走 createPOe2e 取消后刷新断言无新 PO生效
AC-EL-PO-052保存草稿客户端校验校验有效行=brand+sku 非空且 qty>0,至少一行否则报「至少一行有效的品牌+SKU+数量」(page.tsx:111-112)无效行静默剔除后提交(items2)全空行保存断言错误横幅生效
AC-EL-PO-053create 服务端口径写操作POST /api/po/create(inventory_po.py)po_no=PO-{yymmdd}-{pid:04d};qty≤0 行跳过;unit null→0;total=round(sum,2);初始 status=draft;审计事件 po.create(操作者+内容留痕)建单后查 audit_events 断言 po.create 行存在生效
AC-EL-PO-054创建成功反馈反馈「已创建 {po_no}(草稿)」+关抽屉+重置表单+刷新(page.tsx:113-115)po_no 服务端返回回显e2e 断言横幅含完整 PO 号生效
AC-EL-PO-055prefill 深链交互/po?prefill=<sku> 自动开建单并预填该 SKU(page.tsx:74-88)查 /api/products?search=<sku>&page_size=5,取 sku 全等匹配(大小写不敏感)否则取首项;已在物料行则不重复加;qty=1e2e 带合法 SKU 深链断言行预填生效
AC-EL-PO-056详情抽屉容器抽屉drawer 宽 720,遮罩点击关闭(page.tsx:330-332)openDetail 成功才渲染;404 走错误横幅e2e 断言宽 720生效
AC-EL-PO-057详情标题标题「{po_no} · {status_cn}」(page.tsx:333)GET /api/po/{pid} 返回单头+itemse2e 断言标题两段拼接生效
AC-EL-PO-058流程条 flowbar可视化5 步:草稿→已提交→已确认→在途→已收货,done/cur 两态(page.tsx:28,334-342)当前态之前的步骤=done;cancelled 不在主流,追加灰底「已取消」cur 徽章(:341)各状态开详情断言高亮位生效
AC-EL-PO-059详情 meta 行信息「供应商 X · 目的市场 Y · 创建 Z · 备注 W」(page.tsx:343-345)空字段显「—」;备注仅在非空时追加;创建时间到分钟e2e 断言四段拼接与空值占位生效
AC-EL-PO-060详情物料表表格6 列:品牌/SKU/市场/订量/单价(RMB)/已收(page.tsx:349)已收=qty_received 累计值;单价「¥」前缀 null 显「—」部分收货后断言已收列更新生效
AC-EL-PO-061状态流转按钮组操作NEXT 映射(page.tsx:29-34):draft=[提交审批];submitted=[确认订单,驳回,取消];confirmed=[标记在途,取消];in_transit=[收货];received/cancelled 无按当前态渲染下一跳按钮;驳回=回 draft(逆向边)逐状态开详情断言按钮集合生效
AC-EL-PO-062流转确认弹窗护栏useConfirm「确认{动作}该 PO?」(page.tsx:123-131)动作中文映射 提交/确认/驳回/标记在途/收货/取消;确认才 POST /api/po/{id}/statuse2e 点流转断言确认框文案生效
AC-EL-PO-063服务端状态机口径·护栏PO_FLOW 服务端镜像校验(inventory_po.py /api/po/{pid}/status)非法流转 400(错误文案含中文状态名);合法流转写库+审计 po.status;前后端两份映射必须一致(代码与条目不一致=缺陷)curl 直发非法流转断言 400生效
AC-EL-PO-064确认触发钩子联动流转到 confirmed 时服务端经 hooks.fire_po_confirmed 触发 ARC-02 钩子(inventory_po.py)钩子=po_pdf.generate_and_maybe_mail(po_pdf.py:319-331 注册):生成盖章 PDF+尝试发供应商邮件,best-effort 任何异常吞掉不阻断确认事务确认带邮箱 PO 后断言 pdf_path 回写+mail_status 变化生效
AC-EL-PO-065「收货录入」入口操作仅 in_transit 态显示(page.tsx:366-368)开收货抽屉(AC-EL-PO-072);与「收货」流转按钮并存(后者直接转 received 不录明细)confirmed 态断言无此按钮生效
AC-EL-PO-066删除按钮写操作仅 draft/cancelled 态显示,红字(page.tsx:369-371)danger 确认「删除该 PO?」body「仅草稿/已取消状态可删除。」confirmed 态断言无删除按钮生效
AC-EL-PO-067服务端删除约束护栏DELETE /api/po/{pid} 仅 draft/cancelled 可删(inventory_po.py)其余状态 400;删除审计 po.delete;物料行随删(不可误删护栏:非草稿物理不可删)curl 删 confirmed PO 断言 400生效
AC-EL-PO-068「✉ 发邮件」按钮操作status≠draft 显示;mailBusy 期间禁用文案「发送中…」(page.tsx:373-377)源码注 2026-09-17 修:sendMail 原是死代码无按钮,补按钮+防重复;POST /api/po/{id}/mail连点发送断言仅一请求生效
AC-EL-PO-069无邮箱补录 prompt交互供应商未维护邮箱时 window.prompt 输入收件邮箱(page.tsx:132-135)取消(null)则中止不发;输入空串等同 skipped 由服务端判定e2e 无邮箱 PO 点发送断言 prompt 出现生效
AC-EL-PO-070mail 结果三分支反馈反馈sent→「邮件已发送」;skipped→「未发送:{reason}」;failed→「发送失败:{reason}」(page.tsx:138-139)响应字段 mail_status+reason;发送后刷新列表并在详情开着时重开详情三场景各断言横幅文案生效
AC-EL-PO-071send_mail 服务端口径口径收件人优先级 body.to > 供应商 email(po_pdf.py:282-316)无收件人→mail_status=skipped「供应商未维护邮箱」;SMTP 未配→skipped「SMTP 未配置」;成功→sent+mailed_at 落库;失败→failed:{原因[:120]} 落 mail_status;审计 po.mail(po_pdf.py:358-363)四场景各查 purchase_orders.mail_status 值生效
AC-EL-PO-072PDF 端点文件GET /api/po/{pid}/pdf 惰性生成返回 FileResponse;POST 同路径强制重生成(po_pdf.py:338-355)文件不存在时生成并回写 pdf_path;po_no 非法(非 [A-Za-z0-9_-]+)400;审计 po.pdf / po.pdf.regen;PDF 含盖章水印与公司脚注(po_pdf.py:240-243)GET 断言 content-type=application/pdf 与文件名={po_no}.pdf生效
AC-EL-PO-073收货抽屉容器抽屉drawer 宽 560,标题「收货录入 · {po_no}」(page.tsx:384-388)说明文案「逐行填本次实收数量;全部收齐后 PO 自动转为「已收货」」e2e 断言宽 560 与标题生效
AC-EL-PO-074收货表列与 clamp表格·输入4 列:SKU/订量/已收/本次收货(page.tsx:391)本次收货 number min=0 max=qty,onChange clamp 到 [0, 订量](:396-397);初值=已收累计(增量编辑模型)输入超订量断言自动截到订量生效
AC-EL-PO-075receive 服务端口径写操作POST /api/po/{pid}/receive(inventory_po.py)仅 confirmed/in_transit 可收否则 400;qty_received=least(本次值, qty_ordered);正增量写 recv_items 收货流水;全部行满足 qty_received≥qty_ordered→received 否则停留 in_transit;审计 po.receive;成功后 best-effort auto_grn_for_po_receive 自动 GRN(失败不影响收货)部分收货断言状态仍 in_transit+流水行存在生效
AC-EL-PO-076收货结果反馈反馈received→「全部收货完成,PO 已完结」;否则「部分收货,PO 保持在途」(page.tsx:149-157)依据响应 status 字段二分;关双抽屉并刷新列表e2e 两路径各断言文案生效

§11.36 项目页(/projects · AC-EL-PRJ,64 条 · 2026-10-22 源码实证 web/app/projects/page.tsx 709 行 + api/routers/projects.py 333 行,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-PRJ-001页面标题/面包屑导航AppShell title=项目,面包屑「产品研发甘特图 · 8 阶段 × 任务 · 基线偏差」(page.tsx:314)路由 /projects;接口权限 require_module("collab")(projects.py 全端点);数据经 RLS 企业隔离(页面脚注声明,page.tsx:474)e2e 登录 collab 模块账号断言标题与面包屑生效
AC-EL-PRJ-002错误横幅反馈红色横幅 role="alert"(page.tsx:315)产品列表/详情拉取失败 setErre2e mock 500 断言横幅生效
AC-EL-PRJ-003产品下拉选择器导航选项「{name}({task_count} 任务)」(page.tsx:319-323)GET /api/pm/products(page.tsx:67);切换触发详情加载;metas 空时下拉为空e2e 断言选项格式含任务数生效
AC-EL-PRJ-004产品列表排序口径口径ORDER BY start_date, created_at, id(projects.py:104-105)下拉顺序=启动日期升序,同日按创建先后;首项自动选中(page.tsx:68)建三个不同启动日期产品断言下拉顺序生效
AC-EL-PRJ-005「+ 新建产品」按钮操作开产品弹窗 new 模式(page.tsx:324)恒可用(无产品也可建)e2e 断言弹窗标题「新建产品项目」生效
AC-EL-PRJ-006「编辑产品」按钮操作仅 prod 已加载时显示(page.tsx:325)开产品弹窗 edit 模式,key=当前产品 id无产品断言按钮不渲染生效
AC-EL-PRJ-007「+ 新任务」按钮操作disabled=!prod(page.tsx:326)开任务弹窗 new 模式(追加到任务列表末尾)未选中产品断言禁用生效
AC-EL-PRJ-008「⛓ 一键串链」按钮操作仅 tasks.length>1 显示,title「按任务顺序连成 完成→开始 依赖链」(page.tsx:327-329)chainBusy 期间禁用;POST /api/pm/products/{pid}/chain {enabled:true}(page.tsx:99)单任务产品断言按钮不渲染生效
AC-EL-PRJ-009「拆链(N)」按钮操作仅 stats.chained>0 显示,N=有依赖任务数(page.tsx:330-332)POST chain {enabled:false};toast「已拆链」串链后断言按钮出现且计数正确生效
AC-EL-PRJ-010串链服务端语义口径按 seq 顺序将任务连成 完成→开始 单链(projects.py:262-277)enabled=true:每任务 depends_on=前一任务(首任务无依赖),返回 chained=len-1;enabled=false:全部依赖清空返回 0;审计事件 pm.chain;产品不存在 404串链后断言首任务无依赖+其余各一依赖生效
AC-EL-PRJ-011「⬇ 导出」按钮操作disabled=!metas.length(page.tsx:334)GET /api/pm/export 全量 products+tasks(projects.py:279-283);前端存 blob 下载,文件名 pm-gantt-{YYYY-MM-DD}.json(page.tsx:294);失败 toast「导出失败」导出断言文件名与 JSON 结构含 products 数组生效
AC-EL-PRJ-012「⬆ 导入」按钮操作触发隐藏 file input,accept=".json,application/json"(page.tsx:335-336)读文本 JSON.parse;失败 toast「导入失败:…」;成功后刷新 metas 并选首项(page.tsx:299-311)选非 JSON 文件断言 toast 错误生效
AC-EL-PRJ-013导入=全量替换口径·护栏POST /api/pm/import(projects.py:285-333)先 DELETE FROM pm_products 级联清全部任务再插入(同企业内);toast「已导入 N 个产品 · M 个任务(全量替换)」;页面提示「可先导出备份」(page.tsx:474);审计 pm.import;护栏=无有效产品 400「无有效产品可导入」导入 1 产品后断言原产品全部消失生效
AC-EL-PRJ-014导入字段映射与容错口径兼容 camelCase/snake_case 双写法(projects.py:294-316)产品需 name+合法 startDate 否则整产品跳过;任务 phase 非法或日期非法静默跳过该任务;end<start 时 end=start;status 非法回 pending;任务 id 统一换新 id,depends_on 经旧→新映射重指,指不到即断链;title 截 200 / owner 截 60 / name 截 120构造混合非法字段文件导入断言容错行为生效
AC-EL-PRJ-015缩放控件交互「-」「{dayW}px」「+」三件(page.tsx:337-341)步进 6px,clamp [18,72](:338,340);dayW 影响日格宽/条宽/拖拽吸附粒度连点放大断言到 72 后不再增生效
AC-EL-PRJ-016阶段筛选 chips筛选8 个 chipbtn:P1 选品调研→P8 上架运营,各带色点(page.tsx:17-26,344-349)颜色常量 PHASES(与服务端 PM_PHASES 一致);至少保留 1 个选中(:121 全取消被拒)点击取消 7 个断言最后 1 个不可取消生效
AC-EL-PRJ-017负责人 chips筛选当前产品去重 owner 排序后渲染(page.tsx:81,351-353)ownerSel null=全选默认;至少保留 1 个(:125)断言 chips 集合=任务 owner 去重集生效
AC-EL-PRJ-018搜索框筛选placeholder「搜索任务 / 负责人 / 备注」,宽 180(page.tsx:354-355)对 title/owner/notes 三字段 toLowerCase 包含匹配(page.tsx:127-130);即时过滤(vis 数组)不重新请求输入关键词断言行数收敛生效
AC-EL-PRJ-019vis 过滤口径口径vis=阶段∩负责人∩搜索 三条件交集(page.tsx:128-130)甘特图行/箭头/统计的「任务 N/M」均按 vis;底部统计 stats 按全量 tasks(不含筛选)——两口径并存需区分筛选 1 阶段断言标签列计数变化而统计条总数不变生效
AC-EL-PRJ-020统计条容器信息pm-stat 行:产品名/总任务/已完成(pct)/进行中/延误/依赖(page.tsx:357-370)仅 prod 加载后显示;数字来自 useMemo stats(全量 tasks)e2e 断言六段文本生效
AC-EL-PRJ-021完成率 pct口径round(done/total×100),total=0 时 0%(page.tsx:148)done=status=done 任务数;进度条 width 同值(:369)对账 tasks 表 done 占比生效
AC-EL-PRJ-022延误口径口径delayed=ddays(baseline_end, end_date)>0 计数(page.tsx:143)即当前结束晚于基线结束的任务数;ddays=UTC 日差四舍五入(:40)改期任务跨过基线断言计数+1生效
AC-EL-PRJ-023依赖冲突口径口径conflicts=后继 start_date≤前置 end_date 的依赖边数(page.tsx:135-137)显示「依赖 N · 冲突 M」仅当 chained>0;有冲突红字无冲突 muted(:364-367);title 提示定义「后继任务早于前置任务结束即冲突」构造重叠依赖断言冲突数生效
AC-EL-PRJ-024进度条可视化pm-progress 条 width={pct}%,title「完成率 {pct}%」(page.tsx:369)纯前端派生无接口断言 width 与 pct 一致生效
AC-EL-PRJ-025空态卡空态metas.length=0 时居中卡「还没有产品项目。新建后将按 8 阶段模板生成 48 个任务(选品调研 → 上架运营)。」+「+ 新建第一个产品」(page.tsx:374-379)仅零产品时显示;48=标准模板 8×6新企业断言空态文案与按钮生效
AC-EL-PRJ-026加载占位卡空态有产品但 prod 未回时「加载甘特图…」(page.tsx:465-469)与零产品空态互斥慢网络断言占位出现生效
AC-EL-PRJ-027甘特图容器容器pm-gantt 双栏:左标签列+右滚动时间轴,CSS 变量 --day-w(page.tsx:382)左右通过 onScroll 同步 scrollTop(:216-219);滚动时清 tooltip滚动右侧断言左侧跟随生效
AC-EL-PRJ-028标签列头信息「任务 · {vis.length}/{tasks.length}」(page.tsx:384)分母=全量分子=过滤后筛选断言分子变化生效
AC-EL-PRJ-029任务标签行行状态按钮+阶段色块+标题+负责人四件(page.tsx:385-397)done 任务行 is-done 置灰;title 属性=完整任务名;双击行开编辑弹窗(:387)e2e 断言行结构与双击行为生效
AC-EL-PRJ-030状态切换按钮操作圆形按钮点击循环 pending→doing→done→pending(page.tsx:106-116,388-392)title「{中文态}(点击切换)」;done 显 ✓;PUT /api/pm/tasks/{id} 全字段回传仅改 status;成功 toast 已完成/进行中/回到待办;双击不触发(stopPropagation)e2e 三连击断言状态循环生效
AC-EL-PRJ-031无匹配任务行空态标签列「无匹配任务」+ 甘特区「无匹配任务 · 调整上方筛选或搜索词」(page.tsx:398,459)vis=0 时两处同时显示过滤至空断言双空态生效
AC-EL-PRJ-032月行时间轴格式 {yy}/{m},span=该月覆盖天数(page.tsx:181-199,402-404)UTC 月界切分;与日格对齐(gridColumn span)跨月项目断言月分段数生效
AC-EL-PRJ-033日格时间轴每格一日:wk 周末底色/first 月首加粗/today 高亮;dayW≥30 才显日期数字(page.tsx:405-409)totalDays 决定横向 grid 列数;缩到 30px 以下数字隐藏仅留底纹缩放到 24px 断言数字消失生效
AC-EL-PRJ-034时间范围口径口径range=min/max 所有任务 baseline 与当前四组日期,各外扩 3 天(page.tsx:150-158)空任务时锚今日+90 天;仅随 prod 变化重算断言首日=最早任务−3 天生效
AC-EL-PRJ-035今日线可视化pm-today 竖线 left=todayPx(page.tsx:201-203,412)仅今日落在范围内才渲染拖动系统日期到范围外断言消失生效
AC-EL-PRJ-036初始滚动定位交互产品切换时滚到今日线附近(page.tsx:208-214)scrollLeft=max(0, 今日偏移−min(clientWidth×0.4, 520));仅 prod.id 变化触发切产品断言滚动位置含今日线生效
AC-EL-PRJ-037周网格背景可视化repeating-linear-gradient 每 7×dayW 画分隔线(page.tsx:204-206)backgroundPositionX 按范围首日星期偏移(周一为界)对齐断言分隔线落在周界生效
AC-EL-PRJ-038依赖箭头 SVG可视化完成→开始连线:前置条右缘→水平→垂直→后继条左缘(page.tsx:160-179,413-427)仅 vis 内两端均可见才画;箭头 marker 灰色 pm-ar;行高 24px 定位;宽=totalDays×dayW 高=vis.length×24串链后断言 path 数=依赖边数生效
AC-EL-PRJ-039冲突箭头红可视化bad 边(后继 start≤前置 end)用红色 marker pm-ar-bad+bad 类(page.tsx:175,419-424)与统计条冲突计数同口径(AC-EL-PRJ-023)构造冲突断言红色 path生效
AC-EL-PRJ-040基线条可视化pm-bar base 灰条,left/width 按 baseline_start/baseline_end(page.tsx:433-434,444)width=max(基线长, 4px) 下限防消失改期后断言灰条不动彩条动生效
AC-EL-PRJ-041当前计划条可视化pm-bar cur 彩条按 start/end,色=阶段色(page.tsx:435-448)延误时条体改 warn/over 类不用阶段色;宽下限 4px;行 zebra 隔行底色断言颜色与阶段一致生效
AC-EL-PRJ-042延误着色阈值口径delay>0:delay>期长×20%=over(红)/否则 warn(黄)(page.tsx:430-432)delay=ddays(baseline_end,end_date);期长=当前工期+1 天;脚注声明「黄=轻微延误 <20% 期长,红=严重延误」(page.tsx:472-473)构造 25% 延误断言红条生效
AC-EL-PRJ-043条内标题可视化条宽>70px 才显示,done 前缀 ✓(page.tsx:447)窄条隐藏文字防溢出缩放到条宽<70 断言文字消失生效
AC-EL-PRJ-044拖拽改期交互交互仅鼠标左键;条体=整体平移,左右 8px 边缘=缩放起/止(page.tsx:236-272)位移 <4px 不触发(防误触);触摸留给滚动不拖拽;拖拽中禁 tooltip条左缘 5px 处按下拖动断言仅改起始生效
AC-EL-PRJ-045拖拽按日吸附口径dx=round(像素位移/dayW) 天(page.tsx:250)连续量转离散天;拖拽预览 dLeft/dWidth 即时跟随慢拖 0.5 日格断言无半日状态生效
AC-EL-PRJ-046拖拽提示浮层反馈显示新起止(M/D 格式)+「(±N 天)」(page.tsx:449-455)仅 dx≠0 显示;mode=r 固定显示原起始,mode=l 固定显示原结束拖动断言浮层数字随动生效
AC-EL-PRJ-047松手提交条件护栏engaged 且 dx≠0 才提交;ne<ns 或无变化放弃(page.tsx:253-260)PUT 全字段回传仅改日期;成功 toast「「{title}」顺延/提前 N 天」;失败 toast 改期失败拖成交叠(r 边拖过 s)松手断言无请求生效
AC-EL-PRJ-048悬浮提示卡反馈hover/点击彩条显示 pm-tip:标题/阶段·负责人·状态/基线区间/当前区间/启动完成偏差天数/备注(page.tsx:221-233,478-488)定位防溢出(右缘 320px 内、底部翻转向上);偏差带 +/− 号;尾行提示「双击行编辑 · 改期自动记历史」hover 断言七行内容与 DB 一致生效
AC-EL-PRJ-049底部口径说明口径声明灰字说明灰条=基线/彩条=当前/黄红延误定义/双击编辑/改期记历史/导入全量替换/RLS 企业隔离(page.tsx:471-475)页面级口径汇总,与各条目一致(不一致=缺陷)逐句与对应条目比对生效
AC-EL-PRJ-050toast反馈pm-toast 2.8 秒自动消失(page.tsx:57,64,515)所有操作反馈共用;无错误横幅则仅 toast断言 2.8s 后消失生效
AC-EL-PRJ-051任务弹窗容器弹窗pm-ov 遮罩+pm-modal,标题「新任务/编辑任务」二态(page.tsx:490-499,562-566)ESC 关闭(:536-540);遮罩自点击关闭;sub 说明编辑模式会记历史e2e ESC 断言关闭生效
AC-EL-PRJ-052任务表单字段表单任务名称 maxLength200/阶段 select 8 项/负责人 input+datalist/状态 select 三态/前置任务 select/起止 date 双件/备注 textarea maxLength500(page.tsx:567-601)负责人 datalist=现有 owners∪{Patrick,Susan,未分配}(:586-588);新任务默认 p1/未分配/pending/今日起 5 天(:526-532)打开新任务弹窗断言默认值生效
AC-EL-PRJ-053前置任务下拉表单选项=同产品其余任务,带起止日期展示(page.tsx:589-596)排除自身防自依赖;服务端另有环校验(AC-EL-PRJ-062)双护栏编辑任务断言列表无自身生效
AC-EL-PRJ-054任务保存校验校验名称必填+结束≥开始(page.tsx:542-544);服务端同校验 400(projects.py:193-194,227-228)新建 POST /api/pm/products/{pid}/tasks;编辑 PUT /api/pm/tasks/{id};phase/status 枚举非法服务端 400交叠日期保存断言错误提示生效
AC-EL-PRJ-055改期历史块信息「改期历史(N 次)」倒序列表:旧区间→新区间+时间(page.tsx:602-612)数据=history JSON 数组;仅编辑弹窗内展示拖拽改期两次后开弹窗断言两行倒序生效
AC-EL-PRJ-056history 服务端口径口径日期变化即 append {fs,fe,ts,te,time:UTC ISO}(projects.py:236-239)仅 start/end 变化才记(改状态/负责人不记);time 到毫秒;只增不删改状态断言 history 不增长生效
AC-EL-PRJ-057删除任务写操作danger 确认「删除任务「{title}」?」(page.tsx:555-560)DELETE /api/pm/tasks/{id};服务端不存在 404;审计 pm.task.delete;删除后依赖该任务的后继断链(depends_on 悬空由前端容忍)删除被依赖任务断言后继箭头消失生效
AC-EL-PRJ-058产品弹窗容器弹窗pm-modal 标题「新建产品项目/编辑产品」二态(page.tsx:500-514,671-675)ESC+遮罩关闭;edit 模式 key=产品 id 保证表单重置切换模式断言表单值刷新生效
AC-EL-PRJ-059新建产品表单表单产品名称 maxLength120(placeholder「如:X3 按摩仪」)/启动日期 date/阶段数 select 1-8/每阶段任务 select 1-6/阶段间隔 number 0-60(page.tsx:677-694)间隔输入 clamp [0,60](:692);名称必填(:648);POST /api/pm/products(phases_count/tasks_per_phase/phase_gap)边界值 1×1 间隔 0 建产品断言 1 任务生效
AC-EL-PRJ-060任务数预告反馈「将生成 N 个任务(标准模板 8 × 6 = 48,选品调研 → 上架运营)」(page.tsx:696-698)N=phasesN×tasksN 实时联动;创建成功 toast 补「(标准模板)」当恰 48(:509)改阶段数断言预告数字联动生效
AC-EL-PRJ-061模板生成算法口径任务=PM_PHASES 前 N 阶段×每阶段前 M 个模板任务(projects.py:35-52,133-142)每任务 e=s+(dur−1);baseline=首次生成日期;阶段间 offset+=phase_gap 天顺延;模板 48 任务各带固定标题/工期/负责人(Patrick/Susan);审计 pm.product.create标准模板断言 48 任务+起止连续+负责人符合模板生效
AC-EL-PRJ-062依赖合法性校验护栏_pm_dep_ok:同产品存在/非自身/沿链 ≤100 跳无环(projects.py:85-101)违规 400「前置任务非法(不存在/自身/成环)」;创建与更新均校验构造 A→B→A 环断言 400生效
AC-EL-PRJ-063编辑产品口径口径仅改名称+启动日期,不重排已有任务(page.tsx:675,658;projects.py:165-174)PUT 复用 PmProductIn(未传 phases 参数取默认 8/6/15 但更新 SQL 不使用);toast 明示「任务日期未联动,如需重排请编辑任务」;审计 pm.product.update改启动日期断言任务日期不动生效
AC-EL-PRJ-064删除产品写操作danger 确认「删除产品「{name}」?」body「其全部任务将一并删除。」(page.tsx:664-669)DELETE /api/pm/products/{pid} 级联删任务;审计 pm.product.delete 附「(级联删任务)」;删除后回产品列表自动选首项;护栏=确认弹窗+级联范围明示(不可误删铁律:删除范围对用户可见)删含任务产品断言任务全清生效

§11.37 站外促销页(/offsitepromotion · AC-EL-OFF,65 条 · 2026-10-22 源码实证 web/app/offsitepromotion/page.tsx 389 行 + 11 子组件(面板级)+ api/routers/ads.py /api/promotion/* 族,建档·待验)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFF-001页面标题导航AppShell title=推广(page.tsx:92)路由 /offsitepromotion;接口权限 require_module("ads")(ads.py 全 /api/promotion/* 端点);数据经 tenant_conn 企业隔离e2e 登录 ads 模块账号断言标题生效
AC-EL-OFF-002错误横幅反馈红色横幅 role="alert"(page.tsx:93)仅渠道库列表请求失败 setErr;摘要失败静默(:70)e2e mock channels 500 断言横幅生效
AC-EL-OFF-003顶级页签组导航8 页签:总览看板/达人库/Reddit 专库/邮件模板/邮件外联/收件工作台/邮箱设置/项目·任务·资源;默认总览看板(page.tsx:52,95-104)单选切换;信息架构 2026-10-11 定稿(:51 注释)e2e 断言 8 页签文本与默认选中生效
AC-EL-OFF-004子面板委派容器前 7 页签各委派一个子组件:OverviewTab/LibraryTab/RedditTab/TemplatesTab/SegmentsTab+SendTasksTab(外联=两件同屏)/InboxTab/MailboxesTab(page.tsx:106-118)委派关系为页面唯一结构;子组件文件均在 web/app/offsitepromotion/ 下逐 tab 切换断言对应组件渲染生效
AC-EL-OFF-005work 页签组导航「项目·任务·资源」页签内二级 6 页签:渠道库/采集监控/✅任务/📣KOL/🚀推广项目/🌐全部资源;默认渠道库(page.tsx:53,152-159)二级状态独立于顶级 tab;KPI 区恒显示于二级页签上方e2e 断言 6 页签与默认选中生效
AC-EL-OFF-006KPI·渠道总数KPI 卡数值+foot「去重后(同名合并)」(page.tsx:122-127)源 /api/promotion/summary kpi.total=count(*)(ads.py:370-373);同名去重发生在入库层非查询层SQL count(*) 与卡片数字对账生效
AC-EL-OFF-007KPI·含联系方式KPI 卡数值+foot「N% 可直接触达」(page.tsx:128-132)with_contact=count(contact);百分比=round(with_contact/total×100),total=0 时 0%对账 contact 非空占比生效
AC-EL-OFF-008KPI·待联系/待投稿KPI 卡双数值斜杠分隔+foot「养号中 N」(page.tsx:133-139)by_status 数组按 status 字符串查找;status 为空者服务端归「未标注」不参与这三项对账 by_status 各态计数生效
AC-EL-OFF-009KPI·近 7 日采集KPI 卡发现数+foot「发现 · 入库 N · 联系方式 M」(page.tsx:140-144)crawl7=前端对 sum.crawl 全行 reduce(page.tsx:83-86);后端只回近 7 日(interval '7 days',ads.py:403-407)故两端一致对账 promotion_crawl_stats 近 7 日和生效
AC-EL-OFF-010KPI·数据截至KPI 卡last_checked 日期+foot「快照口径 · 日更待接入」(page.tsx:145-149)max(last_checked)::date;空显「—」;foot 明示非实时(口径声明)对账 max(last_checked)生效
AC-EL-OFF-011摘要数据源口径挂载即 GET /api/promotion/summary 一次,失败静默(page.tsx:70)KPI/筛选 facets/分布/采集监控共用此响应;失败时相关区域显示 0 或空不报错mock 500 断言页面可用无横幅生效
AC-EL-OFF-012渠道库卡标题容器h2「渠道库」sub「共 N 条 · 按粉丝数排序」(page.tsx:163)N=data.total;「按粉丝数排序」指默认 sort=followers(可改排序,sub 文案不随动——已知文案固化)改排序断言列表顺序变而 sub 不变生效
AC-EL-OFF-013类型下拉筛选「全部类型(N)」+各类型带计数(page.tsx:165-168)选项=facets.types(空 type 剔除);选择即重查回第 1 页选一类型断言 total 收敛生效
AC-EL-OFF-014层级按钮组筛选「全部层级」+「X 级」按钮组(page.tsx:169-172)选项=facets.tiers(DISTINCT 升序);单选互斥选 B 级断言仅 B 级行生效
AC-EL-OFF-015国家/状态下拉筛选两个 select:全部国家/全部状态(page.tsx:173-180)选项=facets.countries/statuses(DISTINCT,空值剔除);服务端 coalesce 等值匹配组合筛选断言结果生效
AC-EL-OFF-016搜索表单筛选input「渠道 / 联系方式 / 备注」+排序下拉+「搜索」按钮(page.tsx:181-187)输入即时存 search 态,submit 才置 query 触发请求(防抖语义);提交回第 1 页输入不提交断言无请求生效
AC-EL-OFF-017排序下拉筛选4 项:按粉丝数/活跃度/最近核验/名称(page.tsx:40-42,183-185)默认 followers;服务端映射 PROMO_SORTS(ads.py:320-321):followers=follower_count DESC NULLS LAST 等;非法值回退 followers选活跃度断言顺序变化生效
AC-EL-OFF-018渠道表表头表格12 列:渠道/类型层级/国家·平台/粉丝/活跃度/费用/预估单/联系方式提交/状态/适配产品线/核验/操作(page.tsx:194-197)列序固定;行键=namee2e 断言 12 列文本与顺序生效
AC-EL-OFF-019渠道列列source_url 非空时名称为外链(新窗 noreferrer),notes 超 60 字截断加…(page.tsx:201-204)title 属性=完整 notes 可看全文;无 url 纯文本断言截断与悬停全文生效
AC-EL-OFF-020类型/层级列列类型文本+层级 badge「X 级」(B=ok 绿 其余 dim 灰)(page.tsx:205-208)tier 空则无 badge;类型空显「—」断言 B 级绿徽章生效
AC-EL-OFF-021国家·平台列列[country, platform, language] 过滤空后「 · 」连接,全空显「—」(page.tsx:209)三字段拼接展示缺字段行断言拼接正确生效
AC-EL-OFF-022粉丝列列int() 千分位,null 显「—」(page.tsx:210)源 follower_count 整数对账 DB 值生效
AC-EL-OFF-023活跃度列列数值一位小数(page.tsx:211)服务端 round(activity_score::numeric,1)(ads.py:350);null 显「—」对账 round 一位小数生效
AC-EL-OFF-024费用/预估单列列文本展示 cost/est_orders,空显「—」(page.tsx:212-213)源库自由文本(非数值字段),无汇总口径断言原样回显生效
AC-EL-OFF-025联系方式/提交列列contact 主行+submit 副行(page.tsx:214-217)submit=投稿方式(submit_method 字段);空 contact 显「—」对账两字段生效
AC-EL-OFF-026状态徽章 tone 映射列STATUS_TONE 十态映射(page.tsx:43-46)待投稿=ok/养号中·暂缓=warn·bad/其余(待联系 待评估 待代理 待注册 待开通 待布局)=dim;未知态回退 dim逐状态断言颜色生效
AC-EL-OFF-027适配产品线 chips列fits 数组渲染中文 chip(page.tsx:37-39,219)FIT_LABELS 五线:keyboard=机械键盘/earphone=耳机/security=安防/bra=女士bra/brainews=BraiNews;空显「—」断言 chip 文本映射生效
AC-EL-OFF-028fits 口径(0-3 评分)口径fits=fit_* 五列中值≥1 的集合(ads.py:361)fit_* 为 0-3 评分非布尔;筛选条件 fit_col>=1(ads.py:333-335,2026-09-17 P0 修:原 =1 漏 90% 渠道);此口径为已修缺陷基准评分 2/3 的渠道断言命中筛选与 chip生效
AC-EL-OFF-029核验列列last_checked 日期(page.tsx:220)服务端 str[:10] 截日期;空显「—」对账 last_checked生效
AC-EL-OFF-030操作列(投稿/下单)操作每行「投稿」「下单」两按钮开记录弹窗(page.tsx:221-224,50)T3-2(2026-09-12):行级「投稿/下单」表单(UVPVP 记录投稿/申请投放对齐);弹窗见 AC-EL-OFF-044e2e 点投稿断言弹窗标题生效
AC-EL-OFF-031渠道表空态空态「无匹配渠道」colSpan=12(page.tsx:227)仅 items=[] 显示过滤至空断言文案生效
AC-EL-OFF-032分页器分页重置筛选/「共 N 条 · 第 x / y 页」/上一页/下一页(page.tsx:231-236)pageSize 固定 20(:66;服务端 clamp [1,100]);pages=ceil(total/20);越界按钮禁用;重置=清全部筛选回第 1 页翻页断言参数 page 正确生效
AC-EL-OFF-033channels 服务端搜索口径口径search 匹配 name/contact/notes/platform 四字段 ILIKE(ads.py:339-340)任意子串不分区大小写;空 search 全量platform 片段搜索断言命中生效
AC-EL-OFF-034类型×层级分布卡表格「类型 × 层级分布」sub「Top 12 类型」:类型/B 级/C 级/合计 4 列(page.tsx:248-271)byType=distribution 前端按 type 求和降序前 12(:87-89);B 级=tier=B 行,C 级=其余 tier 合计(含空);0 显「—」对账 distribution 分组求和生效
AC-EL-OFF-035采集监控卡表表格6 列:日期/发现/入库/富化/失败/联系方式,按日倒序(page.tsx:272-300)源 promotion_crawl_stats 平台级表:无企业列无 RLS 登录即可见(ads.py:402 注释);date_trunc('day',hour) 聚合近 7 日对账 crawl_stats 日聚合生效
AC-EL-OFF-036失败列红色阈值口径failed>100 时红字 var(--danger)(page.tsx:284)阈值 100 为展示告警线,不影响数据构造 101 失败日断言红色生效
AC-EL-OFF-037近 7 日合计行行底行浅底 #f8f8ff 加粗:五指标合计(page.tsx:288-297)与 KPI 近 7 日同源 crawl7;富化 0 显「—」合计与 KPI foot 对账一致生效
AC-EL-OFF-038采集监控口径说明口径声明「渠道发现 → 入库 → 联系方式富化三段式采集离线运行;失败数偏高多为目标页反爬(429/403),不影响已入库数据。」(page.tsx:301-303)三段式链路口径;失败为采集侧非数据侧文案与采集器行为比对生效
AC-EL-OFF-039投稿/下单弹窗容器弹窗440px 卡片弹窗,标题二态「📝 记录投稿/💵 申请付费投放」+「渠道:X」(page.tsx:347-352)遮罩点击关闭;渠道名只读回显e2e 断言两模式标题生效
AC-EL-OFF-040弹窗·产品下拉表单5 固定选项(page.tsx:316,354-357)PRODUCTS=[机械键盘,耳机,安防,女士bra,BraiNews] 与 FIT_LABELS 值域一致;默认首项断言 5 选项生效
AC-EL-OFF-041弹窗·投稿模式字段表单结果 select 4 态(待审/上稿/拒绝/无回复,默认待审)+单量 number 可空(page.tsx:359-367)单量空=null 不传 0留空提交断言 orders=null生效
AC-EL-OFF-042弹窗·下单模式字段表单金额 number+货币 select(USD/CNY 默认 USD)(page.tsx:368-377)金额 Number(amount)(空串落 0);备注可选空金额提交断言 amount=0生效
AC-EL-OFF-043弹窗·提交与反馈写操作投稿 POST /api/promotion/submission toast「投稿已记录」;下单 POST /api/promotion/orders toast「投放申请已提交(待审批)」(page.tsx:329-344)busy 期间按钮禁用「提交中…」;失败 toast 错误信息;成功关弹窗e2e 双路径断言 toast生效
AC-EL-OFF-044submission 服务端口径写操作product/channel 必填 400「产品与渠道必填」(ads.py:2475-2491)截断 product 80/channel 120/result 20/note 500;result 空默认「待审」;落 promotion_submissions 含 submitted_by;审计 promotion.submission 事务内原子化(2026-10-01 P2-波⑤ 修:原 audit NameError 致半成功)——已修缺陷基准提交后查审计行存在且与 INSERT 同事务生效
AC-EL-OFF-045orders 服务端口径写操作INSERT promotion_orders,status 默认 pending,含 requested_by(ads.py:2293-2302)审计 promo.order.create;金额原币存储不折算(currency 字段区分)提交申请断言 status=pending生效
AC-EL-OFF-046orders 审批护栏护栏POST /api/promotion/orders/{oid}/approve 需管理员(_require_admin)+action=approve/reject(ads.py:2305-2320)仅 pending 可批,否则 409「订单不存在或已审批」;审计 promo.order.approve/reject非管理员调用断言 403;重复审批断言 409生效
AC-EL-OFF-047子面板·总览看板面板OverviewTab(page.tsx:106)数据源 kol-library(suppression=all&page_size=1)+kol-stats+channel-dict(OverviewTab.tsx:30-34);含「达人渠道分布 Top 12」「Deal 资源怎么找 三处口径」「待上线模块」等卡(h2 行 87/106/115)切 tab 断言三请求发出与卡片渲染生效
AC-EL-OFF-048子面板·达人库面板LibraryTab(page.tsx:107)数据源 /api/promotion/kol-library 多选筛选(suppression 默认隐藏,h2 sub 声明,LibraryTab.tsx:117)+批量类目 /api/promotion/kol-categories/batch(:103)+类目管理 /api/promotion/categories(:288-302)+渠道字典 /api/promotion/channel-dict(:349-367,插行即生效)断言四组端点与三卡渲染生效
AC-EL-OFF-049子面板·Reddit 专库面板RedditTab(页签按钮 page.tsx:98,渲染行 :108)数据源 /api/promotion/kol-reddit(RedditTab.tsx:37);h2「共 N 位达人 · 仅站内联系方式,只读浏览」(:53)——只读面板无写操作断言请求与只读(无写按钮)生效
AC-EL-OFF-050子面板·邮件模板面板TemplatesTab(页签按钮 page.tsx:99,渲染行 :109)数据源 /api/promotion/email-templates 列表/新建/编辑 PUT/删除/预览 preview(TemplatesTab.tsx:46,53,159-175)CRUD+预览各断言一次生效
AC-EL-OFF-051子面板·分群面板SegmentsTab(page.tsx:113)数据源 /api/promotion/segments 建删(SegmentsTab.tsx:54,77,86);h2 口径「达人 ID 快照 · 发送时仍实时查 suppression + 30 天冷却」(:92);建删后通知发送任务刷新分群下拉(page.tsx:67-68 segVer 机制)建分群断言返回 kol_count 与下拉刷新生效
AC-EL-OFF-052子面板·发送任务面板SendTasksTab(page.tsx:114)数据源 /api/promotion/send-tasks 建/列表/状态动作 /{tid}/{action}/删//{tid}/logs 分页日志(SendTasksTab.tsx:50,83,95,103,208);依赖 email-templates/mailboxes/segments 三下拉源(:56-65)建任务断言状态机流转+日志分页生效
AC-EL-OFF-053子面板·收件工作台面板InboxTab(page.tsx:117)组件文件 web/app/offsitepromotion/InboxTab.tsx(366 行);本批未核其端点与元素——列级条目待深化(验收缺口挂账)。

2026-10-22 换绿:§11.40 OFC-INB 63 条已建档——面板容器+全部端点(列表/翻页/15s 轮询/thread/kol-profile/email-templates/claim/classify/handled/reply/classify-rules CRUD)+列+交互元素,InboxTab.tsx 逐行实证
读源后补列级条目生效
AC-EL-OFF-054子面板·邮箱设置面板MailboxesTab(page.tsx:118)数据源 /api/promotion/mailboxes 列表/新建/编辑 PUT/连通测试 /{id}/test/删(MailboxesTab.tsx:61,85,88,99,110)建邮箱+测试断言连通结果生效
AC-EL-OFF-055子面板·✅任务面板TasksPanel(page.tsx:242,实现于 TasksTab.tsx)数据源 /api/promotion/submissions(投稿记录 100 条,h2 行 39)+/api/promotion/orders(投放申请,h2 行 51「pending 状态管理员可批」)+审批 approve 调用(TasksTab.tsx:27-32)断言两列表与审批按钮生效
AC-EL-OFF-056子面板·📣KOL面板KolPanel(page.tsx:243,实现于 TasksTab.tsx)含「平台效果分析(互动率=(均赞+均评)/均播 · 100K+ 占比按订阅)/粉丝量级性价比/品类分布/国家分布」四卡(TasksTab.tsx h2 行 313-327);数据源 kol-analysis 族断言四分析卡渲染生效
AC-EL-OFF-057子面板·🚀推广项目面板ProjectsPanel(page.tsx:244,实现于 ProjectsTab.tsx 374 行)端点族 10 个:projects 列表/建/删、/{id}/kols 筛选分页、/project-kols/{pkid}/status、email/batch-send、export CSV、kols/add 勾选加入、/project-kols/{pk_id}/content+manual PUT(ProjectsTab.tsx:31,38,91,129,135,141,147,256,303,315)走通建项目→加 KOL→批送→导出链生效
AC-EL-OFF-058子面板·🌐全部资源面板ResourcesPanel(page.tsx:245,实现于 ResourcesTab.tsx)数据源 /api/promotion/resources?rtype&platform(ResourcesTab.tsx:30);h2「渠道站 + 达人 · 共 N 条 · 按粉丝降序」(:46)断言列表与筛选生效
AC-EL-OFF-059tasks 端点族口径GET/POST /api/promotion/tasks+/{tid}/status+DELETE(ads.py:2195-2256)列表排序 in_progress→blocked→其余,LIMIT 300;stats=pending/blocked/in_progress 三计数;状态非法 400「未知状态」;动作必填 400;审计 promo.task.create/status/delete对账三计数与排序生效
AC-EL-OFF-060渠道状态流转口径POST /api/promotion/channels/{cid}/status(ads.py:2257-2278)自由九态(待投稿/已投稿/已上稿/已拒/待代理/暂缓/养号中/待注册/待评估);审计留痕流转一态断言列表回显生效
AC-EL-OFF-061KOL 外联状态护栏护栏POST /api/promotion/kol/{kind}/{kid}/outreach(ads.py:2327-2339)kind∈{channel,site,high};kind=channel 固定 400「KOL 渠道表不支持外联状态(仅测评站/高优清单支持)」(2026-09-17 修:原代码对该表必 500)——已修缺陷基准;审计 promo.kol.outreachkind=channel 调用断言 400 非 500生效
AC-EL-OFF-062KOL 库口径口径GET /api/promotion/kol(ads.py:2342+)kind 三源:渠道 1000/测评站 315/高优 65(docstring 口径);limit clamp [1,200] 默认 50三 kind 各拉一页对账量级生效
AC-EL-OFF-063submissions/orders 回读口径GET /api/promotion/submissions 与 GET /api/promotion/orders(ads.py:2279-2290,2494-2503)各新→旧 100 条;orders 2026-09-17 补(原提交后无页面可读回,审批无入口)——已修缺陷基准;orders 含 requested_by/approved_by提交后断言列表首行回显生效
AC-EL-OFF-064子组件列级深化挂账边界声明本节对 11 个子组件按面板级建档(端点+标题+核心口径),组件内部逐元素条目未建面板出现而库中无列级条目=验收缺口(沿用 §11.27 财务列级+§11.28 采集六 tab 列级两级先例:先页级后列级);InboxTab 连面板级端点都未核(AC-EL-OFF-053)优先补后续批次按组件逐个补列级。

2026-10-22 换绿:§11.40 OFC 系列 446 条列级全建档(11 子组件+InboxTab),两级先例(页级→列级)闭环
生效
AC-EL-OFF-065模块权限与隔离口径·铁律全部 /api/promotion/* 端点 require_module("ads")(ads.py 各路由签名)渠道库/分群/模板/邮箱经 tenant_conn 企业隔离;唯 promotion_crawl_stats 平台级无企业列(登录可见,AC-EL-OFF-035 已声明); crawl 数据不涉品牌隔离非 ads 模块账号访问断言 403生效

§11.38 选品图表墙逐图·ABA/Explore(/sourcing · AC-EL-SRC-AB/EC 系列,源码 web/app/sourcing/charts/{ABACharts,ExploreCharts}.tsx + chartCatalog.ts;数据接线 web/app/sourcing/page.tsx)

ABA 墙 20 图=ABA_CHARTS 目录驱动循环渲染(chartCatalog.ts:5-26,卡片网格 ABACharts.tsx:35-41,图题=目录第二列逐字);数据=GET /api/sourcing/explorer(page.tsx:260 拉取、:421 <ABACharts data> 注入,payload 含 timeline/turnover/rotation/cross;姊妹端点 /api/sourcing/aba/chart sourcing.py:2206 同口径);timeline 空则整墙零构建、逐卡显「当前范围无可绘制数据」(:30/:38);periods>18 的折线自动 dataZoom;源=aba_terms_full+aba_search_terms+aba_keepa_full(SRC-17 口径,未变)。

Explore 墙 38 图 7 组=EXPLORE_CHART_GROUPS 目录驱动(ExploreCharts.tsx:21-74,组头 h2 显「N 图 · 固化架构」:96,卡网格 :97-103);数据=/api/sourcing/explore 行集前 200 行、EXPLORE_FIELDS 33 字段固定全取(:10-19,SRC-52 口径未变),全部图前端由行集计算(bucketize :111-118 / cnt :124-128 / sc :175-176 / topAsin :186-189 / boxBy :196-203 / pearson :232-240);无数据图渲染「无数据 · 空白占位」斜纹卡(:84-88)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-SRC-AB-001SFR月度趋势折线ABA 墙第 1 图timeline.search_frequency_rank 逐月;y 轴反转(SFR 越小越热),yLabel「SFR (越小越热)」;目录项 chartCatalog.ts:6,构建器 ABACharts.tsx:51-56读 chartCatalog.ts chartCatalog.ts:6 与构建器 ABACharts.tsx:51-56;图题逐字比对生效
AC-EL-SRC-AB-002SFR月度变化量/变化率折线ABA 墙第 2 图逐月差分=prev−cur(首月无前值记空);目录项 chartCatalog.ts:7,构建器 ABACharts.tsx:57-66读 chartCatalog.ts chartCatalog.ts:7 与构建器 ABACharts.tsx:57-66;图题逐字比对生效
AC-EL-SRC-AB-003季节性热力图(年份×自然月)热力图ABA 墙第 3 图timeline 按年×月矩阵,色值=−SFR(反转着色);目录项 chartCatalog.ts:8,构建器 ABACharts.tsx:67-78读 chartCatalog.ts chartCatalog.ts:8 与构建器 ABACharts.tsx:67-78;图题逐字比对生效
AC-EL-SRC-AB-004ABA月份完整度/缺月图柱图ABA 墙第 4 图逐月 status=available 记 1 否则 0,竖柱;目录项 chartCatalog.ts:9,构建器 ABACharts.tsx:79-87读 chartCatalog.ts chartCatalog.ts:9 与构建器 ABACharts.tsx:79-87;图题逐字比对生效
AC-EL-SRC-AB-005Top1/2/3点击份额曲线折线ABA 墙第 5 图asin_{1,2,3}_click_share 三线,百分轴;目录项 chartCatalog.ts:10,构建器 ABACharts.tsx:88-95读 chartCatalog.ts chartCatalog.ts:10 与构建器 ABACharts.tsx:88-95;图题逐字比对生效
AC-EL-SRC-AB-006Top1/2/3成交份额曲线折线ABA 墙第 6 图asin_{1,2,3}_conv_share 三线,百分轴;目录项 chartCatalog.ts:11,构建器 ABACharts.tsx:96-103读 chartCatalog.ts chartCatalog.ts:11 与构建器 ABACharts.tsx:96-103;图题逐字比对生效
AC-EL-SRC-AB-007Top3与榜外点击份额堆叠图堆叠ABA 墙第 7 图top3_click_share+other_click_share 两段百分堆叠;目录项 chartCatalog.ts:12,构建器 ABACharts.tsx:104-112读 chartCatalog.ts chartCatalog.ts:12 与构建器 ABACharts.tsx:104-112;图题逐字比对生效
AC-EL-SRC-AB-008Top3与榜外成交份额堆叠图堆叠ABA 墙第 8 图top3_conv_share+榜外=1−Top3 推导(源无榜外成交原始列);目录项 chartCatalog.ts:13,构建器 ABACharts.tsx:113-121读 chartCatalog.ts chartCatalog.ts:13 与构建器 ABACharts.tsx:113-121;图题逐字比对生效
AC-EL-SRC-AB-009点击份额-成交份额差值曲线折线ABA 墙第 9 图top3_click_share−top3_conv_share 逐月,百分轴;目录项 chartCatalog.ts:14,构建器 ABACharts.tsx:122-127读 chartCatalog.ts chartCatalog.ts:14 与构建器 ABACharts.tsx:122-127;图题逐字比对生效
AC-EL-SRC-AB-010指定月份Top3与榜外份额结构图环形ABA 墙第 10 图取最近 status=available 且份额非空月的 Top1/2/3+榜外四段百分环;目录项 chartCatalog.ts:15,构建器 ABACharts.tsx:128-141读 chartCatalog.ts chartCatalog.ts:15 与构建器 ABACharts.tsx:128-141;图题逐字比对生效
AC-EL-SRC-AB-011全部上榜ASIN点击份额轨迹折线ABA 墙第 11 图逐 ASIN 聚合各席位 click_share 成线,仅前 15 ASIN(slice 0,15);目录项 chartCatalog.ts:16,构建器 ABACharts.tsx:142-158读 chartCatalog.ts chartCatalog.ts:16 与构建器 ABACharts.tsx:142-158;图题逐字比对生效
AC-EL-SRC-AB-012全部上榜ASIN成交份额轨迹折线ABA 墙第 12 图同 011 口径改 conv_share,仅前 15 ASIN;目录项 chartCatalog.ts:17,构建器 ABACharts.tsx:159-175读 chartCatalog.ts chartCatalog.ts:17 与构建器 ABACharts.tsx:159-175;图题逐字比对生效
AC-EL-SRC-AB-013ASIN×月份×Top1/2/3席位热力图热力图ABA 墙第 13 图矩阵值=席位号 1/2/3;ASIN 取 rotation 前 15;目录项 chartCatalog.ts:18,构建器 ABACharts.tsx:176-191读 chartCatalog.ts chartCatalog.ts:18 与构建器 ABACharts.tsx:176-191;图题逐字比对生效
AC-EL-SRC-AB-014Top1占位ASIN时间带时间带ABA 墙第 14 图逐月 asin_1 占位标签带;目录项 chartCatalog.ts:19,构建器 ABACharts.tsx:192-197读 chartCatalog.ts chartCatalog.ts:19 与构建器 ABACharts.tsx:192-197;图题逐字比对生效
AC-EL-SRC-AB-015每月新进入/退出ASIN数折线ABA 墙第 15 图turnover.entered/exited 双线;目录项 chartCatalog.ts:20,构建器 ABACharts.tsx:198-206读 chartCatalog.ts chartCatalog.ts:20 与构建器 ABACharts.tsx:198-206;图题逐字比对生效
AC-EL-SRC-AB-016随选月增加的累计去重ASIN曲线折线ABA 墙第 16 图turnover.cumulative_unique 单线;目录项 chartCatalog.ts:21,构建器 ABACharts.tsx:207-211读 chartCatalog.ts chartCatalog.ts:21 与构建器 ABACharts.tsx:207-211;图题逐字比对生效
AC-EL-SRC-AB-017ASIN上榜月数分布柱图ABA 墙第 17 图rotation.appearances 分桶计数(X 月);目录项 chartCatalog.ts:22,构建器 ABACharts.tsx:212-219读 chartCatalog.ts chartCatalog.ts:22 与构建器 ABACharts.tsx:212-219;图题逐字比对生效
AC-EL-SRC-AB-018相邻月份席位换手率折线ABA 墙第 18 图turnover.turnover_rate,百分轴;目录项 chartCatalog.ts:23,构建器 ABACharts.tsx:220-224读 chartCatalog.ts chartCatalog.ts:23 与构建器 ABACharts.tsx:220-224;图题逐字比对生效
AC-EL-SRC-AB-019月份数→理论席位→有效席位→去重ASIN漏斗横柱ABA 墙第 19 图四级横柱:有效月数→×3 理论席位→Σappearances 有效席位→rotation 数去重;目录项 chartCatalog.ts:24,构建器 ABACharts.tsx:225-239读 chartCatalog.ts chartCatalog.ts:24 与构建器 ABACharts.tsx:225-239;图题逐字比对生效
AC-EL-SRC-AB-020同一精确词跨站点SFR/Top1/Top3集中度对比折线ABA 墙第 20 图cross[].sfr_median/top1_click_median/top3_click_median 按 country 三线;仅 cross.length>1 构建,否则空卡;目录项 chartCatalog.ts:25,构建器 ABACharts.tsx:240-249读 chartCatalog.ts chartCatalog.ts:25 与构建器 ABACharts.tsx:240-249;图题逐字比对生效
AC-EL-SRC-EC-001BuyBox 价格分布柱图价格维度组图卡buy_box 分桶 0/10/20/30/50/80/120/200,币种轴;构建器 ExploreCharts.tsx:132读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:132;图题逐字比对生效
AC-EL-SRC-EC-002Amazon 自营价分布柱图价格维度组图卡price_amazon 同 8 档桶,币种轴;构建器 ExploreCharts.tsx:133读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:133;图题逐字比对生效
AC-EL-SRC-EC-003Marketplace 新品价分布柱图价格维度组图卡price_new 同 8 档桶,币种轴;构建器 ExploreCharts.tsx:134读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:134;图题逐字比对生效
AC-EL-SRC-EC-004Used 价分布柱图价格维度组图卡price_used 同 8 档桶,币种轴;构建器 ExploreCharts.tsx:135读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:135;图题逐字比对生效
AC-EL-SRC-EC-005List 价分布柱图价格维度组图卡list_price 分桶 0/15/30/50/80/120/200/400,币种轴;构建器 ExploreCharts.tsx:136读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:136;图题逐字比对生效
AC-EL-SRC-EC-006当前 BSR 档位分布柱图排名/销量维度组图卡bsr_current 分桶 0/1k/5k/1w/5w/10w/50w/100w;构建器 ExploreCharts.tsx:139读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:139;图题逐字比对生效
AC-EL-SRC-EC-00790 天均 BSR 档位分布柱图排名/销量维度组图卡bsr_avg90 同 7 档桶;构建器 ExploreCharts.tsx:140读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:140;图题逐字比对生效
AC-EL-SRC-EC-008近月购买量档位分布柱图排名/销量维度组图卡monthly_sold 分桶 0/100/300/1k/3k/1w/3w;构建器 ExploreCharts.tsx:141读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:141;图题逐字比对生效
AC-EL-SRC-EC-00930 天 Rank Drops 档位分布柱图排名/销量维度组图卡drops30 分桶 0/500/2k/5k/1w/3w/10w;构建器 ExploreCharts.tsx:142读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:142;图题逐字比对生效
AC-EL-SRC-EC-010365 天 Rank Drops 档位分布柱图排名/销量维度组图卡drops365 分桶 0/5k/2w/5w/10w/30w/100w;构建器 ExploreCharts.tsx:143读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:143;图题逐字比对生效
AC-EL-SRC-EC-011评分分布柱图评论/评分维度组图卡rating 分桶 1/3/3.5/3.8/4/4.2/4.4/4.6/4.8;构建器 ExploreCharts.tsx:146读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:146;图题逐字比对生效
AC-EL-SRC-EC-012评论数档位分布柱图评论/评分维度组图卡reviews 分桶 0/10/50/100/500/1k/5k;构建器 ExploreCharts.tsx:147读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:147;图题逐字比对生效
AC-EL-SRC-EC-01390 天均评论档位分布柱图评论/评分维度组图卡reviews_avg90 分桶 0/1/5/10/50/100/500;构建器 ExploreCharts.tsx:148读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:148;图题逐字比对生效
AC-EL-SRC-EC-014总报价数档位分布柱图报价/库存维度组图卡total_offers 分桶 0/2/5/10/20/50/100;构建器 ExploreCharts.tsx:151读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:151;图题逐字比对生效
AC-EL-SRC-EC-01530 天缺货次数分布柱图报价/库存维度组图卡oos_amazon_30 分桶 0/1/3/5/10/20;构建器 ExploreCharts.tsx:152读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:152;图题逐字比对生效
AC-EL-SRC-EC-016商品重量档位分布柱图报价/库存维度组图卡item_weight 分桶 0/0.2/0.5/1/2/5/10/20;构建器 ExploreCharts.tsx:153读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:153;图题逐字比对生效
AC-EL-SRC-EC-017品牌占比 Top15环形结构占比维度组图卡brand 计数 Top15 环;构建器 ExploreCharts.tsx:156读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:156;图题逐字比对生效
AC-EL-SRC-EC-018制造商占比 Top10环形结构占比维度组图卡manufacturer 计数 Top10 环;构建器 ExploreCharts.tsx:157读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:157;图题逐字比对生效
AC-EL-SRC-EC-019BSR 显示组占比 Top12环形结构占比维度组图卡sales_rank_display_group 计数 Top12 环;构建器 ExploreCharts.tsx:158读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:158;图题逐字比对生效
AC-EL-SRC-EC-020颜色占比 Top10环形结构占比维度组图卡color 计数 Top10 环;构建器 ExploreCharts.tsx:159读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:159;图题逐字比对生效
AC-EL-SRC-EC-021尺寸占比 Top10环形结构占比维度组图卡size 计数 Top10 环;构建器 ExploreCharts.tsx:160读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:160;图题逐字比对生效
AC-EL-SRC-EC-022BuyBox FBA / FBM 占比环形结构占比维度组图卡buy_box_is_fba true/false/其余未知 三段;构建器 ExploreCharts.tsx:161-166读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:161-166;图题逐字比对生效
AC-EL-SRC-EC-023BuyBox 自营 / 第三方占比环形结构占比维度组图卡buy_box_is_amazon true/false/其余未知 三段;构建器 ExploreCharts.tsx:167-172读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:167-172;图题逐字比对生效
AC-EL-SRC-EC-024BuyBox 价 × 月销量散点关联散点维度组图卡气泡=reviews,x 币种轴;sc() :175-176;构建器 ExploreCharts.tsx:177读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:177;图题逐字比对生效
AC-EL-SRC-EC-025当前 BSR × 月销量散点关联散点维度组图卡x=bsr_current y=monthly_sold 气泡=reviews;构建器 ExploreCharts.tsx:178读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:178;图题逐字比对生效
AC-EL-SRC-EC-026评分 × 评论数散点关联散点维度组图卡x=rating y=reviews;构建器 ExploreCharts.tsx:179读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:179;图题逐字比对生效
AC-EL-SRC-EC-027BuyBox 价 × 评论数散点关联散点维度组图卡x 币种轴;构建器 ExploreCharts.tsx:180读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:180;图题逐字比对生效
AC-EL-SRC-EC-02830 天 Drops × 月销量散点关联散点维度组图卡x=drops30 y=monthly_sold;构建器 ExploreCharts.tsx:181读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:181;图题逐字比对生效
AC-EL-SRC-EC-029总报价数 × BuyBox 价散点关联散点维度组图卡y 币种轴;构建器 ExploreCharts.tsx:182读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:182;图题逐字比对生效
AC-EL-SRC-EC-030品牌上榜数 Top20柱图Top榜/箱线/相关性组图卡cnt(brand,20) 计数降序;构建器 ExploreCharts.tsx:185读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:185;图题逐字比对生效
AC-EL-SRC-EC-031月销量 Top20 ASIN柱图Top榜/箱线/相关性组图卡topAsin(monthly_sold desc) 前 20(topAsin :186-189);构建器 ExploreCharts.tsx:190读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:190;图题逐字比对生效
AC-EL-SRC-EC-032评论数 Top20 ASIN柱图Top榜/箱线/相关性组图卡topAsin(reviews desc);构建器 ExploreCharts.tsx:191读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:191;图题逐字比对生效
AC-EL-SRC-EC-033BuyBox 价 Top20 ASIN柱图Top榜/箱线/相关性组图卡topAsin(buy_box desc) 币种轴;构建器 ExploreCharts.tsx:192读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:192;图题逐字比对生效
AC-EL-SRC-EC-034BSR 最优 Top20 ASIN柱图Top榜/箱线/相关性组图卡topAsin(bsr_current asc)(越小越优);构建器 ExploreCharts.tsx:193读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:193;图题逐字比对生效
AC-EL-SRC-EC-035品牌 BuyBox 价格箱线 Top10箱线Top榜/箱线/相关性组图卡boxBy 按品牌样本数 Top10(boxBy :196-203),币种轴;构建器 ExploreCharts.tsx:204读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:204;图题逐字比对生效
AC-EL-SRC-EC-036品牌评分箱线 Top10箱线Top榜/箱线/相关性组图卡boxBy(rating);构建器 ExploreCharts.tsx:205读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:205;图题逐字比对生效
AC-EL-SRC-EC-037品牌月销量箱线 Top10箱线Top榜/箱线/相关性组图卡boxBy(monthly_sold);构建器 ExploreCharts.tsx:206读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:206;图题逐字比对生效
AC-EL-SRC-EC-038核心指标相关性矩阵热力图Top榜/箱线/相关性组图卡9 指标(BuyBox/BSR/月销/评分/评论/drops30/报价数/New报价/重量)两两 Pearson,逐对仅取双字段均有限行,n<3 不计,值留 2 位(pearson :232-240);构建器 ExploreCharts.tsx:209-228读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:209-228;图题逐字比对生效

§11.39 选品图表墙逐图·Keepa 单 ASIN/池级/ABA×Keepa 联合(AC-EL-SRC-KS/KP/JT 系列,源码 web/app/sourcing/charts/{KeepaSingleCharts,KeepaPoolCharts,JointCharts}.tsx;图录 chartCatalog.ts)

数据源 /api/sourcing/explorer → rotation[*].keepa(aba_keepa_full 快照+30/90/180/365 窗口聚合,无原始时序——历史类图为单点/窗口近似,KeepaSingleCharts.tsx:2-5 头注明示);34+22+34=90 图目录卡全渲染(网格 auto-fit minmax(380px,1fr),无数据兜底「无数据」)。KS 降级规则:纯线图非空点<3 → 快照摘要卡(:49-73);「⚡ 拉取 Keepa 原始曲线」(GET /api/sourcing/keepa-history,1 token/24h 缓存,:87-94)就位后 7 个历史图升级真曲线(720 点,:97-111)。JT 实为 34 图——chartCatalog.ts:136 counts 注 joint:32 已过时;JointCharts.tsx:67-74 sfrVsKeepa 数组为死代码(计算后未用,:84-104 循环另行构建)。 2026-10-22 v5.3 更正:KS 5 张恒空卡撤卡(KS-014/016/017/023/035→废止),7 处图题对齐实构(KS-025/032/034、KP-022、JT-005/009/010);上句 counts 过时与 sfrVsKeepa 死数组问题均已修复——counts 现 joint:34/keepa_single:34/total:110(chartCatalog.ts:132),死数组 :67-74 已删(本节 JointCharts 行号已随删行平移)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-SRC-KS-001BSR原始变化点线图BSR 两点近似keepa-single-bsr-raw 目录项;bsr_avg90+bsr_current 两点线, invert 轴; 快照近似非真时序(构建 KeepaSingleCharts.tsx 162-170)chartCatalog.ts:29+KeepaSingleCharts.tsx:162生效
AC-EL-SRC-KS-002BSR日末值及日内最好/最差区间线图BSR 区间近似keepa-single-bsr-daily-range 目录项;avg90/current±drops30 模拟上下界; 快照近似(构建 KeepaSingleCharts.tsx 171-179)chartCatalog.ts:30+KeepaSingleCharts.tsx:171生效
AC-EL-SRC-KS-003BSR周级/月级聚合柱图(横)drops 四窗分布keepa-single-bsr-week-month 目录项;drops30/90/180/365 四横柱(以 drops 代理聚合)(构建 KeepaSingleCharts.tsx 181-190)chartCatalog.ts:31+KeepaSingleCharts.tsx:181生效
AC-EL-SRC-KS-004Amazon近月购买量档位阶梯线线图月销档单点keepa-single-monthly-sold 目录项;monthly_sold 档位单点线(构建 KeepaSingleCharts.tsx 192-195)chartCatalog.ts:32+KeepaSingleCharts.tsx:192生效
AC-EL-SRC-KS-005BSR×近月购买量档位双轴图双轴线BSR×月销档keepa-single-bsr-sold 目录项;bsr_current×monthly_sold 双轴, 主轴 invert(构建 KeepaSingleCharts.tsx 196-206)chartCatalog.ts:33+KeepaSingleCharts.tsx:196生效
AC-EL-SRC-KS-00630/90/180/365天Sales Rank Drops对比柱图drops 四窗对比keepa-single-rank-drops 目录项;drops30/90/180/365 四柱(构建 KeepaSingleCharts.tsx 207-217)chartCatalog.ts:34+KeepaSingleCharts.tsx:207生效
AC-EL-SRC-KS-007Amazon自营价历史线图price_amazon 单点近似keepa-single-amazon-price 目录项;当前单点; 非空点<3 降级快照摘要卡; keepa-history S.amazon 升级真曲线(单点构建 :219-233;升级路径 :97-111)chartCatalog.ts:35+KeepaSingleCharts.tsx:220生效
AC-EL-SRC-KS-008Marketplace New价历史线图price_new 单点近似keepa-single-new-price 目录项;同上降级规则; keepa-history S.new 升级(单点构建 :219-233;升级路径 :97-111)chartCatalog.ts:36+KeepaSingleCharts.tsx:221生效
AC-EL-SRC-KS-009Used价历史线图price_used 单点近似keepa-single-used-price 目录项;keepa-history S.used 升级(单点构建 :219-233;升级路径 :97-111)chartCatalog.ts:37+KeepaSingleCharts.tsx:222生效
AC-EL-SRC-KS-010List Price历史线图list_price 单点近似keepa-single-list-price 目录项;keepa-history S.list 升级(单点构建 :219-233;升级路径 :97-111)chartCatalog.ts:38+KeepaSingleCharts.tsx:223生效
AC-EL-SRC-KS-011BuyBox价历史线图buy_box 单点近似keepa-single-buybox-price 目录项;当前单点(无真时序升级项)(构建 :224)chartCatalog.ts:39+KeepaSingleCharts.tsx:224生效
AC-EL-SRC-KS-012New FBA最低价历史线图FBA 条件价keepa-single-new-fba-price 目录项;buy_box_is_fba?price_new:空(构建 :225)chartCatalog.ts:40+KeepaSingleCharts.tsx:225生效
AC-EL-SRC-KS-013New FBM含运费价历史线图FBM 条件价keepa-single-new-fbm-price 目录项;!buy_box_is_fba?price_new:空(构建 :226)chartCatalog.ts:41+KeepaSingleCharts.tsx:226生效
AC-EL-SRC-KS-014Warehouse/Refurbished/Collectible价历史空态卡恒无数据keepa-single-other-condition-prices 目录项;无构建器(:234 注释跳过), 卡渲染「无数据」。

2026-10-22 撤卡:目录项已从 chartCatalog 删除、卡不再渲染;原目录行号失效(构建 KeepaSingleCharts.tsx 234)
chartCatalog.ts:41+KeepaSingleCharts.tsx:234废止
AC-EL-SRC-KS-015二手各成色价格历史柱图used 单点keepa-single-used-condition-prices 目录项;price_used 单值柱(currency)(构建 KeepaSingleCharts.tsx 235-239)chartCatalog.ts:42+KeepaSingleCharts.tsx:235生效
AC-EL-SRC-KS-016Lightning/Prime/Deal事件时间线空态卡恒无数据keepa-single-deal-events 目录项;无构建器(:240 注释)。

2026-10-22 撤卡:目录项已从 chartCatalog 删除、卡不再渲染;原目录行号失效(构建 KeepaSingleCharts.tsx 240)
chartCatalog.ts:43+KeepaSingleCharts.tsx:240废止
AC-EL-SRC-KS-017Coupon与折扣历史空态卡恒无数据keepa-single-coupon-events 目录项;无构建器(:241 注释)。

2026-10-22 撤卡:目录项已从 chartCatalog 删除、卡不再渲染;原目录行号失效(构建 KeepaSingleCharts.tsx 241)
chartCatalog.ts:44+KeepaSingleCharts.tsx:241废止
AC-EL-SRC-KS-018New报价数量历史线图count_new 单点keepa-single-new-offer-count 目录项;当前单点线(构建 KeepaSingleCharts.tsx 242-246)chartCatalog.ts:43+KeepaSingleCharts.tsx:242生效
AC-EL-SRC-KS-019FBA/FBM报价数量历史柱图FBA vs FBMkeepa-single-fba-fbm-count 目录项;offer_fba/offer_fbm 双柱(蓝/橙)(构建 KeepaSingleCharts.tsx 247-255)chartCatalog.ts:44+KeepaSingleCharts.tsx:247生效
AC-EL-SRC-KS-020Used/Refurbished/Collectible报价数量历史柱图其他报价近似keepa-single-other-offer-count 目录项;total_offers−fba−fbm 近似三柱(构建 KeepaSingleCharts.tsx 256-266)chartCatalog.ts:45+KeepaSingleCharts.tsx:256生效
AC-EL-SRC-KS-021BuyBox卖家占位时间线柱图占位 0/1keepa-single-buybox-seller 目录项;buy_box_is_amazon/buy_box_is_fba 0/1 柱(构建 KeepaSingleCharts.tsx 267-276)chartCatalog.ts:46+KeepaSingleCharts.tsx:267生效
AC-EL-SRC-KS-022Amazon/第三方/空窗BuyBox持有结构环形三类 100/0keepa-single-buybox-holder-structure 目录项;Amazon/FBA 三方/FBM 三方 百分比环形(构建 KeepaSingleCharts.tsx 277-286)chartCatalog.ts:47+KeepaSingleCharts.tsx:277生效
AC-EL-SRC-KS-023各卖家报价历史空态卡恒无数据keepa-single-seller-offers 目录项;无构建器(:287 注释)。

2026-10-22 撤卡:目录项已从 chartCatalog 删除、卡不再渲染;原目录行号失效(构建 KeepaSingleCharts.tsx 287)
chartCatalog.ts:50+KeepaSingleCharts.tsx:287废止
AC-EL-SRC-KS-024Amazon可售/缺货/恢复事件事件图缺货事件keepa-single-amazon-availability 目录项;oos_amazon_30/90 → 缺货次数事件点(构建 KeepaSingleCharts.tsx 288-297)chartCatalog.ts:48+KeepaSingleCharts.tsx:288生效
AC-EL-SRC-KS-02530/90天缺货次数对比柱图实构两窗keepa-single-oos-windows 目录项;题称四窗, 源只有 oos_amazon_30/90 两柱(构建 KeepaSingleCharts.tsx 298-306)。

2026-10-22 图题对齐:目录题「30/90/180/365天缺货率对比」→「30/90天缺货次数对比」(chartCatalog.ts:49),实构未动
chartCatalog.ts:49+KeepaSingleCharts.tsx:298生效
AC-EL-SRC-KS-026评分历史线图rating 单点keepa-single-rating 目录项;keepa-history S.rating 升级(构建 KeepaSingleCharts.tsx 307-311)chartCatalog.ts:50+KeepaSingleCharts.tsx:307生效
AC-EL-SRC-KS-027评论数历史线图reviews 单点keepa-single-reviews 目录项;keepa-history S.reviews 升级(构建 KeepaSingleCharts.tsx 312-316)chartCatalog.ts:51+KeepaSingleCharts.tsx:312生效
AC-EL-SRC-KS-028评论增长速度柱图90 天增长keepa-single-review-growth 目录项;reviews−reviews_avg90 单柱(构建 KeepaSingleCharts.tsx 317-322)chartCatalog.ts:52+KeepaSingleCharts.tsx:317生效
AC-EL-SRC-KS-029父ASIN变化历史柱图(横)parent 占位keepa-single-parent-history 目录项;parent_asin 存在时占位横柱(构建 KeepaSingleCharts.tsx 323-327)chartCatalog.ts:53+KeepaSingleCharts.tsx:323生效
AC-EL-SRC-KS-030BSR参考类目/类目变化历史柱图(横)类目占位keepa-single-category-history 目录项;sales_rank_display_group 占位横柱(构建 KeepaSingleCharts.tsx 328-332)chartCatalog.ts:54+KeepaSingleCharts.tsx:328生效
AC-EL-SRC-KS-031变体结构及历史变化柱图(横)color/size 占位keepa-single-variation-history 目录项;颜色/尺寸占位横柱(构建 KeepaSingleCharts.tsx 333-340)chartCatalog.ts:55+KeepaSingleCharts.tsx:333生效
AC-EL-SRC-KS-032BSR Current/Avg90/Drops30/Drops90对比柱图(横)实构四柱keepa-single-window-comparison 目录项;题称五窗, 实构 Current/Avg90/Drops30/Drops90(构建 KeepaSingleCharts.tsx 341-351)。

2026-10-22 图题对齐:目录题「Current/Avg30/Avg90/Avg180/Avg365对比」→「BSR Current/Avg90/Drops30/Drops90对比」(chartCatalog.ts:56),实构未动
chartCatalog.ts:56+KeepaSingleCharts.tsx:341生效
AC-EL-SRC-KS-033当前价/List Price/竞争价格阈值对比柱图(横)三价对比keepa-single-price-threshold 目录项;price_new/list_price/buy_box 横柱(currency)(构建 KeepaSingleCharts.tsx 352-362)chartCatalog.ts:57+KeepaSingleCharts.tsx:352生效
AC-EL-SRC-KS-034BuyBox价→FBA费→佣金→毛利瀑布图瀑布价费毛利keepa-single-cost-waterfall 目录项;题称含尺寸重量, 实构 BuyBox−FBA费−佣金→毛利(构建 KeepaSingleCharts.tsx 363-376)。

2026-10-22 图题对齐:目录题「包装尺寸、重量、FBA费、佣金、成本瀑布图」→「BuyBox价→FBA费→佣金→毛利瀑布图」(chartCatalog.ts:58),实构未动
chartCatalog.ts:58+KeepaSingleCharts.tsx:363生效
AC-EL-SRC-KS-035图片/视频/A+/Features/变体数量内容资产图空态卡恒无数据keepa-single-content-assets 目录项;无构建器(:377 注释)。

2026-10-22 撤卡:目录项已从 chartCatalog 删除、卡不再渲染;原目录行号失效(构建 KeepaSingleCharts.tsx 377)
chartCatalog.ts:62+KeepaSingleCharts.tsx:377废止
AC-EL-SRC-KS-036每日评分 × 评论数散点评分×评论keepa-single-daily-rating-review 目录项;rating×reviews 单点散点(构建 KeepaSingleCharts.tsx 378-382)chartCatalog.ts:59+KeepaSingleCharts.tsx:378生效
AC-EL-SRC-KS-037每日排名 BSR线图BSR 单点keepa-single-daily-bsr 目录项;bsr_current 单点 invert(构建 KeepaSingleCharts.tsx 383-387)chartCatalog.ts:60+KeepaSingleCharts.tsx:383生效
AC-EL-SRC-KS-038每日 BSR × 近月购买量档位散点BSR×月销档keepa-single-daily-bsr-sold 目录项;bsr_current×monthly_sold 散点 xInvert(构建 KeepaSingleCharts.tsx 388-392)chartCatalog.ts:61+KeepaSingleCharts.tsx:388生效
AC-EL-SRC-KS-039近月购买量档位历史线图月销档单点keepa-single-monthly-sold-history 目录项;monthly_sold 单点线(构建 KeepaSingleCharts.tsx 393-397)chartCatalog.ts:62+KeepaSingleCharts.tsx:393生效
AC-EL-SRC-KP-001新品价格分布柱图price_new 分桶keepa-pool-new-price-distribution 目录项;桶界 [0,10,20,30,50,80,120,200], 空桶剔除(构建 KeepaPoolCharts.tsx 53-61)chartCatalog.ts:66+KeepaPoolCharts.tsx:53生效
AC-EL-SRC-KP-002品牌/父体价格箱线图箱线品牌价箱线keepa-pool-brand-parent-price-boxplot 目录项;按 brand 聚 price_new, top12 品牌(构建 KeepaPoolCharts.tsx 62-75)chartCatalog.ts:67+KeepaPoolCharts.tsx:62生效
AC-EL-SRC-KP-003近月购买量档位分布柱图月销档分桶keepa-pool-monthly-sold-distribution 目录项;桶界 [0,100,300,1000,3000,10000,30000](构建 KeepaPoolCharts.tsx 76-84)chartCatalog.ts:68+KeepaPoolCharts.tsx:76生效
AC-EL-SRC-KP-004BSR分布柱图(横)BSR 分桶keepa-pool-bsr-distribution 目录项;桶界 [0,1000,5000,20000,80000,200000,500000](构建 KeepaPoolCharts.tsx 85-93)chartCatalog.ts:69+KeepaPoolCharts.tsx:85生效
AC-EL-SRC-KP-005评论数分布柱图reviews 分桶keepa-pool-reviews-distribution 目录项;桶界 [0,10,50,200,1000,5000,20000](构建 KeepaPoolCharts.tsx 94-102)chartCatalog.ts:70+KeepaPoolCharts.tsx:94生效
AC-EL-SRC-KP-006评分分布柱图评分分桶keepa-pool-rating-distribution 目录项;rating×10 桶界 30-48, 标签回除 10(3.0-4.8)(构建 KeepaPoolCharts.tsx 103-111)chartCatalog.ts:71+KeepaPoolCharts.tsx:103生效
AC-EL-SRC-KP-007报价数量分布柱图offers 分桶keepa-pool-offer-distribution 目录项;total_offers 桶界 [0,1,3,5,10,20,50](构建 KeepaPoolCharts.tsx 112-120)chartCatalog.ts:72+KeepaPoolCharts.tsx:112生效
AC-EL-SRC-KP-008FBA/FBM/Amazon报价结构环形三和环形keepa-pool-fulfilment-structure 目录项;offer_fba/offer_fbm 总和+自营计数(求和口径, 非互斥)(构建 KeepaPoolCharts.tsx 121-133)chartCatalog.ts:73+KeepaPoolCharts.tsx:121生效
AC-EL-SRC-KP-009BuyBox类型分布环形(%)三类互斥keepa-pool-buybox-type 目录项;自营/FBA 三方/FBM 三方 百分比(构建 KeepaPoolCharts.tsx 134-149)chartCatalog.ts:74+KeepaPoolCharts.tsx:134生效
AC-EL-SRC-KP-010BuyBox自营锁定程度分布环形(%)自营占比keepa-pool-amazon-lock 目录项;buy_box_is_amazon 计数/总数(构建 KeepaPoolCharts.tsx 150-160)chartCatalog.ts:75+KeepaPoolCharts.tsx:150生效
AC-EL-SRC-KP-011品牌ASIN数量分布柱图(横)品牌 top12keepa-pool-brand-count 目录项;按 brand 计数降序 top12(缺品牌记「未返回」)(构建 KeepaPoolCharts.tsx 161-168)chartCatalog.ts:76+KeepaPoolCharts.tsx:161生效
AC-EL-SRC-KP-012制造商ASIN数量分布柱图(横)厂商 top12keepa-pool-manufacturer-count 目录项;按 manufacturer 计数降序 top12(构建 KeepaPoolCharts.tsx 169-176)chartCatalog.ts:77+KeepaPoolCharts.tsx:169生效
AC-EL-SRC-KP-013父体与子体数量分布柱图子体分桶keepa-pool-parent-count 目录项;按 parent_asin 聚合, 桶 1/3/5/10/20 子体(构建 KeepaPoolCharts.tsx 177-187)chartCatalog.ts:78+KeepaPoolCharts.tsx:177生效
AC-EL-SRC-KP-014类目树矩形图树图类目计数keepa-pool-category-treemap 目录项;sales_rank_reference‖root_category 计数 treemap(构建 KeepaPoolCharts.tsx 188-195)chartCatalog.ts:79+KeepaPoolCharts.tsx:188生效
AC-EL-SRC-KP-015价格×购买量档位散点图散点价×月销档keepa-pool-price-sold 目录项;price_new×monthly_sold, 点=ASIN(构建 KeepaPoolCharts.tsx 196-203)chartCatalog.ts:80+KeepaPoolCharts.tsx:196生效
AC-EL-SRC-KP-016BSR×购买量档位散点图散点BSR×月销档keepa-pool-bsr-sold 目录项;bsr_current×monthly_sold, xInvert(构建 KeepaPoolCharts.tsx 204-211)chartCatalog.ts:81+KeepaPoolCharts.tsx:204生效
AC-EL-SRC-KP-017评论数×购买量档位散点图散点评论×月销档keepa-pool-reviews-sold 目录项;reviews×monthly_sold(构建 KeepaPoolCharts.tsx 212-219)chartCatalog.ts:82+KeepaPoolCharts.tsx:212生效
AC-EL-SRC-KP-018价格×BSR散点图散点价×BSRkeepa-pool-price-bsr 目录项;price_new×bsr_current, yInvert(构建 KeepaPoolCharts.tsx 220-227)chartCatalog.ts:83+KeepaPoolCharts.tsx:220生效
AC-EL-SRC-KP-019评分×购买量档位散点图散点评分×月销档keepa-pool-rating-sold 目录项;rating×monthly_sold(构建 KeepaPoolCharts.tsx 228-235)chartCatalog.ts:84+KeepaPoolCharts.tsx:228生效
AC-EL-SRC-KP-020FBA费/佣金/毛利空间对比柱图(横)毛利空间keepa-pool-fee-headroom 目录项;buy_box−fba_pick_pack_fee−佣金, top12 ASIN(currency)(构建 KeepaPoolCharts.tsx 236-248)chartCatalog.ts:85+KeepaPoolCharts.tsx:236生效
AC-EL-SRC-KP-021缺货率×BuyBox锁定×报价结构矩阵热力3 指标矩阵keepa-pool-oos-buybox-offers 目录项;top12 ASIN × [缺货30,BB自营,总报价](构建 KeepaPoolCharts.tsx 249-260)chartCatalog.ts:86+KeepaPoolCharts.tsx:249生效
AC-EL-SRC-KP-022ASIN×6字段覆盖热力图(Top12)热力覆盖 0/1keepa-pool-coverage-freshness 目录项;题称新鲜度, 实构=6 字段覆盖 0/1(bsr/price/rating/reviews/offers/monthly_sold), 无时间维(构建 KeepaPoolCharts.tsx 261-276)。

2026-10-22 图题对齐:目录题「ASIN×字段覆盖×数据新鲜度热力图」→「ASIN×6字段覆盖热力图(Top12)」(chartCatalog.ts:87),实构未动
chartCatalog.ts:87+KeepaPoolCharts.tsx:261生效
AC-EL-SRC-JT-001SFR×同参考类目Top3 BSR中位数双轴线SFR×BSR 中位joint-sfr-bsr 目录项;SFR 序列 × 每月 Top3 asin bsr_current 中位, 双轴双 invert(构建 JointCharts.tsx :84-105,fieldMap :85-89;死数组 sfrVsKeepa :67-74 不在此图路径。

2026-10-22:死数组已删除,行号平移为构建 :76-97、fieldMap :77-81)
chartCatalog.ts:91+JointCharts.tsx:76生效
AC-EL-SRC-JT-002SFR×Top3购买量档位中位数双轴线SFR×月销中位joint-sfr-sold 目录项;同上, field=monthly_sold(构建 JointCharts.tsx 76-104)chartCatalog.ts:92+JointCharts.tsx:76生效
AC-EL-SRC-JT-003SFR×Top3价格中位数双轴线SFR×价中位joint-sfr-price 目录项;field=price_new(构建 JointCharts.tsx 76-104)chartCatalog.ts:93+JointCharts.tsx:76生效
AC-EL-SRC-JT-004SFR×Top3报价数量双轴线SFR×报价中位joint-sfr-offers 目录项;field=total_offers(构建 JointCharts.tsx 76-104)chartCatalog.ts:94+JointCharts.tsx:76生效
AC-EL-SRC-JT-005SFR×Top3评论数中位双轴线实构存量joint-sfr-review-growth 目录项;题称评论增长, fieldMap 用 reviews 存量中位(非差值)(构建 JointCharts.tsx 76-104)。

2026-10-22 图题对齐:目录题「SFR×Top3评论增长」→「SFR×Top3评论数中位」(chartCatalog.ts:95),实构未动
chartCatalog.ts:95+JointCharts.tsx:76生效
AC-EL-SRC-JT-006SFR×Top3缺货率双轴线SFR×缺货中位joint-sfr-oos 目录项;field=oos_amazon_30(构建 JointCharts.tsx 76-104)chartCatalog.ts:96+JointCharts.tsx:76生效
AC-EL-SRC-JT-007Top1点击份额×同ASIN BSR散点份额×BSRjoint-top1-click-bsr 目录项;asin_1_click_share×该 ASIN bsr_current, yInvert(构建 JointCharts.tsx 98-120)chartCatalog.ts:97+JointCharts.tsx:98生效
AC-EL-SRC-JT-008Top1成交份额×同ASIN BSR散点份额×BSRjoint-top1-conversion-bsr 目录项;asin_1_conv_share×bsr_current(构建 JointCharts.tsx 113-135)chartCatalog.ts:98+JointCharts.tsx:113生效
AC-EL-SRC-JT-009Top1点击份额×同ASIN价格散点实构点击joint-top1-share-price 目录项;题称点击/成交两系, 实构仅点击系渲染(成交点集计算未用)(构建 JointCharts.tsx 128-151)。

2026-10-22 图题对齐:目录题「Top1点击/成交份额×同ASIN价格」→「Top1点击份额×同ASIN价格」(chartCatalog.ts:99),实构未动;ptsConv 死计算已删(渲染不变)
chartCatalog.ts:99+JointCharts.tsx:128生效
AC-EL-SRC-JT-010Top3点击集中度×品牌数散点集中×品牌数joint-concentration-structure 目录项;top3_click_share×当月 Top3 去重品牌数, y 实构仅品牌数(题称含父体数)(构建 JointCharts.tsx 143-166)。

2026-10-22 图题对齐:目录题「Top3点击集中度×品牌数/父体数」→「Top3点击集中度×品牌数」(chartCatalog.ts:100),实构未动
chartCatalog.ts:100+JointCharts.tsx:143生效
AC-EL-SRC-JT-011点击份额×BSR散点全池散点joint-click-bsr 目录项;rotation click_share×bsr_current(构建 JointCharts.tsx 158-178)chartCatalog.ts:101+JointCharts.tsx:158生效
AC-EL-SRC-JT-012成交份额×BSR散点全池散点joint-conversion-bsr 目录项;conv_share×bsr_current(构建 JointCharts.tsx 158-178)chartCatalog.ts:102+JointCharts.tsx:158生效
AC-EL-SRC-JT-013点击份额×购买量档位散点全池散点joint-click-sold 目录项;click_share×monthly_sold(构建 JointCharts.tsx 170-190)chartCatalog.ts:103+JointCharts.tsx:170生效
AC-EL-SRC-JT-014成交份额×购买量档位散点全池散点joint-conversion-sold 目录项;conv_share×monthly_sold(构建 JointCharts.tsx 170-190)chartCatalog.ts:104+JointCharts.tsx:170生效
AC-EL-SRC-JT-015点击份额×价格散点全池散点joint-click-price 目录项;click_share×price_new(yCurrency)(构建 JointCharts.tsx 182-202)chartCatalog.ts:105+JointCharts.tsx:182生效
AC-EL-SRC-JT-016成交份额×价格散点全池散点joint-conversion-price 目录项;conv_share×price_new(构建 JointCharts.tsx 182-202)chartCatalog.ts:106+JointCharts.tsx:182生效
AC-EL-SRC-JT-017点击-成交份额差×评论数散点差×评论joint-gap-reviews 目录项;click−conv 差×reviews(构建 JointCharts.tsx 194-215)chartCatalog.ts:107+JointCharts.tsx:194生效
AC-EL-SRC-JT-018点击-成交份额差×评分散点差×评分joint-gap-rating 目录项;click−conv 差×rating(构建 JointCharts.tsx 207-228)chartCatalog.ts:108+JointCharts.tsx:207生效
AC-EL-SRC-JT-019ABA份额×BuyBox持有结构堆叠(%)份额×持有joint-share-buybox 目录项;(自营数/3)×top3_click_share 三系百分比堆叠(构建 JointCharts.tsx 220-253)chartCatalog.ts:109+JointCharts.tsx:220生效
AC-EL-SRC-JT-020ABA份额×缺货率双轴线份额×缺货joint-share-oos 目录项;top3 份额 × 当月 Top3 oos30 中位(构建 JointCharts.tsx 245-266)chartCatalog.ts:110+JointCharts.tsx:245生效
AC-EL-SRC-JT-021ABA份额变化×价格变化双轴线相邻月差joint-share-change-price 目录项;top3 份额差 × price_new 中位差(构建 JointCharts.tsx 258-300)chartCatalog.ts:111+JointCharts.tsx:258生效
AC-EL-SRC-JT-022ABA份额变化×BSR变化双轴线相邻月差joint-share-change-bsr 目录项;bsr_current 中位差(构建 JointCharts.tsx 258-300)chartCatalog.ts:112+JointCharts.tsx:258生效
AC-EL-SRC-JT-023ABA份额变化×购买量档位变化双轴线相邻月差joint-share-change-sold 目录项;monthly_sold 中位差(构建 JointCharts.tsx 258-300)chartCatalog.ts:113+JointCharts.tsx:258生效
AC-EL-SRC-JT-024ABA份额变化×评论增长双轴线相邻月差joint-share-change-reviews 目录项;reviews 中位差(构建 JointCharts.tsx 258-300)chartCatalog.ts:114+JointCharts.tsx:258生效
AC-EL-SRC-JT-025ABA份额变化×报价数量变化双轴线相邻月差joint-share-change-offers 目录项;total_offers 中位差(构建 JointCharts.tsx 258-300)chartCatalog.ts:115+JointCharts.tsx:258生效
AC-EL-SRC-JT-026ASIN进入Top3前后事件图事件图进入事件joint-entry-event 目录项;first_period 进入标记; last≠first 加「最后上榜」(构建 JointCharts.tsx 292-314)chartCatalog.ts:116+JointCharts.tsx:292生效
AC-EL-SRC-JT-027ASIN退出Top3前后事件图事件图退出事件joint-exit-event 目录项;last_period≠末月 → 退出事件(构建 JointCharts.tsx 306-323)chartCatalog.ts:117+JointCharts.tsx:306生效
AC-EL-SRC-JT-028促销/降价/BuyBox换手叠加ABA份额双轴线BuyBox 近似joint-promotion-overlay 目录项;无促销数据, 用当月自营 BuyBox 计数近似(:324 注释)(构建 JointCharts.tsx 315-335)chartCatalog.ts:118+JointCharts.tsx:315生效
AC-EL-SRC-JT-029月份间Top1/2/3席位流转桑基图桑基席位流转joint-slot-sankey 目录项;相邻月席位变化; 反向边防环+links≤80 上限(构建 JointCharts.tsx 327-368)chartCatalog.ts:119+JointCharts.tsx:327生效
AC-EL-SRC-JT-030选定月份ASIN证据矩阵热力末月证据joint-evidence-matrix 目录项;末个 available 月 Top≤10 ASIN × 7 字段(BSR/月销/价格/评分×100/评论/FBA/FBM)(构建 JointCharts.tsx 360-389)chartCatalog.ts:120+JointCharts.tsx:360生效
AC-EL-SRC-JT-031ABA×Keepa相关性与领先滞后矩阵热力lag 相关系数joint-correlation-lag 目录项;5 字段 × lag0/1/2 皮尔逊 r, n≥3 才算(构建 JointCharts.tsx 381-420)chartCatalog.ts:121+JointCharts.tsx:381生效
AC-EL-SRC-JT-032ABA月份×Keepa观察时间×字段覆盖热力图热力覆盖数joint-observation-coverage 目录项;月份 × rot≤10 ASIN 的 5 字段覆盖数(0-5)(构建 JointCharts.tsx 412-440)chartCatalog.ts:122+JointCharts.tsx:412生效
AC-EL-SRC-JT-033品牌Top3席位分布与垄断度环形席位加权joint-brand-seat-share 目录项;按 brand 累加 appearances, top12(构建 JointCharts.tsx 432-451)chartCatalog.ts:123+JointCharts.tsx:432生效
AC-EL-SRC-JT-034品牌×月份Top3席位堆叠堆叠品牌×月joint-brand-month-stack 目录项;top12 品牌每月 Top3 席位计数堆叠(构建 JointCharts.tsx 443-464)chartCatalog.ts:124+JointCharts.tsx:443生效

§11.40 站外推广子组件列级(/offsitepromotion · AC-EL-OFC 系列,源码 web/app/offsitepromotion/{InboxTab,OverviewTab,SegmentsTab,ResourcesTab,RedditTab,ProjectsTab,LibraryTab,TemplatesTab,MailboxesTab,SendTasksTab,TasksTab}.tsx)

§11.37 面板级 65 条(OFF-001..065)之列级深化:11 子组件+InboxTab 面板内部逐元素建档——每列一条(表头原文+渲染口径)、每端点一条(方法+路径+载荷/响应字段)、每交互元素一条;行号以 2026-10-22 源码为准(LibraryTab 405/TemplatesTab 266/MailboxesTab 264/SendTasksTab 245/TasksTab 333 行,含末空行口径)。两个建档 fork(cw-off1=139:INB63/OVR14/SEG21/RES20/RDT21;cw-off2=307:PRJ64/LIB59/TPL34/MBX30/SND39/TSK81)+ 独立只读校对 fork 核验。OFF-053/064 挂账据此清账。

§11.40 站外推广子组件·列级/元素级·收件工作台 InboxTab(/offsitepromotion · AC-EL-OFC-INB 系列,源码 web/app/offsitepromotion/InboxTab.tsx)

收件工作台=待处理队列卡+会话弹层+规则弹层三块(容器 :80/:178-184/:319-323);队列数据 GET /api/promotion/inbox(:65,chips 查询串+page+page_size=20),存在未处理件时 15s 轮询(:70-75);会话/档案/模板 thread/kol-profile/email-templates 三 GET(:146/:148/:154)+ 认领/改类/标已处理/原箱回复四 POST(:209/:218/:221/:170);规则包 CRUD 四端点(:288/:297/:307/:315)。分类标签映射 CLS_LABELS(:34-37)、色调 CLS_TONE(:38-41)为标签/徽章统一事实源。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-INB-001待处理回复卡头容器队列卡标题h2「待处理回复」+sub「IMAP 每 10 分钟拉取 · 规则引擎自动分类 · 复核/认领/回复」;InboxTab.tsx:82InboxTab.tsx:82 读源断言标题与 sub 文案逐字生效
AC-EL-OFC-INB-002待处理队列加载端点队列列表数据源GET /api/promotion/inbox?{chip.q}&page={page}&page_size=20→{total,items};chip 切换或翻页即重载;存在 !handled 件时 setInterval 15s 轮询(worker 每 10 分钟拉收信);InboxTab.tsx:64-69,70-75InboxTab.tsx:65 读源断言查询串拼装与 page_size=20、:73 轮询 15000ms生效
AC-EL-OFC-INB-003分类中文标签映射标签分类码→中文CLS_LABELS:dsn=退信/agree=同意合作/sample=索要样品/quote=索要报价/decline=拒绝合作/irrelevant=无关/manual_review=待人工;未知码原样显示;InboxTab.tsx:34-37InboxTab.tsx:34-37 读源比对 7 组映射生效
AC-EL-OFC-INB-004分类徽章色调映射标签分类徽章配色CLS_TONE:dsn=bad/agree·sample·quote=ok/decline·manual_review=warn/irrelevant=dim;InboxTab.tsx:38-41InboxTab.tsx:38-41 读源比对色调表生效
AC-EL-OFC-INB-005队列筛选 chip 组选择器9 枚单选筛选CHIPS 逐项:待人工 classified=manual_review&handled=0、未匹配 matched=0&handled=0、同意合作 classified=agree&handled=0、索要样品 classified=sample&handled=0、索要报价 classified=quote&handled=0、拒绝合作 classified=decline&handled=0、退信 classified=dsn、无关 classified=irrelevant、全部 q="";选中态 class on,切换重置回第 1 页;InboxTab.tsx:42-52,84-87InboxTab.tsx:42-52 读源比对 9 项 label+q 逐字生效
AC-EL-OFC-INB-006分类规则入口按钮按钮打开规则弹层「分类规则」ghost sm 按钮→setRulesOpen(true) 渲染 RulesModal;InboxTab.tsx:89InboxTab.tsx:89 读源断言按钮文案与开关行为生效
AC-EL-OFC-INB-007队列列·发件人列表头「发件人」单元格 m.from,空显「—」;InboxTab.tsx:94,101InboxTab.tsx:94,101 读源断言表头原文与空值兜底生效
AC-EL-OFC-INB-008队列列·主题列表头「主题」单元格 m.subject,空显「(无主题)」;InboxTab.tsx:94,102InboxTab.tsx:94,102 读源断言表头与空值文案生效
AC-EL-OFC-INB-009队列列·分类列表头「分类」badge 类名=CLS_TONE[classified_as]||dim,文本=CLS_LABELS[classified_as]||原码;InboxTab.tsx:94,103-104InboxTab.tsx:103-104 读源断言双 fallback 链生效
AC-EL-OFC-INB-010队列列·置信度列表头「置信度」num 列,confidence!=null 显 toFixed(2) 两位小数,否则「—」;InboxTab.tsx:94,105InboxTab.tsx:105 读源断言 toFixed(2) 与空值生效
AC-EL-OFC-INB-011队列列·达人列表头「达人」三级显示:kol_name → kol_id 显「#id」→ badge warn「未匹配」;InboxTab.tsx:94,106-107InboxTab.tsx:106-107 读源断言三级 fallback生效
AC-EL-OFC-INB-012队列列·时间列表头「时间」received_at 截前 16 位、T 换空格(YYYY-MM-DD HH:mm),空显「—」;InboxTab.tsx:94,108InboxTab.tsx:108 读源断言 slice(0,16)+replace生效
AC-EL-OFC-INB-013队列列·状态列表头「状态」handled 显「已处理」否则「待处理」;未处理整行 fontWeight 600 加粗;InboxTab.tsx:94,100,109InboxTab.tsx:100,109 读源断言文案与加粗条件生效
AC-EL-OFC-INB-014队列行选中按钮行点击开会话tr onClick=setId 选中行背景 var(--bg2,#f6f7f9)、cursor pointer;选中后渲染 ThreadPanel;InboxTab.tsx:98-100,127InboxTab.tsx:98-99 读源断言选中样式与 setSel生效
AC-EL-OFC-INB-015队列空态空态队列为空行items 空数组时 colSpan 7 居中行「队列为空(worker 每 10 分钟拉取未读邮件,未匹配/置信度不足的会进「待人工」)」;InboxTab.tsx:112-115InboxTab.tsx:113-114 读源断言空态文案逐字生效
AC-EL-OFC-INB-016队列加载态空态加载占位行items==null 时 colSpan 7 居中「加载中…」;InboxTab.tsx:116InboxTab.tsx:116 读源断言加载占位生效
AC-EL-OFC-INB-017队列分页计数标签pager 计数「共 {int(total)} 封 · 第 {page} / {pages} 页」,pages=ceil(total/20) 下限 1;InboxTab.tsx:77,120-121InboxTab.tsx:77,121 读源断言计数式生效
AC-EL-OFC-INB-018队列翻页按钮按钮上一页/下一页page≤1 禁用上一页、page≥pages 禁用下一页;InboxTab.tsx:122-123InboxTab.tsx:122-123 读源断言双侧 disabled 边界生效
AC-EL-OFC-INB-019会话弹层容器容器ThreadPanel 弹层fixed 遮罩 rgba(16,20,26,.45) 点遮罩关闭(内层 stopPropagation);卡宽 min(1100px,96vw) 双栏 1fr+250px(会话/回复左、档案右);标题「会话视图」+sub「邮件 #{mid} · 全部往来挂达人档案」;InboxTab.tsx:178-186InboxTab.tsx:179-186 读源断言遮罩关闭与双栏结构生效
AC-EL-OFC-INB-020会话线程加载端点thread 数据源GET /api/promotion/inbox/{mid}/thread→{kol_id,items};InboxTab.tsx:145-152InboxTab.tsx:146 读源断言路径与响应字段生效
AC-EL-OFC-INB-021达人档案加载端点profile 数据源GET /api/promotion/inbox/kol/{kol_id}/profile,仅 thread 响应 kol_id 非空时请求,失败置 null 不报错;InboxTab.tsx:147-149InboxTab.tsx:147-149 读源断言条件请求与静默失败生效
AC-EL-OFC-INB-022模板列表加载端点回复模板下拉源GET /api/promotion/email-templates→{items}(弹层挂载时一次),失败静默;InboxTab.tsx:153-155InboxTab.tsx:154 读源断言路径与静默 catch生效
AC-EL-OFC-INB-023会话气泡流容器往来消息列表direction=out 右对齐底色 var(--ok-bg,#e8f5ee),其余左对齐 var(--bg2,#f1f3f6);气泡头行=「我方/发件人 · 时间 · 分类中文」;主体主题+正文(pre-wrap);空线程显「无记录」;InboxTab.tsx:187-201InboxTab.tsx:188-200 读源断言双底色与头行拼接生效
AC-EL-OFC-INB-024认领达人输入输入未匹配认领框条件渲染 data.kol_id==null;input placeholder「认领达人ID」maxWidth 130;InboxTab.tsx:203-207InboxTab.tsx:203-207 读源断言条件与 placeholder生效
AC-EL-OFC-INB-025认领按钮按钮绑定达人「认领」busy 或 ID 空白禁用;成功 toast「已执行」并刷新线程+队列;InboxTab.tsx:208-209InboxTab.tsx:208-209 读源断言 disabled 条件生效
AC-EL-OFC-INB-026认领提交端点claim 通道POST /api/promotion/inbox/{mid}/claim body {kol_id:Number(claimId)};InboxTab.tsx:209InboxTab.tsx:209 读源断言路径与数值化载荷生效
AC-EL-OFC-INB-027复核改类选择器选择器改类下拉首项「复核改类…」(值空)+CLS_LABELS 全 7 类选项;InboxTab.tsx:213-216InboxTab.tsx:213-216 读源断言 8 项选项生效
AC-EL-OFC-INB-028改类并结单按钮按钮提交改类「改类并结单」busy 或未选类禁用,成功后清空选择;InboxTab.tsx:217-219InboxTab.tsx:217-219 读源断言 disabled 与 setCls("")生效
AC-EL-OFC-INB-029改类提交端点classify 通道POST /api/promotion/inbox/{mid}/classify body {classified_as:cls};InboxTab.tsx:218InboxTab.tsx:218 读源断言路径与载荷生效
AC-EL-OFC-INB-030标已处理按钮按钮人工结单「标已处理」ghost sm,仅 busy 禁用;InboxTab.tsx:220-221InboxTab.tsx:220-221 读源断言文案与禁用条件生效
AC-EL-OFC-INB-031标已处理提交端点handled 通道POST /api/promotion/inbox/{mid}/handled body {handled:true};InboxTab.tsx:221InboxTab.tsx:221 读源断言路径与载荷生效
AC-EL-OFC-INB-032从原箱回复卡容器回复表单卡内嵌卡 h2「从原箱回复」,含模板下拉+主题输入+正文 textarea+发送/关闭;InboxTab.tsx:224-242InboxTab.tsx:224-242 读源断言卡结构与标题生效
AC-EL-OFC-INB-033回复模板选择器选择器模板/手写首项「手写」(值空)+email-templates 全列 name;选模板后正文 placeholder 变「选模板后发送时按达人变量渲染」;InboxTab.tsx:227-230,235InboxTab.tsx:227-230 读源断言选项来源与首项生效
AC-EL-OFC-INB-034回复主题输入输入邮件主题placeholder「主题(空=Re: 原主题)」,提交时 trim;InboxTab.tsx:231-232,171InboxTab.tsx:231 读源断言 placeholder 与空语义生效
AC-EL-OFC-INB-035回复正文输入输入textarea 正文minHeight 90,placeholder 手写态「回复正文…」;空正文提交被拦「正文不能为空」;InboxTab.tsx:234-236,167InboxTab.tsx:234-236 读源断言 placeholder 与前置校验生效
AC-EL-OFC-INB-036发送回复按钮按钮原箱发送「发送回复」busy 显「发送中…」;busy 或正文空禁用;成功 toast「已从原箱回复」并清空主题/正文、刷新;InboxTab.tsx:237-239,173InboxTab.tsx:238-239 读源断言 busy 文案与清空行为生效
AC-EL-OFC-INB-037回复提交端点reply 通道POST /api/promotion/inbox/{mid}/reply body {template_id:tplId?Number:null, subject:trim, body};InboxTab.tsx:166-176InboxTab.tsx:170-172 读源断言路径与三字段载荷生效
AC-EL-OFC-INB-038会话关闭按钮按钮关 ThreadPanel「关闭」ghost sm→onClose 清选中;InboxTab.tsx:240InboxTab.tsx:240 读源断言关闭行为生效
AC-EL-OFC-INB-039达人档案侧栏容器右侧档案栏标题「达人档案」;profile 空显「未匹配邮件无档案;认领后显示。」;InboxTab.tsx:245-272InboxTab.tsx:246,271 读源断言标题与空档案文案生效
AC-EL-OFC-INB-040档案·名/平台/粉丝标签档案头name 加粗 + platform,subscribers 非空追加「 · N 粉」(int 千分位);InboxTab.tsx:249-252InboxTab.tsx:249-252 读源断言拼接式生效
AC-EL-OFC-INB-041档案·邮箱/抑制标签联系方式行email||「无邮箱」,suppression=true 追加「 · 已抑制」;InboxTab.tsx:253-254InboxTab.tsx:253-254 读源断言兜底与抑制后缀生效
AC-EL-OFC-INB-042档案·回复状态/触达标签触达摘要行「回复状态:{reply_status||—} · 最近触达 {last_contacted_at 前 10 位||—}」;InboxTab.tsx:255-257InboxTab.tsx:256 读源断言文案式生效
AC-EL-OFC-INB-043档案·标签徽章标签tags 徽章列tags 前 12 枚 badge dim(字号 11),空显「无标签」;InboxTab.tsx:258-262InboxTab.tsx:259-261 读源断言 slice(0,12) 与空态生效
AC-EL-OFC-INB-044档案·发送历史标签历史任务列表标题「发送历史」;逐行「{task_name||任务#id} · {status} · {sent_at 前 10 位}」,sent_at 空省略;空显「无」;InboxTab.tsx:263-269InboxTab.tsx:264-268 读源断言行式与空态生效
AC-EL-OFC-INB-045规则包列表加载端点规则表数据源GET /api/promotion/classify-rules→{items},失败 toast 报错;InboxTab.tsx:287-291InboxTab.tsx:288 读源断言路径生效
AC-EL-OFC-INB-046规则列·优先级列表头「优先级」右对齐 num,数值原样;数字越小越先匹配;InboxTab.tsx:327,331InboxTab.tsx:327,331 读源断言表头与对齐生效
AC-EL-OFC-INB-047规则列·分类列表头「分类」badge 同队列分类列(CLS_TONE/CLS_LABELS+原码 fallback);InboxTab.tsx:327,332-333InboxTab.tsx:332-333 读源断言复用映射生效
AC-EL-OFC-INB-048规则列·类型列表头「类型」kind=regex 显「正则」否则「关键词」;InboxTab.tsx:327,334InboxTab.tsx:334 读源断言二值映射生效
AC-EL-OFC-INB-049规则列·词/正则列表头「词 / 正则」pattern 文本 maxWidth 260、title 悬浮全文;InboxTab.tsx:327,335InboxTab.tsx:335 读源断言 title 属性生效
AC-EL-OFC-INB-050规则列·状态列表头「状态」enabled 显「启用」否则「停用」;InboxTab.tsx:327,336InboxTab.tsx:336 读源断言二值文案生效
AC-EL-OFC-INB-051规则列·操作列表头「操作」启停切换按钮(文本随 enabled「停用/启用」)+「删除」按钮;InboxTab.tsx:327,337-340InboxTab.tsx:338-339 读源断言双按钮与切换文案生效
AC-EL-OFC-INB-052规则新增提交端点建规则通道POST /api/promotion/classify-rules body {priority:Number||100, classified_as, kind, pattern:trim, enabled:true};pattern 空被拦「词或正则不能为空」;InboxTab.tsx:293-304InboxTab.tsx:294-300 读源断言载荷与前置校验生效
AC-EL-OFC-INB-053规则·优先级输入输入新增优先级number 输入默认「100」,title「数字越小越先匹配」maxWidth 80;InboxTab.tsx:281,348-349InboxTab.tsx:348-349 读源断言默认值与 title生效
AC-EL-OFC-INB-054规则·分类选择器选择器新增分类6 选项:同意合作/索要样品/索要报价/拒绝合作/无关/退信(无 manual_review;规则匹配口径「无命中进『待人工』」见 :324);InboxTab.tsx:350-353InboxTab.tsx:351-352 读源断言 6 键枚举生效
AC-EL-OFC-INB-055规则·类型选择器选择器关键词/正则二选项 keyword=关键词/regex=正则;InboxTab.tsx:354-357InboxTab.tsx:355-356 读源断言二值生效
AC-EL-OFC-INB-056规则·pattern 输入输入词/正则输入placeholder「关键词或正则(正则须能编译)」;InboxTab.tsx:358-359InboxTab.tsx:359 读源断言 placeholder 逐字生效
AC-EL-OFC-INB-057规则·新增按钮按钮提交建规则「新增」busy 禁用,成功 toast「规则已加」并清空 pattern 刷新表;InboxTab.tsx:360,301InboxTab.tsx:360 读源断言文案与刷新链生效
AC-EL-OFC-INB-058规则启停提交端点改规则通道PUT /api/promotion/classify-rules/{id} body 全量 {priority, classified_as, kind, pattern, enabled:!原值};InboxTab.tsx:305-313InboxTab.tsx:307-310 读源断言全量载荷与翻转生效
AC-EL-OFC-INB-059规则启停按钮按钮启停切换文本随 enabled 显「停用/启用」ghost sm;InboxTab.tsx:338InboxTab.tsx:338 读源断言切换文案生效
AC-EL-OFC-INB-060规则删除提交端点删规则通道DELETE /api/promotion/classify-rules/{rid}(无 body),成功 toast「已删除」;InboxTab.tsx:314-317InboxTab.tsx:315 读源断言 DELETE 与无载荷生效
AC-EL-OFC-INB-061规则删除按钮按钮行内删除「删除」ghost sm,无二次确认(直接 DELETE);InboxTab.tsx:339InboxTab.tsx:339 读源断言无确认直删生效
AC-EL-OFC-INB-062规则加载态空态规则表占位items==null 时 colSpan 6「加载中…」;InboxTab.tsx:343InboxTab.tsx:343 读源断言占位生效
AC-EL-OFC-INB-063规则关闭按钮按钮关规则弹层「关闭」ghost sm→onClose;规则弹层卡宽 min(760px,94vw);InboxTab.tsx:322-323,361InboxTab.tsx:361 读源断言关闭行为生效

§11.40 站外推广子组件·列级/元素级·总览 OverviewTab(/offsitepromotion · AC-EL-OFC-OVR 系列,源码 web/app/offsitepromotion/OverviewTab.tsx)

总览=7 KPI 卡+渠道分布条形+两张说明卡;数字唯一源 GET /api/promotion/kol-stats(:32,邮箱三层口径:rows_total 含抑制/unique_emails 去重/personal_emails 扣公共角色邮箱),facets 自 kol-library?suppression=all&page_size=1(:30),渠道字典计数自 channel-dict(:34);未知/未上线一律显「—」不以 0 充数(:6 注释约束)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-OVR-001facets 加载端点渠道/类目 facet 源GET /api/promotion/kol-library?suppression=all&page_size=1 只取 facets;OverviewTab.tsx:29-31OverviewTab.tsx:30-31 读源断言仅取 facets生效
AC-EL-OFC-OVR-002统计加载端点KPI 数字唯一源GET /api/promotion/kol-stats→Stats 9 字段(rows_total/rows_with_email/unique_emails/role_emails/personal_emails/deal_kol_rows/deal_kol_emails/deal_channel_sites/deal_reddit_posters);OverviewTab.tsx:32-33,16-21OverviewTab.tsx:32-33 读源断言 9 字段消费生效
AC-EL-OFC-OVR-003渠道字典加载端点字典登记数GET /api/promotion/channel-dict 取 items.length,失败静默(脚注显「—」);OverviewTab.tsx:34-35OverviewTab.tsx:34-35 读源断言 length 与静默生效
AC-EL-OFC-OVR-004错误条容器API 失败提示err 非空显 div.error role=alert;OverviewTab.tsx:47OverviewTab.tsx:47 读源断言条件渲染生效
AC-EL-OFC-OVR-005KPI·达人总数标签库规模卡k-value=int(rows_total),未载显「—」;k-foot「企业达人库 · 含抑制名单」;OverviewTab.tsx:49-53OverviewTab.tsx:50-52 读源断言取值与脚注生效
AC-EL-OFC-OVR-006KPI·唯一收件邮箱标签去重邮箱卡值=unique_emails;foot「带邮箱记录 N 行 · 去重 P%」,P=round((1−unique/rows_with_email)×100)(分母 0 显「—」);OverviewTab.tsx:54-58,40-41OverviewTab.tsx:57,40-41 读源断言去重式与零分母兜底生效
AC-EL-OFC-OVR-007KPI·个人邮箱标签有效外联量卡值=personal_emails;foot「扣除公共/角色邮箱 N(info@/press@/noreply@ 等,占 Q%)」,Q=round(role/unique×100);OverviewTab.tsx:59-63,42-43OverviewTab.tsx:62,42-43 读源断言占比式生效
AC-EL-OFC-OVR-008KPI·Deal 资源标签deal 邮箱卡值=deal_kol_emails;foot「达人库 deal 类 N 行 · deal站 N · Reddit poster N」三子数;OverviewTab.tsx:64-68OverviewTab.tsx:66-67 读源断言三子数来源生效
AC-EL-OFC-OVR-009KPI·覆盖渠道标签平台数卡值=facets.platforms.length;foot「字典登记 N 项」(channel-dict 计数);OverviewTab.tsx:69-73OverviewTab.tsx:71-72 读源断言双来源生效
AC-EL-OFC-OVR-010KPI·自定义类目标签类目数卡值=categories.length;foot「已打标 Σcount 人次」;OverviewTab.tsx:74-78OverviewTab.tsx:76-77 读源断言 reduce 求和生效
AC-EL-OFC-OVR-011KPI·外联漏斗占位标签未上线卡值恒「—」(fontSize 19);foot「发送/回复/意向 P2 邮件基建投用后接入」;OverviewTab.tsx:79-83OverviewTab.tsx:80-82 读源断言恒「—」不上 0生效
AC-EL-OFC-OVR-012达人渠道分布条形图表Top12 CSS 条形h2「达人渠道分布」sub「Top 12 · 企业达人库现场聚合」;逐行 label||value/条宽 round(count/maxCount×100)% 下限 3/int(count);facets 空显「加载中…」、零行显「暂无数据」;CSS div 实现非 ECharts;OverviewTab.tsx:86-103,38-39OverviewTab.tsx:91-99 读源断言条宽式与下限 3生效
AC-EL-OFC-OVR-013Deal 资源怎么找卡容器三口径指引h2「Deal 资源怎么找」sub「三处口径 · 分别进入对应 tab 筛选」;正文 ①达人库 tab ②渠道库 ③Reddit 专库 三条路径文案;OverviewTab.tsx:105-112OverviewTab.tsx:107-111 读源断言三路径文案逐字生效
AC-EL-OFC-OVR-014待上线模块卡容器P2/P3 范围声明h2「待上线模块」;正文声明邮件外联/收件工作台/邮箱设置=P2 代码已就绪待投用、自动跟进与归因=P3、上线前显「—」不以 0 充数;OverviewTab.tsx:114-120OverviewTab.tsx:116-119 读源断言范围声明生效

§11.40 站外推广子组件·列级/元素级·分群 SegmentsTab(/offsitepromotion · AC-EL-OFC-SEG 系列,源码 web/app/offsitepromotion/SegmentsTab.tsx)

分群=筛选条件→POST 存 kol_id 快照;条件键与 kol-library 筛选同名(platforms/countries/cat_ids/contact/fmin/fmax,:4);facet 源 kol-library?page=1&page_size=1(:60);h2 sub「达人 ID 快照 · 发送时仍实时查 suppression + 30 天冷却」(:92)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-SEG-001分群列表加载端点分群表数据源GET /api/promotion/segments→{items},失败写入 error 条;SegmentsTab.tsx:53-58SegmentsTab.tsx:54-56 读源断言路径与错误通路生效
AC-EL-OFC-SEG-002分群 facet 加载端点条件 chip 源GET /api/promotion/kol-library?page=1&page_size=1 只取 facets,失败静默;SegmentsTab.tsx:59-62SegmentsTab.tsx:60-61 读源断言仅 facets生效
AC-EL-OFC-SEG-003分群名输入输入新建分群名placeholder「分群名」maxWidth 160,空名提交被拦「分群名必填」;SegmentsTab.tsx:95,67SegmentsTab.tsx:95 读源断言 placeholder 与必填生效
AC-EL-OFC-SEG-004渠道 chip 多选按钮platforms 条件facets.platforms 前 20 枚圆角 chip,文本「{label}({count})」,点击 toggle 选中态 on;SegmentsTab.tsx:96-102SegmentsTab.tsx:97-100 读源断言 slice(0,20) 与 toggle生效
AC-EL-OFC-SEG-005国家 chip 多选按钮countries 条件facets.countries 前 30 枚 chip,空值显「(空)」;SegmentsTab.tsx:104-111SegmentsTab.tsx:107-110 读源断言 slice(0,30) 与空值标签生效
AC-EL-OFC-SEG-006类目 chip 多选按钮cat_ids 条件facets.categories 全量 chip「{name}({count})」;SegmentsTab.tsx:112-116SegmentsTab.tsx:112-116 读源断言全量渲染生效
AC-EL-OFC-SEG-007联系方式选择器选择器contact 条件默认 email;选项「联系方式不限」+4 项:有邮箱/IM(无邮箱)/社交(无邮箱)/仅官网/无联系方式(CONTACT_LABELS);SegmentsTab.tsx:48,120-123,20-23SegmentsTab.tsx:120-123 读源断言默认值与 5 选项生效
AC-EL-OFC-SEG-008粉丝下限输入输入fmin 条件number 输入 placeholder「粉丝下限」maxWidth 110,空不进 criteria;SegmentsTab.tsx:124,75SegmentsTab.tsx:124 读源断言 placeholder 与可选生效
AC-EL-OFC-SEG-009粉丝上限输入输入fmax 条件number 输入 placeholder「粉丝上限」maxWidth 110;SegmentsTab.tsx:125,76SegmentsTab.tsx:125 读源断言 placeholder生效
AC-EL-OFC-SEG-010建分群按钮按钮提交创建「按条件建分群」busy 显「创建中…」;成功 toast「分群已创建:N 位达人」并清名刷新+onChanged 回调;SegmentsTab.tsx:126,79-80SegmentsTab.tsx:126,79-80 读源断言 busy 文案与回调链生效
AC-EL-OFC-SEG-011建分群提交端点创建通道POST /api/promotion/segments body {name:trim, criteria};criteria 仅收非空键:platforms/countries/cat_ids 逗号串、contact、fmin/fmax 数值(:70-76)→响应 {id,kol_count};SegmentsTab.tsx:66-82SegmentsTab.tsx:70-78 读源断言条件组装与响应消费生效
AC-EL-OFC-SEG-012成员口径说明标签建群脚注「成员 = 当前条件下有任一联系方式的达人;无邮箱者在发送时自动跳过」;SegmentsTab.tsx:127SegmentsTab.tsx:127 读源断言脚注逐字生效
AC-EL-OFC-SEG-013分群列·分群列表头「分群」单元格 name 加粗;SegmentsTab.tsx:132,136SegmentsTab.tsx:132,136 读源断言表头与样式生效
AC-EL-OFC-SEG-014分群列·筛选条件列表头「筛选条件」criteriaSummary(:25-36):渠道/国家/类目 #id/源类目/标签/联系式标签/粉丝≥≤ 空格点接,全空显「空条件(全库)」;SegmentsTab.tsx:132,137SegmentsTab.tsx:137,25-36 读源断言摘要式与全库文案生效
AC-EL-OFC-SEG-015分群列·成员数列表头「成员数」右对齐 num 显 member_n(快照人数)而非 kol_count(建群时点数);SegmentsTab.tsx:132,138SegmentsTab.tsx:138 读源断言取 member_n生效
AC-EL-OFC-SEG-016分群列·创建时间列表头「创建时间」created_at 原样;SegmentsTab.tsx:132,139SegmentsTab.tsx:139 读源断言原样显示生效
AC-EL-OFC-SEG-017分群列·操作列表头「操作」「删除」ghost sm 按钮;SegmentsTab.tsx:132,140SegmentsTab.tsx:140 读源断言按钮生效
AC-EL-OFC-SEG-018删除分群按钮按钮危险确认删除useConfirm 危险框「删除分群」「「{名}」?引用它的发送任务将无法取人。」确认才发;成功 toast「已删除」;SegmentsTab.tsx:84-88SegmentsTab.tsx:85 读源断言确认文案与 danger生效
AC-EL-OFC-SEG-019删除分群提交端点删除通道DELETE /api/promotion/segments/{sid}(无 body)+onChanged 回调;SegmentsTab.tsx:86SegmentsTab.tsx:86 读源断言 DELETE 与回调生效
AC-EL-OFC-SEG-020分群空态空态暂无分群行items 空数组 colSpan 5「暂无分群」;SegmentsTab.tsx:143SegmentsTab.tsx:143 读源断言空态文案生效
AC-EL-OFC-SEG-021分群加载态空态加载占位行items==null colSpan 5「加载中…」;SegmentsTab.tsx:144SegmentsTab.tsx:144 读源断言占位生效

§11.40 站外推广子组件·列级/元素级·资源 ResourcesTab(/offsitepromotion · AC-EL-OFC-RES 系列,源码 web/app/offsitepromotion/ResourcesTab.tsx,导出名 ResourcesPanel)

全部资源=渠道站+达人合库浏览;数据 GET /api/promotion/resources?rtype&platform&category&country&q&page&page_size=20(:30-32)带 facets 三组;列表按粉丝降序(h2 sub 声明 :46);筛选变更即重载且重置回第 1 页。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-RES-001资源列表加载端点合库数据源GET /api/promotion/resources 七参数(rtype/platform/category/country/q/page/page_size=20),平台/类目/国家/q 均 encodeURIComponent;失败置 null 显 Spinner;ResourcesTab.tsx:28-35ResourcesTab.tsx:30-33 读源断言参数拼装生效
AC-EL-OFC-RES-002资源卡头计数标签h2 动态总数「全部资源」sub「渠道站 + 达人 · 共 {int(total)} 条 · 按粉丝降序」,未载 total=undefined 显 0;ResourcesTab.tsx:46ResourcesTab.tsx:46 读源断言计数式生效
AC-EL-OFC-RES-003类型 tab 组选择器rtype 三选全部("")/渠道站(channel)/达人(kol),选中 on,切换回第 1 页;ResourcesTab.tsx:48-51ResourcesTab.tsx:48-51 读源断言三值生效
AC-EL-OFC-RES-004平台选择器选择器platform 筛选首项「全部平台」+facets.platforms「{value}({count})」,「(空)」值映射回 "";ResourcesTab.tsx:52-55ResourcesTab.tsx:54 读源断言空值映射生效
AC-EL-OFC-RES-005类目选择器选择器category 筛选首项「全部类目」+facets.categories,同空值映射;ResourcesTab.tsx:56-59ResourcesTab.tsx:58 读源断言选项源生效
AC-EL-OFC-RES-006国家选择器选择器country 筛选首项「全部国家」+facets.countries,同空值映射;ResourcesTab.tsx:60-63ResourcesTab.tsx:62 读源断言选项源生效
AC-EL-OFC-RES-007搜索输入输入q 名称/邮箱placeholder「搜索名称 / 邮箱」maxWidth 220,输入即筛(无防抖)且回第 1 页;ResourcesTab.tsx:64-65ResourcesTab.tsx:64-65 读源断言即时筛选生效
AC-EL-OFC-RES-008重置按钮按钮清全部筛选「重置」→rtype/platform/category/country/q 全清+回第 1 页;ResourcesTab.tsx:40-42,66ResourcesTab.tsx:41,66 读源断言五态清零生效
AC-EL-OFC-RES-009加载态空态Spinnerdata==null 显 Spinner 组件(每次筛选变更先置 null);ResourcesTab.tsx:29,69ResourcesTab.tsx:29,69 读源断言先清后载生效
AC-EL-OFC-RES-010无匹配空态空态EmptyStateitems 空显 EmptyState title「无匹配资源」hint「调整筛选条件」;ResourcesTab.tsx:70ResourcesTab.tsx:70 读源断言双文案生效
AC-EL-OFC-RES-011资源列·资源列表头「资源」name 单行省略 maxWidth 240;source_url 非空渲染 a 外链(新窗 noreferrer 品牌色)否则纯文本;ResourcesTab.tsx:75,81-83ResourcesTab.tsx:81-83 读源断言条件外链生效
AC-EL-OFC-RES-012资源列·类型列表头「类型」chip:rtype=kol 显「达人」(默认色)否则「渠道站」(dim);ResourcesTab.tsx:75,84ResourcesTab.tsx:84 读源断言二值与配色生效
AC-EL-OFC-RES-013资源列·平台列表头「平台」muted 显 platform,空「—」;ResourcesTab.tsx:75,85ResourcesTab.tsx:85 读源断言空值兜底生效
AC-EL-OFC-RES-014资源列·类目列表头「类目」t2 单行省略 maxWidth 140,空「—」;ResourcesTab.tsx:75,86ResourcesTab.tsx:86 读源断言省略与兜底生效
AC-EL-OFC-RES-015资源列·国家列表头「国家」muted 显 country,空「—」;ResourcesTab.tsx:75,87ResourcesTab.tsx:87 读源断言兜底生效
AC-EL-OFC-RES-016资源列·粉丝列表头「粉丝」右对齐 num;fmtK=followers!=null?toLocaleString("en-US")(千分位):「—」;ResourcesTab.tsx:75,88,37ResourcesTab.tsx:88,37 读源断言千分位与空值生效
AC-EL-OFC-RES-017资源列·活跃度列表头「活跃度」右对齐 num muted,activity!=null 显原值否则「—」;ResourcesTab.tsx:75,89ResourcesTab.tsx:89 读源断言空值兜底生效
AC-EL-OFC-RES-018资源列·联系方式列表头「联系方式」contact 含 @ 显 mailto 链接(取逗号前首个 trim)否则纯文本,空「—」;单行省略 maxWidth 200;ResourcesTab.tsx:75,90-92ResourcesTab.tsx:91 读源断言 mailto 取首地址生效
AC-EL-OFC-RES-019资源分页计数标签pager 计数「共 {int(total)} 条 · 第 {data.page} / {pages} 页」(当前页取响应 page);ResourcesTab.tsx:97-98ResourcesTab.tsx:98 读源断言响应页号消费生效
AC-EL-OFC-RES-020资源翻页按钮按钮上一页/下一页page≤1/page≥pages 双侧禁用;ResourcesTab.tsx:99-100ResourcesTab.tsx:99-100 读源断言边界禁用生效

§11.40 站外推广子组件·列级/元素级·Reddit 专库 RedditTab(/offsitepromotion · AC-EL-OFC-RDT 系列,源码 web/app/offsitepromotion/RedditTab.tsx)

Reddit 专库=919 万 reddit 达人只读浏览(:3 注释),不进达人库筛选/打标,触达=点达人名跳 Reddit 主页站内私信;数据 GET /api/promotion/kol-reddit(:37,参数 country/raw_cat/fmin/fmax/q/sort/page/page_size=20,fmin/fmax 空补 "0");昵称搜索为提交制(search→query,:71-72)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-RDT-001Reddit 列表加载端点专库数据源GET /api/promotion/kol-reddit?country&raw_cat&fmin&fmax&q&sort&page&page_size=20(URLSearchParams,fmin/fmax 空串补"0")→{total,page,page_size,items,facets,note};失败写 error 条;RedditTab.tsx:32-41RedditTab.tsx:33-39 读源断言参数表与补 0生效
AC-EL-OFC-RDT-002专库卡头计数标签h2 动态总数「Reddit 专库」sub「共 {int(total)} 位达人 · 仅站内联系方式,只读浏览」;RedditTab.tsx:53RedditTab.tsx:53 读源断言计数式逐字生效
AC-EL-OFC-RDT-003只读口径说明容器库定位文案说明段:Reddit 达人只有站内触达(私信/评论)无邮箱/IM/社交,单独成库不进筛选打标体系,点达人名跳主页发起私信;RedditTab.tsx:54-57RedditTab.tsx:55-57 读源断言口径文案生效
AC-EL-OFC-RDT-004错误条容器API 失败提示err 非空显 div.error role=alert;RedditTab.tsx:51RedditTab.tsx:51 读源断言条件渲染生效
AC-EL-OFC-RDT-005国家选择器选择器country 筛选首项「国家不限」+facets.countries「{value}({count})」;RedditTab.tsx:59-62RedditTab.tsx:60-61 读源断言选项源生效
AC-EL-OFC-RDT-006类目选择器选择器raw_cat 筛选首项「类目不限」+facets.raw_categories;RedditTab.tsx:63-66RedditTab.tsx:64-65 读源断言 facet 键名生效
AC-EL-OFC-RDT-007粉丝下限输入输入fmin 筛选number placeholder「粉丝下限」maxWidth 110,变更即筛回第 1 页;RedditTab.tsx:67-68RedditTab.tsx:67-68 读源断言即时筛选生效
AC-EL-OFC-RDT-008粉丝上限输入输入fmax 筛选number placeholder「粉丝上限」maxWidth 110;RedditTab.tsx:69-70RedditTab.tsx:69-70 读源断言即时筛选生效
AC-EL-OFC-RDT-009昵称搜索输入输入search 暂存框placeholder「昵称搜索」maxWidth 220;仅提交(form onSubmit)才写入 query 触发查询,输入本身不触发;RedditTab.tsx:71-73RedditTab.tsx:72-73 读源断言提交制搜索生效
AC-EL-OFC-RDT-010排序选择器选择器sort 二选followers=按粉丝数(默认)/name=按昵称;RedditTab.tsx:28,74-76RedditTab.tsx:28,75 读源断言默认值生效
AC-EL-OFC-RDT-011搜索按钮按钮提交搜索type=submit「搜索」→回第 1 页+query=search;RedditTab.tsx:72,77RedditTab.tsx:77 读源断言提交行为生效
AC-EL-OFC-RDT-012重置筛选按钮按钮清全部条件「重置筛选」→country/rawCat/fmin/fmax/search/query 全清+回第 1 页(sort 保留);RedditTab.tsx:43-46,109RedditTab.tsx:44-45 读源断言清空范围与 sort 不清生效
AC-EL-OFC-RDT-013Reddit 列·达人列表头「达人」name 渲染 a 外链 r.url(新窗 noreferrer 品牌色)——触达入口;RedditTab.tsx:89,94-96RedditTab.tsx:95 读源断言外链指向 r.url生效
AC-EL-OFC-RDT-014Reddit 列·粉丝列表头「粉丝」右对齐 num,subs!=null 显 int 千分位否则「—」;RedditTab.tsx:89,97RedditTab.tsx:97 读源断言千分位与空值生效
AC-EL-OFC-RDT-015Reddit 列·国家列表头「国家」muted 显 country,空「—」;RedditTab.tsx:89,98RedditTab.tsx:98 读源断言兜底生效
AC-EL-OFC-RDT-016Reddit 列·类目列表头「类目」muted 显 category,空「—」;RedditTab.tsx:89,99RedditTab.tsx:99 读源断言兜底生效
AC-EL-OFC-RDT-017Reddit 列·语言列表头「语言」muted 显 language,空「—」;RedditTab.tsx:89,100RedditTab.tsx:100 读源断言兜底生效
AC-EL-OFC-RDT-018Reddit 列·活跃度列表头「活跃度」右对齐 num,activity!=null 显原值否则「—」;RedditTab.tsx:89,101RedditTab.tsx:101 读源断言兜底生效
AC-EL-OFC-RDT-019Reddit 空态空态无匹配行items 空 colSpan 6「无匹配达人」padding 28;RedditTab.tsx:104RedditTab.tsx:104 读源断言空态文案生效
AC-EL-OFC-RDT-020Reddit 加载态空态加载占位!data && !err 显「加载中…」;RedditTab.tsx:83RedditTab.tsx:83 读源断言双条件占位生效
AC-EL-OFC-RDT-021Reddit 分页按钮计数+翻页「共 {int(total)} 条 · 第 {data.page} / {pages} 页」+上一页/下一页(page≤1/page≥pages 禁用);RedditTab.tsx:108-113RedditTab.tsx:110-112 读源断言计数与双侧禁用生效

OFF 列级·推广项目(/offsitepromotion 🚀推广项目 · AC-EL-OFC-PRJ 系列 64 条,源码 web/app/offsitepromotion/ProjectsTab.tsx 374 行)

ProjectsPanel(列表 :23-78)+ NewProjectForm(:81-112)+ ProjectDetail 达人工作台(:115-231)+ AddKols 勾选面板(:234-291)+ ContentEditor 文案抽屉(:294-374);面板级归属见 AC-EL-OFF-057,本批为面板内部逐元素/逐列。PK 状态五态 pending/ai_generated/edited/sent/ignored(PK_STATUS :18,中文 STATUS_LABEL :19-21)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-PRJ-001GET /api/promotion/projects端点项目列表加载挂载即拉(useEffect :34);响应 {items:Project[]};失败置空数组(:32)不报错读源 ProjectsTab.tsx:31-34生效
AC-EL-OFC-PRJ-002DELETE /api/promotion/projects/{id}端点删除项目危险确认 :37「该项目及其下所有达人关联与文案将一并删除。」;成功 toast「已删除」回列表重拉(:38-39)读源 ProjectsTab.tsx:36-40生效
AC-EL-OFC-PRJ-003POST /api/promotion/projects端点新建项目载荷 {name,product_link,discount_code,product_desc} 全 trim(:91);name 空前置拒绝 :88「项目名必填」读源 ProjectsTab.tsx:87-95生效
AC-EL-OFC-PRJ-004GET /api/promotion/projects/{id}/kols端点项目达人分页列表六参数 platform/contact_type/status/q/page/page_size=20(:129);响应 {total,items:Pk[]};任一筛选变化重查(依赖数组 :131);回第 1 页=各控件 onChange setPage(1) :174-186读源 ProjectsTab.tsx:127-132生效
AC-EL-OFC-PRJ-005POST /api/promotion/project-kols/{pkid}/status端点行内状态流转载荷 {status};行内下拉触发(:207-212);成功重拉列表(:134-137)读源 ProjectsTab.tsx:134-137生效
AC-EL-OFC-PRJ-006POST /api/promotion/projects/{id}/email/batch-send端点批量发送confirm :139「对项目内所有「有邮箱」达人批量发送?(SMTP 修复前会先落日志 pending)」;空 body;响应 {queued,note} → toast「已入队 N 封」(:141-142)读源 ProjectsTab.tsx:138-144生效
AC-EL-OFC-PRJ-007GET /api/promotion/projects/{id}/export端点导出 CSV响应 {filename,csv};前端 BOM+Blob 触发下载(:148-151);toast「已导出」读源 ProjectsTab.tsx:145-153生效
AC-EL-OFC-PRJ-008GET /api/promotion/kol?kind=channel&q=端点加入达人数据源AddKols 面板拉全局渠道库(:242);响应 items {id,name,platform,subs,email};失败置空(:243)读源 ProjectsTab.tsx:240-245生效
AC-EL-OFC-PRJ-009POST /api/promotion/projects/{id}/kols/add端点勾选加入项目载荷 {kol_ids:[...]}(:256);响应 {added} → toast「已加入 N 位」;零选拒绝 :253「先勾选达人」读源 ProjectsTab.tsx:252-260生效
AC-EL-OFC-PRJ-010GET /api/promotion/project-kols/{pk_id}/content端点文案抽屉加载响应 {content};编辑态初值 manual_* 优先回退 AI 字段(:306-308);失败仅停 loading(:310)读源 ProjectsTab.tsx:302-311生效
AC-EL-OFC-PRJ-011PUT /api/promotion/project-kols/{pk_id}/manual端点手工文案保存载荷 {manual_email,manual_long_reply,manual_short_reply}(:315);成功 toast「已保存」关闭抽屉读源 ProjectsTab.tsx:313-318生效
AC-EL-OFC-PRJ-012「+ 新建项目」按钮按钮打开新建表单tabs 行右侧(:50);点击置 showNew 渲染 NewProjectForm(:52)读源 ProjectsTab.tsx:50-52生效
AC-EL-OFC-PRJ-013「还没有项目」空态空态列表空提示EmptyState title「还没有项目」hint「点「新建项目」开始第一个推广外联」(:55);仅 projects.length===0读源 ProjectsTab.tsx:54-55生效
AC-EL-OFC-PRJ-014「项目」列列项目表第 1 列名称可点进详情(cursor:pointer :62);product_link 副行 ellipsis 280 单行截断(:63)读源 ProjectsTab.tsx:58,62-63生效
AC-EL-OFC-PRJ-015「折扣码」列列项目表第 2 列muted 文本;空显「—」(:64)读源 ProjectsTab.tsx:58,64生效
AC-EL-OFC-PRJ-016「状态」列(项目表)列项目表第 3 列chip 原文回显 p.status(无中文映射,:65)读源 ProjectsTab.tsx:58,65生效
AC-EL-OFC-PRJ-017「达人数」列列项目表第 4 列int(kol_count) 千分位右对齐(:66)读源 ProjectsTab.tsx:58,66生效
AC-EL-OFC-PRJ-018「已发送」列列项目表第 5 列int(sent_count) 千分位右对齐(:67)读源 ProjectsTab.tsx:58,67生效
AC-EL-OFC-PRJ-019「创建时间」列列项目表第 6 列created_at 原文 t2 样式(:68)读源 ProjectsTab.tsx:58,68生效
AC-EL-OFC-PRJ-020「操作」列(项目表)按钮项目表第 7 列「打开 →」按钮进详情(:69);表头为空 th(:58)读源 ProjectsTab.tsx:58,69生效
AC-EL-OFC-PRJ-021「项目名 *」输入输入新建表单字段必填(:88「项目名必填」);placeholder「如:机械键盘 Q4 黑五推广」(:101)读源 ProjectsTab.tsx:88,101生效
AC-EL-OFC-PRJ-022「折扣码」输入(新建)输入新建表单字段placeholder「如:BF30」(:102);可空读源 ProjectsTab.tsx:102生效
AC-EL-OFC-PRJ-023「产品链接」输入输入新建表单字段跨两列(:103);placeholder「https://amazon.com/dp/...」读源 ProjectsTab.tsx:103生效
AC-EL-OFC-PRJ-024「产品描述」输入输入新建表单字段textarea minHeight 70(:104);placeholder「卖点 / 目标人群 / 合作诉求」读源 ProjectsTab.tsx:104生效
AC-EL-OFC-PRJ-025「创建/取消」按钮按钮新建表单提交busy 期间禁用文案「创建中…」(:107);取消关表单(:108)读源 ProjectsTab.tsx:106-109生效
AC-EL-OFC-PRJ-026「← 项目列表」按钮按钮详情返回onBack 回列表并重拉(:160,:42 回调)读源 ProjectsTab.tsx:42,160生效
AC-EL-OFC-PRJ-027折扣码 chip标签详情页头标识条件 project.discount_code 非空才显(:162)读源 ProjectsTab.tsx:162生效
AC-EL-OFC-PRJ-028「+ 加入达人」按钮按钮打开勾选面板置 showAdd 渲染 AddKols(:164,:170)读源 ProjectsTab.tsx:164,170生效
AC-EL-OFC-PRJ-029「⬇ 导出 Excel」按钮按钮CSV 导出doExport(:145-153);文件名/内容全由端点返回读源 ProjectsTab.tsx:145-153,165生效
AC-EL-OFC-PRJ-030「✉ 批量发送」按钮按钮批量外联confirm 文案见 PRJ-006(:139);主样式 tab on(:166)读源 ProjectsTab.tsx:138-144,166生效
AC-EL-OFC-PRJ-031「删除项目」按钮按钮危险操作danger 色(:167);确认链路 PRJ-002读源 ProjectsTab.tsx:36-40,167生效
AC-EL-OFC-PRJ-032「搜索名称 / 邮箱」输入输入详情筛选·搜索即时 onChange 置 q 并回第 1 页(:174-175);请求参数见 PRJ-004读源 ProjectsTab.tsx:174-175生效
AC-EL-OFC-PRJ-033「全部平台」选择器选择器详情筛选·平台10 固定选项 youtube/tiktok/telegram/bluesky/website/instagram/x/facebook/deal_community/forum(:178);空=全部读源 ProjectsTab.tsx:176-179生效
AC-EL-OFC-PRJ-034「联系类型」选择器选择器详情筛选·联系类型has_email「有邮箱」/no_email「无邮箱」/空不限(:180-184)读源 ProjectsTab.tsx:180-184生效
AC-EL-OFC-PRJ-035「全部状态」选择器选择器详情筛选·状态PK_STATUS 五态中文(STATUS_LABEL :19-21:待处理/AI已生成/已编辑/已发送/已忽略)(:185-188)读源 ProjectsTab.tsx:18-21,185-188生效
AC-EL-OFC-PRJ-036「共 N 位达人」标签标签详情计数int(total)(:190);total 来自 PRJ-004 响应读源 ProjectsTab.tsx:117,190生效
AC-EL-OFC-PRJ-037「暂无达人」空态空态达人表空提示hint「点「加入达人」从达人库勾选,或调整筛选」(:194)读源 ProjectsTab.tsx:193-194生效
AC-EL-OFC-PRJ-038「达人」列(明细表)列达人表第 1 列名称 ellipsis 200 单行截断(:201)读源 ProjectsTab.tsx:197,201生效
AC-EL-OFC-PRJ-039「平台」列列达人表第 2 列muted 原文(:202)读源 ProjectsTab.tsx:197,202生效
AC-EL-OFC-PRJ-040「粉丝」列列达人表第 3 列fmtK 千分位,null 显「—」(:203;fmtK :155)读源 ProjectsTab.tsx:155,203生效
AC-EL-OFC-PRJ-041「国家/类目」列列达人表第 4 列countries join「·」+ categories 前 2 项,空「—」(:204)读源 ProjectsTab.tsx:197,204生效
AC-EL-OFC-PRJ-042「邮箱」列链接达人表第 5 列email 存在显 mailto 链接,否则 muted「无」(:205)读源 ProjectsTab.tsx:197,205生效
AC-EL-OFC-PRJ-043「匹配分」列列达人表第 6 列match_score 原值右对齐,null 显「—」(:206)读源 ProjectsTab.tsx:197,206生效
AC-EL-OFC-PRJ-044「状态」列(达人表)选择器达人表第 7 列行内 select 五态即改即存(:207-212,写端点 PRJ-005)读源 ProjectsTab.tsx:207-212生效
AC-EL-OFC-PRJ-045「文案」列按钮达人表第 8 列按钮文案按 contact_type 二态「邮件」/「社区回复」(:213);打开 ContentEditor读源 ProjectsTab.tsx:213,228生效
AC-EL-OFC-PRJ-046达人表分页器按钮明细分页total>20 才显;「x / y」y=ceil(total/20)(:219-225);越界禁用读源 ProjectsTab.tsx:219-225生效
AC-EL-OFC-PRJ-047「从达人库勾选加入」标题标签AddKols 面板头h2 + sub「已选 {sel.size} 位」实时联动(:264)读源 ProjectsTab.tsx:264生效
AC-EL-OFC-PRJ-048「搜索名称 / 邮箱」输入(勾选)输入勾选面板搜索即时重查(:266-267,:240-244)读源 ProjectsTab.tsx:240-245,266生效
AC-EL-OFC-PRJ-049「加入所选(N)/取消」按钮按钮勾选提交busy「加入中…」禁用(:269);取消关面板(:270)读源 ProjectsTab.tsx:252-260,269-270生效
AC-EL-OFC-PRJ-050勾选列(勾选表)列勾选表第 1 列行点击 toggle+选中行背景 accent-soft(:278);checkbox stopPropagation 防双触发(:279)读源 ProjectsTab.tsx:247-251,278-279生效
AC-EL-OFC-PRJ-051「达人」列(勾选表)列勾选表第 2 列strong 名称(:280)读源 ProjectsTab.tsx:275,280生效
AC-EL-OFC-PRJ-052「平台」列(勾选表)列勾选表第 3 列muted(:281)读源 ProjectsTab.tsx:275,281生效
AC-EL-OFC-PRJ-053「粉丝」列(勾选表)列勾选表第 4 列千分位,空显「—」(:282)读源 ProjectsTab.tsx:275,282生效
AC-EL-OFC-PRJ-054「邮箱」列(勾选表)列勾选表第 5 列原文,空显「—」(:283)读源 ProjectsTab.tsx:275,283生效
AC-EL-OFC-PRJ-055文案抽屉容器容器右侧滑出抽屉fixed 全屏遮罩+右侧 560px(maxWidth 92vw)面板(:321-323);遮罩点击关闭(:322)读源 ProjectsTab.tsx:320-323生效
AC-EL-OFC-PRJ-056抽屉头标识标签达人上下文达人名+「{platform} · {email 或 无邮箱 · 社区回复}」(:326-327)读源 ProjectsTab.tsx:324-331生效
AC-EL-OFC-PRJ-057「⚠ 站点风控提醒」卡标签风控提示条件 c.platform_risk_note 非空(:336);warn-soft 底 pre-wrap 展示(:337-340)读源 ProjectsTab.tsx:336-341生效
AC-EL-OFC-PRJ-058「邮件主题」只读输入输入邮件模式字段readOnly 回显 c.email_subject(:344-346);placeholder「(AI 生成后显示)」读源 ProjectsTab.tsx:344-346生效
AC-EL-OFC-PRJ-059「邮件正文(可编辑)」输入输入邮件模式字段textarea minHeight 260(:347-349);初值 manual_email||email_content(:306)读源 ProjectsTab.tsx:306,347-349生效
AC-EL-OFC-PRJ-060「💡 编辑提示」标签标签编辑建议条件 c.email_edit_tips(:350)读源 ProjectsTab.tsx:350生效
AC-EL-OFC-PRJ-061「长版深度评论(可编辑)」输入输入社区模式字段contact_type≠has_email 时渲染(:352-360);textarea minHeight 160;初值 manual_long_reply||community_long_reply(:307)读源 ProjectsTab.tsx:307,354-356生效
AC-EL-OFC-PRJ-062「短版简评(可编辑)」输入输入社区模式字段textarea minHeight 80(:357-359);初值 manual_short_reply||community_short_reply(:308)读源 ProjectsTab.tsx:308,357-359生效
AC-EL-OFC-PRJ-063「保存/取消」按钮(抽屉)按钮文案保存保存走 PUT manual(PRJ-011)成功关闭并重拉(:313-318,:363)读源 ProjectsTab.tsx:313-318,362-365生效
AC-EL-OFC-PRJ-064抽屉底注标签口径声明「文案由外部离线 AI 生成后导入,此处仅编辑。Deal 社区只导出文案,需人工到对应社区发布,系统不自动发帖。」(:366-368)读源 ProjectsTab.tsx:366-368生效

OFF 列级·达人库(/offsitepromotion 达人库 · AC-EL-OFC-LIB 系列 59 条,源码 web/app/offsitepromotion/LibraryTab.tsx 405 行)

LibraryTab 主列表(:34-244)+ FilterRow 多选筛选行组件(:246-277)+ CatManager 类目管理弹窗(:279-338)+ DictManager 渠道字典弹窗(:340-404);面板级归属见 AC-EL-OFF-048。筛选选项全部来自 API facets 注册表事实,前端不硬编码清单(:3-4 注释)。回复状态六态中文 REPLY_LABELS(:29-32)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-LIB-001GET /api/promotion/kol-library端点主列表加载14 参数 URLSearchParams(:61-64):platforms/countries/cat_ids/raw_cats/tags/contact/suppression/reply_status/fmin/fmax/q/sort/page/page_size=20;响应 {total,page,page_size,items,facets}(:27);失败 setErr(:68)读源 LibraryTab.tsx:59-70生效
AC-EL-OFC-LIB-002POST /api/promotion/kol-categories/batch端点批量打标/移除载荷 {kol_ids, add:[], remove:[]}(:103-104);响应 {added,removed} → toast;成功清勾选并刷新 facets(:105-107)读源 LibraryTab.tsx:99-108生效
AC-EL-OFC-LIB-003GET /api/promotion/categories端点类目管理列表CatManager 挂载拉取(:287-290);失败静默读源 LibraryTab.tsx:287-290生效
AC-EL-OFC-LIB-004POST /api/promotion/categories端点新增类目载荷 {name,sort}(:296);name 空拒绝 :293「类目名必填」;成功后列表+facets 双刷新(:297)读源 LibraryTab.tsx:292-299生效
AC-EL-OFC-LIB-005DELETE /api/promotion/categories/{id}端点删除类目危险确认 :301「「{n}」?达人与该类目的映射将一并移除。」;成功双刷新(:302-303)读源 LibraryTab.tsx:300-304生效
AC-EL-OFC-LIB-006GET /api/promotion/channel-dict端点渠道字典列表DictManager 挂载拉取(:348-351);失败静默读源 LibraryTab.tsx:348-351生效
AC-EL-OFC-LIB-007POST /api/promotion/channel-dict端点新增渠道载荷 {value,label||value,sort:999}(:357);value 空拒绝 :354「value 必填(小写字母/数字)」读源 LibraryTab.tsx:353-360生效
AC-EL-OFC-LIB-008PUT /api/promotion/channel-dict/{id}端点渠道启停载荷 {is_active:!active}(:362);成功重拉(:363)读源 LibraryTab.tsx:361-364生效
AC-EL-OFC-LIB-009DELETE /api/promotion/channel-dict/{id}端点删除字典项危险确认 :366「「{v}」?已入库达人数据不受影响。」(:365-369)读源 LibraryTab.tsx:365-369生效
AC-EL-OFC-LIB-010错误横幅空态请求失败反馈error role=alert(:115);仅 kol-library 请求失败 setErr(:68)读源 LibraryTab.tsx:68,115生效
AC-EL-OFC-LIB-011「达人库」标题标签面板头h2 + sub「多选筛选 · 共 {int(total)} 位达人 · suppression 默认隐藏」(:117)读源 LibraryTab.tsx:117生效
AC-EL-OFC-LIB-012FilterRow 多选行组件容器筛选行骨架label+pill 组(:246-277);maxHeight 92 滚动(:268);B8 修复(:254-255):always 行空时不整行消失、空态给指引读源 LibraryTab.tsx:246-277生效
AC-EL-OFC-LIB-013「渠道」筛选行选择器平台多选选项=facets.platforms「{label}({count})」(:118);label 映射见渠道字典读源 LibraryTab.tsx:118生效
AC-EL-OFC-LIB-014「国家」筛选行选择器国家多选facets.countries 前 40 个(:119);空值显「(空)」读源 LibraryTab.tsx:119生效
AC-EL-OFC-LIB-015「自定义类目」筛选行选择器企业类目多选always 行(:120);空态 hint「暂无自定义类目 — 点下方「类目管理」新增」;值=类目 id 字符串读源 LibraryTab.tsx:120,254-263生效
AC-EL-OFC-LIB-016「源类目」筛选行选择器源类目多选facets.raw_categories 前 30 个(:121);空值显「(空)」读源 LibraryTab.tsx:121生效
AC-EL-OFC-LIB-017「标签」筛选行选择器标签多选选项=facets.tags 全量(:122)读源 LibraryTab.tsx:122生效
AC-EL-OFC-LIB-018「联系方式」选择器选择器联系方式互斥分类五选项各带 facets.contact 计数(:124-133);title :125「主联系方式互斥分类:按 邮箱 > IM > 社交 > 官网 优先级归入最高一类」读源 LibraryTab.tsx:124-133生效
AC-EL-OFC-LIB-019suppression 选择器选择器抑制名单过滤hide(默认)/only「仅看抑制名单」/all 三态(:134-136)读源 LibraryTab.tsx:44,134-136生效
AC-EL-OFC-LIB-020「回复状态」选择器选择器回复过滤REPLY_LABELS 六态:同意/索样/询价/拒绝/退信/无关(:29-32,:137-140)读源 LibraryTab.tsx:29-32,137-140生效
AC-EL-OFC-LIB-021「粉丝下限/上限」输入输入粉丝区间过滤两个 number(:141-144);空传 0(:63);变更回第 1 页读源 LibraryTab.tsx:63,141-144生效
AC-EL-OFC-LIB-022搜索表单输入名称/邮箱搜索input「达人名 / 邮箱」+submit「搜索」(:145-152);submit 才置 query+回第 1 页(:146)防抖语义读源 LibraryTab.tsx:145-152生效
AC-EL-OFC-LIB-023排序选择器选择器列表排序followers(默认)/recent「按最近触达」/name 三项(:50,:148-150)读源 LibraryTab.tsx:50,148-150生效
AC-EL-OFC-LIB-024「重置筛选」按钮按钮清空筛选清全部 11 项筛选态回第 1 页(:73-77,:155)读源 LibraryTab.tsx:73-77,155生效
AC-EL-OFC-LIB-025「类目管理」按钮按钮开类目弹窗置 mgr="cats"(:156,:240 渲染)读源 LibraryTab.tsx:156,240生效
AC-EL-OFC-LIB-026「渠道字典」按钮按钮开字典弹窗置 mgr="dict"(:157,:241 渲染)读源 LibraryTab.tsx:157,241生效
AC-EL-OFC-LIB-027批量操作卡容器勾选后批量栏条件 selKols.length>0(:161);brand 边框;sub「已勾选 {N} 位达人(本页全选切换: 表头复选框)」(:163)读源 LibraryTab.tsx:161-173生效
AC-EL-OFC-LIB-028批量类目选择器选择器批量目标类目选项=facets.categories「{name}({count})」(:165-168)读源 LibraryTab.tsx:165-168生效
AC-EL-OFC-LIB-029「打标/移除标记」按钮按钮批量写操作batchTag add/remove(:169-170,:99-108);零选或未选类目拒绝 :100「先勾选达人并选择类目」读源 LibraryTab.tsx:99-108,169-170生效
AC-EL-OFC-LIB-030表头勾选列列主表第 1 列全选=本页 every(allChecked :111,:182-183);勾选仅本页集合读源 LibraryTab.tsx:111,182-183生效
AC-EL-OFC-LIB-031行勾选列列行选择checkbox 逐行增删 selKols(:190-191)读源 LibraryTab.tsx:190-191生效
AC-EL-OFC-LIB-032「达人」列链接主表第 2 列url 存在时名称外链新窗 noreferrer(:193);bio ellipsis+title 全文(:194-197);「最高播放 N」条件 max_views(:198)读源 LibraryTab.tsx:192-199生效
AC-EL-OFC-LIB-033「渠道」列列主表第 3 列platLabel 字典映射(:84-88)回退原值/「—」(:200)读源 LibraryTab.tsx:84-88,200生效
AC-EL-OFC-LIB-034「粉丝」列列主表第 4 列int(subs) 千分位右对齐,null「—」(:201)读源 LibraryTab.tsx:201生效
AC-EL-OFC-LIB-035「国家」列列主表第 5 列前 3 个+「+N」溢出标记;title=全列表逗号连接(:202)读源 LibraryTab.tsx:202生效
AC-EL-OFC-LIB-036「类目」列列主表第 6 列源类目 dim badge 前 3+「+N」(:204-207)+自定义 chip cat_ids(catName id→名映射 :79-83,:208-210);双空「—」(:211)读源 LibraryTab.tsx:79-83,203-212生效
AC-EL-OFC-LIB-037「标签」列列主表第 7 列tags 逐个 dim badge,空「—」(:213)读源 LibraryTab.tsx:213生效
AC-EL-OFC-LIB-038「负责人」列列主表第 8 列owner 原文,空「—」(:214)读源 LibraryTab.tsx:214生效
AC-EL-OFC-LIB-039「最近触达」列列主表第 9 列last_contacted_at 原文,空「—」(:215)读源 LibraryTab.tsx:215生效
AC-EL-OFC-LIB-040「回复」列列主表第 10 列REPLY_LABELS badge 回退原值;空「—」(:216)读源 LibraryTab.tsx:29-32,216生效
AC-EL-OFC-LIB-041「联系方式」列列主表第 11 列邮箱/IM/社交/官网四行逐条件 badge+值 ellipsis+title 全文(:217-223);四皆空「—」(:222)读源 LibraryTab.tsx:217-223生效
AC-EL-OFC-LIB-042「状态」列列主表第 12 列suppression? badge bad「已抑制」: badge ok「正常」(:224)读源 LibraryTab.tsx:224生效
AC-EL-OFC-LIB-043「无匹配达人」空态空态主表空行colSpan 12 居中(:227)读源 LibraryTab.tsx:227生效
AC-EL-OFC-LIB-044主表分页器按钮列表分页「共 {total} 条 · 第 {page} / {pages} 页」pages=ceil(total/20)(:110,:231-235);越界禁用读源 LibraryTab.tsx:110,231-235生效
AC-EL-OFC-LIB-045类目管理弹窗容器容器模态框460px 模态(:306-309);h2「类目管理」sub「自定义类目(企业级注册表)」(:310);遮罩点击关闭(:308)读源 LibraryTab.tsx:306-310生效
AC-EL-OFC-LIB-046「新类目名/排序」输入输入类目新增行name+number sort(:312-313);sort 初值 "0"(:284);提交「新增」(:314)读源 LibraryTab.tsx:283-284,311-315生效
AC-EL-OFC-LIB-047「类目」列(类目表)列类目表第 1 列strong 名称(:322)读源 LibraryTab.tsx:318,322生效
AC-EL-OFC-LIB-048「排序」列列类目表第 2 列sort 数值右对齐(:323)读源 LibraryTab.tsx:318,323生效
AC-EL-OFC-LIB-049「达人数」列列类目表第 3 列int(kol_count) 千分位(:324)读源 LibraryTab.tsx:318,324生效
AC-EL-OFC-LIB-050「操作」列(类目表)按钮类目表第 4 列「删除」按钮(:325)→危险确认(LIB-005)读源 LibraryTab.tsx:318,325生效
AC-EL-OFC-LIB-051「暂无自定义类目」空态空态类目表空行colSpan 4 居中(:328)读源 LibraryTab.tsx:328生效
AC-EL-OFC-LIB-052渠道字典弹窗容器容器模态框520px 模态(:371-374);h2「渠道字典」sub「注册表事实:插行即生效,筛选器自动出现」(:375);遮罩点击关闭(:372)读源 LibraryTab.tsx:371-375生效
AC-EL-OFC-LIB-053「value/显示名」输入输入字典新增行value 必填小写字母/数字(:354,:377);label 空回退 value(:357,:378);提交「新增」(:379)读源 LibraryTab.tsx:353-360,376-380生效
AC-EL-OFC-LIB-054「value」列(字典表)列字典表第 1 列sku 样式原文(:387)读源 LibraryTab.tsx:383,387生效
AC-EL-OFC-LIB-055「显示名」列列字典表第 2 列label 原文(:388)读源 LibraryTab.tsx:383,388生效
AC-EL-OFC-LIB-056「达人」列(字典表)列字典表第 3 列int(kol_count) 千分位(:389)读源 LibraryTab.tsx:383,389生效
AC-EL-OFC-LIB-057「启用」列按钮字典表第 4 列badge 按钮 ok「启用」/dim「停用」点击切换(:390-391)→PUT(LIB-008)读源 LibraryTab.tsx:361-364,390-391生效
AC-EL-OFC-LIB-058「操作」列(字典表)按钮字典表第 5 列「删除」按钮(:392)→危险确认(LIB-009)读源 LibraryTab.tsx:383,392生效
AC-EL-OFC-LIB-059「加载中…」占位空态主表加载态!data 且 !err 时 muted 文案(:176);首次加载可见读源 LibraryTab.tsx:176生效

OFF 列级·邮件模板(/offsitepromotion 邮件模板 · AC-EL-OFC-TPL 系列 34 条,源码 web/app/offsitepromotion/TemplatesTab.tsx 266 行)

TemplatesTab 列表(:33-111)+ TplEditor 编辑器(:113-265);面板级归属见 AC-EL-OFF-050。变量渲染口径在 API 一份实现、前端只做插入与展示(:3-4 注释);变量中文标签 VAR_LABELS 七变量(:24-27)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-TPL-001GET /api/promotion/email-templates端点列表加载四参数 lang/category/status/q(:45-46);响应 {items,facets{langs,categories},variables}(:14-18);失败静默读源 TemplatesTab.tsx:44-48生效
AC-EL-OFC-TPL-002DELETE /api/promotion/email-templates/{id}端点删除模板危险确认 :51「「{name}」?」;删除正在编辑项时同步关编辑器(:54)读源 TemplatesTab.tsx:50-56生效
AC-EL-OFC-TPL-003PUT /api/promotion/email-templates/{tid}端点编辑保存载荷 {name,lang,subject,body,category,status}(:156,:159)读源 TemplatesTab.tsx:152-168生效
AC-EL-OFC-TPL-004POST /api/promotion/email-templates端点新建保存同载荷(:161);响应 {id} 并 setId(:162-163),保存后可继续预览读源 TemplatesTab.tsx:159-164生效
AC-EL-OFC-TPL-005POST /api/promotion/email-templates/{tid}/preview端点实时预览载荷 {kol_id||null,product,discount_code,my_name}(:175-177);响应 {kol{name,platform,countries},subject,body,missing[],unknown[]}(:19-22)读源 TemplatesTab.tsx:170-180生效
AC-EL-OFC-TPL-006「邮件模板」标题标签面板头h2 + sub「共 {items.length} 个 · 变量白名单渲染 · 发送时逐收件人生成」(:61);N=当前筛选返回条数(无分页参数/分页器,全量渲染 :45-46,:77-99)读源 TemplatesTab.tsx:61生效
AC-EL-OFC-TPL-007「全部语言」选择器选择器语言筛选选项=facets.langs「{value}({count})」空值显「(空)」(:63-66)读源 TemplatesTab.tsx:63-66生效
AC-EL-OFC-TPL-008「全部分类」选择器选择器分类筛选选项=facets.categories(:67-70)读源 TemplatesTab.tsx:67-70生效
AC-EL-OFC-TPL-009「全部状态」选择器选择器状态筛选draft「草稿」/active「启用」两项(:71-73)读源 TemplatesTab.tsx:71-73生效
AC-EL-OFC-TPL-010「模板名搜索」输入输入名称搜索即时 q 联动重查(:74,:45)读源 TemplatesTab.tsx:44-48,74生效
AC-EL-OFC-TPL-011「新建模板」按钮按钮开编辑器setEditing("new")(:75);编辑器 key="new"(:103)读源 TemplatesTab.tsx:75,102-108生效
AC-EL-OFC-TPL-012「模板名」列列列表第 1 列strong 名称(:83)读源 TemplatesTab.tsx:79,83生效
AC-EL-OFC-TPL-013「语言」列列列表第 2 列lang 原文,空「—」(:84)读源 TemplatesTab.tsx:79,84生效
AC-EL-OFC-TPL-014「分类」列列列表第 3 列category 原文,空「—」(:85)读源 TemplatesTab.tsx:79,85生效
AC-EL-OFC-TPL-015「主题」列列列表第 4 列subject ellipsis 320 单行,空「—」(:86)读源 TemplatesTab.tsx:79,86生效
AC-EL-OFC-TPL-016「状态」列列列表第 5 列badge active=ok「启用」/其余 dim「草稿」(:87)读源 TemplatesTab.tsx:79,87生效
AC-EL-OFC-TPL-017「更新」列列列表第 6 列updated_at muted(:88)读源 TemplatesTab.tsx:79,88生效
AC-EL-OFC-TPL-018「操作」列按钮列表第 7 列「编辑」开编辑器/「删除」危险确认(:90-91)读源 TemplatesTab.tsx:79,89-92生效
AC-EL-OFC-TPL-019「暂无模板」空态空态列表空行「暂无模板,点「新建模板」开始」colSpan 7(:95-97)读源 TemplatesTab.tsx:95-97生效
AC-EL-OFC-TPL-020编辑器标题标签编辑器头「编辑模板 #{id}」/「新建模板」二态(:184);sub「变量在发送时逐收件人替换;缺失变量的收件人将被跳过并记录原因」(:185)读源 TemplatesTab.tsx:184-185生效
AC-EL-OFC-TPL-021「模板名」输入(编辑器)输入编辑器字段必填 :153「模板名必填」(:190)读源 TemplatesTab.tsx:152-153,190生效
AC-EL-OFC-TPL-022语言选择器(编辑器)选择器编辑器字段固定 6 语种 en/de/fr/es/it/ja(:192);新建默认 en(:122)读源 TemplatesTab.tsx:122,191-193生效
AC-EL-OFC-TPL-023「分类」输入(编辑器)输入编辑器字段自由文本(:194)读源 TemplatesTab.tsx:194生效
AC-EL-OFC-TPL-024状态选择器(编辑器)选择器编辑器字段draft/active,新建默认 draft(:124,:195-197)读源 TemplatesTab.tsx:124,195-197生效
AC-EL-OFC-TPL-025「主题」输入(编辑器)输入编辑器字段placeholder「Collab with {{channel_name}}?」(:204);focus 记录 lastField=subject(:202)供变量插入定位读源 TemplatesTab.tsx:199-205生效
AC-EL-OFC-TPL-026「正文」输入(编辑器)输入编辑器字段textarea minHeight 260(:210-213);新建默认初值「Hi {{first_name}}, …」(:126);focus 记录 lastField=body读源 TemplatesTab.tsx:126,206-214生效
AC-EL-OFC-TPL-027「插入变量」按钮组按钮变量插入variables 来自 API(:105,回退 VAR_LABELS keys :24-27);insertVar 按 lastField 在光标处插入 {{var}}(:137-150);按钮显中文 VAR_LABELS 回退原值(:220)读源 TemplatesTab.tsx:24-27,137-150,215-223生效
AC-EL-OFC-TPL-028「关闭/保存/保存并预览」按钮按钮编辑器提交保存→TPL-003/004;保存并预览先 save 再调 preview(:170-171,:224-228)读源 TemplatesTab.tsx:170-180,224-228生效
AC-EL-OFC-TPL-029「实时预览」卡标签预览区头h3「实时预览」sub「抽真实达人渲染」(:232)读源 TemplatesTab.tsx:231-232生效
AC-EL-OFC-TPL-030「产品名/折扣码/署名」输入输入预览参数默认 Zipforce 新品/KOL15/Anna(:129-131,:234-238)读源 TemplatesTab.tsx:129-131,234-238生效
AC-EL-OFC-TPL-031「指定达人 ID」输入输入预览收件人number;placeholder「指定达人 ID(留空随机抽一位有邮箱的达人)」(:239-240)读源 TemplatesTab.tsx:239-240生效
AC-EL-OFC-TPL-032「生成预览」按钮按钮预览触发preview()(:241,:170-180)读源 TemplatesTab.tsx:170-180,241生效
AC-EL-OFC-TPL-033预览结果区标签渲染反馈样例达人行(:245-247);missing「模板未使用(或缺失值)」+unknown 红「非白名单变量(发送时保留原样)」warn badge(:248-252);主题+正文渲染框(:254-257)读源 TemplatesTab.tsx:243-258生效
AC-EL-OFC-TPL-034未预览提示空态预览初始态「填好变量参数后点「生成预览」;未保存过的模板会先存为草稿再渲染。」(:260)读源 TemplatesTab.tsx:260生效

OFF 列级·邮箱设置(/offsitepromotion 邮箱设置 · AC-EL-OFC-MBX 系列 30 条,源码 web/app/offsitepromotion/MailboxesTab.tsx 264 行)

MailboxesTab 列表+编辑卡(:50-263);面板级归属见 AC-EL-OFF-054。R7 边界:平台只存储/测试/轮发/监控,不自动开箱不代购(:3-5 注释);密码 write-only——编辑留空=保留原凭据,任何接口不回明文(:4-5);健康徽标来自 health jsonb(:5)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-MBX-001GET /api/promotion/mailboxes端点列表加载响应 {total,items:Mb[]}(:61);Mb 含 has_smtp_pass/has_imap_pass 布尔而非明文(:21-22);失败静默读源 MailboxesTab.tsx:60-63生效
AC-EL-OFC-MBX-002POST /api/promotion/mailboxes端点新增邮箱载荷=form 全量 15 字段(:85,Form :28-33)读源 MailboxesTab.tsx:80-94生效
AC-EL-OFC-MBX-003PUT /api/promotion/mailboxes/{id}端点编辑邮箱编辑预填密码置空(:72-73)→留空=保留原凭据;toast 条件「已保存(凭据已更新)」当任一密码非空(:89)读源 MailboxesTab.tsx:68-77,80-94生效
AC-EL-OFC-MBX-004POST /api/promotion/mailboxes/{id}/test端点连通测试响应 TestResp {ok,smtp{ok,ms,error},imap{ok,ms,error,inbox_count}}(:23-27,:99);toast「连通测试通过」/「测试未通过, 见行内详情」(:101)读源 MailboxesTab.tsx:96-105生效
AC-EL-OFC-MBX-005DELETE /api/promotion/mailboxes/{id}端点删除邮箱危险确认 :108「「{email}」?关联发送任务将无法再用该箱。」读源 MailboxesTab.tsx:107-113生效
AC-EL-OFC-MBX-006「邮箱设置」标题标签面板头h2 + sub「共 {items.length} 个 · 运营人工录入企业邮箱 SMTP/IMAP(R7: 平台只存储/测试/轮发/监控,不自动开箱)」(:125)读源 MailboxesTab.tsx:125生效
AC-EL-OFC-MBX-007「新增邮箱」按钮+密码口径提示按钮新增入口openNew 重置 EMPTY 表单(:65-67,:127);旁注「密码 Fernet 加密落库且永不回显 · 新箱预热期建议 ≤20 封/日(R1)」(:128-130)读源 MailboxesTab.tsx:65-67,126-131生效
AC-EL-OFC-MBX-008「邮箱」列列列表第 1 列email strong+条件「 · {display_name}」muted(:144)读源 MailboxesTab.tsx:134,144生效
AC-EL-OFC-MBX-009「状态」列列列表第 2 列STATUS_BADGE 四态(:45-48):active ok「正常」/warming warn「预热中」/paused dim「已暂停」/quota_exceeded dim「达上限」;未知回退 dim(:141)读源 MailboxesTab.tsx:45-48,141,145生效
AC-EL-OFC-MBX-010「SMTP」列列列表第 3 列「{host}:{port} {SSL|STARTTLS}」(:146)读源 MailboxesTab.tsx:134,146生效
AC-EL-OFC-MBX-011「IMAP」列列列表第 4 列「{host}:{port}」(:147)读源 MailboxesTab.tsx:134,147生效
AC-EL-OFC-MBX-012「日上限」列列列表第 5 列daily_send_limit 原值(:148)读源 MailboxesTab.tsx:134,148生效
AC-EL-OFC-MBX-013「连通测试」列列列表第 6 列三层回显:本次结果 ✓{ms}ms/✗{err} 双行+「收件箱 {N} 封」(:149-156,leg :115-120);否则 health.last_test_*「上次通过/失败 · {时间}」(:157-161);否则「未测试」(:161)读源 MailboxesTab.tsx:115-120,149-162生效
AC-EL-OFC-MBX-014「最近拉信」列列列表第 7 列last_pull_at slice(5,16),空「—」(:163)读源 MailboxesTab.tsx:134,163生效
AC-EL-OFC-MBX-015「备注」列列列表第 8 列note 原文 maxWidth 160,空「—」(:164)读源 MailboxesTab.tsx:134,164生效
AC-EL-OFC-MBX-016「操作」列按钮列表第 9 列「测试」(testing 中禁用显「测试中…」)/「编辑」/「删除」danger(:166-170)读源 MailboxesTab.tsx:134,165-171生效
AC-EL-OFC-MBX-017「尚无邮箱」空态空态列表空行「尚无邮箱——录入企业邮箱的 SMTP/IMAP 参数后即可用于发送任务与收信」colSpan 9(:175-179)读源 MailboxesTab.tsx:175-179生效
AC-EL-OFC-MBX-018编辑卡标题标签编辑器头「新增邮箱」/「编辑 {email}」二态;sub 二态「录入后先「测试」验证参数」/「密码留空 = 保留原凭据(不预填明文)」(:187-188)读源 MailboxesTab.tsx:186-188生效
AC-EL-OFC-MBX-019「邮箱地址/发件显示名」输入输入基础字段email(保存必填之一)+display_name 可空(:190-195)读源 MailboxesTab.tsx:189-196生效
AC-EL-OFC-MBX-020「SMTP 服务器」输入输入SMTP 字段placeholder「smtp.company.com」(:199-201);保存必填之一读源 MailboxesTab.tsx:198-201,253-254生效
AC-EL-OFC-MBX-021「SMTP 端口/加密」输入选择器SMTP 字段端口 number 默认 465(:37);加密「SSL(465 隐式)」/「STARTTLS(587)」(:205-210)读源 MailboxesTab.tsx:37,202-210生效
AC-EL-OFC-MBX-022「SMTP 登录名」输入输入SMTP 字段placeholder 动态=邮箱地址(:211-213);「空=邮箱地址」读源 MailboxesTab.tsx:211-213生效
AC-EL-OFC-MBX-023「SMTP 密码」输入输入SMTP 凭据type=password 占位「••••••••」(:214-216);编辑态 label 加「(留空不改)」;新建必填读源 MailboxesTab.tsx:214-216,253-254生效
AC-EL-OFC-MBX-024「IMAP 服务器」输入输入IMAP 字段placeholder「imap.company.com」(:220-222);保存必填之一读源 MailboxesTab.tsx:219-222,253-254生效
AC-EL-OFC-MBX-025「IMAP 端口/加密」输入选择器IMAP 字段端口默认 993(:38);加密「SSL(993)」/「不加密(不建议)」(:223-231)读源 MailboxesTab.tsx:38,223-231生效
AC-EL-OFC-MBX-026「IMAP 登录名/密码」输入输入IMAP 凭据同 SMTP 口径:登录名空=邮箱地址、密码 write-only 编辑留空不改(:232-237)读源 MailboxesTab.tsx:232-237生效
AC-EL-OFC-MBX-027「日发送上限」输入输入配额字段number 默认 20(:39);label「日发送上限(新箱预热 ≤20)」(:240-242)读源 MailboxesTab.tsx:39,239-242生效
AC-EL-OFC-MBX-028状态选择器(编辑卡)选择器邮箱状态四态 warming(默认 :39)/active/paused/quota_exceeded(:243-247)读源 MailboxesTab.tsx:39,243-247生效
AC-EL-OFC-MBX-029「备注」输入(编辑卡)输入备注字段placeholder「预热批次/负责人等」(:248-250)读源 MailboxesTab.tsx:248-250生效
AC-EL-OFC-MBX-030「保存/取消」按钮按钮编辑提交禁用条件(:253-254):!email||!smtp_host||!imap_host||(新建且缺任一密码);busy「保存中…」读源 MailboxesTab.tsx:252-258生效

OFF 列级·发送任务(/offsitepromotion 邮件外联 · AC-EL-OFC-SND 系列 39 条,源码 web/app/offsitepromotion/SendTasksTab.tsx 245 行)

SendTasksTab 新建表单+任务列表(:31-202)+ TaskLogs 日志弹窗(:204-244);面板级归属见 AC-EL-OFF-052(与 SegmentsTab 同屏=「邮件外联」页签)。状态机 draft/scheduled/sending/paused/done/failed(:4 注释);发送中任务 15s 轮询(:71-76)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-SND-001GET /api/promotion/send-tasks端点任务列表加载响应 {items:Task[]}(:50);失败 setErr(:52);15s 轮询复用此调用(:72-76)读源 SendTasksTab.tsx:49-54,72-76生效
AC-EL-OFC-SND-002GET /api/promotion/email-templates(下拉)端点模板下拉源默认选 status=active 首个否则第一个(:56-59)读源 SendTasksTab.tsx:55-62生效
AC-EL-OFC-SND-003GET /api/promotion/mailboxes(下拉)端点邮箱池数据源拉全量供池 pills(:61,:135-146)读源 SendTasksTab.tsx:61,135-146生效
AC-EL-OFC-SND-004GET /api/promotion/segments端点分群下拉源segVer 变化触发刷新(建/删分群联动 :63-70);选中项消失回退首项(:67)读源 SendTasksTab.tsx:63-70生效
AC-EL-OFC-SND-005POST /api/promotion/send-tasks端点创建任务载荷 {name,template_id,segment_id,mailbox_ids,per_hour_per_mailbox||20,schedule_at||""}(:83-87);排程 toast「任务已排程,到期自动开跑」否则「任务已创建,worker 每分钟轮发」(:88)读源 SendTasksTab.tsx:78-91生效
AC-EL-OFC-SND-006POST /api/promotion/send-tasks/{tid}/{action}端点状态动作action∈launch/pause/resume(:95);toast 已发起/已暂停/已恢复读源 SendTasksTab.tsx:93-99生效
AC-EL-OFC-SND-007DELETE /api/promotion/send-tasks/{tid}端点删除任务危险确认 :102「「{n}」?其发送明细将一并删除。」读源 SendTasksTab.tsx:101-105生效
AC-EL-OFC-SND-008GET /api/promotion/send-tasks/{tid}/logs端点发送日志page&page_size=50(:208);响应 {total,page,items{kol_id,name,send_status,skip_reason,message_id,sent_at}}(:205)读源 SendTasksTab.tsx:204-211生效
AC-EL-OFC-SND-009错误横幅空态请求失败反馈error role=alert(:115);仅 send-tasks 列表失败 setErr读源 SendTasksTab.tsx:52,115生效
AC-EL-OFC-SND-010「新建发送任务」标题标签表单卡头h2 + sub「模板 × 分群 × 邮箱池 · 单箱每小时限速 · 30 天冷却去重」(:117)读源 SendTasksTab.tsx:117生效
AC-EL-OFC-SND-011「任务名」输入输入表单字段必填 :79「任务名必填」(:119)读源 SendTasksTab.tsx:78-80,119生效
AC-EL-OFC-SND-012「选择模板…」选择器选择器表单字段草稿项带「(草稿)」后缀(:120-123)读源 SendTasksTab.tsx:120-123生效
AC-EL-OFC-SND-013「选择分群…」选择器选择器表单字段选项「{name}({N}人)」int(member_n)(:124-127);必选 :80读源 SendTasksTab.tsx:80,124-127生效
AC-EL-OFC-SND-014「每箱每小时」输入输入限速字段number 默认 20;title「每个邮箱每小时最多发几封」(:128-129)读源 SendTasksTab.tsx:128-129生效
AC-EL-OFC-SND-015排程输入输入排程字段datetime-local;title「留空 = 立即开始」(:130-131)读源 SendTasksTab.tsx:130-131生效
AC-EL-OFC-SND-016「创建任务」按钮按钮表单提交busy「创建中…」禁用(:132)读源 SendTasksTab.tsx:132生效
AC-EL-OFC-SND-017邮箱池说明标签标签池口径「邮箱池(不选 = 全部启用邮箱,共 {N} 个可用)」N=active 计数(:135)读源 SendTasksTab.tsx:134-135生效
AC-EL-OFC-SND-018邮箱池 pills选择器池多选逐箱 pill 多选 toggle(:137-146);非 active opacity .45+title「({status} 不可用)」;title 含日上限读源 SendTasksTab.tsx:136-147生效
AC-EL-OFC-SND-019空池提示空态无邮箱警示「暂无邮箱——先到「邮箱设置」录入 SMTP/IMAP,空池任务会被标失败」(:147)读源 SendTasksTab.tsx:147生效
AC-EL-OFC-SND-020「发送任务」标题标签列表卡头h2 + sub「共 {int(items.length)} 条」(:153)读源 SendTasksTab.tsx:153生效
AC-EL-OFC-SND-021「任务」列列列表第 1 列name strong+note 红色副行(条件 t.note,:163-166)读源 SendTasksTab.tsx:156,163-166生效
AC-EL-OFC-SND-022「模板 / 分群」列列列表第 2 列「{template_name} / {segment_name}」(:167)读源 SendTasksTab.tsx:156,167生效
AC-EL-OFC-SND-023「邮箱池」列列列表第 3 列mailbox_ids.length 或「全部」(:168)读源 SendTasksTab.tsx:156,168生效
AC-EL-OFC-SND-024「每箱时速」列列列表第 4 列per_hour_per_mailbox 右对齐(:169)读源 SendTasksTab.tsx:156,169生效
AC-EL-OFC-SND-025「排程」列列列表第 5 列schedule_at 空「立即」(:170)读源 SendTasksTab.tsx:156,170生效
AC-EL-OFC-SND-026「状态」列列列表第 6 列六态 badge(LABELS :20-22 / TONE :23-25:draft dim/scheduled warn/sending ok/paused warn/done ok/failed bad);未知回退 dim+原值(:171)读源 SendTasksTab.tsx:20-25,171生效
AC-EL-OFC-SND-027「进度」列列列表第 7 列statsText「发 {sent} · 跳 {skipped} · 败 {failed}」(:107-111);三值全空显「—」(:109);stats 由 worker 每 tick 回写读源 SendTasksTab.tsx:107-111,172生效
AC-EL-OFC-SND-028「创建」列列列表第 8 列created_at muted(:173)读源 SendTasksTab.tsx:156,173生效
AC-EL-OFC-SND-029「操作」列按钮列表第 9 列状态机:sending→「暂停」;paused→「恢复」;非 done→「发起」(:175-181);「日志」恒显(:182);删除仅 status∉{sending,scheduled}(:183-185)读源 SendTasksTab.tsx:174-186生效
AC-EL-OFC-SND-030列表空/加载态空态列表占位「暂无任务」/「加载中…」colSpan 9 二态(:189-190)读源 SendTasksTab.tsx:189-190生效
AC-EL-OFC-SND-031发送规则底注标签口径声明「发送规则:suppression 优先跳过 · 同一达人 30 天冷却 · (任务,达人) 去重 · 单箱达日上限/时上限自动切箱 · 全池达限挂起到下窗口。」(:194-196)读源 SendTasksTab.tsx:194-196生效
AC-EL-OFC-SND-032sending 轮询标签进度刷新口径存在 sending 任务时 setInterval 15s 重拉(:72-76);注释「stats 由 worker 每 tick 回写」(:71)读源 SendTasksTab.tsx:71-76生效
AC-EL-OFC-SND-033「发送日志」弹窗标题标签日志弹窗头h2 + sub「任务 #{tid} · 共 {total} 条」(:217);680px 模态遮罩关闭(:214-216)读源 SendTasksTab.tsx:213-217生效
AC-EL-OFC-SND-034「达人」列(日志表)列日志表第 1 列name 空回退「#{kol_id}」(:224)读源 SendTasksTab.tsx:220,224生效
AC-EL-OFC-SND-035「状态」列(日志表)列日志表第 2 列LOG_LABELS 六态(:26-29:待发/已发/跳过·抑制/跳过·冷却/跳过·无邮箱/失败);badge sent ok/failed bad/其余 dim(:225-226)读源 SendTasksTab.tsx:26-29,225-226生效
AC-EL-OFC-SND-036「原因」列列日志表第 3 列skip_reason maxWidth 260+title 全文,空「—」(:227)读源 SendTasksTab.tsx:220,227生效
AC-EL-OFC-SND-037「时间」列列日志表第 4 列sent_at 空「—」(:228)读源 SendTasksTab.tsx:220,228生效
AC-EL-OFC-SND-038「尚无发送记录」空态空态日志表空行「尚无发送记录(worker 每分钟跑一次)」colSpan 4(:231)读源 SendTasksTab.tsx:231生效
AC-EL-OFC-SND-039日志分页器按钮日志分页「第 {page} / {pages} 页」pages=ceil(total/50)(:211,:235-239);越界禁用;「关闭」按钮读源 SendTasksTab.tsx:211,235-240生效

OFF 列级·任务与 KOL 面板(/offsitepromotion ✅任务/📣KOL · AC-EL-OFC-TSK 系列 81 条,源码 web/app/offsitepromotion/TasksTab.tsx 333 行)

TasksTab.tsx 含四组件:SubOrdersSection 投稿/投放回读(:22-72)+ TasksPanel 任务面板(:74-167)+ KolPanel KOL 三库+分析(:169-283)+ KolAnalysis 四分析卡(:286-332);面板级归属见 AC-EL-OFF-055/056。任务四态 STATUSES/TONE(:12-13);外联五态 OUTREACH(:14)。

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-OFC-TSK-001GET /api/promotion/submissions端点投稿回读响应 {items:Sub[]}(:27);失败置空(:27)读源 TasksTab.tsx:26-30生效
AC-EL-OFC-TSK-002GET /api/promotion/orders端点投放申请回读响应 {items:POrder[]}(:28);失败置空读源 TasksTab.tsx:26-30生效
AC-EL-OFC-TSK-003POST /api/promotion/orders/{oid}/approve端点审批动作载荷 {action:approve|reject}(:32);toast 已批准/已拒绝;服务端护栏见 OFF-046读源 TasksTab.tsx:31-34生效
AC-EL-OFC-TSK-004GET /api/promotion/tasks端点任务列表加载响应 {items,stats{pending,blocked,in_progress}}(:82);失败回退零值读源 TasksTab.tsx:81-84生效
AC-EL-OFC-TSK-005POST /api/promotion/tasks/{id}/status端点任务状态流转载荷 {status}(:87);成功重拉读源 TasksTab.tsx:86-89生效
AC-EL-OFC-TSK-006POST /api/promotion/tasks端点新增任务载荷 {action,product_key}(:93);action 空前端拦截(:91)读源 TasksTab.tsx:90-96生效
AC-EL-OFC-TSK-007DELETE /api/promotion/tasks/{id}端点删除任务useConfirm「删除该任务?」danger confirmText「删除」(:98);失败静默无 toast读源 TasksTab.tsx:97-100生效
AC-EL-OFC-TSK-008GET /api/promotion/kol端点KOL 三库检索kind/channel|site|high + q + platform(:179-181);响应 {items,counts,platforms}读源 TasksTab.tsx:178-183生效
AC-EL-OFC-TSK-009POST /api/promotion/kol/{kind}/{kid}/outreach端点外联状态写载荷 {outreach_status}(:186);site/high 行内下拉触发;kind=channel 服务端 400 见 OFF-061读源 TasksTab.tsx:185-188生效
AC-EL-OFC-TSK-010GET /api/promotion/kol-analysis端点分析四表响应 {platform,tiers,categories,countries} 四行集(:291);失败回退四空数组(:292)读源 TasksTab.tsx:288-293生效
AC-EL-OFC-TSK-011KPI 三卡标签任务计数待办任务/进行中/被卡任务(:106-110);blocked 红字 var(--danger);数值=stats(TSK-004)读源 TasksTab.tsx:104-110生效
AC-EL-OFC-TSK-012「⏭ 下一步动作(你现在该做什么)」清单容器置顶 SOP条件 pinned.length>0(:102,:111);条目 action 加粗+note muted(:117);非 done 显「✓ 完成」、done 显 badge ok「已完成」(:118-119)读源 TasksTab.tsx:102,111-124生效
AC-EL-OFC-TSK-013新增任务输入行输入快速添加「产品(可选)」+「新任务:要做什么…」Enter 提交(:128-130)+「+ 添加」(:131)读源 TasksTab.tsx:127-132生效
AC-EL-OFC-TSK-014「产品」列(任务表)列任务表第 1 列sku 样式,空「—」(:142)读源 TasksTab.tsx:138,142生效
AC-EL-OFC-TSK-015「动作」列列任务表第 2 列action+note 副行 t2(:143)读源 TasksTab.tsx:138,143生效
AC-EL-OFC-TSK-016「负责人」列列任务表第 3 列assigned_to 空「—」(:144)读源 TasksTab.tsx:138,144生效
AC-EL-OFC-TSK-017「状态」列(任务表)选择器任务表第 4 列行内 select STATUSES 四态(:12,:146-149:待办/进行中/被卡/完成);写端点 TSK-005读源 TasksTab.tsx:12,146-149生效
AC-EL-OFC-TSK-018「操作」列(任务表)按钮任务表第 5 列「完成」(非 done,:153)+「删」danger(:154);表头空 th(:138)读源 TasksTab.tsx:138,151-156生效
AC-EL-OFC-TSK-019「暂无任务」空态空态任务表空提示hint「上方添加;置顶清单为运营 SOP。」(:134)读源 TasksTab.tsx:133-134生效
AC-EL-OFC-TSK-020「投稿记录」标题标签投稿卡头h2 + sub「渠道投稿提交回执 · 新→旧 100 条」(:39)读源 TasksTab.tsx:38-39生效
AC-EL-OFC-TSK-021「时间」列(投稿表)列投稿表第 1 列s.at muted(:44)读源 TasksTab.tsx:42,44生效
AC-EL-OFC-TSK-022「产品」列(投稿表)列投稿表第 2 列s.product(:44)读源 TasksTab.tsx:42,44生效
AC-EL-OFC-TSK-023「渠道」列(投稿表)列投稿表第 3 列s.channel(:44)读源 TasksTab.tsx:42,44生效
AC-EL-OFC-TSK-024「结果」列列投稿表第 4 列s.result 空「—」(:45)读源 TasksTab.tsx:42,45生效
AC-EL-OFC-TSK-025「订单」列列投稿表第 5 列s.orders 空「—」右对齐(:45)读源 TasksTab.tsx:42,45生效
AC-EL-OFC-TSK-026「备注」列(投稿表)列投稿表第 6 列s.note 空「—」muted(:45)读源 TasksTab.tsx:42,45生效
AC-EL-OFC-TSK-027「暂无投稿记录」空态空态投稿表空提示hint「渠道行「投稿」弹窗提交后在此显示」(:40)读源 TasksTab.tsx:40生效
AC-EL-OFC-TSK-028「投放申请」标题标签投放卡头h2 + sub「下单弹窗提交 · pending 状态管理员可批」(:51)读源 TasksTab.tsx:50-51生效
AC-EL-OFC-TSK-029「时间」列(投放表)列投放表第 1 列o.at muted(:56)读源 TasksTab.tsx:54,56生效
AC-EL-OFC-TSK-030「产品」列(投放表)列投放表第 2 列o.product(:56)读源 TasksTab.tsx:54,56生效
AC-EL-OFC-TSK-031「渠道」列(投放表)列投放表第 3 列o.channel(:56)读源 TasksTab.tsx:54,56生效
AC-EL-OFC-TSK-032「金额」列列投放表第 4 列「{amount} {currency}」原币展示不折算(:57)读源 TasksTab.tsx:54,57生效
AC-EL-OFC-TSK-033「状态」列(投放表)列投放表第 5 列badge:approved ok「已批准」/rejected bad「已拒绝」/其余 warn「待审批」(st :35,:58)读源 TasksTab.tsx:35,54,58生效
AC-EL-OFC-TSK-034「备注」列(投放表)列投放表第 6 列o.note 空「—」(:59)读源 TasksTab.tsx:54,59生效
AC-EL-OFC-TSK-035「操作」列(投放表)按钮投放表第 7 列pending 显「批准」「拒绝」两按钮(:60-64),其余 muted「—」(:65);端点 TSK-003读源 TasksTab.tsx:54,60-65生效
AC-EL-OFC-TSK-036「暂无投放申请」空态空态投放表空提示hint「渠道行「下单」弹窗提交后在此显示」(:52)读源 TasksTab.tsx:52生效
AC-EL-OFC-TSK-037KOL 四页签选择器库切换KOL 渠道/测评站/高优清单(带 counts 千分位计数 :195-197)/📊 数据分析(:198);单选切 kind读源 TasksTab.tsx:194-199生效
AC-EL-OFC-TSK-038「全部平台」选择器(KOL)选择器渠道库过滤仅 kind=channel 显示(:200-205);选项「(空)」映射 value=""(:203);来自响应 platforms facets读源 TasksTab.tsx:200-205生效
AC-EL-OFC-TSK-039「搜索名称 / 邮箱 / 域名」输入输入KOL 搜索Enter 触发 load(:207-208)读源 TasksTab.tsx:207-208生效
AC-EL-OFC-TSK-040「频道」列(channel 表)列渠道表第 1 列名称 ellipsis 240(:222)读源 TasksTab.tsx:218,222生效
AC-EL-OFC-TSK-041「平台」列(channel 表)列渠道表第 2 列muted(:223)读源 TasksTab.tsx:218,223生效
AC-EL-OFC-TSK-042「订阅」列列渠道表第 3 列fmtK 千分位空「—」(:189,:224)读源 TasksTab.tsx:189,218,224生效
AC-EL-OFC-TSK-043「最高播放」列列渠道表第 4 列fmtK 千分位 muted(:225)读源 TasksTab.tsx:218,225生效
AC-EL-OFC-TSK-044「地区/类目」列列渠道表第 5 列arrS 数组 join「·」非数组原值空「—」(:190,:226)读源 TasksTab.tsx:190,218,226生效
AC-EL-OFC-TSK-045「联系」列(channel 表)链接渠道表第 6 列email→mailto 链接;无 email 有 url→外链新窗「链接」;皆无「—」(:228-230)读源 TasksTab.tsx:218,227-231生效
AC-EL-OFC-TSK-046「站点」列(site 表)链接测评站表第 1 列https://{domain} 外链新窗+name 副行(:242)读源 TasksTab.tsx:238,242生效
AC-EL-OFC-TSK-047「类目」列(site 表)列测评站表第 2 列category 空「—」(:243)读源 TasksTab.tsx:238,243生效
AC-EL-OFC-TSK-048「优先级」列列测评站表第 3 列★×min(3,priority),空「—」(:244)读源 TasksTab.tsx:238,244生效
AC-EL-OFC-TSK-049「联系」列(site 表)链接测评站表第 4 列emails→原文;否则 contact→外链「联系页」;皆无「—」(:245)读源 TasksTab.tsx:238,245生效
AC-EL-OFC-TSK-050「外联状态」列(site 表)选择器测评站表第 5 列行内 select OUTREACH 五态英文原值(:14,:247-251);默认 pending;写端点 TSK-009读源 TasksTab.tsx:14,246-252生效
AC-EL-OFC-TSK-051「频道」列(high 表)列高优表第 1 列name+platform 副行(:263)读源 TasksTab.tsx:259,263生效
AC-EL-OFC-TSK-052「主类目」列列高优表第 2 列category 空「—」(:264)读源 TasksTab.tsx:259,264生效
AC-EL-OFC-TSK-053「联系」列(high 表)链接高优表第 3 列email→mailto,无「—」(:265)读源 TasksTab.tsx:259,265生效
AC-EL-OFC-TSK-054「外联状态」列(high 表)选择器高优表第 4 列同 OUTREACH select(:267-271)读源 TasksTab.tsx:259,266-272生效
AC-EL-OFC-TSK-055「无匹配」空态空态KOL 表空提示EmptyState title「无匹配」(:213)读源 TasksTab.tsx:213生效
AC-EL-OFC-TSK-056KOL 底注标签同步口径声明「资源库同步自公司 KOL 库(增量:粉丝数/邮箱等自动更新,你标的外联状态不会被覆盖);联系邮箱可直接点击发信。」(:279)读源 TasksTab.tsx:279生效
AC-EL-OFC-TSK-057分析四卡共用 DataTable容器表格骨架mk() 统一构造(:295-309):列带 sortValue/csv/filter(文本列 text/数值列 num);caliber 口径条「站外推广分析表口径:数量=个/件|数据源=promotion_* 推广渠道库(只读库更新)|按平台/层级/类目/国家分组统计。」(:306);loading/empty「无数据」内置读源 TasksTab.tsx:294-309生效
AC-EL-OFC-TSK-058「平台效果分析」表图表分析卡 1h2 sub「互动率 = (均赞+均评)/均播 · 100K+ 占比按订阅」(:313);7 列 平台/KOL 数/平均粉丝/总粉丝/平均播放/互动率%/100K+ 占比%(:314-315);行集=d.platform读源 TasksTab.tsx:312-316生效
AC-EL-OFC-TSK-059「粉丝量级性价比」表图表分析卡 25 列 量级/KOL 数/平均粉丝/平均播放/平均最高播放(:319-320);行集=d.tiers读源 TasksTab.tsx:317-321生效
AC-EL-OFC-TSK-060「品类分布」表图表分析卡 34 列 品类/KOL 数/平均粉丝/平均播放(:324);行集=d.categories读源 TasksTab.tsx:322-325生效
AC-EL-OFC-TSK-061「国家分布」表图表分析卡 44 列 国家/KOL 数/平均粉丝/平均播放(:328);行集=d.countries读源 TasksTab.tsx:326-329生效
AC-EL-OFC-TSK-062「平台」列(平台效果分析)列分析卡 1 第 1 列平台名 text 列(:314);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:313-315生效
AC-EL-OFC-TSK-063「KOL数」列(平台效果分析)列分析卡 1 第 2 列数值 num 列(:314);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:313-315生效
AC-EL-OFC-TSK-064「平均粉丝」列(平台效果分析)列分析卡 1 第 3 列数值 num 列(:314);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:313-315生效
AC-EL-OFC-TSK-065「总粉丝」列(平台效果分析)列分析卡 1 第 4 列数值 num 列(:315);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:313-315生效
AC-EL-OFC-TSK-066「平均播放」列(平台效果分析)列分析卡 1 第 5 列数值 num 列(:315);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:313-315生效
AC-EL-OFC-TSK-067「互动率%」列(平台效果分析)列分析卡 1 第 6 列数值 num 列(:315);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:313-315生效
AC-EL-OFC-TSK-068「100K+占比%」列(平台效果分析)列分析卡 1 第 7 列数值 num 列(:315);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:313-315生效
AC-EL-OFC-TSK-069「量级」列(粉丝量级性价比)列分析卡 2 第 1 列粉丝量级档 text 列(:319);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:318-320生效
AC-EL-OFC-TSK-070「KOL数」列(粉丝量级性价比)列分析卡 2 第 2 列数值 num 列(:319);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:318-320生效
AC-EL-OFC-TSK-071「平均粉丝」列(粉丝量级性价比)列分析卡 2 第 3 列数值 num 列(:319);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:318-320生效
AC-EL-OFC-TSK-072「平均播放」列(粉丝量级性价比)列分析卡 2 第 4 列数值 num 列(:320);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:318-320生效
AC-EL-OFC-TSK-073「平均最高播放」列(粉丝量级性价比)列分析卡 2 第 5 列数值 num 列(:320);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:318-320生效
AC-EL-OFC-TSK-074「品类」列(品类分布)列分析卡 3 第 1 列类目 text 列(:324);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:323-324生效
AC-EL-OFC-TSK-075「KOL数」列(品类分布)列分析卡 3 第 2 列数值 num 列(:324);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:323-324生效
AC-EL-OFC-TSK-076「平均粉丝」列(品类分布)列分析卡 3 第 3 列数值 num 列(:324);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:323-324生效
AC-EL-OFC-TSK-077「平均播放」列(品类分布)列分析卡 3 第 4 列数值 num 列(:324);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:323-324生效
AC-EL-OFC-TSK-078「国家」列(国家分布)列分析卡 4 第 1 列国家码 text 列(:328);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:327-328生效
AC-EL-OFC-TSK-079「KOL数」列(国家分布)列分析卡 4 第 2 列数值 num 列(:328);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:327-328生效
AC-EL-OFC-TSK-080「平均粉丝」列(国家分布)列分析卡 4 第 3 列数值 num 列(:328);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:327-328生效
AC-EL-OFC-TSK-081「平均播放」列(国家分布)列分析卡 4 第 4 列数值 num 列(:328);带对齐/排序/CSV/列筛选(mk() :298-304)读源 TasksTab.tsx:327-328生效
§11.x API 端点分组锚(批G-C2, 2026-10-25)——§12 全量册 67 无锚端点按路由域 18 组收口
AC-EL-ADS-G01API 端点组·ads 域(§12 全量册补锚)端点组ads 路由域下 6 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /api/ads/ops(✓在册)
GET /api/ads/rename(✓在册)
POST /api/ads/rename/apply(—)
GET /api/ads/rename/family(✓在册)
POST /api/ads/rename/family(—)
GET /api/ads/sku-daily(✓在册)
§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-AI-G01API 端点组·ai 域(§12 全量册补锚)端点组ai 路由域下 1 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)POST /api/ai/ask(—)§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-BILLING-G01API 端点组·billing 域(§12 全量册补锚)端点组billing 路由域下 1 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)POST /api/billing/webhook(—)§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-DASHBOARD-G01API 端点组·dashboard 域(§12 全量册补锚)端点组dashboard 路由域下 1 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /api/dashboard/sku-matrix(✓在册)§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-FINANCE-G01API 端点组·finance 域(§12 全量册补锚)端点组finance 路由域下 10 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /api/finance/amazon-aging(✓在册)
GET /api/finance/amazon-fees(✓在册)
GET /api/finance/amazon-rankings-analytics(✓在册)
GET /api/finance/full(✓在册)
GET /api/finance/noon-pnl(✓在册)
GET /api/finance/onno(✓在册)
GET /api/finance/product-pl(✓在册)
GET /api/finance/profit-matrix(✓在册)
GET /api/finance/sku-profit(✓在册)
GET /api/finance/summary(✓在册)
§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-HEALTH-G01API 端点组·health 域(§12 全量册补锚)端点组health 路由域下 1 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /api/health(豁免(exclude))§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-INTERNAL-G01API 端点组·internal 域(§12 全量册补锚)端点组internal 路由域下 5 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /internal/api/v1/ads/spend(✓在册)
GET /internal/api/v1/finance/monthly(✓在册)
GET /internal/api/v1/order/sku-aggregate(✓在册)
GET /internal/api/v1/order/status(✓在册)
GET /internal/api/v1/shared/fx-rate(✓在册)
§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-LISTING-G01API 端点组·listing 域(§12 全量册补锚)端点组listing 路由域下 2 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)POST /api/listing/tasks/{tid}/approve(—)
POST /api/listing/tasks/{tid}/revert(—)
§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-MATRIX-G01API 端点组·matrix 域(§12 全量册补锚)端点组matrix 路由域下 1 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /api/matrix/dimensions(✓在册)§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-MCP-G01API 端点组·mcp 域(§12 全量册补锚)端点组mcp 路由域下 4 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)POST /mcp(—)
POST /api/mcp/keys(—)
GET /api/mcp/keys(✓在册)
DELETE /api/mcp/keys/{kid}(—)
§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-NOON-G01API 端点组·noon 域(§12 全量册补锚)端点组noon 路由域下 4 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /api/noon/coupons(✓在册)
GET /api/noon/deal-skus(✓在册)
GET /api/noon/deals(✓在册)
GET /api/noon/rankings(✓在册)
§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-NOONOPS-G01API 端点组·noonops 域(§12 全量册补锚)端点组noonops 路由域下 13 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /api/noonops/asn/eligible-items(✓在册)
POST /api/noonops/asn/items(—)
POST /api/noonops/asn/ledger-sync(—)
POST /api/noonops/asn/schedule(—)
GET /api/noonops/asn/shipments(✓在册)
GET /api/noonops/asn/slots(✓在册)
POST /api/noonops/asn/status(—)
GET /api/noonops/order/{order_nr}/customer(✓在册)
GET /api/noonops/po/{po_nr}(✓在册)
GET /api/noonops/pricing(✓在册)
POST /api/noonops/pricing/set(—)
POST /api/noonops/write(—)
GET /api/noonops/write-endpoints(✓在册)
§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-OPS-G01API 端点组·ops 域(§12 全量册补锚)端点组ops 路由域·运营后台新面 4 端点的分组锚(#117 三层登记 2026-11-14, 照 9.102 P3-2 先例; /ops 页面级元素册未建档, 按域一锚收口=批G-C2 模式; 先住民 dlq→AC-EL-BKF-029/032/033、llm→AC-EL-SET-006/027/034 已有锚不入组)POST /api/ops/login(—)
POST /api/ops/logout(—)
GET /api/ops/tenants(✓在册)
POST /api/ops/tenants/{slug}/activate(—)
§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-ORDERS-G01API 端点组·orders 域(§12 全量册补锚)端点组orders 路由域下 1 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /api/orders(✓在册)§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-PROMOTION-G01API 端点组·promotion 域(§12 全量册补锚)端点组promotion 路由域下 4 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /api/promotion/channels(✓在册)
POST /api/promotion/send-tasks/{tid}/launch(—)
POST /api/promotion/send-tasks/{tid}/pause(—)
POST /api/promotion/send-tasks/{tid}/resume(—)
§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-REPORTS-G01API 端点组·reports 域(§12 全量册补锚)端点组reports 路由域下 3 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /api/reports/backend-keywords/{sku}(✓在册)
PUT /api/reports/backend-keywords/{sku}(—)
POST /api/reports/landed-cost(—)
§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-SOURCING-G01API 端点组·sourcing 域(§12 全量册补锚)端点组sourcing 路由域下 5 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /api/sourcing/aba/chart(✓在册)
GET /api/sourcing/explore/fields(✓在册)
GET /api/sourcing/keepa-history(✓在册)
POST /api/sourcing/verdicts/decision(—)
GET /api/sourcing/verdicts/legacy(✓在册)
§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-TENANT-G01API 端点组·tenant 域(§12 全量册补锚)端点组tenant 路由域下 2 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /api/tenant/exists(豁免(exclude))
GET /api/tenant/jobs(✓在册)
§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-TODAY-G01API 端点组·today 域(§12 全量册补锚)端点组today 路由域下 1 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /api/today(✓在册)§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效
AC-EL-WEBHOOKS-G01API 端点组·webhooks 域(§12 全量册补锚)端点组webhooks 路由域下 2 个端点的分组锚(批G-C2 2026-10-25; 前端无独立页面或既有页面元素册未覆盖 API 面, 按域一锚收口, 单端点争议时再拆条)GET /api/webhooks/noon/status(✓在册)
POST /api/webhooks/noon/{path_token}(—)
§12 锚列回填同刻; R6 引用零悬空; 注册表括注=endpoint_registry as-built(api/write/exclude)生效

§11.41 总览大盘(/dashboard · AC-EL-DASH-001…021,源码 web/app/dashboard/page.tsx ~900 行 · API 全部复用垂直页既有端点零新增——/api/notifications/summary、/api/finance/full、/api/finance/product-pl、/api/ads/analysis、/api/ads/charts、/api/dashboard/filters、/api/dashboard/charts、/api/today、/api/inventory/health、/api/po/list、/api/settlement、/api/rankings(/markets) · 设计真源=hub-page-system-design-2026-10-29.md §4.1 + baseline-param-spec §6/§7 · 2026-10-29 建档 · 同日呈现层 v2 追记见 AC-EL-DASH-022)

ID元素类型描述定义(数据来源·口径·边界)验证方法状态
AC-EL-DASH-001路由页壳+导航项页壳/dashboard 索引路由(与 /dashboard/[brand] 品牌看板壳并存不冲突);AppShell title=总览大盘 crumb=总览 / 大盘;导航「经营分析」组首项 总览大盘 icon=board四问定位(设计 §4.1):出事了吗①/赚了吗②/每个域健康吗③/走向如何④;「大盘没有自己的数字,只有垂直页的影子」——每数 ≡ 垂直页同窗同值逐位e2e 访问 /dashboard 断言标题+导航项(verify_dashboard.py)生效
AC-EL-DASH-002平台切换制筛选页头 Amazon|Noon tab + URL ?platform=(与财务页同参);未注册平台不渲染切换项;数据断供≠未注册=报错占位永不静默隐藏;Noon 面内 SA/AE 市场切面 chips(一图一币不混轴)注册判据=/api/dashboard/filters platforms.noon.length>0(财务页同源镜像);切换 replaceState 写回 URL;开关管辖层②③④,层①异常带=企业面哨兵不随平台切(E 拍板 2026-10-29 呈现形态)e2e zf 断言双 tab;fg 断言 Noon tab 不渲染;?platform=noon 直达生效
AC-EL-DASH-003层① 异常带(铃铛同源)横带六类哨兵三态渲染:全绿压缩一行/红行置顶可点/黄小字;红类排序铁则=数据可信类(管道断更>2天→数量骤降vs7日均值→排名市场异常)在业务类(回款异常>14天→库存紧急补货)前;黄=PO滞留>7天+库存观察级数据源=/api/notifications/summary(顶栏 NotificationBell 同端点,5 分钟 visibility-gated 轮询同款,同源同值永不两账);端点断供=红边报错占位不静默;零后端改动;行链接 /pipeline、/rankings、/settlement?filter=abnormal、/inventory 与铃铛一致e2e 断言三态之一在位(绿文案/红行标签);与顶栏铃铛计数同值抽查生效
AC-EL-DASH-004时间档(本月/今年)筛选业绩速览+Top5 双档:本月(month=当月)/今年(year=当年),默认本月(财务页默认今年,大盘独立默认=设计拍板);图表窗口=规格表固定不随档档位只管辖层②与 Top5;大1=近12月、大2=近90天、大3=近30天(设计 §4.1 图表预算表);Noon 月度结算面窗口=月集合e2e 点今年断言请求 year= 参数变化生效
AC-EL-DASH-005层② 业绩速览·Amazon 面KPI四数:营收/毛利/净利/净利率(USD);data-caliber=id43镜像财务页 MoneyStrip #55b 推导:窗口逐行求和 revenue/net/ad/cost → gross=net−ad → profit=gross−cost → margin=profit/revenue×100;单月档=财务页最新月瀑布逐位同值(/api/finance/full matrix 同端点同参)e2e 同源断言:大盘本月档净利 ≡ 财务页(默认今年档)最新月净利润 flow-step 逐位(verify_dashboard.py 已锁)生效 reg:id43
AC-EL-DASH-006层② 业绩速览·Noon 面KPISA(SAR)/AE(AED) 分市场分列四数(GMV/毛利/净利/净利率)+订单/窗口行;data-caliber=id44;不做跨币合计(E 拍板)镜像财务页 NAgg:Σnet、Σad;cost_missing 行→noCost++,全月无缺才出净利(缺=「净利—·COGS 缺 N 行」AC-CAL-17);noon_pl_gap/noon_ads_gap 与窗口相交才渲染 ⚠ 覆盖警示(audit 9.89 同款);SA 信任起点 2025-02(9.90 拍板)注脚e2e 同源断言:大盘今年档 SA/AE 净利 ≡ 财务页 noon 面窗口求和逐位(已锁)生效 reg:id44
AC-EL-DASH-007环比 chip(拍板①)chipheader 右缘:Amazon 净利环比 MM←MM 原值对;Noon 每市场一枚本币原值对;不可比=灰 chip 带因(无对照月/品牌覆盖不齐/缺 COGS/进行中月不出)推导源=months=12 的 /api/finance/full(与档位解耦——环比本就完整月对完整月,进行中月永不入对);完整月判定 mon<当月;不算 %;与财务页环比如出一辙e2e 断言大盘环比 chip 数字 ≡ 财务页环比行逐位(已锁 13,761→21,897 实证)生效
AC-EL-DASH-008SKU 养家/亏损 Top5 双列小表表大盘唯一表:左养家右亏损;Amazon=net2/net2_asc(真净利含 COGS)USD;Noon=net/net_asc(结算净额)按市场分组各取 5、币种按市场行映射(SAR/AED,不采 API currency 列字面量)、组内编号 1-5 重起不跨币排序;行点击 → /finance?platform=&sku=(财务页暂无 sku 读取,链接前向兼容)与财务页双榜同端点同参同值(/api/finance/product-pl;amazon page_size=5、noon page_size=50 客户端按市场拆);data-caliber 随面 id43/id44e2e 断言行 href 透传;值与财务榜首行对账抽查生效 reg:id43,44
AC-EL-DASH-009层③ 域卡矩阵骨架(同构)卡片组八域卡(广告/库存/市场表现/PO 采购/物流/选品/运营(今日)/回款)同构骨架:状态灯(本域异常滚动)+P0 KPI+详情直链+口径注;卡片级 ErrorBoundary(class CardErr)单卡崩不塌整页,崩=报错占位文本(AC-SEC-07 形态)状态灯=层① 同源哨兵映射(库存 urgent→红/watch→黄;回款 settle_abnormal→红;排名 rank_abnormal→红;PO po_aging→黄;运营 vol_drop→红);门禁=navState 同式(unpurchased/forbidden 占位文案)e2e 断言八卡标题在位;fg ads 未开通断言「模块未开通」占位生效
AC-EL-DASH-010广告域卡卡30 天花费+ACOS+ROAS 三 KPI + 近 30 天日花费 sparkline;data-caliber=id42/api/ads/analysis?days=30(totals_amz=USD / totals_noon.acos 币种无关);Noon 面花费=charts?platform=noon&country={mk} 单市场本币日表 Σ——必传 country(不传=SAR+AED 跨币直加坑,ads.py 源码实证);mod=ads 门禁e2e zf 三 KPI 在位;fg 门禁占位生效 reg:id42
AC-EL-DASH-011库存域卡卡by_status 各状态计数(断货/无销售/正常/充足);状态灯=urgent 红/watch 黄/api/inventory/health?brand&page_size=1(库存页同源);库存归属=AC-SEC-15(brand_fix 仅收入面,库存面禁用);mod=inventorye2e 断言 by_status 渲染数与端点一致生效
AC-EL-DASH-012市场表现域卡卡在榜数(total)+首条目评分/小类 BSR/90 天评论净增;data-caliber=id39/api/rankings/markets → 平台主市场(amazon 取 US 优先/noon 取 SA 优先)→ /api/rankings?platform&market&brand(market 必传,空返空);评分/评论数=product-reviews 目录级(id39);net90 时代重置检测端点侧已承载;noon BSR 全 NULL →「—」如实e2e 断言在榜/评分值与端点 JSON 一致生效 reg:id39
AC-EL-DASH-013PO 采购域卡卡summary 各状态计数(≤4 态)+ 滞留>7 天 KPI(有则);状态灯=po_aging 黄/api/po/list?brand&page_size=1(PO 页同源)+铃铛 po_aging 同源(>7 天未推进);mod=inventorye2e 断言状态计数与端点 summary 一致生效
AC-EL-DASH-014物流/选品域卡(占位挂账)卡「口径待入册(AC-CAL-17 · 占位挂账,不硬造数)」占位卡 + 详情直链;选品卡叠 mod=sourcing 门禁无注册表行口径不发明聚合(AC-CAL-17 市场表现 7× 放大事故教训);入册后接入e2e 断言两张占位卡在位不渲染数值生效
AC-EL-DASH-015运营(今日)域卡卡今日订单/昨日订单(+Amazon 今日营收)+ 24h 小时订单 sparkline;状态灯=vol_drop 红/api/today?brand&platform(今日页同源);hourly_today 为「小时×国家」件级格——按小时聚合跨国家求和后再画(直读会重复计数);noon 面无营收数(月度结算口径)不显示营收 KPIe2e 断言今日订单与端点 cur.orders 一致生效
AC-EL-DASH-016回款域卡(小卡并业绩区下)卡待回款数/待回款额(USD)/最长等待/僵尸(有则)+ payout 近 12 月 sparkline(≥2 点才画);状态灯=settle_abnormal 红/api/settlement?filter=pending summary(回款页同源);payout 序列=/api/finance/full months=12 matrix payout 列按月求和;mod=finance;不进八卡栅格按设计置于业绩区下(回款小卡并业绩区拍板)e2e 断言 pending_count 与端点一致生效
AC-EL-DASH-017层④ 大1 主图(营收·净利·净利率)ECharts近 12 月:营收柱(Amazon USD / Noon 当选市场 GMV 本币)+净利线+净利率虚线(右轴 %);当月残缺月柱半透明虚框+「进行中」语义;悬浮读值有、缩放/下钻无;点标题去垂直页推导=months=12 full:Amazon 按月 Σ(revenue;net−ad−cost);Noon 按月 Σ gmv/net(cost_missing 月净利断线不伪造);净利率=净利/营收×100;SA 面带「信任起点 2025-02」markLine(9.90 拍板);进视口才 init(IntersectionObserver rootMargin 140px)e2e 断言 canvas init+信任起点标注(SA 面截图实证)生效
AC-EL-DASH-018层④ 大2 广告图(日花费·ACOS)ECharts近 90 天:日花费柱+ACOS 线(右轴 %);盈亏平衡 ACOS 参考线(红虚线)=mon_ratios breakeven_acos 最近月(id42 判定线同源);TACOS=月粒度文本行(近 3 月,Amazon 面)——无日粒度源不发明日 TACOS/api/ads/charts?days=90(Amazon platform=amazon USD;Noon platform=noon&country={mk} 单市场本币——跨币直加坑同 010);ACOS=spend/revenue×100(币种无关);mod=ads 门禁(未开通=占位卡)e2e 断言 markLine 标签与 mon_ratios 值一致;fg 门禁占位生效 reg:id42
AC-EL-DASH-019层④ 大3 订单图(订单量·销售额/GMV)EChartsAmazon:近 30 天日订单量柱+日销售额线(USD);Noon:近 12 月月订单量柱+月 GMV 线(本币)+「Noon=月度结算口径(无日粒度销售面)」披露注Amazon=/api/dashboard/charts?platform=amazon&days=30 墙图 dailyCnt/dailyRev 双序列同源(工作台墙一源);Noon=months=12 full.noon 按月 Σ(#56 同市场同币);进视口才 inite2e 断言 canvas init+noon 面月度口径注在位生效
AC-EL-DASH-020页脚同源声明脚注虚线框声明块(v2 形态):加粗导语「大盘没有自己的数字,只有垂直页的影子。」+ 六条编号——① 异常带=顶栏铃铛同源(5 分钟轮询);② 业绩/Top5 每数=财务页同窗同值(id43/id44 同源);③ 平台未注册=切换项不渲染(AC-SEC-07 形态);④ 数据断供=报错占位永不静默;⑤ 金额随面单币不跨币合计(E 拍板);⑥ 物流/选品卡口径入册后接入(AC-CAL-17 占位挂账)页面级口径披露常驻(AC-CAL-17 呈现纪律);「大盘没有自己的数字」总声明的落点(v2 起升为加粗导语置顶)e2e 文案在位断言生效
AC-EL-DASH-021验收脚本(同源断言锁)门禁/tmp/verify_dashboard.py 49 断言:zf 双面(49/49 含同源逐位两枚+环比逐位)+ fg 面(无 Noon 项+结构同构)+ 零 JS error + 零 4xx/5xx API + 三截图(/tmp/dash_{zf_amz,zf_noon,fg_amz}.png)同源断言写死:amz=大盘本月档净利 ≡ 财务页最新月净利润 flow-step;noon=大盘今年档 SA/AE 净利 ≡ 财务页窗口求和;环比=双页 chip 数字逐位;四层结构+data-caliber(id43/id44/id42/id39)+懒加载 canvas重跑 python3 /tmp/verify_dashboard.py 全绿(2026-10-29 15:0x UTC 实证;呈现层 v2 后 15:43 UTC 复跑 49/49 零改动全绿)生效
AC-EL-DASH-022呈现层 v2(.dpg 亮色语言)样式新建 web/app/dashboard/dashboard.css(~110 行 .dpg 作用域,财务舱 v3 亮色样板间语言,全局类零改动)+ page.tsx 呈现重排:工具栏分段控件 .dbar/.segtab(保 button.tab 钩子)、四问段眉 .dsec(①出事了吗②赚了吗③每个域健康吗④走向如何,段眉非 .card)、KPI 大数字 tile .dkpis/.dtile(26px tabular-nums+竖分隔线)、Top5 行 .drow(名次徽章+市场小徽章+右对齐 tabular)、域卡 .ddom(状态灯 3px 同色光环+等高虚线注脚+dim 虚线卡)、大图 .dchart(渐变圆角柱 barGrad+右上图例 LEG+白底圆角阴影 tooltip TIP+轴指针阴影+净利线白边圆点+SPLIT 浅网格)、大2/大3 双列 .dgrid2、页脚 .dfoot 声明块;SVG sparkline 面积填充+端点白边圆点(SVG 属性不吃 CSS var·默认色 #4f46e5 字面量)纯呈现层批(用户 2026-10-29「好难看的界面」+「优化自定义图表」):数据·口径·端点·verify 钩子零动,49/49 复跑全绿;无 reg 锚(不涉口径,R3 平衡不受影响)部署后三截图肉眼复核(zf amz 全页+底部视口+zf noon 全页,/tmp/dash_*.png 2026-10-29 15:4x);真滚动 canvas=3 实证(full_page 截图不触发 IntersectionObserver 属取图伪影非产品缺陷)生效
AC-EL-DASH-023大盘总指令批2 · L1 国家筛选控件页头.dbar 内 amazon 面独有 segtab(「全部国家」+ /api/dashboard/filters countries.amazon 逐国 chip,选项<2 不渲染;noon 面不渲染国家控件——国家轴属 Amazon marketplace);选择写 URL ?country=(replaceState · 跳转/刷新可复原);L2 业务开关语义=同作用于主窗与基线:透传 /api/finance/full、/api/dashboard/kpi(compare 基线行)、/api/today、/api/ads/charts 四面;不辖三面并披露:Top5(product-pl 无 country 参数)、广告卡 30 天花费(ads/analysis 无参数·title 标「全国家面」)、 noon 面;切到 noon 自动清国家总指令 §四 L1 全局基准:主窗与基线窗必须同筛选同变换(C6 拍板=销售模式轴缓办,L1 本批只上国家维);缺参端点不造过滤(AC-CAL-17 禁发明)转披露/tmp/bl2_test.py ①国家控件 5 断言(在位/选项数/URL/复原/noon 不渲染)+ 32/32 全绿(2026-10-30 00:5x UTC)生效
AC-EL-DASH-024批2 · 业绩速览基线行(compare 消费面)层②PerfStrip 主值 tile 下新增 .dbase 基线行块(data-caliber="id45,id46,id47,id48"):amazon=营收/订单/件数/广告 × 环比+同比 8 行,noon=GMV/结算净额/广告(月粒度·折 USD 跨市场合计)×2 窗 6 行;每行=差值 abs(+/− 号)+变化率 pct+基线值披露(title=基线无数据行/基线金额);id47 呈现纪律=abs null 或 pct null→「不可用」斜体(基线无行/0 分母/noon PL 残缺月三源合一落点);方向着色=营收/订单/件数/GMV/结算净额 good、广告类中性(增减非好坏);行块首行斜体披露 win_desc 三窗串(滚动窗基线 · 主窗 · 环比基线窗 · 同比基线窗=§五窗口披露+id48 归集基准日);卡片右下 .dwmark 水印(机绑锚 reg:id45 reg:id46 reg:id47 reg:id48 独立 token;页内由 compare.caliber 动态串接展示 reg:id45,id46,id47,id48,串接形态纯展示非机绑——R4 P3-1 修正);数据源=/api/dashboard/kpi?period=rolling compare 块(批1 AC-CAL-23~26 后端下发,前端零派生)总指令 §六卡片结构(主值+环比行+同比行)+§五基线零空缺禁百分比显不可用;C5 拍板双口径并存:id42 完整月业绩速览不动(Tile/MoChip/dcal 钩子零动),滚动窗基线作新增行不替换主值/tmp/bl2_test.py ②基线行 7 断言(.dbase 在位/caliber 逐串/环比同比标签/三指标/win_desc 日期/水印/noon 月粒度折USD);verify_dashboard 49/49 零改动复跑(Tile 文本钩子与同源正则不触)生效
AC-EL-DASH-025批2 · 八域卡四折叠分组(C4 容器吸收)层③域卡矩阵重组为四个 .dgrp 可折叠分组容器(C4 拍板映射):营收组(广告·回款)/库存组(库存·选品·采购)/订单组(运营·物流)/市场组(市场表现);组头=.dgrp-t 组名+.dgrp-abn 告警 pill(bad=异常红/warn=关注黄,铃铛同源计数聚合:回款异常/库存紧急/库存关注+PO滞留/骤降/排名异常,数据驱动零硬造)+.dgrp-cnt 卡数+.dgrp-fold 折叠钮;折叠=.closed 类 CSS display:none——DOM 保留(verify 钩子 .card b 八卡标题 locator count 不受折叠影响);组头/钮双通道可点(钮 stopPropagation)+键盘可达(role=button+Enter/Space);默认全展开;折叠=纯视图(L3)不触发重查总指令 §六六大可折叠分组在大盘的落地形态:既保八域卡同构骨架与全部验收钩子,又给组级折叠+组级告警聚合两层信息/tmp/bl2_test.py ③折叠组 8 断言(4 组/组名/点击 closed/折叠后 .card b count 不变 15→15/八卡仍可定位/再点展开/pill 类合法/键盘支持实现内证)生效
AC-EL-DASH-026批2 · Top5 定性榜标注 + 大图 L3 粒度档 + 口径水印层②④/全域①Top5 双榜(C1 拍板留榜)补定性披露:h2 sub 追「定性风险排行榜(C1 拍板)」+.dcal 行「聚合排行非单 SKU 明细 · 榜单源 product-pl 不带国家参数:国家筛选不辖本表」(表头文本/行链接钩子零动);②Big1(营收·净利·净利率)头加 12月/6月粒度档 segtab=纯前端切片 ch12 已取数(useMemo 切 .slice(-mons),禁重查=L3 纪律),sub 随档标注 近{6,12}月,amazon 面同纳切片(原为全量月序);③DomCard(有 caliber 者)+PerfStrip(有 compare 者)右下 .dwmark 口径版本水印 reg:{idXX,…}(总指令 §六右下角口径版本水印,与 data-caliber 属性同源同串)总指令 §四 L3 纯视图禁重查+§六水印;C1 定性榜标注与 AC-EL-DASH-008 双榜本体解耦(本体零动,标注只增)/tmp/bl2_test.py ④⑤⑥ 9 断言(切 6 月 /api/finance/full 新请求=0·sub 近6月·canvas≥3/定性两标注/表头钩子在/水印 reg:id42+reg:id39 在位)生效
AC-EL-DASH-027批3 · 快照预生成调度 + 回溯联动禁对比 + 窗档选择(§七)层②/后端①生成器 api/dash_snapshots.py(host crontab 01:23 UTC · docker exec):遍历 active 企业,组合=amazon(品牌∈{全部,注册品牌}×国家∈{全部,订单表 DISTINCT 国}×窗{7,30,90})+noon(品牌×窗,国家恒全部),每组合算 _amz_kpi/_noon_kpi 滚动窗块 UPSERT 入 dashboard_snapshots(PK=企业+品牌+平台+国家+窗;payload jsonb/sums_fp 主窗聚合指纹/data_as_of 归集基准日 reg:id48/backfill_flag);逐企业 tenant_conn RLS 正道写入(不走 saas_admin 绕行);②读路径 /api/dashboard/kpi 新参 days(rolling 窗长,默认 30 与原硬编码逐位一致)+snap(显式=1 才走快照——工作台不传→恒 live 语义零漂移);门控=rolling+days∈{7,30,90}+单平台,TTL 26h 内直读快照,未命中/TTL 外回退 live 重算;快照命中下发 snapshot meta(kind/generated_at/data_as_of/backfill_flag/days);③回溯联动禁对比:生成时对已存行重算「上一行生成日的近 N 天封窗」(amazon=day 精确窗/noon=rolling date~date2 月对齐)比对聚合指纹,漂移→backfill_flag=true→读路径剥 compare+下发 compare_disabled_reason(§七回溯联动);页面基线行显示禁用原因替代环比/同比行;④页面:基线行头加 7天/30天/90天窗档 segtab(L1 时间基准,切档重查 days 参数;默认 30)+.snapmeta 披露行(快照预生成 时刻 UTC · 数据截至=归集基准日);noon 块新增 data_as_of 键(max 有数据月封顶窗末月取月末,单源下发)总指令 §七三套快照 cron 预生成+回溯联动禁对比;§三口径注册表全局强制(compare 剥离而非改值;指纹比对不改任何下发数值);AC-SEC-07 全企业同构(生成器遍历三企业 273 组合)/tmp/bl3_api_test.py 18 断言(快照命中/meta/cur≡live 逐位/live 无 snapshot 键=工作台零漂移/days=7 等长前移窗/非标窗45·双平台·month 门控回退/noon 月粒度命中/backfill 剥 compare+原因+flag 披露/复位恢复/TTL 外回退);/tmp/bl3_page_test.py 20 断言(segtab 三档默认30/win_desc 随档联动 7·30·90 三窗/切档重查 days=7&snap=1/快照 meta 披露/回溯禁用原因+数据行隐藏+复位/noon 面 segtab+meta+月粒度不回归/零 JS error 零 4xx5xx);生成器两趟 273/273 零失败指纹零漂移;verify_dashboard 49/49 零改动复跑全绿生效
AC-EL-DASH-028批4 · 全页导出(隔离校验+口径版本入文件)+ 视图保存加载(企业绑定)+ 指标检索 + 两套日志 + TraceID 全链路(§八)控制条/页脚/后端①导出 GET /api/dashboard/export?platform&brand&country&days:§八导出全隔离校验=品牌以企业 brands_source∩tenant_brands 注册集校验(未注册 400);数据与 /kpi 完全同源同参(快照优先→live 兜底,无二次计算);CSV UTF-8 BOM+Content-Disposition(dashboard_{platform}_{时间戳}.csv);文件头=导出时间 UTC/TraceID/维度/窗档/数据源(快照或 live)/数据截至=归集基准日 reg:id48/对比禁用原因;正文=compare 块直读行(指标中文标签+当前窗+环比基线/差值/%+同比基线/差值/%,reg:id45 环比窗+reg:id46 同比窗+reg:id47 差值与率显示规则);尾部=口径版本水印行 reg:id42、reg:id45、reg:id46、reg:id47、reg:id48(独立 token)+口径说明行;全文件不含企业ID;②视图 user_dashboard_prefs 增 views jsonb(160 迁移·RLS tenant_isolation 沿用=企业+账号绑定跨企业不可见);GET/PUT/DELETE /api/dashboard/views;state 白名单键=platform/country/bw/timeRange/noonMk(L1/L3 选择面;品牌=全局 BrandContext 档不进页面视图)+值限标量(嵌套注入剥除)+同名覆盖+上限 20;页面加载视图=选择面还原+URL ?country=/?platform= 写回(§八跳转带参不带企业ID);③指标检索 GET /api/dashboard/metrics?q=:metric_calibers 只读披露(metric/note/authoritative_source ILIKE+精确 idN,LIMIT 50;portal_app 只读);页脚 .dmtr 块检索入口;④两套日志+TraceID 全链路:企业使用日志=audit_log 行(dashboard.export/dashboard.view.save/dashboard.view.delete,dim 五列 platform/brand/…+trace_id);系统日志=zlog 单行 JSON(既有)+pg application_name(既有)+usage:{date} 请求计数(既有);中间件每请求 new_trace 播种+企业 set_context+X-Trace-Id 响应头;core.audit INSERT 补 trace_id 列(全站生效)——响应头/audit_log 行/导出文件/zlog 行/pg application_name 同 id 互查;页脚披露 TraceID总指令 §八导出全隔离校验+跳转带参不带企业ID+两套日志+TraceID;§三口径注册表全局强制(导出文件水印行=注册表锚入文件);§六口径版本水印;AC-SEC-16 企业隔离(导出校验+视图 RLS+检索只读)/tmp/bl4_api_test.py 32 断言(X-Trace-Id 每请求播种且不同/视图保存读回白名单键集注入键被剥/audit_log.trace_id==PUT 响应头同 id 全链路/空名 400/删除+日志/导出 200 csv+BOM+文件名+TraceID 行+reg:id45 水印+环比基线窗述+不含企业ID+文件内 TraceID==响应头/未注册品牌 400/noon 导出 GMV(折USD)+近7天档/导出日志 dim/检索 id45 精确命中+环比模糊命中+无命中空表+通配符不炸/跨企业视图不可见/kpi snap 路径不回归);/tmp/bl4_page_test.py 16 断言(.dvw 控件条/保存后下拉出现/改国家+7天档→存→刷新→加载还原国家+URL ?country= 带参+窗档 7天还原/导出下载事件+文件名+文件含 TraceID+reg:id45/检索 id45 命中+无命中提示/页脚 TraceID 16hex/dfoot ⑦ 披露/基线行不回归/清场/零 JS error 零 4xx5xx);verify_dashboard 49/49 零改动复跑全绿生效

PDF 规范字段映射(2026-10-26):《上线前全量审计与测试规范》Step 3 API 台账 12 字段 ↔ 本册 as-built:method/path=第1/2列;service=路由域;purpose=作用;permission/tenant_bound/dimensions=统一由鉴权中间件+RLS 承载(AC-SEC-08~12,非逐端点散写,免冗余列);uses_metric_registry=注册表列(✓在册=endpoint_registry 归档);emits_audit_log/propagates_trace=写面端点(action≠GET)经 zlog+audit_log 全量承载(AC-AUD-04/05);cache_strategy=进程级 caliber_filters 缓存绑定 (metric,platform) 键(AC-AUD-08)。字段不缺席、承载面归口单一。

§12 接口全量册(AC-API,2026-10-25 批C 立·机器源=live OpenAPI(/api/openapi.json) × endpoint_registry)

口径:全量=公网 app 全部 method×path 端点(as-built 2026-10-25 06:5x UTC 拉取)。 列:方法|路径|路由域|作用(OpenAPI summary)|尺子锚(§11 AC-EL 条目·路径精确匹配·{参数}归一)|注册表(GET 端点对 endpoint_registry)。 生成纪律:机器生成+独立校对(fork 复核,C3 抓浅前缀锚 51 处→锚规则=精确匹配);本节属尺子(只增不删、状态随修随换);endpoint_registry=端点注册表(GET 遍历面 api/internal+写面 write,迁移 133),本节=人读全量面。
§12接口全量册在册(347 路由路径 · 400 method×path 端点)
方法路径路由域作用尺子锚(§11)注册表
GET/api/ads/adviceadsAds Advice ListAC-EL-ADS-019✓在册
GET/api/ads/advice/{aid}/checkinsadsAds Advice CheckinsAC-EL-ADS-038✓在册
POST/api/ads/advice/{aid}/decisionadsAds Advice DecideAC-EL-ADS-034—
GET/api/ads/analysisadsAds AnalysisAC-EL-ADS-048✓在册
POST/api/ads/campaign-opsadsAds Campaign OpsAC-EL-ADS-066—
GET/api/ads/campaign-opsadsAds Campaign Ops HistoryAC-EL-ADS-066✓在册
GET/api/ads/chartsadsAds ChartsAC-EL-ADS-077✓在册
GET/api/ads/daypartingadsAds DaypartingAC-EL-ADS-111✓在册
GET/api/ads/importsadsAds Imports ListAC-EL-ADS-160✓在册
POST/api/ads/imports/recomputeadsAds Imports RecomputeAC-EL-ADS-163—
GET/api/ads/keyword-bidsadsAds Keyword BidsAC-EL-ADS-104✓在册
GET/api/ads/monitoradsAds Monitor ListAC-EL-ADS-045✓在册
GET/api/ads/morningadsAds MorningAC-EL-ADS-009✓在册
GET/api/ads/neg-keywordsadsAds Neg Keywords ListAC-EL-ADS-133
AC-EL-ADS-134
✓在册
POST/api/ads/neg-keywordsadsAds Neg Keyword AddAC-EL-ADS-133
AC-EL-ADS-134
—
PATCH/api/ads/neg-keywords/{nid}adsAds Neg Keyword PatchAC-EL-ADS-135—
DELETE/api/ads/neg-keywords/{nid}adsAds Neg Keyword DeleteAC-EL-ADS-135—
POST/api/ads/noon-keyword-bidadsAds Noon Keyword BidAC-EL-ADS-140—
POST/api/ads/noon-recommendations/{rec_id}/adoptadsAds Noon Rec AdoptAC-EL-ADS-144—
GET/api/ads/opsadsAds Ops ListAC-EL-ADS-G01✓在册
POST/api/ads/ops/{aid}/doneadsAds Ops DoneAC-EL-ADS-014
AC-EL-ADS-037
—
GET/api/ads/optlogadsAds OptlogAC-EL-ADS-126✓在册
POST/api/ads/optlog/{log_id}/feedbackadsAds Optlog FeedbackAC-EL-ADS-131—
GET/api/ads/platformadsAds PlatformAC-EL-ADS-058✓在册
GET/api/ads/placement-rowsadsAds Placement RowsAC-EL-ADS-102✓在册
GET/api/ads/price-suggestionsadsAds Price SuggestionsAC-EL-PRD-019✓在册
POST/api/ads/reattributeadsAds ReattributeAC-EL-ADS-164—
GET/api/ads/recommendationsadsAds Recommendations ListAC-EL-ADS-115✓在册
POST/api/ads/recommendations/runadsAds Recommendations RunAC-EL-ADS-119—
POST/api/ads/recommendations/{rid}/decisionadsAds Recommendation DecideAC-EL-ADS-122—
POST/api/ads/recommendations/{rid}/executeadsAds Recommendation ExecuteAC-EL-ADS-123—
GET/api/ads/renameadsAds Rename PlanAC-EL-ADS-G01✓在册
POST/api/ads/rename/applyadsAds Rename ApplyAC-EL-ADS-G01—
GET/api/ads/rename/familyadsAds Rename Family ListAC-EL-ADS-G01✓在册
POST/api/ads/rename/familyadsAds Rename Family UpsertAC-EL-ADS-G01—
GET/api/ads/rule-configadsAds Rule Config GetAC-EL-ADS-165
AC-EL-ADS-166
✓在册
POST/api/ads/rule-configadsAds Rule Config SaveAC-EL-ADS-165
AC-EL-ADS-166
—
DELETE/api/ads/rule-config/{key}adsAds Rule Config DeleteAC-EL-ADS-168—
GET/api/ads/search-termsadsAds Search TermsAC-EL-ADS-093✓在册
GET/api/ads/sku-dailyadsAds Sku DailyAC-EL-ADS-G01✓在册
GET/api/ads/sourcesadsAds SourcesAC-EL-ADS-151✓在册
POST/api/ads/uploadadsAds UploadAC-EL-ADS-157—
POST/api/ads/upload/previewadsAds Upload PreviewAC-EL-ADS-155—
POST/api/ai/adcopyaiAi AdcopyAC-EL-AI-005—
POST/api/ai/ads-optimizeaiAi Ads OptimizeAC-EL-AI-006—
POST/api/ai/askaiAi AskAC-EL-AI-G01—
POST/api/ai/insightaiAi InsightAC-EL-AI-003—
POST/api/ai/page-chataiAi Page ChatAC-EL-CMP-032—
POST/api/ai/sourcingaiAi SourcingAC-EL-SRC-23
AC-EL-AI-004
—
POST/api/ai/sourcing-agentaiAi Sourcing AgentAC-EL-SRC-68—
DELETE/api/aplus/docs/{did}aplusAplus Doc DelAC-EL-LST-143—
GET/api/aplus/documentsaplusAplus DocumentsAC-EL-LST-143✓在册
POST/api/aplus/draftaplusAplus Draft SaveAC-EL-LST-139—
GET/api/aplus/historyaplusAplus History ListAC-EL-LST-144✓在册
GET/api/aplus/mediaaplusAplus Media ListAC-EL-LST-141✓在册
POST/api/aplus/mediaaplusAplus Media AddAC-EL-LST-141—
DELETE/api/aplus/media/{mid}aplusAplus Media DelAC-EL-LST-142—
GET/api/aplus/metaaplusAplus MetaAC-EL-LST-135✓在册
POST/api/auth/loginauthLoginAC-EL-AUTH-020—
POST/api/auth/logoutauthLogoutAC-EL-SHELL-011—
POST/api/auth/logout-allauthAuth Logout AllAC-EL-ACC-019—
POST/api/auth/passwordauthAuth PasswordAC-EL-ACC-010—
POST/api/auth/registerauthRegisterAC-EL-AUTH-011—
GET/api/auth/registration-statusauthRegistration StatusAC-EL-AUTH-001
AC-EL-CMP-025
豁免(exclude)
POST/api/auth/resendauthResendAC-EL-AUTH-014—
GET/api/auth/sessionsauthAuth SessionsAC-EL-ACC-013
AC-EL-ACC-018
豁免(exclude)
GET/api/auth/verifyauthVerifyAC-EL-AUTH-027豁免(exclude)
GET/api/backfill/limitsbackfillBackfill LimitsAC-EL-BKF-005豁免(exclude)
POST/api/backfill/runsbackfillBackfill CreateAC-EL-BKF-013
AC-EL-BKF-015
—
GET/api/backfill/runsbackfillBackfill ListAC-EL-BKF-013
AC-EL-BKF-015
豁免(exclude)
DELETE/api/backfill/runs/{run_id}backfillBackfill Delete DryrunAC-EL-BKF-026—
POST/api/backfill/runs/{run_id}/cancelbackfillBackfill CancelAC-EL-BKF-026—
POST/api/billing/checkoutbillingBilling CheckoutAC-EL-BIL-021—
GET/api/billing/modulesbillingBilling ModulesAC-EL-BIL-012✓在册
POST/api/billing/modules/togglebillingBilling Module ToggleAC-EL-BIL-014—
GET/api/billing/plansbillingBilling PlansAC-EL-BIL-016✓在册
GET/api/billing/statusbillingBilling StatusAC-EL-BIL-005✓在册
POST/api/billing/webhookbillingBilling WebhookAC-EL-BILLING-G01—
GET/api/brandboard/country-skubrandboardBrandboard Country SkuAC-EL-BRD-039
AC-EL-CMP-037
✓在册
GET/api/brandboard/noonbrandboardBrandboard NoonAC-EL-BRDN-006
AC-EL-BRDN-015
AC-EL-CMP-043
✓在册
GET/api/brandboard/ordersbrandboardBrandboard OrdersAC-EL-BRD-022
AC-EL-CMP-037
✓在册
GET/api/brandboard/product-drillbrandboardBrandboard Product DrillAC-EL-PRD-028
AC-EL-PRD-040
✓在册
GET/api/collab/files/{fid}/rawcollabUpload File RawAC-EL-LST-148✓在册
GET/api/dashboard/alertsdashboardDashboard AlertsAC-EL-HOME-05✓在册
GET/api/dashboard/chart-orderdashboardChart Order GetAC-EL-HOME-25✓在册
PUT/api/dashboard/chart-orderdashboardChart Order PutAC-EL-HOME-25—
GET/api/dashboard/chartsdashboardDashboard ChartsAC-EL-HOME-22
AC-EL-BRD-001
AC-EL-BRD-006
AC-EL-BRD-011
AC-EL-BRD-015
AC-EL-CMP-037
✓在册
GET/api/dashboard/filtersdashboardDashboard FiltersAC-EL-HOME-01✓在册
GET/api/dashboard/kpidashboardDashboard KpiAC-EL-HOME-38✓在册
GET/api/dashboard/kpi-cardsdashboardKpi Cards GetAC-EL-HOME-11✓在册
PUT/api/dashboard/kpi-cardsdashboardKpi Cards PutAC-EL-HOME-11—
GET/api/dashboard/merged-kpidashboardDashboard Merged KpiAC-EL-HOME-15✓在册
GET/api/dashboard/sku-matrixdashboardDashboard Sku MatrixAC-EL-DASHBOARD-G01✓在册
GET/api/db/table/{table_name}dbDb Table DetailAC-EL-DB-027✓在册
GET/api/db/table/{table_name}/rowsdbDb Table RowsAC-EL-DB-028✓在册
GET/api/db/tablesdbDb TablesAC-EL-DB-004
AC-EL-DB-025
✓在册
GET/api/dictionarydictionaryData DictionaryAC-EL-DIC-006
AC-EL-DIC-007
AC-EL-DIC-018
AC-EL-DIC-019
✓在册
GET/api/documents/treedocumentsDocuments TreeAC-EL-DOC-020
AC-EL-DOC-021
AC-EL-LEGAL-034
✓在册
GET/api/finance/amazon-agingfinanceAmazon Inventory AgingAC-EL-FINANCE-G01✓在册
GET/api/finance/amazon-feesfinanceAmazon Fees BreakdownAC-EL-FINANCE-G01✓在册
GET/api/finance/amazon-rankings-analyticsfinanceAmazon Rankings AnalyticsAC-EL-FINANCE-G01✓在册
GET/api/finance/fullfinanceFinance FullAC-EL-FINANCE-G01✓在册
GET/api/finance/kpi-wallfinanceFinance Kpi WallAC-EL-FIN-C-001✓在册
GET/api/finance/monthlyfinanceFinance Monthly PlAC-EL-FIN-C-157✓在册
GET/api/finance/noon-opsfinanceFinance Noon OpsAC-EL-FIN-C-133✓在册
GET/api/finance/noon-pnlfinanceFinance Noon PnlAC-EL-FINANCE-G01✓在册
GET/api/finance/noon-skufinanceFinance Noon SkuAC-EL-FIN-C-050✓在册
GET/api/finance/onnofinanceFinance OnnoAC-EL-FINANCE-G01✓在册
GET/api/finance/product-plfinanceFinance Product PlAC-EL-FINANCE-G01✓在册
GET/api/finance/profit-matrixfinanceFinance Profit MatrixAC-EL-FINANCE-G01✓在册
GET/api/finance/sku-profitfinanceFinance SkuAC-EL-FINANCE-G01✓在册
GET/api/finance/summaryfinanceFinance SummaryAC-EL-FINANCE-G01✓在册
GET/api/glossaryglossaryGlossaryAC-EL-DIC-020
AC-EL-PIPE-043
✓在册
GET/api/healthhealthHealthAC-EL-HEALTH-G01豁免(exclude)
GET/api/inv/docsinvInv DocsAC-EL-INV-030
AC-EL-INV-040
✓在册
POST/api/inv/docsinvInv Doc CreateAC-EL-INV-030
AC-EL-INV-040
—
GET/api/inv/docs/{did}invInv Doc DetailAC-EL-INV-032✓在册
POST/api/inv/docs/{did}/approveinvInv Doc ApproveAC-EL-INV-033—
POST/api/inv/docs/{did}/cancelinvInv Doc CancelAC-EL-INV-034—
GET/api/inv/ledgerinvInv LedgerAC-EL-INV-044✓在册
GET/api/inv/productsinvInv Products ListAC-EL-INV-046✓在册
POST/api/inv/productsinvInv Product UpsertAC-EL-INV-046—
GET/api/inv/reportinvInv ReportAC-EL-INV-045✓在册
GET/api/inv/stockinvInv StockAC-EL-INV-042✓在册
GET/api/inv/stocktake/planinvInv Stocktake PlanAC-EL-INV-043✓在册
GET/api/inv/warehousesinvInv WarehousesAC-EL-INV-038
AC-EL-INV-047
✓在册
POST/api/inv/warehousesinvInv Wh CreateAC-EL-INV-038
AC-EL-INV-047
—
GET/api/inventory/alertinventoryInventory AlertAC-EL-INV-020
AC-EL-PO-006
AC-EL-PO-012
AC-EL-PO-040
✓在册
GET/api/inventory/healthinventoryInventory HealthAC-EL-INV-009✓在册
GET/api/inventory/matrixinventoryInventory MatrixAC-EL-INV-058✓在册
GET/api/layoutlayoutGet LayoutAC-EL-CMP-013✓在册
POST/api/layoutlayoutSave LayoutAC-EL-CMP-013—
POST/api/layout/resetlayoutReset LayoutAC-EL-CMP-013—
GET/api/listing/eventslistingList EventsAC-EL-LST-150✓在册
GET/api/listing/exportlistingExportAC-EL-LST-087✓在册
GET/api/listing/healthlistingListing HealthAC-EL-LST-093✓在册
POST/api/listing/import-resultslistingImport ResultsAC-EL-LST-091—
GET/api/listing/metalistingListing MetaAC-EL-LST-004
AC-EL-LST-114
✓在册
POST/api/listing/models/speclistingUpload Spec ModelAC-EL-LST-019—
GET/api/listing/noon/categorieslistingNoon CategoriesAC-EL-LST-115✓在册
GET/api/listing/noon/category-attrslistingNoon Category Attrs EpAC-EL-LST-117✓在册
GET/api/listing/noon/content/{tid}listingNoon Content StatusAC-EL-LST-125✓在册
POST/api/listing/noon/tasklistingNoon Task SaveAC-EL-LST-122—
GET/api/listing/pt-marketslistingListing Pt MarketsAC-EL-LST-033✓在册
GET/api/listing/pt-schemalistingListing Pt SchemaAC-EL-LST-151✓在册
GET/api/listing/pt-searchlistingListing Pt SearchAC-EL-LST-034✓在册
GET/api/listing/skus-by-modellistingListing Skus By ModelAC-EL-LST-009✓在册
POST/api/listing/specslistingUpload SpecAC-EL-LST-067
AC-EL-LST-150
—
GET/api/listing/specslistingList SpecsAC-EL-LST-067
AC-EL-LST-150
✓在册
POST/api/listing/taskslistingCreate TaskAC-EL-LST-005
AC-EL-LST-011
AC-EL-LST-012
AC-EL-LST-018
AC-EL-LST-130
AC-EL-LST-150
—
GET/api/listing/taskslistingList TasksAC-EL-LST-005
AC-EL-LST-011
AC-EL-LST-012
AC-EL-LST-018
AC-EL-LST-130
AC-EL-LST-150
✓在册
POST/api/listing/tasks/batchlistingBatch TasksAC-EL-LST-032—
GET/api/listing/tasks/{tid}listingGet TaskAC-EL-LST-023
AC-EL-LST-030
AC-EL-LST-152
✓在册
PUT/api/listing/tasks/{tid}listingEdit TaskAC-EL-LST-023
AC-EL-LST-030
AC-EL-LST-152
—
DELETE/api/listing/tasks/{tid}listingDelete TaskAC-EL-LST-023
AC-EL-LST-030
AC-EL-LST-152
—
POST/api/listing/tasks/{tid}/approvelistingApproveAC-EL-LISTING-G01—
POST/api/listing/tasks/{tid}/bind-ptlistingBind PtAC-EL-LST-056—
POST/api/listing/tasks/{tid}/generatelistingGenerateAC-EL-LST-021
AC-EL-LST-046
—
POST/api/listing/tasks/{tid}/revertlistingRevertAC-EL-LISTING-G01—
POST/api/listing/tasks/{tid}/submitlistingSubmit TaskAC-EL-LST-057—
GET/api/logistics/appendixlogisticsLogistics AppendixAC-EL-LOG-048✓在册
POST/api/logistics/createlogisticsLogistics CreateAC-EL-LOG-034—
GET/api/logistics/paramslogisticsLogistics Params GetAC-EL-LOG-037
AC-EL-LOG-042
✓在册
POST/api/logistics/paramslogisticsLogistics Params SaveAC-EL-LOG-037
AC-EL-LOG-042
—
GET/api/logistics/pricinglogisticsLogistics PricingAC-EL-LOG-043✓在册
GET/api/logistics/productslogisticsLogistics ProductsAC-EL-LOG-031✓在册
GET/api/logistics/shipmentslogisticsLogistics Shipments ListAC-EL-LOG-003✓在册
POST/api/logistics/shipments/importlogisticsLogistics Shipments ImportAC-EL-LOG-011—
GET/api/mapping/api-fieldsmappingMapping Api FieldsAC-EL-SET-036✓在册
GET/api/mapping/editmappingMapping Edit GetAC-EL-MAP-024
AC-EL-MAP-032
AC-EL-MAP-047
AC-EL-MAP-048
✓在册
POST/api/mapping/editmappingMapping Edit SaveAC-EL-MAP-024
AC-EL-MAP-032
AC-EL-MAP-047
AC-EL-MAP-048
—
POST/api/mapping/edit/exportmappingMapping Edit ExportAC-EL-MAP-038
AC-EL-MAP-040
—
POST/api/mapping/edit/importmappingMapping Edit ImportAC-EL-MAP-042
AC-EL-MAP-049
—
GET/api/mapping/skusmappingMapping SkusAC-EL-MAP-002
AC-EL-MAP-004
AC-EL-MAP-047
AC-EL-MAP-048
✓在册
GET/api/matrix/chartsmatrixGet Matrix ChartsAC-EL-CMP-033✓在册
GET/api/matrix/datamatrixGet Matrix DataAC-EL-CMP-033✓在册
GET/api/matrix/dimensionsmatrixGet DimensionsAC-EL-MATRIX-G01✓在册
POST/api/mcp/keysmcpCreate KeyAC-EL-MCP-G01—
GET/api/mcp/keysmcpList KeysAC-EL-MCP-G01✓在册
DELETE/api/mcp/keys/{kid}mcpRevoke KeyAC-EL-MCP-G01—
GET/api/metric-thresholdsmetric-thresholdsMetric ThresholdsAC-EL-ADS-054✓在册
GET/api/noon-inventorynoon-inventoryNoon InventoryAC-EL-BRDN-013
AC-EL-CMP-043
AC-EL-INV-003
✓在册
GET/api/noon/catalog-salesnoonNoon Catalog SalesAC-EL-NOON-41✓在册
GET/api/noon/couponsnoonNoon CouponsAC-EL-NOON-G01✓在册
GET/api/noon/deal-skusnoonNoon Deal SkusAC-EL-NOON-G01✓在册
GET/api/noon/dealsnoonNoon DealsAC-EL-NOON-G01✓在册
GET/api/noon/feesnoonNoon FeesAC-EL-ADS-145
AC-EL-INV-049
✓在册
GET/api/noon/keywordsnoonNoon KeywordsAC-EL-ADS-137✓在册
GET/api/noon/offersnoonNoon OffersAC-EL-LST-110
AC-EL-INV-049
✓在册
GET/api/noon/rankingsnoonNoon RankingsAC-EL-NOON-G01✓在册
GET/api/noon/recommendationsnoonNoon RecommendationsAC-EL-ADS-141✓在册
GET/api/noon/reviewsnoonNoon ReviewsAC-EL-RANK-062✓在册
GET/api/noon/reviews-analyticsnoonNoon Reviews AnalyticsAC-EL-NOON-29✓在册
GET/api/noon/summarynoonNoon SummaryAC-EL-NOON-03
AC-EL-CMP-046
AC-EL-FIN-C-101
✓在册
POST/api/noonops/asn/createnoonopsAsn CreateAC-EL-INV-054—
GET/api/noonops/asn/eligible-itemsnoonopsAsn EligibleAC-EL-NOONOPS-G01✓在册
POST/api/noonops/asn/itemsnoonopsAsn ItemsAC-EL-NOONOPS-G01—
POST/api/noonops/asn/ledger-syncnoonopsAsn Ledger Sync EpAC-EL-NOONOPS-G01—
POST/api/noonops/asn/schedulenoonopsAsn ScheduleAC-EL-NOONOPS-G01—
GET/api/noonops/asn/shipmentsnoonopsAsn ShipmentsAC-EL-NOONOPS-G01✓在册
GET/api/noonops/asn/slotsnoonopsAsn SlotsAC-EL-NOONOPS-G01✓在册
POST/api/noonops/asn/statusnoonopsAsn StatusAC-EL-NOONOPS-G01—
GET/api/noonops/order/{order_nr}/customernoonopsNoonops CustomerAC-EL-NOONOPS-G01✓在册
GET/api/noonops/po/{po_nr}noonopsNoonops PoAC-EL-NOONOPS-G01✓在册
GET/api/noonops/pricingnoonopsNoonops PricingAC-EL-NOONOPS-G01✓在册
POST/api/noonops/pricing/setnoonopsNoonops Price SetAC-EL-NOONOPS-G01—
POST/api/noonops/stock/setnoonopsNoonops Stock SetAC-EL-INV-056—
POST/api/noonops/writenoonopsNoonops WriteAC-EL-NOONOPS-G01—
GET/api/noonops/write-endpointsnoonopsNoonops Write ListAC-EL-NOONOPS-G01✓在册
GET/api/notifications/summarynotificationsNotifications SummaryAC-EL-SHELL-003豁免(exclude)
POST/api/onboarding/brandonboardingOnboarding BrandAC-EL-ONB-011—
POST/api/onboarding/categoryonboardingOnboarding CategoryAC-EL-ONB-020—
GET/api/onboarding/metaonboardingOnboarding MetaAC-EL-ONB-002豁免(exclude)
GET/api/onboarding/pipelineonboardingOnboarding PipelineAC-EL-ONB-003豁免(exclude)
POST/api/onboarding/skusonboardingOnboarding SkusAC-EL-ONB-025—
GET/api/ops/dlqopsDlq ListAC-EL-BKF-029豁免(exclude)
POST/api/ops/dlq/dropopsDlq DropAC-EL-BKF-033—
POST/api/ops/dlq/retryopsDlq RetryAC-EL-BKF-032—
GET/api/ops/llm/providersopsOps Llm ProvidersAC-EL-SET-006
AC-EL-SET-027
✓在册
POST/api/ops/llm/switchopsOps Llm SwitchAC-EL-SET-034—
POST/api/ops/loginopsOps LoginAC-EL-OPS-G01—
POST/api/ops/logoutopsOps LogoutAC-EL-OPS-G01—
GET/api/ops/tenantsopsOps TenantsAC-EL-OPS-G01✓在册
POST/api/ops/tenants/{slug}/activateopsOps Tenant ActivateAC-EL-OPS-G01—
GET/api/ordersordersOrders ListAC-EL-ORDERS-G01✓在册
POST/api/org/tenant/offboardorgTenant OffboardAC-EL-TEAM-034
AC-EL-OFB-010
—
POST/api/org/tenant/restoreorgTenant RestoreAC-EL-OFB-006—
GET/api/pipeline/auditpipelinePipeline AuditAC-EL-PIPE-002
AC-EL-PIPE-046
✓在册
POST/api/pipeline/run/{func_name}pipelinePipeline RunAC-EL-PIPE-019
AC-EL-PIPE-047
—
GET/api/pipeline/statuspipelinePipeline StatusAC-EL-PIPE-002
AC-EL-PIPE-045
豁免(exclude)
GET/api/pm/exportpmPm ExportAC-EL-PRJ-011✓在册
POST/api/pm/importpmPm ImportAC-EL-PRJ-013—
GET/api/pm/productspmPm Products ListAC-EL-PRJ-003
AC-EL-PRJ-059
✓在册
POST/api/pm/productspmPm Products CreateAC-EL-PRJ-003
AC-EL-PRJ-059
—
GET/api/pm/products/{pid}pmPm Products GetAC-EL-PRJ-064✓在册
PUT/api/pm/products/{pid}pmPm Products UpdateAC-EL-PRJ-064—
DELETE/api/pm/products/{pid}pmPm Products DeleteAC-EL-PRJ-064—
POST/api/pm/products/{pid}/chainpmPm ChainAC-EL-PRJ-008—
POST/api/pm/products/{pid}/taskspmPm Tasks CreateAC-EL-PRJ-054—
PUT/api/pm/tasks/{tid}pmPm Tasks UpdateAC-EL-PRJ-030
AC-EL-PRJ-054
AC-EL-PRJ-057
—
DELETE/api/pm/tasks/{tid}pmPm Tasks DeleteAC-EL-PRJ-030
AC-EL-PRJ-054
AC-EL-PRJ-057
—
POST/api/po/createpoPo CreateAC-EL-PO-015
AC-EL-PO-021
AC-EL-PO-053
—
GET/api/po/listpoPo ListAC-EL-PO-005
AC-EL-PO-009
AC-EL-PO-014
AC-EL-PO-027
AC-EL-PO-028
AC-EL-PO-029
✓在册
GET/api/po/supplierspoPo SuppliersAC-EL-INV-038
AC-EL-PO-030
AC-EL-PO-032
AC-EL-PO-034
✓在册
POST/api/po/supplierspoPo Supplier CreateAC-EL-INV-038
AC-EL-PO-030
AC-EL-PO-032
AC-EL-PO-034
—
DELETE/api/po/suppliers/{sid}poPo Supplier DeleteAC-EL-PO-035—
GET/api/po/{pid}poPo DetailAC-EL-PO-024
AC-EL-PO-057
AC-EL-PO-067
✓在册
PUT/api/po/{pid}poPo UpdateAC-EL-PO-024
AC-EL-PO-057
AC-EL-PO-067
—
DELETE/api/po/{pid}poPo DeleteAC-EL-PO-024
AC-EL-PO-057
AC-EL-PO-067
—
POST/api/po/{pid}/mailpoPo Pdf MailAC-EL-PO-068—
GET/api/po/{pid}/pdfpoPo Pdf GetAC-EL-PO-072✓在册
POST/api/po/{pid}/pdfpoPo Pdf RegenAC-EL-PO-072—
POST/api/po/{pid}/receivepoPo ReceiveAC-EL-PO-075—
POST/api/po/{pid}/statuspoPo StatusAC-EL-PO-062
AC-EL-PO-063
—
GET/api/productsproductsProducts ListAC-EL-PRD-002
AC-EL-PRD-007
AC-EL-PRD-040
AC-EL-PO-055
✓在册
GET/api/promotion/categoriespromotionList CategoriesAC-EL-OFF-048
AC-EL-OFC-LIB-003
AC-EL-OFC-LIB-004
✓在册
POST/api/promotion/categoriespromotionAdd CategoryAC-EL-OFF-048
AC-EL-OFC-LIB-003
AC-EL-OFC-LIB-004
—
PUT/api/promotion/categories/{cid}promotionUpd CategoryAC-EL-OFC-LIB-005—
DELETE/api/promotion/categories/{cid}promotionDel CategoryAC-EL-OFC-LIB-005—
GET/api/promotion/channel-dictpromotionList Channel DictAC-EL-OFF-048
AC-EL-OFC-OVR-003
AC-EL-OFC-LIB-006
AC-EL-OFC-LIB-007
✓在册
POST/api/promotion/channel-dictpromotionAdd Channel DictAC-EL-OFF-048
AC-EL-OFC-OVR-003
AC-EL-OFC-LIB-006
AC-EL-OFC-LIB-007
—
PUT/api/promotion/channel-dict/{did}promotionUpd Channel DictAC-EL-OFC-LIB-008
AC-EL-OFC-LIB-009
—
DELETE/api/promotion/channel-dict/{did}promotionDel Channel DictAC-EL-OFC-LIB-008
AC-EL-OFC-LIB-009
—
GET/api/promotion/channelspromotionPromotion ChannelsAC-EL-PROMOTION-G01✓在册
POST/api/promotion/channels/{cid}/statuspromotionPromo Channel StatusAC-EL-OFF-060—
GET/api/promotion/classify-rulespromotionList RulesAC-EL-OFC-INB-045
AC-EL-OFC-INB-052
✓在册
POST/api/promotion/classify-rulespromotionAdd RuleAC-EL-OFC-INB-045
AC-EL-OFC-INB-052
—
PUT/api/promotion/classify-rules/{rid}promotionUpd RuleAC-EL-OFC-INB-058
AC-EL-OFC-INB-060
—
DELETE/api/promotion/classify-rules/{rid}promotionDel RuleAC-EL-OFC-INB-058
AC-EL-OFC-INB-060
—
GET/api/promotion/email-templatespromotionList TemplatesAC-EL-OFF-050
AC-EL-OFC-INB-022
AC-EL-OFC-TPL-001
AC-EL-OFC-TPL-004
AC-EL-OFC-SND-002
✓在册
POST/api/promotion/email-templatespromotionAdd TemplateAC-EL-OFF-050
AC-EL-OFC-INB-022
AC-EL-OFC-TPL-001
AC-EL-OFC-TPL-004
AC-EL-OFC-SND-002
—
PUT/api/promotion/email-templates/{tid}promotionUpd TemplateAC-EL-OFC-TPL-002
AC-EL-OFC-TPL-003
—
DELETE/api/promotion/email-templates/{tid}promotionDel TemplateAC-EL-OFC-TPL-002
AC-EL-OFC-TPL-003
—
POST/api/promotion/email-templates/{tid}/previewpromotionPreview TemplateAC-EL-OFC-TPL-005—
GET/api/promotion/inboxpromotionList InboxAC-EL-OFC-INB-002✓在册
GET/api/promotion/inbox/kol/{kol_id}/profilepromotionInbox Kol ProfileAC-EL-OFC-INB-021✓在册
POST/api/promotion/inbox/{mid}/claimpromotionClaim InboxAC-EL-OFC-INB-026—
POST/api/promotion/inbox/{mid}/classifypromotionClassify InboxAC-EL-OFC-INB-029—
POST/api/promotion/inbox/{mid}/handledpromotionSet Inbox HandledAC-EL-OFC-INB-031—
POST/api/promotion/inbox/{mid}/replypromotionReply InboxAC-EL-OFC-INB-037—
GET/api/promotion/inbox/{mid}/threadpromotionInbox ThreadAC-EL-OFC-INB-020✓在册
GET/api/promotion/kolpromotionPromo KolAC-EL-OFF-062
AC-EL-OFC-PRJ-008
AC-EL-OFC-TSK-008
✓在册
GET/api/promotion/kol-analysispromotionPromo Kol AnalysisAC-EL-OFC-TSK-010✓在册
POST/api/promotion/kol-categories/batchpromotionBatch TagAC-EL-OFF-048
AC-EL-OFC-LIB-002
—
GET/api/promotion/kol-librarypromotionKol LibraryAC-EL-OFF-048
AC-EL-OFC-OVR-001
AC-EL-OFC-SEG-002
AC-EL-OFC-LIB-001
✓在册
GET/api/promotion/kol-redditpromotionKol RedditAC-EL-OFF-049
AC-EL-OFC-RDT-001
✓在册
GET/api/promotion/kol-statspromotionKol StatsAC-EL-OFC-OVR-002✓在册
POST/api/promotion/kol/{kind}/{kid}/outreachpromotionPromo Kol OutreachAC-EL-OFF-061
AC-EL-OFC-TSK-009
—
GET/api/promotion/mailboxespromotionList MailboxesAC-EL-OFF-054
AC-EL-OFC-MBX-001
AC-EL-OFC-MBX-002
AC-EL-OFC-SND-003
✓在册
POST/api/promotion/mailboxespromotionCreate MailboxAC-EL-OFF-054
AC-EL-OFC-MBX-001
AC-EL-OFC-MBX-002
AC-EL-OFC-SND-003
—
PUT/api/promotion/mailboxes/{mid}promotionUpdate MailboxAC-EL-OFC-MBX-003
AC-EL-OFC-MBX-005
—
DELETE/api/promotion/mailboxes/{mid}promotionDelete MailboxAC-EL-OFC-MBX-003
AC-EL-OFC-MBX-005
—
POST/api/promotion/mailboxes/{mid}/testpromotionTest MailboxAC-EL-OFC-MBX-004—
GET/api/promotion/orderspromotionPromo Orders ListAC-EL-OFF-043
AC-EL-OFF-055
AC-EL-OFF-063
AC-EL-OFC-TSK-002
✓在册
POST/api/promotion/orderspromotionPromo Order CreateAC-EL-OFF-043
AC-EL-OFF-055
AC-EL-OFF-063
AC-EL-OFC-TSK-002
—
POST/api/promotion/orders/{oid}/approvepromotionPromo Order ApproveAC-EL-OFF-046
AC-EL-OFC-TSK-003
—
GET/api/promotion/project-kols/{pkid}/contentpromotionGet ContentAC-EL-OFC-PRJ-010✓在册
PUT/api/promotion/project-kols/{pkid}/contentpromotionSave ContentAC-EL-OFC-PRJ-010—
PUT/api/promotion/project-kols/{pkid}/manualpromotionSave ManualAC-EL-OFC-PRJ-011—
POST/api/promotion/project-kols/{pkid}/statuspromotionSet Pk StatusAC-EL-OFC-PRJ-005—
GET/api/promotion/projectspromotionList ProjectsAC-EL-OFC-PRJ-001
AC-EL-OFC-PRJ-003
✓在册
POST/api/promotion/projectspromotionCreate ProjectAC-EL-OFC-PRJ-001
AC-EL-OFC-PRJ-003
—
DELETE/api/promotion/projects/{pid}promotionDelete ProjectAC-EL-OFC-PRJ-002—
POST/api/promotion/projects/{pid}/email/batch-sendpromotionBatch SendAC-EL-OFC-PRJ-006—
GET/api/promotion/projects/{pid}/exportpromotionExport ProjectAC-EL-OFC-PRJ-007✓在册
GET/api/promotion/projects/{pid}/kolspromotionList Project KolsAC-EL-OFC-PRJ-004✓在册
POST/api/promotion/projects/{pid}/kols/addpromotionAdd KolsAC-EL-OFC-PRJ-009—
GET/api/promotion/resourcespromotionList ResourcesAC-EL-OFF-058
AC-EL-OFC-RES-001
✓在册
GET/api/promotion/segmentspromotionList SegmentsAC-EL-OFF-051
AC-EL-OFC-SEG-001
AC-EL-OFC-SEG-011
AC-EL-OFC-SND-004
✓在册
POST/api/promotion/segmentspromotionCreate SegmentAC-EL-OFF-051
AC-EL-OFC-SEG-001
AC-EL-OFC-SEG-011
AC-EL-OFC-SND-004
—
DELETE/api/promotion/segments/{sid}promotionDelete SegmentAC-EL-OFC-SEG-019—
GET/api/promotion/send-taskspromotionList Send TasksAC-EL-OFF-052
AC-EL-OFC-SND-001
AC-EL-OFC-SND-005
✓在册
POST/api/promotion/send-taskspromotionCreate Send TaskAC-EL-OFF-052
AC-EL-OFC-SND-001
AC-EL-OFC-SND-005
—
DELETE/api/promotion/send-tasks/{tid}promotionDelete Send TaskAC-EL-OFC-SND-007—
POST/api/promotion/send-tasks/{tid}/launchpromotionLaunch Send TaskAC-EL-PROMOTION-G01—
GET/api/promotion/send-tasks/{tid}/logspromotionSend Task LogsAC-EL-OFC-SND-008✓在册
POST/api/promotion/send-tasks/{tid}/pausepromotionPause Send TaskAC-EL-PROMOTION-G01—
POST/api/promotion/send-tasks/{tid}/resumepromotionResume Send TaskAC-EL-PROMOTION-G01—
POST/api/promotion/submissionpromotionPromo SubmissionAC-EL-OFF-043—
GET/api/promotion/submissionspromotionPromo SubmissionsAC-EL-OFF-055
AC-EL-OFF-063
AC-EL-OFC-TSK-001
✓在册
GET/api/promotion/summarypromotionPromotion SummaryAC-EL-OFF-006
AC-EL-OFF-011
✓在册
GET/api/promotion/taskspromotionPromo TasksAC-EL-OFF-059
AC-EL-OFC-TSK-004
AC-EL-OFC-TSK-006
✓在册
POST/api/promotion/taskspromotionPromo Task CreateAC-EL-OFF-059
AC-EL-OFC-TSK-004
AC-EL-OFC-TSK-006
—
DELETE/api/promotion/tasks/{tid}promotionPromo Task DeleteAC-EL-OFC-TSK-007—
POST/api/promotion/tasks/{tid}/statuspromotionPromo Task StatusAC-EL-OFC-TSK-005—
GET/api/rankingsrankingsRankings ListAC-EL-RANK-002
AC-EL-RANK-007
AC-EL-RANK-008
AC-EL-RANK-009
AC-EL-RANK-017
AC-EL-RANK-042
✓在册
GET/api/rankings/amazon-reviewsrankingsRankings Amazon ReviewsAC-EL-RANK-062✓在册
GET/api/rankings/historyrankingsRankings HistoryAC-EL-RANK-034✓在册
GET/api/rankings/marketsrankingsRankings MarketsAC-EL-RANK-014✓在册
GET/api/rankings/rating-review-analyticsrankingsRankings Rating Review AnalyticsAC-EL-RANK-044✓在册
POST/api/rankings/refreshrankingsRankings RefreshAC-EL-RANK-005—
POST/api/rankings/review-airankingsRankings Review AiAC-EL-RANK-072—
GET/api/reports/backend-keywords/{sku}reportsGet Backend KeywordsAC-EL-REPORTS-G01✓在册
PUT/api/reports/backend-keywords/{sku}reportsSet Backend KeywordsAC-EL-REPORTS-G01—
GET/api/reports/defsreportsList DefsAC-EL-HOME-49
AC-EL-CMP-051
✓在册
POST/api/reports/defsreportsCreate DefAC-EL-HOME-49
AC-EL-CMP-051
—
PUT/api/reports/defs/{rid}reportsUpdate DefAC-EL-CMP-051—
DELETE/api/reports/defs/{rid}reportsDelete DefAC-EL-CMP-051—
GET/api/reports/fieldsreportsReport FieldsAC-EL-HOME-49
AC-EL-CMP-051
✓在册
POST/api/reports/landed-costreportsLanded CostAC-EL-REPORTS-G01—
POST/api/reports/queryreportsReport QueryAC-EL-HOME-49
AC-EL-CMP-053
—
GET/api/settings/credentialssettingsList CredentialsAC-EL-SET-008
AC-EL-SET-024
✓在册
POST/api/settings/credentialssettingsCreate CredentialAC-EL-SET-008
AC-EL-SET-024
—
PUT/api/settings/credentials/{cid}settingsUpdate CredentialAC-EL-SET-017
AC-EL-SET-024
—
DELETE/api/settings/credentials/{cid}settingsDelete CredentialAC-EL-SET-017
AC-EL-SET-024
—
POST/api/settings/credentials/{cid}/verifysettingsVerify CredentialAC-EL-SET-015—
GET/api/settings/providerssettingsList ProvidersAC-EL-SET-003
AC-EL-SET-023
✓在册
GET/api/settlementsettlementSettlement TrackerAC-EL-STL-010
AC-EL-STL-024
✓在册
GET/api/sourcing/aba/chartsourcingAba ChartAC-EL-SOURCING-G01✓在册
GET/api/sourcing/aba/ledgersourcingAba LedgerAC-EL-SRC-21✓在册
GET/api/sourcing/aba/overviewsourcingAba OverviewAC-EL-SRC-08✓在册
GET/api/sourcing/aba/termssourcingAba Terms AcAC-EL-SRC-05✓在册
GET/api/sourcing/category-treesourcingSourcing Category TreeAC-EL-SRC-35✓在册
GET/api/sourcing/dealssourcingSourcing DealsAC-EL-SRC-80
AC-EL-SRC-D-001
✓在册
POST/api/sourcing/enrichsourcingSourcing EnrichAC-EL-SRC-F-021—
GET/api/sourcing/exploresourcingSourcing ExploreAC-EL-SRC-50✓在册
POST/api/sourcing/exploresourcingSourcing Explore PostAC-EL-SRC-50—
POST/api/sourcing/explore/exportsourcingSourcing Explore ExportAC-EL-SRC-54—
GET/api/sourcing/explore/fieldssourcingSourcing Explore FieldsAC-EL-SOURCING-G01✓在册
GET/api/sourcing/explorersourcingSourcing ExplorerAC-EL-SRC-06
AC-EL-SRC-17
✓在册
POST/api/sourcing/findersourcingSourcing FinderAC-EL-SRC-81
AC-EL-SRC-F-001
—
GET/api/sourcing/keepa-graphsourcingSourcing Keepa GraphAC-EL-SRC-V-019✓在册
GET/api/sourcing/keepa-historysourcingSourcing Keepa HistoryAC-EL-SOURCING-G01✓在册
GET/api/sourcing/keepa-statussourcingSourcing Keepa StatusAC-EL-SRC-01✓在册
GET/api/sourcing/lightningsourcingSourcing LightningAC-EL-SRC-D-018✓在册
GET/api/sourcing/price-historysourcingSourcing Price HistoryAC-EL-SRC-78
AC-EL-SRC-V-003
✓在册
GET/api/sourcing/radarsourcingSourcing RadarAC-EL-SRC-24✓在册
GET/api/sourcing/searchsourcingSourcing SearchAC-EL-SRC-12
AC-EL-SRC-W-005
✓在册
POST/api/sourcing/seller-findersourcingSourcing Seller FinderAC-EL-SRC-S-010—
GET/api/sourcing/seller-lookupsourcingSourcing Seller LookupAC-EL-SRC-S-031✓在册
GET/api/sourcing/sellers/topsourcingSourcing Sellers TopAC-EL-SRC-79
AC-EL-SRC-S-005
✓在册
GET/api/sourcing/topsellerssourcingSourcing TopsellersAC-EL-SRC-S-025✓在册
GET/api/sourcing/verdicts/candidatessourcingVerdicts CandidatesAC-EL-SRC-X-009✓在册
POST/api/sourcing/verdicts/decisionsourcingVerdicts DecisionAC-EL-SOURCING-G01—
GET/api/sourcing/verdicts/legacysourcingVerdicts LegacyAC-EL-SOURCING-G01✓在册
POST/api/sourcing/verdicts/materializesourcingVerdicts MaterializeAC-EL-SRC-X-001—
GET/api/sourcing/verdicts/paretosourcingVerdicts ParetoAC-EL-SRC-X-003✓在册
POST/api/sourcing/watchsourcingSourcing Watch AddAC-EL-SRC-W-013—
POST/api/sourcing/watch/alertsourcingSourcing Watch AlertAC-EL-SRC-W-022
AC-EL-SRC-V-023
—
DELETE/api/sourcing/watch/{wid}sourcingSourcing Watch DelAC-EL-SRC-W-025—
GET/api/sourcing/watchlistsourcingSourcing WatchlistAC-EL-SRC-77
AC-EL-SRC-W-015
✓在册
GET/api/team/metateamTeam MetaAC-EL-TEAM-002
AC-EL-TEAM-005
AC-EL-TEAM-033
豁免(exclude)
GET/api/team/usersteamTeam UsersAC-EL-TEAM-008
AC-EL-TEAM-043
豁免(exclude)
POST/api/team/usersteamTeam User CreateAC-EL-TEAM-008
AC-EL-TEAM-043
—
PUT/api/team/users/{mid}teamTeam User UpdateAC-EL-TEAM-018
AC-EL-TEAM-019
AC-EL-TEAM-043
—
DELETE/api/team/users/{mid}teamTeam User DeleteAC-EL-TEAM-018
AC-EL-TEAM-019
AC-EL-TEAM-043
—
GET/api/tenant/brandstenantTenant Brands ListAC-EL-TEAM-021
AC-EL-TEAM-023
✓在册
POST/api/tenant/brandstenantTenant Brand AddAC-EL-TEAM-021
AC-EL-TEAM-023
—
DELETE/api/tenant/brands/{brand}tenantTenant Brand DelAC-EL-TEAM-028—
PUT/api/tenant/brands/{brand}/activatetenantTenant Brand ActivateAC-EL-TEAM-029—
GET/api/tenant/existstenantTenant ExistsAC-EL-TENANT-G01豁免(exclude)
GET/api/tenant/infotenantTenant InfoAC-EL-ADS-057
AC-EL-ADS-071
AC-EL-SHELL-010
AC-EL-SHELL-011
AC-EL-SRC-X-002
豁免(exclude)
GET/api/tenant/jobstenantTenant JobsAC-EL-TENANT-G01✓在册
GET/api/todaytodayToday StatsAC-EL-TODAY-G01✓在册
GET/api/training/statstrainingTraining StatsAC-EL-HLP-026✓在册
POST/api/uploaduploadUpload FileAC-EL-LST-147
AC-EL-LST-148
—
GET/api/upload/filesuploadUpload Files ListAC-EL-LST-146✓在册
DELETE/api/upload/files/{fid}uploadUpload File DeleteAC-EL-LST-149—
GET/api/webhooks/noon/statuswebhooksNoon Webhook StatusAC-EL-WEBHOOKS-G01✓在册
POST/api/webhooks/noon/{path_token}webhooksNoon WebhookAC-EL-WEBHOOKS-G01—
GET/internal/api/v1/ads/spendinternal/apiAds SpendAC-EL-INTERNAL-G01✓在册
GET/internal/api/v1/finance/monthlyinternal/apiFinance MonthlyAC-EL-INTERNAL-G01✓在册
GET/internal/api/v1/order/sku-aggregateinternal/apiOrder Sku AggregateAC-EL-INTERNAL-G01✓在册
GET/internal/api/v1/order/statusinternal/apiOrder Data StatusAC-EL-INTERNAL-G01✓在册
GET/internal/api/v1/shared/fx-rateinternal/apiGet Fx RateAC-EL-INTERNAL-G01✓在册
POST/mcp(root)Mcp EndpointAC-EL-MCP-G01—
批C 对账结论:live GET 端点 217 个中 endpoint_registry 在册 202; 漂移(live 有·registry 无)0 个(15 个 live 未入册 GET 全部命中 exclude 豁免前缀=P2-26 设计豁免面:auth/backfill/health/notifications/onboarding/pipeline/team/tenant/ops-dlq,非漂移); registry-only(registry 有·live 无)0 个; 原 67 行/64 路径无 §11 锚(批C 时诚实挂账)→ 2026-10-25 批G-C2 组锚收口:19 个 AC-EL-{DOM}-G01 按域一锚覆盖全部 67 行(前端无独立页面或元素册未覆盖 API 面,单端点争议再拆条);2026-10-26 R11 门禁新立(§12 锚列零无锚零悬空防回退),400/400 有锚在案。

§13 全量审计与回归总纲(AC-AUD · 2026-10-26 立·当日成文版 PDF 收敛)

源=用户下发《完整系统审计 & 全量回归审计指令》(code_20261026.txt,10 条原则+三阶段,全文完整——终点=业务链路图末节「审计日志、追踪链路」)→ 同日成文规范《Zipforce Hub — 上线前全量审计与测试规范》PDF(20 节·Step 1–16·配套术语词典,10 页)为本节权威收敛版:AC-AUD-01~09 与其十条原则/层级模型/隔离/追踪/日志/遍历/组合/指标治理/纵向流逐条对应(PDF Step 1 架构测绘七台账→本库 §11 页面册+§12 接口册+metric_calibers 指标册+采集注册表任务册+sku_mapping 维度映射册承载);PDF 新增面=版本化(AC-AUD-10)/后台任务(11)/回溯(12)/指标分级(13)/风险分级(14)/回归验收序(15)/报告模板(16)。执行顺序=PDF Step 16 十步(架构测绘→静态台账核对→E2E 全页遍历→接口越界隔离→后台任务→回溯对账→双日志 Trace 核验→横向抽样比对→全量回归→UAT)。经与本库逐条比较后成尺:隔离与横向的实体标准单源于 §6(本节只引用不重复定义);本节载方法论铁律——审计角色、归属链、追踪、日志、遍历、组合、指标治理、纵向业务流。审计执行记录仍归 audit.html。
ID对象验收标准验证方法状态
AC-AUD-01审计角色与真值纪律审计线只审计、只识别风险、只出证据与结论——不生成、不执行、不落地任何修复代码/配置/变更(修复走独立批案,且遵守本库「标准先于代码」序);以系统真实测绘为基准零假设——不预设容器数、页面数、任务数,先测绘再校验;审计数字先复算后采纳(页首三纪律②)。过程纪律;审计档案(audit.html)内数字均带独立复算记录生效 reg:—
AC-AUD-02层级归属链·禁逆向业务层级固定顺序自上而下:企业→平台→品牌→销售模式(直营 direct/代理 distributor)→国家/区域→SKU;所有订单、财务、广告、库存、采集、报表、权限必须绑定该链路;下游实体(订单、SKU)不得反向推断、覆盖上游归属。SKU 宇宙唯一事实源=sku_mapping(禁逆向捕捉);品牌归因纠正唯一实现=AC-CAL-11 三路。归因 SQL 复算(AC-CAL-11 口径);逆向推导路径存在性=零生效 reg:—
AC-AUD-03多维隔离+横向一致(引用条)六维(企业/平台/品牌/销售模式/国家/SKU)任意维度组合必须正确切分——不串、不漏、不混算。实体标准单源于 §6:AC-SEC-08~12(隔离五条)+AC-SEC-07(同平台横向结构强制一致,R10 执法)。风险分级:企业间数据串扰/越权读取=严重;无业务正当理由的报表结构或计算公式不一致=高风险(正当理由仅=未注册平台,见 AC-SEC-07)。pen_tests 三企业越权面 + ruler_recon R10(既有门禁)生效 reg:—
AC-AUD-04TraceID 全链贯穿全部请求、前端操作、API、后台任务、采集、结算、回溯、定时任务携带全局追踪 ID 贯穿链路,服务边界不丢不断。as-built(zlog,api/main.py:171-185):外部 X-Request-Id 优先采纳否则新生成、响应回带;trace_id/span_id 走 contextvars;子进程经 ZLOG_TRACE_ID 领养(采集链 /collection/run.py 完整);arq 任务 @job 装饰记 trace_id;audit_log 每行携带。缺口清零(2026-10-26「挂账全干」):①web 前端携带=P2-35(2026-10-23, web/components/kit.tsx 一次性 fetch 补丁: 全部 /api/ 请求注入 x-request-id=标签页种子 sessionStorage.zf_trace, 响应 id 领养回存, 页面直呼 fetch 同覆盖);②DB 会话级标注=api/core.py _TracePool(getconn 时 set_config application_name=<svc>/<trace_id>, api 25 连接+worker 面 tasks.py 同款子类; pg_stat_activity/PG 日志 %a 归因可见, 端到端实证外部头→会话名恒等)。缺口面在册清零为终态。采样请求跨 api/worker/采集子进程 trace_id 恒等复算;缺口面在册清零为终态生效 reg:—
AC-AUD-05双日志分离两套独立日志不可混淆:①开发运维日志=stdout 单行 JSON(docker 滚动切割,zlog 五级);②企业使用审计日志=saas_registry.audit_log(tenant_id/user_id/action/resource/trace_id)。zlog 四分类 access/business/audit/exception 各归其道;ERROR/FATAL best-effort 永久留存(action 前缀 applog.* 与业务操作前缀分离,同表不混义);敏感键与邮箱/bearer 递归脱敏;日志异常自身吞掉——日志永不打崩业务。PDF 必填字段口径(Step 9):企业使用日志=日志ID/RequestID/TraceID/企业ID/账号/操作人/操作时间/操作页面按钮/操作类型/入参/返回结果/操作状态/平台/品牌/销售模式/国家/SKU,不可篡改、持久存储、按企业与链路 ID 双检索、不可随意删除;开发工作日志=日志ID/操作人/时间/变更对象/变更前/变更后/变更原因/版本号/TraceID;上报失败必须有兜底(操作成功日志丢=缺陷);日志查询守企业隔离。as-built(2026-10-26 迁移145 已修,AC-REQ-18):audit_log 补维度五列(platform/brand/sales_mode/country/sku)+middleware query 提取→audit()/_audit() 尽力填充(存量不回填不造值)audit_log 行结构与 action 前缀分布抽查;脱敏规则对拍;两类日志抽样零混流生效 reg:—
AC-AUD-06全覆盖遍历台账页面/Tab/弹窗/对话框/按钮(创建、编辑、删除、导出、刷新、回溯、结算、重试、批量)/筛选组件(单条件、多条件、区间、多选、组合)/表格(列、排序、分页、合计)/图表(指标、维度、聚合、时间粒度)/权限分支/后台任务,全量入台账逐一核验,不只覆盖高频路径。台账本体=§11 逐页元素全册(§11.1–§11.40);桌面+移动双视口;跨企业/平台/品牌/销售模式/国家/角色各形态遍历;新增页面元素同批入册。PDF 台账字段映射(Step 2):page_id/route/element_type/element_id/element_name=§11 ID/前缀域/类型/元素列与 §11.0 路由表;permission=付费模块门 mod 字段+AC-SEC 系列(非逐元素散写);data_source/metric_ids=定义列数据源与 reg:idN 锚(↔metric_calibers R1–R3 双向恒等);dimensions/supported_combinations=AC-AUD-07 七类基准组合矩阵;audit_logged=写面操作经 audit_log(AC-AUD-05);traceable=AC-AUD-04 全链(页面直呼 fetch 同覆盖)。字段不缺席、承载面归口单一。§11 册内条目 vs 线上路由/元素探针对账;frontend_e2e+dashboard_audit(既有门禁)双视口断言生效 reg:—
AC-AUD-07组合场景覆盖所有多条件筛选、多维交叉查询、边界值、空值、极值、多平台/多品牌/直营+代理合并与拆分场景都要核验。七类基准组合:①六维全链×直营 ②六维全链×代理 ③企业+多平台×双模式 ④企业+多品牌×双模式 ⑤企业+平台+全部国家 ⑥企业+平台+全部 SKU ⑦品牌×时间范围×筛选条件。核验面=正确数据集、无遗漏维度、无他企业/品牌/国家混入、计算正确、导出与页面与接口三面一致。e2e/dashboard_audit 组合矩阵扩面;组合查询 SQL 复算;导出 CSV 对拍生效 reg:—
AC-AUD-08指标字典治理指标字典本体=metric_calibers 注册表:每指标记名称/业务含义/完整可核验公式/数据源/更新频率/是否区分直营代理/是否区分平台品牌国家/是否支持回溯重算/是否跨企业(禁)。同一指标多处出现→公式、单位、聚合方式恒等,消费端禁第二处口径 SQL(R5 内联清零);字典外「临时看板/临时指标」=风险即挂账;财务、结算、退款、广告指标的特殊分支必须入册(未文档化特殊分支=风险)。PDF 注册表字段对照(Step 4):metric_id/name/description=formula 所在 §1 口径条+calibers(metric,note);formula_version/dependencies/owner/change_log 承载=audit_base_ref 锚+decision_date+audit.html 台账(版本化结构化承载见 AC-AUD-10 挂账);dimensions/sales_mode/refresh_strategy/retro_supported=filters jsonb+§1 条目语义(直营/代理区分=AC-SEC-09 铁律)。ruler_recon R5 契约全绿;metric_calibers↔§1 口径条双向锚(R1–R3);临时指标扫描=零生效 reg:—
AC-AUD-09纵向业务流核验沿完整业务链逐环节核验状态流转、计算、回冲、对账:企业接入→平台绑定→品牌配置→销售模式→国家/站点→SKU 维护→订单采集(付款/未付款)→结算→退货/退款(含部分退款、多次退款、金额回冲、状态回转)→财务/广告/库存/利润指标→看板/明细/报表/导出→数据回溯(历史重算、快照比对)→审计日志与追踪链路。识别逻辑断层、公式错误、对账不一致=缺陷;回溯重算保留原始快照、可比对新旧结果。caliber_recon 跨层对账(AC-GATE-01);回溯重算前后快照比对;退款回冲复算生效 reg:—
AC-AUD-10指标公式版本化与变更纪律每次修改指标公式必须生成新版本而非直接覆盖旧定义(PDF Step 4.3):旧报表/旧任务/旧缓存绑定旧版本不漂移;新使用方绑新版本;回溯任务可选用公式版本执行;注册表变更写入开发工作日志(变更人/时间/原因/前后值/版本号)。as-built 差距挂账:现版本语义=迁移(pg-init 台账)+calibers.decision_date+audit.html 台账三件承载,非结构化 formula_version 列——metric_calibers 加版本列与旧版快照留存归后续批案(迁移面)拍板,未落期间口径变更纪律不变(标准先于代码+台账留痕)。calibers 变更行数=迁移台账行数对账;版本快照存续抽查;变更日志字段完备性生效 reg:—
AC-AUD-11后台任务审计(Cron/队列/Worker)全部定时/队列/抓取/结算/退款回冲/预计算/归档/回溯任务:①执行绑定企业上下文与维度(缺=严重);②携带 TraceID 日志可串联整链(缺=高);③计算逻辑引用指标注册表禁独立硬编码公式(违=高);④调度时间/间隔/重试次数/超时阈值配置明示(缺=中);⑤失败重试区分可重试与不可重试、禁无限重试脏数据(无区分=中高);⑥执行前后写日志记入参/输出/耗时/状态(缺=高);⑦并发控制防同企业同任务重复跑造成重复计算重复结算(无锁=严重);⑧任务隔离 A 企业任务不得读写 B 企业数据(越界=严重)。测试场景七类:超时/异常中断/多次重试/并发同任务/跨零点定时/改版本后旧任务沿用旧版/回溯重跑不污染在线数据。任务台账=worker functions+cron 注册表+采集注册表三方对账;_arun/collection_runs 账本抽样(trace/耗时/状态);并发锁存在性 grep+重复结算零实证生效 reg:—
AC-AUD-12数据回溯审计(重算非改)回溯=对历史周期按公式版本重算指标与结算,不是修改原始订单数据——原始记录保持不变,重算结果单独存版本快照。硬性规则:绑定企业/平台/品牌/销售模式/国家/SKU 六维;可选择指标公式版本执行;单独写审计日志(操作人/时间/范围/版本/TraceID);重算过程可暂停、可预览,确认无误后再覆盖报表快照;不得逆向修改上游原始抓取订单明细。校验:全平台订单回溯支持(不支持=业务能力缺失);退款/退货重算后结算利润与广告指标对齐(不齐=缺陷);回溯资源隔离不影响在线查询(抢占=高);新旧版本快照可对比(无对比=中);普通企业不得可随意发起大范围全量回溯(无权限管控=高)。backfill 面(backfill_ad/recalc_order_metric/mirror_runs)操作前后数据快照比对;回溯行审计日志完备性;回溯任务与在线查询资源隔离观测生效 reg:—
AC-AUD-13指标分级与瘦身治理看板指标全量分级(PDF Step 12):P0 核心指标=首页概览/企业最常用必须保留;P1 业务指标=运营高频单独业务报表页;P2 辅助指标=少数场景入高级查询/自定义报表;冗余指标=重复/已废弃/公式与其他指标完全一致者直接移除。硬性规则:同一指标全报表看板逻辑统一(横向一致性);报表禁私实现计算逻辑全部读指标注册表;报表缓存绑定指标版本公式更新后刷新策略明确;企业自定义看板/报表仍守企业与维度隔离。审计内容:梳理全部看板图表表格形成指标台账标记保留/下线;下线指标不得仍在后台定时计算占用资源(发现=缺陷即清理)。metric_calibers×§11 图表条目×后台任务清单三方交叉:下线指标零后台引用;P0/P1/P2 分级标记覆盖率;缓存键含版本要素抽查生效 reg:—
AC-AUD-14风险分级标准(四级)严重=可越权跨企业跨维度取数/核心公式错误/权限完全失效/日志完全丢失/数据可逆向篡改——阻断上线;高=TraceID 断链/公式多处不一致/定时任务无锁易重复结算/回溯不可用/缺必要审计日志——必须修复且修复后重新回归;中=缺版本记录/重试策略不合理/指标台账缺失/页面交互偶发异常——限期修复;低=UI 文案排版次要提示优化——不阻断。与既有 P0/P1/P2 运维分级并存口径:P0 晨检面≈严重+高风险自动化哨兵;P1/P2 审计发现项按本条四级归档;处置要求随级生效。审计档案(audit.html)逐风险行带级别标签;严重/高项挂账-修复-回归闭环核验生效 reg:—
AC-AUD-15回归·验收序与 UAT全量回归=每次版本上线遍历全部页面/按钮/弹窗/筛选组合/后台任务/结算退款/回溯整套业务重跑,非只测改动模块;E2E=模拟真实企业从页面操作到后端计算落库报表展示全链;双视口 E2E=桌面+移动分别执行校验响应式展示交互数据一致;UAT=业务运营人员以企业身份模拟真实业务场景验收。测试顺序八步固定:架构测绘→静态台账核对→E2E 全页面遍历→接口越界隔离测试→后台任务测试→回溯对账测试→全量回归→UAT 验收。frontend_e2e+dashboard_audit 双视口门禁(AC-GATE-04 串行律);版本上线检查单含八步顺序勾验;UAT 记录归 audit.html生效 reg:—
AC-AUD-16审计输出报告模板审计产出固定八件套(PDF Step 15):①报告头部(审计时间/范围/企业样本/版本号);②架构测绘台账(容器/API/后台任务/页面元素清单——本库 §11/§12/任务册承载);③风险汇总(等级/位置/现象/证据/影响范围/建议——只描述问题不写修复代码方案);④对账结果(抽样对账一致性);⑤日志校验结果(两类日志+Trace 链路完整);⑥隔离测试结果(越界访问测试);⑦回归测试结论(是否可上线);⑧附录(抽样测试用例清单)。审计档案本体=audit.html(链接不变原则),报告模板字段完整性以本条为尺。audit.html 结构对本八件套映射核对;每审计批条目含证据与复算记录(AC-AUD-01)生效 reg:—

§13.1 配套术语词典(PDF 附录)

与《上线前全量审计与测试规范》配套术语逐条对应,本库口径单源不另造:
术语定义(PDF)本库承载
SaaS多企业软件服务六容器 zipforce-saas-*
企业独立客户账号zf/onno/fg 三企业(RLS)
租户→企业2026-11-14 用户拍板叫法切换(词换、码不动、史不改):旧档/PDF 中「租户」即今「企业」物理层不改(tenants 表/schema 名/RLS 政策/API 报文/标识符);同日二次拍板已清 UI 残留(_shot_1002 断言四行同步换),仅标尺内 API 报文引文保原文;映射 izero↔zipforce / foncye↔onno / vnique↔fittingirls
直营 direct自营销售模式AC-SEC-09 铁律2
代理 distributor代理商销售模式AC-SEC-09 铁律2
TraceID整条业务链路追踪编号AC-AUD-04(zlog contextvars)
RequestID单次请求编号AC-AUD-04(X-Request-Id)
E2E端到端测试AC-GATE-04/e2e 门禁
全量回归全部功能重新测试AC-AUD-15 八步序
指标注册表指标公式唯一数据源metric_calibers(AC-AUD-08)
回溯历史周期按公式版本重算指标与结算AC-AUD-12(backfill 面)
Cron定时后台任务arq cron_jobs 注册表
Worker异步队列执行任务zipforce-saas-worker-1(80 functions)
横向一致性不同企业同指标计算逻辑统一AC-SEC-07+R10 门禁
纵向业务流上游原始数据向下单向流转AC-AUD-02/09

§14 上线需求尺全册(AC-REQ · 2026-10-26 立 · PDF《上线前全量审计与测试规范》需求面提炼)

定位:与 §13 AC-AUD(审计方法尺——怎么审、怎么验收)互补,本册=需求尺——系统本身必须满足什么/禁止什么,上线验收时逐条对照打状态(✅满足/⚠️部分·挂账)。26 条自 PDF 20 节的硬性需求条款提炼(§2 层级与隔离/§6 API 职责约束/§8 数据库层校验/§9 纵向流硬性约束/§11 回溯硬性规则/§12 两类日志/§13 链路追踪/§14 组合一致性/§15 报表治理),每条注 PDF 出处与 as-built 承载归口(AC-SEC/AC-CAL/AC-GATE/R 门禁/组件面)。方法尺管审计作业规范,需求尺管系统合格标准——验收结论=需求尺逐条 ✅ 或挂账在案。
ID需求条款(系统必须/禁止)PDF 出处as-built 承载状态
AC-REQ-01层级模型六层固定:企业→平台→品牌→销售模式(直营/代理)→国家→SKU 顺序固定,业务流/数据流自上而下单向生成,禁逆向推导或越界访问§2.1/§2.3AC-SEC 系+ops.py 级联+sku_mapping 宇宙(AC-AUD-02 纵向流核验)✅
AC-REQ-02企业隔离:企业间数据/业务/报表/结算/日志严格隔离——不能读取/聚合/修改他企业数据§2.2RLS 98/98 表 ENABLE+FORCE+AC-SEC-01+越界攻击测试面✅
AC-REQ-03平台隔离:同企业下不同平台的指标/订单/广告/库存独立,数据与权限双隔离§2.2{tenant}_{platform} schema 分域+RLS+R10 横向列构门禁✅
AC-REQ-04品牌独立核算:同平台下品牌独立核算、独立报表、权限隔离§2.2brand 维度+useBrand 本企业+RLS 行级✅
AC-REQ-05直营/代理双路径:使用不同结算/佣金/利润/退款公式,两套计算路径分别存在、分别核验§2.2/§7.2AC-SEC-09+metric_calibers sales_mode 区分+AC-CAL 系口径✅(onno 采购成本行=R24 线挂账)
AC-REQ-06国家规则独立:币种/税费/合规/汇率/本地化规则按国家独立生效§2.2fx 汇率面+noon rankings sa/ae 目录级口径+AC-CAL-18 税差对齐✅
AC-REQ-07SKU 六维绑定:选品/库存/广告/订单/销售/退货全绑定正确维度组合§2.2sku_mapping 宇宙唯一事实源+R9 级联纯净度双向执法✅
AC-REQ-08维度联动经映射表:指标依赖映射维度必经映射表解析,禁硬编码维度§2.3sku_mapping+R9+AC-PEND-02 谓词派生(禁逆向捕捉)✅
AC-REQ-09指标注册表单一事实源:看板/报表/表格/图表/结算/退款/回溯/导出/REST API 全部由注册表驱动;业务指标公式禁散落在接口/前端/定时任务,任何一处硬写=高风险§1.2/§6.1metric_calibers 37 行+R1-R3 双向锚+R5 内联清零+AC-CAL-17 展示页禁公式✅
AC-REQ-10页面权限+数据行权限双控:权限不能只控「能不能打开页面」,必须同时控数据行——拿到接口也读不到非本企业/维度数据§6.4mod 付费模块门+RLS 行级+API 企业绑定(AC-SEC 系)✅
AC-REQ-11导出隔离:导出与页面同走企业与维度隔离,禁导出越界数据§6.4导出端点全经 API 层(§12 册)+RLS✅
AC-REQ-12后台任务绑定企业:任务执行时绑定企业上下文,禁后台绕过隔离§6.4/§10.2tasks.py _arun 账本+RLS+AC-AUD-11 八条校验✅
AC-REQ-13数据库层隔离兜底:业务表含企业 ID+维度字段;后台查询强制带企业与维度条件;禁无企业条件的通用聚合;审计日志同绑定企业——应用层出 bug 也不轻易跨企业泄漏§8.4RLS ENABLE+FORCE(应用层之外的库层兜底)+audit_log tenant_id(维度五列挂账见 AC-REQ-18)✅
AC-REQ-14纵向流单向:原始采集→清洗规整→指标计算→订单汇总→结算生成→退款/退货调整→报表输出;下游报表/结算禁反写上游原始业务数据§9.1audit.cleaned_* 消费面分层(原始层只进不改)+AC-AUD-02✅
AC-REQ-15上下游对账恒平:上游明细汇总后与下游报表/结算金额匹配——正常订单/部分退款/全额退款/跨周期退货/多平台合并/直营代理分开六场景§9.3AC-GATE 对账门禁+catalog_sales 滞后判+晨检第 6 面数据完整性对账✅
AC-REQ-16回溯=重算非改原始:原始订单记录保持不变,重算结果单独保存版本快照;六维绑定+可选公式版本+独立审计日志+可暂停可预览确认后覆盖+不逆向改上游+资源隔离+权限管控;全平台订单回溯为全企业通用能力§11.1/§11.2AC-AUD-12(标准面)+backfill 重算面+audit_log before/after 留痕✅标准在册(backfill 能力面按 AC-AUD-12 场景对照,新面立项先过本尺)
AC-REQ-17两类日志分立:企业使用日志与开发工作日志两套严格分开、存储不混§12/§12.3audit_log(action 前缀 applog.* 与业务操作前缀分离,同表不混义)+zlog 四分类+audit.html 开发台账✅(语义分立承载;独立库面=随 AC-REQ-18 迁移批)
AC-REQ-18企业使用日志 17 必填字段+四要求:日志ID/RequestID/TraceID/企业ID/账号/操作人账号/操作时间/操作页面按钮/操作类型/入参/返回结果/操作状态/平台/品牌/销售模式/国家/SKU;不可篡改、持久存储、按企业与链路 ID 双检索、不可随意删除§12.1audit_log 已有 id/trace_id/tenant_id/user_id/action/resource/ip/created_at/before/after✅2026-10-26 已修(用户令「修复修复」,迁移145):五列落库+middleware query 提取→contextvars 兜底+audit()/_audit() 显式 dim 参数(存量行不回填不造值;sales_mode 覆盖=渐进补点;端到端实证 verify.acreq18 行五列落值)
AC-REQ-19开发工作日志 9 必填字段:日志ID/操作人/操作时间/变更对象/变更前/变更后/变更原因/版本号/TraceID§12.2audit.html 台账+迁移台账+metric_calibers decision_date/audit_base_ref 三件承载✅(载体=台账制度)
AC-REQ-20日志上报兜底:上报失败必须有兜底——操作成功但日志丢=缺陷§12.3zlog 异常自吞不阻断业务+audit_log 与业务同事务写✅(同事务=强兜底;异步面无独立重试队列,如实注记)
AC-REQ-21日志查询守隔离:企业只能查看自己的操作日志§12.3audit_log RLS+API 企业绑定✅
AC-REQ-22TraceID 全链透传:前端生成/接收→API→内部服务→队列/定时任务继承→所有日志/数据库记录/回溯记录绑定 TraceID;UUID 全局唯一不可伪造;任一环节丢失=高风险;同一业务操作可经 TraceID 一次性检索全链§13.1/§13.2/§13.3P2-35(kit.tsx fetch 种子 X-Request-Id)+zlog_access_middleware 采纳+contextvars+_TracePool application_name(AC-AUD-04 端到端清零实证 verify-aud04-26)✅
AC-REQ-23筛选四方一致:同一套筛选条件下,页面表格/图表/导出文件/后端直查四方数据恒一致;不一致=高风险,组合漏数据/带出越界维度数据=严重§14.2/§14.3AC-AUD-07 七类基准组合矩阵+AC-EL 数据源列+e2e 门禁✅标准在册(组合测试持续执法)
AC-REQ-24报表禁私算+缓存绑版本:报表不能私自实现计算逻辑,全部读取指标注册表;缓存绑定指标版本,公式更新后刷新策略明确§15.2R5 内联清零+AC-CAL-17+AC-AUD-10 版本化✅2026-10-26 已修(迁移146):formula_version text NOT NULL DEFAULT 'v1',37 行机器可读版本锚;改公式必生新版本号(禁覆盖),三件承载(迁移+decision_date+台账)不变
AC-REQ-25自定义看板守隔离:支持企业自定义看板,但自定义报表仍遵守企业与维度隔离规则§15.2as-built 暂无企业自建报表功能——本尺为该面上线前置约束✅(无该面=无违例;未来上线必守)
AC-REQ-26下线指标禁空转:已下线/冗余指标不得还在后台定时计算占用资源§15.3AC-AUD-13 分级治理+arq cron 册(80 functions 全注册可对照)✅标准在册(分级标注=AC-AUD-13 面)
AC-CAL-31finances 正本面结构门禁(四检查)
(2026-11-09 用户令「finances 面门禁立项,现在做」;起因=9.184 fg 正本 74% 马甲重复数月无灯可见)
正本 {schema}_spapi_finances 四结构不变量:①马甲指纹——脱 MarketplaceName 指纹 md5(event_data-'MarketplaceName') 按(单号 COALESCE∪型∪日 COALESCE∪指纹)分组叠组=0(亚马逊每市场拉取给同一事件穿当地马甲,全文 md5 防不住,fg 9.184 之病)②哨兵日期 posted<1990 行=0(epoch 占位)③国别合法——非空 country ∈ MP_NAME 已知集(16 国 as-built 快照,正本国别只认事件自带市场名不虚构)④跨国民警——同脱马甲指纹现于>1 国=0(马甲铁证)。配套唯一索引已换脱马甲口径(fg,9.184)。tools/finance_face_recon.py 每夜执法(宿主 21:41 UTC=北京 05:41,四层审计后);口径派生 metric_calibers reg:id62(缺行退码 2,口径先于代码)数值真源 reg:id62生效
AC-CAL-32应收·H 甲已售未出(回款待收)口径
(2026-11-13 用户「都授权」批;metric=receivable,决策 2026-11-13,formula_version v1;取号=现查 31 为最大已用)
近 30 天窗口有效订单(xc_amz id4 剔取消)中,结算成员键 (brand, amazon_order_id) 不在结算面(NOT EXISTS audit.cleaned_settled_orders)的订单计待收——面=单数+面额(USD,订单面 revenue_usd 原值直读求和=甲拍板 AC-CAL-17 豁免);结算面截至日=max(posted_date) 随卡披露。权威源=audit.cleaned_settled_orders(结算明细单号纯集镜像;源=center_warehouse {schema}.spapi_settlement_items 注册表派生)。成员判定键=(brand, amazon_order_id):三 schema 品牌纯集已实证(2026-11-13 逐行验证,零空 brand/零跨 brand)故双键≡单号纯集;空/0 单号聚集行不入面(哨兵体检实证 izero 1,426 行)。代卖边界:EU onno 代卖若经 izero 账号结算,源侧盖 brand=zipforce 落 zipforce 面——仅多增结算成员,待收看可见订单反查,多余成员永不触发(无害)。metric_calibers id66 注册表驱动(2026-11-13 22:09 UTC 落库);h_preview 预演三租户真值在案(T1 336单/$4,724.73 · T2 53单/$1,142.76 · T3 696单/$13,364.57);face=public.settled_orders 过滤器派生数值真源 reg:id66生效
AC-CAL-33月度对账时点规则(结算滞后收敛)
(2026-11-15 用户令「第一修,第二怎么避免」+「干」;起因=#114 十月对账 AE 佣金 12.42/US 尾程 9.99 两处滞后差定谳)
月度对账(库 ⊗ Amazon 报表/面板导出)终对账时点=次月结算窗关闭后(Amazon 结算窗 14 天一窗+48h 入账滞后,月末单尾款要到次月窗才落结算面),实操不早于 M+1 月 15 日。提前对账只出「预对」:滞后类差异(佣金 ServiceFee 行/尾程费未落结算面)标「滞后收敛中·跟踪」不当缺陷立案——实证:US 十月尾程差 9.99 在 47→62→77→97.33 四轮单调收敛(2026-11 复对过程)。ServiceFee 未采行不属本条(AC-CAL-30 采集器已挂档 night 39/52 自动进来,未采≠滞后)。对账记录必标时点戳(对账日 vs 结算面 max(posted_date) 覆盖检查);滞后类差异逐轮跟踪收敛曲线,收敛完成才终谳数值真源 reg:—(流程性口径无注册表数值)生效
AC-CAL-34Amazon 面板对账换算四口径(先换算后比对)
(2026-11-15 用户令「第一修,第二怎么避免」+「干」;起因=#114 十月对账 SA/AU 口径差定谳)
库 ⊗ Amazon 侧(报表导出/面板显示)比对前先按四口径换算,未换算直接比=假差异:①窗边界——库按 UTC 日切,Amazon 报表按本币本地时区窗切,月首/月末 24h 窗边单先按 Amazon 侧时区重切再比(实证:SA 十月营收差 154.05=09-30 单 403-1461438 计 71.98 + 11-01 单 408-6890640 计 82.07,两单窗边归属);②AU GST 含税显示——Amazon AU 面板显示含 10% GST 而库为不含税,AU 侧 ÷1.1 后再比;③汇率源——Amazon 报表导出 USD 额用其内部汇率,库 revenue_usd 用库侧汇率源,比对前 Amazon 侧本币额按库侧同源汇率重折 USD(AU 实测口径差 +1.6%);④多渠道单——Amazon 报表含多渠道配送单(S03,非 Amazon 订单面单),库按 SP-API 订单面不含,比对前 Amazon 侧剔 S03 多渠道行(AU 实证 5 张)。换算后残差才立案。对账流程按四口径先换算后比对(换算记录随对账留档);换算后残差 > 平阈(对齐 AC-CAL-18 ±1 USD 惯例)才立案数值真源 reg:—(操作口径;四口径实证数据在 changelog #114 定谳记录)生效
AC-CAL-35Amazon 净利率口径公式钉死
(2026-11-15 用户令「补」;起因=AC-GATE-09 FIN-02 门首跑 zipforce 2026-04/05 红旗复核问答中暴露「阈值有册、公式无册」缺口)
净利率=Σ(net_profit_usd)÷Σ(revenue_usd),月粒度 brand×marketplace×mon(表=finance_monthly)。净利=结算收入−|平台总费用|−|促销返拨|(行级 COALESCE(net_usd, 本式÷入账日 fxd 汇率)折 USD),服务费(spapi_service_fees)按月×区域收入占比摊入。费用边界:只含平台侧结算扣费(佣金/FBA 四项费 unit·order·weight·fulfillment/促销返拨/其他结算费/摊入服务费),不含采购货本、头程、广告费——语义=Amazon 回款净额率,非含货本的会计净利(该口径下 50%+ 属常见区间)。scope=Amazon 全站点结算事件(SP-API Finances→各账号 schema spapi_finances;fg 型=finances_view 扁平视图,principal+shipping−14 项费用);noon 不在本口径(noon_sku_pl_monthly 另册)。阈值仍派生 id34(flag_ratio=0.5,action=超阈视为口径嫌疑→人工复核)——本行补的是 id34 未登记的分子分母与费用边界。缘起:直觉词「净利率」(会计净利)与实际口径(回款净额率)错位此前无任何册面文字拦截,数据字典 net_profit_usd 描述仅「净利 USD」四字。公式与 api/sync_source.py _FIN_BRANCH(:221)/_FIN_BRANCH_VIEW(:277) 模板逐项对照(2026-11-15 实读锚定);执法=audit_baseline_gate FIN-02a2 断言 id67 行在册且 excludes 含边界锚串(册行漂移=门红);数据字典 net_profit_usd 描述同步补边界数值真源 reg:id67(公式/excludes/scope/truth_anchor 全量入注册表;消费端=audit_baseline_gate FIN-02+数据字典)生效
AC-OPS-08采集/审计档期=北京凌晨带(链序保全)
(2026-11-09 用户令「全部改到北京时间的凌晨,具体时间你来确认」)
全链落北京 00:00-06:00(UTC 16-22):结算链周一 01:10 → sales 01 档 → night 03 档 → 入库 03:30 → keepa 05:10 → 排名 05:20 → 报警 05:45-58 → 清理 06:07-37 → 晨检 06 点档;晨报族(北京 07 点前就绪)与日内半点/小时增量不动。链序铁律:采集→入库→校验→报警→清理相对次序不可倒。三系统联动改(collection_schedule+tasks.py arq+host-crontab.txt 镜像防漂移),**改后必 docker inspect 验 StartedAt(up -d 无配置变化=空刀,9.189 教训)**。host-crontab.txt 逐字节镜像+cron_audit 防漂移;tasks.py 改后 worker 必 build+up 真重载台账 9.182/9.189生效 reg:—(纪律型无口径行)
§ 全栈最细颗粒度审计需求总册(2026-11-09 用户令「包括但不限于每一个按钮每一个选择器每一个填空每一个chart每一个表每一个企业每一个平台每一个国家每一个sku」;起因=当晚四事故全在审计盲区)
总则:审计=全栈逐值校验,非抽样巡检。每一个可验证点(页面×元素×企业×品牌×平台×国家×SKU×层级)从 Amazon/Noon API 原始响应→采集入库→清洗面→API 端点→浏览器 DOM 逐层追溯,链上任何一环断裂或走样都能定位到那一环。验证矩阵从注册表+文件系统+DB 自动发现(禁手写),新品牌/平台/国家注册即自动纳入审计面。
一、数据层(D1-D10)逐行逐列逐值
AC-AUD-D1逐值追溯每个 SKU×每个国家×每个指标,从 API 原始 JSON→采集入库→清洗面→端点→DOM 逐层核对值不变。抽样率≥0.1%,关键面(库存/费用/销售)≥1%fullstack_d1_trace 已建+全量跑 10/10 四层一致(2026-11-10 audit-26 终验;L4 显示容差 0.05、L3 严格)cron 夜档✅
AC-AUD-D2共享 FC 区域去重EU 泛欧(DE=FR=IT=ES=NL=BE=IE=SE=PL)同 SKU 库存精确相等;NA 北美(US≈CA≈MX)近似相等(容差≤5%);违例=虚增库存fullstack 已建cron 夜档✅
AC-AUD-D3独立 FC 区域校验UK/AU/JP/SA/AE 间同 SKU 库存无关联约束(相等=异常,需查源)fullstack_p3 已建cron 夜档✅
AC-AUD-D4唯一键有效每表按其唯一索引验零同键多行。**审计键=执法键口径(2026-11-10 ④案定谳)**:重复检查必须按表的执法唯一索引键(如 ServiceFee 族=uq_fg_settle_undated 六列无 posted_date)判真重复;粗粒度业务键(四列含 posted_date)仅作成分分析面——空壳行(金额列 NULL 断源存量)与无单号账户级多行为合法并存非违例(9.221/9.223)storage_fee_recon 核③ + fullstack_gap_close D4 面(ServiceFee 族已改六列键口径)reg:id60✅
AC-AUD-D5空值纪律缺失=NULL 不填 0;空 region 非池化行=0storage_fee_recon 核①reg:id60✅
AC-AUD-D6国别合法非空 country ∈ 该品牌市场集∪币国映射storage 核②+finance 核③reg:id60/62✅
AC-AUD-D7金额符号费用≤0、销售≥0、退款≤0(同列内符号一致)fullstack 已建cron 夜档✅
AC-AUD-D8日期合理1970<posted_date<now+1dfinance_face_recon 核②reg:id62✅
AC-AUD-D9马甲指纹md5(event_data-'MarketplaceName') 同键零叠finance_face_recon 核①reg:id62✅
AC-AUD-D10币国一致专表 region==CUR2CC[currency](EUR→EU 除外)横向一致扫平 9.174reg:id61✅
二、管道层(P1-P8)每个采集器每张表
AC-AUD-P1采集器覆盖注册的品牌×平台→config.ADAPTERS 有对应条目?缺=红(该有而没有的管道)待建(generate_tenant 对照)cron 夜档✅
AC-AUD-P2表覆盖注册的品牌×平台→schema 存在且行数>0?空表=红fullstack_p3 已建cron 夜档✅
AC-AUD-P3面新鲜度每张采集表 max(created_at/fetched_at) < now()-24h;清洗面 max(同步时间) 同理;费用分项面 max(mon) ≥上月fullstack 已建cron 夜档✅
AC-AUD-P4采集跑况每个采集器最近 24h 有 collection_runs 行且 exit_code=0pipe_audit—✅
AC-AUD-P5增量有效采集器 stdout 报 N 行→表增量==N(不多不少=无静默丢弃/无重复插入)fullstack_p3 已建cron 夜档✅
AC-AUD-P6凭证活性12 探针逐把钥匙打 LWA 端点credential_livenesscron 08:07✅
AC-AUD-P7代理出口每品牌出口 IP==钉死值(EXPECTED_IPS)exit-guard(每采集器每次)config✅
AC-AUD-P8调度注册表crontab 活动==host-crontab.txt 镜像(防漂移)cron_auditcron 22:25✅
三、API 层(A1-A7)每个端点每个参数
AC-AUD-A1端点存活351 个端点全返回 200/预期码audit_nodes夜审✅
AC-AUD-A2country 过滤生效传 country=X→返回只含 X 的数据(不传=全量);所有支持 country 的端点逐个验待建(2026-11-09 广告 KPI 事故)cron 夜档✅
AC-AUD-A3brand 过滤生效传 brand=X→返回只含 X 的数据fullstack_p3 已建cron 夜档✅
AC-AUD-A4platform 过滤生效传 platform=X→返回只含 X 的数据fullstack_p3 已建cron 夜档✅
AC-AUD-A5企业隔离企业 A 的 token→查企业 B 的数据=0 行(RLS 逐行验)tenant_isolation_audit夜审✅
AC-AUD-A6RLS 全覆盖每张表都有 brand_isolation 政策five_layer_audit夜审✅
AC-AUD-A7返回值一致API 返回值==DB 直查值(逐字段抽样核对)fullstack_p3 已建cron 夜档✅
四、UI 层(U1-U8)每个页面每个元素每个交互
AC-AUD-U1页面加载47 个页面全返回 200+有内容frontend_e2e(224 锚点)夜审✅
AC-AUD-U2按钮功能每个按钮点击→预期动作发生(暂停广告→状态真变了;导出→CSV 真下了)fullstack_u2_buttons 已建+44 页 1748 元素全分类跑:SAFE 215 测(FAIL 9 待修复线定性)、硬破坏 40 只登记不点(audit-26 安全设计);WRITE 面待 --execute-writecron 夜档✅(SAFE 层)
AC-AUD-U3选择器联动选国家→所有图表/KPI/表变;选品牌→数据切;选平台→内容切;每个选择器×每个选项×每个受影响组件待建(2026-11-09 广告 KPI 切国家不变事故)cron 夜档✅
AC-AUD-U4填空生效输入筛选词→行数减且匹配;输入日期→窗口切fullstack_p3 已建cron 夜档✅
AC-AUD-U5chart 逐点每个图每个数据点==API 返回值==DB 值chart_value_audit(80 图)夜审✅
AC-AUD-U6table 逐格每个表每行每列值==源数据(不是「表有数据」而是「这个格子是这个值」)fullstack 已建cron 夜档✅
AC-AUD-U7导出正确点导出→CSV 内容==页面显示fullstack_p3 已建cron 夜档✅
AC-AUD-U8CRUD 完整增删改→数据库真变了→页面刷新显示新状态fullstack_u8_crud 夜档实弹终证(2026-11-11 21:15 UTC=11-12 05:15 北京 夜档首绿 FAIL=0:A 采购单 11 PASS/B 深圳仓 5 PASS/C Mapping 8 PASS+清理零残留;时标勘误 2026-11-12:经 cron 宿主行 15 21 * * * 与 log mtime 21:15:45+0000 三证核实,UTC 值本正确非误标,原疑「北京 21:15 误标」撤回,仅补北京换算)cron 夜档✅
五、口径层(C1-C8)每条业务规则
AC-AUD-C1正副本对齐副本面 vs 正本面逐币累计差额,有备案理由→WARN 放行(不要求平要求对齐)storage 核④+gap_reasons 备案册reg:id27/60✅
AC-AUD-C2报表⊗专表报面值==专表税前折算值(税差参数族 AE/JP/SA/AU)storage 对账段reg:id27✅
AC-AUD-C3跨面勾稽overview.total == sum(detail) 逐面核对fullstack 已建cron 夜档✅
AC-AUD-C4费用分项国别sum(国家面) == sum(全量面)fullstack_p1 C3 已覆盖cron 05:05✅
AC-AUD-C5金额守恒采集增量==入库增量==页面增量fullstack_p3 已建cron 夜档✅
AC-AUD-C6SKU Mapping 一致每 SKU 的 brand==mapping 的 brand(全表逐行)fullstack_p3 已建cron 夜档✅
AC-AUD-C7币种不混同一面内不混加不同币种核④逐币reg:id60✅
AC-AUD-C8归属唯一每 SKU×平台×国家只有一个品牌归属fullstack_p3 已建cron 夜档✅
六、基础设施层(I1-I6)
AC-AUD-I1容器健康6 容器全 Up 且 healthyfive_layer_audit晨检✅
AC-AUD-I2磁盘<80%five_layer_auditAC-OPS-07✅
AC-AUD-I3cron 全跑21 条 cron 最近 24h 全有日志cron_auditcron✅
AC-AUD-I4代码卫生采集器零硬编码密钥/零 runpy/零语法错2026-11-09 横向一致扫夜审✅
AC-AUD-I5DB 连接连接池不耗尽、慢查询<阈值pipe_audit晨检✅
AC-AUD-I6备份每日备份成功+可恢复backup.sh+cron03:33✅
实施优先级:P0=D2+P1+P3+A2(今晚四事故直接对应);P1=U3+C3+D7(用户最易感知);P2=D1+U2+U6(覆盖面最广);P3=全部剩余。总验证点≈15,000+(47页×~50元素×3企业 + 351端点×~3参数 + 414表×新鲜度 + 37采集器×覆盖),每晚全量跑。验证矩阵从注册表自动发现(generate_tenant 对照),新品牌/平台/国家注册即自动纳入审计面,禁手写验证点清单。