Files
makemd/docs/governance/task-specifications.md
Ansonai 6759d47de4 docs: 新增V30.0版本相关设计文档与指南
新增服务器启动文档、设计说明书、风险清单等核心文档
补充前端集成蓝图、多租户实施清单、上线红线检查清单
添加质量保障文档与早期业务规格书
2026-03-16 01:31:26 +08:00

63 KiB
Raw Blame History

📋 任务规格说明书 (Master Task Registry) - V32.0

多 AI 协同原子指令源。严禁物理删除历史规格,失效规格请使用 删除线 标注并记录版本。

[ERP_WMS_01] 拣货路径优化与波次分单算法 (Pick Wave)

  • 技术收益:基于 AGI 销量预测自动聚合高频 SKU 订单,优化拣货路径,提升仓库作业效率 40%。
  • 核心目标:实现 WMSWaveService,支持波次自动生成、路径 TSP 优化与物理表持久化。
  • 参考路径WMSWaveService.ts

[ERP_LOG_01] 物流轨迹全链路归一化监控 (Logistics Tracker)

  • 技术收益:实时识别全球物流轨迹异常(停滞、错投、延误),联动自愈路由降低丢包风险。
  • 核心目标:实现 LogisticsTrackerService,支持轨迹异常检测模式匹配与 reportAnomaly 联动。
  • 参考路径LogisticsTrackerService.ts

[CORE_TELE_ALRT] 统一告警归集与自愈路由 (Alert Hub)

  • 运维收益:打破信息孤岛,将风控、系统、业务异常统一归集,为 AGI 自愈提供结构化决策输入。
  • 核心目标:实现 AlertService支持告警分级CRITICAL/ERROR/WARN、租户聚合与状态管理。
  • 参考路径AlertService.ts

[ERP_REP_01] 全业务多维报表宽表构建 (Report Mart Aggregator)

  • 技术收益通过增量预聚合Incremental Aggregation解决大数据量下的报表查询性能瓶颈。
  • 核心目标:在 ReportService 中实现预聚合逻辑,将明细表增量同步至 cf_report_summary 宽表。
  • 参考路径ReportService.ts

[CORE_TELE_PREDICTIVE_HEALTH] 预测性系统健康度看板 (Predictive Health)

  • 技术收益:通过时间序列分析预判系统崩溃与性能瓶颈,实现 AGI 级别的自愈能力。
  • 核心目标:实现 PredictiveHealthService,基于 Telemetry 数据展示未来 24 小时的健康度预测。
  • 参考路径PredictiveHealthService.ts

[CORE_AI_60] Agent 集群自治协作协议 (Agent Swarm)

  • 战略收益:打破单 Agent 性能瓶颈,实现多 AGI 实例的复杂任务流水线。
  • 核心目标:实现 AgentSwarmService,支持任务在不同特性的 Agent 间自动流转。
  • 参考路径AgentSwarmService.ts

[BIZ_INV_30] 滞销库存深度治理与清仓建议 (Aging Inventory)

  • 利润收益:降低仓储成本,通过 AGI 自动生成针对滞销 SKU 的阶梯折扣建议。
  • 核心目标:实现 AgingInventoryService,联动 InventoryAgingService 进行库龄分析。
  • 参考路径AgingInventoryService.ts

[BIZ_MKT_50] AGI 驱动的跨平台套利自动化 (Arbitrage AGI)

  • 战略收益秒级识别全球多平台Amazon, Temu, 1688价格洼地全自动执行套利下单。
  • 核心目标:实现 ArbitrageAGIService,联动 ArbitrageService 锁定套利空间。
  • 参考路径ArbitrageAGIService.ts

[BIZ_INV_50] 分布式库存分布优化 (Inventory Distribution)

  • 业务收益:基于销量热力图动态调整全球各仓库存分布,减少跨区调拨成本 30%。
  • 核心目标:实现 InventoryDistributionService,生成 TRANSFER 建议。
  • 参考路径InventoryDistributionService.ts

[BIZ_FIN_210] 跨主权流动性对冲与避险 (Liquidity Hedge)

  • 金融收益:自动对冲跨境贸易中的流动性风险,确保结算网关资金充沛。
  • 核心目标:实现 LiquidityHedgingService,监控各 Hub 节点头寸。
  • 参考路径LiquidityHedgingService.ts

[BIZ_FIN_220] 供应链微贷与信用评估 (Micro Credit)

  • 金融收益:基于贸易真实性证据链为租户提供 AGI 授信建议,解决小微外贸融资难。
  • 核心目标:实现 MicroCreditService,联动 cf_order 真实交易记录。
  • 参考路径MicroCreditService.ts

[BIZ_SOV_13] 声誉驱动的阶梯费率与流量倾斜 (Reputation Perks)

  • 业务收益:激励租户维护高信用评分,自动为高信用节点提供更低的结算手续费与优先的资源分配。
  • 核心目标:联动 BillingServiceTrafficService,根据声誉分值自动匹配计费 FSM。
  • 参考路径BillingService.ts

[BIZ_SOV_14] 跨节点资源共享配额管理 (Resource Quota)

  • 网络收益:防止恶意节点占用全网算力/存储资源,基于声誉实现动态的资源预留与配额管理。
  • 核心目标:实现 NodeResourceQuotaService,联动 InfinityComputeService 进行配额限制。
  • 参考路径NodeResourceQuotaService.ts

[CORE_TELE_TOPO] 全球节点实时拓扑遥测 (Network Topology)

  • 遥测收益:提供全球贸易网络的实时连接快照,自动识别高延迟链路并触发路由重排。
  • 核心目标:实现 NetworkTopologyService,采集 P2P 通信中的 latency, jitter 与 hop_count。
  • 参考路径NetworkTopologyService.ts

[FE_CMD_01] AGI 指令终端 (Omni-Box Command)

  • 交互收益:让运营人员通过自然语言直接操控系统,降低操作复杂度 80%。
  • 核心目标:实现一个全局浮动的搜索指令框,支持语义解析并映射至后端 API 指令。
  • 参考路径dashboard/src/components/OmniBox/

[FE_TOC_01] TOC 消费者运营工作台 (Consumer Ops)

  • 业务收益:打通零售端的售后与评价管理,提升客户满意度。
  • 核心目标:展示消费者订单全链路状态,集成 RAG 驱动的智能纠纷处理界面。
  • 参考路径dashboard/src/pages/business/toc/

[FE_SITE_01] 独立站管理矩阵 (Site Matrix)

  • 业务收益:一站式管理 Shopify/WooCommerce 资产,监控全球流量波动。
  • 核心目标实现多站点健康度遥测、SEO 关键词热力图与跨站商品同步 UI。
  • 参考路径dashboard/src/pages/business/sites/

[FE_TOB_01] TOB 批发与寻源询价 (Wholesale & RFQ)

  • 业务收益:标准化 B2B 贸易流程,管理大宗订单与长期协议。
  • 核心目标:实现 RFQ (询价单) 处理流水线,支持阶梯报价矩阵的图形化编辑。
  • 参考路径dashboard/src/pages/business/tob/

[FE_ERP_SKU] 全球 SKU 主数据管理中心 (SKU Master)

  • 业务收益:建立跨平台统一的商品身份,解决一物多码导致的库存混乱。
  • 核心目标:实现多维属性(颜色/尺寸/规格)编辑器,支持 1688/Amazon/Temu SKU 映射矩阵。
  • 参考路径dashboard/src/pages/erp/sku/

