| 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-03 | Noon 广告归因分层 | 总额/国家维度 = 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-04 | Amazon 广告归因 | campaign 级行(无 SKU)只进平台汇总与国家维度,禁进产品/SKU 明细(防伪归因空 SKU 组);SKU 级双源并集(sku 日表 + campaign 表 advertised_sku 非空行)。 | ads_analysis 产品/SKU 维度无空 SKU 组;双源合计=平台汇总 | 生效 reg:id1 | ||||||||||||||||||||||||||||||||||||||||||||||||||
| AC-CAL-05 | Noon 本币折 USD | Noon 金额行级按国家(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-06 | ACOS 健康线 / 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-07 | fm 三方对账口径 | 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-10 | SKU 宇宙 | 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-12 | noon 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 清单)。
| grep 源表直查(cleaned_ads_sku_daily 等)仅存于视图 DDL 与 ingest/clean 写面;caliber_recon 视图 vs 消费端 |Δ|≤$1;frontend_e2e+dashboard_audit 全过 | 生效 | ||||||||||||||||||||||||||||||||||||||||||||||||||
| AC-CAL-16 | Noon 有效件口径 (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-20 | Noon 评分/评论数口径 (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-21 | Amazon 星级分布(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-27 | Amazon 销量件数移除单过滤口径 (退回剔除/弃置保留,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-28 | Amazon 退款月表口径与国家码单源 (净额公式 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-30 | ServiceFee 专表国别标签口径(货币定标) (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 混排债挂账 |
| 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-04 | SKU 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:— |
| 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 |
| ID | 对象 | 验收标准 | 验证方法 | 状态 |
|---|---|---|---|---|
| AC-KPI-01 | KPI 卡池 | 每卡 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-03 | merged-kpi 双模 | rolling 与 calendar 两模式禁混标;切换即整体换基准。 | 双模式响应基准字段断言 | 生效 reg:— |
| 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-03 | RLS 三件套 | 每张 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-04 | staging 最细键 | 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-06 | docker exec heredoc | 凡 docker exec 送 SQL 必带 -i——不带时静默空跑且退出码 0(两次实证),DDL 后必须 to_regclass 回验。 | 操作规程(AGENTS.md 同条) | 生效 reg:— |
本节兼为全册铁律登记处(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-13 | AI 边界(指定 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) |
| ID | 对象 | 验收标准 | 验证方法 | 状态 |
|---|---|---|---|---|
| AC-GATE-01 | caliber_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-04 | e2e 串行律 | 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) |
| ID | 对象 | 验收标准 | 验证方法 | 状态 |
|---|---|---|---|---|
| AC-UI-01 | 口径说明元素 | 凡展示金额/比率/订单数的页面元素,同屏必带口径说明(脚注或 tooltip),且文案与 AC-CAL 条目一致——口径说明是 UI 的一部分,不是可选装饰。 | frontend_e2e 文案断言 | 生效 reg:— |
| AC-UI-02 | NoonTab 品牌参数 | Noon 页签数据请求必带品牌 prop(硬编码死锁 P1-1 修复后)。 | e2e 请求参数断言 | 生效 reg:— |
| AC-UI-03 | Settings 凭据面 | Settings 页凭据卡片必须渲染(字段齐全可保存)。tab 作用域:凭据列表只挂平台/服务商 tab,字段 tab 挂数据字典(ApiFieldsTab),大模型 tab 挂供应商卡(2026-10-21 #33 修复补述)。 | frontend_e2e 渲染断言(8b 随 tab 断言);2026-10-21 探针 PASS | 生效 reg:— |
| AC-UI-04 | 768 宽布局 | 首页 768px 视口无横向溢出。根因记录:5 列 KPI deck 卡内宽装不下换槽 select(108px 不可缩);≤980px 降 3 列,≤700px 降 2 列(2026-10-21 #33 修复补述)。 | e2e 视口断言;2026-10-21 探针 overflow=0px | 生效 reg:— |
| AC-UI-05 | frm/to 日期区间标注 | 双闭区间语义([frm,to] 拼接重叠 1 天属设计)必须前端标注"含首尾";非法日期输入 400 带原因(P3-2 已修后端)。 | frm=2026-13-45 → 400;UI 标注存在(首页+订单页 2026-10-21 探针 PASS) | 生效 reg:— |
| AC-UI-06 | ASN 输入校验 | 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:— |
| 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-04 | git 纪律 | 不经允许不 commit/不 push;门禁不接管道;secrets 只编程使用不打印值。 | 过程纪律 | 生效 reg:— |
| AC-OPS-05 | 发布面 | audit.html 链接不变、描述只增不删(审计档案);changelog 子域不动;本页(audit-base.html)=最终标准,可直接改写收敛、不作历史层积(2026-10-24 用户裁定),ID 永不复用。 | diff 审查 | 生效 reg:— |
| AC-OPS-06 | 破坏性 SQL | classifier 阻塞的破坏性 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 | 生效 |
| 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:— |
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-TODAY | 459 行 | 32 条(校对通过·全生效) | 已建 v4.5 |
| /orders | 订单页 AC-EL-ORDER | 175 行 | 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 |
| /noon | Noon 专页 AC-EL-NOON | 495 行 | 42 条(42 生效) | 已建 v4.4 |
| /logistics | 物流页 AC-EL-LOG(ASN) | 759 行 | 51 条(50 生效 / 1 待核) | 已建 v5.1 |
| /listings | Listings 页 AC-EL-LST | 1162 行 | 159 条(158 生效 / 1 未上线保留) | 已建 v5.1 |
| /rankings | 排名页 AC-EL-RANK | 718 行 | 84 条(84 生效) | 已建 v5.1 |
| /products | 产品页 AC-EL-PRD | 299 行 | 40 条(40 生效) | 已建 v5.1 |
| /inventory | 库存页 AC-EL-INV | 278 行 | 57 条(57 生效) | 已建 v5.1 |
| /mapping | 映射表页 AC-EL-MAP | 317 行 | 47 条(47 生效) | 已建 v5.1 |
| /po | PO 页 AC-EL-PO | 413 行 | 76 条(76 生效) | 已建 v5.1 |
| /projects | 项目页 AC-EL-PRJ | 709 行 | 64 条(64 生效) | 已建 v5.1 |
| /offsitepromotion | 站外促销页 AC-EL-OFF | 389 行 | §11.37 全页 65 条(65 生效)v5.1;§11.40 子组件列级 446 条(全生效)v5.4 | 已建 v5.4 |
| /settlement | 结算页 AC-EL-STL | 130 行 | 43 条(全生效·校对通过) | 已建 v5.0 |
| /settings | 设置页 AC-EL-SET(凭据/字段/大模型 tabs) | 236 行 | 24 条(全生效·校对通过) | 已建 v5.0 |
| /billing | 账单页 AC-EL-BIL | 205 行 | 33 条(31 生效 / 2 待核·校对通过) | 已建 v5.0 |
| /backfill | 回填页 AC-EL-BKF | 238 行 | 31 条(全生效·校对通过) | 已建 v5.0 |
| /database | 数据浏览器 AC-EL-DB | 183 行 | 20 条(全生效·校对通过) | 已建 v5.0 |
| /dictionary | 数据字典页 AC-EL-DIC | 145 行 | 23 条(全生效·校对通过) | 已建 v5.0 |
| /documents | 文档页 AC-EL-DOC | 140 行 | 24 条(全生效·校对通过) | 已建 v5.0 |
| /account | 账号页 AC-EL-ACC | 111 行 | 44 条(全生效·校对通过) | 已建 v5.0 |
| /team | 团队页 AC-EL-TEAM | 291 行 | 17 条(全生效·校对通过) | 已建 v5.0 |
| /ai | AI 助手页 AC-EL-AI | 110 行 | 48 条(47 生效 / 1 待核·校对通过) | 已建 v5.0 |
| /pipeline | 管道页 AC-EL-PIPE | 334 行 | 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-ONB | 310 行 | 13 条(12 生效 / 1 待拍板·校对通过) | 已建 v5.0 |
| /offboarding | 离场页 AC-EL-OFB | 80 行 | 55 条(全生效·校对通过) | 已建 v5.0 |
| /register ·/login ·/verify ·/welcome | 认证四页 AC-EL-AUTH | 388 行 | 3 条(2 生效 / 1 待深化·校对通过) | 已建 v5.0 |
| /promotion ·/upload | 跳转页 AC-EL-REDIR | 18 行 | 42 条(全生效·校对通过) | 已建 v5.0 |
| /en ·/training | 帮助两页 AC-EL-HLP | 238 行 | 41 条(40 生效 / 1 待核=价格分歧坐实·校对通过) | 已建 v5.0 |
| /privacy ·/terms ·/feishu | 法务/集成三页 AC-EL-LEGAL | 347 行 | 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 |
| 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-10 | KPI 概览·标题行 | 标题 | 📊 KPI 概览 + 使用说明 + ⓘ 口径说明折叠钮 | 说明文案="每张卡片右上 ▾ 可换指标 · 选择即保存到你的账号 · 随品牌 / 国家筛选联动";Ⓘ切换口径表显隐 | e2e 文案存在 | 生效 |
| AC-EL-HOME-11 | KPI 卡槽 ×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-12 | KPI 指标池(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-13 | KPI 卡值/脚注/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-14 | KPI ⓘ 口径说明折叠表 | 表格 | Ⓘ 展开的"各卡片计算方式"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-34 | Amazon 区块头 | 标题 | "📦 Amazon 平台 · USD · 订单级" | 仅 data.amazon 存在时渲染 | e2e | 生效 |
| AC-EL-HOME-35 | Noon 区块头 | 标题 | "🟡 Noon 平台 · SA / AE 本币分列 · 折USD 合计" | 仅 data.noon 存在时渲染 | e2e | 生效 |
| AC-EL-HOME-36 | Amazon 无数据空态卡 | 空态 | "该筛选下无 Amazon 平台数据" | platform≠noon 且无 amazon 数据时 | e2e 空品牌筛选 | 生效 |
| AC-EL-HOME-37 | Noon 无数据空态卡 | 空态 | "该品牌无 Noon 平台业务(Noon 为 SA / AE 两国)" | platform=noon 且无数据;NoonSection 内层空态(per_country/ads_30d/trend 全空)另有文案 | e2e | 生效 |
| AC-EL-HOME-38 | Noon 分国家·结算明细表(表级) | 表格 | 按国家分列的结算金额表,"本币分列不混加" | 数据=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 | 列 | 结算净额本币+折 USD | net_usd=null→"—" | 同上 | 生效 |
| AC-EL-HOME-43 | Noon 分国家·广告明细表(表级) | 表格 | 近 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 | 列 | 广告花费本币+折 USD | spends/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 | 生效 |
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-A01 | dailyRev·每日营收 | 图·line | 按天看销售额走势,识别增长或下滑拐点 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A02 | dailyCnt·每日订单数 | 图·bar | 按天看订单量走势,配合营收判断客单价变化;* = 当日进行中(半日) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A03 | dailyProfit·每日利润走势 | 图·line | 每天净利润(营收−平台费用)变化 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A04 | monthlyGmv·月度 GMV | 图·bar | USD | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A05 | monthlyNet·月度结算净额 | 图·bar | USD | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A06 | weeklyOrders·每周订单 | 图·bar | 件 · ISO 周 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A07 | weeklyRev·每周营收 | 图·bar | 按周看销售趋势,平滑日常波动 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A08 | cumRev·累计营收 | 图·line | 从区间起点到当前的累计销售额 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A09 | aovTrend·客单价趋势 | 图·line | 平均订单金额随时间变化 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A10 | hourly24·24小时订单分布 · 按品牌 | 图·bar | 最新数据日(订单表最大日)的逐小时单量 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图;x=00–23 时,series=品牌逐线,无品牌数据时补零线 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A11 | statusPie·订单状态构成 | 图·pie | Shipped / Canceled / Pending 等状态占比 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A12 | statusTime·订单状态随时间 | 图·stack | 各状态数量按月变化 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A13 | cancelRate·每日取消率 | 图·line | 取消订单占比走势,异常升高需排查 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A14 | shipCancel·发货 vs 取消趋势 | 图·line | 发货量增 + 取消量降 = 健康 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A15 | dow·星期订单分布 | 图·bar | 一周中哪天单量最高(广告投放参考) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A16 | hourDist·24小时订单分布 · 按品牌 | 图·bar | 最新数据日(订单表最大日)的逐小时单量 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A17 | promoTime·促销订单趋势 | 图·line | 促销订单(促销费>0)随时间变化 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A18 | fbaMfn·每日 FBA vs MFN 订单 | 图·stack | 两种配送方式每日单量 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A19 | valueDist·订单金额分布 | 图·bar | 订单金额区间统计 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A20 | multiSku·单 SKU vs 多 SKU 订单 | 图·pie | 一单买一个 vs 一单买多个 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A21 | aging·发货时效分布 | 图·bar | 已发货订单从下单到发货的等待天数 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A22 | monthCancel·月度取消数 | 图·bar | 每月取消订单量 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A23 | fulfillPie·配送渠道占比 | 图·pie | FBA vs MFN(自发货) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A24 | salesChan·销售渠道占比 | 图·pie | 各销售渠道订单比例 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A25 | promoPie·促销 vs 非促销订单 | 图·pie | 依赖促销出单的程度 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A26 | itemsPerOrder·单均件数趋势 | 图·line | 平均每笔订单购买件数 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A27 | ordersPerItem·每单件数分布 | 图·bar | 1件/2件/3件…订单数分布 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A28 | revPerItem·单品营收趋势 | 图·line | 总营收 ÷ 商品件数(单件产出) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A29 | monthProfit·月度利润走势 | 图·bar | 每月净利润变化 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A30 | monthSettle·月度结算总额 | 图·bar | 每月 Amazon Settlements 实际打款 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A31 | monthFee·月度费用走势 | 图·bar | 每月平台扣费(佣金+FBA+促销+其他)变化 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A32 | monthSettleRate·月度回款率 | 图·line | 已回款订单营收 ÷ 总营收(派生口径) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A33 | avgFee·单均费用趋势 | 图·line | 平均每笔订单的平台扣费 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A34 | feeVsSettle·费用 vs 回款(月) | 图·line | 同一时间轴对比平台扣费与实际打款 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A35 | feeComp·费用构成 | 图·pie | 佣金 / FBA / 促销 / 其他占比 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A36 | settleStatus·回款状态金额 | 图·pie | 已回款 vs 待回款 vs 其他(订单营收口径) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A37 | dailyFee·每日费用 | 图·bar | 每天平台扣费金额 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A38 | monthFeeRatio·月度费用占比 | 图·line | 费用 ÷ 营收 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A39 | dailySettle·每日回款口径营收 | 图·line | 已回款订单的每日营收(派生) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A40 | curRev·分币种营收 | 图·pie | USD / SAR / AED 等币种销售分布(本币) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A41 | settleCur·分币种回款 | 图·pie | 已回款订单各币种营收(本币,派生) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A42 | orderCur·分币种订单数 | 图·pie | 各币种订单量 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A43 | revChan·分渠道营收 | 图·hbar | 各销售渠道销售额 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A44 | profChan·分渠道利润 | 图·hbar | 各渠道净利润 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A45 | settleRateChan·分渠道回款率 | 图·hbar | 各渠道已回款营收占比(派生) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A46 | last24Country·最近数据日分国家订单 | 图·pie | 各站点最近一天的单量分布 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A47 | countryRev·分国家营收 | 图·hbar | 各国销售额对比,找出主力市场 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A48 | countryProfit·分国家利润 | 图·hbar | 卖得多不一定赚得多 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A49 | countrySettle·分国家结算金额 | 图·hbar | 各国实际结算净额(回款)对比 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A50 | countryShare·国家订单占比 | 图·pie | 各国订单份额 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A51 | countryAov·分国家客单价 | 图·hbar | 各国平均每单金额 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A52 | countryMargin·国家利润率 | 图·hbar | 各国净利润率 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A53 | countryFeeRate·国家费率 | 图·hbar | 各国平台扣费比例 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A54 | countrySettleRate·国家回款率 | 图·hbar | 各国结算净额 ÷ 营收,回款效率对比 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A55 | countryCancelRate·国家取消率 | 图·hbar | 各国取消订单比例 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A56 | countryCancel·分国家取消订单数 | 图·hbar | 各国取消订单量,找出异常站点 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A57 | countryFba·FBA 费用分国家 | 图·hbar | 各国 FBA 物流费对比 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A58 | countryComm·佣金分国家 | 图·hbar | 各国平台佣金对比 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A59 | countryCommRate·分国家佣金率 | 图·hbar | 各国佣金比例 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A60 | countryPromo·分国家促销返点 | 图·hbar | 各国促销补贴金额 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A61 | countryRefund·分国家退款件数 | 图·hbar | 各国退款退货量 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A62 | countryFbaMix·FBA vs MFN 分国家 | 图·stack | 各国配送方式占比 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A63 | countryItems·分国家单均件数 | 图·hbar | 各国平均每单件数 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A64 | countryShipDays·分国家平均发货天数 | 图·hbar | 各国物流时效(下单→发货) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A65 | countryFbaUnit·分国家单件 FBA 费 | 图·hbar | 各国每件物流费 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A66 | top3FeeTrend·Top 3 国家费率趋势 | 图·line | (f-string 动态) f"营收前三({'、'.join(top3c)})费率按月变化" | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A67 | top5CountryDaily·Top 5 国家每日订单 | 图·line | 单量最高的 5 个国家每日走势 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A68 | fbaMonthly·FBA 费用按月 | 图·bar | 物流费月度走势(spapi 财务事件四项合计) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A69 | skuMargin·SKU 利润率 | 图·hbar | 负值 = 亏损品(营收 Top,费用事件已到) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A70 | skuFeeRate·SKU 费率 | 图·hbar | 每个产品的平台扣费比例(营收 Top,费用事件已到) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A71 | skuUnits·热卖 SKU(按件数) | 图·hbar | 畅销品排行,快速了解主力产品 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A72 | skuRev·营收 Top SKU | 图·hbar | 贡献销售额最多的产品 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A73 | skuProfit·利润 Top SKU | 图·hbar | 与营收榜对比可发现高营收低利润品 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A74 | skuSettle·回款口径 Top SKU | 图·hbar | 已回款订单营收最多的产品(派生) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A75 | skuCnt·SKU 订单数 Top 15 | 图·hbar | 订单量最高的 15 个产品 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A76 | top3SkuDaily·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-A77 | rating·产品评分分布 | 图·hbar | 各 Listing 当前星级(rankings 快照) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A78 | reviews·评论数对比 | 图·hbar | 各产品评论数量 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A79 | bsrSmall·小类 BSR | 图·hbar | 细分类目排名(越低越好) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-A80 | bsrBig·大类 BSR | 图·hbar | 大类目排名(越低越好) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N01 | nGmvBar·月度 GMV | 图·bar | 折 USD | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N02 | nNetBar·月度结算净额 | 图·bar | 折 USD | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N03 | nWeeklyOrders·每周订单 | 图·bar | 件 · ISO 周 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N04 | nDailyRev·每日营收 | 图·line | 折 USD | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N05 | nDailyCnt·每日订单数 | 图·bar | 件 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N06 | nDailyProfit·每日利润走势 | 图·line | 折 USD · 结算净额−佣金−履约费 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N07 | nWeeklyRev·每周营收 | 图·bar | 折 USD · ISO 周 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N08 | nAovTrend·客单价趋势 | 图·line | 折 USD · 营收÷订单 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N09 | nStatusPie·订单状态构成 | 图·pie | 件 · 近180天 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N10 | nCancelRate·每日取消率 | 图·line | % · 取消件÷订单 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N11 | nCountryCancel·分国家取消订单数 | 图·hbar | 件 · 近180天 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N12 | nFeeStack·月度费用构成 | 图·stack | 折 USD · 8 项平台费用拆解 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N13 | nCurRev·分币种营收 | 图·pie | 本币 · SAR/AED | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N14 | nCountryMon·国家 × 月营收 | 图·stack | 折 USD · 堆叠 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N15 | nCountryGmv·国家营收排名 | 图·hbar | 折 USD · 窗口合计 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N16 | nCountryShare·国家营收份额 | 图·pie | 折 USD | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N17 | nCountryOrders·国家 × 月订单数 | 图·stack | 堆叠 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N18 | nTopSku·Top 15 SKU 营收 | 图·hbar | 本币 · 按营收排序 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N19 | nTopSkuTrend·Top 5 SKU 月度营收 | 图·line | 折 USD | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N20 | nBrandMon·品牌 × 月营收 | 图·stack | 折 USD · 堆叠 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N21 | nModelTop·Top 10 型号营收 | 图·hbar | 本币 · sku_mapping 归并型号 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N22 | nSkuUnits·热卖 SKU(按件数) | 图·hbar | 件 · 近180天 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N23 | nAdSpend·月度广告花费 | 图·line | 折 USD | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N24 | nAdSales·月度广告销售 | 图·line | 折 USD | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N25 | nAdRate·月度 TACOS | 图·line | 广告花费 ÷ 营收 % | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N26 | nCumGmv·累计营收 | 图·line | 折 USD · 窗口内累计 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N27 | nProfitTrend·月度利润走势 | 图·line | 折 USD · 结算净额 − 广告花费 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N28 | nRefundTrend·月度退款 | 图·line | 折 USD | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N29 | nHourly24·24小时订单分布 · 按品牌 | 图·bar | 最新数据日(订单表最大日)的逐小时单量 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N30 | nStatusTime·订单状态随时间 | 图·stack | 各状态件数按月变化 · 近180天 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N31 | nShipCancel·发货 vs 取消趋势 | 图·line | 件 · 已发货(含已送达) vs 取消 · 近似: 无发货时间戳按下单日 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N32 | nDow·星期订单分布 | 图·bar | 一周中哪天单量最高(广告投放参考)· 近180天 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N33 | nHourDist·24小时订单分布 · 按品牌 | 图·bar | 最新数据日(订单表最大日)的逐小时单量 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N34 | nMultiSku·单 SKU vs 多 SKU 订单 | 图·pie | 一单买一个 SKU vs 买多个 SKU · 近180天 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N35 | nMonthCancel·月度取消数 | 图·bar | 件 · 订单表(月表 cancelled 列恒 0 不可用) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N36 | nItemsPerOrder·单均件数趋势 | 图·line | 平均每笔订单购买件数 · 近180天 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N37 | nOrdersPerItem·每单件数分布 | 图·bar | 1件/2件/3件…订单数分布 · 近180天 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N38 | nRevPerItem·单品营收趋势 | 图·line | 折 USD · 月度 · GMV÷件(近似 Amazon 日级) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N39 | nMonthFee·月度费用走势 | 图·bar | 折 USD · 月表 8 项平台费用合计 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N40 | nMonthSettleRate·月度回款率 | 图·line | 折 USD · 结算净额÷GMV | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N41 | nAvgFee·单均费用趋势 | 图·line | 折 USD · 费用÷订单(件口径) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N42 | nFeeVsSettle·费用 vs 回款(月) | 图·line | 折 USD · 平台扣费与结算净额同轴对比 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N43 | nDailyFee·每日费用 | 图·bar | 折 USD · 日级仅佣金+履约费(月表 8 项全) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N44 | nMonthFeeRatio·月度费用占比 | 图·line | 折 USD · 费用÷GMV | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N45 | nDailySettle·每日回款口径营收 | 图·line | 折 USD · 日表结算净额 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N46 | nSettleCur·分币种回款 | 图·pie | 本币 · SAR/AED · 月表结算净额 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N47 | nOrderCur·分币种订单数 | 图·pie | 件 · 各币种订单量 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N48 | nLast24Country·最近数据日分国家订单 | 图·pie | 件 · 各站点最近一天的单量分布 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N49 | nCountryProfit·分国家利润 | 图·hbar | 折 USD · 结算净额−广告 · 卖得多不一定赚得多 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N50 | nCountrySettle·分国家结算金额 | 图·hbar | 折 USD · 各国结算净额(回款)对比 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N51 | nCountryShareOrd·国家订单占比 | 图·pie | 件 · 各国订单份额 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N52 | nCountryAov·分国家客单价 | 图·hbar | 折 USD · GMV÷订单(件口径) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N53 | nCountryMargin·国家利润率 | 图·hbar | 折 USD · 利润÷GMV | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N54 | nCountryFeeRate·国家费率 | 图·hbar | 折 USD · 8项费用÷GMV | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N55 | nCountrySettleRate·国家回款率 | 图·hbar | 折 USD · 结算净额÷GMV | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N56 | nCountryCancelRate·国家取消率 | 图·hbar | 件 · 取消÷全部 · 近180天(订单表) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N57 | nCountryFba·履约费分国家 | 图·hbar | 折 USD · delivery_fee(对应 Amazon FBA 费用图) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N58 | nCountryComm·佣金分国家 | 图·hbar | 折 USD · 各国平台佣金对比 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N59 | nCountryCommRate·分国家佣金率 | 图·hbar | 折 USD · 佣金÷GMV | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N60 | nCountryPromo·分国家订单补贴 | 图·hbar | 折 USD · order_subsidies(对应 Amazon 促销返点图) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N61 | nCountryRefund·分国家退款金额 | 图·hbar | 折 USD · 月表 refund(对应 Amazon 退款件数图) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N62 | nCountryItems·分国家单均件数 | 图·hbar | 件/单 · 近180天(订单表) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N63 | nCountryFbaUnit·分国家单件履约费 | 图·hbar | 折 USD · 履约费÷订单件(对应 Amazon 单件FBA费) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N64 | nTop3FeeTrend·Top 3 国家费率趋势 | 图·line | 营收前三(SA、AE)费率按月变化 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N65 | nTop5CountryDaily·Top 5 国家每日订单 | 图·line | 件 · 单量最高的 5 个国家每日走势 · 近180天 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N66 | nFbaMonthly·履约费按月 | 图·bar | 折 USD · delivery_fee(对应 Amazon FBA 费用按月) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N67 | nSkuProfit·利润 Top SKU | 图·hbar | 折 USD · 结算净额−SKU广告 · 与营收榜对比可发现高营收低利润品 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N68 | nSkuSettle·回款口径 Top SKU | 图·hbar | 折 USD · 结算净额最多 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N69 | nSkuMargin·SKU 利润率 | 图·hbar | 折 USD · 利润÷GMV · 负值=亏损品(营收 Top15) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N70 | nSkuFeeRate·SKU 费率 | 图·hbar | 折 USD · 8项费用÷GMV(营收 Top15) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N71 | nSkuCnt·SKU 订单数 Top 15 | 图·hbar | 件 · 月表口径 | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N72 | nRating·产品评分分布 | 图·hbar | 各 Listing 当前星级(rankings 快照 · noon AE/SA) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| AC-EL-HOME-N73 | nReviews·评论数对比 | 图·hbar | 各产品评论数量(rankings 快照) | /api/dashboard/charts 下发 spec(title/hint/kind),前端不造图 | charts 响应与本行 key/title/hint/kind 逐字比对(机器可查) | 生效 |
| 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) | 生效 |
| 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-009 | Noon 数据源说明卡 @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-010 | Noon 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-011 | Noon KPI·今日件数 @Noon KPI 行 | KPI卡 | 件数+昨日+环比% | 同表 count(*)(件级行数) | SQL count(*) 对拍 | 生效 |
AC-EL-TODAY-012 | Noon KPI·取消 cancelled @Noon KPI 行 | KPI卡 | 取消件数(红) | count(*) FILTER (WHERE item_status='cancelled');foot=昨日同口径 | SQL FILTER 对拍 | 生效 |
AC-EL-TODAY-013 | Noon KPI·客户退货 cir @Noon KPI 行 | KPI卡 | 退货件数(橙 warn) | count(*) FILTER (item_status='cir') | 同上 | 生效 |
AC-EL-TODAY-014 | Noon KPI·无法送达 @Noon KPI 行 | KPI卡 | undeliverable 件数(红) | count(*) FILTER (item_status='undeliverable') | 同上 | 生效 |
AC-EL-TODAY-015 | Noon KPI·已送达 @Noon KPI 行 | KPI卡 | delivered 件数(绿) | count(*) FILTER (item_status='delivered') | 同上 | 生效 |
AC-EL-TODAY-016 | Noon KPI·已发货 @Noon KPI 行 | KPI卡 | shipped 件数(默认色) | count(*) FILTER (item_status='shipped') | 同上 | 生效 |
AC-EL-TODAY-017 | Noon KPI·已导出 @Noon KPI 行 | KPI卡 | exported 件数 | count(*) FILTER (item_status='exported') | 同上 | 生效 |
AC-EL-TODAY-018 | Noon 分品牌表 @Noon 双卡左 | 表格 | 品牌×(订单/件数/取消/退货/无法送达) | day 当日 GROUP BY brand ORDER BY 订单 DESC;品牌列带 brandColor() 色点(AC-UI-07);空态行「今日暂无数据」colSpan=6 | SQL 分组对拍 | 生效 |
AC-EL-TODAY-019 | Noon 分国家表 @Noon 双卡右 | 表格 | 国家×同五列 | GROUP BY country ORDER BY 订单 DESC;空态「本月暂无数据」(文案沿用) | SQL 分组对拍 | 生效 |
AC-EL-TODAY-020 | KPI·今日订单(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-021 | KPI·今日件数 * @主 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-022 | KPI·今日营收 @主 KPI 行 | KPI卡 | 营收 USD+昨日+环比% | sum(revenue_usd)(当日全量,usd() 千分位 2 位);pending>0 附「N 单 Pending 金额未计入」 | SQL sum 对拍 | 生效 |
AC-EL-TODAY-023 | KPI·今日净利 @主 KPI 行 | KPI卡 | 净利 USD+昨日(无环比) | sum(net_usd) 当日全量;净利口径见 AC-CAL-01 | SQL sum(net_usd) 对拍 | 生效 |
AC-EL-TODAY-024 | KPI·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 axis | SQL sales_hourly 对拍 | 生效 |
AC-EL-TODAY-026 | SKU 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-031 | Pending 脚注 @分品牌表下 | 脚注 | 「Pending = 平台尚未确认结算的订单(金额暂缺属正常);长期不转化=采集侧状态回刷问题,见数据管道页水位」 | 静态口径文案 | 文案断言 | 生效 |
AC-EL-TODAY-032 | 页脚数据链路说明 @页底 | 脚注 | SP-API 采集库→每 2 小时增量(今日订单+小时销量)→只读库;「今日」=最新数据日北京时间;* 件数估算口径 | 静态 | 文案断言 | 生效 |
源码实证注记:待核:0。注:今日页 Amazon KPI 口径=当日全量(含取消/Pending),与 AC-CAL-02 看板 30 天有效订单口径不同属页面定位差异,验收按本表口径。
| ID | 元素 | 类型 | 描述 | 定义(来源·口径·公式·边界·交互) | 验证方法 | 状态 |
|---|---|---|---|---|---|---|
AC-EL-ORDER-001 | 页标题/面包屑 @页头 | 静态 | 「订单 · Amazon 订单明细 · 三品牌统一(订单主表口径)」 | AppShell title/crumb | e2e 文案断言 | 生效 |
AC-EL-ORDER-002 | 错误横幅 @页顶 | 反馈 | 接口失败红条 | err ← getJson catch | role=alert | 生效 |
AC-EL-ORDER-003 | KPI·订单数(当前筛选) @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-004 | KPI·营收 USD @KPI 行 | KPI卡 | 筛选内有效订单营收 | sum(revenue_usd) FILTER 剔取消;valid=0 显「—」不显误导 $0.00(D批P3-4),foot「当前筛选无有效订单(全为取消单)」;正常 foot「有效订单口径(不含取消)」 | SQL 对拍;全取消筛选下断言「—」 | 生效 |
AC-EL-ORDER-005 | KPI·件数 @KPI 行 | KPI卡 | 筛选内有效订单件数 | sum(items_count) FILTER 剔取消;valid=0 显「—」 | SQL 对拍 | 生效 |
AC-EL-ORDER-006 | KPI·客单价 @KPI 行 | KPI卡 | AOV=营收/有效订单 | aov=sum(rev)/valid(valid=0 为 0.0 前端显「—」),usd 2 位;foot「营收 / 有效订单」 | 复算 | 生效 |
AC-EL-ORDER-007 | KPI·状态分布 @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 实值为准)。
| ID | 元素 | 类型 | 描述 | 定义(来源·口径·公式·边界·交互) | 验证方法 | 状态 |
|---|---|---|---|---|---|---|
AC-EL-FIN-001 | AppShell 标题/面包屑 @顶栏 | 导航 | 标题"财务"+面包屑"资金流水 · 问题雷达 · 全维度损益(品牌 × 月 × 费用 × 回款 × Noon 官方结算口径)"(page.tsx:2761;R4b P4 对齐) | page.tsx 静态常量,路由 /finance |交互:面包屑回上级 | 浏览器开页标题可见 | 生效 |
AC-EL-FIN-002 | 错误横幅 @页首 | 提示条 | data.error 时红条 role=alert | useFullBlock('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-009 | KPI卡1 净收款 @六卡 | KPI | Net Proceeds 值+Delta环比%+foot"未扣平台费·上月对比" | /full rows.rev=Σrevenue_usd(未扣平台费);AC-CAL-01 起点项;环比=(当期−上期)/上期 | SQL Σrevenue_usd 同窗相等 | 生效 |
AC-EL-FIN-010 | KPI卡2 结算净额 @六卡 | KPI | 值+Delta+foot"已扣佣金FBA促销" | fin.net=rev−comm−fba−promo−other−vat;AC-CAL-01 | SQL 复算相减 | 生效 |
AC-EL-FIN-011 | KPI卡3 毛利润 @六卡 | KPI | 值+Delta+毛利率foot | gross=net−ad;毛利率=gross/rev;AC-CAL-01 | 复算 | 生效 |
AC-EL-FIN-012 | KPI卡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-013 | KPI卡5 广告 @六卡 | KPI | 广告花费+广告销售 foot+上月 | ads=cleaned_ads_sku_daily ∪ cleaned_amazon_ads_daily 双源并集(P1-17/18 修) | 双源并集复算 | 生效 |
AC-EL-FIN-014 | KPI卡6 平台回款 @六卡 | KPI | Payout+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 @卡头 | 筛选器 | 国家+时间 pills | useFullBlock('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-020 | Amazon 销量柱状图 @卡体 | 图 | Orders bar+Net Profit line,dataZoom | 同 kpi-wall 月份序列 |交互:缩放 | 图值=表值 | 生效 |
AC-EL-FIN-021 | Annual Summary 卡 @卡体 | 表格 | 10列:产品/订单/件数/净收款/结算/广告/毛利润/净利润/毛利率/Net per Unit;空态"无数据" | kpi-wall annual 段(按产品年聚合) | 年合计=12月和 | 生效 |
AC-EL-FIN-022 | 页签行 @主区 | tabs | 5枚:品牌月度矩阵(默认)/📈盈利矩阵/产品损益/月度对账/年度对比 | 前端 state tab;monthly/years 仅 amazon 渲染 |交互:切tab | noon 下仅3枚 | 生效 |
AC-EL-FIN-023 | 趋势块 BlockBar @卡头 | 筛选器 | 国家+时间 pills | useFullBlock('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;年份下拉;导出Excel | useFullBlock('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-030 | Noon 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-031 | Noon 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-032 | Noon 产品×月损益卡 @主区 | 表格 | 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-033 | Noon 账户余额卡 @主区 | 表格 | 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-035 | GMV 月柱状图 @卡体 | 图 | 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 @卡头 | tabs | Amazon USD / Noon 本币 | platform 子 state,随顶部 |交互:切换 | 币种标注切换 | 生效 |
AC-EL-FIN-048 | RangePills @卡头 | 筛选器 | 时间档 pills | timeParams |交互:切换 | 参数同步 | 生效 |
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-051 | Amazon 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-053 | Noon 10列表 @卡体 | 表格 | SKU/品牌/市场/订单/GMV/佣金/履约/广告/VAT推算/结算净额;SAR/AED 本币标注 | /product-pl?platform=noon;AC-CAL-12 |交互:翻页 | 本币不混 | 生效 |
AC-EL-FIN-054 | 年份 pills @卡头 | pills | 全部+数据年份 | year 参数 |交互:切换 | 参数同步 | 生效 |
AC-EL-FIN-055 | RangePills @卡头 | 筛选器 | 时间档 | timeParams |交互:切换 | 同上 | 生效 |
AC-EL-FIN-056 | 口径说明 @卡头 | 脚注 | 账单总额=平台账单;结算到账/打款=Settlements 月度;差额=对账缺口 | AC-CAL-07 fm 三方对账(与订单层两条口径,差值带标签披露) | 与注册表口径一致 | 生效 |
AC-EL-FIN-057 | 项目×月对账表 @卡体 | 表格 | 17列:月份/项目(品牌)/订单/退款单/营收/退款/佣金/履约/VAT/其他费/净利润/账单总额/结算到账/差额/打款/差额/广告;两差额列 |差|>1 标 warn 色 | /api/finance/monthly | 差额=账单−结算 代数复算 | 生效 |
AC-EL-FIN-058 | Noon Model×月表 @卡体 | 表格 | 12列:月份/品牌/国家币种/型号/订单/GMV/佣金/履约/广告/广告销售/VAT推算/结算净额;本币 | /monthly noon 段;AC-CAL-05/12 | 本币列核对 | 生效 |
AC-EL-FIN-059 | BlockBar @卡头 | 筛选器 | 国家+时间 pills | useFullBlock('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-064 | CustomModules @页尾 | 模块区 | 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 条目时逐列展开。
| ID | 元素 | 类型 | 描述 | 定义(数据来源·口径·边界) | 验证方法 | 状态 |
|---|---|---|---|---|---|---|
| AC-EL-NOON-01 | 页标题/面包屑 | 静态 | 「Noon 平台 · 中东 Noon · 月度财务(原币口径)+ 官方对账单」 | AppShell 面包屑 | e2e 文案断言 | 生效 |
| AC-EL-NOON-02 | 错误横幅 | 反馈 | 接口失败红条 | err ← catch | role=alert | 生效 |
| AC-EL-NOON-03 | 无数据空态 | 空态 | 「当前品牌无 Noon 数据」居中卡 | months 与 statements 均空时整页空态(/api/noon/summary 空结果) | 纯 Amazon 品牌视角断言 | 生效 |
| AC-EL-NOON-04 | KPI·最新月 GMV(每币种一张) | KPI卡 | 最新月 GMV + 订单/件数/费用 foot | latest=mons 末位;months=audit.cleaned_noon_monthly(RLS 企业域,不随全局品牌筛选);money()=「CUR N,NNN」千分位 0 位(NoonStatement.tsx) | SQL 最新月 gross 对拍(按币种分行) | 生效 |
| AC-EL-NOON-05 | KPI·累计(每币种一张) | 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_net | SQL 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-MM | mon;text 筛选 | — | 生效 |
| AC-EL-NOON-13 | 明细表·列「品牌」 | 列 | 色点+品牌名 | brandColor 色点(AC-UI-07);排序/筛选 | — | 生效 |
| AC-EL-NOON-14 | 明细表·列「币种」 | 列 | AED/SAR | currency;筛选 | — | 生效 |
| 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×评论数 Top15 | sku_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 品牌 tab | noonBrands=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 / SA | country → SQL upper(country_code) 等值;days 固定 30(API 上限 90);单击重拉 | — | 生效 |
| AC-EL-NOON-41 | SKU 流量表现表 | 表格 | 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」 | 文案断言 | 生效 |
| ID | 元素 | 类型 | 描述 | 定义(数据来源·口径·边界) | 验证方法 | 状态 |
|---|---|---|---|---|---|---|
| AC-EL-SRC-01 | KeepaTokenChip(tab 栏右端) | chip | Keepa 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·工具栏) | select | 15 站选择(COUNTRIES,chartCatalog 单源;批D 2026-10-25 语义抽检纠偏:原文 16 站含 IN 印度,git 史已删而数字未随改) | 本地 state,无请求;交互:切换即 ABA 模式自动重查(F2-1) | e2e 切站点后图表刷新 | 生效 |
| AC-EL-SRC-04 | 数据源 select(charts·工具栏) | select | ABA 词分析(快照+词库)/ 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)+可搜词 chips | data.available=false 触发 keepaLoad("cascade");country_terms chips 点击即以此词 load;交互:点 chip 换词搜索 | 造无词断言级联触发+kres 渲染 | 生效 |
| AC-EL-SRC-11 | Keepa 实时搜索卡(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 求和;币种=首行 currency | JS 复算中位数 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-15 | ABA 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×6 | ABA 图表[20]/Keepa 图表[39+22]/ABA×Keepa[32]/全部产品与原始行/分析报告总结/🎯机会雷达 | subtab query state;图表计数取 chartCatalog 常量 | — | 生效 |
| AC-EL-SRC-17 | ABA 图表墙(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-20 | ABA×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-22 | ABA 逐月原始行表(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,各带 total | GET /api/sourcing/radar?country&limit=50(&offset 翻页);源表 aba_radar_rising/fragmented/gem/basket/repeat+aba_meta(radar_computed_at);期号/源计算日期在卡头;交互:点击切换 kind | SQL 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 分页只并入当前 kind | total 与行数关系断言 | 生效 |
| AC-EL-SRC-31 | 页头说明(explore·卡头) | 脚注 | 全部条件平铺直选·零下拉·选完点底部搜索 | 静态文案 | — | 生效 |
| AC-EL-SRC-32 | 站点 chips(explore) | chips×13 | 13 站(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-34 | live 提示条(explore·live) | 提示条 | 琥珀底:配额规则+38 项条件在全库档生效说明 | 静态 | — | 生效 |
| AC-EL-SRC-35 | live 根类目 select(explore·live) | select | 全类目(活跃榜)+根类目列表 | GET /api/sourcing/category-tree(源表 keepa_category_tax,2026-10-19 口径切市场公共维度) | 选项与 category-tree 响应一致 | 生效 |
| AC-EL-SRC-36 | live 关键词 input(explore·live) | input | 占位=完整口径说明:纯词=Top30 快照;+任意筛选=自动切全市场条件检索(标题含词);留空=按筛选+类目检索 | 2026-10-21 二次升级口径统一(bsr<80 只 2 个→条件全走 /finder) | 占位文案断言 | 生效 |
| AC-EL-SRC-37 | live 筛选行 1(explore·live) | 控件×18 | 品牌(逗号分隔≤50)/价格类型(NEW|AMAZON|USED)/价≥≤/型号/颜色/尺码/评分≥≤/评论≥≤/月销≥/掉榜30·180·365≥/优惠券三态/秒杀三态 | 组装 POST /finder body;任一筛选回车即检索 | 输入+Enter | 生效 |
| AC-EL-SRC-38 | live 筛选行 2(explore·live) | 控件×10 | BSR≥≤/卖家数≤/卖家≥/FBA 卖家≥/均价30·90≥/自营可购四态/BuyBox=Amazon 三态/排序(销量/价格↑↓/评论/月销) | 同 AC-EL-SRC-37;sort=sales 等 | 输入+Enter | 生效 |
| AC-EL-SRC-39 | live 更多筛选网格(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-42 | kwNote 动态口径行(explore·live) | 脚注 | 快照模式:「TopN 已按筛选过滤 X→Y · 未生效(需清词走条件检索): 字段清单」;条件模式:命中 N 个第 M 页;修改后:「已修改——回车重查(10 分钟缓存)」 | kwApply 纯前端过滤(0 配额)+skipped 字段清单派生;_fsig 与 filterSig 比对检测已修改 | 改筛选后提示行断言 | 生效 |
| AC-EL-SRC-43 | live 结果区+分页(explore·live) | 结果区 | KeepaLiveResults+LiveCharts+上一页/第 N 页/共 ≤200 页/下一页 | /finder page 翻页(50/页,上限 200 页);交互:翻页按钮 | 翻页请求 body.page 断言 | 生效 |
| AC-EL-SRC-44 | LiveCharts 实时图墙(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) | chips | sort_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-52 | ExploreCharts 图墙(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-54 | CSV 导出(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×13 | 13 站(两模式全 Keepa 后端,F2 修统一收窄) | KEEPA_COUNTRIES | 13 断言 | 生效 |
| 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-63 | live 刷榜控件(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-65 | AI 站点 chips(ai) | chips×12 | 12 站全覆盖(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-68 | AI 分析按钮(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-69 | AI 分析结论卡(ai·结果) | 卡 | 副标题: 站·model·Keepa 调用 N 次·今日剩余配额 N 次+pre-wrap 答案 | AgentResp.answer | keepa_calls 与 steps 数关系 | 生效 |
| AC-EL-SRC-70 | 工具调用轨迹卡(ai·结果) | 卡 | agent 实际调用的 Keepa MCP 工具逐条(✓/✗ tool+参数截断 40 字+note),副标题「全部经过配额门与审计」 | AgentResp.steps | ok=false 显示 ✗ | 生效 |
| AC-EL-SRC-71 | AI 检索的商品卡(ai·结果) | 卡 | KeepaLiveResults rankMode(BSR 升序) | AgentResp.products | 同 AC-EL-SRC-14 | 生效 |
| AC-EL-SRC-72 | AI 检索的促销表(ai·结果) | 表(5 列) | ASIN[深链+🛒]/标题/现价/均价/降幅%(降序) | AgentResp.deals;Keepa 官方促销流;交互:行内链接 | 降幅降序断言 | 生效 |
| AC-EL-SRC-73 | 站点 chips(cat) | chips×13 | 13 站(类目聚合读 Keepa 后端,F2 修收窄) | KEEPA_COUNTRIES | 13 断言 | 生效 |
| AC-EL-SRC-74 | 统计行(cat·卡头) | 行 | 共 N 产品·根类目 M 个·另有 K 产品未返回类目(不成树节点披露) | category-tree total/roots.length/unclassified | SQL 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 | 待另册展开后逐元素比对 | 生效 |
全页通用:口径引用 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↔noonkw | NOON_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-005 | timeParams 换算(全局/逻辑) | 映射 | 全部=days:0(不限);今年=365d+from:01-01;本月=当月第N日+from:月初;上月=60d+精确自然月 from/to;近3月=90d;近12月=365d | page.tsx:2410-2427;2026-09-21 修「上月=近60天」近似,from/to 传接口由 _daywin 优先采用 | 选上月看请求含 from/to=上月首末日 | 生效 |
| AC-EL-ADS-006 | tab 条(全局/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-010 | KPI 待决策建议(晨报/KPI行) | KPI卡 | queue.total,>0 红色;脚注「escalated 优先 · 去处理」链接 | 同 009;queue.total=pending+escalated 计数;交互:点「去处理」跳 advice | 值=advice tab 决策队列两态之和 | 生效 |
| AC-EL-ADS-011 | KPI 昨日决策执行(晨报/KPI行) | KPI卡 | executed_yesterday.length;脚注「API 直连 + 人工兜底」 | 昨日(北京日) decision 落库数 | 与 advice tab 昨日决策数对 | 生效 |
| AC-EL-ADS-012 | KPI 到期/逾期回访(晨报/KPI行) | KPI卡 | followups.due.length;脚注 逾期 N 项/无逾期 | 检查点 3/7/15/30/60/90d 到期集合;overdue 单列 | 到期日期≤今日的行数 | 生效 |
| AC-EL-ADS-013 | KPI monitor 告警(晨报/KPI行) | KPI卡 | monitor.by_monitor.alert;脚注 watch N · 观察中 N | 与 monitor tab 同源计数(ads.py:3131) | 与监测 tab alert tab 计数相等 | 生效 |
| AC-EL-ADS-014 | KPI 人工操作单(晨报/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;交互:点击跳 config | URL 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_count | badge 色与状态枚举对 | 生效 |
| 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/done | done 与 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 显示,打开 CheckinModal | GET /api/ads/advice/{aid}/checkins(ads.py:3227);交互:点击开弹层 | 弹层列出各检查点 | 生效 |
| AC-EL-ADS-039 | 分页脚注(建议/尾) | 文本 | 「显示前 N 条 / 共 M 条(按花费降序)」 | total>items.length 时显示 | 计数与接口 total 对 | 生效 |
| AC-EL-ADS-040 | EditModal·动作/预算(建议/弹层) | 表单 | 动作 select:暂停/降预算/加预算/检查创意定向/按建议改关键词出价/按建议加推荐词;budget 类出「预算系数(×)」「新日预算 $(留空用系数算)」 | 7.6 决议:数字/动作/理由都可改,保存即按新值执行;POST decision {decision:"edit",…} | 修改后卡动作变 modified 语义 | 生效 |
| AC-EL-ADS-041 | EditModal·改价表(建议/弹层) | 表格 | 列:勾/关键词定向/现价/建议价/新出价(input step0.01, min Noon 0.01 / Amazon 0.02)/依据;护栏提示 Noon [0.01,200]本币 / Amazon [0.02,100]站点货币 | 勾选行必填价且>0,空/非法报行号错误 | 提交载荷 changes 含新价 | 生效 |
| AC-EL-ADS-042 | EditModal·加词表(建议/弹层) | 表格 | 列:勾/关键词/匹配/建议价/新出价/依据;护栏同 041 | 同 041;至少勾一词 | 同 041 | 生效 |
| AC-EL-ADS-043 | EditModal·理由/备注(建议/弹层) | 表单 | 理由 textarea(预填)+决策备注(可选) | 随 decision 提交 | 载荷 reason/note | 生效 |
| AC-EL-ADS-044 | CheckinModal(建议/弹层) | 弹层 | 标题「建议 #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-045 | monitor 状态页签(监测/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-070 | ROAS 无销售时=花费值语义 | 生效 |
| 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-071 | ops_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 | 图·国家筛选(图区/头) | 下拉 | 国家 select | GET /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-079 | c1 花费/收入(图区/图) | 双bar图 | 花费(红)bar+收入(绿)bar,日粒度 | charts 接口 series;Noon 副题「本币口径」 | series 数=2 | 生效 |
| AC-EL-ADS-080 | c2 ROAS(图区/图) | 折线图 | ROAS 日趋势 | =收入/花费 | 与 c1 导出数互算 | 生效 |
| AC-EL-ADS-081 | c3 CTR(图区/图) | 折线图 | CTR 日趋势 | =点击/曝光 | 复算 | 生效 |
| AC-EL-ADS-082 | c4 CVR(图区/图) | 折线图 | CVR 日趋势 | =订单/点击 | 复算 | 生效 |
| AC-EL-ADS-083 | c5 CPC(图区/图) | 折线图 | CPC 日趋势 | =花费/点击 | 复算 | 生效 |
| AC-EL-ADS-084 | c6 花费Top20(图区/图) | 横bar图 | 花费 Top20(SKU/ASIN) | 降序截断20 | 行数≤20 | 生效 |
| AC-EL-ADS-085 | c7 ROAS by ASIN(图区/图) | bar图 | ASIN 维 ROAS | 分组聚合 | 与明细表对 | 生效 |
| AC-EL-ADS-086 | c8 月度双bar(图区/图) | 双bar图 | 月度花费+收入 | 月聚合 | 月桶数 | 生效 |
| AC-EL-ADS-087 | c9 月度ROAS(图区/图) | bar图 | 月度 ROAS | 月聚合 | 同 086 | 生效 |
| AC-EL-ADS-088 | c10 ATC(图区/图) | bar图·占位 | 加购紫 bar;Amazon 平台显占位文案「源无ATC数据恒0请切Noon」 | Amazon 源表无 ATC 列(诚实占位,不造数) | Amazon 下显示占位说明 | 生效 |
| AC-EL-ADS-089 | c11 CPS(图区/图) | 折线图 | CPS 日趋势 | =花费/订单 | 复算 | 生效 |
| AC-EL-ADS-090 | c12 曝光/点击(图区/图) | 双线图 | 曝光+点击双线 | 两 series | series=2 | 生效 |
| AC-EL-ADS-091 | 断更 badge(图区/头) | 徽标 | 「数据止于 MM-DD」(最新点>3天前) | data_through 判定 | 人为断更后出现 | 生效 |
| AC-EL-ADS-092 | 国家探测回退(图区/逻辑) | 逻辑 | 选中国家无数据自动回退「全部」+banner「显示全部时段」 | probe 请求+fullCache 防重查 | 冷门国家验证 | 生效 |
| AC-EL-ADS-093 | KPI 花费(搜索词/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-094 | KPI ROAS·ACOS(搜索词/KPI) | KPI卡 | ROAS+ACOS | 公式通用 | 复算 | 生效 |
| AC-EL-ADS-095 | KPI 点击·CPC(搜索词/KPI) | KPI卡 | 点击+CPC | 公式通用 | 复算 | 生效 |
| AC-EL-ADS-096 | KPI 搜索词数(搜索词/KPI) | KPI卡 | 去重搜索词数 | count distinct | 对表行数 | 生效 |
| AC-EL-ADS-097 | KPI 零转化浪费(搜索词/KPI) | KPI卡 | danger 色「N 个词花费≥$20 无销售」 | waste 判定:spend≥20 且 sales=0 | 构造词复算 | 生效 |
| AC-EL-ADS-098 | kpi_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-103 | Noon 占位提示(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-105 | KPI×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+覆盖 meta | GET /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-114 | Noon 占位卡(optlog·Noon) | 卡片 | 「Amazon 特有」说明卡 | 平台特有 tab | Noon 下自动跳转不显示 | 生效 |
| AC-EL-ADS-115 | RecEngine·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-116 | RecEngine·KPI×4(optlog/建议引擎) | KPI卡 | 已接受/已拒绝/已修改/规则分布前4 badge | stats 聚合 | 与列表计数对 | 生效 |
| AC-EL-ADS-117 | RecEngine·窗口页签(optlog/引擎toolbar) | 页签 | 全部/1d昨日/3d/7d/30d | win 参数;交互:筛选 | win 参数 | 生效 |
| AC-EL-ADS-118 | RecEngine·规则/状态筛选(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-121 | RecEngine·建议表(optlog/引擎表) | 表格 | 列:窗口/规则(RULE_TONE:emergency_stop 行红底/max_clicks_alert 黄底)/目标/品牌平台/花费/建议动作(modified=删除线原动作+修改版)/依据/状态/决策 | 引擎零 LLM;决策列见 122 | 色带规则目检 | 生效 |
| AC-EL-ADS-122 | RecEngine·决策三按钮(optlog/引擎表) | 按钮 | pending:✓接受/✗拒绝/✎修改,均强制理由(usePrompt) | POST /api/ads/recommendations/{rid}/decision(ads.py:1162);交互:弹理由框 | 空理由被拒 | 生效 |
| AC-EL-ADS-123 | RecEngine·⚡执行(optlog/引擎表·条件) | 按钮 | accepted+Amazon+keyword级+未执行;新bid USD 预填 suggested,护栏 [0.02,10],确认串 EXECUTE_ADS_ACTION | POST /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-124 | RecEngine·脚注(optlog/引擎) | 脚注 | 「23:00 UTC 三窗口·零LLM·活动级并入 advisor(23:10 UTC)」 | 与 advice 引擎分工声明 | 目检 | 生效 |
| AC-EL-ADS-125 | AI 优化日志折叠区(optlog/折叠) | details | 归档折叠;2026-10-11 E 源已停更 | 历史数据只读;交互:展开 | 默认收起 | 生效 |
| AC-EL-ADS-126 | LogTab·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-140 | NoonBidEditModal(noonkw/弹层) | 弹层 | 新出价护栏 [0.01,200] 本币;原生 window.confirm/alert(非 kit);确认串 EXECUTE_ADS_ACTION | POST /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-146 | referral 列集(noonfees/表) | 列集 | 履约badge/SKU/市场+SAR/AED/周期/基础价/佣金率%/佣金额 | 佣金=基础价×佣金率 | 单行验算 | 生效 |
| AC-EL-ADS-147 | storage 列集(noonfees/表) | 列集 | 月仓储费 | — | — | 生效 |
| AC-EL-ADS-148 | outbound 列集(noonfees/表) | 列集 | 出库费/计费重/实重/尺寸L×W×H cm/分类 | — | — | 生效 |
| AC-EL-ADS-149 | fbp 列集(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/上传卡) | input | accept .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-158 | auto 模式提示(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 联动 | 改参+立即重跑即时生效 | 生效 |
| 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-003 | KPI 卡①待回款 | 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-004 | KPI 卡②回款异常(>14 天) | KPI 卡 | 数量(danger 色)+ 金额 + 文案"需优先核查" | abnormal_count=count(*) FILTER(is_abnormal);金额=sum(revenue_usd) FILTER(is_abnormal);异常口径=已发货且超 14 天未回款(is_abnormal 同步层置位) | SQL 复算 abnormal 两值;抽异常行断言 >14 天 | 生效 |
| AC-EL-STL-005 | KPI 卡③已回款率 | 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-006 | KPI 卡④等待天数 | 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 副行小字;否则仅 USD | local_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 | 表格列-回款状态 | 表格列/badge | badge 四态:异常 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 220px | sku_list 原串;超宽 CSS 截断不换行 | 长 SKU 串断言截断显示 | 生效 |
| AC-EL-STL-020 | 加载态/导出按钮 | 状态/按钮 | 加载中骨架;exportCsv("settlement") 导出 CSV | CSV 列=表列同序同文案(含状态列文案与页面一致) | 断言 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-025 | KPI 卡②僵尸单(永不回款)+ 僵尸单 tab | KPI 卡/筛选 | 数量(有值 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-026 | KPI 卡③移除单(永不回款)+ 移除单 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 记录) | 生效 |
| 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-003 | Tab·🔌 平台 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-004 | Tab·🚚 服务商(货代等) | 筛选 | 显示 category=logistics 与 category=other 两类(货代/物流/其他第三方服务接口凭据) | page.tsx:64-65 tab === "logistics" && p.category === "other" 一并纳入 | e2e 断言 other 类凭据在本 tab 可见、platform tab 不可见 | 生效 |
| AC-EL-SET-005 | Tab·📖 API 字段 | 挂载 | 本 tab 渲染 ApiFieldsTab 组件(全库数据字典),详见 AC-EL-SET-036…043 | page.tsx:108 {tab === "fields" && <ApiFieldsTab />};组件本体 web/app/settings/ApiFieldsTab.tsx | e2e 切 tab 断言「API 字段参考」标题出现 | 生效 |
| AC-EL-SET-006 | Tab·🤖 大模型 | 挂载 | 本 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),目录中查不到时回退裸 key | page.tsx:199 providers.find(...)?.label || c.provider | e2e 断言与新增时选的类型 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 === 0 | e2e 空企业断言文案;新增后消失 | 生效 |
| 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 重置 config | e2e 编辑态断言 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 期间 disabled | page.tsx:68-82;整包重录=PUT 携带全量 config(旧密文不参与合并) | e2e 新增+重录各走一遍断言 toast 与列表行变化 | 生效 |
| AC-EL-SET-025 | 编辑卡·取消按钮 | 操作 | 关闭编辑卡并把表单重置为当前 tab 首个 provider + 空名称/空 config | page.tsx:170 | e2e 填一半点取消,再点新增断言表单为干净态 | 生效 |
| AC-EL-SET-026 | 编辑卡·明文丢弃提示 | 说明 | 保存/取消按钮旁灰字「提交后明文即刻丢弃(AES 加密落库, 列表只显掩码; 编辑需整包重录)」 | page.tsx:171-173;对应后端 _enc AES 加密落库、列表接口只回 _mask 结果 | e2e 断言文案存在;保存后再次编辑断言输入框为空(非回显明文) | 生效 |
| AC-EL-SET-027 | LLM 卡·标题 | 容器 | 「大模型供应商」副标「平台级 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-028 | LLM 卡·无权限态 | 空态 | llmErr 时灰字「无权限或加载失败:{err}(仅平台主企业管理员可管理)」 | page.tsx:113;请求 403/失败均落此态,不弹全局错误 | e2e 普通企业 owner 打开 🤖 tab 断言本文案 | 生效 |
| AC-EL-SET-029 | LLM 表·表头 | 表格 | 6 列:供应商/模型/协议/端点/Key/操作(无验证时间等列,区别于凭据表) | page.tsx:117;行数据=LlmState.providers(LlmP={id,label,model,format,endpoint,key_ok}) | e2e 断言 6 个 th | 生效 |
| AC-EL-SET-030 | LLM 表·供应商列 | 列 | label + badge:id===active 显「当前」(ok)、id===default 显「默认」(dim),二者互斥优先当前 | page.tsx:121-123 三元链 active > default > 无 | e2e 断言当前行恰一枚「当前」badge;默认行(非当前)显「默认」 | 生效 |
| AC-EL-SET-031 | LLM 表·模型/协议/端点列 | 列 | model(sku 样式)/format/endpoint 三列纯展示 | page.tsx:124-126 | e2e 断言与 providers 接口返回一致 | 生效 |
| AC-EL-SET-032 | LLM 表·Key 列 | 列 | badge:key_ok=true「就绪」(ok)/false「缺失」(bad);不显示任何 Key 内容 | page.tsx:127;key_ok 由后端判定(配置存在性),Key 值不出后端 | e2e 断言 badge 二态;页面源码/网络面板无 Key 值 | 生效 |
| AC-EL-SET-033 | LLM 表·切换按钮 | 操作 | 三态文案:busy=「探针中…」/当前行=「当前使用」/其余=「⇄ 切换到此」;disabled 条件 llmBusy || id===active || !key_ok | page.tsx:129-132 | e2e 断言当前行与缺 Key 行均 disabled | 生效 |
| AC-EL-SET-034 | LLM·切换流程 | 操作 | 确认框「切换大模型供应商?」正文含「切换到「{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-035 | LLM 卡·脚注 | 说明 | 「切换即时生效(下一次 AI 调用即走新供应商, 无需重启); 探针失败自动回滚保持原供应商; 全程审计。」 | page.tsx:140-142 | e2e 断言文案;切换后立即问一句 AI 断言走新供应商(audit 记录) | 生效 |
| AC-EL-SET-036 | API 字段 Tab·标题 | 容器 | 「API 字段参考」副标「全库数据字典 · {total} 张表/视图 · 点击行展开列定义」;total 千分位 | ApiFieldsTab.tsx:28;total 来自 GET /api/mapping/api-fields(collab.py:105) 响应 | e2e 断言标题与 total 数与本节脚注(SET-043)快照数一致 | 生效 |
| AC-EL-SET-037 | API 字段 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-038 | API 字段 Tab·搜索表单 | 筛选 | 输入框 placeholder「表名 / 列名 / 描述」+「搜索」按钮;submit 才触发查询(输入过程不实时搜) | ApiFieldsTab.tsx:39-44 onSubmit → setAfQuery(afSearch),afQuery 入参 search= | e2e 输入已知列名提交,断言结果含该列所在表 | 生效 |
| AC-EL-SET-039 | API 字段 Tab·表头 | 表格 | 6 列:表 / 视图、schema、分组、列数(右对齐)、行数(右对齐千分位)、说明 | ApiFieldsTab.tsx:50;列数=columns.length,行数=接口 rows 字段 | e2e 断言 th 与数值格式 | 生效 |
| AC-EL-SET-040 | API 字段 Tab·表行与展开 | 表格 | 行尾 ▸/▾ 指示;点击行 toggle 展开(expanded===id),展开行背景 #f8f8ff;说明列超长省略号;schema 空显「—」 | ApiFieldsTab.tsx:53-62 expanded === t.id ? " ▾" : " ▸";单展开(再点同行收起,点他行切换) | e2e 点行断言列定义区出现、再点收起、点第二行断言首行收起 | 生效 |
| AC-EL-SET-041 | API 字段 Tab·列定义展开区 | 表格 | colSpan=6 子行,grid 卡片式列出每列「列名[红*] …… 类型」;红 *= !nullable(非空/主键列) | ApiFieldsTab.tsx:63-76;columns={name,type,nullable} 由接口下发 | e2e 展开一张已知非空列的表断言红 * 出现 | 生效 |
| AC-EL-SET-042 | API 字段 Tab·空态行 | 空态 | 搜索/筛选无结果时 colSpan=6「无匹配」 | ApiFieldsTab.tsx:79 | e2e 搜乱码串断言文案 | 生效 |
| AC-EL-SET-043 | API 字段 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 张 | 生效 |
| ID | 元素 | 类型 | 描述 | 定义(数据来源·口径·边界) | 验证方法 | 状态 |
|---|---|---|---|---|---|---|
| AC-EL-BIL-001 | Suspense 兜底 | 状态 | 加载中占位 | 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-005 | KPI 当前套餐 | KPI 卡 | 套餐名;foot"支付通道已配置/支付通道未配置(演示模式)" | GET /api/billing/status:plan=tenants.plan;stripe_configured=bool(STRIPE_KEY),两值同响应 | 接口比对;未配 key 环境断言演示模式文案 | 生效 |
| AC-EL-BIL-006 | KPI AI 助手额度 | KPI 卡 | ai_ask 次/企业/天 | 按当前 plan 取 PLAN_AI_QUOTA(core.py 单一事实源,与执行层限额共用同常量) | 断言显示值与 AI 问答实际拦截限额同源同值 | 生效 |
| AC-EL-BIL-007 | KPI 选品搜索/关注池 | 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-010 | info 说明横幅 | 提示 | 卡内 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 | 模块状态 badge | badge | 已开通(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:联系开通 disabled | POST /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/Enterprise | GET /api/billing/plans 返回 BILLING_PLANS(billing.py 常量)+stripe_configured | 接口断言四档齐全 | 生效 |
| AC-EL-BIL-017 | 当前套餐 badge | badge | 当前套餐卡显"当前"(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 逐条 ul | BILLING_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 未回时整页占位 | 慢网断言出现后消失 | 生效 |
| 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-010 | dry-run 复选框 | 表单 | 默认勾选;文案"只出差异报表,不写业务库" | dry_run=true 入库;按钮文案/进度列/删除权限均随 dry_run 变化 | 勾选提交断言 toast"(dry-run 预览)" | 生效 |
| AC-EL-BKF-011 | 规则版本 badge | badge | "规则版本 {NEXT_PUBLIC_BACKFILL_RULE ?? 2026-10-v1}" | 构建时环境变量注入,未设回退"2026-10-v1";版本随回溯规则修订升级 | 断言当前构建显示值与发布配置一致 | 生效 |
| AC-EL-BKF-012 | 平台上限 badge | badge | maxDays 存在时显"平台上限 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 | 表格列/badge | done=ok/running=warn/queued=dim/error=bad/cancelled=bad;未知回退 dim | STATUS_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 丢弃断言条目消失 | 生效 |
| 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-between | e2e 点选后右侧加载结构卡 | 生效 |
| 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 + nowrap | title=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 | 后端·表清单端点 | API | GET /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 | 后端·表结构端点 | API | GET /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 | 后端·数据行端点 | API | GET /api/db/table/{table}/rows | brand 过滤仅 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 双保险) | 切品牌后行数变化 + 空态文案联动 | 生效 |
| ID | 元素 | 类型 | 描述 | 定义(数据来源·口径·边界) | 验证方法 | 状态 |
|---|---|---|---|---|---|---|
| AC-EL-DIC-001 | 页框架·AppShell | 框架 | title=数据字典;crumb=「全部业务表 × 字段含义 · 按业务域分组 · 语义注释与 changelog 归档同源」 | 2026-09-24 用户令「所有字段按业务输出到 zipforcehub」立页 | e2e 路由可达 + crumb 逐字 | 生效 |
| AC-EL-DIC-002 | 双 tab 切换 | 导航 | 「字段字典(系统口径)」「电商词汇(行业口径)」两 tab | view 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 | 后端·字典端点 | API | GET /api/dictionary | information_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 | 后端·词汇端点 | API | GET /api/glossary | glossary_domains()+attach_sys 注入系统落点;total=Σ各域词条;与 MCP glossary 工具共用同源;changelog 归档版 /audit/ecommerce-glossary-2026-09-24.md 同步维护 | 端点 total vs 页面计数 | 生效 |
| 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=alert | load/doSearch catch 均写 err=String(e.message) | 断端点场景横幅出现 | 生效 |
| AC-EL-DOC-003 | KPI 卡·根目录 | KPI | int(kpi?.roots);foot「品牌 / 部门 / 运营资料分区」 | roots=documents_nodes 中 parent='' 行数(后端 FILTER);kpi 仅 parent="" 根请求返回(AC-EL-DOC-022);kpi null → int=0 | 端点 kpi vs 卡值 | 生效 |
| AC-EL-DOC-004 | KPI 卡·文档链接 | KPI | int(kpi?.files);foot「飞书云文档 / 表格 / 上帝视角」 | files=type='file' 行数(FILTER 计数) | 同上 | 生效 |
| AC-EL-DOC-005 | KPI 卡·节点总数 | KPI | int(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 28 | total=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}」,点击 toggle | loading 中显示 …;isOpen=−;未展开=+;fontSize 13 | e2e 展开加载子级 | 生效 |
| 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 模式 | API | GET /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 模式 | API | GET /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="" 根请求返回 kpi | kpi={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 | 生效 |
| 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:53 | e2e 改密成功断言横幅文案 | 生效 |
| AC-EL-ACC-004 | 修改密码卡·标题 | 容器 | 「修改密码」副标「改密后其他设备全部下线,当前设备保持登录」 | account/page.tsx:56 | e2e 断言标题与副标 | 生效 |
| AC-EL-ACC-005 | 修改密码·当前密码输入 | 输入 | type=password,受控 pwd.old | account/page.tsx:58 | e2e 断言 input.type=password | 生效 |
| AC-EL-ACC-006 | 修改密码·新密码输入 | 输入 | label「新密码(≥8 位)」type=password,受控 pwd.new1 | account/page.tsx:59;≥8 位为前后端一致约束(前端 ACC-008 先拦) | e2e 断言 label 文本 | 生效 |
| AC-EL-ACC-007 | 修改密码·确认新密码输入 | 输入 | type=password,受控 pwd.new2 | account/page.tsx:60 | e2e 断言三输入框齐备 | 生效 |
| AC-EL-ACC-008 | 修改密码·客户端校验 | 校验 | 两次提交前检查:new1≠new2 →「两次输入的新密码不一致」;new1.length<8 →「新密码至少 8 位」;均写 err 横幅不发请求 | account/page.tsx:38-39 | e2e 两种非法输入各断言拦截文案且网络面板无 POST | 生效 |
| AC-EL-ACC-009 | 修改密码·按钮 | 操作 | 文案 busy=「提交中…」/常态「修改密码」;disabled = busy || !old || !new1(new2 空可点但会被一致性校验拦) | account/page.tsx:62-64 | e2e 空表单断言 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:69 | e2e 弱网断言先显加载态 | 生效 |
| 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=sid | account/page.tsx:77;sid 为服务端在册会话 ID,非令牌本体 | e2e 断言至少一行 sid 非空 | 生效 |
| AC-EL-ACC-015 | 会话表·登录时间列 | 列 | created 原样展示(muted),不做时区/格式转换 | account/page.tsx:78 | e2e 断言与登录时刻一致 | 生效 |
| AC-EL-ACC-016 | 会话表·状态列 | 列 | badge:current=true「当前设备」(ok)/false「其他设备」(dim) | account/page.tsx:79 | e2e 断言恰一行「当前设备」 | 生效 |
| AC-EL-ACC-017 | 会话表·空态行 | 空态 | colSpan=3「无在册会话」(登出后立即回显场景) | account/page.tsx:82 | e2e 退出全部后未跳转前断言(或 mock 空 items) | 生效 |
| AC-EL-ACC-018 | 刷新按钮 | 操作 | 「刷新」重拉 GET /api/auth/sessions;busy 期间 disabled | account/page.tsx:88 | e2e 另开登录后点刷新断言新行出现 | 生效 |
| 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:100 | e2e 断言文案;渗透测试矩阵含伪造签名/未在册令牌双拒用例 | 生效 |
| AC-EL-ACC-022 | 会话机制·登出生效行 | 说明 | 「服务端即刻吊销,旧 Cookie 立即作废(此前仅删浏览器 Cookie,令牌仍有效 8h)」 | account/page.tsx:101 | e2e 登出后用旧 Cookie 重放断言 401 | 生效 |
| AC-EL-ACC-023 | 会话机制·有效期行 | 说明 | 「8 小时滑动;Redis 故障时按未认证处理(fail closed)」 | account/page.tsx:102 | e2e 断言文案;故障注入 Redis 不可用断言全部 401(fail closed 不放行) | 生效 |
| AC-EL-ACC-024 | 会话机制·防跨企业行 | 说明 | 「令牌绑定企业 slug,跨子域使用直接拒绝(渗透测试矩阵覆盖)」 | account/page.tsx:103 | e2e 持 A 企业令牌访问 B 企业子域断言 401 | 生效 |
| 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:152 | e2e 重复邮箱建员工断言 409 文案上横幅 | 生效 |
| AC-EL-TEAM-004 | 成功横幅 | 反馈 | ok-banner 条 role="status";建/改/删员工、品牌增删恢复各写各自回执(见对应条目) | team/page.tsx:153 | e2e 各操作后断言回执文案 | 生效 |
| 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 ?? [],161 | e2e 点开断言抽屉品牌 chips 全 on | 生效 |
| AC-EL-TEAM-007 | 员工表·加载态 | 空态 | members 未返回时灰字「加载中…」 | team/page.tsx:163 | e2e 弱网断言先显加载态 | 生效 |
| 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:172 | e2e 断言与库内一致 | 生效 |
| AC-EL-TEAM-011 | 员工表·职能列 | 列 | job_label 展示,空值显「—」 | team/page.tsx:173 | e2e 断言与抽屉保存值一致 | 生效 |
| AC-EL-TEAM-012 | 员工表·角色列 | 列 | badge dim 展示 role(owner/admin/member) | team/page.tsx:174 | e2e 断言 badge 文本 | 生效 |
| AC-EL-TEAM-013 | 员工表·模块列 | 列 | owner/admin 显「全部」;其余显授权模块名(key→meta.modules[k].name,查不到回退 key)「、」连接,空显「(未授权)」;列宽上限 220 | team/page.tsx:175-178 | e2e 三种角色/空授权断言三种呈现 | 生效 |
| AC-EL-TEAM-014 | 员工表·品牌列 | 列 | owner/admin 显「全部」;其余显授权品牌「、」连接,空显「(无)」 | team/page.tsx:179 | e2e 同上三态 | 生效 |
| AC-EL-TEAM-015 | 员工表·状态列 | 列 | badge:active=「在职」(ok)/其他=「停用」(bad) | team/page.tsx:180 | e2e 停用员工断言 badge 翻转 | 生效 |
| AC-EL-TEAM-016 | 员工表·最后登录列 | 列 | last_login_at 截「yyyy-MM-dd HH:mm」(slice(0,16) T→空格),从未登录显「从未」 | team/page.tsx:181 | e2e 新建未登录员工断言「从未」 | 生效 |
| AC-EL-TEAM-017 | 员工表·操作列·编辑 | 操作 | 打开编辑抽屉(回填 email/name/job_label/modules/brands,密码置空),见 TEAM-035…044 | team/page.tsx:54-58, 184 | e2e 点编辑断言抽屉回填值 | 生效 |
| 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, 186 | e2e 删测试员工断言行消失+审计落账 | 生效 |
| 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, brand | e2e 断言标题;品牌清单与库一致 | 生效 |
| 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.add | team/page.tsx:98-103 | e2e 添加测试品牌断言三卡(员工抽屉品牌 chips/品牌表)同步出现 | 生效 |
| AC-EL-TEAM-024 | 品牌表·表头 | 表格 | 4 列:品牌/商品数/数据截至/操作 | team/page.tsx:206 | e2e 断言 4 个 th | 生效 |
| AC-EL-TEAM-025 | 品牌表·品牌列 | 列 | 品牌名 strong;停用品牌追加 badge dim「已停用」且整行 opacity 0.5 | team/page.tsx:209-210 is_active === false | e2e 停用后断言 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-219 | e2e 停用→恢复断言行态复原且各页数据回归 | 生效 |
| AC-EL-TEAM-030 | 品牌表·彻底删除按钮 | 操作 | 仅停用品牌渲染(danger 色);UI-07(2026-10-14) 接线两步走定稿(2026-09-22)第二步——先停用才可彻底删除;danger 确认「彻底删除品牌 {b}?/将永久删除该品牌的所有商品、订单、库存数据,不可恢复!」;DELETE ?mode=permanent | team/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-233 | e2e 断言标题与红边样式 | 生效 |
| 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 否则 400 | e2e 输错 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=1 | team/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-253 | e2e 点遮罩空白处断言抽屉关闭、点内容区不关 | 生效 |
| AC-EL-TEAM-036 | 抽屉·邮箱输入 | 输入 | 新增态可输入(登录账号);编辑态 disabled(邮箱不可改) | team/page.tsx:255-256 disabled={edit !== "new"} | e2e 编辑态断言不可交互 | 生效 |
| AC-EL-TEAM-037 | 抽屉·姓名输入 | 输入 | 自由文本,可空(列表显「—」) | team/page.tsx:257 | e2e 留空保存断言列表「—」 | 生效 |
| AC-EL-TEAM-038 | 抽屉·职能输入 | 输入 | 自由文本 job_label;点职能预设 chip 会覆盖此值(TEAM-040) | team/page.tsx:258 | e2e 手填+预设各试一次断言联动 | 生效 |
| AC-EL-TEAM-039 | 抽屉·密码输入 | 输入 | label 随态:新增「初始密码(≥8 位)」/编辑「重置密码(留空不改)」;type=password | team/page.tsx:259-260;新增前端先拦 <8 位(page.tsx:68),后端 org.py:93 同判 400;编辑态仅填了才随 PATCH 带 password | e2e 新增 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,选中 on | team/page.tsx:268-274;模块清单=meta.modules(key→{name,pages}),chip 显 name | e2e 勾/退各一次保存后断言列表模块列与库内授权一致 | 生效 |
| AC-EL-TEAM-042 | 抽屉·品牌授权 chips | 输入 | 分区标题「品牌授权(不选 = 该员工看不到任何品牌数据)」;chip=各在营品牌 toggle | team/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-252 | e2e 填一半点遮罩断言直接关闭无确认 | 生效 |
| ID | 元素 | 类型 | 描述 | 定义(数据来源·口径·边界) | 验证方法 | 状态 |
|---|---|---|---|---|---|---|
| AC-EL-AI-001 | 页面框架·标题与面包屑 | 布局 | AppShell title=「AI 助手」,crumb=「四大 AI 能力 · 数据经 RLS 隔离 · 全量审计」 | ai/page.tsx:58;组件本体见 AC-EL-CMP(AppShell) | e2e 断言标题与 crumb | 生效 |
| AC-EL-AI-002 | Tab 组(4 个) | 导航 | 数据问答/选品建议/广告文案/广告优化;默认 insight;切 tab 即清空 answer 与 err(不保留旧答案) | ai/page.tsx:6-13 TABS, 63-65 setTab(k); setAnswer(""); setErr("") | e2e 生成答案后切 tab 断言输出区清空 | 生效 |
| AC-EL-AI-003 | Tab·数据问答(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-004 | Tab·选品建议(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-005 | Tab·广告文案(adcopy) | 能力 | desc=「输入 SKU,生成 3 组英文广告标题 + 五点卖点。」 | ai/page.tsx:11;后端 POST /api/ai/adcopy(ai.py:350, require_module("ai")),审计 ai.adcopy | e2e 传入有效 SKU 断言回答含 3 组标题结构 | 生效 |
| AC-EL-AI-006 | Tab·广告优化(ads) | 能力 | desc=「逐广告活动分析 ACOS,给出加预算 / 降竞价 / 否定词 / 暂停建议。」 | ai/page.tsx:12;前端 path 映射 ads→POST /api/ai/ads-optimize(ai.py:804, require_module("ai")),审计 ai.ads-optimize | e2e 断言请求落在 ads-optimize 端点 | 生效 |
| AC-EL-AI-007 | insight·问题输入框 | 输入 | textarea rows=3;默认问题「最近哪个 SKU 营收下滑最严重?跌了多少?」;placeholder「如:上个月哪个 SKU 毛利跌了?为什么这个 SKU 的广告没有花费?」 | ai/page.tsx:31, 70-71 | e2e 断言默认值与 placeholder | 生效 |
| AC-EL-AI-008 | insight·快捷问题按钮组 | 输入 | 6 个 ghost 小按钮,点击将问题填入 textarea(不自动触发生成):最近哪个 SKU 营收下滑最严重?/最新月各品牌赚了还是亏了?/库存有哪些断货风险?/回款有没有异常订单?/各品牌近 30 天营收对比如何?/哪些 SKU 有广告花费但没有转化? | ai/page.tsx:73-77 onClick={() => setQuestion(q)} | e2e 点任一按钮断言 textarea 同步 | 生效 |
| AC-EL-AI-009 | adcopy·SKU 输入 | 输入 | placeholder「SKU(见商品页)」,随 body.sku 提交 | ai/page.tsx:83 | e2e 断言占位文本 | 生效 |
| AC-EL-AI-010 | adcopy·侧重点输入 | 输入 | placeholder「侧重点(可选),如:户外场景」,空则不约束生成角度 | ai/page.tsx:84 | e2e 断言占位文本 | 生效 |
| AC-EL-AI-011 | sourcing/ads·说明段落 | 说明 | 两 tab 无输入控件,仅 muted 小字展示 active.desc(即 TEAM 对应 desc 文案) | ai/page.tsx:87-89 | e2e 切两 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, 95 | e2e 未授权模块账号生成断言 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:99 | e2e 断言回答文本出现于 .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 引用 | 生效 |
| 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-003 | KPI 卡·定时任务 | KPI | jobs.length,未就绪「—」;foot「worker 定时调度 · UTC」 | jobs=PIPELINE_JOBS 代码常量(29 条,AC-EL-PIPE-022);调度时刻全部 UTC 口径 | 卡值=29 vs 注册表 | 生效 |
| AC-EL-PIPE-004 | KPI 卡·数据表在管 | KPI | tables.length,未就绪「—」;foot「RLS 企业可见范围行数」 | tables=后端 22 表 UNION ALL 常量行(AC-EL-PIPE-025);行数在 RLS 企业可见范围内统计 | 卡值=22 vs 巡检表行数 | 生效 |
| AC-EL-PIPE-005 | KPI 卡·Keepa 关注池 | KPI | int(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-006 | KPI 卡·状态页日期 | KPI | as_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=29 | sub 计数 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 天分片;错误在 stdout | docker 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);失败静默 catch | sub 计数 vs glossary 端点 total | 生效 |
| AC-EL-PIPE-044 | 词汇速查搜索与结果 | 筛选 | input「搜词条 / 英文 / 缩写(如 ACOS、IPI、FBN)」maxWidth 380 | term/en/abbr/desc/sys 五字段 lowercase includes;命中 slice(0,12) 上限 12 条;q 空不渲染结果区;结果表 5 列(词条 120/英文全称 180/缩写 90/释义/系统落点 200,minWidth 480);空命中「无匹配词条」 | 过滤命中与 12 条上限抽测 | 生效 |
| AC-EL-PIPE-045 | 后端·status 端点 | API | GET /api/pipeline/status | current_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 端点 | API | GET /api/pipeline/audit | audit_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 端点 | API | POST /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 失败→静默;无轮询/自动刷新——刷新页面才更新 | 网络面板两请求各一次 | 生效 |
| ID | 元素 | 类型 | 描述 | 定义(数据来源·口径·边界) | 验证方法 | 状态 |
|---|---|---|---|---|---|---|
| AC-EL-BRD-001 | 路由页壳 | 页壳 | 动态路由 /dashboard/[brand],URL 段即 brandKey;AppShell title={brandLabel(brandKey)} Amazon 主看板,crumb=对齐 UVPVP 8 区块 · 数据源 /api/dashboard/charts + /api/brandboard | title 展示名=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)+1 | clamp 1..3650;非法区间(NaN/end<start)回落全局窗口;独立区间仍是拖尾天数语义 | 代码走查 + e2e 卡片选 2026-10-01→2026-10-08 断言按 8 天窗口请求 | 生效 |
| AC-EL-BRD-006 | 墙数据加载 | API | GET /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-011 | KPI 卡×5 | KPI 卡 | 订单(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.length | e2e 断言锚点跳转与组标签 | 生效 |
| 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-016 | ChartGrid 拖拽持久化 | 持久化 | 每组独立 ChartGrid,pageKey=/dashboard/{brandKey}:{g.key} | 拖拽排序按账号持久化(user_dashboard_prefs);pageKey 区分独立页与工作台内嵌(内嵌 pageKey 见 §11.1) | e2e 拖拽后刷新断言顺序保持 | 生效 |
| AC-EL-BRD-017 | ChartCard 标题 | 图表卡标题 | title=CHART_TITLES[c.key]?.title ?? c.key | 标题字典=lib/chartTitles;无字典项时裸 key 兜底 | e2e 断言卡标题 | 生效 |
| AC-EL-BRD-018 | ChartCard 副题 | 图表卡副题 | 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-020 | ChartCard CSV | 导出 | csvName={brandKey}_{c.key},内容由 specCsv 生成(pie=项/值;直角=维度+各系列) | 独立区间生效时用独立 spec,否则用原始 c | e2e 下载断言文件名与首行表头 | 生效 |
| AC-EL-BRD-021 | ChartCard 独立区间 | 区间选择 | 每卡 range 下拉(默认 global,globalLabel=当前窗标签);选区间→onCardRange 按换算天数加载对应窗口墙并取同 key 图 | 独立区间未加载时回落全局 spec;语义同 BRD-005 | e2e 卡片选区间断言新墙请求与卡内数据变化 | 生效 |
| 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 | 列 | 国家代码,文本筛选 | 源字段 country | e2e 筛选 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-039 | Country/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-040 | C/S 列·Country | 列 | 国家代码,文本筛选 | 分组维度=国家×SKU | e2e 断言分组正确 | 生效 |
| AC-EL-BRD-041 | C/S 列·SKU | 列 | SKU,文本筛选 | SKU 宇宙事实源=sku_mapping(不另造清单) | e2e 筛选已知 SKU | 生效 |
| AC-EL-BRD-042 | C/S 列·Qty | 列 | 件数,右对齐,数值筛选 | 按订单内 SKU 数均摊(见 BRD-045) | SQL 复核均摊合计=订单件数 | 生效 |
| AC-EL-BRD-043 | C/S 列·Revenue (Local) | 列 | 本币营收,右对齐,数值筛选 | 源字段 rev_local;均摊口径同上 | e2e 断言与 Country 币种一致 | 生效 |
| AC-EL-BRD-044 | C/S 列·Revenue (USD) | 列 | 美元营收,右对齐加粗,数值筛选 | 源字段 rev_usd;均摊口径同上 | e2e 断言加粗与折算一致 | 生效 |
| AC-EL-BRD-045 | Country/SKU 口径脚注 | 口径脚注 | 表底固定:Country/SKU 汇总表口径:金额=折 USD|件数与金额按订单内 SKU 数均摊(items 级粒度未 ingest 的近似口径)|按国家×SKU 分组。 | 卡片 sub 同口径缩写版;近似口径声明为恒定标准(items 级 ingest 落地前不改) | e2e 断言脚注全文 | 生效 |
| AC-EL-BRD-046 | Country/SKU 导出 | 导出 | exportCsv/exportExcel 均为 {brandKey}_country_sku | 导出内容=当前 200 行内筛选结果 | e2e 下载断言文件名 | 生效 |
| 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 | 墙数据加载 | API | GET /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-012 | KPI 卡×4 | KPI 卡 | 窗口订单(件)(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-013 | FBN 库存预警卡 | KPI 卡 | id=nsec-fbn;k-value=FBN 总库存;foot=🔴 {urgent} · 🟡 {watch} · 🟢 {ok} · 缺口 {shortage_units}u · {period_days}d(快照 {snapshot}) 或 暂无快照(等待每日 08:00 采集);尾链 明细 → → /inventory | GET /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-016 | ChartGrid 拖拽持久化 | 持久化 | pageKey=/dashboard/noon/{brandKey}:{g.key} | 账号级记忆,与内嵌实例共用同 pageKey(两态排序互通) | e2e 拖拽刷新断言保持 | 生效 |
| AC-EL-BRDN-017 | ChartCard 标题 | 图表卡标题 | title=CHART_TITLES[c.key]?.title ?? c.key | 与 BRD-017 同源字典 | e2e 断言标题 | 生效 |
| AC-EL-BRDN-018 | ChartCard 副题 | 图表卡副题 | sub={EN[c.key] 原图名}{ · hint};无 EN 项时仅 hint | EN 名册=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-020 | ChartCard CSV | 导出 | csvName=noon_{brandKey}_{c.key} | specCsv 同 BRD-020 实现 | e2e 下载断言文件名 | 生效 |
| AC-EL-BRDN-021 | ChartCard 独立区间 | 区间选择 | range 下拉默认 global;选区间按换算天数加载对应墙取同 key 图,未加载回落全局 | 语义同 BRD-005/BRD-021 | e2e 选区间断言数据变化 | 生效 |
| 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 复核 | 生效 |
| ID | 元素 | 类型 | 描述 | 定义(数据来源·口径·边界) | 验证方法 | 状态 |
|---|---|---|---|---|---|---|
| AC-EL-ONB-001 | 页壳 | 页壳 | AppShell title=品牌管理,crumb=开户自动化 · 注册表驱动 · 新品牌/新产品零建表零发版 | 三块(web/库/采集)以注册表为合同:本页只写注册表与主数据,管道与健康由注册表驱动,零 LLM | e2e 断言标题与面包屑 | 生效 |
| AC-EL-ONB-002 | 元数据加载 | API | GET /api/onboarding/meta → platforms/marketplaces/categories/tenant_brands/brands_source | 失败→toast err;tenant_brands=本企业品牌(铁律①,RLS 限定) | e2e 断言选项渲染 | 生效 |
| AC-EL-ONB-003 | 管道健康加载 | API | GET /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 取该平台首个选中站点);留空则不带 channels | e2e 填写提交断言 brands_source/brand_channels 落库 | 生效 |
| AC-EL-ONB-009 | 直营/代卖下拉 | 下拉 | mode 选择:直营=direct / 代卖=consignment | 铁律②直营/代理区分的登记入口;服务端 mode 仅 direct/consignment,违者 400 mode 仅 direct/consignment: {v};写入 brand_channels.mode | e2e 两 mode 提交断言落库值 | 生效 |
| AC-EL-ONB-010 | 经营站点多选 | 多选 | 仅唯一平台选中时渲染;activeMks=marketplaces 按该平台过滤;tab {country} {currency} 可多选 | 服务端校验 (platform,country)∈marketplaces,坏站点 400 平台 {p} 无站点: {列表};多平台时隐藏(站点仅单平台语义) | e2e 双平台断言隐藏;单平台勾选断言提交 | 生效 |
| AC-EL-ONB-011 | 登记品牌按钮 | 按钮 | 登记品牌, 下一步(busy=登记中…);POST /api/onboarding/brand | body={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-20 | e2e 非法标识断言 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/category | body={category, name, attrs};成功 toast 类目已保存、自动选中新类目、meta 重载;busy 期间禁用 | e2e 保存断言下拉出现新类目 | 生效 |
| AC-EL-ONB-021 | 类目属性提示 | 文案 | 选中类目有 attr_schema 时显 类目属性: {label}{必填加 *} · … — 属性可经 API attrs 字段导入 | 引导 API 导入路径(attrs 字段);general 等无属性类目不显 | e2e 选有属性类目断言提示 | 生效 |
| AC-EL-ONB-022 | SKU 粘贴框 | 输入 | textarea rows=8,placeholder=每行一条: SKU, 品名, ASIN, 成本RMB
例: BN-001, BrainNews 智能台灯, B0XXXXXXXX, 45.5;等宽字体 | 行分隔 /\n+/;列分隔 /\t|,/(制表符或逗号);列序=SKU,品名,ASIN,成本RMB | e2e 粘贴样例断言解析 | 生效 |
| 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)→step3 | e2e 导入断言 imported 数与 step3 | 生效 |
| AC-EL-ONB-026 | 步骤3完成态 | 完成态 | ✓ 已导入 {imported} 个 SKU + 说明(商品页 /products 链接与工作台品牌筛选立即可见;管道自动装配文案) | 级联效果声明:主数据入库即全站可见,数据回流后分析自动带出 | e2e 导入后断言完成态文案与 /products 可见 | 生效 |
| AC-EL-ONB-027 | 再接入一个品牌按钮 | 按钮 | step3 显 再接入一个品牌;点击重置 step/brand/plats/csv/done→步骤1 | mks/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 新企业断言空态行 | 生效 |
| 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-002 | query 参数吸收 | 交互 | 挂载时从 URL query 读 due(届满日期)与 just=1(刚发起) | 来源两路:登录自救(login 响应)或团队页危险区发起注销(offboard 响应)由入口带入 | e2e 带 due/just 访问断言渲染 | 生效 |
| AC-EL-OFB-003 | 警示图标+标题 | 图标 | 44px 红底圆角「!」图标 + h1 注销冷静期 + 企业已停止服务,数据已完整归档 | danger 色变量(fallback #c0392b) | e2e 断言标题与图标 | 生效 |
| AC-EL-OFB-004 | just 横幅 | 横幅 | 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_admin | e2e 冷静期企业点恢复断言回 active 可进工作台 | 生效 |
| AC-EL-OFB-007 | 重新登录后可恢复按钮(just 路径) | 按钮 | just=1 时改显 a.btn 重新登录后可恢复(href=/login)+ 说明 注销时全员会话已吊销——登录后会被自动带回本页,再点「恢复企业」即可撤回。 | 会话已吊销故不能直接恢复;登录后被中间件带回本页走 OFB-006 | e2e ?just=1 断言登录按钮与说明 | 生效 |
| AC-EL-OFB-008 | 权限说明脚注 | 文案 | 恢复需要 owner / admin 权限;如你不是业主,请联系业主在本页操作。审计记录(注销/恢复)永久留存。 | 与 _require_admin 服务端契约一致;审计永久留存=不可误删的反向保障 | e2e 断言脚注;SQL 断言审计行 | 生效 |
| AC-EL-OFB-009 | err/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.gz | tenant_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 断言双向审计行齐备 | 生效 |
| 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-002 | Z 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/register | API | 提交 {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/login | API | 提交邮箱+密码,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,外包 RegGate | closedText=「注册暂未开放」(短版,区别于注册页长版文案);机制同 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-026 | verify token 参数读取 | 交互 | /verify 从 URL 查询串读 token | new 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-034 | welcome 页 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-035 | welcome header 导航 | 导航 | 顶栏:功能(#features)/ 数据安全(#security)/ EN(→/en)/ 免费注册(→/register,RegGate 包裹) | 锚点两项页内滚动;EN 切英文版;注册 CTA 受 RegGate 管控(机制同 001) | 读 welcome/page.tsx header 段 | 生效 |
| AC-EL-AUTH-036 | hero 徽章「亚马逊店铺 + 广告一体化数据分析 · SaaS」 | 文本 | hero 区胶囊徽章 | 静态定位语;与 /en 页英文徽章互译对应 | 读 welcome/page.tsx hero 徽章段 | 生效 |
| AC-EL-AUTH-037 | hero 主标题 | 文本 | h1「连接你的亚马逊店铺与广告数据,AI 一句诊断广告赚没赚」 | 静态;核心价值主张一句话(店铺+广告数据接入 → AI 诊断) | 读 welcome/page.tsx h1 段 | 生效 |
| AC-EL-AUTH-038 | hero 主 CTA「免费开始 —— 14 天全功能试用」 | 交互 | 主按钮 → /register,外包 RegGate | closedText=联系 support@zipforcehub.com 版本;「14 天全功能试用」口径同 004/terms §二 | 读 welcome/page.tsx CTA 段 | 生效 |
| AC-EL-AUTH-039 | hero 已有账号提示 | 文本 | 「已有账号?访问 你的公司名.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-055 | welcome 页脚 | 脚注 | © 2026 ZIPFORCE + 隐私政策/服务条款链接 | 链接 → /privacy、/terms;版权年份硬编码 2026 | 读 welcome/page.tsx footer 段 | 生效 |
| 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-002 | NoonPromoTab 承载 | 组件 | /promotion 唯一内容区=子组件 NoonPromoTab(站内促销 deals/coupons 面) | 本组只立壳层条目;NoonPromoTab 内部逐元素(表格/筛选/操作)未在本组展开,属促销组件另册待后续批次录入 | 读 promotion/page.tsx import;ls web/app/promotion/ 看子组件文件 | 待深化 |
| AC-EL-REDIR-003 | /upload 308 重定向 | 重定向 | 访问 /upload 永久重定向到 /listings | redirect("/listings")(next/navigation);代码注释载明缘由:2026-09-15 页面合并,上传(文件+A+)并入 /listings;旧链接/书签兼容通道 | 读 upload/page.tsx(6 行全文);curl -sI /upload 看 308 Location | 生效 |
| 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,外包 RegGate | closedText=「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-025 | KPI「培训模块」 | 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-026 | KPI「内容体量」+ 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-027 | KPI「主推课程」 | 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-038 | UVPVP 卡 1「核心词汇」 | 卡片 | UVPVP_SECTIONS 卡:vocab | desc「运营核心词汇表(ACOS/BSR/冗语等术语速查)」;tone=warn;链接 /training/uvpvp/vocab.html(静态直出,无 UVPVP 账号依赖) | 读 training/page.tsx UVPVP_SECTIONS[0] | 生效 |
| AC-EL-HLP-039 | UVPVP 卡 2「运营 SOP」 | 卡片 | UVPVP_SECTIONS 卡:sop | desc「标准作业流程(Listing 上架 / 广告 / 客服)」;tone=warn;链接 /training/uvpvp/sop.html | 读 training/page.tsx UVPVP_SECTIONS[1] | 生效 |
| AC-EL-HLP-040 | UVPVP 卡 3「Listing 教程」 | 卡片 | UVPVP_SECTIONS 卡:listing | desc「Listing 编写教程(标题/五点/A+ 要领)」;tone=warn;链接 /training/uvpvp/listing.html | 读 training/page.tsx UVPVP_SECTIONS[2] | 生效 |
| AC-EL-HLP-041 | UVPVP 卡 4「Listing 设计规范」 | 卡片 | UVPVP_SECTIONS 卡:listing-design | desc「设计规范 + 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 页脚段 | 生效 |
| 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/tree | API | 页面加载拉取云盘树:响应 {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-035 | KPI「云盘根目录」 | KPI | 值=kpi.roots(int 格式化) | 来源=documents/tree 响应;foot「品牌 / 部门分区直达」;接口失败显「—」非 0(见 034 降级边界) | 读 feishu/page.tsx 根目录 KPI 段 | 生效 |
| AC-EL-LEGAL-036 | KPI「镜像文档链接」 | KPI | 值=kpi.files(int 格式化) | 来源同上;foot「文档中心内可搜索浏览」指向文档中心能力 | 读 feishu/page.tsx 镜像 KPI 段 | 生效 |
| AC-EL-LEGAL-037 | KPI「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 说明段 | 生效 |
全壳通用:品牌名单单源=/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-002 | brandReady 初始化门 | 门控 | 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-007 | NAV_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-008 | navState 三态门控 | 门控 | 每个菜单项按 (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-009 | adminOnly 角色过滤 | 门控 | 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 挂载 | Provider | AppShell 将页面内容包 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;页面无外部图标资源请求 | 生效 |
全组件通用:图表 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-001 | KpiDeck(引用行) | 引用 | 工作台唯一 KPI 区:2 行×5 卡、右上 ▾ 换指标、ⓘ 口径说明 | 已录 §11.1 AC-EL-HOME-10..14;2026-10-22 口径文案×5 对齐 AC-CAL-02(订单/客单价/CPS/取消率/脚注②)并部署(镜像 31f9b5812522) | 见 §11.1;线上 ⓘ 展开逐字核对 | 生效 |
| AC-EL-CMP-002 | SkuMasterTable(引用行) | 引用 | SKU 主表(全量列与口径) | 已录 §11.3 AC-EL-SKU(2026-10-12 三卡合并拍板:Top15×2+SKU销量明细+四维矩阵→一张全量表) | 见 §11.3 | 生效 |
| AC-EL-CMP-003 | AdsAdvice(引用行) | 引用 | 广告建议组件(R24 算法/预算护栏/EXECUTE_ADS_ACTION 确认串) | 已录 §11.9 AC-EL-ADS 对应条目(bid 建议三源、九层写护栏、挂账项) | 见 §11.9 | 生效 |
| AC-EL-CMP-004 | EChart 渲染容器 | 图表 | 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-005 | GChart·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-006 | GChart·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-007 | GChart·EMPTY_OPT 空图兜底 | 空态 | spec 缺失/加载中统一渲染居中灰字「暂无数据」常量 EMPTY_OPT | P3 缺陷⑰(2026-10-01)——原裸 {series:[]} 渲染空坐标系无提示,违反「数据缺失须可视化兜底」铁律;BrandBoard/NoonBoard 均引用 | 无数据品牌墙图显示「暂无数据」而非空轴 | 生效 |
| AC-EL-CMP-008 | GChart·单点线补大圆点 | 图表 | 线图仅 1 个非空数据点时 symbol:"circle" symbolSize:10,≥2 点纯线 symbol:"none" | 2026-09-29——30 天全局窗下月度图只剩当月一点,symbol:none 画不出线成「有轴无线」伪装空白(e2e 像素扫描当场抓获) | 窗内单点月度图显示圆点 | 生效 |
| AC-EL-CMP-009 | ChartCard 图卡本体 | 图卡 | 图卡容器:标题+副题+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-010 | ChartCard·日期三态 | 筛选 | 每图独立日期控件三态:global 跟随页面全局窗 / {start,end} 独立区间 / null 未设;📅 展开起止 date 输入,独立区间显示「✕ 清除」 | 跟随态 tab 显示「跟随全局 · <globalLabel>」;start≤max(end)、end≥min(start) 互约束;清除回 global 并收起控件 | 设独立区间图卡重查独立窗数据;清除回全局 | 生效 |
| AC-EL-CMP-011 | ChartCard·⬇CSV | 导出 | 右上「⬇ CSV」导出本图数据 | 缺省 extractCsv 从 option 提取(类目 x 轴×各 series);业务可传 csv() 覆盖;文件名 zf_chart_<name>_<YYYYMMDD>.csv(name=csvName||id,非 [\w-] 字符替换 _);含引号/换行字段 RFC 转义+BOM | 任意图卡导出打开核对行列与图一致 | 生效 |
| AC-EL-CMP-012 | ChartGrid·拖拽/锁定/重置 | 交互 | 图卡栅格:拖拽排序(指针 Y 找插入点 insertBefore 语义)+「🔓 可拖动/🔒 已锁定」切换 +「↺ 重置」(confirm「恢复默认布局?(你的自定义排序会被清除)」) | 栅格 auto-fill minmax(min(420px,100%),1fr);锁定态 draggable=false;style prop 可覆盖布局(如单列 flex) | 拖动换序、锁定后不可拖、重置回默认序 | 生效 |
| AC-EL-CMP-013 | ChartGrid·布局持久化 | 交互 | 顺序与锁定态按登录账号+页面 key 服务端持久化 | GET /api/layout?page=<pageKey> 载入(未识别新卡 id 追加尾部,与 UVPVP applyOrder 同语义);拖拽结束/锁定切换 POST /api/layout {page,layout,locked};重置 POST /api/layout/reset {page} | 排序后换浏览器同账号顺序保持;重置后清除 | 生效 |
| AC-EL-CMP-014 | DataTable·通用表契约 | 表格 | 泛型数据表 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-015 | DataTable·列级筛选行 | 筛选 | 表头下筛选行: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-016 | DataTable·导出 CSV+Excel | 导出 | 右上「⬇ 导出 CSV」「⬇ 导出 Excel」按钮(分别传 exportCsv/exportExcel scope 才出现) | CSV=zf_<scope>_<YYYYMMDD>.csv(RFC 引号转义+BOM);Excel=.xls HTML 表格 WYSIWYG(与页面所见筛选+排序后一致,office:x 命名空间);两导出均只含当前筛选可见行 shown | 导出文件行数==页面筛选后行数 | 生效 |
| AC-EL-CMP-017 | DataTable·分页条 | 分页 | 表底 pager:上一页 / 第 N / M 页 · 共 T 条 / 下一页 | page≤1 禁用上一页、page≥pages 禁用下一页;total 可选缺省省略「· T 条」 | 翻页请求 page 参数递变 | 生效 |
| AC-EL-CMP-018 | DataTable·口径说明卡 caliber | 脚注 | 表上方「📖 口径说明(点击展开)」details/summary 折叠卡 | 2026-10-03 用户令,全栈表格统一;传 caliber ReactNode 即渲染;展开态浅底圆角块 | 任意带 caliber 表展开核对文案 | 生效 |
| AC-EL-CMP-019 | DataTable·加载/空态 | 空态 | loading 时表体内嵌 Skeleton(行 4×列=cols×高 30);无数据渲染 empty 或默认 EmptyState「暂无数据」 | 空态不隐藏表结构(列头常驻) | 慢网见骨架;空数据表显示空态 | 生效 |
| AC-EL-CMP-020 | kit·基础展示件 | 静态 | Spinner(zf-spin+「加载中…」可自定义文案)/ Skeleton(rows×cols 网格、行透明度 1−r×0.08 递减、aria-busy)/ EmptyState(◍ 图标+title+hint+action) | 零第三方依赖;全站加载/空态统一件 | 源码 kit.tsx(179 行) | 生效 |
| AC-EL-CMP-021 | kit·Delta 环比 | 状态 | 环比涨跌组件:((cur−prev)/prev)×100,好=绿/差=红(invert=true 成本类反转——下降为好) | cur/prev 为 null 或 prev===0 → 灰「—」;输出 +x.x%/−x.x% 一位小数 | 传参断言渲染色与符号 | 生效 |
| AC-EL-CMP-022 | kit·Toast | 反馈 | useToast()(msg,kind) 轻提示,pm-toast 样式 | kind=ok(✓ 默认)/err(✕ danger 底)/info(ℹ brand 底);2800ms 自动消失;KitProvider 宿主根布局挂载一次 | 触发保存成功/失败看 toast 色与前缀、2.8s 消失 | 生效 |
| AC-EL-CMP-023 | kit·Confirm | 弹窗 | useConfirm()({title,body,confirmText,danger}) → Promise<boolean> 弹窗,替代 window.confirm | danger=true 确认键 danger 红;遮罩/取消均 resolve(false);同时只留一个(新开先 resolve 旧为 false) | 删除流程确认/取消两分支行为 | 生效 |
| AC-EL-CMP-024 | kit·Prompt | 弹窗 | usePrompt()({title,fields}) → Promise<string[]|null> 多字段弹窗,替代 window.prompt | 字段{label,initial,placeholder,multiline};Enter 提交 / Esc 或遮罩取消(null);副题「确认后提交;取消则不做任何改动」;multiline=textarea rows 3 | 多字段表单提交取值/取消 null | 生效 |
| AC-EL-CMP-025 | RegGate·注册门 | 门控 | SAAS_REGISTRATION_OPEN=0 时把注册入口替换为灰字「注册暂未开放,请联系 support@zipforcehub.com」 | 开关状态以 API /api/auth/registration-status 为准(营销页预渲染,构建时读不到运行时 env);拿不到状态时放行显示原入口(API 层 403 兜底),避免状态接口故障误藏入口 | 关闭注册后入口页显示关闭文案;模拟状态接口故障入口仍在 | 生效 |
| AC-EL-CMP-026 | BrandContext·brand 模块级 store | Provider | 当前品牌选择=模块级外部 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-027 | BrandContext·初始化优先级 | 门控 | 登录后 info 到达时同步初始化当前品牌,优先级:localStorage 记忆 > 单品牌自动选中 > 账号同名品牌 | 品牌拆开铁律——多品牌账号默认落在自己的品牌而非「全部」聚合,「全部」仅显式点击生效;namesake=brands.includes(slug)?slug:(brands[0]??"");记忆品牌被删回退账号同名;初始化幂等(inited ref 按 slug) | 多品牌新登录默认选中自己品牌非「全部」 | 生效 |
| AC-EL-CMP-028 | BrandContext·注册表级联注入 | 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-029 | BrandContext·useBrandReady | 门控 | 品牌 store 初始化完成信号 hook;页面级请求 effect 必须等其为 true | 否则初始化前以 brand=""(全部聚合)打出请求——品牌拆开铁律下禁止(与 SHELL-002 门配套) | 源码 :79-87;新页面接入检查项 | 生效 |
| AC-EL-CMP-030 | AIContext·页面上下文注册 | Provider | useAIContext({page,title,presets,getContext}) 声明「我是谁、能问什么、当前选择是什么」,供 AppShell 挂载的 🤖 面板消费 | 栈式(LIFO)注册——同页多视图(如 sourcing 两个主 tab)各自入栈、卸载即弹出、栈顶生效;getContext 经 ref 恒取最新 | 源码 AIContext.tsx;切 tab 面板标题/预设随之变 | 生效 |
| AC-EL-CMP-031 | AIChat·悬浮球与面板 | 交互 | 右下角固定悬浮球「🤖 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-032 | AIChat·问答链路 | 交互 | 提问 POST /api/ai/page-chat {page: cfg.page||"generic", context: getContext(), question},回 {answer} 入气泡 | 切页面(cfg.page 变)清空会话与错误;Enter 发送(e.nativeEvent.isComposing 防中文输入法组字误发);busy 期输入与发送禁用;失败红字错误条 | 源码 send;中文输入法组字中回车不发送 | 生效 |
| AC-EL-CMP-033 | MatrixSection·四维矩阵本体 | 表格 | 平台×国家×品牌×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-034 | MatrixSection·四图 | 图表 | 收入趋势图(线)/ 利润对比图(柱,x=品牌-国家)/ SKU 分布图(饼,收入)/ 国家热力图(横条,收入+利润双系列),高 286 | 趋势 2026-09-28 修复——API 内层 key 为「{brand}/amz|{brand}/noon」非裸品牌名,原按裸名取值恒 0 趋势整条贴零;系列按真实 key 生成(两系列均 USD,Noon 侧 API 已按锚定汇率折算);数据未到整区 Skeleton | 趋势线 Noon 系列非全零 | 生效 |
| AC-EL-CMP-035 | MatrixSection·口径说明 | 脚注 | 表上方 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-036 | BrandBoard·主看板主体契约 | 引用 | 品牌主看板(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-037 | BrandBoard·数据源与缓存 | 表格 | 墙 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-038 | BrandBoard·核心指标 5 卡 | KPI卡 | 订单(foot=N 件)/ 营收 USD(foot=客单价 $)/ 净利 USD(foot=利润率 %)/ 费用 USD(foot=已回款 $)/ 取消率 %(foot=区间 from→to) | 值=墙 kpis 字段;仅全屏页渲染(compact 无);空值渲染「—」 | 与墙响应 kpis 对算 | 生效 |
| AC-EL-CMP-039 | BrandBoard·图题与 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-040 | BrandBoard·图卡交互 | 交互 | 每图 ⬇CSV(specCsv:pie=项/值两列,其余=维度×系列矩阵)+ 独立日期区间 + ChartGrid 拖拽持久化 | 独立区间仍是拖尾天数语义(rangeDays=区间天数 clamp [1,3650],独立窗墙按需加载、未加载回落全局);pageKey=/dashboard/<brand>:<组> | 设独立区间图卡换窗数据;CSV 打开核对 | 生效 |
| AC-EL-CMP-041 | BrandBoard·数据表格区 | 表格 | 📋 数据表格区:订单明细表(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-042 | BrandBoard·空态/被拒态 | 空态 | 墙 empty→「该品牌窗口内无订单数据」引导卡(试试「全部」窗口,或检查采集管道);墙未载且 err→「无法加载该品牌看板」引导卡(请从工作台品牌区进入) | P3 缺陷㊴(2026-10-01)——品牌被拒(403/他牌)时 brandboard/* 的 catch(()=>{}) 吞错致骨架永卡/「第1/1页·0条」误导;chart_count 行空墙 from/to 为 null 时省略「( → )」括号段(P3 残片修复) | 越权品牌直达路由看引导卡不卡骨架 | 生效 |
| AC-EL-CMP-043 | NoonBoard·主看板主体契约 | 引用 | 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-044 | NoonBoard·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-045 | NoonBoard·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-046 | NoonStatement·表①官方对账单 | 表格 | 财务页 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-047 | NoonStatement·VAT 内拆 | 列组 | 每费项拆「含税|VAT」两列,VAT=含税×市场税率,税率写死 STMT_VAT_RATE={SA:15/115, AE:5/105} | VAT>0 绿色显示;聚合层不先拆——渲染层按市场税率对聚合后含税值内拆(率恒定,与逐月拆后求和等价);期初/期末/打款等非费项列不拆 | SA 行 VAT=含税×15/115 手算核对 | 生效 |
| AC-EL-CMP-048 | NoonStatement·月/季/年聚合 | 表格 | STMT_GRAINS 月/季/年聚合 aggregateStmts(客户端,源=月粒度行),分组键=品牌|市场|期间 | 期初=期内首月期初、期末=期内末月期末,其余 13 列(净入账/总费用/打款/8 费项/银行转账/余额转账)期内求和;组内全 null 保持 null;排序 mon 降序→品牌→市场;表② aggregateOps 同法(15 量列求和) | 季行=三月行手算对(期初取首月、期末取末月) | 生效 |
| AC-EL-CMP-049 | NoonStatement·表②月度经营总表 | 表格 | 表②:月度经营总表 20 字段(用户字段清单逐字):月份|品牌|市场|Orders|Units Sold|Valid Units|Delivered|Pending|Cancel Order|未妥投|CIR|GMV|Commission|Delivery|Ad Spend|Gross Profit|COGS|Net Profit|Settlement 净额|Payout | OPS_COLS 17 数据列(英文 head 逐字+未妥投/CIR/Settlement 净额中英混合);gross=settlement−ad、net=gross−cogs(聚合后推导列);net<0 红字、gross/net strong 加粗;金额列 muted、计数列裸数字(toLocaleString 0 位小数) | 列头逐字比对清单;net 手算 | 生效 |
| AC-EL-CMP-050 | NoonStatement·期间下拉 | 筛选 | #56 期间下拉(墙钟锚定):今年/本月/上月/近3月/近12月/去年 + #56b 单月键(YYYY-MM 合法,窗口=[该月,该月]) | periodRange 返回 [起月,止月](this_year=YYYY-01~YYYY-12 等);标题 periodLabel——单月→「2026-09」、月度→月键、年→「YYYY 全年」、近3月→「YYYY-MM~MM」;未知键回本月 | 选上月窗口=上个自然月整月 | 生效 |
| AC-EL-CMP-051 | CustomModules·模块本体与 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-052 | CustomModules·编辑器 | 弹窗 | 添加/编辑弹窗:数据域 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-053 | CustomModules·卡片查询与筛选 | 筛选 | 模块卡片: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-054 | CustomModules·成图规则 | 图表 | dims[0]=X 轴,其余维度组合拆系列(多度量时系列名「组合·度量」);饼图=全维度组合为扇区×首个度量 | 多度量饼图不再只画首度量——逐度量各一饼、各自量纲独立成图(挂账①);顺带修复裸数字数组被 d.value>0 滤空的隐性 bug;渲染走 GChart specToOption 单源 | 两维×两度量图系列数=组合数×2 | 生效 |
| AC-EL-CMP-055 | CustomModules·Noon 本币提醒 | 脚注 | noon 域选金额度量且未选「国家/站点」维时编辑器行内提醒 | 挂账⑥——NOON_LOCAL={noon_gmv,noon_net,noon_ad,noon_commission} 站点本币(AE=AED/SA=SAR)未拆国家维直接相加;文案「…两种币种直接相加——建议勾选国家维拆分」 | 构造该组合看提醒文案出现 | 生效 |
| ID | 元素 | 类型 | 描述 | 定义(数据来源·口径·边界) | 验证方法 | 状态 |
|---|---|---|---|---|---|---|
| AC-EL-FIN-C-001 | 卡头 h2 | 卡头 | 「Amazon {月} 累计 · 分市场」+ sub 结算净额/毛利润/净利润三公式 | /api/finance/kpi-wall;page.tsx:718 | 文案断言 | 生效 |
| AC-EL-FIN-C-002 | 月份下拉 | 筛选器 | monOpts select 切 amzMon | page.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),muted | 2026-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→—否则 localCur | 2026-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),muted | td9(701) | 对拍 | 生效 |
| AC-EL-FIN-C-013 | 列10 尾程配送 FBA | 列 | local_fba 优先,回退 usd(fba),muted | td10(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||cur3 | td12(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;posColor | td14(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);不折 USD | RMB 原值 | 生效 |
| AC-EL-FIN-C-020 | 列17 净利润 | 列 | net=gross−product_cost,全程 USD 计算(严禁币种混算),strong+posColor | td17(709) | 复算 | 生效 |
| AC-EL-FIN-C-021 | 列18 回款 | 列 | usd(payout),null→— | td18(710) | 对拍 | 生效 |
| AC-EL-FIN-C-022 | 全市场行 | 行 | 首行「全市场 USD」底色 #fbfcfd | amzRow(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),strong | has_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),muted | AMZ 侧 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/AE | country 参数(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=alert | err←catch(980) | role=alert | 生效 |
| AC-EL-FIN-C-055 | DataTable 容器 | 表格 | 排序/筛选/CSV=noon_sku/Excel=noon_sku/minWidth 3400/rowKey=brand+model+color+country | NOON_COLS 由 NOON_SPEC 生成;21 个金额列头加(本币)后缀(2026-10-03 用户令) | 导出列数=44 | 生效 |
| AC-EL-FIN-C-056 | caliber 口径块 | 脚注 | 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=str | NOON_SPEC 第 1 项(数组 page.tsx:903–917,每行 4 项);行键组成 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-058 | 列2 颜色 | 列 | key=color,格式化 kind=muted | NOON_SPEC 第 2 项(数组 page.tsx:903–917,每行 4 项) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-059 | 列3 品牌 | 列 | key=brand,格式化 kind=brand | NOON_SPEC 第 3 项(数组 page.tsx:903–917,每行 4 项);行键组成+品牌过滤键 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-060 | 列4 国家 | 列 | key=country,格式化 kind=muted | NOON_SPEC 第 4 项(数组 page.tsx:903–917,每行 4 项);SA=SAR / AE=AED 分行 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-061 | 列5 SKU数 | 列 | key=skus,格式化 kind=num | NOON_SPEC 第 5 项(数组 page.tsx:903–917,每行 4 项);合并 SKU 数 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-062 | 列6 订单 Orders | 列 | key=orders,格式化 kind=num | NOON_SPEC 第 6 项(数组 page.tsx:903–917,每行 4 项);订单号去重 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-063 | 列7 销售件数 Units Sold | 列 | key=units,格式化 kind=num | NOON_SPEC 第 7 项(数组 page.tsx:903–917,每行 4 项) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-064 | 列8 取消订单 Cancel Order | 列 | key=cancelled,格式化 kind=abs | NOON_SPEC 第 8 项(数组 page.tsx:903–917,每行 4 项) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-065 | 列9 不可投递 | 列 | key=undeliverable,格式化 kind=abs | NOON_SPEC 第 9 项(数组 page.tsx:903–917,每行 4 项) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-066 | 列10 CIR | 列 | key=cir,格式化 kind=abs | NOON_SPEC 第 10 项(数组 page.tsx:903–917,每行 4 项) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-067 | 列11 有效件 Valid Units | 列 | key=valid_orders,格式化 kind=numB | NOON_SPEC 第 11 项(数组 page.tsx:903–917,每行 4 项);=件数−取消−不可投递−CIR | 抽行对拍 | 生效 |
| AC-EL-FIN-C-068 | 列12 GMV | 列 | key=gmv,格式化 kind=num | NOON_SPEC 第 12 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-069 | 列13 佣金 Commission | 列 | key=commission,格式化 kind=abs | NOON_SPEC 第 13 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-070 | 列14 履约费 | 列 | key=delivery_fee,格式化 kind=abs | NOON_SPEC 第 14 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;noon 尾程 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-071 | 列15 运费补贴 | 列 | key=shipping_credits,格式化 kind=abs | NOON_SPEC 第 15 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-072 | 列16 其他订单 Orders费 | 列 | key=other_order_fees,格式化 kind=abs | NOON_SPEC 第 16 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-073 | 列17 订单 Orders补贴 | 列 | key=order_subsidies,格式化 kind=abs | NOON_SPEC 第 17 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-074 | 列18 非订单 Orders费 | 列 | key=non_order_fees,格式化 kind=abs | NOON_SPEC 第 18 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-075 | 列19 非订单 Orders补贴 | 列 | key=non_order_subsidies,格式化 kind=abs | NOON_SPEC 第 19 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-076 | 列20 其他 | 列 | key=others,格式化 kind=abs | NOON_SPEC 第 20 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-077 | 列21 VAT(推算) | 列 | key=vat_est,格式化 kind=abs | NOON_SPEC 第 21 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;五费×市场税率内拆+广告×外加(finance.py) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-078 | 列22 结算 Settlement净额 | 列 | key=settlement,格式化 kind=numB | NOON_SPEC 第 22 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-079 | 列23 退款 Refund | 列 | key=refund,格式化 kind=abs | NOON_SPEC 第 23 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-080 | 列24 曝光量 Impression | 列 | key=views,格式化 kind=num | NOON_SPEC 第 24 项(数组 page.tsx:903–917,每行 4 项) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-081 | 列25 点击 | 列 | key=clicks,格式化 kind=num | NOON_SPEC 第 25 项(数组 page.tsx:903–917,每行 4 项) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-082 | 列26 CTR | 列 | key=ctr,格式化 kind=pct | NOON_SPEC 第 26 项(数组 page.tsx:903–917,每行 4 项) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-083 | 列27 ATC | 列 | key=atc,格式化 kind=num | NOON_SPEC 第 27 项(数组 page.tsx:903–917,每行 4 项) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-084 | 列28 广告花费 Ad Spend订单 Orders | 列 | key=ad_orders,格式化 kind=num | NOON_SPEC 第 28 项(数组 page.tsx:903–917,每行 4 项);表头文案为源码原样(双语拼接),勿当错字改 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-085 | 列29 CVR | 列 | key=cvr,格式化 kind=pct | NOON_SPEC 第 29 项(数组 page.tsx:903–917,每行 4 项) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-086 | 列30 广告花费 Ad Spend花费 Spend | 列 | key=ad_cost,格式化 kind=num | NOON_SPEC 第 30 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-087 | 列31 广告花费 Ad Spend销售 | 列 | key=ad_revenue,格式化 kind=num | NOON_SPEC 第 31 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-088 | 列32 ACOS | 列 | key=acos,格式化 kind=pctD | NOON_SPEC 第 32 项(数组 page.tsx:903–917,每行 4 项);>50% 红标 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-089 | 列33 TACOS | 列 | key=tacos,格式化 kind=pctD | NOON_SPEC 第 33 项(数组 page.tsx:903–917,每行 4 项);>30% 红标 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-090 | 列34 CPC | 列 | key=cpc,格式化 kind=d2 | NOON_SPEC 第 34 项(数组 page.tsx:903–917,每行 4 项) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-091 | 列35 CPS | 列 | key=cps,格式化 kind=d2 | NOON_SPEC 第 35 项(数组 page.tsx:903–917,每行 4 项) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-092 | 列36 单件成本 Cost | 列 | key=cost_per_unit,格式化 kind=d2x | NOON_SPEC 第 36 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-093 | 列37 有效件 Valid Units成本 Cost | 列 | key=valid_orders_cost,格式化 kind=num | NOON_SPEC 第 37 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-094 | 列38 头程 | 列 | key=first_mile,格式化 kind=abs | NOON_SPEC 第 38 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;按拍板恒 0 录入 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-095 | 列39 不可售件 | 列 | key=unsaleable,格式化 kind=abs | NOON_SPEC 第 39 项(数组 page.tsx:903–917,每行 4 项) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-096 | 列40 不可售成本 Cost | 列 | key=unsaleable_cost,格式化 kind=abs | NOON_SPEC 第 40 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-097 | 列41 毛净 | 列 | key=gross_net,格式化 kind=num | NOON_SPEC 第 41 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;=结算净额 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-098 | 列42 净利润 Net Profit | 列 | key=net_profit,格式化 kind=signB | NOON_SPEC 第 42 项(数组 page.tsx:903–917,每行 4 项);列头加(本币)后缀;正绿负红 | 抽行对拍 | 生效 |
| AC-EL-FIN-C-099 | 列43 净利润 Net Profit率 | 列 | key=margin,格式化 kind=pctS | NOON_SPEC 第 43 项(数组 page.tsx:903–917,每行 4 项) | 抽行对拍 | 生效 |
| AC-EL-FIN-C-100 | 列44 单件履约 | 列 | key=unit_fulfill,格式化 kind=d2 | NOON_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+aggregateStmts | M→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,strong | gross=Settlement 净额−Ad Spend(聚合后派生) | 复算 | 生效 |
| AC-EL-FIN-C-152 | 列17 COGS | 列 | money | COGS=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 广告 | 列 | 金额 | — | 对拍 | 生效 |
| ID | 元素 | 类型 | 描述 | 定义(数据来源·口径·边界) | 验证方法 | 状态 |
|---|---|---|---|---|---|---|
| AC-EL-SRC-W-001 | Keepa 未配置空态 | 空态 | EmptyState「Keepa 通道未配置」 | keepa_configured=false 整 tab 替换(112-118) | 断配置渲染 | 生效 |
| AC-EL-SRC-W-002 | KPI 监控池 | KPI卡 | count / watch_limit | 上限按套餐(可升级) | SQL 对拍 | 生效 |
| AC-EL-SRC-W-003 | KPI 今日搜索配额 | KPI卡 | quota_left | 每次搜索/拉历史消耗 1 次(配额池口径) | 搜索后 -1 | 生效 |
| AC-EL-SRC-W-004 | KPI 每日自动刷新 | 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=alert | err←catch | role=alert | 生效 |
| AC-EL-SRC-W-010 | Spinner | 反馈 | 「实时查询 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/watch | pulled=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-018 | ASIN 深链 viewer | 链接 | 点击 SPA 无刷新跳价格历史 tab | setQs({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 线图 #4f46e5 | trend≥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 640 | setDetail(it) | 点遮罩关闭 | 生效 |
| AC-EL-SRC-W-027 | drawer 元信息 | 静态 | 站点·ASIN·Buybox·BSR·评分 | detail 字段 | 对拍 | 生效 |
| AC-EL-SRC-W-028 | 90 天历史图 | 图 | 新品价线(#4f46e5)+BSR 副轴(#d97706 反转) | GET /product?asin&domain(耗 1 配额);无序列提示 | 拉后 load() | 生效 |
| AC-EL-SRC-W-029 | 零配额说明+拉取按钮 | 按钮 | 「详情默认展示池内已有快照(零配额消耗);拉取 90 天完整历史会消耗 1 次搜索配额」 | 配额披露文案(281-283) | 文案断言 | 生效 |
| AC-EL-SRC-W-030 | drawer 移除/关闭 | 按钮 | 底部 ghost 移除监控/关闭 | — | 关闭清 detail | 生效 |
| AC-EL-SRC-V-001 | 国家 select | 筛选器 | KEEPA_COUNTRIES 13 站 | AE/SA/SE 不采集被收窄(F2 修,选中必 400) | 13 项断言 | 生效 |
| AC-EL-SRC-V-002 | ASIN 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-006 | Spinner | 反馈 | 「读取时序…」 | 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-010 | KPI 品牌 | KPI卡 | meta.brand 回退 — | — | 对拍 | 生效 |
| AC-EL-SRC-V-011 | KPI 当前 BSR | KPI卡 | bsr_current,foot=月销 monthly_sold | — | 对拍 | 生效 |
| AC-EL-SRC-V-012 | KPI BuyBox | KPI卡 | buy_box_price 本币,foot=offers 已采/未 offers 采集 | csv[18] 三元组(分期三 A) | 未采显「未 offers 采集」 | 生效 |
| AC-EL-SRC-V-013 | KPI New/Amazon | KPI卡 | price_new / price_amazon,foot=Used·List | — | 对拍 | 生效 |
| AC-EL-SRC-V-014 | KPI 评分/评论 | KPI卡 | rating .1f / reviews,foot=上市 listed_since | — | 对拍 | 生效 |
| AC-EL-SRC-V-015 | KPI 时序覆盖 | 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-017 | BuyBox 时序 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-019 | Keepa 官方原图卡 | 图 | 90/365 天 tab + /api/sourcing/keepa-graph 代理 PNG w900 h320 | 1 配额/图;同参数 90min Keepa 侧免配额;redis 5400s;key 不出后端;截不到=无价格记录 | 二次加载 0 配额 | 生效 |
| AC-EL-SRC-V-020 | BSR 排名历史图 | 图 | y 轴反转(小=好)#d97706 | rank 序列 | 方向断言 | 生效 |
| 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=alert | err←catch | role=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-100 | rating_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-016 | FBA select | 筛选器 | 不筛/用过 FBA/没用过 FBA | has_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+cached | 10min 内复点 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-026 | BR 不可用提示 | 空态 | 「BR 域该端点官方不可用,请换站点」 | country===BR 分支 | 选 BR 断言 | 生效 |
| AC-EL-SRC-S-027 | 拉取/刷新按钮 | 按钮 | 「🏅 拉取最高评分卖家榜(50 配额)」/「刷新榜单(50 配额)」 | loadTs | 点击出榜 | 生效 |
| AC-EL-SRC-S-028 | 全库计数+缓存徽标 | 反馈 | 全库 N 家·展示前 M + 缓存命中(0 token) | total_ids+ids.length | 24h 内复点 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-032 | ID/名称 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-035 | ID 未命中 hint | 反馈 | hint 文本 | mode=id&&!found | 对拍 | 生效 |
| AC-EL-SRC-S-036 | 名称匹配表 | 表格 | 卖家 ID/名称/池内赢家/评分/评分数(5 列)行点击转 ID 查 | matches[] | 点行出档案 | 生效 |
| AC-EL-SRC-S-037 | 档案 KPI×6 | KPI卡 | 卖家(商号·刚实时入库)/评分评分数(近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-042 | BuyBox 竞争者 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+cached | 30min 内复点 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 contain | img 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-026 | Prime 标记 | 标记 | 🅿 角标 title=Prime 资格 | is_prime | 对拍 | 生效 |
| AC-EL-SRC-D-027 | 卖家列 | 列 | seller_name||seller_id(title=ID)+·FBA | is_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 FBA | price_type | 切换生效 | 生效 |
| AC-EL-SRC-F-006 | 价格区间 min/max | 输入 | 本币两位 input | price_min/price_max | 区间生效 | 生效 |
| AC-EL-SRC-F-007 | BSR 排名区间 | 输入 | 大类 min/max | bsr_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-009 | 30天掉榜≥ input | 输入 | 估算销量口径 | drops30_gte | 对拍 | 生效 |
| AC-EL-SRC-F-010 | 评分≥ input | 输入 | 0-5 星 step 0.1 | rating_gte | 对拍 | 生效 |
| AC-EL-SRC-F-011 | 评论数≥ input | 输入 | — | reviews_gte | 对拍 | 生效 |
| AC-EL-SRC-F-012 | 总报价数≤ input | 输入 | 竞争热度 | offers_lte | 对拍 | 生效 |
| AC-EL-SRC-F-013 | Amazon 自营状态 select | 筛选器 | 不筛/自营现货/无自营报价/自营预售/自营补货 | amazon_offer | 对拍 | 生效 |
| AC-EL-SRC-F-014 | BuyBox 归属 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/cached | 10min 复点 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_coverage | chip 合计≈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-027 | ASIN 跳转按钮 | 按钮 | tab sku 样式「{asin} 📈」+行尾「📈 历史」 | setQs viewer 种子 | 点击跳 viewer | 生效 |
| AC-EL-SRC-F-028 | ASIN 网格回退态 | 空态 | 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=true | isAdmin←/api/tenant/info role | 429 复现 | 生效 |
| AC-EL-SRC-X-003 | Pareto 排序按钮 | 按钮 | 「⚖ Pareto 排序 Top30」 | GET /api/sourcing/verdicts/pareto?limit=30 | 点击出表 | 生效 |
| AC-EL-SRC-X-004 | 状态筛选 select | 筛选器 | 全部状态/跟进/观察/放弃/主攻/杀 | state 参数 | 过滤生效 | 生效 |
| AC-EL-SRC-X-005 | 搜候选词 input | 输入 | 回车触发 load | q 参数 | 命中集变 | 生效 |
| AC-EL-SRC-X-006 | Pareto 卡 | 表格 | 排名/候选词/可用维度;四维(周期数↑ 月销↑ 评论↓ 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)dim | sources[] | 对拍 | 生效 |
| 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:v | gates 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_reason | legacy 历史旁证避免重复翻案 | 对拍 | 生效 |
| AC-EL-SRC-X-016 | 状态 badge | 徽章 | 跟进 ok/观察 warn/放弃 dim/主攻 ok/杀 bad(state_cn) | STATE_TONE | 对拍 | 生效 |
| AC-EL-SRC-X-017 | 裁决按钮 | 按钮 | 行尾 ghost;打开 drawer 默认 watch→follow | setDecide(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 | 提交后行状态变 | 生效 |
| 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-002 | tab 状态 URL 同步 | 导航 | 五 tab 选中态同步进 URL query(tab 参数) | useQueryState({ tab: "tracking" }) 默认 tracking;2026-09-21 起 tab 不再是纯前端 state——刷新/分享链接不回默认 tab | e2e 切到 pricing 后刷新断言仍停 pricing | 生效 |
| AC-EL-LOG-003 | 数据接口·船票列表 | 接口 | GET /api/logistics/shipments?badge&search&brand&page&page_size | logistics.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-004 | KPI·在途 | 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-005 | KPI·累计签收 | 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-006 | KPI·阶段超时 | 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-007 | KPI·动态徽章卡 | 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-013 | Tracking 表·列 产品名/型号 | 表格列 | 两行:product_name(strong)+ t2「型号 · AWB」 | product_name/model_number 为产品对齐核心(同全站);空 product_name 回退型号行展示 | 抽行与源表 product_name/model_number 比对 | 生效 |
| AC-EL-LOG-014 | Tracking 表·列 AWB 提单号 | 表格列 | AWB + overdue 时叠加「超时」bad badge | awb 直显;stage_overdue 服务端置位(同步层),前端只渲染 | 超期行断言 badge 出现;正常行断言无 | 生效 |
| AC-EL-LOG-015 | Tracking 表·列 路线 | 表格列 | 「from → to · city」 | from_country/to_country/city 三字段拼接 | 抽行比对 | 生效 |
| AC-EL-LOG-016 | Tracking 表·列 重量kg | 表格列 | 右对齐 toFixed(1) | weight float8;null 显「—」 | 无重票断言「—」 | 生效 |
| AC-EL-LOG-017 | Tracking 表·列 发货日 | 表格列 | muted 日期文本 | ship_date 字符串直显(YYYY-MM-DD) | 抽行比对 | 生效 |
| AC-EL-LOG-018 | Tracking 表·列 状态 | 表格列/badge | 状态徽章(同 009 配色) | BADGE_CLS 回退 dim;文案 badge_label 空则回退 badge | 同 009 | 生效 |
| AC-EL-LOG-019 | Tracking 表·列 载货 | 表格列 | ellipsis 单行截断 maxWidth 220px | products 空则回退 remark 再空显「—」;title=remark 悬停看全 | 长品名断言截断样式与 title | 生效 |
| AC-EL-LOG-020 | Tracking 表·列 最新轨迹 | 表格列 | event 文本 + 时间 | latest_event + latest_event_time(T 换空格、截前 16 字符) | 抽行断言格式 | 生效 |
| AC-EL-LOG-021 | Tracking 表·空态 | 空态 | 「无匹配船票」 | items 空时整行替换 colSpan=8(含筛选/搜索无命中) | 无命中搜索断言文案 | 生效 |
| AC-EL-LOG-022 | Tracking 表·分页器 | 分页 | 「共 {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 报价/📚 参考附录 Reference | tab 值同步 URL(002);五 tab 分别对应下列 030-050 组 | e2e 逐 tab 断言渲染容器 | 生效 |
| AC-EL-LOG-030 | Create·地址 select | 输入 | 空选项=默认地址;选项「{label 空取 id} · {country} {cityName}」 | 地址簿来自 params.addresses(默认地址 is_default=true);提交时 address_id 传后端(见 035 合并顺序) | e2e 切地址下单 dry-run 断言返回 address 变化 | 生效 |
| AC-EL-LOG-031 | Create·产品 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-032 | Create·数量 | 输入 | number input min=1 默认 100 | qty≤0 后端 400「Quantity must be > 0」;非法串归 0 同 400 | submit qty=0 断言 400 | 生效 |
| AC-EL-LOG-033 | Create·虚线预览卡 | 反馈 | 「{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-034 | Create·🔍 校验 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-035 | Create·🚀 真实下单 | 按钮/接口 | 两步创建双清运单;成功「✓ 下单成功: 订单号 {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-036 | Create·警示文案 | 文案 | 「真实下单会调 Vnlin OMS 外部 API 创建运单, 谨慎点击」(page.tsx:332,半角逗号+空格) | 常驻 muted 提示;下单按钮在 busy 或未选产品时禁用 | 文案逐字 diff;未选产品断言按钮禁用 | 生效 |
| AC-EL-LOG-037 | Parameters·读接口 | 接口 | GET /api/logistics/params | logistics.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-038 | Parameters·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 合并结果;保存走 042 | e2e 断言各字段初值=默认参数 | 生效 |
| AC-EL-LOG-039 | Parameters·地址簿卡 | 输入组 | label(maxWidth 200)/默认地址 checkbox(互斥)/删除按钮 + country·cityName·destCode·area·contact·mobile·address 七输入 | 地址簿=params.addresses 列表;默认地址唯一(勾选互斥逻辑在前端 state) | 勾 B 默认断言 A 失去默认 | 生效 |
| AC-EL-LOG-040 | Parameters·➕ 新增地址 | 按钮 | 追加空白地址卡 | id="addr_"+Date.now() 前缀防撞;country 默认 SA;shortAddressTypes=NSA | 点击断言新卡出现且九输入可填 | 生效 |
| AC-EL-LOG-041 | Parameters·Remark textarea | 输入 | 备注多行文本 | remark 字段随参数保存,下单时进 Vnlin order_body.remark | 存 remark 后 dry-run 响应/后台参数含该值 | 生效 |
| AC-EL-LOG-042 | Parameters·💾 保存参数 | 按钮/接口 | 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-043 | Pricing·报价接口 | 接口 | GET /api/logistics/pricing | logistics.py:298-304:静态读 api/data/yamwen_pricing.json(106 渠道 8 分类,公司级共享只读、不分企业);文件缺失 404「pricing data not found」 | 接口断言渠道分组数;删文件场景(测试环境)断言 404 | 生效 |
| AC-EL-LOG-044 | Pricing·🧮 运费计算器 | 计算器 | 副标题「体积重 = 长×宽×高 ÷ 泡比 · 计费重 = 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-045 | Pricing·报价表 A 模式列 | 表格列 | 4 列:重量段 Weight(kg)/公斤运费 ¥/kg/处理费 ¥/件/最小计费 Min(kg) | 列集随渠道计费模式切换(A/B 二选一渲染,page.tsx:639) | A 渠道断言恰 4 列表头 | 生效 |
| AC-EL-LOG-046 | Pricing·报价表 B 模式列 | 表格列 | 7 列:重量段 Weight(kg)/首重(kg)/首重价 ¥/续重(kg)/续重价 ¥/处理费 ¥/干线费 ¥/kg | 同 045 条件渲染;续重进位公式见 044 | B 渠道断言恰 7 列表头 | 生效 |
| AC-EL-LOG-047 | Pricing·分组/空态/脚注 | 表格配件 | 🌍 大洲·国家(code) 分组头行;空态「无匹配报价行」;脚注「共 {n} 行报价 · {m} 国家」;<details> 展开「价格说明 Notes ({n})」 | 分组按报价单结构渲染;Notes 折叠块默认收起 | 过滤无命中国家断言空态;脚注计数 SQL/JSON 对拍 | 生效 |
| AC-EL-LOG-048 | Reference·附录接口 | 接口 | 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 凭据未配 503 | ds=bad-name! 断言 400;ds=state_city&q=Riyadh 断言命中;空 ds 断言 12 节 meta | 生效 |
| AC-EL-LOG-049 | Reference·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-050 | Reference·搜索防抖与空态 | 交互 | 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 | 生效 |
| 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-009 | SKU 下拉 | 下拉 | 占位「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.countries | mks=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「关键词(逗号分隔, 标题用)」,宽度 240 | nu.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,.csv | POST /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-020 | AI 抽取兜底(规格书) | 口径 | 规则命中 <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+1 | gen_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=200 | page.tsx:554-558;TITLE_MAX=200(listing.py:136) | 计数=n/200 实时;粘贴超长截断 | 生效 |
| AC-EL-LST-025 | 流程③·五点编辑 | 输入组 | label「五点描述(≥3 条)」;5 行编号输入 maxLength=500 | page.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;「关键词」input | page.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→下拉(空选项+枚举/选项),否则文本 input | page.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 时 disabled | batch("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-040 | generate_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:703 | imported 任务断言徽标与 ASIN | 生效 |
| AC-EL-LST-044 | 任务详情头卡 | 卡头 | 「{brand} · {sku}」+ 灰字「{platform} · {market} · {category} · v{version}」+ 状态 badge | openTask 经「编辑内容 →」触发(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=5000 | page.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 均 disabled | doSubmit→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-059 | ASIN 行与提交结果 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-060 | Amazon 推送结果与 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-063 | Noon 预检 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 PASS | dry 响应键集断言无 csv_preview(已删分支,编译产物零残留) | 生效 |
| AC-EL-LST-064 | NSKU 行(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/input | page.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.brands | page.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-082 | SKU 明细/收起按钮与行展开 | 交互 | 分组行点击或按钮切换展开;展开行背景 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 ∪ exported | readyTasks.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 截 500 | done/成功 两值行断言仍 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、其余 ok | listing.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 天销量,无数据=nodata | listing.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-108 | NoonListingTab 承载 | 组件挂载 | 页级 noon 三 tab(LST-002 后三键)渲染 NoonListingTab,sub=tab 去前缀,setSub 回写页级 tab | page.tsx:1029-1032;NoonListingTab.tsx:39-42;受控挂载(原常驻底部自带第二套 tab 栏已并轨,page.tsx:1029 注释) | 三 tab 切换页级高亮同步 | 生效 |
| AC-EL-LST-109 | noon 内层 sub-tab 条 | 页签 | 三键:「📋 SKU 清单」「🚀 建品向导」「🗂 任务与 QC」 | NoonListingTab.tsx:65-69 | 三键顺序逐字 | 生效 |
| AC-EL-LST-110 | noon 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-111 | noon 清单表 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-CMP | 8 列表头与渲染规则逐项;CSV 导出文件名 noon_listings | 生效 |
| AC-EL-LST-112 | noon 清单口径注 | 口径行 | 表脚 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-122 | noon 任务保存端点 | 口径 | 保存=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 全量 payload | NoonListingTab.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.qc | QC 后任务状态仍 imported;submit_result.qc 更新 | 生效 |
| AC-EL-LST-126 | QC 语言卡内容 | 展示 | 每语言卡:{语言}+状态 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-127 | QC 图片审核块 | 展示 | 「图片审核 ({N})」前 6 张:review_status badge(VALID ok/INVALID bad/其余 warn,去前缀)+URL 省略灰字 | NoonListingTab.tsx:496-508 | 超 6 图仅显前 6 | 生效 |
| AC-EL-LST-128 | QC 失败呈现 | 错误态 | HTTP 非 200=红 pre「查询失败 HTTP {n}: {raw 截 200}」 | NoonListingTab.tsx:510-514 | mock 非 200 断言格式 | 生效 |
| AC-EL-LST-129 | 向导编辑深链 | 路由 | ?edit={id} 打开即载入该 noon 任务回填全部字段+submit_result/qc,并按其类目拉属性表单 | NoonListingTab.tsx:151-170;配合 LST-003 初始 tab | 带参访问断言回填与 tab 落位 | 生效 |
| AC-EL-LST-130 | noon 任务与 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-131 | noon 任务表列 | 表 | 7 列:# 灰 / SKU(文本筛选)/ 品牌 / 标题(截 40 悬停全文,空 —)/ 状态 badge(单源 LST-045,文本筛选)/ 更新(截 16)/ 操作 | NoonListingTab.tsx:559-576 | 列序与渲染逐项 | 生效 |
| AC-EL-LST-132 | noon 任务行操作 | 按钮组 | 「编辑」=写 ?edit= 后整页 reload 进向导;「预检」=dry toast(缺 N 项: 清单 或 预检通过 ✓);「提交」仅 ready 显示,confirm「真实提交任务 #{id} 到 noon 建品?」;「QC」仅 imported 显示,toast 逐语言「{lang}:{状态}({完整度})」或「无状态」 | NoonListingTab.tsx:532-557,568-575 | 四按钮状态门各断言 | 生效 |
| AC-EL-LST-133 | A+ tab 条 | 页签 | 三键:「📄 A+ 创建」「🖼️ 媒体库」「📋 文档 & 历史」 | AplusTab.tsx:85-89 | 三键顺序逐字 | 生效 |
| AC-EL-LST-134 | A+ ①·基本信息卡 | 卡 | h2「① 基本信息」sub「ASIN 多个逗号分隔 · 站点多选」;「文档名称(后台识别用)」(placeholder「如 T11 A+ 2026-09」)与「ASIN(多个逗号分隔)」两输入 | AplusTab.tsx:93-101;保存前必填校验:名称空 toast「文档名称必填」、ASIN 空「至少一个 ASIN」(66-68) | 两必填 toast 各断言 | 生效 |
| AC-EL-LST-135 | A+ ①·站点多选 toggle | 按钮组 | 站点 pill 点击切换选中(on 态);来源 /api/aplus/meta markets | AplusTab.tsx:103-111,51;GET /api/aplus/meta(aplus.py:14) | 点击切换与 markets 集一致 | 生效 |
| AC-EL-LST-136 | A+ ①·语言缺失警告 | 提示 | 选了站点且媒体库全为 none 语言时黄字「⚠ 媒体库暂无非英文图 → 将用英文图打底(UVPVP 同语义警告)」 | AplusTab.tsx:56-58,113-117;判定=所选站点 locale 无对应语言图(UVPVP 同语义) | 媒体库仅 none 语言断言警告出现 | 生效 |
| AC-EL-LST-137 | A+ ②·模板布局 | 单选 | 三 radio pill:「经典版(推荐)」「简洁版」「自定义」+ 说明「经典版=Header大图+3图文+4宫格+对比表 · 简洁版=无对比表 · 自定义=按需填模块」 | AplusTab.tsx:120-134;TEMPLATES:classic=header+three+quad+compare / simple=无 compare / custom=全四模块(28-32) | 选简洁版断言 compare 模块不渲染 | 生效 |
| AC-EL-LST-138 | A+ ③·模块内容与图片槽 | 表单 | 按模板渲染模块:① 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-139 | A+ ④·保存卡 | 按钮 | 「💾 保存草稿」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-140 | A+ ④·提交审核(禁用) | 按钮 | 「🚀 提交审核(未接凭证)」恒 disabled,title「SP-API 凭证未接入(需求单)」 | AplusTab.tsx:179;本期闭环=草稿+媒体库+登记+历史(AplusTab.tsx:3-4 注释) | 按钮恒禁用;无网络请求 | 未上线保留 |
| AC-EL-LST-141 | A+ 媒体库·登记卡 | 表单 | 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-142 | A+ 媒体库·已登记表 | 表 | h2「已登记图片({N})」;5 列:媒体引用(省略)/语言 chip/标签(空 —)/登记时间/「删」按钮(confirm「删除媒体登记」) | AplusTab.tsx:239-258,214-218;DELETE /api/aplus/media/{id}(aplus.py:61);空态 EmptyState「暂无登记」提示「上方登记第一条媒体引用」 | 删除后行消失并 toast | 生效 |
| AC-EL-LST-143 | A+ 文档表 | 表 | 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-144 | A+ 操作历史表 | 表 | 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=6 | FilesTab.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-151 | PT 元数据端点(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_admin | listing.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/qc | audit 调用 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 走查无第三处挂载点 | 生效 |
| 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",展示最近一次接口异常 message | page.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-CMP | e2e 切品牌断言 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-007 | KPI①快照日期 | 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-008 | KPI②在榜产品(截断披露) | 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 卡该市场 products | curl /api/rankings 断言 total>items.length 时 foot 出现「筛选后共」字样 | 生效 |
| AC-EL-RANK-009 | KPI③平均评分/总评论 | KPI | 值=平均评分(两位小数),foot=「N 条评论」 | page.tsx:472-476、551-555;客户端口径=当前 60 行内 rating 非空行均值 toFixed(2)(无评分行不计分母),总评论=Σreview_count;边界=仅统计展示行,非全市场口径 | 取 /api/rankings items 手工复算均值与页面相等 | 生效 |
| AC-EL-RANK-010 | KPI④当前品牌 | 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,各只列本平台市场 chip | page.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-015 | amazon 市场白名单 | 口径 | 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-039 | curl 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-019 | Amazon 表头 10 列 | 表格 | #/产品/品牌/BSR 大类/小类/评分/评论/卖家评分/90 天变化/区间 | page.tsx:616-620;列集为 amazon 平台专属,noon 切 8 列(见 RANK-020) | e2e 断言 thead 列名与列数 | 生效 |
| AC-EL-RANK-020 | Noon 表头 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 CTE | e2e 断言有类目名的行后缀存在且以「 · 」分隔 | 生效 |
| 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 int | SQL 抽行比对三值与页面渲染一致 | 生效 |
| 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) 至少 1 | SQL 复算窗口计数比对 | 生效 |
| 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 长度≥5 | SQL 抽有 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 60 | dashboard.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-042 | UK→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_reviews | curl 端点断言八键齐全 | 生效 |
| AC-EL-RANK-045 | ⭐KPI①快照日期 | KPI | as_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=9 | SQL 复算某品牌 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 商品评论」,默认 noon | page.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&brand | page.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-271 | e2e 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 秒)」并 disabled | page.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/n | code 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) | 跨企业账号访问断言只见本企业品牌数据 | 生效 |
| 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-004 | flat·搜索框 | 筛选 | 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-005 | flat·排序 select | 筛选 | SORTS 五项:按营收/按销量/按售价/按毛利率/按 SKU | ops.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-006 | flat·国家筛选 | 筛选 | 「全部国家」+ 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-007 | flat·数据接口 | 接口 | GET /api/products?search&sort&country&brand&page&page_size | ops.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-008 | flat·列 产品名/型号 | 表格列 | 两行: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-009 | flat·列 品牌 | 表格列 | branddot 色点 + 品牌名 | brandColor(brand) 跨页一致(AC-UI-07);可排序 | 同品牌多页断言同色 | 生效 |
| AC-EL-PRD-010 | flat·列 渠道 SKU | 表格列 | 等宽 sku 样式 | p.sku 直显;可排序;rowKey=brand+sku | 抽行比对 | 生效 |
| AC-EL-PRD-011 | flat·列 ASIN / NSKU | 表格列 | 「{asin} / {nsku}」muted;空 asin 显「—」 | asin/nsku 来自 sku_mapping;CSV 两值斜杠拼接 | 抽行比对映射表 | 生效 |
| AC-EL-PRD-012 | flat·列 类目 | 表格列 | muted 文本 | category→platform→「—」三级回退;排序键同回退链 | 无类目行断言显 platform 或 — | 生效 |
| AC-EL-PRD-013 | flat·列 售价 USD | 表格列 | 右对齐 usd 2 位 | p.price::float8;null 由 fmt 层显「—」;排序 null 计 −1 | 无价行断言 — | 生效 |
| AC-EL-PRD-014 | flat·列 成本 RMB | 表格列 | 右对齐整数 | p.cost:truthy 显 int(cost) 否则「—」;成本口径=sku_mapping.cost_rmb(映射优先,采购表回退,见 021 caliber) | 缺成本 SKU 断言 —(与 3 SKU 缺成本主数据挂账联动) | 生效 |
| AC-EL-PRD-015 | flat·列 30 天销量 | 表格列 | 右对齐整数 | units30=COALESCE(a.u30,0)(agg CTE,007) | SQL 同窗复算 | 生效 |
| AC-EL-PRD-016 | flat·列 30 天营收 | 表格列 | strong usd 2 位 | revenue30=COALESCE(a.rev30,0);金额=USD(caliber) | SQL 同窗复算 | 生效 |
| AC-EL-PRD-017 | flat·列 30 天广告费 | 表格列 | 右对齐 usd 2 位 | ad_spend30=COALESCE(a.sp30,0)(sales_daily 同源广告聚合) | SQL 同窗复算 | 生效 |
| AC-EL-PRD-018 | flat·列 估算毛利率 * | 表格列 | 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-019 | flat·列 💰 调价建议 | 表格列 | 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-020 | flat·DataTable 契约 | 组件复用 | 表格容器/CSV/分页/口径行 | 复用 AC-EL-CMP-014(通用表)/016(导出 CSV)/017(分页)/018(caliber)/019(加载空态);本页仅传参:exportCsv="products"、empty=「无匹配商品」、pager pageSize=25、loading=!data&&!err | 断言空态文案与导出文件名 | 生效 |
| AC-EL-PRD-021 | flat·caliber 口径行 | 口径 | 「产品表口径:金额=USD|数据源=产品主表(sku_mapping/products)|30 天聚合(销量/营收/广告)|成本=sku_mapping.cost_rmb(映射优先,采购表回退)。」 | UI 文案即验收标准(AC-UI-01),逐字受保护;与 007-017 各列实现一一对应 | 页面文案与库内记录逐字 diff | 生效 |
| AC-EL-PRD-022 | flat·底部脚注 | 口径 | 三行:①「* 官方口径估算:(售价 − 采购成本×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-023 | drill·粒度 tabs | 筛选 | 周(默认)/月/日 | gran 白名单 day/week/month,非法值后端回落 week(brandboard.py:485-486) | gran=year 直调断言响应 gran=week | 生效 |
| AC-EL-PRD-024 | drill·窗口 tabs | 筛选 | 30/90/180/365 天(默认 90) | days 服务端 clamp [1,3650](brandboard.py:487) | days=9999 直调断言响应 days=3650 | 生效 |
| AC-EL-PRD-025 | drill·计数条 | 反馈 | 「{rows} SKU · 共 {total_units} 件」/「加载中…」 | rows=接口明细行数;total_units=round(sum(r.total))(brandboard.py:532-533) | 与接口响应两值对拍 | 生效 |
| AC-EL-PRD-026 | drill·Expand/Collapse | 按钮 | 全展开/全收起 | allOpen 布尔覆盖单节点 open 记录;Collapse 同时清空 open 表 | Expand 后断言全部叶行可见 | 生效 |
| AC-EL-PRD-027 | drill·⬇ CSV | 按钮 | 导出 zf_product_drill_YYYYMMDD.csv | BOM 头 Excel 直开;列=系列/产品/国家/颜色/尺码/SKU+全桶列(不截断,区别于展示 26 桶)+TOTAL;esc 处理引号/逗号/换行 | 断言文件名日期、表头全桶数=buckets.length | 生效 |
| AC-EL-PRD-028 | drill·数据接口 | 接口 | GET /api/brandboard/product-drill?brand&days&gran | brandboard.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-029 | drill·件数均摊口径 | 口径 | 每订单 items_count 按 SKU 数均摊 | sku_list 逗号拆分 n 份,每份 +(ic or 1)/n(items 级粒度未 ingest 的近似口径,脚注原文);桶值/total 均 round 取整 | 两 SKU 单各记 0.5 再 round 对拍手算 | 生效 |
| AC-EL-PRD-030 | drill·bucket 格式 | 口径 | 桶标签三种粒度 | 月=YYYY-MM、周=ISO 年-Www(周数补零,brandboard.py:503-509 bucket())、日=MM-DD;桶全集升序 | 跨年周断言 ISO 年正确 | 生效 |
| AC-EL-PRD-031 | drill·五级树构建 | 逻辑 | Series→Product→Country→Color→Size 层级树 | buildTree(page.tsx:14-40):叶=bucket 求和+total;rollup 自底向上累加、同级按 total 降序 | 单测:给定行集断言父级=子级和且排序 | 生效 |
| AC-EL-PRD-032 | drill·26 桶展示截断 | 边界 | 表体只显示最近 26 个桶 | buckets.slice(-26) + off 偏移取值(page.tsx:60-61);防横向爆炸;CSV 导出不受限(027) | 365 天日粒度断言列数=26 | 生效 |
| AC-EL-PRD-033 | drill·表头 | 表格列 | 「Series → Product → Country → Color → Size」+桶列+TOTAL+AVG+📦Stock | 首列表头为层级链说明文字;桶列右对齐 | 表头文案断言 | 生效 |
| AC-EL-PRD-034 | drill·行渲染 | 表格列 | 缩进=8+depth×16 px;▾/▸ 折叠钮;depth0 背景加深;叶行附 SKU muted 小字 | 无子级行 26px 占位符对齐;名称加粗 depth0=700 其余 500 | 视觉断言缩进梯度与折叠交互 | 生效 |
| AC-EL-PRD-035 | drill·AVG 列 | 表格列 | 桶均销量 toFixed(1);0 显「·」 | avg=total/max(1, 非零桶数)(分母只计值>0 的桶,page.tsx:70) | 单桶有值行 avg=total 对拍 | 生效 |
| AC-EL-PRD-036 | drill·📦Stock 列 | 表格列 | 叶行库存数;无映射/非叶显「—」 | stock[leaf.sku]=cleaned_inventory_health.total_qty(FBA 快照口径,与 037 脚注一致) | 抽 SKU 与库存页总库存对拍 | 生效 |
| AC-EL-PRD-037 | drill·TOTAL 行 | 表格列 | 表底根合计行(背景加深 700 加粗) | 各桶列=根节点子树合计;TOTAL=全部 total 和;AVG/Stock 显「—」(跨 SKU 加总无意义) | 断言 TOTAL 行各桶=列求和 | 生效 |
| AC-EL-PRD-038 | drill·空态 | 空态 | 「无数据」/「加载中…」 | data 有值且树空=无数据;data=null=加载中;colSpan=buckets.length+4 | 空品牌断言「无数据」 | 生效 |
| AC-EL-PRD-039 | drill·脚注 | 口径 | 「件数按订单内 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 计数随之切换且无跨企业行 | 生效 |
| 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-003 | Noon tab 可见性探测 | 守卫 | 品牌无 Noon 数据时隐藏 Noon tab 并回落 fba | brand 非空时 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-004 | FBA·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-005 | FBA·体检卡空态 | KPI 卡 | 「暂无数据」(拉取中=「正在拉取最新数据…」) | hs 空时渲染 fallback 不裸空白(AmazonCabin.tsx:320;R4b P4 对齐:2026-10-28 供应链舱重构,旧 KPI 瓦片空卡并入库存体检卡,原「库存数据 — 当前品牌暂无 FBA 库存快照」文案随重构退役) | 无快照品牌断言该卡 | 生效 |
| AC-EL-INV-006 | FBA·合计可售/在途卡 | KPI 卡 | totalGood 大数 + foot「在途 N 件」 | totalGood/totalInbound=by_status 求和(前端 reduce,page.tsx:149-150) | 断言=by_status good/inbound 列总和 | 生效 |
| AC-EL-INV-007 | FBA·国家筛选与结构面 | 筛选 | 明细卡国家筛选=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-008 | FBA·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-009 | FBA·库存明细接口 | 接口 | GET /api/inventory/health?status&search&brand&country&page&page_size | inventory_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-010 | FBA·状态筛选 | 筛选 | 全部状态/断货/无销售/正常/充足/低库存 六枚 | STATUS_FILTERS 常量(2026-09-17 修:KPI 有 5 态而筛选原缺低库存);status→stock_status 精确等值;「低库存」不在列头 BADGE 映射内→badge 回退 dim;点选重置第 1 页 | 选断货断言全行断货;低库存筛选按 DB 实值验收 | 生效 |
| AC-EL-INV-011 | FBA·国家下拉 | 筛选 | 「全部国家」+ 各国({count}) | 与国家 tab 同 state 同步(双向一致);选项文案 EU·共享;change 重置第 1 页 | tab 与下拉互切断言同步 | 生效 |
| AC-EL-INV-012 | FBA·搜索框 | 筛选 | placeholder「搜索 产品名 / 型号 / SKU / ASIN」+ 搜索按钮 | submit 才 setQuery 回第 1 页;四字段 ILIKE 同 009 | 搜 ASIN 断言命中 | 生效 |
| AC-EL-INV-013 | FBA·⬇ 导出 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-014 | FBA·明细表 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-015 | FBA·70vh 限高滚动容器 | 边界 | 明细表容器 maxHeight 70vh 滚动 | 2026-10-01 像素审计 P3 缺陷㊲:首拉 10000 行在 fittingirls 8500 SKU 把页面撑到 62 万 px——限高兜底(mapping 页同模式);服务端分页方案列 P4 待拍板 | fg 全量加载断言页高正常、容器内滚动 | 生效 |
| AC-EL-INV-016 | FBA·明细空态 | 空态 | 「无匹配库存」 | data 加载且 items=0(含筛选无命中)时渲染;loading 期不显 | 无命中搜索断言文案 | 生效 |
| AC-EL-INV-017 | FBA·明细 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})」;默认 urgent | LEVEL_LABEL 映射(urgent 紧急/watch 观察/nosale 无动销/ok 健康);count=summary[l].count 无数据显示「—」;page_size=15(无分页器仅取首页) | 切级断言表行 level 全一致 | 生效 |
| AC-EL-INV-020 | 预警·接口与分桶 | 接口 | GET /api/inventory/alert?level&search&brand&country | inventory_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 LAST | SQL 按 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-028 | CustomModules 挂载位 | 组件 | 页底 CustomModules page="inventory" | 企业自定义模块位(AC-EL-CMP 域);随企业配置渲染 | 配置模块企业断言出现 | 生效 |
| AC-EL-INV-029 | DocsTab·子 tab×5 | 导航 | 单据(默认)/库存余额/流水/📈 报表/基础资料;docs sub 显「+ 新建单据」、stock sub 显「📋 盘点录入」 | sub 本地 state;数据按需懒加载(stock/base 首开加载、ledger 每开刷新);台账引擎在 api/routers/inv.py(DocsTab.tsx:2-3 文件头注释:移动加权平均/单事务/红冲按台账净额反向) | e2e 逐 sub 断言容器与按钮 | 生效 |
| AC-EL-INV-030 | DocsTab·单据筛选双下拉 | 筛选 | 「全部类型」+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-031 | DocsTab·单据表 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-032 | DocsTab·操作列 | 操作 | 详情(恒显)+ 过账(仅 draft)+ 红冲(仅 approved,danger 色) | 详情=openDetail GET /api/inv/docs/{id}(inv.py:126);过账/红冲见 033/034;操作后刷新列表并置空余额缓存 | approved 行断言无过账钮;draft 行断言无红冲钮 | 生效 |
| AC-EL-INV-033 | DocsTab·过账确认 | 操作 | confirm「过账 {doc_no}?」正文「过账后写入台账并计算移动平均成本;已过账单据只能红冲。」 | POST /api/inv/docs/{id}/approve(inv.py:182);成功 toast「{doc_no} 已过账」 | e2e(测试企业)过账草稿断言状态翻已过账+余额变动 | 生效 |
| AC-EL-INV-034 | DocsTab·红冲确认 | 操作 | confirm「红冲 {doc_no}?」正文「按台账净额反向冲回;草稿直接取消。操作会留审计记录。」 | POST /api/inv/docs/{id}/cancel(inv.py:235);danger 色确认钮;成功 toast「{doc_no} 已红冲」 | 过账→红冲断言余额回到过账前(净额反向) | 生效 |
| AC-EL-INV-035 | DocsTab·单据空态 | 空态 | EmptyState「暂无单据」hint「点右上「新建单据」录入入库/出库/调拨;PO 收货会自动生成入库单。」 | PO 收货自动 GRN 联动(inventory_po.py:429-439 auto_grn_for_po_receive) | 新企业断言空态文案 | 生效 |
| AC-EL-INV-036 | DocsTab·单据 caliber | 口径 | 「库存单据表口径:数量=件|数据源=台账单据(入库/出库/调拨,手工录入+PO 收货自动生成入库单)|状态=草稿/已过账/已作废。」 | 逐字受保护(AC-UI-01) | 逐字 diff | 生效 |
| AC-EL-INV-037 | DocsTab·详情抽屉 | 抽屉 | 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-048 | NoonTab·子 tab×5 | 导航 | 📊 库存总览(默认)/📋 FBN 明细/🏭 直发仓/📦 ASN 入库/⚙️ 库存管理 | 平台隔离:本 tab 只在品牌含 noon 时显示(页面级 003 控制,NoonTab.tsx:2-3 注释);2026-10-04 增强版(预警+明细+仓库+设库存) | e2e 逐 sub 断言容器 | 生效 |
| AC-EL-INV-049 | NoonTab·数据源 | 接口 | 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-050 | Noon·总览表 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-051 | Noon·总览 caliber/导出/空态 | 口径 | 「数据源=noon-catalog offer/list API · gmv/units=当前累计 · BuyBox=是否赢得购物车 · FBN 库存=FBN 仓净库存。」;exportCsv="noon_fbn_overview";空态「无数据」/「加载中…」 | 逐字受保护;gmv/units=当前累计(非滚动窗)口径声明 | 文案 diff;导出文件名断言 | 生效 |
| AC-EL-INV-052 | Noon·FBN 明细表 10 列 | 表格列 | SKU·长(cm)·宽(cm)·高(cm)·重(kg)·分类·出库费·FBN 库存·库存状态·首次入库 | 尺寸/重量/分类/出库费取 fees 行(feeMap),无费率行显「—」;库存状态 condition=SALEABLE「可售」ok/UNSALEABLE「不可售」bad/其余「—」;首次入库 muted 12px | 有费率 SKU 断言尺寸四列数值 | 生效 |
| AC-EL-INV-053 | Noon·直发仓清单 | 表格列 | 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-054 | Noon·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-055 | Noon·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-056 | Noon·库存管理(设库存) | 表单/操作 | 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-058 | Amazon 舱 · 紧急/观察 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 阈值线一致 | 生效 |
| 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-003 | Tab 组(单 tab) | 导航 | 仅一枚「SKU 映射」tab | page.tsx:51-53;2026-09-20 起 SKU 映射+新品建档合并为一个 tab,editMode 切换只读/编辑两形态(page.tsx:25-26);tab 本身不可切换 | e2e 断言 tab 唯一且无第二 tab | 生效 |
| AC-EL-MAP-004 | KPI·平台卡(每平台一枚) | 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-005 | KPI·映射总行 | 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」三 tab | page.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-92 | e2e 断言列名与列数 | 生效 |
| 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:103 | e2e 断 Amazon 行绿徽 Noon 行灰徽 | 生效 |
| AC-EL-MAP-015 | 列·国家/ASIN/NSKU/UPC | 表格 | 灰字等宽,空值均显「—」 | page.tsx:104-107 | e2e 断空值占位符 | 生效 |
| 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:109 | e2e 断列不存在(下线后) | 下线 |
| AC-EL-MAP-018 | 只读排序 | 口径 | 固定排序:platform, country, sku | collab.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-87 | e2e 断过渡文案 | 生效 |
| 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;加行即 dirty | e2e 点加行断言首行出现预填行 | 生效 |
| 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-288 | e2e 任一编辑动作后断言徽标出现 | 生效 |
| AC-EL-MAP-030 | 💾保存到数据库 | 按钮 | 「💾 保存到数据库」(busy 显「保存中…」);未 dirty 或 busy 时 disabled | page.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}.csv | page.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=xls | e2e 下载断言文件头含 <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,.csv | page.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:219 | e2e 导入只有表头的文件断言提示 | 生效 |
| 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_name | ops.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-053 | Keepa 官方 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 盯防挂账 | 生效 |
| 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-002 | Suspense 加载壳 | 反馈 | 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/list | e2e 断言卡片标题文本 | 生效 |
| 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 未在页签展示仅 count | SQL 直查各状态 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-037 | e2e 点击断言抽屉出现 | 生效 |
| 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 items | e2e 断言表头 9 列文本与顺序 | 生效 |
| AC-EL-PO-015 | PO 号列 | 列 | 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.id | e2e 断言表头 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;导入后清空勾选并 setInfo | e2e 无勾选断言 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) | 新行默认数量 1 | e2e 连点两次断言两行 qty=1 | 生效 |
| AC-EL-PO-051 | 取消/保存草稿按钮 | 操作 | 底部 toolbar 右对齐:取消关抽屉 / 保存草稿提交(page.tsx:321-324) | 取消不落库不确认;保存走 createPO | e2e 取消后刷新断言无新 PO | 生效 |
| AC-EL-PO-052 | 保存草稿客户端校验 | 校验 | 有效行=brand+sku 非空且 qty>0,至少一行否则报「至少一行有效的品牌+SKU+数量」(page.tsx:111-112) | 无效行静默剔除后提交(items2) | 全空行保存断言错误横幅 | 生效 |
| AC-EL-PO-053 | create 服务端口径 | 写操作 | 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-055 | prefill 深链 | 交互 | /po?prefill=<sku> 自动开建单并预填该 SKU(page.tsx:74-88) | 查 /api/products?search=<sku>&page_size=5,取 sku 全等匹配(大小写不敏感)否则取首项;已在物料行则不重复加;qty=1 | e2e 带合法 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} 返回单头+items | e2e 断言标题两段拼接 | 生效 |
| 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}/status | e2e 点流转断言确认框文案 | 生效 |
| 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-070 | mail 结果三分支反馈 | 反馈 | sent→「邮件已发送」;skipped→「未发送:{reason}」;failed→「发送失败:{reason}」(page.tsx:138-139) | 响应字段 mail_status+reason;发送后刷新列表并在详情开着时重开详情 | 三场景各断言横幅文案 | 生效 |
| AC-EL-PO-071 | send_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-072 | PDF 端点 | 文件 | 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-075 | receive 服务端口径 | 写操作 | 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 两路径各断言文案 | 生效 |
| 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) | 产品列表/详情拉取失败 setErr | e2e 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-019 | vis 过滤口径 | 口径 | 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-050 | toast | 反馈 | 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-056 | history 服务端口径 | 口径 | 日期变化即 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 附「(级联删任务)」;删除后回产品列表自动选首项;护栏=确认弹窗+级联范围明示(不可误删铁律:删除范围对用户可见) | 删含任务产品断言任务全清 | 生效 |
| 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-005 | work 页签组 | 导航 | 「项目·任务·资源」页签内二级 6 页签:渠道库/采集监控/✅任务/📣KOL/🚀推广项目/🌐全部资源;默认渠道库(page.tsx:53,152-159) | 二级状态独立于顶级 tab;KPI 区恒显示于二级页签上方 | e2e 断言 6 页签与默认选中 | 生效 |
| AC-EL-OFF-006 | KPI·渠道总数 | KPI 卡 | 数值+foot「去重后(同名合并)」(page.tsx:122-127) | 源 /api/promotion/summary kpi.total=count(*)(ads.py:370-373);同名去重发生在入库层非查询层 | SQL count(*) 与卡片数字对账 | 生效 |
| AC-EL-OFF-007 | KPI·含联系方式 | KPI 卡 | 数值+foot「N% 可直接触达」(page.tsx:128-132) | with_contact=count(contact);百分比=round(with_contact/total×100),total=0 时 0% | 对账 contact 非空占比 | 生效 |
| AC-EL-OFF-008 | KPI·待联系/待投稿 | KPI 卡 | 双数值斜杠分隔+foot「养号中 N」(page.tsx:133-139) | by_status 数组按 status 字符串查找;status 为空者服务端归「未标注」不参与这三项 | 对账 by_status 各态计数 | 生效 |
| AC-EL-OFF-009 | KPI·近 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-010 | KPI·数据截至 | 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) | 列序固定;行键=name | e2e 断言 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-028 | fits 口径(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-044 | e2e 点投稿断言弹窗标题 | 生效 |
| 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-033 | channels 服务端搜索口径 | 口径 | 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-044 | submission 服务端口径 | 写操作 | 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-045 | orders 服务端口径 | 写操作 | INSERT promotion_orders,status 默认 pending,含 requested_by(ads.py:2293-2302) | 审计 promo.order.create;金额原币存储不折算(currency 字段区分) | 提交申请断言 status=pending | 生效 |
| AC-EL-OFF-046 | orders 审批护栏 | 护栏 | 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-059 | tasks 端点族 | 口径 | 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-061 | KOL 外联状态护栏 | 护栏 | 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.outreach | kind=channel 调用断言 400 非 500 | 生效 |
| AC-EL-OFF-062 | KOL 库口径 | 口径 | GET /api/promotion/kol(ads.py:2342+) | kind 三源:渠道 1000/测评站 315/高优 65(docstring 口径);limit clamp [1,200] 默认 50 | 三 kind 各拉一页对账量级 | 生效 |
| AC-EL-OFF-063 | submissions/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 | 生效 |
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-001 | SFR月度趋势 | 折线 | 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-002 | SFR月度变化量/变化率 | 折线 | 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-004 | ABA月份完整度/缺月图 | 柱图 | 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-005 | Top1/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-006 | Top1/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-007 | Top3与榜外点击份额堆叠图 | 堆叠 | 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-008 | Top3与榜外成交份额堆叠图 | 堆叠 | 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-013 | ASIN×月份×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-014 | Top1占位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-017 | ASIN上榜月数分布 | 柱图 | 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-001 | BuyBox 价格分布 | 柱图 | 价格维度组图卡 | buy_box 分桶 0/10/20/30/50/80/120/200,币种轴;构建器 ExploreCharts.tsx:132 | 读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:132;图题逐字比对 | 生效 |
| AC-EL-SRC-EC-002 | Amazon 自营价分布 | 柱图 | 价格维度组图卡 | price_amazon 同 8 档桶,币种轴;构建器 ExploreCharts.tsx:133 | 读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:133;图题逐字比对 | 生效 |
| AC-EL-SRC-EC-003 | Marketplace 新品价分布 | 柱图 | 价格维度组图卡 | price_new 同 8 档桶,币种轴;构建器 ExploreCharts.tsx:134 | 读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:134;图题逐字比对 | 生效 |
| AC-EL-SRC-EC-004 | Used 价分布 | 柱图 | 价格维度组图卡 | price_used 同 8 档桶,币种轴;构建器 ExploreCharts.tsx:135 | 读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:135;图题逐字比对 | 生效 |
| AC-EL-SRC-EC-005 | List 价分布 | 柱图 | 价格维度组图卡 | 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-007 | 90 天均 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-009 | 30 天 Rank Drops 档位分布 | 柱图 | 排名/销量维度组图卡 | drops30 分桶 0/500/2k/5k/1w/3w/10w;构建器 ExploreCharts.tsx:142 | 读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:142;图题逐字比对 | 生效 |
| AC-EL-SRC-EC-010 | 365 天 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-013 | 90 天均评论档位分布 | 柱图 | 评论/评分维度组图卡 | 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-015 | 30 天缺货次数分布 | 柱图 | 报价/库存维度组图卡 | 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-019 | BSR 显示组占比 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-022 | BuyBox FBA / FBM 占比 | 环形 | 结构占比维度组图卡 | buy_box_is_fba true/false/其余未知 三段;构建器 ExploreCharts.tsx:161-166 | 读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:161-166;图题逐字比对 | 生效 |
| AC-EL-SRC-EC-023 | BuyBox 自营 / 第三方占比 | 环形 | 结构占比维度组图卡 | buy_box_is_amazon true/false/其余未知 三段;构建器 ExploreCharts.tsx:167-172 | 读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:167-172;图题逐字比对 | 生效 |
| AC-EL-SRC-EC-024 | BuyBox 价 × 月销量 | 散点 | 关联散点维度组图卡 | 气泡=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-027 | BuyBox 价 × 评论数 | 散点 | 关联散点维度组图卡 | x 币种轴;构建器 ExploreCharts.tsx:180 | 读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:180;图题逐字比对 | 生效 |
| AC-EL-SRC-EC-028 | 30 天 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-033 | BuyBox 价 Top20 ASIN | 柱图 | Top榜/箱线/相关性组图卡 | topAsin(buy_box desc) 币种轴;构建器 ExploreCharts.tsx:192 | 读 EXPLORE_CHART_GROUPS 目录与构建器 ExploreCharts.tsx:192;图题逐字比对 | 生效 |
| AC-EL-SRC-EC-034 | BSR 最优 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;图题逐字比对 | 生效 |
数据源 /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-001 | BSR原始变化点 | 线图 | BSR 两点近似 | keepa-single-bsr-raw 目录项;bsr_avg90+bsr_current 两点线, invert 轴; 快照近似非真时序(构建 KeepaSingleCharts.tsx 162-170) | chartCatalog.ts:29+KeepaSingleCharts.tsx:162 | 生效 |
| AC-EL-SRC-KS-002 | BSR日末值及日内最好/最差区间 | 线图 | BSR 区间近似 | keepa-single-bsr-daily-range 目录项;avg90/current±drops30 模拟上下界; 快照近似(构建 KeepaSingleCharts.tsx 171-179) | chartCatalog.ts:30+KeepaSingleCharts.tsx:171 | 生效 |
| AC-EL-SRC-KS-003 | BSR周级/月级聚合 | 柱图(横) | 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-004 | Amazon近月购买量档位阶梯线 | 线图 | 月销档单点 | keepa-single-monthly-sold 目录项;monthly_sold 档位单点线(构建 KeepaSingleCharts.tsx 192-195) | chartCatalog.ts:32+KeepaSingleCharts.tsx:192 | 生效 |
| AC-EL-SRC-KS-005 | BSR×近月购买量档位双轴图 | 双轴线 | BSR×月销档 | keepa-single-bsr-sold 目录项;bsr_current×monthly_sold 双轴, 主轴 invert(构建 KeepaSingleCharts.tsx 196-206) | chartCatalog.ts:33+KeepaSingleCharts.tsx:196 | 生效 |
| AC-EL-SRC-KS-006 | 30/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-007 | Amazon自营价历史 | 线图 | 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-008 | Marketplace 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-009 | Used价历史 | 线图 | price_used 单点近似 | keepa-single-used-price 目录项;keepa-history S.used 升级(单点构建 :219-233;升级路径 :97-111) | chartCatalog.ts:37+KeepaSingleCharts.tsx:222 | 生效 |
| AC-EL-SRC-KS-010 | List 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-011 | BuyBox价历史 | 线图 | buy_box 单点近似 | keepa-single-buybox-price 目录项;当前单点(无真时序升级项)(构建 :224) | chartCatalog.ts:39+KeepaSingleCharts.tsx:224 | 生效 |
| AC-EL-SRC-KS-012 | New FBA最低价历史 | 线图 | FBA 条件价 | keepa-single-new-fba-price 目录项;buy_box_is_fba?price_new:空(构建 :225) | chartCatalog.ts:40+KeepaSingleCharts.tsx:225 | 生效 |
| AC-EL-SRC-KS-013 | New FBM含运费价历史 | 线图 | FBM 条件价 | keepa-single-new-fbm-price 目录项;!buy_box_is_fba?price_new:空(构建 :226) | chartCatalog.ts:41+KeepaSingleCharts.tsx:226 | 生效 |
| AC-EL-SRC-KS-014 | Warehouse/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-016 | Lightning/Prime/Deal事件时间线 | 空态卡 | 恒无数据 | keepa-single-deal-events 目录项;无构建器(:240 注释)。2026-10-22 撤卡:目录项已从 chartCatalog 删除、卡不再渲染;原目录行号失效(构建 KeepaSingleCharts.tsx 240) | chartCatalog.ts:43+KeepaSingleCharts.tsx:240 | 废止 |
| AC-EL-SRC-KS-017 | Coupon与折扣历史 | 空态卡 | 恒无数据 | keepa-single-coupon-events 目录项;无构建器(:241 注释)。2026-10-22 撤卡:目录项已从 chartCatalog 删除、卡不再渲染;原目录行号失效(构建 KeepaSingleCharts.tsx 241) | chartCatalog.ts:44+KeepaSingleCharts.tsx:241 | 废止 |
| AC-EL-SRC-KS-018 | New报价数量历史 | 线图 | count_new 单点 | keepa-single-new-offer-count 目录项;当前单点线(构建 KeepaSingleCharts.tsx 242-246) | chartCatalog.ts:43+KeepaSingleCharts.tsx:242 | 生效 |
| AC-EL-SRC-KS-019 | FBA/FBM报价数量历史 | 柱图 | FBA vs FBM | keepa-single-fba-fbm-count 目录项;offer_fba/offer_fbm 双柱(蓝/橙)(构建 KeepaSingleCharts.tsx 247-255) | chartCatalog.ts:44+KeepaSingleCharts.tsx:247 | 生效 |
| AC-EL-SRC-KS-020 | Used/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-021 | BuyBox卖家占位时间线 | 柱图 | 占位 0/1 | keepa-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-022 | Amazon/第三方/空窗BuyBox持有结构 | 环形 | 三类 100/0 | keepa-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-024 | Amazon可售/缺货/恢复事件 | 事件图 | 缺货事件 | keepa-single-amazon-availability 目录项;oos_amazon_30/90 → 缺货次数事件点(构建 KeepaSingleCharts.tsx 288-297) | chartCatalog.ts:48+KeepaSingleCharts.tsx:288 | 生效 |
| AC-EL-SRC-KS-025 | 30/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-030 | BSR参考类目/类目变化历史 | 柱图(横) | 类目占位 | 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-032 | BSR 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-034 | BuyBox价→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-004 | BSR分布 | 柱图(横) | 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-008 | FBA/FBM/Amazon报价结构 | 环形 | 三和环形 | keepa-pool-fulfilment-structure 目录项;offer_fba/offer_fbm 总和+自营计数(求和口径, 非互斥)(构建 KeepaPoolCharts.tsx 121-133) | chartCatalog.ts:73+KeepaPoolCharts.tsx:121 | 生效 |
| AC-EL-SRC-KP-009 | BuyBox类型分布 | 环形(%) | 三类互斥 | keepa-pool-buybox-type 目录项;自营/FBA 三方/FBM 三方 百分比(构建 KeepaPoolCharts.tsx 134-149) | chartCatalog.ts:74+KeepaPoolCharts.tsx:134 | 生效 |
| AC-EL-SRC-KP-010 | BuyBox自营锁定程度分布 | 环形(%) | 自营占比 | keepa-pool-amazon-lock 目录项;buy_box_is_amazon 计数/总数(构建 KeepaPoolCharts.tsx 150-160) | chartCatalog.ts:75+KeepaPoolCharts.tsx:150 | 生效 |
| AC-EL-SRC-KP-011 | 品牌ASIN数量分布 | 柱图(横) | 品牌 top12 | keepa-pool-brand-count 目录项;按 brand 计数降序 top12(缺品牌记「未返回」)(构建 KeepaPoolCharts.tsx 161-168) | chartCatalog.ts:76+KeepaPoolCharts.tsx:161 | 生效 |
| AC-EL-SRC-KP-012 | 制造商ASIN数量分布 | 柱图(横) | 厂商 top12 | keepa-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-016 | BSR×购买量档位散点图 | 散点 | 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散点图 | 散点 | 价×BSR | keepa-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-020 | FBA费/佣金/毛利空间对比 | 柱图(横) | 毛利空间 | 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-022 | ASIN×6字段覆盖热力图(Top12) | 热力 | 覆盖 0/1 | keepa-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-001 | SFR×同参考类目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-002 | SFR×Top3购买量档位中位数 | 双轴线 | SFR×月销中位 | joint-sfr-sold 目录项;同上, field=monthly_sold(构建 JointCharts.tsx 76-104) | chartCatalog.ts:92+JointCharts.tsx:76 | 生效 |
| AC-EL-SRC-JT-003 | SFR×Top3价格中位数 | 双轴线 | SFR×价中位 | joint-sfr-price 目录项;field=price_new(构建 JointCharts.tsx 76-104) | chartCatalog.ts:93+JointCharts.tsx:76 | 生效 |
| AC-EL-SRC-JT-004 | SFR×Top3报价数量 | 双轴线 | SFR×报价中位 | joint-sfr-offers 目录项;field=total_offers(构建 JointCharts.tsx 76-104) | chartCatalog.ts:94+JointCharts.tsx:76 | 生效 |
| AC-EL-SRC-JT-005 | SFR×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-006 | SFR×Top3缺货率 | 双轴线 | SFR×缺货中位 | joint-sfr-oos 目录项;field=oos_amazon_30(构建 JointCharts.tsx 76-104) | chartCatalog.ts:96+JointCharts.tsx:76 | 生效 |
| AC-EL-SRC-JT-007 | Top1点击份额×同ASIN BSR | 散点 | 份额×BSR | joint-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-008 | Top1成交份额×同ASIN BSR | 散点 | 份额×BSR | joint-top1-conversion-bsr 目录项;asin_1_conv_share×bsr_current(构建 JointCharts.tsx 113-135) | chartCatalog.ts:98+JointCharts.tsx:113 | 生效 |
| AC-EL-SRC-JT-009 | Top1点击份额×同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-010 | Top3点击集中度×品牌数 | 散点 | 集中×品牌数 | 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-019 | ABA份额×BuyBox持有结构 | 堆叠(%) | 份额×持有 | joint-share-buybox 目录项;(自营数/3)×top3_click_share 三系百分比堆叠(构建 JointCharts.tsx 220-253) | chartCatalog.ts:109+JointCharts.tsx:220 | 生效 |
| AC-EL-SRC-JT-020 | ABA份额×缺货率 | 双轴线 | 份额×缺货 | joint-share-oos 目录项;top3 份额 × 当月 Top3 oos30 中位(构建 JointCharts.tsx 245-266) | chartCatalog.ts:110+JointCharts.tsx:245 | 生效 |
| AC-EL-SRC-JT-021 | ABA份额变化×价格变化 | 双轴线 | 相邻月差 | joint-share-change-price 目录项;top3 份额差 × price_new 中位差(构建 JointCharts.tsx 258-300) | chartCatalog.ts:111+JointCharts.tsx:258 | 生效 |
| AC-EL-SRC-JT-022 | ABA份额变化×BSR变化 | 双轴线 | 相邻月差 | joint-share-change-bsr 目录项;bsr_current 中位差(构建 JointCharts.tsx 258-300) | chartCatalog.ts:112+JointCharts.tsx:258 | 生效 |
| AC-EL-SRC-JT-023 | ABA份额变化×购买量档位变化 | 双轴线 | 相邻月差 | joint-share-change-sold 目录项;monthly_sold 中位差(构建 JointCharts.tsx 258-300) | chartCatalog.ts:113+JointCharts.tsx:258 | 生效 |
| AC-EL-SRC-JT-024 | ABA份额变化×评论增长 | 双轴线 | 相邻月差 | joint-share-change-reviews 目录项;reviews 中位差(构建 JointCharts.tsx 258-300) | chartCatalog.ts:114+JointCharts.tsx:258 | 生效 |
| AC-EL-SRC-JT-025 | ABA份额变化×报价数量变化 | 双轴线 | 相邻月差 | joint-share-change-offers 目录项;total_offers 中位差(构建 JointCharts.tsx 258-300) | chartCatalog.ts:115+JointCharts.tsx:258 | 生效 |
| AC-EL-SRC-JT-026 | ASIN进入Top3前后事件图 | 事件图 | 进入事件 | joint-entry-event 目录项;first_period 进入标记; last≠first 加「最后上榜」(构建 JointCharts.tsx 292-314) | chartCatalog.ts:116+JointCharts.tsx:292 | 生效 |
| AC-EL-SRC-JT-027 | ASIN退出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-031 | ABA×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-032 | ABA月份×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.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 挂账据此清账。
收件工作台=待处理队列卡+会话弹层+规则弹层三块(容器 :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:82 | InboxTab.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-75 | InboxTab.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-37 | InboxTab.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-41 | InboxTab.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-87 | InboxTab.tsx:42-52 读源比对 9 项 label+q 逐字 | 生效 |
| AC-EL-OFC-INB-006 | 分类规则入口按钮 | 按钮 | 打开规则弹层 | 「分类规则」ghost sm 按钮→setRulesOpen(true) 渲染 RulesModal;InboxTab.tsx:89 | InboxTab.tsx:89 读源断言按钮文案与开关行为 | 生效 |
| AC-EL-OFC-INB-007 | 队列列·发件人 | 列 | 表头「发件人」 | 单元格 m.from,空显「—」;InboxTab.tsx:94,101 | InboxTab.tsx:94,101 读源断言表头原文与空值兜底 | 生效 |
| AC-EL-OFC-INB-008 | 队列列·主题 | 列 | 表头「主题」 | 单元格 m.subject,空显「(无主题)」;InboxTab.tsx:94,102 | InboxTab.tsx:94,102 读源断言表头与空值文案 | 生效 |
| AC-EL-OFC-INB-009 | 队列列·分类 | 列 | 表头「分类」 | badge 类名=CLS_TONE[classified_as]||dim,文本=CLS_LABELS[classified_as]||原码;InboxTab.tsx:94,103-104 | InboxTab.tsx:103-104 读源断言双 fallback 链 | 生效 |
| AC-EL-OFC-INB-010 | 队列列·置信度 | 列 | 表头「置信度」 | num 列,confidence!=null 显 toFixed(2) 两位小数,否则「—」;InboxTab.tsx:94,105 | InboxTab.tsx:105 读源断言 toFixed(2) 与空值 | 生效 |
| AC-EL-OFC-INB-011 | 队列列·达人 | 列 | 表头「达人」 | 三级显示:kol_name → kol_id 显「#id」→ badge warn「未匹配」;InboxTab.tsx:94,106-107 | InboxTab.tsx:106-107 读源断言三级 fallback | 生效 |
| AC-EL-OFC-INB-012 | 队列列·时间 | 列 | 表头「时间」 | received_at 截前 16 位、T 换空格(YYYY-MM-DD HH:mm),空显「—」;InboxTab.tsx:94,108 | InboxTab.tsx:108 读源断言 slice(0,16)+replace | 生效 |
| AC-EL-OFC-INB-013 | 队列列·状态 | 列 | 表头「状态」 | handled 显「已处理」否则「待处理」;未处理整行 fontWeight 600 加粗;InboxTab.tsx:94,100,109 | InboxTab.tsx:100,109 读源断言文案与加粗条件 | 生效 |
| AC-EL-OFC-INB-014 | 队列行选中 | 按钮 | 行点击开会话 | tr onClick=setId 选中行背景 var(--bg2,#f6f7f9)、cursor pointer;选中后渲染 ThreadPanel;InboxTab.tsx:98-100,127 | InboxTab.tsx:98-99 读源断言选中样式与 setSel | 生效 |
| AC-EL-OFC-INB-015 | 队列空态 | 空态 | 队列为空行 | items 空数组时 colSpan 7 居中行「队列为空(worker 每 10 分钟拉取未读邮件,未匹配/置信度不足的会进「待人工」)」;InboxTab.tsx:112-115 | InboxTab.tsx:113-114 读源断言空态文案逐字 | 生效 |
| AC-EL-OFC-INB-016 | 队列加载态 | 空态 | 加载占位行 | items==null 时 colSpan 7 居中「加载中…」;InboxTab.tsx:116 | InboxTab.tsx:116 读源断言加载占位 | 生效 |
| AC-EL-OFC-INB-017 | 队列分页计数 | 标签 | pager 计数 | 「共 {int(total)} 封 · 第 {page} / {pages} 页」,pages=ceil(total/20) 下限 1;InboxTab.tsx:77,120-121 | InboxTab.tsx:77,121 读源断言计数式 | 生效 |
| AC-EL-OFC-INB-018 | 队列翻页按钮 | 按钮 | 上一页/下一页 | page≤1 禁用上一页、page≥pages 禁用下一页;InboxTab.tsx:122-123 | InboxTab.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-186 | InboxTab.tsx:179-186 读源断言遮罩关闭与双栏结构 | 生效 |
| AC-EL-OFC-INB-020 | 会话线程加载 | 端点 | thread 数据源 | GET /api/promotion/inbox/{mid}/thread→{kol_id,items};InboxTab.tsx:145-152 | InboxTab.tsx:146 读源断言路径与响应字段 | 生效 |
| AC-EL-OFC-INB-021 | 达人档案加载 | 端点 | profile 数据源 | GET /api/promotion/inbox/kol/{kol_id}/profile,仅 thread 响应 kol_id 非空时请求,失败置 null 不报错;InboxTab.tsx:147-149 | InboxTab.tsx:147-149 读源断言条件请求与静默失败 | 生效 |
| AC-EL-OFC-INB-022 | 模板列表加载 | 端点 | 回复模板下拉源 | GET /api/promotion/email-templates→{items}(弹层挂载时一次),失败静默;InboxTab.tsx:153-155 | InboxTab.tsx:154 读源断言路径与静默 catch | 生效 |
| AC-EL-OFC-INB-023 | 会话气泡流 | 容器 | 往来消息列表 | direction=out 右对齐底色 var(--ok-bg,#e8f5ee),其余左对齐 var(--bg2,#f1f3f6);气泡头行=「我方/发件人 · 时间 · 分类中文」;主体主题+正文(pre-wrap);空线程显「无记录」;InboxTab.tsx:187-201 | InboxTab.tsx:188-200 读源断言双底色与头行拼接 | 生效 |
| AC-EL-OFC-INB-024 | 认领达人输入 | 输入 | 未匹配认领框 | 条件渲染 data.kol_id==null;input placeholder「认领达人ID」maxWidth 130;InboxTab.tsx:203-207 | InboxTab.tsx:203-207 读源断言条件与 placeholder | 生效 |
| AC-EL-OFC-INB-025 | 认领按钮 | 按钮 | 绑定达人 | 「认领」busy 或 ID 空白禁用;成功 toast「已执行」并刷新线程+队列;InboxTab.tsx:208-209 | InboxTab.tsx:208-209 读源断言 disabled 条件 | 生效 |
| AC-EL-OFC-INB-026 | 认领提交 | 端点 | claim 通道 | POST /api/promotion/inbox/{mid}/claim body {kol_id:Number(claimId)};InboxTab.tsx:209 | InboxTab.tsx:209 读源断言路径与数值化载荷 | 生效 |
| AC-EL-OFC-INB-027 | 复核改类选择器 | 选择器 | 改类下拉 | 首项「复核改类…」(值空)+CLS_LABELS 全 7 类选项;InboxTab.tsx:213-216 | InboxTab.tsx:213-216 读源断言 8 项选项 | 生效 |
| AC-EL-OFC-INB-028 | 改类并结单按钮 | 按钮 | 提交改类 | 「改类并结单」busy 或未选类禁用,成功后清空选择;InboxTab.tsx:217-219 | InboxTab.tsx:217-219 读源断言 disabled 与 setCls("") | 生效 |
| AC-EL-OFC-INB-029 | 改类提交 | 端点 | classify 通道 | POST /api/promotion/inbox/{mid}/classify body {classified_as:cls};InboxTab.tsx:218 | InboxTab.tsx:218 读源断言路径与载荷 | 生效 |
| AC-EL-OFC-INB-030 | 标已处理按钮 | 按钮 | 人工结单 | 「标已处理」ghost sm,仅 busy 禁用;InboxTab.tsx:220-221 | InboxTab.tsx:220-221 读源断言文案与禁用条件 | 生效 |
| AC-EL-OFC-INB-031 | 标已处理提交 | 端点 | handled 通道 | POST /api/promotion/inbox/{mid}/handled body {handled:true};InboxTab.tsx:221 | InboxTab.tsx:221 读源断言路径与载荷 | 生效 |
| AC-EL-OFC-INB-032 | 从原箱回复卡 | 容器 | 回复表单卡 | 内嵌卡 h2「从原箱回复」,含模板下拉+主题输入+正文 textarea+发送/关闭;InboxTab.tsx:224-242 | InboxTab.tsx:224-242 读源断言卡结构与标题 | 生效 |
| AC-EL-OFC-INB-033 | 回复模板选择器 | 选择器 | 模板/手写 | 首项「手写」(值空)+email-templates 全列 name;选模板后正文 placeholder 变「选模板后发送时按达人变量渲染」;InboxTab.tsx:227-230,235 | InboxTab.tsx:227-230 读源断言选项来源与首项 | 生效 |
| AC-EL-OFC-INB-034 | 回复主题输入 | 输入 | 邮件主题 | placeholder「主题(空=Re: 原主题)」,提交时 trim;InboxTab.tsx:231-232,171 | InboxTab.tsx:231 读源断言 placeholder 与空语义 | 生效 |
| AC-EL-OFC-INB-035 | 回复正文输入 | 输入 | textarea 正文 | minHeight 90,placeholder 手写态「回复正文…」;空正文提交被拦「正文不能为空」;InboxTab.tsx:234-236,167 | InboxTab.tsx:234-236 读源断言 placeholder 与前置校验 | 生效 |
| AC-EL-OFC-INB-036 | 发送回复按钮 | 按钮 | 原箱发送 | 「发送回复」busy 显「发送中…」;busy 或正文空禁用;成功 toast「已从原箱回复」并清空主题/正文、刷新;InboxTab.tsx:237-239,173 | InboxTab.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-176 | InboxTab.tsx:170-172 读源断言路径与三字段载荷 | 生效 |
| AC-EL-OFC-INB-038 | 会话关闭按钮 | 按钮 | 关 ThreadPanel | 「关闭」ghost sm→onClose 清选中;InboxTab.tsx:240 | InboxTab.tsx:240 读源断言关闭行为 | 生效 |
| AC-EL-OFC-INB-039 | 达人档案侧栏 | 容器 | 右侧档案栏 | 标题「达人档案」;profile 空显「未匹配邮件无档案;认领后显示。」;InboxTab.tsx:245-272 | InboxTab.tsx:246,271 读源断言标题与空档案文案 | 生效 |
| AC-EL-OFC-INB-040 | 档案·名/平台/粉丝 | 标签 | 档案头 | name 加粗 + platform,subscribers 非空追加「 · N 粉」(int 千分位);InboxTab.tsx:249-252 | InboxTab.tsx:249-252 读源断言拼接式 | 生效 |
| AC-EL-OFC-INB-041 | 档案·邮箱/抑制 | 标签 | 联系方式行 | email||「无邮箱」,suppression=true 追加「 · 已抑制」;InboxTab.tsx:253-254 | InboxTab.tsx:253-254 读源断言兜底与抑制后缀 | 生效 |
| AC-EL-OFC-INB-042 | 档案·回复状态/触达 | 标签 | 触达摘要行 | 「回复状态:{reply_status||—} · 最近触达 {last_contacted_at 前 10 位||—}」;InboxTab.tsx:255-257 | InboxTab.tsx:256 读源断言文案式 | 生效 |
| AC-EL-OFC-INB-043 | 档案·标签徽章 | 标签 | tags 徽章列 | tags 前 12 枚 badge dim(字号 11),空显「无标签」;InboxTab.tsx:258-262 | InboxTab.tsx:259-261 读源断言 slice(0,12) 与空态 | 生效 |
| AC-EL-OFC-INB-044 | 档案·发送历史 | 标签 | 历史任务列表 | 标题「发送历史」;逐行「{task_name||任务#id} · {status} · {sent_at 前 10 位}」,sent_at 空省略;空显「无」;InboxTab.tsx:263-269 | InboxTab.tsx:264-268 读源断言行式与空态 | 生效 |
| AC-EL-OFC-INB-045 | 规则包列表加载 | 端点 | 规则表数据源 | GET /api/promotion/classify-rules→{items},失败 toast 报错;InboxTab.tsx:287-291 | InboxTab.tsx:288 读源断言路径 | 生效 |
| AC-EL-OFC-INB-046 | 规则列·优先级 | 列 | 表头「优先级」 | 右对齐 num,数值原样;数字越小越先匹配;InboxTab.tsx:327,331 | InboxTab.tsx:327,331 读源断言表头与对齐 | 生效 |
| AC-EL-OFC-INB-047 | 规则列·分类 | 列 | 表头「分类」 | badge 同队列分类列(CLS_TONE/CLS_LABELS+原码 fallback);InboxTab.tsx:327,332-333 | InboxTab.tsx:332-333 读源断言复用映射 | 生效 |
| AC-EL-OFC-INB-048 | 规则列·类型 | 列 | 表头「类型」 | kind=regex 显「正则」否则「关键词」;InboxTab.tsx:327,334 | InboxTab.tsx:334 读源断言二值映射 | 生效 |
| AC-EL-OFC-INB-049 | 规则列·词/正则 | 列 | 表头「词 / 正则」 | pattern 文本 maxWidth 260、title 悬浮全文;InboxTab.tsx:327,335 | InboxTab.tsx:335 读源断言 title 属性 | 生效 |
| AC-EL-OFC-INB-050 | 规则列·状态 | 列 | 表头「状态」 | enabled 显「启用」否则「停用」;InboxTab.tsx:327,336 | InboxTab.tsx:336 读源断言二值文案 | 生效 |
| AC-EL-OFC-INB-051 | 规则列·操作 | 列 | 表头「操作」 | 启停切换按钮(文本随 enabled「停用/启用」)+「删除」按钮;InboxTab.tsx:327,337-340 | InboxTab.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-304 | InboxTab.tsx:294-300 读源断言载荷与前置校验 | 生效 |
| AC-EL-OFC-INB-053 | 规则·优先级输入 | 输入 | 新增优先级 | number 输入默认「100」,title「数字越小越先匹配」maxWidth 80;InboxTab.tsx:281,348-349 | InboxTab.tsx:348-349 读源断言默认值与 title | 生效 |
| AC-EL-OFC-INB-054 | 规则·分类选择器 | 选择器 | 新增分类 | 6 选项:同意合作/索要样品/索要报价/拒绝合作/无关/退信(无 manual_review;规则匹配口径「无命中进『待人工』」见 :324);InboxTab.tsx:350-353 | InboxTab.tsx:351-352 读源断言 6 键枚举 | 生效 |
| AC-EL-OFC-INB-055 | 规则·类型选择器 | 选择器 | 关键词/正则 | 二选项 keyword=关键词/regex=正则;InboxTab.tsx:354-357 | InboxTab.tsx:355-356 读源断言二值 | 生效 |
| AC-EL-OFC-INB-056 | 规则·pattern 输入 | 输入 | 词/正则输入 | placeholder「关键词或正则(正则须能编译)」;InboxTab.tsx:358-359 | InboxTab.tsx:359 读源断言 placeholder 逐字 | 生效 |
| AC-EL-OFC-INB-057 | 规则·新增按钮 | 按钮 | 提交建规则 | 「新增」busy 禁用,成功 toast「规则已加」并清空 pattern 刷新表;InboxTab.tsx:360,301 | InboxTab.tsx:360 读源断言文案与刷新链 | 生效 |
| AC-EL-OFC-INB-058 | 规则启停提交 | 端点 | 改规则通道 | PUT /api/promotion/classify-rules/{id} body 全量 {priority, classified_as, kind, pattern, enabled:!原值};InboxTab.tsx:305-313 | InboxTab.tsx:307-310 读源断言全量载荷与翻转 | 生效 |
| AC-EL-OFC-INB-059 | 规则启停按钮 | 按钮 | 启停切换 | 文本随 enabled 显「停用/启用」ghost sm;InboxTab.tsx:338 | InboxTab.tsx:338 读源断言切换文案 | 生效 |
| AC-EL-OFC-INB-060 | 规则删除提交 | 端点 | 删规则通道 | DELETE /api/promotion/classify-rules/{rid}(无 body),成功 toast「已删除」;InboxTab.tsx:314-317 | InboxTab.tsx:315 读源断言 DELETE 与无载荷 | 生效 |
| AC-EL-OFC-INB-061 | 规则删除按钮 | 按钮 | 行内删除 | 「删除」ghost sm,无二次确认(直接 DELETE);InboxTab.tsx:339 | InboxTab.tsx:339 读源断言无确认直删 | 生效 |
| AC-EL-OFC-INB-062 | 规则加载态 | 空态 | 规则表占位 | items==null 时 colSpan 6「加载中…」;InboxTab.tsx:343 | InboxTab.tsx:343 读源断言占位 | 生效 |
| AC-EL-OFC-INB-063 | 规则关闭按钮 | 按钮 | 关规则弹层 | 「关闭」ghost sm→onClose;规则弹层卡宽 min(760px,94vw);InboxTab.tsx:322-323,361 | InboxTab.tsx:361 读源断言关闭行为 | 生效 |
总览=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-001 | facets 加载 | 端点 | 渠道/类目 facet 源 | GET /api/promotion/kol-library?suppression=all&page_size=1 只取 facets;OverviewTab.tsx:29-31 | OverviewTab.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-21 | OverviewTab.tsx:32-33 读源断言 9 字段消费 | 生效 |
| AC-EL-OFC-OVR-003 | 渠道字典加载 | 端点 | 字典登记数 | GET /api/promotion/channel-dict 取 items.length,失败静默(脚注显「—」);OverviewTab.tsx:34-35 | OverviewTab.tsx:34-35 读源断言 length 与静默 | 生效 |
| AC-EL-OFC-OVR-004 | 错误条 | 容器 | API 失败提示 | err 非空显 div.error role=alert;OverviewTab.tsx:47 | OverviewTab.tsx:47 读源断言条件渲染 | 生效 |
| AC-EL-OFC-OVR-005 | KPI·达人总数 | 标签 | 库规模卡 | k-value=int(rows_total),未载显「—」;k-foot「企业达人库 · 含抑制名单」;OverviewTab.tsx:49-53 | OverviewTab.tsx:50-52 读源断言取值与脚注 | 生效 |
| AC-EL-OFC-OVR-006 | KPI·唯一收件邮箱 | 标签 | 去重邮箱卡 | 值=unique_emails;foot「带邮箱记录 N 行 · 去重 P%」,P=round((1−unique/rows_with_email)×100)(分母 0 显「—」);OverviewTab.tsx:54-58,40-41 | OverviewTab.tsx:57,40-41 读源断言去重式与零分母兜底 | 生效 |
| AC-EL-OFC-OVR-007 | KPI·个人邮箱 | 标签 | 有效外联量卡 | 值=personal_emails;foot「扣除公共/角色邮箱 N(info@/press@/noreply@ 等,占 Q%)」,Q=round(role/unique×100);OverviewTab.tsx:59-63,42-43 | OverviewTab.tsx:62,42-43 读源断言占比式 | 生效 |
| AC-EL-OFC-OVR-008 | KPI·Deal 资源 | 标签 | deal 邮箱卡 | 值=deal_kol_emails;foot「达人库 deal 类 N 行 · deal站 N · Reddit poster N」三子数;OverviewTab.tsx:64-68 | OverviewTab.tsx:66-67 读源断言三子数来源 | 生效 |
| AC-EL-OFC-OVR-009 | KPI·覆盖渠道 | 标签 | 平台数卡 | 值=facets.platforms.length;foot「字典登记 N 项」(channel-dict 计数);OverviewTab.tsx:69-73 | OverviewTab.tsx:71-72 读源断言双来源 | 生效 |
| AC-EL-OFC-OVR-010 | KPI·自定义类目 | 标签 | 类目数卡 | 值=categories.length;foot「已打标 Σcount 人次」;OverviewTab.tsx:74-78 | OverviewTab.tsx:76-77 读源断言 reduce 求和 | 生效 |
| AC-EL-OFC-OVR-011 | KPI·外联漏斗占位 | 标签 | 未上线卡 | 值恒「—」(fontSize 19);foot「发送/回复/意向 P2 邮件基建投用后接入」;OverviewTab.tsx:79-83 | OverviewTab.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-39 | OverviewTab.tsx:91-99 读源断言条宽式与下限 3 | 生效 |
| AC-EL-OFC-OVR-013 | Deal 资源怎么找卡 | 容器 | 三口径指引 | h2「Deal 资源怎么找」sub「三处口径 · 分别进入对应 tab 筛选」;正文 ①达人库 tab ②渠道库 ③Reddit 专库 三条路径文案;OverviewTab.tsx:105-112 | OverviewTab.tsx:107-111 读源断言三路径文案逐字 | 生效 |
| AC-EL-OFC-OVR-014 | 待上线模块卡 | 容器 | P2/P3 范围声明 | h2「待上线模块」;正文声明邮件外联/收件工作台/邮箱设置=P2 代码已就绪待投用、自动跟进与归因=P3、上线前显「—」不以 0 充数;OverviewTab.tsx:114-120 | OverviewTab.tsx:116-119 读源断言范围声明 | 生效 |
分群=筛选条件→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-58 | SegmentsTab.tsx:54-56 读源断言路径与错误通路 | 生效 |
| AC-EL-OFC-SEG-002 | 分群 facet 加载 | 端点 | 条件 chip 源 | GET /api/promotion/kol-library?page=1&page_size=1 只取 facets,失败静默;SegmentsTab.tsx:59-62 | SegmentsTab.tsx:60-61 读源断言仅 facets | 生效 |
| AC-EL-OFC-SEG-003 | 分群名输入 | 输入 | 新建分群名 | placeholder「分群名」maxWidth 160,空名提交被拦「分群名必填」;SegmentsTab.tsx:95,67 | SegmentsTab.tsx:95 读源断言 placeholder 与必填 | 生效 |
| AC-EL-OFC-SEG-004 | 渠道 chip 多选 | 按钮 | platforms 条件 | facets.platforms 前 20 枚圆角 chip,文本「{label}({count})」,点击 toggle 选中态 on;SegmentsTab.tsx:96-102 | SegmentsTab.tsx:97-100 读源断言 slice(0,20) 与 toggle | 生效 |
| AC-EL-OFC-SEG-005 | 国家 chip 多选 | 按钮 | countries 条件 | facets.countries 前 30 枚 chip,空值显「(空)」;SegmentsTab.tsx:104-111 | SegmentsTab.tsx:107-110 读源断言 slice(0,30) 与空值标签 | 生效 |
| AC-EL-OFC-SEG-006 | 类目 chip 多选 | 按钮 | cat_ids 条件 | facets.categories 全量 chip「{name}({count})」;SegmentsTab.tsx:112-116 | SegmentsTab.tsx:112-116 读源断言全量渲染 | 生效 |
| AC-EL-OFC-SEG-007 | 联系方式选择器 | 选择器 | contact 条件 | 默认 email;选项「联系方式不限」+4 项:有邮箱/IM(无邮箱)/社交(无邮箱)/仅官网/无联系方式(CONTACT_LABELS);SegmentsTab.tsx:48,120-123,20-23 | SegmentsTab.tsx:120-123 读源断言默认值与 5 选项 | 生效 |
| AC-EL-OFC-SEG-008 | 粉丝下限输入 | 输入 | fmin 条件 | number 输入 placeholder「粉丝下限」maxWidth 110,空不进 criteria;SegmentsTab.tsx:124,75 | SegmentsTab.tsx:124 读源断言 placeholder 与可选 | 生效 |
| AC-EL-OFC-SEG-009 | 粉丝上限输入 | 输入 | fmax 条件 | number 输入 placeholder「粉丝上限」maxWidth 110;SegmentsTab.tsx:125,76 | SegmentsTab.tsx:125 读源断言 placeholder | 生效 |
| AC-EL-OFC-SEG-010 | 建分群按钮 | 按钮 | 提交创建 | 「按条件建分群」busy 显「创建中…」;成功 toast「分群已创建:N 位达人」并清名刷新+onChanged 回调;SegmentsTab.tsx:126,79-80 | SegmentsTab.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-82 | SegmentsTab.tsx:70-78 读源断言条件组装与响应消费 | 生效 |
| AC-EL-OFC-SEG-012 | 成员口径说明 | 标签 | 建群脚注 | 「成员 = 当前条件下有任一联系方式的达人;无邮箱者在发送时自动跳过」;SegmentsTab.tsx:127 | SegmentsTab.tsx:127 读源断言脚注逐字 | 生效 |
| AC-EL-OFC-SEG-013 | 分群列·分群 | 列 | 表头「分群」 | 单元格 name 加粗;SegmentsTab.tsx:132,136 | SegmentsTab.tsx:132,136 读源断言表头与样式 | 生效 |
| AC-EL-OFC-SEG-014 | 分群列·筛选条件 | 列 | 表头「筛选条件」 | criteriaSummary(:25-36):渠道/国家/类目 #id/源类目/标签/联系式标签/粉丝≥≤ 空格点接,全空显「空条件(全库)」;SegmentsTab.tsx:132,137 | SegmentsTab.tsx:137,25-36 读源断言摘要式与全库文案 | 生效 |
| AC-EL-OFC-SEG-015 | 分群列·成员数 | 列 | 表头「成员数」 | 右对齐 num 显 member_n(快照人数)而非 kol_count(建群时点数);SegmentsTab.tsx:132,138 | SegmentsTab.tsx:138 读源断言取 member_n | 生效 |
| AC-EL-OFC-SEG-016 | 分群列·创建时间 | 列 | 表头「创建时间」 | created_at 原样;SegmentsTab.tsx:132,139 | SegmentsTab.tsx:139 读源断言原样显示 | 生效 |
| AC-EL-OFC-SEG-017 | 分群列·操作 | 列 | 表头「操作」 | 「删除」ghost sm 按钮;SegmentsTab.tsx:132,140 | SegmentsTab.tsx:140 读源断言按钮 | 生效 |
| AC-EL-OFC-SEG-018 | 删除分群按钮 | 按钮 | 危险确认删除 | useConfirm 危险框「删除分群」「「{名}」?引用它的发送任务将无法取人。」确认才发;成功 toast「已删除」;SegmentsTab.tsx:84-88 | SegmentsTab.tsx:85 读源断言确认文案与 danger | 生效 |
| AC-EL-OFC-SEG-019 | 删除分群提交 | 端点 | 删除通道 | DELETE /api/promotion/segments/{sid}(无 body)+onChanged 回调;SegmentsTab.tsx:86 | SegmentsTab.tsx:86 读源断言 DELETE 与回调 | 生效 |
| AC-EL-OFC-SEG-020 | 分群空态 | 空态 | 暂无分群行 | items 空数组 colSpan 5「暂无分群」;SegmentsTab.tsx:143 | SegmentsTab.tsx:143 读源断言空态文案 | 生效 |
| AC-EL-OFC-SEG-021 | 分群加载态 | 空态 | 加载占位行 | items==null colSpan 5「加载中…」;SegmentsTab.tsx:144 | SegmentsTab.tsx:144 读源断言占位 | 生效 |
全部资源=渠道站+达人合库浏览;数据 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-35 | ResourcesTab.tsx:30-33 读源断言参数拼装 | 生效 |
| AC-EL-OFC-RES-002 | 资源卡头计数 | 标签 | h2 动态总数 | 「全部资源」sub「渠道站 + 达人 · 共 {int(total)} 条 · 按粉丝降序」,未载 total=undefined 显 0;ResourcesTab.tsx:46 | ResourcesTab.tsx:46 读源断言计数式 | 生效 |
| AC-EL-OFC-RES-003 | 类型 tab 组 | 选择器 | rtype 三选 | 全部("")/渠道站(channel)/达人(kol),选中 on,切换回第 1 页;ResourcesTab.tsx:48-51 | ResourcesTab.tsx:48-51 读源断言三值 | 生效 |
| AC-EL-OFC-RES-004 | 平台选择器 | 选择器 | platform 筛选 | 首项「全部平台」+facets.platforms「{value}({count})」,「(空)」值映射回 "";ResourcesTab.tsx:52-55 | ResourcesTab.tsx:54 读源断言空值映射 | 生效 |
| AC-EL-OFC-RES-005 | 类目选择器 | 选择器 | category 筛选 | 首项「全部类目」+facets.categories,同空值映射;ResourcesTab.tsx:56-59 | ResourcesTab.tsx:58 读源断言选项源 | 生效 |
| AC-EL-OFC-RES-006 | 国家选择器 | 选择器 | country 筛选 | 首项「全部国家」+facets.countries,同空值映射;ResourcesTab.tsx:60-63 | ResourcesTab.tsx:62 读源断言选项源 | 生效 |
| AC-EL-OFC-RES-007 | 搜索输入 | 输入 | q 名称/邮箱 | placeholder「搜索名称 / 邮箱」maxWidth 220,输入即筛(无防抖)且回第 1 页;ResourcesTab.tsx:64-65 | ResourcesTab.tsx:64-65 读源断言即时筛选 | 生效 |
| AC-EL-OFC-RES-008 | 重置按钮 | 按钮 | 清全部筛选 | 「重置」→rtype/platform/category/country/q 全清+回第 1 页;ResourcesTab.tsx:40-42,66 | ResourcesTab.tsx:41,66 读源断言五态清零 | 生效 |
| AC-EL-OFC-RES-009 | 加载态 | 空态 | Spinner | data==null 显 Spinner 组件(每次筛选变更先置 null);ResourcesTab.tsx:29,69 | ResourcesTab.tsx:29,69 读源断言先清后载 | 生效 |
| AC-EL-OFC-RES-010 | 无匹配空态 | 空态 | EmptyState | items 空显 EmptyState title「无匹配资源」hint「调整筛选条件」;ResourcesTab.tsx:70 | ResourcesTab.tsx:70 读源断言双文案 | 生效 |
| AC-EL-OFC-RES-011 | 资源列·资源 | 列 | 表头「资源」 | name 单行省略 maxWidth 240;source_url 非空渲染 a 外链(新窗 noreferrer 品牌色)否则纯文本;ResourcesTab.tsx:75,81-83 | ResourcesTab.tsx:81-83 读源断言条件外链 | 生效 |
| AC-EL-OFC-RES-012 | 资源列·类型 | 列 | 表头「类型」 | chip:rtype=kol 显「达人」(默认色)否则「渠道站」(dim);ResourcesTab.tsx:75,84 | ResourcesTab.tsx:84 读源断言二值与配色 | 生效 |
| AC-EL-OFC-RES-013 | 资源列·平台 | 列 | 表头「平台」 | muted 显 platform,空「—」;ResourcesTab.tsx:75,85 | ResourcesTab.tsx:85 读源断言空值兜底 | 生效 |
| AC-EL-OFC-RES-014 | 资源列·类目 | 列 | 表头「类目」 | t2 单行省略 maxWidth 140,空「—」;ResourcesTab.tsx:75,86 | ResourcesTab.tsx:86 读源断言省略与兜底 | 生效 |
| AC-EL-OFC-RES-015 | 资源列·国家 | 列 | 表头「国家」 | muted 显 country,空「—」;ResourcesTab.tsx:75,87 | ResourcesTab.tsx:87 读源断言兜底 | 生效 |
| AC-EL-OFC-RES-016 | 资源列·粉丝 | 列 | 表头「粉丝」 | 右对齐 num;fmtK=followers!=null?toLocaleString("en-US")(千分位):「—」;ResourcesTab.tsx:75,88,37 | ResourcesTab.tsx:88,37 读源断言千分位与空值 | 生效 |
| AC-EL-OFC-RES-017 | 资源列·活跃度 | 列 | 表头「活跃度」 | 右对齐 num muted,activity!=null 显原值否则「—」;ResourcesTab.tsx:75,89 | ResourcesTab.tsx:89 读源断言空值兜底 | 生效 |
| AC-EL-OFC-RES-018 | 资源列·联系方式 | 列 | 表头「联系方式」 | contact 含 @ 显 mailto 链接(取逗号前首个 trim)否则纯文本,空「—」;单行省略 maxWidth 200;ResourcesTab.tsx:75,90-92 | ResourcesTab.tsx:91 读源断言 mailto 取首地址 | 生效 |
| AC-EL-OFC-RES-019 | 资源分页计数 | 标签 | pager 计数 | 「共 {int(total)} 条 · 第 {data.page} / {pages} 页」(当前页取响应 page);ResourcesTab.tsx:97-98 | ResourcesTab.tsx:98 读源断言响应页号消费 | 生效 |
| AC-EL-OFC-RES-020 | 资源翻页按钮 | 按钮 | 上一页/下一页 | page≤1/page≥pages 双侧禁用;ResourcesTab.tsx:99-100 | ResourcesTab.tsx:99-100 读源断言边界禁用 | 生效 |
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-001 | Reddit 列表加载 | 端点 | 专库数据源 | 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-41 | RedditTab.tsx:33-39 读源断言参数表与补 0 | 生效 |
| AC-EL-OFC-RDT-002 | 专库卡头计数 | 标签 | h2 动态总数 | 「Reddit 专库」sub「共 {int(total)} 位达人 · 仅站内联系方式,只读浏览」;RedditTab.tsx:53 | RedditTab.tsx:53 读源断言计数式逐字 | 生效 |
| AC-EL-OFC-RDT-003 | 只读口径说明 | 容器 | 库定位文案 | 说明段:Reddit 达人只有站内触达(私信/评论)无邮箱/IM/社交,单独成库不进筛选打标体系,点达人名跳主页发起私信;RedditTab.tsx:54-57 | RedditTab.tsx:55-57 读源断言口径文案 | 生效 |
| AC-EL-OFC-RDT-004 | 错误条 | 容器 | API 失败提示 | err 非空显 div.error role=alert;RedditTab.tsx:51 | RedditTab.tsx:51 读源断言条件渲染 | 生效 |
| AC-EL-OFC-RDT-005 | 国家选择器 | 选择器 | country 筛选 | 首项「国家不限」+facets.countries「{value}({count})」;RedditTab.tsx:59-62 | RedditTab.tsx:60-61 读源断言选项源 | 生效 |
| AC-EL-OFC-RDT-006 | 类目选择器 | 选择器 | raw_cat 筛选 | 首项「类目不限」+facets.raw_categories;RedditTab.tsx:63-66 | RedditTab.tsx:64-65 读源断言 facet 键名 | 生效 |
| AC-EL-OFC-RDT-007 | 粉丝下限输入 | 输入 | fmin 筛选 | number placeholder「粉丝下限」maxWidth 110,变更即筛回第 1 页;RedditTab.tsx:67-68 | RedditTab.tsx:67-68 读源断言即时筛选 | 生效 |
| AC-EL-OFC-RDT-008 | 粉丝上限输入 | 输入 | fmax 筛选 | number placeholder「粉丝上限」maxWidth 110;RedditTab.tsx:69-70 | RedditTab.tsx:69-70 读源断言即时筛选 | 生效 |
| AC-EL-OFC-RDT-009 | 昵称搜索输入 | 输入 | search 暂存框 | placeholder「昵称搜索」maxWidth 220;仅提交(form onSubmit)才写入 query 触发查询,输入本身不触发;RedditTab.tsx:71-73 | RedditTab.tsx:72-73 读源断言提交制搜索 | 生效 |
| AC-EL-OFC-RDT-010 | 排序选择器 | 选择器 | sort 二选 | followers=按粉丝数(默认)/name=按昵称;RedditTab.tsx:28,74-76 | RedditTab.tsx:28,75 读源断言默认值 | 生效 |
| AC-EL-OFC-RDT-011 | 搜索按钮 | 按钮 | 提交搜索 | type=submit「搜索」→回第 1 页+query=search;RedditTab.tsx:72,77 | RedditTab.tsx:77 读源断言提交行为 | 生效 |
| AC-EL-OFC-RDT-012 | 重置筛选按钮 | 按钮 | 清全部条件 | 「重置筛选」→country/rawCat/fmin/fmax/search/query 全清+回第 1 页(sort 保留);RedditTab.tsx:43-46,109 | RedditTab.tsx:44-45 读源断言清空范围与 sort 不清 | 生效 |
| AC-EL-OFC-RDT-013 | Reddit 列·达人 | 列 | 表头「达人」 | name 渲染 a 外链 r.url(新窗 noreferrer 品牌色)——触达入口;RedditTab.tsx:89,94-96 | RedditTab.tsx:95 读源断言外链指向 r.url | 生效 |
| AC-EL-OFC-RDT-014 | Reddit 列·粉丝 | 列 | 表头「粉丝」 | 右对齐 num,subs!=null 显 int 千分位否则「—」;RedditTab.tsx:89,97 | RedditTab.tsx:97 读源断言千分位与空值 | 生效 |
| AC-EL-OFC-RDT-015 | Reddit 列·国家 | 列 | 表头「国家」 | muted 显 country,空「—」;RedditTab.tsx:89,98 | RedditTab.tsx:98 读源断言兜底 | 生效 |
| AC-EL-OFC-RDT-016 | Reddit 列·类目 | 列 | 表头「类目」 | muted 显 category,空「—」;RedditTab.tsx:89,99 | RedditTab.tsx:99 读源断言兜底 | 生效 |
| AC-EL-OFC-RDT-017 | Reddit 列·语言 | 列 | 表头「语言」 | muted 显 language,空「—」;RedditTab.tsx:89,100 | RedditTab.tsx:100 读源断言兜底 | 生效 |
| AC-EL-OFC-RDT-018 | Reddit 列·活跃度 | 列 | 表头「活跃度」 | 右对齐 num,activity!=null 显原值否则「—」;RedditTab.tsx:89,101 | RedditTab.tsx:101 读源断言兜底 | 生效 |
| AC-EL-OFC-RDT-019 | Reddit 空态 | 空态 | 无匹配行 | items 空 colSpan 6「无匹配达人」padding 28;RedditTab.tsx:104 | RedditTab.tsx:104 读源断言空态文案 | 生效 |
| AC-EL-OFC-RDT-020 | Reddit 加载态 | 空态 | 加载占位 | !data && !err 显「加载中…」;RedditTab.tsx:83 | RedditTab.tsx:83 读源断言双条件占位 | 生效 |
| AC-EL-OFC-RDT-021 | Reddit 分页 | 按钮 | 计数+翻页 | 「共 {int(total)} 条 · 第 {data.page} / {pages} 页」+上一页/下一页(page≤1/page≥pages 禁用);RedditTab.tsx:108-113 | RedditTab.tsx:110-112 读源断言计数与双侧禁用 | 生效 |
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-001 | GET /api/promotion/projects | 端点 | 项目列表加载 | 挂载即拉(useEffect :34);响应 {items:Project[]};失败置空数组(:32)不报错 | 读源 ProjectsTab.tsx:31-34 | 生效 |
| AC-EL-OFC-PRJ-002 | DELETE /api/promotion/projects/{id} | 端点 | 删除项目 | 危险确认 :37「该项目及其下所有达人关联与文案将一并删除。」;成功 toast「已删除」回列表重拉(:38-39) | 读源 ProjectsTab.tsx:36-40 | 生效 |
| AC-EL-OFC-PRJ-003 | POST /api/promotion/projects | 端点 | 新建项目 | 载荷 {name,product_link,discount_code,product_desc} 全 trim(:91);name 空前置拒绝 :88「项目名必填」 | 读源 ProjectsTab.tsx:87-95 | 生效 |
| AC-EL-OFC-PRJ-004 | GET /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-005 | POST /api/promotion/project-kols/{pkid}/status | 端点 | 行内状态流转 | 载荷 {status};行内下拉触发(:207-212);成功重拉列表(:134-137) | 读源 ProjectsTab.tsx:134-137 | 生效 |
| AC-EL-OFC-PRJ-006 | POST /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-007 | GET /api/promotion/projects/{id}/export | 端点 | 导出 CSV | 响应 {filename,csv};前端 BOM+Blob 触发下载(:148-151);toast「已导出」 | 读源 ProjectsTab.tsx:145-153 | 生效 |
| AC-EL-OFC-PRJ-008 | GET /api/promotion/kol?kind=channel&q= | 端点 | 加入达人数据源 | AddKols 面板拉全局渠道库(:242);响应 items {id,name,platform,subs,email};失败置空(:243) | 读源 ProjectsTab.tsx:240-245 | 生效 |
| AC-EL-OFC-PRJ-009 | POST /api/promotion/projects/{id}/kols/add | 端点 | 勾选加入项目 | 载荷 {kol_ids:[...]}(:256);响应 {added} → toast「已加入 N 位」;零选拒绝 :253「先勾选达人」 | 读源 ProjectsTab.tsx:252-260 | 生效 |
| AC-EL-OFC-PRJ-010 | GET /api/promotion/project-kols/{pk_id}/content | 端点 | 文案抽屉加载 | 响应 {content};编辑态初值 manual_* 优先回退 AI 字段(:306-308);失败仅停 loading(:310) | 读源 ProjectsTab.tsx:302-311 | 生效 |
| AC-EL-OFC-PRJ-011 | PUT /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 | 生效 |
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-001 | GET /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-002 | POST /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-003 | GET /api/promotion/categories | 端点 | 类目管理列表 | CatManager 挂载拉取(:287-290);失败静默 | 读源 LibraryTab.tsx:287-290 | 生效 |
| AC-EL-OFC-LIB-004 | POST /api/promotion/categories | 端点 | 新增类目 | 载荷 {name,sort}(:296);name 空拒绝 :293「类目名必填」;成功后列表+facets 双刷新(:297) | 读源 LibraryTab.tsx:292-299 | 生效 |
| AC-EL-OFC-LIB-005 | DELETE /api/promotion/categories/{id} | 端点 | 删除类目 | 危险确认 :301「「{n}」?达人与该类目的映射将一并移除。」;成功双刷新(:302-303) | 读源 LibraryTab.tsx:300-304 | 生效 |
| AC-EL-OFC-LIB-006 | GET /api/promotion/channel-dict | 端点 | 渠道字典列表 | DictManager 挂载拉取(:348-351);失败静默 | 读源 LibraryTab.tsx:348-351 | 生效 |
| AC-EL-OFC-LIB-007 | POST /api/promotion/channel-dict | 端点 | 新增渠道 | 载荷 {value,label||value,sort:999}(:357);value 空拒绝 :354「value 必填(小写字母/数字)」 | 读源 LibraryTab.tsx:353-360 | 生效 |
| AC-EL-OFC-LIB-008 | PUT /api/promotion/channel-dict/{id} | 端点 | 渠道启停 | 载荷 {is_active:!active}(:362);成功重拉(:363) | 读源 LibraryTab.tsx:361-364 | 生效 |
| AC-EL-OFC-LIB-009 | DELETE /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-012 | FilterRow 多选行组件 | 容器 | 筛选行骨架 | 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-019 | suppression 选择器 | 选择器 | 抑制名单过滤 | 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 | 生效 |
TemplatesTab 列表(:33-111)+ TplEditor 编辑器(:113-265);面板级归属见 AC-EL-OFF-050。变量渲染口径在 API 一份实现、前端只做插入与展示(:3-4 注释);变量中文标签 VAR_LABELS 七变量(:24-27)。
| ID | 元素 | 类型 | 描述 | 定义(数据来源·口径·边界) | 验证方法 | 状态 |
|---|---|---|---|---|---|---|
| AC-EL-OFC-TPL-001 | GET /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-002 | DELETE /api/promotion/email-templates/{id} | 端点 | 删除模板 | 危险确认 :51「「{name}」?」;删除正在编辑项时同步关编辑器(:54) | 读源 TemplatesTab.tsx:50-56 | 生效 |
| AC-EL-OFC-TPL-003 | PUT /api/promotion/email-templates/{tid} | 端点 | 编辑保存 | 载荷 {name,lang,subject,body,category,status}(:156,:159) | 读源 TemplatesTab.tsx:152-168 | 生效 |
| AC-EL-OFC-TPL-004 | POST /api/promotion/email-templates | 端点 | 新建保存 | 同载荷(:161);响应 {id} 并 setId(:162-163),保存后可继续预览 | 读源 TemplatesTab.tsx:159-164 | 生效 |
| AC-EL-OFC-TPL-005 | POST /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 | 生效 |
MailboxesTab 列表+编辑卡(:50-263);面板级归属见 AC-EL-OFF-054。R7 边界:平台只存储/测试/轮发/监控,不自动开箱不代购(:3-5 注释);密码 write-only——编辑留空=保留原凭据,任何接口不回明文(:4-5);健康徽标来自 health jsonb(:5)。
| ID | 元素 | 类型 | 描述 | 定义(数据来源·口径·边界) | 验证方法 | 状态 |
|---|---|---|---|---|---|---|
| AC-EL-OFC-MBX-001 | GET /api/promotion/mailboxes | 端点 | 列表加载 | 响应 {total,items:Mb[]}(:61);Mb 含 has_smtp_pass/has_imap_pass 布尔而非明文(:21-22);失败静默 | 读源 MailboxesTab.tsx:60-63 | 生效 |
| AC-EL-OFC-MBX-002 | POST /api/promotion/mailboxes | 端点 | 新增邮箱 | 载荷=form 全量 15 字段(:85,Form :28-33) | 读源 MailboxesTab.tsx:80-94 | 生效 |
| AC-EL-OFC-MBX-003 | PUT /api/promotion/mailboxes/{id} | 端点 | 编辑邮箱 | 编辑预填密码置空(:72-73)→留空=保留原凭据;toast 条件「已保存(凭据已更新)」当任一密码非空(:89) | 读源 MailboxesTab.tsx:68-77,80-94 | 生效 |
| AC-EL-OFC-MBX-004 | POST /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-005 | DELETE /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 | 生效 |
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-001 | GET /api/promotion/send-tasks | 端点 | 任务列表加载 | 响应 {items:Task[]}(:50);失败 setErr(:52);15s 轮询复用此调用(:72-76) | 读源 SendTasksTab.tsx:49-54,72-76 | 生效 |
| AC-EL-OFC-SND-002 | GET /api/promotion/email-templates(下拉) | 端点 | 模板下拉源 | 默认选 status=active 首个否则第一个(:56-59) | 读源 SendTasksTab.tsx:55-62 | 生效 |
| AC-EL-OFC-SND-003 | GET /api/promotion/mailboxes(下拉) | 端点 | 邮箱池数据源 | 拉全量供池 pills(:61,:135-146) | 读源 SendTasksTab.tsx:61,135-146 | 生效 |
| AC-EL-OFC-SND-004 | GET /api/promotion/segments | 端点 | 分群下拉源 | segVer 变化触发刷新(建/删分群联动 :63-70);选中项消失回退首项(:67) | 读源 SendTasksTab.tsx:63-70 | 生效 |
| AC-EL-OFC-SND-005 | POST /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-006 | POST /api/promotion/send-tasks/{tid}/{action} | 端点 | 状态动作 | action∈launch/pause/resume(:95);toast 已发起/已暂停/已恢复 | 读源 SendTasksTab.tsx:93-99 | 生效 |
| AC-EL-OFC-SND-007 | DELETE /api/promotion/send-tasks/{tid} | 端点 | 删除任务 | 危险确认 :102「「{n}」?其发送明细将一并删除。」 | 读源 SendTasksTab.tsx:101-105 | 生效 |
| AC-EL-OFC-SND-008 | GET /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-032 | sending 轮询 | 标签 | 进度刷新口径 | 存在 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 | 生效 |
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-001 | GET /api/promotion/submissions | 端点 | 投稿回读 | 响应 {items:Sub[]}(:27);失败置空(:27) | 读源 TasksTab.tsx:26-30 | 生效 |
| AC-EL-OFC-TSK-002 | GET /api/promotion/orders | 端点 | 投放申请回读 | 响应 {items:POrder[]}(:28);失败置空 | 读源 TasksTab.tsx:26-30 | 生效 |
| AC-EL-OFC-TSK-003 | POST /api/promotion/orders/{oid}/approve | 端点 | 审批动作 | 载荷 {action:approve|reject}(:32);toast 已批准/已拒绝;服务端护栏见 OFF-046 | 读源 TasksTab.tsx:31-34 | 生效 |
| AC-EL-OFC-TSK-004 | GET /api/promotion/tasks | 端点 | 任务列表加载 | 响应 {items,stats{pending,blocked,in_progress}}(:82);失败回退零值 | 读源 TasksTab.tsx:81-84 | 生效 |
| AC-EL-OFC-TSK-005 | POST /api/promotion/tasks/{id}/status | 端点 | 任务状态流转 | 载荷 {status}(:87);成功重拉 | 读源 TasksTab.tsx:86-89 | 生效 |
| AC-EL-OFC-TSK-006 | POST /api/promotion/tasks | 端点 | 新增任务 | 载荷 {action,product_key}(:93);action 空前端拦截(:91) | 读源 TasksTab.tsx:90-96 | 生效 |
| AC-EL-OFC-TSK-007 | DELETE /api/promotion/tasks/{id} | 端点 | 删除任务 | useConfirm「删除该任务?」danger confirmText「删除」(:98);失败静默无 toast | 读源 TasksTab.tsx:97-100 | 生效 |
| AC-EL-OFC-TSK-008 | GET /api/promotion/kol | 端点 | KOL 三库检索 | kind/channel|site|high + q + platform(:179-181);响应 {items,counts,platforms} | 读源 TasksTab.tsx:178-183 | 生效 |
| AC-EL-OFC-TSK-009 | POST /api/promotion/kol/{kind}/{kid}/outreach | 端点 | 外联状态写 | 载荷 {outreach_status}(:186);site/high 行内下拉触发;kind=channel 服务端 400 见 OFF-061 | 读源 TasksTab.tsx:185-188 | 生效 |
| AC-EL-OFC-TSK-010 | GET /api/promotion/kol-analysis | 端点 | 分析四表 | 响应 {platform,tiers,categories,countries} 四行集(:291);失败回退四空数组(:292) | 读源 TasksTab.tsx:288-293 | 生效 |
| AC-EL-OFC-TSK-011 | KPI 三卡 | 标签 | 任务计数 | 待办任务/进行中/被卡任务(: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-037 | KOL 四页签 | 选择器 | 库切换 | 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-056 | KOL 底注 | 标签 | 同步口径声明 | 「资源库同步自公司 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 | 「平台效果分析」表 | 图表 | 分析卡 1 | h2 sub「互动率 = (均赞+均评)/均播 · 100K+ 占比按订阅」(:313);7 列 平台/KOL 数/平均粉丝/总粉丝/平均播放/互动率%/100K+ 占比%(:314-315);行集=d.platform | 读源 TasksTab.tsx:312-316 | 生效 |
| AC-EL-OFC-TSK-059 | 「粉丝量级性价比」表 | 图表 | 分析卡 2 | 5 列 量级/KOL 数/平均粉丝/平均播放/平均最高播放(:319-320);行集=d.tiers | 读源 TasksTab.tsx:317-321 | 生效 |
| AC-EL-OFC-TSK-060 | 「品类分布」表 | 图表 | 分析卡 3 | 4 列 品类/KOL 数/平均粉丝/平均播放(:324);行集=d.categories | 读源 TasksTab.tsx:322-325 | 生效 |
| AC-EL-OFC-TSK-061 | 「国家分布」表 | 图表 | 分析卡 4 | 4 列 国家/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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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-G01 | API 端点组·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) | 生效 |
| 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 面 | KPI | SA(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(拍板①) | chip | header 右缘:Amazon 净利环比 MM←MM 原值对;Noon 每市场一枚本币原值对;不可比=灰 chip 带因(无对照月/品牌覆盖不齐/缺 COGS/进行中月不出) | 推导源=months=12 的 /api/finance/full(与档位解耦——环比本就完整月对完整月,进行中月永不入对);完整月判定 mon<当月;不算 %;与财务页环比如出一辙 | e2e 断言大盘环比 chip 数字 ≡ 财务页环比行逐位(已锁 13,761→21,897 实证) | 生效 |
| AC-EL-DASH-008 | SKU 养家/亏损 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/id44 | e2e 断言行 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=inventory | e2e 断言 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-013 | PO 采购域卡 | 卡 | summary 各状态计数(≤4 态)+ 滞留>7 天 KPI(有则);状态灯=po_aging 黄 | /api/po/list?brand&page_size=1(PO 页同源)+铃铛 po_aging 同源(>7 天未推进);mod=inventory | e2e 断言状态计数与端点 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 面无营收数(月度结算口径)不显示营收 KPI | e2e 断言今日订单与端点 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) | ECharts | Amazon:近 30 天日订单量柱+日销售额线(USD);Noon:近 12 月月订单量柱+月 GMV 线(本币)+「Noon=月度结算口径(无日粒度销售面)」披露注 | Amazon=/api/dashboard/charts?platform=amazon&days=30 墙图 dailyCnt/dailyRev 双序列同源(工作台墙一源);Noon=months=12 full.noon 按月 Σ(#56 同市场同币);进视口才 init | e2e 断言 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 零改动复跑全绿 | 生效 |
| 方法 | 路径 | 路由域 | 作用 | 尺子锚(§11) | 注册表 |
|---|---|---|---|---|---|
| GET | /api/ads/advice | ads | Ads Advice List | AC-EL-ADS-019 | ✓在册 |
| GET | /api/ads/advice/{aid}/checkins | ads | Ads Advice Checkins | AC-EL-ADS-038 | ✓在册 |
| POST | /api/ads/advice/{aid}/decision | ads | Ads Advice Decide | AC-EL-ADS-034 | — |
| GET | /api/ads/analysis | ads | Ads Analysis | AC-EL-ADS-048 | ✓在册 |
| POST | /api/ads/campaign-ops | ads | Ads Campaign Ops | AC-EL-ADS-066 | — |
| GET | /api/ads/campaign-ops | ads | Ads Campaign Ops History | AC-EL-ADS-066 | ✓在册 |
| GET | /api/ads/charts | ads | Ads Charts | AC-EL-ADS-077 | ✓在册 |
| GET | /api/ads/dayparting | ads | Ads Dayparting | AC-EL-ADS-111 | ✓在册 |
| GET | /api/ads/imports | ads | Ads Imports List | AC-EL-ADS-160 | ✓在册 |
| POST | /api/ads/imports/recompute | ads | Ads Imports Recompute | AC-EL-ADS-163 | — |
| GET | /api/ads/keyword-bids | ads | Ads Keyword Bids | AC-EL-ADS-104 | ✓在册 |
| GET | /api/ads/monitor | ads | Ads Monitor List | AC-EL-ADS-045 | ✓在册 |
| GET | /api/ads/morning | ads | Ads Morning | AC-EL-ADS-009 | ✓在册 |
| GET | /api/ads/neg-keywords | ads | Ads Neg Keywords List | AC-EL-ADS-133 AC-EL-ADS-134 | ✓在册 |
| POST | /api/ads/neg-keywords | ads | Ads Neg Keyword Add | AC-EL-ADS-133 AC-EL-ADS-134 | — |
| PATCH | /api/ads/neg-keywords/{nid} | ads | Ads Neg Keyword Patch | AC-EL-ADS-135 | — |
| DELETE | /api/ads/neg-keywords/{nid} | ads | Ads Neg Keyword Delete | AC-EL-ADS-135 | — |
| POST | /api/ads/noon-keyword-bid | ads | Ads Noon Keyword Bid | AC-EL-ADS-140 | — |
| POST | /api/ads/noon-recommendations/{rec_id}/adopt | ads | Ads Noon Rec Adopt | AC-EL-ADS-144 | — |
| GET | /api/ads/ops | ads | Ads Ops List | AC-EL-ADS-G01 | ✓在册 |
| POST | /api/ads/ops/{aid}/done | ads | Ads Ops Done | AC-EL-ADS-014 AC-EL-ADS-037 | — |
| GET | /api/ads/optlog | ads | Ads Optlog | AC-EL-ADS-126 | ✓在册 |
| POST | /api/ads/optlog/{log_id}/feedback | ads | Ads Optlog Feedback | AC-EL-ADS-131 | — |
| GET | /api/ads/platform | ads | Ads Platform | AC-EL-ADS-058 | ✓在册 |
| GET | /api/ads/placement-rows | ads | Ads Placement Rows | AC-EL-ADS-102 | ✓在册 |
| GET | /api/ads/price-suggestions | ads | Ads Price Suggestions | AC-EL-PRD-019 | ✓在册 |
| POST | /api/ads/reattribute | ads | Ads Reattribute | AC-EL-ADS-164 | — |
| GET | /api/ads/recommendations | ads | Ads Recommendations List | AC-EL-ADS-115 | ✓在册 |
| POST | /api/ads/recommendations/run | ads | Ads Recommendations Run | AC-EL-ADS-119 | — |
| POST | /api/ads/recommendations/{rid}/decision | ads | Ads Recommendation Decide | AC-EL-ADS-122 | — |
| POST | /api/ads/recommendations/{rid}/execute | ads | Ads Recommendation Execute | AC-EL-ADS-123 | — |
| GET | /api/ads/rename | ads | Ads Rename Plan | AC-EL-ADS-G01 | ✓在册 |
| POST | /api/ads/rename/apply | ads | Ads Rename Apply | AC-EL-ADS-G01 | — |
| GET | /api/ads/rename/family | ads | Ads Rename Family List | AC-EL-ADS-G01 | ✓在册 |
| POST | /api/ads/rename/family | ads | Ads Rename Family Upsert | AC-EL-ADS-G01 | — |
| GET | /api/ads/rule-config | ads | Ads Rule Config Get | AC-EL-ADS-165 AC-EL-ADS-166 | ✓在册 |
| POST | /api/ads/rule-config | ads | Ads Rule Config Save | AC-EL-ADS-165 AC-EL-ADS-166 | — |
| DELETE | /api/ads/rule-config/{key} | ads | Ads Rule Config Delete | AC-EL-ADS-168 | — |
| GET | /api/ads/search-terms | ads | Ads Search Terms | AC-EL-ADS-093 | ✓在册 |
| GET | /api/ads/sku-daily | ads | Ads Sku Daily | AC-EL-ADS-G01 | ✓在册 |
| GET | /api/ads/sources | ads | Ads Sources | AC-EL-ADS-151 | ✓在册 |
| POST | /api/ads/upload | ads | Ads Upload | AC-EL-ADS-157 | — |
| POST | /api/ads/upload/preview | ads | Ads Upload Preview | AC-EL-ADS-155 | — |
| POST | /api/ai/adcopy | ai | Ai Adcopy | AC-EL-AI-005 | — |
| POST | /api/ai/ads-optimize | ai | Ai Ads Optimize | AC-EL-AI-006 | — |
| POST | /api/ai/ask | ai | Ai Ask | AC-EL-AI-G01 | — |
| POST | /api/ai/insight | ai | Ai Insight | AC-EL-AI-003 | — |
| POST | /api/ai/page-chat | ai | Ai Page Chat | AC-EL-CMP-032 | — |
| POST | /api/ai/sourcing | ai | Ai Sourcing | AC-EL-SRC-23 AC-EL-AI-004 | — |
| POST | /api/ai/sourcing-agent | ai | Ai Sourcing Agent | AC-EL-SRC-68 | — |
| DELETE | /api/aplus/docs/{did} | aplus | Aplus Doc Del | AC-EL-LST-143 | — |
| GET | /api/aplus/documents | aplus | Aplus Documents | AC-EL-LST-143 | ✓在册 |
| POST | /api/aplus/draft | aplus | Aplus Draft Save | AC-EL-LST-139 | — |
| GET | /api/aplus/history | aplus | Aplus History List | AC-EL-LST-144 | ✓在册 |
| GET | /api/aplus/media | aplus | Aplus Media List | AC-EL-LST-141 | ✓在册 |
| POST | /api/aplus/media | aplus | Aplus Media Add | AC-EL-LST-141 | — |
| DELETE | /api/aplus/media/{mid} | aplus | Aplus Media Del | AC-EL-LST-142 | — |
| GET | /api/aplus/meta | aplus | Aplus Meta | AC-EL-LST-135 | ✓在册 |
| POST | /api/auth/login | auth | Login | AC-EL-AUTH-020 | — |
| POST | /api/auth/logout | auth | Logout | AC-EL-SHELL-011 | — |
| POST | /api/auth/logout-all | auth | Auth Logout All | AC-EL-ACC-019 | — |
| POST | /api/auth/password | auth | Auth Password | AC-EL-ACC-010 | — |
| POST | /api/auth/register | auth | Register | AC-EL-AUTH-011 | — |
| GET | /api/auth/registration-status | auth | Registration Status | AC-EL-AUTH-001 AC-EL-CMP-025 | 豁免(exclude) |
| POST | /api/auth/resend | auth | Resend | AC-EL-AUTH-014 | — |
| GET | /api/auth/sessions | auth | Auth Sessions | AC-EL-ACC-013 AC-EL-ACC-018 | 豁免(exclude) |
| GET | /api/auth/verify | auth | Verify | AC-EL-AUTH-027 | 豁免(exclude) |
| GET | /api/backfill/limits | backfill | Backfill Limits | AC-EL-BKF-005 | 豁免(exclude) |
| POST | /api/backfill/runs | backfill | Backfill Create | AC-EL-BKF-013 AC-EL-BKF-015 | — |
| GET | /api/backfill/runs | backfill | Backfill List | AC-EL-BKF-013 AC-EL-BKF-015 | 豁免(exclude) |
| DELETE | /api/backfill/runs/{run_id} | backfill | Backfill Delete Dryrun | AC-EL-BKF-026 | — |
| POST | /api/backfill/runs/{run_id}/cancel | backfill | Backfill Cancel | AC-EL-BKF-026 | — |
| POST | /api/billing/checkout | billing | Billing Checkout | AC-EL-BIL-021 | — |
| GET | /api/billing/modules | billing | Billing Modules | AC-EL-BIL-012 | ✓在册 |
| POST | /api/billing/modules/toggle | billing | Billing Module Toggle | AC-EL-BIL-014 | — |
| GET | /api/billing/plans | billing | Billing Plans | AC-EL-BIL-016 | ✓在册 |
| GET | /api/billing/status | billing | Billing Status | AC-EL-BIL-005 | ✓在册 |
| POST | /api/billing/webhook | billing | Billing Webhook | AC-EL-BILLING-G01 | — |
| GET | /api/brandboard/country-sku | brandboard | Brandboard Country Sku | AC-EL-BRD-039 AC-EL-CMP-037 | ✓在册 |
| GET | /api/brandboard/noon | brandboard | Brandboard Noon | AC-EL-BRDN-006 AC-EL-BRDN-015 AC-EL-CMP-043 | ✓在册 |
| GET | /api/brandboard/orders | brandboard | Brandboard Orders | AC-EL-BRD-022 AC-EL-CMP-037 | ✓在册 |
| GET | /api/brandboard/product-drill | brandboard | Brandboard Product Drill | AC-EL-PRD-028 AC-EL-PRD-040 | ✓在册 |
| GET | /api/collab/files/{fid}/raw | collab | Upload File Raw | AC-EL-LST-148 | ✓在册 |
| GET | /api/dashboard/alerts | dashboard | Dashboard Alerts | AC-EL-HOME-05 | ✓在册 |
| GET | /api/dashboard/chart-order | dashboard | Chart Order Get | AC-EL-HOME-25 | ✓在册 |
| PUT | /api/dashboard/chart-order | dashboard | Chart Order Put | AC-EL-HOME-25 | — |
| GET | /api/dashboard/charts | dashboard | Dashboard Charts | AC-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/filters | dashboard | Dashboard Filters | AC-EL-HOME-01 | ✓在册 |
| GET | /api/dashboard/kpi | dashboard | Dashboard Kpi | AC-EL-HOME-38 | ✓在册 |
| GET | /api/dashboard/kpi-cards | dashboard | Kpi Cards Get | AC-EL-HOME-11 | ✓在册 |
| PUT | /api/dashboard/kpi-cards | dashboard | Kpi Cards Put | AC-EL-HOME-11 | — |
| GET | /api/dashboard/merged-kpi | dashboard | Dashboard Merged Kpi | AC-EL-HOME-15 | ✓在册 |
| GET | /api/dashboard/sku-matrix | dashboard | Dashboard Sku Matrix | AC-EL-DASHBOARD-G01 | ✓在册 |
| GET | /api/db/table/{table_name} | db | Db Table Detail | AC-EL-DB-027 | ✓在册 |
| GET | /api/db/table/{table_name}/rows | db | Db Table Rows | AC-EL-DB-028 | ✓在册 |
| GET | /api/db/tables | db | Db Tables | AC-EL-DB-004 AC-EL-DB-025 | ✓在册 |
| GET | /api/dictionary | dictionary | Data Dictionary | AC-EL-DIC-006 AC-EL-DIC-007 AC-EL-DIC-018 AC-EL-DIC-019 | ✓在册 |
| GET | /api/documents/tree | documents | Documents Tree | AC-EL-DOC-020 AC-EL-DOC-021 AC-EL-LEGAL-034 | ✓在册 |
| GET | /api/finance/amazon-aging | finance | Amazon Inventory Aging | AC-EL-FINANCE-G01 | ✓在册 |
| GET | /api/finance/amazon-fees | finance | Amazon Fees Breakdown | AC-EL-FINANCE-G01 | ✓在册 |
| GET | /api/finance/amazon-rankings-analytics | finance | Amazon Rankings Analytics | AC-EL-FINANCE-G01 | ✓在册 |
| GET | /api/finance/full | finance | Finance Full | AC-EL-FINANCE-G01 | ✓在册 |
| GET | /api/finance/kpi-wall | finance | Finance Kpi Wall | AC-EL-FIN-C-001 | ✓在册 |
| GET | /api/finance/monthly | finance | Finance Monthly Pl | AC-EL-FIN-C-157 | ✓在册 |
| GET | /api/finance/noon-ops | finance | Finance Noon Ops | AC-EL-FIN-C-133 | ✓在册 |
| GET | /api/finance/noon-pnl | finance | Finance Noon Pnl | AC-EL-FINANCE-G01 | ✓在册 |
| GET | /api/finance/noon-sku | finance | Finance Noon Sku | AC-EL-FIN-C-050 | ✓在册 |
| GET | /api/finance/onno | finance | Finance Onno | AC-EL-FINANCE-G01 | ✓在册 |
| GET | /api/finance/product-pl | finance | Finance Product Pl | AC-EL-FINANCE-G01 | ✓在册 |
| GET | /api/finance/profit-matrix | finance | Finance Profit Matrix | AC-EL-FINANCE-G01 | ✓在册 |
| GET | /api/finance/sku-profit | finance | Finance Sku | AC-EL-FINANCE-G01 | ✓在册 |
| GET | /api/finance/summary | finance | Finance Summary | AC-EL-FINANCE-G01 | ✓在册 |
| GET | /api/glossary | glossary | Glossary | AC-EL-DIC-020 AC-EL-PIPE-043 | ✓在册 |
| GET | /api/health | health | Health | AC-EL-HEALTH-G01 | 豁免(exclude) |
| GET | /api/inv/docs | inv | Inv Docs | AC-EL-INV-030 AC-EL-INV-040 | ✓在册 |
| POST | /api/inv/docs | inv | Inv Doc Create | AC-EL-INV-030 AC-EL-INV-040 | — |
| GET | /api/inv/docs/{did} | inv | Inv Doc Detail | AC-EL-INV-032 | ✓在册 |
| POST | /api/inv/docs/{did}/approve | inv | Inv Doc Approve | AC-EL-INV-033 | — |
| POST | /api/inv/docs/{did}/cancel | inv | Inv Doc Cancel | AC-EL-INV-034 | — |
| GET | /api/inv/ledger | inv | Inv Ledger | AC-EL-INV-044 | ✓在册 |
| GET | /api/inv/products | inv | Inv Products List | AC-EL-INV-046 | ✓在册 |
| POST | /api/inv/products | inv | Inv Product Upsert | AC-EL-INV-046 | — |
| GET | /api/inv/report | inv | Inv Report | AC-EL-INV-045 | ✓在册 |
| GET | /api/inv/stock | inv | Inv Stock | AC-EL-INV-042 | ✓在册 |
| GET | /api/inv/stocktake/plan | inv | Inv Stocktake Plan | AC-EL-INV-043 | ✓在册 |
| GET | /api/inv/warehouses | inv | Inv Warehouses | AC-EL-INV-038 AC-EL-INV-047 | ✓在册 |
| POST | /api/inv/warehouses | inv | Inv Wh Create | AC-EL-INV-038 AC-EL-INV-047 | — |
| GET | /api/inventory/alert | inventory | Inventory Alert | AC-EL-INV-020 AC-EL-PO-006 AC-EL-PO-012 AC-EL-PO-040 | ✓在册 |
| GET | /api/inventory/health | inventory | Inventory Health | AC-EL-INV-009 | ✓在册 |
| GET | /api/inventory/matrix | inventory | Inventory Matrix | AC-EL-INV-058 | ✓在册 |
| GET | /api/layout | layout | Get Layout | AC-EL-CMP-013 | ✓在册 |
| POST | /api/layout | layout | Save Layout | AC-EL-CMP-013 | — |
| POST | /api/layout/reset | layout | Reset Layout | AC-EL-CMP-013 | — |
| GET | /api/listing/events | listing | List Events | AC-EL-LST-150 | ✓在册 |
| GET | /api/listing/export | listing | Export | AC-EL-LST-087 | ✓在册 |
| GET | /api/listing/health | listing | Listing Health | AC-EL-LST-093 | ✓在册 |
| POST | /api/listing/import-results | listing | Import Results | AC-EL-LST-091 | — |
| GET | /api/listing/meta | listing | Listing Meta | AC-EL-LST-004 AC-EL-LST-114 | ✓在册 |
| POST | /api/listing/models/spec | listing | Upload Spec Model | AC-EL-LST-019 | — |
| GET | /api/listing/noon/categories | listing | Noon Categories | AC-EL-LST-115 | ✓在册 |
| GET | /api/listing/noon/category-attrs | listing | Noon Category Attrs Ep | AC-EL-LST-117 | ✓在册 |
| GET | /api/listing/noon/content/{tid} | listing | Noon Content Status | AC-EL-LST-125 | ✓在册 |
| POST | /api/listing/noon/task | listing | Noon Task Save | AC-EL-LST-122 | — |
| GET | /api/listing/pt-markets | listing | Listing Pt Markets | AC-EL-LST-033 | ✓在册 |
| GET | /api/listing/pt-schema | listing | Listing Pt Schema | AC-EL-LST-151 | ✓在册 |
| GET | /api/listing/pt-search | listing | Listing Pt Search | AC-EL-LST-034 | ✓在册 |
| GET | /api/listing/skus-by-model | listing | Listing Skus By Model | AC-EL-LST-009 | ✓在册 |
| POST | /api/listing/specs | listing | Upload Spec | AC-EL-LST-067 AC-EL-LST-150 | — |
| GET | /api/listing/specs | listing | List Specs | AC-EL-LST-067 AC-EL-LST-150 | ✓在册 |
| POST | /api/listing/tasks | listing | Create Task | AC-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/tasks | listing | List Tasks | AC-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/batch | listing | Batch Tasks | AC-EL-LST-032 | — |
| GET | /api/listing/tasks/{tid} | listing | Get Task | AC-EL-LST-023 AC-EL-LST-030 AC-EL-LST-152 | ✓在册 |
| PUT | /api/listing/tasks/{tid} | listing | Edit Task | AC-EL-LST-023 AC-EL-LST-030 AC-EL-LST-152 | — |
| DELETE | /api/listing/tasks/{tid} | listing | Delete Task | AC-EL-LST-023 AC-EL-LST-030 AC-EL-LST-152 | — |
| POST | /api/listing/tasks/{tid}/approve | listing | Approve | AC-EL-LISTING-G01 | — |
| POST | /api/listing/tasks/{tid}/bind-pt | listing | Bind Pt | AC-EL-LST-056 | — |
| POST | /api/listing/tasks/{tid}/generate | listing | Generate | AC-EL-LST-021 AC-EL-LST-046 | — |
| POST | /api/listing/tasks/{tid}/revert | listing | Revert | AC-EL-LISTING-G01 | — |
| POST | /api/listing/tasks/{tid}/submit | listing | Submit Task | AC-EL-LST-057 | — |
| GET | /api/logistics/appendix | logistics | Logistics Appendix | AC-EL-LOG-048 | ✓在册 |
| POST | /api/logistics/create | logistics | Logistics Create | AC-EL-LOG-034 | — |
| GET | /api/logistics/params | logistics | Logistics Params Get | AC-EL-LOG-037 AC-EL-LOG-042 | ✓在册 |
| POST | /api/logistics/params | logistics | Logistics Params Save | AC-EL-LOG-037 AC-EL-LOG-042 | — |
| GET | /api/logistics/pricing | logistics | Logistics Pricing | AC-EL-LOG-043 | ✓在册 |
| GET | /api/logistics/products | logistics | Logistics Products | AC-EL-LOG-031 | ✓在册 |
| GET | /api/logistics/shipments | logistics | Logistics Shipments List | AC-EL-LOG-003 | ✓在册 |
| POST | /api/logistics/shipments/import | logistics | Logistics Shipments Import | AC-EL-LOG-011 | — |
| GET | /api/mapping/api-fields | mapping | Mapping Api Fields | AC-EL-SET-036 | ✓在册 |
| GET | /api/mapping/edit | mapping | Mapping Edit Get | AC-EL-MAP-024 AC-EL-MAP-032 AC-EL-MAP-047 AC-EL-MAP-048 | ✓在册 |
| POST | /api/mapping/edit | mapping | Mapping Edit Save | AC-EL-MAP-024 AC-EL-MAP-032 AC-EL-MAP-047 AC-EL-MAP-048 | — |
| POST | /api/mapping/edit/export | mapping | Mapping Edit Export | AC-EL-MAP-038 AC-EL-MAP-040 | — |
| POST | /api/mapping/edit/import | mapping | Mapping Edit Import | AC-EL-MAP-042 AC-EL-MAP-049 | — |
| GET | /api/mapping/skus | mapping | Mapping Skus | AC-EL-MAP-002 AC-EL-MAP-004 AC-EL-MAP-047 AC-EL-MAP-048 | ✓在册 |
| GET | /api/matrix/charts | matrix | Get Matrix Charts | AC-EL-CMP-033 | ✓在册 |
| GET | /api/matrix/data | matrix | Get Matrix Data | AC-EL-CMP-033 | ✓在册 |
| GET | /api/matrix/dimensions | matrix | Get Dimensions | AC-EL-MATRIX-G01 | ✓在册 |
| POST | /api/mcp/keys | mcp | Create Key | AC-EL-MCP-G01 | — |
| GET | /api/mcp/keys | mcp | List Keys | AC-EL-MCP-G01 | ✓在册 |
| DELETE | /api/mcp/keys/{kid} | mcp | Revoke Key | AC-EL-MCP-G01 | — |
| GET | /api/metric-thresholds | metric-thresholds | Metric Thresholds | AC-EL-ADS-054 | ✓在册 |
| GET | /api/noon-inventory | noon-inventory | Noon Inventory | AC-EL-BRDN-013 AC-EL-CMP-043 AC-EL-INV-003 | ✓在册 |
| GET | /api/noon/catalog-sales | noon | Noon Catalog Sales | AC-EL-NOON-41 | ✓在册 |
| GET | /api/noon/coupons | noon | Noon Coupons | AC-EL-NOON-G01 | ✓在册 |
| GET | /api/noon/deal-skus | noon | Noon Deal Skus | AC-EL-NOON-G01 | ✓在册 |
| GET | /api/noon/deals | noon | Noon Deals | AC-EL-NOON-G01 | ✓在册 |
| GET | /api/noon/fees | noon | Noon Fees | AC-EL-ADS-145 AC-EL-INV-049 | ✓在册 |
| GET | /api/noon/keywords | noon | Noon Keywords | AC-EL-ADS-137 | ✓在册 |
| GET | /api/noon/offers | noon | Noon Offers | AC-EL-LST-110 AC-EL-INV-049 | ✓在册 |
| GET | /api/noon/rankings | noon | Noon Rankings | AC-EL-NOON-G01 | ✓在册 |
| GET | /api/noon/recommendations | noon | Noon Recommendations | AC-EL-ADS-141 | ✓在册 |
| GET | /api/noon/reviews | noon | Noon Reviews | AC-EL-RANK-062 | ✓在册 |
| GET | /api/noon/reviews-analytics | noon | Noon Reviews Analytics | AC-EL-NOON-29 | ✓在册 |
| GET | /api/noon/summary | noon | Noon Summary | AC-EL-NOON-03 AC-EL-CMP-046 AC-EL-FIN-C-101 | ✓在册 |
| POST | /api/noonops/asn/create | noonops | Asn Create | AC-EL-INV-054 | — |
| GET | /api/noonops/asn/eligible-items | noonops | Asn Eligible | AC-EL-NOONOPS-G01 | ✓在册 |
| POST | /api/noonops/asn/items | noonops | Asn Items | AC-EL-NOONOPS-G01 | — |
| POST | /api/noonops/asn/ledger-sync | noonops | Asn Ledger Sync Ep | AC-EL-NOONOPS-G01 | — |
| POST | /api/noonops/asn/schedule | noonops | Asn Schedule | AC-EL-NOONOPS-G01 | — |
| GET | /api/noonops/asn/shipments | noonops | Asn Shipments | AC-EL-NOONOPS-G01 | ✓在册 |
| GET | /api/noonops/asn/slots | noonops | Asn Slots | AC-EL-NOONOPS-G01 | ✓在册 |
| POST | /api/noonops/asn/status | noonops | Asn Status | AC-EL-NOONOPS-G01 | — |
| GET | /api/noonops/order/{order_nr}/customer | noonops | Noonops Customer | AC-EL-NOONOPS-G01 | ✓在册 |
| GET | /api/noonops/po/{po_nr} | noonops | Noonops Po | AC-EL-NOONOPS-G01 | ✓在册 |
| GET | /api/noonops/pricing | noonops | Noonops Pricing | AC-EL-NOONOPS-G01 | ✓在册 |
| POST | /api/noonops/pricing/set | noonops | Noonops Price Set | AC-EL-NOONOPS-G01 | — |
| POST | /api/noonops/stock/set | noonops | Noonops Stock Set | AC-EL-INV-056 | — |
| POST | /api/noonops/write | noonops | Noonops Write | AC-EL-NOONOPS-G01 | — |
| GET | /api/noonops/write-endpoints | noonops | Noonops Write List | AC-EL-NOONOPS-G01 | ✓在册 |
| GET | /api/notifications/summary | notifications | Notifications Summary | AC-EL-SHELL-003 | 豁免(exclude) |
| POST | /api/onboarding/brand | onboarding | Onboarding Brand | AC-EL-ONB-011 | — |
| POST | /api/onboarding/category | onboarding | Onboarding Category | AC-EL-ONB-020 | — |
| GET | /api/onboarding/meta | onboarding | Onboarding Meta | AC-EL-ONB-002 | 豁免(exclude) |
| GET | /api/onboarding/pipeline | onboarding | Onboarding Pipeline | AC-EL-ONB-003 | 豁免(exclude) |
| POST | /api/onboarding/skus | onboarding | Onboarding Skus | AC-EL-ONB-025 | — |
| GET | /api/ops/dlq | ops | Dlq List | AC-EL-BKF-029 | 豁免(exclude) |
| POST | /api/ops/dlq/drop | ops | Dlq Drop | AC-EL-BKF-033 | — |
| POST | /api/ops/dlq/retry | ops | Dlq Retry | AC-EL-BKF-032 | — |
| GET | /api/ops/llm/providers | ops | Ops Llm Providers | AC-EL-SET-006 AC-EL-SET-027 | ✓在册 |
| POST | /api/ops/llm/switch | ops | Ops Llm Switch | AC-EL-SET-034 | — |
| POST | /api/ops/login | ops | Ops Login | AC-EL-OPS-G01 | — |
| POST | /api/ops/logout | ops | Ops Logout | AC-EL-OPS-G01 | — |
| GET | /api/ops/tenants | ops | Ops Tenants | AC-EL-OPS-G01 | ✓在册 |
| POST | /api/ops/tenants/{slug}/activate | ops | Ops Tenant Activate | AC-EL-OPS-G01 | — |
| GET | /api/orders | orders | Orders List | AC-EL-ORDERS-G01 | ✓在册 |
| POST | /api/org/tenant/offboard | org | Tenant Offboard | AC-EL-TEAM-034 AC-EL-OFB-010 | — |
| POST | /api/org/tenant/restore | org | Tenant Restore | AC-EL-OFB-006 | — |
| GET | /api/pipeline/audit | pipeline | Pipeline Audit | AC-EL-PIPE-002 AC-EL-PIPE-046 | ✓在册 |
| POST | /api/pipeline/run/{func_name} | pipeline | Pipeline Run | AC-EL-PIPE-019 AC-EL-PIPE-047 | — |
| GET | /api/pipeline/status | pipeline | Pipeline Status | AC-EL-PIPE-002 AC-EL-PIPE-045 | 豁免(exclude) |
| GET | /api/pm/export | pm | Pm Export | AC-EL-PRJ-011 | ✓在册 |
| POST | /api/pm/import | pm | Pm Import | AC-EL-PRJ-013 | — |
| GET | /api/pm/products | pm | Pm Products List | AC-EL-PRJ-003 AC-EL-PRJ-059 | ✓在册 |
| POST | /api/pm/products | pm | Pm Products Create | AC-EL-PRJ-003 AC-EL-PRJ-059 | — |
| GET | /api/pm/products/{pid} | pm | Pm Products Get | AC-EL-PRJ-064 | ✓在册 |
| PUT | /api/pm/products/{pid} | pm | Pm Products Update | AC-EL-PRJ-064 | — |
| DELETE | /api/pm/products/{pid} | pm | Pm Products Delete | AC-EL-PRJ-064 | — |
| POST | /api/pm/products/{pid}/chain | pm | Pm Chain | AC-EL-PRJ-008 | — |
| POST | /api/pm/products/{pid}/tasks | pm | Pm Tasks Create | AC-EL-PRJ-054 | — |
| PUT | /api/pm/tasks/{tid} | pm | Pm Tasks Update | AC-EL-PRJ-030 AC-EL-PRJ-054 AC-EL-PRJ-057 | — |
| DELETE | /api/pm/tasks/{tid} | pm | Pm Tasks Delete | AC-EL-PRJ-030 AC-EL-PRJ-054 AC-EL-PRJ-057 | — |
| POST | /api/po/create | po | Po Create | AC-EL-PO-015 AC-EL-PO-021 AC-EL-PO-053 | — |
| GET | /api/po/list | po | Po List | AC-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/suppliers | po | Po Suppliers | AC-EL-INV-038 AC-EL-PO-030 AC-EL-PO-032 AC-EL-PO-034 | ✓在册 |
| POST | /api/po/suppliers | po | Po Supplier Create | AC-EL-INV-038 AC-EL-PO-030 AC-EL-PO-032 AC-EL-PO-034 | — |
| DELETE | /api/po/suppliers/{sid} | po | Po Supplier Delete | AC-EL-PO-035 | — |
| GET | /api/po/{pid} | po | Po Detail | AC-EL-PO-024 AC-EL-PO-057 AC-EL-PO-067 | ✓在册 |
| PUT | /api/po/{pid} | po | Po Update | AC-EL-PO-024 AC-EL-PO-057 AC-EL-PO-067 | — |
| DELETE | /api/po/{pid} | po | Po Delete | AC-EL-PO-024 AC-EL-PO-057 AC-EL-PO-067 | — |
| POST | /api/po/{pid}/mail | po | Po Pdf Mail | AC-EL-PO-068 | — |
| GET | /api/po/{pid}/pdf | po | Po Pdf Get | AC-EL-PO-072 | ✓在册 |
| POST | /api/po/{pid}/pdf | po | Po Pdf Regen | AC-EL-PO-072 | — |
| POST | /api/po/{pid}/receive | po | Po Receive | AC-EL-PO-075 | — |
| POST | /api/po/{pid}/status | po | Po Status | AC-EL-PO-062 AC-EL-PO-063 | — |
| GET | /api/products | products | Products List | AC-EL-PRD-002 AC-EL-PRD-007 AC-EL-PRD-040 AC-EL-PO-055 | ✓在册 |
| GET | /api/promotion/categories | promotion | List Categories | AC-EL-OFF-048 AC-EL-OFC-LIB-003 AC-EL-OFC-LIB-004 | ✓在册 |
| POST | /api/promotion/categories | promotion | Add Category | AC-EL-OFF-048 AC-EL-OFC-LIB-003 AC-EL-OFC-LIB-004 | — |
| PUT | /api/promotion/categories/{cid} | promotion | Upd Category | AC-EL-OFC-LIB-005 | — |
| DELETE | /api/promotion/categories/{cid} | promotion | Del Category | AC-EL-OFC-LIB-005 | — |
| GET | /api/promotion/channel-dict | promotion | List Channel Dict | AC-EL-OFF-048 AC-EL-OFC-OVR-003 AC-EL-OFC-LIB-006 AC-EL-OFC-LIB-007 | ✓在册 |
| POST | /api/promotion/channel-dict | promotion | Add Channel Dict | AC-EL-OFF-048 AC-EL-OFC-OVR-003 AC-EL-OFC-LIB-006 AC-EL-OFC-LIB-007 | — |
| PUT | /api/promotion/channel-dict/{did} | promotion | Upd Channel Dict | AC-EL-OFC-LIB-008 AC-EL-OFC-LIB-009 | — |
| DELETE | /api/promotion/channel-dict/{did} | promotion | Del Channel Dict | AC-EL-OFC-LIB-008 AC-EL-OFC-LIB-009 | — |
| GET | /api/promotion/channels | promotion | Promotion Channels | AC-EL-PROMOTION-G01 | ✓在册 |
| POST | /api/promotion/channels/{cid}/status | promotion | Promo Channel Status | AC-EL-OFF-060 | — |
| GET | /api/promotion/classify-rules | promotion | List Rules | AC-EL-OFC-INB-045 AC-EL-OFC-INB-052 | ✓在册 |
| POST | /api/promotion/classify-rules | promotion | Add Rule | AC-EL-OFC-INB-045 AC-EL-OFC-INB-052 | — |
| PUT | /api/promotion/classify-rules/{rid} | promotion | Upd Rule | AC-EL-OFC-INB-058 AC-EL-OFC-INB-060 | — |
| DELETE | /api/promotion/classify-rules/{rid} | promotion | Del Rule | AC-EL-OFC-INB-058 AC-EL-OFC-INB-060 | — |
| GET | /api/promotion/email-templates | promotion | List Templates | AC-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-templates | promotion | Add Template | AC-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} | promotion | Upd Template | AC-EL-OFC-TPL-002 AC-EL-OFC-TPL-003 | — |
| DELETE | /api/promotion/email-templates/{tid} | promotion | Del Template | AC-EL-OFC-TPL-002 AC-EL-OFC-TPL-003 | — |
| POST | /api/promotion/email-templates/{tid}/preview | promotion | Preview Template | AC-EL-OFC-TPL-005 | — |
| GET | /api/promotion/inbox | promotion | List Inbox | AC-EL-OFC-INB-002 | ✓在册 |
| GET | /api/promotion/inbox/kol/{kol_id}/profile | promotion | Inbox Kol Profile | AC-EL-OFC-INB-021 | ✓在册 |
| POST | /api/promotion/inbox/{mid}/claim | promotion | Claim Inbox | AC-EL-OFC-INB-026 | — |
| POST | /api/promotion/inbox/{mid}/classify | promotion | Classify Inbox | AC-EL-OFC-INB-029 | — |
| POST | /api/promotion/inbox/{mid}/handled | promotion | Set Inbox Handled | AC-EL-OFC-INB-031 | — |
| POST | /api/promotion/inbox/{mid}/reply | promotion | Reply Inbox | AC-EL-OFC-INB-037 | — |
| GET | /api/promotion/inbox/{mid}/thread | promotion | Inbox Thread | AC-EL-OFC-INB-020 | ✓在册 |
| GET | /api/promotion/kol | promotion | Promo Kol | AC-EL-OFF-062 AC-EL-OFC-PRJ-008 AC-EL-OFC-TSK-008 | ✓在册 |
| GET | /api/promotion/kol-analysis | promotion | Promo Kol Analysis | AC-EL-OFC-TSK-010 | ✓在册 |
| POST | /api/promotion/kol-categories/batch | promotion | Batch Tag | AC-EL-OFF-048 AC-EL-OFC-LIB-002 | — |
| GET | /api/promotion/kol-library | promotion | Kol Library | AC-EL-OFF-048 AC-EL-OFC-OVR-001 AC-EL-OFC-SEG-002 AC-EL-OFC-LIB-001 | ✓在册 |
| GET | /api/promotion/kol-reddit | promotion | Kol Reddit | AC-EL-OFF-049 AC-EL-OFC-RDT-001 | ✓在册 |
| GET | /api/promotion/kol-stats | promotion | Kol Stats | AC-EL-OFC-OVR-002 | ✓在册 |
| POST | /api/promotion/kol/{kind}/{kid}/outreach | promotion | Promo Kol Outreach | AC-EL-OFF-061 AC-EL-OFC-TSK-009 | — |
| GET | /api/promotion/mailboxes | promotion | List Mailboxes | AC-EL-OFF-054 AC-EL-OFC-MBX-001 AC-EL-OFC-MBX-002 AC-EL-OFC-SND-003 | ✓在册 |
| POST | /api/promotion/mailboxes | promotion | Create Mailbox | AC-EL-OFF-054 AC-EL-OFC-MBX-001 AC-EL-OFC-MBX-002 AC-EL-OFC-SND-003 | — |
| PUT | /api/promotion/mailboxes/{mid} | promotion | Update Mailbox | AC-EL-OFC-MBX-003 AC-EL-OFC-MBX-005 | — |
| DELETE | /api/promotion/mailboxes/{mid} | promotion | Delete Mailbox | AC-EL-OFC-MBX-003 AC-EL-OFC-MBX-005 | — |
| POST | /api/promotion/mailboxes/{mid}/test | promotion | Test Mailbox | AC-EL-OFC-MBX-004 | — |
| GET | /api/promotion/orders | promotion | Promo Orders List | AC-EL-OFF-043 AC-EL-OFF-055 AC-EL-OFF-063 AC-EL-OFC-TSK-002 | ✓在册 |
| POST | /api/promotion/orders | promotion | Promo Order Create | AC-EL-OFF-043 AC-EL-OFF-055 AC-EL-OFF-063 AC-EL-OFC-TSK-002 | — |
| POST | /api/promotion/orders/{oid}/approve | promotion | Promo Order Approve | AC-EL-OFF-046 AC-EL-OFC-TSK-003 | — |
| GET | /api/promotion/project-kols/{pkid}/content | promotion | Get Content | AC-EL-OFC-PRJ-010 | ✓在册 |
| PUT | /api/promotion/project-kols/{pkid}/content | promotion | Save Content | AC-EL-OFC-PRJ-010 | — |
| PUT | /api/promotion/project-kols/{pkid}/manual | promotion | Save Manual | AC-EL-OFC-PRJ-011 | — |
| POST | /api/promotion/project-kols/{pkid}/status | promotion | Set Pk Status | AC-EL-OFC-PRJ-005 | — |
| GET | /api/promotion/projects | promotion | List Projects | AC-EL-OFC-PRJ-001 AC-EL-OFC-PRJ-003 | ✓在册 |
| POST | /api/promotion/projects | promotion | Create Project | AC-EL-OFC-PRJ-001 AC-EL-OFC-PRJ-003 | — |
| DELETE | /api/promotion/projects/{pid} | promotion | Delete Project | AC-EL-OFC-PRJ-002 | — |
| POST | /api/promotion/projects/{pid}/email/batch-send | promotion | Batch Send | AC-EL-OFC-PRJ-006 | — |
| GET | /api/promotion/projects/{pid}/export | promotion | Export Project | AC-EL-OFC-PRJ-007 | ✓在册 |
| GET | /api/promotion/projects/{pid}/kols | promotion | List Project Kols | AC-EL-OFC-PRJ-004 | ✓在册 |
| POST | /api/promotion/projects/{pid}/kols/add | promotion | Add Kols | AC-EL-OFC-PRJ-009 | — |
| GET | /api/promotion/resources | promotion | List Resources | AC-EL-OFF-058 AC-EL-OFC-RES-001 | ✓在册 |
| GET | /api/promotion/segments | promotion | List Segments | AC-EL-OFF-051 AC-EL-OFC-SEG-001 AC-EL-OFC-SEG-011 AC-EL-OFC-SND-004 | ✓在册 |
| POST | /api/promotion/segments | promotion | Create Segment | AC-EL-OFF-051 AC-EL-OFC-SEG-001 AC-EL-OFC-SEG-011 AC-EL-OFC-SND-004 | — |
| DELETE | /api/promotion/segments/{sid} | promotion | Delete Segment | AC-EL-OFC-SEG-019 | — |
| GET | /api/promotion/send-tasks | promotion | List Send Tasks | AC-EL-OFF-052 AC-EL-OFC-SND-001 AC-EL-OFC-SND-005 | ✓在册 |
| POST | /api/promotion/send-tasks | promotion | Create Send Task | AC-EL-OFF-052 AC-EL-OFC-SND-001 AC-EL-OFC-SND-005 | — |
| DELETE | /api/promotion/send-tasks/{tid} | promotion | Delete Send Task | AC-EL-OFC-SND-007 | — |
| POST | /api/promotion/send-tasks/{tid}/launch | promotion | Launch Send Task | AC-EL-PROMOTION-G01 | — |
| GET | /api/promotion/send-tasks/{tid}/logs | promotion | Send Task Logs | AC-EL-OFC-SND-008 | ✓在册 |
| POST | /api/promotion/send-tasks/{tid}/pause | promotion | Pause Send Task | AC-EL-PROMOTION-G01 | — |
| POST | /api/promotion/send-tasks/{tid}/resume | promotion | Resume Send Task | AC-EL-PROMOTION-G01 | — |
| POST | /api/promotion/submission | promotion | Promo Submission | AC-EL-OFF-043 | — |
| GET | /api/promotion/submissions | promotion | Promo Submissions | AC-EL-OFF-055 AC-EL-OFF-063 AC-EL-OFC-TSK-001 | ✓在册 |
| GET | /api/promotion/summary | promotion | Promotion Summary | AC-EL-OFF-006 AC-EL-OFF-011 | ✓在册 |
| GET | /api/promotion/tasks | promotion | Promo Tasks | AC-EL-OFF-059 AC-EL-OFC-TSK-004 AC-EL-OFC-TSK-006 | ✓在册 |
| POST | /api/promotion/tasks | promotion | Promo Task Create | AC-EL-OFF-059 AC-EL-OFC-TSK-004 AC-EL-OFC-TSK-006 | — |
| DELETE | /api/promotion/tasks/{tid} | promotion | Promo Task Delete | AC-EL-OFC-TSK-007 | — |
| POST | /api/promotion/tasks/{tid}/status | promotion | Promo Task Status | AC-EL-OFC-TSK-005 | — |
| GET | /api/rankings | rankings | Rankings List | AC-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-reviews | rankings | Rankings Amazon Reviews | AC-EL-RANK-062 | ✓在册 |
| GET | /api/rankings/history | rankings | Rankings History | AC-EL-RANK-034 | ✓在册 |
| GET | /api/rankings/markets | rankings | Rankings Markets | AC-EL-RANK-014 | ✓在册 |
| GET | /api/rankings/rating-review-analytics | rankings | Rankings Rating Review Analytics | AC-EL-RANK-044 | ✓在册 |
| POST | /api/rankings/refresh | rankings | Rankings Refresh | AC-EL-RANK-005 | — |
| POST | /api/rankings/review-ai | rankings | Rankings Review Ai | AC-EL-RANK-072 | — |
| GET | /api/reports/backend-keywords/{sku} | reports | Get Backend Keywords | AC-EL-REPORTS-G01 | ✓在册 |
| PUT | /api/reports/backend-keywords/{sku} | reports | Set Backend Keywords | AC-EL-REPORTS-G01 | — |
| GET | /api/reports/defs | reports | List Defs | AC-EL-HOME-49 AC-EL-CMP-051 | ✓在册 |
| POST | /api/reports/defs | reports | Create Def | AC-EL-HOME-49 AC-EL-CMP-051 | — |
| PUT | /api/reports/defs/{rid} | reports | Update Def | AC-EL-CMP-051 | — |
| DELETE | /api/reports/defs/{rid} | reports | Delete Def | AC-EL-CMP-051 | — |
| GET | /api/reports/fields | reports | Report Fields | AC-EL-HOME-49 AC-EL-CMP-051 | ✓在册 |
| POST | /api/reports/landed-cost | reports | Landed Cost | AC-EL-REPORTS-G01 | — |
| POST | /api/reports/query | reports | Report Query | AC-EL-HOME-49 AC-EL-CMP-053 | — |
| GET | /api/settings/credentials | settings | List Credentials | AC-EL-SET-008 AC-EL-SET-024 | ✓在册 |
| POST | /api/settings/credentials | settings | Create Credential | AC-EL-SET-008 AC-EL-SET-024 | — |
| PUT | /api/settings/credentials/{cid} | settings | Update Credential | AC-EL-SET-017 AC-EL-SET-024 | — |
| DELETE | /api/settings/credentials/{cid} | settings | Delete Credential | AC-EL-SET-017 AC-EL-SET-024 | — |
| POST | /api/settings/credentials/{cid}/verify | settings | Verify Credential | AC-EL-SET-015 | — |
| GET | /api/settings/providers | settings | List Providers | AC-EL-SET-003 AC-EL-SET-023 | ✓在册 |
| GET | /api/settlement | settlement | Settlement Tracker | AC-EL-STL-010 AC-EL-STL-024 | ✓在册 |
| GET | /api/sourcing/aba/chart | sourcing | Aba Chart | AC-EL-SOURCING-G01 | ✓在册 |
| GET | /api/sourcing/aba/ledger | sourcing | Aba Ledger | AC-EL-SRC-21 | ✓在册 |
| GET | /api/sourcing/aba/overview | sourcing | Aba Overview | AC-EL-SRC-08 | ✓在册 |
| GET | /api/sourcing/aba/terms | sourcing | Aba Terms Ac | AC-EL-SRC-05 | ✓在册 |
| GET | /api/sourcing/category-tree | sourcing | Sourcing Category Tree | AC-EL-SRC-35 | ✓在册 |
| GET | /api/sourcing/deals | sourcing | Sourcing Deals | AC-EL-SRC-80 AC-EL-SRC-D-001 | ✓在册 |
| POST | /api/sourcing/enrich | sourcing | Sourcing Enrich | AC-EL-SRC-F-021 | — |
| GET | /api/sourcing/explore | sourcing | Sourcing Explore | AC-EL-SRC-50 | ✓在册 |
| POST | /api/sourcing/explore | sourcing | Sourcing Explore Post | AC-EL-SRC-50 | — |
| POST | /api/sourcing/explore/export | sourcing | Sourcing Explore Export | AC-EL-SRC-54 | — |
| GET | /api/sourcing/explore/fields | sourcing | Sourcing Explore Fields | AC-EL-SOURCING-G01 | ✓在册 |
| GET | /api/sourcing/explorer | sourcing | Sourcing Explorer | AC-EL-SRC-06 AC-EL-SRC-17 | ✓在册 |
| POST | /api/sourcing/finder | sourcing | Sourcing Finder | AC-EL-SRC-81 AC-EL-SRC-F-001 | — |
| GET | /api/sourcing/keepa-graph | sourcing | Sourcing Keepa Graph | AC-EL-SRC-V-019 | ✓在册 |
| GET | /api/sourcing/keepa-history | sourcing | Sourcing Keepa History | AC-EL-SOURCING-G01 | ✓在册 |
| GET | /api/sourcing/keepa-status | sourcing | Sourcing Keepa Status | AC-EL-SRC-01 | ✓在册 |
| GET | /api/sourcing/lightning | sourcing | Sourcing Lightning | AC-EL-SRC-D-018 | ✓在册 |
| GET | /api/sourcing/price-history | sourcing | Sourcing Price History | AC-EL-SRC-78 AC-EL-SRC-V-003 | ✓在册 |
| GET | /api/sourcing/radar | sourcing | Sourcing Radar | AC-EL-SRC-24 | ✓在册 |
| GET | /api/sourcing/search | sourcing | Sourcing Search | AC-EL-SRC-12 AC-EL-SRC-W-005 | ✓在册 |
| POST | /api/sourcing/seller-finder | sourcing | Sourcing Seller Finder | AC-EL-SRC-S-010 | — |
| GET | /api/sourcing/seller-lookup | sourcing | Sourcing Seller Lookup | AC-EL-SRC-S-031 | ✓在册 |
| GET | /api/sourcing/sellers/top | sourcing | Sourcing Sellers Top | AC-EL-SRC-79 AC-EL-SRC-S-005 | ✓在册 |
| GET | /api/sourcing/topsellers | sourcing | Sourcing Topsellers | AC-EL-SRC-S-025 | ✓在册 |
| GET | /api/sourcing/verdicts/candidates | sourcing | Verdicts Candidates | AC-EL-SRC-X-009 | ✓在册 |
| POST | /api/sourcing/verdicts/decision | sourcing | Verdicts Decision | AC-EL-SOURCING-G01 | — |
| GET | /api/sourcing/verdicts/legacy | sourcing | Verdicts Legacy | AC-EL-SOURCING-G01 | ✓在册 |
| POST | /api/sourcing/verdicts/materialize | sourcing | Verdicts Materialize | AC-EL-SRC-X-001 | — |
| GET | /api/sourcing/verdicts/pareto | sourcing | Verdicts Pareto | AC-EL-SRC-X-003 | ✓在册 |
| POST | /api/sourcing/watch | sourcing | Sourcing Watch Add | AC-EL-SRC-W-013 | — |
| POST | /api/sourcing/watch/alert | sourcing | Sourcing Watch Alert | AC-EL-SRC-W-022 AC-EL-SRC-V-023 | — |
| DELETE | /api/sourcing/watch/{wid} | sourcing | Sourcing Watch Del | AC-EL-SRC-W-025 | — |
| GET | /api/sourcing/watchlist | sourcing | Sourcing Watchlist | AC-EL-SRC-77 AC-EL-SRC-W-015 | ✓在册 |
| GET | /api/team/meta | team | Team Meta | AC-EL-TEAM-002 AC-EL-TEAM-005 AC-EL-TEAM-033 | 豁免(exclude) |
| GET | /api/team/users | team | Team Users | AC-EL-TEAM-008 AC-EL-TEAM-043 | 豁免(exclude) |
| POST | /api/team/users | team | Team User Create | AC-EL-TEAM-008 AC-EL-TEAM-043 | — |
| PUT | /api/team/users/{mid} | team | Team User Update | AC-EL-TEAM-018 AC-EL-TEAM-019 AC-EL-TEAM-043 | — |
| DELETE | /api/team/users/{mid} | team | Team User Delete | AC-EL-TEAM-018 AC-EL-TEAM-019 AC-EL-TEAM-043 | — |
| GET | /api/tenant/brands | tenant | Tenant Brands List | AC-EL-TEAM-021 AC-EL-TEAM-023 | ✓在册 |
| POST | /api/tenant/brands | tenant | Tenant Brand Add | AC-EL-TEAM-021 AC-EL-TEAM-023 | — |
| DELETE | /api/tenant/brands/{brand} | tenant | Tenant Brand Del | AC-EL-TEAM-028 | — |
| PUT | /api/tenant/brands/{brand}/activate | tenant | Tenant Brand Activate | AC-EL-TEAM-029 | — |
| GET | /api/tenant/exists | tenant | Tenant Exists | AC-EL-TENANT-G01 | 豁免(exclude) |
| GET | /api/tenant/info | tenant | Tenant Info | AC-EL-ADS-057 AC-EL-ADS-071 AC-EL-SHELL-010 AC-EL-SHELL-011 AC-EL-SRC-X-002 | 豁免(exclude) |
| GET | /api/tenant/jobs | tenant | Tenant Jobs | AC-EL-TENANT-G01 | ✓在册 |
| GET | /api/today | today | Today Stats | AC-EL-TODAY-G01 | ✓在册 |
| GET | /api/training/stats | training | Training Stats | AC-EL-HLP-026 | ✓在册 |
| POST | /api/upload | upload | Upload File | AC-EL-LST-147 AC-EL-LST-148 | — |
| GET | /api/upload/files | upload | Upload Files List | AC-EL-LST-146 | ✓在册 |
| DELETE | /api/upload/files/{fid} | upload | Upload File Delete | AC-EL-LST-149 | — |
| GET | /api/webhooks/noon/status | webhooks | Noon Webhook Status | AC-EL-WEBHOOKS-G01 | ✓在册 |
| POST | /api/webhooks/noon/{path_token} | webhooks | Noon Webhook | AC-EL-WEBHOOKS-G01 | — |
| GET | /internal/api/v1/ads/spend | internal/api | Ads Spend | AC-EL-INTERNAL-G01 | ✓在册 |
| GET | /internal/api/v1/finance/monthly | internal/api | Finance Monthly | AC-EL-INTERNAL-G01 | ✓在册 |
| GET | /internal/api/v1/order/sku-aggregate | internal/api | Order Sku Aggregate | AC-EL-INTERNAL-G01 | ✓在册 |
| GET | /internal/api/v1/order/status | internal/api | Order Data Status | AC-EL-INTERNAL-G01 | ✓在册 |
| GET | /internal/api/v1/shared/fx-rate | internal/api | Get Fx Rate | AC-EL-INTERNAL-G01 | ✓在册 |
| POST | /mcp | (root) | Mcp Endpoint | AC-EL-MCP-G01 | — |
| 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-04 | TraceID 全链贯穿 | 全部请求、前端操作、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:— |
| 术语 | 定义(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 |
| ID | 需求条款(系统必须/禁止) | PDF 出处 | as-built 承载 | 状态 | |
|---|---|---|---|---|---|
| AC-REQ-01 | 层级模型六层固定:企业→平台→品牌→销售模式(直营/代理)→国家→SKU 顺序固定,业务流/数据流自上而下单向生成,禁逆向推导或越界访问 | §2.1/§2.3 | AC-SEC 系+ops.py 级联+sku_mapping 宇宙(AC-AUD-02 纵向流核验) | ✅ | |
| AC-REQ-02 | 企业隔离:企业间数据/业务/报表/结算/日志严格隔离——不能读取/聚合/修改他企业数据 | §2.2 | RLS 98/98 表 ENABLE+FORCE+AC-SEC-01+越界攻击测试面 | ✅ | |
| AC-REQ-03 | 平台隔离:同企业下不同平台的指标/订单/广告/库存独立,数据与权限双隔离 | §2.2 | {tenant}_{platform} schema 分域+RLS+R10 横向列构门禁 | ✅ | |
| AC-REQ-04 | 品牌独立核算:同平台下品牌独立核算、独立报表、权限隔离 | §2.2 | brand 维度+useBrand 本企业+RLS 行级 | ✅ | |
| AC-REQ-05 | 直营/代理双路径:使用不同结算/佣金/利润/退款公式,两套计算路径分别存在、分别核验 | §2.2/§7.2 | AC-SEC-09+metric_calibers sales_mode 区分+AC-CAL 系口径 | ✅(onno 采购成本行=R24 线挂账) | |
| AC-REQ-06 | 国家规则独立:币种/税费/合规/汇率/本地化规则按国家独立生效 | §2.2 | fx 汇率面+noon rankings sa/ae 目录级口径+AC-CAL-18 税差对齐 | ✅ | |
| AC-REQ-07 | SKU 六维绑定:选品/库存/广告/订单/销售/退货全绑定正确维度组合 | §2.2 | sku_mapping 宇宙唯一事实源+R9 级联纯净度双向执法 | ✅ | |
| AC-REQ-08 | 维度联动经映射表:指标依赖映射维度必经映射表解析,禁硬编码维度 | §2.3 | sku_mapping+R9+AC-PEND-02 谓词派生(禁逆向捕捉) | ✅ | |
| AC-REQ-09 | 指标注册表单一事实源:看板/报表/表格/图表/结算/退款/回溯/导出/REST API 全部由注册表驱动;业务指标公式禁散落在接口/前端/定时任务,任何一处硬写=高风险 | §1.2/§6.1 | metric_calibers 37 行+R1-R3 双向锚+R5 内联清零+AC-CAL-17 展示页禁公式 | ✅ | |
| AC-REQ-10 | 页面权限+数据行权限双控:权限不能只控「能不能打开页面」,必须同时控数据行——拿到接口也读不到非本企业/维度数据 | §6.4 | mod 付费模块门+RLS 行级+API 企业绑定(AC-SEC 系) | ✅ | |
| AC-REQ-11 | 导出隔离:导出与页面同走企业与维度隔离,禁导出越界数据 | §6.4 | 导出端点全经 API 层(§12 册)+RLS | ✅ | |
| AC-REQ-12 | 后台任务绑定企业:任务执行时绑定企业上下文,禁后台绕过隔离 | §6.4/§10.2 | tasks.py _arun 账本+RLS+AC-AUD-11 八条校验 | ✅ | |
| AC-REQ-13 | 数据库层隔离兜底:业务表含企业 ID+维度字段;后台查询强制带企业与维度条件;禁无企业条件的通用聚合;审计日志同绑定企业——应用层出 bug 也不轻易跨企业泄漏 | §8.4 | RLS ENABLE+FORCE(应用层之外的库层兜底)+audit_log tenant_id(维度五列挂账见 AC-REQ-18) | ✅ | |
| AC-REQ-14 | 纵向流单向:原始采集→清洗规整→指标计算→订单汇总→结算生成→退款/退货调整→报表输出;下游报表/结算禁反写上游原始业务数据 | §9.1 | audit.cleaned_* 消费面分层(原始层只进不改)+AC-AUD-02 | ✅ | |
| AC-REQ-15 | 上下游对账恒平:上游明细汇总后与下游报表/结算金额匹配——正常订单/部分退款/全额退款/跨周期退货/多平台合并/直营代理分开六场景 | §9.3 | AC-GATE 对账门禁+catalog_sales 滞后判+晨检第 6 面数据完整性对账 | ✅ | |
| AC-REQ-16 | 回溯=重算非改原始:原始订单记录保持不变,重算结果单独保存版本快照;六维绑定+可选公式版本+独立审计日志+可暂停可预览确认后覆盖+不逆向改上游+资源隔离+权限管控;全平台订单回溯为全企业通用能力 | §11.1/§11.2 | AC-AUD-12(标准面)+backfill 重算面+audit_log before/after 留痕 | ✅标准在册(backfill 能力面按 AC-AUD-12 场景对照,新面立项先过本尺) | |
| AC-REQ-17 | 两类日志分立:企业使用日志与开发工作日志两套严格分开、存储不混 | §12/§12.3 | audit_log(action 前缀 applog.* 与业务操作前缀分离,同表不混义)+zlog 四分类+audit.html 开发台账 | ✅(语义分立承载;独立库面=随 AC-REQ-18 迁移批) | |
| AC-REQ-18 | 企业使用日志 17 必填字段+四要求:日志ID/RequestID/TraceID/企业ID/账号/操作人账号/操作时间/操作页面按钮/操作类型/入参/返回结果/操作状态/平台/品牌/销售模式/国家/SKU;不可篡改、持久存储、按企业与链路 ID 双检索、不可随意删除 | §12.1 | audit_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.2 | audit.html 台账+迁移台账+metric_calibers decision_date/audit_base_ref 三件承载 | ✅(载体=台账制度) | |
| AC-REQ-20 | 日志上报兜底:上报失败必须有兜底——操作成功但日志丢=缺陷 | §12.3 | zlog 异常自吞不阻断业务+audit_log 与业务同事务写 | ✅(同事务=强兜底;异步面无独立重试队列,如实注记) | |
| AC-REQ-21 | 日志查询守隔离:企业只能查看自己的操作日志 | §12.3 | audit_log RLS+API 企业绑定 | ✅ | |
| AC-REQ-22 | TraceID 全链透传:前端生成/接收→API→内部服务→队列/定时任务继承→所有日志/数据库记录/回溯记录绑定 TraceID;UUID 全局唯一不可伪造;任一环节丢失=高风险;同一业务操作可经 TraceID 一次性检索全链 | §13.1/§13.2/§13.3 | P2-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.3 | AC-AUD-07 七类基准组合矩阵+AC-EL 数据源列+e2e 门禁 | ✅标准在册(组合测试持续执法) | |
| AC-REQ-24 | 报表禁私算+缓存绑版本:报表不能私自实现计算逻辑,全部读取指标注册表;缓存绑定指标版本,公式更新后刷新策略明确 | §15.2 | R5 内联清零+AC-CAL-17+AC-AUD-10 版本化 | ✅2026-10-26 已修(迁移146):formula_version text NOT NULL DEFAULT 'v1',37 行机器可读版本锚;改公式必生新版本号(禁覆盖),三件承载(迁移+decision_date+台账)不变 | |
| AC-REQ-25 | 自定义看板守隔离:支持企业自定义看板,但自定义报表仍遵守企业与维度隔离规则 | §15.2 | as-built 暂无企业自建报表功能——本尺为该面上线前置约束 | ✅(无该面=无违例;未来上线必守) | |
| AC-REQ-26 | 下线指标禁空转:已下线/冗余指标不得还在后台定时计算占用资源 | §15.3 | AC-AUD-13 分级治理+arq cron 册(80 functions 全注册可对照) | ✅标准在册(分级标注=AC-AUD-13 面) | |
| AC-CAL-31 | finances 正本面结构门禁(四检查) (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-34 | Amazon 面板对账换算四口径(先换算后比对) (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-35 | Amazon 净利率口径公式钉死 (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 非池化行=0 | storage_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+1d | finance_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.174 | reg: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=0 | pipe_audit | — | ✅ |
| AC-AUD-P5 | 增量有效 | 采集器 stdout 报 N 行→表增量==N(不多不少=无静默丢弃/无重复插入) | fullstack_p3 已建 | cron 夜档 | ✅ |
| AC-AUD-P6 | 凭证活性 | 12 探针逐把钥匙打 LWA 端点 | credential_liveness | cron 08:07 | ✅ |
| AC-AUD-P7 | 代理出口 | 每品牌出口 IP==钉死值(EXPECTED_IPS) | exit-guard(每采集器每次) | config | ✅ |
| AC-AUD-P8 | 调度注册表 | crontab 活动==host-crontab.txt 镜像(防漂移) | cron_audit | cron 22:25 | ✅ |
| 三、API 层(A1-A7)每个端点每个参数 | |||||
| AC-AUD-A1 | 端点存活 | 351 个端点全返回 200/预期码 | audit_nodes | 夜审 | ✅ |
| AC-AUD-A2 | country 过滤生效 | 传 country=X→返回只含 X 的数据(不传=全量);所有支持 country 的端点逐个验 | 待建(2026-11-09 广告 KPI 事故) | cron 夜档 | ✅ |
| AC-AUD-A3 | brand 过滤生效 | 传 brand=X→返回只含 X 的数据 | fullstack_p3 已建 | cron 夜档 | ✅ |
| AC-AUD-A4 | platform 过滤生效 | 传 platform=X→返回只含 X 的数据 | fullstack_p3 已建 | cron 夜档 | ✅ |
| AC-AUD-A5 | 企业隔离 | 企业 A 的 token→查企业 B 的数据=0 行(RLS 逐行验) | tenant_isolation_audit | 夜审 | ✅ |
| AC-AUD-A6 | RLS 全覆盖 | 每张表都有 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-write | cron 夜档 | ✅(SAFE 层) |
| AC-AUD-U3 | 选择器联动 | 选国家→所有图表/KPI/表变;选品牌→数据切;选平台→内容切;每个选择器×每个选项×每个受影响组件 | 待建(2026-11-09 广告 KPI 切国家不变事故) | cron 夜档 | ✅ |
| AC-AUD-U4 | 填空生效 | 输入筛选词→行数减且匹配;输入日期→窗口切 | fullstack_p3 已建 | cron 夜档 | ✅ |
| AC-AUD-U5 | chart 逐点 | 每个图每个数据点==API 返回值==DB 值 | chart_value_audit(80 图) | 夜审 | ✅ |
| AC-AUD-U6 | table 逐格 | 每个表每行每列值==源数据(不是「表有数据」而是「这个格子是这个值」) | fullstack 已建 | cron 夜档 | ✅ |
| AC-AUD-U7 | 导出正确 | 点导出→CSV 内容==页面显示 | fullstack_p3 已建 | cron 夜档 | ✅ |
| AC-AUD-U8 | CRUD 完整 | 增删改→数据库真变了→页面刷新显示新状态 | 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-C6 | SKU 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 且 healthy | five_layer_audit | 晨检 | ✅ |
| AC-AUD-I2 | 磁盘 | <80% | five_layer_audit | AC-OPS-07 | ✅ |
| AC-AUD-I3 | cron 全跑 | 21 条 cron 最近 24h 全有日志 | cron_audit | cron | ✅ |
| AC-AUD-I4 | 代码卫生 | 采集器零硬编码密钥/零 runpy/零语法错 | 2026-11-09 横向一致扫 | 夜审 | ✅ |
| AC-AUD-I5 | DB 连接 | 连接池不耗尽、慢查询<阈值 | pipe_audit | 晨检 | ✅ |
| AC-AUD-I6 | 备份 | 每日备份成功+可恢复 | backup.sh+cron | 03: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 对照),新品牌/平台/国家注册即自动纳入审计面,禁手写验证点清单。 | |||||