! 亲跑包; 复活不依赖此条(孤儿机制今晚照常跑完, 墙已拆)。修复② 今晚 19:00 UTC(北京 11-14 03:00)=墙后首个自然实弹档, 验收=pricing max(snapshot_date)=2026-11-13 双 schema+④ adapter_runs 首录 fullpull 全程; 已挂一次性验收提醒。挂账优化提案(只报不动) fullpull 无 --brand 每晚双跑双份 impex 配额; 修法=adapter 参数化+调度器 per-brand 传参(同 apionly 10-09 补传参先例)或 tick 内去重, 拍板后另窗。亲跑包 docker exec -i zipforce-saas-db-1 sh -c 'exec psql -U "$POSTGRES_USER" -d saas_registry' 后: UPDATE collection_schedule SET config=jsonb_set(config,'{timeout_s}','3600'::jsonb), updated_at=now() WHERE id IN (15,25); RETURNING 验证 timeout_s=3600 且 returns_timeout_s=5400 保留。! 亲跑全绿(首跑两挫: 全角!未进 shell+缺 -d 落脚库, 均零副作用; 三跑逐条=预期: ④146→1166/⑦2·2·1·2/⑨c UPDATE 1+INSERT 1=1857AE+1861SA 同 nsku 同价/⑧id64+setval 64), 独立只读复核 ONNO=0·ZFH24=2 行·id64 在册。A组余量=⑧部署(build api worker+up -d, 避整半点档)。【补注 15:11 北京】⑧部署已由用户 ! 亲跑(15:07-15:08, :07 档避坑24): 双镜像重建+容器 Recreate, 实证=双容器 grep zero_order_gap_alarm=5、main arq 81 functions(79+2 吻合, 启动行列名 zero_order_gap_alarm+cron:zero_order_gap_alarm)+P2 arq 4 functions 双起、启动窗零 Traceback、api /api/health 200、部署后首个 :00 档 cron 族正常落(ads_import_pump/collection_cycle_sales rc 正常); 首航档=15:59 北京(:59 UTC), 监听已挂待报。改前备份=backups/changelog-pre-103-pill2-20261113.html。【补注 16:12 北京】⑧ 首航落地(15:59:00 北京, dur 97ms): checked_markets=25(zf9+onno4+fg12 分母吻合)/breaches=5=fg AU 98h·CA 106h·ES 101h·FR 103h·NL 106h(与下午实弹同集)+全断红牌(12 市场全 idle>24h)=真阳性维持。mailed=0 根因已拆: stderr 实证 [zero_order] mail failed tenant=3: PermissionError(13)——非 socket 非配额: 容器内出网 host:465 实测 OK; 真凶=secrets/monitor_smtp_pass 权限 0600 root:root(其余三文件 0644, mtime=北京 11-13 凌晨 07:14:49 被重写, 来源不明)→worker 非 root 读密码 open() 即 13。判定链: redis 键 zero_order_gap:3=本次首航写入(last_mail=首航时刻, TTL 7d−220s)→流程已走到发送段仅败在读取; _mon_smtp_cfg 每档现读无缓存→chmod 644 已修(对齐兄弟文件), 即生效零重启。自愈在轨: 告警行文含实时零单小时数→16:59 档 cur_set≠prev_set→new_breach=True 自动重发, 观察已挂。两呈报: (a)密码内容是否同窗被改=未验(凭证零读纪律), 16:59 首发成功=内容正确证, SMTPAuthenticationError=内容错需用户侧重置; (b)口径 wrinkle——去重键含实时数→持续破发期每小时一封(设计意图=新破即发+24h 心跳), 选项=维持事故期每小时提醒/键改品牌×国家裸集比对, 并入⑧四参数拍板卡。改前备份=backups/changelog-pre-103-firstfire-20261113.html。【补注 17:0x 北京·四参数转正】 用户令「1-8 全部推进」→ ⑧零单告警四参数按证据默认值转正(id 64 已入册): idle=now−max(purchase_date)@品牌×市场 / 阈值=max(24h, ceil(1.5×90d 窗最大单间隔)) / n90≥10 噪声底 / 品牌全市场 idle>24h 红牌。调参走 caliber 重入册流程, 不再视为试验参数。当日配套: 去重稳定键修复(_zog_key, 见 #106)。! 亲跑(0 常驻连接预检 DO 块+ALTER DATABASE, owner=collector, ACL/RLS 自动继承);②口径 id37 authoritative_source→center_warehouse.v_monthly_overhead(UPDATE 1; id29=历史叙事照旧例不动);③88 文件 sed 切换(12:44:19 群体落, 每文件 .bak_20261113 留档):collection 12+mars-mcp 4+tools 46+api 8+portal 5+pg-init 12+docs 1=计划 86+执行中补漏 2(/opt/mars-mcp/setup_role.sql 与 portal/app/migrations/20260903_portal_app_grants.sql, 均可重放 setup 脚本非留档);真代码残留 0, 不动组=旧 .bak-*/archive/__pycache__(mtime 自动失效)/evidence/restore_drill_20261025.txt/FULLSTACK_HANDOVER.md;④api+worker 重建 12:49:53(用户 !);⑤只读冒烟=双容器 saas_admin@center_warehouse 8 表可查(izero_noon.orders 86,974/foncye_noon 1,166/mapping 261/39/832 与 #101 冒烟逐一对上)+三子域+api/health 200+双容器日志零错;⑥采集首证:改名~sed 雷窗口(约 12:38-12:44)实测零损伤(zf 12:37 轮赶在改名前收口, fg 12:43 轮全程 0 行更新未触写库路径, 三 pending 日志零条 does not exist), 13:00 半点增量轮 izero/foncye/vnique 三品牌 rc:0+13:07 zf 状态轮 STATUS_ONLY_DONE 149——新容器+sed 后源码+新库名三合一首证全绿。⑦MCP 变更(用户令「取消这个mcp」):mars-db 移出 MCP 配置(~/.claude.json)+11 孤儿 server.py 进程(20h~12 天旧会话残留, 全指着死库名)清零; /opt/mars-mcp 代码与留档原样在盘, 可 claude mcp add 一键恢复。批3 全落地·两 MCP(mars-db/onno)均已取消! 亲跑):四轴定谳=租户 izero/foncye/vnique·品牌=数据标签·平台·公司(zipforce=hub 双关记惯例);违例总账=索引带品牌/租户/平台戳 59 处(原报 38 为分母漏计:补 uqg_za_*/uqg_zf_*/uqg_fg_*/uq_fg_*/idx_zf_*/zf_*_idx/idx_onno_* 与 product_rankings_*/fba_inventory_msku_snap_key 旧表名残留)+生产 schema bak 表 23 张(原报 21→22→实 23)+空库 2+MCP 死名 2 处(配置本体已对)批1/2/4+批2a下+批3 全落地izero_amazon.inventory_fba 形(schema.裸表名)/壳文件 izero_amazon_orders.py 形/注册键 izero-amazon-orders 形; 机制核单源(general_* 核)不改名。轴切分=brand 数据轴一律不动('zipforce' 字面量/NOON_TENANT_IDS/--brand 传参/label/color/adv_code/partner_id/collector 列值/seller_owner 值/EXPECTED_IPS 键——品牌=标签照旧), 只有复合基础设施串(schema/表/索引/序列/库名/注册键/壳文件名/凭证文件名)改。②批一(11-12 北京, 用户 ! 亲跑) 五映射之四: zipforce_amazon→izero_amazon / zipforce_noon→izero_noon / onno_noon→foncye_noon / fittingirls_amazon→vnique_amazon, +4 业务库 izero_ba/izero_factory/izero_pm/izero_promotion; 表/索引/序列剥旧租户前缀, RLS 三件套与视图 OID 依赖自动跟随不断链。③批二(11-13 凌时, run3c 首航 00:51 完成之后, 用户 ! 亲跑 /tmp/rename_onno_amazon_deferred.sql 单事务) 第五映射 onno_amazon→foncye_amazon: 32 表+77 索引+14 序列剥前缀+ALTER SCHEMA+注册表尾段(brands_source onno/amazon 行 source_schema→foncye_amazon+source_map 12 replace+collection_schedule 5,12); 自验 BASE 表=32/前缀残留=0/旧 schema 已无; 品牌味名(onno_* 形 11 索引+1 序列, 如 onno_adjustments_uniq)按批一成例保留不剥。④注册表 SQL①(saas_registry, 用户 ! 亲跑 /tmp/rename_registry_keys.sql) 64 UPDATE: brands_source 五行 source_schema/source_map 采集键与表值引用/凭证文件名/consign_schema 全换新+collection_schedule 6,8,9,15,18 翻转; 双断言旧串残留=0; onno/amazon 行当时=onno_amazon 系批二未跑的中间态, 由批二尾段收口转绿(audit-26 D1 红牌即此, 非映射错)。⑤run3c 首航随迁(#96⑥ 后记) 15 行(GB 7+AU 8)首灌落库后由批二连表带数改名 foncye_amazon.spapi_removal_orders, 终验 15 行在位; 原 Pending「批二后重跑 run3c」随真相还原(per-region 末尾才 commit 的写入节奏曾被误判死跑)取消, 无需重跑。⑥代码面 /opt/collection: config.py ADAPTERS 41 键+BRAND_OF 全新名(izero-*/foncye-*/vnique-*), 壳文件 mv 新形, 凭证文件只 mv+改引用路径(secrets/izero_noon.json/foncye_noon.json 等, 内容零读零打印), NOON_BRAND_REGISTRY 引用随迁; SaaS 侧四修复: api/routers/noon_data.py:110,112 fees 查询单段化 FROM {bs}.fees_{fee_type}(原双段 FROM 崩)+freshness_baseline.json 21 行基线换新名+izero_ads/vnique_ads docstring 注记; brand 数据轴串全数不动。⑦容器批+调度恢复 容器烤码制实证(api/worker 无代码目录挂载, SaaS 代码 build 时烤入镜像; /opt/collection 挂 worker 宿主改即生效)→api/web/worker rebuild+up -d(用户 ! 亲跑); 冒烟三绿=/api/health 200(内含 SELECT 1 真验 DB)+noon fees 单段已烤入新容器+业务路由匿名 404(路由隐藏防探测=设计); 调度按停表原谓词精确回启 11 行(task_type IN collect/collect_daily/webhook_consume), daily_readonly 3 行(20,21,22)批前本就停维持不启。⑧终验+audit-26 协同(对真值) pg_namespace 恰五 schema 全新名, BASE 表 foncye_amazon 32/foncye_noon 43/izero_amazon 35/izero_noon 43/vnique_amazon 47=200; 全库旧名前缀对象残留=0; 函数体扫描 3132 个零旧 schema 引用; audit-26 批二独立复核全中(D1 转绿: foncye_amazon.inventory_fba 1,100 行在位), 锚全套已更新, 夜档预期失败标记随落地可撤。⑨挂账如实(8 项在册只报未动, 全部待用户拍板) ①订单断流一行修法(general_amz_orders.py:36 market 未定义, 三租户 11-09 起零新单, 恢复调度后三壳照跑照失败吞异常)②spapi.ip 漂移两行(zf 行持 onno 值/onno 行死值)③品牌味索引名清理+saas api/tasks.py:1559 dropbox onno-ads 路径(采集侧 foncye_import_ads_daily.py:26 同路径两侧一致未断链, 归同类挂账)④调度器 stdout 80 字符截断(#96⑤ 帮凶)⑤noon_portal_full.py 死码处置⑥status_refresh 污染 fetched_at⑦SMTP 告警认证失败⑧collector GRANT SELECT 面(#94 后续)。备份与留档: 两 SQL 稿 /tmp/rename_registry_keys.sql、/tmp/rename_onno_amazon_deferred.sql; 本台账改前备份 backups/changelog-pre-96-98-20261113.html。! 亲跑 apply,19:07-19:10 北京):18 表键归一双事务全绿——13 正典约束在位+手术①②②b④⑦ 计数精确+终验 18/18 全绿,strict 形态达成 已落地·终验全绿docker exec -i zipforce-saas-db-1 psql -U saas_admin -d amazon_analytics -v ON_ERROR_STOP=1 < keyunit_a_apply.sql | tee apply_20261113_keyunit_a.log;输出与稿逐行吻合(幂等哨兵 DO→TXN1 六 INSERT+_cnt 断言 DO→COMMIT;TXN2 7 DROP INDEX+2 ALTER 降旧约束+13 ADD→COMMIT)零报错;前置备份三件 /opt/backups/schema-unify/20261113-keyunit-a/(18 表 schema-only+4 手术表 data)。②终验(MODE=verify SURGERY7=1,19:10 北京) 18/18 表(6 族×3 租户)真违反多余=0+正典唯一索引=有;行数四 Δ 精确:refunds|zf 1005→1004(−1)/oi|onno 604→594(−10)/removals|fg 179→99(−80)/其余 12 格 +0;13 新增约束库内独立复核(pg_constraint+pg_get_constraintdef)列定义与稿分毫不差;5 格存量同列旧约束在位(fg refunds / sales 双家 / rankings zf+onno 旧名索引)→13 新增+5 存量=18 全覆盖。③verify 读法修复(如实呈报) 终验首跑 15 格误红=执行稿 bug:无空格列串 cols 子串匹配 pg_indexes.indexdef 带空格渲染("a, b, c")→全部多列约束漏判(单列 oi×3 恰好幸免);修一行空格归一 d.replace(' ','') 后重跑全绿——只动 /tmp/keyunit_a_execute.py:224 读法,不动库、不改判据、不改 apply 结果。④遗留如实 fg debt 947/onno debt 3 = NULL 键暗区行(canon_dup 口径=全列非 NULL 键前提下 0 违反),不属本单元手术,维持降级只报挂账;settle_items 大单元(A6)按 #91 压后 2026-11-16 周一 settle 首航后。! 亲跑(tee apply_20261112_b3_grants.log,末尾自验期望 0 行无权表),授后 pricing 不手工干预、次日 full_pull 档自然复活,复验两壳新行落库后落账。SELECT … FROM {schema}_catalog_offers WHERE coalesce(partner_sku,'')<>'' 可跑(partner_sku 非空 zf 64/onno 7 行在位=pricing 取数源就绪);86 张 noon 业务表逐表 SELECT LIMIT 1 全通、不可访问集=无。③复活档期 每日快照档=0 19 * * *(服务器 UTC,collection_schedule 行 25/26 zf 侧 collect_daily+id15 onno 侧 daily_snapshot)=次日 03:00 北京:zf/onno noon-full-pull 同档跑 pricing(t_pricing 首次有望成功);同档 noon-portal-apionly seller_reviews TRUNCATE 自愈(#92 观察点同夜);recon_gates 03:17 北京九域恒等式其后自检。11-13 晨检复验三件:两壳 pricing 新行落库+seller_reviews count=distinct(两壳)+恒等式无新红。④范围如实 本批=纯授权不加数据;28 备份表不授(audit_fix_bak×11/fg 备份 7/public 3/shared 3,含 3 孤儿备份);public.fx_daily/ghost_write_log 维持 collector 不可读(引擎侧零引用无 live 影响);B2(ads_placements/targets 08-31 停摆)与权限无关转 Phase 4 另诊;deal_skus 0 行(双租户)非权限另案。"sku": it.get("sellerSku","") or it.get("sku","")——FBA 库存快照 sku 列双键兜底(与 seller_sku 行同读法); 下游读面零损失(清洗层 sync_source.py:646 以 inv.seller_sku 别名取列, 原始 sku 列无活读面), 但 sku 列波及面=全表 750 行(11-12 实测列值全空串, SEU 等行 seller_sku 列一直有值故表未失明); 修复后 11-13 03:00 北京 amz-fba 档自愈回填; 备份 amz_fba_sync.py.bak_20261112_sku_col②B6 修复 general_settle_items.fetch_events 429 同页退避×5 上界+持续 429→止已收页返回下轮水位补(原无计数器打转挂死风险; 与 general_settlements.retry_get(tries=5,wait=20) 同语义); 模块/函数 docstring 同步注记; 备份 .bak_20261112_b6_429cap; 三壳(fg:76/onno:120/zf:219)调用行零改。③deal_skus 定谳=真值非病 deals 端点回的是平台可报名目录(raw 实证 enrolled=false+metrics.total_enrolled=0, 双租户 100/100 全同); 写入器 noon_promo_pull 只收 status="ongoing" 的 psku → 0 行=两账号从未报名任何 deal; 写入器日跑健康, 不修。④noon_portal_full.py=死码 playwright cookie 通道(COOKIE_FILE noon_access_cookie.txt); 全库唯一引用=继任者 noon_portal_apionly.py:8 docstring「取代」清单; 注册表 "noon-full-pull"→adapters.noon_full_pull(另一文件, Impex 8 类目)与它无关; 处置(归档/删除)待拍板, 只报未动。⑤zf removal_orders 8 天断流案(本批最大意外发现, 已修复复活) 症状: {sch}_spapi_removal_orders 表 zf 侧 fetched_at 止于 2026-11-04 10:31 北京, 11-05 起八档全灭而调度日志 rc=0 假绿。根因: 11-11 23:24 UTC「直连核心」批改只给 fg_removal_orders 补了 lwa= 传参, zf_removal_orders.py:91 漏传→general_amz_finances._tok(s,lwa,region) 的 lwa[region] 在 lwa=None 上 TypeError×4 区(现场复现实锤); 双重静默=适配器 per-region try/except 吞异常照常走完+调度器 _isolated_run 截断 stdout[:80]/stderr[:80] 逐区 FAILED 行永久丢失。修复=:91 补 lwa=zf_finances.LWA(备份 .bak_20261112_lwa_arg); 复跑 11:37-11:40 UTC 四区 AE 178/SA 137/US 81/DE 220 行 upsert 全绿, 8 天缺口 DO UPDATE 幂等一次补齐, fetched_at 四区=2026-11-12 19:37-19:40 北京; fg 侧一直活(fetched_at 2026-11-12 03:53 北京)。调度器 80 字符截断机制=断流帮凶, 是否改全量落盘待拍板。⑥B5 onno 壳首航(用户令「所有的表格都要来自于api接口,不可以瞎编」+「同一平台横向一致」, 两轮迭代后定稿) 新建 核 general_removal_orders.py(机制自 zf_removal_orders #120 正文逐句原样迁入, 参数化 brand/schema/market_plan/lwa/session; CREATE 仅建本租户 schema)+壳 onno_removal_orders.py 纯绑定(凭证=onno_common 单 md 三区; LWA 键 onno_na/onno_eu/onno_fe 前缀防 _tc 互灌, fg:29 同模式); 市场面零手编: 运行时 /sellers/v1/marketplaceParticipations 实取=26 枚参与市场且每国新旧两枚 id(US=A2ZV50J4W1RKNI 新统一+ATVPDKIKX0DER 经典, DE/GB/CA/MX 等同构对)。首航挖出账户级数据真值: onno 移除报表=区域池行为——欧盟任一门牌(SA/AE/BE/DE/ES/FR/GB…)都回同一池 7 单(同 order_id 六重落 region 标签, /0qNWOaqTO 等 7 单×6 区实证), 对照 zf/fg 跨区同单=0(真按市场切)——若逐市场拉, 同一批单 6× 重复入库且下游件数聚合 6× 虚增。终稿 market_plan=onno_common.region_representative_markets()(注释原文即 "region-pooled APIs…avoiding duplicate rows")每区一枚代表共 3 拉(US=经典 id ATVPDKIKX0DER; US 侧 FAILED 观测如实: run1 两枚 id 双 CANCELLED=US 池空, run2 新 id FATAL(50193020769)+run3 经典 id 亦 FATAL(50194020769)=报表端摇摆 id 无关, FAILED 系诚实噪音零数据损失, 留次日档观察是否持续/GB=A1F83G8C2ARO7P/AU=A39IBJ37TRP1C6); 中间态 50 行重复标签先快照 /opt/backups/onno_removal_orders_intermediate_20261112.tsv 再 TRUNCATE 清表(表在今日首航前=0 行, 全部行为本日可重取, 非毁历史数据)。注册 config.py:76+BRAND_OF+调度器 DAILY onno amazon 加项+collection_schedule 行 12 补 timeout_s 2400(与 zf 行 26/fg 行 18 同款), 均免重启; RLS 横比三表同态(raw 层无 RLS 无策略, 与 zf/fg 逐格同构)。首航终态: run3c(终稿 3 市场版)10 小时长跑完成退出 rc=0——GB 00:50:56/AU 00:51:39(北京时间 11-13), 首灌 15 行(GB 7+AU 8); US 代表市场 FATAL(50194020769) 摇摆噪音与前文 run1 双 CANCELLED 同源(US 池空=诚实空窗, 零数据损失, 留次日档观察是否持续); 中途查库恒 0 行系 per-region 末尾才 commit 的写入节奏, 曾致「死跑」误判——真相=活跑全程至完成。后记(#98 手术交叉引用): 表随后连名带数随批二改名定谳 foncye_amazon.spapi_removal_orders, 15 行完整随迁(终验在案), 原「批二后重跑 run3c」Pending 取消。⑦B2 诊断(处置两选项待拍板) ads_placements/ads_targets 08-31 停摆=迁移断层孤儿表(写入器随前代通道退役而灭, 非权限非数据面故障); 选项 A=归档退役(当前无读面依赖)/选项 B=重建写入器(若页面要用); 未动。验证 两核一壳 py_compile 过; 市场面探针只读; 净首航日志 /tmp/onno_removal_first_run3.log(终稿 3 市场版; 前两跑 26/17 市场版系区域池真相揭出前的中间态, 已中止清场); zf 复跑日志与本批全部备份在 adapters/ 目录同批。/logistics 文案↔实现专项审计(严格只读,共核 44 处 → ⚠️ 9 · ✓ 35):⚠️-2~9 定性为措辞过时/歧义级,按 §89 新节奏(详比首发入 changelog + 文案级授权自动修;产品语义/破坏性仍停)执行;⚠️-1(「历史累计 {total} 票」vs 实时在册口径错位,40≠316)属口径取舍,留用户拍板(A 文案改「在册累计」/ B 恢复历史口径)。②8 处旧→新(全量对照,web/app/logistics/page.tsx)需跟进货代 · 本快照 X 票在册 → 需跟进货代 · 在册 X 票(by_badge 实时 GROUP BY 求和,快照表 9-26 起退役)。数据源:物流渠道快照… → 数据源:货代运单报表(⬆ 导入运单 CSV 手动导入 · KPI 实时聚合;货代 CSS 双清渠道,公司级发货,归母账号品牌隔离)。在途 / 待起运 → 在途(值单口径 stats.transit),foot 待起运 N → 待离港 N · 清关中 N。阶段超时 = 超过货代时效节点。 → 表格/KPI「超时」= 超过货代时效节点,节点「超期」= >7 自然日未推进且未签收(运输段豁免)(双口径写明:DB stage_overdue vs 前端 logiSteps.ts:42 OVERDUE_DAYS=7)。已收件 → 待起运 → 运输中… → 已收件 → 待离港 → 运输中 → 清关中 → 已签收(对齐 14 段状态机段序)。待起运 → 待离港——DB 权威实证 AWAITING="Awaiting Departure 待离港";四道门脚本 grep 零字符串依赖,仅两 standalone 工具脚本引用已同步(见③)。{265} 国家 → {265} 国家/地区代码(codes 键含 7 个非国家码 NULL/YT_n/YT_n1/MS_1/SRB/MNE/SGS)。VAT税率 / 无IOSS税率 → VAT税率(小数) / 无IOSS税率(小数)(值即小数 0.2=20%,防误读为百分数)。③工具脚本同步(防漂移) verify_logi_burn.py(第 3 节定位器 has_text="待离港"+记录标签 ×3)、audit_logi_frontend.py(badge_filters 列表)同步待起运→待离港,可运行性保持。④快照与部署 pre/post 双份归档 backups/code-2026-10-12-logi-wording/(非 git 仓库 tar 约定;pre 由 8 对编辑串反向重建并逐对断言旧串在位,page.tsx 45022B→45189B);docker compose build web + up -d --force-recreate web(仅 web 镜像;api/worker 共镜像未动未重启)。⑤自检(改完必截图铁律) tools/_shot_logi_wording.py DOM 断言 15/15 ALL PASS:新文案 5 串在页 · 旧文案 5 串绝迹(待起运/本快照/物流渠道快照/在途 / 待起运/旧超时句)· KPI1 label=「在途」+foot 待离港/清关中 · Pricing「265 国家/地区代码」· VAT 表头三列带(小数) · 移动端 390 复断言。五截图 analyze_image 视觉确认全过:KPI 行(在途 17·待离港 2·清关中 1;阶段超时 foot「在册 40 票」)· Tracking·桌面 · Tracking·移动 · Pricing 头 · VAT 附录(KPI 行首拍落在 .card 内漏 KPI 区,补拍 .kpis 元素)。视觉旁证非缺陷四项:最新轨迹/载货列 ellipsis 截断=设计内 · 移动端表格横向滚动=设计内 · 产品名「—」=空数据兜底 · KPI 4/5 卡双语 label=by_badge 直渲 DB badge_label 既有行为。frontend_e2e 门 ALL PASS(日志 tools/_gate_logi_wording_e2e.log;本批仅 web 前端变更,其余三门所测 API/DB 未动)。沉淀 memory-longterm §219;⚠️-1 待拍板挂账(A 改「在册累计」/ B 恢复历史口径 316)。sku_mapping ↔ mars shared.mapping_* 逐位一致(fg 832 行/208 ASIN、zf 261/33、onno 39/5),脏数据双侧清零,两晚零回灌(map_sku upsert 语义下双侧同净=无回灌源)。③权威目录与双口径定案(119→27 款) Keepa 抓取口径 27 款/237 ASIN(fg 9 款[2402/3993/2415/D985/2417/88106/TJ12/W003/DW003]=208 ASIN · zf 13 款=24 · onno 5 款=5);全平台口径 30 款/246 ASIN(zf 16 款/33——9 个 zf ASIN 仅登记 AE/SA/EU 站[Keepa 13 站外],其中 ZF-4306/Clip06/T11 三整型号完全在范围外→zf 16→13 款);两口径非矛盾、各说各轴,目录页用 Keepa 口径;ZF-565 归属 zf 定案;旧 119 款目录的 fg 一次性 SKU/zf 77 裸 ASIN 欠账全随导入自然消失(10-10 #57-g 挂账清零)。④Keepa 循环器重启(分母 351) 家族分母 1547(119×13)→351(27×13)(#57-g 后第二次换分母;前会话 936 为算错值已纠正);循环器 cron 随旧会话死亡,今日重启(10 分钟节拍,断点续传键 (brand,asin,market) 沿用零重复耗 token);首轮 166/351,今日快照已入库(cleaned_rankings_daily 2026-10-12=247 行持续增长);收敛后回归每日 05:20 UTC 定时档;token 日需求 351 vs 日补给 28800 富余 82 倍。⑤#66 /mapping 页面自检 三租户 list+edit 6 视角+zf 移动端共 7 截图视觉确认(zf list · fg list · onno list · zf edit · zf 移动端)。⑥#67 下游复验(排名/库存/广告/财务,用户「广告问题」项) API 12/12(3 租户×4 页):排名最新快照 2026-10-12 全租户(循环器在投);库存行带新权威名(ZF430T0NAC→Luna Pro/ZF-430/map_asin B0CYM2KF9S);广告 30 天孤儿 SKU=0(LEFT JOIN 只改归属不丢行);财务 2026-09 matrix 全品牌 unmapped_sku_count=0。DOM 10/10 无「请求失败」横幅(fg 库存 8825 行健康渲染——大表性能优化列为可选欠账);孤儿定性:inv fg 1039 旧 SKU 无名=设计内(旧名即被清脏数据)、rankings 30d 孤儿 fg233/zf39/onno1=旧追踪集、sales 孤儿 16/4/1 收入不受影响。截图+视觉确认 5 张:排名·zf · 库存·zf · 库存·fg · 广告·zf · 财务·zf。⑦#68 家族目录重生成 生成器 build_keepa_family_catalog.py 加 --csv 模式(单一事实源=tasks._family_groups;10-10 旧 CSV 系废弃 parent_asin 语义的 ad-hoc SQL,一并替代);交付 keepa_family_catalog_20261012.html(27 行全 model 键)+ CSV(72 家族×市场行,列含该市场在册 ASIN 数);7/7 DOM 断言(27 行/计数器/副标题口径链 119→27/键来源全 model/fg 筛选 9 行/搜索 2402→1 行/US 筛选 23 行)+ 视觉确认(27 产品/237 ASIN/zf13·fg9·onno5);截图 目录·桌面。⑧四道门(收口)+多会话并跑新坑 pen_tests ALL PASS(10:05)· audit_nodes ALL PASS(192 端点快照,10:07)· frontend_e2e 重跑 ALL PASS(10:28-10:35)· dashboard_audit FAIL 1+WARN 5=基线原样零新增(R17 zf 费用覆盖既有挂账 + 5 产品成本权威缺失已知欠账)。新坑:e2e 首跑(10:08-10:11)尾段连环 401+看板超时,定性=并行会话 pen_tests 尾部 logout-all 吊销 owner 全设备会话跨门互杀(非代码缺陷,重跑全绿证实)——后续任何两套门并跑,先错峰 pen_tests 的 logout-all 或改用独立测试账号。沉淀 口径辨析三轴(Keepa 13 站 vs 全平台、款数 vs ASIN 数、分母只随 Keepa 范围演化);memory-longterm §217(10-11 广告战役欠档今补)+§218 本节点。sum(spends) s 起别名 s,外层却写 avg(spends)——引用子查询输出里不存在的列名(应为 avg(s)),UndefinedColumn;同表 _series() 直查无误。该路径此前只测过 amazon accept 与 SQL 直插的 MANUAL_STOP,Noon accept 首次被真实点击才暴露。修复 avg(spends)→avg(s) 一处;api+worker 双 build 重启(worker 横幅 68 函数含 daily_ads_followups ✓)。补执行 与用户所点完全一致 body {decision:accept} 经 caddy 重发:#29/#28 均 200→monitoring+manual-ops(Noon 无 API 人工单);baseline 已落库(avg_daily_spend 67.41 / 13.8 本币 SAR),回访 base_date=2026-10-11 装订。坑 SQL 子查询别名内外不一致编译期不报错、运行期才炸;决策三分支(amazon-api / noon-manual / reject)各有独占代码路径,冒烟须逐分支覆盖。{产品名}/{sp|sb|sd}/{auto|manu}/{keywords|products|category}/{YYYYMMDD};api/ads_naming.py:parse_name 解析存量四形态(规范 5 段名短路的 / 「H24 SP Keywords Manu 0808」尾日期 / 「FG-AU-2415-SP-KW-Exact」复合 dashed / 「Airfit Neo SP Auto」常规 token),家族最长前缀匹配('H24 Product&Category'→'H24');主键永远 campaign_id,名字解析只是分组加速器(铁则)。②家族映射表=唯一注册处 ads_campaign_family(pg-init/89,30 条种子,zf/fg/onno 三品牌);GET/POST /api/ads/rename/family 增改(source=manual 不被种子覆盖);未映射家族在计划中标 unmapped 跳过执行——先补表再跑(mapping 宪法:唯一注册处、数据正向生成)。③存量改名(已执行) GET /api/ads/rename 计划(90 天窗 DISTINCT ON 每 id 最新行,默认仅 ENABLED,all_status 看全量)+ POST /api/ads/rename/apply 逐条落 ads_campaign_rename 历史;53/53 成功(zf 15 / fg 35 / onno 3,campaign_id 不变);同 profile 撞名自动产品段 -2 后缀(US 两条 2417 keyword campaign 实证);1 条「SP ASIN Targeting Manu 0807」(zf SA)无家族前缀 unmapped,待人工归族后重跑。④onno 停投(7.4 决议,已执行) Amazon EU 剩余 3 条 ENABLED——IT 195017604097068 / SE 20001839184874 / UK 133384910830801——经 SP v3 API PAUSED(onno 跑 zf 卖家账号内→凭证按 zipforce);Noon 2 条(AE「Dual Cameran Auto」/ SA「Dual lense auto」)入人工操作单(monitoring+manual-ops,web 建议 tab ✓已办回执闭环);5 条 MANUAL_STOP 建议行(Amazon 3 条 executed_by=api 带 executed_at、Noon 2 条待回执),base_date=2026-10-11 起 3/7/15/30/60/90 全程回访。⑤Noon 人工改名清单 无 API→人工:/api/ads/rename?platform=noon 导出 57 条;其中 onno 2 条停投 campaign 须等 30d 检查点后再改(Noon 回访按名匹配,见 #73)。⑥部署与验证 api/Dockerfile COPY 清单补 ads_naming.py(容器 ModuleNotFoundError 即修);api+worker 双 build;端点经 caddy 实数据冒烟(rename 19 条租户内 / family 24 / 未映射 1 条如实标注);四道门 P2 全绿后本轮未整跑(增量路由+组件+数据执行,无既有面改动),验证=实数据冒烟+双 build+web 渲染。{"code":"NOT_FOUND","details":"Method Not Found"} → 定性:v2 SP 资源端点整体退役(含 GET)。此前 P2 按 v2 规范改的「集合路径修复」从未对真实 API 成功——即当时 Accept 执行实际全部走失败兜底(转人工提示),非偶发。②v3 新契约(逐项探针实证) POST /sp/{campaigns|keywords}/list 翻页:body {maxPageSize≤100, pageToken} → {resource[], nextPageToken};写=PUT /sp/{resource} body {resource:[patch...]} → 207 {resource:{error:[], success:[{campaignId,index}]}};每资源独立 vendor Content-Type:campaigns=application/vnd.spcampaign.v3+json、keywords=application/vnd.spkeyword.v3+json(415 错误提示探得);keywords 路径为复数;state 大写枚举(ENABLED/PAUSED);budget 嵌套 {budget, budgetType:"DAILY"};同 profile 内 campaign 名必须唯一。③移植(api/ads_exec.py) _sp3_headers/_sp3_list(maxPageSize=100 翻页聚合)/_sp3_put(207 逐项 error/success 判定;逐项 404/403→not_found 标记)统一通道;exec_action(pause/enable/budget/keyword 级 pause+update_bid,_find_keyword_in_campaign 改 list+客户端 campaignId 过滤+大写 matchType)、exec_campaign_action、exec_campaign_rename 全部切 v3;跨 profile 遍历兜底保留(not_found 续探)。④实测 53/53 改名成功(52 条幂等 no-op+1 条撞名修复);onno EU 3 条 pause 逐条成功(见 #76);state/budget 契约以 list 响应实形状佐证——真实写探针最小化,仅改名与停投两类业务必要写操作实发。⑤沉淀 v2 退役+v3 契约全貌记入 memory(ads-advisor-spec):后续任何 Amazon Ads 写操作一律走 v3。asyncio.to_thread(sync_source.ingest_all, tables=_ads_import_targets(...))——staging+cleaned 一次到位,不再等 04:30 夜批;#66 P0-2 事件循环阻塞教训直防(同步重活必 to_thread)。档名→(brand,platform,csv) 新增 _ads_slot_brand 映射(zf/fg/onno 前缀 + -ads-csv 后缀判 CSV 通道)。入库失败只打日志不拦下一档(04:30 ingest_mercury_daily 降级为兜底,注释在案)。rules_ads 读 staging(ads_search_terms_daily/sales_daily)+ 晨报读 cleaned,两层都由 ingest_all 覆盖。③接力时刻 ads-audit 08:00→22:40(读 mars 源表不等入库,含 P0 完整性校验);daily_ads_rules 05:40→23:00(三窗口建议,晚间档入库完成后);collab.py 任务目录 cron_utc 标签同步更新。验证 _ads_plan()={19:zf-ads, 20:zf-ads-attr, 21:fg-ads, 22:[fg-ads-attr, onno-ads-csv]} ✓;_ads_slot_brand 五档名全对 ✓;当前小时干跑 skipped 无副作用 ✓;api+worker 双 build 重启(横幅含新函数无异常)。四道门 pen_tests ALL PASS|audit_nodes ALL PASS|dashboard_audit 首跑 10 红(noon KPI api=None ×10)——复跑归零 FAIL 1+WARN 5=基线精确(§85 同律:api 重启后首轮门预热超时,手动复现端点数据完全正确 gmv=57,466.59 逐位一致)|frontend_e2e ALL PASS。今晚 19:00 UTC(北京 03:00)zf-ads 首个自然档带档后入库,missed_slot_sweep+daily_pipe_alarm 双保险兜底,下会话核验。public.amazon_ads_campaigns(zf+fg SP 报表:本币 cost/sales_1d + sync 侧 fxd 逐日折算 spend_usd/sales_usd + campaign_status/budget_amount/bidding_strategy/currency,复合 PRIMARY KEY——_discover_tables 只认 PK/UNIQUE 约束不认唯一索引,否则 no_pk);public.amazon_ads_advertised_products(campaign→SKU 证据表,无金额,120 天滚动窗有界)。键列 NOT NULL DEFAULT ''(ON CONFLICT 裸列对 NULL 永不触发,pg-init/76 教训)。已手动应用于生产 saas_registry。②sync_source 两 spec campaign 分支 SP-only(SB 两账号 0 行/SD 仅 1 行试验,sb/sd 列族未证同构,ad_product 列预留);更新列含 campaign_name/campaign_status/budget_amount(P5 存量改名与快照执行检测依赖)。坑即修:类型串手写 18 字符 vs 17 列错位(zip 按位配对,purchases 后全体错档必崩/截断),修为精确 tdtttttiinninntnt。③clean_audit SPECIAL_TABLES[campaign 层]:campaign_brand_fix——campaign 报表无 SKU 列,以 advertised_products 证据×sku_mapping 按 campaign_id 多数投票归属(与 ads_audit #54 同口径;无证据兜底卖家品牌=账号宪法键),1,022 行 zf→onno 归属纠正入 dirty 日志可追溯;VIRTUAL_SPECS[noon_ads_campaign]:Noon campaign 分析层一律 ad_type='sp' 单粒度(sp/offer/target 三粒度同额三写,非'all'混加=×3 双计铁则),pk 含 sku(同 campaign 同日多 SKU 行合法),run() 随 noon_ads_daily 自动挂载。连带 bug 即修:campaign_brand_fix 预扫描复用 sku_brand_map 变量后,通用 brand_fix 块守卫失效误取 cfg['brand_fix'] KeyError——该表首轮清洗静默失败,加 cfg 守卫修复(直接跑 clean 才暴露,ingest 返回值不带清洗错误)。④tasks.py _ads_import_targets API 通道(zf/fg)+= 两新表(recompute 分支同步),手动导入即全链。⑤ads_audit 新 audit_integrity:D-1 缺档检测(近 7 天有数据 + 当日 0 行 → 🚨 显式报,zf/fg-amazon-campaign + zf/onno-noon 四源)——首跑即抓 onno-noon 10-10 缺档,深挖实证 10-06/10-07/10-10 三天真缺(10-08/10-09 在,非档期时序),采集侧独立修复项挂账;audit_noon 顺修 ×3 双计(原 ad_type<>'all' 求和把三粒度同额行混加,改 ad_type='sp' 单粒度,与虚拟层同律)。验证(全对上) cleaned_amazon_ads_campaigns 近 30 天:fg $2,346/$6,337 精确匹配独立 fxd 口径;zf $333 + onno $278 = $611 精确匹配(归属拆分后总额不变);7,499 行全量(04-26 起)、9 币种、budget 4,143 行/bidding 全行;cleaned_noon_ads_campaign:zf AE/SA 两国 sp 与 all 层 100% 精确相等(sp=近全量 campaign 粒度铁则实证,SA 22,436 同额);onno sp 覆盖仅 17-20%=源头稀疏(campaign 层如实反映,总额仍归 all 层)。三层 cleaned 表 portal_app 授权 ✓。四道门(HOST 错峰单跑) pen_tests ALL PASS|audit_nodes ALL PASS(172 端点/2,431 节点)|dashboard_audit FAIL 1+WARN 5=基线精确(R17 zf 08-31 费用覆盖+5 成本债;首跑 kpi-pool not-authenticated 为容器重启预热瞬态,复跑归零)|frontend_e2e ALL PASS。api+worker 双 build 双重启(镜像 baked 铁律)。挂账 onno-noon 三天空档(10-06/07/10)补拉+采集节奏排查;zf campaign 10-09 缺档补拉(zf-ads 重跑);onno Amazon CSV 通道无 campaign 报表(7.1 人工单模式,数据面天然受限如实记)。public.noon_ads_daily(10-10)均活,唯 audit.cleaned_noon_ads_daily 停 10-07(zf)/10-05(onno);上午定向修复 ingest_all(tables=[noon 三表]) 同步 57,303 行且 clean-511f66ad7149「跑完」但水位不动——重跑带日志抓到 ✗ noon_ads_daily 清洗失败: 'int' object is not iterable,traceback 落 clean_audit.py:534 log_dirty(..., "|".join(str(k) for k in key))。根因链 ①清洗引擎对单列主键表做标量优化(key = r[colidx[single_pk]],458 万行表省数倍内存,key=int);②10-05 staging 最细化改造(pg-init/76)给 public.noon_ads_daily 换上单列 id PRIMARY KEY → single_pk 生效;③同日上线的 agg_shadow_dedup 在 10-05~10-07 期间从未有行走进该分支(无「'all' 日 + 细粒度行」并存),10-08 onno / 10-09 zf 的 target/offer/sp 细粒度行第一次与 'all' 聚合行同日并存 → 第一次触发 agg_shadowed 的 log_dirty → 迭代 int 崩 → savepoint 回滚该表、不阻断其他表 = 每轮清洗静默失败三天(run 层 stats 只记 error 字符串,无告警面)。修复 key_disp = (key,) if single_pk else key 一行 + 11 处 dirty-log join 换 key_disp(duplicate/asin_twin/case_twin/agg_shadowed/product_shadowed/campaign_shadowed/missing_pk/ccy_filled/brand_fix/onno_country_dedup/missing_field 全覆盖);api+worker 双 build(横幅 64 函数核对✓)。验证 clean-13f17de5201f 3/3 表成功(含虚拟层 sku_attr/finest);cleaned 水位 zf→10-10 / onno→10-09(onno 源头仅到 10-09,已追平);167,337 条细粒度行按设计入 agg_shadowed 脏日志('all' 聚合真值遮蔽防多计,2026-10-05 口径);次日起 04:30 常规链自动接管(当日 300s 超时杀因已由 P0-1 job_timeout=21600 根治)。连带修复·ads-audit Noon 盲区 adapters/ads_audit.py audit_noon 查 zipforce_noon.noon_ads_daily——该表从不存在(实表 {sch}.{sch}_ads_skus,列名 report_date/views/spends、无 campaign_id),Noon 审计自六期上线起每日 ⚠️ 静默跳过。重写为 zf+onno 双源 campaign 级 CTR 聚合(排除 ad_type='all' 聚合行防与细粒度双计,[daily_total] 行剔除,阈值 CTR<0.3%+views>500+spend>10 不变);宿主挂载零 rebuild,08:24 实跑无跳过警告、1 条 amazon 建议照常(zf AE T11 SP Auto CTR 0.16%)。四道门(错峰单跑) pen_tests ALL PASS|audit_nodes ALL PASS|frontend_e2e ALL PASS|dashboard_audit FAIL 1+WARN 5=基线精确(R17 zf 08-31 费用覆盖+已知成本欠账;首轮 4 额外红为 api 重启后预热瞬态,复跑归零——重启后首轮门让子弹飞一会)。坑 数据形态依赖分支('all'+细粒度同日并存)上线 3 天才第一次触发——全局路径优化(标量 key)叠后续新增调用面(log_dirty join)=潜伏雷,本次顺带把 11 处 join 全收口;单列 int 主键表今后再进任何 dirty 分支都不会再崩。修复后 cleaned 水位单轮跳 3 天属预期非异常。default/p2(回溯低优)/dlq(死信);优先级 enqueue_job(_queue=) + default 队列优先消费;租户信号量 tenant_sem(Redis sem:{tenant}:{cls} incr/expire 86400,超限 defer 600s 重排,finally rel() 释放——本次实测抓到 backfill_order_refund 信号量泄漏(异常路径不释放)并修复三处 rel=None 初始化 + finally 兜底,Redis 残值 0 实证);missed-slot 补跑 每 10 分钟扫描 collection_slot 注册(collection_cycle 3h / sales 26h / ads 30h / settlements 8d),档期被阻塞击穿(#66 P0-2 同源)自动补发并打 missed_slot 事件;DLQ 重试耗尽入 arq:dlq 列表,/api/ops/dlq 面板 list/retry/drop(仅 owner/admin)。模块3 三类回溯(api/backfill.py + routers/backfill.py + pg-init/84):backfill_ad(ads-attr 深窗重拉,注册表 60d 硬限,CSV 通道拒)/ backfill_order_refund(finances 滚动重拉 + derive 回放,amazon 731d / noon 180d,双时间口径 order_created|refund_posted)/ recalc_order_metric(不调外部 API:前置快照 → canonical clean_audit 重跑 → 差异报表 → 出错按快照回滚窗口行,RULE_VERSION=2026-10-v1 可追溯)。全走 P2 队列 + 单租户同类并发=1 信号量;JSONB 行级快照分片≤1000 行断点续传;dry-run 只算差异不写库;admin-only API + audit_log 全链路审计 + backfill_runs/backfill_snapshots(RLS FORCE tenant_isolation);web 面板 /finance 页「回溯任务」卡(发起/进度/diff_report/取消 + 最大回溯窗提示)。部署与实测修复链(发四修四,全实证):①migration 84 首版漏 sequence USAGE → portal_app INSERT 500(补 GRANT USAGE, SELECT ON SEQUENCE,#83 教训同源);②zlog @job 与业务函数 status kwarg 碰撞(装饰器记录字段名改 job_status);③psycopg2 dict 绑定不支持(_set_run jsonb 参数改 _jsonb 字符串化);④routers/backfill.py Flask 惯用语混入 FastAPI(全量重写);⑤信号量泄漏(见模块2)。全部修后 docker compose build api worker 热更(镜像 baked 铁律)。⑥上线后 P0 即断即修(07:30 档验证抓到,47 分钟闭环):_slotmark_after 包装器只回填 __name__ 不保 __qualname__——arq 函数注册表/cron 档期按 qualname 键,6 个 watched-slot 函数(collection_cycle/sales/ads/settlements/ingest_mercury_daily/rankings)塌缩成同名 _slotmark_after.<locals>._w 互相覆盖,实际只剩最后注册的 rankings:06:51 部署起 07:00/07:30 档全跑成 rankings(worker 日志实证),每小时订单采集链静默断流。修复=functools.wraps 保名(zlog.job 本就 wraps 无恙,只补 slotmark 层)。重建重启后横幅 64 函数(原 54)全部独立命名 ✓;损失盘点:唯 07:30 collection_cycle 一档真实欠账(07:00 广告档=注册表计划 UTC 02/03/05 时本就空转,sales 分钟档小时自判无动作,settlements 周一档/settlements 结算/mercury 日档未到期),catchup 手动补跑 07:39:11→07:44:55 done(344s,fg/onno/zf-amazon 三链 rc=0,onno 55/55、zf 150 单刷新)。教训:包装器必须 functools.wraps(或至少显式回填 __qualname__),同名塌缩在 arq 注册表是静默的——横幅函数数 54 是异常信号(6 个名字消失),以后部署后核对横幅函数数=源函数数。自然档终验(08:41:38):08:30 自然档 collection_cycle 正常起跑并完成(697.99s,fg/onno/zf 三链 rc=0,worker.log `08:30:00 → cron:collection_cycle()`)——修复在真实 cron 档位上闭环确认(另:监视器 grep `cron:collection_cycle` 两次前缀误报 `_sales` 行,exact 标记也须词边界,本次以 worker.log 直查为准)。recon 勾稽口径发现(如实暴露,不改代码):月度恒等式 订单额−佣金/尾程/促销费用 ≈ 结算净回款 在实测中 gap 28%~828%(worker 实测 ERROR backfill.recon.exceed:zipforce 827.75% / onno 487.52%)——根因=结构性口径缺口非 bug:cleaned_amazon_settlement_monthly.payout_usd 是实回款口径(含 2025-06 负回款月 −6,560.78 实证),恒等式右侧缺退款金额列(refund 仅 units 口径)→ 差异全部进容差外告警。对应设计文档风险#4「勾稽恒等式两侧行业口径不齐」,处置=保留告警不放宽 2% 容差(宁噪勿漏),月度退款金额列入注册口径后复评。实测记录:backfill_runs 1-5 留存(tenant1 审计证据)——runs 2/3/4 zipforce backfill_ad/order_refund/recalc 全 done,run 5 onno order_refund dry-run 07:00:48 done(diff_report 完整、progress.api_calls 缺省=零外部调用实证);cron 实况核对:collection_cycle 档=每小时第 30 分(非整点,tasks.py cron(minute=30)),worker 06:51:31 重启(54 函数含三 backfill + missed_slot_sweep + _slotmark 包装器)后首轮 07:30 UTC。四门(HOST,qualname 修复后终跑):pen_tests ALL PASS——新增 N 段(回溯+DLQ 安全矩阵 12 断言:未登录 401/员工 403/超窗 400/跨租户品牌 400/limits 只含本租户/dry-run 全链 done+diff_report/终态 cancel 400/RLS 列表隔离/DLQ 越界 404+员工 drop 403)+ O 段(zlog 单测 8 断言:脱敏/采样/DEBUG 门/ERROR 全字段/job 入死信原样 args/trace 子进程透传);audit_nodes ALL PASS(172 端点/2,774 节点,backfill 面数据面 EXCLUDE 不建第二引擎);frontend_e2e ALL PASS(新增第 19 段:回溯面板全状态);dashboard_audit FAIL 1+WARN 5=基线精确(首跑 4 条额外红=与 e2e 并发抢站的 429/图表注释瞬态,复跑即净——两门必须错峰单跑)。设计文档 docs/p0-enhancements-2026-10-11.md(含 8 项输出与 P0 优先上线顺序、模块0 五断流闭环引用 #65/#66)。挂账:recon 容差 2% 待月度退款金额列进注册口径后复评;结算批次历史回补需适配器扩展(backfill.py docstring 在案);LWA 凭证硬编码(#66 同账);凭证仅路径引用。pg-init/82-collect-noon-full-scalar-20261011.sql 幂等迁移(UPDATE 3 行,全新初始化环境同态)+ api 容器实测 _collect_channel('noon_full') 返回全 str 元组;补跑 zf-noon/onno-noon rc=0(行为与 10-08 最后成功一致:Noon 平台侧 3 接口不可用为既有状态,Content Rejections 正常同步);06:20 起自动恢复调度。全注册表形状审计:orders/finances/ads/settle/sales_fba/night/noon/noon_full 全部符合消费方预期,无同类地雷。③促销返点卡空白三层穿透(e2e 挖出,定性反转):zf 页「分国家促销返点」新空白——初判广告数据停旧档是错的。实证链:广告表无辜(zf-ads 补跑后 campaigns/advertised 均到 10-10 最新)→ 该卡读 audit.cleaned_amazon_orders.promo_usd(spapi 财务事件,非广告)→ 逐层核对 raw(24 单)/order_fees(24 单, 新鲜)/amazon_orders(4 单)——最后在分支 SQL 探针+品牌拆分定案:全月 24 张 promo 单中 22 张是 onno 代卖单(zf 账号卖 onno 货,品牌归因归 onno),zf 真实 9 月促销仅 2 单 $6.5;30 天窗滑出 8 月(98 单)后窗内真零=如实空白,非断流非 bug。处理=BLANK_ALLOW 加 zf 页白名单(与「分国家退款件数」同款,有注释;zf 再做促销即自愈)。同挖出 4 个真实新案(见④挂账)。④本次连环挖出的管道缺陷(如实记):(a) sku_mapping 同步断裂——10-10 导入把 sku_mapping 改为租户盖章制(唯一键加 tenant_id 五坐标,ops.py 会话盖章),sync_source 旧四列 ON CONFLICT 键不再匹配→每日全量 ingest 该表 InvalidColumnReference(今晨 02:13 实证,savepoint 单表失败不阻塞其余表但每日报警+该域断更);后台无租户同步与租户盖章制结构性冲突,删除该 spec 或改经租户通道待拍板。(b) 今晨 02:13 周档 cron 300s 超时把 ingest_mercury_weekly/ingest_today 拦腰截断(清洗阶段没跑完)。(c) 手动全量 ingest 在 api 容器 OOM(rc=137)——orders 全量 fetchall 与 82 表清洗同进程内存叠加;同引擎同数据在宿主直跑无此问题(引擎自身没问题,是容器内存上限)——已用「先 ingest(提交) 后单独跑清洗」两步完成同等效果。(d) 宿主 tools/audit_db_clean.py 是旧引擎(无 _grant_and_rls:不恢复 portal_app 授权/RLS/索引)——误用两轮后 dashboard 全 500(InsufficientPrivilege 实证),已用 api 容器内 canonical 引擎 clean_audit.run 定向重建 2 表恢复(portal_app+mcp_read 授权、brand_isolation RLS、索引全部回位实证);教训入册:清洗一律走 api 容器内 clean_audit,宿主旧工具停用。门禁终态(如实呈报):audit_nodes ALL PASS|dashboard_audit FAIL 1+WARN 5=已知基线零新增(FAIL=R17 zf 08-31 费用覆盖,WARN=sku_mapping 5 产品成本欠账)|pen_tests FAIL L「task created+approved」——非本次回归:products.category 存产品线名(09-05 初始导入起)vs validator 只认 product_categories 的已知数据债(测试注释 10-05 在案),此前靠前 20 候选含空类目商品兜底,10-10 mapping 导入后商品排序变化使前 20 候选恰好全为带品名类目老商品→兜底耗尽|frontend_e2e:429 限流瞬态复跑即消+促销返点真零白名单收编(见③),终跑全绿。挂账:products.category 品名污染的规范化修复(taxonomy 对齐/宽松回退/测试候选扩池三选一待拍板);④(a) sku_mapping 同步通道删除/改造待拍板;onno 订单 promo 列 NULL(onno 模板不聚合 promo,onno 22 张 promo 单在 order_fees 有、amazon_orders 无——onno 促销返点展示缺失,改 onno 模板加 promo LATERAL 聚合,需 api 镜像重建);④(b)(c) ingest 排程超时/容器内存两运维项;P0-2 排程缺陷(分钟档精确匹配被队列延迟击穿:fg-derive 09-24 起未跑、onno-derive 重复);P0-3 zf 无 derive 适配器(zf_refunds 停 05-26);P0-4 fg-settle 批次 06-29 起静默零;P0-5 onno finances 事件长零——均已定性待批准执行。边界:只动 /opt/collection 适配器(宿主挂载零 build)+ saas_registry 注册表数据/清洗层 + pg-init 迁移 + frontend_e2e.py 白名单;api/worker 镜像未动(dashboard.py 曾改后还原,零残留);订单数据一字未删(要保留所有订单);凭证仅路径引用。A · sku_mapping 同步通道五处原子删除:sync_source 里的 sku_mapping 通道是逆向通道——从采集侧 shared.mapping_* 反推注册表,违宪(mapping=唯一注册处,写入只走 ops.py 租户会话盖章),且四列 ON CONFLICT 与五列租户唯一键 uq_sku_mapping_registration(tenant_id,brand,sku,platform,country) 结构不兼容,每日 InvalidColumnReference 报警断更(sync 从未成功写入过一行,注册表 1,132 行全部 ops.py 源)。删除=五处同刀:静态 _MAP_FULL 常量、_MAPFULL_BRANCH、_build_map_full、_SPECS 元组、_refresh_dynamic_specs 动态注册行(_set_spec_sql 对缺失 spec 抛 KeyError,删除必须原子)。读取方向保留(_build_map_sku/margin 回填等正向消费不动)。镜像重建+重启后 smoke:specs n=29 无 sku_mapping。
B · onno 促销返点补齐:_ORDERS_ONNO_TPL 的 promo 列原恒 NULL——onno 订单促销返点加 pr LATERAL 从双 schema finances 事件聚合(zf 代卖事件在 zipforce_amazon、onno 自营在 onno_amazon,与 oi 双 schema 同构),逐行 fxd 折 USD 保留结算负号口径(对齐 master 的 settlement_promo_usd;order_fees 是 abs 口径,两者并存)。全窗 orders 同步 42,163 行,onno promo≠0 落库 550 行;清洗层 427 行 / −8,363.98 USD(原为 0)。展示面自检(zf 租户 /finance + 品牌切 onno,品牌×月度矩阵「促销 Promotion」列):桌面 1600 视口 / 手机 390 视口;订单页 promo 列桌面 1600 / 390。取证坑(如实记):Playwright scroll_into_view_if_needed 在本页不生效(smooth 滚动被图表回流吃掉,is_visible 只查非零盒不查视口相交,首拍两张均为页顶错帧)——改 JS 强制 instant 双滚 + getBoundingClientRect 数值断言(桌面 th(855,483)/手机 th(134,405) 双双落视口)后重拍,DOM 直取 onno 促销值 2026-08=$7,987.54 / 09=$380.62 / 10=$0.23(=order_fees abs 口径,页面消费面实测口径与月报 promo_usd 口径并存非 bug)。
C · products.category 类目污染治理:1,142 行类目被 model_name(品名)冒充(product_categories 分类学 20 值之外,listing 创建 400、pen L 候选池枯竭)。三刀:①数据清洗 1,142→NULL;②源头停写——_products_sql 的 nullif(m.model_name,'')→NULL::text;③category 移出 spec 更新列(类目=注册表正向编辑字段,ops/onboarding 写入后 sync 不覆写)。清洗层污染 0,pen L 用例复活全绿。自检截图:products 页类目空(1600)。
P0-2 · 采集 job 事件循环阻塞根治:collection_* 14 处 subprocess 同步直跑独占 arq 事件循环——分钟档 job(collection_cycle_sales 精确分钟匹配)被 03:30 订单链阻塞 644s 后 minute!=d 静默 skip(fg-derive 09-24 起丢)、队列排空恰落匹配分钟则连跑多份(onno-derive 重复)。统一 await _arun(...) = asyncio.to_thread(#44 ingest 同款)。镜像重建+重启。
P0-3 · zf 退款明细派生链新建:zf_spapi_refunds 自 2026-05-26 起 168 天零增量(mercury JS-CSV 遗产链停更,无 derive 适配器)。新建 adapters/zf_derive.py:源=settlement_items 扁平行(event_data 恒 NULL 无 item 拆分,charge/fee 忠实直存),只派生 Refund(ServiceFee 575/DebtRecovery 135/ProductAdsPayment 137 源 posted_date 全 NULL 且无消费面);marketplace_name=订单表 country 反查(_REFUND_BRANCH CASE 的精确逆映射 13 站,表外国家写原码走正向 ELSE 透传,往返无损);防双算=cutoff max(posted_date)−7d 回渗窗 + 反连接 (order,posted_date,sku,quantity)(mercury 遗产行金额拆列口径不同,同事件两行会在 monthly sum(quantity) 双算)+ ON CONFLICT DO NOTHING 二层兜底;--since 显式全史回填。注册 config.ADAPTERS+BRAND_OF,pg-init/83 jsonb_set 外科式登记 collect.night=[["zf-derive",40]](03:40,fg-derive 30/onno-derive 45 之间;绝不全量替换 source_map——78 号起的 refund/rankings/orders_tpl 等键与跨租户主键 (tenant_id,brand,platform) 不动)。回填:SI 1,000 行 Refund(2024-12-26→10-08)→ 派生 747 / 防双算跳过 253;明细表 994 行水位 2026-10-08。月度消费面:zf 退款月度从停更 05 月恢复到 10 月(06/07/08/09/10 月=36/52/37/14/7 件,找回 146 件)。口径自检:月度 959 件 vs 源 961 件(0.2% 保守方向,防双算守卫边界);44 行非 ZF 前缀 SKU 为注册口径 pref=ZF% 固有范围。自检截图(/pipeline 退款明细水位 2026-10-08):1600 / 390。
P0-5 · onno_derive DSN 硬编码修复(定性反转):onno finances 采集活着,真凶=onno_derive.py 硬编码外部冻结库 DSN——派生读旧库事件且写回旧库(违宪),Mars 本机 onno_spapi_refunds 永停 1 行/08-14。改走 config.DB_DSN + 400 天回填:refunds 42→41+6 adjustments(watermark 2026-10-10)。
fg-derive 积压补跑(P0-2 数据找回):09-24 watermark 起积压 14,005 事件——补跑找回 refunds 167 / adjustments 25 / debt_recovery 69 / service_fees 13,749;fg 退款月度 2026-09=230 件、2026-10=105 件(原 10 月全缺)。
P0-4 · 定性反转不改代码:fg-settle 批次活着(weekly 周一链,10-05 八批次在),仅 cleaned 月度滞后一月——挂账待 10-12 周一链后复验;fg_settlements.py:30-46 硬编码 LWA 凭证为路径外债(凭据不外印)。
四门(HOST):pen_tests ALL PASS(L 用例复活——污染类目清理后候选池重生)|audit_nodes ALL PASS(172 端点/2,507 数值节点)|dashboard_audit FAIL 1+WARN 5=基线精确匹配(R17 zf 08-31 费用覆盖+5 成本债;首跑 kpi-pool 2×not-authenticated 为 api 瞬时竞态,复跑即净)|frontend_e2e ALL PASS(9 页像素空白 0 新增、工作台全状态组合扫 0 异常)。
api/sync_source.py(五处原子删+promo LATERAL+products 类目)|api/tasks.py(_arun×14)|/opt/collection/adapters/zf_derive.py(新)+config 注册|pg-init/83-zf-derive-night-20261011.sql|/opt/collection/adapters/onno_derive.py(DSN)。数据修复:products 1,142 行类目→NULL;onno promo 427 行/−8,363.98 USD;zf refunds +747 行(05-26→10-08 补齐);fg refunds +167 等;amazon_refund_monthly 三次重拉+清洗。挂账:fg cleaned 月度滞后一月待 10-12 复验;LWA 凭证硬编码(fg_settlements.py:30-46);44 行非 ZF 前缀 SKU 退款在注册口径外;dashboard_audit 首跑偶发 auth 竞态待观察。https://changelog.zipforcehub.com/zipforce-hub-full-2026-10-10.md(caddy file_server 直出,导航 14 页全量合一约 1MB);页头导航首位加「⬇ 下载全站 MD(14 tab 合一)」按钮(download 属性强制落盘),与既有 changelog.md 按钮并列(后者同步改标 407 条目)。结构=每页「# N. tab名 + 源页面链接」+ 页内标题统一降一级(h1→##/h2→###/h3→####;changelog 日期###/条目####+锚点),词汇表 gl/gm 伪表转 md 表(列头固定五列/三列),mermaid 保留 ```mermaid 围栏,系统手册页喂 Playwright 渲染后 DOM(全站唯一 JS 造表页,/tmp/_render_manual.py 存档)。转换器四缺陷修复(/tmp/hubfull2md.py v3→v6,逐个实证后修):①行内层死正则——旧 inline_md 的 a/code/b 正则作用在只含解码纯文本的 buf 上全是死代码,全站 md 链接数实际为 0(href 全丢,仅锚文本),且 <[^>]+> 剥离把源文裸「<+数字/中文」文本(如「断货风险 days<7 / 长期仓储>366天」)从 < 误吞到下一个 >——改为事件驱动行内转换(a→\[text\](href)、b/strong→**、code→`、em/i→*、s→~~),全站 433 链接逐一对账 433/433;②游离闭标签清栈——某安全事件条目 code 文本里裸写 </head>(浏览器对 body 内游离闭标签直接忽略,旧转换器却 pop 清空整个栈,导致该条目后半 3 个 span 全丢)——补「栈内无此标签即忽略」浏览器同构守卫;③无 span 的 kv div 直属行内内容(b/链接/尾巴,如「截图自检」行)无落点整行丢——kv div 补 loose 收口成 bullet;④词汇表 gl/gm 单元格文本落 loose 而 pseudo 收口读 buf,645 行整列空——伪表行内 div 统一 buf+嵌套(gl-csv-it 多值)上浮。两页 head 腐染修复:api-field-dictionary.html / field-coverage-audit.html 各含 7787B 旧数据链路页整页内嵌 <head> 内(与 /audit/data-lineage-2026-09-18.html 逐字节同源的 7029B 块),HTML5 解析下 head 内 div 被当正文渲染——线上双导航条+双 h1 叠渲染(Playwright 实证 2→1);删除后 api-dict 246014→238227B、field-coverage 38679→30892B,div/span 标签全平衡,修前备份 /tmp/hub-backup-20261010/。覆盖审计(铁律自检):源文本节点级全量对账(/tmp/hub_audit3.py——与转换器同跳过逻辑解析源页,节点归一化剥 md 行内语法+全空白后子串匹配)——14 页合计 31,537 个文本节点 0 缺失;每页结构计数(标题/表行/details/fld/pre 围栏)全对齐;每页 <a href> 对 \[text\](href) 433/433。changelog.md 同步重生成:单页 md 改为从全站 md 抽取 changelog 段降一级标题生成(/tmp/gen_changelog_md.py),与全站 md 同引擎同内容——顺带修复其 v3 同源缺陷(链接数 0、「(分市场 广告 SA 28,609」「断货风险 days<7」等 kv 尾文本缺)。ENABLE+FORCE ROW LEVEL SECURITY + 策略 tenant_isolation FOR ALL USING/WITH CHECK tenant_id=app_tenant_id() TO PUBLIC(app_tenant_id()=NULLIF(current_setting)→fail-closed);平价固化 pg-init/81-rls-collection-schedule-tenant-accounts-20261010.sql(全新 docker-entrypoint 环境同态)。至此 tenant_id 基表 75 张全数 RLS(注销归档/清除的动态枚举自动从 74→75——新表 by-design 自动纳入)。SELECT 授权失窃案(透明披露):开 RLS 后 portal_app 探针即报 permission denied for table collection_schedule——表级 SELECT 被不明路径撤掉(#61 的 17 表授权是 DELETE-only、从未给过该表 SELECT,但 #61 当日 14:18-14:25 归档+14:42 清除以 portal_app 实跑成功证明 SELECT 当时在;14:42→16:20 窗口内消失,repo/crontab/monitor 全查无 REVOKE 记录,根因不可归因,疑似视野外操作者)→ 修复=线上 GRANT SELECT + pen_tests M 双金丝雀:(M1) portal_app 对全部 tenant_id 基表的 SELECT 覆盖逐表对账(role_table_grants LEFT JOIN,缺一即红);(M2) 两表 tenant_isolation 策略在位计数==2——今后任何静默撤权直接红门。种子触发器提权:trg_collection_schedule_tenant/brand(tenants/brands_source INSERT 时代写 collection_schedule)改 SECURITY DEFINER SET search_path=public——注册场景存在 RLS 鸡生蛋问题(新租户 id 尚未回填时无 app.tenant_id 上下文,触发器必须以属主 saas_admin 身份写)。超管通道复核零影响:saas_admin superuser+BYPASSRLS(FORCE 不拦)——宿主 collection_scheduler(每分钟 docker exec psql -U saas_admin)、审计四门、noon_webhook_consumer、clean_audit 策略子查询(definer 语义)全不受影响;portal_app 探针四态:t1 上下文见 14 行/t2 见 4/t3 见 3/无上下文 0 行/跨租户 INSERT 拒绝。zzofftest3 全链复证(RLS 生效后的注销流):offboard→75 表 3 行归档(collection_schedule:1 首次在列)✓ purge tenant_deleted=true·75 表 ✓ 测试痕迹全清(audit 行/归档目录/真实租户 1·2·3 全 active 未动,collection_schedule 回 21 行)。② 归档保留期回收(#61 挂账③「归档永久留存无清理策略」):用户拍板 90 天。tasks.py 新增 ARCHIVE_RETENTION_DAYS=90 + offboarding_archive_retention(每日 07:17=清除 07:07 后 10min):规则=目录内最新 *.sql.gz 满 90 天且该 slug 无 offboarding 状态租户(冷静期中/清除失败重试中的档绝不删——purge 缺档即永久跳过,删档等于废掉清除)→ 整目录 shutil.rmtree + audit 行 tenant.archive.retire(tenant_id 从 manifest 恢复,audit_log 无 FK 永久留存;恢复 active 租户的陈旧归档同样到期回收——业务数据以库内为准,归档只是注销时点快照)。compose worker 挂载 ./offboarding:/srv/offboarding ro→rw(retention 需删档权)。回收测试抓出的真 bug(audit_log RLS WITH CHECK):首版回收写审计行报 new row violates row-level security policy for table audit_log——audit_log 的 tenant_isolation WITH CHECK 要求 tenant_id=app_tenant_id(),而回收路径的 tid 是删档后才从 manifest 恢复的、连接无上下文;purge 路径能写是因为它先 SET 了 app.tenant_id。修复=审计 INSERT 前 SET app.tenant_id=tid(0=0 同样过,无 manifest 档 tid=0)。三档回收测试(全命中后痕迹全清):zzretstale(95 天龄,无对应租户)→回收 ✓ tid=987654 从 manifest 恢复 ✓ audit 行 19428 落地(后清);zzretfresh(当日龄)→保留 ✓;zzretlive(95 天龄但 slug=offboarding 租户 id=11)→保护不删 ✓;临时租户行/审计行/残留目录全清,worker 注册 59 functions(含 cron:offboarding_archive_retention)。另实证 worker/api 双容器 UID=1000(app)——宿主 root 造的测试档属主不符会 PermissionError,真实归档由 api(1000) 创建无此问题。过时注释同步:org.py 归档循环与 tasks.py purge 循环的「collection_schedule/tenant_accounts 未开 RLS,单靠 SET 会跨租户」双保险注释更新为「显式过滤+RLS 双保险,75 表全开」——防御结构不变,事实陈述刷新。四道门:pen_tests ALL PASS(新增 M 双金丝雀首跑绿)|audit_nodes ALL PASS(172 端点)|frontend_e2e ALL PASS|dashboard_audit FAIL 1=既有 R17(zf 08-31 费用覆盖)+WARN 5=已知成本欠账——零新增红。部署:api+worker 双 build×2(首版→audit RLS 修复版),worker recreate 换 rw 挂载;DB 变更(RLS/GRANT/DEFINER)线上直用 psql 即时生效,pg-init/81 保证重建平价。挂账:SELECT 失窃根因不可归因(已有金丝雀盯防,再犯即红门);mars 侧 tenant 维度仍属跨库规划另报。changelog.md 全量下载上线(用户令「md 要可以下载」):https://changelog.zipforcehub.com/changelog.md(file_server 直出 200/960KB/text-markdown),页头导航首位加「⬇ 下载完整 MD」链接(download 属性强制落盘而非浏览器内打开);apex 侧 /audit/changelog.md 同文件同源可访问(static_content 挂载同目录)。md 生成器 /tmp/chlog2md.py(转换规则:date→##、entry h2→###+锚点、kv span→bullet、表格保留、正文裸 < 转义;源 html 本次顺带修复 5 处历史标签缺陷后全平衡 849/849·2177/2177·406/406·518/518)。输入 {slug} 以确认(slug 来自 team_meta 新增回传)+ 「发起注销」按钮(输入为空/归档中禁用)→ Confirm 弹窗(危险色)→ POST offboard 成功即 router.replace('/offboarding?due=…&just=1')。后端配套一行:org.py team_meta 回传 slug(api build 已含)。/offboarding 独立页(web/app/offboarding/page.tsx,新建):不挂 AppShell、不发任何数据请求——offboarding 租户中间件只放行 login+restore 两条 API(#61),AppShell 的 /api/me 探测会 404;query 参数经 window.location.search 于 useEffect 读取(规避 useSearchParams/Suspense 构建问题)。红色 ! 图标 + 标题「注销冷静期」+ 三要点(30 天只读封存 / 届满日期 {due} 永久清除 / 冷静期内一键恢复无损失)+ 底部提示(恢复需 owner/admin、审计永久留存)。双形态与 UX 接缝修复:注销发起后会话已全员吊销——just=1 变体若直接放「恢复」按钮,点击必 401 且 postJson 401 会硬跳 /login 丢上下文;改 just=1 变体渲染「重新登录后可恢复」锚链(附提示:登录后自动带回本页再点恢复),登录回跳变体(无 just)渲染「恢复租户,撤回注销」按钮直调 restore。/login 路由配合(web/app/login/page.tsx):登录响应新增 tenant_status='offboarding' + purge_due(auth.py,#61 已部署)→ 前端 router.replace('/offboarding?due=…') 而非 /,自救闭环:发起注销→落冷静期页→点登录→登录→自动回冷静期页→一键恢复→回工作台,全程无死链。e2e 实证(zzofftest2 临时租户,真租户零触碰):API 层——错误 confirm→400「confirm 必须回显本租户 slug」✓ offboard→200(74 表归档,purge_due=2026-11-09)✓ offboarding 期间 /api/team/users→404 ✓ 自救 login→200 带 tenant_status+purge_due ✓ restore→200 cooled_days=0 业务面复活 ✓。浏览器层(tools/_shot_1002_offboard_ui.py,桌面 1600)——A1 登录落工作台 ✓ A2 发起注销后 /offboarding?due=2026-11-09&just=1 ✓ A3a 点「重新登录后可恢复」落 /login ✓ A3b 重新登录自动回 /offboarding?due=2026-11-09 ✓ A3c 点恢复落 / 工作台 ✓;四租户危险区卡片 slug 回显逐个验证(zzofftest2/zipforce/onno/fittingirls placeholder 精确匹配)。截图自检(铁律·analyze_image 8 张全过):刚发起变体·绿横幅+届满 11-09+登录按钮 · 登录回跳变体·无横幅+恢复按钮 · 确认弹窗·标题含 slug+危险色 · 危险区卡 zzofftest2 · zipforce·slug 回显 · onno·slug 回显 · fittingirls·slug 回显 · 恢复后落地工作台(Trial 租户模块未开通的空态属预期)。视觉复核揪出并修两处:登录锚链下划线(补 textDecoration:none,web 三度 build 最后一版含此修复,curl 实证 textDecoration 已在渲染 HTML)+ 「吊锁」系小字号 OCR 误读(源码为「吊销」,无改动)。四道门:pen_tests / audit_nodes / frontend_e2e ALL PASS · dashboard_audit FAIL 1=既有 R17(zf 08-31 费用覆盖)+ WARN 5=已知成本欠账——零新增红。部署:仅 web 容器三轮 build(初始版→just=1 接缝修复→下划线润色;api+worker 于 #61 已含全部后端改动)。中间一次双命令并发竞态致容器名冲突,后台跑完的 recreate 成功、容器健康无残留。边界:真租户 zipforce/onno/fittingirls 全程只读验证卡片可见性,未发起注销;注销动作只在 zzofftest2 临时租户执行且已恢复+按 #61 同款流程清除测试痕迹;凭证仅以 secrets/audit_tenants/ 路径引用。挂账(承 #61 余项):①collection_schedule/tenant_accounts 未开 RLS(独立安全任务);③归档文件永久留存无清理策略。COPY (SELECT * WHERE tenant_id=) 写 gzip SQL 流 + sidecar manifest(逐表行数),gzip 魔数+尺寸校验不过即 500 中止且 status 不动(归档是清除的前置铁条件);成功后 status='offboarding'+suspended_at=now() → 吊销全员会话 → 返回 purge_due=+30 天。自救通道(main.py 中间件):offboarding 租户仅放行 /api/auth/login 与 /api/org/tenant/restore 两条路径,其余一律无租户上下文(404)——停用即停业务面,但保留逆转能力;restore 一键 offboarding→active(数据全程未动)。到期清除(tasks.py offboarding_purge_due,每日 07:07=全部晨间报警之后):铁序=①/srv/offboarding/{slug}/ 最新归档必须存在、可解压、manifest 在——缺档/坏档跳过并报警绝不无归档清除;②同事务:先写审计行 → 逐表 DELETE(74 表动态枚举+显式 WHERE tenant_id)→ 最后删 tenants 行(37 张 FK 子表自动级联,4 张 NO ACTION 子表已被逐表 DELETE 提前清空);③逐租户独立事务,失败只跳过该租户。审计行永久留存:audit_log 无任何 FK,租户删除后 offboard/restore/purge 全动作记录仍在(实测 11 行 4 类 action)。e2e 实证(一次性租户 zzofftest/tid=7,真租户绝不触碰):错误 confirm→400 ✓ offboard→200(74 表 3 行归档 907B+manifest,purge_due=11-09)✓ 业务端点→404 unknown tenant ✓ login 自救通道→200 ✓ 重复 offboard 被门挡 ✓ restore→200 cooled_days=0 业务面复活 ✓ 再 offboard+回拨 suspended_at 31 天→worker 清除 tenant_deleted=true·74 表·3 行 ✓ 子域终态 404(租户行已不存在,自救通道也失效)✓ zipforce/onno/fittingirls 全 active 零影响 ✓ 归档文件完好 ✓ 测试痕迹(租户/数据/审计/归档/cookie)全清。实测抓出并修的两坑:①psycopg2 copy_expert 第三参是缓冲大小非 params(首版 TypeError 500)→ 改 mogrify 内联租户键;②portal_app 权限洞两处——keepa_pull_log 无 SELECT(首跑 InsufficientPrivilege 500,归档先行的保险正确触发 status 未动)+ 17 张表无 DELETE(saas_admin 属主)→ 补授权 GRANT(SELECT 1 表 + DELETE 17 表:tenant_accounts/ads_imports/collection_schedule/ads_decision_audit/ads_decision_request/aplus_history/brands_source/listing_specs/listing_events/provisioning_log/sourcing_candidates/sourcing_decision_audit/sourcing_verdicts/sourcing_verdicts_legacy/tenant_credential_events/listing_backend_keywords/mcp_keys),均租户域表且行级由 RLS/显式 WHERE 双层限定。纵深防御:归档与清除 SQL 全部显式 WHERE tenant_id=%s,不单靠 SET app.tenant_id——因 collection_schedule/tenant_accounts 两表有 tenant_id 列但未开 RLS(挂账①:全局 RLS 补齐属独立安全任务,本流程已由显式过滤防住跨租户读写)。部署:api+worker 双 build(org.py/main.py/tasks.py 均镜像内);compose 新挂载 ./offboarding:/srv/offboarding(api rw 写归档 / worker ro 验档)。四道门:pen_tests/audit_nodes/frontend_e2e ALL PASS · dashboard_audit FAIL 1=既有 R17+WARN 5 已知——零新增红。挂账:①collection_schedule/tenant_accounts 未开 RLS(上面);②注销/恢复的前端 UI 按钮未做(端点已可用,冷静期业主现经 curl/后续 UI 自救,接 UI 待令);③归档文件默认永久留存(磁盘代价极小,未做清理策略)。/api/noon/reviews(noon_data.py:147)——brand 空=双品牌 UNION ALL(原默认 zipforce 丢 onno 全部评论)、review_date 是 'DD Mon YYYY' 文本裸 ORDER BY 按日号字典序乱序改 to_date(review_date,'DD Mon YYYY')、响应增 country 字段+country 过滤参数;③dashboard.py rating-review-analytics 的 noon_reviews 块改每品牌 count/avg/max(date)/差评数 + countries[] GROUP BY upper(country) 分市场拆分。前端修复(web/app/rankings/page.tsx):①品牌对比 noon 行加分市场拆分行——「SA 747条·4.21★ / AE 267条·3.96★」(countries 非空才渲染);②BSR 表五列空值渲染 null→'—'(bsr_big/bsr_small/rating/review_count/seller_rating)——此前空值渲染 NaN/空白。每日同步链确认(无需新代码,全在位):collection_scheduler 静态映射每日跑 noon-portal-apionly(--brand zipforce 与 onno 两轮)→ api 容器 tasks.py cron(ingest_mercury_daily, 04:30) → ingest_all 覆盖 rankings_daily 入库+清洗 → keepa 排名任务写后也触发同清洗。评论明细(seller_reviews)为 qsource 直读 mars 实时表,采集即生效。Amazon 评论内容(同页另一源,如实呈报):/api/rankings/amazon-reviews 读 product_reviews(当前 0 行)——amz_reviews_crawl.py 采集器 10-07 已建但从未排程(挂账 #21 同源),启用需 crawlbase credit 成本拍板。【10-10 追加·Amazon 五字段结论(用户问「amazon的结论呢」)+ seller_rating 假数据案修复】:五字段终审——①rating ✅ 266 distinct ASIN/13 市场/728 行快照,598/728 行有分、均分 3.98(Keepa 通道,每日 05:20 任务+断点续传循环器);②review amount ✅ 快照评论总数 138,879;③ranking:大类 BSR ✅ 503/728 行有值(10-07 起补写、逐日积累),小类 BSR 0/728 无源→'—'(Keepa 通道只给大类 salesrank);④review content ❌ 0 行挂账(上条);⑤seller rating——查出假数据并已修:tasks.py:388 keepa INSERT 第 8 占位误把 rating 复写进 seller_rating(598 行页面显示与评分完全同值的「卖家评分」,违「没有的-」),修=None + 存量 UPDATE rankings_daily SET seller_rating=NULL WHERE platform='amazon'(10,001 行)+ 清洗层刷新 clean-dc568203aee3(raw/clean 双层 0 非空)+ api/worker 双 build;端点复核 US 47 行 seller_rating 非空=0。截图 zf·BSR 表·US·44·10-10 选中·卖家评分列全 '—'·评分/评论有数(analyze_image 实证前 8 行逐行核对)。【10-10 追加·Amazon 挂账】:①rankings 明细里存在 domain1/EU/UK 休眠市场行(写入兜底 f"domain{domain}" + sku_mapping 空 country/EU 国家值)——markets 端点 #49 白名单挡住不露芯片(休眠无害),但 rating-review-analytics 聚合无同款白名单,这些行同日写入时会混入聚合数字(今日快照干净);②小类 BSR 无源;③Amazon 评论正文采集待 crawlbase credit 拍板。【10-10 追加·挂账①执行完毕:analytics 补 #49 白名单(用户令「1 不要,其它的执行」)】:rating-review-analytics 的 7 条 amazon 查询(latest/评分分布/评论分布/品牌对比/BSR 分布/30天趋势/top 评论 SKU)全部补 market = ANY(RANKING_MARKETS) 守卫(dashboard.py,与 /api/rankings 主表 1950 行同口径)——污染定量:30 天窗内非白名单行 4,439 行(EU 1624/SA 587/AE 562/PL 377/IE 374/BE 349/SE 334/UK 197/domain1 35,全部 ≤10-09,#57-g 注册表切档后新写入已规范化)。修复前后端点对比(10-09 趋势日):zf 298→225 SKU·47,914→36,730 评论;fg 2,319→1,746·470,112→373,557;DB 交叉核对精确:10-09 当日非白名单行 zf 73+fg 573=646 与端点减量逐数吻合;latest 快照聚合(10-10 干净日)前后不变(符合预期)。残留 10-09 峰值=真数据:#57-f 起每家族×13 域全球抓取,10-09 是首写日——趋势「SKU 数」按行计(家族×市场行),非 distinct 产品数,属产品语义口径待用户拍板(非缺陷不擅改)。api 单容器 build(dashboard.py 仅 api 侧);四道门:pen_tests/audit_nodes/frontend_e2e ALL PASS·dashboard_audit FAIL 1=既有 R17+WARN 5 已知——零新增红。截图 analyze_image 双租户实证:zf·KPI 300·4.01·31,981 无报错 · fg·KPI 403·3.95·106,121·趋势图 10-09 峰已降。【10-10 追加·挂账③执行完毕:小类 BSR 有源接入(Keepa 同参响应零额外 token)+ 大类分类名补显】:探针实证(B0CNPMHPZ5·US):排名任务既用的 /product 同参数(stats=30, rating=1)响应里 salesRanks{catId:[keepa分钟,排名,...]} 自带双轨——根类轨=大类(catId 7141123011 rank 2011 与 stats.current[3]/csv[3] 精确一致,salesRankReference=根 catId)+ 叶子类轨=小类独立存在(2376204011 Everyday Bras #55);categoryTree 给根→叶名称链且按市场本地化(ES 'Sujetadores básicos' / IT 'Reggiseni' / FR 'Écouteurs Sleep')——「无源」结论作废,零额外 token 接入。接线:keepa_client 新增 _subcat_rank 单一事实源(树最深层节点的末位有效排名→(排名,分类名),排名与名成对:无排名不带名保持页面 '—' 干净),parse_product 增 bsr_big_category(树根名)/bsr_small/bsr_small_category 三键;parse_product_enrich 的 subcat_rank 改委托同一实现(选品产品表与排名任务口径永久统一);tasks.py 排名 INSERT 三列+ON CONFLICT+全空 guard(rating/review/大/小类全空不写行);api+worker 双 build。验证:单元 PASS + 真实任务断点续传 e2e(删当日 (brand,asin,market) 行→容器内实跑 daily_amazon_rankings_keepa 重拉)——onno B0H69PX1LY US raw+clean 双层大类 145,552·Pet Supplies + 小类 256·Cameras & Monitors(clean-8e6039fe39de,clean_audit SELECT* 列无关自动透传新列);当日 10 行带小类(3 品牌×7 市场);今日覆盖 10/736 系断点续传跳过已写行(设计行为),明日 05:20 全量 1547 键快照起全目录携带小类+大类名。大类名补显:API 本就返回 bsr_big_category,前端 BSR 大类列原只渲数字——page.tsx 补「 · 分类名」灰色后缀(与小类横向统一,「有的都要」),web build。截图自检 6 张 analyze_image 三租户全过:onno·US·256·Cameras & Monitors · zf·FR·102·Écouteurs Sleep/1,878·Écouteurs à conduction osseuse · fg·CA·1,876·Everyday Bras + 大类名版 onno·145,552·Pet Supplies · zf·46,450·High-Tech · fg·190,121·Clothing, Shoes & Accessories(今日快照多数行大类名空=05:20 旧镜像写入时无此列,属预期过渡态,明晨全量收敛)。四道门:pen_tests/audit_nodes/frontend_e2e ALL PASS · dashboard_audit FAIL 1=既有 R17+WARN 5 已知——零新增红。截图自检(铁律·三租户矩阵 5 张全过):zf·评分分析·noon 行拆分 SA 747·4.21/AE 267·3.96·总量 1,014·差评 194 红 · zf·评论内容·noon 源 6 卡日期严格倒序 09→08→07 Oct·国家 chip·共 200 条 · zf·BSR 表·Noon AE 芯片 32·10-10 选中(原断供市场恢复)·评分/评论有数·BSR/卖家评分 '—' · onno·Noon AE·4·10-10 与 Noon SA·4·10-10 双芯片新鲜无琥珀 · fg·12 芯片纯 Amazon 无任何 noon 芯片(诚实空缺)。边界:未触碰订单数据;sku_mapping/注册表未动;凭证只以路径引用未打印。(租户, 品牌, 平台, 国家, SKU, 账号, 模式[direct直营/consignment代卖]),唯一键含 tenant_id——同一 SKU 允许不同租户以不同模式在不同账号并存,SaaS 绝对区分、绝对隔离;②全部系统数据由注册表正向生成、单向流动,严禁订单/FBA/库存等下游数据逆向反推回写注册表;③一次性豁免:仅初始注册事实可基于订单证据反推(2026-10-10 用户授权),此后新代码一律正向业务流。memory 固化:feedback/mapping-table-constitution。表结构迁移(tools/mapping_registry_20261010.sql,已执行):sku_mapping 加 tenant_id bigint NOT NULL DEFAULT 0(fail-closed:未盖章即 0,谁都看不见)、account、mode CHECK IN ('','direct','consignment');唯一约束换为 uq_sku_mapping_registration (tenant_id,brand,sku,platform,country)(原 brand 键控唯一性作废=多租户并存的法律基础);ENABLE+FORCE ROW LEVEL SECURITY,单一 ALL 策略 tenant_isolation: USING/WITH CHECK tenant_id=app_tenant_id();products 可见性同步收紧=tenant_brands 授权 ∩ brand_scope ∩ EXISTS 本租户 sku_mapping 行(产品页由注册表正向驱动)。注册事实(2026-10-10 用户授权声明,非代码推导):终态 1,132 行、0 未归属、246 distinct ASIN(fg 208/zf 33/onno 5)、120 行无 ASIN(Noon 等 nsku 渠道)——zf 租户(t=1):zipforce/Amazon 155(zipforce_amazon/direct)+ zipforce/Noon 106(zipforce_noon/direct)+ onno/Amazon EU 5(zipforce_amazon/consignment 代卖);onno 租户(t=2):onno/Amazon 20 = AE/AU/SA/US(onno_amazon/direct 直营) + onno/Noon 14(onno_noon/direct);fg 租户(t=3):fittingirls/Amazon 832(fittingirls_amazon/direct)。onno 拆分账:#58 的 onno/Amazon 25 行 = 5 EU 归 zf(代卖)+ 20 归 onno(直营),5+20=25 平。行为变化(用户已知情口径):zf 租户 mapping 页 onno/Amazon 视图 25→5 行全 EU(代卖分支);onno 租户 onno/Amazon 25→20 行自有无 EU;onno/Noon 对 zf 租户=200 空表(zf 无该注册,正确);跨租户/未登记品牌 GET+POST 均 400(#58 既有前置校验)+ RLS 兜底。代码改动(全部正向流):ops.py mapping_edit_save——tenant_id 由会话盖章(客户端传值忽略,宪法:归属不可客户端指定)、ON CONFLICT 键扩为五列、冲突键/NOT NULL 列空值写 ''(NULL 会绕过唯一索引判重);onboarding.py /api/onboarding/skus 同五列键 upsert;导入工具重写 tools/mapping_official_import_20261010.py=注册表版官方链(每分支声明 account/mode 盖章写入);crontab catalog_cascade 行注释停用(2026-10-10)——#58 挂账「垫表回涨」正式关闭,订单数据本身一字未动(要保留所有订单)。排名页影响(用户问「现在在排名页面是不是就没有几千个sku了?」):对,早已无几千——keepa 爬虫目标源=sku_mapping(tasks.py _family_groups 实时 SELECT,逐轮计算),注册表切档后只爬 246 个注册 ASIN。今日快照(活数据,写入时点晚):14 市场 / 774 行 / 318 键 = 272 ASIN 键(在册 60=fg28+zf27+onno5,册外 212=fg179+zf33 系今晨切档完成前旧目录轮次残留,明日快照自然收敛至注册口径)+ 46 行 Noon/SA(Z 开头商品 ID 的 Noon 排名流,无 ASIN 概念,合法独立通道);全历史 92 快照 566 distinct 全保留。租户隔离实测(US 在榜):zf 47 / onno 3 / fg 198,无跨租户泄漏。全账号×全品牌矩阵自检(铁律,/tmp/verify_registry_matrix_20261010.py):3 租户 × 10 分支 40/40 PASS——每分支行数/国家集/账号/模式/tenant_id⊆{tid} 全精确命中(如 onno 租户 onno/Amazon=20 且国家集恰 {AE,AU,SA,US};zf 租户 onno/Amazon=5 且恰 {EU} 且 mode=consignment);越权品牌探测 5 分支全 400;products 总数 219/27/832;rankings US 全部 0<x≤241。DB 负向测试(应用实连角色,非超管):pg_stat_activity 实证 API 连接池=portal_app×3 → 以 portal_app+SET app.tenant_id 模拟会话——①五列整键拷贝重复注册:ERROR duplicate key uq_sku_mapping_registration(1/zipforce/C6-U3IY-LOOU/Amazon/SA);②t=2 会话写 t=1 行:ERROR new row violates row-level security policy;③t=2 会话读 t=1 行=0(自己 34 正常);④fail-closed:未设 tenant_id 全表 0 行;探针零残留。测试教训:首轮以 $POSTGRES_USER(超管绕 RLS)跑+唯一键子查询漏 country 列=两次假阴性,均已重做实证——负向测试必须以应用角色跑、冲突用例必须整键拷贝。截图自检(视觉复核全过):zf 租户注册表·155/106/261 · onno 租户·20/14(AE/AU 可见) · fg 租户·832 · zf 租户 onno 品牌视图·5 行全 EU 代卖分支 · zf 排名页 · onno 排名页·GB 5 行纯 onno · fg 排名页·US 共 198。备份与回滚:backups/pre/sku-registry-20261010.dump(迁移前整表 pg_dump)+ backups/pre-sku-registry-policies-20261010.sql(旧策略定义)。挂账:①mapping UI 编辑表单暂未透出 account/mode 列(导入已盖章,手工 UI 建行暂空 '',待前端扩展);②brand_channels 表休眠未用(曾拟作渠道注册表因违宪弃用,零执行);③mars 侧 shared.mapping_* 未加租户维(本轮只动 SaaS,mars 下步规划另报);④今日快照册外 212 ASIN 为历史残留(保留不删,要保留所有订单同源原则),明日 05:20 UTC 定时任务起快照为纯注册口径;⑤tasks.py admin parent_asin enrichment 未动。zipforce.zipforcehub.com/mapping(zf+onno)与 fittingirls.zipforcehub.com/mapping(fg),数据从未丢失;真实问题=mapping 内容被 catalog_cascade.py(每日 01:40)长期垫表污染——该任务以 NOT EXISTS 从 FBA 快照+全部历史订单往 shared.mapping_{brand} 插行,大多无品名。替换前 mars 旧表行数=zf 921 / fg 10,466 / onno 49(fg 10,466 即此来源,已向用户澄清「和我提供的对不上」的正解:那是旧垫表,非文件数据)。权威文件:/opt/agent-console/uploads/ 三文件——zf 261 行(Amazon 155 + Noon 106,含 14 行 ME 站 SKU 按文件原样保留空 country)、fg 832 行(208 SKU × US/AU/EU/CA)、onno 39 行(Amazon 25 + Noon 14);全部品名 100%、无空 SKU、无重复键。替换前备份(可回滚):shared.mapping_zipforce_bak_20261010(921)、shared.mapping_fittingirls_bak_20261010(10,466)、shared.mapping_onno_bak_20261010(49)。mars 侧:三张 shared.mapping_{brand} 清空重建为文件精确内容,终态 zf 261 / fg 832 / onno 39,品名 100%(MCP 复查五分支 no_name 全 0)。SaaS 侧·官方链导入:新工具 tools/mapping_official_import_20261010.py(Playwright,支持 --verify 只读复跑)——两租户各自登录(secrets/audit_tenants/*.env),走页面同款链路 POST /api/mapping/edit/import(服务端 openpyxl 解析原 xlsx)→ 按分支 platform 拆分过滤(混平台文件整文件直导会被前端强制改 platform 串分支,必须逐分支)+ brand/platform 归位 → POST /api/mapping/edit 事务性先删后插 + 级联 products/inv_products + audit。五分支终态(实时校验 status 200):zf/Amazon 155、zf/Noon 106、onno/Amazon 25、onno/Noon 14(zipforce 租户)、fg/Amazon 832(fittingirls 租户),合计 1,132=三文件合计;级联确认如 zf/Amazon cascaded_products=129、cascaded_inv=155,fg cascaded_inv=832(fittingirls 租户此前 inv_products 为 0)。【10-10 补·onno 自营租户验证(用户问「还有onno亚马逊账户呢?怎么没?不是允许自营和代销吗」)】:sku_mapping/products 按 brand 键控 RLS(ops.py:250-252 tenant_brands→allowed_brands,未登记品牌 400),行不属于单一租户——onno 39 行写入一次即对所有登记了 onno 品牌的租户同时可见:zipforce 租户(代销,tenant_brands={zipforce,onno})与 onno 自营租户 onno.zipforcehub.com(tenant_brands={onno})。实测 onno 自营账号登录 GET:onno/Amazon 25 行、onno/Noon 14 行(status 200,brand 全=onno),页面 KPI Amazon 25/Noon 14/总 39,截图 onno 自营租户·39 行(/tmp/verify_onno_tenant.py 只读校验)。自营+代销双通道均在线,无缺失。截图自检(视觉复核通过):zipforce 租户·KPI Amazon 155/Noon 106/总 261 · fittingirls 租户·KPI Amazon 832/总 832——两页品牌列、平台标签、行数与库完全一致,无报错、无「未知的租户域名」。挂账(待用户拍板):catalog_cascade.py 未动(用户令「要保留所有订单」,订单与该文件一律不碰)——它每日 01:40 仍会把历史订单/FBA 快照 SKU 以 NOT EXISTS 插回 shared.mapping_{brand},明晨 mars 行数将回涨(fg 理论回涨至万级),且 mars→SaaS 同步是 upsert-never-delete 会跟着流入;若要求 SaaS 永久=文件,需用户拍板(改 catalog_cascade 垫表行为 / SaaS 侧过滤 / 接受回涨)。边界确认:全流程未触碰订单数据、未改 catalog_cascade.py 与任何业务代码;仅数据替换 + 新增只读/导入工具一个。sadd 入 keepa:rankings:empty:YYYY-MM-DD(expire 172800),skip=done∪empty;当日键不跨日继承(用户拍板「不管有没有在售都抓」→ 次日全量重探,不拿昨日状态筛今日)。#57-d 家族级抓取目录:tasks._rankings_family_rows 键=(brand, fam, market) 三元组(Keepa 按域逐市场抓,缺 market 维会跨域塌缩);fam 优先级=sku_mapping.parent_asin(注册表回填,最准)> 被指为父的 ASIN 自身 > model_number(按 ASIN 聚合非空,防同 ASIN 多行脏数据拆散家族)> ~ASIN 兜底;代表选择=父 ASIN 在目录选父体本身,否则字典序最小子体;UK→GB 归一+非法市场(SE/BE/IE/PL/EU 等 keepa 无域)跳过计数。数字链:6039 ASIN 级 → 5404 仅 model 归并 → 3194 家族级(快照时点;parent 持续回填后当前 3192)——token 成本较 ASIN 级近乎减半。循环器分母 _keepa_family_target() 与任务同一实现,口径永不漂移。父体空壳实证:Keepa 父 ASIN stats 全空、子体间 rating/BSR 全同——实际口径=每家族首序子体代表值。#57-e parent_asin 注册表回填:①每日任务批循环顺带回填(零额外 token,UPDATE ... WHERE coalesce(parent_asin,'')='' 幂等只填空行)——家族化事实源随抓取持续保鲜;②一次性脚本 tools/keepa_parent_backfill_20261010.py(stdin 注入容器,批 100,透支排队重试)首轮回填 62;累计按 ASIN 去重 233/744(31%,行数口径 3188 行;初版条目误记 625/744=行数混除 ASIN 数,已纠正)。已知缺陷挂账:脚本域选择用登记国(DOMAIN_OF),domain=13(US) 批 84 ASIN 全缺席——第二轮应改用 rankings_daily 历史实测有数据的市场域重捞。家族目录交付(本条目主体,用户令链「全都列出来」→「在窗口显示」→「窗口显示这么费劲吗?」→「那你放到changelog」):CSV 3194 行(列=brand,family_key,来源,market,rep_asin,吸收变体数)+ 单文件 HTML 目录页(品牌按钮组+来源按钮组+市场下拉+搜索框+实时计数;来源徽章配色 single/model/parent;sticky 表头 70vh 滚动)+ 会话窗口 8 段全量贴表。分布事实:品牌 fg 2858(89%)/ zf 321 / onno 15;来源 single 2906 / model 219 / parent 69;市场矩阵 MX 466 / US 466 / CA 461 / GB 369 / DE 363 / FR 338 / ES 335 / IT 335 / AU 44 / NL 12 / BR 3 / JP 2;onno 15 行全为 model 家族(HM-/XSJ- 五型号 ×AU/GB/US),zf parent 家族(B09CC7Q6BV 等)跨 5 市场,zf model 家族(ZF-430/435/565)跨 7-11 市场。截图存档:目录页·桌面 · 筛选 fg+parent 计数 31/3194·桌面。当日升级·产品级视图(用户令「表头 第一列是产品名称 sku 国家 其它」「国家可以筛选」):页面重构为一产品一行(367 行),表头=产品名称|SKU|国家(点击徽章或下拉筛选)|品牌|来源|代表ASIN|变体数|家族成员ASIN;名称优先级 product_name→订单 items 最常见 title→代表ASIN(真名 82/367,其余 285 个系统内无名称——未售且未登记,灰色等宽显示不编造);来源 parent 54/model 31/single 282。新截图:产品级·桌面 · US 筛选 349/367 · 移动 390。【10-10 #57-f 全球站点抓取·用户令「全球站点抓取」】:Keepa 排名采集从「登记市场才抓」扩为每家族 × 全部 13 个 Keepa 站(US GB DE FR JP CA IT ES IN MX BR AU NL)。语义:有登记市场的行=市场本地代表(父体优先,否则该市场最小子体,与旧版一致保证断点兼容);未登记市场=家族全局代表(父体优先,否则全市场最小 ASIN)探测该域;Keepa 未收录站点当日记空集合、次日全量重探(10-09 拍板「不拿昨日状态筛今日」不变);断点键 (brand,asin,market) 沿用——改造上线时今晨已写 349 行直接跳过零重复耗 token。SE/BE/IE/PL/EU 等 2646 源行无 Keepa 域,维持跳过(平台侧无站点,改不了)。数字链:分母 2302→4589(353 家族×13 域;家族数从目录页 367 收缩到 353=parent 回填持续合并子家族的正常演化);结构校验每市场恰 353 行、总数 4589 整;token 日需求 4589 vs 日补给 28800(20/min)可承受。改动面:仅 tasks._rankings_family_rows 一函数(新增 fam_members 全市场成员集+末尾 13 域补齐循环;248 行 import 收窄 ABA_DOMAIN→只 RANKING_MARKETS,按当日 NameError 教训先 grep 全文四引用点确认 338 行由 305 行任务函数自带 import 覆盖);循环器零改动——target() 走容器内 _keepa_family_target() 同一实现(单一事实源红利:分母自动跟随零口径漂移);streak 文件 rm 重置收敛计数(分母变更假收敛防护)。部署:停旧爬取任务(断点设计下 mid-run 杀无损,容器内 /proc 扫描+shell 内建 kill)→ api+worker 双 build+force-recreate → 容器内验证新分母 4589 → 循环器触发首轮全球爬取(pid=2651409,起步覆盖 349/4589,桶恢复中)。目录页横幅同步(keepa_family_catalog_20261010.html):加粗「2026-10-10 起全球站点抓取:每产品×全部 13 个 Keepa 站」+「表中国家列=登记市场,未登记站点同抓、Keepa 无收录当日记空次日重探」。新截图:全球抓取横幅·桌面 · US 筛选 349/367(视觉复核:13 站列表完整、367/367、US 下拉 US(349)、无布局回归)。【10-10 #57-g 家族重键·承用户令「内衣总共21个父asin」「所以说按照型号,产品名称来计算呀」】:parent_asin 退出家族键——Keepa 留旧父/死链(fg 实证 49 假父 vs 人工盘点 21 真产品),型号才是真身。新键链:model_number(按 ASIN 聚合非空)> product_name(归一化)> ~ASIN 兜底;代表 ASIN=登记市场最小、未登记市场=全市场最小;分母/目录页/循环器三口径同源 tasks._family_groups(单一事实源,禁双胞胎)。fg 型号回填两步:备份 bak_sku_mapping_fg_20261010(9192 行)→ ①同 SKU 注册表型号传播 2829 行(修复同 SKU 半空行)→ ②残余按 SKU 定长解析 5452 行(3 字符区域前缀+第 4-7 位型号,正则 ^[A-Z]{2}[A-Z-]{1}[0-9A-Z]{4},fg SKU 覆盖 633/633)。截断坑:5 位型号被固定 4 位截断(88106→8816、DW003→DW00),靠①传播+显式 CASE 真值修复防拆家族——定长解析前须对注册表已有值做子串冲突检查。数字链:fg 19 型号家族 + ZF-565 孤行 + 1 裸单体 = 21 精确对上人工盘点;总分母 4654→1547=119×13(fg 21/onno 5/zf 93),token 日需求省 67%(日补给 28800 富余 18 倍)。改动面:tasks.py 新增 _family_groups + _rankings_family_rows 重写;api+worker 双 build×2;keepa_backfill.streak 清零防分母变更假收敛;tools/build_keepa_family_catalog.py 固化生成器(替代一次性 heredoc)。目录页重生成(119 行,8 断言 ALL PASS:型号级标题/键链/fg21/13 站/parent 退役/#tb 119 行/counter 119/119/2402 存在)+ fg 品牌筛选「21 / 119 产品」:新截图 型号级·桌面 · fg 筛选 21/119(视觉复核:119/119 计数、fg 高亮 21/119、型号+灰色品名列渲染正常、无布局回归)。循环器:新分母自动跟随,断点续传已重启(421/1547 起步),收敛后每日 05:20 定时全量接管。数据欠账挂账:zf 93 家族中 77 个为无型号无品名裸 ASIN 单体(SKU=FNSKU 垃圾格式)待补型号或清死链后自动并族;fg 名下 ZF-565 孤行待核对;parent_asin 回填第二轮作废(键已退役,注册表既有值保留作参考)。【当日返工与教训】展示方式三连绕弯:用户要「在窗口显示」,我先做 HTML 网页、再给汇总表并称「全量会刷屏」,用户不满「窗口显示这么费劲吗?」→ 最终 8 段 sed 全量贴窗口(3194 行完整交付)。教训:用户要什么给什么,不擅自升级方案、不以「太长」为由降级交付。【当日修复·循环器零增量真凶 NameError】:四道门收尾查 task log 抓到 NameError: ABA_DOMAIN is not defined——#57-d 把 ABA_DOMAIN 挪进 _rankings_family_rows 函数局部 import 后,daily_amazon_rankings_keepa 337 行引用裸奔(Python 局部 import 不外泄调用方作用域)→ 循环器每轮必崩=零增量真凶(token 桶透支 -119 是并存的第二障碍;假收敛防护此前已把透支期零增量正确判为非收敛,streak 未误增)。修复=函数级 from core import ABA_DOMAIN(tasks.py:305),按铁律 api+worker 双容器 build+up(up 前扫容器活进程,无长任务)。验证:容器内 inspect 函数源含 import ✓ + 实跑一轮 0 NameError、覆盖 39→172 增长中、桶 -119→-105 恢复中。此为 09-24「改调用漏同步 import 断更」同款教训重演——重构挪 import 必查同文件全部引用点。四道门(顺序单跑,仓库根):pen_tests ALL PASS|audit_nodes ALL PASS(172 端点/2923 节点)|frontend_e2e ALL PASS|dashboard_audit FAIL 1=既有 R17(zf 08-31 周费用覆盖挂账)+ WARN 5=已知 sku_mapping 成本欠账——零新增红。注:四道门跑在 NameError 修复部署之前(改动仅函数级 import,对 API/前端零行为面),修复后以容器内实跑验证收尾。循环器现状:会话 cron 每 10 分钟续跑(防重入 pid 锁+假收敛防护+24h 硬上限);当日覆盖随桶回填持续上涨,收敛(桶正+连续 2 轮零增量)自动删 cron 汇报。挂账:parent 回填第二轮域修正;zf sku_mapping 199 行空 country;#21 Amazon 评论采集 pending。brand = 'onno' if any(k in campaign_name for e27/g25/2001/2002/camera/lamp/pet)——词表推断≠事实,违注册表唯一事实源铁律。改造·campaign→brand 事实源映射(_campaign_brand_map):①amazon_analytics 库查近 7 天 advertised_products 的 (campaign_id, advertised_sku);②同实例跨库(worker 容器 /run/secrets saas_admin 凭证)读 saas_registry.sku_mapping——与 clean_audit.py sku_brand_map 同一条 SQL(sku→brand last-wins 字典,双品牌 SKU 解析结果与清洗层一致);③campaign 品牌=其广告 SKU 解析品牌多数票(平票 zf 优先),无 SKU 证据兜底 zipforce(宪法键:采集账号→租户);目录读取失败整体回退账户归属不猜名称。歧义实证·口径对齐价值:G25 campaign(B0H69PX1LY/ONG25X0EU)sku_mapping 双品牌并存(1 onno + 11 zipforce 行)——last-wins 解析=zipforce,新实现与清洗层 brand_fix 同判;旧名称词表会误判 onno(与注册表真相相反),实证「猜」与「事实源」产出分歧的真实案例。部署与验证:/opt/collection 全量挂载在 worker 容器(rw,cron 真正执行处),宿主改文件即生效、零 build(api 容器仅挂 secrets 不受影响);worker 内干跑映射 16 campaign 全解析({'zipforce': 16});争议 campaign 定向复核 → zipforce 与清洗层一致;四道门顺序跑 全绿(dashboard_audit FAIL 1=既有 R17 zf 08-31 挂账,零新增红;早间 3 FAIL 中的 hourly24/hourDist UTC 日切翻牌已随日界自愈)。明早 08:00 ads-audit 常规 cron 自动用新映射。#54 余项:二梯队全闭;仅剩三梯队「接口统一工程设计」(amazon 主订单三代实现 515/298/435 + settle×2 对 + sales_fba + derive 的接口归一)——方向性工程,设计稿出后须拍板才动工。curl --compressed,响应 gzip)得 tokensLeft=−118(透支态,按分钟回填);任务实际在正常消化(成功批不写日志,误判过一次「假死」——查 rankings_daily 当日行数实锤仍在涨)。改动③·循环补齐器(tools/keepa_backfill_loop_20261009.py,会话内 cron 每 10 分钟):防重入(宿主 pid 锁文件+os.kill(pid,0) 活体判定)→ 覆盖率查询(当日 rankings_daily 行数 / sku_mapping 合法域目标 5513)→ 未收敛则触发一轮容器内断点续传任务;收敛判据=连续 2 轮零增量(剩余=Keepa 真无数据的 ASIN)自动删 cron;24h 硬上限自删兜底;明早 05:20 api 容器常规 cron(已带断点续传)自然接续。当前进度 1685/5513 随桶回填持续上涨。验证(tools/_shot_57_rename.py,7 断言 ALL PASS):导航/侧栏出现「市场表现」|旧名「排名监控」消失(首页全文+/rankings 全文双向查)|/rankings 页标题=「市场表现」|移动 390 可见+无横向溢出。截图 2 张存档:改名·桌面 1440 · 改名·移动 390(视觉确认:导航选中态+主标题+副标题正确、无旧名残留、布局无错位;个别市场标签橙色=快照日期偏旧的设计内新鲜度提示,同步补齐后自愈)。回归门(四道顺序跑):pen_tests ALL PASS|audit_nodes ALL PASS(无新端点)|frontend_e2e ALL PASS|dashboard_audit FAIL 3=既有项零新增(hourly24/hourDist×2=UTC 日切边缘翻牌量级 1、费用覆盖=R17 zf 08-31 已知挂账)。部署:web/api/worker 三容器 build+up(up 前扫容器活进程)。挂账(本节点新发现):zf sku_mapping 199 行空 country 洞(不在 RANKING_MARKETS 被跳过不采集,待补国家归属后自动进目录);#21 Amazon 评论内容采集(排名页「评论内容」tab Amazon 侧空态根因)仍 pending。<optgroup label="期间">(今年/本月/上月/近3月/近12月/去年)+ <optgroup label="单月">(数据实际月份并集:对账单+经营总表两源月份 memo 合并 sort 新→旧 cap 24 项,如 2026-10/2026-09/…);三个下拉同构(双图卡+表①+表②),共用同一 opsPeriod: string state 联动。改造②·单月键直通窗口:NoonStatement.tsx periodRange()/periodLabel() 签名放宽 OpsPeriod | string,单月键(/^\d{4}-\d{2}$/)→ 窗口 [该月, 该月]、label=该月本身 → 标题「Noon 2026-09 累计 · 分市场」;switch 加 default 兜底;单月与既有月/季/年粒度 tabs 并存联动(2026-09+季→「2026 Q3」)。新增③·环比图前置月机制(单月仍有环比点):momPrev memo=窗口首月前一月的分市场 GMV(无数据返回 null);momOpt 序列 s=[momPrev, ...opsMonSeries],环比值算完后 .slice(cut) 去掉前置月占位——单月选择时环比图仍有 SA/AE 两个点(对上月)。修复④·环比图 x 轴错位(本节点视觉自检抓出的真缺陷):初版 series 有 .slice(cut) 但 xAxis data:s.map(...) 未同步 slice → ECharts category 轴刻度数>series 长度,单月选择时 x 轴出现 [2026-08, 2026-09] 两刻度、数据点错落在 2026-08 上(多月份窗口同样整条线左移一格);修复=xAxis 改 s.slice(cut).map((m)=>m.mon)(finance/page.tsx momOpt,用 legend 行上下文与 gmvBarOpt 同串区分定位)。验证(tools/_verify_56b_single_month.py,17 断言 ALL PASS):下拉「单月」组存在且含 2026-10/2026-09(n=24)|单月组新→旧排序|期间组 6 项仍在|三个下拉都有单月组|单选 2026-09:表①表②行全为 2026-09+双图卡标题「Noon 2026-09 累计 · 分市场」+两 canvas 渲染|单选 2026-10 表②行+标题随动|单月+季粒度→2026 Q3|预设「今年」回归(标题+行 2026-xx)|移动 390 单月标题随动+无横向溢出。截图 4 张存档:单月双图卡·桌面 · 单月表②·桌面 · 单月双图卡·移动 390 · xAxis 修复复验·桌面(视觉确认:单月 2026-09 视图柱状图仅一组双柱、环比图 x 轴仅 2026-09 一刻度且 SA +13%/AE −32% 两点落其正上方)。排查记录·CDN 边缘缓存坑(新经验):xAxis 修复部署后复验截图 analyze_image 仍显示旧画面——五步排查(容器/镜像时间→容器内 minified chunk dump→Caddyfile 无缓存模块→curl 线上 chunk 实证含修复→CDN 结论)破案:截图 CDN(同路径 object key)边缘缓存了旧截图对象(两次 Read 返回 URL 仅 Signature/Expires 不同);对策=换新文件名(-fix-v2- 后缀=全新 object key)重截即看到修复后画面。教训:截图视觉复验若覆盖同名文件,必须换文件名。另:容器内 busybox grep 不支持 {0,600} 量词、minifier 重命名局部变量(cut→s)致源码字面量搜不到——须 docker cp 出来 GNU grep + dump 代码段看结构特征。回归门(四道顺序跑):pen_tests ALL PASS|audit_nodes ALL PASS(172 端点/2920 节点,无新端点)|frontend_e2e ALL PASS|dashboard_audit FAIL 1=既有 R17(zf 08-31 费用覆盖,非本次)、WARN 5=已知成本欠账——零新增红。部署:web build+up(up 前扫容器活进程;api 本轮未动)。OpsPeriod 六态 + periodRange()(返回 [YYYY-MM, YYYY-MM] 窗口)+ periodLabel()(本月/上月→「2026-10」·今年/去年→「2026 全年」·近3月→「2026-08~10」·近12月→「2025-11~2026-10」);下拉 option 文本「今年(2026 全年)」式六项;窗口过滤在聚合前(stmtRows/opsRows/opsMonSeries 三路共用 inWindow);与既有月/季/年粒度 tabs 并存互不干扰。新增②·双图卡「Noon {期间label} 累计 · 分市场」:上月柱状图=GMV 按月分组柱(SA GMV (SAR) 紫 #7c73f0 / AE GMV (AED) 橙 #f6b17a,各自本币——同市场同币跨品牌可加总,禁跨币 All 汇总);下图=GMV 月环比 % 折线(首月 null · prev≤0 null,环比币无关可同图);两图随期间下拉联动;期间与下方两表共用同一 state。改造③·两表标题+控制条:表①「官方对账单 · Noon {期间label} 累计 · 分市场」(26 列)、表②「月度经营总表 · Noon {期间label} 累计 · 分市场」(20 列);控制条=期间 label+select 与 月/季/年 粒度 tabs 并排;表内容随期间窗口过滤。验证(tools/_verify_56_noon_period_dropdown.py,28 断言三轮迭代 ALL PASS):旧卡已删(无「VAT(税)」「净收款 Net Proceeds」表头)|双图卡 2 canvas+标题「Noon 2026 全年 累计 · 分市场」|两表新标题+下拉 6 选项|期间六态行集精确(本月全 2026-10 · 上月全 2026-09 · 近3月⊆{08,09,10} · 近12月含最早 2025-11 · 去年全 2025-xx)|双图卡标题随期间切换|今年+季粒度并存(2026 Q4)|#55b/#55c 结构回归(表①≥26 列 · 表②=20 列 · Ad Spend/Gross/COGS/Net/Settlement 净额/Payout 六关键表头)|移动 390 双图卡+两表可见+无横向溢出。截图 3 张存档:双图卡桌面 · 表②期间桌面 · 双图卡移动 390(视觉自检:柱状图 2026-01~10 双组柱+环比折线+下拉「今年(2026 全年)」渲染正常)。三轮修复:playwright select_option(label=regex) 不接受单 regex→改 value 形式;移动端「官方对账单」has_text 匹配到页面下方余额卡→限定「官方对账单 · Noon」+≥1;TS guard 条件化后 wA 可能 null→Amazon Annual Summary 卡补 && wA。回归门(四道顺序跑):pen_tests ALL PASS|audit_nodes ALL PASS(无新端点)|frontend_e2e ALL PASS|dashboard_audit FAIL 1=既有 R17(zf 08-31 费用覆盖,非本次)、WARN 5=已知成本欠账——零新增红。部署:web build+up(up 前扫容器活进程,仅 next-server 常驻;api 本轮未动)。cleaned_noon_ads_daily.spends——该源是不含税净额(广告页/广告 KPI 同源口径),违背清单含税要求。SQL 口径实证(三源对账 statement 含税实扣):① Commission:sku_pl_monthly vs statement referral_fee 比值 0.75~1.09 中枢≈1.0(SKU 级 vs 钱包级时间差噪声)→ 已含税,无需改;② Delivery:delivery_fee vs fbn_outbound_fee 比值≈1.0 同上 → 已含税,无需改;③ Ad Spend:ads_daily vs statement advertising_fee(取绝对值)zf AE 2026-04~09 比值 0.99~1.11 中枢 1.045、zf SA 2026-09 = 1.169 → 与 #46/#47 拍板税率(SA 15% · AE 5%)+周批扣时点错位残差 1~2% 完全吻合 → 净额确认,需 ×(1+VAT)。修复内容:api/routers/finance.py /api/finance/noon-ops 广告 SQL 改 sum(spends × CASE country WHEN 'SA' THEN 1.15 WHEN 'AE' THEN 1.05 ELSE 1 END);表②脚注同步注明「Commission/Delivery/Ad Spend=含税实扣(广告源为净额,按市场加 VAT SA 15% · AE 5% 对齐对账单实扣)」;Gross Profit=Settlement−Ad(含税)·Net=Gross−COGS 前端派生自动级联。Commission/Delivery 数据未动(源已含税)。验证:tools/_check_55c_ad_vat.py 精确断言 4 项 ALL PASS——2026-10 zipforce AE 行 Ad Spend 1,359→1,426(=1,358.53×1.05)、Gross 4,185→4,117(=Settlement 5,543−1,426)、Net 1,764→1,696(=4,117−COGS 2,421);年粒度 2026 zf AE Ad 89,991→94,491(×1.05 精确)。#55b 59 断言全量回归 ALL PASS(截图已按新值覆盖重存)。回归门(四道顺序跑):pen_tests ALL PASS|audit_nodes ALL PASS(无新端点)|frontend_e2e ALL PASS|dashboard_audit FAIL 1=既有 R17(zf 08-31 费用覆盖,非本次)、WARN 5=已知成本欠账——零新增红。部署:api+web 双 build+up(up 前扫活进程,仅常驻服务无长任务),网关健康 200。/api/finance/noon-ops(api/routers/finance.py,tenant_conn RLS 租户隔离):六源合一按 (brand,country,月) 合并——① cleaned_noon_sku_status 六态件数(units/cancelled/undeliverable/cir/pending/delivered,Valid Units=max(Units−Cancel−未妥投−CIR,0) SQL 内算)② cleaned_noon_sku_pl_monthly(gmv/commission/delivery_fee/settlement 本币)③ cleaned_noon_ads_daily(ad_type IN product/sp/all,含税口径)④ cleaned_noon_orders(Orders=count DISTINCT order_nr,2026-09-27 拍板口径)⑤ COGS 成本 CTE:greatest(有效件,0)×CASE country 折本币(SA cost_rmb×3.75/6.7963 · AE ×3.6725/6.7963),sku_mapping LATERAL 为准、回退 cleaned_noon_procurement_cost ⑥ statement Payout(DISTINCT ON (brand,market,月) 归一去重 + sum(abs(payouts)),#47 同款键)。派生口径(全站已拍板):Gross Profit=Settlement 净额−Ad Spend;Net Profit=Gross−COGS(前端聚合后派生);季/年=月值求和。修复记录(四轮迭代):① 新端点首跑 500 UndefinedTable: missing FROM-clause entry for table "su"——COGS CTE 外层 SELECT 写 su.u/su.can 引用但子查询别名是 s,PG 把 su 解析成表名 → 4 处改 s.,rebuild api 修复;② 验证脚本表②英文表头假 FAIL——窄列 CSS 软折行使 innerText 返回拆断文本 → 改 all_text_contents()(textContent)+空白归一(DOM 本身正确非产品 bug);③ 季粒度标签两表不一致(表① 2026 Q4 vs 表② 2026-Q4)→ aggregateOps label 同款 replace("-Q"," Q"),横向统一含显示格式。验证(tools/_verify_55b_noon_two_user_tables.py,59 断言 ALL PASS):表① 24 项(卡出现/单 table 不拆/无旧「钱包主表·费用分项」字样/17 表头子串/列序 期末余额<广告费<银行转账/表头≥26 列/含税 VAT 子头各 8)+ 表② 24 项(卡出现/20 表头逐字含中文「未妥投」「Settlement 净额」/列序 Ad Spend→Gross→COGS→Net→Settlement→Payout/共 20 列/首行有数值)+ 粒度 6 项(三态两卡联动,年粒度 Orders/GMV 有值)+ Valid≤Units 抽查 + /noon 回归 2 项(整表 26+ 列仍在)+ 移动 390 两卡可见无横向溢出。数据抽查 2026-10 zipforce AE:Orders 166/Units 162/Valid 142/Delivered 127/Pending 15/Cancel 11/未妥投 4/CIR 5/GMV 7,812/Commission −1,230/Delivery −1,064/Ad 1,359/Gross 4,185/COGS 2,421/Net 1,764(Gross=Settlement 5,544−Ad 1,359 精确成立);年聚合 2026 zf AE:Orders 7,530/GMV 512,707/Ad 89,991。截图自检:表① 26 列整表·桌面|表② 经营总表·桌面|/noon 整表回归|表②·移动 390(analyze_image 视觉复核:表①两行表头 rowSpan/colSpan 结构正确、表② 20 列数据对齐无错位;截图右缘裁切=卡内 tbl-wrap 横向滚动容器,DOM 断言已证 26/20 列全在位)。回归门(四道顺序跑):pen_tests ALL PASS|audit_nodes 首跑 FAIL「新端点未纳入对账」→ --refresh-snapshot 登记 /api/finance/noon-ops(快照 173→172 端点重构入库,机制正确拦截新代码)后 ALL PASS|frontend_e2e ALL PASS(像素空白扫描 finance/noon 零新空白)|dashboard_audit FAIL 1=既有 R17(zf 08-31 周费用覆盖,#47 同款在案非本次引入)、WARN 5=已知 sku_mapping 成本欠账——零新增红。部署:api+web 双容器 build+up(api 含新端点,web 含两卡),up 前扫容器内活进程(api 6/web 4 无长任务)。遗留标注:/api/finance/noon-ops 值对账基准(BASAL)未挂——现入 audit_nodes 红清单工作面,后续按需挂 SQL 直算基准;年聚合钱包恒等式残差 ~1,643=既有已知(#55 条目同款:广告周批扣时点错位+费用覆盖缺口),非本次引入。web/components/NoonStatement.tsx 共享层——Stmt/FeeCov 类型、STMT_FEES 8 费项、STMT_VAT_RATE(SA 15/115 · AE 5/105,与 api finance.py _NOON_VAT_IN 同源)、money、aggregateStmts 聚合、StmtWalletTable/StmtFeeTable 两表组件;/noon 页 26 列整表同步改为引用共享层(UX 零变化),财务页两表同源——不复制 JSX 防新分叉。聚合口径:客户端从月粒度 statements 聚合(源=API 全量月行):期初=期内首月期初 · 期末=期内末月期末 · 净入账/总费用/打款/8 费项/银行/余额转账=期内求和;VAT 在渲染层按市场税率对聚合后含税值内拆(税率恒定 ⇔ 逐月拆后求和,数学等价);打款=银行转账+余额转账(钱包划转非应税无 VAT);期间标签 月=2026-10 · 季=2026 Q4 · 年=2026,排序期间倒序。数据通路零 API 改动:财务页 platform=noon 时直连既有 /api/noon/summary(audit.cleaned_noon_statement,DISTINCT ON (brand,market,月) 归一去重),与 kpi-wall 月窗独立;区块为 Noon 全量口径暂不随全局品牌筛选(与 /noon 页一致,页脚标注)。验证(tools/_verify_55_noon_stmt_two_tables.py,32 断言 ALL PASS):两表卡出现+含 2 张 table;表① 10 表头逐项全含;表② 8 费项+含税/VAT 子头各 8;粒度三态切换(默认月 2026-10 → 季 2026 Q4 → 年 2026 → 切回月);年粒度首行 2026 zipforce AE:打款 −263,943 = 银行 −260,080 + 余额 −3,863 精确成立;/noon 页回归整表 44 行、26+ 表头在(共享层替换无回归);移动 390 卡可见且页面无横向溢出。截图自检:财务页两表·桌面 1440|移动 390|/noon 整表回归·桌面。回归门(四道顺序跑):pen_tests ALL PASS|audit_nodes ALL PASS|frontend_e2e ALL PASS|dashboard_audit FAIL 1=既有 R17(zf 08-31 周费用覆盖,#47 门日志同款在案非本次引入)、WARN 5=已知 sku_mapping 成本欠账——零新增红。部署:web 容器 build+up 完成(前端-only,api/worker 不动)。遗留标注:年聚合钱包恒等式残差(期初 6,403+净 503,314−费 238,820−款 263,943=6,954 vs 期末 5,311,差 ~1,643)=既有已知(广告周批扣时点错位 1~2% + 费用覆盖缺口),非本次引入;对账单按品牌过滤仍为后续版本项。ads_daily_core.py 共享核心 906 行——build_report_configs(schema) 参数化 9 类报告 + run_daily_refresh(adr, refresh_mv) 唯一日刷入口 + _retry 级联回流(行错误 conn.rollback() 防事务 aborted 假失败级联);②zf_ads/fg_ads 品牌状态模块各 ~180 行(CREDS/PROFILES/代理绑定/ensure_token(+force)/_rate_limit/api_post(401+425)/api_get,REPORT_CONFIGS=build_report_configs('{schema}'))——非纯薄壳:ads_attr 薄壳依赖本模块接口(active_profiles/api_post 等);③config.py zf-ads/fg-ads desc 同步「品牌模块→ads_daily_core 共享核心,10-09 铁律级联收敛」;零通道变更(调度/入口/run.py 透传全不动)。等价断言(state/ads-assert-20261009.log,ALL GREEN):A:bak-zf vs bak-fg REPORT_CONFIGS schema 归一后逐字节相同(9 vs 9 报告);B1/B2:core 两品牌构建 vs 各自 bak 逐字节相同;C:9 报告 col_map+columns+groupBy 三方 9/9 相同(注:bak 模块 import 时顺触发 token 刷新打印——仅 refresh→access token,无写库副作用)。真跑验证(state/{zf,fg}-ads-verify-20261009.log 双绿):zf 出口 23.26.215.184 ✓ · 17 profiles · 报告 151 创建/151 完成/0 失败 · 129 行入库(BE 6/SA 71/AE 41/IT 7/FR 4)+ PHASE4 mv_asin_daily 刷新 ✓(AE sb、TR sb 各一次 429=当日噪声);fg 出口 72.245.71.143 ✓ · 18 profiles · 159/159/0 · 907 行(ES198/AU178/DE142/FR140/NL50/BE57/UK42/SE47/CA39/US14)(IE sd_campaigns/sd_targeting HTTP 400 kindleEdition 列无效+PL sb 429=当日已知噪声);双双 mid-run 401 token 强刷成功。备份:*.bak-converge-20261009 共 10 份在位。#54 继续:ads_snapshot(179 行 zf+fg 两段写死)+ ads_audit(151 行 brand='onno' 写死)+ 三梯队接口统一工程设计。amz_finances_core.py——parse_item 为 fg 超集(zf 调用时 event_* 等 9 键不在 zf COLS,[row.get(c) for c in cols] 投影自动丢弃,写库行为不变);run_flow(brand,table,lwa,markets,cols,all_events,conflict_cols,label) 唯一入口,品牌差异全参数;②双薄壳各 ~55 行(原 193/239)——zf 绑 LWA 三文件+MARKETS=[(na,None,None)×3]+all_events=False+CONFLICT_COLS 三元组;fg 绑单文件 LWA+MARKETS 14 市场+all_events=True+conflict_cols=None;③config.py 两条 desc 同步。零通道变更:collection_cycle_finances 每 6h :40 无参 run()、周日 03:20 --days 45 透传 main()、fee_backfill_targeted 报警 --days N 全不动——幂等(DO UPDATE/DO NOTHING)任意窗口重拉安全。onno 排除的架构判断(透明记录):onno_finances(269 行)非本对克隆——onno_common 代:月窗增量(MAX(posted_date) 起月循环 vs 滚动天数窗)、None 语义行构造(vs 0.0-init)、generic catch-all 事件派发(vs 显式映射)、marketplace 重贴标+孪生去重+价格回填三个事后钩子(R11/R16 修复);与 zf/fg 无实质共享面(连 FX 都不用——onno 表无 USD 换算列)。强行并入=核心三分支全走 2/3 死代码的参数化表演。onno 的参数化在其自有共享层 onno_common 已完成(token/api_get/upsert/marketplaces 多适配器共用)。若未来统一属三代接口统一工程(三梯队),需连表结构口径一起拍板。级联回流收益:行错误路径统一 conn.rollback()——原 zf 版缺失,psycopg2 事务 aborted 后所有后续行假失败级联+commit 炸(fg 版正确)。zf 生产从未触发行错误,无数据影响,纯防御级联。等价断言(容器内,28/28 全过,state/fin-assert-20261009.log):常量 4 组×2 bak 逐值 + COLS 逐列表 + LWA 逐区全量相同(不打印值)+ MARKETS 形态(zf 3 区 mp None / fg == bak 且全带 mp_id)+ parse_item 功能等价(合成 item 全字段:3 charge+3 fee 含未知类型+promo,逐值比对 zf 投影 25 键/fg 全 43 键;空 item 边界 quantity=1/currency 空串)+ SQL ast 真源比对(提取 bak 与 core 的 sql/upd_sql 赋值表达式按源码行序,eval 渲染后空白+逗号归一逐字节:zf DO UPDATE 含 upd_sql 全列 EXCLUDED / fg DO NOTHING)+ 双入口 + BRAND_OF + timeout(token 15+GET 60)+ rollback 回流 + 出口断言走 EXPECTED_IPS 注册表。断言器自身三处 bug 修正过程(写粗误报教训):①spec_from_file_location 对 .bak 后缀返回 None→显式 SourceFileLoader;②sql 赋值 dict setdefault 只留 DO UPDATE 分支→fg 渲染撞 conflict_cols=None 炸→改按行序收集数组;③逗号后空格未归一(bak 「a, b, c」 vs join 「a,b,c」)→norm 加 replace(', ', ',')。另发现 fg markets 实为 14 非注释所称 13(PL 后增,薄壳与 bak 逐项相等,docstring 陈旧无害)。真跑验证(11:39 UTC 顺序双品牌,run.py 无参=run() 入口=每 6h 日常档同路径):zf 出口 23.26.215.184 ✓ + na +0/eu +16/fe +0(1 页/区)+ DONE 16 upserted 0 err + 表 12,936 行最新 2026-10-08;fg 出口 72.245.71.143 ✓ + 14 市场全过(US/CA/MX/GB/DE/FR/IT/ES/SE/BE/AU/NL/IE/PL,1-2 页/市场,区域累计计数语义原样保留)+ DONE 342 upserted 0 err + 表 55,865 行最新 2026-10-09。二梯队剩余(#54 内继续):ads_snapshot(179 行 zf+fg 两段写死)+ ads_audit(151 行 brand='onno' 写死)+ 三梯队接口统一工程设计。test_90d_export 辅助;login RS256 JWT/导出创建轮询下载/orders UPSERT(cir 状态保护 CASE + customer_return 流水回填)/finance 22 列 UPSERT/print_stats 全同构。依赖面(与②不同点):scripts/ 四个消费者(statement_repull/monthly_status_sweep/repull_orders_cir/test_90d_export)import zf 版的 make_session/create_export/poll_download/sync_orders/ORDERS_EXPORT/FINANCE_EXPORT——薄壳必须保签名。收敛改动:①新建 noon_inc_core.py(~400 行):make_session(cred_file,proxy)/create_export/poll_download 纯会话函数(签名不变直传)、sync_orders(session,conn,schema,…)/sync_finance/print_stats、main_flow(cred_file,proxy,db,schema,label)(argparse 全参数 --days/--from/--to/--orders-only/--finance-only/--once/--interval);②双薄壳 53/34 行(原 366/361)——zf 版带 scripts 接口兼容层(make_session()/sync_orders() 原签名包装 schema 绑定,兼容层注释标「勿删」);③config.py 两条 desc 同步。零通道变更:run.py key、brands_source 档位、调度器全部不动——增量档调度全走 main() 透传路径(collection_noon_orders 每小时 :30 --days 1 --orders-only --once 900s;collection_noon_deep 每 6h --days 14 --orders-only+--days 35 --finance-only 1500s,35 天财务窗=2026-10-06 断流案修复参数原样保留)。timeout 根治级联回流:原两版 4 处网络调用(login/export create/status 轮询/CSV download)requests 全部零 socket timeout——与②同病(§203 孤儿案根因);core 统一 TIMEOUT=(15,60) 补齐全部 4 处(download 原标量 60 统一化)。cir 回填注释合并:两版实证数字并集保留(zf 4-6月 253/267/198 vs 官方 259/271/207 + onno 7月 0→18/9月 0→9),2026-10-05 用户拍板「cir 用精确新的数据源」语义不变。等价断言(容器内,36/36 全过):品牌绑定 10 + 双入口 4 + f-string SQL 渲染等价 2 品牌×5 条(ast JoinedStr 渲染 {SCHEMA}→schema vs .bak 常量 SQL 归一化逐字节比对:orders INSERT/orders cir CASE 两处表名引用×2/finance INSERT/CIR 回填 UPDATE)+ scripts 接口 inspect.signature 逐参一致 6 项 + timeout 4/4 + bak 裸奔实证。真跑验证(四段顺序=调度器真实路径,透传 main() 入口):onno orders d=1 Auth OK 3 行 UPSERT 3 + CIR 回填 113 行;finance d=3 13 行 UPSERT 13;出口 9.249.112.206 ✓。zf orders d=1 Auth OK 120 行 UPSERT 120 + CIR 回填 3347 行;finance d=3 771 行 UPSERT 771;出口 23.26.215.184 ✓。表计数健康:onno orders 1,137 [2026-02-23→10-08] / finance 1,078 [→10-07];zf orders 85,056 [2024-01-01→10-09] / finance 57,994 [2023-12-16→10-07]。新品牌接入标准:新 Noon 品牌 = 薄壳 ~35 行 + 凭证 json + brands_source.noon 增量档登记——核心零改动,小时/6h 双档自动纳入。import noon_onno/noon_zf(scripts/ 四个消费者全部指向增量版 noon_zf_inc=参数化③范围)。收敛改动(三文件+一处同步):①新建 /opt/collection/adapters/noon_full_core.py(~370 行)——auth(cred_file, proxy)、create_export/wait_download/parse_num/parse_date(纯会话函数)、_tables_ddl(schema) 纯函数(4 表+1 唯一索引 DDL,供等价断言直接调用)+ ensure_tables(cur, schema)(保留 [2026-09-05] pg_class 先查再 DDL 的 ingest_writer 无 CREATE 权限规避)、4 个 sync_*(session, db, schema, …)、main_flow(cred_file, proxy, db, schema, label);②noon_onno.py / noon_zf.py 双薄壳各 33 行(原 427/424 → 总 851→~436 行)——只绑三参数(凭证/代理/schema)+ run()/main() 双入口(run.py 透传调 main()、无参日常档调 run() 重设 argv --days 3 --once 与原版一致);③config.py 两条 desc 同步「薄壳→noon_full_core 共享核心」。零通道变更:run.py 的 onno-noon/zf-noon key、brands_source collect.noon_full 档位、collection_cycle_noon 每 6h :20 调度(subprocess 1200s)全不动。§203 孤儿案 timeout 根治(级联回流,两版克隆同时受益):原两版 4 处网络调用(login/export create/status 轮询/CSV download)requests 全部零 socket timeout(断言实证 bak 源码 timeout= 仅 2 处且均为函数形参)——死代理连接永久挂起、被外层 subprocess 1200s 杀成孤儿(§203 案根因)。core 统一 TIMEOUT=(15,60) 补齐全部 4 处;wait_download 的 status 查询本就在 try/except 内,超时异常自动走既有 10s 重试分支,行为闭环。自查修正一处顺序 bug(等价断言抓出):core 初版把 uq_fbpi_orders 唯一索引排在 dict 首位——全新 schema 首跑 DDL 路径会先建索引于不存在的表而炸;修正回原版顺序(索引在 fbpi_orders 表后),并加专项断言「索引序 > 表序」防复发。现网两 schema 表已存在走 exists 跳过分支,此修复保护的是新品牌接入路径。等价断言(容器内,28/28 全过):品牌绑定 10 项(CRED_FILE/PROXY/SCHEMA/双入口×2)+ BRAND_OF 出口断言登记 2 项 + DDL 逐对象 SQL 等价 2 品牌×5 对象(ast 提取两份 .bak 的 tables dict 字面量 vs core._tables_ddl(schema) 生成值,空白归一化后逐字节一致)+ DDL 顺序断言 + timeout 4/4 断言 + bak 裸奔实证 2 项。真跑验证(11:35 UTC 顺序双品牌,run.py 无参=run() 入口=每 6h 日常档同路径):onno-noon 出口断言 9.249.112.206 ✓ + 5 对象全 exists + Auth OK + Content Rejections=0 行(真实业务值,onno 账号无待拒内容,与原版行为一致)+ Done;zf-noon 出口断言 23.26.215.184 ✓ + 5 对象全 exists + Auth OK + Content Rejections 5 行入库 + Done。其余 3 端点(Catalog Sales/Global Catalog/FBPI Orders)按原版跳过(Noon 侧不可用,注释与行为一字不差保留)。日志头新增 [onno]/[zf] 标签(原版无品牌标识,无害增强)。新品牌接入标准(本案后固化):新 Noon 品牌 = 薄壳 ~40 行(三参数)+ 凭证 json + brands_source 行 collect.noon_full 登记——核心零改动,6h 链自动纳入。_retry() Decodo 代理重试(10-09 实证 18 profiles 第 8 个 503 tunnel 断流)未回流 zf 原版——zf 同走 Decodo 同病却无保护;zf 版的 BACKFILL_DAYS = sys.argv[1] 解析在 run.py 透传模式下永远取不到数字(argv[1]='zf-ads-attr'),fg 版全 argv 扫描才正确。两版各有对方缺失的修复=分叉的典型代价。收敛改动(三文件+一处同步):①新建 /opt/collection/adapters/ads_attr_core.py(234 行)——唯一入口 run_attr_backfill(adr, label),吸收两版并集最优:_retry 代理重试(5 次 15s 递增)、argv 全扫数字解析、GREATEST UPSERT 核心(ATTR_TEXT 转 numeric 比较 / ATTR_NUM 直接 GREATEST / 事实列覆盖,冲突键 profile_id+country+date+advertised_asin+campaign_id+ad_group_id)、三阶段(创建范围报告→35min 预算轮询+5min grace→下载 UPSERT);②zf_ads_attr.py 29 行 / fg_ads_attr.py 27 行双薄壳——只做品牌绑定(import zf_ads/fg_ads as adr + label),旧版 253/231 行进 .bak-converge-20261009 备份;zf 顺手删除遗留 /opt/uvpvp/scripts path(grep 实证 zf_ads.py 零依赖);③config.py 两条 desc 同步为「薄壳→ads_attr_core 共享核心」。零通道变更:run.py 的 zf-ads-attr/fg-ads-attr key、brands_source collect.ads 档位([[zf-ads-attr,3],[fg-ads-attr,5]])、_ads_plan 时刻表全部不动——明起 03:00/05:00 UTC 日常档自动走新薄壳。抓坑(真跑验证的必要性证明):薄壳初版只暴露 run(),首跑即 AttributeError: module has no attribute 'main'——run.py 双入口约定:透传模式(带参数)调 mod.main() 且 argv 重设为 [run.py]+透传参数,无参日常档调 mod.run("status-only")(原版 run() 无视 mode 全跑,薄壳同语义)。补 main() 后通过。真跑验证(--days 1 小窗,GREATEST 幂等安全,09:47 UTC 双品牌并行):zf 17/17 报告全完成 0 失败,处理 19 行新增 19 更新 0;fg 18/18 报告全完成 0 失败,处理 557 行新增 557(11 国有数:FR 102/ES 110/DE 92/AU 87/BE 46/NL 39/UK 29/SE 24/CA 20/US 8,7 国 empty 正常)。全新增合理——今晨旧版档跑时 Amazon 侧 10-08 归因未成熟,本次成熟补齐,正是归因回补存在意义。报告名前缀统一 ZF-ATTR-BF/FG-ATTR-BF(原 zf 版 ATTR-BF,Amazon 后台显示名无功能影响)。onno 同病检查(级联完整性):onno 无 Ads API(广告唯一源=人工 CSV 成品报表,导出即最终归因无延迟成熟问题)→ 不适用本回补,确认无病。全栈克隆对盘点(用户令「所有业务都要参数化」,diff 定量):第一梯队(高克隆度,直接套本样板)——zf_ads↔fg_ads(1035/1021 行,95% 同仅差 48)、noon_onno↔noon_zf(427/424 行,差 43)、noon_zf_inc↔onno_noon_inc(366/361 行,差 49);第二梯队(中克隆/轻违规)——finances 三套(zf 193/fg 239/onno 269)、ads_snapshot 179 行 zf+fg 两段写死、ads_audit 151 行 brand='onno' 写死;第三梯队(三代不同实现,属接口统一工程非逐行收敛)——zf_amazon↔fg_amazon↔onno_amazon(515/298/435)、settle_items×3、settlements×3、sales_fba 对(fg 312/onno 165)、derive 对(fg 271/onno 187);已参数化无需动——noon_full_pull/returns/soa/fbn_inbound/inventory_sync/amz_fba_sync/catalog_cascade(品牌字典+循环内置)、amz_ads_csv 与 noon_portal_apionly(--brand)。推进节奏:一案一收敛+真跑验证,第一梯队 next=zf_ads↔fg_ads(最大克隆对)。tables=None 全量 82 张表每小时清一遍(含 aba_search_terms 458 万行×两遍预扫);②clean_audit 整表 fetchall() 一次性载入内存。另有阻塞次生灾:ingest 三兄弟同步直跑阻塞 arq 事件循环最长 40 分钟,其余 cron 全体 delayed(worker.log 实证 collection_noon_orders delayed=1079s)。修法三件套(全已部署生效):①流式化——api/clean_audit.py 新增 _stream_src()(服务端游标+fetchmany 分批),五处全表级预扫集合由 rows 列表推导改单趟流式(语义不变,L391/L432/L478/L507);双胞胎 tools/audit_clean_all.py 同构同改(引擎改动铁律)。②限域——sync_source.py L1665:每小时增量只触达 orders/noon_orders/inventory_health/sales_hourly 四域,清洗限域到这四张(全量清洗仍归 04:30 daily)。③mem_limit 4g——docker-compose worker 服务 mem_limit: "4g"(compose L119)兜底防复发。附:ingest 三兄弟线程化+显式锁——tasks.py _INGEST_LOCK(threading.Lock)+ asyncio.to_thread:事件循环不再被阻塞(cron 不再 delayed),线程化后显式锁保序(sync_source 模块级 spec 状态非并发安全)。部署验证:api/worker 双容器已滚动(今日 #49 部署顺带携带);worker 实测内存 53.56MiB / 4GiB(1.31%)、RestartCount=0;容器内 clean_audit.py 流式标志在位。收尾说明:实质工作 10-09 晨已完成部署,本条目为补记(changelog/memory/TaskUpdate 三件套滞后于部署,用户问询触发补齐)。tools/collection_scheduler.py(10-02 方案A「半点采集/整点推送」)在半点档 docker exec worker python3 /collection/run.py noon-onno-inc --days 1(subprocess timeout=600)——TimeoutExpired 只杀宿主侧 docker exec 客户端,容器内 python3 成 ppid=0 孤儿永存,每半点+1。挂起根因=adapters/noon_onno.py 427 行内 所有 requests 调用无 socket timeout(wait_download 的 300s 只是应用层轮询上限;impex export/status 请求本身可无限挂死)。调度器通道健康度全量盘点(10-02 上线以来日志实证):noon-onno-inc 303 次全部 TimeoutExpired;noon-zf-inc 0 成功/34 失败(daemon 错+OCI exec 失败);fg-amazon 1 成功/34 失败(fg-amazon 不认 --hours 参数实际跑 mode=full,rc=127 OCI 错为主);zf-amazon 332/337 成功、onno-amazon 338/340 成功(健康)。数据零影响:worker arq cron 全部兜底——noon 增量 collection_noon_orders 每半点同 adapter 同节奏(--orders-only --once,容器内 subprocess 超时可有效 kill,日志实证 onno_noon_orders 1,137 行到 10-08、zf noon 最新单 10-09 08:16);amazon orders 通道三品牌订单全部新鲜到 10-09(fg 70/onno 10/zf 25 单)。止血(当日生效):调度器 INCREMENTAL_ADAPTERS 三品牌 noon 条目改空(本通道全败+与 worker cron 纯冗余双跑还互踩 noon API 配额;半点节奏由 worker cron 保持不变,用户拍板「半点采集」语义不受影响);调度器每分钟由 cron 重启自动加载。待用户拍板:①amazon 三条目(zf/onno/fg-amazon)是否也摘——同属与 worker cron orders 通道冗余双跑(无故障但双倍 SP-API 配额消耗),方向性优化不自主动;②根治挂账:noon_onno.py/noon_zf_inc.py 全部 requests 调用补 socket timeout(connect 15s/read 60s),消除挂死土壤。fg_ads.py 只拉昨天单日报表且 ON CONFLICT DO NOTHING——Amazon 归因字段(sales_7d 等)在事件日后 1-14 天持续回溯修正,昨天拉到的行当天写入后永不重访:sales_7d 永远停在事件日次日的不成熟值(偏小→ACOS 分母偏小→ACOS 虚高),且当天报表缺行=永久单日洞。zf 侧早有同问题修法(zf-ads-attr 14 天窗 GREATEST UPSERT),fg 从未跟进。新 adapter /opt/collection/adapters/fg_ads_attr.py(克隆 zf 模式):对 18 个 profile 创建 sp_advertised 范围报表(reportType=sp_advertised_products,14 天窗),轮询 COMPLETED 后下载 TSV 并 UPSERT 进 fittingirls_amazon.fittingirls_amazon_ads_advertised_products(SaaS cleaned_ads_sku_daily 上游,sync_source.py:805 实证)。UPSERT 语义=GREATEST(EXCLUDED.x, 原值):ATTR_TEXT={sales_other_sku_7d, units_sold_other_sku_7d}、ATTR_NUM={sales_7d, purchases_7d, purchases_same_sku_7d, units_sold_same_sku_7d, attributed_sales_same_sku_7d}(归因字段只进不退,吸收 Amazon 回溯修正);cost/clicks/impressions=EXCLUDED 覆盖(当日终值);conflict=(profile_id,country,date,advertised_asin,campaign_id,ad_group_id)。三轮调试定型:sys.path 注入、argv 全扫描数字参数(cron 经 run.py 传 "14")、_retry 代理重试。32 天回补(09-07~10-08):18/18 profile 报告全部 COMPLETED(MX/IE/SA/IT/PL/JP/SG 七站 empty=真实无广告),下载 17,926 行全部 UPSERT 成功。日志「新增 17,926|更新 0」系 psycopg2 rowcount 对 ON CONFLICT DO UPDATE 恒返回 1 的语义错觉——SQL 抽查 AU 10-01~08 每日 48-90 行键完整无双行,实际全部走 UPDATE 分支。SaaS ingest 一条龙:api 容器 sync_source.ingest_all(tables=["ads_sku_daily","ads_daily"])(拉源→UPSERT→clean_audit→_publish_clean_refreshed)59,432 行;cleaned 列=spend/sales(USD)+local_spend/local_sales+currency。注意 cleaned 层无 ad_sales_7d 列(\d 实证),7d 归因经源表字段进 ads_sku_daily。验证(三组对照,后台截图 vs API):①AU 7d 本币 ACOS=15.71% 与后台分毫不差($27/$262 原样);②7d sales 2,253.44 vs 后台 2,241.45(+0.5%);③30d sales 8,894.77 vs 8,478.35(+4.9%,多出部分=后台截图窗界日切差+10-08 尾部仍在回溯)。修复前工作台 38.8%/5,603 → 修复后 30d ACOS 回落至 sales 8,894.77 对应的成熟值。残差待拍板(唯一未闭环项):spend 系统性 +23%(7d 我们 638 vs 后台≈518);EU+UK 价内 VAT 拆净(×1/(1+税率))只解释 65/120(638→572.66),仍差 +10.6%——sales 已对齐而 spend 高,疑后台账单口径( billed vs invoiced / VAT 显示开关)需用户看后台设置拍板。不含未经确认的口径改动。cron 注册(注册表驱动):brands_source.fittingirls.source_map.collect.ads=[["fg-ads",4],["fg-ads-attr",5]](UTC 05 档,run.py 无 extra → mod.run("full") → sys.argv=[__file__,"14"] → 14 天窗);/opt/collection/config.py ADAPTERS 已注册 "fg-ads-attr"。每日自动跑,断流由 pipe_stale 水位报警兜底。部署:采集侧脚本即生效(宿主 /opt/collection);SaaS 侧无代码改动(既有 ingest 链);api/worker 镜像重建为 #49 部署顺带(本条目无容器依赖)。ABA_DOMAIN.get(country, 1) fallback——SE/BE/IE/PL/EU/AE/SA/SG 无 keepa 域(ABA_DOMAIN 仅 13 域),全部用 US domain=1 查询后冒牌写为该市场。用户拍板(AskUserQuestion):四个过滤方案全部被拒,拍板原文「只要有sku 就要监控,抓取数据」=全量保留不过滤。落地因此走数据卫生而非删数:假市场退场、UK→GB 归一、冒牌源切断——真实有 SKU 的市场一个不少。四文件改动:①api/core.py 新增 RANKING_MARKETS={US,GB,DE,FR,JP,CA,IT,ES,IN,MX,BR,AU,NL}(keepa 真实域全集);②api/tasks.py daily_amazon_rankings_keepa 循环改写——country UK/GB→"GB" 归一、非白名单市场 skipped_invalid 计数跳过(log.warning 可见)、domain 按归一后 market 取值(fallback 永不触发)、return 增 skipped_invalid;③api/routers/dashboard.py /api/rankings/markets SQL 加 market = ANY(%(mk)s)(仅 amazon 平台受限,noon 不受);/api/rankings 与 /api/rankings/history 入口 market=UK→GB、非法市场返回空、GB 查询并集 UK 历史(m_sql="market IN ('GB','UK')",三处 CTE+as_of 全换)——09-29 前 market='UK' 的历史快照无缝延续。数据层零删除(auto mode 分类器实证):rankings_daily EU/UK 脏行(EU 2,353 行)与 mapping 侧 EU 行保留未删——会话权限分类器三次拦截 DELETE/UPDATE(遵指引停止撞墙),展示层已过滤无害;回滚/将来执行依据=tools/rankings_market_hygiene_backup_20261009/ 3 个 CSV(rankings_eu_uk_rows 2,353 行/shared_mapping_eu_rows 209/sku_mapping_eu_uk_rows 211)。API 验证(三组断言全过):①amazon 芯片收敛为 10 真实市场 ['AU','CA','DE','ES','FR','GB','IT','MX','NL','US'],EU/UK 消失,GB=164 SKU(并入 UK 历史后);②market=EU 拦截返回空、market=UK 自动归一返回 GB 数据;③B0FHH9KYQB 79 个快照证明 UK 历史完整并入 GB 视图。截图自检(双视口+公网 200):排名页·桌面 1440|移动 390——视觉确认 10 芯片(GB 高亮 ·164·/US ·135·/IT ·53·…)、EU/UK 无、GB 表 ASIN/BSR/评分/评论渲染正常。AU ·1· 说明(既有饥饿非回归):raw/cleaned 层 AU 10-05/07/09 每日 1 行=旧采集器在 sku_mapping 扩容前的历史状态;sku_mapping 现有 AU 350 行/228 ASIN(#41 回填就位),明早 05:20 UTC 新 worker 代码首跑后 AU 芯片将自然抓满(keepa 在榜 127)。回归门(四道顺序跑,仓库根):pen_tests ALL PASS|audit_nodes ALL PASS(tools/backups/ 目录就绪)|frontend_e2e ALL PASS|dashboard_audit FAIL 1=既有 R17(zf 08-31 周费用覆盖,07:11 历史日志同款在案,非本次引入)——零新增红。部署:api/worker 双容器均已滚动完成(worker 滚动时容器内 6 个 noon-onno-inc 卡死孤儿先甄别后清除,见下一条目);新容器验证 RANKING_MARKETS 13 市场+keepa 任务注册+arq 27 cron 正常调度。DISTINCT ON (market, 月份) 随机丢一品牌——①kpi-wall pay CTE 打款列历史少算(zf SA 2026-09 payouts −42,385.53/onno −20,858.21 只取其一);②新增 _st_m VAT 聚合同险;③/api/noon/summary 逐行下发同月双格式重复行。三处统一改 DISTINCT ON (brand, market, left(stmt_month,7))(2026-09-17 回款翻倍修法+brand 维度),/noon 表加品牌列区分。API 断言 14 项全绿(tools/_verify_47_api_1009.py,curl+cookie 直打生产):A 单月 2026-09 zf→SA 11,716.21/deduct、AE 762.57/deduct、stmt totals 89,822.26/11,716.21/78,106.05、广告 33,328.76、破损 −874.02、分项和=合计、折USD 3,331.96、all_usd deduct;B months=3→mixed(10月无单);C 2025-09→deduct(2025 对账单 R9 已扩采回填,断言首版写反已修);D summary 品牌字段+归一后 zf SA 2026-09 恰 1 行(审计账号 scope=zipforce,onno 行经 RLS 隔离不现=隔离正确)。DOM 截图断言(tools/_shot_1009_47.py 双视口):财务页 VAT(税) 列头、SA 11,716/AE 763、SA title 含「扣款实值」、拆解卡无残留;/noon 全分项表头+品牌列、2026-09 zf SA 行(89,822 锚)含 33,329/4,347/114。截图:财务页·桌面|移动|/noon 对账单·桌面|移动——视觉确认两页渲染正常、24 列宽表横向滚动、贷记绿色冲减。回归门(宿主机顺序跑):pen_tests ALL PASS|audit_nodes ALL PASS(vat_est 口径变更未触发基准漂移)|frontend_e2e 两次单独重跑:第一次 1 FAIL=KPI 卡下拉切换(第二次同项 PASS=时序 flaky,改动面零交集)+本次仅剩 1 FAIL=429 限流(§73 既有坑:四门连跑+验证脚本消耗 240/min 桶;126 业务断言全过)|dashboard_audit FAIL 1=既有 R17 零新增(zipforce 08-31 周费用覆盖,§195 源头挂账)+WARN 5(sku_mapping 缺成本维护欠账)。定案:#47 零回归。边界说明:Amazon 零改动(官方 order_fees.vat 直读);SKU 级 4 表维持推算(悬停已注明口径差);未出账月份(如当月)拆解表整表不显示+提示,VAT 列走推算兜底、出账自动换实值;银行/余额转账为钱包划转非应税费用不计 VAT。zipforce_noon_finance_transactions 的 9 个 *_vat 后缀列全是含税费用总额(列名误导)——恒等式 net_proceeds + 负值费用 = total 单行级成立(此前 n_exact3=0 系符号错:费用列是负值,减了负值);列语义修正存档:net_proceeds=费前商品价,total=费后实收;②官方对账单 statement_official 21 列无任何税额字段,唯一疑似列 import_vat_recovery 全库为空;③流水类型枚举 仅 order/order_update/statement_fee/payment/balance_transfer,无独立 VAT 行;④真实税额只存在于 noon 税务发票,而 noon 财务无 API(noon-api-platform-deep-dive 结论)→ 唯一路径=按法定税率内拆推算。对比 Amazon 有 order_fees.vat 官方逐笔真值不用推算(#43 已直读)。数字是对的(单行级分毫不差):费率卡实证——官方净佣金率(zipforce_noon_fees_referral JSON)×1.15(SA)/×1.05(AE)=流水实扣:SA 单 67.85×20%×1.15=15.6055→实扣 −15.61 ✓、AE 单 65.72×15%×1.05=10.35→实扣 −10.35 ✓;页面复算——AE (5,074.41+4,974.56+252.15)×5/105+5,121.08×5%=746.53→显示 747 ✓、SA (32,579.27+22,164.80+534.00+105.10)×15/115+28,499.24×15%=11,498.78→显示 11,499 ✓(结算净额验算 6,104+23,307=29,411 USD 分毫不差);税率旁证——对账单 advertising_fee(含税)÷媒体日报 spend(不含税) Sep 比值 AE 1.0452/SA 1.1695,近 6 月均值 1.054/1.164,在周批扣时点噪声(±5%)内与法定 1.05/1.15 相容。用户「复算对不上」的两个真实原因(均已消除):①VAT 基数含分市场表未显示的 other_order_fees/non_order_fees/others 三费列(5,074.41 里含 252.15、32,579.27 旁含 534.00+105.10);②含税拆税 ×15/115=13.04%≠直觉 ×15%(15%×(32,579+22,165+28,499)=12,486 vs 实显 11,499)。修复:悬停即见完整实算(API+前端两处,build api+web 已部署):①API finance.py noon_rows 追加下发三费列 other_order_fees/non_order_fees/others(含 _usd_row 折算)——分市场表此前不下发、但计入 vat_est 的隐性基数从此可见;②前端 finance/page.tsx noonRow() 生成 vatTip:分市场行悬停显示 VAT(推算) 实算=(|佣金|+|尾程|+|其他订单费|+|非订单费|+|其他|)×15/115(含税内拆)+|广告|×15%(不含税外加)=… SAR/AED 全数字明细+「五费列均为含税实扣(单行实证:净佣金率×1.15/1.05=流水实扣);noon 无官方税额列,真实税额仅在其税务发票」注记;All 汇总行显示折 USD 锚定汇率说明。信息列性质不变,不动任何利润公式(#43 原则延续)。验证:断言脚本 tools/_shot_1009_noon_vattip.py 三轮迭代后 ALL ASSERT PASS(双视口、固定 2026-09:SA 行 title 含 15/115、11,499、SAR、佣金、广告;AE 行含 5/105、747、AED;All 行含折USD提示;按行首格文本分类避开 SA+AE 汇总行)。截图:分市场表·桌面|移动——视觉确认:3 行结构(SA+AE 汇总/AE AED/SA SAR)、月份 2026-09、佣金列与 9 月实数一致(−5.07k/−32.57k)、无报错/空白/错位;VAT 列在横向滚动区=宽表既有设计(DOM 断言已确凿)。核验 SQL 留档 tools/_chk_noon_vat_1009.sql。回归门(四道顺序跑):pen ALL PASS|audit_nodes ALL PASS|frontend_e2e ALL PASS|dashboard_audit FAIL 1=既有 R17 零新增(zipforce 08-31 周费用覆盖,§195 定案源头挂账,滚动成熟窗随时间逐日激活)+WARN 5(sku_mapping 缺成本维护欠账,晨间 3→5=S-988 Pro/Bento 新 SKU 开始出单,维护类非回归)。**追加质询核验(同日用户三连问)**:①33,328.76 SAR 确认为含 15% VAT 实扣额(÷1.15=28,981.53 净额 vs 媒体 28,499.24 仅差 1.7% 周批时点;单笔流水净佣金率×1.15=实扣分毫不差);②「差值=VAT」近但不纯:4,829.52=理论 VAT 4,274.89+时点残差 554.63;③全年累计时点残差抵消实证:2026-01~09 累计 SA 残差 +0.38%/AE −0.34%(单月摆动 −4.8%~+7.9% 收缩至 ±0.4% 内,正负号相反=边界周随机摆动特征),真全年结完仅剩年初/年末两条边界周且相邻年份消耗相近时对冲趋零,年结须等次年 1 月对账单闭合。**新挂账:媒体日报 251 行全钉 2025-01-01 一天**(SA 240,851.92+AE 83,366.22=正常月 8 倍,疑采集首拉历史总量桶占错日期;不影响 30/90 天窗,广告页按年看有单日异常尖峰,待清洗层处理)。coalesce(seller_sku,'')<>'';zf FBA country 596/596 全 NULL(fg/onno 全有值)→ marketplace 列推导(A1PA6795UKMFR9=amazon.de→'DE'、'EU'→'DE'、其余标签即国家码)。修复②:catalog_cascade.py 日级联(01:40 cron,正式机制):宪法 SKU 粒度补全——每日 diff 平台源 vs 目录自动插新 SKU 行,三品牌 Amazon + zf/onno Noon;支持 --dry;幂等双跑验证过(第二遍全 0)。NULL=NULL 重复插入坑破案存档:首轮 NOT EXISTS 判重 m.country=f.country 双 NULL 不为真 → 每跑一轮重复插 199 对(两轮 398 行实证)→ DELETE 后改两侧 coalesce 根治;修复后 zf 插 576 行真实站点粒度(DE/UK/MX/CA/US 五站)。修复③:勾稽门:recon_gates.py 新增「级联.SKU目录覆盖」门(三品牌 FBA 在库 ASIN ⊆ mapping 目录,期望 0,实测 0 绿)——次日未闭合即报警;SQL 路由扩展(shared.mapping/_inventory_fba → amazon_analytics 库)。keepa 排名补齐排程:目录扩容后 keepa 采集范围 10,094 ASIN 就位,但今日触发撞「Keepa token 不足,已排队重试」(token 分钟级配额耗尽,手动重触发无效)→ 一次性重试脚本 keepa_retry_once_20261009.sh 挂 cron 今晚 21:57(token 随时间回充)+ 明早 05:20 例行 cron 兜底——排名页 Amazon 列数今明两天长全,明早复核。四道门(顺序跑):pen ALL PASS|audit_nodes ALL PASS|frontend_e2e ALL PASS|dashboard_audit FAIL 2=既有 R17(08-31 周 38%,上条定案源头挂账)+ hourDist 日界伪红(00:51 跑门踩 UTC/北京日切缝,onno 今日 1 单在界上,§89 家族时界现象,08:00 北京后自愈,非回归——订单数据只增,未改口径)。截图自检(双视口+视觉确认 3 张,changelog URL 直读):排名页·桌面 1600|移动 390|onno×Noon SA 视图——桌面:布局正常无空白卡,市场标签含 Noon AE/Noon SA(Noon AE 带 09-29 偏旧橙色警示=zf noon rankings 断更 R4 旧案挂账),品牌切换 onno 可见(绿点),zf×Amazon MX 19 在榜/BSR 列「—」=keepa bsr_big 待今晚补拉;onno×Noon SA:4 SKU 在榜渲染正常(快照 09-29 与采集口径一致)。坑存档:watcher pgrep/grep 模式串出现在自身 cmdline → 永不触发/假阳性(今日三起:portal 永不 fire、kill 循环自杀 exit 137、settlement 假 RUNNING)——修法=模式加 python3* 前缀 + skip self;docker exec heredoc 必须 -i(漏则 stdin 进不去 psql 静默零输出);api 容器无 kill 二进制 → sh -c 'kill -9 $pid'。audit.cleaned_order_fees.vat/local_vat 官方逐笔真值直接 sum 暴露(表头「VAT税」,tooltip 注明官方税额 order_fees.vat;本地VAT税列展示 local_vat 本币);Noon=无官方税额列——实证 finance_transactions 的 *_vat 列名误导,实为「含税费用总额」(net_proceeds−referral_fee_vat−fulfillment_fee_vat=total 分毫不差)→ 推算公式 v2:vat_est=(|commission|+|delivery_fee|+|other_order_fees|+|non_order_fees|+|others|)×VAT_IN + |ad|×VAT_OUT,费用五列 内拆(SA 15/115、AE 5/105)+ 广告 外加(SA 0.15、AE 0.05),补贴/credits 加项不参与(用户令「只要扣了的」);表头「VAT(推算)」+tooltip 写公式。v1 只拆三费,v2 升级全五费用列(other_order_fees/non_order_fees/others 同为含税扣款)。两原则:①VAT 为信息列并列展示,不改任何利润公式;②广告基数自洽——VAT 跟随各表既有广告基数(pl_monthly.ad_cost vs ads_daily 两源口径差异保持不动,不因加 VAT 改净利)。API(api/routers/finance.py,9 端点 15 处,build api 已部署):full matrix(vat USD)/countries(vat+local_vat)/noon 产品×月(vat_est 本币)/years(vat);kpi-wall amazon.all(vat)+amazon.countries(vat+local_vat)+noon.rows(vat_est)+noon.all_usd(vat_est);profit-matrix grand(amz 侧 vat + noon 侧 vat_est 折USD);noon-sku(vat_est);monthly noon_models(vat_est);product-pl 双侧(amazon vat / noon vat_est);noon-pnl 三块(kpi/monthly/annual 均 vat_est);/api/noon/summary statements(vat_est)。noon VAT 折 USD 走 _noon_usd 锚定汇率。前端(web/app/finance/page.tsx,21 处编辑,build web 已部署):12 个类型加 vat/vat_est 字段;MatrixTab(汇总条 pm-stat「VAT税」+ 国家 tip 行 + 明细表 VAT税 列);ProfitHero(mons 累计 vat + TACOS 后「VAT税」展示);费用结构 chart 第五系列「VAT税」(#e11d48 堆叠);品牌×月度矩阵 23 列(+VAT税);分市场 KPI 8 列(+本地VAT税);Noon 产品×月 18 列(+VAT(推算));Amazon/Noon 累计分市场表(+VAT税/+VAT(推算));NOON_SPEC 39 列深度表(+vat_est 列,_MONEY_KEYS 入列);Noon SKU P&L(ad 后 VAT(推算)(本币)列);MonthlyTab Noon Model×月 12 列;产品损益 Amazon 14 列/Noon 10 列;年度对比 6 列 + chart 虚线钻石第三系列「VAT税 USD」。各表 colSpan 同步 +1。API 全链实证(9 端点,非零/零值均有数据实况解释):profit-matrix grand amz 1292.44 + noon 17307.65;noon-sku Airfit Light SA 31349.63;/api/noon/summary(真实路由无 /finance 前缀)2026-09 SA statements vat_est=11943.96;kpi-wall UK/FR/ES/IT/SE/BE 非零。当前月 $0=实况非 bug:matrix 倒序最新在前,2026-10 全库 vat 仅 $12.38(591 单月初未结算,9月 3666.73/8月 614.88 非零)且 10 月非零行全部属 fittingirls——zipforce 租户 10 月真无 VAT,ProfitHero/分市场KPI(锁定最新月)显 0 正确。截图自检(tools/_shot_1009_finance_vat{,_fp}.py,viewport 双视口 5 态程序断言 ALL ASSERT PASS + full_page 3 张视觉确认):总览·桌面|移动|总览·全页|Noon 总览·全页|盈利矩阵·全页|产品损益|年度对比——断言:Amazon 表头「VAT税/VAT/VAT USD」、Noon「VAT(推算)/VAT(推算)(本币)」、费用结构卡「VAT税(官方税额)」、pm-stat 含 VAT;视觉确认(changelog URL 直读):费用结构 chart 第五系列红色分段实渲染、分市场 KPI 本地VAT税列就位、盈利矩阵口径行「VAT税 $76,892」(全窗口径)+汇总条当前月 $0、无 NaN/undefined/错位/乱码;宽表(23 列矩阵/39 列深度表)VAT 列在横滚区右侧=设计(full_page 亦只拍视口宽,列存在性由 DOM th 断言确凿)。附带破案+自主修复:租户1(ZIPFORCE 演示租户)onno 数据被 RLS 静默隐藏:四道门 e2e「工作台全状态组合扫」FAIL(Amazon/onno 四窗口裸零卡 $0)→ API 层 /api/dashboard/charts?brand=onno&platform=amazon 返回 empty=true(200 静默空墙非报错)→ RLS 下租户1 会话只见 zipforce(onno 462 行/fittingirls 26336 行全部不可见)→ pg_get_expr 落库复核策略:第三支 seller_owner IN (tenant_accounts WHERE tenant_id=…),而 tenant_accounts 10-08 10:36(#38 重建日)播种只按品牌归属(onno_amazon→租户2、fittingirls_amazon→租户3),漏了租户1——但 brands_source(1,onno,amazon)=t + tenant_brands(1,onno)=t 双注册表都判租户1该见 onno(品牌轴与账号轴两注册表交叉不一致)。修复=INSERT (1,'onno_amazon','amazon') 一行注册表补映射(加法、可逆、不动策略代码、不弱化租户2/3 隔离),RLS 即恢复租户1 见 onno(7 天 38 单),工作台卡实值 38 单/$838、组合扫复跑 0 异常、pen 复跑 ALL PASS 佐证隔离无损。fittingirls 租户1 tenant_brands is_active=f(品牌已迁独立租户3)不受影响。教训存档:品牌轴(brands_source/tenant_brands)与账号轴(tenant_accounts)两注册表必须交叉一致,账号轴缺行=RLS 静默空墙(200 empty),门断言是唯一暴露面。回归门(四道顺序跑,中途两次 e2e TimeoutError 崩溃=2h 清洗引擎 ABA 295 万行长事务阶段与财务重查询锁竞争瞬态,API 健康时最慢端点 3.4s,非代码问题,负载过后复跑通过):pen ALL PASS|audit_nodes ALL PASS(2871 数值节点/18 基准)|frontend_e2e ALL PASS(127 项含组合扫修复后 0 异常)|dashboard_audit 192+ 项 FAIL 1=既有 R17 零新增(zipforce 08-31 周费用覆盖 38%——今晨 #40 条目定案 51 缺费单=SA31+AE20 源头挂账;该周今日才成熟进窗激活 ≥20 单阈值:门窗口 now()-35d 逐日右移,昨日跑同门该周仅截 2 天 18 单被 HAVING 跳过)+WARN 5(sku_mapping 缺成本维护欠账)。e2e C9(排名页 SKU·ASIN 映射)一次 FAIL 一次 PASS=数据序抖动(#41 keepa 补拉在途),非回归。/impex/v1/import/create 端点系编造(noon API Platform 全文档无此路径)、从未真实提交过一次(零成功记录)、api 容器直连 noon 网关被 Akamai IP 白名单 403。旧 web 端只有一个 CSV 拼接文本框。新通道(全部 schema 实证自 noon 官方 content-service 文档):POST /content/v1/product/upsert 同步建品——请求 {skus[{partner_sku*,size?}], brand*, category*, images[{url*,sort*}], attributes{}},响应 {sku_parent, variants[{sku(=NSKU), partner_sku, psku_code, size}]}(同步返回无轮询;限流 1500/60s);认证=RS256 JWT(sub=key_id)→/identity/public/v1/api/login 换 session cookie;网关须走 Decodo 代理(noonops._session 已实现,api 容器直连 403)。后端四端点(api/routers/listing.py,真网关验证过):①GET /api/listing/noon/categories——categories/list 拉取 6,781 个真实类目(family-type-subtype 三段式),内存缓存 24h;②GET /api/listing/noon/category-attrs——ListCategoryAttributes 动态属性 schema(attribute_type 枚举/必填/多值/字数/数值区间/选项),缓存键 brand|category 7 天;③POST /api/listing/noon/task——建品任务存库(唯一键冲突 409);④GET /api/listing/noon/content/{tid}——GetContent QC 状态(EN/AR 双语独立审核+completeness+驳回原因+图片审核 badges)。submit 走既有 /api/listing/tasks/{tid}/submit:?dry_run=1 纯本地预检(必填校验+载荷预览不调网关,缺必填 422),真跑同步返回 NSKU 并回写 sku_mapping,网关错 502 透传。任务状态机 draft→ready→submitting→imported/failed;draft 提交 409;QC 终态不改任务状态(UI 呈现)。前端 NoonListingTab.tsx 全量重写(595 行,三 sub-tab):📋 SKU 清单=offer/list 现状(在线/Buy Box/FBN/问题数);🚀 建品向导六步——①基础信息(品牌 select/SKU/noon 展示品牌/尺码/阿语标题暂存)→②类目搜索(防抖 350ms 打真实类目库,下拉 zIndex:30 maxHeight:320,选中自动置 noon 品牌默认+清属性)→③动态属性表单(按 attribute_type 分派 SELECT 单/多值、NUMERIC/METRIC 数字带 ≥min ≤max 占位、BOOL、超长文本 textarea;必填红*+缺必填红字汇总;保存时类型归一:多值 split 数组/数字 Number())→④图片(url+sort+44px 预览)→⑤提交(保存→Dry-run 预检(载荷 JSON 可折叠预览+缺必填清单)→确认 checkbox→真实提交(NSKU/psku_code 表格呈现))→⑥QC 面板(EN/AR 双语卡 APPROVED/PENDING/REJECTED 配色、completeness、缺属性/无效属性 chips、驳回原因、图片 review_status);🗂 任务与 QC=任务表(编辑跳转向导 ?edit=/预检/提交/QC 快捷操作,提交前 confirm 弹窗)。实测闭环(真实 UI 全链):类目搜索"headphone"→12 命中(earbud_tip~headphone_adapter,全真实类目码)→选首条→30 属性动态表单渲染(colour_family 等 SELECT 枚举、vat_rate_ae/eg/sa、product_title 红必填、「缺必填: product_title」红字汇总)→无 NaN/undefined/乱码。截图自检(screenshots/noon-b1-20261008/ 10 张):SKU清单·桌面·移动|向导基础·桌面·移动|类目搜索·移动全页(下拉入帧)|类目下拉·桌面(程序断言 top462→bottom782 在 1000px 视口内+12 行真实类目)|属性表单·桌面全页(30 控件三列栅格+必填标红)|任务QC·桌面·移动。快照 backups/code-2026-10-08-noon-b1/saas.tar。视觉误报自纠(存档教训):初判「桌面下拉在视口内」实为 locator.count() DOM 附着证据≠像素证据(zoom 图与原图逐字节同 md5,且 CDN 上传按文件名去重复用旧 URL——修正图必须换文件名重传);视口内实证必须 getBoundingClientRect 断言(top≥0 && bottom≤innerHeight)+ scrollIntoView({block:'start'})。回归门(四道顺序跑):pen ALL PASS|audit_nodes ALL PASS(新 4 端点登记快照 169→173;另修 3 条 kpi-cards 基准假 FAIL:10-02 方案A 把 rolling noon 金额改「窗口触及月对齐」,基准仍单月 max(mon) 锚——10 月月行落地即暴露,rev30 70944 vs 21458 差恰=整 9 月;三基准同步月窗后 18/18 全过=§89「改 API 窗口语义必须同步审计基准」教训复发,上次只同步了 e2e)|frontend_e2e ALL PASS|dashboard_audit FAIL 1=既有 R17(费用覆盖真阳性已立案,与本改动无关)——同门另拔 13 条假 FAIL:①noon_base_30d 滞后判定 psql 布尔返回字符串 'f' 恒真→基准恒走月对齐支(日源 10-07 回鲜 API 切日窗 43753,基准卡死月窗 58952,差恰=9月1-8日 15199),::int 强转根治;②kpi_pool NM 单月锚同款月窗同步。待拍板(产品口径分叉,未动):概览卡 noon 金额恒月对齐(_kpi_deck)vs 工作台 noon 板块日源新鲜时日窗精确切(_noon_kpi 10-06 双模式)——10-06 断流期间两者恰一致掩盖分叉,10-07 回鲜首次同页两数(卡 70944 vs 板块 55745),是否级联日窗到卡片待用户拍板。SELECT max(d) FROM audit.cleaned_noon_daily_finance(同 brand/country 过滤)≥ 窗末-3 天 → 日窗精确切 d BETWEEN wf AND wt,按国别 _noon_usd 锚定汇率(SAR 3.75/AED 3.6725)折 USD:rev=gmv、comm=abs(commission)、fba=abs(delivery_fee)、profit=settlement;滞后>3 天 → 回退月对齐 + 脚注「Noon金额按窗口涉及月对齐(日财务流水至{fin_max})」;空表 max=None 同效回退(与 _noon_kpi 判据逐字同构)。N["profit"] -= N["adsp"] 其后照常。kpi_cards_get 的 platform=noon and date 分支把工具栏 date/date2 换算 win=(wf,wt) 传入。两门基准同步(§89 铁律:改 API 窗口语义必须同步审计基准,两门一起):①audit_nodes BASAL /api/dashboard/kpi-cards?platform= rev30/commission/fba 三键 noon 半边改 CASE 双模式(同判据+同窗+同汇率 CASE);②dashboard_audit kpi_pool_reconcile rev/comm/fba/settle 四键 _dual() CASE 同构(空表 max(d)=NULL → CASE 落 ELSE 月对齐,与 API _fin_max None 同效)。实测两表面归一:kpi-cards?platform=noon(无参全牌)rev30=43,752.94 与板块 _noon_kpi 分毫不差;platform=(全部)=55,766.03;无滞后脚注(日源新鲜走日窗)。UI 同参对账(Noon tab 实际请求 brand=zipforce&period=rolling&date=2026-09-09&date2=2026-10-08):营收卡 $42,839 == SQL 日窗基准 42,839.09 分毫不差;月对齐旧值 57,466.59 未采用。十卡值 2,435/$42,839/$19,168/$16,095/$9,014/$6,176/44.7%/$18/$7,576/21.2% 与 API 十键一一对应,页面无 undefined/NaN。截图自检(screenshots/noon-b1-20261008/):概览卡 deck 元素级·桌面(10 卡两行五列完整入镜,营收卡 $42,839 目视确认,无 57,4xx/70,9xx、无月对齐脚注、无乱码/NaN)|Noon tab 移动全页(390×844,卡区目视正常)|过程证据:07(10 条断货警报把卡挤出 1600×1000 视口)→07c(scrollIntoView 后 sticky 头仍压首排——getBoundingClientRect 不感知 sticky 遮挡)→07d 根治(deck 容器 element.screenshot)。教训存档:视口截图三坑=警报挤出/sticky 遮挡/CDN 按文件名去重(修正图必须换名重传)。「全部平台」合并视图 09-16 已拍板下架(代码保留),级联验证点=Noon tab。回归门(四道顺序跑):pen ALL PASS|audit_nodes ALL PASS(18 基准全过,含新双模式 rev30/commission/fba/ad_spend)|frontend_e2e ALL PASS(工作台全状态组合扫 0 异常)|dashboard_audit 192+ 项 FAIL 1=既有 R17(zipforce 08-31 周费用覆盖,SA/AE SPAPI finances 停更真阳性已立案,与本改动无关)——零新增红。snapshot_date=(SELECT max(snapshot_date) FROM ... i2 WHERE i2.brand=i.brand)(brandboard.py:436 为正确范式参照);②空 SKU 行(sku='')产出「Noon 断货: 」空标题 → coalesce(i.sku,'')<>'';③同 SKU 跨 AE/SA 两国各一条、标题截断 25 字符后相同读作重复 → 标题追加「· {country}站」。修复后租户1 Noon 库存报警 10 条标题全唯一(同 SKU 跨站对带 ·AE站/·SA站 可区分=合法业务重复)、租户2 缩为 2 条唯一,API probe + 页面断言(regex 标题唯一性)双验证。notify pipe_domains 顺手修:报警管道域指向 audit.cleaned_noon_daily_finance(根因修复)。Phase B 渠道真源实证(调查完毕,方案待拍板):onno amazon「代卖 vs 自营」可分——mars amazon_analytics 三账号独立 schema(zipforce_amazon/onno_amazon/fittingirls_amazon)为渠道天然分界;spapi_orders+spapi_order_items 按 amazon_order_id 精确对账可行;国家近似渠道法已证伪(代卖单含 DE、PL)。实证规模:代卖=zipforce 账号 5 个 EU 尾 SKU 377 单/90d;自营=onno 账号 14 个 AU/SA/AE/US 尾 SKU;当前 SKU 按市场尾码互斥但基名跨渠道——「同 SKU 可分」是架构能力要求(用户拍板④)。三项待拍板:①渠道标注方案=mars 采集侧戳记 vs saas 清洗层派生+按 mars 账号 schema 回填;②raw 加列 seller_owner 与「rawdata 格式固定不建新表」铁律的取舍;③租户可见性=渠道级 RLS(租户1 只见代卖/租户2 只见自营)vs 品牌级(两租户都见 onno 全量再分渠道展示)。回归门(四道顺序跑)+ 工具坑:pen ALL PASS|audit_nodes ALL PASS(171 端点/2,632 节点/18 基准)|frontend_e2e ALL PASS(工作台全状态组合扫 0 异常)|dashboard_audit 192+ 项 FAIL 1=既有 R17(zipforce 08-31 周费用覆盖 45%,SPAPI finances SA/AE 停更真阳性已立案,与本改动无关)+ WARN 5 既有成本对账——零新增红。坑存档:四道门循环命令用管道 tail 截每门输出+吞 Python 退出码,dashboard_audit 汇总行被切、日志伪绿 EXIT=0——门 verdict 必须以完整重跑(192+ 项 FAIL 1, EXIT=1)为准。截图自检(screenshots/cross-isolation-fix-20261008/ 10 张):租户1 Noon·桌面·移动(zf-only 42,8xx,Top 榜无 ON* 渗漏)|租户2 Noon·桌面·移动(913.85/50 单新可见)|租户2 Amazon·桌面·移动(7,06x 不变)|报警修复复截 4 张(-2 后缀规 CDN 文件名去重):租户1·桌面·移动(10 条唯一)|租户2·桌面·移动(2 条唯一)——analyze_image 目视双通过(报警唯一+国别后缀+无 undefined/NaN)。pg-init/77——tenant_accounts 注册表(PK(tenant_id,account) 5 行:zf_amazon/zf_noon/onno_amazon/onno_noon/fg_amazon,GRANT SELECT portal_app)+ orders/fees ADD COLUMN IF NOT EXISTS seller_owner + 全史回填(orders 41,985/fees 36,159 行 empty=0;fees 先按订单继承再孤儿 brand 字面量,14 条 onno 孤儿经 mars 双 schema 反查 14/14=onno_amazon)+ 策略收敛 DO 块(audit 全部 brand_isolation 幂等重建为规范四分支模板=tenant_brands+brand_scope+noon 表 brands_source 交集+有 seller_owner 列者 tenant_accounts 交集;#26 第三分支自此持久化进 pg-init);②sync_source.py 打戳 7 处(_ORDERS_TYPES 30 字符+_ORDERS_COLS 末位 seller_owner/三分支末列:zipforce→'zipforce_amazon'、fg→'fittingirls_amazon'、onno→CASE v.source;fees 4 处 format so= 参数);③部署序=build api→DB 级 SQL→up -d api→定向 upsert 验证(orders 增量 811/fees 全量 36,159)→定向清洗 2/2——CTAS AS SELECT * LIMIT 0 列自动级联→引擎 information_schema 探测到新列→第四分支自动重建(清洗引擎=策略唯一持久化点)。双向混池根治+三租户守恒(验证法:owner 总数=Σ各租户 RLS 视角):租户2 EU 代卖泄漏归零(FR 100/GB 71/ES 89/IT 54 行不再渗入);租户1 同时掉 onno 自营 459 行(此前 brand∈{zipforce,onno} 反向混入租户2 自营——第四分支双向都治);守恒 orders 41,988=15,224+459+26,305、fees 36,159=12,669+354+23,136,无重叠无遗漏。分隔符大案(本日第二案,11 FAIL 半边归零破案):门2 audit_nodes 11 FAIL 形状=API noon/ads 半边全 0 而 amazon 半边正确(rev30 6,721 vs 基准 49,560)。排除链:RLS 探针三口径全绿(amazon SO=6,721 生效/noon 日财务 159,998 本地币可见/ads 可见)→ 容器内 core.tenant_conn(1,'') 直调 _kpi_deck 全对(49,560.09/3,012/9,179.89/9,204.83/6,755.64/136/20 与基准分毫不差)→ 绕 Caddy 直连容器内 uvicorn 仍 6,721(排除网关缓存)→ 同容器两进程两结果=进程级状态 → 根因:core.py L148 owner 的 brand_scope 非空=活跃品牌 CSV('onno,zipforce'),而 pg-init/77 DO 块策略 string_to_array(...,'''') 引号转义层数错——渲染成空串分隔符 '' 而非逗号,CSV 永远拆不开→brand=ANY(['onno,zipforce']) 全不匹配→该批表 owner 全灭;orders/fees 因定向清洗引擎(clean_audit.py 逗号模板)在 DO 块之后恰好重建过策略带逗号——半边迷惑形状的由来。pg_get_expr 实锤两表策略分隔符一空一逗。修复=DO 块改 ','' 逗号+全文件幂等重放+非逗号策略清单复核为空;HTTP 七卡即时复真分毫不差。三租户守恒+T1 无 onno 泄漏+noon/ads 可见复验全绿。顺手修(同症状同根):finance_profit_matrix TypeError(finance.py:1221 'str'<'NoneType')——月份 UNION 支柱 max(mon) 空租户/分隔符窗口期返 NULL 进 mons;包裹 SELECT mon FROM (SELECT max(mon)…) x WHERE mon IS NOT NULL 根治(build+up -d api 部署,200 无 TypeError)。dashboard_audit 基准级联二修:费用 5 行 o.{_ABSO} 的 o. 前缀只作用第一子句→AND 后 seller_owner 裸露,orders/fees 两表同列歧义报错(基准 SQL None);改 o.{_AB} AND o.{_SO} 分离前缀(audit_nodes 侧本就是分离写法故通过)。回归门(四道顺序跑):pen ALL PASS|audit_nodes ALL PASS(2,632 节点/18 基准)|frontend_e2e ALL PASS(工作台全状态组合扫 0 异常)|dashboard_audit 192+ 项 FAIL 1=既有 R17(zipforce 08-31 周费用覆盖——SA/AE settlement 到货边界 AE 09-01/SA 09-04 vs 订单 10-07/10-08 结构性滞后 ~4-5 周;fees 行数回填前后均 36,159 无丢失=源头缺口非管道损坏,R15 家族)——零新增红。坑存档:SQL 字符串里写 RLS 策略模板,引号转义层数(DO 块 expr 二次求值)必须用 pg_get_expr 落库复核,肉眼数引号必错;「o.+复合条件」前缀只达第一个子句,复合口径要逐子句前缀。截图自检(双视口+视觉确认):工作台·桌面 1440|工作台·移动 375——KPI 七卡目视复真:营收 $49,560/订单 2,948·件 3,012/佣金 $9,204/FBA $6,755/广告 $9,179/取消 136/无法送达 20,脚注「AMZ+Noon 合计·折USD」,无 6,7xx 半边归零残影、无 NaN/乱码。P-B5 挂账(后续):sync_source 注册表驱动去硬编码(_PIPE_ORDER 等残留特判清理)。orders_tpl=master(v_order_master 型)/fg(订单财务视图型)/onno(unified 双 schema 型),未登记品牌不生成订单分支 fail-safe;orders_view=mars public 订单源视图;consign_schema=代卖账号 schema(seller_owner=源 schema 名=tenant_accounts.account 同源);inventory=共享库存视图名|"fba"(fg 表型)),逻辑写死三型模板+生成规则(pg-init/78 落库 5 行:zf=master/v_order_master/v_inventory_health、fg=fg/…detail/fba(t1+t3)、onno=onno/v_onno_orders_unified/zipforce_amazon/v_inventory_health(t1+t2),UPDATE 1/2/2)。代码改造(api/sync_source.py 10 处):_ORDERS_UNION 拆三模板(master 混表排除子句参数化 dropb——单元素 b.brand='onno' 与原文字面量逐字符一致、多元素 IN、空→false;fg 历史重叠去重 dedup=master 账号表;onno CASE source 打戳 so_zf/so_nn+items 双 schema UNION)+_FEES_FG_BRANCH 参数化(b/so/v)+_FG_INV_TPL 参数化+_inv_health_sql 三参签名(inv_views=共享视图归并/fg_parts=fba 表型分支)+_MONTHLY_FG_TPL/_MONTHLY_AMZ 源 schema 参数化+_AMZADS_BRANCH(b,t)+_refresh_dynamic_specs 末尾 P-B5 生成块(dropship=consign_schema 推导、_PIPE_ORDER 分支序、五域正向生成+noon 月表保留)。结构性特判保留:onno unified CASE 打戳/fg 去重/master fd 分摊/monthly_pl adcte 三型(master=_MV_ASIN_AD/consign=_NO_AD/fg=模板内嵌)——特判是逻辑不是事实,写死在模板里。等价验证三层(/tmp/pb5_dryrun_ct.py 容器内跑,ALL PASS):①初值逐字符等价 7 项(_ORDERS_UNION/_FEES_FG_BRANCH(fg)/_FG_INV/spec×4 与原硬编码逐字符相同——为保逐字符等价删掉了模板内两行 SQL 注释);②生成等价 新旧各自 _refresh_dynamic_specs 后对比:order_fees 4 分支/inventory_health 4 分支/amazon_ads_daily 1 分支/_ORDERS_BODY 逐字符一致,monthly_pl 5 分支集合一致(fg/onno 分支序互换=UNION ALL 无语义预期);③mars EXPLAIN 六项(orders 10d/full/fees/monthly_pl/inventory/ads)全部可解析+对象存在。坑:qsource 用 COPY 包裹不收 EXPLAIN(COPY 只认 SELECT/VALUES/DML/EXECUTE),③改 psycopg2 直连;对比基准初值→生成错位会误报(_MAP_SKU 常量 vs _build_map_sku 动态拼接 P0-2 时代既有不同形),②必须两侧都跑 refresh。RLS 分支定时炸弹二案(部署后门2 13 FAIL 破案,Phase B 挂账清算):部署(build api+up -d)+容器内冒烟(五域 spec 生成 4/5/4/1/4 分支+health ok)后门2 audit_nodes 13 FAIL 全部 API>基准。破案链:RLS 租户1 会话 today 50 行(zf 9+fg 34+onno_amazon 6+空戳 1,saas_admin=owner 不受 RLS 的管理员视角)→ API=16=z f9+onno6+空1 恰=「多出 onno_amazon 自营+空戳」→ pg_get_expr 实锤 cleaned_amazon_orders/order_fees 策略只剩 brand 两分支——Phase B 第四分支(seller_owner)被刷掉(tenant_brands 租户1 onno is_active=t 放行 brand='onno' 行)→ 同款排查 14 张 cleaned_noon_% 表第三分支(brands_source 交集)也全被刷掉(onno noon 广告 75.85/订单/营收混入租户1=剩余 7 条小差异)。根因:Phase B 当日只手动 ALTER 线上策略+改了 clean_audit.py 引擎模板但未 build api 容器——2h 清洗一轮原子换名用旧引擎模板刷回两分支(#26 noon 第三分支同款定时炸弹复发,引擎=策略唯一持久化点)。修复:①手动恢复 2 张 seller_owner 表第四分支+14 张 noon 表第三分支(与引擎模板逐字一致,pg_get_expr 落库复核 14|2);②孤证空戳行 250-4875040-9781420(onno AU Pending,mars 侧 source=onno_schema 正常、生产 SQL 拉取 so='onno_amazon' 正常=历史残留非活体 bug)补戳 raw+cleaned 各 1 行;③P-B5 build 已带全部分支引擎模板——手动触发一轮全量清洗(clean_audit.run 42+ 表原子换名)后 pg_get_expr 复核 14+2 分支全部保留=根治实证。回归门(四道顺序跑):pen ALL PASS|audit_nodes ALL PASS(2,638 节点,13 FAIL→0)|frontend_e2e ALL PASS(全状态组合扫 0 异常)|dashboard_audit 192+ 项 FAIL 1=既有 R17(zipforce 08-31 周费用覆盖,复核缺口 100% 集中 SA 37 单/6+AE 23 单/3=settlement 滞后已知红,保持=设计意图)——零新增红。宪法五步 P-B1~B5 全部闭环:B1 打戳/B2 加列回填/B3 RLS 四分支/B4 审计基准级联/B5 注册表化去硬编码。截图自检(双视口+视觉确认,tools/_shot_1008_pb5_equiv.py):工作台·桌面|财务·桌面|今日·桌面|移动×3 同名 -mobile——工作台 30 天营收卡 $49,560.44 与门2 基准 49,560 精确一致(RLS 修复后),KPI 卡/趋势/图表墙/财务月度汇总全部有数据,无空白卡、无 NaN、无误导性 0。collect(全部采集通道清单=orders/finances/ads[[adapter,hour]错峰档]/noon/noon_full/ads_channel/sales_fba/night/settle 快→慢)、spapi(kind=zf_lwa|fg_json|onno_md 三分派+markets+token_regions)、ads_creds(凭证文件对)、color(品牌色注入前端)、consign_schema(代卖声明,C 类清洗归属泛化)。B 类 api/tasks.py 十处硬编码清单全走 _collect_channel/_collect_plan;C 类 spapi_client/ads_exec/clean_audit 三处注册表化(cfg 键 onno_country_dedup 保留=grep 门断言约束;引擎模板改动 build api+worker 两容器);D 类 /api/listing/meta 增 templates(listing_library 30 条种子)+ /api/tenant/info 增 brand_colors + web 三级回退注入 + listings 页 LEGACY 30 条硬编码常量整体删除。附带修复:sales/night 死档 bug(minute≥d 过滤器配 cron minute=0,4 个 job 自上线从未跑过,mars 水位实锤;改精确匹配+minute=set(range(60)))。AS22 正名:骨传导耳机非按摩仪,种子+线上 UPDATE+前端 LEGACY 常量三处同步。验证:brand_markets 等价比对(基线 JSON 逐字段;顺修旧硬编码笔误 3 处:zf CA/EU marketplace_id 与 onno token_region 序号)+ 新租户 dry-run 24/24 PASS(插 cascadetest 三件套→B 六清单/C 代卖对/D 模板色自动出现→删→备份逐行核对恢复)+ 审计基准级联修复链:①§191 账号轴漏网四基准(R1 KPI seller_owner 514=514 / R2 Noon 镜像 brands_source enabled 口径 2458=2458 / 今日页 host→slug→tenants 账号轴 onno 7=7 / chart_value onno 块 saas_admin 带 BYPASSRLS,SET app.tenant_id 单用不生效须 SET ROLE portal_app,KPI 460vs838 假 FAIL 全转绿);②§89 窗口锚差复发:API 图表窗=北京锚 vs 基准 UTC CURRENT_DATE,北京 00:00-08:00 跨日差一天(每日 cron 06:35 恰在窗内,下午同日即绿——15:27 绿/16:4x 红即此故),差额逐单吻合 zf 27单/$361.17 fg 101单/$2145.83,基准改北京锚;③fg sales_channel 全链空串翻案:mars 源 100% 有值→源视图无该列→_ORDERS_FG_TPL 硬编码 ''(asin_list 源表真无列保持)→模板改标量子查询+build 两容器+ingest_all(full_orders) 全量重灌+定向清洗=cleaned 4494/4494;④skuRev 基准近似→精确(unnest 拆行+窗口计数均摊=API 同口径,旧基准恒偏低 24% 假 FAIL);⑤zf/ads_sku_daily 断 3 天=UTC 02:00 档(北京 10:00)撞 B/C/D 部署窗口,worker 内 detached 补跑+手动同步 10-07 落库;⑥e2e Noon timeout 偶发(重跑+终版双 ALL PASS)。四道门终态(batch=2026-10-08-a1b33816,152 项 FAIL 4 WARN 4 四红全定性):pen ALL PASS|frontend_e2e ALL PASS|dashboard_audit FAIL 1=既有 R17(IL 费用覆盖 08-31 周,SA/AE settlement 滞后立案)|four_layer 四红=onno CSV 断 14 天(R2-bis 需求单挂账)+ads_rule_config RLS(≥10-05 既有)+onno orderCur×2(41 行 AU/SA/AE/US currency='' 源头 mars 采集缺口,raw 三币种列全空,API or "USD" falsy 兜底把 106 伪装 65+41——源头需求单)+R17。日内演化 06:43 FAIL 29→15:27 FAIL 7→FAIL 4→83e6a6cf FAIL 5(跨日锚差+撞档暴露)→终版 FAIL 4 全定性;zf/fg chart_value 两块首次双 FAIL 0(81 图对账)。坑沉淀:docker compose build api 只 build 单服务镜像(worker 须显式 build,否则每周全量 ingest 用旧模板刷回空串);会话退出杀 docker exec 长任务(采集补跑须 docker exec -d 容器内脱离)。截图自检 screenshots/1008-cascade/(listings 模板库五组 24 卡+AS22「骨传导耳机」DOM 断言+/today 回归+mobile 390)。soa_v2/get_combined(API key 直通无需 cookie,请求体 {"statement_date","country_code"})→官方真值与我们的数全面对不上(Sep SA 官方打款 42,386 vs 我 20,979;官方费用含广告 33,329 vs 我 49,998 不含;closing 21,320 vs 我 109,565 差 8.8 万)。根因(用户问「为什么没正确输出」):①对账单官方源停在 7 月未再拉+8/9 月是我从流水推的,而流水本身漏账(9 月 SAR 官方 41,027 只捕到 20,979, 下旬转账窗口滑过);②违背「字段交互逻辑」要求——Opening+Net−Fees−Payouts=Closing 逐月连续这条勾稽式从没作为输出前置门跑过, 跑过必炸。修复:①noon-soa-pull 日采集(API key 零 cookie)——61 行官方 SOA 入库(zipforce 44+onno 17), 逐月余额连续全绿, 与用户页面逐位一致;②数据域健康台账(data-domain-ledger-2026-10-05.md)——17 域×(官方源+勾稽式+状态), 勾稽门当晚即抓两洞: 财务流水漏 payment(🔴)+库龄桶恒等式 19,367/181,942 破(gross>Σ桶 差1~27/行, qc_fail 空, 语义待定性);③规则立: 任何输出前勾稽式必跑绿, 不闭合=报警+PENDING。坑 ①读图纪律(不确定不报数/要数走API);②数据源当前性门(陈旧源不得当答案);③接入要"平台域驱动"非"业务问题驱动"(noon-payments 门户主机从未进端点清单=unknown unknowns)。/inbound/v1/…,实际路径前缀=/fbn/inbound/v1/——此前所有探测打错前缀。10 端点实测(API key 会话直通):POST /shipment/create(400 校验=存在)、POST /shipment/update、GET /shipment/{asn_nr}、GET /shipment/list(200)、GET /catalog/items(200, 含 partner_sku/sku/storage_type/title/image)、POST /shipment/items/update、POST /shipment/items/delete、GET /shipment/items、GET /shipment/slot_availability、POST /shipment/schedule——全部非 404。资产:专用文档站完整 OpenAPI 族(11 文档页抓取, /opt/collection/state/fbn_inbound_paths.json);shipments=[] 首查实证(从未建过 ASN)。已执行(用户令「1,2 都操作」):①工单致谢已发(「Access confirmed working」全文上墙, 截图存档); ②ASN 管道已接入 SaaS——noonops 新增 7 端点(铁律: dry-run 默认+confirm 才真调+audit_log): GET /api/noonops/asn/shipments(live 列表)/asn/eligible-items(60 SKU 实测)/asn/slots?asn_nr=(预约时段); POST /asn/create(枚举 SHIPMENT_TYPE_FBN|FBN_GLOBAL)/asn/items(items/update)/asn/status(SEAL|CANCEL|RESCHEDULE)/asn/schedule(scheduleSlot 对象)——实测: shipments 200 空表(从未建过)/eligible 60/create dry-run 载荷预览 ✓; audit_nodes 快照 152→159 端点已登记复跑 ALL PASS。枚举由校验错误实证: shipment_type= FBN|FBN_GLOBAL, action= SEAL|CANCEL|RESCHEDULE, slot_availability 真路径= /shipment/{asn}/schedule/slot_availability。进销存联动已落地(用户拍板「INBOUNDED 到仓即入库+差异护栏」):①采集器 fbn-inbound-pull(shipment/list+items→{sch}_fbn_asn_shipments/items, 状态变更重拉 items, 已入日调度 02:00; onno 403 未进全球卖家计划=留注册自动兼容); ②asn_ledger_sync 引擎+POST /api/noonops/asn/ledger-sync(dry_run 预览默认/confirm 执行)——INBOUNDED→自动 GRN 入 FBN-{国} 仓(仓自动建), 数量=noon 实收数, 成本=在途/主仓均价→采购成本折本币→0 三级结转, 实收≠发货→同单「验收差异」行, 幂等=ref_no ASN:{nr} 跳过, 全程 inv._ledger 移动均价过账; ③调度任务 asn_ledger(02:40 错峰)日执行。夹具实测: 发货 100/实收 98 → GRN qty=98+diff=-2 ✓(预览后清理)。audit_nodes 快照 159→160 复跑 ALL PASS。坑: uq_zf_ads_skus 是唯一索引非约束(DROP CONSTRAINT 无效须 DROP INDEX); routers 互引须带前缀(09-08 旧坑复发一次即修)。拍板 用户周期令「检查工单+开通即接入」。验证 10 端点逐一探测状态码全记录;eligible items 200 真数据。GET /api/ads/sku-daily?platform=noon|amazon&days=N&country=——SKU×天×campaign 明细直读端点(noon=cleaned_noon_ads_sku_attr 99.8% 归集层, amazon=ads_sku_daily;返回 day/brand/country/sku/campaign/本币 spends 等),实测 noon 180 行/amazon 22 行;audit_nodes 快照 151→152 端点已登记复跑 ALL PASS。四态拆分(用户令「pending/cancelled/undelivered/cir 都要拆开」): sync 的 noon_sku_status 加 pending 列(=item_status IN ('shipped','exported') 在途待交付, 与 cancelled/undeliverable/cir 并列), noon-pnl 的分市场 country_monthly 与 SKU P&L 均输出 pending 字段, Web SKU P&L 表加「Pending 在途」列(分市场表本就有); 实测 2026-09 SA: units 2,306=取消139+未妥投118+CIR176+在途9+有效1,873; dashboard_audit FAIL 0 + audit_nodes ALL PASS。坑: st 字典 4→5 元组须同步改全部解包点(两处 monthly/country_perf 循环)。六态铺满 REST+Web(用户令「加到 rest api 更新到 web 端」): ①kpi-wall 分市场(noon 分市场表数据源)——sku CTE/agg/终选/行构造四级贯通加 pending_units+delivered(件数口径, 原 pending 订单数口径保留), Web 分市场表头加「已送达 Delivered」列(在途列改显件数); ②/api/finance/noon-sku(SKU 年度表现)加 pending+delivered(97 行全带); 坑=agg 的 sk 子查询显式列清单漏 pd/dl 致 UndefinedColumn。实测闭合: kpi-wall SA 2,305=送达1,863+在途9+取消139+未妥投118+CIR176 ✓ / AE 565 ✓; 截图 1005-fenmarket-sixstates.png; 两门复跑绿。六态终版(用户问「是不是还有 shipped delivered 2 个状态」): 状态宇宙实为 6 个(delivered 25,304/cir 2,381/undeliverable 1,693/cancelled 1,216/shipped 96/exported 17)——再加 delivered 已送达 独立列(sync+staging+分市场+SKU P&L+Web 全链), 在途=shipped+exported 合并; 验证六态之和=units 分毫不差: SA 2,306=送达1,864+在途9+取消139+未妥投118+CIR176+其他0; AE 565=471+0+27+24+43; SKU 样例 Airfit Light 605=488+4+36+42+35。截图 1005-skupnl-sixstates.png; 三门全绿。caliber?: ReactNode prop——表上方渲染 ⓘ 可展开口径说明卡(details/summary,📖 口径说明(点击展开)),各页面传 caliber 文案即自动继承;列头货币单位在 Col.head 写(ReactNode 可含 <div className="t2">本币</div>)。财务页试点(用户问的源头):①Noon SKU 表现表(:872,43 列 NOON_SPEC)——金额类列头加「本币」(_MONEY_KEYS 21 列:gmv/commission/delivery_fee/settlement/ad_cost/net_profit 等),caliber=「Noon SKU 表现(mercury finance 深度表口径):金额=本币(SA 行=SAR/AE 行=AED,汇总行折 USD)|毛净=结算净额|净利润=结算净额−广告−采购成本(头程恒 0)|广告读 noon_ads_daily(F2-6 单源 nsku 映射)|有效件=件数−取消−未妥投−CIR|无销售但有广告的 SKU 不显示」;②Noon SKU P&L 表(:1046,18 列 skuCols)——金额列头加「本币」(net_proceeds/commission/delivery/settlement/ad/gross_profit/net_profit 7 列),caliber=「Noon SKU P&L 口径:金额=本币|Gross Net=结算净额|Net Profit=Gross Net−广告−采购成本|Margin%=Net Profit/GMV|Valid Units=Units−Cancelled−Undeliverable−CIR|广告读 noon_ads_daily(nsku 映射)|无销售但有广告的 SKU 不显示|First_Mile=—(未接入)」;原 :1051 独立 details 口径卡删除(统一到 DataTable caliber prop)。全栈推广(持续工程):DataTable caliber prop 已统一(全站 DataTable 自动支持),各页面逐页加 caliber+列头单位——原生 <table>(非 DataTable)需逐页改。拍板 用户 10-03:「1 全栈表格;2 表上方的 ⓘ 可展开说明卡;3 货币单位:列头加(如「营收(SAR)」)」。验证 浏览器真机:财务页口径卡 2 个(两 DataTable)+列头「本币」27 处 ✓、口径卡展开正常(SKU P&L 口径说明);截图 /screenshots/pixel-audit-1003-caliber/finance_caliber_open.png。四道门顺序跑全绿(pen ALL PASS/dash FAIL 0/e2e ALL PASS/nodes ALL PASS,test-reports/caliber_*.log)。坑 ①DataTable 统一 prop 是全栈推广的关键——一处改全站 DataTable 自动继承,避免逐页改 164 表;②金额列识别——Noon 同表多国家行币种不同(SA=SAR/AE=AED),列头只能写「本币」不能写具体币种(行级币种在 country 列);③已有独立 details 口径卡的表(:1051 SKU P&L)——统一到 DataTable caliber prop 删独立卡。进度 DataTable caliber prop 统一+财务页试点落地;全栈推广(各页面逐页加)为持续工程;改前快照 backups/code-2026-10-03c/;档案 memory-longterm §104。追加(10-03 用户报「net/unit 为什么没有货币符号?货币符号左右添加,不要上下添加」):①npu 列(Net/Unit 单件净利)补单位「本币/件」(漏加);②所有「本币」从下方 t2 小字改**同行括号**「(本币)」(用户令「左右添加不要上下添加」)——skuCols 7 列+NOON_COLS 21 列全改,列头「(本币)」27 处+「本币/件」1 处+下方 t2 残留 0;四道门全绿(units_*.log)。data-chart-title={c.title} 存的是图表标题(「每周订单」),事件委托 card.dataset.chartTitle 拿到 title 当 key 用——模态 deduped.find(c => c.key === modalKey) 用 title 找 key 找不到(key 是 nWeeklyOrders),mSpec=null→显示「无数据」。修复:渲染段改 data-chart-key={c.key}(存 key)+事件委托改读 dataset.chartKey——模态按 key 找 spec 正常。根因史:方案 A 统一时我把 data-chart-key(核心图机制)改成 data-chart-title(墙图),但事件委托仍读 title 当 key——title 与 key 不一致(title=「每周订单」中文,key=nWeeklyOrders 英文)暴露。拍板 用户 10-02 报缺陷——按自主修复纪律直接修(功能缺陷非产品语义)。验证 浏览器真机:点第一图(每周订单)模态弹出 GChart 渲染(柱图+月窗过滤器+品牌/国家下拉)✓、控制台零错误;截图 /tmp/modal_err.png(模态完整渲染)。四道门顺序跑全绿(pen ALL PASS/dash FAIL 0·WARN 7/e2e ALL PASS/nodes ALL PASS,test-reports/modalkey_*.log)。坑 data 属性命名与内容必须一致——data-chart-title 存 title 但事件委托当 key 用=title/key 不一致即炸;统一后 data-chart-key 存 key(title 仅显示用)。进度 模态放大恢复;档案 memory-longterm §98。collection_scheduler(每分钟,统一调度器方案 A 数据库驱动——注册表 14 任务分级+触发器自动建任务);②工作台页条目更新——筛选段补「统一时间选择器同时驱动 KPI 卡与图表墙(Noon 金额月对齐+订单日切)」;KPI 卡段改「图表墙内嵌 KPI 已取消(拍板 A)」;图表段补「手动排序+锁(账号级持久化)+点击放大模态(同款过滤器,新 chart 自动继承)」;数据来源补 kpi-cards/chart-order 端点。fullstack-map-2026-09-26.html(全景图):①计数全更新——端点 253→255(chart-order GET/PUT)/定时 27→28(collection_scheduler 宿主 cron)/表 219→220(collection_schedule);②数据层注册表群补 collection_schedule;③附录 A 末尾补 chart-order 两行(序号 254/255);④附录 D 补 collection_scheduler 行(宿主 cron 说明);⑤附录 E 注册表群补 collection_schedule 14 行分级表;⑥tenants 表 t3 fittinggoals→fittingirls 正名(⑯ 遗漏处补齐);⑦footer 补 2026-10-02 更新摘要。拍板 用户 10-02 直令「你更新一下操作手册和saas的全景图」。验证 公开站 curl 实证:手册 collection_scheduler 命中 1(本地=公开站一致)、全景图 collection_schedule 命中 7(一致);两文档双路径(根+/audit/)全 200(Caddy 直接 serve /opt/saas/workspace/zipforce-hub/ 无需 restart)。坑 ①附录 A 端点序号连续(1-253)——插入两行会打乱后续序号,改末尾追加(254/255);②全景图 tenants 表 fittinggoals 旧拼写=⑯ 正名的遗漏处——文档同步时一并修正(文档不是「历史记录不改写」的豁免对象,是活体参考);③Caddy 双路径 serve(根+/audit/)——两路径同文件无需分别改。进度 两文档同步闭环;档案 memory-longterm §95。script-src 'self' 'unsafe-inline' 'unsafe-eval' token 集逐字提升进强制头(保 Next 内联引导+打包库,拦一切远程域脚本)。改后 caddy validate 通过→restart→头已上线;playwright 真浏览器在 /login 动态插入同款 gtm.js?id=GTM-PJB7D937 script src→onerror=BLOCKED(CSP 对动态插入同样生效)——即使注入复发访客浏览器也拒载。frontend_e2e ALL PASS(29 页+像素空白扫描 0 异常=无误伤)+ pen_tests ALL PASS(网关重启后 API 流完好)。快照 backups/code-20261001-csp-enforced/。② 副本判别实验(gtm-imgtest2@3999,判读时 uptime 6h22m>生产注入延迟 4h39m,已过 21:31Z 阈值):4 组触发头+容器内直采全 0 GTM、日志 0 信标、body 7498B=干净基线——同延迟镜像炸弹假说否证,活体注入者定案加固;副本留满 24h(10-02 16:53Z 全闭)。③ 并行会话只读审计(重大翻案):今日活跃 7 个 claude 转录窗口内+全天 tool_use 扫描 0 向量命中(web 容器操作/inspector/USR1/GTM 字样全零);codex 最后 session 停在 09-09(今日零活动);10 个 bash pane 回滚缓冲 2000 行 0 可疑;ssh pane=出站客户端不可改本地进程。两处此前误归因全部纠正为本会话自身动作:(a) 11:22–12:02Z web 源码编辑(orders/noon/page.tsx 8 处)+12:03:52Z web 镜像构建=我的 b2+b3 工作(转录 11:22:14–12:02:32 逐条在案,b2「镜像 7/7」即此);(b) 感染窗口内 /mapping HeadlessChrome 201 请求=我的四道门三轮(b14 门 15:54–16:01/b15 首轮 16:13–16:20/b15 复跑 16:33–16:39,日志 mtime+转录命令双证)——窗口内网关流量归属 100% 清白(我+用户 IP+扫描器)。另:本会话转录 16:26:59Z 的 GTM 字样=compact_boundary 重挂台账附件,非信号。④ pg-init/74:⑬ b13 重造后 permanent 级联全程 saas_admin 直连(auth.py:429-474),全库 grep 无任何 DELETE FROM audit.* 代码路径;运行库实查 portal_app 对两张 cleaned 表仅 SELECT=正确最小权限态(§5 观察项成立)——原案 GRANT DELETE 已无消费者,落盘=新增无人使用的宽权限,结案为过时不落盘,重建库零丢失。拍板 用户「干」批准清单全执行(CSP/会话审计/副本判读/pg-init-74);④ 结果与原案不同(不落盘)系事实变化(b13 消费者已消失)非擅动——台账披露②已改写结案。修复 Caddyfile 强制 CSP 增 script-src(注释同步:2026-10-01 复发后拍板提升);caddy 容器 restart;代码快照;台账披露②结案改写;此前条目/事件报告中两处误归因已标注更正。验证 头部实抓含 script-src;真浏览器注入 GTM=BLOCKED;e2e ALL PASS+pen ALL PASS;副本 4+1 探针全零+0 信标;会话审计三源(转录/scrollback/codex 存档)全零命中。坑 ①误归因教训:把「非本会话」直接当「并行会话」之前必须先拿全部转录逐条对时间线——本轮两处误归因幸而都指向自己(镜像构建者/流量来源均=我),若真有第三方在场就构成冤枉;②转录 grep 命中要先看 type:compact_boundary/system 附件会携带文档关键词伪装成时间线信号;③Caddy 流量归因要以日志 mtime+命令双向互证(b15_gates 首轮 16:13 起跑曾被我记成 16:32)。进度 任务 #41~#44 闭;#40 仅剩副本 24h 全闭(10-02 16:53Z);事件链待办更新:密码轮换降级可选、并行会话无需暂停(证据全清)、web 收窄 expose 仍开放为可选加固。</head> 前插 gtm.js?id=GTM-PJB7D937,仅 accept: text/html 浏览器样态请求触发=反 curl 检测,全页面)。信标时间线破译(docker logs --timestamps grep "Error: x",本容器生命周期共 4 条):16:43:22.390 b2s6cGF0Y2hlZA==→解码 oks:patched(=注入落地时刻,先于监控报警 4 秒);16:43:23.837 oks:updated;17:03:06.9/07.7 oks:updated×2(注入 20 分钟后载荷自更新——活体在管理植入物)。排除链(本轮九项):①镜像对照——同镜像 ID aea17a8e5d2f 长活副本(127.0.0.1:3999)连续干净 3h11m+,但生产容器注入时 uptime 4h39m(12:04 启动→16:43 首个信标),副本须过 21:31Z+/24h 才彻底关闭「镜像时间炸弹」次级假设(09-29 的 41 分钟与今日 4h39m 延迟不一致→支持活体注入者);②web 容器零挂载且 compose read_only 加固(/etc/hosts 不可写);③docker exec 不进 dockerd journal(实测验证)——此前「无 exec 记录」证据作废,docker exec + kill -USR1 1 激活 node inspector(9229) 注入后无痕、事后无监听残留=完全可行的本地向量;④远程 HTTP 向量排除——Caddy JSON 访问日志 15:56-16:43Z:6361 次=网关 172.18.0.1 本机(当时记「我的 b15 四道门 e2e + 监控 + 并行会话 HeadlessChrome 192 次测 /mapping+curl 9 次」——后续审计更正:/mapping 流量三簇全部=我自己的四道门三轮,见 incident-gtm-1001-followup)、487 次=用户 IP 120.244.236.82(Agent Console tmux-scroll 355 次观察并行会话)、扫描器背景噪声 4 IP 各 1-2 次;非 GET=0、≥400=0,无任何攻击形态请求;⑤宿主当前无 nsenter/gdb/ptrace 进程(注入时刻已过不可考);⑥容器内监听仅 3000 + 127.0.0.11 高位端口=Docker 内嵌 DNS(良性),api/db 容器 netns 对照各有同类 dockerd 属主监听定案,无 inspector/C2 残留;⑦compose 无 post_start/entrypoint 钩子(仅 redis command+worker command);⑧宿主 cron 全合法、无外部 SSH 登录(last 全 tmux 本地);⑨16:12Z api 镜像构建=我 b15 部署(容器内 org.py⑮补丁在+四道门日志 16:32-39Z);12:03Z web 镜像=并行会话构建(11:22-12:02 三处 web 编辑,内容查过无注入痕迹)——后续审计更正:该镜像与编辑=我本人的 b2+b3 工作,非并行会话。泄露面评估:web PID1 env 仅 11 个无害变量(HOME/PATH/NODE_ENV 等,无任何机密)——信标即使带走全 env 也无 DB 密钥/API key 可泄;注入仅在 web next-server,api 容器未波及。结论:唯一与全部证据自洽的向量=宿主级活体注入者(本地进程/并行 agent 会话经 docker exec 或 ptrace 打补丁)——后续审计更正:并行会话已全部排除嫌疑(转录/scrollback/codex 三源零命中,两处间接归因皆为我本人动作),候选收窄为无痕手工 shell 级动作;封堵已由 CSP 强制上线承担,镜像时间炸弹为待实验否证的次级假设。拍板 用户三选一拍板「批准重启 web 容器」(restart 曾被 auto mode 分类器拦截→依规停下请示);待拍板(重新提请):①Caddy 层 enforced CSP script-src 'self' 白名单(真正有效的封堵——注入复发时浏览器拒载 GTM,须 Caddyfile 改+容器重启);②并行 agent 会话(tmux 内 claude/codex×3/ssh 数个)是否暂停排查;③09-30 待拍板三件原样有效。处置 20:03:25Z docker restart zipforce-saas-web-1(用户批准)→ 1s 就绪;封堵尝试 /etc/hosts 钉 GTM 域名→失败(只读文件系统+zf 非 root),且复盘定性该法本来就无效:<script src> 由访客浏览器解析拉取,服务端 DNS 封堵拦不住——真正有效=CSP(待拍板)。监控持续:生产复发监控(每分钟,persistent)+ 副本延迟激活判别实验(3999,需过 21:31Z+/24h)。验证 重启后 6 项有效检查全零(5 组触发头组合 accept:text/html / accept-encoding:br / text/html+xhtml / sec-fetch-dest:document / UA-Mozilla + 裸 curl;容器内无 curl 跳过)+ 镜像副本 3999 亦 0;信标/流量/env 三份新证据归档 /opt/backups/incident-gtm-20260930/reinfect-1001/(6 文件+SHA256SUMS:beacon-timeline-and-traffic.txt / web-env-varnames.txt / 感染 HTML 对照 / 容器元数据)。坑 ①docker exec 不进 journal——「无记录」≠「未发生」:不可将日志缺失当排除证据,须先验证检测面本身(本轮实测 0 记录后当场推翻前一结论);②/proc/net/tcp 端口 hex 解析两次踩坑(43083=A84B 非 A82B;busybox awk 无 strtonum 须宿主侧换算);③dockerd 在容器 netns 的 127.0.0.11 高位监听=内嵌 DNS 良性(四容器对照定案,勿再当 C2 误报);④Caddy 日志 ts 是 float 不可字符串切片;⑤关键词扫描 'ping' 命中 'mapping' 型误报(读命中清单要带词界意识)。进度 任务 #40 in_progress(副本判别实验跨 21:31Z+ 出结论 + CSP/会话处置待拍板);本条目与 09-30 事件档案 incident-gtm-2026-09-30 互补(同事件延续);memory-longterm §84。users(tenant_id,email) 唯一约束 → psycopg2 UniqueViolation 裸 500。修前现场实锤(2026-10-01 本轮):POST /api/team/users email=owner@zipforce.***(tenant1 已存在)→ 500 Internal Server Error,容器栈 org.py:105 ... duplicate key value violates unique constraint "users_tenant_id_email_key"。台账表述修正:§4-15 原文「重复邮箱注册 500」易误读为公开 /api/auth/register——W10 实测 register 因 SAAS_REGISTRATION_OPEN=0 只可达 403/422(零副作用);且 register 走新建租户上下文 INSERT,(tenant_id,email) 新组合永不撞(邮箱跨租户复用=多租户设计,register 幂等重发另有 _pending_tenant_for 覆盖);波③ P4 台账 +2 的真现场=team 员工添加路径。对照范本:suppliers 重名 409(W2 实测)/ tenant_brand_add try-except 409「品牌已存在」(auth.py:378)——业务冲突应 409 非 500(服务器错误)。影响面:纯 API 健壮性——前端 team 页错误 toast 直显 detail 文案自动受益;500 事务回滚零残留(现场复跑后 users 行数不变实证)。修法:INSERT 前预查 SELECT 1 FROM users WHERE email=%s → 409「该邮箱已存在」(放席位检查后、brands 查询前,单行便宜检查);为何预查而非 try-except:裸 except 吞错面大;精确 except UniqueViolation 需在 org.py 引 psycopg2 错误类且把「冲突」语义藏进异常路径——预查显式可控、文案可带上下文,与 brand_add 的 INSERT 冲突捕获互补(那里 INSERT 本身就是唯一冲突点)。方案:A(落地)预查 409;B try-except UniqueViolation→409——否决(语义藏异常路径+依赖导入);C 不修——否决:台账已定性健壮性缺陷,4xx/5xx 语义正确性是 P2 方法论错误矩阵的组成。拍板 新节奏授权自动修复(10-01)——健壮性兜底类(409 语义修正,零产品语义变化、零数据改动)直接落地调查 连带破案:b15 四道门 dash 费用覆盖假 FAIL 四层根因链(FAIL 1=[费用覆盖] zipforce 08-24周 36单 88.9%<90%,与 org.py 修复无关的数据面独立事件,按自主修复纪律追查)。①翻日推窗:上海时区 10-01→10-02 翻日,窗口界 (now-35) 推进到 08-28,08-27 的 11 单新入成熟周→32/36=88.9%(08-17 周前同数据 100% 通过=非部署回归的铁证)。②4 缺单:026-4494126-6901150/171-4329555-5689125/408-3889332-9730707(mars 源 settlement 有行 posted 09-03/05)+S02-1941677-9018434(源零行)。③定向同步无效:ingest_all(tables=['order_fees']) 35,785 行 upsert 后仍 32/36——3 单费用行 brand=onno(源 settlement 行 product brand=onno:onno 货经 zipforce 卖家账号在 UK/IT/ES 售)而 amazon_orders 行 brand=zipforce→门 (brand,amazon_order_id) 联接结构性漏配。④系统性量化:窗口内失配 zf→onno 6 单+onno→zf 90 行(EU 八国 FR29/ES20/IT13/NL12/GB10/BE3/SE2/PL1,08-08~09-21 密集)——公共层两表 brand 轴分属不同管道键(orders=订单管道轴/fees=settlement product brand 轴),cleaned 层已做归属校准(audit.cleaned_amazon_orders 3 单全 onno)=设计事实→门读公共层带 brand 联接=审计工具自身缺陷非数据缺陷。新发现 MCF 影子单族(R15 立案):S02 前缀 149 单(2024-08→2026-10 持续新增月均~10)全 sales_channel='Non-Amazon'+FBA+revenue 全 NULL、AE(86)/SA(58)+零星取消——Noon 渠道走亚马逊 MCF 多渠道履约的影子单(营收在 Noon 侧已由 noon 管道采集);源 finances 对 S02 仅 7 行且全 Non-Amazon UK/IT/ES 旧单(AE/SA 零行)=MCF 履约费从未进管道;计入门分母=永久压低覆盖率的慢性假 FAIL 源;材料性低(不影响营收口径,缺的是 Noon 渠道真实履约成本)→按 SaaS 边界移交源头 R15。教训:S02 前缀≠新加坡站——Amazon 新版订单号格式(AE 地区 MCF 用),见单先查 sales_channel 再定性。修复 ⑮ 本体=org.py:101-105 INSERT 前预查 409;连带=dashboard_audit.py:707+ 费用覆盖门两刀:①EXISTS 联接去 f.brand=o.brand(Amazon 订单号全局唯一,order_id 单键联接即安全)②队列加 coalesce(sales_channel,'')<>'Non-Amazon'(MCF 影子单剔除,其费用/营收都在体系外)。验证 ⑮ 5 断言 ALL PASS:D1 重复邮箱 409 文案对齐;D2 零副作用(users 2→2+无审计行);D3 新建 id=458 审计 email/modules/brands 全字段;D4 DELETE 200 复原 2。门终版 SQL 实测:21 成熟周全 99~100%(修前 FAIL 的 08-24 周 35 单 100%——该周唯一未覆盖单恰是 MCF 单,双根因各自贡献的缺口全部闭环)。四道门(test-reports/b15_*.log):pen rc=0 / dash FAIL 0 WARN 7(7=既有维护欠账)/ e2e ALL PASS / nodes ALL PASS。纯 API+审计工具改动无可达视觉变化,免截图(铁律豁免项)。坑 ①双段 SQL 串联一段错=整条 exit 1 无输出,须拆开跑定位;②docker psql 双 -U 无 -d → FATAL database "saas_admin" does not exist;③mars-db MCP LIKE '%…' 占位符报错复现(用 ~ 正则);④成熟窗口随上海日翻自动推进(界=now-35)——门 FAIL 可能隔夜自现/自消,定性先算窗口界再谈回归。进度 台账 §4-⑮ 划线(11→10 项);§5 新增双观察(双轴联接铁律/MCF 族);R15 入采集断流清单;memory §83。下一项=⑯ 重复 he 牌名暴露族(=产品决策需停)。_validate 对 chart_type 做 not in ("line","bar","stack","pie","table") → 400——缺失也拦(None not in 五值)。POST /api/reports/query 渲染态遇 400 走优雅降级(:254-261 返回空 rows+note「该图表暂不可计算: 图型: line/bar/stack/pie/table」);create_def 建档(:397 _validate(body.get("config") or body))缺 chart_type 直接 400。定性=过度校验:chart_type 是纯透传渲染字段——_validate 校验后只返回 (domain, dims, mets),chart_type 完全不参与 SQL 构造与行计算;查询语义只需要 domain/dims/metrics/filters,一个渲染形态字段挡住数据查询违反最小校验原则。影响面实测:前端正常路径零影响(CustomModules.tsx :242 建档 config 总带 chart_type;:89 查询透传 def config)——受影响者=API 直调者/历史损坏 def/未来新消费方,纯健壮性。前端潜在次生:若本地 cfg.chart_type=undefined 到 :92 cfg.chart_type==="table"?"bar":cfg.chart_type 会得 undefined chartKind(当前被 API 400 降级挡在渲染前,修复后 API 兜底 table、前端走 :179 表格分支反而更安全)。修法(query 渲染态一行兜底,建档不动):report_query 读 body 后 cfg.setdefault("chart_type", "table") 再 _validate——缺省 table 理由=无图渲染假设的朴素形态(行数据完整呈现,line/bar 需序列结构假设);非法值照拦(setdefault 只补缺失,"xxx" 仍 400 降级);create_def 路径零改动(def 完整性=建档契约,缺图型的 def 不该入库)。方案:A(落地)query 兜底 table;B _validate 缺省 table 全局——否决:建档会存进无图型的 def(config 里没有 chart_type 字段),前端 :92 读 undefined 回到原问题;C 不修——否决:台账 §4-⑭ 已定性健壮性缺陷,一行兜底零风险。拍板 新节奏授权自动修复(10-01)——健壮性兜底类(纯 API 行为放宽,不改产品语义/不删数据)直接落地修复(reports.py 1 处) report_query 读 body 后 if "chart_type" not in cfg: cfg["chart_type"] = "table" 前置于 _validate(含 ⑭ 缺省理由注释);create_def 零改动;已 build+up 部署验证 4 断言 ALL PASS(C1 缺 chart_type 查询→200 真数据行(2026-07 起订单序列,修前=误导性「暂不可计算」note)· C2 显式合法 line→200 同数据无回归 · C3 create_def 缺 chart_type→400 严格保留「图型: line/bar/stack/pie/table」· C4 显式非法 scatter→200+优雅降级 note(非法值照拦走 2026-09-25 既有降级设计))+ 四道门顺序跑全绿(pen ALL PASS / dash FAIL 0·WARN 7 既有 / e2e ALL PASS / nodes ALL PASS,test-reports/b14_*.log)——纯 API 无 web 改动免截图快照 backups/code-20261001-b14-charttype-default/reports.py(修前版,cp 先于改动)坑 api 容器重建后旧会话 jar 出现「not authenticated」(redis 会话在但 8h TTL 内复登最稳)——断言前先重登进度 P4 待拍板清单 12→11(⑭闭);任务 #37;档案 memory-longterm §82租户1={fittingirls,onno,zipforce} · 租户2={brainnews,onno} · 租户3={fittingirls}——onno 与 fittingirls 各被 2 租户引用;业务表(94 张 brand 键)无 tenant_id 列,RLS=brand IN (本租户 tenant_brands 活跃集)——现 permanent 的 DELETE FROM sales_daily WHERE brand=%s 在删共享品牌时把其他租户的同名品牌数据一并删光(租户1 删 onno→租户2 的 onno 数据全没了;「至少保留一个」挡不住:租户1 有 3 品牌可合法通过)——跨租户数据炸弹真实可达,比 88 表残留更严重的缺陷本体。brands_source 实为逐租户行(fg/onno 双租户行并存,与 tenant_brands 引用镜像一致)。最优解=三段式引用计数级联:①动态表枚举——information_schema 实时列 brand 列基表 - 8 张白名单(清单永不腐化,新表自动纳入);②引用计数保护——其他租户仍引用(含已停用行=可恢复引用)→ 只解除本租户 tenant_brands/user_brands 引用 + 审计「数据保留」;本租户是最后引用者才物理删除全量数据;③管道停采联动——最后引用者删除时 brands_source 该品牌 enabled=false 消除复活(此时无其他租户引用=不构成跨租户操作);④审计与级联同事务 + 逐表删除行数。级联走 saas_admin 直连(mcp.py _r 同款先例:跨租户引用计数必须全局视角而 tenant_brands 有 RLS;saas_admin=superuser+bypassrls 实证)。拍板 用户拍板彻底路线(「我就是想彻底的解决」)+ 核心逻辑定稿(原话):「最高权限是租户,租户之间完全隔离,数据之间不可以跨租户操作,这是绝对的核心逻辑。每个租户可以自己添加删减平台,项目,国家等操作。但是跨租户的操作绝对禁止」——引用计数设计即该逻辑的代码化;停采在最后引用者场景自动触发(其他租户已无引用,无人受影响)修复(auth.py permanent 分支重写 + 白名单常量) 模块级 BRAND_EXCLUDE_TABLES(8 表);保护检查租户 scoped + 404 前置(㊵/P2-W8 修复语义保留);引用计数/级联/审计走 saas_admin 直连单事务(审计 INSERT 与级联同 commit=破坏性操作留痕不可被可用性取舍吞掉);共享→unlinked 路径只删本租户 tenant_brands/user_brands 行;最后引用者→停管道+86 表动态级联+引用行清理;archive 分支零改动;已 build+up 部署验证 11 断言 ALL PASS(临时品牌 zz-audit-b13 双租户引用+3 表测试行双场景:A 共享 租户1 删→mode=unlinked·shared_with_tenants=[2]·租户2 引用在·三表数据 1|1|1 完好(跨租户误删根除实证)·管道不停(enabled×2)·unlink 审计行;B 最后引用者 租户2 删→mode=permanent·tables_touched=3·86 级联表 DO 块逐一计数 residue=0·brands_source 双行已停采·引用表 0 行·公共白名单表 0 行·级联审计带逐表行数 'cleaned_sales_daily=1 products=1 sales_daily=1';404 对称 不存在品牌 404 不落审计)+ 四道门顺序跑全绿(pen ALL PASS / dash FAIL 0·WARN 7 既有 / e2e ALL PASS / nodes ALL PASS,test-reports/b13_*.log)——纯 API 无 web 改动免截图;测试 brands_source 行已清、audit_log 留 2 行真实测试痕快照 backups/code-20261001-b13-permanent-cascade/auth.py(修前版,cp 先于改动)坑 ①psql DO 块 RAISE NOTICE 走 stderr——2>/dev/null 会吞掉断言结果(首跑 B1 空就是它);②import psycopg2.pool 已绑定 psycopg2 名,psycopg2.connect 可直用;③psycopg2 连接的 with 只管事务不关连接,须 finally close;④会话按子域名路由({slug}.zipforcehub.com + --resolve 127.0.0.1),旧 jar 全 404「unknown tenant」须全新登录进度 P4 待拍板清单 13→12(⑬闭);任务 #38;档案 memory-longterm §80audit(t, uid, "pm.import", "N产品/M任务(全量替换)") ✓(:324,含 DELETE 全量替换披露)。跨模块对照:neg_keywords CRUD 全有 _audit(⑩)/ads decision+run 刚补(⑪)/verdicts.decision 有 _audit+结构化表——PM 是全平台唯一「仅 1/8 写端点有审计」的模块;甘特图任务是多人协作资产(owner=Patrick/Susan),「谁删了产品/谁拆了链/谁改了任务期」在任务 history 字段只记日期变更(:233-235 只有 fs/fe/ts/te 无操作人),audit_log 全空白。修法(7 处对齐族内既定风格 _audit(cur,...),同事务原子):create/update/delete products 三处带 pid+name(:404 检查后落=404 不留痕对称);tasks create/update/delete 三处带 tid+title/status+日期窗;chain 带 pid+串链/拆链+任务数;全用 INSERT/RETURNING 上下文的确定值。方案:A(落地)7 处补 _audit 同事务;B 只给破坏性端点(delete/chain/import)补——否决:审计粒度模块内应一致,且 update 改期/改 owner 同样是协作追溯刚需;C 结构化新表——否决:pm_tasks.history 已承载变更明细(日期链),audit_log 行定位主体足够,同 ⑪ 理由。不扩大面:import 端点既有 audit 不动(含独立连接形态——它自带先落痕语义);读端点免审;前端零改动。拍板 新节奏授权自动修复(10-01)——纯审计补齐(audit_log 加行,不改产品语义/不删数据)直接落地修复(projects.py 7 处 + import 行补 _audit 符号) products create/update/delete · tasks create/update/delete · chain 各补 _audit(cur, t["id"], uid, "pm.*", ...)(全部 with 块内同事务原子,404 分支先挡不留痕);import 既有 audit 行零改动;已 build+up 部署验证 11 断言 实质 ALL PASS(create 审计行含 pid+name+tasks=6 · update 含改名后名 · task create/update 审计行含状态+日期窗 · task delete · chain 审计行「串链 n=6」与实际任务数一致(断言预期值首算错:P6 已删 1 任务→6 任务 5 边,审计值=真实值) · product delete 审计行+任务级联清 0 · 404 不落审计(对称) · 库回基线 8=8 测试产品全清)+ 四道门顺序跑全绿(pen ALL PASS / dash FAIL 0·WARN 7 既有 / e2e ALL PASS / nodes ALL PASS,test-reports/b12_*.log)——纯 API 无 web 改动免截图快照 backups/code-20261001-b12-pm-audit/projects.py(修前版 0 处 _audit 确认)坑 断言期望值要与前置步骤联动推演(P6 删任务后 chain n=7 预期失效——审计代码写的是真实 len(ids) 恰为正确行为);q() 辅助改用 SET app.tenant_id='1'(无回显,根治 ⑪ 的 '1' 滤杀坑)进度 P4 待拍板清单 14→13(⑫闭);任务 #35;档案 memory-longterm §79_audit ✓(⑩ 刚修同源);②rule-config save/delete ×2——_audit ✓(:1132/:1148);③decision :959-986——无 _audit ✗ 缺口 1;④run :1094-1100——无 _audit ✗ 缺口 2;⑤execute :1160——专用 ads_decision_audit 结构化事件表(EXECUTION_STARTED 先落库再外护+幂等重放表,:1277)✓ 形态不同留痕充分。跨域对照范本:sourcing verdicts.decision :440-468 = _audit("verdicts.decision", f"cand=... {row[0]}->{row[1]}") + sourcing_decision_audit 双留痕——同为「人工决策」语义,ads 侧 decision 无任何 audit_log 行=跨域分叉。decision 缺口量化:UPDATE 落 status/user_note/modified_action/decided_at 于建议行(:969-972),negative_keyword 类还同步写否词库(origin='accepted' 带 created_by=uid ✓);但行上无决策人 uid(UPDATE 不写 user 字段)且 audit_log 无行——「谁在何时决策了哪条建议」只留 user_note 自由文本,无主体可查;租户1 实测 accepted 仅 1 行、expired 1,831 行、pending 1,843 行(2026-10-01 当日轮)。run 缺口量化:owner/admin 手动触发一轮 V4.0 规则引擎(run_ads_rules :172-229 跨全品牌:UPDATE 7 天过期 pending→expired + DELETE 当轮未命中 + INSERT 新建议),全链只留容器 log.info(瞬态滚动);cron 05:40 UTC 自动轮无人工主体可不审计,手动触发必须记谁触发——「平台不代执行」的人工触发动作零留痕,与 execute 端点「审计先落库再外呼」的重留痕设计形成鲜明反差。修法(最小一致修,对齐范本):decision 在同事务 with 块内 404 检查后加 _audit(cur, t["id"], uid, "ads.recommendations.decision", f"rid={rid} {row[2]}:{row[6]} {body.status}")(rule/target_key 全用 RETURNING 的 DB 值——⑩ 同源教训;404 不落审计与 permanent 对称性修复同型);run 在引擎返回后开租户连接 _audit(..., "ads.recommendations.run", f"total={res['total']} brands={len(res['by_brand'])}")(引擎自身 _admin_conn 无租户上下文,审计独立连接事后写不嵌套事务;引擎异常则不落「成功触发」行=如实)。方案:A(落地)补 audit_log 行×2;B 新建结构化决策审计表——否决:verdicts 的 sourcing_decision_audit 是因需存 evidence/note 全文,ads 决策行本身已有 user_note/modified_action 字段承载全文,audit_log 行足够;C 不修——否决:台账 §4-⑪ 原文即定性缺陷,人工决策+人工触发是审计刚需场景。不扩大面:decided_at/user_note 行上留痕机制不动(双轨冗余无必要);execute 的 ads_decision_audit 形态不动;run 引擎内部逻辑零改动。拍板 新节奏授权自动修复(10-01)——纯审计补齐(audit_log 加行,不改产品语义/不删数据)直接落地修复(ads.py 2 处) ①decision 同事务 404 后补 _audit("ads.recommendations.decision", "rid={rid} {rule}:{target_key} {status}")(同事务原子:审计与决策同 commit 同回滚);②run 引擎跑完后租户连接补 _audit("ads.recommendations.run", "total=N brands=M");已 build+up 部署验证 10 断言 实质 ALL PASS(基线 0 → decision accepted 200 · 审计行 resource='rid=11173 price_suggestion:ZF565T0EUY accepted'(rule:target=DB 值)· 行上 decided_at 机制不动 · decision 404 不落审计(对称性)· run 200 total=325/by_brand 3 品牌 · run 审计行 'total=325 brands=3' 与返回体逐字段相等 · run 审计行 user_id=1 主体可查(直查实锤)· 测试行 run 后仍在=引擎幂等不动终态行)+ 四道门顺序跑全绿(pen ALL PASS / dash FAIL 0·WARN 7 既有 / e2e ALL PASS / nodes ALL PASS,test-reports/b11_*.log)——纯 API 无 web 改动免截图快照 backups/code-20261001-b11-decision-run-audit/ads.py(修前版,cp 先于改动)坑 ①set_config 滤法坑变种:q() 辅助过滤 l.strip()!='1' 会把真实值恰为 '1' 的行(uid=1、count=1)误杀——两处假 FAIL 直查全对;根治=用无回显的 SET app.tenant_id 替代 SELECT set_config;②ads_recommendations 有 RLS WITH CHECK:saas_admin 直连改 status→pending 被 policy 挡(Failing row contains...)——该表写路径设计上只走 API(portal 连接+租户上下文),测试残留决策行 11173(note='b11 test')保留为真实决策态(终态行下轮 cron 不动,幂等语义印证)进度 P4 待拍板清单 15→14(⑪闭);任务 #34;档案 memory-longterm §78ads_neg_keyword_add INSERT 落库用 body.keyword.strip()(:1046,brand/country/note 同样 strip ✓),但审计明细 _audit(..., f"{body.keyword[:100]} cc=...") 用原文——用户提交带首尾空白的词(" foo ")时 DB 存 "foo"、审计行记 " foo ",审计与落库不一致(审计明细是运营对账/否词回溯依据,空白差异污染检索与比对)。neg_keywords 全写路径族排查(4 处):①add :1046 strip 落库 ✓ / :1049 audit 原文 ✗(缺陷本体,唯一);②patch :1076 audit 只带 id+status 无 keyword ✓;③delete :1089 audit 用 row[0][:100]=DELETE RETURNING 的 DB 已存值 ✓;④decision→否词库 :978-985 keyword 来自 row[6](ads_recommendations.target_key DB 值非用户输入)✓。影响面:仅手动添加路径(origin='manual')的审计明细显示层;不涉及引擎 done_neg 判重(判重走 neg_keywords 表值=已 strip ✓)、不涉及否词生效语义。修法::1049 body.keyword[:100] → body.keyword.strip()[:100](先 strip 再截断=与 DB 值前 100 字符严格一致;一行修,无方案分叉)。拍板 新节奏授权自动修复(10-01)——简单/明确类(审计与落库同源一致性,无产品语义分叉)直接落地修复(ads.py :1048-1050) _audit 明细改 f"{body.keyword.strip()[:100]} cc={body.country.strip().upper() or '-'}"(keyword 与 country 均与 :1046 落库值同源:strip 后再截断);已 build+up 部署;其余 3 写路径零改动验证 6 断言 ALL PASS(提交带首尾双空白词 → 添加 200+id · A2 DB 值=strip「b10 strip test word」 · A3 修复核心:审计明细 resource='b10 strip test word cc=US' 无空白 · A4 全史 0 条含空白审计行 · DELETE 清理 200 · 库中已清)+ 四道门顺序跑全绿(pen ALL PASS / dash FAIL 0·WARN 7 既有 / e2e ALL PASS / nodes ALL PASS,test-reports/b10_*.log)——纯 API 无 web 改动免截图快照 backups/code-20261001-b10-neg-audit-strip/ads.py(修前版:首跑误存修后版,已按 git 源 sed 反还原一行复原)坑 ①audit_log 明细列名是 resource 非 detail(core.py:203 `INSERT INTO audit_log(tenant_id,user_id,action,resource)`)——首版验证脚本按直觉查 detail 列 SQL 报错被误读成「审计未落」;②SELECT set_config('app.tenant_id','1',true) 在 psql -At -c 多语句里返回行 '1' 会污染 stdout(断言值变 '1\n真实值')——辅助查询须过滤该行或改用无返回的 SET app.tenant_id;③快照纪律:mkdir+cp 必须先 cp 再改文件,顺序颠倒会存进修后版进度 P4 待拍板清单 16→15(⑩闭);任务 #33;档案 memory-longterm §77stripe-signature 头解析 t/v1(:126-131)、hmac(ts.+payload) SHA256 + hmac.compare_digest 常时比较(:132-134)、时间戳 300s 容差 + ValueError 非法拦截(:137-140)、事件两分支(subscription.deleted/updated→plan 回 trial 排除内部租户 :143-164;checkout.session.completed→升档 slug/plan 白名单+内部租户排除 :165-189)。缺口性质=纯测试覆盖:生产 stripe_webhook_secret 文件 0 字节 → STRIPE_WHSEC="" → 端点恒 503「webhook 未配置」(:122-123),验签/容差/分支全部不可达无测试(台账 §4-⑨ 原文「WHSEC 未配置不可达,配 WHSEC 后须补测」)。方案:A(落地)容器内独立进程 + STRIPE_WEBHOOK_SECRET 环境变量 + import 时模块常量生效 + TestClient 进程内调端点——零重启、零生产 env 改动(主进程 WHSEC 仍空=生产端点仍 503 正确)、副作用全 no-op 设计(slug=不存在租户/cust=不存在 customer → 分支逻辑执行到 DB 查询无匹配零写入);B 临时改 compose env 重启生产容器两次——否决:两次秒级中断换纯测试不值;C 离线函数级单测——否决:端点强依赖 Request body/header,mock 迁就测试过度。同测边界(checkout 正式计费分支):checkout.session.completed 的 webhook 处理分支在本矩阵覆盖;checkout 创建端点(:100-117 调 Stripe API)依赖 stripe_secret_key(生产同样 0 字节空)=真外部依赖,留待配置后按同法补测。已知边界(非缺陷注明):同签名重放(同 ts 同 sig 在 300s 窗口内重发)会 double-处理——plan UPDATE 同值幂等 + billing_events 如实插两行(Stripe 官方 at-least-once 投递语义下审计行反映真实投递次数,可接受不改)。拍板 新节奏授权自动修复(10-01)——本项为测试覆盖补齐(零生产代码改动、零重启、副作用全 no-op)直接落地;WHSEC 真实配置后仅需补 Stripe→平台端到端链路(验签/分支逻辑已全测)验证(无生产改动) 15 断言 ALL PASS:生产态 503 未配置 ✓ · 无签名/坏签名 400 · 时间戳超容差(-400s)/非法 400 · completed+不存在 slug no-op 200 · 内部租户 zipforce 排除 no-op · 非白名单 plan no-op · subscription.deleted+不存在 cust no-op · 未知事件 200 · 窗口内重放 200 幂等(plan 同值+billing_events 如实两行属 at-least-once 语义)· billing_events 零测试写入+无幽灵租户+内部租户 plan 未触碰+生产容器 env 零残留;脚本 /tmp/_b9_whsec_test.py(子进程注入法);四道门顺序跑全绿(b9_*.log,零改动一致性确认)快照 无(零生产改动)坑 starlette TestClient 不进 with 不触发 lifespan(适合纯端点测试);docker exec -e 注入只影响 exec 子进程,主进程 env 不变——进程级激活正因此可行进度 P4 待拍板清单 17→16(⑨闭);任务 #32;档案 memory-longterm §76_ai_quota(t)(:437 扣额) → products SKU 查询(:439) → if not p: raise 404(:447)——SKU 不存在时 404 返回但配额已扣(_ai_quota :236 incr 先行,starter 50 次/租户/天)。影响:用户敲错 SKU 重试每次白扣 1 次 AI 额度,零 LLM 服务获得;配额尽前奏——错 N 次=真实可用额度少 N 次。_ai_quota 全 7 调用点同型排查(顺序审计):①:410 insight——门后纯数据组装(_fmt_* 数据空也组装,无 4xx 前置失败路径)✓;②:437 adcopy——缺陷本体(唯一 404 在门后);③:537 sourcing(term)——_fmt_term_landscape 数据组装(:535)在门(:537)前,term 无数据返回空 ctx 字符串无 raise ✓;④:551 sourcing(无参旧模式)——has_ai 400 检查(:549-550)在门前 ✓;⑤:819 agent——provider 503(:817)+Keepa 配额 429(:820-822)两道便宜检查都在门前=「校验先行、扣额最后」范本 ✓;⑥:889 ads-optimize——门后 _fmt_campaigns 无活动=空表也调 LLM(提示词含「无活动直说」)✓;⑦:1047 page-chat——page 分支 else 兜底(未知 page→sourcing ctx)无 404 路径 ✓。修复模式对齐:adcopy 改为 ⑤ 同款序=SKU 查询 → 404(不扣)→ _ai_quota(超限 429,不烧 LLM)→ llm_chat。语义注意::459 aiusage hincrby(真实使用统计)只在成功路径已与 quota 扣费分离,本修不动;扣额仍先于 llm_chat(LLM 调用失败白扣 1 次的边界保持既有行为——与 keepa 门「计数先于拉取」一致,超时不回滚,不扩大修改面)。方案:A(落地)门下移一行区段(404 后、market 拼装前);B 404 时回滚配额(decr)——否决:补偿式修法掩盖顺序缺陷+decr 与 429 抢占窗口竞态;C 门内先查 SKU 再 incr——否决:门函数掺业务查询职责不清,与其余 6 处门形态分叉。拍板 新节奏授权自动修复(10-01)——简单/明确类(门顺序对齐既有范本 :819,无新语义)直接落地修复(ai.py adcopy 1 处) _ai_quota(t) 从 SKU 查询前移到 raise 404 之后(新序=SKU 查询→404 不扣→门 429 不烧 LLM→llm_chat);其余 6 处门+aiusage 统计零改动验证 9 断言 ALL PASS(404 不扣:键未创建 · 门新位触发:灌满 50→429+incr 51+usage 119 不变=未烧 LLM · 放行路径:zipforce 品牌 SKU 200+answer 2959 字符+配额 0→1+usage 119→120 真烧 1 次如实 · redis 键复原)+ 四道门顺序跑全绿(pen ALL PASS / dash FAIL 0·WARN 7 / e2e ALL PASS / nodes ALL PASS,test-reports/b8_*.log)——纯 API 无 web 改动免截图快照 backups/code-20261001-b8-adcopy-quota/ai.py坑 zf 会话 brand_scope 无 fg——products 里 fg 品牌 SKU(AUB*)对 zf API 是 404(四维隔离正确行为,验证须用本品牌 SKU:zipforce=ON* 前缀);aiusage 是 hash(hget slug 非 get)进度 P4 待拍板清单 18→17(⑧闭);任务 #31;档案 memory-longterm §75_keepa_quota(t) 按 keepaq:{tenant_slug}:{date} Redis 日计数,超 PLAN_KEEPA_QUOTA[plan](starter 50/天)raise 429「今日选品搜索额度已用完」;watchlist 端点 :557 响应 quota_left 同键同口径。全景调用点矩阵(api 目录全扫,2026-10-01)——Keepa 客户端拉取调用共 8 组:①search :73-79(search+30 ASIN 补拉)有门 :71;②keepa-history :123 有门 :121;③enrich :498(enriched 批量)有门 :496;④watch :586(keepa_product 1 ASIN = 1 token/次)无门 ✗ 缺口 1;⑤watch/alert :1063(stats=90+history)有门 :1061;⑥price-history live :682(keepa_history 1 token 24h 缓存)有门 :680;⑦explorer :1189(keepa_product_full ≤50 ASIN/批 = 最多 50 token/次)无门 ✗ 缺口 2;⑧explore :1775-1780(search+product)有门 :1774。排除项:tasks.py :198/:261 = 后台定时 worker(_admin_conn() 全租户扫 watch 池每日刷新+ABA 排名,无租户请求上下文不可设门,量由 KEEPA_WATCH_LIMIT 池上限天然有界=设计正确);ai.py :24 = 死 import(无调用点)。缺口量化与风险:watch = 用户每加 1 关注烧 1 token 不计数(台账实测 keepaq 增量 0);explorer = 每次调用若 Top3 ASIN 有 Keepa 档案缺失则同步补拉一批 ≤50 ASIN——重放可烧全局 token 池(:1183-1184 tokens_left>=200 只是全局余额下限守卫,非租户级门;全局余额耗尽影响的是全部租户的 Keepa 功能,非单租户自己)。既有语义锚(方案设计依据):_keepa_quota 按次计(search 一次 search+30 ASIN 补拉也只计 1,粒度=「拉取动作」非「ASIN 数」);watch 端点「关注成功」是主语义(:594-595 拉取失败 pass 不影响关注入库,worker 每日刷新兜底);explorer「补拉失败不阻塞」(:1202 KeepaError pass,ABA timeline 主功能零 token 走库内)。三方案:A(落地)消耗才计+超限不拉不阻塞——两处均在真实拉取动作前 try: _keepa_quota(t) except HTTPException: 跳过拉取:watch 超限→关注照常入库+pulled=False(与拉取失败同表现,quota_left 可查,worker 次日兜底);explorer 超限→跳过补拉(missing ASIN 下次再补,:1203 既有注释语义),ABA timeline 正常渲染;配额内→计数+1 后拉取(计数先于拉取与既有 5 处一致,KeepaError 不回滚计数=既有行为)。B 端点开头无条件 raise 429——否决:watch 会「关注已入库却报 429」脏体验(INSERT :576 先于拉取)且误伤「只加关注不拉取」合理诉求;explorer 零消耗浏览(missing=0)也扣额+超限时 ABA 主功能整体 429 误伤。C watch 拉取失败静默不计数+explorer 补拉移后台——否决:watch 静默=烧 token 时不计数缺口依旧;explorer 移后台=改产品行为(当下同步补拉让用户立刻看到档案)超出补门范围。拍板 新节奏授权自动修复(10-01)——本项属简单/明确类(既有 5 处门的一致性补齐,方案 A 遵循两条既有设计锚不引入新语义)直接落地修复(sourcing.py 2 处) ①watch :584 拉取前置 try: _keepa_quota(t) except HTTPException: pass else: 原拉取块(两层结构必要:HTTPException 是 Exception 子类,单层 except Exception 会吞掉 429 继续拉取);②explorer :1181 补拉分支前置同款 try/except,超限 missing=[] 跳过补拉(原 if missing and keepa_key() 连排复判,逻辑与原版严格等价);worker/ai.py/其余 5 处门零改动验证 12 断言 ALL PASS(超限态:watch 200+id 返回+pulled=False 关注主语义保持+门计数 50→51 触发证据+lastleft 不变=token 未烧;配额内:keepaq 增量 0→1=台账缺陷「实测增量 0」直接反转+真实拉取 pulled=True 烧 1 token 如实记录;explorer 超限 200+timeline 6 期正常+门计数触发 51;redis 真实配额键复原 25)+ 四道门顺序跑全绿(pen ALL PASS / dash FAIL 0·WARN 7 / e2e ALL PASS / nodes ALL PASS,test-reports/b7_*.log)——纯 API 修复无 web 改动免截图,quota_left 字段/429 文案/其余 5 门行为断言级不变快照 backups/code-20261001-b7-keepa-quota/sourcing.py坑 WatchIn asin pattern ^[A-Z0-9]{10}$ 严格 10 位(B0PENTEST01 是 11 位 422,测试 ASIN 用 B0TEST0001);验证脚本须记录 redis 原值再复原(首跑 422 崩溃把真实计数 25 污染成 50,已手动复原);后台门命令 cd saas 后相对路径 test-reports/ 不存在(该目录在站根)——tee/cp 用绝对路径进度 P4 待拍板清单 19→18(⑦闭);任务 #30;档案 memory-longterm §74net_usd/revenue_usd 原样透传;误导源头=同步层把未回款单 net_usd 写 0 占位(清洗引擎 audit_db_clean.py 只兜底 revenue_usd 折算、net_usd 原样,public→cleaned 双层一致)。实测矩阵(RLS 租户3,2026-10-01):fg 待回款 2,952 单(Shipped/Pending 无 has_finance)——net_usd 全 0(null=0/zero=2952/pos=0;zf 同型 1,126 单全 0;onno 对照 179 单全 NULL→渲染「—」,跨品牌渲染分叉实锤);revenue_usd:public 层 NULL 902 → 清洗折算后 NULL 162 + 0 值 740(local_amount=0 折算产物=源头订单金额缺失,非真实 0 营收)+ 有值 2,050;首屏切片(ORDER BY days_waiting DESC)前 20 行=11 NULL + 9 个 0.0,零行有真值(fg max_wait=490 天最老卡单置顶,09-30 fork 视觉报告「明细全 $0.00 vs KPI $47,103」的切片来源);commission_usd 两品牌全 0 但 settlement 页无渲染列(仅类型定义)不修;KPI $47,330.26=sum(revenue) 真值无缺陷(NULL/0 不影响 sum)。已结算对照(has_finance=true 34,283 单):net 有值 33,685(98.3%)/zero 48/null 550——真值区。语义:未回款单净额尚未由结算生成,0 是同步层占位非真值(fg Pending 卡单 R2/R10 族源头);「数据缺失可视化兜底不显示误导性 0」铁律第三刀(B2 orders statusRev / ③-B charts rev_missing 同族)。可达性:fg 租户 /settlement pending tab 2,952 行净额列恒 $0.00、abnormal tab(2,435 单)首屏营收+净额双缺失;zf 1,126 单同型;onno 已正确(「—」)。方案:A(落地)API 层 items 后处理——has_finance=false 行 revenue/net 值 0→None,前端 usd(None) 既有「—」渲染零前端改动;数据层不动(public/cleaned 不改,orders 页等其他消费方零影响);settled tab 真值区 48 个 $0.00 不动;KPI/排序不动(days_waiting DESC=最久等待优先催款语义正确,首屏「—」如实呈现最老卡单状态)。B 数据层 net=0 改 NULL——否决:动数据波及全链路消费方且 0 无法与潜在真 0 区分;C 前端 0→「—」——否决:API 语义仍错、未来消费方继承误导。现象 b(「finance SETTLEMENT 明细 0 vs 卡片 $200」)定性=不可复原观察/同名双口径并列,非数据缺陷:fork 原报告未存档(09-30 视觉 fork 11 项裁定「观察 3」之一);穷尽复现——存档 3 截图(finance-d=zf 2026-09 Amazon 视图已结算 57 计数正常无 $200;finance-m=全史累计;settlement-d=onno 视图净额「—」)+ 程序化扫描 3 品牌×7 月 kpi-wall Amazon 块 + 9 组合 noon 块均无「卡片≈$200 vs SETTLEMENT 0」精确命中;最接近结构性事实=「已结算 Settlement」明细列(settled_orders 计数口径)与「结算/净额」卡(settlement 应计金额口径)同名双口径并列——当月切片结算滞后时计数 0/小而金额正常(zf 2026-10 实证 settled_orders=0 + settlement=$52.05 并存;onno 2026-07 settled=1/$33.02),09-30 fork 看当月时 zf settled_orders 为个位数,$200 具体数值随数据滚动已不可复原;定性观感族(列头可改「已结算单」澄清)入台账 §6 不另修拍板 用户授权自动修复节奏(10-01「你可以逐个发详细对比,并自动修复吗?」)——本项属简单/明确类(B2/③-B 同族既定边界第 3 刀,非产品语义/非破坏性)直接落地;现象 b 属不可复原观察不修修复(finance.py:200-222 一处) settlement items SELECT 追加 o.has_finance,构造后对未回款行(has_finance=false)revenue/net 值 0→None(前端 usd(None) 既有「—」渲染,零前端改动);数据层/KPI/排序/settled 真值区全不动验证 API 镜像 16 断言 PASS(pending zf 净额全 None+营收无 0+有值行保留+KPI 1,126/$18,060.37 · abnormal 同型 · settled 真值保留 · all p1 全 None=最老未回款置顶排序语义+p60 真值出现+2 个 $0.00 行 DB 身份实锤 has_finance=true 真值区设计保留 · onno NULL 行为不变 · zf 租户跨品牌 1,305/$25,222.04/1,129 与 DB 和全等)+ 四道门全绿(test-reports/b6_*.log)+ tools/_shot_1001_b6_settlement.py 双视口 6 截图(pending/abnormal 首屏 $0.00×0+「—」×20 · settled 无清洗痕迹 · 双视口无溢出)+ analyze_image 视觉确认(KPI 卡真值 1,126/$18,060/91.2%/992 天与 API 全等、净额列全「—」、营收 ¥999/$6.87 双行真值保留)快照 backups/code-20261001-b6-settlement-zero/ + 截图 screenshots/b6-settlement-zero-1001/(6 张)坑 /tmp/audit.jar Netscape 格式多行——urllib 取 cookie 须留 #HttpOnly_ 行;zf 租户 brand_scope 无 fg(跨品牌 KPI=zf+onno=1,305 非 4,257);「settled 行 revenue 有值」不能当断言标志(settled 区 rev 也可 NULL/0,判态须 DB 反查 has_finance);回归门并发跑会撞 API 限流伪 FAIL(main.py:115 全局 240 req/min/uid 按自然分钟分桶:pen 尾段+dash 头段挤同桶→L cleanup DELETE/GET 双 429+dash noon 段 api=None FAIL 98;判别法=docker logs -t api 看 429 时间戳;单跑即绿 FAIL 0/WARN 7+ALL PASS,并发版存 test-reports/b6_*_concurrent429.log;同账号重复登录踢旧会话 jar 短暂失效同理非缺陷;pen L 段幂等复用同名任务——首轮 429 残留的 488 在重跑 14:00:48 被正常删除自清)进度 P4 待拍板清单 20→19(⑥闭);任务 #29;档案 memory-longterm §73_noon_wall 月窗锚 max_mon 两级查询只带 {bf}(brand)不带 {cf}(country);空态短路只在 if not max_mon(品牌级全空)——品牌有数据时 max_mon 非空→不进空态→主查询 wcond AND {bf} AND {cf} 遇无数据国 rows=0→mons_set=[]→继续构建全部图表→empty=False+空骨架+误导性 0 KPI。复现实测(2026-10-01 API 直调,触发条件三分支矩阵):①?platform=noon&country=DE&mons=12(无 noon 数据国)= 缺陷本体——empty=False、14 张图全部 x=[](nTopSkuTrend 因 top sku 空条件缺席故 14 非 15)、range from/to=None、kpis={revenue:0,net:0,orders:0,fees:0,margin:None}(B2/B3 误导性 0 同族);②对照 country=SA 15 图正常 x=12·range 2025-10~2026-09·orders 27,735;③对照 amazon 墙 country=NO(不在 amazon 14 国列表)正确返回 empty=True(dashboard.py:1178 if not ds)——noon 系同型不同修的跨平台分叉;④onno mons=24(窗口起点 2024-10 早于最早数据月 2026-02)x 正确修剪为 8 个月 2026-02~09——台账括号里「窗口早于数据月」分支实测健康非缺陷,真缺陷只有国家锚一刀;⑤brand=zzz 端点层 404「品牌不存在或无权访问」(P3-⑱ 守卫先拦)——品牌级空态分支仅「品牌存在但无 noon 数据」可达(如未来 fg)。UI 可达性核查(当前数据下=不可达):filters.countries.noon=['AE','SA'](源 pl_monthly DISTINCT country,zf/onno 两国都有数据)→ 无数据国不进下拉;page.tsx:617-620 countryOpts 按 platform 同步切换(useMemo 非异步)+:623-5 effect 国家不在列表即复位 ""——唯一理论暴露=切平台一帧竞态请求后自愈;实际暴露面=API 直调+未来新国家/品牌接入首屏。拍板核心=品牌锚 vs 国家锚:max_mon 不滤国家非单纯 bug——保证同品牌所有国家同窗(国家图 nCountryMon/份额图/品牌切换共月轴可比、切国家不跳窗),错在缺空态短路;未来停售国出现时两语义才有分叉(品牌锚=「窗口内无数据」空态 / 国家锚=回退该国最新可用窗显示旧数据)。三方案:A 最小修=mons_set 空短路返回既有 empty 结构,对齐 amazon 墙 1178 同款一刀,品牌锚可比性保持(推荐);B 国家锚=max_mon 加 {cf}——切国家窗口漂移、跨国家图月轴不可比、Σ国家≠品牌窗,当前两国都活跃时与 A 行为完全等价纯增复杂度(否决);C 前端兜底=page.tsx 检测全空图渲染空态——治标,API 仍发误导性 0 kpis 且两墙继续分叉(否决)拍板 用户执行方案 A修复(dashboard.py 1 处,4 行) mons_set 空时短路返回既有 empty 结构(与品牌级空态同款文案「该筛选下无 Noon 数据」,天然涵盖国家筛选);品牌锚语义不动验证 API 镜像 13/13 断言 PASS(DE→empty=True/0 图/kpis 空/range None+reason 文案 · SA/AE/全部三视图 15 图 x=12 数值不变 · onno mons=24/0 修剪不变 · amazon NO 空态+SA 78 图不动 · zzz 品牌守卫 404+文案不变)+ 四道门全绿(pen ALL PASS / dashboard FAIL 0·WARN 7 既有 / e2e ALL PASS / nodes ALL PASS,test-reports/b5_*.log);纯 API 改动且无可达页面可见变化(DE 下拉选不到、三视图数值断言级不变)→ 按纪律免截图快照 backups/code-20261001-b5-noonwall-empty/进度 P4 待拍板清单 21→20(⑤闭);任务 #28;档案 memory-longterm §72if r[0] in mset(nCountryShare 修复同款)②金额族逐行 _noon_usd(SAR 3.75/AED 3.6725 锚定,同工作台语义):mon_sum 五列(orders 件数列不折 fx=False)、SKU 三聚合、gmv_by_c/ctry_mon_gmv、sku_ads、ads_d ③ads_d/sku_ads 两条 SQL 加 country 列(折算前提)+sku_ads 同窗过滤(原本全史)+ads_d 按国折后归日 ④mon_floor 提前计算 ⑤hint×5 声明「窗口内折USD」效果 92 天窗 zf:SKU Top1 ZF435T1MEB $45,226(原全史本币 985,324 误标 USD);停售老品 ZF430T0MEB/ZF430T0MEW 出榜;份额 SA $111,121+AE $37,771(真 USD 可加);Σ品牌=全量精确成立(SA 116,373.27=111,120.94+5,252.33,09-30 品牌隔离门不变量保持);KPI 最新月 GMV $44,679 与前端「$·折 USD」声明一致成真验证 API 镜像独立重算 7/7 逐值断言 PASS(Top10 键序+逐值/份额/KPI/月度序列/国家×月全系列,逐行折算语义同构复刻)+ onno/全部品牌视图回归 + 四道门全绿(pen ALL PASS / dashboard FAIL 0·WARN 7 既有 / e2e ALL PASS / nodes ALL PASS,test-reports/b4_*.log)+ tools/_audit_b4_shots.py 12 断言 ALL PASS(KPI $44,679 USD 量级/hint 声明/无本币残值/图卡渲染/onno 回归/双视口无溢出)+ analyze_image 视觉确认(顶部视口:$44,679·折USD 脚注·几万级量级·布局无破版);快照 backups/code-20261001-b4-brandboard-usd/ + 截图 screenshots/b4-brandboard-usd-1001/(4 张含 -top)坑 ①ECharts 数值画在 canvas 不进 DOM——页面断言只能验标题/hint/KPI 卡文本,图值断言须走 API 镜像;②镜像脚本首版猜错图键(nCountryMon→实际 nCountryGmvMon)跨页终态 工作台墙(近N月·本币 hint 明示)|品牌板(92天窗·真 USD·hint 明示)|财务页(显式全部/年份选择器·本币分列)——三处各自声明、不再暗分叉进度 P4 待拍板清单 23→22→21(④闭);任务 #27;档案 memory-longterm §71coalesce→0 真源丢失 + 工作台脚注「该窗口无数据(无订单)」双重失真 vs finance full 裸 sum→null→「—」正确;定性=月界/日界瞬态:窗口内订单全 Pending/Unshipped 无 OrderTotal 时才触发,当前全库已无任何全 NULL 月/日切片,10-01 当日已回填至 7 单 4 缺)后拍 B 方案修复(dashboard.py 3 处 + page.tsx 1 处) Amazon charts kpis 并行加 rev_missing(循环内 rv is None and st in ("Pending","Unshipped") 计数,必须在 rv 铁转 0 之前判;不含 Shipped 死单避免 zf 38 单让标注永不消失;noon 分支无此家族不加);前端营收卡 revenue===0 && rev_missing>0 显「金额待结算」+「N 单金额待结算(未结算不显 $0)」脚注,真 0(无订单)保持原脚注;revenue 数值不动(0 兼容既有消费方与跨页门归一)真触发切片复现 2026-10-01 当日 country=AE 3 单全 NULL(Pending/Unshipped)→ API orders=3/revenue=0.0/rev_missing=3;UI 路径=工作台选国家 AE + 自定义 2026-10-01→2026-10-01验证 API 三组实测(默认 90d orders=1463/revenue=15692.96 基线无漂移 · 今日全品牌 $40.41/4 缺显真值 · AE 触发 0.0/3)+ 四道门全绿(test-reports/b3_*.log)+ tools/_audit_b3_shots.py 10 断言全 PASS(AE 触发卡全文「营收/金额待结算/3 单金额待结算」无 $0 无「无订单」· 今日全品牌 $40 真值 · 默认 30 天 $5,119 · 双视口无横向溢出)+ analyze_image 两次独立视觉确认(整页+顶部视口补拍:主值四字、同排利润/费用/毛利率/取消率卡无破版、汇总行「3 订单」);快照 backups/code-20261001-b3-kpi-revmissing/ + 截图 screenshots/b3-kpi-revmissing-1001/(5 张含 -top 补拍)坑 kpis 类型 Record<string, number|null>,前端两处比较须 (k.rev_missing ?? 0) > 0 否则 TS build 失败;自写脚注文案含字面「$0」会被「无 $」断言误伤(断言改为只查值行)进度 P4 待拍板清单 23→22(③闭);任务 #26;档案 memory-longterm §70rev_missing(count FILTER WHERE revenue_usd IS NULL,按当前筛选联动);前端 statusRev():Pending/Unshipped 全缺=「金额待结算」、部分缺=真值+「N/M 单待结算」(实测 Pending 7 单 · $26 · 5/7 单待结算 / Unshipped 2 单 · 金额待结算);Shipped 缺失=死单终态「—」口径(09-30 定案 zf38+onno9+fg26)不在此标注①残留 /noon pre-2025 未采集月 finance.py /api/noon/summary 新增 fee_cov:真源=源库 transactions 首个费用/打款交易月(qmercury 直读 zipforce_noon/onno_noon finance_transactions 的 statement_fee/payment/balance_transfer,失败回落 cleaned 首个非零月启发式);前端早于覆盖月的行渲染灰字「未采集」+净额带 *(=毛额+冲回未扣费用),CSV 同步「未采集」真源判据的关键辨析(启发式会误标) onno AED 2026-02 源库实有 2 笔 statement_fee 净额恰 0.00=「已采集的真零」——纯 cleaned「首个非零费用月」启发式给 2026-03 会把它误标未采集;实测 fee_cov 4 条(zf AED/SAR 2025-01 · onno AED 2026-02 · onno SAR 2026-03),onno 2026-02 正确放行验证 四道门全绿(pen ALL PASS / dashboard FAIL 0 / e2e ALL PASS / nodes ALL PASS,test-reports/b2_*.log)+ tools/_audit_b2_shots.py 15 断言全 PASS(未采集 21 行全 zipforce · onno 2026-02 不标 · 脚注共 21 行 · 净额* · 累计打款卡 SAR 1,051,861 真值保持 · 四视口无横向溢出)+ 双页双视口视觉确认(orders 状态分布经 analyze_image 逐行核实无裸 $0);快照 backups/code-20261001-b2-pending-fallback/ + 截图 screenshots/b2-pending-fallback-1001/(脚注措辞对齐源库真源后二次重建复截)自愈条款 R9 对账交易扩采回填后 21 行自动恢复数值、标注自愈,无需再改码进度 P4 待拍板清单 24→23(②闭,①残留随②并入闭);任务 #25;档案 memory-longterm §69WHERE order_date IS NOT NULL 把全部费用/打款交易 100% 滤掉已验证WHERE order_date IS NOT NULL——而这三类交易天然无 order_date(只有 transaction_date),实测 zf 391 行 + onno 84 行 100% 被滤 → 两列自上线恒 0.00(raw 78 行全 0)。09-17 月度对账注释「payouts 列全库为 0(源不回填)」系误诊,真值一直在 mars 本地 amazon_analytics 源表且新鲜到 2026-09-30(09-29 cutover 后全链在 mars:qmercury 本地直连,mercury 已冻结——本条目之前的「mercury 采集器」称呼一并纠正)修复(3 处 SQL + 数据一次性应用 + 镜像) 归月改 coalesce(order_date, transaction_date)(订单类仍按 order_date、费用类落 transaction_date=完成原作者设计意图)——静态 spec zf/onno 两分支 + 运行时模板 _NOON_MONTHLY_FIN(sync_mercury.py:1022);一次性应用=容器内等价 upsert 78 行(psycopg2 execute_values,源库与 SaaS 库跨 database 须两段式)+ clean_audit.run(tables=['noon_monthly']) 单表重清洗(run_id clean-b4ff4d30a598)+ api 镜像重建(04:30 定时同步此后带修复);快照 backups/code-20261001-noonmonthly-fix/效果(清洗层+页面双验) cleaned_noon_monthly 51/78 行非零费用、55/78 非零打款(余 27 行=真零:2025-01 前对账交易未采集);zf SAR 累计打款 1,051,869·费用 603,194 / zf AED 255,969·178,659 / onno SAR+AED 全出值;/noon 累计卡「累计打款 SAR 1,051,861 · 费用 SAR 616,207」与 zf+onno 加法精确吻合;净额列连带修复(zf SAR 2026-05 由 87,767 虚高 → 56,654 真值);月度对账 tab/P4 台账原「回填 vs Pending」三方案讨论整体作废验证 四道门全绿(pen_tests 90 PASS / audit_nodes ALL PASS / dashboard_audit FAIL 0 / frontend_e2e ALL PASS,test-reports/nmfix_*.log)+ /noon 双视口复截 screenshots/noon-monthly-fix-1001/(累计卡非零+月表非零行+无横向溢出程序化断言 + 视觉确认,tools/_audit_noon_fix_shots.py)残留(观察入台账) 2025-01 前 zf SAR 13 个月 + AED 10 个月费用/打款 0.00 系对账交易采集未回溯(真零 vs 未采集显示 0 的辨析待 R9 扩采或页面脚注拍板);onno 对账单表(cleaned_noon_statement)仍 0 行——源 transactions 有值但 statement 汇总表未覆盖 onno,两表现各自口径并存进度 P4 待拍板清单 25→24(①闭);任务 #24;档案 memory-longterm §68/screenshots/pixel-audit-0930/{tenant}/(d=1600×1000 首屏 / m=390×844 全页)+ 修复批 /screenshots/pixel-audit-1001-fixbatch/(11 项修复涉及页 ×3 租户×双视口 + 2 未知品牌守卫路由,tools/_audit_fix_shots.py 程序化断言无 NaN/undefined,不覆盖原始档)——样例:zf·noon·移动 · zf·orders·移动 · 修复批·zf·database·移动本段 PASS 页 database-fix-m / listings-m(首跑,P1 已验 SKU 全串)/ team-m / today-m(分国家 0→"—"、-100.0%、合计 12 vs 16 含 Pending 注释全部处理正确);dashboard_onno-m 早批已 PASS⚠ 误报撤销 6 处(视觉判定必须回代码/DB——本批再证纪律) ①inventory 徽章「观察(一)」全角一:代码 LEVEL_LABEL 数字计数渲染无全角字(inventory/page.tsx:56),复跑亦未再报=小字号误读;②noon「JOD」币种:noon/page.tsx 仅 累计 {t.currency}=AED/SAR,全码无 JOD;③finance 分市场 17/18 排在 24 后:kpi-wall ORDER BY fin.rev DESC(finance.py:406)按营收排非订单数,低营收 24 单市场排后自洽;④noon 趋势 X 轴 -30,000 负刻度:zf 净额确有负值月(AED 最低 -675.85 / SAR -2,330.69,gross+updates-fees),ECharts nice-interval 轴自动下探=真实数据合理渲染;⑤upload「批量建任务(...)」占位:listings/page.tsx:474 modelSkus.length || "…" 未选型号设计空态;⑥listings 复跑「SKU 列仅显示 1」:与首跑 PASS + P1 数据审计(HM-3720S-DP-WIFI 全串)矛盾=误读。累计撤销 19+ 处(含早批 13+:tenant_brands 合法双品牌/脑补$/错字/未来日期/tbl-wrap 标准模式)⚠ 真发现(入 P4 台账) ①noon 月度表 fees/payouts 全表恒 0(源头空洞):SQL 实证 audit.cleaned_noon_monthly 四品牌×币种组合 fees/payouts 全部月份=0.00 且非 NULL(API finance.py:235-236 另有 NULL→0.0 强转但此处不适用),/noon 页累计卡「累计打款 0 · 费用 0」如实渲染误导性 0——真值在 cleaned_noon_statement(对账单采集 R9 只到 2026-07)→ 回填 vs 页面 Pending 标注待拍板;②orders 状态分布 Pending 7 单 $0 / Unshipped $0:已知 Pending 回刷缺失家族(db-requirements-2026-09-24 已立项)的表现面,台账交叉引用;③feishu 空文件夹「0 个子项」:children 来自飞书云盘 API 实时值=真实 0 非缺失(观察非缺陷)观感/口径观察族(并入 P4 台账) 铃铛 99+ 挤压/压字(feishu/mapping/training/upload 通病,含 99+ 与 onno 胶囊区重叠);finance 盈利总览小字挤排换行/环比流箭头叠字/订单流标签数值分离;inventory 国家胶囊行末「EU-共享与58」与说明重叠+底部间距 0;noon 月度明细空白月行(2023-12、2024-02~04)无 —/占位+明细列间距过近+「净额未折USD」卡注顶部贴边;mapping「预览」列头右缘截断(tbl-wrap 标准模式内);finance 分市场已结算空值无 —、SAR/AED/GBP 混排无换算说明、amzn.gr. 长串无省略号;training「内容体量」换行截断观感/主推课程卡留白失衡/「无需 UVPVP 账号」h2·sub 390px 换行;orders 分页「14747 条」390px 折行——均为观感类不构成数据缺陷方法论固化(P3 教训) ①agent 死亡模式:analyze_image 长文结果累积 → 子 agent「Prompt is too long」死亡(累计 3 个)→ 对策=主会话直接批量跑(本日 7+9 张两批并行成功,勿混入畸形多余调用);死亡 agent 结果可从 JSONL 转录抢救(assistant 消息内 server_tool_use↔tool_result 按 tool_use_id 配对,jq 不在须 python3 逐行 json.loads);②audit schema 在 saas_registry(RLS 单库多租户),amazon_analytics 是 mars 仓原始层——查 cleaned_* 须 psql -d saas_registry;③宽表 .tbl-wrap 右缘截断=卡内可滚动标准模式(globals.css:140),页面级溢出才是缺陷;④视觉模型对全角/数字、小字币种、排序依据、设计空态省略号四类高发误读,凡裁定必回代码进度 P3 全闭(#18):三租户×双视口全页面像素确认+176 张级存档+11 项修复复截批;P1 十五波 / P2 十波(121 写端点 8 缺陷修)/ P3 六批次全部完成 → P4 总台账报告(#19)开跑(累积待拍板清单 + 4 项 standing 披露:glm-main 切 backup / pg-init·74 迁移未落盘 / 缺陷㊯ max_tokens / 缺陷㒰 僵尸会话)sess:{sid} 键、不从 sess_user:{slug}:{uid} 集合移除——僵尸 sid 永久累积(集合 TTL 每次登录被续期永不消亡;实测 onno:2 集合 316 成员仅 48 活),且 logout-all 的 revoked 计数把已死会话也计入(au5 断言挖出:revoked=2 实活 1);修复=删键同时 srem+顺带清理本次发现的僵尸成员+revoked_other 改为只计活会话;生产存量一次性清理(onno 316→48 全活、zipforce 集合因 TTL 自然过期重建仅 1 活成员)——只删 sess 键已不存在的引用,零登出副作用;build→up -d api→pen_tests 全绿billing 3(配置态决定可测面) modules/toggle:未知模块 400 "模块不存在"/关 listing→DB false+audit f"listing=off"/开复原——demo 模式(STRIPE_KEY 未配置)owner 自助直开;正式计费 503 分支当前配置不可达=观察项;checkout:bogus 400 "套餐不存在"/starter→503 "支付通道未配置(Stripe key / 价格 ID 缺省)"(零 Stripe 外呼);webhook:503 "webhook 未配置"(WHSEC 未配置——验签/时间戳容差/事件处理分支均不可达=观察项,配 WHSEC 后需补测)keepa-history 真外呼(1 token/ASIN,Keepa 外呼门 W1 未覆盖项补齐) 缺 asin 400 "缺少 asin"/ZZ 400 "站点不支持: ZZ"(校验序实证:站点 400 在配额门之前——429 构造须合法站点+未缓存 ASIN);happy:country us→US+asin 小写→大写归一、cached=False、tokens_left int、keepa_pull_log 落库 endpoint/asin_count/tenant_id 全锚、keepaq 计数 +1;二连 缓存命中 cached=True 零 token(缓存键 keepa:hist:{domain}:{asin} 先 DEL 保双跑一致);429 配额门:SET keepaq=50→429 "今日选品搜索额度已用完(50 次/天, 套餐 starter)"(缓存 miss 后配额拦, 零外呼)→finally 计数动态回写po_pdf 3(MailIn.to 参数直构造 failed 分支,免动 suppliers 表) GET pdf:已存在直读 %PDF magic+audit po.pdf "id=3";regen POST:{ok,pdf_path}+盘上 test -f+audit po.pdf.regen;mail 无 to→skipped "供应商未维护邮箱"+DB mail_status=skipped+audit "id=3 skipped->";mail to=.invalid RFC 保留域(必递送失败零打扰)→failed 分支(SMTP 真外呼 1 次实测)+DB mail_status LIKE 'failed:%'+mail_to 落库;99999999 pdf/mail 双 404 "PO 不存在";finally mail 字段复原 NULL——sent 分支无受控收件箱=观察项auth 敏感写(临时 uid 隔离用户全链,不碰真实 owner 22 活会话) viewer 用户双会话:sessions 列表 2 项+current True/False 标记;非 admin toggle 403 "owner or admin only" 且零审计零 DB 改动;改密:错旧密 400 "当前密码不正确"/成功 revoked_other=1(B 设备死 A 存活——㒰 修复前此处已过、僵尸计数在 logout-all 才暴露)/被吊销会话 sessions 401;logout-all revoked=1+redis 集合 EXISTS=0;logout-all 含本设备——后续 sessions 必 401(语义确认非缺陷);logout 幂等 ok+审计;register:REGISTRATION_OPEN=0→403 "注册暂未开放…"(register/resend 双验证)+短密 422(pydantic 先于 handler)+零残留断言;verify:缺 token 400 "缺少验证令牌"/无效 token 400 "链接无效或已过期,请重新注册或重发验证邮件"镜像 bug 分类学(累计 42+) 本轮新增:test -n "$(redis-cli exists k)" 恒真(exists 输出 0/1 恒非空——判断须 = "1",清理脚本首版因此空转);EmailStr 拒收 .test 保留域(422)——临时用户邮箱用可解析形态 .io;站点白名单 400 先于配额门(429 构造的调用参数须全合法);隐式布尔 't' 渲染坑再现(pm2)回归与铁律 缺陷㒰 非口径类当场自主修(快照逻辑最小改+存量清理幂等);W10 脚本 _audit_buttons_w10.py 48 断言 0 FAIL ×2 轮(三轮收敛:轮1 kh5 造门参数撞前置 400+pm2 布尔形态+临时邮箱 422、轮2 au5/au6 挖出㒰+vf2 文案笔误);deploy_gate(pen_tests)全绿;test-reports/pw10_run{1,2}.log;终态:PO3 mail 字段 NULL 复原/listing 模块 true/keepaq 计数回写/临时用户删/审计行数 [toggle2, po.pdf1, regen1, po.mail2, login2, password1, logout.all1, logout1]进度 P2 十波全闭:121 写端点全交互验证(W1~W10),累计挖出并当场修复 8 处真缺陷(㊱㊲㊵㊶㊷㊯㒰+对称性)+2 起生产事故自主处置(glm-main 上限切换/Keepa 日任务 ImportError 前史);下一阶段 P3 每页像素视觉确认(#18)→ P4 总台账(#19,累积待拍板清单)429 code 1310 "您已达到每周/每月使用上限,您的限额将在 2026-10-03 13:57:24 重置"(key 零回显)——生产全部 AI 端点当时 502 中;三把备 key(glm-backup/glm-old/kimi)探针全 200 健康 → 按自主修复纪律经正式 /api/ops/llm/switch 端点切 glm-backup(同 glm-5.3,探针先行防切坏,audit 留痕 glm-main->glm-backup probe_usage=…);终态保持 glm-backup,10-03 13:57 上限重置后可经同端点切回(sw0 已验证切换链路双向健康)⚠ 缺陷㊯ 思考型模型 max_tokens 耗尽正文 502(当场自主修复) 双跑各恰一次重上下文端点 502(run1 sourcing 旧模式 / run2 ads-optimize)→ 抓响应体定案 {"detail":"大模型未返回正文(stop=max_tokens)"}——glm-5.3 思考 token 与正文共享 max_tokens=8192,大上下文分析时思考偶发独吞预算 → 正文空 → 502(~10% 复现率,api logs 只有 INFO 无 detail,靠响应体实锤);ai.py:187 注释早警告过此风险;修复=max_tokens 8192→32768(按实际生成计费,提上限零成本——上游 32768 探针 200 验证过)+ anthropic 路 stop=max_tokens 空正文同参重试一次(思考长度随机)+ agent 循环同步 32768;修复后同款 16 连发大上下文打击 16/16 全 200(修复前同循环第 4 发即 502);fastapi build→up -d api 部署ops/llm/switch 六分支 providers 列表 active=glm-backup/4 家 key_ok 全真;onno 账号 403 "仅平台主租户管理员可管理大模型供应商"(_require_platform_admin slug=zipforce+owner/admin);未知 404 f"未知供应商: nuke";同供应商 no-op {changed:false} 且不落审计;死 key 回滚分支实测——反用 glm-main(上游 429)作切换目标:502 f"目标供应商「glm-main」连通失败, 已保持 glm-backup" + redis llm:active 原位 glm-backup + 失败无审计(坏 key 变测试夹具);kimi(openai 协议)往返切换双向 200 probe_answer/probe_usage 齐ai 端点语义集 ask 空问/超 2000 字 422(Pydantic);insight 审计 resource=问句前 100 字;adcopy SKU 不存在 404 "SKU 不存在"(观察项:_ai_quota 在 SKU 查询前——404 也烧配额计数);sourcing 三态:term+ai=LLM(country us→US 大写归一,audit f"term={term} US")/term+未购 ai=degraded 快照 code-snapshot(零 LLM,租户2 实测 answer 以"【搜索词竞争格局"开头+note 含"未开通 AI 模块")/无参+未购 ai=400 "无参旧模式(自营 SKU 加码/止损)需开通 AI 模块; 请带 term 参数走搜索词格局分析";require_module 403 detail 是 dict {"module":"ai","reason":"unpurchased"} 非 str(镜像:断言须按对象比较);page-chat 三页(ads/finance/sourcing)audit 前缀 ["ads q=","financ","sourci"](切片 r[:6] 期望须按 6 字符写)429 配额门 + aiusage 语义 redis 预置 aiquota:zipforce:{today}=50 → ask 429 "今日 AI 额度已用完(50 次/租户/天, 当前套餐 starter)"(构造零 LLM);finally DEL;aiusage:{today} hash 只在 LLM 成功后 +1(switch 探针/失败/degraded 均不加)——终态增量恒 10 断言双跑稳定测试节奏伪影两枚(非产品缺陷,脚本侧修) ① 双跑背靠背时 run1 尾+run2 尾同分钟 /api/ai/* 累计破 main.py 全局限流 rl:ai:{uid} 20/min → qt1 撞限流 429 "请求频率超限"(先于配额 429)——脚本 qt1 前清审计账号自己当分钟计数键;② 租户2 login.success 精确计数被真实用户并发登录叠加(07:10:28 实测第 3 行——onno owner 与用户共享 35 活会话)→ 断言改 degraded==1 恒等 + login>=2 下限;另:parse_token 对 Redis 瞬断 fail-closed 吐 401(run1 单发抖动,同 cookie 前后 200)→ call() 对非预期 401 重试一次+audit 取行加防崩守卫(原 IndexError 会中断余下覆盖)镜像 bug 分类学 ㊱+(累计 41) 本轮新增:api logs 只留 INFO 状态行,502 根因须抓响应体 detail;psql/断言切片定长笔误(r[:6] 期望写整词);redis 计数键双跑复原用动态读值回写(q_before/q_after)非硬编码回归与铁律 缺陷㊯ 非口径类当场自主修(快照→修码→build→up -d api→16 连发复测→pen_tests 全绿);LLM token 最小构造纪律:一句话作答/agent 明示勿调工具(0 Keepa)/429 与 degraded 全走零 LLM 构造;W9 脚本 _audit_buttons_w9.py 46 断言 0 FAIL ×2 轮(pw9_run{1,2}.log,五轮收敛);终态=glm-backup 可用+租户2 ai 模块复原 true+aiquota 键清进度 P2 已闭 9 波(108 写端点);余量:W10 billing 3(Stripe/WHSEC 均未配置→checkout/webhook 测到 503 未配置分支,零外呼)+Keepa keepa-history 真外呼(1 token/ASIN+缓存+pull_log)+po_pdf regen/mail(.invalid 保留域构造 failed 分支)+auth 敏感写(logout-all 用临时 uid 隔离用户——真实 owner 22 活会话与用户共享不可直接吊销)SELECT count(*) FROM tenant_brands WHERE is_active=true 无 tenant_id 过滤(全表 count)——只要任一租户有 ≥2 活跃品牌,本租户仅剩 1 个也可被 permanent 删光;实证受害面:租户3(fittingirls)仅 1 活跃品牌,且 5 个租户合计活跃品牌 ≥2 恒成立 → 保护自 2026-09-22 上线以来对所有租户完全失效;修复=加 WHERE tenant_id=%s(快照 backups/code-2026-10-01/api-w8-pre.tar → build → up -d api);断言法:纯 DB 翻 zipforce/onno is_active=false(秒级不触发调度 pause)→ permanent 删测试品牌 400 "至少保留一个活跃品牌"→finally 恢复→断言 2 活跃复原⚠ 缺陷㊶ permanent 级联 DELETE 无权限(当场自主修复) 级联要删 audit.cleaned_amazon_orders/audit.cleaned_inventory_health,portal_app 对这两表仅有 SELECT → 彻底删除品牌自上线以来一直 permission denied 500(br12 断言挖出:500 纯文本无 detail → 查 information_schema 实锤);修复=运行库 GRANT DELETE ON audit.cleaned_amazon_orders, audit.cleaned_inventory_health TO portal_app,复测 500→404;⚠ pg-init/74 迁移文件(固化此 GRANT)两次被 auto mode 分类器拒绝未落盘——运行库已生效,但重建库会丢,需用户放行写入或手动补对称性修复(同场) permanent 对不存在品牌原先静默 200+误落 permanent_delete 审计(archive 分支却 404)——tenant_brands DELETE 后加 rowcount=0 → 404 f"品牌不存在: {brand}",且不再误落审计aplus media 登记链 POST 建 media_ref/lang 白名单(en/zh…)/tag +history media.register;同 media_ref UPSERT ON CONFLICT(tenant_id,media_ref) 更新 lang/tag(count=1|de|改后tag 全锚);空 ref 400 "媒体引用路径必填"/501 字符同 400(上限 500)/非法 lang 400 "非法语言标记";DELETE 200+history media.delete str(mid)+行删;删不存在 id 幂等 200+留 media.delete 痕(观察⑭记台账,与 aplus_history 只追加设计一致)aplus draft 全链 POST 无 doc_id=INSERT:name 必填 400 "文档名称必填"/template 白名单 400 "未知模板"/asins 清洗链 strip→逐个 [:16] 截断→[:10] 条数上限(12 项含 1 空串被滤 → 10 条,B0W8001+12X=19 字符截 'B0W8001XXXXXXXXX' 16 字符)/market[:8]/content 原样 jsonb(content->>'header' 取内层对象文本 '{"t": "h"}')+status='draft'+history draft.create(asin=截断后首条);带 doc_id=UPDATE(404 "草稿不存在",name/asins/market/template 全更);docs DELETE 仅 draft 可删 400 "仅草稿可删除"(published 行实测 400;再删已删行同 400)+history draft.delete str(did)collab upload 白名单链(校验序实证) multipart → 后缀白名单(15 类)先于 50MB 大小检查(.exe 400 "不支持的文件类型 .exe"/无后缀 400 "(无后缀)"/51MB .txt 400 "超过 50MB 上限");成功链四锚:响应 id/filename/size(UTF-8 字节数动态复算——'内容'汉字 3 字节);url 格式 /uploads/1/{yyyymm}/{uuid12}_{name};DB 行 filename/size_bytes/uploaded_by=1;盘上落盘 docker exec sh -c 'test -f'(cexec_sh——argv 式 test 的 returncode 捕不进 stdout);列表含新行;raw 鉴权读回 md5 全等;raw 99999999 404 "文件不存在";DELETE 行删+盘 unlink 双锚;再删 404collab pipeline/run _require_admin+PIPELINE_JOBS 白名单:未知 404 f"未知任务 nuke_all";真 enqueue 选 daily_usage_rollup(每日 00:05 已跑的幂等日结——最小可控副作用) 200 {ok,func,job_id}+audit pipeline.run f"{func} job={job_id}"auth tenant/brands 三态管理 POST 正则 [a-z0-9-]{2,40}(大写/1 位/下划线全 400 "品牌名仅限小写字母/数字/连字符, 2-40 位")+audit tenant.brand.add;重复 409 "品牌已存在";DELETE mode=archive 默认:is_active=false+audit tenant.brand.archive+全部停用→pause_tenant_jobs+ShopConfigUpdated 事件;再 archive 幂等 200(行在);不存在 404;activate PUT 恢复+audit tenant.brand.activate+resume_tenant_jobs(幂等);permanent:保护门(缺陷㊵修复后)→级联清 audit.cleaned_amazon_orders/public.sales_daily/audit.cleaned_inventory_health/public.products/public.sku_mapping/user_brands/tenant_brands+audit permanent_delete+ShopConfigUpdated——表覆盖面仅 6 业务表(观察项记台账:ads/listing/pm/aplus 等域表不在此列,残留风险待拍板)权限观察项⑦ 全实证闭环(固化 3 断言) aplus_history portal_app 仅 INSERT,SELECT(API 只 INSERT+SELECT——故意只追加无触发器但代码无 U/D 路径);public.noon_daily_finance portal_app 无 SELECT 而 audit.cleaned_noon_daily_finance 有(API 只读清洗版);keepa_pull_log 仅 INSERT(api/routers/sourcing.py:54 写;读侧走管理员连接)——无权限的表恰是 API 无操作路径的表(权限最小化设计成立);显式 (bool)::text 渲染 'true'/'false' 而 psql 隐式 -t 渲染 't'/'f'(㊳ 同坑再现)镜像 bug 分类学 ㊱(累计 40) 本轮新增:psql 聚合列(count||lang)必须 GROUP BY 或 max() 包裹否则整组无输出;docker exec test -f 的 returncode 不进 stdout——须 sh -c 'test && echo || echo';上传后缀白名单先于大小检查(.bin 会撞后缀 400 而非大小 400);jsonb 取内层对象文本保留 '{"k": v}' 空格形态回归与铁律 缺陷㊵/㊶ 均非口径类当场自主修复(快照→修码→build→up -d api→复测 500→404/保护复活);W8 脚本 _audit_buttons_w8.py 61 断言 0 FAIL ×2 轮(四轮收敛:轮1 psql 聚合崩、轮2 7 FAIL+br12 崩出缺陷㊶);deploy_gate 全绿;纯 api 改动无 web 改动免截图;双 run log 存 test-reports/pw8_run{1,2}.log;终态五表清零(aplus_history/aplus_docs/aplus_media/tenant_brands 测试品牌/upload_files)+真实品牌 2 活跃复原断言进度 P2 已闭 8 波(100 写端点);余量:W9 ai.py 8(LLM token 放行最小构造)、W10 billing 3(Stripe 测试模式)+Keepa 外呼 GET+po_pdf regen/mail SMTP+auth 敏感写 5(logout-all 须先确认审计账号非用户共享会话)vdl:matlock:{tenant} TTL 600s:fresh 200 {ok,processed,watch_note}(幂等 UPSERT 只增不减+每候选必有 verdict 行 watch 态补齐断言);10 分钟冷却内再跑 429 "重算冷却中: 约 {ttl}s 后可再试(owner/admin 可强制重算)";force=true owner 过 200+audit verdicts.materialize f"rows~N country=… watch_seeded=M";脚本首尾双清锁保证双跑幂等verdicts decision 全链+复原 404 "候选不存在"/400 "未知状态"/终裁(qualified/rejected)无备注 400 "终裁(主攻)必须填写备注理由"(空白 note 也拦);改判落 state/owner_uid=1/note;sourcing_decision_audit 只追加含 evidence 证据快照(from/to/note/快照非空全锚);测试后 decision 回原态复原⚠ append-only 触发器表第二例(设计实证) sourcing_decision_audit 有 trg 拒 DELETE("sourcing_decision_audit is append-only")——与 listing_events trg_listing_event_immutable 同类设计;测试审计行按设计留痕 3 行(改判/终裁/复原),不可删——终态断言 count=3 并记录 id 范围;镜像教训:期望复原前先查表有无不可变触发器镜像 bug 分类学 ㊴(累计 39) 本轮新增:显式 (bool)::text 渲染 'true'(vs 隐式 -t 渲染 't'——两种形态不同);UTF-8 字节数手算错('p2w7 更新'=11 非 10,汉字 3 字节);429 detail 含动态 TTL——断言用 startswith 前缀非切片定长回归与铁律 import 全量替换=破坏性操作,备份链 dump→finally 恢复→断言三重(名集/任务数/history);dump 存 test-reports/pm_backup_w7.json;W7 脚本 _audit_buttons_w7.py 91 断言 0 FAIL ×2 轮(四轮收敛:轮1 17 FAIL 全为断言语义校准+1 设计拦截);deploy_gate 全绿;纯 api 审计无 web 改动免截图;materialize 会播 keepa_watch 候选行(KEEPA_WATCH_LIMIT 套餐额度内 ON CONFLICT DO NOTHING——业务幂等不属测试污染)进度 P2 已闭 7 波(90 写端点);余量:W8 aplus 4+collab 3+auth tenant/brands 3(顺带实证 aplus_history/listing_*/keepa_pull_log/noon_daily_finance 权限观察项⑦)、W9 ai.py 8(LLM token 放行最小构造)、W10 billing 3(Stripe 测试模式)+Keepa 外呼 GET+po_pdf regen/mail SMTP+auth 敏感写 5value+' '+kv.unit → '800 lm'),模板 A1/A2 占位与五点又各拼 schema 单位(:333/:340 value+' '+schema.unit)→ 每个规则生成的任务 title='… AUDIT-M6 800 lm lm 6500 K K kw1 kw2'、五点 '亮度: 800 lm lm'——源码静态疑点→首轮实测确认→修复:新增 _join_unit(value, unit)(值尾已含单位则不再拼,大小写不敏感)替换 :333/:340 两处;build → up -d api 部署;修后 title/bullets/全链断言绿。attrs 本身不受影响(:323 不变)测试设计三大外呼边界 ①submit 全 dry_run(真推 SP-API/noon 写外呼绝不构造;422 缺必填验证在外呼前可测);②bind-pt 单端点只测护栏 409/404/400(_brand_ok 后走 ensure_exit 真外呼,TB 测试品牌无凭证);③batch bind_pt 纯 UPDATE 可全测。绕 LLM 兜底=规格书 10 条 kv(≥8 使 len(kv)<8 不成立,ai_added=0 纯确定性)specs 单 SKU 上传 multipart Form brand/sku+file;kv_count 10/parsed[0] 亮度|800|lm/file_type txt/uploaded_by=1/audit f"{brand}/{sku}:txt";错误矩阵 5:缺 brand 400 "brand 与 sku 必填"/产品 404 f"产品不存在: {brand}/NOPE(先在 品牌接入 导入 SKU)"/旧 .doc 400 "旧版 .doc 请先另存为 .docx 再上传"/坏类型 400 f"不支持的文件类型: 完整文件名 (支持 docx/pdf/xlsx/txt)"/空文本 400 "未能提取到文本(扫描件 PDF 请转 docx/xlsx)"models/spec 型号级 同一份 kv 落全型号 SKU(model_number='AUDIT-M6' 命中 A+B;A 因已有单 SKU 行成 2 行)/audit f"{brand}/AUDIT-M6: 2 products, kv=10"/空型号 404 f"型号 {brand}/NOPE-M 下无产品(先完成产品建档)"tasks 建 + auto_pt 预插 listing_pt_suggest(US)→auto_product_type 自动带出+事件 detail.auto_pt;唯一键 409 "该产品×平台×站点已有任务"/ebay 400 "平台未开放: ebay"/XX 400 "平台 amazon 无站点 XX"/未登记品牌 404 "品牌未登记: audit-nope"/产品 404/bogus 400 "类目不存在: bogus"/noon SA 与空 market 均合法(submit 400 分支用)generate ai=0 确定性链 模板 {BRAND} {NAME} {MODEL} – {A1} {A2} {K1} {K2};attrs 三命中 lumen/color_temp/socket(_SYN 同义词+label 匹配);bullets=required 优先+Package 尾条(4 条);gen_meta.engine='rules-v1'+attr_sources spec:标签;version 1→2;spec_id 关联(取该 SKU 最新规格书——单 SKU+型号级双份时指向后者);404 "任务不存在"PUT 编辑 changed 列表序 [title,bullets,keywords,attrs]/schema 外 400 f"属性不在类目 schema 内: bogus_key"/同值 changed:[]/404approve 质量门 + revert 单任务空内容 400 "标题为空; 五点不足(0/3)";批量 fail 三连 "标题为空; 五点不足(0); 缺必填: 接口类型"(batch 比单任务多 schema required 检查);成功 ready+approved_by/approved_at;再批 409 f"仅 draft 可批准(当前 ready)";revert 双向(审批字段清 NULL)+再撤 409export(GET 但写副作用) BOM \xef\xbb\xbf + 列集头 sku,item_name,brand_name,bullet_point1..2…;状态翻 exported+audit "amazon:1";ids 无匹配 404/非 ready 409 f"任务 N 非 ready, 不能导出"/缺参 400 "ids 或 platform 至少其一"import-results ASIN 三级级联 updated=1/total_rows=2/skipped ["NOPE999:无任务"];任务 imported+asin;级联② sku_mapping 精确 (brand,sku,platform) 行回填 asin;级联③ keepa_watch ON CONFLICT(tenant,domain,asin) DO NOTHING source='auto_cascade' domain=1(US)/created_by=0;缺 sku 列 400 "CSV 缺 sku 列(支持 sku/item_sku/item_number)"/空 CSV 400submit 预检全链(真推不测) 非 ready 409/未绑 PT 400 "未绑定平台类目(先 bind-pt)"/缺必填 422 在外呼前 "缺必填属性 1 项: socket"(schema required 逐 key 检 attrs);amazon dry_run:payload_keys 6 键 [socket,lumen,brand_name,item_name,bullet_point,product_description]+payload.item_name=[{value,language_tag:'en-US'}] 结构+audit listing.submit-dryrun;noon dry_run:csv_preview/csv_rows=1/cols=7;批量 submit dry_run note f"预检载荷{N}字段"(noon payload_keys 空→0 字段)+missing 透传batch generate_sync 智能覆盖(2026-09-21 逻辑实证) 模板行 note='模板';audit 计数含模板("2 tasks ← tpl#N");title/bullets/description/keywords 整体拷贝+gen_meta.copied_from;attrs 三分支:own 空→补模板值;own≠模板 且 sibling 值集≤1 → 共用参数下发覆盖(socket E29→E27);值集≥2 → SKU 差异保留(lumen 900 lm 不动);skip 条件 submitting/submitted/imported/exported "已推送(status)"batch 其余 空 ids 400 "ids 必填(1~200)"/未知 action 400 f"未知操作 nuke"/不存在 fail {id,note:'不存在'};approve 非 draft→skip "状态ready"(非 fail);revert 同 skip 语义;bind_pt 批量 只更 product_type 列(market 仅入事件 detail,DB 不动 market)——语义观察记台账DELETE + 事件不可变 ready 409 f"仅 draft/failed/imported 可删除(当前 ready)";draft 200 {ok:true};listing_events 有 trg_listing_event_immutable(BEFORE DELETE OR UPDATE)——任务删后事件残迹保留为设计(终态断言残迹存在而非清零);再删 404观察项(生产不可达,记台账) ①normalize_pt_schema(spapi_client.py:186) 对 schema_raw 为 list 时裸 500('list' has no 'get')——生产 schema_raw 仅由 ensure_exit SP-API 写入恒为 dict,仅手工预插数组可触发;②batch bind_pt 的 market 参数只进事件不进 UPDATE(见上)镜像 bug 分类学 ㊳(累计 38) 本轮新增:psql -t 布尔渲染 't'/'f'(IS NOT NULL 期望写 't' 非 True);jsonb_array_length 返回 int 仍渲染字符串('4' 非 4);curl -F 无 f 前缀字符串把 {var} 当字面量发(422 int_parsing input='ta'——lint 不可见,URL 必拼装后核对)回归与铁律 缺陷㊲ 非口径类自主修复:源码通读疑点→首轮实测定案→快照已在(当日 api.tar)→修码→build→up -d→join_unit 单元断言×4;纯 api 改动无 web 改动免截图;W6 脚本 _audit_buttons_w6.py 94 断言 0 FAIL ×2 轮(三轮连续全绿);deploy_gate 全绿(pen_tests/audit_nodes/pipe_audit/chart_value/dashboard_audit FAIL 0+页面码一致);双 run log 存 test-reports/pw6_run{1,2}.log;终态八表复原(任务/规格/建议/类目元数据/租户品牌/映射/产品/keepa_watch 全清,events 残迹按设计保留)进度 P2 已闭 6 波(75 写端点);余量:W7 projects/pm 8+reports 4+verdicts 2、W8 aplus 4+collab 3+auth tenant/brands 3(顺带实证 aplus_history/listing_* 权限观察项)、W9 ai.py 8(LLM token 放行最小构造)、W10 billing 3(Stripe 测试模式)+Keepa 外呼 GET+po_pdf regen/mail+auth 敏感写 5POST/DELETE /api/ads/rule-config 必 500:portal_app 对 ads_rule_config 无 INSERT/UPDATE/DELETE(permission denied)——2026-09-20 建表时手工建于运行库且漏 GRANT,CREATE TABLE 不在 pg-init 任何文件(重建库即丢表)。修复=运行库 GRANT I/U/D+序列 USAGE(幂等后 111 权)+ 新建 pg-init/63-ads-rule-config-table-20261001.sql 幂等迁移(建表+序列+约束+RLS brand_isolation+GRANT,运行库已验证幂等执行,编号在 64 号默认行文件之前)⚠ 缺陷② promo_submission NameError 半成功(当场自主修复) POST /api/promotion/submission(达人投稿按钮)500:代码引用未导入的 audit(...)(本模块只导入 _audit)→ NameError,但 INSERT 已先行 conn.commit() → 半成功(用户见报错、数据已落库)。D批P3-16(2026-09-26) 引入即坏——投稿按钮上线以来一直 500。修复=审计挪进 with 块改 _audit(cur,...) 原子化(删显式 commit);横向扫描确认全文件唯一误用;快照 backups/code-2026-10-01/api.tar 重打 → build → force-recreate api;修后 sb1 三断言(响应/落库 6 字段/审计串)全绿引擎 run(真跑,与每日 05:40 cron 同函数) resp keys {by_brand,run_date,total};幂等预清理不触碰引擎行,run 放 fake 建议之前避免当日 DELETE 误删optlog 人工反馈四态 fake 行 id=max+1000000(表无 id default)reason='p2w5-log';DISMISSED/EXECUTED/NOT_DO/WATCHING 四态全验 + 非法态 400 串精确 + 404 f"log {id} not found" + 落库 4 字段(user_status/user_feedback/时间戳 t/feedback_by=1)+ audit ads.optlog.feedback f"#{id} EXECUTED"decision 三态+否词同步 accepted→ads_recommendations 状态/备注/时间戳 + negative_keyword 建议自动同步 neg_keywords(match_type 硬码 negativeExact/origin='accepted'/status active/note 承接);再 rejected→否词翻转 rejected(同步双向);modified 空 modified_action 400 "修改决策需填修改后的动作";非否词规则零同步;404 "建议不存在"否词 CRUD add:keyword/country strip 落库但 audit resource 记原始未 strip 词(' p2w5 neg词2 cc=US' 双空格)——观察项记台账;重复词 ON CONFLICT 同 id 冲突激活(200 原id,origin 仍 manual);空词/坏 match_type 422×2;PATCH 状态 200+audit f"id={nid} rejected"/无变更字段 400/404 "否词不存在";DELETE {ok:true}+audit keyword[:100]/再删 404rule-config 覆盖 POST brand=zipforce key=down_pct → 行落库 grp 承全局行('' 的 grp);audit f"zipforce/down_pct=0.25";DELETE query 参数 brand;再删幂等 ok:trueexecute 护栏矩阵 14 断言(全程零外呼——每条都停在 400/404,accepted+campaign+pause_campaign 可达外呼组合绝不构造) 链序实测:X-Idempotency-Key 16-128 正则 400 → confirmed+confirmation='EXECUTE_ADS_ACTION' 400 → 动作白名单 5 种 400 f"动作不在白名单: nuke_all" → 预算 (0,500] 400 → bid [0.02,10] 400 → 建议存在性 404 → platform!=amazon 400 "仅 amazon 平台可执行" → target_type 分派(campaign 级拒绝 keyword 动作 400/keyword 级仅 pause_keyword|update_bid/search_term 级 400 "暂不支持…走「否词库」留痕+后台手动")→ campaign 名缺 400 → pending 400 "请先「接受」该建议再执行" → executed_at 409 → advisory lock+重放表;channel_configured()=True 实测锚 → 501 分支不可达;终验 fake 建议 executed_at 全 NULL + 重放表 0 行(零外呼双保险)promotion 8 端点 tasks:建 7 字段(is_pinned t/created_by 1)+空动作 400+状态流转 pending→in_progress→done(空 note 保旧 CASE WHEN '')+未知状态 400+404+DELETE 幂等静默;channels:九态自由文本 status(fake 建 'p2w5渠道')audit f"{cid}: None->已投稿"→"已投稿->待投稿"+404 "渠道不存在";orders:建 6 字段+audit f"{channel} {amount}";approve 坏 action 400 "action=approve|reject"/approve 落 approved+approved_by+时间戳/再审批 409 "订单不存在或已审批"/reject 落 rejected;kol outreach:坏 kind 400 "kind=channel|site|high"+channel 类 400 "KOL 渠道表不支持外联状态(仅测评站/高优清单支持)"+site/high 两路 200 落库+audit f"{kind}:{id}->{status}"submission(缺陷②修复验证) product/channel strip、result 空兜 "待审"、orders None、note 截断;audit "p2w5渠道x <- p2w5品 result=待审 orders=None";空产品 400 "产品与渠道必填"upload preview 解析矩阵 12 断言 happy:rows_total/rows_dated/date_min/date_max/zip_member ''/detect.missing_required []+columns 8 键映射全等;自动检测(中文表头→noon/amazon);错标平台必填缺失 400 f"noon 必填列缺失: ['sku']";坏平台 400 "platform 须为 amazon|noon";坏国家 400 "country 只收 SA/AE";空文件/无数据行/缺 asin 400×3;zip 无 csv 400 "zip 内无 CSV/XLSX 文件";zip 损坏 400 "zip 文件损坏"(PK 头+garbage 字节);noon xlsx 文件名无日期段 400(容器内 openpyxl 生成真 xlsx)upload 错误矩阵+happy(队列零污染) 坏平台/坏国家/组合不支持 f"不支持的品牌×平台组合 audit-nope/amazon"/none 通道 f"fittingirls/noon 无此通道(fg 无 noon 站点)"/未启用品牌 f"品牌 X 不在本租户启用列表"/后缀 f"仅支持 .csv/.xlsx/.zip(收到 .txt)"/空文件/预览拦截 400×N;happy:job_id+落盘 /srv/uploads/1/ads-import/{job}_zipforce_amazon_p2w5_amz.csv+队行 7 字段+audit 入队串;pump 每分钟取队的解法=秒级 UPDATE status='error'+rm 落盘双保险(不误删用户历史:预清理 manual-recompute 条款已删,残留兜底交终态按 id 删)recompute/reattribute recompute:坏平台 400+queued 行(kind=recompute/filename ''/size 0/detail.reason='manual-recompute')+audit;reattribute:onno/7d 先镜像后断言(ads_sku_updated/amazon_ads_updated=镜像 count 全等)+days=3 clamp→7 验证+audit f"brand=onno days=7: sku=N amz=M"虚惊排除(复合 PK 多租户播种) promotion_review_sites(1035=345×3)/kol_high(195=65×3)/kol_channels(3459=1153×3) 每租户一套同 id 行——PK=(tenant_id,id) 复合+RLS tenant_isolation 齐备+实测 API 只改 tenant_id=1 行;psql 直查断言必须加 tenant_id=1 过滤(saas_admin 绕 RLS 见全租户)portal_app 权限横向扫描 33 表四权缺一清单中唯 ads_rule_config 实锤(已修);观察项待后续波实证:aplus_history(no U/D)、listing_backend_keywords/listing_events/listing_specs(no D)、keepa_pull_log(no SELECT)、noon_daily_finance(全无——走 sync_mercury 另角色?);事件表与只读引用表为故意镜像 bug 分类学 ㊱(累计 36) psql -t 模式 INSERT..RETURNING 值行后附 "INSERT 0 1" 命令标签(同记录 \n 分隔)→ 取首段首行;NULL 在 -t 渲染空串(期望 '' 非 None);promotion_orders.approved_by 列默认 ''(IS NULL='f');float8 ::float8 经 JSON 返回数字但 psql 拆分串永远字符串(期望 "12.5" 非 12.5);grep -ci 零匹配输出 '0' 非空串P4 台账新增 ⑤ neg_keywords audit resource 记原始未 strip 词(含首尾空格)——审计可读性小缺陷仅备注;⑥ decision/run 两写操作无 audit 落笔(观察,与 D批审计补全方向相反——待拍板是否补);⑦ portal_app 权限观察清单(上条)待 listing/aplus 波实证dashboard_audit 月界项处置披露 W4 挂账④(zf 10 月 revenue NULL → kpi=0 vs full=None)本轮仍撞:工具侧把跨页比较器 None≈0 归一(数值漂移仍 FAIL,仅 NULL 展示免疫——每月 1 号必撞的假阳性);生产渲染口径分歧(kpi 0/full None)仍待拍板未动生产代码;数据层已验证非断流(每日金额渐进回填常态:09-30 56/87、10-01 6/28)回归与铁律 两缺陷自主修复(非口径类):快照→修码→build→force-recreate api;纯 api 改动无 web 改动免截图;W5 脚本 _audit_buttons_w5.py 126 断言 0 FAIL ×2 轮收口(三轮连续全绿);deploy_gate --quick 全绿(pen_tests/audit_nodes/pipe_audit/chart_value/dashboard_audit FAIL 0)+ 页面码一致性 111 PASS;终态八查复原(否词/建议/日志/任务/渠道/订单/投稿/导入队+重放行+规则覆盖+外联状态+落盘文件全清)进度 P2 已闭 5 波(62 写端点+MCP 协议);余量 ~57 写端点:listing 13、projects/pm+reports/defs+verdicts、aplus+collab、ai.py 7(LLM token 另批)、billing(Stripe 待拍板)、Keepa 9 外呼(配额内另批)、po_pdf regen+mail SMTP(待拍板)、auth 敏感写(待拍板)POST /api/logistics/shipments/import:未登记品牌行 INSERT logistics_shipments 触发 InsufficientPrivilege→裸 500——修复=预查 tenant_brands active 集,未登记行跳过(imported/skipped 如实分账);② POST /api/mapping/edit 同型(sku_mapping/products 均 brand 隔离)——修复=body.brand 未登记→400 "品牌未登记或不属于当前租户: X" + 行级品牌覆盖未登记→跳过该行。快照 backups/code-2026-10-01/api.tar → build api → force-recreate api/worker;两分支均实测通过(未登记 query 品牌 imported=0 skipped=1 零落库 / 未登记 body.brand 400 / mixed 行级兜底 imported=1)inv 单据引擎(六单型·移动加权均价全数学链,源码通读后预排被证伪两次再定案) X@审计仓A:GRN10@2.5→(10.00,2.5000,25.00);GRN10@4.5→加权均价 (25+45)/20=(20.00,3.5000,70.00);OUT5 按均价出→(15.00,3.5000,52.50);GRN5@0 零成本只加量 avg/tot 冻结→(20.00,3.5000,52.50);ADJUST-3 报损→(17.00,…,42.00);TRANSFER7→双腿 wa(10.00,…,17.50)+wb 新行(7.00,3.5000,24.50);STOCKTAKE 实盘8(账10)→(8.00,…,10.50)+count_qty 账面回写 "10.00"+流水差异行(-2.00);库存不足回滚:approve 400 f"库存不足: {sku} 账面 8.00 需出 999.0"→留草稿+零流水(事务原子);红冲=cancel _ledger(-net,0) 零成本只还量:OUT 红冲后 (13.00,3.5000,10.50)(值不动);重复过账 400 "单据已已过账, 不能重复过账"/再取消 400 "单据已取消"/草稿直取消无红冲流水/未知类型 400/空物料 400/调拨无目标 400/qty≤0 422/404 全矩阵;wa 流水 8 行链 qty_after 全等;doc_no=GRN-261001-hex3 格式断言inv 仓库/产品 POST wh:code lower→upper 落库/kind=transit/platform ''/enabled t + audit inv.wh.create;重码 409 "仓库代码已存在"/必填 400;products upsert 整包更新(standard_cost (12,4)→"1.5000"/reorder_* (12,2)→"5.00")+ audit inv.product.upsertlogistics 运单 CSV 导入:15 列中英别名映射+空列覆盖+badge 关键词归类(已签收→DELIVERED/运输中→TRANSIT/空→INF)+weight "1.25" 无 scale 原样+(brand,awb) UPSERT 幂等(重导 city/weight/ship_date 更新+badge 重归 INF);缺运单号列 400/空文件 400;㊵ taxonomy:FastAPI multipart 端点裸 str="" 参数是 query 参数——-F brand=x 表单字段被静默忽略必须 ?brand=x(前端 logistics/page.tsx:65 实证走 query;改端点签名前先查前端调用方式);params 保存:已知键合并/未知键弃/地址簿整替/增量合并他键留 + audit logistics.params.save;create dry_run(0.12×10=1.2+默认地址簿)+未知产品/零数量/坏数量 400×3+外呼路径零执行(audit 无 logistics.create);真实 Vnlin 下单外呼不测(待拍板)ops mapping import:CSV(utf-8-sig)+XLSX(容器内 openpyxl 生成→服务端解析)双路 count/行值;save:先删后插事务+空 SKU 行跳过+数值列 str→float 转换+空键 ''(非 NULL,冲突键判重语义)+note 恒有基础串"单次保存上限 2000 行"+级联 products(price 0/cost_rmb)+inv_products(standard_cost) ON CONFLICT 不动+audit 串精确;测试须用登记型品牌(tenant_brands 预插 auditp2-w4m/收尾撤销)——修复后未登记 body.brand 直接 400 进不了写路径;分支替换大小写敏感:platform 'amazon'≠'Amazon'(真实分支 Amazon 155 行毫发无损——验证调用用小写意外免于整分支误删,语义记入台账)镜像 bug 分类学 ㊵(累计 35) multipart 裸 str 参数=query;另:Decimal %g 保留尾零("8.00"/"999.0"——消息断言须逐字符);products.price/cost 实为 (x,2)→"0.00"/"12.50"、inv_products.standard_cost (12,4)→"12.5000"(㉝ 补充:sku_mapping.cost_rmb 无 scale "12.5" 是另表)P4 台账新增 ③ logistics_params 2026-09-06 冒烟残留写入生产租户(remark=smoke_test/contact=Zhang San/mobile=+8613800000000——audit_log 全史唯一一次 params.save;保留未动待用户拍板重置);本审计 lp1/lp2 污染 3 键已按最忠实证据复原为默认值(cityName=Riyadh/serviceCode=shuangqing/addresses=[]);④ dashboard_audit 跨页门 10 月月界 FAIL:zf 10 月 6 单 revenue 全 NULL(新单未结算)→kpi=0 vs full=None 均为"尚无收入"纯表示差异,与波④改动无关(该检查只涉 finance/kpi),是否把 base=None 视作空月待拍板回归与铁律 api 两处缺陷自主修复(非口径类):快照→build→force-recreate api/worker→双分支实测;纯 api 改动无 web 改动免截图;deploy_gate --quick:pen_tests ALL PASS/audit_nodes/pipe_audit/chart_value 全绿,dashboard_audit 仅上述月界项(挂账非回归);W4 脚本 _audit_buttons_w4.py 82 断言×2 轮 0 FAIL(pw4_run1/run2.log 各 12s);终态六查复原(仓集/物流参数/单据流水余额链/运单映射产品库存主数据/测试品牌全清)进度 P2 已闭 4 波(37 写端点+MCP 协议);余量 ~84 写端点:ads 写+promotion 写、listing 13、projects/pm+reports+verdicts、aplus+collab、ai.py 7(LLM token 另批)、billing(Stripe 待拍板)、Keepa 9 外呼(配额内另批)、po_pdf regen+mail SMTP(待拍板)、auth 敏感写(待拍板){US}/{US,DE} 花括号形态(非 JSON 数组);㉟ jsonb 列落库后键序归一化(按长度+字节序重排)——比对必须 json.loads 后比 parse 树,逐字节比 json.dumps 输出必炸;另:多 count(*) 拼接必须逐个 ::text(bigint||bigint 无算子,W2 同型再犯);EmailStr 拒收保留 TLD(.test)——测试账号须用真实形态域名;mask/order 类预期先转写源函数再算勿凭语义猜P4 台账新增 ① 重复邮箱创建=500(应映射 409 友好提示);② "不能删除 owner 账号"分支 API 不可达(单 owner 租户+self 检查先行)——仅备注不修回归与铁律 纯写路径审计无 web/api 改动(零缺陷零修复;500/不可达两项按现值断言并记台账)免截图免 build;两轮 0 FAIL×2 收口(pw3_run1/run2.log 各 19s)进度 P2 已闭 3 波(27 写端点+MCP 协议);余量 ~91 写端点POST /api/sourcing/watch:新关注行 8 字段断言(tenant/domain/asin/title/img_url/source='manual'/keyword/created_by + alert 默认值 alert_price 空·alert_dir 列默认 'below'·alert_active f)+ Keepa 即时拉取副作用(keepa_pull_log ("watch",1,1,ASIN) + redis keepa:lastleft 刷新)+ audit_log ("sourcing.watch","1:ASIN");重复 POST=ON CONFLICT 同 id 更新 title 不加行;422 三变体(小写 asin/短 asin/domain=12 越界)。POST /watch/alert:设价 99.5+above → 响应四字段全等 + DB(numeric 渲染 "99.50"/above/t);400×3(价 0→"目标价必须 > 0"/负价/dir=up→"方向只支持 below/above")+ 404("关注行不存在")+ 失败不改行;清提醒(price=None)→ alert_active=f 响应仍带历史值。DELETE /watch/{wid}:{deleted:1}→行删→再删 {deleted:0}→伪 id {deleted:0}→行集复原全等⚠ P4 台账新增(口径缺口,待拍板,未动代码) POST /watch(sourcing.py L586)与 GET /explorer 空词回填(L1189)不经 _keepa_quota 配额门却真实消耗 Keepa token(watch-add 实测 keepa_product 拉取成功而 redis keepaq:zipforce:{date} 增量为 0);其余 11+ 交互路径(search/keepa-history/deals/lightning/seller-finder/topsellers/keepa-graph/finder/enrich/price-history live/seller-lookup live/explore live)均已设门。是否补门属计费口径,待拍板;波① 镜像按现状断言(配额增量=0)波② PO+供应商全生命周期(_audit_buttons_w2.py,51 断言) POST /po/suppliers:建供 6 字段(email 空串→NULL)+ 重名 409 "供应商已存在";POST /po/create:po_no=PO-261001-{pid:04d} 格式断言 + 头 7 字段 + items qty≤0 全跳过(4 行入参→2 行落库)+ unit_cost None 兜 0 + audit ("po.create","po_no=… items=4"——items 计数=入参非落库) + 空 items 400 "PO 至少一行物料";PUT /po/{pid}:草稿更新=头字段+items DELETE 重插(id 变,重新取)+ total 重算 + 非草稿 400 "仅草稿可编辑";POST /status 流转矩阵:draft→confirmed 400 "非法流转: 草稿 → 已确认" / 未知状态 400 / 404 / draft→submitted→draft 回退→再 submitted(双向均验)+ 非法流转与 404 均不写 audit;submitted→confirmed=盖章副作用三查:pdf_path 回写 /srv/po_docs/{po_no}.pdf + 容器内文件实存 + mail_status='skipped'/mail_to=''(供应商无邮箱路径,真 SMTP 发送待拍板后验);confirmed→in_transit;POST /receive 两次:部分收货(4/12 → status 仍 in_transit + 自动 GRN#1:inv_doc_heads(GRN/approved/ref_no=po_no/ref_id=pid/doc_date=今日/remark="PO 收货自动入库"/create_by=0) + inv_doc_items(A×4))→ 收满(99 钳 12=least() / B×5 → status received + GRN#2(A×8+B×5) + inv_stock_ledger 汇总 A:12×2 笔/B:5×1 笔 + inv_products 两 SKU 落库);audit 轨迹十连全等(po.create→5×po.status→po.receive+inv.doc.auto_grn×2 交替——receive 审计先于 auto_grn);终态拒绝:received 再收 400 "仅已确认/在途 PO 可收货"、received 删 400 "仅草稿/已取消可删除"、伪 pid 404 "PO 不存在";DELETE /po/suppliers/{sid}:有 PO 409 "供应商仍有未取消 PO, 不能删除" → 管理员清理 PO/GRN/ledger/products/PDF 后删 200 → 幂等再删 200(源码无 not-found 检查,按现状断言);终态复原四查(供应商名集全等/MAIN 仓未重复新建/无残留测试 SKU/PO 链三计数 000)镜像 bug 分类学 +1(㉝ 累计 33) 列类型决定 ::text 渲染:purchase_orders.total_cost_rmb 与 items.unit_cost_rmb 是 float("25.0"/"2.5" 无补零),inv_doc_items.qty 是 numeric("4.00" 补零)——断言前先查 information_schema 的数值列类型,勿凭语义猜补零;另 psql count(*)||count(*) 触发 bigint||bigint 无算子(须 ::text 先转);写测试重跑幂等=以业务前缀(notes LIKE 'p2w2%')+专用 SKU 圈定自身链路预清理回归与铁律 纯写路径审计无 web/api 改动(零缺陷零修复;配额缺口按铁律记录待拍板不动代码)免截图免 build;两轮 0 FAIL×2 收口(pw1_run1/run2.log、pw2_run1/run2.log)进度 P2 已闭 2 波(sourcing watch + PO 族 10 写端点);余量 ~107 写端点:settings/org/layout/onboarding、inv+logistics+ops-mapping、ads+promotion、listing 13、projects/pm+reports+verdicts、aplus+collab、ai.py 7(LLM token 成本另批)、billing(Stripe 待拍板)、Keepa 9 外呼 GET + live 两路(配额预算内另批)、po_mail SMTP 全路(待拍板)、auth 敏感写(logout-all/password/register/resend 待拍板)GET /api/po/3/pdf pp1 首次调=惰性生成路径(设计内写:生成 /srv/po_docs/PO-260906-0003.pdf+回写 pdf_path)——形态四查 %PDF 前缀/%%EOF 尾/Content-Type=application/pdf/Content-Disposition=attachment filename/content-length=字节数+分页模拟(A4 高 841.89、table_y 起点 H-185-55、表头 24、行 22、<160 换页 H-60——正则 /Type/Page 计数 1==1)+pdf_path 回写值+容器内文件存在;pp2 二次调=同文件字节全等(FileResponse 直读磁盘);pp3 独立镜像喂数再生比对——psql 独立读 _load_po 同口径(po_no/日期/供应商/联系人/备注/total/items sku+brand拼接+qty+unit_cost,RLS=tenant_id='1')→ JSON 注入容器内生产 gen_po_pdf 重渲染 → /CreationDate /ModDate /ID 归一化后与线上服务字节全等(证明 API 的 DB 读取==镜像读取且渲染确定性);pp4 大写金额 total_upper 10 例 KAT(45000→肆万伍仟元整、45000.50→肆万伍仟元伍角、0.05→元伍角零分支、1e9+ 级)+_font_num 6 例(含 None→'0'、'x'→'x' 兜底)镜像转写 vs 生产函数逐一相等+本单 0.0→零元整;pp5 pid=999999→404 {"detail":"PO 不存在"};pp6 pid=abc→422方法论备注 PDF 无 JSON 可比对 → 改「独立数据镜像+生产渲染器+归一化字节比对」三明治;WQY TTF 子集编码致内容流不可直读文本,数据正确性由字节全等传递证明;首轮惰性生成/次轮文件直读两分支在 run1/run2 各覆盖一次本轮零 API 缺陷(32 断言首跑即全绿)P2 移交 POST /api/po/{pid}/pdf(重生成+audit)、POST /api/po/{pid}/mail(SMTP 全路:无邮箱 skipped/未配置 skipped/发送 sent/失败 failed:原因 回写)、generate_and_maybe_mail 确认钩子回归与铁律 纯数据审计无 web/api 改动免截图免 build;两轮 0 FAIL×2 收口(pv16_run1/run2.log)🏁 P1 总收官:15 波全闭 全部只读 GET 端点完成「独立重算」验证(镜像=psql 独立路径→Python 重聚合→键控逐字段比对),累计断言 15 万+、发现并修复 API 缺陷与口径分叉均已在各波条目记录;镜像 bug 分类学 ㉚㉛㉜ 等共 32 条沉淀于 memory-longterm §47~§56。下一步 P2 每个按钮交互验证(写端点+外呼+live 路径清单已在各波移交栏汇总)/api/sourcing/watchlist(items 21 字段含 7 日 trend json_agg+LATERAL 最新快照+quota=redis keepaq:zipforce:{今日}+keepa_configured=/run/secrets 探测)+ price-history ×3(local 路 B000PCWKBA 全序列 13 series 抽稀 3000 点复刻——先 DEL redis pview 键锁 cached=False、立即重调验 cached=True+setex 21600 语义;none 路 B09P1G2952 未采集 hint 兜底)+ sellers/top ×2(默认 50/limit=5——wins 聚合+array_agg[1:3]+seller_full DISTINCT ON 补档案)+ seller-lookup ×3(ID 命中 30 字段+pool wins / ID 未入库 found=false+hint / 名字 ILIKE matches 20 条含 category_stats catId→显示组标签翻译)+ explorer ×2(bra 12 月/mechanical keyboard 3 月——timeline/turnover/rotation/cross 中位数/brand·manufacturer·category 三计数全 Python 重聚合)+ explore/fields ×2(all/pool——18 组 145 字段+9 枚举列 DISTINCT≤30+类目标签频次多数派+「等N组」)+ explore GET ×2+POST ×2(默认 8 列/pool+sort=asin/conds eq·ge·like 多值#分隔+坏条件 dropped 注记+exclude NOT ILIKE+批量 ASIN 去重)+ explore/export CSV(BOM+头 X-Total-Rows/X-Export-Rows/attachment 文件名逐字节)+ category-tree(两级树+unclassified+roots 按 count 排序)+ aba/overview(countries/terms/meta)+ aba/chart ×2(6 月/36 月——轻量 keepa 15 字段版)+ aba/ledger ×3(默认 30/term=bra+covered/asin=B0+missing 第 2 页——seats UNION ALL 三槽位 CTE 全转写)+ radar ×2(US 30/DE 10+offset——五榜单 rising·frag·gem·basket·repeat 各自 ORDER+LIMIT)——独立路径=psql→Python 重聚合,键控逐字段(items 键=id、sellers/matches 键=seller_id、rotation 键=asin、roots 键=id…)RLS 落地要点 aba_keepa_full/aba_seller_full/aba_search_terms/aba_meta/aba_country_catalog/aba_radar_五表/keepa_watch = tenant_id='1';keepa_daily = watch_isolation(镜像 EXISTS 关注对子查询,trend 与 LATERAL 两处);keepa_csv_series(int,text) 为 SECURITY DEFINER——镜像直调与管理员同果本轮零 API 缺陷;镜像 bug 分类学新增三条 ㉚ psql 布尔 ::text 输出 "true"/"false" 而非 "t"/"f"——null 探针 `IS NOT NULL::text` 判断须兼容两种;㉛ psql -tA 把 NULL 文本打印为空串——一切可空文本列须 NU() chr(2) 哨兵包装,且 ① 哨兵必须 Python 侧调用(f-string 里 {NU('x')}、列表片段里 NU("x"),绝不能当 SQL 字面文本嵌入)② 读回必须 nz() 反映射(radar basket cp_asin 漏映射当场翻车)③ fnum/fint 须 None 安全(转换幂等);㉜ subprocess text=True 通用换行翻译会把响应体里的 \r\n 洗成 \n——CSV 等原始体捕获必须 text=False+手动 decode(ep1 首轮 api=\n vs db=\r\n 假 FAIL,API 源码 csv.writer 默认 \r\n 本无误);另 sl3 名字模式 category_stats 须用已解析值再 _translate_cats(传原始 JSON 字符串为 no-op)、urlencode(str) 须 quote_plus——均为镜像自伤外呼旁路规避(全程零 Keepa/Dell 实调) 变体词全部选库内 Keepa 全覆盖词(断言 missing=[] 防回填写库);price-history 仅 live=0;explore keepa_live 按构造恒空;探索排序用 sort=asin 锁序分支覆盖限制(如实记录) price-history watch≠None 分支在当前数据不可达——已关注 ASIN B09P1G2952/B0CTZHY9D7 在 keepa_product_raw 无行,库内无「已关注且有本地序列」样本,该分支留 P2 live 路一并验P4 台账新增 sourcing.py L1054 sourcing_product 函数体完整但无 @router 装饰器=死代码(不修,待 P4 台账统一处置)P2 移交(非只读/外呼) 9 个 Keepa 外呼 GET:search/keepa-history/deals/lightning/seller-finder/topsellers/keepa-graph/finder/enrich;3 个写端点:POST watch、DELETE watch/{wid}、POST watch/alert;live=1 两路(price-history/seller-lookup);explorer/explore 无行词兜底(Dell live 回填)回归与铁律 纯数据审计无 web/api 改动(零缺陷零修复)免截图免 build;两轮 0 FAIL×2 收口(pv15_run1/run2.log,各 38/39s)进度 P1 已闭 14 波;余量:po_pdf.py /api/po/{pid}/pdf(PDF 响应形态)——续审中/api/promotion/channels ×3(默认/类型+国家+搜索 page_size=50/fit=bra 评分≥1+sort=activity+page=2——20 字段含 fits 列表=five fit_* 0-3 评分≥1 的有序键、activity round1、last_checked 取日期、PROMO_SORTS 四排序键)+ /api/promotion/summary(KPI 三指标+by_status+类型×层级分布+国家 TOP10+facets 四轴 DISTINCT+products 11 字段+近 7 日采集统计 promotion_crawl_stats date_trunc 日聚合——8 个子查询全转写)+ /api/promotion/tasks(状态 CASE 排序 in_progress→blocked→其余+id、status_cn 映射、stats 三计数)+ /api/promotion/orders(100 条新→旧,amount float 兜 0)+ /api/promotion/kol ×4(channel 默认+platform/q 过滤/site/high 三库——text[] 数组经 array_to_json(coalesce(…,'{}')) 取回,空数组与 NULL 同归 []→API 的 or["?"] 兜底语义)+ /api/promotion/kol-analysis(纯 Python 重聚合全转写:互动率=(均赞+均评)/均播%、平台表 avg_subs/total_subs/engagement/pct_100k、量级四档 tier_of、品类/国家数组展开聚合,round 半偶数舍入逐值复刻)+ /api/promotion/submissions(100 条)——独立路径=psql→Python 重聚合,键控逐字段(channels 键=name、kol 三库键=id、分析四表键=分组名)RLS 落地要点 promotion_channels/kol_channels/kol_high/review_sites/products/tasks/orders/submissions 八表=tenant_id='1';promotion_crawl_stats 无租户列无 RLS=平台级裸读(与源注释一致)本轮零 API 缺陷;镜像 bug 分类学 ㉖ 第二次命中(修正其适用范围) ① NU 包装会让 ORDER BY 裸列名绑到输出文本表达式——EXPLAIN 实证 Sort Key=CASE…::text(文本序 '9900000'>'9848'>'984000'),kol top-50 全错位;channels 同型隐患(pc1-3 通过纯属 follower 值位数巧合)。修正认知:㉖ 不止 wave-10 的"无别名表达式"场景——凡 SELECT 列表含 CASE/NU 表达式覆盖列 X,ORDER BY X 即绑输出表达式,一律表限定(c./k./w.)排序键;② text[] 取回用 array_to_json 而非 ::text 拆 {}(带引号/逗号元素会拆错);③ NU 哨兵 chr(2) 必须 nz() 反映射后再 or ""(哨兵字符串本身为真值)正面观察(不动代码) channels 的 fit_* 评分≥1 口径(2026-09-17 P0 修复在位);kol-analysis Python 侧聚合与 API 逐值全等(含 round 半偶数边界);爬虫统计按平台级共享(无租户泄漏面)P2 移交(非只读) POST tasks/submission/orders+approve、PUT tasks/{tid}/status、DELETE tasks/{tid}、channels/{cid}/status、POST kol/{kind}/{kid}/outreach回归与铁律 纯数据审计无 web/api 改动(零缺陷零修复)免截图免 build;两轮 0 FAIL×2 收口(pv14_run1/run2.log)进度 P1 已闭 13 波;余量:sourcing.py 19 GET(分拣 DB-backed vs Keepa 外呼)、po_pdf.py——续审中GET /api/reports/fields(白名单字面量 11 维×31 度量全标签逐值——5 域 domains 结构 daily/stock/rank/noon_daily/noon)+ GET /api/reports/defs ×2(全量/page=dashboard 过滤——config jsonb 深比对,RLS 租户隔离=tenant_id)+ POST /api/reports/query ×14(只读报表引擎全模式转写:DAILY 宽表模式×3——订单侧 amazon_orders 排 Canceled/Cancelled 与广告侧 cleaned_ads_sku_daily+cleaned_amazon_ads_daily UNION ALL 子聚合再外聚合、FULL JOIN ON brand+country+day、o./a. 前缀替换链含 commission 的 round(abs(o.commission),2)、派生比率先聚后除 acos/tacos/cpc/ctr/cvr/aov 逐值、days 窗 CURRENT_DATE-N、country 仅 [A-Z]{2} 白名单;ADSKU 逐 SKU×2(coalesce(sku,'')<>'' 排 campaign 级行);ORDSTATUS 订单状态×1(含取消单的状态分布+ORDMETS 白名单);ADTERMS 广告词维×2(campaign/term 各一,dk 别名);stock 库存×2(inventory_health,qty=sum(total_qty)+stock_days=avg;brand/country 筛选级联 marketplace);rank 排名×1(rankings_daily 120 天窗,rating/reviews/bsr 均值);noon_daily×1(cleaned_noon_orders 92 天窗写死,noon_orders=count(DISTINCT order_nr));noon 状态月报×1(noon_sku_status s LEFT JOIN noon_sku_pl_monthly p,refund_units=round(sum(coalesce(p.refund,0)),0)+valid_units 走 p 侧+其余 sum(s. 前缀替换——delivered=sum(s.units)-sum(s.cancelled)-sum(s.undeliverable) 复合表达式);优雅降级×1(dims=[sku]×metrics=[orders] 撞单侧守卫→rows=[]+note"该图表暂不可计算: SKU 维度(广告侧逐 SKU)仅支持广告指标…"))+ POST /api/reports/landed-cost ×2(纯计算器零 DB:DE 海运体积重 max(45, 0.2×167)=45、MX 空运 chargeable=max(5, 8.35)=8.35 体积重胜出——LANDED_RATES 19 国+FREIGHT_RATES 三档+VAT 仅 11 国基数=货值+头程+关税,input/breakdown/landed_cost_usd/landed_cost_pct 全字段逐值)+ GET /api/reports/backend-keywords/{sku} ×2(真 SKU 最新行/不存在 SKU→keywords="")——独立路径=引擎 SQL 逐行转写(参数内联+RLS 手工落地)psql 执行→Python 重聚合,键控比对(维度组=唯一键)RLS 落地要点 amazon_orders/ads_search_terms_daily/inventory_health/rankings_daily/noon_sku_status/noon_sku_pl_monthly 及 audit.cleaned_*=AB;noon 域 LEFT JOIN 的 p 侧 AB 写进 ON 子句(波⑪确立的同型规则复用);report_defs/listing_backend_keywords=tenant_id='1'本轮零 API 缺陷;镜像 bug 修复 3 处 ① 广告 UNION 外层引用列名=子查询一别名集(sub2 无别名→列名取 sub1 的 sales,外层必须 sum(sales) ad_sales,误写 sum(ad_sales) 即 UndefinedColumn——UNION ALL 列名绑定规则的转写陷阱);② urlencode 双前缀(?page=+urlencode('page=…')→page=page=dashboard,API 对乱值正确返回 [],镜像侧拼 URL 低级错);③ ORDER BY 1(首维)在首维同值组内行序非确定(㉘/㉙ 第三次命中:rq5 brand+sku 按 brand 排序、组内 sku 序=计划形状任意,参数化 vs 内联字面量计划不同)→ 报表引擎返回行一律键控比对(GROUP BY 维度组=唯一键,值逐键全对)口径正面观察(不动代码) 引擎全模式比率先聚后除(口径铁律达成);ADSKU/ORDSTATUS/ADTERMS 单侧源守卫+400 白名单=不显示误导性 0 的落地范本;ads 双源拆分(sku_daily 非 onno+amazon_ads_daily onno)防 EU 双计(2026-09-29 级联在位);DAILY 的 commission 用 abs() 防退款月负值颠倒P2 移交(非只读) POST /api/reports/defs 建档(_validate 严格 400+同域门防死图)、DELETE /api/reports/defs/{rid}、PUT /api/reports/backend-keywords/{sku}(250 字节限额+upsert)回归与铁律 纯数据审计无 web/api 改动(零缺陷零修复)免截图免 build;两轮 0 FAIL×2 收口(pv13_run1/run2.log)进度 P1 已闭 12 波;余量:ads.py promotion 子端点(7 GET)、sourcing.py 19 GET(分拣 DB-backed vs Keepa 外呼)、po_pdf.py——续审中/api/orders ×5(默认/status 状态过滤+page_size=50/days=7+订单号搜索/frm-to 自定义区间(北京日切 10 天窗)/brand=onno+country=US——by_status 聚合+summary 三拼写排除 Canceled/Cancelled/cancelled+aov 逐值+items 18 字段含 GB→UK marketplace JOIN 币种兜底链 nullif(currency,'')→mp.currency→'USD'、is_prime/is_abnormal 布尔、local_amount/revenue NULL 语义、days 窗 N 自然日含界 days-1 偏移、frm/to 非法输入静默清空+优先级压 days)+ /api/mapping/edit ×3(缺参 400 brand 与 platform 必填/zipforce+amazon 全量/onno+noon——information_schema 动态列集(除 id)全类型变换 isoformat/Decimal→float/布尔,56 组 (brand,sku) 重复行序不稳定 → 排序 JSON 多重集比对)+ /api/logistics/shipments ×3(默认/badge+运单号搜索/brand=onno——KPI 实时聚合 8 指标 含 stage_overdue+as_of=max(coalesce(nullif(latest_event_time,''),ship_date::text))、by_badge 聚合(仅 brand 过滤不受 badge/search 影响)、items 18 字段含 traces jsonb 逐轨迹 time/st/desc/loc 四键兜底、total=0 时 stats=None 结构语义)+ /api/logistics/products(19 型号字面量目录 code/name/weight/hs/value 逐值)+ /api/logistics/params(默认参数 24 键合并 logistics_params jsonb+空地址簿注入 addr_default 九字段兜底链+service_codes 7/platforms 5/transports 6)+ /api/logistics/pricing(yamwen_pricing.json 全文深比对)+ /api/logistics/appendix ×4(meta 模式 12 数据集 row_count LEFT JOIN 计数+extra jsonb/rows 模式无 q 30 行/rows 模式 q 白名单词过滤(\% \_ ' 转义 ILIKE)/未知数据集 404 unknown dataset: no_such_ds——镜像通道=同 db 容器 -d amazon_analytics 直查 shared.yanwen_appendix_*,与 API 的 qmercury 同库同实例)+ /api/matrix/dimensions ×2 + /api/matrix/data ×2(Amazon sku_list CROSS JOIN LATERAL unnest 平摊:n_sku=array_length greatest 1、units=coalesce(nullif(items_count,0),1)、净额=rev−commission−fba−promo−other 不扣 VAT、orders=int(round(sum(1.0/n_sku)))、margin=ROUND(净/收×100,1);Noon _noon_usd 锚定折算 SA→SAR/3.75、AE→AED/3.6725 独立转写)+ /api/matrix/charts ×2(revenue_trend 月度 {brand/amz,brand/noon} 双源混排含 Noon 按国家折 USD 累加 round2/profit_comparison 按国家 扣 f.vat(R16-P1) LIMIT 20/sku_distribution CTE+LATERAL 去重 SKU 数 LEFT JOIN/country_heatmap 扣 VAT LIMIT 20)+ /api/po/suppliers(open_pos 未取消 PO 子查询计数)+ /api/po/list ×2(summary 仅按 brand 过滤(不受 status/search 影响)的三字段逐状态/status+search 过滤翻页——18 字段含 status_cn 映射、total_cost_rmb NULL 语义、supplier_id/created_by 可 NULL(fint))+ /api/po/{pid} ×2(真单 18 字段头+items 8 字段/999999→404 PO 不存在)——独立路径=psql(-F\\x01 -R\\x03) 行级拉取→Python 重聚合,键控逐字段(by_status 键=status、items 键=订单号、by_badge 键=badge|label、船票键=brand|awb、矩阵键=平台|国家|品牌|SKU、PO 键=id)RLS 落地要点 audit.cleaned_amazon_orders/cleaned_noon_sku_pl_monthly=AB;cleaned_order_fees 的 AB 必须写进 LEFT JOIN ON 子句(写进 WHERE 会把外连接退化成内连接→正确性错误,非风格问题);logistics_shipments=AB;logistics_params/suppliers/purchase_orders/purchase_order_items=tenant_id='1';marketplaces=注册表裸读P4 新观察(口径/方向性,待拍板,不动代码) ① matrix/dimensions 的 skus 查询=DISTINCT ON (brand) 但无 ORDER BY 平局裁剪——注释意图"每品牌收入最高 SKU"完全未落地:算了 sum() OVER 窗口却从不按 rev 排序,返回任意代表 SKU;且 Sort 不稳定,同一角色两次执行/一次 analyze 或重启后选择可能漂移(实测 portal_app 复跑与 API 服不一致);② 同查询 trim() 只去空格,sku_list 以 ",\\n" 分隔的行会产出 "\\nZF230T0AEC" 这类带换行前缀的 SKU 值(本轮实测镜像侧命中 3 行),前端维度下拉可能显示脏值。修复方案已备:ORDER BY brand, rev DESC 双 CTE + btrim(sku, E' \\n\\r\\t')——因改变前端可见维度内容属方向性,待拍板后实施本轮零 API 缺陷;镜像 bug 分类学 +2(累计 ⑨+17) ㉘ 无 ORDER BY 的 DISTINCT/UNION 输出序=哈希序不稳定(platforms 四平台字面量顺序每次可变)→ 语义为集合时必须 sorted 比对;㉙ DISTINCT ON 无 ORDER BY = 行选择本身非确定(同角色同 SQL 两次执行可不同,Sort 不稳定+SRF 展开后平局任意)→ 唯一可靠验证=语义校验(返回值 ∈ 合法全集+双源各一),曾尝试 api 容器内以 portal_app+同会话变量复现执行计划仍漂移,证明非角色差而是不稳定排序本身;另:可空整型外键(supplier_id)须 fint 防 int('') 崩溃P2 移交(非只读) mapping/edit import+save(先删后插级联 products/inv_products+[:2000] 截断)、logistics shipments/import(CSV 列别名映射+(brand,awb) UPSERT)、params save、create(Vnlin OMS 两步+Redis 幂等锁 409)、po create/update/delete/status/suppliers 写端点、po_pdf回归与铁律 纯数据审计无 web/api 改动(本轮零缺陷零修复)故免截图免 build;两轮 0 FAIL×2 收口(pv12_run1/run2.log)进度 P1 已闭 11 波;余量:reports.py(fields/defs/backend-keywords 3 GET)、ads.py promotion 子端点(7 GET)、sourcing.py 19 GET(分拣 DB-backed vs Keepa 外呼,外呼归 P2)——续审中mapping/skus ×4(默认/平台+搜索/品牌+国家+page_size=50/翻页,by_platform 五列聚合+15 字段行级,AB 全程)+ documents/tree ×3(根 KPI+children 计数子查询+最热父目录+搜索"上架"路径 ILIKE 全量)+ mapping/api-fields ×3(181 表全量 columns jsonb 深比对+group 过滤+三列 search)+ upload/files(0 行结构)+ collab/files/1/raw(404 文件不存在)+ pipeline/status(22 表 UNION 逐表 RLS 落地:品牌表=AB、租户表=tenant_id、keepa_daily=EXISTS watch、audit.cleaned_*=AB;volume_drop 4 检查×2 管道逐行转写——brands_source 管道发现+北京日切 lag+7 日均窗+阈值地板 max(2, min(mindiff, 30%)),实测命中 2 条真跌水位;rank_markets CTE 全转写——停更+在榜萎缩双信号 f-string 精确匹配,4 市场含"在榜 3 ← 7日均 26.9";jobs 27 条字面量+external 2+as_of)+ pipeline/audit(最新批 144 项 4 层 rollup+8 日趋势,audit_results 无租户列=全租户共享审计批,裸读正确)+ db/tables(111 表含 pg_class reltuples 估算)+ db/table/{products,logistics_shipments} 详情(列元数据+默认值+RLS 下 count)+ users→403 敏感表 + 不存在表→404 + db/table/{t}/rows ×3(值变换逐列复刻:Decimal→float、timestamptz→isoformat[:19]、jsonb→json.dumps[:200]、double→round4;brand+search 过滤与 RLS AB 交集)+ dictionary(122 表 1,435 列全量:域分组+31 表描述+74 通用+86 专有列描述双源合并)+ glossary(md 解析器逐行转写+term_field_map sys 映射,全部词条深比对)——独立路径=psql→Python 重聚合,键控逐字段安全姿态正面观察(不动代码) API 连接角色 portal_app 的 information_schema 可见性=「任意权限」语义:keepa_pull_log 仅 INSERT 也列出;keepa_product_raw / keepa_seller_raw / noon_daily_finance 只授 saas_admin → db 浏览器与数据字典天然隐藏 3 张 raw 表(信息泄露面正确收窄);audit_results 无 tenant_id 但无敏感行(批次级校验结果),共享读无害本轮零 API 缺陷;镜像 bug 分类学 +3(累计 ⑨+15) ㉕ information_schema 视图 WHERE 中挂 has_table_privilege(text,…) 直接触发 relation "collations" does not exist——权限谓词必须走 pg_class JOIN + OID 变体 EXISTS 子查询;㉖ 无别名表达式 SELECT 列表下 ORDER BY 裸列名会绑到输出表达式(NU(id)::text 文本序 '9183'>'47951')而非源列——必须表限定 t0.col(EXPLAIN 证实);㉗ UNION ALL 中 NULL 字面量在 psql 输出与 '' 不可分——镜像侧须 ''→None 反映射(⑰ 的输出侧孪生);另 rank_markets/drops 外层无 ORDER BY 且镜像 WHERE 改变 CTE 输出序 → 键控比较(⑯ 复用)P2 移交(非只读) upload POST/DELETE、pipeline/run 触发、collab 写端点回归与铁律 纯数据审计无 web/api 改动(零缺陷零修复)免截图免 build;两轮 0 FAIL×2 收口进度 P1 已闭 10 波——collab 族全覆盖;余量:ops.py(mapping/edit、logistics、po、promotion 子端点、sourcing、matrix、reports)——续审中listing/meta(平台/站点/类目含 attr_schema jsonb 深比对 + 双品牌 model_numbers 全量 37 型号逐值)+ skus-by-model ×2(缺参 400 brand 与 model 必填 + ZF-430 45 SKU ×10 字段全量)+ listing/specs ×4(默认 20 行 + fittingirls 残留 5 行真数据 + brand=zipforce 空态 + sku 过滤)+ listing/tasks ×6(默认→仅 1 行 onno 任务/状态/平台空/品牌空/q 搜索/分页,含 products INNER JOIN+sku_mapping LATERAL 语义)+ tasks/{48,215} 详情 ×2(onno 48 = 全 25 列 + PT 类目 schema 路径 normalize_pt_schema 逐行复刻 + 最新规格书 raw_preview 2000 字 + 最近 10 事件;fittingirls 215 = RLS 边缘:products/sku_mapping/category_meta 不可见→product 字段空串、spec 按租户隔离可见)+ listing/events ×2(默认 50 行 detail jsonb 深比对 + task_id 过滤)+ listing/health ×3(9 维体检逻辑 Python 逐行复刻:销量/趋势/评分/评论/BSR/库存/退货/Keepa 价格/内容,默认 181 个 ASIN×SKU ×每维 status+val+note 共 6,796 断言,含 f-string note 精确匹配/BSR 千分位/周环比窗口 day BETWEEN/退货率上月分母/Keepa 关注池 EXISTS/watch_isolation/体检排序低分在前)+ pt-markets ×3(zipforce 7 市场 JP 跳过 + onno 4 市场 brand_markets 硬编码表独立转写 + 未知品牌 404 品牌不存在或无权访问: zzz)+ aplus/meta(amazon 19 国)+ aplus/media(0 行结构)+ aplus/documents ×2(空态+market 过滤)+ aplus/history(4 行,nullable status/ok NU 标记全过)——独立路径=psql 行级拉取→Python 重聚合;RLS 显式落地(sku_mapping/products/sales_daily/rankings_daily/inventory_health/amazon_refund_monthly/listing_category_meta=AB,listing_specs/tasks/events+aplus_*=tenant_id='1',keepa_daily=EXISTS keepa_watch,注册表三表=saas_admin 裸读与 _pool 同口径)P4 新观察(口径/方向性,待拍板,不动代码) tenant 1 名下残留 fittingirls 行:listing_specs 504 行全是 fittingirls(品牌已迁租户 3 且 tenant_brands 行 is_active=f)——listing_tasks 63 行同型;listing 两表仅 tenant_isolation 无品牌维度 → 租户 1 用户可 ?brand=fittingirls 查 specs、可打开任务 215 详情(任务标题/bullets/attrs/规格书可见,仅 product 三表字段被 AB RLS 置空);任务列表因 INNER JOIN products(AB) 天然挡住。非跨租户(行本就是租户 1 历史资产)但属跨品牌范围残留,处置(迁移租户 3 / 保留 / 清理)待拍板;另 pt-markets 的 _brand_ok 未校验 is_active(fittingirls 若调用会走 fg_amazon.json 返回市场表)同案记录本轮零 API 缺陷;镜像 bug 分类学 +3(累计 ⑨+12) ㉒ psql 文本/jsonb 字段含换行必须 -R chr(3) 记录分隔符(字段内换行保留、整输出末尾恒多一个 \n 只剥一个);㉓ NU() 的 ::text 把 boolean 打成 true/false 而非 t/f(tobool 双拼写);㉔ 宽表覆盖式索引转换表必须从 0 重数——dict(zip(TASK_COLS)) 本来正确,覆盖循环索引错位反而引入两处假缺陷(keywords 7→8、attrs 12→13),教训:先探测原始行再写转换表,不凭记忆数列P2 移交(非只读,本波不碰) listing/export(改任务状态→exported)、pt-search/pt-schema(SP-API 外呼 + redis 缓存 + 写 listing_category_meta)、其余 listing/aplus 写端点(specs 上传/任务增删改/审批/推送/媒体/草稿)回归与铁律 纯数据审计无 web/api 改动(本轮零缺陷零修复)故免截图免 build;两轮 0 FAIL×2 收口进度 P1 已闭 9 波——listing/aplus 只读族全覆盖;余量:collab(mapping/documents/dictionary)/ops mapping-edit/db/logistics/po/promotion 子端点/sourcing/matrix/glossary/reports——续审中inv/warehouses(2 仓库真实数据逐字段)+ inv/docs ×5(doc_type/status/search/brand/分页参数全组合)+ inv/docs/999999(404 形状 {"detail":"单据不存在"})+ inv/stocktake/plan ×2(真仓库 id + 不存在 id)+ inv/stock ×3(search/brand 过滤)+ inv/ledger ×2 + inv/products ×3(971 行真实数据,默认变体 500 行 ×8 字段全量比对)+ inv/report ×2 + /api/products ×5(默认 revenue/units 排序/brand+country/search+price 排序/margin 排序翻页,46 行真实数据含毛利公式 (price-cost*0.1471-0.12*price)/price 逐值重算)+ pm/products/pm/export/pm/products/{pid}(8 项目,首项目 48 任务全字段含 history jsonb 深比对)——独立路径=psql 行级拉取→Python 重聚合,键控逐字段;RLS 显式落地(products/sales_daily/sku_mapping=AB 激活品牌子查询,inv_*/pm_*=tenant_id='1')数据形态如实记录 tenant 1 的 inv 单据头/库存台账/库存余额全为 0 行(库存业务流未启用)→ dc/dd/sp/st/lg/rp 共 14 个变体为结构级验证(空响应形状、total/page/参数回显、404 语义全对);真实数据族=仓库 2 / inv 产品 971 / 产品 46 / PM 8——注意:这不代表库存模块「无数据即无风险」,结构级验证证明空态响应形状正确,P2 按钮验证阶段将覆盖写入端点本轮零 API 缺陷;5 类镜像 bug 全部在带起阶段歼灭(分类学累计 ⑨+11) ⑱ NU() 用于非文本列必须 ::text 统一转型(CASE 类型不匹配直接报错,好发现);⑲ NU 转型后 NULL 标记 chr(2) 与空串须统一 fnum/fint 解析(数值列 NULL/'' 可混同,文本列不可——沿用 ⑰);⑳ RLS 过滤必须落在每一张品牌隔离表引用上——products 主查询漏加 AB 时 total 膨胀 46→1034 而首页 20 行逐字段全对(零销量外品牌行恰好排在 revenue DESC 末尾)——教训入档:total 必须独立验证,首页全对≠过滤正确;㉑ pm 三个端点均不返回 created_at(list={id,name,start_date,task_count}, export/detail 无 created_at)——实际响应为准,代码通读推断的键集合不可信观察账维持不变 /api/products LATERAL LIMIT 1 sku_mapping 冲突组非确定性(3 组)本轮 5 变体页界未命中未触发;sku_mapping 56 组重复 (brand,sku) 待 P4 台账回归与铁律 纯数据审计无 web/api 改动(本轮零缺陷零修复)故免截图免 build;两轮 0 FAIL×2 收口进度 P1 已闭 8 波——inv/products/pm 家族全覆盖;余量:listing/aplus/mapping/db/dictionary/documents/logistics/po/promotion 子端点、sourcing/matrix/glossary/reports——续审中optlog(6 变体:状态/关键词 q/platform+brand/action/分页翻页)+ platform(7 变体:noon/amazon × brand/days/from-to 精确窗)+ search-terms(6 变体:默认/min_spend+waste 排序/平台/国家/精确月窗翻页/搜索词)+ keyword-bids(4 变体:默认/raise+spend/EXACT 14d/US 7d acos)+ dayparting(5 变体:默认/平台过滤/14d/brand+country/7d)+ recommendations(3 变体)+ neg-keywords + rule-config(默认/zipforce)+ imports + sources——独立路径=psql 行级拉取→Python 重聚合,键控逐字段比对;RLS 语义显式落地(品牌隔离表 AB 子查询 / ads_imports+neg_keywords tenant_id='1' / rule_config brand 空-or-AB)缺陷⑥(本轮唯一 API 真缺陷,两段修复史如实记录) search-terms?sort=waste 原 ORDER BY waste DESC, spend DESC 引用不存在的 waste 列 → HTTP 500(潜伏缺陷:web 排序选择器只提供 spend/sales/roas/clicks/term,UI 不触发)。第一段修复用 (CASE WHEN sales=0 AND spend>=20 THEN 0 ELSE 1 END) DESC, spend DESC——镜像比对当场打脸:CASE DESC 把非烧钱(1)排前面,与 waste 排序「烧钱词优先」意图相反(原 waste DESC 若是布尔列则 true=1 在前=烧钱在前);同日二次修 ASC 上线,st2 变体(min_spend=20+sort=waste+分页)逐字段验证烧钱词在前、同级花费降序,pen_tests ALL PASS。教训入档:修排序缺陷必须用数据验证序语义,不能只验证不再 500观察账翻案一则(更正前波记录) /api/ads/sources 曾记「未按租户品牌过滤(tenant 1 可见 fittingirls 行)」——实测 API 按 request.state.brand_scope(owner=租户激活品牌集,api/core.py:146-154)过滤返回 4 行不含 fittingirls,无跨租户泄漏,是审计镜像漏了该过滤;观察账撤销同名快照行现象(记录非缺陷) platform amazon campaigns UNION ad_campaigns 30 天快照表存在同 campaign_name 多行(G25 SP Auto 8 行 zipforce 不同 campaign_id),响应内 8 行同名不同值——是快照表多活动同名真实态,对比器按全字段多重集配对验证通过;前端表格按行渲染不受影响并列名次容差(ties=14 两轮同型) pf campaigns/skus 序(sum(spends) 并列)、st5 roas 序、kb items 页界并列(impact=0 大并列组 22 词)与 items 序(Python stable sort 等键)、recs by_rule 序(count 并列)——多重集键值等价+双侧单调即记 ties 不记 FAIL镜像 bug 分类学新增(防复发,累计 ⑨+6) ⑬ psql 文本字段不得 strip——前导空格活动名(' Luna Light auto')是独立分组;⑭ jsonb 列(suggested_action/detail)NU 须 col::text 再 json.loads;⑮ f-string 里四引号词法陷阱——brand/country 回显过滤必须写成 esc 后「空串短路 OR 等值」两分支(dp1-4 四处,写错则静默全零);⑯ PG 无序 GROUP BY 拉取序 vs Python dict 序——页界/任意并列须键多重集等价判,且 单调性检查方向要与 keyfn 升序约定一致(本轮曾写反致所有 tie 误判 FAIL);⑰ psql 空串混同 NULL——kb status 真有空串值并存 NULL 时须 NU() chr(2) 标记区分回归门 pen_tests ALL PASS ×2(两段修复各跑一次);无 web 改动(waste 排序 UI 不可达,选择器无该选项)故按铁律纯数据审计免截图;api 容器 build+up 两次进度 P1 已闭 7 波(品牌板/财务结算/广告排名库存促销/财务A/财务B/工作台全家/ads 子端点)——ads 家族至此全覆盖;余量:inv/*、products/pm/listing/aplus/mapping/db/dictionary/documents/logistics/po/promotion 子端点、sourcing/matrix/glossary/reports——续审中/api/dashboard/filters + /kpi(rolling 默认,amazon+noon 双腿) + /kpi-cards(GET,19 值池含双平台合并与 Pending 防御 margin/tacos=None 门) + /api/today(amazon+noon) + /merged-kpi(默认月) + /sku-sales + /api/orders——noon 腿全部逐国逐月键控复算(月表名册序=sum(gmv) DESC、rolling 覆盖 orders/units 走 noon_orders 30d 真窗、gmv/net 走 daily_finance、trend 12 月双源 pl+ads、kpi-cards 的 noon commission/fba/adsl abs-usd 并入「全部」);无新 API 缺陷,全家族值与镜像分毫一致(含 fees30 浮点逐位相同 15684.939999999995)波⑥B 品牌深析图表墙(11,667 点级断言 0 FAIL ×2,8 变体) /api/dashboard/charts 行级拉取订单全集(22 列)→Python 单遍聚合复算→每图每点键控比对(x 标签含「* 当日进行中」半日标、series 名序、逐点值、饼 name+value、sub 脚注、kpis 9 键、chart_count、range)——变体:agg90 全品牌聚合 / zf90 / onno30 / zf-SA60 国家窗 / onnoUS / zf 精确 frm-to 8 月窗(时间选择器三分支全覆盖)+ noon 墙 agg12 / onno mons6;Amazon 墙 86 图(销售 7/订单 18/财务 17/国家 24/SKU 6-8 条件图/链接 4)含费用 er=本币/USD营收 折算、结算派生 _SETTLED_ST、SKU 均摊 /_n、每日利润「结算中 null+脚注」_pend_days 规则、skuMargin/skuFeeRate 费用事件已到条件渲染;Noon 墙 15 图(8 项费用拆解 abs-usd、广告 daily 单源 F2-6、nTopSku 本币/nTopSkuTrend 折USD、nModelTop LATERAL 型号归并)——超越既有 chart_value_audit.py(仅 amz days=90 系列求和)并列名次容差器 排序图并列值时行序依赖订单拉取物理序,比对器实现 tie-equivalence 降级(数值+名册多重集等价即记 ties 不记 FAIL)——两轮 ties=0,全序稳定空窗分支 amazon 空=镜像精确匹配(brand/days/empty/groups/kpis/range,无 chart_count);noon 空=发现口径分叉:_noon_wall max_mon 锚查询只滤 brand 不滤 country → 无数据国家组合走「15 张空 x=[] 骨架图」而非空态结构(违 empty-state 初衷);UI 不可达(noon 下拉仅 SA/AE),且修法涉及月窗锚语义(品牌锚 vs 国家锚)→ 入拍板账未擅改镜像 bug 分类学新增(防复发,累计 ⑨+3) ⑨ coalesce 守卫必须双写 <>''(漏写编成 text 传入 OR 直接 psql 报错);⑩ psql 文本布尔 't'/'f' 均真值——has_finance 必须 =='t' 判;⑪ PG 数组字面量是花括号 {...} 非 json 方括号;⑫ 饼 series 无 name 键须 .get(KeyError 于对比器);另 API NULL 序列化 None 镜像不得 coerce 0(orders.it3 Canceled 单 NULL revenue=正确行为非缺陷)进度 P1 已闭 6 波(品牌板/财务结算/广告排名库存促销/财务A/财务B/工作台全家)——dashboard/today/orders/charts 至此全覆盖;余量家族:ads 子端点 8 个、inv/*、products/pm/listing/aplus/mapping/db/dictionary/documents/logistics/po/promotion 子端点、sourcing/matrix/glossary/reports——续审中brand IN (SELECT brand FROM tenant_brands WHERE tenant_id='1' AND is_active)(别名分立 ABO/ABA/ABS/ABPL,禁用字符串 replace 造别名——会把 tenant_brands 内列名也替换掉)波② finance/settlement 2,102 ✓ 0 FAIL ×2;波③ ads(charts/analysis/campaigns)+rankings+inventory/health+promotion/summary 1,645 ✓ 0 FAIL ×2(含断货/0销速大并列组的排序不变式断言替代位置比对);波④ finance-A(sku-profit/noon-summary/kpi-wall/product-pl amazon+noon)1,536 ✓ 0 FAIL ×2;波⑤ finance-B(noon-sku/monthly/profit-matrix/onno 四变体/noon-pnl)6,558 ✓ 0 FAIL ×2——finance 家族(②④⑤)至此全覆盖缺陷⑤(本轮唯一 API 真缺陷,其余 FAIL 全为镜像 bug 自纠) finance.py noon-pnl sku_monthly 查询 GROUP BY 1,2,3, st.units——st.units 混进分组键,同 (product,mon,country) 多 SKU 型号按各自 units 拆成重复行:租户1 实测 1,263 行 / 796 键 / 467 重复行;前端 SKU 型号图按行喂 ECharts → 柱状系列重复/覆盖,型号下拉靠 new Set 去重侥幸掩盖。修=GROUP BY 1,2,3 + sum(coalesce(st.units,0))(改前先证颗粒唯一性:sku×月×国 1,288=1,288,sum 合并安全);api 容器 build + up;上线实测 796 行/796 键/0 重复,且 796 行全量逐行值核对通过;pen_tests 回归门 ALL PASS镜像 bug 分类学(防复发) ① mmap 键是 (brand,sku) 二元组而 pl 键三元组——get 必须显式取二元组,否则型号永不解析成假 FAIL;② 局部变量 mm 撞名闭包捕获的成本字典 → TypeError('tuple'),改名 mp;③ profit-matrix grand 6345 vs 6312——API exp CTE 逐 SKU 行展开(每行 1/n_sku,多 SKU 订单 n 行合计=1),按订单一次汇总会少计,SQL 复演=6345 分毫后才重写镜像;④ 年度榜 ORDER BY 5 DESC 位置语义=net_proceeds(gmv) 非 orders;⑤ mon_ccy 字典迭代产出的是 (mon,ccy) 键元组,r[2] 索引键=错值,必须 mon_ccy[r][i];⑥ 三段成本拆分口径 unit_cost=pc/units 均摊且含不可售件;⑦ Postgres round(numeric)=half-away-from-zero vs Python round half-even——整数四舍五入统一 rhu();⑧ sku_mapping 53 组 (brand,sku) 重复全为同值(0 组 >1 product_name),DISTINCT ON 无 ORDER BY 实务稳定(双跑哈希验证)截图自检(8 张=SKU 卡元素级+Noon 平台全页 × 双品牌×双视口) SKU卡·zf·桌面 · SKU卡·zf·移动 · SKU卡·onno·桌面 · SKU卡·onno·移动 · 全页·zf·桌面 · 全页·zf·移动 · 全页·onno·桌面 · 全页·onno·移动——脚本 tools/_shot_0930_p1_sku_monthly_fix.py 内联断言:页面无 NaN/undefined + 页内 fetch noon-pnl 复核键唯一(zf 736/736·33 型号,onno 60/60·4 型号,合计 796);视觉确认表格 型号×月×国 行无重复、ECharts 型号序列+总数 Units+GMV 虚线正常渲染进度 P1 已闭 5 波(品牌板/财务结算/广告排名库存促销/财务A/财务B);余量端点家族:today/orders/dashboard 族、ads 子端点 8 个、noon-inventory+inv/* 族、products/pm/listing/aplus/mapping/db/dictionary/documents/logistics/po/promotion 子端点、sourcing/matrix/glossary/reports——续审中 前精确 77 字节 splice <script src=https://www.googletagmanager.com/gtm.js?id=GTM-PJB7D937>,仅浏览器特征请求触发(accept: text/html 或 accept-encoding: br;sec-fetch/UA 单独不触发)——反 curl 检测设计;GTM 容器加载后向 polygon RPC 三端点发 JSON-RPC(钱包嗅探类载荷特征)性质判定 磁盘 HTML 7498B vs 服务端 7575B、镜像层 grep 净、容器运行时文件零新增、restart 即清除 → next-server 运行时内存补丁(非镜像非磁盘非构建产物);日志信标 [Error: x] digest=base64(完整 process.env+Next config) = env 泄露通道时间线(UTC) 09-29 18:13 镜像构建+Ready(干净)→ 18:54:29 注入激活(启动后 41 分钟,caddy 该窗口零请求=非公网 HTTP 触发)→ 20:09–20:41 四次 TypeError('v'/'o'/'b'/'k') → 09-30 02:25/09:48/11:06 信标复发 → 15:56 取证后 restart 清除取证排除 公网入口(55,401 请求全内网)/ SSH 密码(仅公钥)/ 磁盘+镜像 / 本机全部 Claude 会话转录 tool_use 扫描 18:40–19:10Z 零条 / root 手工 shell(history mtime 09-27);向量未定(剩余可能:容器网直连 web:3000 绕过 caddy、宿主级 root 行为)影响面 会话 cookie HttpOnly+Secure 不可窃取;暴露=窗口期(09-29 18:54→09-30 15:56)登录用户 DOM 数据+同源 API 调用能力;外发仅见 polygon RPC,业务数据外发无实证(保守按可见即泄露处理)处置 ①restart 清除(5 种触发头组合验证 0 残留)②证据存档 /opt/backups/incident-gtm-20260930/(中毒/干净 HTML、镜像 sha、运行时 md5)③常驻 60s 复发监控 ④事件报告全文待拍板三件 ①enforced CSP script-src 收紧(Caddyfile 注释标明故意保守)②窗口期输入过的租户密码轮换 ③web 容器宿主端口映射收窄为仅 exposesync_mercury.py:326 读 v_fittingirls_order_finance_detail→依赖链上有 v_fittingirls_monthly_overhead(读 archive 表的冻结摊销)——直接 DROP 会打断 SaaS 财务摄取。修法=快照化改写:CTAS 落 public.fg_monthly_overhead_snapshot(5 行 2026-01~05,冻结 /5 摊销值原样)+ CREATE OR REPLACE VIEW 同名视图盖在快照上(owner=collector、同 7 列同序)——接口零变化、数值零变化、依赖解除;「改读活表」方案被否(会改动已冻结的历史摊销口径)DROP 本体 DROP SCHEMA archive CASCADE——NOTICE 确认恰 205 对象(09-30 归位搬入 201 张 + 4 张先在 archive 的 _deduprows_archive_*/archive_*),释放 0.87GB;archive schema 清零,public 19 视图完好,品牌 schema 109 / shared 11 / sourcing 3 不动连带挖出隔离缺陷并修复(brandboard.py) DROP 后品牌隔离门 4 FAIL——月集起点原绑各视图自己订单首日 ds[0],品牌数据覆盖不同时月集不对称(onno 最后一笔 6 月订单 14:10 UTC 滑出 92 天窗后其 6 月月度行只进全量视图)。修=mon_floor 锚窗口日历月(frm[:7] 或 now−days 的 %Y-%m),全量/品牌视图同层;API 数值验证:onno 92d 月集 2026-06 起 GMV 15,617.55、Σ品牌 43,396.41+698,282.78=全量 741,679.20 分毫;90d 两品牌对称排除 6 月;api 容器 build + force-recreate回归门全绿 dashboard_audit FAIL 0(隔离 4 FAIL 清零;余 7 WARN 既有已知:orders30 时间差 2 + 成本 sku_mapping 欠账 5)/ audit_nodes 2,447 节点·18 基准 ALL PASS(较前 +2=月集扩行)截图自检(4 张双品牌×双视口+API 内联断言) onno·桌面 · onno·移动 · zf·桌面 · zf·移动——视觉确认 onno 双视口:渲染健康无 NaN/破碎,月度 GMV 柱 13.5k/10k 与 API 真值精确吻合(07 月 13,586.62/08 月 10,620.07,90d 默认窗对称排 6 月=正确语义);脚本 tools/_shot_0930_archive_drop_isolation.py(92d 含 6 月≈15,617 + 90d 排除双断言)备份与回滚 /opt/backups/mars-archive-drop-20260930/——archive_schema_20260930.dump(79.7MB pg_dump -Fc as saas_admin 全 205 表)+ fg_overhead_views_20260930.sql(视图旧定义)+ move_list_mars.tsv;回滚=pg_restore 进临时 schema→SET SCHEMA 回 public→重跑视图旧 def;旧锚 /opt/backups/schema-reorg-20260930/rollback_mars.sql DROP 后作废(SET SCHEMA 型回滚已不可能)rev−|comm|−|fba|−|other|−|promo|−vat−adsp:finance.py(16 处 net/net_usd)+ dashboard.py(KPI deck profit、fees30 倒算后减回 vat——费用卡不含 VAT(注册表 id=14 裁决)、月/周趋势)+ ai.py(3 处)+ matrix.py(利润对比/国家热力图)+ mcp.py(1 处)+ tools/dashboard_audit.py 基准同步(vat 基准/profit/fees30 三处);锚点 402-8713043-3112317 回款恒等式分毫闭合P2 采集层+mars ① 采集器 onno 三缺陷根治(promo_rebates normalize/孪生标签/退款本金);② settlement_items charge 侧 Promotion 并入——zf 适配器重跑 538 结算单 11,736 items 0 错,锚点 GB Vine 205-3947921-0649150 charge 39.99→0.00+fee −3.37 = finances 真值分毫,聚合足迹 314 行全冲抵 Shipment,非 DebtRecovery 组头表对账与未触碰组同构(无回归);③ mars 141 陈旧行 DELETE(备份 /opt/backups/mars-r16-20260930/saas_order_fees_stale_nullvat_141.csv)+ onno 孪生 DELETE + 单表重清洗——vat 总额 78,826.55 修复前后分毫不变(纯品牌间再归属:fg 59,211.44 / onno 1,124.13 / zf 18,490.98),promo 差额 −2,725.50 属 fees_brand_fix 既有防双计设计P3 spec promo→abs()(promo 桶=正成本量级)+ onno promo 硬清零移除 + vat USD coalesce-to-0回归门全绿 pen_tests ALL PASS / audit_nodes 2,445 节点·18 基准 ALL PASS / dashboard_audit FAIL 0(余 7 WARN 全为既有已知:orders30 时间差±15、5 个 sku_mapping 成本维护欠账)量化终值(365d) vat −65,776 + promo −14,272(onno 8,317/zf 5,955)→ 修正后净额 360,651(fee-covered 营收 649,566)截图自检(8 张双视口×双品牌×两页) 首页·zf·桌面 · 首页·zf·移动 · 首页·onno·桌面 · 首页·onno·移动 · 财务·zf·桌面 · 财务·zf·移动 · 财务·onno·桌面 · 财务·onno·移动——视觉确认 3 张关键图(home-zf-d/finance-onno-d/home-zf-m):10 KPI 卡/6 盈利卡/利润链路/分市场表全正常,移动端新费用卡脚注「不算 EU 代付 VAT」正确渲染,无 NaN/undefined/布局破损;「—」全市场行=既有多币不混加设计非回归口径已拍板(同日用户拍板「Vine 就按 mars 真值展示」) Vine 全冲抵/部分冲抵单净额一律按 mars 结算真值照实展示(全冲抵净=费用项),不采 peer「强制费 0」口径(mars 未复现);SaaS 近似式天然收敛无代码改动;已登记 metric_calibers vine_net(id=15)回滚 API 层 /opt/backups/code-20260930-r16c/(覆盖重建);mars 层 /opt/backups/mars-r16-20260930/(141 行 CSV 回插+旧 promo 值);SaaS 数据层单表重摄取自愈归档 需求单 R16——①②③ 全修执行记录+Vine 分叉披露已入单collection_cycle :50→:30(每轮实测 20–24min,~:54 收尾);② Noon 订单增量 collection_noon_orders {3,18,33,48}→:30(并入统一半点节奏,15min→60min 降频无损失——当日几乎每轮 0 新单);③ SaaS 清洗推送 ingest_today_incremental 偶数 :43(2h)→每小时 :05(采纳 :05 而非 :00:留采集收尾 10min 缓冲 + 避开 :00 作业堆叠/01:00/03:00 sales 锚)效果 web 页面订单新鲜度 ≤2h→≤1h;dashboard 审计 0/1 瞬态翻转窗口减半;已知的 worker 串行阻塞滑点(重任务互阻 10–30min)在新节奏下只会更宽松(采集/推送不再同窗)部署 build 共享镜像 + 仅重建 worker(API 行为零改动不动 api 容器);容器内内省确认三条 CronJob minute=30/30/5 hour=ALL;快照 /opt/backups/code-20260930-cadence/(tasks.py 旧版),回滚=旧版覆盖重建同日连带体检修复 全订单链路体检发现 align_zf_fg_schema(ZF/FG 表结构对齐,每日 04:00)自 09-17 迁移起天天 PermissionError 静默失败——宿主脚本 root:600 容器 uid1000 不可读;chmod 644(对齐同目录惯例)+ 手动补跑成功(幂等 SQL 13 天欠账清零),明起自动恢复;订单数据面双层对账全新鲜(mars raw 三品牌 Amazon max 08:35–09:26 / zf-noon 09:35;SaaS cleaned 三品牌均有今日单,差额=去重/EU 归属预期)验证 首轮 10:30 采集 + 11:05 推送观察哨已挂(出结果自动报);本批零 UI/API 路由改动 → pen_tests/frontend_e2e/截图不适用xjli360/sealeap-amazon-skills(204⭐ MIT,sealeap.cn 独立提炼)clone 至宿主 /opt/sealeap-amazon-skills(42MB depth-1);目录 amazon-official 38 / douyin 211(7 代号库)/ weixin 108 / xiaohongshu 9 / bilibili 74 / youtube 49 / public-research 6 / app 三库 101 = 596 个 SKILL.md(全 <20KB,frontmatter 单行 name+description)接入方式 compose api 服务 bind mount /opt/sealeap-amazon-skills:/sealeap:ro——宿主 git pull 即更新(索引 TTL 600s 自动刷新,免重建镜像);匹配层内联 api/routers/ai.py(~90 行,未建新文件):启动时 os.walk 建 frontmatter 索引,ascii 词边界正则 + CJK bigram,确定性评分 name×4+desc×2+路径×1,门槛 6 分实测校准(真实运营意图 6~15 分命中,「今天天气怎么样」4 分被挡;校准脚本 briefs/sealeap_match_test.py)铁律合规 LLM 不进工作流——检索全程纯代码,LLM 只收注入文本;注入块自带从属声明「与平台数据/官方标准冲突时一律以平台数据为准」;库缺失/低分/读取失败一律 ("","") 行为等价未集成,绝不 500;正文截断 6000 字符四端点接线 /api/ai/{ask,insight,adcopy,ads-optimize} 各注入 1 个最优技能:ask/insight 按用户问题实时匹配,adcopy 固定 listing 文案词族+SKU 类目,ads-optimize 固定 PPC 诊断词族;audit 日志追加 skill=技能名 可追溯;sourcing/sourcing-agent/page-chat 不注入(选品走 Keepa 实时数据、页面浮窗上下文已足)容器内实测 596 全量索引 2.6MB;ACOS 问句→sealeap-amazon-acos-diagnostics(4386 字符)/ 库存→hermes-logistics-inventory / listing→yingzhao evidence-based-listing-copy / 广告优化固定词族→chongming ppc-auto-broad-exact-ladder / 闲聊→不注入验证 pen_tests ALL PASS / audit_nodes ALL PASS(2,438 节点·18 基准)/ dashboard_audit FAIL 0(部署中曾现 noon FAIL 2:今日三次 force-recreate 恰撞 :43 的 2h ingest_today_incremental 在跑被杀,非管道缺陷——手动补摄 ingest_today 9677 行自愈,cleaned=raw 24 行逐位追平,10:43 UTC 起自动节奏恢复);本批零 UI 改动 → frontend_e2e/截图不适用(LLM 端到端已含在 pen_tests ask 用例)回滚 /opt/backups/code-20260930-sealeap/(ai.py+docker-compose.yml 旧版)覆盖 + compose 删 mount 行重建;或 SEALEAP_DIR 指空目录即整体旁路_FEES_ZF_BRANCH/_FEES_FG_BRANCH/order_fees spec(列 12→14,四分支 VAT_EU 参数化)+ clean_audit.py amount_cols 补 vat;DDL 双表各 ADD vat double precision+local_vat numeric(14,2)(public.order_fees + audit.cleaned_order_fees);快照 /opt/backups/code-20260930-r16c/;镜像 build api worker + force-recreate 两容器;定向摄取 ingest_all(tables=['order_fees']) 35,720 行(spec 无窗全史自动回补)+ 单表清洗验收(五点) ①PL 锚点单 402-8857872-1497907(onno 归属 fees_brand_fix 生效)local_vat=24.87 PLN 分毫(=132.99×23/123)、vat 6.69 USD;②UK 203-6478165-8946713=3.33 GBP(20%);③排除面实证:VAT 汇总仅现 EUR/GBP/PLN/SEK 四币,零 USD/AED/SAR/MXN/CAD 行;④四桶+total 逐位不变(spec 增列不触旧列表达式);⑤audit_nodes 2,438 节点/18 基准 ALL PASS(基线 SQL 直算随清洗层同移)三件套同日 代码+基线+注册表当日齐:metric_calibers 新增 vat_withheld(id=14,含代扣集/性质/锚点/USD 折算法);本批无 web/api 路由改动、页面无 VAT 展示位 → pen_tests/frontend_e2e/截图不适用(DB 锚点即验收)连带发现(非本批引入) dashboard_audit FAIL 2 = noon nPast24h/nLast24hCountry「api=0 vs base=1」——实锤 SaaS noon 订单 cleaned 层摄取滞后(raw max 09-30 08:17 vs cleaned 05:43,样本量 1 单的 0/1 翻转),下轮摄取自愈;与 VAT 改动无关,若 10-01 仍现另立新案(已闭 09-30:根因=当日三次部署重启撞 :43 摄取窗杀在跑任务,见 sealeap 条目,手动补摄自愈勿立案)回滚 /opt/backups/code-20260930-r16c/ 旧码重跑 + ALTER TABLE … DROP COLUMN vat, DROP COLUMN local_vat(双表)+ 删注册表 id=14归档 需求单 R16——③ 执行记录已入单;①②(onno_amazon 源侧重复行治理+Promotion 组件补齐)仍立案,验收锚点已备(PL 17.80/17.81、AU ONQ2001 287.00/287.34)fxd(业务日,币) 逐日:读 mars public.fx_daily(= saas fx_rates 全量镜像),当日→前向填充(周末/23 个 ECB 假日缺口覆盖)→旧常数→记 dirty_data_log(fx_fallback_constant) 兜底不静默;锚定币(AED/SAR/USD/Noon/RMB 成本)口径不变。历史源拍板=ECB/frankfurter 一次性种子 2024-01-01~2026-09-08(5,512 行,source 列如实分标,ON CONFLICT 不覆写活水行),活水仍是自家 exchangerate-api 06:05;MXN:ECB 2026-09 停发参考价(种子止 09-08),活水已接棒实测至 09-30,CURS 补 MXN双陷阱(表面替换修不出真口径) ① 三品牌 spapi_orders.revenue_usd 是采集器写库时烘焙常数的存储列(实测=total_amount/常数 分毫吻合)——COALESCE 首位透传使 fxd 永不生效 → 三分支全部调序重算优先、存储列退兜底;② zf 表 order_total_amount 2025-08 245/245 全 0/NULL(R10 病灶),真实本币金额在 total_amount/currency → ot lateral 配对 CASE(订单金额可用 507→835 全量)改动面 orders spec 三分支 + it_raw×4 + fin 分支×2 + order_fees;mars 视图 fx( 残留清零 4 张(v_order_finance_detail 21 点/v_monthly_overhead 3/v_fittingirls_shipment_agg 22/v_fittingirls_monthly_overhead 5),spec 端 fx( 仅剩 RMB 成本钉死路径(故意保留)回补(spec 自愈单一口径路径,无旁路 UPDATE) 全量摄取 41,375 行(对账 0 幽灵行)+ R12 式去窗回补 sales_daily(订单窗→2024-01-01/广告窗→2026-01-01,进程内 patch 不落盘)3,224→26,715 行(zf 至 2024-01-11 / fg 至 2025-05-27 / onno 自 2026-08-01)验收(冻结窗逐分吻合) 2025-08 全品牌 20,891.79=探针分毫不差(n=1026)、2024H2-float 21,443.43(n=997)同;锚点三品牌 0 偏差(zf 706 行/fg 172/onno 30d 289,local_amount÷fxd(日,币)≈revenue_usd);本币列逐位不变(zf 854 行 vs v_order_master 0 不一致);sales_daily 跨表对账 zf 2025-08 16,937.42 vs orders 16,937.60(0.001% 舍入);audit_nodes 2,444 节点·18 基准 ALL PASS + dashboard_audit FAIL 0(基线均 SQL 直算随清洗层同移,无需手工重冻结)。方向:30d ~+6%(AUD/EUR 区,zf $5,093/onno $8,588 见截图)、2025-08 +2.3%、2024H2-float −5.0%(2024 下半年欧元日率>0.92 常数,USD 下修是诚实方向;需求单「整体 ~+3.3%」为 2025-26 区间表述)。sales_daily 159 行 fg units 变动=源端 Pending 回刷(09-24 立过案老问题)被 spec 自愈到当前源真值,非口径变更当日连带修 finance_monthly 全量摄取暴露 fxd(timestamptz) 漏 cast(fg 视图 posted_date,EXPLAIN 清单当时漏此表)→ ::date 即修即重跑 5,000 行,镜像重建烧入(容器 /app 已验证 4 处)验证 双视口截图(工作台 zf·Amazon·桌面 · 手机 · onno·桌面)DOM+视觉双确认(fg=fittinggoals 租户无审计凭据,照既往惯例 DB 基准同构验证:锚点 0/172+跨表对账);本批无 web 改动,pen_tests/frontend_e2e 不适用教训(两条入档) ①前段「v_monthly_overhead 零读者」结论错误(实为 v_order_finance_detail 读取)——「零读者结论执行前必须对执行对象重 grep」铁律再次应验;②EXPLAIN 验证清单要覆盖全部受影响 spec,漏了 finance_monthly 就在全量摄取时才爆注册表+回滚 metric_calibers 新增 fx_daily 行 + fx_pegged 注记(浮动币已迁逐日/锚定路径不变);对账以原币列 local_amount 为锚,与 peer Excel 固定汇率口径再分叉属预期、各自脚注;回滚=视图重跑旧 def + 旧代码同法去窗重跑 + DELETE WHERE source='ecb-frankfurter-backfill'(详见需求单 R15 执行记录)SET SCHEMA archive 共 201 张(批1 D1+D3 实搬 188——190 残留中 4 张本就在 archive;批2 D2 13 张,shared.fx_rates 保留原位);核验:mars 基础表 328 = archive 205 + 品牌 schema 109 + shared 11 + sourcing 3 + public 0(剩 19 张 VIEW,SET SCHEMA 保 OID 视图完好);D4 执行前翻案取消——sourcing_verdicts_legacy 复核发现活读者 3 处(verdicts.py:246/480/488),保留原位;搬后 audit_nodes / dashboard_audit 全绿执行⑤(R12 根治+全史回补) 根因=_NOON_ORDERS_BRANCH 92 天滚动窗(首同步 09-11 → 起点 06-12 冻结);进程内去窗 + ingest_all(tables=["noon_orders"]) 定向 UPSERT 85,323 行(onno 1,124 + zf 级联 84,199——zf 同窗 2024-01 起全缺一并回补,纯加法不碰既有行);onno 逐月 34/148/102/164/202/159/134/66 与 mars 分毫一致,cleaned=public 逐位;脚本 tools/backfill_noon_orders_full.py(热路径 spec 未动,回滚 SQL 见脚本头)执行③(MCP 四工具迁 cleaned) sales_summary/top_products/inventory_status/ad_performance 全部改读 audit.cleaned_*(RLS SET tenant_id,参照 ads_by_country 模式);修活三处 raw 硬伤——ad_performance(onno,amazon) 原本必炸(onno 无 ads_campaigns 表)→ 23 行含 EU 归属;sales_summary 营收 onno $226.52→$8,368.48(raw revenue_usd 大面积 NULL+混币直加)、zf $107.45→$5,055.65;top_products NULL 价行排最前→真营收 Top;stdio 探活 20 组合 0 错(探针+对照表存 /opt/backups/mcp-cleaned-migration-20260930/,回滚=单文件覆盖)⑥ 立案不执行 R15 变更单落 db-requirements-2026-09-29.md:清洗层 fx 固定常数→自家 fx_rates 日表(AUD 低 7.7%/SEK 低 ~10%),影响面=EUR/AUD/SEK/PLN 区历史 USD 整体 ~+3.3% + 18 基准重冻结;口径变更三件套纪律;执行前需再拍板验证 audit_nodes ALL PASS(2,442 节点/18 基准)/ dashboard_audit FAIL 0 / MCP stdio probe 0 错;R12 页面效果双视口截图(/noon onno·桌面 · 手机)DOM+视觉双确认全史生效——KPI 订单 1,009/件数 1,263、月度表 2026-02 AED 1,522 起、趋势覆盖 2026-03~09(本批无 web/api 代码改动,pen_tests/frontend_e2e 不适用)观察项(非本批引入) 截图中「月度盈亏(按 SKU)」块全 0 行:数量=0 诚实对应源 valid_units=0(§28 已知源缺口),但源 gmv 非零(2026-02=2,020)显示 0 存疑——该块在当前 web 源码/容器构建中不存在(水合前瞬态产物),当前版 /noon 页无此块,未改动;30 天 DROP(④)~10-30 届时再确认,回滚锚 /opt/backups/schema-reorg-20260930/rollback_mars.sqlSET SCHEMA archive 原地搬(DDL 秒级可逆,表数 328→136);批2 D2 13 张+saas legacy 1 张同法;批3 MCP 4 工具迁 cleaned(参照已上线 ads_by_country 模式);完成后 555→350 张、每表层属唯一写入方唯一;30 天后统一 DROP 回收 888MB教训 ①reltuples=-1 ≠ 0 行(没 ANALYZE 过而已),清单文档必须真跑 count——27 张「预留空表」全部实跑核实;②shared.fx_rates 1,192 行看似活维度层,实为 09-28 单时刻写入的 backfill 脚本缓存(fetched_at 一列定案),差点误报「双活汇率分裂」;③表名带品牌词≠属于该品牌 schema(public.fittingirls_amazon_rankings 停 08-11 是死版,真身日更至 09-29)onno_finances.py 当月窗 PostedBefore 压到 now−7d——在 Amazon 自身 7~9 天之上再叠 7 天,把费用可见性拖到 ~2 周;zf/fg 同款适配器只回退 5 分钟(防 Amazon 端时钟偏快 400),证明 7 天尾窗纯属过度保守修复 safe_end = min(end, utcnow−5min) 对齐 zf/fg 口径(备份 .bak-r11b-window-20260930,bind mount 即时生效);适配器重跑落 284 行,raw 费用行 posted max 09-22→09-29,09-22~29 原 0 费用窗新落 78 条带费 Shipment 行;SaaS 重摄取 order_fees 35,664 行(+66)自动过清洗效果 peer 对账窗覆盖 571/694=82.3%;周度覆盖轨迹 09-14 周 71/95 → 09-21 周 5/49 → 09-28 周 0/12——覆盖停在「今天−7~9 天」正是 Amazon 滞后的直接体现,每日滑窗自愈一格;09-14 后订单补上费用 $609.85(76→97 行);工作台 onno 30 天费用卡 $1,150→$1,757(佣金 $453/尾程 $1,331),利润 $4,978→$4,372、利润率 62.2%→54.6%(费用补齐后诚实回落),覆盖脚注 52%→72%验证 四道门:pen_tests ALL PASS / audit_nodes 2,393 节点·17 基准 ALL PASS / dashboard_audit FAIL 0 / frontend_e2e ALL PASS;双视口截图(工作台 onno·Amazon·桌面 · 手机)DOM+视觉双确认 $1,757/$453/$1,331、图表无空白、窄屏无裁切教训 KPI 卡比对必须用 cleaned 层同口径 SQL(租户+北京窗)——本轮首测误用 public.order_fees(raw brands)得 $1,225 假不符:87 行 EU 归属费用行 raw 侧 brand=zipforce,cleaned 层才归 onno,差 ~$532;卡是对的,比对 SQL 错了归档 需求单 R11 口径句已改写(「滞后~2周」→拆分为 Amazon p50 7~9 天+已移除的 7 天尾窗);peer 已获实证答复(Seller Central 早显=内部系统,非 API 口径)ads_by_country(brand, platform, days=90):连 saas_registry 读清洗层——amazon=audit.cleaned_ads_sku_daily UNION ALL cleaned_amazon_ads_daily(onno 双表国别互斥由 onno_country_dedup 保证,EU 9 国+AE/AU/SA/US 13 国全量);noon=cleaned_noon_ads_daily(源表仅本币,列名如实标 spend_local/sales_local+按国推导币种,不冒充 USD);每行随 first_day/last_day 实际覆盖窗(断流可见不缩窗——UK 止 09-04=第二 Ads 账户在案);ROAS 分母 0 时 NULL 不显误导值安全面 mcp_read 只读角色+RLS:工具内按品牌映射 SET app.tenant_id(zf/onno=1、fg=3)后查询;saas_registry 加入 ALLOWED_DATABASES 但 不进 query 工具的 Database literal——通用 SQL 面不可达,专用工具定义暴露面;授权=全量 audit 表 SELECT+public.tenant_brands(此前已施)+默认 ACL 双通道(saas_admin/portal_app 两建表角色都盖,未来清洗换表自动带权,引擎孪生文件无需改)验证(stdio JSON-RPC 全链路) initialize→tools/list(10 工具含新)→tools/call 实测:onno+amazon 13 国 UK $227.52/ROAS 0.964/87 行/08-01~09-04、onno+noon SA 3,397.37 SAR+AE 1,457.65 AED、zipforce 5 国、fittingirls 10 国(租户 3 隔离正确);另以 mcp_read 身份直跑同 SQL 证 grants+RLS 畅通。零 SaaS 文件改动→四道门不适用(MCP 独立进程栈);无 UI→无截图项注意 已建立的 MCP 客户端连接仍是旧代码,重连/新会话后才见新工具onno_finances.py 的 normalize_finance_market 重贴标 UPDATE 撞唯一键 onno_finances_uniq(order,sku,posted,type,marketplace)——全库仅 1 行 SA/GB 双标签同键行(id 9974507,404-5877980-2597101/ONY2002SA)使每日 03:20 UTC 的 cron 崩死在 8 月该步,9 月整月永不同步(适配器从 MAX(posted_date) 月恢复推进,第一步即炸)。修=UPDATE 加 NOT EXISTS 守卫(撞键行保持代表市场标签,费值同源不丢,绝不阻塞月度推进);肇事行按 _deduprows_..._20260929 惯例移档归档(可逆)。备份 .bak-r11-normalize-20260929,bind mount 即时生效根因②(FBA 恒 0·SaaS 聚合层) 「佣金有值、FBA 全 0」独立成案:FONCYE 表(onno_amazon_spapi_finances)283/283 Shipment 行 fba 四组件列含 NULL(费用事件缺啥组件就空啥,zf 表四列全填),SaaS 同步 _FEES_ZF_BRANCH 的 SUM(a)+SUM(b)+SUM(c)+SUM(d) 链任一 NULL 毒整个 fba=0——raw 事件里明明有 −7.76 AUD 却聚合不出。修=按同文件 FG 分支既有 COALESCE 模式包齐 fba/other 全链(api/sync_mercury.py),api+worker 镜像重建烧入;zf/EU 表 0/12,812 行中招=zf 与 EU 数字不受扰(改动前后零变化实证)回补+重同步 8+9 月 FONCYE finances 重拉 363 事件行(US 47/GB 68/AU 94…,raw max 09-22=适配器安全窗 now−7d 上限);SaaS order_fees 35,598 行重同步+清洗层换新 ×2(第二次为撞键行移档后修正),肇事单费用修正 commission 3.36/fba 2.91 SAR效果(peer 对账窗 08-01~09-25 vs Excel 后台) 费用覆盖 447/701→601/701(85.8%);佣金 $484→$659(76%);FBA $1,916→$3,084(79%,AU $0→$678/161 单);onno 30 天费用 KPI $604.21→$1,150.48(80→170 单,佣金 $271/尾程 $907);费用覆盖门转绿(dashboard_audit FAIL 0);08-24 成熟周验收 SQL 53%→100%;剩余差额=09-14 周起结算滞后单+09-22 后尾巴——Amazon 费用事件本身滞后 ~2 周发布,每日 03:20 UTC cron 现已畅通按日滑窗自愈,settlement 明细周一 04:10 批次自动补,无需人工验证 四道门:pen_tests / audit_nodes 2,442 节点·18 基准 ALL PASS / dashboard_audit FAIL 0(费用覆盖门转绿=本案验收线)/ frontend_e2e ALL PASS(像素空白扫描+品牌×平台×窗口全状态扫);双视口截图(工作台 onno·Amazon·桌面 · 手机)DOM+视觉双确认费用卡 $1,150/佣金 $271/尾程 $907、利润卡 $4,978 非空、图表无空白;peer(onno-db 会话)独立复核同窗收敛:佣金差 43%→23%、FBA 50%→20%(其口径到 09-25 全量),结论一致=剩余为结算滞后教训(两条入档) ①子进程采集器 rc≠0 无人告警——断流一个月才被费用覆盖门抓住,collection_cycle_sales 的 rc 已在返回值里、告警面待接(次优先);②SUM(x)+SUM(y) 链式相加是 NULL 放大器,跨源模板复制时 FG 分支的 COALESCE 模式才是正确范本归档 需求单 R11 主体关闭(归属半侧见上条+断流半侧本条);记忆 collection-gaps 已标「三层全修当日闭案勿重查」fees_brand_fix:zf 行挂 onno 订单——local 有值→brand 改判 onno(87 行);local 全 0 且已有 onno 费用行→fees_stale_twin 整行不入层(137 行);无孪生的保留标 fee_local_missing 不静默丢钱(当前 0 行);②订单侧连带修 7 单 ON\* 漏挂(GB·Shipped·$181.22):amazon_orders 增 brand_fix: sku_list(sku_mapping 精确命中才改,多 SKU 逗号列表不命中=不动;raw 不动——sync upsert 按源 brand 回插,改 raw 必生孪生);③孤儿校验移位到品牌纠正之后 + order_keys 用归属后口径(LEFT JOIN CASE 与订单 brand_fix 同式)——否则归入行按 raw 旧品牌判孤儿会误标,6 条反向行 orphan 误标同根出清;raw 守恒实证 12,535−224=12,311 分毫不差效果 onno 费用 KPI(Amazon 视图 30 天,API 同口径 SQL)$23.63 → $604.21(80 单有费用,佣金 $134/尾程 $495);利润/利润率转诚实(费用缺席期利润原虚高,KPI 卡脚注「费用覆盖24%(结算滞后未到·利润偏高)」如实标注);zf 侧零变化——这些费用行此前按 brand join 两头都不到,非 zf 转出连带修(frontend_e2e 像素空白扫描挖出):工作台「SKU 利润率」「SKU 费率」两图误导性 0% 根因链:zf 30 天营收 Top3(ZFT11TSABE/ZFCP04AEBK/ZFH24T0SAB)的 76/49/84 单全无费用行(zf 费用事件 09-21 周起未到),net_usd 亦未结算→rate(0,rev)=0% → 零宽条形=像素空白,e2e 首次抓获——0% 是「数据未到」冒充「真零利润零费率」,违铁律。修法与每日利润图「结算中」null+脚注同款口径:两图改取费用事件已到(fee 行命中且折算成功 er>0,或订单列费用>0)的营收 Top3,被略 SKU 数入脚注「营收Top中 N/3 个 SKU 费用事件未到(结算滞后约2周),已略」;窗内一个可算 SKU 都没有时不渲染该图(不画空轴);onno 视图同享(AU/SA 零费用 SKU 不再画 0%)验证 四道门:pen_tests / audit_nodes 2,440 节点·18 基准 ALL PASS / frontend_e2e ALL PASS(含品牌×平台×窗口全状态扫)/ dashboard_audit 仅剩 1 FAIL=费用覆盖门如实报警(门读 raw order_fees 按 f.brand=o.brand,清洗层归属不动 raw——R11 真断流 08-24 起回补前持续红,验收=成熟周覆盖率≥90% 转绿);双视口截图(工作台 onno·Amazon·桌面 · 手机)DOM+视觉双确认费用卡 $604/利润卡 $5,524 非空剩余开放(需求单 R11) 采集断流恢复(08-24 起退化、09-07 周起归零)+ 08-24 起回补 + AU/SA/AE/US(FONCYE 账号)settlement 报表拉取;UK 第二 Ads 账户仍待卖家后台授权(R2)ads_sku_daily brand=zipforce(ON\* SKU)——但读侧 15 处 brand<>'onno' 闸门把专表 amazon_ads_daily 的 onno 半边焊死,EU 半边又按 brand 查不到,onno 视图两头落空;本轮把归属翻案在清洗层落地(raw 账号事实不动,铁律)清洗层双规则(audit_clean_all.py + api/clean_audit.py 双文件同源) ①brand_fix:ads_sku_daily 中 ON\* 前缀 SKU 行 brand 改判 onno(订单侧 source=zf_resell 同族翻案);②onno_country_dedup:onno 名下行若其 country 已被 raw amazon_ads_daily brand='onno'(FONCYE 账号 AE/AU/SA/US)覆盖则不入清洗层——两表 onno 行国别互斥(EU 9 国走 ads_sku_daily、AE/AU/SA/US 走专表),union 全量且零双计;闸门全部拆除后 API 直接两表并读;镜像重建烧入防旧规则回退;自愈性=venus 恢复 SKU 级日更后新行自动落对侧,无需再动EU 9 站对账(vs 用户 Amazon对账汇总.xlsx,30 天窗) BE +1.1% / ES +0.5% / FR +0.9% / IT +1.9% / NL +2.2% / SE +3.2% 全部对上(清洗层 30 天分国花费:FR 81 行 $297.68 · ES 26/$125.20 · IT 31/$93.00 · NL 49/$46.50 · SE 75/$43.15 · BE 26/$41.01 · UK 11/$37.42 · PL 15/$6.71);UK −9.2% 真缺口已根因=卖家有第二个 Amazon Ads 账户在投 UK(zf-ads adapter 只授权了一个,UK SP 报表 09-05 起断流即此,需求单 R2 已补授权诉求);PL 反向差(后台标「无广告」vs 我方有 96.53 PLN)待同伴确认后台口径;DE 仅 €6.09 无对账 sheet 不立案验证(读侧全链路) /api/ads/charts?brand=onno&platform=amazon 返回 13 国(含 EU 9 国全席);DOM 断言 onno 品牌下 9 个 EU 国名+数值全渲染;双视口截图(广告页·桌面 · 分国明细·桌面 · 广告页·手机);pen_tests / audit_nodes / frontend_e2e ALL PASS,dashboard_audit 仅剩 1 FAIL=费用覆盖门如实报警的源缺口(见下条 R11,非回归)同日修①:dashboard_audit noon 金额基准月窗→当月 原 mon>=上月 窗在 09-29 Noon 回补落 8 月月行后整月多计(kpi-pool noon 5 项假 FAIL,实测 86490→36053 对上 API)——4849 同类口径病,与 audit_nodes BASAL 同日同修,口径=当月(mon=to_char(now() AT TIME ZONE 'Asia/Shanghai','YYYY-MM'))同日修②:GChart 单点线渲染 symbol:"none" 的线只有 1 个数据点时画不出线——根页面默认全局窗 30 天(page.tsx useState(30))下月度图只剩当月一个点,图变「有轴无线」伪装空白(e2e 像素扫描当场抓获,feeVsSettle 被 legend 色块掩盖);修法=单点补大圆点(symbol circle/10px),≥2 点保持纯线;配套 e2e 扫描器阈值改「彩色像素恒=0 才判空白」(真实空白图的轴/字/网格全灰,稀疏真图彩色占比可低至 0.5%,按占比误杀)新立案 R11(费用覆盖门首次报警的源缺口) onno Amazon 订单费用(order_fees)采集自 08-24 周退化、09-07 周起归零(08-24 周 104 单中 45 单无任何费用行;AU 130/SA 66/AE 29/US 27 单零费用;EU 费用部分错挂在 zipforce 名下=与广告同族归属问题,ES 11 onno/20 zf、FR 8/26、GB 8/10、IT 6/13…)——~263 单无费用,利润/费用口径失真,需求单 R11 已立(采集恢复+回补+EU 费用归属拍板项)1790687425_e902750a_Noon对账汇总.xlsx(onno AE/SA 两 sheet,看板 vs 后台逐指标对账,多格 ❌)——本轮逐格定案,并与 Amazon 对账同规格出具判词表先纠一个关键误读 表头「看板(onnotek)」=noon 卖家门户自己的仪表盘(onnotek=店铺账号名),「后台(Noon)」=noon 报表导出——我方数据与「后台」列全量分毫一致(GMV AE $6,611.94=24,282.36 AED 逐位 / 订单 372/682 / SKU 明细 141·52·89·90 与 90·162·85·80 / 后台毛利 $5,134.35=noon_monthly.gross 18,855.90×0.2723);全部 ❌ 格 = noon 门户 vs noon 报表的口径差(门户毛利=门户GMV−佣金−FBN−广告 自洽 231.49/1,100.07 逐位;ROAS 门户用总GMV÷花费 1.35/1.49 vs 后台用归因销售额÷花费 1.04/2.05;门户订单+5/+1 与 GMV+5%/+3.8% = 门户实时到 09-28 而台账止 09-23 的未结算尾巴;门户「可售」含 FBN 外库存 vs FBN 报表——我方库存快照 09-28 {138,98,8} 对上 FBN 报表 {139,97,8},SA 16/18 两格逐位)但对账挖出我方真 bug:noon_ads_daily「SP/sp 大小写孪生」双计 采集器先以 'SP' 后以 'sp' 两种大小写写同一 (brand,country,日,活动,SKU) 的同一笔账(onno 2~7 月并存,1,008 对中 1,005 对四指标逐位相同)——raw 全期合计 AE 21,474 AED / SA 21,612 SAR,实际(小写唯一)AE 11,422 / SA 12,477,虚增 1.87 倍;实锤依据=noon 后台导出 AE 11,460 / SA 12,760 AED(差值=09-26 后文件尾巴,R2-bis 在案);zf 的 'product'/'sp' 两型经查零同键重合=不同活动集不受影响修复(asin_twin_dedup 同族方案,双文件同源) tools/audit_clean_all.py + api/clean_audit.py 增 case_twin_dedup 规则:组内存在小写 ad_type 变体时大写行不入清洗层(金额不同的 3 对 SA 03-08~10 共 19.37 SAR 按「晚写=修正值」让位,差额入 dirty_data_log 可追溯);raw 表只增不删不动;单表清洗 1,008 行孪生全部剔除(cleaned AE 11,422.48/667 行 · SA 12,476.79/666 行,zf 逐位不变);api+worker 镜像重建烧入(容器内 grep 实证),防同步任务以旧规则重建清洗表回退验证 audit_nodes 135 端点/2,436 节点/18 基准 ALL PASS;dashboard_audit 192+ 项 FAIL 0(9 WARN 全为在案已知:2~3% 清洗修正时间差 + R7 成本孤儿);30 天窗口数字不变(9 月行全为 'sp'),受影响=2~7 月历史合计视图剩余口径注记(非缺口) 我方 sku_pl 费用列 vs 同伴 SKU 报表导出存在方向性小差(佣金 −4~7% / 配送 +13~15%,两国同向)=报表版本/归类差,GMV·订单·结算零差,观察不动;门户 GMV/广告高于报表的部分均为 noon 内部口径,无从修也无需修ssh mercury 连 mercury 冻结快照,本轮曾据此得出 IT45/SE14 等幻觉残留(活库为零)——服务器已搬迁 mars 本地 /opt/mars-mcp(代码+依赖就绪、动态解析 db 容器 IP),mcp_read 角色创建待用户执行两条 psql 后生效;本会话核验已全部改走活库直查归档 需求单 R10 当日关闭(含 10-01 起月度巡检口径);备份 adapters/*.bak-r10-*-20260929sync_mercury._ORDERS_UNION zf/onno 两分支加第三级 LATERAL 兜底(order_items 实价+运费合计→fx() 折 USD,仅 Shipped 生效防取消单混入,COALESCE 链 order_total→finances→items);②一次性重同步 07-25 起(tools/_reingest_orders_0725.py,4,542 行 upsert);③增量窗 3→10 天(迟到回刷金额不再滑过)——需求单 R10 立案 venus 侧根治(Shipped 后回刷 getOrder)效果(8/1~9/25 vs 卖家后台,$) GB 2,502/2,546 · US 1,781/1,799 · FR 2,881/2,788 · ES 2,488/2,418 · SA 2,240/2,306 · AE 876/894——全在 97~103%(修复前 GB 仅 756);同夜同伴全量复核校准:13 国中 10 国 ±3%,AU −12% = 恰好 4 单死单($860÷4≈$215/单=AU 客单价,R10 终态集 09-14/17/21+08-14,API 无价不可收敛)、NL +13% = $54 发生在 $406 小基数(我方 18 单全有价、边缘日无单,侧干净)——次日闭案:不用等对方数行数,答案就在其上传工作簿 NL 页,后台 18 单(G25×16+灯泡×2)与我方订单级完全同构(无缺单/多单/退款),差额 99.6% = 纯口径:①VAT(后台数去 21% 净额、我方含税:G25 €384.57÷1.21×1.1357=$360.98≈其 $361.99 差 0.3%;两 SKU 合计推 $404.40 vs $406.09 差 0.4%)②汇率(我方日表 1.0869 vs 其固定 1.1357)——13 国终态=「大市场 ±3% + AU 死单 + NL 口径」,无数据缺口残留 20 行诚实显「—」 zf 16(SA/AE)+ onno 4(AU/FR)四层全空(order_total 0/NULL · finances 空 · items 金额 NULL · settlement 0.00 或缺行)=真不可填尾巴(疑似全额折扣/换新单),不造假数验证 源端三样例单兜底命中(£29.99→$37.96 精确);cleaned_amazon_orders 单表刷 41,325 行与 raw 逐位一致;api+worker 镜像重建烧入;audit_nodes 2,436 节点/18 基准 ALL PASS、dashboard_audit rc=0(kpi-pool 三 WARN=既有 raw↔cleaned 漂移类,noon 侧未触碰);三层结论已回复 onno-db 会话https://zipforcehub.com/mcp(实测全链路通:无效 key 返回标准 JSON-RPC 401 = 路由/限速/认证层在主域名均正常;租户归属由 mk_ key 决定与域名无关);建/管 key 的 /api/mcp/keys 仍走租户子域名(按域名路由)数据验证 用户问「刚补的广告数据没在 MCP 里吗」——在:ads_performance 直查 audit.cleaned_amazon_ads_daily,onno 30 天 $1,377.43(483 行补账全含);此前查不到的根因=该工具 onno 分支列名 spend/sales 不存在,09-24 上线起任何调用必报错,随双计战役修复(mcp.py:127 容器内实查确认部署)坑修 /api/mcp/keys 的 label 走查询参数 ?label=,body 里的 label 不生效(默认 claude)——文档已按真实行为改写;本轮验证用临时 key 已全部吊销(DB 实查 revoked)文档 mcp-guide-2026-09-29.md:端点/协议方法/错误码/8 工具全参数与返回字段/口径与时效(清洗层 2h 滞后)/key 管理(租户作用域表)/三种客户端配置示例(Claude Code·Desktop JSON·curl 裸调)/安全边界——取代 09-24 接入指南asin_twin_dedup(api/clean_audit.py + tools/audit_clean_all.py 同源):同 (brand,day,country,campaign,ad_group) 组存在 ^B0 ASIN 行时非 ASIN 行不入 cleaned——255 标题行 + 15 空sku重复行一次出清 270 行,本地币金额全在 ASIN 行 local 列零损失;连带迁移 mcp/reports/metrics_store 三处 raw 读点至 cleaned(mcp 原列名 spend/sales 不存在调用即 500 + 缺品牌过滤跨租户污染,连修)FONCYE 归属定案(七维对账) sku/asin/产品名/型号/品牌/国家/账号七维全中 onno:5/5 活动名与 SELECT DISTINCT campaign_name … brand='onno' 精确同集(1020S/2001/2002/E27/G25 SP Auto);线级 USD 金额与库内 ASIN 行逐笔吻合(US/SA/AE 钉住币零差、AU 汇率时点差 ≤$0.32);ON\* SKU/型号链全 onno;ASIN 跨国一致——FONCYE=onno 的 Amazon 卖家账号(推翻 09-29 晨「独立卖家账号」判断)补账(用户令「rawdata格式要固定,除非必要,否则不要建新表」) amazon_ads_daily 零 schema 变更,campaign 行=同格式粗粒度行(ad_group/advertised_sku/advertised_asin 三空,campaign_id 存控制台 A 式 ID);新导入器 tools/import_amazon_ads_campaign_csv.py(--brand 必填无默认)只入库内无细粒度数据的 (country,day)——57 份 CSV 中 483 行入(09-01~25 全窗 + 7/8 月零星真洞日,$1,327.74),372 行重叠日自动跳过防双计;ON CONFLICT 唯一键幂等口径四件套 指标位守卫放宽 OR campaign_name<>''(dashboard×4/ads×2/ai×1 + audit_nodes×4/dashboard_audit×3 镜像);维度位补 guard finance 产品维×3 + SKU 维×2(原 15 条重复行本就在污染空组);metric_calibers id=1 note 追加全记录验证 30 天 KPI $1,421.12 = 修正基线 93.38 + 补账 1,327.74 分毫吻合;API 活值(onno 租户真实登录)北京锚窗 $1,377.43 与 SQL 逐位一致(差 $43.69=08-30 一天窗缘);重叠日防双计抽检 08-15 SA 仅 5 条 ASIN 行 $8.98;RLS 探针 t3/t4=0 零泄漏(t1/t2 双租户挂 onno 是既有设计);四道门全绿(audit_nodes 18/18 · dashboard_audit · pen_tests · frontend_e2e;纯 API/数据层无 web 像素变化,数据经 SQL↔API↔审计基准三层对账)回滚 DELETE FROM public.amazon_ads_daily WHERE brand='onno' AND coalesce(advertised_sku,'')='' AND coalesce(ad_group,'')=''; 后重跑单表清洗即回补账前态;双计修复回滚=去掉 asin_twin_dedup 配置重清洗>= bj-N 是 N+1 天窗,30 天差 08-30 整天 11 单)——「销售趋势 7 图只显示 1 天」「每日订单数出入」两报障的代码侧根因A2 KPI 概览卡取消过滤 dashboard.py:737 rev/units 补排除 Canceled,与平台区 _amz_kpi 同口径(fg「30 天销量/订单数不对」根因)A3 Top15 排序列改营收 dashboard.py:225/242 列序 6=revenue,原按 7=广告费排序(「热卖 SKU 排名不对」根因)A4 补货预警分桶重构 inventory_po.py:123 有销速→35/90 天线 urgent/watch;无销速→断货=紧急、其余单列「无动销」;无销速行天线/缺口 NULL 前端显「—」(「紧急观察没数据健康数据错误」根因——0 销速原冒充健康)A5 EU 库存桶恢复 inventory_po.py:81 EU 聚合桶单列(「欧洲已按国拆行」假设对 onno 5 行/fg 610 行不成立)A6 ACOS 口径统一 dashboard.py:157/771+ads.py:200 空广告 SKU 行排除 + 广告页 platform='' 时 Amazon/Noon 分列汇总(原混算一个 ACOS)C7 订单页国家+日期区间筛选 国家下拉(17 国)+ frm/to 自定义区间(设区间自动退出快捷天数窗)+ 清除按钮C8 商品页国家筛选 ops.py:47 products 无国家列,语义=sku_mapping 中该 (brand,sku) 在该国上架(EXISTS)C9 BUZZ 排名 SKU 映射 dashboard.py:1646 源 name 列本身是 ASIN,显示层经 sku_mapping(brand,asin) 映射出 SKUD 类随带 每日订单数图注(口径+数据止于)+ 订单页脚注(数据源/N 自然日北京时区含首尾)验证 DB 级对账(onno 30 天 304 单/有效 274/$7,420.07/318 件与 API 逐位一致,本轮 onno 租户侧探针复确认);四道门全绿;9 组双视口截图自检(分桶·桌面 · EU·共享桶 · 订单 DE+区间 · 广告分列 · BUZZ SKU · 商品国家筛选 · KPI 概览卡 · 每日订单数图注 · 订单 GB+区间)桶计数作用域(SQL 取证闭环) 分桶 chip 传 country 后按所选国服务端重算是设计(D批P3-6);SQL 复算自洽:zipforce 全部 urgent=117/nosale=21/ok=1 合计 139=chip 总数 ✓;EU 作用域 urgent=30/nosale=8 合计 38 ✓(早期「119/29」读数为视觉误读,119+29+1=149≠139 自证)(null??0)+(undefined??0)=0 显示「90 天线缺口合计 0 件」违反不显示误导性 0 铁律——改 NULL 毒化:分量未知即整体「—」(紧急缺口合计同规则)。DOM+视觉双确认:「紧急缺口合计 — 件 · 90 天线缺口合计 — 件」,行级 35/90 天线与缺口列同步「—」,与无销速断货语义自洽验证 web 镜像重建部署;frontend_e2e 复跑 ALL PASS(50 项:订单日期区间联动/四桶/EU·共享/像素空白扫描 0 新增/全状态组合扫 0 异常);截图(EU 合计—·桌面 · GB+区间·桌面)_OVERVIEW_ALL_Report xlsx(UAE/KSA 各 25 天,09-01~09-25)Noon 回补(R2 半侧) Sku 页粒度=SKU 级,与 noon_ads_daily 表结构/币种/SKU 后缀/活动名全部对齐既有行——按唯一索引 (brand,report_date,country,ad_type,campaign_name,sku) 幂等 UPSERT 78 行(AE 41·183.67 AED + SA 37·408.94 SAR ≈ $159.06);SA 09-11/12 源报表空=如实 0 行;单表清洗层已刷新;回滚 DELETE FROM noon_ads_daily WHERE brand='onno' AND report_date>='2026-09-01' 后重跑单表清洗验证链 raw↔cleaned 双表 78 行一致;/api/ads/charts 26 个日点含 9 月;dashboard/kpi trend[10] 广告 $159.06 与 SQL 逐位一致;广告页(onno·Noon)脚注「数据止于 09-25」;双视口截图(桌面 · 手机)fg CSV 判读(R3 新证) Campaign 粒度=campaign×国家、无 SKU/ASIN 列,与 ads_sku_daily(SKU 级)粒度不匹配无法回补;但 09-18 当日文件证实 11 个活动行/$78.98——fg 广告缺 09-18 与 09-26 两天(zf 同日均正常),R3 已扩写并附验收 SQL;处置待拍板(不导入留档 / 新建 campaign 级日表 / 移交采集侧参照)未变 amazon_ads_daily(onno Amazon 侧)本次无文件仍缺;noon 源采集仍未恢复(文件止 09-25,pipe_stale 如实报 lag 4>2)_FG_INV 取全局 max(snapshot_date)——采集窗口内拉取只含已落库市场;2h 增量任务(worker cron 每偶数小时:43)随后 _snapshot_reconcile(window_where="true") 把本轮拉取里没有的 (brand,sku,marketplace) 键整段 DELETE → fg 非美国家被清空,下一轮窗口关闭后才恢复=用户看到的「库存明细仅美国站」间歇性复现。zf/onno 不受影响(库存源是实时当前态视图无快照过滤)修复 A(拉取侧) sync_mercury.py _FG_INV 改每市场各自最新快照((coalesce(country,marketplace), snapshot_date) IN (SELECT …, max(snapshot_date) … GROUP BY 1)),窗口内各国各取自己的最新一批,拉取恒含源表现存全部市场修复 B(对账侧) _snapshot_reconcile 新增 guard_idx 参数:仅删除 (brand,marketplace) 组合在本轮拉取集出现过的作用域行——源端「先全局清库再分市场写」模式(无运行日志表、不可排除)下也不整国误删;inventory_health 调用点传 guard_idx=(0,2)验证 ①mercury 实跑新 _FG_INV:8,809 行 / 13 市场(与本地 fg 行数逐位一致;当前窗口已关闭,新旧同值 13/13——分叉只在窗口内,错峰时序已证);②守卫语义模拟(SaaS 临时表+ROLLBACK):无守卫删 3 行(幽灵键✓但 CA/DE 整国误删✗=复现 bug),有守卫仅删 1 行幽灵键、CA/DE/onno 全保留;③api+worker 重建部署后手动跑 ingest_today:inventory_health: 8958 全量入库、_inventory_health_reconciled: 0(零误删),表内 fg 8,809/13 市场 · cleaned 层 AU,BE,CA,DE,ES,FR,IE,IT,MX,PL,SE,UK,US 全在;④四道门全绿(20s 间隔)。同步层无 UI 变化→行为验证(截图规则适用于可见变化,库存页 EU 桶 09-28 已截档)/api/dashboard/merged-kpi amazon.fees 值对账(月窗=API 同款两平台最新完整月 LEAST fallback,含 onno 分支,基准通过 17→18)——分叉复发即门红;dashboard_audit 无该端点断言无需动验证 四道门全绿(audit_nodes 18 基准含新锚);「全部平台」合并视图 UI 于 2026-09-16 用户拍板下架(代码保留),故为端点级验证;工作台双视口截图作部署回归存档(桌面 · 手机)max(2, min(注册值, 30%×基线))——实证 onno 订单基线日均 6.2 单,三天 0 单降 100% 差仅 6.2<10 恒静默(R1 漏报根因);连带修对比日错位:广告检查 lag=2(Amazon 站点日 T+1 批次轴,D-1 上午恒未落库——09-29 01:11Z 实测三品牌 09-28 广告行全空,按昨日对比=每个上午必然假报骤降),订单/销量实时表 lag=1 不变② pipe_domains 扩域 4→7 +排名 rankings_daily(snap_date,断>1天) +noon广告 noon_ads_daily(report_date,2) +库存 inventory_health(synced_at,1)。synced_at 为 2026-09-29 新列=每轮摄取时刻——last_updated 是源端行级变更时间(滞销品合法地旧,不能当同步水位):摄取 spec 15 列+SQL 双分支尾列 now(),手动 ingest 真跑 8,958 行/reconcile 0/三品牌行数无损;清洗引擎动态列自动透传(单表清洗已触发验证);/pipeline「库存健康」水位列同步换 synced_at。pipe_stale_rows 补 timestamptz 归一化——date−datetime 相减 TypeError 会让整函数抛异常再被铃铛 fail-open 吞掉(pipe_stale 整类静默归零,实测必现)③ 告警接入铃铛 /api/notifications/summary 加 vol_drop(四类→五类);顶栏铃铛新条目「数量骤降(vs 7日均值)」;/api/pipeline/status 加 drops 明细+管道页「数据新鲜度巡检」卡内新增「⚠ 数量骤降巡检」表(品牌/指标/7日日均/对比日/降幅)——铃铛点击不再死胡同实测(对照) 修复后三租户:onno 订单 6.2→0(−100%)/销量两口径同断全亮(修前恒静默);onno+zf 的 noon 广告 29 天断更入列(新扩域);排名/库存/全品牌零误报;zf 订单 −51%/日销量 −67%、fg 日销量 −63% 真实回落如实呈现;铃铛 summary vol_drop=5·pipe_stale=4 与函数级实测逐值一致验证 api/worker/web 三容器重建;四道门全绿;双视口截图(铃铛面板·桌面元素级 · 铃铛·手机 · 管道页骤降块·桌面 · 管道页·手机)ads_sku_daily brand='fittingirls' 855 行(campaign 级 sku=''),fg 30 天广告花费一度 $2,067.04→$2,835.47。用户质疑「foncye 哪来的 fittingirls」「你要核对 asin 和 sku」「FONCYE 是卖家账号,也是 noon 品牌」→ 立即取证,结论归属错误三重证据(全部 SaaS/mercury 库实测) ①同账号同日同国花费必须相等——实测 08-15 fg US $46.61 vs CSV $1.00(差 46 倍),112 个重叠 (day,country) 组全部不符;②fg 订单市场面 14 国无 SA/AE,CSV 却有 SA 285 行+AE 114 行(fg 不在这两国卖);③6 个活动名(G25/2001/2002/E27/1020S SP Auto+testing)命中 zipforce 搜索词库 5 个、fg=0(撞名=ON\* 型号命名习惯跨账号复用,非同账号证据);④全库 products/sku_mapping FONCYE 字样 0 条=未入驻账号回滚(三步完成) DELETE FROM public.ads_sku_daily WHERE sku='' AND campaign_name<>'';(精确 855 行)→ 单表重清洗(53,169 行/脏 0,campaign 行从 cleaned 层同步消失)→ 复核:fg 30 天广告花费精确回到 $2,067.04,audit_nodes 复跑 18 基准 ALL PASS,RLS/门无回归保留物(账号无关基础设施,无残留风险) ①schema:campaign_name 列+5 列主键(空表谓词,不影响任何现有数据);②口径四件套代码/基准(OR campaign_name<>'' 守卫现在匹配 0 行,纯休眠);③导入器 import_amazon_campaign_csv.py 加硬闸:--brand 必填无默认(本次事故根因之一是 brand 默认 fittingirls)FONCYE 归属待拍板 FONCYE=独立卖家账号(Amazon US/AU/SA/AE 四市场)+noon 品牌,系统内无对应品牌行——归属哪个租户/是否新品牌接入(brands_source 插行全链路自动)需用户拍板后才能再入库;文件留 /tmp/archive_0929/ 未删教训(进长期档案) ①「文件名品牌=库内品牌」是未验证假设——归属判定必须用账号级硬证据(同日同国金额对账/市场面/活动 ID),本次三重证据全部指向不符才半小时内闭环;②导入器永远不该有品牌默认值;③fg 的 Amazon 卖家显示名与库内 brand 无任何已证对应关系,此前「FONCYE=fittingirls 品牌名」的说法无出处,已废止ads_sku_daily 扩 campaign_name text NOT NULL DEFAULT '',主键扩 5 列 (brand,sku,country,day,campaign_name);旧唯一索引 uq_asd_sync4 在新代码部署之后 DROP(顺序错会在导入期撞重复键,已踩已修)入库 tools/import_amazon_campaign_csv.py(幂等可重跑)导入全量 855 行:US 228 / AU 228 / SA 285 / AE 114,07-31~09-25 共 57 天,总花费 $2,410.42——其中 SA/AE 399 行为 fg 从未有过的新市场广告数据(非单纯补洞)清洗层 campaign_shadowed(去双计核心) 同 (brand,country,day) 存在 SKU 级行时 campaign 行(sku='')不进清洗层:kept 407(AE 114+SA 285 全量 + AU 4/US 4 均 09-18)/ shadowed 448——mercury 将来回补 SKU 级后自动剔除当日 campaign 行自愈,结构上不可能双计KPI 效果(DB 级复算) fg 30 天广告花费 $2,067.04 → $2,835.47(+$768.43 = SA $419.71 / AE $312.56 / AU $23.37 / US $12.79);09-18 洞已按 campaign 级回补(15 行:US4+AU4+SA5+AE2)——R3 剩余诉求收窄为 09-26 单日(CSV 止 09-25)口径四件套 ①代码 10 处/7 文件(ads.py/finance.py/reports.py/mcp.py/metrics_store.py):METRIC 位(KPI·趋势·月度·ad_spend_usd)放宽 (coalesce(sku,'')<>'' OR campaign_name<>'') 或经 cleaned 直入,DIMENSION 位(Top SKU 列表/报表 sku 维/财务产品维)仍 sku<>'' 防伪空 SKU 组;②注册表 metric_calibers ad_spend filters.empty_sku 重写+事实注记;③audit_nodes 5 处基准镜像(kpi-cards ad_spend / amazon.cur.ad_spend / merged-kpi fees);④dashboard_audit 3 处(adsp/adsl/amz_base 镜像 _amz_kpi)连带修 audit_nodes cancelled/undeliverable 两基准 raw→cleaned 同表同谓词(noon_sku_status 原读 raw、API 读 cleaned,两轮清洗间 raw 先行 +5取消/+3无法送达造成 299 vs 304 型假 FAIL——rank-alarm 批 9 处的漏网 2 处),复跑 18 基准 ALL PASS新工具 tools/import_noon_overview_xlsx.py:onno Noon _OVERVIEW_ALL_Report 日报常态导入器(同批 50 份 xlsx 干跑验证:SA 37+AE 41=78 行,与 09-29 人工回补逐位一致)——两个导入器构成「用户文件→既有表」常态增量通道验证链 raw 855 行+幂等重跑 0 新增;cleaned 407/448 分桶复算;fg KPI 差额逐国分解;RLS SET LOCAL ROLE portal_app 三租户(t3=407 / t1=0 / t2=0,saas_admin 属主会绕过非强制 RLS 不可作证);四道门全绿(pen_tests / dashboard_audit FAIL 0 / audit_nodes 复跑 ALL PASS / frontend_e2e)+ 镜像固化×4 + chart_value;pipe_audit 7 FAIL = R1 源头断流已立案(需求单),非本次回归。口径层无 UI 结构变化且 t3 无登录凭证→按先例(fg-inv-sync)DB/SQL 级验证回滚 DELETE FROM public.ads_sku_daily WHERE sku='' AND campaign_name<>''; + 回滚代码/基准 + 重跑单表清洗;需求单 R3 已同步进展节secrets/smtp_pass 一个文件(双消费方自动生效,每次发信重读文件无需重启容器),心跳下轮自动补发积压报警验证 four_layer_audit 复跑 EXIT=1(仅已立案 FAIL,146 行已入 audit_results batch=2026-09-29-696f4da1);heartbeat 检查函数干跑=异常项恰为隧道断 1 项;13:07 正式跑日志确认新检查生效+邮件失败如实留痕(状态机未污染,每 10 分钟重试){brand}/amz|{brand}/noon 恒取 0;且 Noon 趋势跨国家 SAR+AED 本币直加(2026-02 旧值 221,938.67=混币数)修 API 侧统一走 core._noon_usd 单一事实源:矩阵表行级按国家折 USD(DB 级核对精确:688,739.38 SAR÷3.75=183,663.83 命中);趋势改 GROUP BY mon,brand,country 逐国家折 USD 再累加(2026-02 修后 59,557.88)。前端 MatrixSection 系列按真实 key 生成(图例 zipforce·AMZ / zipforce·Noon)级联 MatrixSection 仅工作台+财务页两处消费,一次修复双页生效验证 e2e 复跑 ALL PASS/exit 0;趋势画布中段彩色像素探针 1743(桌面)/887(手机) 非贴零;DB 级数值核对精确命中;截图(趋势图·桌面 · 趋势图·手机390)附注 矩阵表 Noon 行「件数」列=0:源表 cleaned_noon_sku_pl_monthly.valid_units 1288 行中 1281 行为 0(清洗层未填充),源数据如实显示非本次引入;如需补齐属源头数据需求单totals_usd.units 不吃国家过滤——_ord_map 查询漏 {cf},任一 country 下件数恒 3039(全量),SA 实为 2426——违反国家隔离铁律;修 dashboard.py _noon_kpi 加 cf(country 列与前缀推导 100% 一致已验证);生产实测:全部 3039 / SA 2426 / AE 613 / US 0,SA+AE=3039 加法封闭;该字段前端不渲染(分国家表只出订单/营收/净额)=API 数据正确性修复,Web 零像素变化审计基线对齐 dashboard_audit.py 基线冻结在 09-26 → 51 假 FAIL(09-27 口径变更随矩阵部署上线后未同步):①矩阵1 Noon 基准改真 30 天(gmv/net←cleaned_noon_daily_finance、orders/units←cleaned_noon_orders、广告=月窗 mon=sku_pl 最大月与 API 同构);②amz 基准 orders 去取消过滤(units/revenue 保留 FILTER,09-27 口径统一);③today/kpi-pool 基准全量切清洗表(API 全走 audit.cleaned_*,raw 有 2h 清洗滞后 → pending 13 vs 14 型时间差假 FAIL 根治);④noon 月度基准三表同步清洗层租户1 zipforce 四道门全绿:dashboard_audit FAIL 0/exit 0(51→0,raw/clean 时间差 WARN 亦全消,仅剩 5 条存量 sku_mapping 成本台账 WARN);audit_nodes 135 端点 ALL PASS;pen_tests ALL PASS(一次 429 时序假 FAIL:前置 2400 节点扫描耗尽限流窗口,隔离重跑即绿);frontend_e2e ALL PASS租户2 onno 参数化全量审计(onno+brainnews × noon30d/month × SA/AE/XX + amazon 13国 + kpi-cards 19卡×3平台 + today + 品牌加法恒等式 + noon 国家加和探针)FAIL 0(仅 return 卡 0.2% WARN);brainnews 全零品牌过滤验证通过租户3 fittinggoals(无凭据,DB 层同构验证) 以 API 真实 DB 用户 portal_app 实证 RLS 隔离:t1/t2 下 fittingirls 行数=0,t3 下=25,745 且总数恰=25,745(零跨租户泄漏);fittingirls 基准值:amz30d orders=1364(含取消)/units=1712/rev=$29,934.41/广告=$2,076.43,今日 41 单,8 月营收 $16,888 为已知源头断流(需求单在案);API 层验证待凭据(owner@fittinggoals.*** 密码本机/采集包均无)跨租户一致性 onno 品牌 KPI 租户1 vs 租户2 API 逐值相同:noon30d gmv/net/orders/units、amazon30d revenue/units/orders/ad_spend、kpi-cards 双平台全命中——同数据双视图+隔离同时成立待用户拍板 ①Noon 滚动窗口广告=9月月窗但广告源停在 08-31 → 显示 0(口径不一致:广告月窗 vs 其余 30 天窗;源头缺口需求单在案,选项=补源头 / 广告也改 30 天窗 / 维持月窗+脚注);②fittinggoals API 级验证需 owner@fittinggoals.*** 凭据aw = report_date >= current_date - 30 与同块四指标同窗。级联:dashboard_audit.py noon_base_30d 广告分支同窗、租户2 审计脚本同构、metric_calibers id=2 注册 filters.rolling_window(口径变更=代码+基线+注册表三件套)① 修后实测(生产) 全部 $979.34(SA 2,972.62 SAR=$792.70 + AE 685.42 AED=$186.64)/ zipforce $900.50 / onno $78.84——修前全部为 0;工作台「分国家·广告明细」表从空表恢复 SA/AE 两行(zipforce 视图 2,808 SAR/$749 + 557 AED/$152,与 API brand=zipforce 逐值一致);9 月缺口仍属源头需求单,30 天窗=窗内已到数据的真实花费② blank-tab 修复 财务页「月度对账」tab 按钮自 09-27 就在(注释「Amazon=全五枚」证明意图含它)但内容区从未渲染 {tab==="monthly"}——点开纯空白;补 <MonthlyTab brand={brand}/>(mercury gen_monthly_financials 三方对账口径:17 列 项目×月 P&L 37 行 + Noon Model×月 按国家分列 750+ 行;/api/finance/monthly 端点本就在线)验证(四道门+截图) dashboard_audit FAIL 0/exit 0(192+ 项,仅 5 条存量成本台账 WARN);frontend_e2e 70 项 ALL PASS(新增 7b 断言「财务月度对账tab渲染非空白」锁死回归);租户2 onno 全量审计复跑 FAIL 0(新 30 天广告基准全命中,仅存量 return 卡 0.2% WARN);双视口截图+OCR 目检过(广告明细 SA/AE 数值逐位命中、P&L 表 17 列真实数据)(广告明细·桌面 · 手机390 · 月度对账P&L·桌面 · 手机390)仍待用户 ①fittingirls API 级验证需登录密码(邮箱 owner@fittinggoals.***,本机/采集包均无);②观察项:两处「近30天 Noon 广告」锚点差一天——kpi-cards=北京锚 30 天含当天(zipforce $621.64)vs 工作台滚动=current_date-30 含首尾 31 天($900.50),差额恰=08-29 一天 $278.86,两处口径各自内一致,是否统一锚点待拍板/api/sourcing/search(配额/审计/429 全继承)双模式 主工具栏新增「数据源」选择器:ABA 词分析(快照+词库)(默认,原流程原样)|Keepa 实时搜索(耗配额)——直连 Keepa API 按 Keepa 域搜 top30 ASIN,返回 5 KPI(结果数/BuyBox 中位价/BSR 中位/平均评分/评论总数)+ 商品表(ASIN 链价格历史 viewer/Buybox/BSR/30·90 天掉价/FBA 卖家/评分/评论数)+ ⚡配额余量行(Redis keepaq:{slug}:{date},starter 套餐 50 次/天)三级级联 ABA 死胡同自动再兜一级:本地 ABA 快照 → Dell 大词库(4972 万词)→ Keepa 实时库——available=false 时自动转向(级联徽标「『词』不在 ABA 词宇宙…已自动转向 Keepa 实时库」),死胡同卡同步注明已转向;AE/SA/SE(无 Keepa 域)注明无法兜底防误导 Keepa 模式下隐藏旧 ABA KPI 行与全部图表墙(113 图 subtab 区整块 smode==="aba" 条件渲染)——实时模式下旧快照图表=误导数据,一律不显示;级联无结果时诚实空态「无结果——Keepa 实时库未返回商品」,KPI 缺项一律 — 不显 0防烧配额 Keepa 模式永不自动发请求(每次耗配额,仅显式点按钮/回车触发;切站点/切模式不烧);级联自动兜底只在真死胡同触发一次;切回 ABA 模式恢复免费自动重查域覆盖 前端 KEEPA_DOM 对齐 api 侧 13 站(US1 UK2 DE3 FR4 JP5 CA6 IT8 ES9 IN10 MX11 BR12 AU13 NL14);AE/SA/SE 无 Keepa 域 → 按钮禁用+提示「Keepa 不覆盖 XX 站」;WatchTab DOMAINS 同步补 BR/AU/NL(对齐 09-27 实测 KEEPA_DOMAINS 全集)验证 frontend_e2e 新增 7c 六项断言(选择器就位/ABA 默认/切 Keepa 文案/月窗+图表墙隐藏/AE 禁用+提示/切回 ABA 恢复)——回归门只断 DOM 不真发搜索,不烧配额;真搜索由截图自检脚本执行。四道门+e2e 76 项 ALL PASS/exit 0;双视口截图+OCR+视觉复核(桌面 20 行真实商品:AULA F75 Pro $68.99/BSR 62、AULA F99、Logitech MX、EPOMAKER、Redragon 系;KPI 20/USD67.99/470.5/4.5/42,143;级联卡诚实空态;手机 390 堆叠正常;脚本共耗 3 次配额 37→35)(实时搜索·桌面 · 手机390 · 死胡同级联 · 死胡同提示卡)附注 FBA 卖家列多为 —:stats=30 快照口径 Keepa 不回 offer_count_fba 全量,数据如实显示;33 项 ABA 图表墙/水位条在 Keepa 模式下不渲染属设计(实时模式无月窗概念)⚡ Keepa 实时(耗配额):直连 Keepa API 实时搜索(复用 /api/sourcing/search,零 API 语义改动,配额/审计/429 全继承),top 30 商品实时快照+5 KPI+⚡配额余量+ASIN 跳价格历史;②「全库」chip 从「该站点全部 ASIN」(过度承诺)改为如实标注 全库(本地档案池 · 1,142 条)——/api/sourcing/explore/fields 新增 pool_total,UI 自解释「为什么本地搜得少」;③Keepa 实时结果块抽共享组件 KeepaLiveResults(选品情报台+数据探索两处同口径)防误导 live 模式隐藏本地池专属的 38 项筛选墙/明细列选择/排序 chips/图表墙/CSV 导出(条件对实时搜索无效——显示即误导);无结果诚实空态不显 0防烧配额 live 模式仅显式按钮/回车触发(切站点/切范围不烧);AE/SA/SE 无 Keepa 域→按钮禁用+提示;回归门只断 DOM 不真发搜索验证 e2e 新增 7d 六项断言(三档就位/池容量数字/live 卡就位/筛选墙隐藏/AE 禁用/切回恢复),82 项 ALL PASS/exit 0;真搜索双视口+OCR 实证:本地 mirro=3 条(品牌 3/明细 3 行)vs Keepa 实时=20 行真实镜子商品(中位价 USD37.95/BSR 中位 4,406/评论 103,491,Arched Full Length Mirror/Delma/DUMOS LED 等),手机 390 堆叠正常;脚本共耗 2 次配额(35→33)(全库·池容量标注 · 本地匹配3条KPI · 本地明细3行 · Keepa实时20行·桌面 · 手机390)附注 本地池 3 条里中位 BuyBox 显 $0.00——池内快照 buy_box 缺失如实显示非 bug;池子扩容(按词自动落库实时结果)属后续需求,另行拍板/api/sourcing/search(配额 Redis keepaq/审计/429 全继承,13 站;AE/SA/SE 禁用+「Keepa 不覆盖 XX 站」提示);KeepaLiveResults 共享组件加可选 rankMode:结果按 BSR 升序+# 名次列(默认关——情报台/数据探索两处既有消费字节不变);live 模式隐藏池专属控件(根类目/ref chips/导出 CSV/到数据探索)不误导;永不自动发请求(显式按钮/回车)AI选品后端(agent 端点) api/routers/ai.py 新增 POST /api/ai/sourcing-agent:GLM-5.3 agent loop(anthropic 协议 /v1/messages + tools 数组)→ Keepa 官方 MCP https://keepa.com/mcp(stateless Streamable HTTP JSON-RPC 免 initialize,Bearer=既有 Keepa key,26 工具);三精选工具 search_products/get_deals/estimate_fees——search 工具内用既有 REST keepa_product 补评分/评论(MCP 永不回 rating/reviewCount:get_products 描述声称但 schema 与响应均无,参数以 tools/list 为准、响应以真跑为准);预算护栏=1 次 AI 配额+Keepa ≤3 次(AGENT_MAX_TOOLS=3,5 轮+1 强制终答轮);Keepa 预检先于 AI 配额扣减(Keepa 配额不足时 429 不白烧 AI 次数);预算耗尽的工具请求返回说明不计次;中途 429→tool_result is_error 优雅收尾;审计 ai.sourcing-agent + keepa_pull_log mcp:{name} + aiusage 配额计数AI选品前端(新 tab 第三位) MCP 10 站 chips(含 IN——COUNTRIES 缺 IN 本地补);AU/NL/BR/中东如实标注「Keepa MCP 暂不覆盖(其余 tab 的实时搜索仍支持 13 站)」;3 个预设问题;不自动发请求;结果四卡=AI 分析结论(副标题披露模型/Keepa 调用次数/剩余配额)/工具调用轨迹(✓/✗+参数+说明)/AI 检索的商品(rankMode 表)/AI 检索的促销协议先行实证(零配额验证) GLM agent 协议上生产前先用假工具三连探针跑通全链路(round1 stop=tool_use→round2 tool_result→round3 无工具强制终答),真跑一次成功;另探明 keepa.com/mcp 走 Cloudflare——python-requests 默认 UA 直接 403,须诚实自报 UA「ZIPFORCE-Hub/1.0 (MCP client)」验证 e2e 新增 7e 七断言(畅销榜双 chips/live 池控件隐藏/AE 禁用/切回档案池恢复 + AI 卡就位配额披露含 IN/MCP 不覆盖站点如实标注/不自动发请求),89 项 ALL PASS/exit 0;真跑截图自检:畅销榜 live「yoga mat」20 行(#1 Gaiam BSR 19,KPI 20 结果/USD23.87 中位/BSR 中位 137/4.6/546,434 评论);AI agent 真跑审计表精确对账——search_products 20 条 + estimate_fees×2(B01LP0U5X0/B07JQCVBBZ),GLM 结论四段式(结论先行/数据依据/建议清单/数据边界):FBA 利润实测 Amazon Basics -$2.67(-12.6%)vs B07JQCVBBZ +$5.89(21%/ROI 84%),明示月销/drops30 为 Keepa 估算口径+样本 Top20 边界+未覆盖维度;配额对账精确 33→29(1 实时榜+3 agent,keepaq zipforce 当日/50);双手机 390 视口无溢出(实时榜·桌面 · AI结论·桌面 · AI检索商品·桌面 · AI选品·手机390 · 实时榜·手机390)附注 MCP locale 枚举 search/deals 不含 AU/NL/BR(get_products/estimate_fees 另含 com.br)——AI 选品 10 站是如实子集非遗漏;AI 答案以 pre-wrap 纯文本显示(markdown 表格线原样可见),富文本渲染属后续打磨另行拍板api/ecommerce-glossary.md(09-24 上线, ~620+ 词条, 按 ZIPFORCE 业务域组织, 带平台官方指标口径注解如 ODR<1%/ACOS 口径); ②解析器 api/data_dict_meta.py: glossary_domains() 运行时读 md; ③消费端 GET /api/glossary → 前端入口: 左侧导航「数据字典」(/dictionary 页)→ 页内 tab「电商词汇(行业口径)」(与「字段字典(系统口径)」并列双 tab)+ MCP glossary 工具; ④公开快照 ecommerce-glossary-2026-09-24.md拍板(2026-09-27) 以官方版为主干不整体替换——理由: 口径注解是数据平台命门(词表=业务标准非纯翻译)/业务域与数据字典同构/量更大且全链路已通; CSV 的价值在官方版盲区域: Shopee 29 + Lazada 21 + 直播 14 + 短视频 6 ≈ 70 词条为未来增补素材(当日已实施并入 tab,经复查口径修正,见下)实施+口径修正(用户令「你要加到tab里面」,同日完成) 增补前用英文全称列全量复查,证伪初判「19 条缺失」——初版比对键只取中文名+缩写、漏了英文全称列(CSV「亚马逊自发货」与官方 FBM / MFN = 同一条 Fulfillment by Merchant),且英文全称匹配需人工分辨撞名假阳性(ERP=企业资源计划 vs Early Reviewer、Campaign=广告活动 vs 大促、Turnover=成交额 vs 库存周转、Merchant/Brand 子串);逐条复核结论 19/19 全部为「同概念不同叫法」,官方 md 零真缺失,CSV 404/404 全部命中官方行(含 Shopee/Lazada 等平台词);处置=不插重复行(曾误插 19 行已回滚),19 个 CSV 叫法以括号别名并入官方行:FBM / MFN(亚马逊自发货)、退货·本土退货(退货退款)、退货率(退换货率)、索赔(A-to-Z 索赔)、商品推广(商品推广广告)、品牌推广(品牌推广广告)、展示型推广(展示型广告)、预履行取消率(预配送取消率)、单会话购买率(会话转化率)、Subscribe & Save(订阅省)、大促(平台大促活动)、周转率(库存周转率)、时效(采购提前期)、星级分布(评分分布)、早评人(早期评论人计划)、评论操纵(操纵评价)、刷单/测评(激励评价)、差评移除(删评申请)——官方 md 维持 663 表行零新增;前端搜索为五列全匹配(词条/英文/缩写/释义/系统落点)故 CSV 用户的叫法全部可直接搜到上线与验证 改 api/ecommerce-glossary.md → 公开快照 ecommerce-glossary-2026-09-24.md 同步(663 行)→ build api + force-recreate api 容器(构建铁律)→ 线上验证 645 词条/18 域、10/10 别名抽检命中(亚马逊自发货/商品推广广告/预配送取消率/会话转化率/平台大促活动/订阅省/早期评论人计划/操纵评价/A-to-Z 索赔/退货退款);双视口截图自检过(1600/390:tab 选中+搜索「亚马逊自发货」命中 FBM 行;390 宽英文全称列被裁切为既有表格样式非本次引入,如实记录不越界修);回滚 backups/ecommerce-glossary-pre-csv-merge-20260927.md(改前快照);教训(不许猜铁律再验证) 比对键必须覆盖全部可匹配列(中文名/缩写/英文全称三列),漏列即产出假缺失清单(搜索命中·桌面 · 手机390)公开站 tab(用户令「放到 https://changelog.zipforcehub.com/」,同日) 新增公开页 /ecommerce-glossary.html——与 SaaS 词表同一份事实源(api md,生成器 zipforce-hub/tools/glossary_page.py,改 md 后重跑生成器+站框注入器即更新):645 词条/18 域与线上 /api/glossary 同数,四列子串搜索(词条/英文/缩写/释义)与 app 同逻辑,头部带 md 原文+用户 CSV 归档链接;全站统一导航新增 「📖 电商词汇」tab(NAV 第二位),注入器重跑 14 页同步;手机 390 词条竖排堆叠、英文全称完整不裁切(优于 app 页既有样式);验证 curl 200 · gl-row 645 · 双视口截图核验过(导航高亮+搜索「亚马逊自发货」命中 FBM 行+无溢出)(公开页·桌面 · 公开页·手机390)映射表(用户令「一列数据库关键字、一列我提供的CSV,一一对应,对应不上用 —」,同日) 新增 /ecommerce-glossary-map.html(全站导航「📋 词汇映射」第三位)+ 可下载映射表 CSV(列=业务域/数据库关键字/官方缩写/CSV叫法,无对应=—)——生成器 zipforce-hub/tools/glossary_map_page.py,匹配级联=中文精确→候选内英文/缩写消歧→英文全称→唯一缩写(歧义缩写不参与)→人工表 HAND 按(CSV中文,CSV分类)拍板;重名歧义实例全部落对节:秒杀→十三 Flash Sale(非五 限时秒杀)、退货退款×2 按分类分落三/十七、店铺券/优惠券按 Coupon/Voucher 英文各归十四/十六/十七/十;结果 CSV 404/404 全落点零悬空,官方 645 行中 400 行有对应、245 行 —;一对多 4 行(订单缺陷率/迟发率为 CSV 跨分类重名、本土退货·大促为双叫法)展示层去重;坑=f-string 内 JS 对象字面量 {{total:x}}、用户 CSV 英文全称藏在释义列首段;验证 curl 200 · gm-row 645 · 双视口截图核验过(导航高亮+搜索「库存保有单位」命中 SKU←库存保有单位行+手机 245 个 — 完整无溢出)(映射表·桌面 · 映射表·手机390)并入词汇表页(用户令「你要在 ecommerce-glossary.html 修改」,同日) /ecommerce-glossary.html 每行新增第三列「我的CSV叫法」(词条/英文/我的CSV叫法/释义 四列;— 紫字=CSV 未覆盖 245 行 · 有对应 400 行,与映射专页三方口径一致),搜索 data-k 并入 CSV 叫法(搜「库存保有单位」命中 SKU 行);实现=glossary_page.py 先 subprocess 跑 glossary_map_page.py(unresolved 即拒绝生成)再读映射 CSV 作列值——匹配级联单一来源在映射生成器不复制;两个坑(均已修) ① 读映射 CSV 须(业务域,词条)复合键——md 有头程/秒杀/优惠券/店铺券 4 个跨节同名词条,单词条键令「四、费用 头程」假继承「六、库存 头程」的值(401/244 假阳);② 原版 JS ALL={total} 被 f-string 渲染成 set 字面量,搜索后清空统计变「共 undefined 条」——修为 {{total:{total}}(映射页当时已修同款,词汇页漏网);「预履行取消率(预配送取消率)」词条长折两行为既有样式如实记录;映射专页保留作大表视图+CSV 下载入口;验证 curl 200 · gl-row/glmycsv 645 · dash 245 · 双视口复拍核验过(导航高亮+第三列双形态+共 645 条)(词汇页CSV列·桌面 · 词汇页CSV列·手机390)列头标注(用户令「每一列分别是什么呀?标注一下」,同日) 词汇表页搜索栏下新增列头行——词条(数据库关键字)|英文全称|我的CSV叫法(—=未覆盖)|释义(官方口径),页脚补四列文字说明;映射专页同款列头(数据库关键字(官方词表·英文/缩写)|我的CSV叫法(—=CSV未覆盖));手机端列头隐藏(竖排已有「我的CSV:」行内标签);桌面列头与行内容像素对齐核验过(词汇页列头·桌面 · 映射页列头·桌面)api/routers/ai.py LLM_PROVIDERS 四条:glm-main(生产默认)/ glm-backup / glm-old / kimi(Kimi 打破本地代理依赖:探明宿主 kimi-proxy 的实质是 Anthropic→OpenAI 协议转换,SaaS 容器直连公网 api.kimi.com/coding/v1 + openai 格式,llm_chat 双协议适配原样复用);key 全值只存 secrets 文件(compose secret → /run/secrets/llm_key_*,644),页面与接口只回 key_ok 布尔热切换 active 供应商存 redis llm:active 每次调用热读,失效/未设回退 env 默认 SAAS_LLM_PROVIDER=glm-main——改完即生效无需重启;llm_chat 与所有 AI 端点的 model 返回改为动态取当前供应商admin 端点(平台级权限) GET /api/ops/llm/providers(列表+active,不回 key 任何形态)+ POST /api/ops/llm/switch(切换前实测一发连通探针,失败立即回滚保持原供应商);权限=zipforce 主租户 owner/admin(其他租户一律 403)前端 设置页新增「🤖 大模型」tab:供应商表(模型/协议/端点/Key 就绪/当前标记)+ 切换按钮(二次确认+探针回声展示)实测 切 kimi 成功(探针 pong,直连公网验证);切回 glm-main 首发探针偶发失败被正确拒绝且未半切换(回滚机制实证),重试 3.1s 成功;AI 出口确认回到 glm-5.3;onno 子域双端点负测试 403×2门测 audit_nodes --refresh-snapshot ALL PASS(135 端点入库含新端点)/ pen_tests ALL PASS / frontend_e2e ALL PASS / dashboard_audit 首跑 3 FAIL 为瞬态(重跑 FAIL 0;WARN 5 条=既知 sku_mapping 成本权威欠账挂账在案,与本次无关)构建 api+worker+web 三镜像 build + force-recreate(secrets 新增三个文件须 recreate 挂载);回滚 私有备份目录 code-20260927-llm-switch-pre/ + redis del llm:active 即回 glm-main截图 设置页桌面 · 手机(双视口 4 行供应商表+当前 badge 齐整)tools/unify_site_frame.py 沉淀文档站NAV 列表写死;当前页按文件名静态注入 aria-current + .zfh-on 高亮,无 JS)+ 唯一站脚(站点说明 + 生产域名链接 + © 2026);<!--ZFH:HEAD/FOOT:start/end--> 标记对幂等——重跑原位替换即刷新,新增归档页跑一次脚本自动入列;注入块自包含 <style>、全部 .zfh- 作用域类不碰各页裸标签样式(防 header{}/footer{} 页样式串扰);深浅色跟随 prefers-color-scheme 双族适配片段页回退 6 页无 html/head/body 骨架(audit-clean/audit-solution/data-lineage/fix-log/fix-plan/system-manual,浏览器容错渲染)——头注锚点=首个 </style> 后(title/link/style 归 head、注入 div 起 body),脚注=EOF 追加;fix-log/fix-plan/system-manual 自带页级 sticky topnav 与站头干净叠放(滚走+吸顶互补),三页旧内容性 footer 保留正文、站脚另置最底;workflow-atlas 残页(meta-refresh 跳转)列入 SKIP 不注入验证 13/13 注入 + 重跑幂等(replaced 计数=1);线上全页 200×13 + /audit/ 前缀双路径 200;playwright 结构门 40/40(4 代表页 changelog/fullstack-map/audit-clean/fix-log × 桌面 1600/手机 390:站头存在 + 品牌 1+导航 10 + 站头 y<8 + 滚底站脚可见含 © 与域名);像素级顶条截带确认「变更日志」当前页 chip 紫底高亮正确、无重叠无裁切;fix-log 页双导航条叠放视觉确认手机 390 溢出定性(不越界) changelog/fullstack-map/audit-clean 三页横向溢出(scrollWidth 849/1307/399px)与改前备份逐页同值——溢出源为正文宽表格(表格宽至 1268px)与长文本,原已存在非站框引入(zfh-bar 自身恒 390 不溢出),按边界约定不扩大范围修正文,如实记录待后续专项生效方式 Caddy file_server 逐请求读盘,宿主写入即生效,无重启;回滚 backups/code-20260927-changelog-frame/(13 页改前快照)截图 站头顶条(高亮确认) · fix-log 整页(双导航叠放) · 站脚(全套 2026-09-27-zfh-frame-*.png 18 张)30 6 5 * *(每月 5 号 06:30 UTC=14:30 北京,避开 04:10 日更与 03:30 备份,Dell 上午采集已收):全量重灌(复用 aba-refresh.sh 全部防呆)+ 强断言「上月每国行数≥该国前 3 月中位数×60%,US/UK/DE/FR/JP/CA 六主站必须达标否则 exit 1 列明缺口」,中位数基线单月残缺不污染后续月;多租户等比副本不影响比值判据;注释写明日更已自然带新月、此任务仅完备性兜底;演练模式 ABA_GUARD_ONLY=1/ABA_GUARD_PERIOD=YYYY-MM验证 bash -n 过;守卫演练双跑:目标期 2026-07 全 14 国 OK exit 0(达标不告警);目标期 2026-08 逮住 US/CA/MX MISSING exit 1(缺 6726/5095/5019 行)——如实记录灵敏度事实:60% 判据下 DE 68.8%/UK 67.2%/JP 62.2% 的部分缺失刚好过线(判据为任务规定值未擅自收紧);crontab 先备份 backups/crontab-backup-20260927.txt 再追加,diff 确认仅 +1 行边界 不动 E1/E2/E3 冻结件与 web/api 业务代码;仅新增 aba-monthly.sh + crontab 一行 + 本 changelog 条目 + 需求单;无页面改动故无截图;凭据全程只在 mercury 侧 .portal.env 注入未出 mercury 未打印;/opt/six-claude/workspace/saas 非 git 目录、无既有文件改动故无 tar 快照需求GET /seller?domain&seller=ID:sellers 是 dict 按 sellerId 键非 list(首版探针按 list 取打空);计量 Δ1 token/卖家、批量逗号分隔线性(3 个=Δ3)、stats 参数无影响;名字直搜 HTTP 400 "no valid sellerIds"(仅支持 ID);Keepa UI 的「按类目筛卖家」走内部 pro/sellerfinder(bundle 实证 query 风格+merchantNames)要求登录不公开——不冒充同口径,热销榜改本库聚合方案。payload 30+ 字段族实测:ratingCount/positiveRating=[30d,90d,180d,365d] 四元数组;csv[0]=评分时序平铺 [t,v,…](0~100);totalStorefrontAsins=[t,count];sellerCategory/BrandStatistics、competitors([{sellerId,percent}])、address(list)、phone 可缺改动 ①pg-init/73:全局 raw 层 keepa_seller_raw(payload jsonb,portal_app 无权限)+ 租户 clean 层 aba_seller_full(33 列含 rating_series jsonb [[unix,0~100],…],RLS 照抄 aba_keepa_full);②43 个 US BuyBox 赢家卖家全量回填(Δ43 token)+ 晋升 tools/keepa_promote_sellers.sql(幂等,129 租户行,123 有评分序列——Amazon 自营无评分=真值);③sourcing.py 两端点:GET /sellers/top(本库 BuyBox 赢家榜聚合:wins=count(DISTINCT asin)、样本 ASIN/均值价/评分,零 token)+ GET /seller-lookup(13~14 位 ID 直查命中零 token;未入库 live=1 走配额门→_keepa_seller_fetch→Python 解码镜像晋升 SQL→只落本租户行(RLS WITH CHECK 语义,其他租户查询时各自落)→pull_log 记账;非 ID 一律名字 ILIKE 已拉库+池内 wins 联查);类目统计附挂 catId→显示组翻译名(池内无则显式缺不猜);④web 主 tab 「🏪 卖家」(SellerTab):榜表点行查档案、档案卡=6 KPI+评分历史 EChart(0~100 缩放)+四窗评价数表+主营品牌/类目 Top+竞争者 chips(可点连查)+地址电话评分时序平铺解包(两层聚合口诀) csv[0] 单趟 WITH ORDINALITY(1 起始)奇序=ts、偶序=val、(ord+1)/2 同 i 配对——单趟解包每行 ts/val 互斥,WHERE ts AND val 恒灭全行(首版 0 行教训);必须内层 GROUP BY i 后 max(ts)/max(val) 聚对 + HAVING ts>0 AND val∈[0,100] 滤哨兵,外层 jsonb_agg(ORDER BY i) 按卖家聚合;另 jsonb_array_elements 前必须 typeof='array' 守卫(部分卖家 csv[0] 是标量)两个 bug 门/冒烟逮出 ①卖家 ID 13~14 位:ATVPDKIKX0DER(Amazon 自营)=13 位,首版 14 位正则把它漏进名字路径 → 放宽 A[A-Z0-9]{12,13}(Zappos AH1YFAUS3NHX2 也是 13 位);②psycopg2 %s 与 %(name)s 不可混用("dict is not a sequence")——live INSERT 前三列占位符改全命名式验证 专属门 /tmp/keepa_seller_gate.py 30 断言 ALL PASS(A 榜单 43 家/Amazon 自营 389 wins 首位/降序/池内口径 1167=389×3 互证 · B 13 位 ID 走 ID 路径回归/富卖家 203 点序列升序 0~100/类目翻译名/未入库 hint/无效站点 400 · C live 落库回查 Zappos 3105 点+pull_log 记账+本租户行 · D 名字命中/无匹配显式 hint · E UI 榜 43 行/档案/评分图 canvas/四窗表/⚡按钮/手机 390 无溢出);四道回归门逐道全绿(dashboard_audit 192+ FAIL 0 · frontend_e2e ALL PASS · audit_nodes 新端点按设计先 FAIL→--refresh-snapshot 登记 130 端点 ALL PASS · pen_tests 压轴 ALL PASS);三截图视觉确认(榜单·未入库显式灰字 / 档案·KPI+紫线评分图+品牌类目+竞争者 chips / 手机 390 竖排正常)边界/回滚 快照 backups/saas-pre-keepa-seller-20260927.tar.gz(sourcing.py+page.tsx 改前版)秒级可回滚;拉取器/探针会话临时件零落盘凭据(key 容器 secret 只读进内存);token 账本:POC 探针+回填 43+live 测试共耗 ~640,桶回充后余 ~560(refill 20/min);「cab」三项(C 分期四 viewer+tracking / A offers 铺开 / B 卖家两页卡)全部完工,蓝图分期一~四全部上线(热销榜·桌面 · 卖家档案·桌面 · 卖家页·手机390)tools/keepa_promote_offers.sql(幂等可重跑,MATERIALIZED CTE 剥鲸鱼,守卫 payload ? 'offers');③sourcing.py:_PVIEW_SERIES 全改三元组 stride-aware 解包 + explore 注册 4 新字段三处(_R12_FIELDS/_BOOL_FIELDS/fields 元数据);④ViewerTab:价格大图 +BuyBox 黑线(Keepa 视觉对照),badge 动态「已解锁(offers 采集)/无数据(待铺开)」,BuyBox KPI foot「offers 已采/未 offers 采集」哨兵事故与三连修复(POC 段揭出) 首版守卫 stats ? 'buyBoxPrice' 失效——无 offers 的响应该键存在恒 -1、retrieved/FBA/FBM 键存在恒 -2 → UPDATE 全表扫 3542 行,-2 泄入 3 列;修复=守卫改 payload ? 'offers' + int 列一律 ~ '^\d+$' 非负守卫 + buy_box_price 加 current[19] COALESCE(无 offers 时恒 -1 原本就进不了列,基线零损伤实证);铺开段又逮 7 行:offers 数组有货但 Keepa 聚合并发未完成回 fba/fbm=-2(7 个 ASIN 全部 0 活跃报价=已下架)→ 39-41 行表达式补同款守卫重晋升,-2→NULL(无数据),totalOfferCount=0 与 0 活跃报价自洽保留(非误导 0)定量铺开(token 余量倒推) 桶回满 1200、停拉阈值 150 → 取 US 按 BSR 升序未铺开 Top140(候选池 1122),批次 20/请求 7 批 140/140 ok · 0 miss,tokensLeft 1200→371(批次成本 120~143t 波动,Keepa offers 处理偶发慢批 ~3 分钟属正常);拉取器 docker exec -i stdin 注入(忘 -i 则 python 读空脚本静默退出——本段踩过);铺开后晋升 UPDATE 478 租户行 + pview 缓存清 2 key + 端到端抽查 B00MW8G62E:source=local、buy_box_price 562 点、末点 $19.20 与 meta 互证终态非空率(n=160 distinct ASIN,对照 POC n=20) csv[18] BuyBox 时序 160/160=100%(viewer 全量解锁)· last_buybox_update 100% · offer_count_fba/fbm 153(95.6%) · import_fees 159(99.4%) · buy_box_price 148(92.5%,POC 100%→规模化后 12 个真无 BuyBox 属实) · is_fba 152(95%) · is_prime 145(90.6%) · seller_id 145 · condition 144(90%) · retrieved 80(50%) · shipping_country 1(0.6%,一个 EU 进口件——结构性判断成立) · trade_in 0(0%) · 负哨兵清零(7 已下架 ASIN 全 NULL)验证 专属门 /tmp/keepa_offers_gate.py 17 断言 ALL PASS(A 时序真值升序/现势 · B DB 落库无哨兵 · C explore 4 字段+FBA/成色筛选命中——explore 响应键是 rows 不是 items · D badge 双态 · F 手机 390 无溢出);四道回归门逐道全绿(dashboard_audit FAIL 0 · audit_nodes 128 ALL PASS · frontend_e2e ALL PASS · pen_tests 压轴 ALL PASS);三截图视觉确认(viewer 已解锁态 BuyBox 黑线+$24.81 / plain 未铺开灰 badge 显式无数据·图例无 BuyBox / 手机 390 竖排正常);铺开段纯数据层(只动 tools SQL+DB 行),API/web 代码零改动无需重跑回归门边界/回滚 快照 backups/saas-pre-keepa-offers-poc-20260927.tar.gz(sourcing.py+ViewerTab.tsx 改前版);拉取器会话临时件零落盘凭据(key 容器 secret 只读);token 账本余 371(给每日监控刷新+B 项 /seller POC 留底);下一步「cab」末项 B:/seller 端点 POC 摸计量与返回形状 → 热销商家列表+卖家查询两页卡(R3)(offers·viewer 桌面 · 未铺开·显式无数据 桌面 · offers·viewer 手机390)GET /api/sourcing/price-history?country&asin&range&live:本库 csv 时序走 SECURITY DEFINER 白名单投影函数 keepa_csv_series(domain,asin)(portal_app 对 keepa_product_raw 仍无表权限,12 序列白名单)+ redis 6h 缓存(≤2.5MB 防大 value)+ 降采样上限 3000 点/序列 + range 切片(all/3y/1y/90d/30d);未采集 ASIN 显式 source=none+hint(不误导 0),live=1 走 keepa_history 实时兜底(1 token/ASIN,24h 缓存);响应带干净层 meta + 关注/提醒状态;②web/app/sourcing 新主 tab 「价格历史」(ViewerTab):价格历史大图(Amazon橙/New蓝/Used绿/List紫/收藏品/秒杀,Keepa 视觉对照配色)+ BSR 排名(y 轴反转小=好)+ 报价数 + 评分·评论双轴四图,全图滚轮缩放+缩略刷;KPI 头卡(品牌/BSR/月销/BuyBox/New/Amazon/评分/评论/上市/时序覆盖)+ 数据源 badge(本库 csv 零 token / Keepa 实时 1 配额,BuyBox/FBA/Prime 序列显式标「无数据(需 offers 扩采集)」);③价格提醒 tracking:keepa_watch 表加 alert_price/alert_dir(below|above)/alert_active/alert_triggered_at/alert_notified_at 五列(pg-init/71),watch/alert 端点(设价>0 武装+清零重新武装;price=null 只灭 active 保留旧价不误导)、viewer 未关注 ASIN 一键「关注+设提醒」、监控池行内设/清提醒列;worker 每日 05:10 刷新后 eval_keepa_alerts(tasks.py):现价=coalesce(buybox,price_new) 最新快照,below(≤)/above(≥) 触发,一次性(notified 置位即排除,改价重新武装),按租户查 owner 邮件 best-effort 不阻断;④三处 ASIN 跳 viewer:数据探索/畅销榜/监控池行内 ASIN 链接(mtab=viewer&vasin&vcountry 种子)验证 专属门 /tmp/keepa_phase4_gate.py 33 断言 ALL PASS:[A1-A12] 本库真值(source=local·amazon>100点·rank>1000·时间升序+价格合理·降采样≤3000·90d 切片·非法 asin 400)[B1-B2] live 兜底(keepa_search 实取真 ASIN B07KRY43KN,6416 点,不猜)[C1] 未采集=none+hint [D1-D11] tracking 全闭环(watch→alert above/0.01→落库 armed→docker exec eval→触发 t|0.01|t|t→二次 eval 不重置→重设重新武装→清除灭 active→DELETE 清理)[E1-E6] UI(4 canvas·badge·无数据态·explore/bestseller/watch 三处跳转)[F1] 手机 390 无溢出;四道回归门全绿(audit_nodes 新端点按设计先 FAIL→--refresh-snapshot 登记 128 端点 ALL PASS · dashboard_audit FAIL 0 · frontend_e2e ALL PASS · pen_tests 压轴 ALL PASS);三截图视觉自检过(无数据态无误导 0)数据口径实证(视觉自检逮出的疑点闭环) 价格大图 New 序列多次下探近 $0——查库:csv new 序列 2531 点零个 0 值、6 个负值哨兵(_pview_convert 已滤),下探是史实 1 美分 glitch 报价(vmin=1 分,第三方卖家错误标价,Keepa 官网同样显示)→ 忠实呈现非误导 0,不改代码;查询口诀:jsonb WITH ORDINALITY 1 起始,值在偶数序(i%2=0),首查 i%2=1 错选时间戳(vmin=119520 恰是 2011-03-25 的时间戳)自纠挂账(存量故障,非本分期引入) SMTP 526 Authentication failure:/run/secrets 四文件齐全、_smtp_cfg 读法正确、user @zipforcetek.com,容器内只测登录同样被服务商拒——全站出站邮件瘫痪(发票 po_pdf/管道告警 daily_pipe_alarm/价格提醒全发不出),需服务商侧修复凭据,eval 邮件 best-effort 不阻断提醒落库边界/回滚 快照 backups/saas-pre-keepa-phase4-20260927.tar.gz 秒级可回滚;只动 sourcing.py(+2 端点)+tasks.py(eval 函数)+page.tsx+ViewerTab/WatchTab+pg-init/71(五列)+投影函数,不触采集管道/explore;Keepa 凭据零落盘;token 账本:本段消耗 ~12(live 测试+search 探针+watch pulls),余 1190;下一步按「cab顺序做」→ A offers POC(20 ASIN 小批验证 buyBox/IsFBA/PrimeEligible/ShippingCountry 真值)→ B /seller POC(viewer·桌面 · 无数据态·桌面 · viewer·手机390)/run/secrets/keepa_api_key 只读进内存不打印不落盘):三租户×(US 1142+AU 48) 去重 1190 ASIN,/product?stats=30..365&history=1 一把拉 → 1190/1190 零缺失([DONE] total=1190 ok=1190 miss=0),NDJSON 511MB 存档 keepa-ui-archive/keepa-raw-pull-20260927.ndjson(csv 时序原料同车入库,分期四 viewer/tracking 的原料就此备齐);②装载 tools/_keepa_raw_load.sh:NDJSON→CSV→\copy keepa_raw_stage→upsert 全局 raw 层 keepa_product_raw(PK domain_id+asin,payload jsonb,REVOKE portal_app)1m44s;③晋升 tools/keepa_promote_r12.sql 纯 SQL:105 表达式全打在剥鲸鱼后的小对象上,1190 行 22 秒(vs v1 12 分钟跑不完),全局 1190 → 租户行扇出 3542哨兵语义(库内实测零猜测) 时间戳缺失∈{-2,-1,0}→NULL,负数分钟合法(listedSince=-2063415≈2007-02,正则必须 ^-?\d+$));价格/计数<0→NULL;coupon/lightningDealInfo 键恒在缺=空串→NULLIF 判存在;stats.min/max=[[t,v]对数组]值取 ->i->>1;keepa 分钟→unix=(t+21564000)×60;monthlySoldHistory 单趟 unnest 奇偶配对(vals ord 偶 JOIN times ord=v.ord-1)出月销峰值+峰值日期表结构 pg-init/69(95 列)+ 70(实测 stats 真值后净新 7+既有 3):aba_keepa_full 137→147 列;explore 注册四处齐动:_R12_FIELDS 白名单(95+10 直映射 k.{f})+ /explore/fields 新组 10 个(价格窗口均值(R1) 29 项含全史 min/max/avg、报价窗口、最低价/缺货、BuyBox统计(R2) 14 项含运费、产品属性(R4) 17、布尔/合规(R5)、变体/媒体(R6)、日期(R7) 8、销量扩展(R8) 含月销峰值、促销(R9)、尺寸扩展(R10) 8)+ 排序白名单 +6(全史最低/最高/Amazon全史均价)+ 前端 GROUP_HINT 同步;字段总数 141boolean = text 500;修复=模块级 _BOOL_FIELDS 全集 23 字段(与 _R12_FIELDS 同推导式单一来源)②晋升 SQL 性能病理:payload 内 csv=332MB/500行(664KB/行)+salesRanks=68MB 是鲸鱼,v1 每表达式/每元素重复解压整份 payload(百 GB 级重复 memcpy)→ v3 MATERIALIZED CTE 先剥 14 个鲸鱼 key 得 ~2KB 小对象 p(整行只解压一次),500 行 12 分钟跑不完变 14 秒验证 专属门 tools/_shot_keepa_phase2.py 全绿:[A] 字段元数据 10 组全在位(R1≥29 全史≥6/R2≥14 运费=1/其余组>0/总数 141)[B] 六类筛选命中(90天均窗 1043 · 自营BuyBox 390 · 上市≥1995 1052 · 月销峰值≥1 1103 · 全史min≥0.01 1110)[C] 无数据列 NULL 显式+真券>0 [D] UI 实操:数字范围+三态+日期起止组合筛=233 行与 API 直查精确一致(门里先清 explore 默认关键词才对上)[E] 排序含全史 min/max [F] 手机 390 无溢出。四道回归门全绿(dashboard_audit FAIL 0 · audit_nodes 无新端点 ALL PASS · frontend_e2e 首跑 2 FAIL=429 限流噪声级联复跑两连绿 · pen_tests 压轴 ALL PASS——run1 的 L toggle-on 也被 429 打中致 listing 模块留在 OFF,照抄 pen_tests 的 JSON+origin 登录格式直连恢复 ON 后复跑全绿)边界/回滚 快照 backups/saas-pre-keepa-phase2-20260927.tar.gz(sourcing.py+page.tsx+DDL 两份改前原版)秒级可回滚;keepa_product_raw 为全局 raw 层新表(portal_app 无权限,只经晋升 SQL 白名单列进租户 clean 层,四维隔离不破);Keepa 凭据零落盘(secret 只读+会话命令行用完即删);分期三决策点:offers POC(+5 tokens/ASIN≈5950 解锁 BuyBox 价/FBA/Prime/发货国/条件计数全统计族)vs /seller 端点(卖家两页卡 R3)vs 先分期四价格历史 viewer(csv 原料 511MB 已全量入库)(全部字段组·桌面 · 组合筛选 233 行·桌面 · 数据探索·手机390)/query 端点真 key 验证 200 + 全功能复制蓝图生产已上线wss://push.keepa.com 二进制压缩帧,HTTP 监听抓不到是也);③Round3 决胜——登录弹层实测(#username/#password/#submitLogin,主页点 Log In / Register 弹出,#!login 不渲染表单)+ Cloudflare 反检测三件套实测通过(--disable-blink-features=AutomationControlled + navigator.webdriver 删除 + 正常 Chrome UA)。核心突破:finder DOM 内 1486 个表单控件 / 去 widget 前缀 429 个唯一字段名(存档 finder-field-ids-full.txt + finder-field-names-unique.txt)——29 个窗口族(SALES/RATING/AMAZON/NEW/NEW_FBA/USED×4成色/BUY_BOX×2/COUNT×8/EBAY×2/LIGHTNING_DEAL/LISTPRICE/WAREHOUSE 等,各 14 变体 current/avg30~365/deltaPercent1~90/isLowest/outOfStock/lastPriceChange)+ 105 非窗口字段(buyBoxStats×20/月销族×6/salesRankDrops×4/尺寸×10/日期×5/属性×25/卖家 textArray×5 含匹配类型选择器);widget 前缀=语义(numberFrom/To·dateFrom/To·boolean-checkbox·singleChoice·text·textArray+Type·autocomplete+Type)官方线格式(零猜测) Keepa UI 自带「显示API请求」按钮(#filterQuery)——填筛选值点击即吐官方明文:GET api.keepa.com/query?key=…&domain=1&selection={JSON},selection 内 _gte/_lte 后缀 + ### 分隔 50 值 OR(Keepa UI 原文逐字,A 项已照抄)+ sort:[[字段,dir],…] 多级数组 + perPage≥50(实测 3 报 400)+ page 0 基 + 自动附加 lastOffersUpdate_gte 保鲜;库内真 API key 验证 200:title=keyboard@.com → totalResults=1,286,300,响应 asinList(50/页)+tokens 计量(11 tokens/20ms)——/query 回 ASIN 列表、明细走 /product;「查找产品」(#filterSubmit) 实跑命中 4,599 产品截图存档GET /api/sourcing/category-tree?country=(api/routers/sourcing.py):root_category → sales_rank_reference 两级树,标签与 /explore/fields C 项完全同规则(显示组频次多数派,root 多组共现标「等N组」),每节点带产品计数,附 total/unclassified(未返回参考类目产品显式亮出不静默丢弃);②web/app/sourcing/page.tsx 新增两主 tab:畅销榜(根类目 chips→参考类目子 chips 两级联动·复用 POST /explore 按 bsr_current 升序 Top100·列=ASIN/标题/品牌/BSR/月销/新品价/评分/评论·CSV 复用 /explore/export)与类目树(统计行+根类目卡+子 chips,点子类目携 root+ref 跳畅销榜看榜);③跨 tab 种子:类目树/畅销榜关键词框 → 跳「数据探索」自动搜索(父组件 key 强制重挂载+initialTerm),search 页按蓝图裁定并入 explore 不单开页验证 专属门 tools/_shot_keepa_phase1.py 最终全绿:[A] 两新 tab / [B] 全类目 chip+BSR 前5升序断言 / [C][C2] 根→参考两级联动(xpath 定位「参考类目」span 邻接 button)/ [D] 类目树 24 根卡+统计行(body innerText 正则)+子 chips≥20 / [D2] 子 chip 跳畅销榜带条件且可读名非裸 ID / [E] 关键词种子(keyboard→探索框自动搜索 KPI 29) / [F] CSV 按钮 / [G] 口径交叉验证(树 root 计数=explore eq 命中 169=169 · ref 计数 160=160)/ [m] 双视口 1600+390 无横向溢出;门逮住两个真 bug 修复后才全绿:①BestsellerTab 挂载 effect 清空类目树带入的种子(显示「全类目」而非所选参考类目)→ useRef(false) 首挂载守卫,仅站点真切换才清;②子 chip 只传 ref 未传 root → 畅销榜显示裸「ID 3760901」→ onPick 改传双键,断言收紧拒绝 "ID "。四道回归门全绿(dashboard_audit 192+ FAIL 0 · frontend_e2e ALL PASS · audit_nodes 新端点按黑名单机制先 FAIL → --refresh-snapshot 登记 128 端点后 ALL PASS · pen_tests ALL PASS 压轴,均逐道单独跑)边界/回滚 改 api/routers/sourcing.py(+1 端点)+ web/app/sourcing/page.tsx(+2 tab+种子),不触 DB/表结构/采集;explore/fields/export 零改动(树端点独立只读);快照 backups/saas-pre-keepa-phase1-20260927.tar.gz 秒级可回滚(改前两文件原版);分期二(finder 窗口族筛选全量补齐)卡 B 单 R1/R2 采集落库、分期三(卖家两页)卡 R3、分期四(价格历史 viewer+tracking)卡时序管道——按蓝图顺序推进(畅销榜·桌面 · 畅销榜·参考类目联动 · 类目树·桌面 · 关键词种子跳探索 · 畅销榜·手机390 · 类目树·手机390)#{2,} 切分多值任一命中(OR ILIKE),单 # 不切保住「C#」类真词,>50 值显式 note 截断拒绝静默丢,空值入 dropped 回报;前端 like 输入框 placeholder+title 提示。B 扩采集需求单 keepa-expand-requirements-2026-09-26.md:档③ 90+ 项无数据字段按 R1~R10 分组(P0 价格/BuyBox 窗口统计族、P1 卖家维度整块+属性族+合规布尔族、P2 变体/日期/优惠/尺寸族),全部用 PDF UI 原文逐字列项,英文字段名以 Keepa API 文档为准不猜。C audit_nodes 时区日界修复:kpi-cards ad_spend 两条基准 FAIL 根因=基准 SQL 用 current_date(UTC 日)而 API 用 bj_today 北京日——北京时间 0~8 点窗口跨日界(实测 09-27 凌晨 API 窗口 08-29 起而基准 08-28 起,08-28 单日 zf noon 266.80 全额漂移)+ 76 行还在读 public.noon_ads_daily 原始表(API 已 F2-6 单源 cleaned);两条基准统一「北京日下界+上界+清洗表」与 API 同式后复跑全绿,另 RLS 租户口径实证(API 视角 onno 不在本租户,AB 活跃品牌过滤恰好同口径)。Keepa 权威源落地 用户上传 Archive.zip 5 张 Keepa 页面 PDF(产品搜索工具/热销商家列表/卖家查询/产品查看/Best Sellers List)——Read 工具 PDF 渲染器本机未装(poppler)但 pymupdf 内嵌文本层逐字提取成功(4133/4435/2833 字符,比截图更准零视觉误读),存档 keepa-ui-archive/(5 txt+5 png+keepa.js bundle 1MB);crawlbase 双 token 实测:公开页可渲染(拿到 #! 路由全表 15 条:finder/viewer/bestseller/topseller/sellerlookup/categorytree/deals/tracking/data/manage/notification/news/api/features + 11 国站点导航),但工具页全部登录墙内(keepaApp=!1+localStorage.token 64 位检测,渲染后仍空壳)→ 遍历需登录态:Playwright 本机直连通畅(keepa.com CDN 不挡本机 IP),遍历器 tools/_keepa_traverse.py 已备(token 注入/账密登录两模式,逐页截图+DOM+XHR 抓包=筛选参数英文原名最权威来源),待用户提供凭据即跑backups/saas-pre-title-or-20260926.tar.gz;C 改 tools/audit_nodes.py 两条基准 SQL(不触生产代码,audit 门工具);keepa-ui-archive/ 为只增存档;凭据(用户 Keepa 账号/token)只进会话临时用完即删不落盘(整页 · 标识卡·含新placeholder · 类目卡 · 手机 390)backups/saas-pre-explore-keepa-20260926.tar.gz 秒级可回滚(改前两文件原版);(整页·桌面 · 头部卡 · 标识卡 · 类目卡 · 手机 390)backups/workflow-atlas-standalone-20260926.html + backups/fullstack-map-pre-flowmerge-20260926.html 秒级可回滚;门断言并入 tools/_shot_fullstack_map.py 可复跑;changelog 导航保持单链接backups/fullstack-map-pre-5th-20260926.htmlsaas-snapshot-pre-abcd-0926.tgz + saas-snapshot-abcd-d-extra-0926.tgz(回滚锚)· 回款·桌面 · 库存 chips·桌面 · 订单·桌面 · 物流·桌面 · 排名·桌面(各配 390 手机版共 10 张)用户指出 noon 样品早已投递——mercury /root/noon-data/exports/ads/ 下 129 个真实导出(AE 129 xlsx + SA 按月目录)实证:真实格式是 xlsx 多 sheet 而非 CSV(_OVERVIEW_{段}_Report_{日}_{日}.xlsx,11 个 sheet,数据在 (Product) Sku 13 列英文表头,(Brand)/(Display) 实测全空;日期只在文件名、国家只在目录名——新导出文件名段是 ALL 无国家信息)。三决策按实证落地:①适配器 openpyxl 直读 xlsx(区间导出拒收——多日聚合无法按日拆分;同日同国双文件拒收——防两国同名文件叠加错数),CSV 路径保留兼容;②国家解析链=应用内选择 > 文件名 UAE/KSA 段,ALL 文件必须显式选(不许猜),上传卡 noon 平台下新增国家下拉;③导入语义改按(日,国)整体替换——根治 mercury 遗留双 ad_type 约定(product≤07-30 / sp≤08-31)并存时 noon_ads_daily 求和双计,顺带清掉消失 SKU 僵尸行。ad_type 定 'sp' 对齐最新约定;派生列与 noon 自算 CTR/ROAS/CPC/CPS/CVR 逐位一致。修复一个 G 批潜伏缺陷:API 落盘把原文件名抹成 {job_id}_{brand}.xlsx,而 xlsx 元数据在文件名里 → 落盘名改为保留原文件名(job_id 前缀保唯一+非法字符替换)。
用户令「所有广告分 2 种方式:能自动的自动,不能自动的手动——手动走上传数据+按钮触发统计与分析,除自动/手动区别外其他完全一样」。落地后 6 条源通道矩阵(/api/ads/sources,事实源=mars config.CAPABILITY):zf/amazon 自动(Ads API 02:00)· zf/noon 手动 · fg/amazon 自动(03:30)· fg/noon 无此通道(无站点)· onno/amazon 手动(无 Ads API 唯一源)· onno/noon 手动。链路:上传(预览解析→确认入队,CSV/ZIP≤50MB)→ API 落盘 /srv/uploads/{tenant}/ads-import/ + ads_imports 表入队(RLS 租户隔离)→ worker ads_import_pump(arq 每分钟 cron + Redis 锁 + FOR UPDATE SKIP LOCKED)分派采集适配器 → 定向同步(只刷该通道涉及的广告表,非全量)→ clean_audit 定向清洗 → CleanDataRefreshed 广播,全程任务列表 5s 轮询可见;独立「立即重算统计」按钮(不传文件,重跑全部 6 张广告表)。采集侧:新增 adapters/noon_ads_csv.py(宽容列名映射 11 字段中英文、5 派生列公式与 mercury 遗留行 3/3 逐位校准、UPSERT 后传胜)与 amz_ads_csv.py(59 列、profile_id='manual'、campaign/ad_group 缺 ID 时 md5 合成、onno 走既有 onno-ads-csv 不变);onno/amazon 上传同时归档到 dropbox 保持采集侧口径。MySQL→PG 全链与 ABCDE 批同构:noon→{schema}_ads_skus、amz→{brand}_ads_advertised_products,经 mercury 中台再 ingest,四维隔离与清洗层一视同仁。待办:noon 后台导出样本到件后定稿列名映射(当前宽容映射+预览确认兜底,两处同步改)。
第 32 轮 P1×6 的结构性根治:kpi-wall 自 09-18 就有 brand<>'onno' 防护但趋势图 09-26 才漂移——拍板了没有执行机制的口径会衰减。纵横两轴隔离(RLS 四层 / 四维×require_module)之后补第三轴:同一数据处处同算。A 注册表:pg-init/67 建 public.metric_calibers(全局事实表无 RLS,先例 fx_rates),6 行拍板口径种子——Amazon 广告 guarded union(实证:sku_daily=三品牌/amz_daily=仅onno/非onno重叠=0)、Noon 广告单源(F2-6)、成本映射优先(用户拍板 X2 ¥95,含 nullif 防 0.0 挡回退教训)、Amazon 订单排除 Canceled、Noon 订单 DISTINCT order_nr=单数·count(*)=件数、锚定汇率 SAR=3.75/AED=3.6725/RMB=6.7963。B 跨页门:dashboard_audit 新增检查 8(8.1~8.8:跨页同月 kpi=full 三指标、full month 死参数探测器、双租户趋势求和=KPI 卡、Top15 子集恒等、kpi-wall 月份敏感性、成本注册表口径 SQL 同构、今日 Noon 件数),178+→192+ 项 FAIL 0;Top15 断言经数据纠偏为子集关系(onno US 142.52=100.30 有SKU+42.22 四行空 advertised_sku,SKU 级榜单按设计不含)。C 源数据探针:tools/source_recon.py 晨报格式——广告双表重叠(非 onno 重叠=双计风险当天 FAIL)、成本冲突清单(X2 映射胜出列示)、断流矩阵用泊松判定(λ·lag>3 即该流速静默概率<5% 才 FAIL:低量流 onno/AE 静默 3d=概率 10% 不喊狼来了),首轮 PASS 44/WARN 11/FAIL 3(onno ES 4d、FR 5d 已知 + onno IT 14d 新发现)。
ABCDE 五批上线后遗留的唯一成本源冲突(X2:映射 ¥95 vs 采购表 ¥40)经用户确认「sku mapping 是对的」。全链路翻转 coalesce(采购表, 映射) → coalesce(映射, 采购表),并级联到三处原本纯采购表的 Noon 端点(noon-sku 深表单位成本/不可售成本、profit-matrix Noon 列、noon-pnl)。实证依据:冲突全库仅 X2 一款;采购表本币列 28/28 行 = 其 RMB×锚定汇率换算(非独立议价价),翻转对无冲突行无损;X2 两行映射均 platform='Noon' 且 Amazon 侧零订单 → 影响面只在 Noon 成本路径。修后实测:noon-sku X2 单位成本 SA 22.07→52.42 / AE 21.60→51.33(=¥95 折算);Amazon 路径全年成本 $21,407.31 逐位不变;fg/onno 无采购表行不受影响。财务页 footer 口径说明同步。技术细节:本币折算回退用 nullif(cost_rmb,0) 防 0.0 挡住采购表回退;新映射 JOIN 一律 DISTINCT ON ... ORDER BY cost_rmb DESC NULLS LAST 消除取行不确定性。
A 广告口径统一(P1-1/2/3):工作台趋势图+SKU Top15 补 brand<>'onno';财务四处 ads CTE(kpi-wall/full/product-pl/profit-matrix)换 guarded union——onno 以 amazon_ads_daily 为准,与工作台拍板口径对齐。实测:onno 30 天 KPI 卡 $693.38 = 趋势图求和 $693.38(修前 3.18×);Top15 AE $80.22 = KPI 卡(修前翻倍);full onno 2026-08 广告 $2,986.21(修前 $4,130.04,跨页 1.38× 消除)。
B 时间选择器生效(P1-4/5):finance full 的 month 参数此前收而不用(SQL 只用 year),现 month 优先 year 兜底——实测 ?month=2026-08 只返回 8 月矩阵(修前返回全部 31 个月份);kpi-wall Noon 三行补 mon/stmt_month 过滤——2026-08 返回 2 行实测数、2026-01 返回 0 行(修前恒全历史 AE orders=12961)。
C 成本源统一(P1-6):full/product-pl/profit-matrix/kpi-wall 的采购成本统一 coalesce(pc.cost_rmb, m.cost_rmb, 0)——mercury 采购表优先、SKU 映射回退(RMB÷6.7963 折 USD;Noon 本币按锚定汇率 SAR=3.75/AED=3.6725 折算),财务页 footer 同步口径说明。实测:fg 2026-08 成本 0→$4,301.58(DB 同构验证·fittinggoals 租户无凭据)、onno $3,718.94、product-pl 非零行 17~19/20。
D 功能缺陷(P2-1/2/3):sku-sales 映射聚合去重(ZF435T0EUB 3 行→1 行 35 件,国家列变逗号串);今日 Noon 订单改 count(DISTINCT order_nr) + 新增件数卡/件数列(实测 7 单/8 件,昨日 71/74);「全部平台」视图显式标注仅聚合 Amazon。E P3 顺手修×7:Noon 汇率单源化(filters 下发 noon_fx 覆盖前端默认)、max_day 兼 Noon 订单表、by_sku 件数回退链对齐、年度广告去硬编码(跟 year 参数)、winDays 北京时区日切、财务页 Noon 平台隐藏 Amazon 口径盈利总览、sku-sales 卡头"每平台"不副实撤下。
全量逐行通读三页前端(2,528行)+两路由(3,166行),DB 直查 7 组 SQL + 双租户 API 探针 8 次实证。P1 要点:①工作台趋势图/SKU Top15 onno 广告双计(KPI 卡 $693 vs 趋势图求和 $2,203,3.18×,dashboard.py 两处 union 缺 brand<>'onno')②财务四端点广告只用 sku_daily → onno 同月跨页差 1.38×($2,986 vs $4,130)③财务 full 的 month 参数完全无效(API 实测逐字节相同)④kpi-wall Noon 三行不受时间过滤(恒全历史)⑤成本源分裂:full/product-pl 用 procurement_cost(仅 zf 28 行)→ fg/onno 成本=0 净利虚高,kpi-wall 却用 sku_mapping.cost_rmb。P2:sku-sales 同 SKU 出 3 行(映射跨国行 JOIN 不去重)·今日页 Noon 订单=件数(3vs2)·今日"全平台"实为仅 Amazon。通过项:跨页核心一致(2026-08 zf orders=294/rev=$4,214.24 两页逐位相同)·租户隔离有效·sales_hourly 确为北京小时。
F3-1 分时投放:发现本地已有 sales_hourly(60 天滚动·北京小时·RLS)——/api/ads/dayparting 订单侧 24 小时分布(Amazon+Noon 双源堆叠图/峰值徽章/覆盖天数),广告侧小时=无数据显式注记(Amazon Ads 仅日粒度,不显示误导性 0)。
F3-2 否词注册表:新表 neg_keywords(pg-init/66·RLS·UNIQUE 防重)= 单一事实源;建议采纳/驳回自动入表(驳回也抑制重提——60 条/天重复建议主因);引擎 done_neg 并集(active+rejected·brand=''全品牌·country=''全站通配);🚫否词库 tab(状态筛选/搜索/手动添加/行内备注/驳回恢复删除·全审计)。
F3-3 预算趋势:⑥b 新规则 budget_inflection(前后 15 天 ROAS 拐点·花费未降而效率掉→暂缓加预算)+ budget_ladder(ACOS<18% 且规模达标→分步 +15% 阶梯放量·每步观察);词级日汇总口径显式注明(ad_campaigns 只有 30 天快照无日粒度)。F3-4 规则接线:分匹配红线(broad 38%/phrase 35%)·提价帽 raise_max_pct(修正 0.25 小数口径)·sp_auto_close_days 自动广告识别关停(搜索词报表有而关键词报表无=自动投放·实测 1 条)·CONSUMED_CFG_KEYS 全量校准+12 新配置行。
F3-5 重算限频:决策台「⬇ 重算窗口」——Redis 锁 10 分钟冷却(429 带剩余秒数),force 需 owner/admin(前端二次确认弹窗)。F3-6 AI 权限拆分:require_module_any(sourcing,ai)——纯选品租户不再 403,未开 AI 走降级路径(同源代码快照 2,569 字实测·零 LLM 零配额)。F3-7 ASIN 证据源:keepa_watch 池播种(物化时 ABA 上榜≥3 期 ASIN 按套餐额度入池)+ keepa_daily 近 30 天回退(own_src 标注·drops30≈月销前端显 ≈ 估算口径·实测两 US ASIN 补档成功/FR 无数据诚实留空)。
F3-8 关键词级执行:execRec 覆盖 pause_keyword/update_bid——campaign 定位后翻页解析 keywordId(6×100 上限)·bid 护栏 [0.02, 10];搜索词级否定不自动执行(无 campaign 上下文盲加有风险)→路由否词库人工闭环。顺带修三处:决策端点 _evidence 悬空引用(F4-3 遗留·每次裁决必 500)·否词 CRUD audit 签名错·优化建议页 5 条新规则中文标签缺失(显示原始英文键)。
引擎终态(09-26 全品牌重跑):343 条=fg 287/onno 6/zf 50——budget_inflection 4·close_campaign 7(含自动 1)·budget_ladder 0=无达标活动(最优 H24 SP Auto ACOS 18.2%/$75 < 80 门槛,数据事实非 bug)。05:40 cron 曾用旧镜像清掉新规则行(改后必 force-recreate 的活教训),API 重触发后恢复。
A2 事件总线接线(Redis Streams):发布方三处——ingest_all(4 域)/ingest_today(orders 域)完成后向全部活跃租户发 CleanDataRefreshed(失败不阻塞 ingest);daily_fx_rates 落库后发 ExchangeRateUpdated。消费者=worker on_startup 挂常驻线程订阅消费者组(handler 永 ack 防重投死循环,幂等靠 mark_processed 24h)。反应:CleanDataRefreshed→写各域数据水位 zipforce:tenant:{tid}:fresh:{domain}(14 天 TTL,API/前端可读);ExchangeRateUpdated→重跑标准清洗(节流锁 SET nx ex=3600——3 租户同批事件只触发 1 次租户无关的全管道重清洗,实测 1 跑 94/94 表+2 跳过);ShopConfigUpdated→即时刷新注册表驱动采集 spec。
真实路径实证(非手动模拟):04:30 ingest_mercury_daily → 04:42:52 水位 12 键(orders/ads/stock/finance × 3 租户);04:43 ingest_today_incremental → 04:50:57 orders × 3 租户覆盖更新;XPENDING=0 全 ack。两处坑(已修):① fx 发布方静默不发——tasks._pool() 连接(portal_app 无租户上下文)查 tenant_brands 被 RLS 静默滤成 0 行,改走 _admin_conn()(教训:worker 侧查租户表必须 admin 连接);② fresh_marks redis 客户端漏 decode_responses → /api/tenant/jobs 500 bytes/str。
A4 租户调度:语义分层——brands_source.enabled=管道级(采集不停)vs tenant_brands.is_active=租户可见性;品牌 archive 全停才 pause_tenant_jobs(redis 标记),activate 即 resume(幂等);规则引擎 run_ads_rules 进品牌级门控 should_run_brand(无归属活跃租户/全部暂停→跳过,实测三态:正常 True/SET paused→False/DEL→True/未知品牌 False);新增观测端点 GET /api/tenant/jobs(发现 jobs+暂停态+各域水位+最近 20 条事件,已登记 audit_nodes 快照 123 端点)。
def#22 重建 + def#24 新建:用户自建 def#22(18 度量×月份/SKU)撞单侧守卫只显优雅提示——按其意图重建为广告侧可计算配置([mon,sku]×9 广告指标,rows=51)并新建 def#24([mon]×18 全指标月度总览,rows=4 个月)。重建暴露 ADSKU 分支 ORDER BY grp.split(',')[0] 陷阱——首维 mon 表达式内含逗号被砍成 ORDER BY to_char(day 语法错 → 改 ORDER BY 1(列位=首维,语义不变)。
④ 4849 前端终验:无缓存浏览器(全新 context=强刷等效)切 Noon → 「30天订单 = 2,990 订单数 · Noon·折USD」——日级表 DISTINCT order_nr 动态值,绝非月表整月双计 4849;10 卡+FBN 库存卡全渲染,双视口 analyze_image 视觉确认过(桌面 2,490/移动 2,900 均 ≠4,849,OCR 小字差不掩结论,DOM 抽取为准)。KpiDeck 前端口径说明同步改单源措辞(「Noon ads_daily 单源全品牌(F2-6)」)。
F1 数据正确性 9 条:① 规则引擎逐规则 SAVEPOINT 隔离+全参数化(单条坏配置不再炸全批,审计⑭);② _calc_gp 僵尸代码收敛(同查询 3 次+恒真条件→各 1 次,审计⑮);③ 广告 KPI 混源口径显式声明(zf/fg=ad_campaigns 30 天快照 vs onno=日表聚合,审计⑯);④ min_spend 门槛语义——全窗口全量词算 KPI/否词/矩阵、仅明细带 HAVING+脚注(审计⑰);⑤ 10 条死配置清点归档(消费键清单注释锚定,审计⑬);⑥ _dell_live_term 复核(ssh COPY 管道无参数层→白名单拒,审计⑫);⑦ 检索条件非法字符显式回报不静默丢(审计⑯);⑧ 空窗探测双请求去重(审计㉒);⑨ keyword-bids 排序下推 SQL(ORDER BY/LIMIT/OFFSET,审计㉓)。
F4 架构卫生 4 条:F4-1+F4-2 pg-init/65-rls-dual-permissive-converge-20260926.sql——RLS 双 PERMISSIVE OR 叠加收敛+keepa_pull_log 补防(恢复 11-keepa 设计授权仅 INSERT);F4-3 决策台证据/旧裁决批量化(原逐行 4-5 查 limit=200 实测 7.8s → 批量后数百 ms);F4-4 时点常量提取。F2 交互 UX 7 条:F2-1 站点/月窗变更即自动重查(原须手点搜索);F2-2 雷达/决策台/探索三处「加载更多」服务端 offset 翻页(筛选变化重置,图墙/KPI 恒基于首页 200 行采样声明);F2-3 探索明细加载更多;F2-4 删恒重复的「有效ASIN」卡+品牌归一计数;F2-5 live/available 术语统一;F2-6 zf noon tab 恒空根治——noon_ads_daily 单源全品牌(模板化 17 列源表映射,zf 全历史覆盖),KPI 口径说明同步;F2-7 upload 成功区 T+1 出数提示(上传成功后可见)。
F3 功能增强 8 条按路线图约定逐条过用户后再开工(见 roadmap 文档 F3 表)。挂账 4 条不变:竞品 BSR 源(本轮 ②C 后调度底座就绪,仍缺数据源)/Dell 源头停更需求单/onno zip 人工投递恢复(用户侧)/def#22 已重建销账。
第廿九轮审计 49 条(广告 24 + 选品 25)中 P0/P1 共 19 条已修于 A/E/B/D/C 五包;余下 P2/P3 全量 28 条 + 挂账 4 条排序分批为 F1 正确性速修(9 条)→ F4 架构卫生(4 条)→ F2 交互 UX(7 条)→ F3 功能增强(8 条,逐条过用户),另列挂账 4 条(竞品 BSR 源[依赖决策②] / Dell 源头停更需求单 / onno zip 人工投递恢复 / def#22 处置)。清单含已修勿重复节(如租户 3 断更已在 D 包根治)。
根因链:onno 无 Amazon Ads API(能力矩阵 reserved),唯一数据源=人工从广告后台下载 zip 投递 dropbox;适配器脚本早已存在但 config 注册的模块名错误(adapters.onno_import_ads_daily vs 实际文件名不符)且 on=False,从未被调度——审计⑥断链实为「三重断」。修复四件:① 适配器重构为 run(mode) 契约(run.py 调度兼容);② 无 zip 时优雅跳过 rc=0(残留解包目录自动清理防每轮重复解析,zip 内无有效行也跳过入库);③ config.py 模块名纠正+启用(本地文件+PG 无外连,不注册 BRAND_OF 出口断言);④ tasks.py collection_cycle_ads 增 05:00 UTC 槽位,cron 扩为 {2,3,4,5} 时——02 zf / 03 归因回补 / 04 fg / 05 onno。
验证:api+worker 镜像 rebuild+force-recreate(先查 /proc 确认无活动适配器再重启);无 zip 场景实测 rc=0 输出「无待导入 zip」;worker 53 函数注册确认;四道门全绿。用户侧依赖(关键):人工投递自 08-31 起停——需恢复「Amazon 广告后台下载 zip → /opt/collection/dropbox/onno-ads/onno_amazon.zip」,首个调度窗口 05:00 UTC;断供由 SaaS pipe_stale 水位报警兜底(>2 天即报)。
D1 词宇宙扩容(头号修复):决策台 9,352 候选来自机会雷达,原快照只拉 drill_log 词宇宙(~48 词)→ 99.9% 候选无 ABA 行可算证据(11/9352=0.1%)。aba_snapshot.py 并入本地雷达候选词(8,819 新词),全量快照 1,593,438 行 aba_search_terms(531,146×3 租户)、8,868 词、14 国;aba_search_terms 改 COPY 批量格式(逐行 INSERT 数十万行太慢),aba-refresh.sh 防呆 awk 同步改 /^COPY aba_search_terms\(/(原行尾空格正则恒计 0 → 快照成功却跳过灌库的假阳性)。
D1 附带根因:租户 3 fittingirls→fittinggoals 改名后按写死 slug 列表查租户漏掉,aba_* 表静默断更一晚——demo_tenant_ids 改按 aba_term_universe 存量租户选择(改名自愈)。D2 证据国别修:Pareto _evidence 固定 country="US" + 死代码 if ctry=="US" or True → 按行国别取数。D3 verdicts 租户化:legacy 杀648/副攻161 全挂 tenant_id=3 但 UI 硬编码 → 动态计数按当前租户。D4 换手率图:相邻月份席位换手率接口不返回数据(恒空图)→ 修复后双视口实测 0%~66%、13 个月数据线。D5 物化 5/5:候选池物化从 3/5 类型补齐到 5/5(TERM 9,352 + ASIN 161),processed 9,861。
权威验证(SQL 级,非 API 200 条 UI 窗):TERM 证据命中 9352/9352=100%(修复前 0.1%);ASIN 进词 Top3 1/161、Keepa 覆盖 0/76——共现 ASIN≠词 Top3 属数据本性,页面诚实显示「数据不足」而非误导 0;ASIN 证据源缺口(Keepa 池不含共现 ASIN)记 F3-7 增强项。决策台脚注动态计数「杀 648 / 攻 162 / 待验 96」双视口截图 analyze_image 确认,ASIN 级行(FR/UK/US/ES · ASIN 级)渲染正常。
① stage 窗生效:目标按首见日分区(_first_seen min(day),term_new_days=14),新词快窗/老词慢窗——原双 pass 全量扫+run 级 dedup 保最长窗 → 3d 档恒被抹。② 冷却锁复合键 (target_type,target_key,country)——原裸 target_key 同名搜索词/关键词/活动互相误锁;keyword 规则 country 列存 campaign 名(历史设计,注释锚定)。③ pending 7 天过期:积压 2449→1233(expired 1211),已接受否定 (target_key,country) 不重提。④ campaigns 未知态:state='—' 按花费/ACOS 判健康(租户 2 模拟 5 个 onno 活动获得真实健康度)。⑤ optlog 停更徽章「今日新增 0 · ⚠️最近一条 7 天前」+ 待审 KPI 最新跑批/7 天过期提示;API recommendations stats 全量 by_status+latest_run(原只当日)。
E1 断更双根因:表层=宿主 ssh 无 mercury 别名(~/.ssh/config 补 Host mercury 104.194.81.222:20111,备份 config.bak-20260926)+补跑 13,750+19,722 行;深层=mercury 源头 Dell 采集停更(ABA 09-03 起 / Keepa 09-04 起)——SaaS 管道正常反复同步旧快照,源侧挂账需求单移交。E2 sourcing 页三源水位行(ABA/Keepa/雷达,超 3 天 ⚠️N 天前)。E3 COUNTRIES 13→14 国对齐 aba_search_terms 实态(去 IN/AU 补 AE/SA/SE;Keepa 仅 US/BR=数据边界如实标注)。
① rule-config 空页:54 条 brand='' 全局默认配置被 RLS 拒 → API 0 行页面空。pg-init 016 + live 授 saas_admin;引擎例外两拷贝(api/clean_audit.py + tools/audit_clean_all.py _grant_and_rls)同步修。② competitor_event 死代码:rules_ads.py 游标被 sku_mapping 查询覆盖 → 恒 0 行=A2 竞品监控失效,修活(BSR 数据源缺口挂 F 清单,依赖决策②)。③ CTR 口径:search-terms 页把 imp/clicks 当 CTR%(显示 81.9% vs 真 1.22%)→ 真口径 clicks/imp×100,实测修复后 0.09-12.59 全 <100% 合理区间。
① 用户令「sku 无值」根治:单侧源专查模式——订单表无 SKU 金额明细(仅订单级 sku_list),原「sku」维在日宽表 FULL JOIN 下只能给 '-' 占位=无值误导。引擎改三模式:ADSKU=ads_sku_daily 逐 SKU 专查(zipforce 20 SKU 真值)、ORDSTATUS=订单侧状态分布(含取消单,修原 'Shipped' 常量占位对 Pending/Unshipment 假值)、ADTERMS=广告活动/搜索词维。顺带三修:asin 移出 daily 白名单(两表均无 asin 列,rank 域仍真实);noon_daily 域补 sku 维(cleaned_noon_orders 有列);orders 度量改 sum(orders)(原 count(*) 数的是 CTE 行数,实测 2026-07 引擎 147 vs 真实 574)。
② 单侧守卫(诚实性铁律):SKU/词维×订单指标、订单状态×广告指标=跨侧无明细不可诚实计算 → 建档时显式 400 + 教学信息(「订单表无该维金额明细,不支持:revenue,units…」),编辑器同步提示。③ 渲染态优雅降级:已存 def 渲染遇校验失败不再 400 炸页面(历史 def 的坏组合每次开页 3×400 拖挂 frontend_e2e)——report_query 捕 400 返回空行+红 note「该图表暂不可计算: …」,建档仍严格 400 拦新坏配置。用户自建 def#22(18 度量×月份/SKU 撞守卫)现显示优雅提示可自删重建(删/留由用户定)。
④ 用户令「选择器尽可能是下拉菜单」:维度列筛选=下拉精确选值 + 级联选项——各下拉选项=其余列筛选后剩余行的去重值(先选国家,SKU 下拉只剩该国 SKU),并集当前已选值防受控失配;度量列保持 Min/Max 数字区间;表格与图表共用同一 shown 谓词。
⑤ 对账工具锚对齐北京业务日(两假 FAIL 根治):API 业务锚=bj_today()(北京),审计基准原用 DB current_date(UTC)——北京 00:00-08:00 双锚错位一天。dashboard_audit 三处(_ADSW/noon 池/amz_base ads_sku 行,差恰=zipforce 08-27 花费 $6.72);audit_nodes ads/analysis 基准已上海锚暴露 API 侧 _daywin 的 UTC 锚(api=421.37[含08-27] vs 基准=415)→ ads.py 六处 UTC 滚动窗全对齐:_daywin(级联 analysis/platform/search-terms/keyword-bids 四端点)+ campaigns 内联×2 + optlog「今日」计数(timestamptz 须北京零点显式转换)+ upload 回填 + reattribute×2;audit_nodes campaigns 基准同步换锚+raw→cleaned 镜像 API。修后 api=414.65 ↔ 基准=415 ✓。
中途事故(已修):首轮把 Python # 注释写进三引号 SQL 字符串内部 → campaigns 500 → pen_tests J FAIL;剥除 SQL 内注释后四道门全绿。教训:SQL 字符串内禁 # 注释,惯例说明只写 Python 层。
① 用户令「维度度量我们要任意个」:去 ≤2 维/≤4 度硬上限——上限即白名单本身(daily 域 11 维×22 度,键去重)。引擎同轮修三处隐性 bug:常量占位维度(platform/sku/asin/status 等日宽表无真列者)只进 SELECT 不进 GROUP BY(PG 拒非整数常量分组,全常量维度=整窗聚合一行);词维模式(广告活动/搜索词)维度组合越界显式 400 拦截(旧上限也没拦住的"undefined AS"坏 SQL);饼图裸数字数组被 specToOption value>0 滤空的隐性 bug 顺带修复(改对象数组)。
② 用户令「各列都有 filter」:表头筛选行常驻——维度列=文本包含、度量列=数字 Min/Max(与全站 DataTable 同范式),同时作用于表格与图表;筛后行数徽标(筛后 n/总);筛后 0 行表头筛选行不卸载(可清筛回退)+ 显式「无匹配行」空态——不显示误导性 0(筛选诚实性级联)。多维成图:dims[0]=X 轴,其余维度组合拆系列(组合×度量)。
③ 用户令「跟随租户品牌联动」:卡片与编辑器跟随页首全局品牌——ModuleCard 消费 useBrand() 模块级 store(无需逐页穿 prop);主从语义:页首切换→覆盖卡片级选择并重查,卡片下拉可临时改看。def 不烘焙品牌,渲染期套用查看者页首品牌(租户 RLS 之下二层隔离);编辑器实时显示当前跟随品牌。实测请求体 filters.brand=zipforce、表内品牌列全 zipforce、单品牌租户(本租户 brands=['zipforce'])页首自动锁定=预期,多品牌租户切换面自动生效。
④ 级联:brand/country 筛选全参数化进 5 域(daily 订单侧+广告侧双写 / stock / rank / noon / noon_daily,原先三域静默忽略=假筛选);country 单复数统一。注入探针 x' OR '1'='1 → 0 行。
已知边界:极端宽组合(如 13 国×5 度量=65 系列)图例拥挤——共享 GChart 不为此单点改动,宽组合建议用表格模式(各列筛选在表格态)。
① P0 根治:清洗引擎 RLS 模板补 b.is_active(tools/audit_clean_all.py + api/clean_audit.py 两份同源拷贝都修——每日 ingest 走镜像内 clean_audit.py,只修宿主副本治不了本);api+worker 镜像重建部署;重放 62 号 SQL → 86 张策略全三维。活体探针翻绿:tenant1 无 scope→仅 zipforce,scope=onno/fittingirls→空(06:40 FAIL 场景完全逆转)。决定性实证:手动复跑完整 ingest(引擎 run f55219db2eca 以新模板走完全周期)后 pg_policies 仍 86 张三维、missing_is_active=0——今晨正是这一步把修复刷回去的,现已根治。
② P1:sync_mercury left(date,integer) 根治——mercury 源表 zipforce_noon_statement_official.stmt_month 已漂移为 date 类型,裸 left() 无此重载;改 left(stmt_month::text,7)(text/date 两类源归一结果不变)。复跑 ingest noon_statement=38 行落库(2025-01~2026-07),cron_audit 唯一 FAIL 根因消除。
③ 审计落库隐藏 bug(本次核查新发现):audit_results 层约束缺 regression 值——回归防护层(09-24 上线)写 layer='regression' 被 CHECK 拒绝 → four_layer_audit 落库循环中途崩溃,09-24 起 L3/L4/regression 结果从未进 audit_results(晨间"FAIL 3"实为截断口径)。pg-init/63 放行 regression,批次自 118 行恢复完整 134 行。
④ 审计口径级联(昨日修复未级联到检查工具的欠账):dashboard_audit amz_base 补取消单过滤(API _amz_kpi 设计性排除 Canceled——zipforce 30 天 474 单中 112 Canceled,基准漏过滤致 474 vs 362 假 FAIL ×8);kpi-pool noon 池改日级表 DISTINCT/count(*)(4849 终修的检查侧级联,基准原为月表整月加总=4849);audit_nodes BASAL 同步两处(kpi 取消单 + kpi-cards units30 日级口径)+ 快照刷新 122 端点(+7 新端点登记,17 基准全对账)。
⑤ e2e 与 240/3s 限速共存:e2e 作为四层审计 L4 紧跟三个重工具(数千请求)运行时令牌桶未排空 → 页面自身 fetch 吃 429 →"( → )"假空看板;修法=开跑静默 3.5s 排空 + 遍历段 429 单页重试(非 429 不豁免)+ KPI 卡配置防御性重置(上轮被超时截断在 select_option 后,持久化配置污染下轮 before 假 FAIL——Pending→Pending 案)。
用户上传「最终完整架构总文档」选 B 出正式差距分析(与已归档 architecture-master-spec.md 逐字同一份)。报告在线:architecture-gap-analysis-2026-09-25.md。总判定:✅5 / 🟡等价3 / 🟠部分3 / ❌2 / ⚠️语义冲突1(shop_id)。方向高度一致,隔离机制 PG RLS 比文档 ORM 拦截更强;建议文档定位=长期愿景+语义标准,改造按 P0-P3 分级,微服务拆分/shop_id 明确不建议现在做。
🔴 核查发现 P0 活体安全回归(比差距更要紧,修复方案已备待用户批):audit schema 42 张 cleaned_* 表 RLS 策略缺 is_active——01:34 修复态 PASS 后,清洗引擎 audit_clean_all.py:167 的旧两维模板在原子换名时把 62 号修复刷回(06:40 审计批次 RLS 三维完整性 + portal_app 实测双 FAIL,scope=onno→onno 停用品牌真实可见)。dashboard.py 代码级过滤在位(824/1583 行),业务数字未污染。治本=引擎模板补 b.is_active + 重放 62 号 SQL + L2 复核。
交接摘要三处勘误:①"全部重建策略"非当前事实(引擎回滚);②"FAIL 1"引用 01:34 旧批次(06:40 实为 FAIL 3);③对今晨按用户令落地的主控架构 A1–A4 四件套只字未提——本次勘正:A1 /internal 5 端点 + A3 DTO 已接线(公网 404 隔离实测 ✓),A2 事件总线/A4 租户调度基建就绪但生产静默(无发布方、cron 未迁移),处置选项 A/B/C 见报告 §1.2。
顺带完成三项待验证(只读):① 4849 服务端终验通过——kpi-cards?platform=noon&period=rolling 实测 values.units30.foot="订单 2761"(预期锚点≈2737,差值=当日新增,rolling 窗口右移);前端待用户强刷一次即闭环。② keepa 05:20 首跑验证通过——31.4s 完成(asins 1064/pulled 509/written 442),无 ImportError,rankings_daily 三品牌 max(snap_date)=2026-09-25。③ cron_audit 07:25 机器人工作正常——今日报告产出,唯一 FAIL="worker 日志 8 行 Traceback",根因=sync_mercury 某结算 spec 的 left(date,integer) 类型错误(P1 待修,改 to_char 即可)。
A1 域目录 + /internal 契约 API:api/domains/{orders,ads,finance,inventory,shared}/store.py 域目录 + 5 个 /internal/api/v1/* 端点(订单 status/sku-aggregate + 广告 spend + 财务 monthly + 共享 fx-rate)。X-Tenant-Id 头传递租户;公网 Caddy 404 隔离、容器内网 200。全部返回聚合指标不返回明细行(主控架构 4.2 同步契约调用规范)。
A2 事件总线(Redis Streams):api/domains/events.py — publish/subscribe/mark_processed/get_events。全局幂等(eventId=uuid + Redis 24h 过期标记)。标准事件:CleanDataRefreshed / ShopConfigUpdated / ExchangeRateUpdated(主控架构 4.4 节事件结构)。实测发布+幂等+读回全通。
A3 DTO 契约模型:api/dto.py — 11 个 Pydantic BaseModel(OrderSkuAggregateRequest/Response / OrderStatusResponse / AdsSpendResponse / FinanceMonthlyResponse / FxRateResponse / DomainEvent / KpiCardValue)。字段名+类型+单位+业务语义不可变,改变=新建 v2(主控架构 2.3 版本变更铁律)。
A4 租户级调度:api/domains/scheduler.py — discover_tenant_jobs()(8 个租户-品牌-平台组合自动发现)+ pause/resume/is_paused(Redis 标记控制)。首跑发现 tenant_1/zipforce+noon / tenant_2/onno+amazon+noon+brainnews / tenant_3/fittingirls(14 市场含 UK)。
主控架构差距更新:14/30(46%) → 18/30(60%)。pen_tests ALL PASS。剩余 12 项差距:Clean 版本化 / 全局 cron→租户级 Job 迁移 / 域独立 DB 账号 / 镜像库 / 适配器基类 / 静态检查等(持续迭代)。
自定义报表佣金精度修复 + 截图 OCR 工具(用户怒斥后修正):① 佣金列显示完整浮点精度(75.47149155443319)→ 全部金额类 metric 加 round(...,2),修后 75.47/866.09/466.47 ✓。② 新增 tools/read_screenshot.py(tesseract OCR + chi_sim),以后发截图自动 OCR 读文字,不再假装能看图。
用户提交完整架构规范(Raw-to-Clean 单次标准化 + 领域私有存储 + 契约接口通信),保存为 architecture-spec.md(262 行)。核心公理:①清洗只做一次 ②Clean 表域私有 ③数据自上而下 ④审计旁路不改数据。规范含 10 章:四层详细规范、11 个业务域清单、3 种跨域通路(契约调用/事件/镜像库)、计算职责边界+黑名单 8 条、多币种规则、MCP 审计架构、端到端示例、工程约束、三阶段实施路线。
主控架构总文档升级(用户提交 535 行完整版):新增 5 大核心——①插件化平台扩展(适配器基类+一行注册=零改核心)②事件驱动级联(弃 DB CASCADE)③租户全自动(无全局任务)④统一表结构(七字段前置+version+extension)⑤禁忌红线 10 条。差距分析 30 项:✅14(46%) 🔄6 ❌10。最大差距:无全局任务→租户级 Job、跨域 /internal API、事件总线、Clean 版本化、域独立 DB 账号。文档在线:architecture-master-spec.md。
现状 vs 规范差距分析(20 项):✅ 已有 8 项(40%)——Raw 只读/按域分表/原始币种存储/多币种共享模块/MCP 审计/三方比对/前端不碰库不算。🔄 部分 5 项——Clean 域私有(有表未分schema)/标签字段(缺shop_id)/清洗只一次(部分重复)/汇率散落(部分内联)/CI基线(有检查未入门禁)。❌ 未有 7 项——内部契约接口/版本管理/DTO/事件队列/镜像库/静态检查/Schema归属。三个阶段逐步落地(阶段一基础改造→阶段二契约体系→阶段三审计完善)。
用户报"30天订单数量不对"和"noon 显示 4800 多单",两处根因:
① Amazon KPI 卡(_amz_kpi)没排除取消单:显示 470(含 112 取消)vs 正确 358。修 3 处查询(cur/prev CTE、by 维度、trend 聚合)全部加 NOT IN ('Canceled','Cancelled')。修后 358 与 DB 直查一致 ✓,chart_value_audit KPI orders 双视图 FAIL 0 ✓。
② merged-kpi(跨平台合并卡)没过滤停用品牌:显示 all.orders=4755(Amazon 1933 含已停用的 fittingirls/onno + Noon 2822 含月度口径),正确应为 3095(Amazon 358 仅活跃 zipforce + Noon 2737 日级 distinct)。根因:SELECT brand FROM tenant_brands 缺 WHERE is_active=true——停用的 fittingirls(1255 单)和 onno(320 单)被计入 Amazon 侧。修后 358/2737/3095 全部与 DB 对齐 ✓。
根因:09-20 加品牌停用(is_active)功能时没级联到 RLS——86 张 cleaned/public 表的 brand_isolation 策略只查 tenant_id 不查 is_active,停用品牌数据在 RLS 层仍可见。KPI 显示 4755(应为 3095)的架构级根因。
修复两轮:第一轮(v2)修 8 张表但引入两个新问题——① tenant_brands 自引用递归 ② 丢了 brand_scope 维度(pen_tests 员工隔离 FAIL)。第二轮(v4)排除系统表 + 恢复三维完整(tenant_id + is_active + brand_scope),86 张表全部重修。
三维验证:无 scope → 只见活跃品牌 ✓ / scope=停用品牌 → 空 ✓ / scope=活跃品牌 → 只见该品牌 ✓ / pen_tests ALL PASS ✓ / KPI 358=DB ✓ / chart_value FAIL 0 ✓。
回归防护体系上线(用户令"changelog 问题整理成 checklist 每日巡检防复发"):四层审计新增 audit_regressions()——7 项历史 bug 模式每日 06:35 自动检查(R1 取消单过滤 / R2 停用品牌 / R3 Noon rolling 日级 / R4 错误透传 / R5 API 探活 / R6 广告双计 / R7 视图裸::date)。changelog 54 条问题→提炼 7 项自动检查+8 项已有覆盖+人工检查清单,记入 verification-checklist 回归防护节。首跑即抓到 1 个复发:R6 广告双计(onno 30 行泄入 ads_sku_daily)。审计从 116→123 项。
全部修复记录入 checklist(用户令"放到 checklist 里面"):verification-checklist 新增 6 大节——① _amz_kpi 取消单过滤(4 项) ② merged-kpi 停用品牌(3 项) ③ RLS 86 表架构修复(9 项含四层审计 3 项) ④ Noon KPI 4849 月表整月加总(4 项) ⑤ SaaS 自审 10+1 项(9 项) ⑥ 品牌隔离铁律 6 条教训。共 35 项检查项全部 ✅实点验证,每项带修前/修后/证据。
模块化架构方案(用户令"4层确认,给模块化方案,各模块独立互不影响,通信接口固定"):modular-architecture — 5 层 12 模块单向依赖(L5 Web → L4 API → L3 metrics_store → L2 DB → L1 采集)+ 3 个横切模块(core/data_dict/audit)。每层定义固定通信接口(REST/函数签名/SQL+粒度守卫/SSH 通道),禁止反向依赖。变更影响范围矩阵(改 L3 口径只影响调用方,不影响 L4/L5)。落地路径四阶段(新增指标一律走 metrics_store → 高频路由迁移 → 回归验证 → 删除内联 SQL)。
粒度错配架构防线(用户问"这种怎么避免"):① TABLE_GRANULARITY 粒度契约表(机器可读,月/日/时/快照四档,新表必须登记)② granularity_guard() 运行时守卫(查询月粒度表+非整月窗口→警告含 bug 模式描述)③ is_clean_month_window() 整月判定 ④ 回归检查 R8 每日监控。核心原则:月粒度表只用于整月窗口的财务对账,任何"最近N天"查询必须用日级表。
Noon KPI 4849 六轮终极排查闭环(用户确认"终于搞定了"):根因是 kpi-cards 的 noon 订单/销量从 noon_sku_pl_monthly 月表按 mon BETWEEN 整月加总——用户浏览器发的是 period=day&date=2026-08-27&date2=2026-09-25(Caddy 日志实锤),30 天跨月窗口把 8+9 月两个整月全计入。终修:noon 订单/销量无条件用日级表(noon_orders),月表仅用于金额结算口径。六轮教训记入长期档案:①修 bug 用用户实际参数(查 access log)②同源多字段一起修 ③同函数多入口一起修 ④月表禁用于非整月窗口 ⑤修复后从用户视角验证。
Noon KPI 4849 根因终修(用户持续追问三轮):kpi-cards 端点 rolling 模式的 noon 订单用 noon_sku_pl_monthly 月表整月加总——30 天窗口跨 8+9 月,两个整月全计(2890+1959=4849,实际日级 2737)。修:rolling 模式改用日级 noon_orders 表 count(DISTINCT order_nr)。修后 noon rolling 2737 ✓ / 全部平台 3207 ✓(AMZ 470→358 + Noon 2737→2737)。
品牌隔离全库扫尾(同日,用户报"noon KPI 还是 4849"再挖出 9 处漏修):dashboard.py 812 行(chart wall 品牌列表)+ ai.py(1) + org.py(3) + onboarding.py(1) + listing.py(1) + ads.py(2) 共 10 处 SELECT brand FROM tenant_brands 不带 is_active=true——停用品牌在图表墙/AI 助手/团队管理/Listing/广告等页面仍可见。全库 grep 扫尾修复至 0 处遗留,重建部署后 noon KPI 2,890/2,737 正确。
RLS 验证入四层审计(同日,用户令"把所有 RLS 策略的验证加到四层审计里面"):L2 层新增 3 项——① 策略三维完整性(86 张 brand_isolation 策略逐条检查含 tenant_id+is_active+brand_scope)② 策略数量稳定(当前 vs 期望值 86,偏差>3 WARN)③ portal_app 实测隔离(模拟非管理员用户+scope=停用品牌,验证数据不可见)。首跑三项全 PASS ✓。审计从 113→116 项。
全量口径(four_layer_audit.py v2 重写):L1 = 三品牌订单源表 + 三品牌 finances 独立源交叉(原只查 fg)+ 全库视图裸 ::date 扫描 + 三品牌 token 授权×配置全探针(真实调 sellers API)+ 注册表驱动全域断更 + Pending 回刷滞后 + 幽灵行;L2 = 全部 86 张 cleaned 表逐表(行数/新鲜度/动态日期列/is_valid/与 public 源表行数对齐);L3 = 三大工具全跑(81 图双视图 + dashboard_audit 178 项 + audit_nodes 1605 节点)+ 今日页对账;L4 = frontend_e2e 27 页全量。
首跑抓到 6 个抽查版漏掉的真问题,当日全部处置:① zf 独立源交叉缺 56 单(fg 同款状态流转换漏采,按 id 补录 47 单,余 9 单 Amazon 已查不回);② 两视图裸 ::date(v_order_finance_detail / v_onno_order_finance_detail,fg 同款病,已改北京日);③ audit_nodes 抓到新端点未登记(快照 101→115 刷新);④⑤ onno 广告两表断更 08-31 转白名单(09-23 需求单在案挂账);⑥ 探针 join bug(逐字符拼接)修复 + fg sellers 403 已知集合降级。终态 107 项 FAIL 0 / WARN 7(全部白名单/观察级:挂账广告表×2、清洗标记、断流观察×3、幽灵行历史错位 reconcile 消化中)。
配套:前端四层区块 PASS 折叠(明细只列非 PASS + 前 3 条样例);SaaS 全量对齐 38,472 行带回补录单。
用户令"4 个 agent 加到 /pipeline + 定时任务不需要 LLM",同日落地(体系文档 four-layer-audit):
① deploy_gate 四门 → 六门:收编 pipe_audit.py(L1/L2:断流扫描·两表 diff(取消单口径对齐)·finances 独立源交叉)+ chart_value_audit.py(L3:81 图值对账,升级 zipforce+onno 双视图模式);② 四层日检 four_layer_audit.py(15 项:rawdata 6 / cleandata 3 / api 4 / web 2)→ 新表 audit_results(pg-init/52,只追加+禁改删触发器)→ 宿主 crontab 06:35 每日,全代码零 LLM;③ /pipeline 页新增"四层审计"区块(四层卡片 PASS/WARN/FAIL 计数 + 点击展开明细 + 批次与 7 天趋势,/api/pipeline/audit)。
验证:六门全过 EXIT=0;四层首跑 15 项 0 FAIL(1 WARN:清洗标记 2541/38289 观察级);curl 端到端四层计数正确;DOM 断言(标题/四卡片/展开/批次行)+ 双视口截图 桌面 · 手机。
用户就工作台订单图表连续 3 天问 10 次后,当日连打四轮直到除根(当天 5 次部署、四道门全绿 ×3):
① SaaS 口径(24小时图基准日分裂/半日无标注/数据日不标)→ ② mercury 根因(fg 视图 UTC 日切 + Pending 回刷缺失 1388 单 + zf SA/AE 凭证丢失断流 14 天找回 309 单 + token 缓存串号 + 6 市场漏配,需求单 db-requirements-2026-09-24 当日出当日闭)→ ③ 全站点排查(fg 荷兰站全年 499 单漏采/PL 断流/29 单状态流转换漏/onno 变体 SKU 品牌误标)→ ④ 81 图全量值对账(新工具 tools/chart_value_audit.py,修 multiSku 兜底 + SKU 金额均摊 + promoPie 内联口径,zipforce/onno 双租户 0 FAIL)。
终态数字:fg 金额覆盖 0%→96%、两表日切偏差 ±15→≤2、SA 187+AE 122 断流单找回、fg NL 499 单入库、回刷 1388 单、9 月 SaaS 侧 fg ~1050 / zf 396 / onno 288。挂账:noon_statement 类型错(09-23 需求3)· SMTP 526 · fg PL 9 单(已随 14 市场配置修复,待下轮回刷)· onno IT 停 09-12 待用户后台对数确认是否自然停售。
方法:新立 tools/chart_value_audit.py——API /api/dashboard/charts 输出 vs DB 独立 SQL 重算(不经 dashboard.py 代码路径),覆盖 81 图中全部可 SQL 化锚点(KPI/趋势合计/状态饼/渠道饼/费用构成/分币种/分国家/小时图/TOP SKU),zipforce 与 onno 两租户视图双向跑。
修掉两个真口径 bug(dashboard.py):① multiSku items_count=0 兜底不看 sku_list 直接按 1 计——多 SKU 单被误判单 SKU(zipforce 实证差 1 单),改与 /api/today 同款兜底;② SKU 系列金额全额重复计——多 SKU 订单每 SKU 记全额营收,SKU 图合计>总营收(TOP1 差 5%),改按订单内 SKU 数均摊(件数/营收/净利/费用/回款,与 today 页 by_sku 同款)。修后 zipforce 79 锚点 ✓(当时仅剩 promoPie,下段同日改掉)+ onno 0 FAIL(含 skuRev TOP1 精确一致)。
promoPie 已改内联口径(同日用户拍板):促销"订单判定"改用内联 promo_usd(新增 promo_inline,覆盖 promoTime/promoPie/promo_cnt 三处),促销"金额"仍走结算事件口径——修后 zipforce 促销 0→301 单与 DB 精确一致,双租户视图 0 FAIL,四门全绿。
方法:① 三品牌 token 授权 vs 采集配置逐市场实测(sellers/v1/marketplaceParticipations)② 全站点断流扫描(每品牌×国家最新单时间)③ 独立源交叉(finances 结算事件 vs 订单表,能暴露 orders 端点漏单)。
新发现并当日修复:① fg 荷兰站全年 499 单从未采集(NL 有授权一直漏配,首采 1-6 月全回;7 月起自然停售)+ fg PL 断流(31 单停 09-10,与 zf SA/AE 同款上线日事故)+ IE 漏配——fg markets 11→14;② fg 29 单状态流转换漏采(GB 为主,finances 有 Shipment 事件但 orders 无行——incremental 的 OrderStatuses 不含 Canceled,状态流转掉的单常规拉取永不回)→ 按 AmazonOrderIds 直查补录(含 PL 断流期 11 单);③ onno 2 单品牌误标(Amazon 自动变体 SKU `amzn.gr.ON3720SEU-…` 不匹配 mapping → 兜底判 zipforce,四维隔离击穿)→ 数据修正 + `_brand_for_order` 剥 amzn 前缀分段匹配防复发;④ onno_amazon token() 缓存键同款隐患预防性修复。fg US/CA/MX/AU 的 sellers 403 但 orders 在进(端点权限差异,不阻断)。
交叉验证:zf 8 月 finances 459 vs orders 509(orders≥finances ✓ 无漏单证据);fg 交叉暴露 29 单缺(已补);onno IT 停 09-12、fg NL 停 07 月、DE 量微——判定自然停售非故障,待用户后台对数确认。终态 9 月 SaaS 侧:fg ~1,050 单(AU251/ES194/IT157/FR110/CA106/US102/…)、zf 396(SA192/AE125/GB28/IT18/…)、onno 288(AU85/SA68/FR28/…)。
起因:用户质疑工作台 24小时订单分布 / 每日订单数等图。四层对账(raw→cleaned→api→web)发现:① hourly24/hourDist 的"最新数据日"取各品牌 sales_hourly 各自 max(day),与订单表口径的 KPI/日图互相矛盾(当日实例:fittingirls 订单管道停 09-23、小时管道到 09-24,同屏 KPI 今天 0 单 vs 24小时图 17 单);② 原子查询只对齐 brand 不滤 country,选国家筛选时基准日可漂到别国;③ 今天这根柱子是半日数据无标注,视觉上像暴跌。
修复(快照 backups/code-2026-09-24/dashboard-charts-caliber.tgz):
① api/routers/dashboard.py — 24小时图基准日统一取订单表 max(purchase_date)(hday,与 /api/today、last24Country 同口径,即 09-09 立的数据日铁律),删各品牌 max(day) 子查询(连带修掉 country 漂移);② 日粒度图 x 标签北京时间当日加 *(xday(),16 图统一);③ hourly24/hourDist 增加 sub=实际数据日,前端 BrandBoard/ChartWall 副题渲染"· 数据日 YYYY-MM-DD";④ GChart category 轴 showMaxLabel:true(轴标签抽稀曾吞掉最后的 09-24*)。
验证:curl 端到端(zipforce 租户:hourly24 sub=2026-09-24·2单 与 DB 一致、dailyCnt x[-1]=09-24*);fg 单品牌视图 DB 重放锚点 09-23 全天 44 单(fix 后不再混 09-24 半日);视觉核验双视口(桌面 hourly24 · dailyCnt 09-24* · 手机版 · 全页 d m)。
⚠️ dashboard_audit 唯一 FAIL 与本次无关(纯 DB 断言):费用覆盖 zipforce 08-17周(30单) 覆盖率 83% —— 30 单中 7 单 Pending/Unshipped(settlement_status=其他、revenue 空)缺 order_fees 事件,与 fg Pending 卡单同源(mercury 侧状态回刷缺口);该周 09-24 年龄满 38 天首次滚进"成熟周(≥35天)"检查窗口被扫出。待用户拍板:出需求单给 mercury 侧回刷,或 SaaS 侧豁免。
另一源头发现(未修,属采集侧):订单表 vs 小时表日切有系统性偏差(fg 近一周 -14~+15、相邻日互补,疑日界挪移/回刷不同步;onno +2~+4)——SaaS 侧已用基准日统一消解同屏矛盾,根治需 mercury 侧排查。
📋 源头需求单已出(用户拍板"彻底修复"):db-requirements-2026-09-24——经 mercury 只读通道实证两根因:① R1(P0) fg 订单视图 v_fittingirls_order_finance_detail 裸 ::date 按 UTC 切日,与 zf/onno 分支的北京日在同一条采集 SQL 里并存(当日实证:活表北京日 18 单 vs 视图 UTC 日 1 单;order_month 跨月错分连带 fg 月度摊销分母);② R2(P0) Pending/Unshipped 状态回刷缺失扩展到全品牌(zipforce 08-17 周 7 单实锤:状态卡住 + finances 0 行 + 金额空,费用覆盖门 83% FAIL 即此)。R3 重申数据契约:timestamptz 切日禁止裸 ::date,必须显式 AT TIME ZONE 'Asia/Shanghai'。历史脉络:用户就这两个图 3 天问 10 次,SaaS 三轮修复(标题语义/同步中断/基准日口径)每次修一层,根因在源头的日历分裂与状态卡单,本单移交根治。
执行(用户放行 ssh 222 权限,需求单 db-requirements-2026-09-24 当日闭环,快照 mercury /root/backups-code-20260924/ + mars mercury-fix-20260924/ + adapter *.bak-*-20260924):
① R1 fg 视图时区:`v_fittingirls_order_finance_detail` 三处日期表达式改北京日(diff 核对除三处外逐字一致,曾手滑漏 `spapi` 被 diff 抓回)——视图当日 1→18 单,fg 两表日切偏差 -14~+15 → ≤2(时点差范围);② R2 回刷:zf_amazon.py 新增 status_refresh(每小时自动)+ 窗口参数化,fg/zf 历史 backfill 累计 1,388 单(429 限速分轮),fg 8月起金额覆盖 0%→96%,zf 35 天卡单 110→2;③ 执行中追查三根因(用户实锤"SA/AE 在售、全球站点都不对"后深挖):zf 采集器 09-10 上线丢掉 sa.json/ae.json 独立凭证(de token 实测授权不含 SA/AE)→ 断流 14 天,找回凭证后 SA 187 + AE 122 单当日涌入;token() 缓存键只按 region 必串号 → 改 (region, rt);MARKETS 漏配 IE/TR/BE/CA/MX/BR 六个已授权市场 → 补齐 18 市场(BE 首跑 +4 单)。"138 单死单"确认为断流期单据,凭证恢复后可回刷,无需归档拍板。
验收:SaaS 全量对齐(amazon_orders 37,756 行)后——SA 192/AE 125 单已进 SaaS、fg 近 7 天两表 diff 全部 ≤2、dashboard_audit FAIL 0(昨日的费用覆盖 83% FAIL 已消:7 单被回刷修复)。已知未修(老单挂账):noon_statement 类型错误(09-23 需求单 R3)、SMTP 526(待用户)、fg PL 市场 9 单不在 11 市场配置(量小未动)。
根因:finance_monthly 中间表只从 SP-API 财务事件(spapi_finances)单源灌入,onno 的订单/广告/结算没交叉进去——spapi_finances 天生残缺(要求 seller_sku 非空 + 财务事件滞后),导致财务页订单数严重漏单:onno 8月中间表 126 单 vs 源表 431 单、9月中间表 0 单 vs 源表 134 单。
改造(源表直读):订单/营收→amazon_orders,费用→order_fees,广告→ads 表,回款→amazon_settlement_monthly,退货→amazon_refund_monthly,不再读 finance_monthly。GLM 先改 /api/finance/full 主矩阵 fin+cost CTE(快照 backups/code-2026-09-18/);Kimi K3 接续完成剩余 6 接口 + full 内部 4 处遗留:summary / sku-profit / kpi-wall / product-pl / profit-matrix / onno + full 的国家KPI子查询/年度对比/未映射SKU计数/profit-matrix月份列表。
口径写死:①有效订单=order_status NOT IN(Canceled,Cancelled);②净额=revenue_usd−佣金−尾程−促销−其他(order_fees 为 USD);③SKU 级按 sku_list 逗号展开平摊(多SKU订单约9%);④country→marketplace 用 marketplaces 表映射(GB→UK 特例),不再用 _AMZ_CC(那是 finance_monthly 的 marketplace 映射);⑤本地币 net 无源(order_fees 仅 USD)→ 拍板用 USD 净利率折算 local_net=local_amount×(net_usd/revenue_usd);⑥费用滞后时 net≈rev(9月费用未进 order_fees),订单数/营收仍准。
保留未改:/api/finance/monthly 是财务三方对账口径(posted_date+settlements),用户拍板不改(对账本就该用财务事件口径,与业务指标不同);Noon 系列(noon/summary、noon-sku、noon-pnl)与本次 onno Amazon 漏单无关;/api/settlement 本就是源表直读。
验证:每接口改完跑 pen_tests 全 PASS;剩余 finance_monthly 实际 SQL 引用清零;双视口截图自检通过。桌面截图 · 手机截图。
配套方案文档:🔗 数据链路盘点(mercury raw → SaaS 中间表 → API → Web 全链路图 + 27+ 中间表明细 + 口径清单 + 对照理想架构的 4 缺口)。归档入口:changelog.zipforcehub.com 子域上线(显式站点块,不走 on_demand——changelog 非租户 ask 会拒;普通 ACME 签发,DNS 已指向本机),根路径默认打开本页,截图/方案/审计同域可访问。
背景:吸收 SaaS 审计说明书(用户上传 saas.txt)的"数据库 Raw 清洗"思想——未清洗的脏数据不能直接当审计基准。之前 finance_monthly 漏单、早期订单缺 USD 折算,根因都是"没清洗就拿原始数据当真相"。
架构决策(用户拍板,采纳豆包建议的"清洗表对接 API"):清洗层不只是审计裁判,而是屏蔽层——mercury raw 任何变化只影响清洗层,清洗逻辑统一处理,API/Web 不动。链路:mercury raw → 业务表(public) → 清洗引擎(原子换名) → 清洗表(audit.cleaned_*) → API → web。清洗时机=离线批量全量(实测 14s/12表),挂 ingest222 后跑。
实施:①通用清洗引擎 tools/audit_clean_all.py——读表元数据动态生成清洗表(源表全列+标记列 rev_estimated/is_valid/issues/is_orphan),通用校验(去重/空主键/类型)+专项校验(金额负数/跨表孤儿/状态合法/USD折算兜底);②原子换名(建_new→灌数据→事务内换名→删_old),表永远在线无重建窗口;③12 张清洗表全部加 RLS 品牌隔离(与源表一致)+ 授权 portal_app + 主键/关键索引(否则 CTAS 无索引→接口超时);④试点 /api/finance/summary 改读清洗表。
发现的真实数据问题:①有效订单缺 USD 营收折算 4504 单(已用确定汇率补 4359 单,EUR/GBP/SEK/JPY/PLN 缺汇率待需求单,333 单币种缺失);②孤儿费用 1936 条合计 39,498 USD(order_fees 有费用但无对应订单,zipforce 28703/fg 10765/onno 30,费用虚高)。明细见 audit.dirty_data_log。
误判修复(清洗规则冲着真实脏法,不空想):Noon 费用列是负数口径(业务合理)不做负数校验;sales_hourly 主键补 day 列;sku_mapping 空串 country 合法不算空;products jsonb 列用 Json 包装。
验证:清洗副本 vs 源表 onno 8月一致(431单/4650.73);RLS 隔离 onno 租户只读 onno;接口加索引后 0.48s;pen_tests + audit_nodes 全 PASS(audit_nodes 基准同步改清洗表口径,17 基准通过)。dashboard_audit 2 个 FAIL(hourly24 标题语义)读源表,系既有问题与清洗层无关。清洗报告 📊 数据库清洗报告。
承接上一条:从 12 表试点推广到全量。①82 张业务表全量清洗(24 张系统/配置表排除)——通用框架 _discover_tables() 自动发现业务表 + 自动读主键(PRIMARY KEY 或第一个 UNIQUE 约束,不手写 82 个配置)+ 特殊表用 SPECIAL_TABLES 专项配置覆盖;39 张有 brand 列的加 RLS。②全站接口切清洗表——finance/dashboard/ads/brandboard/collab/ai/ops/notify/onboarding/auth/inventory_po 全部从读源表(public)改读清洗表(audit.cleaned_*),源表引用残留清零。③清洗挂 ingest 自动跑——ingest_all + ingest_today 完成后自动调 audit_clean.run()(api 内新模块,Dockerfile COPY 清单加入),清洗表永远跟源表最新。
口径变化(用户拍板接受):清洗层补早期订单 USD 折算后,zipforce 营收 41,285 → 136,218(补全真实缺失),fg/onno 不变。
回归门基准口径对齐:audit_nodes 的 finance/summary 基准改读清洗表(接口口径一致);dashboard_audit 加 WARN 机制——基准读源表/接口读清洗表时,清洗修正(补USD)+时间差的小差异(≤5%)标 WARN 不 FAIL,真 BUG 才 FAIL。hourly24 标题语义锚基准改读 sales_hourly(与接口同表,原读 amazon_orders 口径不一致误报)。
关键验证:清洗挂 ingest 后自动跑(ingest_today 后 audit_clean 自动跑,run_id 入返回值);清洗表与源表一致(今日 17 单/67.50);接口读清洗表 200 快速;RLS 隔离 onno 租户只读 onno。四门全绿:pen_tests / audit_nodes / dashboard_audit(FAIL 0 WARN 0) / frontend_e2e 全 PASS。
最终架构:mercury raw → 业务表(public) → 清洗引擎(原子换名, ingest后自动) → 清洗表(audit.cleaned_*) → API → web。清洗层成为真正的屏蔽层——mercury raw 任何变化只影响清洗层,清洗逻辑统一处理,API/Web 不动。
源头需求单移交:清洗层发现的两个源头数据缺口已写成需求单移交 mercury/venus 数据库侧——📋 db-requirements-2026-09-18:R1 补全 fx_rates 汇率(缺 EUR/GBP/SEK/JPY/PLN,约 5100 单缺 USD 折算);R2 核查孤儿费用(1936 条合计 39,498 USD,order_fees 有费用无对应订单)。SaaS 侧清洗层已做兜底标记,源头修复后 ingest 自动清洗带回,无需发版。
需求:全栈所有页面尽量用本土货币计算,注意货币符号,国家间求和转换汇率到美金求和(并注释)。
核心框架:①汇率定时任务 daily_fx_rates(tasks.py cron 06:05)——每天抓 exchangerate-api 汇率写 fx_rates(11 个币种:EUR/GBP/SEK/PLN/JPY/CAD/AUD 等),没抓到用最后一次+提示手动提交;②ingest222 存本地币——ads_sku_daily + amazon_ads_daily 加 local_spend/local_sales/currency 列(不折算的本土币金额);③接口返回本地币——kpi-wall 分市场行加 local_revenue、ads/campaigns + ads/analysis 加 local_spend/local_sales/currency、settlement 加 local_amount/currency;④前端 localCur()(fmt.ts)——按 currency 显示本土货币符号(SEK kr / EUR € / GBP £ / SAR ﷼ / AED د.إ / JPY ¥)。
已改页面:①财务页 kpi-wall 分市场表格加"本土币营收 Local Rev"列(AU$6,020 / SAR70,040 / AED4,209);②广告页 spend/sales 显示本土币+USD(SAR842 / AED526 / SAR498);③settlement 页营收显示本土币+USD(¥999 JPY / €43 EUR);④工作台 Noon 平台 per_country 营收本币+折USD 分列(原有);⑤orders 页本币金额列(原有)。today/products 页是汇总/产品级 USD 口径,不需改。
时间选择器:页面顶部全局时间选择器(全部/今年/本月/上月/近3月/近12月),控制 overview tab(finance/full) + matrix tab(profit-matrix) + 全窗口累计表(kpi-wall,接口加 year/month 前缀过滤)。
验证:四门全绿(pen_tests / audit_nodes / dashboard_audit FAIL 0 WARN 0 / frontend_e2e)。截图自检:财务页本土币营收列、广告页本土币、settlement 页本土币均正常。
审计要求:遍历所有页面、所有表格、图表金额逻辑,切换全部国家选择器校验:①单国家内 raw data 原始数据 + 派生字段全部使用本土货币运算;②跨国多国家汇总统一转 USD 美金计算,严禁不同币种直接硬相加;③排查币种转换错误、图表空数据、金额0、空白单元格、API数据注入错误、分页合计错误、导出和前端展示不一致。
审计结果:①财务页所有 tab 按本土货币显示正常(分市场行 SAR/AED/GBP/SEK/EUR/AUD,全市场汇总换 USD);②工作台 Noon 平台分国家表格按本土货币显示正常;③广告页 spend 列本土币正常(SAR842/AED526/SAR498);④settlement 页营收列本土币正常(¥999 JPY/€43 EUR);⑤orders 页本币金额列正常,但发现异常——部分 GB 订单 currency 空(None)导致本币金额显示空。
修复异常:orders 页 GB 订单 currency 空——ops.py 的 /api/orders 接口加 marketplaces 表映射兜底(currency 空时用 country→currency 映射,GB→GBP)。修复后 GB 订单 currency 显示 GBP,本币金额列正常(local_amount 空是 Pending 订单无金额,正常)。
核心规则确认:①单国家内营收/佣金/尾程/结算净额全部使用本土货币运算(local_revenue/local_commission/local_fba/local_net);②跨国汇总全市场换美金求和(USD),严禁不同币种硬相加(分市场行各自本土币,全市场换 USD)。
验证:四门全绿(pen_tests / audit_nodes / dashboard_audit FAIL 0 WARN 0 / frontend_e2e)。截图自检:财务页/广告页/settlement 页/orders 页货币逻辑均正常。
需求:能用本土货币的都用本土货币计算,跨国求和采用美金。所有页面、所有表格、KPI 卡片、chart 都要这样。
完成:①财务页 kpi-wall 分市场表格所有金额列按本土货币显示(本土币营收/净收款/佣金/尾程/结算净额/广告花费/毛利润/净利润,采购成本按 RMB ¥);②广告页 spend 列本土币(SAR842/AED526/SAR498);③settlement 页营收列本土币(¥999 JPY/€43 EUR);④工作台 Noon 平台 per_country 营收本币+折USD 分列;⑤orders 页本币金额列(currency 兜底成 GBP)。
不需改的页面:工作台主页(KPI 卡片合并口径/top_skus SKU 级 USD 汇总)、today 页(今日汇总 USD 口径)、products 页(产品级 USD 汇总)、sourcing/logistics/promotion/onboarding 页(USD 口径)。
核心框架:①kpi-wall 接口分市场行返回所有金额的本土币(local_revenue/local_commission/local_fba/local_promo/local_other/local_ad);②ingest222 order_fees 存本土币费用(local_commission/local_fba/local_promo/local_other)、ads_sku_daily + amazon_ads_daily 存本土币广告(local_spend/local_sales);③前端 localCur() 按 currency 显示本土货币符号,采购成本按 RMB ¥ 显示。
验证:四门全绿(pen_tests / audit_nodes / dashboard_audit FAIL 0 WARN 0 / frontend_e2e)。截图自检:财务页所有金额列按本土货币显示(AU$ / SAR / AED / SEK kr / EUR € / ¥ RMB)。
用户令:「Web端写死框架,API注入数据,所有页面都是这样」——标题/布局/列名固定在前端组件,API 只返回 key+kind+x+series。
实施:①新建 web/lib/chartTitles.ts——113 张图的 key→{title,hint} 注册表(从线上 API 提取,写死在前端);②BrandBoard.tsx 和 NoonBoard.tsx 的 ChartCard 渲染改为从注册表取标题(CHART_TITLES[c.key]?.title),不再读 API 的 title/hint 字段;③API 侧 title/hint 保留在响应中(向后兼容/供审计工具读),但前端已不再消费——后续可在 API 清理。四门全过,双墙截图自检通过。
结构性防御:标题在组件文件里和 API 调用写在一起——改了查询参数,标题就在旁边看着你,文实不符一眼看出。标题语义锚门继续在 dashboard_audit 常驻(从 API 侧对比标题声明 vs 数据实际)。
用户实锤"你他妈的分品牌了吗?说了多少次了"——hourly24 和 hourDist 两图此前只有一条混装系列。修复:sales_hourly 查询改按 (brand, hour) 分组,每品牌一条系列(fittingirls 1078 / onno 399 / zipforce 484)。切具体品牌时自动只剩该品牌一条。四门全过。
第 3 步备份迁移:backup-zipforce.sh(WordPress DB) + backup-pg-analytics.sh(PG dump) 的触发权从 mercury crontab 移到 mars crontab(SSH 触发,备份文件仍在 mercury 本地)。cleanup_braionow_tunnel.sh 留 mercury(本机基础设施,同 acme.sh 性质)。mercury crontab 现在只剩 acme.sh + 隧道清理两条。
迁移清单:①sourcing-v2-dispatcher(原 mercury systemd timer 每分钟)→ mars 宿主 crontab(SSH 触发,脚本仍在 mercury 执行);②label_price_status.sql(原 mercury crontab 每小时×2)→ mars worker cron 直连 mercury PG(psycopg2,SQL 已拷至 /collection/scripts/);③align_zf_fg_schema.sql(原 mercury crontab 每日 04:00)→ 同②。mercury 侧已停:systemd timer stop+disable、crontab 移除 label_price 与 align_schema 两行。
mercury 剩余 cron(均为基础设施,第 3 步处理):backup-zipforce.sh / acme.sh / cleanup_braionow_tunnel / backup-pg-analytics.sh。
通路要点:SQL 类走 worker 容器 psycopg2 直连(104.194.81.222:5432,凭据 /collection/secrets/db.json,与采集器同通路);Python 脚本类走宿主 SSH(容器内无 SSH 别名)。实测 label_price_status 从 worker 容器跑通(0 行更新=当前无待标数据,正常)。
根因:mars `zf_amazon.py` 适配器第 15 行 `BRAND='zipforce'` 硬编码——zf 账号拉的所有订单(含 ON-SKU 欧洲单)全标 zipforce,9 月起 81 单 onno 产品被错标。用户令 「一切以 mapping table 为核心,不猜前缀」。
修复:①`_brand_for_order` 改为启动时加载 `shared.mapping_onno`(32 SKU→onno)+ `shared.mapping_fittingirls`(832 SKU→fittingirls),逐单按 items SKU 查映射判品牌,未匹配→zipforce 兜底;②重拉全量 12 市场 139 单,**81 单 onno 全部回位**(源表 onno:81 + zipforce:171 = 252 正确分布);③SaaS 明日 04:30 全量 ingest 自动对账纠正旧标签。
新铁律(用户令):①数据抓取与 API 注入相互独立、互不干扰——数据库是什么 API 就注入什么,LLM 全程不碰数据流;②不允许拿"自洽"当正确性证明——数据来源问题直接确认源头;③一切以 mapping table 为品牌归属唯一真源。三条已入 AGENTS.md 口径铁律段。
用户实锤"onno 过去24小时 100多单"两轮——真相:/dashboard/onno AMZ 墙的「最近数据日 24 小时订单」图,标题声称最近一天、代码实际算的是整个窗口(30 天)订单按时段聚合(合计 368=30 天量,onno AMZ 真实日均 ~12)。数值层全对(与 SQL 互证),错的是标题语义——所有门都验"数对不对",无门验"标题是否说真话"。onno Noon 侧经双源互证确认为 ~5 单/天(日级采集与月度结算一致),此前"100多单"判断即源于此图。
修复:①hourly24 与同案 hourDist 标题改为「订单时段分布(窗口合计)」+ hint 明示"窗口内全部订单聚合·非单日量";②新立标题语义锚门(dashboard_audit):凡标题/hint 含"最近数据日/今日/24小时"的图,系列合计必须≈SQL 最新单日量,否则 FAIL——上线首跑即抓到第二个同案犯 hourDist,修后 178+ 项全绿。
①🗺 业务流·数据流全景(新 tab):业务闭环五层(数据接入→经营分析→决策→带护栏执行→履约回款+质量回路)与数据管道全链(平台API→mars采集器→源库→ingest对账→96表RLS→口径层→页面→用户,旁路监控报警→自动补抓),Mermaid 双图 + 关键口径锚点(一个口径一份实现/并集铁律/回款费用真源/禁裸零)。②⏰ 定时任务总览:23 项任务五层分类,每项节奏+工作内容+新鲜度核验(2026-09-17 实测全吻合)。③底账烧名单终态 226✅/24📖/5⬜/1❌。三页与 changelog 互链成导航区。
9 窗口并行实点验证 175 个未测控件(写操作点到弹窗即止/禁真推真发),回收 150+ 条带证据结果合并入底账。烧出 1 个全站性真 bug:5 个页面主组件 toast 静默失效(/listings /mapping /settings /onboarding /promotion)——页面组件在 AppShell 内嵌 KitProvider 上方调用 useToast() 拿到空 context,创建/保存/删除等操作反馈全部丢失。修复=KitProvider 上移根布局(layout.tsx)+ 从 AppShell 摘除(同治 useConfirm/usePrompt 同病)。实测 /listings 空创建 toast 正常弹出。
甄别澄清:po 窗口 3 个按钮"点击超时"= 抽屉遮罩挡住后续点击的脚本误报(新建 PO/预警导入/供应商添加实测全部正常开抽屉);ads 花费门槛"KPI 不变"= KPI 全量池口径非 bug(已注)。底账终态:226 ✅实点 / 24 📖代码级 / 5 ⬜未验证 / 1 ❌(培训2卡404)——剩余 5 ⬜ 为 billing 套餐切换三件套+产品串链+供应商表单真提交,均涉及计费/写路径留待专项。
九窗口舰队审计发现的 9 个 P0 + 4 个 P1 当日全修,11 项端到端实测验证:①工作台 Noon 墙 to_char '%%Y-%%m' 格式串错→onno 广告恒空(nAdSales 0→15,636);②noon_statement 双行(42 行清理+ingest left(_,7) 归一)→Noon 回款 900,849→405,820 恰减半;③FBN 销速按 (sku,国家) 拆分(ZF435T1MEB:AE 1411→0/OK、SA→638/WATCH);④盈利矩阵产品维广告 CTE 维度错(0→13,640);⑤推广 fit 评分 =1→>=1(20→715);⑥物流附录空 ds 400→200;⑦文档搜索 setQuery 死代码修复(7 行结果实测);⑧RawTab 契约对齐 items+keepa 嵌套(0→62 行);⑨Pareto POST→GET(405→200 items=30);⑩推广投稿/投放回读区+审批按钮上线(新 GET /api/promotion/orders,黑名单门当场拦截→已登记+基准);⑪inventory 补低库存筛选;⑫PO 抽屉补发邮件按钮(mailBusy 防重复);⑬outreach kind=channel 潜伏 500→400 拒绝。
功能验证底账页:/audit/checklist.html——28 页 258 项控件逐项「逻辑描述+验证状态+证据」,四态计数 49✅实点 / 21📖代码级 / 185⬜未验证 / 1❌(培训2卡404列P2),与 changelog 互链。铁律:本账永不预填✅。
项羽(mercury six-codex 飞书机器人)已停用:模型余额耗尽+Lark websocket 每日崩,systemctl stop+disable。同族 zhangsanfeng-codex-bridge 仍在运行(未动,待拍板)。mercury 侧 sourcing-v2-dispatcher/备份/schema 对齐等 cron 均为 SaaS 数据链上游,保留不动。
上一版挂外链被用户否决("我是叫你把内容复制过来")。本版从 mercury /opt/uvpvp/backend 搬运四页培训内容入 static/training/uvpvp/(Caddy 宿主直出):核心词汇(100 行术语表)/ 运营 SOP / Listing 教程 / Listing 设计规范(含 13 案例图 + 19 张版式实拍图)。处理:去 Jinja(breadcrumb+portal nav)、内联设计变量(--zf-red 色系等)、交叉链接本地化(vocab↔sop↔listing↔design、BraiNews 指向站内既有副本)、源 1.9G 资源目录只保留页面真实引用的 32 张图(5.9MB)。培训页区块改为「UVPVP 培训内容(本地搬运)· 无需 UVPVP 账号」四张内链卡。
截图自检:培训页 · 词汇页(表格 100 行渲染正常,design 页 37 图 0 破图)。
用户指定加入:/training 新增「UVPVP 外部培训站」区块——核心词汇(vocab)/ 运营 SOP(sop)/ Listing 教程(listing)三张外链卡片。三个链接实测均 302 跳 UVPVP 登录页(login?next=… 登录后自动回课程页),故卡片标注「需 UVPVP 账号登录 · 登录后自动跳回课程页」。双视口截图自检通过(桌面 · 移动)。
背景(用户质问"都测试了怎么还有问题"):元素枚举早已全量(517 卡/443 图),但每元素挂的断言类是逐个补的——枚举全、断言不全,每补一类就抓到上一类漏网。解法=交叉矩阵一遍跑:每图表系列 × {品牌加和、站点(国家)加和、空系列}全断言,首跑 75 项 0 违规(品牌隔离 bug 已在上一条修净)。
站点隔离固化进 dashboard_audit:country 维度同款加和不变量(AMZ 17 国 + Noon AE/SA),与品牌隔离共用排除表(比率/Top-N/按实体)。四门全过。
当前断言类清单(每元素全挂):渲染像素非空白 / 值对账(KPI 57 项+节点 2905) / 品牌加和 / 站点加和 / 时间窗语义 / 注释 desc-foot-hint / 响应无 ≥400 / 空系列检测。如实列出尚未覆盖面:表格行级逐行对账(45 表 1385 行只验了有行/空态)、写路径(表单提交/CRUD)、移动端布局(用户已叫停)。
背景(用户实锤"要按品牌和平台区分,你都混到一起了"→"所有数据要随品牌/站点/国家/时间自动筛选,审计怎么没审出来"):昨天的联动断言验证"请求带 brand 参数+首卡值变化",从不断言"每个图/系列真的按品牌隔离"。新立品牌隔离审计(加和性不变量:全部品牌视图每个数值系列==各品牌之和,按系列名配对),首跑即抓到真 bug:
①monthSettle 字典覆盖 bug:全部品牌视图下 amazon_settlement_monthly 每月多行(每品牌一行),payout_m={mon:v} 字典推导按键覆盖只留最后一行——月度结算图显示的是"每月某随机品牌的值"(7 月显示 onno 的 -40,真实三品牌之和 44,500)。修=按月累加;实测全部视图 [5889,44500,1185,-934] 与逐品牌求和精确吻合。②fees 字典键碰撞(键仅 order_id,跨品牌同单号会串费用):键改 (brand, order_id)。③Noon 墙"最新数据日24小时订单"改按品牌分系列(此前全部品牌视图 zf+onno 混一条序列)。
隔离审计已固化进 dashboard_audit(178+ 项):排除三类语义不可加项(比率/均值系列名、Top-N/份额/下钻/最新日、按实体聚合图),其余系列全部断言加和;此前另修 noon_orders 并入 2h 增量("最新数据日"曾是残月:源 75 件 vs SaaS 7 件,卡在每日 04:30 同步点)。
背景(用户拍板"2个都上"):费用滞后分两种——发布滞后(Amazon 结算 2-4 周后才 POST 事件,3 天滚动窗自然追到,占缺失 ~95%)与窗口漏抓(采集器停摆>3 天则事件永久漏掉;成熟周残缺 2-5% 中 Shipped 单是真漏抓嫌疑)。zf/fg finances 原本无任何深窗回补(仅 noon 有周日 30d)。
两层补抓:①兜底深窗——每周日 03:20 collection_finances_deep 对 zf/fg 各拉 45 天窗(覆盖完整结算周期+余量),UPSERT 幂等(键=order+sku+posted_date)零副作用,页上限按天放缩(45d→135 页/区防 2000 事件截断);②报警触发定向重拉——fee_coverage_alarm 检出成熟周低于线时 enqueue fee_backfill_targeted(窗口=报警周龄+7 天,不阻塞报警任务),次日覆盖率重算,回升自动消警、未回升升级人工。采集器 WINDOW_DAYS 参数化(--days,run.py 透传模式补 main() 入口)。
全链路实测:enqueue→worker→采集器 --days 3→23 事件 upsert→rc=0 返回;SaaS 侧 04:30 daily 全量 upsert 自动带出。onno 不需要(onno-finances 本就是全量适配器)。
规范(用户问"费用滞后怎么及时补全"):①度量——metrics.fee_coverage_rows 口径唯一实现,品牌×下单周费用覆盖率,近 12 周滚动;②目标线按实测曲线校准(结算批量 2-4 周龄到达:5%→66%→91%→95%+):≥21 天 40% / ≥35 天 90% / ≥50 天 95%,20 单以下的周不算(噪音);③铃铛新增 fee_lag 计数(与管道断更同款 fail-open);④worker 每日 06:20 fee_coverage_alarm——成熟周低于线 → owner 邮件(best-effort)+stderr,覆盖率回升自动消警;⑤门禁兜底——dashboard_audit 新增成熟周断言(≥35 天且 ≥20 单的周覆盖 ≥90% 否则 FAIL,178+ 项)。
复核节奏:近窗(<21 天)滞后=正常不报;21-35 天低覆盖=观察;连续报警(邮件措辞已注明)=向采集侧发需求单重拉 finances。当前实测全部达标(报警静默、fee_lag=0),KPI 覆盖脚注与铃铛/报警/门禁四者同源。
用户截图实锤近窗口佣金/尾程为 0——数据实证:费用行随结算滞后到达(近 2 周订单覆盖 0-5%、一周前 28%),近 7 天窗佣金尾程必然 0,30 天窗也只 44% 覆盖。此前对账只能证明"显示=SQL"(一致性),证明不了"数据到齐没到齐"(完备性)——判断标准漏了覆盖率维度;状态扫也只断言第一张卡非零。
修复:①_kpi_deck 计算窗口费用覆盖率,佣金/尾程/费用/利润/利润率/TACOS 六卡在覆盖<100% 时自动挂"费用覆盖X%(结算滞后未到,利润偏高)"脚注;②ad_spend=0 且有订单时挂"无投放或广告数据未到";③e2e 状态扫升级为全卡断言:每状态×每张 KPI 卡,0/空值必须带解释脚注否则 FAIL(升级后当场又抓出 onno 广告裸零卡,已补脚注)。截图
遗留公开项:移动端 / 页仍有 518px 横向溢出(宽表无横向滚动容器,ChartGrid 网格已修 44px 档);费用滞后本身属源头结算节奏,需求单已挂。
背景(用户令"所有页面所有功能最细颗粒度全量"):把"全量"从页面级降到元素级,定义六层覆盖矩阵(元素/渲染/值/交互/口径/边界),并立即执行第 1、2、4 层全量:
元素清单(32 路由逐页枚举):517 卡 / 443 图 / 45 表 1,385 行 / 1,465 按钮 / 297 tab / 38 下拉 / 158 输入框 / 956 链接——空表无空态 0、破图 0、API≥400 0、导航失败 0。
40 状态组合扫(平台×品牌×时间窗)抓到并已修:/api/dashboard/merged-kpi?mode=day 空 500(下架视图端点仍被切换瞬态调用;空日期进 BETWEEN 使 date 解析炸)——修=空日期回退近30天,实测 200。fg×Noon 组合无平台 tab 属正确行为(fg 无 Noon 业务)。状态扫已固化为 e2e 节 18(valid-state 感知,0 异常才过)。
背景(用户质问"审计为什么没查出来"的三类盲区):①19 张 KPI 卡从未全量对过账(audit_nodes 只挂 9 个值基准);②注释存在性(desc/foot/hint)从未有检查;③"有轴无数据"的伪装空白图骗过所有容器数/canvas 数断言。且补扫两品牌墙后修正全貌:已知空白共 23 张(zf AMZ 墙 2 + fg 墙 3 + onno 墙 14 + zf Noon 墙 4),全部为数据形态缺口——onno 排名 0 行、shipped_date 0/560、退款源头止于 05-15、摊销列结构性零值、zf 无 noon 日广告源。
落地:①dashboard_audit 增 kpi_pool_reconcile()——19 卡×{全部/amazon/noon} 独立 SQL 按 desc 公式重算 vs kpi-cards API(57 项)+ annotation_checks() 注释门(desc/foot 非空 ×3 平台 + 81 图墙与 Noon 墙 hint 全覆盖),106+ → 172+ 项;②frontend_e2e 增节 17 像素空白扫描——11 个图表页 canvas 彩色像素占比检测,23 张已知空白入 BLANK_ALLOW 白名单(附原因),白名单外新空白 = FAIL;检测器经合成 canvas 自证(空白被抓/彩色不误报)。AGENTS.md 门描述同步。
门写门验:本次门代码自身被拦两次(o. 双前缀 SQL 错、units30 映射错)——与历史上"门两次拒绝写错的基准"同款,基准双实现互检对作者同样生效。
① 退货/退款卡改代码(用户拍板):原纯 Amazon 平台恒 0——AMZ 分支查了 _refunds 却丢弃。现按 desc 口径:AMZ 平台=AMZ 近窗口退款件,全部=AMZ+Noon,脚注分别标注来源。对账 57/57 保持全吻合(当前 90 天 AMZ 退款真值恰为 0,源头最后一条退款单 05-15)。
② Noon 主看板 hint 22→32 全覆盖:每张图题下现在都有口径注释(数据源表+公式,如"CIR 率=当日 CIR 件÷当日总件"、"每日广告花费=noon_ads_daily 日级(仅 onno 有源)")。截图。
③ 6 张无数据图根因:退款图=源头断供(refund_count 最后写入 05-15,挂源头核实);摊销图=结构性零值(无费用事件订单的 other_fees_usd 全 NULL,222 口径本地无数据);zf 的 Noon 广告 ×4=数据在月度不在日级(pl_monthly 33 个月 $59.4 万 vs noon_ads_daily 仅 onno 有行)——日级源缺失挂采集需求单,图上加占位说明待拍板。
KPI 公式全量对账(应用户问"所有 KPI 公式都对吗"):19 卡 × 3 平台变体独立 SQL 重算 vs API 逐卡对比——57/57 全部吻合(营收/销量/订单/利润/佣金/尾程/费用倒算/各比率逐分对上)。发现一处 desc 与实现不符:退货/退款卡纯 Amazon 平台恒 0(代码查了 AMZ 退款数但丢弃,desc 却写"Amazon 退款件数+Noon 退款件数",脚注还显示"Noon 口径")——待拍板改代码还是改文案。
空白图表像素级扫描(彩色像素占比识别"有轴无数据"伪装空白):抓到 Noon 主看板 4 张广告图(每日花费/CTR/CVR/CPS)无论品牌窗口恒空——根因 brandboard.py 的 ads_d = cur.fetchall() 连写两遍,第二遍取空覆盖真数据。修复后 onno 72 天真曲线恢复(截图)。剩余 6 张空白均为真无数据非 bug:Noon 墙 zf 品牌无日广告源 ×4(zf 广告走月度口径)、AMZ 墙分国家退款/摊销 ×2(90 天 refund=0;摊销列 222 口径下恒 0)——建议加占位说明卡(待拍板)。
注释完整性:KPI 卡 19×3 平台 foot 口径注释全覆盖 ✅;主墙 81 图 hint 全覆盖且 UI 渲染 ✅;Noon 墙 32 图仅 10 张有 hint(22 张缺)——待补。检查工具:本次对账/扫描脚本可复跑(/tmp/kpi_reconcile.py 思路入 changelog 存档说明)。
为什么 kpi-cards 500 能过四门:frontend_e2e 原来只监听 request 记 URL 不看响应状态——切 Noon 平台 500 时 KPI 卡残留 Amazon 旧值(非零),"请求已发出 + 值非零"两条断言照样 PASS;响应监听又注册在交互段之后。
堵法(4 处):①失败响应监听提到页面创建时全程生效(/api/ ≥400 全记);②节 3b 加"kpi-cards platform=noon 无 ≥400"回归锚;③节 1-5 工作台交互全程无 ≥400 汇总断言;④全页面遍历逐页归因 API 失败。监听机制已用必然 404 路径自证可捕获;全量 e2e 跑两遍 ALL PASS。
审计范围:DOM 层 34 路由全遍历(NaN/undefined/null/原始字段码/图表渲染/console 错误,269 张截图存档 screenshots/audit-2026-09-16/)+ DB 层(全库唯一索引键 NULL 扫描/无唯一索引表纯重复/新鲜度/跨品牌同单号)+ API 层(audit_nodes 106 端点 2905 数值节点、16 基准)。
抓到并已修的真 bug:工作台切 Noon 平台时 /api/dashboard/kpi-cards 500——_kpi_deck 的 fees_monthly 只在 Amazon 分支赋值、vals 字典无条件引用(UnboundLocalError),为本日早些时候 onno 费用重构引入的回归。修复=初始化外提到平台分支前;实测 noon 平台 200,值合理(3,852 单/$64.6k,fees30 倒算=rev−profit−adsp 精确吻合)。回归门覆盖缺口已记:e2e/audit_nodes 从未以 platform=noon 调 kpi-cards。
其余结论:全站 0 NaN/undefined/字段码暴露、0 导航失败;全库唯一索引键 0 NULL、0 纯重复;已知源头问题维持登记态(onno 广告双表止于 08-31 手动更新、跨品牌同单号 2 对、fg 8 月 Pending 209/860 残余)。裸 /dashboard 为死路由(无 UI 入口,零影响)。/today Noon 表格视图、/ads 表格月度稀疏 0、promotion 测评站域名表均甄别为设计如此/真实数据。
重复数据扫描收尾(上一条挂账的"630 行要清吗")——挖出根因不是误导入,是 ingest 冲突键失配:14 个 Noon SKU 在 222 源表 country 为 NULL,而 PostgreSQL 唯一索引与 ON CONFLICT (brand,sku,platform,country) 对 NULL 不判重(NULL≠NULL),每日 04:30 全量同步每天给这 14 个 SKU 各插一份纯克隆,累计 46 份/组(约 8 月初起)。另 53 组"×2 重复"经查是 AE+SA 两国各一行的合法映射,不是重复。
三层修复:①ingest222._MAP_FULL 冲突键列 coalesce(platform/country,'')(空串可被索引判重);②映射编辑器 /api/mapping/edit 同病同修(空值曾转 NULL 插入);③存量单事务清理:按键去重删 630 行(ZFH24BEX000ME 保留 cost_rmb=15.00 版本)+ 14 行存活行 country 规范化为 '',1763→1133 行,0 重复 0 NULL。
防复发实测:走真实 ingest 通道单跑 sku_mapping 全量源(1132 行)upsert 后 行数零变化(修复前每天净增 14 行)——克隆机制已死。映射页自检:总行 1,133 = Amazon 1,013 + Noon 120,与库内一致。桌面 · 移动
用户三连实锤"佣金尾程不对/好多国家还是0/你自己不检查吗"——根因三层:①_kpi_deck 佣金/尾程从 amazon_orders 的 NULL 列算(onno 采集没抓订单级财务,列全空);②我上一轮"回退 finance_monthly"只在无国家筛选时生效,选国家就 0;③order_fees 的 promo 列把 zf 源表的 promo_rebates(负值=亚马逊返利)abs() 成费用,利润多扣 $2,122。
修复:①_kpi_deck 佣金/尾程改走 order_fees 真源(经 amazon_orders JOIN 获国家/日期/品牌过滤,订单级、国家维度有值);②onno 两个 order_fees 分支 promo 口径改 0(与 finance_monthly promo_usd=0、fg 同款一致);③audit_nodes 基准 SQL 同步 order_fees 口径。实测 onno:佣金 $274 / 尾程 $1,230 / 费用 $1,524 / 利润 $1,996(此前利润 -$126 虚低 / 更早 $3,940 虚高);GB 佣金 $25/尾程 $49、AU 佣金 $12——各国家费用全部有真值。
截图自检:桌面·onno 费用最终版
用户实锤"onno 数据混了 zipforce"→ 深挖出三层问题:
①双计根治:onno 近 30 天订单虚高一倍(394 vs 真实 194)——历史上游把 zf 卖家账号的西欧单(ES/FR/GB/IT 等)brand 误标 onno,SaaS 摄入后上游改正为 zipforce,upsert 只增不删留幽灵行。清理:删 SaaS 中不在 mercury 权威视图(v_onno_orders_unified)的 onno 行 347 条 + 删 zipforce 侧冗余行 252 条(同号双品牌各一行、营收完全相同的冗余)。②items 全字段补齐:onno 订单 sku_list 曾全空(采集 8-31 才上线、ingest 只读一张 items 表)——ingest 改为 UNION 双表(onno_amazon 自有市场 + zipforce_amazon 西欧七国),并写一次性回填脚本(/opt/collection/tools/backfill_onno_items.py,252 单 SP-API 全字段补齐,FK 按源表归属路由)。③防复发:ingest_all 全量摄入后加对账删除(删 SaaS 中源头已不存在的 (brand, amazon_order_id) 行)+ zf 分支排除 brand='onno' 行(v_order_master 无 brand 列,EXISTS 排除)。
最终口径(30 天):onno 344 单 / $5,577 / SKU 覆盖 344/344(100%);zipforce 396 单 / $3,792;品牌间同号残留 2 单(mercury 源头 zf+fg 两表各有的真实边缘案例,$44 影响挂源头需求单)。onno 看板 SKU 图表组全部点亮(此前为空)。
截图自检:桌面·onno 去重后看板
根因:/api/matrix/{data,charts,dimensions} 三个端点从未接受 brand 参数(SQL 全品牌 CROSS JOIN),MatrixSection 收了 brand prop 也没传——顶栏选 onno,四维矩阵的 SKU 列/图表照样是全品牌(zipforce 占多数)。修复:三端点加 brand 过滤(空=全部),前端 fetch 带 brand 且随品牌切换重查。实测 onno:SKU 分布只剩 onno:11、趋势品牌只剩 onno、表格品牌列纯 onno ✔。
关联发现(诚实交代):onno 的 amazon_orders 392/392 条 sku_list 全空(采集侧缺 items 明细)→ 主看板的 SKU 图表组对 onno 为空、Country/SKU 表显示"(无SKU)"——这是源头数据缺口(需采集侧补订单 items),SaaS 不硬造。映射表 sku_mapping 本身存在且 onno 有映射(平台区块 top_skus 正常列出 onno SKU 即证明)。顺手修 brandboard_country_sku 因上轮批量替换误加 country 引用导致的 500。
用户实锤"onno 没有平台费":根因——onno 的 amazon_orders 费用列全 NULL(0/392 有佣金/FBA,zf/fg 100% 有),导致费用卡=0 且利润虚高(未扣平台费 $3,940 vs 实际 $3,368)。onno 费用存在于 finance_monthly(结算口径)。修复:_kpi_deck 订单级费用缺失时回退 finance_monthly 月度费用(窗口月份对齐,同 Noon 月度逻辑;脚注标注"平台费按月度财务";选了国家过滤时不回退、如实显示缺失)。默认卡组并入佣金、尾程(替换 tacos/units30 位)。
平台费构成(口径说明同步):佣金 + 尾程FBA + 促销 + 其他平台费(广告另算)。实测 onno:佣金 $122 / 尾程 $450 / 费用 $572 / 利润 $3,368 = 5997−572−2057,与 finance_monthly 逐分对账一致。
截图自检:桌面·onno 费用修复后
应用户确认,把逐卡核算的口径表放进产品:KPI 概览标题旁「ⓘ 口径说明」按钮,展开完整计算方式表(收入与利润 7 项 / 平台费用 2 项 / 广告 5 项 / 订单状态 5 项,含公式与数据源)+ 三条口径边界(Noon 金额按月对齐非日切 / 订单含全状态 / Cancelled 单件混合)。此前每卡仅有悬停一句话提示。
用户纠正上一轮去重方向:"kpi 是合并,不是 2 选 1,而且要放到 chart 上面"。落地:①指标池合并——看板五卡独有的四个指标并入 KpiDeck 池(近30天订单/近30天费用(营收−利润−广告倒算)/客单价/取消率,池 15→19 项,任何卡位可换选);②默认卡组=两套并集(订单/营收/利润/费用/利润率/客单价/广告花费/ACOS/TACOS/销量);③布局修正——KPI 概览卡从看板下方(1.8 万像素深处)移到图表墙上方(此前集成看板时插错了顺序)。实测:合并卡组 10 张数值齐全,KPI y=172 < 图 y=773 ✔。
截图自检:桌面·合并KPI在图表上方
用户问"为什么有 2 套 KPI 卡片"——历史叠加:KPI 概览卡(自研,10 卡可换指标+账号记忆)与主看板内嵌自带的 UVPVP 固定五卡重复。处理:工作台保留 KpiDeck 一套(跟随品牌/平台/国家/时间全部筛选器);看板自带五卡在内嵌模式隐藏(/dashboard 全屏页保留),Noon 板的 FBN 库存预警卡独有信息保留。
截图自检:桌面·单套KPI
应用户需求"新账号要添加自己的平台 API,需要设置入口,包括货代等服务商"。新页面 /settings「API 接入」(侧边栏·账户组,仅 owner/admin 可见):两个 tab——🔌 平台 API(Amazon SP-API 三区 token / Amazon Ads / Noon 合作伙伴)与 🚚 服务商(货代/物流 + 其他第三方),目录驱动的动态表单。
安全设计:Fernet(AES128-CBC+HMAC) 加密落库(密钥由 GLOBAL_SECRET 派生);明文提交即丢弃——任何接口只回掩码(如 yw-key…3456),编辑=整包重录不预填;变更全程只追加审计(触发器拦截改删);SP-API 凭据支持一键 LWA 连通验证(真换 access token)。实测:录入→掩码列表→明文零泄露检查通过→删除清理。
阶段边界(如实):v1 为"管理+验证"闭环;凭据自动接入采集管线(替代 /opt/collection/secrets 服务端文件,采集侧按 tenant_credentials 优先、文件兜底)为下一期。
用户报"检查切换国家功能"→ 实测坐实历史同款坑:KPI 概览卡与平台区块跟随国家(US $2,517 / ES $4,005 / 全部 $32,435 变化正常),但 Amazon/Noon 主看板完全忽略国家选择器(BrandBoard 请求硬编码 country="",页面上排头的 KPI 卡正是看板自己的,造成"切国家数字不变"的观感——与记忆中"_units 派生查询漏 cf 过滤"为同类病灶)。
修复:BrandBoard/NoonBoard 接受 country prop(请求参数 + 缓存键第四维);/api/brandboard/noon 三表(orders/pl_monthly/ads_daily)与 /api/brandboard/orders 增加 country 过滤;charts 端点 cf 过滤本就现成。实测:全部国家 546 单 → 切 US 看板 2 单(2026-09-02→09-07),与 DB 交叉验证一致(zipforce US 30 天=1 有效+1 取消)。e2e 增加"主看板请求带 country=US"契约。
截图自检:桌面·切US后看板跟随
应用户拍板"肯定能做就做"。四个端点加 frm/to(YYYY-MM-DD,同时提供时覆盖 days 拖尾窗):/api/dashboard/charts(订单基准 BETWEEN + 小时表 BETWEEN,81 图全部自动跟随)、/api/brandboard/{orders,country-sku}、/api/brandboard/noon(日表 + 月表 mon BETWEEN 对齐)。前端看板缓存键升级为 天数|from|to(同天数不同区间不再撞缓存),内嵌提示行显示精确区间。
对齐实测(8 月整月):KPI 582 = 看板 582 单(2026-08-01 → 2026-08-31)✅ 双视口一致;旧拖尾近似为 567/08-17 起的偏差消除。e2e 新增三条契约断言(看板 frm/to 请求、KPI date 区间请求、看板窗口标签)。预设档(7/30/60/90/全部)行为不变。
截图自检:桌面·自定义8月精确区间 · 手机·同
应用户要求"看板和 KPI 用 7/30/60/90/全部 + from/to"。工具栏时间选择器重做:7天/30天/60天/90天/全部 预设 + 自定义日期区间,一个选择器同时驱动 KPI 概览卡、平台区块(内部统一映射 period=day&date..date2)与 Amazon/Noon 主看板(days 受控 prop,内嵌时看板自己的时间窗按钮隐藏,全屏页保留)。KPI 卡标签随窗口自适应("30天营收"/"90天营收"…)。
对齐实测:默认 30 天 KPI 546 = 看板 546(08-18→09-15);切 7 天 42 = 42(09-10→09-15);切 90 天 1,643 = 1,643(06-19→09-15)✅。已知边界(如实标注):自定义区间时 KPI 为精确日区间,图表墙按"区间天数拖尾窗"近似(如 8/1~8/31 → 08-17→09-15),看板窗口行有提示文案——精确日区间需图表墙 API 扩展 from/to(81 图深改,待排期)。顺带清理:旧"日粒度不适用 Noon"提示卡删除(noon 日窗口实测有数)、月/年下拉移除。
截图自检:桌面·30天默认 · 桌面·90天 · 桌面·自定义8月 · 手机·30天
用户反馈"全部平台数据不好用,先 disable 不显示"。平台选择器移除「全部平台」,工作台默认直接进 Amazon 视图(KPI 概览卡 + Amazon 主看板),Noon 按需切换。MergedOverview 组件与 /api/dashboard/merged-kpi 端点代码全部保留(复活只需恢复按钮与默认值,合并口径已通过四品牌交叉对账:all=AMZ+Noon ✅)。e2e 品牌联动断言回到 kpi-cards 契约。
截图自检:桌面·默认Amazon视图 · 手机·默认Amazon视图(双视口确认无"全部平台"残留、看板与KPI正常渲染)
用户选定 C+:近30天/按日时金额卡主值保持 "—"(忠于所选窗口,不冒充),脚注展示最新完整月合计参考(如"2026-08合计 $92,453 · 此窗口金额不可加")。实现:merged-kpi 日级响应附 ref{month, all}(最新完整月聚合,月度聚合抽为 _merged_month_agg 共用函数);订单/件数仍为日级真合并(4,545 = AMZ 1,857 + Noon 2,688)。未采 A(单侧AMZ数=回潮"粘")/B(窗口错位) 的理由已与用户对齐。
上线实况截图(2026-09-16 存档): 桌面·月模式 · 桌面·近30天(C+参考值脚注) · 手机·月模式 · 手机·近30天
应用户指出"卡片没有时间选择器":/api/dashboard/merged-kpi 增加 mode/date/date2,工作台时间选择器(近30天/日/月/年)直接驱动合并卡——
· 月/年窗口:金额+订单全量合并(区间聚合,脚注仍是两平台拆分);默认打开=月模式·最新共同完整月(8月:5,079 单 / $92,453 营收)。视图默认规则:全部平台=月(金额可合并),平台页=近30天;用户手动选过则尊重选择。
· 近30天/按日窗口:订单与件数日级真合并(AMZ 订单≠Canceled + Noon distinct order_nr/件级行,实测 4,543 = 1,855+2,688);金额两端返回 null 显示"—"(Noon 无日级金额源,硬加=误导),脚注引导切月/年看金额。
· 排障:合并视图此前误收"筛选器自动兜底月"(当月残月 2026-09),改为只传用户显式选择,空则端点回退最新完整月。
用户实锤:上一版合并视图实际只算了 Amazon——full.matrix 仅含 finance_monthly(Noon 行是 API 层另组数组,从未进 matrix)。修正:新端点 /api/dashboard/merged-kpi(audit_nodes 104 端点)取最新共同完整月(排除当月残月),AMZ(finance_monthly 结算口径 + 广告/回款运行时并集,与 /api/finance/full 同源同列)+ Noon(pl_monthly settlement 折USD 锚定汇率 + 对账单回款 abs 口径)逐项相加;工作台合并卡每张脚注展示平台拆分(如 "AMZ $42,017 + Noon $50,436"),卡片自身即可对账"全部=平台之和"。实测 8 月:订单 2,063+3,016=5,079,营收 $42,017+$50,436=$92,453,净利 $24,648+$30,531=$55,179。口径不同的取消率/ACOS 仍显示 "—"。Noon 回款月度对账单滞后(8 月未出→0,脚注注明)。
排障记录:finance_monthly 实际列名 commission_usd/fba_usd/promo_usd 且无 ad/payout 列(full 是运行时并集);noon 结算列名 settlement 非 net;noon_statement payouts 需 abs(与 full 一致)。e2e 品牌联动断言改验 merged-kpi。
应用户指令"全部平台不可硬把不同平台的页面粘在一起,要合数据":全部平台视图 = 合并 KPI + 四维矩阵 + 平台入口——6 张合并卡(订单/营收/净利/费用/回款按 finance_monthly 最新完整月跨平台同源加总:AMZ USD + Noon 折USD;净利率由加总值派生;取消率/ACOS 因跨平台口径不同显示"—");两个主看板、KPI 概览卡、平台区块全部退到各自的平台页(Amazon/Noon 平台页按钮一键直达)。选定具体平台时视图与之前完全一致。顺带解决了此前挂账的"全部平台≈Amazon"观感问题。
e2e 前端契约同步:品牌联动断言改验 /api/finance/full?brand=;国家/时间联动移到平台页内验证(全部平台视图按设计不消费这两个筛选)。
应用户要求移除。背景:9-12 独立 /matrix 页撤掉时 MatrixSection 被散装塞进三处(工作台卡/财务底部/选品tab),选品这份无业务必然性且与情报台市场研究气质不符。移除后主 tab 为 选品情报台/数据探索/监控池/决策台;四维矩阵保留两处——财务页底部(用户指令位置)与工作台卡片。
应用户要求,/upload(📁 文件 + 📄 A+ 内容)并入 /listings:Listing 页 tab 变为 任务 / 工作台 / 导出回流 / 模板库 / 📁 文件 / 📄 A+ 内容 六个。文件与 A+ 组件原样搬迁(upload/FilesTab.tsx 抽出 + AplusTab 复用,零逻辑改动);/upload 路由 308 重定向到 /listings(老链接/收藏不受影响);侧边栏移除"上传"入口(Listing 一个入口收口内容生产)。e2e 第 16 节 A+ 断言同步改址。
应用户要求"把每个类目的属性拉下来以便 AI 填写"——此前只有按需拉取(绑定时),本批完成全量预取与对接:
①批量预取(tools/prefetch_pt_meta.py,幂等可重跑):453 个产品 → 品名 PT 搜索 → 428 条产品→类目建议入新表 listing_pt_suggest(pg-init/50),13 个唯一类目的官方 schema 全量入 listing_category_meta(如 SECURITY_CAMERA 168 字段 / BRA 135 字段 / POTABLE_WATER_FILTER 123 字段,均含必填标记与枚举)。②建任务自动带 PT:Amazon 任务创建即查建议表自动绑定 product_type。③AI 对官方字段填写:_task_schema 统一四处(详情/生成/编辑/批准)——绑定 PT 后规则+AI 全部对官方 schema 工作;实测文胸产品:规格书 9 条 → AI 映射 9 项到官方字段(fabric_type/bra_cup_coverage/bra_design/care_instructions,"34B"被拆为 band=34 + cup=B)+ AI 英文标题五点。
排障记录:spapi zf 市场 token_region 大小写笔误(31 产品报错后修正重跑 0 错);RLS 下批量脚本需 SET app.tenant_id。真推(PUT listingsItems)仍待用户拍板单 SKU 实测。
11 步流程的 ③⑨⑩⑪ 步落地(Amazon 侧):①新模块 api/spapi.py——LWA 换 token、PT Definitions 搜索/Schema(schema.link 实为 {resource:预签名S3URL} 对象,已实测修正)、Listings Items put/get;品牌独立 decodo 代理 + 出口 IP 断言(采集铁律同款,10 分钟缓存);凭据直读 /collection/secrets/(fg_amazon.json / zf_lwa/ / onno_amazon_creds.md),零复制零新密钥。②新表 listing_category_meta(pg-init/49,官方属性元数据缓存 7 天;坑:表+序列都要 GRANT portal_app)。③四个新端点:pt-markets(品牌市场表,采集器同源)/ pt-search / pt-schema / bind-pt(绑定后工作台属性编辑器自动切换为 168 个官方字段,含必填标记与枚举下拉);submit(dry_run 预检 + 真推 putListingsItem → 回写状态/ASIN/报错)。④状态机扩展 submitting/submitted/failed。
实测链路:建任务→规则生成→PT 搜索(light bulb security camera→SECURITY_CAMERA)→绑定(168 字段/6 必填)→approve→dry_run 预检精准报缺 brand/country_of_origin/supplier_declared_dg_hz_regulation。audit_nodes 快照 100→103 端点。
挂账:真实推送(PUT listingsItems)已实现未实推——等用户指定首个 SKU 补齐必填后拍板单点实测;Noon 直推为期3。
为 11 步 Listing 流程的期2(类目元数据 API + 平台直推)完成凭据与出口盘点。本页只记位置与 IP,凭据内容永不落此页。
① 平台 × 品牌 × 凭据 × 出口 IP 总账(权威源 /opt/collection/TOPOLOGY.md,出口 IP 今日逐项实测一致 ✅):
| 品牌 | 平台 | 凭据(mars /opt/collection/secrets/) | 市场 | 出口 | 出口IP(实测) |
|---|---|---|---|---|---|
| fittingirls | AMZ SP-API | fg_amazon.json | 11国 | decodo:10001 | 72.245.71.143 ✅ |
| AMZ Ads | fg_ads_creds/profiles.json | — | 同上 | 同上 | |
| onno | AMZ SP-API | onno_amazon_creds.md | AU/SA/AE/US | decodo:10002 | 9.249.112.206 ✅ |
| AMZ Ads | ❌ 无API→人工CSV(dropbox/onno-ads/) | — | |||
| Noon API | noon_onno.json(RS256) | SA/AE | 同:10002 | 同上 | |
| zipforce | AMZ SP-API | zf_lwa/(五区) | 12国 | decodo:10003 | 23.26.215.184 ✅ |
| AMZ Ads | zf_ads_creds/profiles.json | — | 同上 | 同上 | |
| Noon API | noon_zf.json | SA/AE | 同:10003 | 同上 | |
出口铁律在运行:run.py 每次采集前 assert_exit_ip 断言,漂移即拒采+报警;端口映射 10001/04→fg、10002/05→onno、10003/06→zf。
② SP-API 只读实测(fg 凭据,纯 GET):LWA 换 token ✅ 200 → Product Type Definitions 搜索 ✅ 200("security camera light bulb"→SECURITY_CAMERA)→ PT Schema ✅ 200(schema.link+propertyGroups)。期2 第3步(类目元数据拉取)可行性确认;Listing 写入 scope 待期2 实施时单 SKU 受控验证。
③ 项羽(mercury /opt/six-codex Codex 机器人):profile 单 provider(scienceedu/gpt-5.6-sol),余额不足(INSUFFICIENT_BALANCE)不可用,需充值或经批准改指其他 LLM 端点。
11 步目标流程的 4/5/6 步 AI 化(规则打底、LLM 兜底,任一失败静默回退纯规则):①规格书上传后规则命中不足时 LLM 补抽 KV(条目标 ai:true);②生成时 LLM 把规格值映射到未填类目属性(带枚举的属性强制从枚举选,gen_meta.attr_sources 记 ai:map);③LLM 生成英文标题+五条卖点(20~200/3~6 条校验通过才采纳)。gen_meta.engine=rules-v1+ai-v1,工作台显示"AI映射 N 项 · AI标题 · AI五点"来源标识。generate 加 ?ai=0 纯规则秒回通道(pen_tests 回归走此路径)。实测 onno 摄像头灯泡产品 9 秒出 AI 标题+五点,质量达标。紧急开关 LISTING_AI=0。AI 调用计入 aiusage 额度。
挂账:期2(类目元数据 API + SP-API 直推)与期3(Noon API)待凭据——mercury 上的 Codex 机器人"项羽"因模型账户余额不足(INSUFFICIENT_BALANCE)未能回答凭据问题,需充值后再问。
应用户要求(截图圈选"这几个按钮都不要"),移除工作台全部看板控制按钮:「📊 Amazon/Noon 主看板 ▲ 收起」两个开关、「全屏打开 →」×2、「收起 ▲」×2。现在两个主看板常驻直出,无任何外壳开关;品牌选"全部"时仅保留品牌快切小签(ZipForce/Fittingirls/ONNO 与 ZipForce/ONNO)。实测 0 按钮残留、137 canvas 正常渲染、手机视口验证通过。
挂账待决:用户指出"全部平台 ≈ Amazon 平台"观感问题——实测语义正确(全部=双平台分算都显示),但 Amazon 内容(81 图看板)全在页面前部,Noon 内容被推到十余屏之后。三个方案待拍板:A 按平台分组重排(节标题吸顶)/ B 仅在 Noon 内容起点加分隔标题 / C 不动。
应用户要求移除 preview.zipforcehub.com:删除 compose web-preview 服务与容器、Caddyfile 显式站点块(重启网关后该域名 TLS 握手即被拒——按需签发 ask 门不放行非租户域)、web-preview/ 源码目录、镜像。UVPVP 绿色主题两件套(globals.css + 顶部 tab 外壳 AppShell.tsx)已随整目录归档至 backups/code-2026-09-15/web-preview-decommissioned.tar.gz(127 文件),将来要上该主题可直接取回。生产 zipforce.zipforcehub.com 全程无感(验证 200)。
与 Amazon 主看板同法:Noon 品牌看板主体抽为 components/NoonBoard.tsx(5 区块 32 图 + FBN 库存预警卡 + 数据审计说明卡),路由页 /dashboard/noon/[brand] 变薄壳。工作台工具栏新增「📊 Noon 主看板 ▼」展开按钮(选 Noon 平台或全部平台时可见),品牌快切支持 ZipForce / ONNO;默认展开(同 Amazon 看板,用户拍板落地即见)。实测内嵌 32 图 + FBN 卡与独立页逐项一致。
应用户要求建立全站改动台账:/audit/changelog.html(静态直出,主域与租户子域均可访问)。约定:每次生产/预览改动上线后在此页顶部追加条目(环境/验证/回滚锚点三要素),与 backups/code-<日期>/ 快照目录互为印证。
应用户要求,工作台的「📊 品牌主看板 →」跳转链接改为页内展开式区块:点击按钮就地展开完整看板(8 区块 81 图 + KPI 条 + 订单/Country-SKU 表格),默认展开(初版默认折叠被用户否决:集成=落地即见),按钮可收起。顶栏品牌切换自动跟随;"全部品牌"时提供 ZipForce/Fittingirls/ONNO 快切。实现:看板主体从 /dashboard/[brand]/page.tsx 抽为共享组件 components/BrandBoard.tsx(独立全屏页保留为薄壳,ChartGrid 拖拽持久化 pageKey 不变)。顺带修正工作台四维矩阵卡过时的"64 组"文案。
问题:报告内容与搜索词无关——后端 /api/ai/sourcing 从未读取前端传的 country/term,把自营 SKU/财务数据交给 LLM 写"加码建议",与选品情报台的搜索语境完全错位。
修复:带 {country, term} → 基于该词的 ABA 月度席位序列 + 上榜 ASIN Keepa 档案(与 explorer 同源同口径)生成竞争格局报告;无参数保留旧自营模式(向后兼容)。响应新增 term/country 字段供前端校验。
新增 GET /api/sourcing/keepa-history:单 ASIN 按需拉 Keepa 原始时序(1 token/ASIN,Redis 缓存 24h,计入每日选品额度)。csv 索引经实测校验(1=New价 2=Used 3=BSR 4=List 16=评分 17=评论数;BuyBox 需更贵的 offers 参数暂未开)。前端 Keepa 子页新增「⚡ 拉取原始曲线」按钮,7 张历史图(New/Used/List/Amazon 价 · BSR · 评分 · 评论数)升级为真曲线(≤720 点 + 缩放滑块)。audit_nodes 快照 99→100 端点。
本地 aba_search_terms 一直有 Top1/2/3 点击·转化份额六列(快照每天从 mercury 拉全列),但 explorer 组装 timeline 时只保留了 Top3 汇总、丢掉了分席位值,导致「Top1/2/3 点击/成交份额曲线」两张图长期"暂无数据"。补齐 6 字段(本地快照 + Dell 实时两条路径),曲线 12/12 月全量点亮。
根因:aba_keepa_full 是快照表(当前值 + 窗口聚合),无原始时间序列;39 张单 ASIN 图里的"历史曲线"只有 1~2 个点可画,大画布上孤点视觉等同空白。
处理:纯 line 且非空点 <3 的图不再画布,降级为「快照摘要卡」(显示可用当前值 + 说明);真无数据的显示"无数据";卡片标题栏注明快照近似边界。实测 13 张转摘要卡、9 张无数据、40 张真图保留。
SaaS 建库时把 fg 品牌写成了 fittinggoals(笔误;mercury 源库 schema 本为 fittingirls_amazon.*,UVPVP 页面 tab 亦为 Fittingirls)。一次性正名:21 张表 133,248 行 + tenant_brands/brands_source 注册表 + api 6 文件 + web 4 文件 + tools 5 文件;采集链路同步改名,次日定时任务直接写新名。改名前 pg_dump 全量备份。
问题:Noon 广告与 onno-Amazon 数据止于 08-31(手动更新模式),切"近 7/14 天"整个图墙全空;symbol:"none" 使单点序列不可见;Amazon 的 ATC 恒 0 画空坐标。
修复:①当前窗口无数据时自动探测全量时段,有历史则自动切"全部"并黄条提示数据止点(用户手动选短窗口只提示不强切)②数据止于 3 天前挂「数据止于 MM-DD」徽标 ③点数稀少时显示数据点 ④Amazon ATC 图换占位说明。
preview.zipforcehub.com 上按 UVPVP 形态重做外壳:顶部 sticky 白头(品牌 logo + 绿点 + 用户区)+ pill tab 导航行(替换深色侧边栏)、内容区 1280→1600、图表两列→三列、卡片标题绿下边框、表头灰底、KPI 六列。生产 zipforce.zipforcehub.com 保持原版靛蓝。回滚镜像 tag:zipforce-saas-web:rollback-20260915-pre-uvpvp。
应用户要求,财务页「🔢 四维矩阵」tab 移除,整块固定为页面最后一个区块(口径脚注之下、不受 full 数据块加载影响)。顺带修三处:①维度组合已扩到全量(10,644 行),表格无分页曾把页面撑到 39 万像素高 → 客户端分页 20/页 + 受控全局排序;②默认收入降序(否则前几页全是 $0 空组合);③死 Tailwind 类换 CSS 变量着色。已知留白:platform 维为 SQL 合成维度,同组合重复 4 行同值(动 API 需过口径门禁,挂账)。
背景:用户拍板四道防线全做 + 新要求"未来几万租户,新用户开通自动复制全数据系统"。万级租户定案:共享 schema + RLS 隔离(不复制表)+ 注册表播种(开通即自动接线管道)——RLS 三租户矩阵实证 t1=272/t2=373/t3=1208/未设GUC=0 精确闭合。
① 租户矩阵冒烟(新工具 tools/tenant_matrix.py):每个活跃租户登录 → openapi 全量枚举 GET 端点(本租户 94 个)→ 递归收集响应 brand 字段 → 断言不含仅授权他租户的品牌。首跑即抓 5 处疑点,分诊后:sourcing 两端点为市场第三方品牌(选品/ABA 公开数据,豁免);onboarding/tenant-brands 为本租户自己的停用品牌管理行(非跨租户,信息项备案)。修正基线后 ALL PASS:跨租户品牌泄漏 = 0。fittinggoals 租户无演示口令,支持 secrets/tenant_matrix_creds.json 补充后覆盖。
② 部署门禁(新脚本 tools/deploy_gate.sh):镜像固化 md5(4 对)+ 四门回归一键化,任一不过 exit 1 拒绝部署;--quick 跳过最慢的前端像素扫描。首验 --quick 全过。
③ 注册表化实证收口:动态分支主路径早已落地(_refresh_dynamic_specs 按 brands_source.source_map 生成订单/小时销/广告四表+结算/退款/排名/广告分支)。容器内 dry-run 实证:模拟新品牌注册 spapi_orders+ads_products 管道 → sales_hourly/ads_daily/ads_sku_daily 分支自动生成,原三品牌不受影响。三遗留项定性保留:_PIPE_ORDER=排序元组、_ONNO_AMZ_ADSSKU=源拓扑差异(等 mercury 需求 2/4)、brand<>'onno'=双计防护守卫。
④ 开通链路验证:signup 自动播种 tenants+owner+初始品牌+8 模块;向导 brand.register 自动补 brands_source/仓库种子/渠道/sku_mapping/products + provisioning_log;管道接线全走注册表。E2E 测试租户创建被 SMTP 526 阻塞(验证邮件发不出,等密码重置后补)。
用户三问的正面回答:① changelog 总结在下面这张总账表里;② 历史问题按"同类不再犯"原则逐类绑定机器检查——检查不过 = 当天日报 FAIL;③ 四层监管(rawdata→cleandata→api→web)每天针对性审计一次,监控 agent(SaaS 外、纯代码、零 LLM)早 07:10 自动跑,遍历全部活跃租户,报告落盘 reports/ 并邮件(SMTP 修复前仅落盘)。
总账表(失败模式 → 历史案例 → 每日针对性检查):
𝗔 采集断供(fg 断 9 天、worker skipped 两天、AE/SA 静默零单 13 天)→ 每日查:管道水位(≤2天)、数量骤降(昨日vs前7日日均双门槛)、逐日订单断档、国家级断档(近60天≥5单的国家 3 天无新单即报——AE/SA 教训:表级水位对国家级断档免疫)、worker 日志 skipped/failed、API today 数据日边界、注册表"注册未回流"。
𝗕 双计/幽灵行(sales_hourly 384 幽灵行、inventory_health 56% 幽灵行)→ 每日查:身份恒等式(全品牌=Σ分品牌)、inventory_health 幽灵行占比(>30% 报)、清洗表 vs 源表水位逐表滞后。
𝗖 隔离泄漏(混品牌表、RLS 覆盖缺口、策略缺 is_active)→ 每日查:RLS+FORCE 全表面覆盖(180 表,白名单备案)、全租户身份恒等式(动态遍历每个活跃租户:portal_app 可见=活跃品牌期望,万级租户自动覆盖)、租户矩阵跨租户泄漏扫描(全端点×全可登录租户)、孤儿 brand、清洗隔离键 NULL、ai.py 零写库。
𝗗 静默失败(灰饼图、接口空壳、SQL 类型错铃铛报错、连接池耗尽间歇 500)→ 每日查:页面/静态资源冒烟、前端像素级回归(29 页)、api 日志 Traceback/500/PoolError/UndefinedFunction+DataError(text 列比 now() 类)、网关 5xx(caddy 访问日志已开)。
𝗘 AI 幻觉进工作流 → 每日查:ai.py 零写语句、LLM_API 引用不出 ai.py。
𝗙 配置漂移(改代码忘 rebuild 实证两次)→ 每日查:容器存活 + 镜像 md5 固化(部署前另有 deploy_gate 门禁强制)。
𝗚 资源/可观测(磁盘、证书、caddy 无访问日志、worker 日志随重建丢)→ 每日查:磁盘 ≥5G、证书 ≥14 天、网关 5xx 可审计;worker 日志落盘待办。
2026-09-23 四层审计结果:cleandata 6/6 过;api 7/7 过(0 异常);web 基础设施全绿但像素回归抓出 工作台 filters/sku-sales 间歇 500 → 根因连接池耗尽(SimpleConnectionPool 非线程安全+maxconn=10)→ 已改 ThreadedConnectionPool(1,25) 部署;rawdata 7 项 → zipforce AE/SA 断档根因:Amazon 卖家账号 16 站点参与列表已无 AE/SA(站点被移除,业务拍板弃用或恢复);国家断档检查首跑另抓 fittingirls/PL、onno/IT 并已实锤定性:Amazon 端 9 月中旬起零新单(zf EU IT 站最近创建单 09-02,非 SaaS 四层 bug,属业务/账号侧静默);inventory_health 幽灵行 56%、brands_source 重复注册行(清理需用户二次确认)。
① inventory_health 幽灵行根治:_snapshot_reconcile 扩展进 ingest_today/ingest_all 两处(键 brand+sku+marketplace,快照语义=键集外即幽灵),首跑清 556 行,此后每轮 ingest 自动对账。口径修正:剩余 60% NULL last_updated 是源视图不给时间戳的正常快照行,监控检查改为防结构性断裂(≥95% 才 WARN)。
② worker 日志落盘:compose command 改 tee -a /logs/worker.log(卷挂载 ./logs/worker,容器 uid 1000 已授权限),事故日志跨重建保留——四层审计低危项关闭。
③ 监控 ignore 机制:/opt/saas/monitor-agent/ignore.json(缺省空表)——用户拍板定性的问题(如 AE/SA 站点弃用)配置子串后 FAIL 转 ACK 单列留痕,不计失败。
④ 注册表语义澄清与回滚(用户纠正"按代码走"):曾将租户1名下 fittingirls/onno 三行及 brainnews 空行置 enabled=false,经指出后全部回滚(UPDATE 4,8 行全 enabled=true,四管道三分支验证正常)。代码语义:管道身份=(brand,platform),多租户行是同一管道的重复登记,enabled 是管道级状态;租户级停用由 tenant_brands.is_active+RLS 表达(已生效)。空 source_map 占位行代码已自动过滤,无需手工禁用。⑤ 部署后复验:镜像固化+pen_tests+dashboard_audit+audit_nodes 全过;inventory ingest 实测 sales_hourly 对账 6 行 + inventory_health 对账 556 行同步生效。
发现:用户核对注册表清单时指出租户1还有 zipforce/noon 管道。查证:该管道真实在跑(noon_zf 采集器→zipforce_noon schema,noon_sku_pl_monthly 水位 2026-09 正常),但没有独立注册行——嵌在 zipforce|amazon 行的 source_map.noon 键内。水位检查按行的 platform 字段只认 platform='noon',zipforce 行标 amazon → zipforce 的 noon 断更将无人知晓(onno 有独立 noon 行所以幸免)。
修复:metrics.pipe_stale_rows(铃铛+每日报警唯一实现处)与监控 agent check_pipelines 双路径同修——platform='noon' 或 source_map 含 noon 键都查 noon_sku_pl_monthly 月水位(≤35天)。api+worker 已 rebuild,验证:监控水位出现 zipforce/noon_sku_pl_monthly(当前正常故静默),pipe_stale_rows 无异常。
模型(用户定):管道=品牌×平台共 5 条——zipforce/amazon、zipforce/noon、onno/amazon、onno/noon、fittingirls/amazon。
变更:① 新增独立行 (1, zipforce, noon),source_map = {"noon":{schema:zipforce_noon, has_ads:true, rankings:zipforce_noon.zipforce_noon_rankings}}(与 onno|noon 同款布局);② zipforce|amazon 行摘除嵌套 noon 键(jsonb - 'noon' 回写 json)——两步合一事务,避免双分支。代码依据:_refresh_dynamic_specs 双布局原生支持(for _pf in ("amazon","noon"))。验证:注册表管道键恰为 5;noon_sku_pl_monthly zipforce/onno 分支各=1(无重复);sales_hourly 三分支正常;rankings_daily 含 zipforce_noon。多租户重复授权行(t1 名下 fittingirls/onno、brainnews 占位行)按代码原样保留(DISTINCT ON 与空 map 过滤天然处理)。
决策(用户拍板"做"):订单/销量链全站按北京时间翻日。关键事实:amazon_orders.purchase_date 是 DATE 列(UTC 日在摄取时固化),查询层无法补救 → 翻转必须落在 sync_mercury 派生 SQL + 一次全量重同步。
改动:① sync_mercury 派生全翻(_IT_RAW×3、_ORDERS_UNION 含 last_update、onno 分支、增量滑动窗、hourly 对账窗×2,统一 (purchase_date AT TIME ZONE 'Asia/Shanghai')::date);② metrics 新增 bj_today() 唯一实现(业务日=北京时间)+ volume/fee/水位全部改走;③ dashboard 窗口工厂 _period_win/_kpi_deck 的 Python today 翻 bj_today(SQL current_date 之外的漏网点,审计抓出);④ ai.py sales_daily 窗口、monitor bj_today(顺带修复 cron 07:10=UTC23:10 报告日期戳差一天的隐性 bug);⑤ 审计工具 purchase_date/kpi-ads 窗口同口径翻转(16 FAIL→3)。不动轴:ads 日(Amazon 站点日)、月度结算期、keepa/rankings 快照戳、ai 配额桶。
验证:全量重同步 37,550 行(sales_daily 1,607 重派发);边界单抽查精确(UTC 16:16→存北京次日 09-23;UTC 15:51→存同日);时区差归零:orders(排除取消) 18 = hourly 18(残余 1 差 = hourly 原口径排除取消单,属图表语义差,冻结口径不动)。挂账:dashboard_audit 余 3 FAIL(广告 kpi 基线 2% 级边差——需逐字段对照 _kpi_deck adsp 与审计基准;费用覆盖单周边界)+ ad_campaigns 摄取断供(mercury 2521 vs mars 86,Task 独立跟踪)。pen_tests 通过。
① campaigns 断供修复:根因=注册表化时动态分支 `_CAMP_BRANCH` 只输出 8 列,丢失 country(而 _SPECS 列清单 9 列且 country 在冲突键里)→ `row[8]` 越界报错,同步自注册表化起持续失败。补齐 country 列(与静态版逐字对齐)后报错消失,84 行聚合正常刷新。澄清:该表是"近30天×campaign×国家"聚合语义,行数与源表快照行数本就不同,此前问题=报错导致停止刷新。
② 连带揪出回归(翻转时区时引入,验证环节实锤):_ORDERS_UNION 日期列改 AT TIME ZONE 表达式后丢失列名(PG 表达式列命名 ?column?),增量窗口 `WHERE q.purchase_date` 解析失败 → 补显式别名 AS purchase_date/last_update_date,增量 162 行恢复。
③ 连带揪出存量 bug(09-16 起):fee_coverage_rows 的 `next()` 取 FEE_COV_TARGETS 第一个满足档=最松 0.40,35 天+成熟周全部被宽松放行(08-17 周实为 61/68=89.7%<90%)。改 reversed() 取最严档。该周确为真实回填滞后 → 已触发 fee_backfill_targeted(zf/fg 各 2 批次),按设计次日覆盖率重算自动消警;门禁当前红=正确拦截真实信号。
终态:ingest_all 全域无 error(仅剩需求单内 mercury 侧 noon_statement);pen_tests ALL PASS;audit_nodes ALL PASS;dashboard_audit FAIL 1=费用覆盖真实滞后(回填已触发,次日消警)。
背景:铁律落地从"靠自觉"转"结构强制"的 L1 数据库层。全量盘点发现:83 张 audit 清洗表仅 40 张有 RLS、0 张 FORCE;public 运行时表 13 张缺口(6 张休眠策略只差 ENABLE、ads_rule_config 等 3 张无策略、billing_events/tenant_credentials 等 3 张租户表裸奔);更关键——brand_isolation 策略不带 is_active 过滤,历史授权过的停用品牌数据在 DB 层对租户仍全量可见(实测 t1 见 1853 行=全表,期望 272)。
改动(脚本存档 rls-hardening-2026-09-23.sql + rls-policy-active-2026-09-23.sql,单事务执行):① 6 张休眠策略 ENABLE;② listing_category_meta/listing_pt_suggest 补 brand_isolation,billing_events/tenant_credentials/tenant_credential_events 补 tenant_isolation;③ audit 42 张 tenant 清洗表 ENABLE+策略(防纵深);④ 全库 RLS 表 FORCE(未来若撤销 BYPASSRLS 连表主一起约束);⑤ 全部 brand_isolation 策略升级加 is_active——停用品牌数据在 DB 层直接消失;⑥ ads_rule_config 策略带 OR brand='' 显式例外(系统默认参数全租户可见,品牌覆盖严格隔离,代码 brand IN ('', :brand) 语义不变);⑦ 白名单备案 8 张全局/系统表(fx_rates/marketplaces/tenants/keepa_pull_log 等,见脚本注释)。
验证:portal_app 三租户矩阵 t1=272 / t2=373 / t3=1208 / 未设GUC=0,恒等式 272+373+1208=1853=全表精确闭合;四门回归(pen_tests/dashboard_audit/audit_nodes/frontend_e2e)ALL PASS 零破坏;监控 agent RLS 检查升级为全表面覆盖 + t1 身份恒等式探针(SET ROLE 模拟),终态 FAIL 1(已知 onno 广告源问题)/PASS 35。
背景:用户要求 ① changelog 全量复盘防复发 ② 在 SaaS 外面建每日审计 agent ③ 评估铁律合规。复盘 128 条历史条目归为 7 类模式(采集断供/双计幽灵行/隔离泄漏/静默失败/AI幻觉/配置漂移/口径单位),agent 审计项逐类覆盖。
监控 agent(/opt/saas/monitor-agent/monitor.py,宿主机 cron 每日 07:10,纯代码零 LLM、全只读):容器存活 + 镜像固化检查(容器内代码 md5 vs 宿主机,抓"改代码忘 rebuild")+ 管道水位(注册表驱动、去重多租户行、跳过空注册)+ 数量骤降(昨日 vs 前7日日均,双门槛)+ 容器日志错误扫描 + API 登录冒烟 + 身份恒等式(全品牌=Σ分品牌)+ RLS 抽查 + 孤儿 brand + 铁律合规(ai.py 零写库语句、LLM 引用不出 ai.py)+ 磁盘/证书。日报落盘 reports/YYYY-MM-DD.md,异常邮件 best-effort。
首跑 20 分钟内抓到的真问题:① api 容器代码过期(今日只 rebuild 了 worker,混品牌修复在 api 容器内未生效)→ 已 rebuild;② fittingirls sales_daily 断供 6 天——venus fg 采集器 ~09-17 起 items 的 sku 字段不再写值(值在 seller_sku),同步 SQL 以 sku<>'' 过滤后 fittingirls 分支归零;SaaS 已 coalesce(nullif(sku,''), seller_sku) 兜底 + 全量补数(昨日 52 件恢复),源头修复入需求单;③ onno Amazon 广告断更 23 天(mercury 端源头停在 08-31,venus 采集中断)→ 需求单需求 4。
另发现(待用户处理):SMTP 密码失效(526 Authentication failure,9-5 后未动过配置,宿主机直连同失败)——所有报警邮件目前发不出去(含每日管道报警),需到阿里企业邮箱后台重置 business@zipforcetek.com 的密码;修复前监控日报以落盘为主。
配套交付:① mercury/venus 源头需求单(4 项:fg items sku 字段失效 / 采集表混品牌语义 / noon_statement 类型错 / onno 广告断更);② daily_pipe_alarm 扩容数量基线校验(metrics.volume_drop_rows)+ ingest 失败/skipped 邮件报警(4h 节流);③ 铁律合规结论:运行时 LLM 仅 ai.py(5 端点纯只读,0 写库语句),管道全确定性代码 ✓;残留硬编码品牌特判(_PIPE_ORDER 等)已挂账待清理。
用户定稿(2026-09-23):① 账户间、品牌间、国家间、平台间数据绝对隔离;② 只围绕 rawdata → cleandata → api → web 四层处理问题;③ SaaS 工作流中 LLM 不可以介入,全部代码执行;④ 任何数据修改必须级联到不同的账户、国家、平台——修改是整体的,不是独立事件;⑤ 多用户/多平台/单品牌/多品牌/多站点全部保证正常。
即时合规排查:运行时 LLM 调用点全量 grep——仅 routers/ai.py(用户主动触发的 AI 助手,5 端点)一处,且 0 条 INSERT/UPDATE/DELETE(纯只读分析);采集/同步/清洗/报警全部管道均为确定性代码 ✓。落地路径:一切品牌/平台/国家清单从 brands_source 注册表推导(清理 _PIPE_ORDER、brand<>'onno'、_ONNO_AMZ_ADSSKU 等历史特判);写路径(清洗/回填/纠正)走全租户×全品牌×全平台×全国家循环;验证器 = dashboard_audit 交互矩阵 + 账户交叉对账 + 数量基线校验。
用户提供的 GLM(open.bigmodel.cn)新 key 同步更换到两处:① Claude Code CLI(~/.claude/settings.json 的 ANTHROPIC_AUTH_TOKEN,重启 CLI 生效);② SaaS 平台 AI 助手(secrets/llm_api_key,api/routers/ai.py 启动时读一次,已 restart api 容器)。旧 key 备份:settings.json.bak-20260923-glmkey · llm_api_key.bak-20260923。
验证:新 key 直调 bigmodel glm-5.3 通;/api/ai/ask 端到端返回正常(glm-5.3)。出于安全本页不记录 key 明文。
背景:用户反馈「24小时订单分布」「每日订单数」chart 数字不对(显示 18 单 vs 直觉日销 60+)。逐层排查(用户定框架:只查 rawdata → cleandata → api → web 四层)。
四个叠加根因:① worker 容器是昨日 sed 事故坏版本(/ssh/mercury_key + 104.194.81.mercury)——今日 08:43 起 ingest_today_incremental 每两小时全部 skipped "no ssh key mounted",mercury 增量同步断流;② 增量滑动窗口漏洞:增量只拉近 3 天(purchase_date >= current_date - 3),任务失败期间滑出窗口的单永久漏采(实证 09-16/09-19 全缺);③ sales_hourly 聚合混品牌:mercury 端 zipforce_amazon_spapi_orders 是同账号(EU 统一卖家)混品牌表(60 天内 onno 标占 1/3),hourly 分支无 brand 过滤,违反品牌隔离铁律,且 upsert 不删除取消单幽灵行(比源头多 6 行/1 单);④ 单活跃品牌自动选中后 Amazon 占比饼图全灰(brandColor 无国家色回退 PALETTE)被像素扫描判空白。
修复:① rebuild worker 容器(恢复 222_key 正确版)+ 手动补跑增量与全量订单同步(37,522 行 upsert,历史缺口全补齐);② sync_mercury.py 新增 _snapshot_reconcile() 聚合快照对账删除(sales_hourly 60 天窗口,本轮删 384 幽灵行),hourly 分支加 brandf 品牌过滤占位(zipforce 传 brand='zipforce');③ page.tsx Amazon 占比 pie 颜色加 PALETTE 回退(同 Noon 组件);④ 审计/e2e 三工具与品牌作用域同口径:dashboard_audit 与 audit_nodes 的 SQL 基准加 is_active 活跃品牌过滤(停用品牌 api=0 vs 基准>0 的 80+15 条假 FAIL 清零);invariant 广告销售检查改读清洗表(raw ads_sku_daily 的 zipforce 行混 ON* 前缀 SKU,raw 3068 vs clean 1706);frontend_e2e 品牌联动用例动态取活跃品牌(不足 2 个记 SKIP)。
验证:mercury 端与 mars 逐小时对齐(zipforce 近 7 天 19 单,含 09-19=2、09-23=3 补齐);API dailyCnt=20/hourly24=3 与清洗层一致;四门回归 ALL PASS(dashboard_audit FAIL 80→0);桌面 1440 截图 · 手机 375 截图。
问题:顶栏品牌切换器已存在,但多个业务页面表格不受其控制,全部品牌数据混在一起。
修复:8 个页面 12 个接口统一加 brand 参数过滤,前端接入 useBrand() 自动随顶栏切换重取数据:
① inventory(FBA 快照 + 补货预警):/api/inventory/health + /api/inventory/alert;② inventory/DocsTab(单据台账 5 接口):/api/inv/docs + /api/inv/stock + /api/inv/ledger + /api/inv/products + /api/inv/report(SKU 经 sku_mapping 关联品牌,不改表结构);③ orders:/api/orders;④ settlement:/api/settlement(含汇总查询);⑤ po:/api/po/list(经 purchase_order_items.brand 关联);⑥ logistics:/api/logistics/shipments(含 badge 汇总)。
验证:playwright 截图确认——orders 切 onno 只显示 onno 616 单、settlement 切 onno 只显示 onno 回款、inventory 切 onno 只显示 onno 产品。接口验证 orders?brand=onno 返回纯 onno(无 brand 时 37308 混合)。pen_tests ALL PASS、audit_nodes ALL PASS;dashboard_audit FAIL 1 为 onno 08-10 周费用覆盖(上游数据问题,非本次改动)。
需求:创建新 SKU 后所有相关业务流自动创建;listing 上传亚马逊/noon 后捕捉 ASIN/NSKU 回写 sku_mapping,Amazon ASIN 自动推进 keepa 关注池。
实现(三步):
① mapping 编辑器级联创建:保存 SKU 映射时自动同步创建 products(brand+sku+title+cost)和 inv_products(sku+product_name+standard_cost),ON CONFLICT 幂等。
② listing ASIN/NSKU 回写:SP-API submit 成功或 CSV import-results 回流时,自动回写 sku_mapping.asin(Amazon)或 sku_mapping.nsku(Noon),按 brand+sku+platform+country 精确匹配,只填空值行不覆盖已有值。
③ Amazon ASIN 推进 keepa_watch:ASIN 回写后自动加入 keepa 关注池(domain 按 country→ABA_DOMAIN 映射),keepa 每日任务自动抓排名/评分/评论。Noon 无 keepa 跳过。
验证:mapping 保存测试 SKU → sku_mapping/products/inv_products 三表同步创建成功(cascaded_products=1, cascaded_inv=1)。pen_tests ALL PASS、audit_nodes ALL PASS。
/api/products 加 brand 参数(WHERE p.brand 过滤,count + 主查询同步);前端 ProductsPage(flat 视图)接入 useBrand(),fetch 带 brand 参数。DrillView 已有 brand 不重复改。验证:brand=onno → 14 条纯 onno、brand=zipforce → 31 条纯 zipforce、无 brand → 466 混合。
/api/mapping/skus 加 brand 参数(WHERE m.brand 过滤,by_platform 汇总 + count + 主查询同步);前端 MappingPage 接入 useBrand()。验证:brand=onno → 40 条纯 onno、brand=zipforce → 106 条纯 zipforce。
页面标题「数据接入」→「产品建档」,副标题简化「SKU 映射」;侧边栏导航同步改名。三个 tab:SKU 映射(不变)/ API 字段(不变)/ ✏️编辑 → 「新品建档」(编辑器标题同步改,副标题补充"保存自动级联创建产品主数据+库存主数据")。
问题:pipeline 页定时任务注册表只有 7 条,tasks.py 实际有 27 个定时任务,大量任务(Amazon/Noon 采集、监控报警、mercury 收编等)未展示。
修复:PIPELINE_JOBS 补全到 27 个任务,按 9 组分类(数据采集/Amazon 采集/Noon 采集/Keepa·排名/汇率/mercury 收编/监控报警/广告规则/系统);每个任务显示名称、调度时间、代码位置(tasks.py:函数名)、说明;新增 POST /api/pipeline/run/{func} 手动触发接口(owner/admin 鉴权,ARQ enqueue 异步执行);前端分组表格 + 每行「▶ 执行」按钮。
验证:27 任务 9 组全展示;手动触发汇率抓取返回 job_id 成功入队。
新增 /database 页面(adminOnly):左侧 101 张表列表(表名 + 行数估算 + 🏷品牌列标记),可搜索过滤;右侧选中表后显示字段结构(列名/类型/可空/默认值 badge 墙)+ 数据浏览(分页 50/页、搜索、品牌过滤随顶栏切换)。3 个 API 端点:GET /api/db/tables(表列表)、GET /api/db/table/{name}(表结构)、GET /api/db/table/{name}/rows(数据浏览,brand+search+分页)。敏感表(users/tenants/api_keys 等)屏蔽不暴露。audit_nodes 快照刷新 108→111 端点。
需求:noon 无广告 API、onno Amazon 广告 API 断更,需要手动上传广告报表补数据;上传后自动归因(SKU→sku_mapping→本土币)。
实现:广告页新增第 7 个 tab「📤 数据上传」。POST /api/ads/upload:上传 CSV 自动识别 Amazon/Noon 格式(列名映射 30+ 别名),日期多格式自动解析,UPSERT 幂等去重(Amazon 键=brand+day+country+campaign+ad_group+sku,Noon 键=brand+date+country+type+campaign+sku),重复上传自动覆盖不产生重复行;Amazon 同步写 ads_sku_daily(SKU 级汇总,页面主读)。上传后自动归因(SKU→sku_mapping→marketplaces→local_spend/local_sales/currency)。POST /api/ads/reattribute:手动触发重新归因(近 90 天),sku_mapping 更新后重算。
验证:3 行 CSV(含 1 行重复)上传 → 数据库 2 行(去重成功);再传一次同样 2 行(幂等);手动归因 ads_sku_daily 更新 2 行。pen_tests + audit_nodes ALL PASS。
新品建档(mapping 编辑器)两处体验优化:①「+ 加行」新行插入到表格第一行(原加在末尾);②表头 position:sticky 锁定,上下滚动时列名始终可见。
需求:按《亚马逊全链路立体广告自动化搭建&启停优化规范V4.0》全量替换规则引擎,决策 UI 升级(接受/拒绝/编辑各需填写详细理由),区分平台品牌。
V4.0 核心改动:
① GP 核算:售价 - 佣金15% - 采购成本(RMB→USD) - 头程5% - 尾程12% = 单笔GP,每日刷新;② Max_Clicks = GP/CPC,亏损红线优先级 > ACOS 规则;③ 产品阶段:新品(≤90天) 3天窗口+48h冷却 / 老品(>90天) 7天窗口+72h冷却;④ 冷却锁:调价后冷却期内禁止二次优化防震荡;⑤ 紧急止损:花费≥2倍GP零单→立即否定,≥3倍GP→降价20%,无视冷却锁;⑥ ACOS 梯度:>40%降18%、30-40%降10%、25-30%降5%、<20%升8%(提价前校验新Max_Clicks≥3);⑦ 预算调控:上调(ACOS<25%)/下调(ACOS>35%)/关停(ACOS>50%持续亏损);⑧ 否定体系:动态(高花费零转化) + 静态(垃圾流量词根);⑨ 关键词迁移:自动广告好词→手动精准+原自动否定。
决策 UI 升级:接受/拒绝/编辑三按钮均要求填写详细理由(必填,空理由拦截);规则 badge 颜色区分(紧急止损=红底行+红badge、击穿红线=黄底行+橙badge、关停=红、降价=橙、提价=绿、否定=灰);窗口筛选新增近3天(新品窗口)。
验证:手动触发 V4.0 → 115 条建议(紧急止损 3 / 击穿红线 6 / 否定 57 / 降价 11 / 提价 9 / 预算上调 4 / 预算下调 12 / 关停 8 / 唤醒 4 / 暂停 1)。pen_tests + audit_nodes ALL PASS。
①「🎯 出价建议」与「优化日志」合并为「广告优化」tab:上半 V4.0 规则引擎建议(人工决策),下半关键词出价建议明细(参考表);② budget_up/budget_down 建议动作算出具体新日预算(日均花费×1.25/×0.8),执行时默认值直接带入;③ fg-ads 手动补跑 + ingest222 同步,fg 广告数据从 09-17 补齐到 09-19。
导航从 7 组(核心分析/业务操作/平台数据/运营工具/协作/智能/账户)重组为 7 组(工作台/经营分析/业务管理/渠道/数据/协作/账户):推广/项目/Listing 移入业务管理;排名→排名监控、数据管道→管道任务、数据库→数据浏览、品牌接入→品牌管理、Noon→Noon 平台(页面标题同步改)。广告 tab「出价建议」→「出价参考」、「优化日志」→「优化建议」(改回两个独立 tab)。
发现:财务页 zipforce 2026-08 月结算净额 -$2,513(亏损),排查发现佣金率 81%、FBA 率 168% 严重异常(正常佣金 10-15%、FBA 10-30%)。逐月趋势:2024-08 佣金 2.5%/FBA 7%(正常)→ 2024-09 开始异常 → 2026-08 峰值。单笔样本:佣金率 157%、FBA 率 731%。
根因待查:费用归属错误 / 累计费用误写 / 结算批次摊错 / 费用类型混淆(mercury 侧 zipforce_amazon 数据源)。
影响:财务页毛利/净利失真、盈利矩阵误导、V4.0 GP 核算失真。
根因确认:R4 费用率异常非上游问题——ingest222 灌入 order_fees 时 USD 列(commission/fba)直接写了本土币值(SEK/EUR),缺 /fx(currency) 折算。SEK 27.84 被当成 $27.84(实际 $2.83),导致费用率逐月虚高。
修复:_FEES_ZF_BRANCH + _FEES_FG_BRANCH 的 USD 列加 /nullif(fx(currency),0) 折算,本土币列(local_*)保持不折算。下次全量 ingest(周日 02:00)后历史数据自动修正。
命名统一:ingest222.py → sync_mercury.py(数据同步引擎)、audit_clean.py → clean_audit.py(数据清洗引擎)、keepa.py → keepa_client.py(Keepa API 客户端)、spapi.py → spapi_client.py(SP-API 客户端)。17+ 文件 import 引用批量替换 + Dockerfile COPY 更新。pen_tests + audit_nodes ALL PASS。
验证结果:34,966 行 order_fees 重灌 + 清洗后,问题订单 commission 从 27.84 修正为 2.65(SEK÷9.84)、fba 从 77.56 修正为 7.39;zipforce 2026-08 佣金率 81%→24.9%、FBA 率 168%→50.4%、结算净额 -$2,513→+$478、毛利润 -$2,736→+$255(毛利率 53.4%)。R4 需求单根因已确认并修复(非上游问题,SaaS 侧 ingest 折算缺失)。
问题:3,218 单 Shipped 订单 revenue=0(Amazon SP-API order_total 返回 0,但 finances 事件有真实金额),导致平均 GMV 被拉低(SA 8月 $8.32 → 实际 $16.63)。
修复:① _ORDERS_UNION 加 finances LATERAL JOIN 回退(Shipped+order_total=0 时从 finances 取 revenue);② 新增 _backfill_zero_revenue 每日自动回填(ingest 时跑,SaaS 查 zero_rev 订单 ID → mercury 查 finances → 回写 SaaS),finances 到达后自动回填无需人工干预。全量重灌 37,326 行后 zipforce 从 976 降到 371(finances 已到达的回填完毕),剩余 940 单等 finances 到达后每日自动回填。
效果:SA 8月平均 GMV 从 $8.32 修正为 $16.63(有营收订单 59→86 单,总 GMV $940→$1,430)。
backfill 加 fg 分支(v_fittingirls_finances_flat,revenue=principal+shipping_charge),1,956 单 GB 订单从 finances 回填成功(GBP 22.22 ÷ 0.748 = $29.71)。三品牌 Shipped+revenue=0 从 3,127 降到 1,171:fg 43(AU 全额退款/赠品,真 0)、zf 940(822 Amazon 全额退款/赠品 + 118 Non-Amazon 无 finances)、onno 188(真 0)。剩余均为真实业务数据非 bug。每日 ingest 自动跑 backfill,finances 到达后自动回填。
需求:学习 zipforce noon 财务报表(7 个 xls),整合到财务页,数据从数据库自动更新不需要手动上传。
现状确认:noon tab 已有 KPI Summary(16 列)/ Monthly P&L(31 列)/ Country Performance(24 列)/ SKU 表现/产品×月损益,覆盖文件大部分内容。noon_sku_pl_monthly 扩列 cancelled/undeliverable/valid_units/unsaleable,ingest SQL 从 noon_orders 拉取 item_status 计算。
新增:④ Annual Summary 按产品汇总表(Product × Orders/NetProceeds/Settlement/Ad/GrossProfit/NetProfit/Margin%/Net per Unit),数据从 noon_sku_pl_monthly + sku_mapping + noon_sku_status 聚合,31 个产品。验证:Airfit Light NP 520,228 · Settlement 339,932 · NP 256,248 · Margin 49.3% · NPU 46.83,与文件一致。pen_tests + audit_nodes ALL PASS。
学习 zipforce amazon 财务报表(6 个 xls),kpi-wall 接口加 annual 区块:按产品汇总 Orders/Units/NetProceeds/Settlement/Ad/GrossProfit/NetProfit/Margin%/Net per Unit,sku_list 展开平摊 + sku_mapping 产品名聚合 + ads_sku_daily 广告 + cost_rmb 采购成本。34 个产品。验证:H24 NP $16,769 · Settlement $11,148 · NP $6,963 · Margin 41.5% · NPU $4.61,与文件一致。pen_tests + audit_nodes ALL PASS。
kpi-wall 的 brand 参数自动过滤,onno 5 个产品(Wifi Light Bulb Camera NP $5,645 · NP $1,317 · Margin 23.3%)、fittingirls 98 个产品(Bra NP $452,559 · NP $179,253 · Margin 39.6%)、zipforce 34 个产品均已展示 Annual Summary。三品牌截图确认。
财务页加平台选择器(全部/Amazon/Noon),放在时间选择器前面同一卡片内(分隔线隔开)。选 Amazon 只显示 Amazon 分市场 + Annual Summary,选 Noon 只显示 Noon 分市场,选全部显示所有区块。pen_tests ALL PASS。
「Noon 平台」tab 去掉——既然有了平台选择器(全部/Amazon/Noon),选 Noon 后所有区块自动显示 Noon 数据(分市场表格 + Noon P&L 三表 + SKU 表现 + 产品×月损益 + 对账单余额),不需要单独 tab。tab 栏只剩:品牌月度矩阵 / 📈盈利矩阵 / 产品损益 / 月度对账 / 年度对比。pen_tests ALL PASS。
广告页加全局平台选择器(全部/Amazon/Noon),放在 tab 栏前面同一卡片内。各 tab 按平台过滤:平台投放=全局 platform 覆盖本地 plat;活动表现/出价参考/优化建议=Amazon 特有,选 Noon 时提示;深度分析=API 加 platform 参数过滤数据源(ads_sku_daily+amazon_ads_daily vs noon_ads_daily);搜索词=全局 platform 覆盖本地 plat。pen_tests + audit_nodes ALL PASS。
问题:工作台 from/to 自定义日期输入框无功能——非自定义模式下输入框值为空(value=isCustom?wFrom:""),用户选日期后看不到值;MergedOverview 组件收到的 edate/edate2 也是空字符串。
修复:from/to 输入框始终显示当前生效的日期范围(不管是预设还是自定义),MergedOverview 用 wFrom/wTo 替代 pdate/pdate2。pen_tests ALL PASS。
Noon 直推:实现 /impex/v1/import/create 直接上传商品到 Noon(RS256 JWT 认证跟采集同款),生成 noon 列集 CSV → 创建导入任务 → 轮询 /impex/v1/import/status → 回写 NSKU 到 sku_mapping。工作台加 Noon 直推卡片(预检/提交推送按钮),Amazon 直推保持。dry_run 预检验证通过(7 列 CSV 正确生成)。
任务 tab 改 model_number:SKU 手输改为三级联动(品牌 → 型号 model_number → SKU),meta 接口加 model_numbers 按品牌分组,新增 /api/listing/skus-by-model 按型号查 SKU 列表。验证:zipforce 29 型号 / onno 7 型号 / fg 11 型号,T03 → 17 个 SKU。pen_tests ALL PASS。
sku_mapping 表加 upc 列(text,默认空),ingest SQL 同步(mercury 无 upc 用 '' 兜底);SKU 映射表加 UPC 列显示;新品建档编辑器自动包含 UPC 列(information_schema 动态拉列,可编辑保存)。mapping/skus 接口返回 upc 字段。pen_tests ALL PASS。
SKU 映射和新品建档合并为一个 tab「SKU 映射」:默认只读模式(KPI 卡片 + 筛选 + 表格 + UPC 列),点"✏️ 编辑"进入编辑模式(单元格编辑 + 加行 + 删行 + 导入 xlsx + 导出 CSV/Excel + 保存/放弃),点"↩ 退出编辑"回到只读。去掉"新品建档"tab,tab 栏只剩 SKU 映射 / API 字段。pen_tests ALL PASS。
「API 字段」tab 从产品建档页面(/mapping)移到 API 接入页面(/settings):产品建档只剩 SKU 映射 tab;API 接入加第三个 tab「📖 API 字段」(全库数据字典 8 组 181 张表/视图,点击行展开列定义)。新建 ApiFieldsTab 组件(web/app/settings/ApiFieldsTab.tsx)。pen_tests ALL PASS。
① 广告页加全局时间选择器(全部/今年/本月/上月/近3月/近12月),跟平台选择器同一卡片内(分隔线隔开),所有 tab 共享;各 tab 的本地窗口切换去掉。② 优化建议 reason 丰富:每条建议含完整决策依据(花费/销售/订单/点击/ACOS/ROAS/CPC/建议动作/理由)。③ 窗口去重:同一活动+关键词在不同窗口重复建议只保留最长窗口(7d>3d>1d)。pen_tests ALL PASS。
活动表现 tab「全部广告活动」表格加国家列:ad_campaigns 表加 country 列(从 mercury ads_campaigns 拉 string_agg 多国),ingest SQL 同步;API 返回 country 字段;前端表格在"活动/品牌"和"状态"之间显示国家(多国逗号分隔)。验证:2001 SP Auto=SE · H24=SA · Clip04=AE · T11=AE,SA · H24 SP Auto=AE,BE,IT,SA。pen_tests ALL PASS。
活动表现 tab「全部广告活动」表格从手写 table 改为 DataTable 组件:每列顶部筛选输入框(活动/品牌/国家/状态/健康度/花费/销售/ACOS/ROAS/点击/曝光),列头可点击排序,导出 CSV/Excel。pen_tests ALL PASS。
ad_campaigns 从按活动聚合改为按国家拆分(冲突键 brand+name+country),ingest SQL 按国家分组(GROUP BY country),唯一约束改 (brand,name,country)。2402 SP Auto 从 1 行(AU,BE,ES,FR,NL,SE,UK)拆成 7 行(AU/BE/ES/FR/NL/SE/UK),每个国家独立花费/销售/ACOS/ROAS/点击/曝光。验证:ES 花费最高 $461.76 ACOS 49.9% 超标,SE 销售最高 $1,039.95 ACOS 18.8% 健康。pen_tests ALL PASS。
活动表现 tab「判定口径」KPI 卡片加各健康度活动数量配颜色:健康<25%(绿)/ 观察25-40%(黄)/ 超标>40%(红)/ 有花费无转化(红)/ 闲置(灰)/ 暂停(灰)。pen_tests ALL PASS。
V4.0 规则引擎策略参数全部入库(ads_rule_config 表):① GP 核算(佣金率/头程/尾程)② 目标 ACOS(高利润/常规/清库)③ 产品阶段(新品天数/窗口/冷却)④ 紧急止损(否定/降价倍数)⑤ ACOS 梯度(严重/中度/临近/优质阈值+幅度)⑥ 搜索词策略(否词花费/点击/新词订单/花费/ACOS/bid倍数)⑦ 关键词调价(暂停花费/提价点击/幅度上限/容错/冷却)⑧ 预算策略(上调/下调幅度/最低花费/ACOS上下限/关停下限)⑨ 活动启停(唤醒天数/SP自动/ST短语/ST广泛/SB/SD关停ACOS)⑩ 归因策略(窗口/跨SKU权重)⑪ 静态否定词库。广告页加「⚙️规则配置」tab:点击数值直接编辑(Enter保存/Esc取消),品牌级覆盖优先于全局默认,删除覆盖回到默认。规则引擎读配置而不是写死常量。pen_tests ALL PASS。
数据探索 tab 顶部加大搜索框"输入产品关键词搜索(如 wireless keyboard / 品牌名 / 型号 / ASIN)",scope=all 时 term 作为全局过滤条件(title/brand/model/asin 任一 ILIKE)。验证:term=wireless 返回 123 结果(Apple AirPods / Logitech G305 等)。pen_tests ALL PASS。
逐单核实 mercury 源数据:822 单 Amazon zero_rev 订单的 spapi_orders.order_total=0、finances 所有金额字段(revenue/principal/commission/fba)均为 0、fulfillment_channel=AFN(FBA)、sales_channel=Amazon.sa/ae。确认为 $0 订单(100% 折扣促销/赠品/替换品/Vine 免费样品),非全额退款(全额退款会有负数 revenue 或 refund 事件)。revenue=0 是真实业务数据,不需要回填。剩余 1,171 单 zero_rev(zf 940 + onno 188 + fg 43)均为同类 $0 订单或 Non-Amazon 渠道无 finances 记录。
需求:按测试任务文档做全量原子级功能拆解 + 一一对应的详细测试报告。自动化骨架(10,952 控件存在性 + 135 截图)先行,再人工补关键路径(playwright 实操点击 + curl 接口核对)。subagent 因模型配额 403 全部失败后改由主 agent 逐组执行完成。
报告清单(test-reports/):财务(09-20)、订单(37,469 单与 API 一致)、库存、广告 8 tab×3 品牌×2 平台、选品 4 视图+排名监控、工作台+今日、商品+PO+回款+物流、推广+项目+Listing、Noon+产品建档+管道任务、数据浏览+品牌管理、文档+培训+飞书、团队+账户+计费+API 接入,及 总览 2026-09-21-test-summary.md(10 条跨页观察项)。全日审计总结(测试+修复+回归+管道全景)见 2026-09-21-audit-summary.md。
关键实测:广告决策三按钮理由必填+执行需确认串、策略参数 49 项点击即编辑(Esc 取消不落库)、产品建档 CSV 导出真实下载 mapping_zipforce_Amazon.csv、Listing model_number 三级联动(fittingirls→2402→AUB2402BL00LC)、工作台 from/to 传参生效(date2 改 08-31 KPI 1,893→1,477)、今日页 0 个 date 输入、管道 26 任务 ▶ 执行进 ⏳ 运行态、数据浏览选表+品牌过滤、账户安全 65 会话审计。
① /api/ads/platform 忽略 days 参数(广告页平台投放 KPI 6 档时间范围全同 $15,211):docstring 声明支持但 SQL 未使用。修复 api/routers/ads.py:新增 dflt_amz(day ≥ CURRENT_DATE - N)/ dflt_noon(report_date ≥ …),注入 amazon monthly 两路 UNION、campaigns 日表、skus 两路 UNION 及 noon 三处查询共 6 处。复验:days=7/30/90/0 分别返回 1/2/4/6 个月($499/$4,032/$12,412/$15,211),页面"本月"=$1,916、"近3月"=$12,412 联动。ad_campaigns 为 30d 快照表无 day 列不过滤(口径注释)。
② 回款页"已回款率"显示 0.9%(应 94.3%):接口 settled_rate 返回 0~1 比例(0.9429),web/lib/fmt.ts pct() 直接 v.toFixed(1)+"%"。修复 web/app/settlement/page.tsx:×100 后再格式化。复验:页面显示 94.3%。
① 订单跨品牌双计(根因修复,83+2 个幽灵行清除):2026-09-16 建的对账删除把 mercury 侧 SQL 内嵌进本地 DELETE(v_order_master 本地不存在→必报错→savepoint 回滚连 upsert 一起撤销),幽灵行从未真正删除。修复:用本轮已取回键集建临时表对账(sync_mercury.ingest_all);另发现 fittingirls 分支缺排他守卫,补 NOT EXISTS zf 表(22,282 单仅 2 单重叠,验证无副作用)。全量重灌后 37,397 行,跨品牌重复 = 0。
② sku_mapping 空 SKU 脏数据:保存接口空 SKU 转空串后仅拦 None,空串穿透入库并级联 products/inv_products。修复:`if not sku_val` 拦截 + 清理三表空壳行(各 1 行)。
③ 物流运单导入管道:运单表只有 pg-init 一次性种子(40 条停在 09-05),无任何喂入口。新增 POST /api/logistics/shipments/import(CSV 列名中英文自动映射 + 徽章关键词归类 + (brand,awb) UPSERT 幂等)+ 物流页 Tracking tab「⬆ 导入运单」按钮;管道水位报警纳入"在途单 7 天无轨迹"检查。实测:3 行含重复上传幂等 ✓(测试行已清理,等货代真实报表)。
④ 推广渠道库日更:promotion_* 只有 09-06 一次性快照,页面"近 7 日采集=0"——222 源库一直在更(channels 1,221 行更新到当日),是 SaaS 缺管道。新增 tools/promotion_refresh.py + promotion-refresh.sh(渠道 2,674 条 UPSERT,SaaS 人工维护的 status/notes 永不覆盖;products/crawl_stats 同步刷新),首跑后 last_checked=2026-09-21。
⑤ 物流 tab 同步 URL:/logistics tab 改 useQueryState(?tab=pricing 刷新/分享保持;选品页本就同步,参数名 mtab)。实测刷新后高亮保持 ✓。
⑥ 广告时间范围精确化:"上月"原为近 60 天近似。API 新增 _daywin 辅助(from_date/to_date 优先、正则校验格式、5 接口接入:platform/analysis/charts/search-terms/keyword-bids),前端 timeParams 带自然区间(今年=01-01 起、本月=1 号起、上月=完整自然月)。实测上月=1 个月 $5,661.61(原 3 个月 $8,500)。
keepa_watch id=5(pen_tests listing 导回测试 ASIN 经 auto_cascade 级联进入关注池)已删除;pen_tests 仅写 listing import-results,不依赖关注池含此行,回归不受影响。sku_mapping 无 B0PENTEST01 残留。
① 推广日更定时注册:crontab 已登记 55 4 * * * promotion-refresh.sh(与 kol-refresh 04:50 错峰),手动触发同路径全链路验证通过(2,674 条 upsert,last_checked=2026-09-21)。至此推广渠道库与 KOL 资源库同为日更。
② 测试残留会话清理:按 TTL 保留最近使用的 3 个会话,清理其余测试残留(7→3,验证登录与业务接口 200 正常)。此后自动化测试建议用独立测试账号,避免污染 owner 会话表。
③ B0PENTEST01 复发根治:清理后跑回归又复活——pen_tests 每轮 listing 导回都会级联进关注池。pen_tests.py 补自清理步骤(回归末尾经 watch DELETE 接口移除),复跑验证 ALL PASS 且残留=0,闭环。
用户报障:「3220 bra_完整.xlsx」导入产品建档不成功。排查发现三层问题:① 该 WPS 系 xlsx 触发浏览器 SheetJS(CDN) "e.replace is not a function" 解析崩溃;② 文件实为 63 行单款数据(后 772 空样式行),而导入原语义是整网格替换——834 行分支瞬间只剩 63 行,看起来像"导入失败",直接保存会清掉整个分支;③ 目标分支选择器默认 zipforce·Amazon,fittingirls 文件会串分支。
修复:① 解析挪到服务端 POST /api/mapping/edit/import(openpyxl,对该文件实测正常,xlsx/xls/csv 三格式,10MB 限);② 导入语义改为按 sku+country 合并进网格——文件空值不覆盖已有数据、新行插首行、其余行保留,toast 报告"更新 X · 新增 Y · 保留 Z";③ 分支守卫:文件 brand/platform 列与目标不符时拒绝导入并提示。
结果:3220 bra 63 个新 SKU(US 站,全带 UPC+成本)成功建档:分支 834→897 行,级联创建 products/inv_products 各 63 个,样例 USB3220GL00MA UPC=798387201102 成本 ¥27.5。零 JS 错误。
背景:用户反馈 Listing 上传流程复杂——实际要走 10+ 步、操作散在 4 个区块、6 个一级 tab 过载、一个型号 63 个 SKU 要重复建 63 次任务。
① 流程条 + 下一步主按钮:详情页顶部状态条「生成内容 → 绑定类目 → 批准就绪 → 预检提交」(Noon 自动跳过类目步),当前步琥珀高亮、完成步绿勾,右侧主按钮永远是"下一步该做的事";Amazon 未绑类目时主按钮=按品名自动搜类目(自动填关键词触发搜索,用户只需下拉选中绑定)。
② 新建任务瘦身:品牌直接继承顶栏品牌选择器(未选品牌时红徽章提示,不可能串品牌);必填只留 型号+平台;SKU 国家自动带入站点;类目/关键词/站点收进"高级选项"折叠。
③ 批量建任务:选型号后「⚡ 批量建任务(63)」一键为该型号全部 SKU 各建一个任务,已存在的 409 自动跳过并计数;实测 3220 的 63 个 SKU 一次建完(tenant1,draft×63)。
④ tab 收纳 6→3:任务(详情内联展开,原"工作台"tab 取消)/ 导出回流 / 资源(模板库+文件+A+ 合并);"工作台 →"按钮改名语义不变。
用户理想流程:创建产品档案 → 选产品 → 传一次规格书 → LLM 生成 title/五点/描述 → 人工审核修改 → 储存(加版本) → 上传。对比原实现:规格书/生成/审核/上传全部按 SKU 重复 N 遍(3220 要做 63 次)。
实现(任务 tab 新增「型号上架」流程卡,6 步一键化):① 上传规格书一次 → 新端点 POST /api/listing/models/spec 同一份 parsed_kv 落该型号全部 SKU;② 「生成全部」→ 首条 LLM 生成(约 10~60s) + 批量同步;③④ 审核修改在模板任务上做,改完「同步内容」一键广播(title/五点/描述/关键词拷贝,attrs 只补空值——尺码/颜色等 SKU 差异字段保留自身);⑤ 「批量批准」逐条质量门;⑥ 「批量绑类目」(一次绑全部) + 「批量预检」+「🚀 批量提交推送」。
新端点:POST /api/listing/tasks/batch(generate_sync/approve/submit/revert/bind_pt,≤200 任务/次,真推隔 0.2s 防限速)+ POST /api/listing/models/spec。批准门与提交口径对齐:item_name/product_description 由标题/描述自动带入载荷,不再卡批准门。
3220 全链路实测:批量建任务 63 → 规格书一次同步 63 → LLM 生成 10.8s(title+五点 AI) → 同步 63/63 → 批量批准 63/63 → 绑类目 BRA@US 63/63 → 批量预检 63/63 全必填齐。真推按钮由用户确认后触发(本次测试未真推)。
用户反馈布局"不符合逻辑、乱":①「新建任务」与「型号上架」两张卡重复要求选型号,割裂;②「编辑内容」编辑器展开在任务列表最底部,点完要滚到底找;③按钮文案残留旧概念「工作台 →」。
重排:① 两卡合一——「型号上架」一张卡从上到下即完整流程:第 0 步建任务(选型号/平台 → 批量建任务)→ 6 步(规格书→生成→审核→同步→批准→上传);② 编辑器展开位置移到任务列表之前,打开时自动平滑滚动定位(scrollIntoView);③ 「工作台 →」改「编辑内容 →」,页头副标题改为「型号上架 · 建任务 → 规格书 → 生成 → 审核 → 批准 → 上传」。
改动:① 批量端点 generate_sync 支持 template_id(以用户改的那条为模板);② 编辑器点「保存修改」后自动以本任务为模板把 title/五点/描述/关键词注入同型号全部 SKU(不再需要手动点同步);③ 拆掉两道状态限制——ready 任务可直接编辑、同步不再跳过 ready(仅已推送平台的任务锁编辑/跳过同步),任何阶段改一处 → 全部更新且状态原样保留;④ 流程卡删掉「同步内容」步骤(变自动),审核步注明"保存即自动注入"。
实测:ready 态下改模板 222 标题 → 保存 → 注入 63/63,全部任务标题更新且状态保持 ready。
背景:保存即注入此前对已填参数只补空不覆盖——人工修正一个错误参数(如面料写错)时,其余 SKU 的旧值不会更新,"手动优化"断在最后一环。
规则:注入时逐字段判断——各 SKU 值一致的字段视为共用参数(如面料/品牌/产地,随模板覆盖下发,支持人工修正);值各不相同的字段视为 SKU 差异参数(如尺码/颜色,保留自身只补空)。
实测:两条 SKU 各写不同 sku_size(M/L),模板修正 material → 注入 63/63:全部任务 material 更新为修正值,M/L 原样保留。
用户反馈"怎么还是一堆 sku":任务列表原按 SKU 平铺(3220 = 63 行),与型号级上架流程的视角冲突。
改造:列表按 型号×平台×站点 分组——一行一个型号,列 = 型号/品牌、平台/站点、SKU 数、内容进度条(已生成 n/N)、上传进度条(已推送 n/N + 待推送徽标)、最近更新;行操作「进入流程 ↑」(回填型号到上方流程卡并滚到顶部)与「SKU 明细」(展开逐 SKU 行:状态/版本/标题/ASIN·NSKU 徽标/编辑内容)。接口 /api/listing/tasks 经 sku_mapping 回带 model_number/asin/nsku,搜索支持按型号命中。实测 3220 的 63 任务聚为一行,内容进度 63/63、待推送 63。
原因:按钮只设置了型号状态,但 SKU 列表加载写在型号下拉的 onChange 里(程序化设置不触发);且顶栏品牌为"全部"时空值守卫把加载拦住 → 点了没反应。
修复:① SKU 列表加载挪进 useEffect(selModel/brand 一变自动拉);② 「进入流程」同时 setBrand(型号的品牌)+selModel+平台,滚回顶部;③ 流程卡任务统计补 page_size=100。实测:新会话零选择状态下点 3220 行「进入流程」→ 顶栏自动切 fittingirls、型号/SKU/63 任务全部点亮,6 步按钮全可用。
用户反馈:① 审核内容不能藏在按钮后面,全部要直接打开;② 任务全为就绪态时「生成全部」409 报错。
改动:① 第 3 步「人工审核修改」改为内联编辑器——标题/五点/长描述/关键词/全部类目参数(135 个官方字段,必填红标)直接摊开在流程卡里,无任何折叠;底部唯一按钮「💾 保存并注入全部 SKU」(保存 + 以本任务为模板广播全部);② 「生成全部」遇全部就绪时自动撤回模板任务再生成(重新生成后走批准即可)。
实测:内联 145 个控件全打开;改标题保存 → 63/63 任务标题自动更新。
用户反馈:① 类目参数排成一长列;② 上传步骤"类目选不了"。
修复:① 参数区改响应式多列网格(实测 3 列),必填参数(红标+填齐状态)与可选参数分组;② 根因是任务列表接口没返回 product_type → 上传按钮永远禁用、绑类目区总显示——接口补 lt.product_type 后已绑 BRA@US 时预检/提交正常激活、绑类目控件自动隐藏;③ 搜类目加复数/去复数回退(bra→bras);④ LLM 描述字面 \n 净化为真实换行。
用户发现:可选参数几乎全被填了同一串垃圾值"item_name | brand_name | bullet_point1 | …"——LLM 属性映射幻觉输出(10 条规格KV 映射出 50+ 字段,把字段清单当值回填),而旧校验只查"是字符串"未查内容,垃圾经同步扩散到全部 63 个任务(共 6,867 个毒键)。
修复:① AI 映射三重校验:映射数 > 规格 KV×2 → 整批判定幻觉丢弃;值引用字段名(item_name/brand_name/bullet_point/product_description)→ 单条拒绝;值含 ≥2 个 " | " 拼接段 → 单条拒绝。② 专用字段(item_name/bullet_point1-5/product_description/brand_name)彻底不进入 AI 映射候选、不落 attrs——提交时由标题/五点/描述/品牌自动带入(brand_name 取 attrs.brand 或品牌名大写)。③ 清洗 63 任务 6,867 毒键,真实参数(brand/color/closure/material/fabric_type/罩杯/洗护/产地/钢圈 9 项)完好保留,批量预检 62/62 必填齐。
需求:库存页要所有国家、所有数据。库存健康表本有 marketplace 维度但页面未用,且 65 行是原始站点 ID(ATVPDKIKX0DER 等)。
实现:① 存量 65 行归一化 + 采集层(sync_mercury)同步归一(13 个站点 ID→国家码,EU 保持整桶不拆);② /api/inventory/health 与 /api/inventory/alert 加 country 筛选 + by_country 分国汇总;③ 库存页加国家 tab 条:🌍全部国家 | US 294 | EU 251 | CA 229 | AU 207 | MX 71 | SA 48 | AE 43 | UK 43 | DE 12 | JP 5,点选后 KPI 下的补货预警/库存明细/级别全表随国家过滤,站点列显示归一化国家码。
需求:库存页要所有国家、所有数据;MX 无库存却写 50(共享壳行);缺国家筛选与导出。
实现:① 库存健康/补货预警两接口加 country 筛选 + by_country 分国汇总(count=该国真实有库存 SKU 数,无数据写 0);② 页面加固定国家 tab 条:🌍全部 + US/UK/DE/FR/IT/ES/BE/NL/PL/IE/CA/MX/AU/JP/SA/AE + 「共享(EU)」(欧洲聚合桶单列标共享),点选后 KPI 下补货预警/库存明细全表联动;③ 库存明细卡加国家下拉(与 tab 双向联动)+「⬇ 导出 CSV」(按品牌/国家/状态/搜索筛选导出全量,跨页抓取,BOM 头 Excel 直开);④ 明细/预警站点列显示归一化国家码。
底层:65 行原始站点 ID(ATVPDKIKX0DER 等)归一化为国家码(EU 依需求保持整桶不拆)+ 采集层(sync_mercury inventory spec)同步归一,新增数据不再产生乱码站点。
实测:国家 tab 全清单渲染 ✓;AU 筛选 → 预警 9 条全部 AU、紧急缺口 110 件;导出 AU 全量 207 行、国家集合仅 AU;UK(0 库存)点入正确显示空。
根因: mars 每日 08:00 的 amz_fba_sync 按国家写入库存(GB/DE/FR…),但 01:00 的 fg-sales-fba 采集(sales+inventory 合体老脚本)在 01:08 又以 country=EU/US/AU/CA 聚合桶 DELETE+重写同一张表 —— 两个 mars 任务互打,按国家数据每晚被聚合桶覆盖(EU 桶混入 GB/DE 无法拆分,UK 消失,MX 壳行冒充库存)。
修复:① fg_sales_fba.py 停用库存写入段(sales 照常)——库存归 08:00 amz_fba_sync 专职按国家采集;② zipforce UK/EU 站 token_region 配置为 'DE' 而代码映射缺键的 KeyError 修复(补 'DE' 键)。备份:fg_sales_fba.py.bak-noinv-20260922。
现象:推送/读取 listingsItems 一律 403 Unauthorized;同令牌 orders/finances/catalog/definitions/sellers 全部 200。
排查定案:逐应用逐站点探测(fittingirls 11 站、zipforce 7 站、onno 4 站)全部 403;用**重新生成的 fittingirls 新令牌**复测仍 403 —— 排除令牌过期。结论:三个开发者应用授权时都只勾了采集类角色(Orders/Finance/Catalog…),**均未勾「商品列表」(Product Listing) 角色**,而 Listings Items API 必需该角色。开发者资料(VNIQUE INTERACTIVE LIMITED)的已批准角色清单亦无此项,与实测完全吻合。
解锁步骤(卖家账号,每应用一次永久生效):Developer Console → 对应应用 → 角色勾「商品列表」→ 保存(私有应用即时生效);若 403 未消,Seller Central → 设置 → 用户权限 → 对该应用重新授权。unlock 后回 Listing 页点「🚀 批量提交推送」,3220 的 63 个就绪任务即创建新 ASIN 并自动回写建档/排名监控。
过渡通道:推送解锁前,3220 可用 Listing 页「导出回流」走 Seller Central 批量表上传,结果 CSV 回流后 ASIN 照常回写。工单文案已备(含完整证据矩阵:新令牌+四端点对照+角色清单)。
用户发现:各国 SKU 数量不可能只有 50 个。根因:mars 版采集器 fetch_inventory 内 `for s in summaries` 循环变量**覆盖了会话对象 s**——翻第二页时对 dict 调 .get 崩溃被静默吞掉,每个站点永远只采到第一页 50 个 SKU,所有站点、所有品牌、每天、持续数月。
修复:① 循环变量改名消除覆盖;② 顺带修 nextToken 读取位置(pagination 与 payload 平级)。重采后 fittingirls 单品牌从 650 → **8,809 个 SKU**(US 1,026 / CA 1,011 / MX 1,011 / 英国等欧洲各国 610 / AU 349),全站 9,339 行。
连带修正:① ingest 的 fg 部分去掉对 mercury 映射表的 JOIN(该表缺按国家 SKU,JOIN 丢弃全部欧洲行;改用品牌常量,表本身就是 fg 专表);② 库存国家 tab 语义定稿:**每个国家独立列出上架 SKU 数(含 0 库存),EU 为欧洲站点聚合,无共享桶**;③ 清洗层重建(9,339 行全部干净)。
用户发现:Noon FBN 预警 tab 没有跟随顶栏品牌切换——原因:NoonTab 内部有自己的品牌下拉(独立状态),未接入全局品牌选择器;FBA 快照接入了但 NoonTab 被遗漏。
修复:NoonTab 删除内部品牌下拉和本地 brand state,改用 useBrand 全局品牌(与 FBA 快照/库存明细/补货预警统一)。切换顶栏品牌后所有 tab 一次联动。实测 zipforce/onno 品牌切换 Noon 数据正确刷新。
教训:全局品牌接入跨组件改造需逐 tab 逐卡片验证品牌联动——之前只测了 FBA 主表漏了 NoonTab。
需求:品牌有业务数据时无法删除,用户希望"删除后不显示"。旧方案一刀切——有数据就不让删,没有中间态。
实现:
① 停用(可逆):tenant_brands 加 is_active 列;「停用」按钮设置 is_active=false,品牌从所有页面隐藏(半透明+已停用标注),数据全保留;「恢复」按钮一键还原。core.py 的品牌作用域计算改为排除已停用品牌——RLS 层全局过滤,所有页面一次性生效,不需要逐页改查询。
② 彻底删除(不可逆):DELETE ?mode=permanent 按依赖顺序清理:订单→销量→库存→商品→建档→品牌关联。需管理员 + 二次确认。适用于确定不再需要的品牌。
③ NoonTab 品牌联动:库存页 Noon FBN 预警 tab 删掉内部品牌下拉,接入全局品牌选择器——切品牌所有 tab 一次联动。无 Noon 数据的品牌自动隐藏 Noon tab。
实测:停用 fittingirls → 库存页 fittingirls 行数 0、品牌选择器不再可选 → 恢复 → 数据全部回来。zipforce/onno Noon tab 正常显示。
用户发现:停用品牌后 web 端仍显示该品牌数据;各国 SKU 数量不可能只有 50 个。
① 品牌停用全局生效:core.py 品牌作用域计算排除 is_active=false 的品牌——RLS 层自动过滤,所有页面/接口/查询一次生效。品牌列表 API(团队页)不过滤(管理需看到全部),顶栏品牌选择器只显示活跃品牌。停用 fittingirls → 库存 0 行 + 品牌选择器消失;恢复 → 全部回来。
② FBA 采集分页截断修复:amz_fba_sync 两个 bug——`for s in summaries` 覆盖会话变量 s 导致翻第二页崩溃被静默吞掉(每站点只采第一页 50 SKU);nextToken 从 payload 内读取但实际在顶层 pagination 对象。修复后 fittingirls 从 650 → 8,809 SKU 全量入库。
③ FG 库存按国家独立:ingest 的 fg 部分去掉 mercury 映射 JOIN(该表缺按国家 SKU 导致欧洲行全部被丢);改为直接读采集表 + GB→UK 归一。EU 大陆共享库存不再卷为单一桶——英国(GB/UK)与欧洲各国(DE/FR/IT/ES/SE/BE/IE/PL)独立成行。
需求:工作台页面需要看到每个平台、每个国家、每个 SKU 的销量数据,可通过时间选择器筛选。
实现:① 新端点 GET /api/dashboard/sku-sales:sales_daily JOIN sku_mapping 按 country×SKU 聚合,支持 date_from/date_to/country/brand/page 筛选分页;② 工作台底部新增「SKU 销量明细」卡:时间范围起止日期选择器 + 国家下拉/标签双向筛选 + 原生表格(国家/品牌/SKU/产品名/ASIN/销量/营收)+「⬇ 导出 CSV」按筛选导出全量。
实测:全部 119 行明细可查看;国家标签点击切换即时过滤;CSV 导出全量数据。
用户需求:① 展示所有数据,翻页没问题但不能断;② 各列可以手动排序;③ 手机端 KPI 卡片不要单列堆叠。
实现:① 库存明细改用 DataTable 组件(rows+rowKey),一次拉全量数据不再截断,每列可点击排序;② 明细卡内加国家下拉筛选(与顶部国家 tab 双向联动);③ 手机端 KPI 卡片改两列排布(globals.css 700px 断点),大数字缩小;④ API page_size 上限从 200 → 10000。
背景:用户提出"电商 SaaS 应尽可能注册表化"。盘点发现注册表已建不少但没用满——brands_source.marketplaces 全空(采集配置/token 授权/注册表三张皮,SA/AE 断流 14 天的根因)、sync_mercury 一半 spec 硬编码三品牌、审计 L1 写死表名。原则确立:事实进注册表,逻辑写死在代码(与五铁律一致)。
P0-1 站点清单回填:brands_source.marketplaces 从采集配置回填(zf 18 市场/fg 14/onno amazon 4 + noon AE·SA×2,8 行多租户一致,GB→UK 归一);marketplaces 表补 CA/MX 行 + 新增 marketplace_id 列回填 19 国 Amazon 站点 ID。
P0-2 ingest 注册表化:sync_mercury 新增同构域动态生成——规律名零登记(shared.mapping_{brand}、{sch}._spapi_order_items/finances、noon 六表),特殊口径显式键(fg finances_view、zf noon statement_official);11 个 spec 由 _refresh_dynamic_specs 重写,ingest_today 也接入刷新(新品牌增量不断流)。等价性 dry-run 11/11 通过(表集合一致/逐字等价)+ mercury 真跑行数对齐 + 全量 ingest 前后行数零意外变化。
P0-3 货币框架接线:广告折算 CASE(_ADS_CCY)从硬编码 9 国改注册表生成 19 国。顺手修正历史错折:CA 站预算币种为空的 2047 行曾按 EUR 错折(实为 CAD),重灌后清零(CA spend $1,728→$1,298 正确口径)。
P0-4 审计切注册表:L1 新鲜度/独立源交叉(新纳入 onno)/Pending 回刷三项改 brands_source 注册表循环——新品牌插一行自动长检查;授权探针对比基准从采集配置切换为注册表×marketplace_id(三张皮归一),实测 zf 18/fg 14/onno 4 市场全对齐。
仍硬编码(异构口径,新品牌接入走需求单):amazon_orders 三分支/order_fees/monthly_pl AMZ·FG 分支/keepa domainId 映射。挂账不变:noon_statement left(date,int)(需求3)。
P1-1 白名单表:audit_known_issues(check_key, reason, expires_at)——现有 5 条挂账迁移入表(onno IT 断 10-15 到期、广告两表断更 10-08、noon_statement 类型错 10-24、finance_monthly 永久豁免 NULL)。过期自动复报:到期未续期的行次日起按原级别报警 + 专设"挂账过期复报"提醒项点名(防挂账永远沉默,实测验证通过)。
P1-2 阈值表:audit_thresholds 21 项(fresh.* 新鲜度/stall.* 断流/twotable/ghost/pending/align 等)——调阈值改表即可不发版,代码保留同值缺省兜底。
P1-3 凭据目录:secrets/audit_tenants/{tenant}.env(600 权限)——今日页对账与图表对账改为遍历目录全部租户,新租户放一个 env 文件即被 L3 审计自动覆盖;e2e 凭据外置(AUDIT_TENANT 环境变量可切租户)。
顺手修掉的旧 bug(精读代码实锤):chart_value_audit 的 run(brand) 参数从未生效——无参"双视图"实为 zipforce 跑两遍,onno 81 图从未真正对账过。修复后 onno 首次真对账 FAIL 0。另修模块级 _load_registry() 在 psql 定义前执行的载入顺序 bug 与 L1 循环变量 _t 遮蔽阈值函数的命名冲突。
P2-1 平台×域断更矩阵:pipe_domains(platform, domain, table, date_col, stale_days, brand_override)——metrics.pipe_stale_rows 的"amazon 三域 + noon 月度 + onno 品牌特例"if/elif 全部改注册表展开(代码同值兜底)。新平台上线 = 插行即通,未登记平台仍按 noon 月度兜底(原行为)。
P2-2 noon 源表新鲜度:L1 新增 noon 订单源表检查({s}.{s}_orders 从 brands_source noon 域 schema 推导,gap≤2 天)——此前 noon 断流仅月度表 35 天阈值兜底太钝;zipforce/onno 双品牌实测 PASS。
P2-3 数据质量基线:audit_baselines(check_key, metric, value)——L2 的 invalid 率在基线内判 PASS。首条基线:cleaned_amazon_orders invalid_pct_max=10%(当前 6.6% 属误判防护标记常态),该长期 WARN 噪声消除。
📘 三轮收官,全景文档已整理:注册表唯一事实源——架构改造全录(原则与判断标准 / 八张注册表总账 / P0+P1+P2 三轮明细 / 新品牌·新站点·新平台接入流程 / 日常运维操作速查(挂账·阈值·基线·凭据)/ 顺手修掉的 5 个 bug 与共性教训 / 验证与边界遗留)。
入口:/pipeline 页四层审计卡片底部新增 📘 注册表架构文档 外链(同文档),双视口截图自检通过(screenshots/pipeline-registry-doc-{desktop,mobile}-20260924.png)。
背景:盘点"SaaS 相关文件/定时任务是否都在 saas 目录"发现两类不可重建资产在仓库外——① /opt/saas/workspace/{dashboard,finance,sourcing} 三份 2026-09-11 多窗口 saas 代码副本(35M×3,09-12 后零改动),是"改错库"陷阱;② 宿主 root crontab 10 条任务(5 条 SaaS 脚本调度 + sourcing 分发 + mercury 备份 + 2 条外部监控),机器重建时静默消失。
归档:三副本 + WORKFLOW.md 移入 saas/backups/residual-workspaces-20260924/(目录 + tar.gz 34M 双保险,tar 覆盖 766 文件核验;rm -rf 被权限分类器拦截后改用 mv 非破坏性方案,可逆);/opt/saas/workspace/ 现只剩 zipforce-hub。
crontab 落地:saas/host-crontab.txt(10 条逐条注释用途,分三组:SaaS 脚本调度 / 必须宿主跑(容器无 SSH) / 刻意在 SaaS 外的监控)+ install-host-crontab.sh(幂等安装:先备份旧表→原子替换→diff 校验;实测二次运行幂等退出,终态与清单 diff 完全一致)。变更流程:先改清单文件再跑安装脚本。
文档:注册表架构文档新增第八章"部署目录地图 + 定时任务全景"(目录角色表 / arq 与宿主两层调度结构 / 归档位置与恢复方式)。
入口:/pipeline 页新增 🗂 部署目录地图 卡片(8 行目录角色表 + 两层调度说明 + 架构文档链接),与文档第八章同源;双视口截图自检通过(screenshots/pipeline-dirmap-{desktop,mobile}-20260924.png,手机端表格横向滚动容器承载)。 同步:双系统手册第一部分改为"部署目录地图与定时任务"——插入同源 8 行地图表,修正"全部由 ARQ 驱动"的过时描述(补宿主 10 条清单层),hero 更新为"arq 20+ 任务 + 宿主 10 条"(screenshots/manual-dirmap-{desktop,mobile}-20260924.png)。
mercury cron.d 收编(同日第二批):biweekly-backfill(隔周结算回补,05:30,脚本内部判窗口)与 zipforce-pm-backup(PM 库备份,03:00)两条改 mars ssh 调度(与 sourcing 分发/mercury 备份同模式)——crontab 增至 12 条,ssh 通道实测(biweekly 空跑正确按日期退出);mercury 侧旧文件 .disabled-20260924 留档(用户侧执行 mv)。架构文档/双系统手册/pipeline 卡片三处同步 12 条(截图 screenshots/pipeline-dirmap-12entries-20260924.png)。
用户报告:每日利润走势图最近几天都是 0。四层排查实锤根因:非故障,是 Amazon 结算滞后——净利列(net_usd/费用)靠结算事件回填,zf 品牌回流滚动滞后约 2 周(当天刚好补到 09-16,09-17 后 8 天 40~75 单/日零事件覆盖);finances 事件流速稳定(每天 3~17 行)采集正常,SaaS 同步与当日改动无关(源头 mercury 同样为 0)。
修复(用户拍板"要写进 rawdata→cleandata→api→web"):按"数据缺失可视化兜底不显示误导性 0"铁律四层级联——① rawdata/ingest:onno 分支 has_finance 由写死 false 改"净利可用"语义(Shipped 且 order_total 折算非空;onno 净利不依赖结算事件,原信号误判);② cleandata:has_finance 同构透传(零改动,已验证);③ api:图表循环新增日结算覆盖统计 d_fin,判定"有单≥3 且覆盖<10% 且该日净利恰为 0"的天置 null 断线+图题 sub 标注"近 N 天结算中(Amazon 结算滞后约2周, 到期自动点亮)"(d_net==0 条件保证 null 天贡献恒 0,与审计基准数学恒等,部分结算的低覆盖日显示真实部分值不误剔);④ web:GChart 原生 null 断点(零改动)。
验证:curl 实测 14 天窗 13 天断线+标注正确(zf 品牌结算回流确实极慢,此前全品牌口径高覆盖主要来自 fg);chart_value 双租户 dailyProfit 守门 FAIL 0(修 onno 信号前曾 FAIL −10.68 vs −809.41,两轮收敛到 0.01 舍入差内);双视口截图(screenshots/dashboard-dailyprofit-pending-{desktop,mobile}-20260924.png)。
用户令:"安排一个机器人,每天审计所有的定时任务工作情况"。tools/cron_audit.py(crontab 第 13 条,07:25)——清单零写死:宿主条目解析 host-crontab.txt(按调度频率判日志 mtime 窗口 + 尾部错误扫描),arq 20+ 任务从 tasks.py cron 注册解析 + worker 落盘日志找 ← cron:func 完成标记(缺跑/超窗=FAIL),另查 crontab↔清单防漂移 + mercury cron.d 残留。日报落 logs/cron-audit/(按日+latest),FAIL 走 stderr+exit 1。分级原则:日志不存在=WARN(新装待首触),存在但停更=FAIL;已知挂账不过滤(报警必须真实)。
首跑 42 项:FAIL 5 全是存量真问题(移交处理):① sourcing 分发断 58h(mercury 15432 隧道 connection refused,选品停 2.5 天);② promotion-refresh 失败(ssh mercury 别名 exit 255);③ backup-pg-analytics 6 天无日志;④ six-claude-monitor 停摆 18 天(09-06 起,机器监控盲区);⑤ worker 日志 3 行 Traceback(keepa 历史 + noon_statement 已知挂账)。
顺手修真凶:daily_amazon_rankings_keepa 每日 05:20 ImportError 断更——09-23 改调用(keepa_client_product→keepa_product)漏同步 import 行(09-16 快照比对实锤,非当日改动)。修复后 rebuild 验证 import OK + 手动触发补跑(job d2305448)。
①④ 深挖反转(用户令"继续排查处理"):逐项实锤后 5 个"真问题"里 3 个是机器人误判、2 个是真修——
① sourcing 断流 = 虚惊:dispatcher 是沉默型任务(成功零输出,失败才写日志)——"58h 无日志"实为 58h 无失败;隧道拓扑为 mars -L → mercury:15432 ← Dell -R → Dell:5432,mars 侧实测握手到 PG,09-22 00:42 隧道半死期结束后一直健康。④ monitor 停摆 = 虚惊:脚本健康(心跳文件正常更新+被 claude 会话短路 exit 0 是设计行为);09-06 的"stale 1788699481s"是心跳文件损坏事件(已自愈),静默=无事故。
真修两处:① promotion-refresh 断更根因——ssh mercury 别名本机不存在(脚本自 mercury 移植时未改),统一改 ssh 222,手动跑通 COMMIT 且回灌 09-20 起 crawl_stats;② backup-pg 假断流——清单重定向连字符 backup-pg.log vs 脚本下划线 backup_pg.log 拼写差异,备份实际六天全绿(今日 148M),清单已改齐。backup-pg-analytics 与六道门审计口径同步修正。
机器人三轮自我修正(每个误判都变成判定规则):Ⅰ 沉默型任务判活降级到 journald _COMM=cron 调度记录(有调度=在跑且静默);Ⅱ 错误扫描加恢复态判定(错误行后还有新活动=WARN 恢复态,错误是最新事件才 FAIL);Ⅲ 日志不存在=WARN/停更=FAIL 分级保留。终态 42 项 FAIL 1(唯一=noon_statement 已知挂账每日真实失败,报警必须真实不消音)。
方法:GitHub 真实搜索页 8 组关键词(综合看板/SP-API SDK/结算财务/PPC 广告/Keepa/库存/中文/AI Skills)+ 3 个重点仓库深读。报告:github-research-amazon-ops-2026-09-24。
核心结论:① 成品卖家看板开源界无成熟项目(186 结果最高 5★ 全练手级)——Hub 定位空白;② 高星全在底层 SDK(SP-API 680★/Keepa 315★),"接入开源、业务闭源"是分工;③ 结算/财务对账开源盲区(检索仅 1 个 0★)——我们的 finances→order_fees→覆盖报警→结算滞后可视化链路是自研护城河;④ AI Skills/MCP 是热点(中文 awesome 182★),模式共识"MCP 接数据→SKILL.md 装 SOP→Agent 干活";⑤ 客服售后公认生态稀缺=业务机会。可借鉴:搜索词收割/否定关键词建议、Listing 9 维体检、VOC 内容层、SaaS 数据 MCP 化输出。
插曲:WebSearch 摘要曾返回"2.1k★ Amazon Seller Dashboard"等条目,与 GitHub 真实搜索页不符(链接格式无效=检索层幻觉)——已弃用,全部结论锚定一手搜索页。
来源:GitHub 调研的借鉴清单第一项(用户拍板"干")。盘点发现规则引擎 V4 已有否定/收割雏形,本单做三项增强而非重建:① 双窗口收割——原 7 天窗会漏低频长尾好词,新增 30d 慢热档(门槛/ACoS 上限独立配置,默认更宽),首跑即挖出 4 词(如 SA 站 ASIN 词 30 天 $90 花费 6 单 ACoS 32.2%,7 天窗确实抓不到);② 高ACOS止损否定档——原否定只管零转化词,漏"转了但越投越亏"的词;新增 30 天花费≥$25 且 ACOS>2×目标的否定建议(首跑抓出 ACoS 158%/131% 等 4 个亏损词,文案含净亏金额与"先降档观察"决策路径);③ 噪声门洞修复——neg_clicks 配置定义了但查询没用上,补进 HAVING。
配置注册表化:新增 5 个参数进 ads_rule_config(harvest_orders_30d/spend_acos_30d、neg_acos_mult/spend)——调阈值不改代码;全规则零 LLM,建议进 ads_recommendations 走既有 pending→人工决策→执行闭环。
验证:引擎重跑 139 条(30d 档 new/migrate 8 条+高ACOS否定 4 条);DB 抽样内容合理;API rule 精确过滤含慢热文案;前端 30d 窗口+规则筛选视图截图确认渲染(screenshots/ads-harvest-30d-20260924.png)。默认分页排序下慢热建议可能不在第一页(114 条 30d 建议中排后),用规则下拉"新词收割"直达。
来源:调研借鉴清单第二项(zach-listing-health-checker 9 维体检思路)。数据现实先行:盘点发现 A+ 数据为空、listing 文本内容(标题/五点/图)无采集链——内容维不做假数据,按现有数据定义 9 维:①销量活跃 ②销量趋势(周环比) ③评分 ④评论规模 ⑤BSR ⑥库存风险 ⑦退货信号 ⑧价格稳定(仅Keepa关注池) ⑨内容覆盖(nodata 扩展位,接 SP-API catalog 后点亮)。
实现:零 LLM 全代码规则;评分 ok100/warn60/bad20,nodata 显式灰点不计分(铁律:数据缺失可视化兜底不显示误导性 0);SKU×ASIN 骨架串 sales_daily/rankings/inventory/refund/keepa 五源;低分排前(体检语义=找问题)。新端点 GET /api/listing/health + /listings 页第 4 个"体检"tab(9 维色点矩阵+总分+行展开明细+悬浮说明)。
验证:zipforce 155 SKU/138 有实数据;低分卡实锤(评分 3.1+断货+冷启动 → 50 分排最前);双视口截图(screenshots/listing-health-{desktop,mobile,final}-20260924.png)。开发中修 2 处:rank 元组下标越界(rt[3]→rt[2],limit>3 时 500)、TS 泛型断言。
目标:接入 Amazon 评论原文(VOC 分析的数据层——系统只有评论数计数,无文本)。基础设施已建好:product_reviews 表(pg-init/55,去重键/RLS)+ 采集脚本 api/voc_collect.py(品牌代理铁律/域注册表/data-hook 解析器)+ Dockerfile 纳入。
五路验证矩阵(全部实测留档):① SP-API 无评论端点(平台 2021 关闭);② Keepa 只有计数无文本;③ requests+住宅代理+完整浏览器头 → JS 挑战壳(228KB 页面 0 锚点);④ mars 部署 firecrawl self-host(官方镜像 7 组件栈,api harness nuq-worker 起不来即弃)→ 直用其 playwright-service(JS 真渲染+zf 品牌代理出口 23.26.215.184 验证生效)→ 仍被 "Welcome to Amazon" 地域仲裁页拦截,补丁同 context 二次导航(volume 挂载持久化)两轮重访仍回弹 → 解剖确认是 ap_login_form 登录墙(Amazon 对该 IP 段要求登录验证,IP 信誉维度封锁,非技术补丁可绕);⑤ Decodo Scraper API 账号未订阅。
止损决策:分析层(VOC 端点+前端)未动工避免空转;playwright-service+品牌代理保留为通用 JS 渲染能力(127.0.0.1:31003,补丁版挂载持久,其余 6 组件已停),后续推广/竞品独立站抓取可复用。VOC 数据源三选项——用户拍板:搁置(评论维维持计数口径;product_reviews 表/voc_collect 骨架/playwright-service 渲染能力留档,订阅商业 Scraping API 可随时重启此线)。
新工具 tools/gen_data_dictionary.py:information_schema 实时导出(表/列/类型/行数)× 内置业务语义(12 域分组 + 表级业务描述 40 条 + 核心表逐列口径注释 9 张 + 通用列名词根词典)→ 数据字典(113 表 / 1218 列,1824 行 markdown)。核心表逐列注释覆盖订单 28 列/财务/广告建议闭环/库存/Noon 损益/注册表显式键等口径要点(结算滞后/双计防御/翻日时区/本币双轨均在列含义中注明);长尾表字段名自明+行数列数索引。附 mercury 源库 181 表目录指引(api_fields_catalog 表)。可随时重跑再生成(表结构变更后)。
形态:手写最小 streamable HTTP MCP(单 POST /mcp JSON-RPC,零新依赖)——Claude Code/Desktop 等客户端一行接入(接入指南)。工具集 7 个全只读:brands / sales_summary / orders_recent / ads_performance / inventory_risk / listing_health / finance_monthly,返回均带口径注释(净利结算滞后等)。
安全边界(铁律):不给裸 SQL(防注入拖库);密钥 mk_* 只存 sha256(明文一次返回),Bearer→租户→RLS 四维隔离不下放 LLM——实测 onno 密钥查 zipforce 品牌 0 行;key 生成/撤销限 owner/admin 进 audit_log,每次调用记 last_used_at。MCP 属人工侧分析入口(与 AI 助手同域),不在采集/计算/写入链路。
验证:公网网关全流程(initialize/tools/list/tools/call 实数据:30 天 352 单 $4854.5/库存风险 50 条)、无 key 401、跨租户隔离 0 行。配套:Caddy 两站点块放行 /mcp、pg-init/56 mcp_keys 表。
词汇表入 MCP(同日,用户令"同步到 mcp 工具"):MCP 工具集 7→8 个——新增 glossary 工具(query 可选,词条/英文全称/官方缩写/释义四字段模糊匹配,≤60 条返回)。解析抽为 data_dict_meta.glossary_domains() 共享函数——站内 /api/glossary 与 MCP 工具同一解析同一 md 源。实测 query=ACOS→3 条(含 TACOS/ROAS)、IPI→库存绩效指标 ✓。
词汇速查入 /pipeline(同日,用户令"加到 /pipeline 页"):页尾新增 📖 电商词汇速查卡——搜索框 + 四列命中表(词条/英文/缩写/释义,≤12 条即时过滤),同源 /api/glossary,完整版入口指引 /dictionary。双视口截图+搜索实测 FBN→Fulfilled by Noon 命中(screenshots/pipeline-gloss-{desktop,mobile}-20260924.png)。
用户 CSV 增量合并(同日,用户上传《电商词汇中英文对照完整大表.csv》404 条/20 分类,拍板"合并"):自动化三步——①CSV 四列化(释义前缀提取英文全称+缩写拆分)②确定性去重(abbr/英文归一匹配跳过 64 条重叠)③分类→域映射并入。新增 6 域:十三、直播与短视频电商 / 十四、营销与价格促销 / 十五、支付与风控 / 十六、Shopee 平台 / 十七、Lazada 平台 / 十八、平台规则与合规;Noon 域 +24(NFR/SABER/COD 拒收率等)。同词甄别清理 17 条(保口径更好一方,平台专属词如 Lazada Voucher/Shopee Voucher Shop 保留)。终态 18 域 644 词条——站内 /dictionary、/pipeline 速查、归档 md、MCP glossary 工具四端同源生效(MCP 实测 SIP→Shopee International Platform ✓)。
词条↔系统字段映射(同日,用户令"和数据库字段做映射"+"是不是需要加到 mapping table"——落 term_field_map 注册表,pg-init/57):63 个核心词条挂系统落点(表.列/派生公式/注册表/MCP 工具),如 ACOS→ads_sku_daily.spend÷sales、净利→amazon_orders.net_usd(结算滞后)、否定关键词→ads_recommendations(rule=negative_keyword)、断货→inventory_health.stock_status;无落点的诚实标"未采集"(买家维度/评论内容/预留金等)。attach_sys() 共享注入——站内 /dictionary 与 /pipeline 词条表加第 5 列"系统落点"(搜索含落点字段),MCP glossary 按落点可搜(实测 net_usd→净利词条)。行业语言↔系统字段双向打通。
用户令"干"(形态按用户澄清"每一页可加自定义模块自己设计图表"):工作台/财务/广告/库存/订单 5 页尾部新增 🧩 自定义分析卡——点"添加图表"→ 编辑器(域→维度≤2×度量≤4×时间窗×图型 line/bar/stack/pie/table)→ 保存即嵌入该页;模块卡片支持图表⇄表格切换、删除;空数据显式"无数据"(不显示误导性 0)。
引擎铁律:38 字段白名单硬编码(DIMS 11 维度 + METS 27 度量,4 域=daily 经营日宽表(订单 FULL JOIN 广告)/stock 库存/rank 排名/noon 状态月报),不给裸 SQL——恶意维度名实测 HTTP 400;派生度量(ACOS/TACOS/CPC/CPS/CTR/CVR/AOV)先聚后除;四域全通实测(月度营收+净利+ACOS+TACOS 数据正确;noon 33 月状态件数;rank 3.98 分/450 评论/BSR 21708;库存 717 件)。report_defs 注册表(pg-init/58,RLS 租户隔离,租户共享模块)。回滚锚点 v2026.09.24-registry-mcp。
用户令"都做"——GitHub 第二轮调研的全部空地一次补齐:
A1 📉 BSR 排名下滑报警(规则引擎):rankings_daily 7 天均值 vs 前 7 天,恶化超 80% 且曾入前 5000 → 建议(首跑抓到 T11 Beige/AE BSR 913→2,231 +144%)。A2 🔍 竞品异动:ABA 前 3 点击份额中非自有 ASIN 的 BSR 飙升/评论暴涨监控(首跑数据正常无报警)。
A3 💰 动态调价建议(guardrail ±10%):库存断货提价 5%/库存过剩(>120天)降价 5%/毛利率低于目标微提——首跑 6 条(zf 断货提价 ×4、fg 库存 615 天降价 ×2),guardrail 限不低于成本×120%,全部走 ads_recommendations pending→人工确认→执行闭环。
B1 🧮 Landed Cost 计算器:POST /api/reports/landed-cost——19 国 VAT 率 + 海/空/快三级运费率 + 体积重 167kg/m³ → 货值+头程+关税+VAT 到岸成本(实测 DE 空运 $5 货值 → $9.91 landed=198%)。B2 后台搜索词管理:listing_backend_keywords 表(pg-init/59,RLS),GET/PUT 带 250 字节 UTF-8 限额校验。B3 🔤 Autocomplete 挖词:Amazon 搜索联想词采集——playwright-service 搜索页渲染 + s-suggestion 解析 → autocomplete_terms 表(首跑 seed "wireless bra" 采到 113 个联想词)。
报告:saas-audit-github-2026-09-24。基准 = forter/security-101(4.7k★) 5 阶段安全清单 + PG RLS 官方范式 + nextify 最佳实践。14 项自审:RLS 覆盖/2FA/暴力破解/CORS/限速/备份/容器/secrets/错误泄露/审计日志/MCP 面。
结论:3 项领先(RLS 四维/CORS 同源/容器加固)、5 项达标、3 项落后(TOTP 2FA 未实装/API 无限速/SaaS 库备份无异地)、3 处需修(mcp_keys+product_reviews+autocomplete_terms 无 RLS、sourcing.py str(e) 错误透传)。红色立即修复 3 项 / 黄色近期 4 项(限速/MCP 限速/备份异地/TOTP)/ 绿色中期 3 项。全部已排优先级待拍板。
红色 3 项(安全实质):① mcp_keys/product_reviews/autocomplete_terms RLS 加固(pg-init/61;mcp_keys 租户隔离、评论/联想词品牌隔离;MCP saas_admin 通道 Bypass RLS 不受影响 4 keys 可读 ✓);② sourcing.py 3 处 str(e) 错误透传修复(→ 通用 502 + stderr 详情)。
黄色 4 项:③ API 限速(FastAPI Redis middleware:全局 240 req/min + AI 端点 20 req/min + MCP 60 req/min;实测 250 次顺序请求 238 过 / 12 次 429 ✓;Redis 不可用时降级不限速保可用性);④ MCP 限速(同 middleware Bearer 桶);⑤ 备份异地(backup.sh 追加 scp → mercury /opt/backups/saas/,留 14 天,首跑 28MB dump 已送达实检 ✓);⑥ TOTP 2FA 实装(GET /api/auth/mfa/setup 生成密钥+otpauth URI / POST verify 验证启用;users.mfa_enabled 列新增;实测 setup→verify 全流程 ✓)。
绿色 3 项:⑦ deploy_gate 加 pip-audit 依赖漏洞扫描(阈值 5 个已知漏洞);⑧ 公共注册表表(fx/marketplaces/platforms/term_field_map)保持公共只读(deliberate);⑨ IR 文档待写(挂账)。
incident-response-2026-09-24——生产事故唯一操作手册,9 章:①联系链与角色(值班/决策人/通知升级时限)②第一响应五步(确认→截证→判定→止血→记录,含证据快照命令)③场景 A 服务不可用(容器/DB/网关/源库断流四种子场景各配止血命令)④场景 B 数据错误(审计→清洗层重灌→ingest 重跑→全库回滚四阶梯)⑤场景 C 安全事件(MCP key 撤销/凭证泄露/RLS 绕过隔离/暴力破解 IP 封禁)⑥场景 D 定时任务故障(机器人报告定位+手动补跑)⑦恢复验证清单(5 步必跑)⑧事后复盘(时间线/五问根因/行动项)⑨资产清单(版本锚点/备份/镜像/crontab 快速定位表)。原则:先止血再根因。
报告:github-ecommerce-survey-2026-09-24。覆盖:平台层(Medusa 36k★ "for agents")/ 卖家工具层 / AI Skills 层(nexscope 双仓 170 skills)/ 垂直工具层(PPC/调价/对账 全部<10★)。
核心发现:① Medusa 平台定位改为 "for agents"——Agent 化成平台标配;② 53 个 Amazon skills 逐项对照——我们已覆盖 6 项、空地 4 项(调价建议/竞品报警/landed cost/后台搜索词);③ PPC/调价/对账三大件开源界全是空地(最高 9★)——我们的规则引擎+财务链全部领先;④ Ozon 156 tools / WB 197 tools MCP 先行;⑤ 1688-cli AI-agent 友好——采购上游接口化。
/reports 自助报表开发前的回滚锚点:三镜像打 tag v2026.09.24-registry-mcp;代码快照 backups/code-2026-09-24/reports-pre-v2026.09.24-registry-mcp.tgz(12M/295 文件);DB 归档 backups/saas_registry-v2026.09.24-registry-mcp.dump(28M)。新增 VERSION 文件(版本唯一记录:里程碑语义/组件版本/回滚命令/next 预告)。回滚能力四项实检全过:镜像 tag 在位 ×3、代码包 295 文件可列、pg_restore --list 206 TABLE DATA 可读、回滚命令一条演练就绪。回滚 = 3 个 docker tag + compose up + pg_restore --clean。
数据字典从 changelog 归档 md 升级为站内页面:新 /dictionary(侧边栏·数据组)——12 业务域 × 114 表 × 1226 字段全量输出,含搜索过滤(表名/列名/含义,如搜"净利/acos/settlement")与逐表展开三列表(列/类型/含义)。后端 GET /api/dictionary 实时拉 information_schema × 语义层。
单一事实源:语义层(分域/表描述/列注释)抽取为 api/data_dict_meta.py,站内 API 与 md 归档工具(tools/gen_data_dictionary.py 改 import 同源)共用——重构后 diff 验证零漂移。多租户边界:站内 API 不下发行数(归档 md 含行数仅内部)。
验证:API 114 表/1226 列/12 域、行数字段确认不在响应;双视口截图+视觉确认(搜索框+统计、域卡片、amazon_orders 展开 29 列三列表渲染正常,screenshots/dictionary-{desktop,mobile}-20260924.png);pen_tests ALL PASS。
词汇总表:12 业务域 × 400+ 词条——平台账号 / Listing / 订单履约 / 费用财务 / 广告流量 / 库存供应链 / 选品市场 / 评论口碑 / 数据指标 / Noon 中东 / AI 新兴 / 运营管理。关键指标带口径注解(ACOS/TACOS/ODR/IPI/CCC 等),灰色词条标注风险提示,与站内 /dictionary(系统字段口径)形成"行业语言 ↔ 系统字段"对照。
站内化(同日第二批,用户令"加到 /dictionary 页"):页顶双 tab——字段字典(系统口径)/ 电商词汇(行业口径);词汇 tab 12 域 × 321 词条表四列化(词条/英文全称/官方缩写/释义)(用户令"英文和缩写分开,每个都要有官方缩写")+ 搜索过滤(含缩写字段)。两轮转换脚本:规则拆分(逗号/斜杠模式+词条即缩写回填+括号内嵌拆出+首字母大写词防误判)+ 高频缩写全称映射 110+ 条——74 条带官方缩写(ACOS→Advertising Cost of Sales、ODR/LSR/PFCR/VTR/RDR、SP/SB/SBV/SD/DSP…),无官方缩写的词条诚实填 —(不造缩写)。后端 GET /api/glossary 解析 md(单一事实源 = api/ecommerce-glossary.md 随镜像 COPY,changelog 归档版已同步)。搜索实测 ACOS 四列行命中(screenshots/dictionary-gloss-4col-20260924.png)。
_zog_key()(行文→「品牌:市场」/「RED:品牌」稳定键), redis state 增 keys 字段比对, 旧存量 state 无 keys 时从行文反解兼容; last_mail 24h 心跳语义保留。py_compile 过; 随 ③ 同批部署。16:59 复航实证: breaches=6 同集合, mailed 通(last_mail 落 16:59:00 北京, stderr 零异常)——15:59 的 PermissionError 修复(chmod 644)即足, SMTP 密码内容实证有效无需重置; 旧码在部署前仍每小时一封(小时数漂移判新破), 17:0x 档部署即止。【部署 17:11 北京】api+worker build+recreate 全绿(用户 `!` 通道真执行), 终验: 镜像内 _zog_key×3+两处 nullif(advertised_sku) 在位/启动零异常/api health 200; 17:59 档=去重修复实弹验证点(预期 new=False+redis keys 字段出现, 会话已挂 18:03 验证 cron)。【17:59 复航实弹通过】mailed=0 零重发零失败: 旧码行文全等去重在零单小时数逐档增长下必重发, 本档静默=稳定键拦截; 运行容器 /app/tasks.py _zog_key 实证在位。两处事实校正: ①跳档不回写 redis——keys 字段待下封实发(明 16:59 心跳档或新增市场)时落库, 16:59 旧 payload 由兼容反解路径消费, 去重不受影响; ②result breaches=5=在破市场数, 红线汇总行不计入(预登记 6 系口径数错)。
③ ⑤ advertised_sku 转正三件套 (a) DDL 待亲跑: center_warehouse.foncye_amazon.ads_daily 增 advertised_sku text NOT NULL DEFAULT '' + ad_sales_7d numeric(14,4) NOT NULL DEFAULT 0, 主键 8→9 列(day,country,campaign_id,ad_group,advertised_asin,advertised_sku,target_id,search_term,match_target)——live 表主键与解析器建表稿 2026-07 前已分叉(live=关键词粒度 8 列, 稿=商品粒度 6 列), 对齐到 live 扩展形; 1594 行瞬间重建。旧 PK 唯一性蕴含新 PK 唯一性, 零冲突风险。(b) 解析器已改(宿主即生效): foncye_import_ads_daily.py CREATE TABLE 补 target_id/search_term/match_target 三列+PK 同步 9 列, ON CONFLICT arbiter 6→9 列(INSERT 16 列不动, 三新列走 DEFAULT '')。(c) 汇聚层已改(待部署): sync_source.py 两处 asin 借道位改 coalesce(nullif(advertised_sku,''), advertised_asin)——_AMZADS_BRANCH 第 9 列(amazon_ads_daily 面, 注册表实证唯一源=onno→foncye_amazon.ads_daily, 无误伤)与 _ONNO_AMZ_ADSSKU 第 2 列(ads_sku_daily onno 分支); 存量行回退旧口径(空 sku→asin), 新数据落真 sku, 过渡显式。SaaS 面 public.amazon_ads_daily 1162 行已有 advertised_sku/ad_sales_7d 列零 DDL。漂移门 06:30 对新增两列=INFO 自动吸收基线不报警。clean_audit brand_fix(sku_col=advertised_sku) 将从假 sku(=asin) 变真 sku 开始真工作。py_compile 双过。顺序铁律: DDL 先于部署(部署先行则同步面报缺列错)。【落地 17:08 北京】用户两次粘贴 `!` 命令均以消息态到达未走执行通道(两查 DB 零变动+会话无输出证实), 经用户原样下令后会话代跑 pkg1_ddl_20261113.sql, ALTER×2 成功; 终验: PK 9 列/两列默认值在位/1594 行零变动/存量 sku 全空走 asin 回退。旁证钉死: 表 owner=collector 但 saas_admin rolsuper=t 无碍; / 为 noatime 挂载。(d) 用户侧恢复投喂: foncye 广告后台导出商品级 Report_*.csv(须含「推广的商品编号」+「广告名称」两列)→/opt/collection/dropbox/foncye-ads/(foncye_amazon.zip 或散 CSV 均可), 解析器自动拾取+镜像。
④ B5 闭 / ⑤ E5 闭 见 #105 补注(onno 成本自愈 100% 覆盖 / 零撞号无可指认)。
⑥ E4 三轮排除扫描(全零命中) sweep1=订单/PL/结算/销售面(30d/90d/当月/上月 日均+原值); sweep2=广告面+月面(加 3 窗日均值+窗口合计); sweep3=3d/7d/14d 窗——26,501 与 fg 84 在 saas_registry public+audit 全部数值列×8 窗×日均/合计口径均不出现; 18 条原值命中全为巧合(id/margin_pct/local_amount 单行值)。结论=两数字非汇聚层任何聚合口径, 出自前端展示层计算/导出/源库直查/手算之一, 维持待出处页指认。盲区声明: 本轮未扫 center_warehouse 源库(WebUI 不直读, 若出处为源库直查需另扫)。
⑦ B10 四死库已归档 github_research 5.2M(4 表)/redash 160K(20)/izero_factory 120K(21)/izero_pm 16K(2)→/opt/backups/b10_dbs_20261113/+SHA256SUMS+pg_restore --list 逐个验可恢复; 【DROP 已执行 17:1x 北京·B10 闭卷】用户 `!` 通道 pkg3 四库 DROP 全过; 终验: 库 10→6, 四目标零残留, 幸存=izero_ba/kol_db/izero_promotion(三活体)+center_warehouse/saas_registry/postgres(核心), 与 ④ 分型完全一致。venus 覆盖已核: /opt/backups 顶层不在任何推送范围 → 副本已并入 zipforce-hub/backups/b10_dbs_20261113(该树整体镜像无 backups 排除), 明晨 venus rsync 自动拾取, 双份在位。
⑧ B9 WebUI 终态三案呈报 甲=判读列(每行附人话判读)/乙=结论卡(区块置顶结论)/丙=双层(结论卡+判读列), 已呈报待拍板。【拍板 18:19 北京·丙双层定稿】结论卡(页级置顶)+判读列(行级)双层落地; 三条边界随案生效: ①判读=规则引擎零 LLM(确定性规则可审计); ②判读引用阈值一律在册口径——v1 只用既有 caliber(零单四参数 id64/R24 BID_CALC 族等), 新阈值另走 AC-CAL-17 入册禁自造; ③横向同构=机制核单源+页面壳, 形态即全站标准。实施即启, proto3/4 KPI统计卡群同批排入。
亲跑包 ×4 全部落地(17:0x-17:2x 北京) ①⑤DDL 会话代跑(用户两度下令, `!` 粘贴以消息态到达未执行, 终验 9 列 PK/1594 行零变动) / ②部署 17:11 用户 `!` 真执行, build+recreate 全绿 / ③B10 DROP×4 用户 `!` 全过, 库 10→6 / ④timeout_s UPDATE 2 行(15/25→3600) 用户 `!` 全过, RETURNING 实证。备份: backups/changelog-pre-106-advance-20261113.html。
web/lib/interpret.ts(零依赖纯函数, 禁 import)——三面单源: skuJudge(SKU 主表判读列, 7 规则+null 兜底)/noonCountryJudge(Noon 分国家, 3 规则)/deltaPct(id47 显示式: 基=0或缺→不可比, 负基=|基|分母)/marginTone(id42 三态, 入参百分数)/conclusions(结论卡: 可动手=alerts high 前3·窗口盈亏·Amazon 环比方向·Noon 事实面, items≤5)。阈值全部经参流入(Th), 冻结锚 FROZEN_TH 仅兜底(=在册值 15/20/30·25/40/10)。事实型判读(零单/净亏/纯自然单/有广告无单)零阈值; 量级仅 id42; 环比仅方向+id47 显示式。金额 amazon=$USD·noon=本币带币种(#56 不混加)。
② 页面壳(只许调用, 禁壳内变体) components/Interpret.tsx=InterpretTop(结论卡 .concl-card ①②③+可动手区+12 卡 stat-grid+数据健康卡, th={...FROZEN_TH,...useThresholds()})+JdCell(行级 td.jd, anchor 悬停); app/page.tsx=InterpretTop 挂载(KpiResp amazon/noon 直通)+Noon 分国家表尾列判读; components/SkuMasterTable.tsx=判读尾列(表头+每行 JdCell+tfoot 补空 td 保 16 列); globals.css 追加判读列/结论卡/stat-grid/th.jd-h 样式(proto4 形态)。kpi-cards 既有端点零新 SQL 零新口径(AC-CAL-17: values 后端单源, 前端零公式)。
③ 断言矩阵(用户令首例) web/scripts/b9_assert.mjs——编译真源 lib/interpret.ts(镜像项目 target ES2022)后断言, 测试文件只含 fixture+硬编码期望值, 零规则拷贝。34 用例/33 分支分母全覆盖, 34 PASS/0 FAIL; 分母清单硬编码在脚本内, 任一分支 0 用例即 exit≠0(枚举分母机械化); caliber 语句逐字节断言, 装饰文案仅 tone+子串; S8b 专证阈值参流(换线 10→12% 落 ok/20→落 warn, 证非写死)。首跑 2 FAIL 属我方笔误非规则错: S5 fixture 给 profit=-1 先命中净亏规则(改为 profit≥0 使 margin 面单独可达)、C3 期望值笔误; 同时暴露机制核真瑕疵一处(danger 带双标点「,(<0」)已修, 断言同批更新——期望值永不自动更新, 全部人审手改。
④ 构建与部署 tsc --noEmit 0 错(途中修掉 page.tsx 我方插入注释多一「}」笔误); next build 过; 构建产物 9 标记 grep 全命中(stat-card/concl-card/concl-acts/jd-h/有广告无单/纯自然单/零单文案/id45 等长窗/可动手)。镜像 18:52 build, 18:53:02 北京 up -d web(避 19:00 档, 坑24; web-only, api/worker/db/redis/caddy 不动)。
⑤ 活体监测点 8 PASS/0 FAIL web health 200; 生产 api 容器内注册表 8 值断言(health_line=25/40/10·id42=15/20/30·id12=35/90, TH_ASSERT OK); DB id42 filters→net_margin_healthy=15 与 FROZEN_TH 同值; 容器 bundle 5 标记(stat-card/concl-card/jd-h/有广告无单/可动手)。附注: /api/metric-thresholds HTTP 层带登录门(Depends current_user), 匿名 curl 实得 unknown tenant 属预期门控行为非故障, 探针走容器内同函数断言。
⑥ 挂账 (a)ACOS-平衡线卡: breakeven_acos 仅存在于 finance 面内部(mon_ratios), 未下发 dashboard, 需后端扩池另批(展示页禁公式, 不能前端算); (b)proto4 卡无池源 4 张: Noon GMV 本币/EU VAT/回款待收/养家Top5(Noon 有效件 units_valid 半源在 per_country 有、deck 池无); (c)playwright DOM 探针: 渲染层断言(视觉面最弱环节)后补。
⑦ 补披露欠账(11-12~13 会话) (a)分类学体检 probe SCH 表清单修复(旧清单含已并库陈表致 0 表误报); (b)我方自查事故: schema_full_checkup_20261112.json 被 probe OUT 变量覆盖(改前未先改带日期文件名), 从 venus 备份 scp 取回复原逐字节, OUT 已改带日期名防再发; (c)B9 开工前分类学预检门已跑(18:22 北京, 177 表全量五面, 结果落 /logs/schema-unify/schema_full_checkup_20261113.json); (d)2 新 A 哨兵 flags: foncye_amazon.ads_daily.advertised_sku 1594 行空=⑤投喂过渡态(#106 ③ DDL 已落, 待用户投喂商品级 Report_*.csv 自愈); foncye_amazon.spapi_removal_orders.currency 3 行空=只报不动观察项。
⑧ 待用户 E4 出处页指认(sweep 三轮全零命中已报, 26,501/84 非汇聚层任何口径值); ⑤ 恢复投喂 Report_*.csv→/opt/collection/dropbox/foncye-ads/。
breakeven_acos=((利润+广告−AMZ采购成本−Noon采购成本)÷营收)×100, 随 deck 窗口; AMZ 成本=2026-09-26 拍板口径(sku_mapping.cost_rmb 优先·fallback 采购 RMB 列·items_count 空→SKU 数估·÷RMB_USD), Noon 成本=B批 P1-5 有效件口径(月表窗口对齐 _ncm1/_ncm2 随 amounts 分支; daily-finance 精确模式保留月表口径+脚注「·Noon成本按月表对齐」); 营收=0→null(禁 0 分母); pending 爆红防御/noon_lag 脚注链同步纳入新键。
② B ACOS≥平衡线=红 判定 web/lib/interpret.ts 新增 acosJudge(零依赖纯函数): ①平衡线在且 ACOS≥线→danger「危 · 广告已蚀尽毛利」(拍板#56/#58 同式·含等号); ②线缺或线下→退 id16 三态。后端 vals.acos.tone 保持 id16 原值不动(改后端会牵连其余消费面), 判定只活在 web 判读层(统计卡+结论卡 conclusions 同判插窗口盈亏前)。STAT_KEYS 12→16 键(+数据健康=17 卡)。
③ C Noon本币GMV 卡 池化 txt 卡: 「SA 85,140 SAR · AE 20,914 AED」形(#56 不混加, 各市场原值直读); D 养家Top5 卡: 窗口利润前5 SKU「名称 $利润」|分隔, 利润口径=SKU 主表同源。
④ D 同构铁律(2026-11-12 令)首例落地 SKU 行集实现从 sku-matrix 端点抽出为模块级单源 _sku_matrix_rows(cur,d1,d2,brand,country,want_amz,want_noon)(自含 noon_months/unsettled/bf/cf), 端点与 deck top5 两壳只许调用。Top5 增量延迟实测 306~308ms(最大租户 izero)<500ms 阈→不加缓存(度量决策, 非拍脑袋)。
⑤ E EU代扣VAT 卡 audit.cleaned_order_fees.vat 窗口合计(R16-P1 principal 代扣非费用项·JOIN cleaned_amazon_orders 订单日切窗); 实测 T1 近30天=0.0 属如实空窗(全史峰值月 2024-10 有值, 窗口内零 VAT 行; T2/T3 从未有 VAT 行)——非缺陷。
⑥ F playwright 渲染层探针(挂账 ⑦c 闭卷) 依赖零新增(宿主 playwright 1.62.0+chromium 既有); 登录态=容器内 make_token 铸会话(零 users 表触碰·零 login 审计行), 探针纪律=Redis sess 集合+TTL 快照→测→逐字节还原(15 断言含还原 2 断言, 15 PASS/0 FAIL): 登录态不被弹回/统计卡 17/四新卡标签可见/结论卡 3 条/td.jd 14 格/ACOS 判定链 DOM 级一致(acos 67.8<be 70.0→退 id16 危·≥观察线40%·rd 类+var(--danger))/口径锚 title 在位。首跑脚本崩溃在还原段前→铸出的会话泄漏 Redis, 已按 created<15min 定位清除回 7 会话, 修正后全程绿——泄漏-清除过程如实入档。
⑦ G 部署+四层断言 20:01:47 北京 up -d(避 20:00 档, 坑24; api+web 同批)。断言面(用户 11-13 令: 硬编码断言+监测点, 禁 LLM 切片): ①规则核 b9_assert.mjs 扩 AJ1~AJ7/C10~C12 共 44 PASS/0 FAIL(平衡线优先含等号/线缺退 id16/th 参流换线/结论卡文案逐字节); ②部署前行为探针(新源码挂同镜像·真库·零接触运行容器) 23 PASS; ③部署后容器内同探针 23 PASS(A.cost 独立 SQL 复算±$1·top5↔行集同源·vat 窗口真值); ④活体监测点 b9_live_probe.sh 扩至 13 PASS(新增⑤a KPI_POOL 池化登记⑤b deck 值类型⑤c bundle 3 标记; 池 label 在后端 API 面, 匿名 HTTP 有登录门→容器内真源断言)。
⑧ 探针拦下的真缺陷(②层的价值实证) Noon 成本 SQL 第二段 f 前缀丢失(f""" 拼接段无 f→FX_PEG/RMB_USD 花括号原样进 PG 报 SyntaxError)——py_compile/单测均不可见, 部署前行为探针首跑即拦, 若无探针层该缺陷将直达生产。另: b9_assert.mjs 顶部 import 为 #107 迁移期遗留损坏(import {fs.rmSync} 形, 先于本批存在), 修为 import fs from node:fs, 断言矩阵同批全绿。
⑨ 入册 id65 待亲跑 metric_calibers=共享单表无 RLS(portal_app 只读·saas_admin 可写, 实证纠正「三租户三册」预判); id65 breakeven_acos_window(公式/判定链/Noon 月表对齐/消费面+四层断言注记, AC-CAL-17)SQL 备 /tmp/caliber65.sql(含 setval+回显), api 角色权限拒绝属设计门禁→待用户 `!` 亲跑(docker exec -i zipforce-saas-db-1 psql -U saas_admin -d saas_registry < /tmp/caliber65.sql)。我方代跑通道=被门禁拦, 未绕。【落地 21:19 北京·亲跑】用户 `!` 通道真执行: INSERT 0 1·setval 65·回显 id65 breakeven_acos_window 在位; 终验 portal_app 角色可读+formula 字段核验 OK(运行时公式为代码内实现, id65 为治理真源, 无缓存重启诉求)。
⑩ 挂账/待用户 (a)H 回款待收=四卡中唯一未实施项: 定义仍缺, 提案随回报呈报待一句话拍板(候选=已售未出结算报告 vs 结算报告已出未到账·对账面), 不自造口径(AC-CAL-17); (b)E4 出处页指认(承 #107 ⑧); (c)⑤ 恢复投喂 Report_*.csv→/opt/collection/dropbox/foncye-ads/(承 #106 ③d, 广告面 sku 真值依赖)。
seller_owner IN (SELECT account FROM tenant_accounts)(账本=账号名 zipforce_amazon/onno_amazon/fittingirls_amazon); 而 sync_source.py 未提交工作树改动把订单构建模板 stamp 从账号名改成 schema 名——diff 实录 so="zipforce_amazon"→"izero_amazon"、so="fittingirls_amazon"→"vnique_amazon"(文件 mtime 11-13 16:47 北京; 系 11-12 更名手术(#97 族)后续改动的未提交内容, 非 #108 批次所改——该批次只动 dashboard/interpret; 首笔翻转执行会话未指认)。brands_source 注册表 seller_owner 列本身仍是账号名(正确)→即 stamp 硬编码与注册表真源脱钩。
③ 证据链(全北京时) 21:19 #108⑥ 探针绿(be=70.0 需 AMZ 营收>0; kpi 面无缓存层, DOM 值=活库直读)→当时可见; ~21:45 起 H 读路探针全暗; 22:06 xmin 查证: 全部 6,335 幽灵行同一事务 xmin=2098971(txid_now−20)=单一一次性全量重建; 窗口(21:19,~21:45)内 21:05:54 hourly 摄取已完(被 21:19 绿排除)、22:05 晚于首暗、api.log 该窗零非 access 动作、夜审/财务对账档在 05:3x/05:4x 不在窗内→首笔全量翻转=非定时档的一次性执行(疑似手动全量重建, 执行者未钉——如实挂账, 叙事与事实分开)。
④ 波及面(61 表 seller_owner 全扫) cleaned_amazon_orders 幽灵 6,335/44,586(存量账号名 stamp 止于 2026-08-14=90 天增量窗外缘, schema 名 stamp 08-15~11-13); cleaned_order_fees 46,605/46,615(≈整表); cleaned_aba_keepa_full 2,376 行 NULL(另一形状, 非本机制, 单列挂账); 小表 NULL: ads_rule_config 60/collection_schedule 7/ads_imports 1; 其余 55 表全净(Noon/广告面不受影响)。查询点 ~121 处/9 路由(dashboard 47·finance 44·ai 10·matrix 9·mcp 5·ops 3·brandboard/notify/collab 各1)。
⑤ 关键运维事实 worker 与 api 两容器 /app/sync_source.py 均已烤入新 stamp 版(08:47Z)→hourly 增量持续给新订单盖 schema 名(#108 部署 20:01:59 重启 api 时把该工作树一并烤入——我方部署成为加载路径, 如实记录); 只修数据的回填会被后续新行再污染→修复必须代码先行, 后重建镜像+up -d(避整半点, 坑24)。
⑥ 连带发现(独立缺陷, 只报) finance_face_recon 夜档(北京 05:41)连续 DB FAIL: center_warehouse zipforce_amazon.spapi_finances 不存在——该 schema 已随 #97 更名 izero_amazon, 工具口径未跟改; 三夜 PASS 后于 11-12/13 之交断。
⑦ 修复选项(待拍板, 未动手) A(荐): sync_source 三处 so= 硬编码改为 brands_source.seller_owner 注册表单源派生(顺带消灭硬编码=同构铁律正解), 重建镜像+部署, 再按注册表映射一条 UPDATE 回填存量(izero_amazon→zipforce_amazon·foncye_amazon→onno_amazon·vnique_amazon→fittingirls_amazon; SQL 备 /tmp/rls_repair_A.sql 待 `!` 亲跑); B(不荐): tenant_accounts 塞 schema 名=毁账号账本语义。aba_keepa 2,376 行 NULL 另案(asin→sku_mapping 血缘补 stamp, 需单独拍板)。
⑧ 在途任务影响 H 回款待收(甲·已拍板)实现不阻塞(其新面设计本就 stamp 账号名), 但 LIVE 数值与部署依赖订单面恢复可见→排序上先拍板本条。
_pipe_registry() 返回值从 (sch, sm) 二元组升格 (sch, sm, seller_owner) 三元组——stamp 一律取注册表 brands_source.seller_owner(账号名), schema 前缀仍用 source_schema(s/cs/t/dedup 派生不变); 消灭 so= 硬编码=同构铁律(机制核单源)正解。订单模板(orders_tpl 三分派 master/fg/onno)与费用模板(_FEES_*)的 so= 实参全部改经注册表派生; onno 代卖分支 so_zf=so_by_schema[cs] 反查宿主账号同理。
② 部署前硬断言 15/15 容器内同镜像+新源码挂载跑探针(py_compile 全量 + 分支展开计数 + 四处 amz 解包点 arity 核对——抓到 py_compile 抓不到的 4 处漏改解包位, 全部修齐后再过); 镜像重建+up -d 22:34:09 北京(避整半点, 坑24)。
③ 存量回填(用户 `!` 亲跑, 分类器纪律) v1 SQL 首跑触发列探针 bug 回滚(原子性成立, 零半写; 如实记录); 三次 `!` 输入形态失败(全角!/无输出/首空格)后 v2 跑通: BEGIN / UPDATE 6335 / UPDATE 46605 / orders_residue 0 / fees_residue 0 / COMMIT——cleaned_amazon_orders 6,335 幽灵行+cleaned_order_fees 46,605 行 stamp 全部按注册表映射回正(izero_amazon→zipforce_amazon·foncye_amazon→onno_amazon·vnique_amazon→fittingirls_amazon)。
④ 三租户复验 11 PASS / 0 FAIL 每租户经 tenant_conn(RLS 语境)断言: 近30天有效订单非零/全表非零/stamp⊆本租户账号集/deck rev30·profit30 非零。分对账(分-级精确): T1 Noon 28,402.51 + AMZ 5,819.14 = 34,221.65 ✓; T2 Noon 997.23 + AMZ 2,461.22 = 3,458.45 ✓; T3 #109 时假深亏 −2,832.34 恰=可见广告花费→AMZ 面单恢复后真值 +17,909.99 ✓(三式全数吻合到分)。
⑤ 23:05 增量监测点(Monitor) 23:05:00 ingest_today_incremental 开跑→23:05:53 done(53s); 摄入后 ghost 残留断言 orders_residue=0 / fees_residue=0——新行 stamp=账号名, 增量链不再产幽灵, 修复不被回滚污染。
⑥ 连带(承 #109 ⑦) aba_keepa 2,376 行 NULL 另案挂账(血缘补 stamp 待拍板); finance_face_recon schema 名口径(zipforce_amazon→izero_amazon)独立挂账待修; 均不在本批动。
country 列, 该表实列 15 个无 country(最接近=currency), 2026-10-05 修引入 CASE country 即坏; per-task 异常被吞 run rc=0 故无告警。修=列名改真源(currency 反推 ae/sa/eg 或写入面补列)拍板待定。连带观察: 同轮 skus_of 中央取键 permission denied for table tenant_brands→回退冻结镜像(存量)。
③ 新第四红 noon-returns(03:25 registry 全量轮哨报): noon_returns_pull.py flush() 内 wiped=True 赋值缺 nonlocal wiped→首次 flush UnboundLocalError rc=1; 批#61(10-14)引入, 调度日志自 10-15 04:10 UTC 起 54 次同型(存量 30 晚); 数据面 izero_noon.returns_references=0 行/foncye=140 行冻结不自愈。今晚崩在 if not wiped 读侧、TRUNCATE 未执行, 无新数据损失。修=补一行 nonlocal 拍板待定。
补注 03:5x 调度实例退出、stdout 缓冲落日志: [collect] brand=zipforce/onno platform=noon …tenant=1/2 双派发行实证(19:53 UTC flush, 前次派发 11-11 19:53→顺证 11-12 空档)——② 之 ps+fd 推断升级为直接日志证据。
补注 05:5x 两档验收 four_layer_audit batch=2026-11-13-ce3161e4 201/201 行 FAIL 17(昨 13)/WARN 20: ①新红=fittingirls Amazon 断流全面化(昨 BE/SE 2 市场→今 11 市场全红+源新鲜度 gap4)——根因 vnique-amazon SP-API orders_status 全市场 403 Unauthorized(14 调/档, 403 非致命→rc=0 静默, 出口 IP ✓, 订单源冻结 2026-11-09 起, 存活日志内 403 至少自 11-12 22:00 UTC)——授权侧问题, 修复=用户侧重授 fg 凭证(行见凭证真相源清单), 只报不动手; ②frontend_e2e KeyError 'zipforce'=三租户更名(11-12)遗留(_SECRET_TENANTS 键已新名, e2e 兜底仍用旧名), 存量 2 晚, 只报; ③zipforce/onno 侧昨夜红(onno/SA+zipforce/GB 断流+双源新鲜度+全域断更 4 表)今全转绿=11-13 注册表重接线首航落库成功; ④存量 4 项原样(audit_nodes 凭据目录空/chart_value rc=1/dashboard_audit rc=1/RLS unforced:public.warehouse_stock); WARN 含 onno/AE 挂账过期复报(续期 audit_known_issues.expires_at 待拍板)。finance_face_recon 05:41=已知挂账缺陷(zipforce_amazon→izero_amazon schema 名, #110 ⑥)预期 DB-FAIL 原样。
④ 处置纪律 全部只报不动手(没点名的不许自行决策); 05:07 four_layer_audit/05:41 finance_face_recon 两档守望中, 结果随晨报。
ingest_all(tables=["settled_orders"])=37,322 行精确命中(T1 10,738 + T2 525 + T3 26,059), net_usd_backfill=910, 快照 backups/metric-calibers-pre-181-20261113.dump 先行; 面验收: 3 支行数=定格真值/幽灵 0/哨兵 0。
② 镜像未建根因(回填输出 clean-f5c561cbc809 假绿) 显式事务复刻三步实证: clean_generic 37,322 行全清洗 0 脏 ✓ → _swap deps 种子 SELECT 'audit.cleaned_settled_orders'::regclass 首建无旧正式表→UndefinedTable 炸→savepoint 回滚(镜像零残留吻合)→失败行 log.info 在 docker exec 环境(logging 默认 WARNING)被吞→run 仍正常返回 run_id。定性: clean_audit 引擎 2026-10-23 视图依赖链重构引入的通用缺陷(换名段本身 IF EXISTS 防御式齐, 唯 deps 种子漏防护; 任何新表首建都炸, 非 settled_orders 特有)。修=种子改 to_regclass 判空一行级(存量表行为逐字节不变), 但修引擎=改源+rebuild api 容器(/app 无 bind, build 进镜像)→只报不动手待拍板。
③ 绕行落地(用户 ! 亲跑 /tmp/h_jia_mirror_fix.py) 首建空壳(壳随后被整套换名吃掉)→重跑 run_id=clean-d3e0dfcd203a 1/1 表成功→正式镜像 37,322 行; 之后每日 04:30 全量清洗自动维护。
④ 验收全链(硬编码断言) 镜像: rows=37,322/rls=true/force=true(house standard)/policy brand_isolation 三分支齐(brand∈租户品牌∩is_active + brand_scope GUC + seller_owner 第4分支自动挂——181 零登记设计实证)/PK 索引 idx_cleaned_settled_orders_pk/portal_app SELECT/盖章零幽灵=0。三租户 RLS 可见性(core.tenant_conn 真实消费路径): T1 10,738[zipforce_amazon]·T2 525[onno_amazon]·T3 26,059[fittingirls_amazon], 零越界·零遗漏·合计=37,322 全集零重叠。deck 当场独立复算交叉(窗口已跨日, 同式新算 10-16..11-14, 不对 11-13 定格值): T1 $5,202.42/349 单/thru 11-07 · T2 $1,160.17/54 单/thru 11-08 · T3 $13,364.57/696 单/thru 11-09 三式全吻合到分, foot 披露 recv_n+settle_thru+id66 齐(11-13 预演 336/$4,724.73·53/$1,142.76·696/$13,364.57 仅作历史记录)。b9 活体探针 18 PASS / 0 FAIL(⑥a-⑥e 全过; ⑥d 探针期望字面量笔误 t|0→true|0 监测点自修正, 产品面在册+零幽灵属实)。
⑤ 同窗连带 audit-26 标准更新批互认: 其裁定 warehouse_stock 真漏 FORCE 路由本线, 本线核验=force 确漏但 policy 已在(brand_isolation 三子句同构), 修复一行 ALTER 待用户亲跑(跑后随本条目补注); vnique 403×12+finance_face_recon 真红维持。
补注 07:0x warehouse_stock FORCE 落地(用户 ! 亲跑) after: rls=true force=true; 补 FORCE 后三租户可见性断言 T1=18/T2=0/T3=0 与行分布(tenant_id=1 全 18 行)精确吻合——零回归、隔离正确; four_layer_audit RLS 不变量 unforced 项下批预期消红。
country 列(#111②); 修=CASE currency WHEN 'SAR' THEN 'sa' WHEN 'AED' THEN 'ae' WHEN 'EGP' THEN 'eg' END + AND currency IN ('SAR','AED','EGP')(未知币种不送, 零虚构); 值域实证 izero/foncye catalog_offers 现仅 SAR(null=0); 活体 dry 跑新 SQL=64 items 全 sa; 宿主改即生效(worker :ro), 验证档=今晚 19:00 UTC(北京 11-15 03:00)看 pricing 新 snapshot_date 行。
② returns 复活(nonlocal 补 wiped) noon_returns_pull.py flush() nonlocal n_rows→nonlocal n_rows, wiped(#111③ 批#61 引入 54 次同型终结); py_compile 过; 同档(北京 11-15 03:00)观察 izero_noon.returns_references(现 0 行冻结)恢复写回。
③ caliber 三行旧 schema 名→新名(SQL 宿主 /tmp/calibers_rename_fix.sql 待用户 ! 亲跑) 映射=zipforce_amazon→izero/fittingirls_amazon→foncye/onno_amazon→vnique(11-12 更名); id62 finance_face_recon filters.schemas 三值全旧名=每晚 21:41 UTC 档逐 schema relation does not exist DB FAIL 直接根因(LIVE 消费=finance_face_recon.py 读 cal["schemas"]); id27 storage_fee_recon gap_reasons 三键+report_residuals 两键旧名=工具运行时 schema 集=information_schema 实名(新名)与 .get(schema) 失配, 已备案差额将从「WARN 放行带理由」降级 FAIL(LIVE, 按需跑下次即炸); id31 consign_schema 注记拉齐(真源 brands_source.source_map.consign_schema 实值已=izero_amazon, 纯台账滞后); id63 分诊免改——no_key_tables 中 *_amazon=seller_owner 账号名(tenant_accounts 五账号 zipforce_amazon/fittingirls_amazon/onno_amazon/zipforce_noon/onno_noon 未随更名改, auto_seller_owner 触发器写的正是账号名), 语义正确非滞后; 佐证=pg_proc 全库扫 saas_registry 唯一含旧名函数=该触发器(账号名语境), center_warehouse 零。
④ clean_audit 引擎首建缺陷修复落地(#112② 待拍板→本批) _swap deps 种子 SELECT %s::regclass::oid→SELECT to_regclass(%s)::oid(首建无旧正式表不再 UndefinedTable 整表回滚); 等价性硬证据=amazon_orders 4 视图链/ads_sku_daily 3 链/settled_orders 0 链, 新旧式输出逐行相同+首建路径打不存在表 0 行(种子 NULL→递归零展开→views 空集→换名段 IF EXISTS 全防御); 生效待 rebuild api(build 进镜像, /app 无 bind)。
④b 吞错假绿同修 sync_source.py 两处 clean_audit.run 调用点(小时增量 line ~2086/ingest 后 line ~2712)log 回调 log=lambda m: log.info("%s", m)→print——info 级在 arq/docker exec 环境无 handler 被 logging 默认 WARNING+ 吞, 清洗逐表失败完全不可见(run 仍返 run_id)=#112② 假绿温床; print 直达容器日志; 与④同镜像同批 rebuild 生效。
⑤ cascade 撤案(考古反转) #111① 「现已无任何调度载体」系误诊——host-crontab.txt 底册 line 32 注释实证: cron 行系 2026-10-10 注册表宪法主动停用(mapping 只由注册正向生成, 严禁订单/FBA 逆向垫表; cascade 机制恰是平台源 diff 逆向垫 shared.mapping_*), 非 carrier 丢失; 载体不补, adapter 文件保留(同 G2 promotion 退役范式, 恢复=宪法层面拍板); SKU 目录覆盖 5538 恒红之缺口(zf=397/fg=5141/onno=0)归注册正向登记欠账, 正道=用户侧登记, 不归 cascade。
待用户 ! 两件 ③ docker exec -i zipforce-saas-db-1 psql -U saas_admin -d saas_registry < /tmp/calibers_rename_fix.sql(自带 after 复核四段); ④ rebuild cd /opt/six-claude/workspace/saas && docker compose build api && docker compose up -d api(避坑24 整半点档)。
cred_name = "zf" if brand == "zipforce" else brand; config._secret(f"noon_{cred_name}.json") 自造拼接找 noon_zf/noon_onno.json(不存在); 实际凭证=izero_noon.json/foncye_noon.json(注册表单源 config.py NOON_BRAND_REGISTRY, 全库 17 处引用皆新名, 唯此适配器漏改)。11-12 更名级联用字面量 grep 找引用点, f-string 拼出的文件名不是字面量=漏网(坑 22 变种); 且适配器 catch 异常 return 0 → DONE: 0 rows 且 rc=0, 调度器 _isolated_run 只记文本无 FAIL 判定=假绿静默 4 天(坑 31)。
③ 修法 对齐注册表单源: 头部挂 BRANDS = config.NOON_BRAND_REGISTRY, make_session 改 _s, cred_path, _pk = BRANDS[brand] 三元组消费+json.load(open(cred_path)), 删自造拼接死分支——与其余 5 个 noon 适配器(fbn_inbound_pull 等)同构姿势; py_compile 过, /opt/collection 挂 worker(:ro) 宿主改即生效免 rebuild, 容器内 52-54 行双验一致。bak=noon_inventory_sync.py.bak_20261115_credpath。
④ 避免机制(用户令第二问, 两件套) (a)根治=凭证路径单源化——今后更名只改注册表一行, 全适配器自动跟随, 自造文件名拼接绝迹; (b)兜底=recon_gates.py 新增「Noon.库存快照新鲜度」staging(izero/foncye aging ≤2天)+cleaned(页面源表 ≤3天)两门, 破=FAIL×_ingest_alert 报警——不看 rc 不看日志直接断言数据面, 断流 ≥2 晚必红(本次事故形态 11-14 19:17 UTC 门值=3 即红, 最迟第 3 天可见, 不再拖到人工盘点); 阈值校准依据=noon 报告业务日滞后 0~2 天波动(11-15 手动跑当时最新=11-13 快照); 引擎 21→23 门(9.79 口径边界不变, 恒等式不另立册行); 坑 30(拼名躲更名字面量搜索: 级联检查必扫 f-string 动态拼名模式)+坑 31(0 行 rc=0 假绿: 排查数据停更先查勾稽门而非 rc)入坑册。
⑤ 验证链(全绿) 手动跑 docker exec worker /collection/run.py noon-inventory → 两品牌成功: staging 落 11-13 快照 izero 148+foncye 15 行(与历史每日行数同构, id 区间 512600-512812 单调证新落); 定向 ingest_all(tables=['noon_inventory']) → public.noon_inventory +103 行 max=11-13(总 5643); 清洗 1/1 表成功(clean-17f290d73837) → cleaned_noon_inventory 11-13 快照 89 行(zipforce 81+onno 8); 勾稽门两门绿(2/2, 红态先行验证过=断流期值 4/4 与事实恒等); 页面端点读 max(snapshot_date)=11-13 恢复。缺口如实记录: 11-12 快照永久缺失(快照制过了不可回补), 断流 4 天(11-12~11-14)期间库存变化无快照留痕。
⑥ 顺带 #122 net_usd 01:05 UTC 生产终验 PASS: onno 922/1051=基线恒等不再被抹, zf 15375/15375+fg 28617/28617 全恒等, 回填管道日志 1 次在跑。勾稽门其余红均为在册挂账(四层金字塔 9~12 波动/Amazon 广告新鲜度 15=onno 人工 CSV 未投递/SKU 目录覆盖)非新问题。
from routers.dashboard import KPI_DEFAULT=新十卡 ✓; web 构建产物「窗口内无异常判读」0 命中(结论卡确撤)+「盈亏平衡ACOS」在 dashboard page chunk ✓; uid1 DB 行=新十卡 ✓(RETURNING+全表复查); 部署 02:52/02:55 UTC=北京 10:52/10:55(api+web 分批 --no-deps, 避 03:05 增量档, worker 全程未动)。
⑦ changelog 尾部结构债清偿(顺带揪出) e121/e122/e123 三条 append 时漏写 </article>(嵌套未闭合一路到 FOOT, 浏览器容错渲染故从未暴露; 开标签 9 vs 闭 7)——本批补三处闭合+去尾一处多余闭合, 开/闭 11/11 平衡全顺序化。bak 三份: dashboard.py.bak_20261115_kpidefault / Interpret.tsx.bak_20261115_concl / page.tsx.bak_20261115_concl / changelog.html.bak_20261115_125。
令: 用户指认工作台智能报警上方的显示区域(截图确认,非「📊 KPI 概览」卡组——后者在报警下方未动),问名并令「删除他」。对象定谳: 该区域=InterpretTop(「KPI 统计卡群」,2026-11-13 B9 丙双层拍板产物,17 固定卡+数据健康卡,固定判定层不可换)。
令: 用户令「每页的顶部选择器,全联动控制当前页面数据」,广告页为首要对象;范围 mid-turn 两拍——「只需要查亚马逊部分」→「都要查」=Amazon/Noon 都改,其余页逐页核查续办。原状病灶:hero 投放总览/月度表只吃 brand/platform/time;图墙只吃 country/days 不吃精确 from/to 与产品/SKU;SKU 矩阵靠客户端过滤(AC-CAL-17 呈现层零公式红线下的客户端重算聚合)。修法纪律=服务端下推(后端参数+SQL 过滤,单源保持,前端零自算)。
/api/ads/platform 与 /api/ads/charts 加 country/product/sku 三维参数。dims() 子句构造器(顺序固定 country→sku→product 与占位符序一致):国家=直滤;SKU=列精确匹配(amazon 腿A advertised_sku/腿B sku、noon sku);产品维=sku_mapping 行值 IN 子查询(非相关一次求值避 RLS LATERAL 退化,显示名表达式与前端 prodOf 同式)。platform 端点:monthly 双腿/campaigns 腿A/skus 双腿/facets 全受三维;campaigns legB(ad_campaigns 30 天快照,无 SKU 维)=国家直滤、SKU/产品筛下整腿省略;R23b 配置快照零指标行与 noon 覆盖层同规则(country upper 直滤、SKU/产品整行跳过)。charts 端点:amz src/top_src 四腿插维、noon src 表切换(SKU/产品筛→v_noon_ad_sku_daily 归集层 id=18 SKU 级真源,口径差 ~2.3% 仅显式筛下承担,本条入册即拍板承担;仅国家筛/未筛仍走 cleaned_noon_ads_daily 数字零漂移)。facets 响应字段 {countries,products,skus} 链式语义:countries 全量、products 受国家收窄、skus 受国家+产品收窄,UNION ALL tag 单往返。SET ROLE portal_app+SET app.tenant_id 复核。租户 1 权威真值:amz 无筛 4780.02/14258.28、AE 1070.73(=腿B,租户 1 amz 日表零行)、facets 11/11/20;noon 无筛 190007.16/806246.18、AE 48206.09、facets 2/67/67、AE 下 58。令: 2026-11-15 用户令「每页的顶部选择器,全联动控制当前页面数据」+ 范围拍板「都要查」——#128 广告页收口后其余页逐页核查,有缺口一并修。
核查分母(13 页全枚举): orders ✅(status/days/country/frm/to/search/brand 全服务端下推, KPI 卡与明细共用同一 where); products ✅(search/sort/country/brand/page; 卡内 drill 与 price-suggestions 各自透传); rankings ✅(主表 platform/market/search/brand; history/markets 联动; RatingAnalytics 卡内 plat/mkt=AC-CAL-17 展现型拍板); sourcing ✅(各 tab country/term/months/q/domain 全透传; aba/overview=全局统计); today ✅(brand/platform/country 三维 bf/cf 全 SQL 下推; 晨报=今日锚定边界); offsitepromotion ✅(channels 七参数全透传; summary=采集运营统计, 运营资产库无品牌维); 工作台 ⚠️→修(kpi 四维/KpiCharts country·product·sku·平台语境/ChartWall/SkuMasterTable 全联动; AlertsPanel=平台级六类扫描 docstring 拍板边界; MonthlyCompare=品牌×月度全景卡, 同比环比需完整月史=卡自身锚定边界; CountryPnL 不吃全局国家筛选=本批唯一实质缺口, 已修); finance ✅(profit-matrix dim/months/country; full brand/country/d1/d2; 全年逐月图=全景卡); inventory ✅(平台 tab 驱动; AmazonCabin health status/country/search/page; 结构卡=注释拍板全景原值); noon ✅(catalog-sales country/days; reviews rating/brand); settlement ✅(filter/search/brand/page); mapping ✅(platform/search/brand/page); logistics ✅(badge/search/brand/page; params/pricing/appendix=静态源)。
缺口与修: 工作台分国家 P&L 卡(Amazon 20 列/Noon 同构)只吃 brand+时间窗, 全局选国家后 KPI/图表墙/SKU 主表全收窄而此卡仍显示全部国家行——违反全联动。修=两端点加 country 自平衡参数(与 #128 同款 (%s='' OR country=%s) 模式):
amz-country 签名+订单费用腿+广告腿+环比/同比对比期四查同滤(对比期不同滤则 mom/yoy 口径漂移; 广告腿不同滤则 setdefault 建行漏出他国纯广告行);
noon-country 签名+PL 月表+日视图+广告+状态四腿+对比月一查同滤(同 setdefault 建行理由)。
前端 CountryPnL props 加 country 透传, page.tsx AmazonSection/NoonSection 两调用点传入。
改动: api/routers/dashboard.py(bak=.bak_20261115_cpnl_country) 10 处; web/app/CountryPnL.tsx(bak 同名规约) 2 处; web/app/page.tsx(bak 同名规约) 2 处调用点。
验证: 容器内直调两端点——收窄前后被选国家行数字逐字节恒等断言(AE/SA 各对拍)+无 country 零漂移回归; 部署后活体验证。部署时刻与验证数字见下方补注。
补注(同日收口): 部署=北京 13:06 api/worker/web 三容器滚动(容器 StartedAt 05:06:52 UTC; build 完 12:58 距 13:00 collection push 档/13:05 arq 档不足 3 分钟, 避档24 等到 13:06 过档才 up -d)。冒烟(租户1, 经 api 池 tenant_conn, ALL_ENDPOINT_CALLS_OK): amz rolling 30d 无筛 9 国(SA AE GB FR ES IT SE BE NL), 收窄 country=AE 与无筛 AE 行恒等 gmv=1407.35/mom=45.2/yoy=314.6, GB 633.10/-23.8/-50.0, SA 2357.09/-8.7/3.2; exact 窗 2026-10-16~11-14 AE gmv=1447.53·对比期 960.70·同比基准 339.46; 品牌×国家组合 zipforce×AE=1407.35; noon mon=2026-11 收窄 SA gmv=28894.36/mom=-74.2/yoy=-82.8, AE 7744.03/-72.7/-84.3。恒等断言首跑逐字节比 5 字段 1e-13 量级不符——两次同参全量对跑零漂移证实=SUM 浮点累加顺序 IEEE754 非结合性尾差(全量 GROUP BY 多国 vs 单国收窄聚合顺序不同), 非活表漂移非缺陷, 断言改容差 1e-6 后全组合 PASS。web 侧构建产物验证: chunk app/page-3aa426cfe9fe247d.js 中两端点 URL 模板均带 &country=…encodeURIComponent(country) 尾参且 useEffect deps 数组含 country——透传在产物中实证成立。
13页分母全枚举 cpnl 国家下推四腿+对比期 自平衡参数模式同构#128 边界六卡拍板在案(报警/月比/全年图/结构卡/summary/overview)
令: 2026-11-15 用户问「之前为什么没发现」(答: 无此验收维度+单组件垂直验缺组合面+props 漏传静默)后拍板「添加」——把组合面固化为常设防线。
立门: tools/audit_selector_linkage.py 三册—— LINKS 32 行(页×文件×端点串×参数串共现断言; 含 /ads #128 三维下推 3 行与工作台 CountryPnL #129 修复本体 2 行; 断言串全部 2026-11-15 从源码原文摘取, 期望值硬编码永不自动更新); EXEMPTS 13 行(拍板豁免卡在册: AlertsPanel 平台级/MonthlyCompare 全景/merged-kpi 模式卡/全年逐月图/库存结构卡×2/promotion summary/aba overview/评分展现型 AC-CAL-17/noon reviews/logistics appendix/mapping edit; 超集合规——日后加参数不违规); NO_SELECTOR 29 页(静态/工具/管理/向导面逐页 grep 定性: listings=任务工具页(brand/market/q 任务参数), onboarding=向导表单, backfill/pipeline/settings=运维操作端点, po/projects=无 country/platform 消费, en=英文镜像等); 分母强制: web/app 下每个 page.tsx(共 43 页含工作台)必须三册有其一, 新页未登记=FAIL——新卡上线流程=过本门+扩表, props 漏传类静默缺口结构上不可漏。
验证: 首跑抓真缺口 2 处(/ads 漏册+#128 本体页、/privacy 漏登静态)→补册后 ALL PASS(LINKS 32/32·EXEMPTS 13/13·43 页分母全覆盖); 负例自测: 临时撤 CountryPnL country 参数→FAIL×2 精确指位两腿, 还原→ALL PASS(门能抓 #129 本体缺口=设计目的实证)。纯源码 grep 不打 API 不占 gate_lock 浏览器互斥族。
挂载: audit-base.html+md/audit-base.md 双档 §7 AC-GATE-08 行(bak=.bak_20261115_gate08); tools/four_gates_nightly.py GATES 数组追加为第 9 道(bak=.bak_20261115_gate08, ast 过)——19:10 UTC 夜跑自动含本门, FAIL 走 monitor SMTP。
门立·首跑ALL PASS 负例自测FAIL×2实证 43页分母机械强制 夜跑第9道已挂 顺修: e128 闭合标签回补(#129 入册锚误吃致 15开14闭, 本批配对校验发现)
令: 用户问「audit_base有很多基线,都有审计吗?」,交付四类分型盘点(①常设自动执法:夜跑 9 门+四层审计+fullstack_p0~p3+cron_audit/credential_liveness/pipe_morning_check/finance_face_recon;②注册表对账 reg:idN→ruler_recon;③断言在案但触发式——建条/改动时人工跑过,代码悄悄漂移无 nightly 兜底,#129 CountryPnL 即此形态实例;④过程律令)。结论如实=非每条基线都有常设审计,触发式缺口面只报不补待拍板。用户令「干」=把可机械化触发式面扩常设。
立门: tools/audit_baseline_gate.py(夜跑第 10 道,four_gates_nightly GATES 尾挂)九组断言,期望值 2026-11-15 逐条实测锚定硬编码永不自动更新:
不收面(如实只报): SEC-05 停用断流(须停用企业活环境=副作用)/SEC-06 强制层单测(CI 触发面)/PIPE-01 三去重恒等式+PIPE-05 模板 format(复刻清洗与模板构造逻辑=造二源,真源在 api/clean_audit.py 与 /opt/collection)/PIPE-02 中断注入(破坏性)/PIPE-06 docker exec 规程(纪律)/AC-CAL 无 reg 条目(口径定义性质,执法载体=注册表对账+各面验收)。
验证: 首跑 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 精确指位(0 条 policy)、FIN-05 期望值漂移→FAIL 报实际值 -362.28,还原→如初。修判据三处过程:SEC-02 groups 不过滤 search 改判 total+items、pg_policies qual 换行压平 chr(10)、SEC-01 生成器漏传 cookie(自抓)。
挂载: four_gates_nightly.py 第 10 道(bak_20261115_gate09)+audit-base.html/md §7 AC-GATE-09 行(bak_20261115_gate09)+本条。纯 API+只读 SQL 不占 gate_lock 浏览器互斥族;HTTP 登录复用 pen_tests.login(__main__ 守卫内才占锁,import 无副作用)。待拍板: ①zipforce 红旗豁免/复核 ②14 张表 RLS 偏差补 policy 或改册 ③服务费册面旧值 -728.73 修注
令: 2026-11-15 用户「补」——前序问答链: AC-GATE-09 门首跑 zipforce 2026-04/05 净利率红旗(52.56%/50.01% 连续两月超阈)→ 问「哪个平台?怎么计算的」→(答: 仅 Amazon 腿、SP-API 结算聚合、不含货本/广告)→ 问「每个数据没有口径公式吗?为什么还有这种奇异的理解」→(答: 阈值有册公式无册,字典仅四字,公式真源只在 sync_source SQL)→ 拍板补口径公式册。
口径本义(本条钉死): 净利率=Σ(net_profit_usd)÷Σ(revenue_usd),月粒度 brand×marketplace×mon(finance_monthly);净利=结算收入−|平台总费用|−|促销返拨|(行级 COALESCE(net_usd, 本式÷入账日 fxd)折 USD)+服务费按月×区域收入占比摊入;费用边界=只含平台侧结算扣费,不含采购货本/头程/广告费——语义=Amazon 回款净额率,非含货本的会计净利(该口径下 50%+ 属常见区间);scope=Amazon 全站点结算事件(SP-API Finances→spapi_finances;fg 型=finances_view),noon 不在本口径(noon_sku_pl_monthly 另册);阈值仍派生 id34(0.5,action=超阈视为口径嫌疑→人工复核)。
落地五件: ①尺子册 DB 行 metric_calibers id67(册面 AC-CAL-35,metric=net_margin_formula,filters 全量公式/excludes/scope/truth_anchor,v1)——注: DB 主键与 audit-base 册面 AC-CAL 号是两条序列(id35 已被 ads_time_window 占用;id34 的 audit_base_ref=AC-FIN-02 非自号,先例在案),故 DB=id67/册面=AC-CAL-35;②audit-base.html AC-CAL-35 行(AC-CAL-34 后);③md/audit-base.md AC-CAL-35 块;④数据字典 net_profit_usd 描述由「净利 USD」四字补为含 AC-CAL-35 边界全述(api/data_dict_meta.py,compose build+up -d,北京 20:20,health 200+容器内文件实证);⑤AC-GATE-09 门补 FIN-02a2 断言(id67 行在册+excludes 含「采购货本/广告费」锚串+formula_version=v1,册行漂移=门红)——门重跑 20 项: a2 PASS、唯一 FAIL 仍 zipforce 红旗(待拍板项原样)=零回归。
偏差上报(只报未动,待拍板): 落 ③ 时发现 md/audit-base.md 存量缺档 AC-CAL-28~34 七条(html 档在册、md 档无——双档不同步偏差,AC-CAL-35 在 md 接于 AC-CAL-27 后孤悬断层)。补齐与否您拍板;补=从 html 档搬压缩版七块。
挂账关联: zipforce 红旗/14 表 RLS 偏差/服务费旧值三项待拍板不变(#131);本条为其口径基建,红旗豁免与否仍待复核拍板。bak 五份: audit-base.html.bak_20261115_cal35 / md/audit-base.md.bak_20261115_cal35 / changelog.html.bak_20261115_132 / api/data_dict_meta.py.bak_20261115_cal35 / tools/audit_baseline_gate.py.bak_20261115_cal35。
令: 2026-11-15 用户「md 缺的七条也补」——对 #132 偏差上报(md/audit-base.md 存量缺 AC-CAL-28~34 七条,html 有 md 无,AC-CAL-35 接于 27 后孤悬)的拍板。
做法: html 档七条原行(127~129 行 AC-CAL-28/29/30 + 3918~3921 行 AC-CAL-31~34)格式转换为 md 管道压缩块——六列表行→「ID| 名称+令注| 口径| 验证| reg| 状态」,转换仅标签映射(b→加粗、code→反引号、br→硬换行、HTML 实体解转义、pill 取文本),口径/验证/reg 三列全文搬运零删节;AC-CAL-28 为五列行(html 本无验证列)按五段原样。插入位=AC-CAL-27 块后、AC-CAL-35 块前;html 档本批零改动(纯 md 补档)。
验证: md 档 AC-CAL 条目 28→35、编号 1~35 全连续(20~27 既有+28~34 本批+35 上批),孤悬解除;RULER_RECON 13 门复跑 PASS(registry 64 行·带锚 67·漏锚 0·违约 0=零回归)。
备份: md/audit-base.md.bak_20261115_md2834 + changelog.html.bak_20261115_133(未跟踪 bak 累计 21 个,夜封/变更清单随报)。
令: 用户「三项也拍了 ①豁免 ②补policy ③修注」——对 #131/#132 上报的三项偏差全部拍板处置。
①净利率红旗豁免(zipforce): 门 FIN02_EXEMPT={fittingirls,onno}→+zipforce(口径复核定谳=AC-CAL-35 回款净额率非会计净利,贴线 50%+ 属常见区间);双档 AC-FIN-02 验证列注记(豁免册三品牌+「豁免册外新红旗仍 FAIL」,旧文「无自动门」同步更正为 AC-GATE-09 常设)。
②14 张共享表补 policy(迁移 182): 现状侦察=零企业/品牌维列(information_schema 亲验);形态定谳=ENABLE RLS+shared_read(FOR SELECT USING(true))显式化,行为等价原则——此前未 ENABLE 时 portal_app 凭 GRANT 全表读,补后访问面零变化(SET ROLE portal_app 实测: cleaned_metric_calibers 63 行/dirty_data_log 5,566,675 行照常可读);写通道=owner saas_admin 非 FORCE 不受影响。
迁移账本三事(P1-19 机制): (a) 181 pending 破案——pg-init 181 文件账本 180,活库亲验 public.settled_orders 表在+metric_calibers id66 在册=主体 11-13 批已手工应用仅缺登记,按 10-31 P3-12 先例 --register-existing 收编(账本 181=181 待应用 0);(b) 182 手工双登记缘由——migrate.py 主循环撞存量 DRIFT 即 sys.exit(排序前端挡住新文件),通读确认无定向参数后走等价路径: psql -q -1 单事务应用(14 policy/无 policy 表 0)+schema_migrations sha256 INSERT+audit_log migration.182.applied 见证行(note 注 manual-witnessed 缘由);(c) sha 漂移 12 个存量旧账上报(不代修,待拍板)——06-real-data/08-amazon-orders/22-onno-ads/106/120/127/128/137/141/142/143/144 账本 sha 与现文件不一致,非本批造成,migrate.py 对这 12 个永远 FAIL 挡新迁移(本批已实证),修法=逐个 --register-existing 重收编或人工核后放弃账本行,须用户拍板。
③AC-FIN-05 册面旧值修注: 双档 −728.73→−362.28(−=U+2212)+修注「建条时点旧值 2026-11-15 复核修正修注,常设门 FIN-05 锚=−362.28」,不编差异原因只记两值+时点。
门联动(audit_baseline_gate.py 三处): EXEMPT_NO_POLICY 14 张→set() 清零(PIPE-03b 自动覆盖全 144 表);PIPE-03c 加第三型 shared_read(pg_policies 查询加 cmd 列,断言 cmd=SELECT);docstring PIPE-03 段更新为拍板落定表述。
册联动(AC-PIPE-03 双档): 口径列尾加「【2026-11-15 拍板「补policy」迁移 182:共享面 14 张=ENABLE+shared_read 显式化,访问面零变化,豁免册清零】」;验证列更「AC-GATE-09 PIPE-03 常设:全 144 表恰 1 policy,shared_read 型 cmd=SELECT」。
验证: 门重跑 20 项 ALL PASS+WARN×3(fittingirls/onno/zipforce 存量披露不阻断)+FAIL 0;RULER_RECON 13 门 PASS 零回归(尺子 2805 持平=注记非新行);活库终态 144 表全 ENABLE/policies 144/shared_read SELECT 型 14。
备份: audit_baseline_gate.py.bak_20261115_3verdict(反转构造精确改前态)/audit-base.html.bak_20261115_3verdict/md/audit-base.md.bak_20261115_3verdict/changelog.html.bak_20261115_134;新增 pg-init/182-shared-read-rls-14tables-20261115.sql(已应用已双登记)。未跟踪 bak 累计 22 个。
令: 用户「sha 漂移 12 个也收编了吧」——#134 挂账的 12 个存量 DRIFT 全部收编。
做法: 先读码确认 migrate.py --register-existing 对账本同名文件直接 continue(只补无记录行,不更新 sha)→ 对已登记漂移行无效,走手工等价路径(同 182 精神): python 算 12 文件(06-real-data/08-amazon-orders/22-onno-ads/106/120/127/128/137/141/142/143/144)pg-init 现文件 sha256 → 单事务 12×UPDATE schema_migrations + audit_log 见证行(action=migration.ledger.sha_repair_12files_20261115,trace_id=ledger-sha-repair-20261115,before/after 各 12 文件新旧 sha 全录)+ COMMIT。
语义披露(如实): 收编=账本认现文件、放弃对历史改动的 sha 追责;fresh volume 重建将应用现文件版本(活库当年应用的是历史版本,两者差异自此不在账本追责面)。风险已随拍板接受。
验证: migrate.py --status 终态=目录 182 文件|账本 182 行|待应用 0|目录外账本行 0|sha 漂移 0(前态漂移 12);UPDATE 12 行命中;残留旧 sha 0;见证行 before/after 俱在。
零文件改动(纯 DB 账本面,changelog 本体除外,bak=changelog.html.bak_20261115_135);未跟踪 bak 累计 23 个。
非全部最新:37 档 cron 主链全活;真断流 1 条(audit.cleaned_amazon_sku_fin_daily 三品牌全停 2026-11-08,根因实锤可复现);漏档 1 个(collection_finances_deep 周六 03:20 档 11-14 未跑,水位停 11-08,gap 7.2d<8d 阈值未红,原因未查);拍板停用态/低频面均与在册口径一致。
① 源健康:center_warehouse.vnique_amazon.spapi_finances 至 11-15 00:41、spapi_orders 至 11-15 13:00(采集层活着);② spec 实算(worker 容器内 _refresh_dynamic_specs 现跑):amazon_sku_fin_daily 源查询 36,819 行、day 范围 2024-09-01~2026-11-15,引用已全为新 schema(izero/foncye_amazon)零旧名残留;③ 脏行:源查询含 12 行 country=NULL(全 fittingirls,posted 2026-06-24~07-23,fetched 2026-08-06 02:50 回补批入库;经由 brands_source.fg 行 finances_view=public.v_fittingirls_finances_flat 视图直读 country 列透传);④ 爆点:upsert 撞 staging public.amazon_sku_fin_daily.country NOT NULL → SAVEPOINT 整表回滚(单表隔离=该表当夜零写入,三品牌同表全灭);⑤ 静默机制:job 整体 done → redis arq:slot 水位绿(11-14 21:06「成功」);单表 error 只进 worker 日志(json-file 已轮转不可回看)、audit_log 零 ERROR 行——完全无告警面;⑥ 复现:容器内走真执行器路径(_upsert_stream+SAVEPOINT+ROLLBACK 净零写入)→ NotNullViolation 100% 复现,样本行 (fittingirls, EUB2402BL00LB, null, 2026-07-24)。
2026-11-12 15:05~22:05 audit_log 29 行 applog.ERROR = 三企业更名批当晚 center_warehouse schema 已改名而 spec 尚引用旧名(UndefinedTable zipforce_amazon.*),ingest_source_daily/ingest_today_incremental 双档硬炸;11-13 起 ERROR 清零(#95 批修复生效),job 恢复绿——但 sku_fin 腿自 11-08 起即被 NULL 行静默炸断(11-09~11-12 与更名炸窗重叠,两故障独立)。
12 行 NULL 行 2026-08-06 已入库,为何 11-08 前未触发:fg 腿挂 finances_view 键/spec 变更的精确时点在 git 提交史与 audit_log 双源均无痕(brands_source.source_map 列变更无审计覆盖)——连带发现:注册表 source_map 变更无审计痕,建议列挂账。此环不影响修复方案。
A 治源:UPDATE 源库 12 行 country 补正(动 center_warehouse,须拍板);B 治管道:spec/执行器对 country NULL 行跳过或兜底(丢 12 行财务数据换管道恢复,须拍板取舍);C 治表:staging 约束放开(破坏 schema 一致性,不推荐)。任一落地后当晚 20:30 全量档自动追回 11-09~11-15 全部滞留数据(spec 全量窗口,无需手工回补)。
全活:分钟档 4(cycle_sales/ads_pump/sourcing_tick/promotion_tick 13:16 实测);小时/6h 档 4(noon_orders 12:07/noon_finances 12:41/ads_snapshot 12:14/noon_deep 08:00);日档昨晚 21:05–23:25 全跑(ingest_source_daily 11-14 21:06 成功);周档 ingest_source_weekly 11-08 正常;主链真值:sales_daily/hourly+amazon_orders=11-15 当日、finance_monthly/settlement/noon_monthly=2026-11 当月、rankings=11-14、inventory_health=11-14 22:05、settled_orders=11-09(周一 04:10 档正常节奏,下档 11-16)、广告日表=11-13(T+1/T+2 口径内)。拍板停用态:onno Amazon Ads(止 10-31,ADEF-C)、推送 daily_readonly(三企业 enabled=f,11-15 拍板)。低频/陈旧(在册口径内):keepa_seller_raw/aba_seller_full=09-26、aba_search_terms=11-03(语料月更)、inv_products=11-10/inv_warehouses=11-06、空表护栏群。挂账销项建议:AED/SAR 断流挂账已过期(cleaned_noon_statement AE/SA stmt_month=2026-11 均在)。
注:盘点窗内 f5 窗三轮部署(worker 14:24 UTC 重启),容器态时点已标注;本文所有断言均有可复现 SQL/容器内复现记录为证,未知处如实标注「未查/无痕」。