[FE_ERP_SOURCING] 采购与寻源生命周期 (Procurement)

  • 业务收益:标准化采购流程,降低采购溢价与虚假发货风险。
  • 核心目标:实现从 AGI 建议转采购单 (PO) 的全自动流程,支持质检 (QC) 结果录入与入库单同步。
  • 参考路径dashboard/src/pages/erp/sourcing/

[FE_ERP_WMS] AGI 驱动的智能仓储 (WMS Ops)

  • 业务收益:提升仓库作业效率,减少拣货路径冗余。
  • 核心目标:提供库位管理的可视化视图,支持基于销量预测的库内移库建议。
  • 参考路径dashboard/src/pages/erp/wms/

[FE_ERP_LOG] 跨境物流与面单中心 (Logistics Hub)

  • 业务收益:自动化物流对账与轨迹监控,降低丢包率。
  • 核心目标:实现多渠道运费实时比价、面单批量生成与包裹轨迹全链路监测。
  • 参考路径dashboard/src/pages/erp/logistics/

[ERP_OMS_01] 订单全生命周期状态机加固 (OMS FSM)

  • 业务收益:支持跨平台订单的统一调度与批量化处理,提升人效。
  • 核心目标:升级 OrderService,支持 PENDING_AUDIT (待审), WAITING_SHIPMENT (待发), EXCEPTION (异常) 等细分状态与批量转换。
  • 参考路径server/src/domains/Trade/OrderService.ts

[FE_OMS_01] 统一订单工作台 (OMS Workbench)

  • 交互收益:提供类似“易仓”的订单列表处理体验,支持多维过滤与批量操作。
  • 核心目标:实现订单列表页,集成批量审核、一键发货、异常标记、导出。
  • 参考路径dashboard/src/pages/erp/oms/

[ERP_FIN_01] 财务对账与收支差异分析引擎 (Reconciliation)

  • 金融收益:自动识别平台结算与实际订单的差异(运费、税费、退款),防止资金流失。
  • 核心目标:实现 FinanceReconService,支持 CSV/API 账单导入、自动对齐、差异生成。
  • 参考路径server/src/domains/Finance/FinanceReconService.ts

[FE_FIN_01] 财务对账与收支日历 (Finance Calendar)

  • 交互收益:通过时间轴直观展示收支节奏,并支持差异项一键下钻至订单明细。
  • 核心目标:实现财务总览看板,包含收支日历、差异对账列表、现金流预测图。
  • 参考路径dashboard/src/pages/erp/finance/

[ERP_TASK_01] 统一任务中枢与分发引擎 (Task Hub)

  • 业务收益:将 Advice, Alert, Approval, PO, RMA 等多源事件归一化,消除信息碎片化。
  • 核心目标:实现 UnifiedTaskService,支持任务的「认领/转派/完成」状态流转与 TTL 自动失效。
  • 参考路径server/src/domains/Governance/TaskService.ts

[FE_INBOX_01] 统一任务收件箱 (Global Inbox UI)

  • 交互收益:提供一站式待办视图,支持按来源模块、优先级、截止时间过滤。
  • 核心目标:实现 Inbox 列表页,集成「一键认领」与「详情穿透」功能。
  • 参考路径dashboard/src/pages/governance/inbox/

[ERP_APPROVE_01] 通用审批流引擎 (Approval Engine)

  • 安全收益:对敏感动作(大额调价、资金划转)实施多级人工门禁,满足合规审计。
  • 核心目标:实现 ApprovalFlowService,支持按金额阈值、多租户/多角色规则的动态编排。
  • 参考路径server/src/domains/Governance/ApprovalService.ts

[FE_APPROVE_01] 通用审批中心 (Approval Center UI)

  • 交互收益统一敏感动作的确认界面展示变更前后对比、AGI 建议与影响评估。
  • 核心目标:实现审批详情对话框,集成「同意/拒绝/修改后通过」动作。
  • 参考路径dashboard/src/components/Approval/

[FE_REP_BI] 自助分析与 AGI 报表生成 (BI Center)

  • 决策收益:通过自然语言提问生成多维分析视图,降低数据获取门槛。
  • 核心目标:实现「维度-指标」拖拽分析界面,支持 AGI 语义解析生成 G2 图表。
  • 参考路径dashboard/src/pages/analytics/bi/

[ERP_CRM_01] 客户 360 视图与商机中枢 (CRM Hub)

  • 业务收益:打通 TOC/TOB 客户的全生命周期数据,沉淀信用资产。
  • 核心目标:实现 Customer360Service,聚合订单历史、客诉记录、财务往来与信用分。
  • 参考路径server/src/domains/Customer/CRMService.ts

[FE_CRM_01] 客户 360 档案与商机看板 (CRM UI)

  • 交互收益:一键直达客户画像,可视化 B2B 商机漏斗(线索 -> 报价 -> 回款)。
  • 核心目标:实现客户详情页与商机漏斗图组件。
  • 参考路径dashboard/src/pages/business/crm/

[CORE_GOV_EXP] AB 实验与策略分桶平台 (Experiment Hub)

  • 战略收益:科学评估 AGI 策略效果,支持灰度发布,降低全局误操作风险。
  • 核心目标:实现 ExperimentService,支持按用户/店铺/节点的实验分桶与 KPI 对比分析。
  • 参考路径server/src/core/governance/ExperimentService.ts

[FE_ALRT_01] 统一告警与可观测性中心 (Alert Center UI)

  • 运维收益:秒级感知节点异常与业务跌价风险,支持订阅与静音管理。
  • 核心目标:实现全局告警列表,展示触发条件、影响对象与 AGI 自愈尝试记录。
  • 参考路径dashboard/src/pages/governance/alerts/

🛡️ 0. 全局生产级交付校验 (Production Readiness Gates)

所有任务在标记为 completed 前,必须通过以下红线审计:

  1. Zero-Mock 校验:实现代码中严禁包含任何模拟数据返回。所有业务输出必须来自 cf_ 数据库表或第三方生产 API。
  2. Schema 闭环校验:如果涉及新字段或新表,必须在 LegacyTableInitializer.ts 中完成 initTable 实现并执行成功。
  3. 因果链校验:通过 DecisionExplainabilityEngine.logDecision 记录真实的决策逻辑。
  4. 影子测试校验AI-2 必须产出对应的冒烟测试用例,验证逻辑非“空壳”。
  5. 全栈联调校验 (Full-Stack Sync)
    • 确保后端 SUGGESTED 状态的建议能真实流转至前端 ReviewWorkbench
    • 严禁只有后端逻辑而无前端呈现方案。
    • 前端操作Approve/Reject必须真实触发后端业务变更。

[BIZ_TRADE_70] 全球保税仓调拨与跨境合规 (Bonded Warehouse)

  • 交付收益:优化跨境物流税费,实现“先入仓后报关”的灵活库存调度。
  • 核心目标:实现 BondedWarehouseService,支持保税仓入库单与出库单自动映射。
  • 参考路径BondedWarehouseService.ts

