⏳ 历史快照(冻结于 2026-10-05(内容 9-26),不再更新)——现行口径(铁律/容器/业务流/数据流/定时任务)以 audit.html 第 0 节 为准;2026-10-14 起的变更记录在 audit.html 第 9 节。页内 mercury/Dell/222 为已退役链路的历史标签(2026-10-18 清零,勿作现行拓扑)。
Full-Stack Map

全栈全景图 · 一页看懂整个系统(结构 §1-§9 + 流程 §10 + 附录 §11)

框架 × 数据流 × 业务流 × 核心逻辑 × 问题落位 · 2026-09-26 第三十三轮全栈审计配套 · 第三次扩充: 权限全景+模块明细流(9节) · 第四次扩充: 分层架构嵌入权限链+模块泳道(图1-1/1-2) · 第五次扩充: 附录全清单·最细颗粒度(§11 端点255/页面39/表220/定时28/注册表群) · 第六次扩充: 工作流程图集并入单页(§10 12图124步: 10.1总流程~10.12 ai) · 变更日志 · 审计报告全文 · 业务流旧版(09-17)
用户/网关/应用 数据/同步层 存储 外部系统 P1口径错致决策错 P2口径不一/数据丢 P3卫生/潜伏
一句话总览:三台服务器(mercury 数据中台 / venus 采集机 / mars 本机生产)→ worker 每日把源头视图同步进 mars 的 Postgres 镜像表并原子清洗 → FastAPI 按写死口径出 255 个端点(RLS 租户隔离+模块门控)→ Next.js 26 个实页展示(本币+USD 双列)。事实进 metric_calibers 注册表,逻辑写死代码+门断言。LLM 只做咨询不进工作流。租户可自助注册→验证→子域自动签发→品牌开户(管道注册表驱动全链路自动)→项目/团队/计费自助;账户/品牌/国家/平台四维数据绝对隔离(第 5 节)。

1全栈分层架构(七层 · 权限链 + 模块泳道 + 数据流全嵌入)

图 1-1 分层总图:请求自上而下过权限链落到模块端点与数据表;图 1-2 模块泳道:基座+9 模块各一条「页面→端点逻辑→数据」纵切,层与图 1-1 对齐;✔ = 09-26 A~D 批已修复项(见第 8 节表)