[BIZ_INV_40] AGI 自治仓储调度与库内优化 (Autonomous Warehousing)

  • 效率收益:利用 AGI 预测库内操作热度,动态优化拣货路径与补货时机。
  • 核心目标:实现 AutonomousWarehousingService,联动 WMS 接口进行指令编排。
  • 参考路径AutonomousWarehousingService.ts

[SOV_NET_06] 基于 Libp2p/WebRTC 的节点直连通信 (P2P Connectivity)

  • 战略收益:打破中心化网关依赖,实现 Hub 节点间的亚秒级直连通信,提升资源交换效率 300%。
  • 核心目标:实现 P2PConnectionService,利用 libp2pWebRTC 构建加密的双向流通道。
  • 参考路径P2PConnectionService.ts

[SOV_NET_07] 基于 ZKP 的隐私声誉分值证明 (ZKP Reputation)

  • 隐私收益:允许节点在不公开具体交易细节与分值前提下,向合作伙伴证明其信用等级满足 P2P 准入门槛。
  • 核心目标:实现 ReputationZKPService,利用 circom 生成声誉范围证明Range Proof
  • 参考路径ReputationZKPService.ts

[SOV_NET_08] 节点声誉衰减与惩罚机制 (Reputation Decay)

  • 治理收益:建立动态信任模型,确保声誉真实反映节点当前的合规性与活跃度。
  • 核心目标:升级 SovereignReputationV2Service,实现基于半衰期算法的自动衰减逻辑。
  • 参考路径SovereignReputationV2Service.ts

🏗️ 1. 深度智能与内核进化 (Domain: CORE_AI / CORE_DEV)

[CORE_AI_40] AGI 策略自进化闭环验证 (Evolution Loop)

  • 战略收益:建立 AI 决策的自我修正机制,减少人工干预成本 70%。
  • 核心目标
    1. 闭环反馈:将 ConsumerOrderService 的真实成交数据回流至 AGIStrategyEvolutionService
    2. 自动微调AGI 代理基于利润反馈自动调整选品与调价 Prompt。
  • 参考路径AGIStrategyEvolutionService.ts

[CORE_AI_22] 多模态 SKU 情感分析与评论生成 (Sentiment AI)

  • 业务收益:提升详情页转化率 30%,自动生成地道营销文案。
  • 核心目标:融合商品图片(视觉)与历史抓取的评价文本,分析痛点并生成高说服力评论。
  • 参考路径SentimentAnalysisService.ts

[CORE_DEV_30] 无限水平扩展的 AGI 推理节点调度 (Infinity Compute)

  • 技术收益:支撑千万级并发 AGI 任务,亚秒级算力动态编排。
  • 核心目标:实现租户级配额隔离与算力池动态扩缩容。
  • 参考路径InfinityComputeService.ts

🔒 2. 主权安全与隐私计算 (Domain: CORE_SEC)

[CORE_SEC_20] 基于零知识证明 (ZKP) 的全流程隐私审计 (Private Audit)

  • 合规收益:在不解密原始数据前提下完成全量合规审计,保护商户主权。
  • 核心目标:利用 circom 或类似技术实现利润与成本的隐私汇总计算。
  • 参考路径PrivateAuditService.ts

[CORE_SEC_35] 全同态加密 (FHE) 利润敏感度审计 (FHE Audit)

  • 安全收益:密文态运算,确保单租户特定策略绝不泄露。
  • 核心目标:实现对加密状态下的财务字段执行加法与平均值运算。
  • 参考路径HomomorphicService.ts

📈 3. 贸易自治与业务扩展 (Domain: BIZ_TRADE / BIZ_FIN)

[BIZ_FIN_161] 订单级 P&L 实时穿透分析建议 (P&L Analysis)

  • 透明收益:还原每笔订单的真实净利,剔除摊销、汇损等隐形成本。
  • 核心目标:实现 OrderProfitService,通过穿透式计算,为租户提供最真实的毛利视角。
  • 参考路径OrderProfitService.ts

[BIZ_FIN_162] 多币种自动锁汇避险建议 (FX Hedge)

  • 避险收益:在汇率剧烈波动时,自动建议锁定结汇汇率,保护外贸利润。
  • 核心目标:监控汇率波动率,识别 CRITICAL 风险并生成锁汇指令建议。
  • 参考路径CurrencyRiskService.ts

[BIZ_FIN_164] 调价策略导致的毛利漂移分析 (Margin Drift)

  • 质量收益评估动态调价的效果识别毛利侵蚀Erosion风险。
  • 核心目标:分析 SKU 毛利趋势,对比调价前后的收益变化。
  • 参考路径PricingAuditService.ts

[BIZ_FIN_165] 广告 ROAS 真实性本地归因建议 (Ad Attribution)

  • 归因收益:识破平台广告虚假繁荣,计算剔除自然单后的真实 ROAS。
  • 核心目标:对比总订单流与广告点击流,计算 trueROASorganicRevenue
  • 参考路径TrueROASService.ts

[BIZ_FIN_166] 各国 VAT 税务起征点自动提醒 (VAT Watch)

  • 合规收益:防止因销售额超标导致的补税与罚款风险。
  • 核心目标监控各目的国年度销售额在接近起征点70%/90%)时触发预警。
  • 参考路径TaxComplianceService.ts

[BIZ_FIN_167] 采购预付款比例信用分级调整 (Vendor Credit)

  • 流动性收益:根据供应商绩效动态优化预付款,释放沉淀资金。
  • 核心目标:实现 VendorCreditService,对高信用供应商建议降低预付款。
  • 参考路径VendorCreditService.ts

[BIZ_FIN_168] 未来 30 天现金流枯竭预警 (Cashflow Burn)

  • 生存收益:联动采购、物流、销售全链路,预判资金链断裂风险。
  • 核心目标:计算未来 30 天的待收与待付,生成 projectedCash 风险评估。
  • 参考路径CashflowPredictor.ts

[BIZ_FIN_169] 租户资源超限自动计费单生成 (Billing Engine)

  • 营收收益自动化处理按需付费Pay-as-you-go场景降低漏收风险。
  • 核心目标:实现 BillingEngine,对超限的 AI 调用或存储空间自动生成计费单。
  • 参考路径BillingEngine.ts

[BIZ_FIN_170-200] 业务财务自动化服务矩阵 (Finance Domain Expansion)

  • 核心收益:实现了从 SKU 效率、回款风险、库存跌价到税务合规、预算管理、审计监控的 31 项财务自治服务。
  • 核心目标
    • Killer: SKUEfficiencyService 识别亏损 SKU。
    • Leverage: PayoutCycleService 评估资金杠杆。
    • Write-down: InventoryValueService 计提跌价准备。
    • Freeze: RefundRiskService 预警退款风险。
    • Terms: PaymentTermsService 优化账期。
    • Remit: RemitPathService 优化汇款路径。
    • Valuation: StockAuditService 审计全球库存价值。
    • Ad Budget: AdOptimizerService 分配营销预算。
    • Tenant Profit: TenantHealthService 监控 P&L 波动。
    • Rebate: RebateService 追踪采购回扣。
    • Loss Audit: FinancialAuditService 审计操作损耗。
    • Amortization: ExpenseService 科学摊销成本。
    • Commodity: MaterialRiskService 预判原材料涨价。
    • Refund Audit: RefundAuditService 审计退款一致性。
    • CAC: CACThresholdService 设定获客上限。
    • Split: CommissionService 自动结算分销利润。
    • Turnover: TurnoverWatchdog 识别资金沉淀。
    • Provision: WarrantyService 计提售后准备金。
    • Filing: TaxFilingAdvisor 预填税务申报。
    • Low Margin: MarginProtector 拦截亏损订单。
    • Credit Limit: CreditMonitorService 监控供应商信用。
    • Transfer Pricing: LegalTaxService 评估跨境合规。
    • Payout Optimizer: PayoutOptimizer 优化提现手续费。
    • Budgeting: FinancialPlanner 生成 AI 预算。
    • Gateway Risk: PaymentRiskService 监控支付网关。
    • Shipping Optimizer: DynamicShippingService 优化包邮门槛。
    • Campaign Health: CampaignHealthService 监控营销 ROI。
    • Savings Audit: SavingTrackerService 审计采购降本。
    • Claim Fraud: ClaimFraudService 拦截恶意索赔。
    • Balance Sheet: GlobalBalanceSheet 实时资产快照。
    • AI Guard: ComplianceAIGuard 最终合规自查。
  • 参考路径Finance Domain

[BIZ_FIN_170] 周期性亏损 SKU 淘汰建议报告 (Killer)

  • 业务收益精准识别“利润黑洞”SKU优化库存周转率与现金流。
  • 核心目标:实现 SKUEfficiencyService,基于过去 30 天真实 P&L 自动生成淘汰/保留建议。
  • 参考路径SKUEfficiencyService.ts

[BIZ_FIN_171] 多平台回款周期差异风险评估 (Leverage)

  • 财务收益预警由于回款周期Payout Cycle过长导致的资金链杠杆风险。
  • 核心目标监控各平台Amazon, Temu 等)的平均结算周期,评估风险级别。
  • 参考路径PayoutCycleService.ts

[BIZ_FIN_172] 库存跌价准备自动计提建议 (Write-down)

  • 合规收益:符合会计准则,实时评估滞销库存的资产减值风险。
  • 核心目标基于库龄Aging自动计算跌价准备金建议财务计提。
  • 参考路径InventoryValueService.ts

[BIZ_FIN_173] 高额退款导致的资金链冻结预警 (Freeze)

  • 风控收益:提前识别由于争议率/退款率过高导致的支付网关PayPal/Stripe冻结风险。
  • 核心目标:监控 refundRatio,触发 CRITICAL 级别预警与现金流储备建议。
  • 参考路径RefundRiskService.ts

[BIZ_FIN_174] 供应商账期自动展期/缩短建议 (Terms)

  • 资金收益:基于供应商绩效动态优化付款条件,平衡供应链稳定性与现金流。
  • 核心目标:评估供应商 SLA交期、质量给出 EXTENDSHORTEN 建议。
  • 参考路径PaymentTermsService.ts

[BIZ_FIN_175] 跨境汇款路径手续费选优建议 (Remit)

  • 降本收益实时对比多条汇款路径Wise, PingPong, Payoneer降低跨境汇损。
  • 核心目标:基于汇款金额与币种,自动推荐综合评分最高的结算路径。
  • 参考路径RemitPathService.ts

[BIZ_FIN_176] 虚拟仓/海外仓库存估值审计 (Valuation)

  • 财务收益符合会计准则FIFO/加权平均),实时掌握全球库存资产价值。
  • 核心目标:实现 StockAuditService,支持跨仓库、多币种的库存估值。
  • 参考路径StockAuditService.ts

[BIZ_FIN_177] 多渠道广告支出预算分配建议 (Ad Budget)

  • 增长收益基于边缘毛利Contribution Margin自动优化广告预算提升 ROAS。
  • 核心目标:实现 AdOptimizerService,识别高 ROI SKU 并建议预算向其倾斜。
  • 参考路径AdOptimizerService.ts

[BIZ_FIN_178] 租户层级 P&L 波动根因分析 (Tenant Profit)

  • 治理收益:秒级感知经营异常,自动定位导致利润下滑的“黑天鹅”因素。
  • 核心目标:监控每日 P&L 变化,触发异常波动(>20%)的自动化归因报告。
  • 参考路径TenantHealthService.ts

[BIZ_FIN_179] 供应商佣金回扣与折扣追踪 (Rebate)

  • 采购收益自动识别符合阶梯折扣或回扣Rebate条件的采购量挽回隐藏利润。
  • 核心目标:追踪 totalVolume,提醒采购专员发起回扣索赔。
  • 参考路径RebateService.ts

[BIZ_FIN_180] 员工/Agent 操作财务损失审计 (Loss Audit)

  • 审计收益:透明化运营成本,识别由于误操作或恶意行为导致的财务损耗。
  • 核心目标:审计退款、改价、取消订单等敏感行为,计算预估损失。
  • 参考路径FinancialAuditService.ts

[BIZ_FIN_181] 多平台合规成本摊销建议 (Amortization)

  • 会计收益:将 ERP、工具费等固定/变动合规成本科学摊销至单笔订单。
  • 核心目标:实现 ExpenseService,计算 costPerOrder,还原真实经营毛利。
  • 参考路径ExpenseService.ts

[BIZ_FIN_182] 大宗商品价格波动对采购成本的影响预测 (Commodity)

  • 风险收益:提前识别原材料涨价风险,自动建议备货或套期保值策略。
  • 核心目标:实现 MaterialRiskService,监控铜、钢、原油等大宗商品行情并生成建议。
  • 参考路径MaterialRiskService.ts

[BIZ_FIN_183] 售后退款路径原路返回一致性审计 (Refund Audit)

  • 合规收益:防止内部舞弊或反洗钱合规风险,确保资金流向闭环。
  • 核心目标:实现 RefundAuditService,强制校验退款路径与原始支付路径的一致性。
  • 参考路径RefundAuditService.ts

[BIZ_FIN_184] 基于用户 LTV 的营销成本上限建议 (CAC)

  • 盈利收益动态设定各渠道的获客成本CAC红线确保长期 LTV/CAC 比率健康。
  • 核心目标:实现 CACThresholdService,根据 LTV 预测自动计算允许的最高获客成本。
  • 参考路径CACThresholdService.ts

[BIZ_FIN_185] 全球分销网络利润分成自动结算 (Split)

  • 渠道收益:自动化处理复杂的分销分润,降低人工对账成本 100%。
  • 核心目标:实现 CommissionService,支持多层级 referral 分润与状态追踪。
  • 参考路径CommissionService.ts

[BIZ_FIN_186] 库存周转率异常导致的资金占用预警 (Turnover)

  • 流动性收益:识别沉淀资金,通过加速周转提升整体资本回报率。
  • 核心目标:实现 TurnoverWatchdog,监控 daysToTurnover 指标并触发积压预警。
  • 参考路径TurnoverWatchdog.ts

**[BIZ_FIN_187] 基于历史数据的售后损耗准备金建议 (Provision)

  • 稳健收益:根据 AGI 预测的损耗率计提准备金,使财务报表更真实地反映风险。
  • 核心目标:实现 WarrantyService,基于历史 lossRatio 自动建议月度计提金额。
  • 参考路径WarrantyService.ts

**[BIZ_FIN_188] 多国税务合规申报文件自动预填建议 (Filing)

  • 合规收益:极大简化跨境电商的税务申报流程,降低逾期申报风险。
  • 核心目标:实现 TaxFilingAdvisor,根据各订单目的国税率与销售额,自动生成申报建议。
  • 参考路径TaxFilingAdvisor.ts