图 1-1 · 分层总图(用户→网关→展示→权限链→服务→数据;异步层+源头层供数)
flowchart TB
  U["👤 用户层 · 三租户子域
zipforce / onno / fittinggoals.zipforcehub.com
角色三级: owner/admin(豁免员工授权·全活跃品牌)
member(需 user_modules 授权 + user_brands 圈定, 空=哨兵'-' 零可见)"] GW["🔒 网关层 · Caddy(mars)
子域路由 · on-demand TLS(只为 active 租户签发)
HTML 缓存(仅网关层) · admin off"] WEB["🖥 展示层 · web 容器 Next.js · 26 实页 · 导航 5 组 30 项
基座页(登录即得): 工作台/今日/排名/产品/映射/团队/计费/设置
报表=5页挂载卡片(工作台/财务/广告/库存/订单, 无独立路由·09-26勘误)
模块页(按 tenant_modules 门控渲染, 未开通不进导航):
sourcing·listings·ads+promotion·orders·finance+settlement+noon
logistics·inventory+po·collab(projects/documents/training/upload/feishu)·ai
本币+USD 双列 · ✔P2-8 导出全量 · ✔P2-2 chips双数 · ✔P3-4 取消态显式"] PCHAIN["🔑 权限链(每请求横切服务层, 五步)
① 子域 cookie → Redis sess 解析: 实时读角色/租户模块/员工授权/品牌范围
② 13 无会话端点自带鉴权: 注册流·价目·Stripe HMAC·MCP 密钥·internal 内网
③ require_module×9 双层: 租户开通(tenant_modules) AND 员工授权(user_modules)
④ adminOnly×41: owner/admin 专属(租户级)
⑤ brand_scope 横切 → RLS 落库(tenant_conn SET app.tenant_id + brand_scope)"] API["⚙ 服务层 · api 容器 FastAPI · 27 router
255 端点 = 201 模块/会话门控 + 41 adminOnly + 13 无会话
基座: dashboard/today/rankings/products/mapping/reports(38字段4域, 域门✔C)
业务: sourcing+verdicts · listing×23 · ads+promotion · orders
finance+settlement+noon · logistics+vnlin+yanwen · inventory_po+po
collab(pm/documents/training/upload/feishu) · ai×6(零写入)
管理: auth/org/onboarding/settings/billing/mcp/collab
✔P3-2 北京日切 · ✔P3-16 投稿审计"] DB[("🗄 数据层 · db 容器 Postgres saas_registry
public 121(源头镜像+注册表+会话表, 活体)
注册表群(唯一事实源): tenant_brands·tenant_modules·user_modules·user_brands
brands_source(管道) · marketplaces(amazon 19国+noon SA/AE) · platforms(amazon/noon=active, emag=planned)
metric_calibers 口径 10 行 · sku_mapping(成本权威) · collection_schedule(调度注册表, 2026-10-02)
audit 98 = cleaned_* 97 + dirty_data_log · RLS 键型 114 租户键+82 品牌键+23 全局无策略 ✔P3-5(未覆盖47→0) · ✔P3-13 cost对账门 · 逐表见 §11 附录C")] WK["🔁 异步层 · worker 容器(arq)
sync_mercury 每日 02:00/03:30(三分支 42 列对齐
回款口径统一 ✔A: onno 异常 526→245 · zf 848→868)
ads_import_pump 每分钟(Redis 锁+SKIP LOCKED)
clean_audit 原子换名 · daily_fx_rates 汇率锚"] RD[("⚡ Redis
会话 · AI日配额 · 幂等锁/任务锁")] MER["🛰 mercury 数据中台(104.194.81.222)
amazon_analytics 库 · 三品牌 schema + 视图
v_order_master / v_fg_order_finance / v_onno_unified"] VEN["🛰 venus 采集机(104.194.95.213)
onno/fg Sales · onno 断流 ES4d/FR5d/IT14d"] EXT["🌐 外部系统
亚马逊 SP-API · Amazon Ads API · Stripe
Vnlin 物流(两步下单+幂等校验 ✔B P2-4) · LLM 咨询(零写入) · 飞书"] U --> GW --> WEB --> PCHAIN --> API --> DB WK <--> DB API <--> RD WK <--> RD WK --> MER WK --> VEN API --> EXT classDef user fill:#eef0fe,stroke:#6366f1,color:#1e1b4b classDef app fill:#eef0fe,stroke:#6366f1,color:#1e1b4b classDef data fill:#e6f6f3,stroke:#0e9384,color:#134e4a classDef store fill:#f5f3ff,stroke:#7c3aed,color:#2e1065 classDef ext fill:#fdf3e7,stroke:#b45309,color:#451a03 class U,GW,WEB,PCHAIN,API user class WK data class DB,RD store class MER,VEN,EXT ext
图 1-2 · 模块泳道(基座+9 模块,每条泳道三格 = 展示层→服务层→数据层纵切;权限链横切全部泳道,异步/源头层全泳道共享)
flowchart LR
  subgraph B0["🧭 基座(无键, 登录即得)"]
    b1["📄 页面
/ · /today · /rankings · /products
/mapping · /team · /billing · /settings"] --> b2["⚙ 端点+逻辑
KPI 池 19 卡 · 趋势 81 图 · 今日实时盘
BSR 排名(LIMIT 60 显式标注✔D)
产品 30 天聚合 · 映射编辑(2000 上限预警✔D)
报表引擎(38 字段 4 域白名单, 域门✔C)"] --> b3["🗄 数据
amazon/noon 聚合 · BSR/关键词排名
sku_mapping(成本权威)"] end subgraph S1["🔍 sourcing"] s1["📄 /sourcing"] --> s2["⚙ ABA 词库(9表)→候选池→keepa 快照
verdict 决策: advisory lock+幂等重放
AI 只建议不决策"] --> s3["🗄 sourcing 9 表
decision_audit 全审计"] end subgraph L1["📝 listing"] l1["📄 /listings"] --> l2["⚙ 模板库→规则引擎文案→人工审
→SP-API 提交→事件回放(PT市场/bind-pt)"] --> l3["🗄 模板/事件表
23 端点全门控"] end subgraph A1["📣 ads"] a1["📄 /ads · /promotion"] --> a2["⚙ 6 源矩阵(自动×2/手动×4)→队列
→pump 每分钟→UPSERT 后传胜
否词/分时/预算→决策台(幂等三件套)"] --> a3["🗄 ads_sku_daily
amazon/noon_ads_daily
投稿审计✔D"] end subgraph O1["🛒 orders"] o1["📄 /orders"] --> o2["⚙ 三分支 42 列→清洗→状态五 tab
北京日切✔D · 取消态显式「—」✔D
取消单双拼写对齐✔D"] --> o3["🗄 cleaned_amazon_orders
(品牌键 RLS)"] end subgraph F1["💰 finance"] f1["📄 /finance · /settlement · /noon"] --> f2["⚙ finance_monthly+noon PL 源表直读
回款三分支统一✔A·铃铛自愈(868=868/245=245)
成本权威=sku_mapping · cost 对账门✔D"] --> f3["🗄 finance_monthly
noon_sku_pl_monthly
metric_calibers 口径 10 行"] end subgraph G1["🚚 logistics"] g1["📄 /logistics"] --> g2["⚙ 船票导入(UPSERT 幂等)→轨迹徽章
KPI 实时聚合自明细✔B
Vnlin 两步校验+幂等锁✔B · 燕文报价(as-of 已显)"] --> g3["🗄 shipments · 轨迹事件
报价表"] end subgraph I1["🏭 inventory"] i1["📄 /inventory · /po"] --> i2["⚙ FBA 快照→健康(chips 双数✔C)
→预警(汇总吃国家✔D)→PO 状态机
→收货自动 GRN→台账(移动加权/红冲/盘点)
导出全量不截断✔B"] --> i3["🗄 FBA 快照 · po/grn · 台账"] end subgraph C1["🤝 collab"] c1["📄 /projects · /documents
/training · /upload · /feishu"] --> c2["⚙ PM 产品/任务 CRUD→文档树协作
上传预览→确认两段式
数据浏览器敏感表黑名单✔D"] --> c3["🗄 pm_* · docs 表"] end subgraph N1["🤖 ai"] n1["📄 /ai"] --> n2["⚙ 6 端点→llm_chat 纯咨询
租户日配额(默认 50/日)
未配置→503 显式不显 0"] --> n3["🗄 零业务表写入(铁律)"] end
层对齐读法:图 1-2 每条泳道的三格纵向对应图 1-1 的 展示层→服务层→数据层;🔑权限链(图 1-1)横切全部泳道——先过闸再进业务;异步层+源头层为所有泳道共享的数据供给面。模块间业务先后闭环见第 3 节,数据流四层穿透见第 2 节,权限深潜见第 6 节,模块全量明细表见第 7 节。

2数据流 · 四层穿透(一条数据从源头到屏幕)

铁律:只查 rawdata→cleandata→api→web 四层;事实进注册表、口径写死代码、门断言防衰减

flowchart LR
  subgraph SRC["① 源头层 mercury/venus"]
    M["mercury 品牌视图
zf: v_order_master
fg: v_fg_order_finance_detail
onno: v_onno_orders_unified
✔A days_waiting/is_abnormal 三分支已统一"] V["venus 采集落库
onno/fg Sales·广告报表
(ES/FR/IT 断流追踪中)"] AU["自动通道
zf/fg Amazon Ads API
02:00 / 03:30"] HU["手动通道 · 应用内上传
Amazon=zip · noon=单日xlsx+选国
预览→确认→按日+国整体替换"] end subgraph ING["② 同步层 worker"] SY["sync_mercury · ingest_all
全量或定向(ADS_IMPORT_TARGETS)
_ORDERS_UNION 三分支合并对齐 42 列"] PU["ads_import_pump · 每分钟
Redis 锁 + SKIP LOCKED 单任务
适配器解析 → UPSERT 后传胜"] end subgraph STO["③ 存储层 db"] RM["public 镜像表(原始落地)"] CL["audit 98 = cleaned_* 97 + dirty_data_log
clean_audit 全镜像+原子换名+RLS
✔P3-5 死镜像补RLS · 逐表见 §11 附录C"] end subgraph SVC["④ 服务层 api"] EP["口径写死 SQL · 对齐 metric_calibers 10 行
RLS: tenant_conn SET app.tenant_id + brand_scope
✔P2-5 reports 白名单引擎已按域挂门"] end subgraph UIS["⑤ 展示层 web"] PG["KPI/表格/图表 · 双币列 · 空态显式
✔P2-2 chips在库/在管双数
✔P2-3 物流KPI实时聚合 · ✔P2-8 导出全量(t3 8809行)"] end M --> SY V --> SY AU --> PU HU --> PU SY --> RM PU --> RM RM --> CL CL --> EP EP --> PG
三条最典型的数据流(实例):
流路径口径要点
订单→回款mercury 三视图 → _ORDERS_UNION 42 列对齐 → cleaned_amazon_orders → /api/settlement · /api/orders → 回款页/订单页/铃铛✔A(09-26 已统一):起点=coalesce(发货日,下单日)·一律要求未回款;onno 异常 526→245(实测=审计预测一字不差)、zf 848→868 统一口径,铃铛同源自愈
广告 6 源自动(Ads API)/手动(上传)→ ads_imports 队列 → pump → 适配器 → 定向同步 2~3 张表 → clean → 重算按钮全 6 表模式矩阵事实源=mars 采集 config.CAPABILITY;zf/amazon 自动·zf/noon 手动·fg/amazon 自动·fg/noon 无通道·onno 双手动
财务月度finance_monthly(AMZ 结算) + noon pl_monthly(对账单) → /api/finance 7 接口源表直读 → 财务页成本权威=sku_mapping(2026-09-26 拍板「sku mapping是对的」后翻转);X2 采购价三处已全部对齐 ¥95(今日完成)

3业务流 · 经营闭环(业务怎么转起来的)

九个模块咬合成一个闭环;箭头=业务先后,闭环=库存预警自动回到采购

flowchart LR
  SEL["🔍 选品 sourcing
✔29轮已审"] LIS["📝 listing 上架
SP-API 提交
✔门控23/23"] PO["📦 采购 /po
draft→submitted→confirmed
→in_transit→received
收货自动GRN入库"] SHP["🚚 物流 /logistics
轨迹·报价·Vnlin下单
✔P2-4 两步校验+幂等锁
✔P2-3 KPI实时聚合"] INV["🏭 库存 /inventory
FBA+FBN+单据台账
移动加权·红冲·盘点闭环
✔P2-2 chips双数 · ✔P2-8 导出全量"] ORD["🛒 订单 /orders
状态五tab·时间窗
✔P3-2 北京日切"] SET["💰 回款 /settlement
待回款/异常/已回款
✔A 三品牌统一口径"] FIN["📊 财务 /finance · /noon
月度毛利·全平台KPI墙
✔32轮已审"] ADS["📣 广告 /ads · /promotion
6源矩阵·否词·分时·决策台
✔G/④A已审"] WARN["⏰ 预警环
补货算法→下PO预填
顶栏铃铛4类"] SEL --> LIS --> PO --> SHP --> INV --> ORD --> SET --> FIN ADS -.驱动.-> ORD FIN -.复盘.-> ADS INV --> WARN --> PO

4租户 · 品牌 · 模块矩阵(谁能看什么)

租户(子域)可见品牌(tenant_brands)模块开关(tenant_modules 9键)审计备注
t1 zipforce(内部)zipforce(active);fittingirls/onno(inactive)9 键全 true(09-26 listing 曾被误触关闭,同日经计费台接口重开,留审计)库存可见 139 行;回款异常 868(A 批统一口径后实测)
t2 onno(内部)onno + brainnews(均 active)9 键全 true库存 10 行;onno 异常 526→245(A 批修复实测=预测)
t3 fittinggoals(真实客户)fittingirls(active)9 键全 true库存 8809 行 → P2-8 导出丢 3809 行的实际受害者

RLS 双键(活体 219 表逐表实证,见 §11 附录C):114 张 tenant_id 键;82 张品牌键——amazon_orders / logistics_shipments / noon_orders / sku_mapping 等无 tenant_id 列的表走 brand ∈ 租户活跃品牌 ∩ brand_scope 等效隔离;23 张无策略=全局参考表及其镜像。四维隔离=账户/品牌/国家/平台,LLM 不进任何工作流。

5租户生命周期 · 自主管理 · 四维绝对隔离(SaaS 开放面)

租户从注册到品牌开户到团队计费的完整自助链;国家/平台是全局注册表(运营方管理,emag 已 planned 排队)

flowchart LR
  A["📝 自助注册 /register
注册开关 registration-status
(展示+403 硬门双层)"] A --> B["📧 邮箱验证 /verify
24h token · 可重发"] B --> C["🌐 子域自动签发
Caddy on-demand TLS ask
只为 active 租户发证书"] C --> D["🏛 品牌开户 /onboarding
一个事务 · 幂等:
品牌授权 tenant_brands
+ 管道注册 brands_source
+ 站点校验(platforms×marketplaces)
+ 默认仓种子 + 渠道登记"] D --> E["⚙ 管道自动装配
注册表驱动 · 新品牌一行
数据到位→全站自动带出"] E --> F["🏃 品牌运营
archive 停用可恢复
permanent 彻底删(两步·保留1活跃)
ShopConfigUpdated 事件
全停→租户调度自动暂停"] B --> G["👥 团队 /team
成员 CRUD · 角色分配"] B --> H["💳 计费 /billing
Stripe checkout · 模块开关 9 键"] I["📋 项目 /projects
产品·任务自助 CRUD"] -.经营并列.-> F
自主能力入口谁能操作现状
租户注册/register → /verify任何人(注册开关控制)✓ 自助已上线 邮箱验证+子域 TLS 自动签发
添加品牌/onboarding 品牌开户(含管道注册/站点选择/默认仓/渠道)+ /api/tenant/brands租户 owner/admin(_require_admin=租户级角色)✓ 自助已上线 品牌名规则校验·幂等·审计全有
品牌停用/恢复/彻底删/api/tenant/brands DELETE(archive|permanent) / activate租户 owner/admin✓ 两步定稿(09-22) 停用可恢复;彻底删按依赖顺序清数+至少留 1 活跃品牌
添加项目/projects(产品+任务)团队成员✓ 自助已上线 全 CRUD+审计
添加国家—平台运营方(DB 级)全局注册表 marketplaces:amazon 19 国 · noon SA/AE · emag RO/BG;租户开户时从中选择,不可自增
添加平台—平台运营方(DB 级)全局注册表 platforms:amazon/noon=active · emag=planned 排队;新平台=采集适配器+清洗+页面全套工程,非开关
四维数据绝对隔离(铁律:账户 / 品牌 / 国家 / 平台)——每一维怎么落地的:
维度隔离机制备注
🏢 账户(租户)间RLS 双键:每请求 tenant_conn SET app.tenant_id;多数表 tenant_id 键,orders/logistics 无租户列走品牌键;WITH CHECK 只能写本租户绝对——跨租户探针三租户实测互不可见;21 张死镜像已补 RLS(✔D P3-5,未覆盖 47→0)
🏷 品牌间品牌键 RLS(brand ∈ 租户活跃品牌 ∩ 会话 brand_scope)+ API 显式品牌参数绝对;跨品牌聚合仅审计基准等显式白名单场景
🌍 国家间country 数据字段 + 页面筛选;不做跨国聚合除非显式数据级隔离;预警汇总吃国家=✔D P3-6 已修
🛒 平台间表域分离(amazon_* 与 noon_* 两族表)+ reports 域白名单 + platform 字段校验结构级隔离——amazon 花费不会算进 noon;新平台接入=新表族+新域

6权限管理全景(谁能做什么——每一次请求怎么过闸)

255 个 API 端点 = 201 模块/会话门控 + 41 adminOnly + 13 无会话(各有自带鉴权或设计公开);角色三级 × 模块 9 键 × 品牌范围三层叠加

flowchart TB
  BR["👤 浏览器请求(子域 cookie)
zipforce/onno/fittinggoals.zipforcehub.com"] SES["🎫 会话层 current_user
Redis sess:{sid} 解析 · users.status=active
实时读库: 角色/租户模块/员工授权/品牌范围
(管理员改授权下一请求即生效)"] G0["🔓 无会话 13 端点(各自带鉴权)
注册流5(开关注视+403硬门) · 计划页1
Stripe webhook(HMAC签名) · MCP(Bearer mk_*→sha256)
internal×5(X-Tenant-Id头+内网) · tenant/exists"] G1["🎫 会话门 current_user
基座页: 工作台/今日/排名/产品/映射
团队/计费/设置/报表引擎(域级另挂)"] G2["🧩 模块门 require_module×9 / require_module_any
双层: 租户开通 tenant_modules
AND 员工授权 user_modules(owner/admin豁免)
未开通→403 unpurchased · 未授权→403 forbidden"] G3["👑 adminOnly _require_admin ×41
owner/admin 角色专属(租户级)"] BS["🏷 品牌范围 brand_scope(横切所有门)
owner/admin=租户全部活跃品牌
员工=user_brands∩活跃品牌 · 零授权=哨兵'-'看不到任何品牌行"] RLS["🔒 RLS 落库(tenant_conn 每请求 SET app.tenant_id+brand_scope)
键1 tenant_id / 键2 brand∈活跃∩scope · WITH CHECK 防跨写"] BR --> SES SES -->|无会话端点| G0 SES -->|基座| G1 SES -->|模块端点| G2 SES -->|管理端点| G3 G1 --> BS G2 --> BS G3 --> BS BS --> RLS classDef gate fill:#eef0fe,stroke:#6366f1,color:#1e1b4b classDef store fill:#f5f3ff,stroke:#7c3aed,color:#2e1065 class G0,G1,G2,G3 gate class SES,BS,RLS store class BR gate

角色三级 × 能力矩阵

角色来源模块门管理面(adminOnly 41)品牌范围
owner注册/开户创建随租户开通全通行✓ 全部全部活跃品牌
admin团队页授予随租户开通全通行✓ 全部全部活跃品牌
member团队页邀请需逐模块授权(user_modules)✗(仅自己档案/会话管理)user_brands 圈定(空=看不到任何品牌)

模块开关(tenant_modules 9键)是租户级计费决策,员工授权(user_modules)是租户内再分配——两层独立,先开后授。

13 个无会话端点——为何公开

端点群鉴权方式定性
auth 注册流×5(register/verify/resend/registration-status/tenant-exists)注册开关+24h token设计公开SaaS 入口
/api/billing/plans无(价目表)设计公开无敏感数据
/api/billing/webhookStripe HMAC 签名校验签名即鉴权
/mcpBearer mk_* → mcp_keys.sha256 → RLS密钥即鉴权四维隔离不下放 LLM
/internal/api/v1/* ×5X-Tenant-Id 头+内网通道内部通道mercury 侧回读
adminOnly 41 端点分布(租户 owner/admin 专属):
路由器数管什么路由器数管什么
settings6系统设置/参数org(团队)5成员 CRUD/角色分配/邀请
auth4会话管理/互踢/档案onboarding4品牌开户/管道注册
listing4模板/批量操作collab3数据浏览器/敏感表黑名单
mcp3MCP 密钥管理ads3广告配置/规则
billing1计费台(模块开关)verdicts/settings 等8决策审计/杂项

会话细节:每子域独立 cookie;Redis sess:{sid} + sess_user:{slug}:{uid} 双键,互踢=revoke-other-sessions;TOTP 2FA 端点已除役(2026-09-26 D批P3-11——只写标志登录不校验=假信号,真 2FA 挑战流挂账)。

7模块 × 业务流全清单(九模块 + 基座,每个模块一条明细流)

第 3 节看闭环咬合,本节逐模块展开:页面 → 端点群 → 数据流 → 关键护栏;所有模块同受第 6 节权限层横切

模块(9键)页面业务流(输入→处理→输出)关键护栏
基座(无键,登录即得)/ · /today · /rankings · /products · /mapping · /team · /billing · /settings工作台KPI池81图→今日实时盘→BSR排名(前60标注D批)→产品30天聚合→SKU映射编辑(2000上限预警D批)→团队→计费台→设置→自定义报表卡片(工作台/财务/广告/库存/订单 5 页挂载, 38字段4域白名单, C批按域挂门)会话+RLS+brand_scope 横切; 排名 LIMIT60 显式标注; 映射分支守卫防串品牌
sourcing 选品情报/sourcingABA 词库(9表)→候选池→keepa 快照→verdict 决策(advisory lock+幂等重放表)→ verdict 落库 → 转入 listing/products决策全审计(sourcing_decision_audit); 幂等键16-128字符; AI 只做建议不做决策
listing Listing工作台/listings模板库→生成文案(规则引擎)→人工审→approve→SP-API 提交→事件回放(events)→PT 市场/bind-pt 关联23/23 端点全门控; 提交前人工审批强制; 事件全审计
ads 广告与推广/ads · /promotion6源矩阵(自动 Ads API×2 / 手动上传×4)→ads_imports 队列→pump 每分钟(Redis锁+SKIP LOCKED)→适配器→UPSERT 后传胜→否词/分时/预算规则→决策台执行(X-Idempotency-Key+重放表)→投稿记录(promotion, D批补审计)上传预览→确认两段式; 按日+国整体替换; 决策幂等三件套; 投稿审计
orders 订单/orders三分支合并 42 列(zf/fg/onno)→清洗→状态五tab→搜索/筛选→导出; 取消单显式「—」(D批 P3-4)北京时区日切(D批 P3-2); 取消双拼写对齐(P3-1); 时间窗可调
finance 财务/finance · /settlement · /noonfinance_monthly(AMZ结算)+noon pl_monthly(对账单) 源表直读 7 接口→月度毛利矩阵→全平台 KPI 墙; 回款跟踪: 三分支统一口径(A批 P1-1)待回款/异常>14天/已回款→铃铛自愈; noon 全平台视图成本权威=sku_mapping(cost对账门 D批 P3-13); 汇率锚定 registry#6; 本币+USD 双列
logistics 物流/logistics船票导入(列名映射+UPSERT幂等)→轨迹事件→徽章(TRANSIT/DELIVERED/EXCEPTION/CUSTOMS/AWAITING)→KPI 实时聚合自明细(B批 P2-3)→Vnlin 两步下单(B2B+箱单, 幂等锁+两步校验 B批 P2-4)→燕文报价(2026-08-08 版, as-of 已显)导入重复上传幂等; 下单 10 分钟同参防双击; 箱单失败显式 502 带单号
inventory 进销存/inventory · /poFBA 快照每日 ingest→清洗→健康页(国家 chips 在库/在管双数 C批)→补货预警(35/90天覆盖线, 汇总吃国家 D批 P3-6)→下PO(prefill 联动)→PO 状态机 draft→received→收货自动 GRN 入库→单据台账(移动加权/红冲/盘点)→FBN noon 库存预警汇总与明细同参; PO 在途关联带市场维(P3-7); 导出动态翻页不截断(P2-8); 台账红冲可逆
collab 文档协作/projects · /documents · /training · /upload · /feishuPM 产品/任务 CRUD→文档节点树协作→培训材料→上传中心(预览→确认)→飞书集成数据浏览器敏感表黑名单 11 张(D批 P3-15 刷新: 凭证/计费身份全拦)
ai AI 助手/ai6 端点→llm_chat 咨询(选品建议/文案/答疑)→Redis 按租户日配额(默认50/日)→纯文本返回零业务表写入(铁律); 未配置 LLM→503 显式「未配置」不显 0

8问题落位总表(P0=0 · P1=1 · P2=6 · P3=16,批次 A~D 已全部落地 2026-09-26)

完整证据链见 audit-fullstack-2026-09-26.md;本表=一图速览

级编号落位(层·页·文件)一句话问题批次
P1P1-1同步层 sync_mercury.py 三分支 → 回款页/订单页/铃铛「回款异常>14天」三品牌三种口径:onno 不看回款状态(虚高2.15×)、zf 起点用数据更新时间、同列三义✔A(09-26 落地)
P2P2-8展示层 /inventory 导出导出循环 5000 行上限静默截断,t3 实测丢 3809 行(43%)✔B(09-26 落地)
P2P2-3数据层 logistics_stats → /logistics KPIKPI 快照停 09-05,手动导入只刷明细不刷 stats;t2/t3 无 stats 行 KPI 空无说明✔B(09-26 落地)
P2P2-4服务层 logistics.py Vnlin 两步下单第二步箱单失败仍返回成功;无幂等(双击=两笔真实运单)✔B(09-26 落地)
P2P2-2服务+展示 /inventory 国家chips计数=上架行数、文案=有库存数(stocked 字段前端从未用,US 虚高5.25×)✔C(09-26 落地)
P2P2-5服务层 reports.py 8 端点自定义图表引擎无模块门,可跨模块拉数据(当前无受害=潜伏)✔C(09-26 落地)
P2P2-1展示层 /settlement 注记「历史快照固化」表述失实(随 P1-1 一并修)✔A(09-26 落地)
P316 项分散 8 文件UTC日切×2 · 取消单双拼写 · onno状态中文空 · 取消页$0 · 21死镜像 · 预警不吃国家 · PO在途无国家 · 报价无截至 · rankings前60无标注 · MFA孤儿 · 粘贴2000上限 · cost副本无断言 · 注释漂移 · 表黑名单陈旧 · 投稿无审计 · billing死条目✔D(09-26 落地, P3-9 实证已满足/P3-3 顺手在A批)

另有 6 条疑似经实证撤销(RLS 装饰性/mapping 与 promotion 无审计/注入可达/webhook 笔误致害/截断归因 zf)——撤销留痕见审计报告 §6.3。

9核心逻辑速查(写死在代码里的规则)

汇率锚定(registry #6)

RMB→USD=6.7963 · SAR=3.75 · AED=3.6725(锚定不浮动)

成本美元=cost_rmb/6.7963;利润率=(price−cost/6.7963−0.12·price)/price×100,0.12=平台佣金近似。

回款异常判定(A 批已落地 09-26)

days = now() − coalesce(shipped_date, purchase_date)
is_abnormal = days>14 AND Shipped AND NOT 已回款

实测:onno 异常 526→245(=预测一字不差)、zf 848→868 统一口径;铃铛同源自愈(双租户 868=868 / 245=245 实证)。

补货预警算法(inventory_po.py)

need = ⌈日均销速 × 35/90⌉ · shortage = max(0, 90线−可售)
po_inbound 按(brand,sku)关联 PO 在途

销速取 90 天窗;下 PO 预填联动 /po?prefill=。✔D P3-6 汇总吃国家、P3-7 关联带市场维。

成本权威=sku_mapping

ui 成本 ← sku_mapping.cost_rmb(2026-09-26 拍板翻转)

mercury 采购表退居镜像;X2 三处已对齐 95(mercury 40→95 今日执行,sku_mapping 本就 95,UI 不变)。✔D P3-13 cost 对账门已立(dashboard_audit)。

模块门控(9 键)

ads ai collab finance inventory listing logistics orders sourcing
Depends(require_module("…"))

listing 23/23、ai 6/6、业务端点全覆盖;模块开关=用户数据决策,403 非回归不擅翻。/promotion 挂 ads、/po 挂 inventory、/settlement+/noon 挂 finance。

RLS 租户隔离(双键)

键1: tenant_id = app.tenant_id()(多数表)
键2: brand ∈ 租户活跃品牌 ∩ brand_scope(orders/logistics)

API 每请求 tenant_conn 注入;四维=账户/品牌/国家/平台。21 张死镜像已补 RLS(✔D P3-5)。

幂等与护栏(三件套)

UPSERT 冲突键后传胜 · Redis SET NX EX 任务锁
advisory lock + X-Idempotency-Key(ads execute)

广告上传/重算/PO 收货自动 GRN 全幂等;Vnlin 下单护栏已补齐(✔B P2-4 幂等锁+两步校验)。

LLM 边界(铁律)

ai.py 6 端点 → llm_chat → 纯咨询文本,零业务表写入

Redis 按租户日配额(默认50);未配置 LLM → 503 显式「未配置」,不显示误导性 0。

10工作流程图集 · 总流程 + 模块最细颗粒度(12 图 / 124 步逐行表)

从注册到终态的总流程 → 数据管道横切 → 基座权限链 → 九模块流程 · 每步四要素:入口·触发 / 函数·端点 / 写表·产物 / 护栏 · 本节=流程视角,与 §1~§9 结构视角互补

口径说明:① 图与表均从 api/ 与 tools/ 源码逐函数提取(端点→函数映射 255 条全量、tasks.py 36 任务函数、core.py 权限链、sync_mercury.ingest_all、audit_clean_all 清洗引擎),非手工臆画。② 护栏列 = 已落地的代码级守卫(事务/锁/幂等键/重放表/状态机/审批门/RLS),与 §9 逻辑卡一一对应。③ 阅读顺序:10.1 总流程(注册→运营→终态)→ 10.2 数据管道(横切,一切读流的前提)→ 10.3 基座权限链 → 10.4~10.12 九业务模块。④ LLM 不进任何工作流(铁律):ai 模块只做纯文本建议,全部决策由代码规则引擎+人执行。

10.1总流程 · 租户全生命周期主流程(从注册到终态)

auth.py / onboarding.py / org.py / billing.py 逐函数实据 · 虚线=守卫判定 · 圆柱=落表

flowchart TD
  subgraph SG0["0 · 入口探测"]
    A0["访客打开注册页 /register"] --> A1{"GET /api/auth/registration-status
注册开关开?"} A1 -->|"关→403 硬门"| A9["拒绝注册(前端也隐藏入口)"] A1 -->|"开"| A2{"GET /api/tenant/exists
子域占用?"} A2 -->|"已占"| A9 A2 -->|"可用"| B0 end subgraph SG1["1 · 注册与验证 auth.py::register/verify"] B0["POST /api/auth/register
register( )"] --> B1{"一次性邮箱域?
DISPOSABLE_DOMAINS"} B1 -->|"是"| A9 B1 -->|"否"| B2{"同邮箱 pending 租户?
_pending_tenant_for( )"} B2 -->|"有→复用"| B3 B2 -->|"无"| B3["INSERT tenants
status=pending_verification
slug=公司名+hex(2)"] B3 --> B4["提交租户后另开租户连接:
INSERT users role=owner scrypt 加密
INSERT tenant_brands slug 占位行
INSERT tenant_modules 默认模块"] B4 --> B5["_issue_signup_token
Redis signup:token (24h)
_send_verification_email"] B5 --> C0{"GET /api/auth/verify?token"} C0 -->|"无效/过期"| C1["POST /api/auth/resend 重发"] C1 --> C0 C0 -->|"有效"| C2["UPDATE tenants
SET status=active"] end subgraph SG2["2 · 子域与登录"] C2 --> D0["Caddy on-demand TLS
ask 端点只为 active 租户签发
slug.zipforcehub.com"] D0 --> D1{"POST /api/auth/login
users.status=active 且 scrypt 通过?"} D1 -->|"失败"| D2["audit login.failure
不设会话"] D1 -->|"通过"| D3["audit login.success
UPDATE last_login_at
set_cookie zf_saas_slug
httponly·secure·lax·SESSION_TTL"] end subgraph SG3["3 · 每请求权限链 core.py::current_user(见 §10.3 五步)"] D3 --> E0["权限链横切全部后续端点
模块门×2 层 + adminOnly×41 + brand_scope + RLS"] end subgraph SG4["4 · 开户装配 onboarding.py(一个事务)"] E0 --> F0{"POST /api/onboarding/brand
platforms WHERE status=active?"} F0 -->|"校验过"| F1["单事务四写:
tenant_brands 授权 + brands_source 管道注册
+ inv_warehouses 主仓种子 + brand_channels 渠道"] F1 --> F2["POST /api/onboarding/category
product_categories UPSERT"] F2 --> F3["POST /api/onboarding/skus
sku_mapping + products UPSERT"] F3 --> F4["后续 ingest/clean 自动带出新品牌
(brands_source.source_map 驱动, 零手工)"] end subgraph SG5["5 · 组织与计费"] F4 --> G0["POST /api/team/users 建成员
role+user_modules+user_brands 授权
改授权即 _revoke_user_sessions 撤会话"] G0 --> G1["POST /api/billing/checkout→Stripe
webhook HMAC 手工验签
completed→改 plan+billing_events
canceled/unpaid→降 trial"] end subgraph SG6["6 · 日常运营闭环(§10.4~§10.12 九模块)"] G1 --> H0["数据管道(§10.2)持续供数 → 九模块日常运营
→ 预警回环(铃铛/邮件报警)"] end subgraph SG7["7 · 品牌与租户终态 auth.py"] H0 --> I0{"品牌处置 DELETE /api/tenant/brands"} I0 -->|"archive 默认"| I1["is_active=false 归档可恢复
保底 ≥1 活跃品牌
全停自动暂停调度②C·A4"] I0 -->|"permanent 二次确认"| I2["级联清理 7 表:
cleaned_amazon_orders·sales_daily
·inventory_health·products·sku_mapping
·user_brands·tenant_brands"] I1 --> J0["成员停用: users.status=disabled
→ _revoke_user_sessions 立即下线"] I2 --> J0 end classDef guard fill:#fdeaea,stroke:#dc2626,color:#101319 classDef io fill:#eef0fe,stroke:#4f46e5,color:#101319 class A1,A2,B1,B2,C0,D1,F0,I0 guard class B3,B4,F1,F2,F3 io
#步骤入口·触发函数·端点写表·产物护栏
1注册开关探测访客 /registerGET /api/auth/registration-status registration_status无(读配置)双层:API 403 硬门 + 前端隐藏入口
2子域占用探测注册页输公司名GET /api/tenant/exists tenant_exists无占用即拒绝,slug 冲突前置拦截
3注册建租户提交注册表单POST /api/auth/register registertenants(pending_verification) + users(owner·scrypt) + tenant_brands(slug占位) + tenant_modules(默认)一次性邮箱域黑名单 · pending 查重复用 · 租户先提交再开租户连接写 RLS 表
4邮件验证点验证链接GET /api/auth/verify verify · POST /api/auth/resendUPDATE tenants→activeRedis signup:token 24h · 仅 pending_verification 可转 active
5子域签发验证通过后Caddy on-demand TLS ask证书只为 active 租户签发
6登录发会话{slug}.zipforcehub.com/loginPOST /api/auth/login loginaudit_log(login.success/failure) · UPDATE last_login_at · cookie zf_saas_{slug}status=active 且 scrypt 通过 · httponly/secure/lax · SESSION_TTL · 成功失败都审计
7每请求权限链全部 255 端点横切core.py current_user → require_module/_any → _require_adminrequest.state(身份/模块/brand_scope)五步(§10.3 拆解)· 权限实时读库改授权下一请求生效
8品牌开户装配owner /onboardingPOST /api/onboarding/brand onboarding_brandtenant_brands + brands_source + inv_warehouses('MAIN') + brand_channels(一事务)platforms active 校验 · ON CONFLICT 幂等可重放 · 后续管道自动带出
9品类与 SKU 底座/onboarding 后续步POST /api/onboarding/category·/skusproduct_categories + sku_mapping + productsON CONFLICT UPSERT 幂等
10建成员授权owner /teamPOST /api/team/users team_user_createusers + user_modules + user_brands + audit_logrole 三级 · 改授权 _revoke_user_sessions 即撤会话 · 全审计
11计费升配/billingPOST /api/billing/checkout→/billing/webhookUPDATE tenants.plan + billing_eventsHMAC 手工验签(不引 SDK) · canceled/unpaid→trial 自动降
12品牌/成员终态/account 品牌管理PUT .../activate · DELETE /api/tenant/brands/{brand} · users.status=disabledarchive: is_active=false · permanent: 级联删 7 表 · 撤会话archive 保底 1 活跃 · 全停自动暂停调度 · 二次确认才 permanent · 停用即撤会话

10.2数据管道 · 采集→同步→清洗→服务(横切流,一切读流的前提)

tasks.py 27 cron + sync_mercury.ingest_all + tools/audit_clean_all.py 逐函数实据 · 源头 mercury/venus → mars 生产库

flowchart LR
  subgraph SRC["源头层(不属本系统, 只读拉取)"]
    M1[("mercury 104.194.81.222
fg v2 / zf / noon 库")] M2[("venus 104.194.95.213
onno 源")] end subgraph COL["采集层 · mars worker cron(写源头库)"] C1["collection_cycle 时:50
Amazon 订单独占"] C2["collection_noon_orders 15min
+noon_deep/cycle_noon 6h"] C3["collection_cycle_ads 05:00
槽位含 onno zip 手动通道"] C4["collection_cycle_inventory 08:00
FBA 快照"] C5["collection_finances_deep 周日03:20
45 天深窗兜底重拉"] C6["sourcing_dispatcher_tick
宿主 crontab SSH mercury"] end subgraph ING["同步层 · ingest_mercury_daily 04:30 / weekly 六 02:00 全量 / today_incremental 每2h:43"] I0["ingest_all(full_orders, tables)"] --> I1["_refresh_dynamic_specs
brands_source.source_map 驱动
品牌分支 SQL 动态拼装"] I1 --> I2["逐表: qmercury 拉数 → _upsert
ON CONFLICT 后传胜"] I2 --> I3{"单表失败?"} I3 -->|"是"| I4["SAVEPOINT 回滚该表
错误进返回值, 不阻塞其余表"] I3 -->|"否"| I5{"全量模式对账"} I5 --> I6["orders: 键集临时表删幽灵行
sales_hourly: 60 天窗口对账"] end subgraph CLN["清洗层 · tools/audit_clean_all.run(原子换名, 表永远在线)"] K1["每表构建 cleaned_新表
全列+标记列 issues/is_valid"] --> K2["_swap 原子换名
new→正名, 旧表→old"] K2 --> K3["_grant_and_rls
ENABLE RLS+策略"] --> K4[("audit.cleaned_* 97
+ dirty_data_log 残账")] end subgraph SRV["服务层"] S1["API tenant_conn
SET app.tenant_id + brand_scope"] --> S2[("RLS 双键过滤
114 tenant_id + 82 品牌键")] S2 --> S3["web 页面/导出"] end M1 --> C1 & C2 & C3 & C4 & C5 M2 --> C3 C1 & C2 & C3 & C4 & C5 --> I0 I6 --> K1 K4 --> S1 subgraph ALM["每日报警护栏 06:15/06:20/06:30"] L1["daily_pipe_alarm 泊松断流"] L2["fee_coverage_alarm 费用覆盖
→ fee_backfill_targeted 定向回填"] L3["source_drift_check 源漂移
(advertised_sku 断供案)"] end I6 -.-> L1 & L2 & L3 classDef guard fill:#fdeaea,stroke:#dc2626,color:#101319 class I3,I5 guard
#步骤入口·触发函数·端点写表·产物护栏
1Amazon 订单采集cron 时:50 每小时collection_cyclemercury 订单库三期收编后独占(fg v2/onno 旧 cron 已停)
2Noon 采集15min 增量 + 6h 全量×2collection_noon_orders / noon_deep / cycle_noonmercury noon 域UPSERT 幂等,双品牌
3广告采集每日 05:00collection_cycle_adsmercury 广告域槽位含 onno zip 手动通道(zip 08-31 停后改应用内上传,§10.4 手动流)
4库存/财务深拉08:00 / 周日 03:20collection_cycle_inventory / collection_finances_deepmercury FBA / 财务45 天深窗覆盖结算周期 · UPSERT 键=order+sku+posted_date 零副作用
5选品分发每分钟sourcing_dispatcher_tickmercury 选品域容器无 SSH → 宿主 crontab 执行(worker 内占位)
6动态 spec 装配ingest_all 入口_refresh_dynamic_specsfinance_monthly/noon_* 动态 SQL注册表驱动:新品牌插 brands_source 一行全链路自动带出(唯一事实源)
7拉数 UPSERT04:30 日增 / 02:00 周全量 / 每2h:43 今日ingest_mercury_daily / weekly / ingest_today_incremental → ingest_allpublic 121 源表SAVEPOINT 单表失败不阻塞 · ON CONFLICT 后传胜 · /ssh/222_key 缺失显式告警跳过
8对账删除仅全量模式ingest_all 内 orders 键集临时表 / _snapshot_reconcile删幽灵行2026-09-21 修复版:本地键集对账(旧版内嵌 mercury 视图必报错)
9清洗原子换名ingest 后链式触发tools/audit_clean_all.run → _swap → _grant_and_rls → log_dirtyaudit.cleaned_* 97 + dirty_data_logRENAME 原子换名表永远在线 · ENABLE RLS+策略 · 残账进 dirty_data_log 可追溯
10三报警护栏06:15 / 06:20 / 06:30daily_pipe_alarm / fee_coverage_alarm / source_drift_check邮件报警 + fee_backfill_targeted泊松断流检测 · 费用覆盖触发定向回填 · 源表结构漂移比基线(缺列/改型=ALARM)
11辅助流00:05 / 锚日更 / 常驻daily_usage_rollup(Redis→usage_daily 计费) · daily_fx_rates(锚定三币除外) · _handle_domain_event(Redis Streams 消费者组 ②C)usage_daily / fx_rates全代码执行零 LLM

10.3基座 · 会话解析 + 权限链五步 + 工作台读流

core.py current_user 逐行拆解 · 无模块键,登录即得

flowchart TD
  R0["任意请求
cookie zf_saas_{slug}"] --> R1{"parse_token 有效?
uid+sid"} R1 -->|"否"| R9["401 not authenticated"] R1 -->|"是"| R2{"users 行存在
且 status=active?"} R2 -->|"否"| R9 R2 -->|"是"| R3["①身份: request.state.user
role 三级 owner/admin/member"] R3 --> R4["②租户模块: tenant_modules
WHERE enabled → 模块门第一层"] R4 --> R5{"员工?(非 owner/admin)"} R5 -->|"是"| R6["③员工授权: user_modules 授予集
④品牌范围: user_brands→CSV
零授权=哨兵 - (看不到任何品牌)"] R5 -->|"否"| R7["scope='' 不限"] R6 --> R8["⑤∩ tenant_brands is_active=true
停用品牌一次性全隐藏(09-22)"] R7 --> R8 R8 --> P1{"require_module(key)
端点声明哪层?"} P1 -->|"租户未开通"| P9["403 unpurchased(owner 也受限)"] P1 -->|"员工未授予"| P8["403 forbidden"] P1 -->|"通过"| P2{"函数体 _require_admin?"} P2 -->|"是且非 owner/admin"| P9 P2 -->|"通过"| P3["tenant_conn SET app.tenant_id
+ brand_scope → RLS 双键过滤 → 数据"] P3 --> W0["工作台读流: KPI 池 19 卡·81 图
/today 实时盘·BSR rankings(LIMIT 60 显式标注)
products 30 天·mapping 编辑·layout 偏好"] W0 --> W1["GET /api/notifications/summary
PO 在途 + settle_abnormal 同源铃铛"] classDef guard fill:#fdeaea,stroke:#dc2626,color:#101319 class R1,R2,R5,P1,P2 guard
#步骤入口·触发函数·端点写表·产物护栏
1会话解析每请求core.py parse_token + current_userrequest.state.sid/uidRedis sess:{sid} 可撤(改授权/停用立即生效)
2身份与状态每请求SELECT role,name,status FROM usersrequest.state.userstatus≠active → 401
3租户模块层每请求SELECT tenant_modules WHERE enabledrequest.state.tenant_modules模块门第一层:未开通 403 unpurchased
4员工双层授权member 角色user_modules + user_brandsgrants + brand_scope零授权=哨兵 - 看不到任何品牌行
5活跃品牌交集每请求∩ tenant_brands is_active最终 brand_scope停用品牌全页一次性隐藏
6adminOnly 判定41 端点_require_admin(函数体内调用)—owner/admin 三级角色制
7RLS 落库每个查询tenant_conn SET app.tenant_id219 表键型 114+82+23WITH CHECK 防跨租户写
8工作台 KPI/图表/ 首页dashboard.py 11 端点(filters/kpi/charts/today/merged-kpi/sku-sales)读聚合表KPI 卡偏好 PUT kpi-cards 按人存
9BSR 排名/rankingsrankings_list / history / markets读 rankings_dailyLIMIT 60 显式标注(✔D)
10SKU 映射编辑/mappingops.py mapping_edit_save / importsku_mapping粘贴 2000 行上限预警(✔D)· 分支守卫防串品牌
11铃铛同源全站右上角GET /api/notifications/summary读 cleaned_amazon_orders.is_abnormal + PO 在途与 /api/settlement 同源 → 重跑自动对齐(868=868/245=245 实证)

10.4ads 广告与推广 · 六源入库→规则引擎→决策执行

ads.py 41 端点 + tasks.py ads_import_pump/daily_ads_rules 逐函数实据

flowchart TD
  subgraph IN["输入 · 6 源矩阵"]
    N1["自动: Amazon Ads API ×2(zf/onno)"]
    N2["手动: 应用内上传 ×4(含 onno zip 停后通道)"]
  end
  N2 --> U1{"POST /api/ads/upload/preview
两段式第一步"} U1 -->|"解析预览"| U2{"POST /api/ads/upload
确认提交?"} U2 --> U3["校验 brand ∈ 活跃品牌
INSERT ads_imports status=pending"] N1 --> U3 U3 --> P1["ads_import_pump 每分钟
Redis 锁单实例 + SELECT FOR UPDATE SKIP LOCKED
认领一条 → status=running"] P1 --> P2["适配器按 kind 解析
文件落投递目录(与 05:00 cron 同约定)"] P2 --> P3{"成功?"} P3 -->|"是"| P4["status=done + detail"] P3 -->|"否"| P5["status=error + detail(可 recompute 重算)"] P4 --> P6["手动流定向同步(09-26):
适配器写完 mercury 后
ingest_all(tables=[广告域])+清洗
不动订单域"] P6 --> D1[("ads_sku_daily · amazon_ads_daily
noon_ads_daily · ads_keywords_daily")] D1 --> R1["daily_ads_rules 05:40
三窗口 1d/7d/30d 零 LLM 规则
→ ads_recommendations 建议"] R1 --> X0{"决策台人工执行
POST /execute"} X0 --> X1["① 校验 X-Idempotency-Key 16-128 字符"] X1 --> X2["② pg_advisory_xact_lock(hashtext(key))"] X2 --> X3{"③ ads_decision_request 重放表
同 key 同 payload?"} X3 -->|"同 hash"| X4["直接返缓存响应"] X3 -->|"异 payload"| X5["409 拒绝"] X3 -->|"新 key"| X6["④ 执行规则动作 → ⑤ ads_decision_audit 全审计
→ request COMPLETED/FAILED + 回写 recommendations"] X6 --> F1["POST /api/ads/optlog/{id}/feedback
执行反馈回流"] R1 -.->|"否词/分时/预算规则面"| NG["neg-keywords CRUD · rule-config · dayparting · keyword-bids"] subgraph PROMO["推广投稿域"] PR1["promo_tasks/channels/orders
KOL outreach + 分析"] PR2["POST /api/promotion/submission
→ submissions 列表(✔D 补审计)"] end classDef guard fill:#fdeaea,stroke:#dc2626,color:#101319 class U1,U2,X0,X3 guard
#步骤入口·触发函数·端点写表·产物护栏
1六源矩阵汇入自动 cron + 手动上传collection_cycle_ads / ads_uploadmercury 广告域自动×2 + 手动×4(onno zip 08-31 停 → 应用内通道)
2上传两段式/ads 上传页POST /api/ads/upload/preview → POST /api/ads/uploadads_imports(pending)预览→确认,防误传
3品牌校验upload 入口SELECT tenant_brands WHERE is_active—非活跃品牌拒收
4泵认领每分钟ads_import_pumpads_imports→runningRedis 锁单实例 + FOR UPDATE SKIP LOCKED 单任务(不双跑不漏跑)
5适配解析认领后按 kind 适配器mercury 广告表 + status=done/error失败 detail 落库可 recompute
6定向同步+清洗手动流(09-26)ingest_all(tables=[广告域]) → audit_clean_allpublic/audit 广告表只动广告域,订单/毛利回填等全量副作用跳过
7日表入库同步后_upsert ON CONFLICTads_sku_daily 等 4 日表后传胜,按日+国整体替换
8规则引擎生建议每日 05:40daily_ads_rulesads_recommendations三窗口 1d/7d/30d · 零 LLM 纯代码规则
9决策执行幂等五件套决策台点执行POST /api/ads/recommendations/{rid}/execute ads_recommendation_executeads_decision_request + ads_decision_audit + recommendations 回写Key 校验 16-128 → advisory_xact_lock → 重放表同 hash 返缓存/异 payload 409 → 执行 → 审计
10反馈回流执行后POST /api/ads/optlog/{log_id}/feedbackads_optimization_log闭环:建议→执行→效果→下一轮规则
11规则配置面/ads 配置页neg-keywords CRUD / rule-config / dayparting / keyword-bidsneg_keywords · ads_rule_configrule_config 全局行 brand='' 放行(RLS 特例)
12推广投稿/promotionpromo_tasks/orders/kol/submission 16 端点promotion_* 9 表投稿审计(✔D 补)· 订单 approve 流

10.5orders 订单 · 三分支合并→五态浏览→回款统一口径

ops.py orders_list + finance.py settlement_tracker + A 批统一口径实据

flowchart LR
  subgraph IN["采集增量"]
    A1["时:50 Amazon 订单"] --> A2["每2h:43 今日增量
(今日订单+小时销量)"] end A2 --> B1["ingest 三分支 UNION 42 列
zf / fg / onno 品牌分支"] B1 --> B2[("public.amazon_orders
品牌键 RLS")] B2 --> C1["清洗: 北京时区日切(✔D)
取消单双拼写对齐(✔D)"] C1 --> C2[("audit.cleaned_amazon_orders
is_abnormal 回款标志")] C2 --> D1{"GET /api/orders
五态 tab"} D1 --> D2["全部/未发货/已发货
/Pending/取消(取消显式「—」)"] D2 --> D3["搜索·国家·品牌筛选·导出"] C2 --> E1["GET /api/settlement 回款跟踪
统一口径: days=now−coalesce(发货日,下单日)
且一律要求未回款(✔A)"] E1 --> E2{"异常判定
days>14 且未回款?"} E2 -->|"是"| E3["abnormal 计数
zf 868 / onno 245(实测)"] E2 -->|"否"| E4["待回款/已回款分桶
onno 回款=订单金额入账推导"] E3 --> F1["铃铛同源(§10.3 步 11)"] classDef guard fill:#fdeaea,stroke:#dc2626,color:#101319 class D1,E2 guard
#步骤入口·触发函数·端点写表·产物护栏
1采集与增量时:50 + 每 2hcollection_cycle / ingest_today_incrementalmercury→public.amazon_ordersUPSERT 幂等
2三分支合并ingest_all订单 spec UNION zf/fg/onno 42 列amazon_orders品牌分支由注册表驱动
3清洗日切ingest 后audit_clean_all 订单清洗cleaned_amazon_orders北京时区日切(✔D P3-2)· 取消双拼写对齐(✔D P3-1)
4五态浏览/ordersGET /api/orders orders_list读 cleaned取消单显式「—」不显 0(✔D)· 时间窗可调
5筛选导出/ordersorders_list 参数导出文件与列表同参
6回款统一口径/settlementGET /api/settlement settlement_tracker读 is_abnormal/is_settled三分支一字不差同口径(✔A):days=now−coalesce(发货日,下单日)·一律未回款
7onno 回款推导同上金额入账 COALESCE 链—回款信号=订单金额入账推导(无独立回款字段)
8异常分桶同上is_abnormal 重算zf 868/onno 245(A 批实测)已回款 430 全非异常·取消 44 清零(=审计预测一字不差)
9铃铛同源全站notifications_summary—与 settlement 同源读 → 全量重跑自动对齐(868=868/245=245)

10.6finance 财务 · 动态 spec 源表直读→口径注册表裁决

sync_mercury 动态分支 + finance.py 12 端点 + metric_calibers 口径注册表

flowchart TD
  subgraph SRC["源表构建(ingest 时动态拼装)"]
    S1["_refresh_dynamic_specs:
finance_monthly = 各品牌分支 UNION
(finances_view 或 schema 分支)"] S2["noon 域: noon_monthly·noon_sku_pl
·noon_statement·noon_procurement_cost
(嵌在 amazon 行的 zf noon + 独立 onno 行)"] S1 --> S3[("public.finance_monthly · noon_* 品牌键 RLS")] S2 --> S3 end S3 --> C1[("audit.cleaned_finance_monthly
cleaned_monthly_pl 等")] C1 --> R1{"finance.py 12 端点
源表直读(非二次加工)"} R1 --> R2["summary/sku-profit/monthly/profit-matrix
kpi-wall/full/onno/noon-sku/noon-pnl/product-pl"] R1 --> R3["GET /api/settlement 回款(§10.5)"] R2 --> V1["口径裁决: metric_calibers 10 行
authoritative_source/fallback_source
成本权威=sku_mapping"] V1 --> V2{"cost 对账门(✔D)
sku_mapping 与 cleaned 副本双有值?"} V2 -->|"不等"| V3["FAIL 当天门拦截(X2 型单边改价)"] V2 -->|"权威缺失"| V4["WARN 欠账提示(5 产品挂账)"] V2 -->|"相等"| V5["放行"] R2 --> FX["daily_fx_rates 日更
锚定 SAR 3.75 / AED 3.6725 锚定除外
本币+USD 双列"] classDef guard fill:#fdeaea,stroke:#dc2626,color:#101319 class R1,V2 guard
#步骤入口·触发函数·端点写表·产物护栏
1动态分支拼装ingest_all 入口_refresh_dynamic_specsfinance_monthly/noon_* 动态 SQLbrands_source.source_map 驱动——onno 漏数根因修复(09-18)
2源表入库04:30/周日深拉ingest + collection_finances_deep 45 天finance_monthly + noon 4 表UPSERT 键=order+sku+posted_date
3清洗ingest 后audit_clean_allcleaned_finance_monthly/monthly_pl 等原子换名+RLS
4源表直读 12 端点/finance /noon /settlementfinance_summary/sku/monthly/matrix/kpi_wall/full/onno/noon_sku/noon_pnl/product_pl/settlement读 cleaned 源表7 接口源表直读口径写死(09-18 改造,monthly 保留对账口径)
5口径注册表裁决读数时metric_calibers 10 行—authoritative/fallback 双源写死·拍板日留痕(唯一事实源)
6成本权威链ingest 全量尾部UPDATE products SET cost FROM sku_mappingproducts.cost 兜底回填权威=sku_mapping,products 只是镜像
7cost 对账门dashboard_audit 每跑双有值必相等断言—不等=FAIL 拦截;权威缺失=WARN 欠账(S-988 Pro 等 5 产品挂账)
8汇率日更每日daily_fx_rates + _FX_PEGfx_rates锚定三币除外(SAR/AED 固定锚)
9本币双列全部财务页_noon_usd 折算—本币+USD 双列呈现(09-18 框架)
10回款跟踪/settlementsettlement_tracker(§10.5 步 6~8)—统一口径+铃铛同源

10.7inventory 进销存 · FBA 快照→预警→PO 状态机→GRN 台账

inventory_po.py + inv.py 25 端点逐函数实据

flowchart TD
  A1["collection_cycle_inventory 08:00"] --> A2["ingest FBA 快照"] --> A3[("inventory_health
品牌键 RLS")] A3 --> B1{"GET /api/inventory/health
国家 chips"} B1 --> B2["chips 双数(✔C): 在库 SKU 数 / 在管行数
两数并列(不推翻 09-22 拍板)"] A3 --> C1{"GET /api/inventory/alert
覆盖线判定"} C1 --> C2["35/90 天覆盖线预警
汇总吃国家(✔D)·PO 在途带市场维(✔D)"] C2 --> D1["POST /api/po/create
draft + items + total_cost_rmb
(prefill 预警联动)"] D1 --> E1["POST /api/po/{pid}/status
draft→submitted→confirmed→in_transit"] E1 --> F1{"POST /api/po/{pid}/receive
po_receive"} F1 --> F2["qty_received=least(到货, 订购)
全部到齐→received 否则 in_transit"] F2 --> G1["收货自动建 GRN 单据
POST /api/inv/docs"] G1 --> H1{"POST /api/inv/docs/{did}/approve
过账"} H1 --> I1[("inv_stock_ledger 台账
移动加权·红冲可逆·盘点 stocktake")] I1 --> J1[("inv_stock_balance 余额
inv_doc_heads/items 单据")] A3 --> K1["GET /api/inventory 导出
动态翻页(✔B) t3 实测 8809 行全量"] subgraph FBN["FBN noon 域"] N1[("noon_inventory 品牌键
/api/noon-inventory")] end classDef guard fill:#fdeaea,stroke:#dc2626,color:#101319 class B1,C1,F1,H1 guard
#步骤入口·触发函数·端点写表·产物护栏
1FBA 快照采集每日 08:00collection_cycle_inventorymercury 库存域UPSERT 幂等
2入库清洗04:30 ingestingest_all → audit_clean_allinventory_health(品牌键)RLS 品牌键+brand_scope
3健康页 chips/inventoryGET /api/inventory/health inventory_health读聚合双数口径:主数=在库 SKU·/后=在管行数(✔C,33/259·US 4/21 实测)
4补货预警/inventory 预警区GET /api/inventory/alert inventory_alert预警清单35/90 天覆盖线 · 汇总与明细同参吃国家(✔D P3-6)
5下 PO/poPOST /api/po/create po_createpurchase_orders(draft)+items+totalpo_no 服务端生成 hex(8)
6PO 状态机/po 操作POST /api/po/{pid}/status po_statusstatus 流转draft→submitted→confirmed→in_transit→received 线性状态机
7收货/po 收货POST /api/po/{pid}/receive po_receiveqty_received=least(...)·状态least 防超收 · 部分到货留 in_transit
8GRN 单据收货联动POST /api/inv/docs inv_doc_createinv_doc_heads/items单据类型 GRN
9过账审批/inventory 台账POST /api/inv/docs/{did}/approve / cancelinv_stock_ledger 流水approve 才过账 · cancel 红冲可逆
10台账三能力/inventoryinv_ledger / inv_stock / inv_stocktake_planledger+balance移动加权 · 红冲 · 盘点三件套
11导出全量/inventory 导出inv_report 动态翻页导出文件动态翻页不截断(✔B:原丢 43%,t3 8809 行实测全量)
12FBN noon 库存/noonGET /api/noon-inventorynoon_inventory品牌键 RLS

10.8logistics 物流 · 船票导入→轨迹徽章→两步下单

logistics.py 8 端点 + B 批两步校验/幂等锁实据

flowchart TD
  subgraph IMP["船票导入"]
    A1{"POST /api/logistics/shipments/import
上传船票文件"} A1 --> A2["列名映射解析
ON CONFLICT (brand, awb) UPSERT"] A2 --> A3[("logistics_shipments
品牌键 RLS")] A3 --> A4["重复上传幂等(同键更新)"] end A3 --> B1["GET /api/logistics/shipments 列表
+ 轨迹事件流"] B1 --> B2["徽章五态:
TRANSIT/DELIVERED/EXCEPTION
/CUSTOMS/AWAITING"] B2 --> C1["KPI 实时聚合自 shipments 明细(✔B)
(旧 logistics_stats 快照 09-05 退役)"] A3 --> D1["GET /api/logistics/pricing 燕文报价
2026-08-08 版·as-of 截至显式(✔D)"] subgraph VNL["Vnlin 两步下单 B2B(✔B)"] E0{"POST /api/logistics/create
logistics_create"} E0 --> E1["指纹=完整下单体(含解析后地址)
Redis SET NX 10 分钟锁"] E1 --> E2{"第一步 r1: POST OMS
/doubleClearance/create"} E2 -->|"status 缺 orderId"| E9["502 显式报错(不下箱单)"] E2 -->|"成功+orderId"| E3{"第二步 r2: POST OMS
/doubleClearance/packageBox"} E3 -->|"box_ok"| E4["返回运单号·落库"] E3 -->|"失败"| E5["502 显式失败带单号(✔B)"] end E1 -.->|"同指纹 10 分钟内"| E6["防双击: 两笔真实运单绝不允许"] classDef guard fill:#fdeaea,stroke:#dc2626,color:#101319 class A1,E0,E2,E3 guard
#步骤入口·触发函数·端点写表·产物护栏
1船票导入/logistics 导入POST /api/logistics/shipments/import logistics_shipments_importlogistics_shipments列名映射 + ON CONFLICT (brand,awb) UPSERT——重复上传幂等
2列表与轨迹/logisticsGET /api/logistics/shipments读明细品牌键 RLS
3徽章五态列表渲染前端按轨迹推导—TRANSIT/DELIVERED/EXCEPTION/CUSTOMS/AWAITING
4KPI 实时聚合/logistics KPI 区列表端点内聚合读 shipments 明细实时聚合自明细(✔B P2-3),快照停更退役——t2/t3 不再空
5报价查询下单前GET /api/logistics/pricing + appendix读报价表2026-08-08 版·截至时间显式标注(✔D)
6参数配置/logistics 设置params get/savelogistics_paramstenant_id RLS
7两步下单·指纹锁/logistics 下单POST /api/logistics/create logistics_create 第 1 段Redis 指纹键完整下单体指纹 SET NX 10 分钟——同参双击直接拦(✔B P2-4)
8第一步 B2B锁通过后httpx POST /doubleClearance/createorderId校验 status=true 且 orderId 存在,缺即 502 不进第二步
9第二步箱单第一步成功httpx POST /doubleClearance/packageBox运单+箱单box_ok 校验,失败显式 502 带单号(✔B——旧版假成功已修)

10.9sourcing 选品情报 · ABA 词库→候选池→verdict 决策

verdicts.py + sourcing.py 18 端点逐函数实据

flowchart LR
  A1[("ABA 词库 9 表
aba_* · radar ×6")] --> B0{"POST /api/sourcing/verdicts/materialize
verdicts_materialize"} B0 --> B1["Redis 锁 10 分钟冷却
(429 带 TTL·force 需 owner/admin)"] B1 --> C1["candidates 两级物化:
radar 高分 + term 词级
ON CONFLICT 幂等"] C1 --> D1[("sourcing_candidates
sourcing_verdicts(machine_rec)")] D1 --> E1["keepa_watch 播种
ON CONFLICT DO NOTHING"] E1 --> F1["refresh_keepa_watch 05:10
watch 池刷新采集"] F1 --> G1[("keepa_daily
watch_isolation RLS:
EXISTS 同租户同 ASIN")] G1 --> H1["查询面: search/product/explorer
aba overview/chart/ledger/radar
keepa-history/watchlist"] D1 --> I0{"POST /api/sourcing/verdicts/decision
verdicts_decision"} I0 --> I1["SELECT ... FOR UPDATE 锁行"] I1 --> I2["UPDATE state(进/杀/候补)
owner_uid·kill_reason"] I2 --> I3[("sourcing_decision_audit
from/to/actor/evidence 全审计")] I3 --> J1["通过候选 → 转入 listing(§10.10)
/ products 域"] H1 -.-> K1["AI 辅助: POST /api/ai/sourcing
require_module_any(sourcing,ai)·只建议"] classDef guard fill:#fdeaea,stroke:#dc2626,color:#101319 class B0,I0 guard
#步骤入口·触发函数·端点写表·产物护栏
1ABA 词库供给aba_snapshot cron采集→ingest→cleanaba_* 9 表(tenant 键)RLS tenant_id
2候选物化限频手动触发POST /api/sourcing/verdicts/materialize verdicts_materializesourcing_candidates 两级全表扫描重 → Redis 锁 10 分钟冷却 429 带 TTL;force 跳过需 owner/admin
3verdict 初判物化内同上sourcing_verdicts(machine_rec)机器只出建议,state 由人改
4keepa 播种物化内同上keepa_watchON CONFLICT DO NOTHING 幂等
5watch 刷新每日 05:10refresh_keepa_watchkeepa_daily + keepa_pull_logtoken 消耗落 pull_log 可审计
6watch 隔离读 keepa_dailyRLS watch_isolation—EXISTS 同租户同 ASIN 同 domain——租户只看自己 watch 池价格
7查询面/sourcingsearch/product/explorer/explore/aba 4 端点/radar/keepa-history/watchlist读各表require_module(sourcing)
8人工决策决策台POST /api/sourcing/verdicts/decision verdicts_decisionUPDATE verdicts + decision_auditFOR UPDATE 行锁防并发双改 · from/to/actor/evidence 全审计
9决策审计回看审计页pareto/candidates/legacy 查询读 audit 表决策可回溯(谁在何时凭何证据)
10AI 只建议/ai 联动POST /api/ai/sourcing无业务表写入require_module_any(sourcing,ai) 开源流(F3-6)· LLM 不决策铁律

10.10listing Listing 工作台 · 规格→生成→人工审→SP-API 提交→事件回放

listing.py 23 端点全门控逐函数实据

flowchart TD
  A1["POST /api/listing/specs
upload_spec 规格上传
(或 models/spec 按型号)"] --> A2["GET skus-by-model
型号聚合取 SKU"] A2 --> B1["POST /api/listing/tasks
create_task → draft"] B1 --> C1{"POST /{tid}/generate
规则引擎生成文案
仅 draft/failed 可生成"} C1 -->|"ready 状态"| C9["409 请先撤回"] C1 -->|"生成"| C2["title/bullets/description/attrs
写入 task"] C2 --> D1["PUT /{tid} edit_task 人工改稿"] D1 --> E1{"POST /{tid}/approve
人工审批(仅 draft→ready)"} E1 -->|"非 draft"| E9["409 拒绝"] E1 -->|"批准"| E2["status=ready
approved_by+approved_at 留痕"] E2 --> F1{"POST /{tid}/submit
仅 ready 可提交"} F1 -->|"其他状态"| F9["409 不可提交"] F1 -->|"提交"| F2["SP-API 推送 Amazon"] F2 --> G1["POST /import_results 回填结果"] G1 --> H1[("listing_events 全事件审计
tasks 状态推进")] B1 -.->|"撤回"| I1["POST /{tid}/revert ready→draft"] subgraph PT["PTEX 市场域"] P1["pt-search/pt-schema/pt-markets 查询"] P2{"POST /{tid}/bind_pt 绑定
仅 draft/failed"} P2 --> P3[("listing_category_meta
brand+market+product_type")] end J1["batch 批量 + health 健康检查
+ export 导出"] classDef guard fill:#fdeaea,stroke:#dc2626,color:#101319 class C1,E1,F1,P2 guard
#步骤入口·触发函数·端点写表·产物护栏
1规格上传/listings 规格页POST /api/listing/specs upload_spec / upload_spec_modellisting_specs(品牌键)ON CONFLICT 幂等
2建任务选型号POST /api/listing/tasks create_tasklisting_tasks(draft)23/23 端点全门控 require_module(listing)
3规则引擎生成任务页生成POST /{tid}/generate generatetitle/bullets/desc/attrs仅 draft/failed(ready 先撤回 409)· 规则引擎非 LLM
4人工改稿编辑器PUT /{tid} edit_tasktask 内容留 updated_at
5撤回需返工POST /{tid}/revertready→draft可逆流转
6人工审批审批按钮POST /{tid}/approve approvestatus=ready + approved_by/at仅 draft 可批(409)· 提交前人工审批强制——AI/规则不代发
7SP-API 提交提交按钮POST /{tid}/submit submit_taskAmazon listing仅 ready(409)——状态机硬门
8结果回填提交后POST /import-results import_resultstasks 状态推进事件全审计
9事件回放任务详情GET /api/listing/events list_eventslisting_events每步留痕可追溯
10PT 市场绑定PT 页POST /{tid}/bind-pt bind_pt + pt-search/schema/marketslisting_category_meta仅 draft/failed 可绑 · (brand,market,product_type) 唯一 UPSERT
11批量与体检工具区batch_tasks / listing_health / export—同门控

10.11collab 文档协作 · PM 项目→文档树→上传两段→运维面板

projects.py + collab.py 26 端点逐函数实据

flowchart TD
  subgraph PM["PM 项目域 /projects"]
    A1["POST /api/pm/products CRUD
pm_products_create/update/delete"] A1 --> A2["POST /{pid}/tasks 任务 CRUD
pm_tasks_create/update/delete"] A2 --> A3["POST /{pid}/chain 链路视图"] A3 --> A4["GET /api/pm/export · POST import
导出导入闭环"] end subgraph DOC["文档域 /documents /training"] B1["GET /api/documents/tree
documents_tree 节点树"] B1 --> B2[("documents_nodes
协作编辑")] B2 --> B3["培训材料 /training"] end subgraph UPL["上传域 /upload 两段式"] C1{"POST /api/upload
upload_file"} C1 -->|"第一步"| C2["预览: 解析+暂存"] C2 -->|"第二步确认"| C3[("upload_files")] C3 --> C4["GET files 列表 / raw 原文 / DELETE"] end subgraph OPS["运维面板 /pipeline /database"] D1["GET /api/pipeline/status+audit
管道状态与审计"] D1 --> D2{"POST /api/pipeline/run/{func}
手动触发管道任务"} D2 --> D3["GET /api/db/tables → table/rows
数据浏览器"] D3 --> D4["敏感表黑名单 11 张(✔D 刷新)
凭证/计费身份全拦"] end E1["GET /api/dictionary + /glossary
数据字典·术语表"] classDef guard fill:#fdeaea,stroke:#dc2626,color:#101319 class C1,D2 guard
#步骤入口·触发函数·端点写表·产物护栏
1PM 产品 CRUD/projects/api/pm/products 5 端点pm_productstenant_id RLS
2任务挂产品产品详情POST /{pid}/tasks + update/deletepm_tasks产品-任务两级归属
3链路与导入导出链路页pm_chain / pm_export / pm_import读/写 pm 表导入幂等
4文档树协作/documentsGET /api/documents/treedocuments_nodes节点树结构·tenant RLS
5上传两段式/uploadPOST /api/upload upload_fileupload_files预览→确认两段(与 ads 上传同设计)
6文件管理/upload 列表files 列表 / raw / DELETEupload_files租户隔离
7管道运维/pipelinestatus / audit / POST run/{func}触发 §10.2 任务adminOnly 手动触发留审计
8数据浏览器/databasedb_tables / table/{t} / rows读任意非黑名单表敏感表黑名单 11 张(✔D P3-15:凭证/计费/身份全拦)
9字典术语/dictionarydata_dictionary / glossary读快照tools/gen_data_dictionary 生成
10飞书集成/feishu飞书侧配置—协作外链

10.12ai AI 助手 · 纯咨询六端点(零写入铁律)

ai.py 6 端点逐函数实据

flowchart LR
  A0{"六端点统一入口
require_module(ai) 或 any"} A0 --> A1["POST /ask 通用咨询
POST /insight 数据洞察
POST /adcopy 文案
POST /sourcing 选品建议(any 开源流)
POST /ads-optimize 广告优化建议
POST /page-chat 页面级对话"] A1 --> B1{"Redis 租户日配额
PLAN_AI_QUOTA
trial10/starter50
growth200/enterprise500"} B1 -->|"超限"| B9["429 显式限额"] B1 -->|"额度内"| C1{"LLM 已配置?"} C1 -->|"未配置"| C9["503 显式「未配置」不显 0"] C1 -->|"已配置"| D1["llm_chat 调用
纯文本返回"] D1 --> E1["零业务表写入(铁律)
不进任何工作流决策
决策全在 §10.4/§10.9 由规则+人完成"] classDef guard fill:#fdeaea,stroke:#dc2626,color:#101319 class A0,B1,C1 guard
#步骤入口·触发函数·端点写表·产物护栏
1模块门每端点require_module(ai) / require_module_any(sourcing,ai)—租户未开通 403 unpurchased
2六端点分流/ai 页ask / insight / adcopy / sourcing / ads-optimize / page-chat—纯咨询语义,无写动作
3租户日配额每调用Redis 计数 × PLAN_AI_QUOTARedis 键trial 10/starter 50/growth 200/enterprise 500,超限 429 显式
4未配置兜底LLM 缺配置503—显式「未配置」不显误导性 0(铁律)
5纯文本返回调用成功llm_chat无业务表写入零写入铁律:LLM 不进工作流,全代码执行
6用量落账00:05 日终daily_usage_rollupusage_daily计费与限额依据(§10.2 步 11)
7配额升配/billingplan 变更(§10.1 步 11)tenants.planwebhook 验签后生效

11附录 · 最细颗粒度全清单(端点 255 · 页面 39 · 表 220 · 定时 28 · 注册表群)

AST + 活库普查(2026-09-26 · tools 生成非手工誊写,可复跑对源)· 附录 A~E 每行可点验

口径说明(不许猜,全部活体实据):① 表数以活库为准 public 121 + audit 98(cleaned_* 97 + dirty_data_log)= 219;审计时点曾记 129/99,差 8+1 未归因(今日 pg-init 无 DROP 语句,以活库为准)。② RLS 键型逐表实证:114 张 tenant_id 键 + 82 张品牌键(brand ∈ 租户活跃品牌 ∩ brand_scope,子查询内含 tenant_id)+ 23 张无策略(全局参考表及其镜像)——§5「orders/logistics 走品牌键」实证成立(amazon_orders / logistics_shipments / noon_orders / sku_mapping 全为品牌键)。③ 特例:keepa_daily=watch_isolation(EXISTS keepa_watch 同租户同 ASIN,键为 tenant_id 经 watch 池推导);cleaned_keepa_daily 镜像无策略且 0 端点引用(api/tools grep 实证,与 D 批 P3-5 死镜像同类)。④ 勘误:本图 §1/§7 原列「/reports 基座页」——实查 web/app 无此路由(39 页 find 验证),报表引擎实为 5 页挂载卡片(工作台/财务/广告/库存/订单尾卡),本轮已同步修正。
附录 A · API 端点全清单 255 条 (201 会话/模块门控 + 41 adminOnly + 13 无会话 · 27 router · 按文件分组)
#方法路径门模块鉴权机制router 文件
ads.py · 41 端点(36 会话/模块门控 + 5 adminOnly)
1GET/api/ads/campaigns会话/模块门控adsrequire_module(ads)ads.py
2GET/api/ads/analysis会话/模块门控adsrequire_module(ads)ads.py
3GET/api/ads/optlog会话/模块门控adsrequire_module(ads)ads.py
4POST/api/ads/optlog/{log_id}/feedback会话/模块门控adsrequire_module(ads)ads.py
5GET/api/promotion/channels会话/模块门控adsrequire_module(ads)ads.py
6GET/api/promotion/summary会话/模块门控adsrequire_module(ads)ads.py
7GET/api/ads/platform会话/模块门控adsrequire_module(ads)ads.py
8GET/api/ads/charts会话/模块门控adsrequire_module(ads)ads.py
9GET/api/ads/search-terms会话/模块门控adsrequire_module(ads)ads.py
10GET/api/ads/keyword-bids会话/模块门控adsrequire_module(ads)ads.py
11GET/api/ads/dayparting会话/模块门控adsrequire_module(ads)ads.py
12GET/api/ads/recommendations会话/模块门控adsrequire_module(ads)ads.py
13POST/api/ads/recommendations/{rid}/decision会话/模块门控adsrequire_module(ads)ads.py
14GET/api/ads/neg-keywords会话/模块门控adsrequire_module(ads)ads.py
15POST/api/ads/neg-keywords会话/模块门控adsrequire_module(ads)ads.py
16PATCH/api/ads/neg-keywords/{nid}会话/模块门控adsrequire_module(ads)ads.py
17DELETE/api/ads/neg-keywords/{nid}会话/模块门控adsrequire_module(ads)ads.py
18POST/api/ads/recommendations/runadminOnly—_require_admin(函数体)ads.py
19GET/api/ads/rule-config会话/模块门控adsrequire_module(ads)ads.py
20POST/api/ads/rule-configadminOnly—_require_admin(函数体)ads.py
21DELETE/api/ads/rule-config/{key}adminOnly—_require_admin(函数体)ads.py
22POST/api/ads/recommendations/{rid}/executeadminOnly—_require_admin(函数体)ads.py
23GET/api/promotion/tasks会话/模块门控adsrequire_module(ads)ads.py
24POST/api/promotion/tasks会话/模块门控adsrequire_module(ads)ads.py
25POST/api/promotion/tasks/{tid}/status会话/模块门控adsrequire_module(ads)ads.py
26DELETE/api/promotion/tasks/{tid}会话/模块门控adsrequire_module(ads)ads.py
27POST/api/promotion/channels/{cid}/status会话/模块门控adsrequire_module(ads)ads.py
28GET/api/promotion/orders会话/模块门控adsrequire_module(ads)ads.py
29POST/api/promotion/orders会话/模块门控adsrequire_module(ads)ads.py
30POST/api/promotion/orders/{oid}/approveadminOnly—_require_admin(函数体)ads.py
31POST/api/promotion/kol/{kind}/{kid}/outreach会话/模块门控adsrequire_module(ads)ads.py
32GET/api/promotion/kol会话/模块门控adsrequire_module(ads)ads.py
33GET/api/promotion/kol-analysis会话/模块门控adsrequire_module(ads)ads.py
34POST/api/promotion/submission会话/模块门控adsrequire_module(ads)ads.py
35GET/api/promotion/submissions会话/模块门控adsrequire_module(ads)ads.py
36POST/api/ads/upload/preview会话/模块门控adsrequire_module(ads)ads.py
37POST/api/ads/upload会话/模块门控adsrequire_module(ads)ads.py
38GET/api/ads/imports会话/模块门控adsrequire_module(ads)ads.py
39POST/api/ads/imports/recompute会话/模块门控adsrequire_module(ads)ads.py
40GET/api/ads/sources会话/模块门控adsrequire_module(ads)ads.py
41POST/api/ads/reattribute会话/模块门控adsrequire_module(ads)ads.py
ai.py · 6 端点(6 会话/模块门控)
42POST/api/ai/ask会话/模块门控airequire_module(ai)ai.py
43POST/api/ai/insight会话/模块门控airequire_module(ai)ai.py
44POST/api/ai/adcopy会话/模块门控airequire_module(ai)ai.py
45POST/api/ai/sourcing会话/模块门控ai+sourcingrequire_module(ai+sourcing)ai.py
46POST/api/ai/ads-optimize会话/模块门控airequire_module(ai)ai.py
47POST/api/ai/page-chat会话/模块门控airequire_module(ai)ai.py
aplus.py · 8 端点(8 会话/模块门控)
48GET/api/aplus/meta会话/模块门控基座current_user 会话aplus.py
49GET/api/aplus/media会话/模块门控基座current_user 会话aplus.py
50POST/api/aplus/media会话/模块门控基座current_user 会话aplus.py
51DELETE/api/aplus/media/{mid}会话/模块门控基座current_user 会话aplus.py
52POST/api/aplus/draft会话/模块门控基座current_user 会话aplus.py
53DELETE/api/aplus/docs/{did}会话/模块门控基座current_user 会话aplus.py
54GET/api/aplus/documents会话/模块门控基座current_user 会话aplus.py
55GET/api/aplus/history会话/模块门控基座current_user 会话aplus.py
auth.py · 16 端点(6 会话/模块门控 + 5 adminOnly + 5 无会话)
56GET/api/tenant/exists无会话无自带鉴权/设计公开auth.py
57POST/api/auth/login会话/模块门控基座auth 会话建立/注销auth.py
58POST/api/auth/logout会话/模块门控基座auth 会话建立/注销auth.py
59GET/api/auth/sessions会话/模块门控基座current_user 会话auth.py
60POST/api/auth/logout-all会话/模块门控基座current_user 会话auth.py
61GET/api/auth/registration-status无会话无自带鉴权/设计公开auth.py
62POST/api/auth/register无会话无自带鉴权/设计公开auth.py
63GET/api/auth/verify无会话无自带鉴权/设计公开auth.py
64POST/api/auth/resend无会话无自带鉴权/设计公开auth.py
65GET/api/tenant/info会话/模块门控基座current_user 会话auth.py
66GET/api/tenant/brandsadminOnly—_require_admin(函数体)auth.py
67POST/api/tenant/brandsadminOnly—_require_admin(函数体)auth.py
68DELETE/api/tenant/brands/{brand}adminOnly—_require_admin(函数体)auth.py
69PUT/api/tenant/brands/{brand}/activateadminOnly—_require_admin(函数体)auth.py
70GET/api/tenant/jobsadminOnly—_require_admin(函数体)auth.py
71POST/api/auth/password会话/模块门控基座current_user 会话auth.py
billing.py · 6 端点(3 会话/模块门控 + 1 adminOnly + 2 无会话)
72GET/api/billing/plans无会话无自带鉴权/设计公开billing.py
73GET/api/billing/status会话/模块门控基座current_user 会话billing.py
74GET/api/billing/modules会话/模块门控基座current_user 会话billing.py
75POST/api/billing/modules/toggleadminOnly—_require_admin(函数体)billing.py
76POST/api/billing/checkout会话/模块门控基座current_user 会话billing.py
77POST/api/billing/webhook无会话无自带鉴权/设计公开billing.py
brandboard.py · 5 端点(5 会话/模块门控)
78GET/api/brandboard/orders会话/模块门控基座current_user 会话brandboard.py
79GET/api/brandboard/country-sku会话/模块门控基座current_user 会话brandboard.py
80GET/api/brandboard/noon会话/模块门控基座current_user 会话brandboard.py
81GET/api/noon-inventory会话/模块门控基座current_user 会话brandboard.py
82GET/api/brandboard/product-drill会话/模块门控基座current_user 会话brandboard.py
collab.py · 15 端点(11 会话/模块门控 + 4 adminOnly)
83GET/api/mapping/skus会话/模块门控基座current_user 会话collab.py
84GET/api/documents/tree会话/模块门控collabrequire_module(collab)collab.py
85GET/api/mapping/api-fields会话/模块门控基座current_user 会话collab.py
86POST/api/upload会话/模块门控collabrequire_module(collab)collab.py
87GET/api/upload/files会话/模块门控collabrequire_module(collab)collab.py
88DELETE/api/upload/files/{fid}会话/模块门控collabrequire_module(collab)collab.py
89GET/api/pipeline/status会话/模块门控基座current_user 会话collab.py
90GET/api/pipeline/audit会话/模块门控基座current_user 会话collab.py
91POST/api/pipeline/run/{func_name}adminOnly—_require_admin(函数体)collab.py
92GET/api/db/tablesadminOnly—_require_admin(函数体)collab.py
93GET/api/db/table/{table_name}adminOnly—_require_admin(函数体)collab.py
94GET/api/db/table/{table_name}/rowsadminOnly—_require_admin(函数体)collab.py
95GET/api/collab/files/{fid}/raw会话/模块门控collabrequire_module(collab)collab.py
96GET/api/dictionary会话/模块门控基座current_user 会话collab.py
97GET/api/glossary会话/模块门控基座current_user 会话collab.py
dashboard.py · 11 端点(11 会话/模块门控)
98GET/api/dashboard/filters会话/模块门控基座current_user 会话dashboard.py
99GET/api/dashboard/kpi会话/模块门控基座current_user 会话dashboard.py
100GET/api/dashboard/kpi-cards会话/模块门控基座current_user 会话dashboard.py
101PUT/api/dashboard/kpi-cards会话/模块门控基座current_user 会话dashboard.py
102GET/api/dashboard/charts会话/模块门控基座current_user 会话dashboard.py
103GET/api/today会话/模块门控基座current_user 会话dashboard.py
104GET/api/rankings/markets会话/模块门控基座current_user 会话dashboard.py
105GET/api/rankings会话/模块门控基座current_user 会话dashboard.py
106GET/api/rankings/history会话/模块门控基座current_user 会话dashboard.py
107GET/api/dashboard/merged-kpi会话/模块门控ordersrequire_module(orders)dashboard.py
108GET/api/dashboard/sku-sales会话/模块门控基座current_user 会话dashboard.py
finance.py · 12 端点(12 会话/模块门控)
109GET/api/finance/summary会话/模块门控financerequire_module(finance)finance.py
110GET/api/finance/sku-profit会话/模块门控financerequire_module(finance)finance.py
111GET/api/settlement会话/模块门控financerequire_module(finance)finance.py
112GET/api/noon/summary会话/模块门控financerequire_module(finance)finance.py
113GET/api/finance/kpi-wall会话/模块门控financerequire_module(finance)finance.py
114GET/api/finance/full会话/模块门控financerequire_module(finance)finance.py
115GET/api/finance/product-pl会话/模块门控financerequire_module(finance)finance.py
116GET/api/finance/noon-sku会话/模块门控financerequire_module(finance)finance.py
117GET/api/finance/monthly会话/模块门控financerequire_module(finance)finance.py
118GET/api/finance/profit-matrix会话/模块门控financerequire_module(finance)finance.py
119GET/api/finance/onno会话/模块门控financerequire_module(finance)finance.py
120GET/api/finance/noon-pnl会话/模块门控financerequire_module(finance)finance.py
internal.py · 5 端点(5 无会话)
121GET/internal/api/v1/order/sku-aggregate无会话无自带鉴权/设计公开internal.py
122GET/internal/api/v1/order/status无会话无自带鉴权/设计公开internal.py
123GET/internal/api/v1/ads/spend无会话无自带鉴权/设计公开internal.py
124GET/internal/api/v1/finance/monthly无会话无自带鉴权/设计公开internal.py
125GET/internal/api/v1/shared/fx-rate无会话无自带鉴权/设计公开internal.py
inv.py · 13 端点(13 会话/模块门控)
126GET/api/inv/warehouses会话/模块门控inventoryrequire_module(inventory)inv.py
127POST/api/inv/warehouses会话/模块门控inventoryrequire_module(inventory)inv.py
128GET/api/inv/docs会话/模块门控inventoryrequire_module(inventory)inv.py
129GET/api/inv/docs/{did}会话/模块门控inventoryrequire_module(inventory)inv.py
130POST/api/inv/docs会话/模块门控inventoryrequire_module(inventory)inv.py
131POST/api/inv/docs/{did}/approve会话/模块门控inventoryrequire_module(inventory)inv.py
132POST/api/inv/docs/{did}/cancel会话/模块门控inventoryrequire_module(inventory)inv.py
133GET/api/inv/stocktake/plan会话/模块门控inventoryrequire_module(inventory)inv.py
134GET/api/inv/stock会话/模块门控inventoryrequire_module(inventory)inv.py
135GET/api/inv/ledger会话/模块门控inventoryrequire_module(inventory)inv.py
136GET/api/inv/products会话/模块门控inventoryrequire_module(inventory)inv.py
137POST/api/inv/products会话/模块门控inventoryrequire_module(inventory)inv.py
138GET/api/inv/report会话/模块门控inventoryrequire_module(inventory)inv.py
inventory_po.py · 12 端点(12 会话/模块门控)
139GET/api/inventory/health会话/模块门控inventoryrequire_module(inventory)inventory_po.py
140GET/api/inventory/alert会话/模块门控inventoryrequire_module(inventory)inventory_po.py
141GET/api/po/suppliers会话/模块门控inventoryrequire_module(inventory)inventory_po.py
142POST/api/po/suppliers会话/模块门控inventoryrequire_module(inventory)inventory_po.py
143DELETE/api/po/suppliers/{sid}会话/模块门控inventoryrequire_module(inventory)inventory_po.py
144GET/api/po/list会话/模块门控inventoryrequire_module(inventory)inventory_po.py
145POST/api/po/create会话/模块门控inventoryrequire_module(inventory)inventory_po.py
146GET/api/po/{pid}会话/模块门控inventoryrequire_module(inventory)inventory_po.py
147PUT/api/po/{pid}会话/模块门控inventoryrequire_module(inventory)inventory_po.py
148DELETE/api/po/{pid}会话/模块门控inventoryrequire_module(inventory)inventory_po.py
149POST/api/po/{pid}/status会话/模块门控inventoryrequire_module(inventory)inventory_po.py
150POST/api/po/{pid}/receive会话/模块门控inventoryrequire_module(inventory)inventory_po.py
layout.py · 3 端点(3 会话/模块门控)
151GET/api/layout会话/模块门控基座current_user 会话layout.py
152POST/api/layout会话/模块门控基座current_user 会话layout.py
153POST/api/layout/reset会话/模块门控基座current_user 会话layout.py
listing.py · 23 端点(16 会话/模块门控 + 7 adminOnly)
154GET/api/listing/meta会话/模块门控listingrequire_module(listing)listing.py
155GET/api/listing/skus-by-model会话/模块门控listingrequire_module(listing)listing.py
156POST/api/listing/specs会话/模块门控listingrequire_module(listing)listing.py
157POST/api/listing/models/spec会话/模块门控listingrequire_module(listing)listing.py
158GET/api/listing/specs会话/模块门控listingrequire_module(listing)listing.py
159POST/api/listing/tasks会话/模块门控listingrequire_module(listing)listing.py
160GET/api/listing/tasks会话/模块门控listingrequire_module(listing)listing.py
161GET/api/listing/tasks/{tid}会话/模块门控listingrequire_module(listing)listing.py
162POST/api/listing/tasks/{tid}/generate会话/模块门控listingrequire_module(listing)listing.py
163PUT/api/listing/tasks/{tid}会话/模块门控listingrequire_module(listing)listing.py
164POST/api/listing/tasks/{tid}/approveadminOnly—_require_admin(函数体)listing.py
165POST/api/listing/tasks/{tid}/revertadminOnly—_require_admin(函数体)listing.py
166DELETE/api/listing/tasks/{tid}adminOnly—_require_admin(函数体)listing.py
167GET/api/listing/exportadminOnly—_require_admin(函数体)listing.py
168POST/api/listing/import-resultsadminOnly—_require_admin(函数体)listing.py
169GET/api/listing/events会话/模块门控listingrequire_module(listing)listing.py
170GET/api/listing/pt-markets会话/模块门控listingrequire_module(listing)listing.py
171GET/api/listing/pt-search会话/模块门控listingrequire_module(listing)listing.py
172GET/api/listing/pt-schema会话/模块门控listingrequire_module(listing)listing.py
173POST/api/listing/tasks/{tid}/bind-pt会话/模块门控listingrequire_module(listing)listing.py
174POST/api/listing/tasks/{tid}/submitadminOnly—_require_admin(函数体)listing.py
175POST/api/listing/tasks/batchadminOnly—_require_admin(函数体)listing.py
176GET/api/listing/health会话/模块门控listingrequire_module(listing)listing.py
logistics.py · 8 端点(8 会话/模块门控)
177POST/api/logistics/shipments/import会话/模块门控logisticsrequire_module(logistics)logistics.py
178GET/api/logistics/shipments会话/模块门控logisticsrequire_module(logistics)logistics.py
179GET/api/logistics/products会话/模块门控logisticsrequire_module(logistics)logistics.py
180GET/api/logistics/params会话/模块门控logisticsrequire_module(logistics)logistics.py
181POST/api/logistics/params会话/模块门控logisticsrequire_module(logistics)logistics.py
182GET/api/logistics/pricing会话/模块门控logisticsrequire_module(logistics)logistics.py
183GET/api/logistics/appendix会话/模块门控logisticsrequire_module(logistics)logistics.py
184POST/api/logistics/create会话/模块门控logisticsrequire_module(logistics)logistics.py
matrix.py · 3 端点(3 会话/模块门控)
185GET/api/matrix/dimensions会话/模块门控基座current_user 会话matrix.py
186GET/api/matrix/data会话/模块门控基座current_user 会话matrix.py
187GET/api/matrix/charts会话/模块门控基座current_user 会话matrix.py
mcp.py · 4 端点(3 adminOnly + 1 无会话)
188POST/api/mcp/keysadminOnly—_require_admin(函数体)mcp.py
189GET/api/mcp/keysadminOnly—_require_admin(函数体)mcp.py
190DELETE/api/mcp/keys/{kid}adminOnly—_require_admin(函数体)mcp.py
191POST/mcp无会话无自带鉴权/设计公开mcp.py
notify.py · 1 端点(1 会话/模块门控)
192GET/api/notifications/summary会话/模块门控基座current_user 会话notify.py
onboarding.py · 5 端点(1 会话/模块门控 + 4 adminOnly)
193GET/api/onboarding/metaadminOnly—_require_admin(函数体)onboarding.py
194POST/api/onboarding/brandadminOnly—_require_admin(函数体)onboarding.py
195POST/api/onboarding/categoryadminOnly—_require_admin(函数体)onboarding.py
196POST/api/onboarding/skusadminOnly—_require_admin(函数体)onboarding.py
197GET/api/onboarding/pipeline会话/模块门控基座current_user 会话onboarding.py
ops.py · 5 端点(5 会话/模块门控)
198GET/api/products会话/模块门控基座current_user 会话ops.py
199GET/api/orders会话/模块门控ordersrequire_module(orders)ops.py
200GET/api/mapping/edit会话/模块门控基座current_user 会话ops.py
201POST/api/mapping/edit/import会话/模块门控基座current_user 会话ops.py
202POST/api/mapping/edit会话/模块门控基座current_user 会话ops.py
org.py · 5 端点(5 adminOnly)
203GET/api/team/metaadminOnly—_require_admin(函数体)org.py
204GET/api/team/usersadminOnly—_require_admin(函数体)org.py
205POST/api/team/usersadminOnly—_require_admin(函数体)org.py
206PUT/api/team/users/{mid}adminOnly—_require_admin(函数体)org.py
207DELETE/api/team/users/{mid}adminOnly—_require_admin(函数体)org.py
po_pdf.py · 3 端点(3 会话/模块门控)
208GET/api/po/{pid}/pdf会话/模块门控inventoryrequire_module(inventory)po_pdf.py
209POST/api/po/{pid}/pdf会话/模块门控inventoryrequire_module(inventory)po_pdf.py
210POST/api/po/{pid}/mail会话/模块门控inventoryrequire_module(inventory)po_pdf.py
projects.py · 11 端点(11 会话/模块门控)
211GET/api/pm/products会话/模块门控collabrequire_module(collab)projects.py
212POST/api/pm/products会话/模块门控collabrequire_module(collab)projects.py
213GET/api/pm/products/{pid}会话/模块门控collabrequire_module(collab)projects.py
214PUT/api/pm/products/{pid}会话/模块门控collabrequire_module(collab)projects.py
215DELETE/api/pm/products/{pid}会话/模块门控collabrequire_module(collab)projects.py
216POST/api/pm/products/{pid}/tasks会话/模块门控collabrequire_module(collab)projects.py
217PUT/api/pm/tasks/{tid}会话/模块门控collabrequire_module(collab)projects.py
218DELETE/api/pm/tasks/{tid}会话/模块门控collabrequire_module(collab)projects.py
219POST/api/pm/products/{pid}/chain会话/模块门控collabrequire_module(collab)projects.py
220GET/api/pm/export会话/模块门控collabrequire_module(collab)projects.py
221POST/api/pm/import会话/模块门控collabrequire_module(collab)projects.py
reports.py · 8 端点(8 会话/模块门控)
222GET/api/reports/fields会话/模块门控基座current_user 会话reports.py
223POST/api/reports/query会话/模块门控基座current_user 会话reports.py
224GET/api/reports/defs会话/模块门控基座current_user 会话reports.py
225POST/api/reports/defs会话/模块门控基座current_user 会话reports.py
226DELETE/api/reports/defs/{rid}会话/模块门控基座current_user 会话reports.py
227POST/api/reports/landed-cost会话/模块门控基座current_user 会话reports.py
228GET/api/reports/backend-keywords/{sku}会话/模块门控基座current_user 会话reports.py
229PUT/api/reports/backend-keywords/{sku}会话/模块门控基座current_user 会话reports.py
settings.py · 6 端点(6 adminOnly)
230GET/api/settings/providersadminOnly—_require_admin(函数体)settings.py
231GET/api/settings/credentialsadminOnly—_require_admin(函数体)settings.py
232POST/api/settings/credentialsadminOnly—_require_admin(函数体)settings.py
233PUT/api/settings/credentials/{cid}adminOnly—_require_admin(函数体)settings.py
234DELETE/api/settings/credentials/{cid}adminOnly—_require_admin(函数体)settings.py
235POST/api/settings/credentials/{cid}/verifyadminOnly—_require_admin(函数体)settings.py
sourcing.py · 13 端点(13 会话/模块门控)
236GET/api/sourcing/search会话/模块门控sourcingrequire_module(sourcing)sourcing.py
237GET/api/sourcing/keepa-history会话/模块门控sourcingrequire_module(sourcing)sourcing.py
238GET/api/sourcing/watchlist会话/模块门控sourcingrequire_module(sourcing)sourcing.py
239POST/api/sourcing/watch会话/模块门控sourcingrequire_module(sourcing)sourcing.py
240DELETE/api/sourcing/watch/{wid}会话/模块门控sourcingrequire_module(sourcing)sourcing.py
241GET/api/sourcing/product会话/模块门控sourcingrequire_module(sourcing)sourcing.py
242GET/api/sourcing/explorer会话/模块门控sourcingrequire_module(sourcing)sourcing.py
243GET/api/sourcing/explore/fields会话/模块门控sourcingrequire_module(sourcing)sourcing.py
244GET/api/sourcing/explore会话/模块门控sourcingrequire_module(sourcing)sourcing.py
245GET/api/sourcing/aba/overview会话/模块门控sourcingrequire_module(sourcing)sourcing.py
246GET/api/sourcing/aba/chart会话/模块门控sourcingrequire_module(sourcing)sourcing.py
247GET/api/sourcing/aba/ledger会话/模块门控sourcingrequire_module(sourcing)sourcing.py
248GET/api/sourcing/radar会话/模块门控sourcingrequire_module(sourcing)sourcing.py
verdicts.py · 5 端点(4 会话/模块门控 + 1 adminOnly)
249POST/api/sourcing/verdicts/materializeadminOnly—_require_admin(函数体)verdicts.py
250GET/api/sourcing/verdicts/candidates会话/模块门控sourcingrequire_module(sourcing)verdicts.py
251GET/api/sourcing/verdicts/pareto会话/模块门控sourcingrequire_module(sourcing)verdicts.py
252POST/api/sourcing/verdicts/decision会话/模块门控sourcingrequire_module(sourcing)verdicts.py
253GET/api/sourcing/verdicts/legacy会话/模块门控sourcingrequire_module(sourcing)verdicts.py
254GET/api/dashboard/chart-order会话/模块门控基座current_user 会话dashboard.py
255PUT/api/dashboard/chart-order会话/模块门控基座current_user 会话dashboard.py
附录 B · 页面全清单 39 路由 (26 实页 · 行数=page.tsx 源码行 · 消费端点=源码 /api 引用 · 7 页零 API 引用为静态/引导/遗留)
#路由组 · 模块行数消费的 API 端点
1/ai协作·ai111/api/ai/
2/documents协作·collab139/api/documents/tree
3/feishu协作·collab79/api/documents/tree
4/training协作·collab93—(零直接引用)
5/upload协作·collab7—(零直接引用)
6/database数据·collab(adminOnly)182/api/db/table/ · /api/db/tables
7/noon数据·finance256/api/noon/summary
8/dictionary数据·基座146/api/dictionary · /api/glossary
9/mapping数据·基座305/api/mapping/edit · /api/mapping/edit/import · /api/mapping/skus
10/pipeline数据·基座(运维)311/api/glossary · /api/pipeline/audit · /api/pipeline/run/ · /api/pipeline/status
11/dashboard/[brand]旧路由(遗留)33/api/brandboard · /api/dashboard/charts
12/dashboard/noon/[brand]旧路由(遗留)33—(零直接引用)
13/account系统·基座112/api/auth/logout-all · /api/auth/password · /api/auth/sessions
14/billing系统·基座206/api/billing/checkout · /api/billing/modules · /api/billing/modules/toggle · /api/billing/plans · /api/billing/status
15/settings系统·基座(adminOnly)175/api/settings/credentials · /api/settings/credentials/ · /api/settings/providers
16/team系统·基座(org)248/api/team/meta · /api/team/users · /api/team/users/ · /api/tenant/brands · /api/tenant/brands/
17/ads经营·ads2044/api/ads/analysis · /api/ads/campaigns · /api/ads/charts · /api/ads/dayparting · /api/ads/imports · /api/ads/imports/recompute · /api/ads/keyword-bids · /api/ads/neg-keywords · /api/ads/neg-keywords/ · /api/ads/optlog · /api/ads/optlog/ · /api/ads/platform · /api/ads/reattribute · /api/ads/recommendations · /api/ads/recommendations/ · /api/ads/recommendations/run · /api/ads/rule-config · /api/ads/rule-config/ · /api/ads/search-terms · /api/ads/sources · /api/ads/upload · /api/ads/upload/preview
18/finance经营·finance1409/api/finance/full · /api/finance/kpi-wall · /api/finance/monthly · /api/finance/noon-pnl · /api/finance/noon-sku · /api/finance/product-pl · /api/finance/profit-matrix
19/sourcing经营·sourcing858/api/ai/sourcing · /api/sourcing/aba/ledger · /api/sourcing/aba/overview · /api/sourcing/explore · /api/sourcing/explore/fields · /api/sourcing/explorer · /api/sourcing/radar
20/rankings经营·基座237/api/rankings · /api/rankings/history · /api/rankings/markets
21/today经营·基座460/api/dashboard/filters · /api/today
22/经营·基座(工作台)691/api/dashboard/charts · /api/dashboard/filters · /api/dashboard/kpi · /api/dashboard/merged-kpi · /api/dashboard/sku-sales
23/onboarding认证·品牌开户312/api/onboarding/brand · /api/onboarding/category · /api/onboarding/meta · /api/onboarding/pipeline · /api/onboarding/skus
24/welcome认证·引导114—(零直接引用)
25/login认证·无会话76/api/auth/login
26/register认证·无会话121/api/auth/register · /api/auth/resend
27/verify认证·无会话57/api/auth/verify
28/promotion运营·ads374/api/promotion/channels · /api/promotion/orders · /api/promotion/submission · /api/promotion/summary
29/projects运营·collab710/api/pm/export · /api/pm/import · /api/pm/products · /api/pm/products/ · /api/pm/tasks/
30/settlement运营·finance130/api/settlement
31/inventory运营·inventory266/api/inventory/alert · /api/inventory/health · /api/noon-inventory
32/po运营·inventory414/api/inventory/alert · /api/po/ · /api/po/create · /api/po/list · /api/po/suppliers · /api/po/suppliers/ · /api/products
33/listings运营·listing1138/api/listing/export · /api/listing/health · /api/listing/import-results · /api/listing/meta · /api/listing/models/spec · /api/listing/pt-markets · /api/listing/pt-search · /api/listing/skus-by-model · /api/listing/specs · /api/listing/tasks · /api/listing/tasks/ · /api/listing/tasks/batch
34/logistics运营·logistics759/api/logistics/appendix · /api/logistics/create · /api/logistics/params · /api/logistics/pricing · /api/logistics/products · /api/logistics/shipments · /api/logistics/shipments/import
35/orders运营·orders148/api/orders
36/products运营·基座262/api/brandboard/product-drill · /api/products
37/en静态116—(零直接引用)
38/privacy静态138—(零直接引用)
39/terms静态124—(零直接引用)
附录 C · 数据表全清单 219 张 (public 121 + audit 98=cleaned 97+dirty_data_log · RLS 键型 114 tenant_id / 82 品牌键 / 23 无策略)
#schema表名RLS 键对偶 / 注记
public 121(源头镜像 + 注册表 + 会话/系统表) · 键型 {'tenant': 69, '品牌': 38, '无': 14}
1publicaba_country_catalogtenant_id→ audit.cleaned_* 对偶
2publicaba_keepa_fulltenant_id→ audit.cleaned_* 对偶
3publicaba_metatenant_id→ audit.cleaned_* 对偶
4publicaba_radar_baskettenant_id→ audit.cleaned_* 对偶
5publicaba_radar_fragmentedtenant_id→ audit.cleaned_* 对偶
6publicaba_radar_gemtenant_id→ audit.cleaned_* 对偶
7publicaba_radar_repeattenant_id→ audit.cleaned_* 对偶
8publicaba_radar_risingtenant_id→ audit.cleaned_* 对偶
9publicaba_search_termstenant_id→ audit.cleaned_* 对偶
10publicaba_term_universetenant_id→ audit.cleaned_* 对偶
11publicad_campaigns品牌键→ audit.cleaned_* 对偶
12publicads_daily品牌键→ audit.cleaned_* 对偶
13publicads_decision_audittenant_id→ audit.cleaned_* 对偶
14publicads_decision_requesttenant_id→ audit.cleaned_* 对偶
15publicads_importstenant_id→ audit.cleaned_* 对偶
16publicads_keywords_daily品牌键→ audit.cleaned_* 对偶
17publicads_optimization_log品牌键→ audit.cleaned_* 对偶
18publicads_recommendations品牌键→ audit.cleaned_* 对偶
19publicads_rule_config品牌键→ audit.cleaned_* 对偶
20publicads_search_terms_daily品牌键→ audit.cleaned_* 对偶
21publicads_sku_daily品牌键→ audit.cleaned_* 对偶
22publicamazon_ads_daily品牌键→ audit.cleaned_* 对偶
23publicamazon_orders品牌键→ audit.cleaned_* 对偶
24publicamazon_refund_monthly品牌键→ audit.cleaned_* 对偶
25publicamazon_settlement_monthly品牌键→ audit.cleaned_* 对偶
26publicapi_fields_catalog无策略(全局)无镜像(注册表/会话/系统表)
27publicaplus_docstenant_id→ audit.cleaned_* 对偶
28publicaplus_historytenant_id→ audit.cleaned_* 对偶
29publicaplus_mediatenant_id→ audit.cleaned_* 对偶
30publicaudit_baselines无策略(全局)→ audit.cleaned_* 对偶
31publicaudit_known_issues无策略(全局)→ audit.cleaned_* 对偶
32publicaudit_logtenant_id无镜像(注册表/会话/系统表)
33publicaudit_results无策略(全局)→ audit.cleaned_* 对偶
34publicaudit_thresholds无策略(全局)→ audit.cleaned_* 对偶
35publicautocomplete_terms品牌键→ audit.cleaned_* 对偶
36publicbilling_eventstenant_id无镜像(注册表/会话/系统表)
37publicbrand_channelstenant_id无镜像(注册表/会话/系统表)
38publicbrands_sourcetenant_id无镜像(注册表/会话/系统表)
39publiccredentialstenant_id无镜像(注册表/会话/系统表)
40publicdocuments_nodestenant_id→ audit.cleaned_* 对偶
41publicfinance_monthly品牌键→ audit.cleaned_* 对偶
42publicfx_rates无策略(全局)无镜像(注册表/会话/系统表)
43publicinv_doc_headstenant_id→ audit.cleaned_* 对偶
44publicinv_doc_itemstenant_id→ audit.cleaned_* 对偶
45publicinv_productstenant_id→ audit.cleaned_* 对偶
46publicinv_stock_balancetenant_id→ audit.cleaned_* 对偶
47publicinv_stock_ledgertenant_id→ audit.cleaned_* 对偶
48publicinv_warehousestenant_id→ audit.cleaned_* 对偶
49publicinventory_health品牌键→ audit.cleaned_* 对偶
50publickeepa_dailytenant_idwatch_isolation(EXISTS keepa_watch 同租户同 ASIN)
51publickeepa_pull_logtenant_id无镜像(注册表/会话/系统表)
52publickeepa_watchtenant_id→ audit.cleaned_* 对偶
53publiclisting_backend_keywordstenant_id→ audit.cleaned_* 对偶
54publiclisting_category_meta品牌键→ audit.cleaned_* 对偶
55publiclisting_eventstenant_id→ audit.cleaned_* 对偶
56publiclisting_pt_suggest品牌键→ audit.cleaned_* 对偶
57publiclisting_specstenant_id→ audit.cleaned_* 对偶
58publiclisting_taskstenant_id→ audit.cleaned_* 对偶
59publiclisting_templatestenant_id→ audit.cleaned_* 对偶
60publiclogistics_paramstenant_id→ audit.cleaned_* 对偶
61publiclogistics_shipments品牌键→ audit.cleaned_* 对偶
62publiclogistics_stats品牌键→ audit.cleaned_* 对偶
63publicmarketplaces无策略(全局)无镜像(注册表/会话/系统表)
64publicmcp_keystenant_id→ audit.cleaned_* 对偶
65publicmetric_calibers无策略(全局)→ audit.cleaned_* 对偶
66publicmonthly_pl品牌键→ audit.cleaned_* 对偶
67publicneg_keywordstenant_id→ audit.cleaned_* 对偶
68publicnoon_ads_daily品牌键→ audit.cleaned_* 对偶
69publicnoon_inventory品牌键→ audit.cleaned_* 对偶
70publicnoon_monthly品牌键→ audit.cleaned_* 对偶
71publicnoon_orders品牌键→ audit.cleaned_* 对偶
72publicnoon_procurement_cost品牌键→ audit.cleaned_* 对偶
73publicnoon_sku_ads品牌键→ audit.cleaned_* 对偶
74publicnoon_sku_pl品牌键→ audit.cleaned_* 对偶
75publicnoon_sku_pl_monthly品牌键→ audit.cleaned_* 对偶
76publicnoon_sku_status品牌键→ audit.cleaned_* 对偶
77publicnoon_sku_unsaleable品牌键→ audit.cleaned_* 对偶
78publicnoon_statement品牌键→ audit.cleaned_* 对偶
79publicorder_fees品牌键→ audit.cleaned_* 对偶
80publicpipe_domains无策略(全局)→ audit.cleaned_* 对偶
81publicplatforms无策略(全局)无镜像(注册表/会话/系统表)
82publicpm_productstenant_id→ audit.cleaned_* 对偶
83publicpm_taskstenant_id→ audit.cleaned_* 对偶
84publicproduct_categories无策略(全局)无镜像(注册表/会话/系统表)
85publicproduct_reviews品牌键→ audit.cleaned_* 对偶
86publicproducts品牌键→ audit.cleaned_* 对偶
87publicpromotion_channelstenant_id→ audit.cleaned_* 对偶
88publicpromotion_crawl_stats无策略(全局)无镜像(注册表/会话/系统表)
89publicpromotion_kol_channelstenant_id→ audit.cleaned_* 对偶
90publicpromotion_kol_hightenant_id→ audit.cleaned_* 对偶
91publicpromotion_orderstenant_id→ audit.cleaned_* 对偶
92publicpromotion_productstenant_id→ audit.cleaned_* 对偶
93publicpromotion_review_sitestenant_id→ audit.cleaned_* 对偶
94publicpromotion_submissionstenant_id→ audit.cleaned_* 对偶
95publicpromotion_taskstenant_id→ audit.cleaned_* 对偶
96publicprovisioning_logtenant_id无镜像(注册表/会话/系统表)
97publicpurchase_order_itemstenant_id→ audit.cleaned_* 对偶
98publicpurchase_orderstenant_id→ audit.cleaned_* 对偶
99publicrankings_daily品牌键→ audit.cleaned_* 对偶
100publicreport_defstenant_id→ audit.cleaned_* 对偶
101publicsales_daily品牌键→ audit.cleaned_* 对偶
102publicsales_hourly品牌键→ audit.cleaned_* 对偶
103publicsku_mapping品牌键→ audit.cleaned_* 对偶
104publicsourcing_candidatestenant_id→ audit.cleaned_* 对偶
105publicsourcing_decision_audittenant_id→ audit.cleaned_* 对偶
106publicsourcing_verdictstenant_id→ audit.cleaned_* 对偶
107publicsourcing_verdicts_legacytenant_id→ audit.cleaned_* 对偶
108publicsubscriptionstenant_id无镜像(注册表/会话/系统表)
109publicsupplierstenant_id→ audit.cleaned_* 对偶
110publictenant_brandstenant_id无镜像(注册表/会话/系统表)
111publictenant_credential_eventstenant_id无镜像(注册表/会话/系统表)
112publictenant_credentialstenant_id无镜像(注册表/会话/系统表)
113publictenant_modulestenant_id无镜像(注册表/会话/系统表)
114publictenants无策略(全局)无镜像(注册表/会话/系统表)
115publicterm_field_map无策略(全局)→ audit.cleaned_* 对偶
116publicupload_filestenant_id→ audit.cleaned_* 对偶
117publicusage_dailytenant_id无镜像(注册表/会话/系统表)
118publicuser_brandstenant_id无镜像(注册表/会话/系统表)
119publicuser_dashboard_prefstenant_id无镜像(注册表/会话/系统表)
120publicuser_modulestenant_id无镜像(注册表/会话/系统表)
121publicuserstenant_id无镜像(注册表/会话/系统表)
audit 98(cleaned_* 97 + dirty_data_log) · 键型 {'tenant': 45, '品牌': 44, '无': 9}
122auditcleaned_aba_country_catalogtenant_id← public.aba_country_catalog 源
123auditcleaned_aba_keepa_full品牌键← public.aba_keepa_full 源
124auditcleaned_aba_metatenant_id← public.aba_meta 源
125auditcleaned_aba_radar_baskettenant_id← public.aba_radar_basket 源
126auditcleaned_aba_radar_fragmentedtenant_id← public.aba_radar_fragmented 源
127auditcleaned_aba_radar_gemtenant_id← public.aba_radar_gem 源
128auditcleaned_aba_radar_repeattenant_id← public.aba_radar_repeat 源
129auditcleaned_aba_radar_risingtenant_id← public.aba_radar_rising 源
130auditcleaned_aba_search_termstenant_id← public.aba_search_terms 源
131auditcleaned_aba_term_universetenant_id← public.aba_term_universe 源
132auditcleaned_ad_campaigns品牌键← public.ad_campaigns 源
133auditcleaned_ads_daily品牌键← public.ads_daily 源
134auditcleaned_ads_decision_audittenant_id← public.ads_decision_audit 源
135auditcleaned_ads_decision_requesttenant_id← public.ads_decision_request 源
136auditcleaned_ads_imports品牌键← public.ads_imports 源
137auditcleaned_ads_keywords_daily品牌键← public.ads_keywords_daily 源
138auditcleaned_ads_optimization_log品牌键← public.ads_optimization_log 源
139auditcleaned_ads_recommendations品牌键← public.ads_recommendations 源
140auditcleaned_ads_rule_config品牌键← public.ads_rule_config 源
141auditcleaned_ads_search_terms_daily品牌键← public.ads_search_terms_daily 源
142auditcleaned_ads_sku_daily品牌键← public.ads_sku_daily 源
143auditcleaned_amazon_ads_daily品牌键← public.amazon_ads_daily 源
144auditcleaned_amazon_orders品牌键← public.amazon_orders 源
145auditcleaned_amazon_refund_monthly品牌键← public.amazon_refund_monthly 源
146auditcleaned_amazon_settlement_monthly品牌键← public.amazon_settlement_monthly 源
147auditcleaned_aplus_docstenant_id← public.aplus_docs 源
148auditcleaned_aplus_historytenant_id← public.aplus_history 源
149auditcleaned_aplus_mediatenant_id← public.aplus_media 源
150auditcleaned_audit_baselines无策略(全局)← public.audit_baselines 源
151auditcleaned_audit_known_issues无策略(全局)← public.audit_known_issues 源
152auditcleaned_audit_results无策略(全局)← public.audit_results 源
153auditcleaned_audit_thresholds无策略(全局)← public.audit_thresholds 源
154auditcleaned_autocomplete_terms品牌键← public.autocomplete_terms 源
155auditcleaned_documents_nodestenant_id← public.documents_nodes 源
156auditcleaned_finance_monthly品牌键← public.finance_monthly 源
157auditcleaned_inv_doc_headstenant_id← public.inv_doc_heads 源
158auditcleaned_inv_doc_itemstenant_id← public.inv_doc_items 源
159auditcleaned_inv_productstenant_id← public.inv_products 源
160auditcleaned_inv_stock_balancetenant_id← public.inv_stock_balance 源
161auditcleaned_inv_stock_ledgertenant_id← public.inv_stock_ledger 源
162auditcleaned_inv_warehousestenant_id← public.inv_warehouses 源
163auditcleaned_inventory_health品牌键← public.inventory_health 源
164auditcleaned_keepa_daily无策略(全局)镜像无策略 · 0 端点引用(grep 实证)
165auditcleaned_keepa_watchtenant_id← public.keepa_watch 源
166auditcleaned_listing_backend_keywordstenant_id← public.listing_backend_keywords 源
167auditcleaned_listing_category_meta品牌键← public.listing_category_meta 源
168auditcleaned_listing_eventstenant_id← public.listing_events 源
169auditcleaned_listing_pt_suggest品牌键← public.listing_pt_suggest 源
170auditcleaned_listing_specs品牌键← public.listing_specs 源
171auditcleaned_listing_tasks品牌键← public.listing_tasks 源
172auditcleaned_listing_templatestenant_id← public.listing_templates 源
173auditcleaned_logistics_paramstenant_id← public.logistics_params 源
174auditcleaned_logistics_shipments品牌键← public.logistics_shipments 源
175auditcleaned_logistics_stats品牌键← public.logistics_stats 源
176auditcleaned_mcp_keystenant_id← public.mcp_keys 源
177auditcleaned_metric_calibers无策略(全局)← public.metric_calibers 源
178auditcleaned_monthly_pl品牌键← public.monthly_pl 源
179auditcleaned_neg_keywords品牌键← public.neg_keywords 源
180auditcleaned_noon_ads_daily品牌键← public.noon_ads_daily 源
181auditcleaned_noon_inventory品牌键← public.noon_inventory 源
182auditcleaned_noon_monthly品牌键← public.noon_monthly 源
183auditcleaned_noon_orders品牌键← public.noon_orders 源
184auditcleaned_noon_procurement_cost品牌键← public.noon_procurement_cost 源
185auditcleaned_noon_sku_ads品牌键← public.noon_sku_ads 源
186auditcleaned_noon_sku_pl品牌键← public.noon_sku_pl 源
187auditcleaned_noon_sku_pl_monthly品牌键← public.noon_sku_pl_monthly 源
188auditcleaned_noon_sku_status品牌键← public.noon_sku_status 源
189auditcleaned_noon_sku_unsaleable品牌键← public.noon_sku_unsaleable 源
190auditcleaned_noon_statement品牌键← public.noon_statement 源
191auditcleaned_order_fees品牌键← public.order_fees 源
192auditcleaned_pipe_domains无策略(全局)← public.pipe_domains 源
193auditcleaned_pm_productstenant_id← public.pm_products 源
194auditcleaned_pm_taskstenant_id← public.pm_tasks 源
195auditcleaned_product_reviews品牌键← public.product_reviews 源
196auditcleaned_products品牌键← public.products 源
197auditcleaned_promotion_channelstenant_id← public.promotion_channels 源
198auditcleaned_promotion_kol_channelstenant_id← public.promotion_kol_channels 源
199auditcleaned_promotion_kol_hightenant_id← public.promotion_kol_high 源
200auditcleaned_promotion_orderstenant_id← public.promotion_orders 源
201auditcleaned_promotion_productstenant_id← public.promotion_products 源
202auditcleaned_promotion_review_sitestenant_id← public.promotion_review_sites 源
203auditcleaned_promotion_submissionstenant_id← public.promotion_submissions 源
204auditcleaned_promotion_taskstenant_id← public.promotion_tasks 源
205auditcleaned_purchase_order_items品牌键← public.purchase_order_items 源
206auditcleaned_purchase_orderstenant_id← public.purchase_orders 源
207auditcleaned_rankings_daily品牌键← public.rankings_daily 源
208auditcleaned_report_defstenant_id← public.report_defs 源
209auditcleaned_sales_daily品牌键← public.sales_daily 源
210auditcleaned_sales_hourly品牌键← public.sales_hourly 源
211auditcleaned_sku_mapping品牌键← public.sku_mapping 源
212auditcleaned_sourcing_candidatestenant_id← public.sourcing_candidates 源
213auditcleaned_sourcing_decision_audittenant_id← public.sourcing_decision_audit 源
214auditcleaned_sourcing_verdictstenant_id← public.sourcing_verdicts 源
215auditcleaned_sourcing_verdicts_legacytenant_id← public.sourcing_verdicts_legacy 源
216auditcleaned_supplierstenant_id← public.suppliers 源
217auditcleaned_term_field_map无策略(全局)← public.term_field_map 源
218auditcleaned_upload_filestenant_id← public.upload_files 源
219auditdirty_data_log无策略(全局)清洗残账 · 无策略
附录 D · 定时任务 28 条 cron (worker 容器 arq 27 + 宿主 collection_scheduler 统一调度器 1 · api/tasks.py 全 36 任务函数,其余 9 个为手动/事件触发)
#任务函数调度(arq cron)机制/说明
1daily_usage_rolluphour=0, minute=5—
2ingest_mercury_dailyhour=4, minute=30每日全量 · 04:30 北京
3ingest_mercury_weeklyhour=2, minute=0, weekday=6周六 02:00 · 周度深同步
4ingest_today_incrementalminute=43, hour=set(range(0, 24, 2))每 2 小时 · 当日增量
5refresh_keepa_watchhour=5, minute=10watch 池播种刷新
6daily_ads_ruleshour=5, minute=40—
7daily_pipe_alarmhour=6, minute=15管道断流泊松报警
8fee_coverage_alarmhour=6, minute=20—
9collection_finances_deephour=3, minute=20, weekday=6—
10collection_cycleminute=50—
11collection_cycle_noonminute=20, hour={0, 6, 12, 18}—
12source_drift_checkhour=6, minute=30源漂移检查
13sourcing_dispatcher_tick无参=默认每分钟默认每分钟(arq 无参=每分钟) · 分发器
14label_price_statusminute={5, 35}—
15align_zf_fg_schemahour=4, minute=0—
16collection_cycle_financesminute=40, hour={0, 6, 12, 18}—
17collection_noon_ordersminute={3, 18, 33, 48}—
18collection_noon_deepminute=53, hour={1, 7, 13, 19}—
19collection_cycle_adsminute=0, hour={2, 3, 4, 5}05:00 槽位含 onno zip 手动通道
20collection_cycle_salesminute=0, hour={1, 3}—
21collection_cycle_settlementsminute=10, hour=4—
22collection_cycle_inventoryminute=0, hour=8—
23collection_cycle_ads_snapshotminute=30, hour=0—
24collection_cycle_ads_auditminute=0, hour=8—
25daily_fx_rateshour=6, minute=5汇率锚日更(其余币种, 锚定三币除外)
26daily_amazon_rankings_keepahour=5, minute=20BSR 榜单采集
27ads_import_pumpminute=set(range(60))每分钟 · Redis 锁+FOR UPDATE SKIP LOCKED 单任务
28collection_scheduler(宿主 cron)* * * * *统一调度器(2026-10-02 方案A 数据库驱动):读 collection_schedule 注册表→到点触发。每半点订单/ads 近1小时增量+每天 02:00 回访/快照+每整点推送+每天 04:30 站外推广只读库;新租户/品牌触发器自动建任务

非 cron 任务函数 9 个(API 触发/事件消费/内部调用):_pool · _rollup_one · _mercury_conn · fee_backfill_targeted · _ads_import_targets · _notify_fx · _handle_domain_event · _events_consumer_thread · _on_worker_startup。宿主侧另有 collection_scheduler(统一调度器,注册表驱动)+ 5 个 .sh 脚本+12 条宿主 crontab(见系统手册)。

附录 E · 注册表群(唯一事实源) · metric_calibers 口径 10 行 · platforms 3 · marketplaces 23 站 · brands_source 9 行(3 租户×6 组) · tenants 3 · collection_schedule 14 行(调度注册表, 2026-10-02)
metric_calibers · 口径注册表(10 行,全局无 RLS·portal_app 只读)
#metricplatformauthoritative_sourcefallback_source拍板日
1ad_spendamazonaudit.cleaned_ads_sku_daily(SKU级) UNION ALL audit.cleaned_amazon_ads_daily(账户级)—2026-09-26
2ad_spendnoonnoon_ads_daily(单源, 全品牌)—2026-09-26
3cost—public.sku_mapping.cost_rmb(映射优先)audit.cleaned_noon_procurement_cost(采购表回退, 两者皆无计 0 该型号利润偏高)2026-09-26
4ordersamazonaudit.cleaned_amazon_orders—2026-09-25
5ordersnoonaudit.cleaned_noon_orders(实时日级)—2026-09-26
6fx_pegged—锚定汇率(冻结): SAR=3.75 / AED=3.6725 / RMB→USD=6.7963fx_rates(其余币种, daily_fx_rates 日更)2026-09-18
7settle_days_waitingamazonsync_mercury._ORDERS_UNION 按品牌起点列: zf=last_update_date(Amazon无发货列,OrderLastUpdatedAt≈发货时点,实测与下单日差11单) / fg=coalesce(shipped_date,order_date) / onno=purchase_date(源无发货列)每分支单列, 无跨列 fallback2026-09-26
8settle_abnormalamazonis_abnormal = order_status=Shipped AND NOT 已回款 AND days_waiting>14已回款信号: zf=has_finance / fg=settlement_status<>已回款 / onno=订单金额入账(st.settled)2026-09-26
9inventory_by_countryamazonchips 主数=stocked(该国有库存SKU数,与文案一致); 辅注=在管上架行数countcount=上架即统计口径保留(2026-09-22拍板)2026-09-26
10logistics_kpiall/api/logistics/shipments KPI=明细表 logistics_shipments 实时聚合(同源同筛选同RLS)无(旧 logistics_stats 快照表退役留档, 停在2026-09-05)2026-09-26
platforms · 平台能力(3)marketplaces · 站点(23 国)
amazon=active · noon=active · emag=planned
emag=planned 已排队(接入=采集适配器+清洗+页面全套工程)
amazon 19 站 · emag 2 站 · noon 2 站(amazon 19 / noon SA·AE / emag RO·BG)
brands_source · 管道注册表(活库 9 行 = 3 租户 × 6 组(品牌,平台),下表按(品牌,平台)去重展示 · enabled=管道级,与租户停用(tenant_brands.is_active)分层)
品牌平台enabled说明
brainnewsamazontsource_map 驱动动态分支
fittingirlsamazontsource_map 驱动动态分支
onnoamazontsource_map 驱动动态分支
onnonoontsource_map 驱动动态分支
zipforceamazontsource_map 驱动动态分支
zipforcenoontsource_map 驱动动态分支
tenants · 租户(3,均 active)
t1zipforceactive
t2onnoactive
t3fittingirlsactive
collection_schedule · 调度注册表(14 行,2026-10-02 统一调度器方案A · 新租户/品牌触发器自动插行)
task_typecron行数说明
collect*/30 * * * *5每半点订单/ads 近1小时增量(zf/onno/fg-amazon --hours 1 + noon-*-inc --days 1)
collect0 2 * * *3每天 02:00 回访(订单窗拉长 amazon --hours 24/noon --days 7)+库存快照(noon-inventory/amz-fba/sales-fba)
daily_readonly30 4 * * *3每天 04:30 站外推广只读库更新(promotion_refresh,物理共享仅 tenant=1 跑)
push0 * * * *3每整点推送 api→web(删租户 redis 缓存键=数据新鲜度)