**[BIZ_FIN_189] 异常低毛利订单强制拦截建议 (Low Margin)

  • 风控收益:作为最后一道防线,识别由于配置错误(如调价异常)导致的亏本订单。
  • 核心目标:实现 MarginProtector,在订单对账阶段实时检测毛利率,并触发拦截。
  • 参考路径MarginProtector.ts

**[BIZ_FIN_190] 供应商信用额度自动预警 (Credit Limit)

  • 供应链收益:预防由于欠款超过信用额度导致的采购中断。
  • 核心目标:实现 CreditMonitorService,监控各供应商的已用额度与剩余额度。
  • 参考路径CreditMonitorService.ts

**[BIZ_FIN_191] 跨国转让定价合规性建议 (Transfer Pricing)

  • 法律收益:预防国际贸易中的反避税调查风险,合规规划全球利润分布。
  • 核心目标:实现 LegalTaxService,监控大额跨境交易额,识别潜在合规审计风险。
  • 参考路径LegalTaxService.ts

**[BIZ_FIN_192] 多平台提现手续费阶梯优化建议 (Payout Optimizer)

  • 降本收益:通过科学的提现时机与额度建议,降低平均提现手续费 10-20%。
  • 核心目标:实现 PayoutOptimizer,基于平台阶梯费率模型建议最佳提现动作。
  • 参考路径PayoutOptimizer.ts

[BIZ_FIN_193] 基于 AI 预测的年度财务预算生成 (Budgeting)

  • 战略收益:从经验决策转向数据驱动的预算编排,提升资金分配效率。
  • 核心目标:实现 FinancialPlanner,基于历史趋势自动生成明年的营收与成本预算草案。
  • 参考路径FinancialPlanner.ts

[BIZ_FIN_194] 高频取消订单导致的支付网关风险预警 (Gateway Risk)

  • 风控收益识别由于订单取消率异常波动导致的支付通道PayPal/Stripe封禁风险。
  • 核心目标:实现 PaymentRiskService,监控 cancellationRatio 并触发网关保护建议。
  • 参考路径PaymentRiskService.ts

[BIZ_FIN_195] 基于实时毛利的动态运费模板建议 (Shipping Optimizer)

  • 利润收益:根据各目的地国家的实时物流成本与订单毛利,动态建议包邮门槛。
  • 核心目标:实现 DynamicShippingService,计算最优 freeShippingThreshold
  • 参考路径DynamicShippingService.ts

[BIZ_FIN_196] 营销活动盈亏平衡点实时监控 (Campaign Health)

  • 决策收益:秒级发现正在亏损的营销活动,防止广告预算的无效浪费。
  • 核心目标:实现 CampaignHealthService,实时计算 currentROAS vs breakEvenROAS
  • 参考路径CampaignHealthService.ts

[BIZ_FIN_197] 供应商年度框架协议降本达成度审计 (Savings Audit)

  • 绩效收益:量化采购团队的降本贡献,确保供应商框架协议的真实执行。
  • 核心目标:实现 SavingTrackerService,对比 base_priceactual_price 计算真实降本。
  • 参考路径SavingTrackerService.ts

[BIZ_FIN_198] 基于用户行为特征的恶意索赔拦截 (Claim Fraud)

  • 风控收益:识别并拦截高频索赔的“职业薅羊毛”账户,保护租户利润空间。
  • 核心目标:实现 ClaimFraudService,基于 claimToOrderRatio 自动识别欺诈风险。
  • 参考路径ClaimFraudService.ts

[BIZ_FIN_199] 全球多币种资产负债表实时快照 (Balance Sheet)

  • 估值收益:为租户提供秒级的资产负债全景,支持企业融资与决策。
  • 核心目标:实现 GlobalBalanceSheet,实时汇总 Inventory Value、Payouts 与 Liabilities。
  • 参考路径GlobalBalanceSheet.ts

[BIZ_FIN_200] 基于 AGI 的全自动审计与合规性自查 (AI Guard)

  • 合规收益:最终合规防线,利用 AGI 遍历全量审计日志,识别任何潜在的财务违规行为。
  • 核心目标:实现 ComplianceAIGuard,对敏感操作(如 DELETE/FORCE_REFUND进行 AI 穿透式审计。
  • 参考路径ComplianceAIGuard.ts

[BIZ_OPS_01] 多平台订单实时同步与状态流转 (Order Sync)

  • 业务收益:统一订单中枢,减少人工多后台操作时间 90%。
  • 核心目标
    1. 实时归集:从 Amazon/AliExpress/Shopify 实时抓取并映射至统一订单模型。
    2. 自动分账:支付成功后自动触发 Owner/Manager 利润分配。
  • 参考路径ConsumerOrderService.ts

[BIZ_FIN_23] 跨主权多资产实时结算网关 (Multi-Asset Settlement)

  • 金融收益:支持法币与数字资产混合清算,降低跨境汇损 3-5%。
  • 核心目标:构建去中心化结算协议,实现亚秒级跨租户资金对冲。
  • 参考路径MultiAssetSettlementService.ts

[BIZ_FIN_05] 全球发票自动化生成与合规引擎 (Auto-Invoicing)

  • 合规收益根据订单与目的地国家法律VAT/GST自动生成合规发票减少人工开票成本。
  • 核心目标:实现 InvoicingService,支持多国税率动态计算与 PDF/电子发票生成。
  • 参考路径InvoicingService.ts

[BIZ_FIN_12] 实时现金流预测与资金调度 (Cashflow Forecasting)

  • 财务收益:利用 AI 预测未来 30 天收支风险,自动优化资金分配。
  • 核心目标:聚合 cf_orders (待结) 与 cf_purchase_orders (待付) 数据,生成风险评级。
  • 参考路径CashflowForecastService.ts

[BIZ_FIN_14] 跨租户大宗商品价格对冲对账 (Commodity Hedging)

  • 避险收益:为原材料敏感型租户提供大宗商品(油、金、钢)的价格对冲策略建议。
  • 核心目标:实时监控大宗行情,跨租户执行虚拟对冲对账。
  • 参考路径CommodityHedgingService.ts

[BIZ_FIN_18] 跨租户大宗商品集中采购议价池 (Pool Sourcing)

  • 降本收益:利用规模效应,自动合并跨租户的相似原材料采购需求,增强议价能力。
  • 核心目标:建立 cf_sourcing_pools,支持“拼单”采购模式。
  • 参考路径PoolSourcingService.ts

[BIZ_FIN_25] 主权财富基金与集体投资协议 (Sovereign Wealth Fund)

  • 生态收益:允许租户将闲置利润投入生态基金,共享基础设施优化收益。
  • 核心目标:基于 Shapley Value 算法模拟分红,实现生态内部资本循环。
  • 参考路径SovereignWealthFundService.ts

🎨 4. 治理遥测与沉浸交互 (Domain: UX / CORE_TELE / LOGISTICS)

[BIZ_SC_13] 供应商绩效自动评分模型 (Supplier Scoring Model)

  • 风控收益:基于交付时效、质检合格率、价格波动等多维数据自动淘汰劣质供应商。
  • 核心目标:建立 cf_supplier_scores 模型,为 TradeService 提供采购决策依据。
  • 参考路径SupplierScoringService.ts

[BIZ_TRADE_14] 最后一公里配送成本优化模型 (Last-Mile Optimizer)

  • 效率收益:利用 TSP 算法动态优化派送路径,降低末端物流成本 15%。
  • 核心目标:基于包裹密度热力图实现智能排单。
  • 参考路径LastMileOptimizerService.ts

[BIZ_TRADE_18] 全球物流拥堵预测与自适应绕路建议 (Congestion Failover)

  • 时效收益:分钟级响应全球港口/枢纽拥堵,自动切换备选物流方案。
  • 核心目标:监控 cf_congestion_history,在危机发生前实现自动路由迁移。
  • 参考路径CongestionFailoverService.ts

[BIZ_AUTO_03] 多渠道营销日历自动执行 (Marketing Calendar)

  • 增长收益:消除人工多平台改价操作,实现全球大促“秒级”联动。
  • 核心目标:自动化执行折扣、优惠券发放及库存锁定。
  • 参考路径MarketingCalendarService.ts

[BIZ_MKT_14] 社交媒体趋势实时对齐与选品反馈 (Social Pulse)

  • 爆款收益:将 TikTok/Instagram 热门趋势词与 AGI 选品引擎对齐,发现蓝海商机。
  • 核心目标:实现 SocialPulseService,支持多语种语义归并。
  • 参考路径SocialPulseService.ts

[BIZ_BILL_01] 企业配额与订阅计费中心 (Quota & Subscription Billing)

  • 业务收益:建立稳定经常性收入模型,支持 TOB/TOC 双线商业化。
  • 技术规格
    1. 数据模型 (Table: cf_tenant_quota):
      • tenant_id (PK), seats_limit, shops_limit, nodes_limit, task_monthly_limit, ai_call_limit.
    2. 计费 API:
      • POST /api/billing/subscribe: 激活套餐并重置配额。
      • GET /api/billing/usage: 获取当前租户的五维用量实时百分比。
  • 参考路径server/src/domains/Billing/

[BIZ_CRM_10] 智能售后与客户成功中枢 (After-Sales & CSM)

  • 业务收益:降低退款与纠纷成本,提升复购率与品牌评分。
  • 技术规格
    1. 状态机 (FSM): PENDING_REVIEW -> AI_ANALYZING -> AUTO_APPROVED | MANUAL_INTERVENE -> RESOLVED.
    2. 核心逻辑: 对接 ArbitrageService 自动核算退款对净利的影响,若退款后 ROI 仍符合红线则由 AGI 自动放行。
  • 参考路径server/src/domains/Customer/

[BIZ_INT_12] 企业集成网关 (SSO + Webhook + OpenAPI)

  • 业务收益:缩短企业客户实施周期,提升交付标准化能力。
  • 技术规格
    1. Webhook 事件总线: 支持 order.created, inventory.low, arbitrage.found 等 10+ 事件。
    2. 安全机制: 采用 HMAC-SHA256 签名Header 携带 X-Crawlful-Signature
  • 参考路径server/src/api/internal/

🎨 4. 治理遥测与沉浸交互 (Domain: UX / CORE_TELE)

BIZ_GOV_BEHAVIORAL_RISK: 租户行为风险监控 (Behavioral Risk)

  • ID: BIZ_GOV_09
  • Owner: AI-2
  • Status: completed (Batch 49)
  • Features:
    • BehavioralRiskService.analyzePatterns: 自动化模式分析 (撞库/高频/枚举).
    • RiskScoring: 动态评分 (0-100) + 级别联动.
    • AGIKillSwitch: 触发高危风险实时熔断.

BIZ_AUDIT_DATA_COMPLIANCE: 跨区域数据合规扫描 (Data Compliance)

  • ID: BIZ_AUDIT_DATA_COMPLIANCE
  • Owner: AI-2
  • Status: completed (Batch 49)
  • Features:
    • DataComplianceService: 实时扫描跨国/跨区域数据调用路径.
    • ComplianceMiddleware: (TBD Integration with API routes).

BIZ_AUDIT_AGENT_TRACE: AI 代理轨迹审计 (Agent Trace)

  • ID: BIZ_AUDIT_14
  • Owner: AI-2
  • Status: completed (Batch 49)
  • Features:
    • AgentTraceAuditService: 全生命周期轨迹审计.
    • Reasoning Evidence: 联动 ExplainableAIService 获取决策依据.
    • Audit存证: 决策因果链路的持久化.

UX_XAI_01: AGI 决策可解释性看板 (XAI Dashboard)

  • 用户收益:建立人机信任,让商户看懂 AI 为何调价或选品。
  • 核心目标:展示 AGI 决策因果链路 (Causal Chain) 与影响因子热力图。
  • 参考路径DecisionExplainabilityEngine.ts

[UX_VR_02] AGI 驱动的实时虚拟供应链数字孪生 (Digital Twin)

  • 交互收益:可视化全球货流与仓储风险,实现“上帝视角”管理。
  • 核心目标:利用 Three.js 渲染全球 4D 贸易流与海外仓动态热力图。
  • 参考路径dashboard/src/pages/ar-3d/

[BIZ_INV_05] 分布式多仓库存实战同步 (Inventory)

  • 业务收益:防止多平台超卖风险,优化跨仓调拨成本。
  • 技术规格
    1. 锁定机制: 采用 Redis 分布式锁确保 lockStock 操作的原子性。
    2. 跨仓调拨: AI 根据 InventoryRLService 建议生成 TRANSFER 任务,自动更新 cf_inventory 的可用余量。
  • 参考路径server/src/domains/Trade/InventoryRLService.ts

[BIZ_FIN_06] 全自动化利润对账引擎 (Recon)

  • 业务收益:消除财务黑盒,实现每笔订单利润的精准勾稽。
  • 技术规格
    1. 三位一体勾稽: 自动关联 cf_order (收入)、cf_purchase_order (成本)、cf_logistics_route (运费)。
    2. 对账状态机: UNRECONCILED -> AUTO_MATCHED -> RECONCILED | DISCREPANCY.
  • 参考路径server/src/domains/Finance/ReconciliationService.ts

[CORE_AI_50] 多模态 AGI 视觉寻源插件 (Visual Sourcing)

  • 战略收益:通过图片直达源头厂家,提升寻源效率 500%。
  • 核心目标:集成 1688 图片搜索 API利用 CLIP 模型进行特征向量匹配,自动识别源头厂家。
  • 参考路径server/src/services/SupplyChainService.ts

[BIZ_LOG_08] 全球物流轨迹实时遥测 (Tracking)

  • 业务收益:提升买家信任度,降低因轨迹不明导致的纠纷率 40%。
  • 技术规格
    1. 4D 轨迹回传: 实现 LogisticsTrackingService,支持对 cf_order 关联的运单号进行定时拉取。
    2. 异常感知: AI 自动识别“轨迹停滞”、“清关异常”等状态,并触发 SovereignCrisisService 预警。
  • 参考路径server/src/domains/Logistics/LogisticTelemetryService.ts

[BIZ_MKT_15] KOL 达人营销全生命周期管理 (Campaign)

  • 业务收益标准化达人合作流程ROI 提升 25%。
  • 技术规格
    1. 生命周期 FSM: IDENTIFIED -> OUTREACHED -> SAMPLE_SENT -> CONTENT_LIVE -> ROI_TRACKING.
    2. 归因联动: 自动关联 KOLService 中的成交数据,计算达人真实的带货转化率。
  • 参考路径server/src/domains/Marketing/KOLService.ts

[BIZ_PROD_12] AI 商品全自动“清洗”与本地化 (Washer)

  • 业务收益极大降低新品上架成本Listing 本地化质量提升 100%。
  • 技术规格
    1. 语义清洗: 过滤掉原图/原标题中的非法字符、品牌 Logo 及无效关键词。
    2. 多模态增强: 利用 VisionFactoryService 自动生成符合目标市场审美(如:中东/东南亚风格)的营销图。
  • 参考路径server/src/services/ProductService.ts

[CORE_SEC_45] 租户数据主权隔离门禁 (Isolation)

  • 安全收益:从底层杜绝越权访问,确保租户数据主权绝对隔离。
  • 技术规格
    1. 隔离拦截器: 实现 MultiTenantCore.from(tenantId, table) 模式,强制所有查询必须通过该门禁。
    2. 所有权校验: 提供 ensureOwnership 方法,在执行更新/删除前强制校验记录归属。
  • 落地代码MultiTenantCore.ts

[BIZ_GOV_20] 全量业务事件审计流水线 (Audit Log)

  • 治理收益满足企业级合规审计要求100% 记录关键业务变更。
  • 技术规格
    1. 事件钩子: 在 core/runtime 层级实现 DomainEventBus,自动捕获各 Domain 的变更。
    2. 结构化存储: 记录 actor, action, resource, diff, timestamp 四元组。
  • 参考路径server/src/core/runtime/DomainRegistry.ts

[BIZ_TEN_03] 多租户标准交付与流程自动化 (Delivery)

  • 业务收益:标准化交付流程,将专有化部署开通时间从 3 天降至 1 小时。
  • 技术规格
    1. 任务追踪: 实现 cf_delivery_tasks记录每个租户交付项SSO 联送、数据库初始化)的完成状态。
    2. 自动化 API: POST /api/v1/tenant/delivery/start 触发异步交付流水线。
  • 参考路径server/src/domains/Tenant/DeliveryTemplateService.ts

[BIZ_FIN_11] 智能税务筹划与最优申报路径 (Tax AI)

  • 业务收益:自动识别最优税务结构(如 OSS/IOSS平均降低跨境合规成本 15%。
  • 技术规格
    1. 税务建议 API: POST /api/v1/finance/tax/plan 提交经营画像,返回 AGI 生成的税务建议。
    2. 合规登记库: 存储 cf_tax_strategies,支持多国税率动态更新。
  • 参考路径server/src/domains/Finance/TaxPlanningService.ts

[BIZ_ECO_08] 自治危机管理与自愈协议 (Crisis)

  • 生态收益:在黑天鹅事件发生时实现分钟级避险,保护商户资金安全。
  • 技术规格
    1. 熔断器集成: 联动 CongestionFailoverService,在危机发生时自动执行 UPDATE cf_order SET logistics_status = 'REROUTING'
    2. 主权防御 API: GET /api/v1/biz/crisis/active 返回当前全网受灾情况与自愈进度。
  • 参考路径server/src/domains/Trade/SovereignCrisisService.ts

[CORE_ANL_03] 租户经营表现实时聚合中心 (Analytics)

  • 决策收益:提供秒级经营遥测,支持从 $10W 营收下钻到单笔订单的证据链。
  • 技术规格
    1. SQL 聚合: 实现基于 tenant_id 的全量聚合查询SUM Revenue, AVG ROI
    2. 证据链下钻: 联动 AuditLogService 还原 found -> calculate -> review -> publish 的完整证据链。
  • 参考路径server/src/domains/Analytics/AnalyticsService.ts

[BIZ_MKT_20] AGI 广告管家与预算动态优化 (AdOps)

  • 业务收益:将广告 ROI 提升 20% 以上,通过 AGI 自动分配各平台预算。
  • 技术规格
    1. 预算动态分配: 联动 ArbitrageAGIService根据实时转化率TikTok vs FB动态执行 updateBudget
    2. 自动创建计划: AI 根据爆款预测结果,自动生成广告创意(联动 AdCreativeService)并推送到平台。
  • 参考路径server/src/domains/Marketing/AdAutoService.ts

[CORE_ANL_05] 全业务多维经营报表中心 (Reporting)

  • 决策收益:一站式获取经营全貌,自动识别亏损项并生成“决策周报”。
  • 技术规格
    1. 多维报表 API: GET /api/v1/analytics/reports 支持按平台、SKU、时间维度聚合 ROI 与净利。
    2. AI 周报生成: 利用 LLM 对本周经营数据cf_order + cf_pixel_logs进行归因分析生成自然语言总结。
  • 参考路径server/src/domains/Analytics/AnalyticsService.ts

[BIZ_CRE_01] 多模态 AI 创作工作台 (Creative)

  • 业务收益实现营销素材的“零人工”生产TTS 转化率提升 40%,视频生成效率提升 10 倍。
  • 技术规格
    1. TTS 集成: 对接 Minimax API支持 voice_id 选择、语速 (speed)、音调 (pitch) 参数控制。
    2. 任务 FSM: PENDING -> PROCESSING -> COMPLETED | FAILED。支持主图生成、详情图生成、视频翻译任务。
    3. 存储模型: cf_creative_tasks (记录任务参数与状态) + cf_media_assets (记录生成后的 URL 与元数据)。
  • 参考路径server/src/domains/Creative/CreativeService.ts

[BIZ_REP_01] 全业务多维报表体系 (Reports)

  • 决策收益:覆盖全业务链路监控,自动识别恶意订单与财务偏差。
  • 技术规格
    1. 报表矩阵: 实现 Advertiser, GMV Max, Settlement, Malicious Order, Employee Log, Financial, Order, Material, Product, Dept 报表。
    2. 数据勾稽: 联动 cf_order, cf_ad_stats, cf_settlement, cf_audit_log 进行跨表聚合。
  • 参考路径server/src/domains/Analytics/ReportService.ts

📜 历史规格存档 (Archived Specs - V26.0 and below)

请查阅 Git 历史记录或对应版本的存档文档。

[BIZ_MKT_40] 多触点归因与利润分析 (Attribution Engine)

  • 业务收益:识破虚假 ROAS计算剔除自然单后的真实 LTV/CAC 比率,优化营销预算分配。
  • 核心目标:实现 MultiTouchAttributionService,对比总订单流与广告点击流,计算 trueROASorganicRevenue
  • 参考路径MultiTouchAttributionService.ts

[BIZ_FIN_40] 基于 DID 的自治清算协议 (DID Settlement)

  • 金融收益:利用分布式身份 (DID) 自动化品牌方、代运营与达人的三方自动分润,降低结算争议 95%。
  • 核心目标:构建 DIDSettlementService,支持亚秒级清算证据链存证与多级分润逻辑。
  • 参考路径DIDSettlementService.ts

[BIZ_LOG_20] 全球动态路径对冲与风险熔断 (Global Route Failover)

  • 时效收益:在黑天鹅事件(如罢工、港口拥堵)发生时,自动切换最优路径并对冲物流成本上涨风险。
  • 核心目标:升级 LogisticsRoutingService,支持多式联运动态对冲策略与实时成本监控。
  • 参考路径DynamicRoutingFailoverService.ts

[BIZ_INV_20] 强化学习驱动的全球库存平衡 (RL Inventory Balancing)

  • 库存收益:自动决策跨仓调拨,最小化总持仓成本与缺货损失,提升库存周转率。
  • 核心目标:完善 InventoryRLOptimizerService,接入多维成本评估模型与 RL 决策引擎。
  • 参考路径InventoryRLOptimizerService.ts

[BIZ_FIN_50] 跨主权多币种对冲对账引擎 (Multi-Currency Recon)

  • 避险收益:自动化处理由于汇率剧烈波动导致的对账偏差,保护商户资金主权,减少财务人工核对成本 80%。
  • 核心目标:实现 MultiCurrencyHedgingReconService,实时计算 fx_drift 并生成对冲对账单。
  • 参考路径MultiCurrencyHedgingReconService.ts

[BIZ_LOG_30] 最后一公里众包路由优化 (Crowdsourced Last-mile)

  • 韧性收益:在黑天鹅事件导致传统物流商瘫痪时,自动调度众包资源,确保履约不中断。
  • 核心目标:实现 CrowdsourcedLogisticsService,支持多点派送路径计算与成本动态核算。
  • 参考路径CrowdsourcedLogisticsService.ts

[BIZ_TRADE_30] 自动化供应商产能预警 (Supplier Capacity Watch)

  • 交付收益:提前感知供应商交期延误风险,通过 AGI 预测产能饱和度,自动建议切换备选源。
  • 核心目标:实现 SupplierCapacityWatchService,监控 backlog_ratio 并生成风险预警报告。
  • 参考路径SupplierCapacityWatchService.ts

[BIZ_CSM_30] 智能争议仲裁建议 (Dispute Arbitration)

  • 效率收益:自动化处理售后纠纷与退款争议,基于全链路证据链给出公正仲裁建议,降低客服工作量 70%。
  • 核心目标:实现 DisputeArbitrationService,聚合订单、物流、支付全量数据生成仲裁书。
  • 参考路径DisputeArbitrationService.ts

[BIZ_TRADE_40] AGI 驱动的全球合规与制裁扫描 (Compliance Scan)

  • 合规收益:自动化扫描 SKU 与收货地址,防止违反特定国家/地区的贸易禁令(如 OFAC 制裁、出口管制),避免高额罚款。
  • 核心目标:实现 TradeComplianceService,集成全球合规库,提供实时风险评分。
  • 参考路径TradeComplianceService.ts

[BIZ_FIN_70] 基于 ZKP 的链上隐私信用证 (Private L/C)

  • 金融收益:利用 ZKP 保护商业机密,同时向金融机构证明交易真实性,缩短 B2B 结算周期,提升资金周转率。
  • 核心目标:实现 SovereignPrivateLCService,支持链上信用证生成与隐私存证验证。
  • 参考路径SovereignPrivateLCService.ts

[BIZ_LOG_50] 弹性多式联运自动对冲引擎 (Intermodal Failover)

  • 韧性收益:当全球主航道发生黑天鹅事件时,自动计算并执行多式联运切换(如海转铁),最小化时效延误。
  • 核心目标:实现 IntermodalFailoverService,支持动态路由成本核算与自动对冲方案生成。
  • 参考路径IntermodalFailoverService.ts

[SOV_NET_02] 跨节点自治清算协议实现 (Cross-Node Settlement)

  • 网络收益:实现 Hub 节点间的自动化利润分润与资金清算,构建去中心化的全球贸易价值网。
  • 核心目标:实现 CrossNodeSettlementService,联动 DIDSettlementService 处理跨 Hub 的 DID 身份清算。
  • 参考路径CrossNodeSettlementService.ts

[SOV_NET_04] 跨节点争议自动仲裁转发 (Dispute Forwarding)

  • 信任收益:在多节点贸易中,实现证据链的自动化路由与转发,支持跨节点的 AGI 联合仲裁。
  • 核心目标:构建 GlobalDisputeRouter,支持证据链在不同主权节点间的安全传输与同步。
  • 参考路径GlobalDisputeRouter.ts

[BIZ_FIN_80] 跨主权贸易信用保险自动投保建议 (Trade Insurance)

  • 风险收益:针对高价值跨国订单,基于供应商风险评分自动建议投保方案,降低坏账与货损风险。
  • 核心目标:实现 TradeInsuranceService,提供自动化投保建议。
  • 参考路径TradeInsuranceService.ts

[BIZ_TRADE_50] 动态出口管制合规证书自动化生成 (Compliance Certificate)

  • 合规收益:自动生成符合目的国要求的电子合规证书,确保顺畅通关。
  • 核心目标:实现 ComplianceCertificateService,支持证书自动生成与 DID 签名。
  • 参考路径ComplianceCertificateService.ts

[BIZ_LOG_60] 绿色供应链碳信用交易撮合 (Carbon Credit Trading)

  • 绿色收益:撮合碳抵扣额度购买,提升品牌绿色合规等级。
  • 核心目标:实现 CarbonCreditTradingService,支持碳足迹抵扣撮合。
  • 参考路径CarbonCreditTradingService.ts

[BIZ_FIN_90] 跨主权多节点资金流动性自动预测 (Liquidity Forecast)

  • 资金收益:预测全球贸易 Hub 节点的资金缺口,自动建议资金调拨,确保清算平滑。
  • 核心目标:实现 NodeLiquidityForecastService,支持节点流动性预测。
  • 参考路径NodeLiquidityForecastService.ts

[BIZ_TRADE_60] 自动化供应链碳配额质押建议 (Carbon Pledge)

  • 金融收益:允许租户质押碳抵扣额度以获取更优的采购账期。
  • 核心目标:实现 CarbonPledgeService,支持碳配额质押逻辑。
  • 参考路径CarbonPledgeService.ts

[BIZ_LOG_70] 众包物流配送员 DID 信用分级体系 (Courier Credit)

  • 履约收益:建立基于 DID 的配送员信用分级,筛选优质众包资源,降低末端风险。
  • 核心目标:实现 CourierCreditService,支持配送员信用分计算。
  • 参考路径CourierCreditService.ts

🛠️ 5. AGI 诊断与自省规范 (AGI Diagnostics & Self-Awareness)

[CORE_DIAG_01] AGI 异常根因自省规范 (Self-Awareness Protocol)

  • 治理收益:消除静默失败,提升系统自愈效率 90%,实现“问题即文档”。
  • 核心要求
    1. 强制 RCA (Root Cause Analysis):所有阻塞性问题必须输出 CATEGORY/ROOT_CAUSE/MITIGATION 三元组。
    2. 分级上报
      • FATAL:立即停止任务并记录阻塞路径,更新看板 [ISSUE-AI-X]
      • WARN记录降级路径Fallback继续执行非核心任务。
    3. 自查清单 (Checklist)
      • 是否存在 Context 缺失?(需 Read/Search
      • 是否存在逻辑冲突?(需 FSM 校验)
      • 是否存在环境约束?(需 .env/Database 校验)
  • 参考路径.trae/rules/project_rules.md

规格维护者AI-1 (Kernel) | 当前版本V32.0
看板索引collaboration-board.md