makemd/docs/governance/task-specifications.md

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

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

### **[ERP_WMS_01] 拣货路径优化与波次分单算法 (Pick Wave)**
- **技术收益**：基于 AGI 销量预测自动聚合高频 SKU 订单，优化拣货路径，提升仓库作业效率 40%。
- **核心目标**：实现 `WMSWaveService`，支持波次自动生成、路径 TSP 优化与物理表持久化。
- **参考路径**：[WMSWaveService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/WMSWaveService.ts)

### **[ERP_LOG_01] 物流轨迹全链路归一化监控 (Logistics Tracker)**
- **技术收益**：实时识别全球物流轨迹异常（停滞、错投、延误），联动自愈路由降低丢包风险。
- **核心目标**：实现 `LogisticsTrackerService`，支持轨迹异常检测模式匹配与 `reportAnomaly` 联动。
- **参考路径**：[LogisticsTrackerService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/LogisticsTrackerService.ts)

### **[CORE_TELE_ALRT] 统一告警归集与自愈路由 (Alert Hub)**
- **运维收益**：打破信息孤岛，将风控、系统、业务异常统一归集，为 AGI 自愈提供结构化决策输入。
- **核心目标**：实现 `AlertService`，支持告警分级（CRITICAL/ERROR/WARN）、租户聚合与状态管理。
- **参考路径**：[AlertService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/telemetry/AlertService.ts)

### **[ERP_REP_01] 全业务多维报表宽表构建 (Report Mart Aggregator)**
- **技术收益**：通过增量预聚合（Incremental Aggregation）解决大数据量下的报表查询性能瓶颈。
- **核心目标**：在 `ReportService` 中实现预聚合逻辑，将明细表增量同步至 `cf_report_summary` 宽表。
- **参考路径**：[ReportService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Analytics/ReportService.ts)

### **[CORE_TELE_PREDICTIVE_HEALTH] 预测性系统健康度看板 (Predictive Health)**
- **技术收益**：通过时间序列分析预判系统崩溃与性能瓶颈，实现 AGI 级别的自愈能力。
- **核心目标**：实现 `PredictiveHealthService`，基于 Telemetry 数据展示未来 24 小时的健康度预测。
- **参考路径**：[PredictiveHealthService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/telemetry/PredictiveHealthService.ts)

### **[CORE_AI_60] Agent 集群自治协作协议 (Agent Swarm)**
- **战略收益**：打破单 Agent 性能瓶颈，实现多 AGI 实例的复杂任务流水线。
- **核心目标**：实现 `AgentSwarmService`，支持任务在不同特性的 Agent 间自动流转。
- **参考路径**：[AgentSwarmService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/AgentSwarmService.ts)

### **[BIZ_INV_30] 滞销库存深度治理与清仓建议 (Aging Inventory)**
- **利润收益**：降低仓储成本，通过 AGI 自动生成针对滞销 SKU 的阶梯折扣建议。
- **核心目标**：实现 `AgingInventoryService`，联动 `InventoryAgingService` 进行库龄分析。
- **参考路径**：[AgingInventoryService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/AgingInventoryService.ts)

### **[BIZ_MKT_50] AGI 驱动的跨平台套利自动化 (Arbitrage AGI)**
- **战略收益**：秒级识别全球多平台（Amazon, Temu, 1688）价格洼地，全自动执行套利下单。
- **核心目标**：实现 `ArbitrageAGIService`，联动 `ArbitrageService` 锁定套利空间。
- **参考路径**：[ArbitrageAGIService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/ArbitrageAGIService.ts)

### **[BIZ_INV_50] 分布式库存分布优化 (Inventory Distribution)**
- **业务收益**：基于销量热力图动态调整全球各仓库存分布，减少跨区调拨成本 30%。
- **核心目标**：实现 `InventoryDistributionService`，生成 `TRANSFER` 建议。
- **参考路径**：[InventoryDistributionService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/InventoryDistributionService.ts)

### **[BIZ_FIN_210] 跨主权流动性对冲与避险 (Liquidity Hedge)**
- **金融收益**：自动对冲跨境贸易中的流动性风险，确保结算网关资金充沛。
- **核心目标**：实现 `LiquidityHedgingService`，监控各 Hub 节点头寸。
- **参考路径**：[LiquidityHedgingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/LiquidityHedgingService.ts)

### **[BIZ_FIN_220] 供应链微贷与信用评估 (Micro Credit)**
- **金融收益**：基于贸易真实性证据链为租户提供 AGI 授信建议，解决小微外贸融资难。
- **核心目标**：实现 `MicroCreditService`，联动 `cf_order` 真实交易记录。
- **参考路径**：[MicroCreditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/MicroCreditService.ts)

### **[BIZ_SOV_13] 声誉驱动的阶梯费率与流量倾斜 (Reputation Perks)**
- **业务收益**：激励租户维护高信用评分，自动为高信用节点提供更低的结算手续费与优先的资源分配。
- **核心目标**：联动 `BillingService` 与 `TrafficService`，根据声誉分值自动匹配计费 FSM。
- **参考路径**：[BillingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Billing/BillingService.ts)

### **[BIZ_SOV_14] 跨节点资源共享配额管理 (Resource Quota)**
- **网络收益**：防止恶意节点占用全网算力/存储资源，基于声誉实现动态的资源预留与配额管理。
- **核心目标**：实现 `NodeResourceQuotaService`，联动 `InfinityComputeService` 进行配额限制。
- **参考路径**：[NodeResourceQuotaService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/NodeResourceQuotaService.ts)

### **[CORE_TELE_TOPO] 全球节点实时拓扑遥测 (Network Topology)**
- **遥测收益**：提供全球贸易网络的实时连接快照，自动识别高延迟链路并触发路由重排。
- **核心目标**：实现 `NetworkTopologyService`，采集 P2P 通信中的 latency, jitter 与 hop_count。
- **参考路径**：[NetworkTopologyService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/telemetry/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](file:///d:/trae_projects/crawlful-hub/server/src/services/BondedWarehouseService.ts)

### **[BIZ_INV_40] AGI 自治仓储调度与库内优化 (Autonomous Warehousing)**
- **效率收益**：利用 AGI 预测库内操作热度，动态优化拣货路径与补货时机。
- **核心目标**：实现 `AutonomousWarehousingService`，联动 WMS 接口进行指令编排。
- **参考路径**：[AutonomousWarehousingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/services/AutonomousWarehousingService.ts)

---

### **[SOV_NET_06] 基于 Libp2p/WebRTC 的节点直连通信 (P2P Connectivity)**
- **战略收益**：打破中心化网关依赖，实现 Hub 节点间的亚秒级直连通信，提升资源交换效率 300%。
- **核心目标**：实现 `P2PConnectionService`，利用 `libp2p` 或 `WebRTC` 构建加密的双向流通道。
- **参考路径**：[P2PConnectionService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/P2PConnectionService.ts)

### **[SOV_NET_07] 基于 ZKP 的隐私声誉分值证明 (ZKP Reputation)**
- **隐私收益**：允许节点在不公开具体交易细节与分值前提下，向合作伙伴证明其信用等级满足 P2P 准入门槛。
- **核心目标**：实现 `ReputationZKPService`，利用 `circom` 生成声誉范围证明（Range Proof）。
- **参考路径**：[ReputationZKPService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/ReputationZKPService.ts)

### **[SOV_NET_08] 节点声誉衰减与惩罚机制 (Reputation Decay)**
- **治理收益**：建立动态信任模型，确保声誉真实反映节点当前的合规性与活跃度。
- **核心目标**：升级 `SovereignReputationV2Service`，实现基于半衰期算法的自动衰减逻辑。
- **参考路径**：[SovereignReputationV2Service.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/SovereignReputationV2Service.ts)

---

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

### **[CORE_AI_40] AGI 策略自进化闭环验证 (Evolution Loop)**
- **战略收益**：建立 AI 决策的自我修正机制，减少人工干预成本 70%。
- **核心目标**：
    1. **闭环反馈**：将 `ConsumerOrderService` 的真实成交数据回流至 `AGIStrategyEvolutionService`。
    2. **自动微调**：AGI 代理基于利润反馈自动调整选品与调价 Prompt。
- **参考路径**：[AGIStrategyEvolutionService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/AGIStrategyEvolutionService.ts)

### **[CORE_AI_22] 多模态 SKU 情感分析与评论生成 (Sentiment AI)**
- **业务收益**：提升详情页转化率 30%，自动生成地道营销文案。
- **核心目标**：融合商品图片（视觉）与历史抓取的评价文本，分析痛点并生成高说服力评论。
- **参考路径**：[SentimentAnalysisService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/SentimentAnalysisService.ts)

### **[CORE_DEV_30] 无限水平扩展的 AGI 推理节点调度 (Infinity Compute)**
- **技术收益**：支撑千万级并发 AGI 任务，亚秒级算力动态编排。
- **核心目标**：实现租户级配额隔离与算力池动态扩缩容。
- **参考路径**：[InfinityComputeService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/InfinityComputeService.ts)

---

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

### **[CORE_SEC_20] 基于零知识证明 (ZKP) 的全流程隐私审计 (Private Audit)**
- **合规收益**：在不解密原始数据前提下完成全量合规审计，保护商户主权。
- **核心目标**：利用 `circom` 或类似技术实现利润与成本的隐私汇总计算。
- **参考路径**：[PrivateAuditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/PrivateAuditService.ts)

### **[CORE_SEC_35] 全同态加密 (FHE) 利润敏感度审计 (FHE Audit)**
- **安全收益**：密文态运算，确保单租户特定策略绝不泄露。
- **核心目标**：实现对加密状态下的财务字段执行加法与平均值运算。
- **参考路径**：[HomomorphicService.ts](file:///d:/trae_projects/crawlful-hub/server/src/core/security/HomomorphicService.ts)

---

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

### **[BIZ_FIN_161] 订单级 P&L 实时穿透分析建议 (P&L Analysis)**
- **透明收益**：还原每笔订单的真实净利，剔除摊销、汇损等隐形成本。
- **核心目标**：实现 `OrderProfitService`，通过穿透式计算，为租户提供最真实的毛利视角。
- **参考路径**：[OrderProfitService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/OrderProfitService.ts)

### **[BIZ_FIN_162] 多币种自动锁汇避险建议 (FX Hedge)**
- **避险收益**：在汇率剧烈波动时，自动建议锁定结汇汇率，保护外贸利润。
- **核心目标**：监控汇率波动率，识别 CRITICAL 风险并生成锁汇指令建议。
- **参考路径**：[CurrencyRiskService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CurrencyRiskService.ts)

### **[BIZ_FIN_164] 调价策略导致的毛利漂移分析 (Margin Drift)**
- **质量收益**：评估动态调价的效果，识别毛利侵蚀（Erosion）风险。
- **核心目标**：分析 SKU 毛利趋势，对比调价前后的收益变化。
- **参考路径**：[PricingAuditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/PricingAuditService.ts)

### **[BIZ_FIN_165] 广告 ROAS 真实性本地归因建议 (Ad Attribution)**
- **归因收益**：识破平台广告虚假繁荣，计算剔除自然单后的真实 ROAS。
- **核心目标**：对比总订单流与广告点击流，计算 `trueROAS` 与 `organicRevenue`。
- **参考路径**：[TrueROASService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/TrueROASService.ts)

### **[BIZ_FIN_166] 各国 VAT 税务起征点自动提醒 (VAT Watch)**
- **合规收益**：防止因销售额超标导致的补税与罚款风险。
- **核心目标**：监控各目的国年度销售额，在接近起征点（70%/90%）时触发预警。
- **参考路径**：[TaxComplianceService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/TaxComplianceService.ts)

### **[BIZ_FIN_167] 采购预付款比例信用分级调整 (Vendor Credit)**
- **流动性收益**：根据供应商绩效动态优化预付款，释放沉淀资金。
- **核心目标**：实现 `VendorCreditService`，对高信用供应商建议降低预付款。
- **参考路径**：[VendorCreditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/VendorCreditService.ts)

### **[BIZ_FIN_168] 未来 30 天现金流枯竭预警 (Cashflow Burn)**
- **生存收益**：联动采购、物流、销售全链路，预判资金链断裂风险。
- **核心目标**：计算未来 30 天的待收与待付，生成 `projectedCash` 风险评估。
- **参考路径**：[CashflowPredictor.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CashflowPredictor.ts)

### **[BIZ_FIN_169] 租户资源超限自动计费单生成 (Billing Engine)**
- **营收收益**：自动化处理按需付费（Pay-as-you-go）场景，降低漏收风险。
- **核心目标**：实现 `BillingEngine`，对超限的 AI 调用或存储空间自动生成计费单。
- **参考路径**：[BillingEngine.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/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](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/)

### **[BIZ_FIN_170] 周期性亏损 SKU 淘汰建议报告 (Killer)**
- **业务收益**：精准识别“利润黑洞”SKU，优化库存周转率与现金流。
- **核心目标**：实现 `SKUEfficiencyService`，基于过去 30 天真实 P&L 自动生成淘汰/保留建议。
- **参考路径**：[SKUEfficiencyService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/SKUEfficiencyService.ts)

### **[BIZ_FIN_171] 多平台回款周期差异风险评估 (Leverage)**
- **财务收益**：预警由于回款周期（Payout Cycle）过长导致的资金链杠杆风险。
- **核心目标**：监控各平台（Amazon, Temu 等）的平均结算周期，评估风险级别。
- **参考路径**：[PayoutCycleService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/PayoutCycleService.ts)

### **[BIZ_FIN_172] 库存跌价准备自动计提建议 (Write-down)**
- **合规收益**：符合会计准则，实时评估滞销库存的资产减值风险。
- **核心目标**：基于库龄（Aging）自动计算跌价准备金，建议财务计提。
- **参考路径**：[InventoryValueService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/InventoryValueService.ts)

### **[BIZ_FIN_173] 高额退款导致的资金链冻结预警 (Freeze)**
- **风控收益**：提前识别由于争议率/退款率过高导致的支付网关（PayPal/Stripe）冻结风险。
- **核心目标**：监控 `refundRatio`，触发 CRITICAL 级别预警与现金流储备建议。
- **参考路径**：[RefundRiskService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/RefundRiskService.ts)

### **[BIZ_FIN_174] 供应商账期自动展期/缩短建议 (Terms)**
- **资金收益**：基于供应商绩效动态优化付款条件，平衡供应链稳定性与现金流。
- **核心目标**：评估供应商 SLA（交期、质量），给出 `EXTEND` 或 `SHORTEN` 建议。
- **参考路径**：[PaymentTermsService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/PaymentTermsService.ts)

### **[BIZ_FIN_175] 跨境汇款路径手续费选优建议 (Remit)**
- **降本收益**：实时对比多条汇款路径（Wise, PingPong, Payoneer），降低跨境汇损。
- **核心目标**：基于汇款金额与币种，自动推荐综合评分最高的结算路径。
- **参考路径**：[RemitPathService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/RemitPathService.ts)

### **[BIZ_FIN_176] 虚拟仓/海外仓库存估值审计 (Valuation)**
- **财务收益**：符合会计准则（FIFO/加权平均），实时掌握全球库存资产价值。
- **核心目标**：实现 `StockAuditService`，支持跨仓库、多币种的库存估值。
- **参考路径**：[StockAuditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/StockAuditService.ts)

### **[BIZ_FIN_177] 多渠道广告支出预算分配建议 (Ad Budget)**
- **增长收益**：基于边缘毛利（Contribution Margin）自动优化广告预算，提升 ROAS。
- **核心目标**：实现 `AdOptimizerService`，识别高 ROI SKU 并建议预算向其倾斜。
- **参考路径**：[AdOptimizerService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/AdOptimizerService.ts)

### **[BIZ_FIN_178] 租户层级 P&L 波动根因分析 (Tenant Profit)**
- **治理收益**：秒级感知经营异常，自动定位导致利润下滑的“黑天鹅”因素。
- **核心目标**：监控每日 P&L 变化，触发异常波动（>20%）的自动化归因报告。
- **参考路径**：[TenantHealthService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/TenantHealthService.ts)

### **[BIZ_FIN_179] 供应商佣金回扣与折扣追踪 (Rebate)**
- **采购收益**：自动识别符合阶梯折扣或回扣（Rebate）条件的采购量，挽回隐藏利润。
- **核心目标**：追踪 `totalVolume`，提醒采购专员发起回扣索赔。
- **参考路径**：[RebateService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/RebateService.ts)

### **[BIZ_FIN_180] 员工/Agent 操作财务损失审计 (Loss Audit)**
- **审计收益**：透明化运营成本，识别由于误操作或恶意行为导致的财务损耗。
- **核心目标**：审计退款、改价、取消订单等敏感行为，计算预估损失。
- **参考路径**：[FinancialAuditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/FinancialAuditService.ts)

### **[BIZ_FIN_181] 多平台合规成本摊销建议 (Amortization)**
- **会计收益**：将 ERP、工具费等固定/变动合规成本科学摊销至单笔订单。
- **核心目标**：实现 `ExpenseService`，计算 `costPerOrder`，还原真实经营毛利。
- **参考路径**：[ExpenseService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/ExpenseService.ts)

### **[BIZ_FIN_182] 大宗商品价格波动对采购成本的影响预测 (Commodity)**
- **风险收益**：提前识别原材料涨价风险，自动建议备货或套期保值策略。
- **核心目标**：实现 `MaterialRiskService`，监控铜、钢、原油等大宗商品行情并生成建议。
- **参考路径**：[MaterialRiskService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/MaterialRiskService.ts)

### **[BIZ_FIN_183] 售后退款路径原路返回一致性审计 (Refund Audit)**
- **合规收益**：防止内部舞弊或反洗钱合规风险，确保资金流向闭环。
- **核心目标**：实现 `RefundAuditService`，强制校验退款路径与原始支付路径的一致性。
- **参考路径**：[RefundAuditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/RefundAuditService.ts)

### **[BIZ_FIN_184] 基于用户 LTV 的营销成本上限建议 (CAC)**
- **盈利收益**：动态设定各渠道的获客成本（CAC）红线，确保长期 LTV/CAC 比率健康。
- **核心目标**：实现 `CACThresholdService`，根据 LTV 预测自动计算允许的最高获客成本。
- **参考路径**：[CACThresholdService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CACThresholdService.ts)

### **[BIZ_FIN_185] 全球分销网络利润分成自动结算 (Split)**
- **渠道收益**：自动化处理复杂的分销分润，降低人工对账成本 100%。
- **核心目标**：实现 `CommissionService`，支持多层级 referral 分润与状态追踪。
- **参考路径**：[CommissionService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CommissionService.ts)

### **[BIZ_FIN_186] 库存周转率异常导致的资金占用预警 (Turnover)**
- **流动性收益**：识别沉淀资金，通过加速周转提升整体资本回报率。
- **核心目标**：实现 `TurnoverWatchdog`，监控 `daysToTurnover` 指标并触发积压预警。
- **参考路径**：[TurnoverWatchdog.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/TurnoverWatchdog.ts)

### **[BIZ_FIN_187] 基于历史数据的售后损耗准备金建议 (Provision)
- **稳健收益**：根据 AGI 预测的损耗率计提准备金，使财务报表更真实地反映风险。
- **核心目标**：实现 `WarrantyService`，基于历史 `lossRatio` 自动建议月度计提金额。
- **参考路径**：[WarrantyService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/WarrantyService.ts)

### **[BIZ_FIN_188] 多国税务合规申报文件自动预填建议 (Filing)
- **合规收益**：极大简化跨境电商的税务申报流程，降低逾期申报风险。
- **核心目标**：实现 `TaxFilingAdvisor`，根据各订单目的国税率与销售额，自动生成申报建议。
- **参考路径**：[TaxFilingAdvisor.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/TaxFilingAdvisor.ts)

### **[BIZ_FIN_189] 异常低毛利订单强制拦截建议 (Low Margin)
- **风控收益**：作为最后一道防线，识别由于配置错误（如调价异常）导致的亏本订单。
- **核心目标**：实现 `MarginProtector`，在订单对账阶段实时检测毛利率，并触发拦截。
- **参考路径**：[MarginProtector.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/MarginProtector.ts)

### **[BIZ_FIN_190] 供应商信用额度自动预警 (Credit Limit)
- **供应链收益**：预防由于欠款超过信用额度导致的采购中断。
- **核心目标**：实现 `CreditMonitorService`，监控各供应商的已用额度与剩余额度。
- **参考路径**：[CreditMonitorService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CreditMonitorService.ts)

### **[BIZ_FIN_191] 跨国转让定价合规性建议 (Transfer Pricing)
- **法律收益**：预防国际贸易中的反避税调查风险，合规规划全球利润分布。
- **核心目标**：实现 `LegalTaxService`，监控大额跨境交易额，识别潜在合规审计风险。
- **参考路径**：[LegalTaxService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/LegalTaxService.ts)

### **[BIZ_FIN_192] 多平台提现手续费阶梯优化建议 (Payout Optimizer)
- **降本收益**：通过科学的提现时机与额度建议，降低平均提现手续费 10-20%。
- **核心目标**：实现 `PayoutOptimizer`，基于平台阶梯费率模型建议最佳提现动作。
- **参考路径**：[PayoutOptimizer.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/PayoutOptimizer.ts)

### **[BIZ_FIN_193] 基于 AI 预测的年度财务预算生成 (Budgeting)**
- **战略收益**：从经验决策转向数据驱动的预算编排，提升资金分配效率。
- **核心目标**：实现 `FinancialPlanner`，基于历史趋势自动生成明年的营收与成本预算草案。
- **参考路径**：[FinancialPlanner.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/FinancialPlanner.ts)

### **[BIZ_FIN_194] 高频取消订单导致的支付网关风险预警 (Gateway Risk)**
- **风控收益**：识别由于订单取消率异常波动导致的支付通道（PayPal/Stripe）封禁风险。
- **核心目标**：实现 `PaymentRiskService`，监控 `cancellationRatio` 并触发网关保护建议。
- **参考路径**：[PaymentRiskService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/PaymentRiskService.ts)

### **[BIZ_FIN_195] 基于实时毛利的动态运费模板建议 (Shipping Optimizer)**
- **利润收益**：根据各目的地国家的实时物流成本与订单毛利，动态建议包邮门槛。
- **核心目标**：实现 `DynamicShippingService`，计算最优 `freeShippingThreshold`。
- **参考路径**：[DynamicShippingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/DynamicShippingService.ts)

### **[BIZ_FIN_196] 营销活动盈亏平衡点实时监控 (Campaign Health)**
- **决策收益**：秒级发现正在亏损的营销活动，防止广告预算的无效浪费。
- **核心目标**：实现 `CampaignHealthService`，实时计算 `currentROAS` vs `breakEvenROAS`。
- **参考路径**：[CampaignHealthService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CampaignHealthService.ts)

### **[BIZ_FIN_197] 供应商年度框架协议降本达成度审计 (Savings Audit)**
- **绩效收益**：量化采购团队的降本贡献，确保供应商框架协议的真实执行。
- **核心目标**：实现 `SavingTrackerService`，对比 `base_price` 与 `actual_price` 计算真实降本。
- **参考路径**：[SavingTrackerService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/SavingTrackerService.ts)

### **[BIZ_FIN_198] 基于用户行为特征的恶意索赔拦截 (Claim Fraud)**
- **风控收益**：识别并拦截高频索赔的“职业薅羊毛”账户，保护租户利润空间。
- **核心目标**：实现 `ClaimFraudService`，基于 `claimToOrderRatio` 自动识别欺诈风险。
- **参考路径**：[ClaimFraudService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/ClaimFraudService.ts)

### **[BIZ_FIN_199] 全球多币种资产负债表实时快照 (Balance Sheet)**
- **估值收益**：为租户提供秒级的资产负债全景，支持企业融资与决策。
- **核心目标**：实现 `GlobalBalanceSheet`，实时汇总 Inventory Value、Payouts 与 Liabilities。
- **参考路径**：[GlobalBalanceSheet.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/GlobalBalanceSheet.ts)

### **[BIZ_FIN_200] 基于 AGI 的全自动审计与合规性自查 (AI Guard)**
- **合规收益**：最终合规防线，利用 AGI 遍历全量审计日志，识别任何潜在的财务违规行为。
- **核心目标**：实现 `ComplianceAIGuard`，对敏感操作（如 DELETE/FORCE_REFUND）进行 AI 穿透式审计。
- **参考路径**：[ComplianceAIGuard.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/ComplianceAIGuard.ts)

### **[BIZ_OPS_01] 多平台订单实时同步与状态流转 (Order Sync)**
- **业务收益**：统一订单中枢，减少人工多后台操作时间 90%。
- **核心目标**：
    1. **实时归集**：从 Amazon/AliExpress/Shopify 实时抓取并映射至统一订单模型。
    2. **自动分账**：支付成功后自动触发 Owner/Manager 利润分配。
- **参考路径**：[ConsumerOrderService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Trade/ConsumerOrderService.ts)

### **[BIZ_FIN_23] 跨主权多资产实时结算网关 (Multi-Asset Settlement)**
- **金融收益**：支持法币与数字资产混合清算，降低跨境汇损 3-5%。
- **核心目标**：构建去中心化结算协议，实现亚秒级跨租户资金对冲。
- **参考路径**：[MultiAssetSettlementService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/MultiAssetSettlementService.ts)

### **[BIZ_FIN_05] 全球发票自动化生成与合规引擎 (Auto-Invoicing)**
- **合规收益**：根据订单与目的地国家法律（VAT/GST）自动生成合规发票，减少人工开票成本。
- **核心目标**：实现 `InvoicingService`，支持多国税率动态计算与 PDF/电子发票生成。
- **参考路径**：[InvoicingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/InvoicingService.ts)

### **[BIZ_FIN_12] 实时现金流预测与资金调度 (Cashflow Forecasting)**
- **财务收益**：利用 AI 预测未来 30 天收支风险，自动优化资金分配。
- **核心目标**：聚合 `cf_orders` (待结) 与 `cf_purchase_orders` (待付) 数据，生成风险评级。
- **参考路径**：[CashflowForecastService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CashflowForecastService.ts)

### **[BIZ_FIN_14] 跨租户大宗商品价格对冲对账 (Commodity Hedging)**
- **避险收益**：为原材料敏感型租户提供大宗商品（油、金、钢）的价格对冲策略建议。
- **核心目标**：实时监控大宗行情，跨租户执行虚拟对冲对账。
- **参考路径**：[CommodityHedgingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CommodityHedgingService.ts)

### **[BIZ_FIN_18] 跨租户大宗商品集中采购议价池 (Pool Sourcing)**
- **降本收益**：利用规模效应，自动合并跨租户的相似原材料采购需求，增强议价能力。
- **核心目标**：建立 `cf_sourcing_pools`，支持“拼单”采购模式。
- **参考路径**：[PoolSourcingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/PoolSourcingService.ts)

### **[BIZ_FIN_25] 主权财富基金与集体投资协议 (Sovereign Wealth Fund)**
- **生态收益**：允许租户将闲置利润投入生态基金，共享基础设施优化收益。
- **核心目标**：基于 Shapley Value 算法模拟分红，实现生态内部资本循环。
- **参考路径**：[SovereignWealthFundService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/SovereignWealthFundService.ts)

---

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

### **[BIZ_SC_13] 供应商绩效自动评分模型 (Supplier Scoring Model)**
- **风控收益**：基于交付时效、质检合格率、价格波动等多维数据自动淘汰劣质供应商。
- **核心目标**：建立 `cf_supplier_scores` 模型，为 `TradeService` 提供采购决策依据。
- **参考路径**：[SupplierScoringService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/SupplierScoringService.ts)

### **[BIZ_TRADE_14] 最后一公里配送成本优化模型 (Last-Mile Optimizer)**
- **效率收益**：利用 TSP 算法动态优化派送路径，降低末端物流成本 15%。
- **核心目标**：基于包裹密度热力图实现智能排单。
- **参考路径**：[LastMileOptimizerService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/LastMileOptimizerService.ts)

### **[BIZ_TRADE_18] 全球物流拥堵预测与自适应绕路建议 (Congestion Failover)**
- **时效收益**：分钟级响应全球港口/枢纽拥堵，自动切换备选物流方案。
- **核心目标**：监控 `cf_congestion_history`，在危机发生前实现自动路由迁移。
- **参考路径**：[CongestionFailoverService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/CongestionFailoverService.ts)

### **[BIZ_AUTO_03] 多渠道营销日历自动执行 (Marketing Calendar)**
- **增长收益**：消除人工多平台改价操作，实现全球大促“秒级”联动。
- **核心目标**：自动化执行折扣、优惠券发放及库存锁定。
- **参考路径**：[MarketingCalendarService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Marketing/MarketingCalendarService.ts)

### **[BIZ_MKT_14] 社交媒体趋势实时对齐与选品反馈 (Social Pulse)**
- **爆款收益**：将 TikTok/Instagram 热门趋势词与 AGI 选品引擎对齐，发现蓝海商机。
- **核心目标**：实现 `SocialPulseService`，支持多语种语义归并。
- **参考路径**：[SocialPulseService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Marketing/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](file:///d:/trae_projects/crawlful-hub/server/src/core/ai/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](file:///d:/trae_projects/crawlful-hub/server/src/domains/Tenant/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`，对比总订单流与广告点击流，计算 `trueROAS` 与 `organicRevenue`。
- **参考路径**：[MultiTouchAttributionService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Marketing/MultiTouchAttributionService.ts)

### **[BIZ_FIN_40] 基于 DID 的自治清算协议 (DID Settlement)**
- **金融收益**：利用分布式身份 (DID) 自动化品牌方、代运营与达人的三方自动分润，降低结算争议 95%。
- **核心目标**：构建 `DIDSettlementService`，支持亚秒级清算证据链存证与多级分润逻辑。
- **参考路径**：[DIDSettlementService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/DIDSettlementService.ts)

### **[BIZ_LOG_20] 全球动态路径对冲与风险熔断 (Global Route Failover)**
- **时效收益**：在黑天鹅事件（如罢工、港口拥堵）发生时，自动切换最优路径并对冲物流成本上涨风险。
- **核心目标**：升级 `LogisticsRoutingService`，支持多式联运动态对冲策略与实时成本监控。
- **参考路径**：[DynamicRoutingFailoverService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/DynamicRoutingFailoverService.ts)

### **[BIZ_INV_20] 强化学习驱动的全球库存平衡 (RL Inventory Balancing)**
- **库存收益**：自动决策跨仓调拨，最小化总持仓成本与缺货损失，提升库存周转率。
- **核心目标**：完善 `InventoryRLOptimizerService`，接入多维成本评估模型与 RL 决策引擎。
- **参考路径**：[InventoryRLOptimizerService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Trade/InventoryRLOptimizerService.ts)

### **[BIZ_FIN_50] 跨主权多币种对冲对账引擎 (Multi-Currency Recon)**
- **避险收益**：自动化处理由于汇率剧烈波动导致的对账偏差，保护商户资金主权，减少财务人工核对成本 80%。
- **核心目标**：实现 `MultiCurrencyHedgingReconService`，实时计算 `fx_drift` 并生成对冲对账单。
- **参考路径**：[MultiCurrencyHedgingReconService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/MultiCurrencyHedgingReconService.ts)

### **[BIZ_LOG_30] 最后一公里众包路由优化 (Crowdsourced Last-mile)**
- **韧性收益**：在黑天鹅事件导致传统物流商瘫痪时，自动调度众包资源，确保履约不中断。
- **核心目标**：实现 `CrowdsourcedLogisticsService`，支持多点派送路径计算与成本动态核算。
- **参考路径**：[CrowdsourcedLogisticsService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/CrowdsourcedLogisticsService.ts)

### **[BIZ_TRADE_30] 自动化供应商产能预警 (Supplier Capacity Watch)**
- **交付收益**：提前感知供应商交期延误风险，通过 AGI 预测产能饱和度，自动建议切换备选源。
- **核心目标**：实现 `SupplierCapacityWatchService`，监控 `backlog_ratio` 并生成风险预警报告。
- **参考路径**：[SupplierCapacityWatchService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Trade/SupplierCapacityWatchService.ts)

### **[BIZ_CSM_30] 智能争议仲裁建议 (Dispute Arbitration)**
- **效率收益**：自动化处理售后纠纷与退款争议，基于全链路证据链给出公正仲裁建议，降低客服工作量 70%。
- **核心目标**：实现 `DisputeArbitrationService`，聚合订单、物流、支付全量数据生成仲裁书。
- **参考路径**：[DisputeArbitrationService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Customer/DisputeArbitrationService.ts)

### **[BIZ_TRADE_40] AGI 驱动的全球合规与制裁扫描 (Compliance Scan)**
- **合规收益**：自动化扫描 SKU 与收货地址，防止违反特定国家/地区的贸易禁令（如 OFAC 制裁、出口管制），避免高额罚款。
- **核心目标**：实现 `TradeComplianceService`，集成全球合规库，提供实时风险评分。
- **参考路径**：[TradeComplianceService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Trade/TradeComplianceService.ts)

### **[BIZ_FIN_70] 基于 ZKP 的链上隐私信用证 (Private L/C)**
- **金融收益**：利用 ZKP 保护商业机密，同时向金融机构证明交易真实性，缩短 B2B 结算周期，提升资金周转率。
- **核心目标**：实现 `SovereignPrivateLCService`，支持链上信用证生成与隐私存证验证。
- **参考路径**：[SovereignPrivateLCService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/SovereignPrivateLCService.ts)

### **[BIZ_LOG_50] 弹性多式联运自动对冲引擎 (Intermodal Failover)**
- **韧性收益**：当全球主航道发生黑天鹅事件时，自动计算并执行多式联运切换（如海转铁），最小化时效延误。
- **核心目标**：实现 `IntermodalFailoverService`，支持动态路由成本核算与自动对冲方案生成。
- **参考路径**：[IntermodalFailoverService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/IntermodalFailoverService.ts)

### **[SOV_NET_02] 跨节点自治清算协议实现 (Cross-Node Settlement)**
- **网络收益**：实现 Hub 节点间的自动化利润分润与资金清算，构建去中心化的全球贸易价值网。
- **核心目标**：实现 `CrossNodeSettlementService`，联动 `DIDSettlementService` 处理跨 Hub 的 DID 身份清算。
- **参考路径**：[CrossNodeSettlementService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/CrossNodeSettlementService.ts)

### **[SOV_NET_04] 跨节点争议自动仲裁转发 (Dispute Forwarding)**
- **信任收益**：在多节点贸易中，实现证据链的自动化路由与转发，支持跨节点的 AGI 联合仲裁。
- **核心目标**：构建 `GlobalDisputeRouter`，支持证据链在不同主权节点间的安全传输与同步。
- **参考路径**：[GlobalDisputeRouter.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Customer/GlobalDisputeRouter.ts)

### **[BIZ_FIN_80] 跨主权贸易信用保险自动投保建议 (Trade Insurance)**
- **风险收益**：针对高价值跨国订单，基于供应商风险评分自动建议投保方案，降低坏账与货损风险。
- **核心目标**：实现 `TradeInsuranceService`，提供自动化投保建议。
- **参考路径**：[TradeInsuranceService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/TradeInsuranceService.ts)

### **[BIZ_TRADE_50] 动态出口管制合规证书自动化生成 (Compliance Certificate)**
- **合规收益**：自动生成符合目的国要求的电子合规证书，确保顺畅通关。
- **核心目标**：实现 `ComplianceCertificateService`，支持证书自动生成与 DID 签名。
- **参考路径**：[ComplianceCertificateService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Trade/ComplianceCertificateService.ts)

### **[BIZ_LOG_60] 绿色供应链碳信用交易撮合 (Carbon Credit Trading)**
- **绿色收益**：撮合碳抵扣额度购买，提升品牌绿色合规等级。
- **核心目标**：实现 `CarbonCreditTradingService`，支持碳足迹抵扣撮合。
- **参考路径**：[CarbonCreditTradingService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/CarbonCreditTradingService.ts)

### **[BIZ_FIN_90] 跨主权多节点资金流动性自动预测 (Liquidity Forecast)**
- **资金收益**：预测全球贸易 Hub 节点的资金缺口，自动建议资金调拨，确保清算平滑。
- **核心目标**：实现 `NodeLiquidityForecastService`，支持节点流动性预测。
- **参考路径**：[NodeLiquidityForecastService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Finance/NodeLiquidityForecastService.ts)

### **[BIZ_TRADE_60] 自动化供应链碳配额质押建议 (Carbon Pledge)**
- **金融收益**：允许租户质押碳抵扣额度以获取更优的采购账期。
- **核心目标**：实现 `CarbonPledgeService`，支持碳配额质押逻辑。
- **参考路径**：[CarbonPledgeService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Trade/CarbonPledgeService.ts)

### **[BIZ_LOG_70] 众包物流配送员 DID 信用分级体系 (Courier Credit)**
- **履约收益**：建立基于 DID 的配送员信用分级，筛选优质众包资源，降低末端风险。
- **核心目标**：实现 `CourierCreditService`，支持配送员信用分计算。
- **参考路径**：[CourierCreditService.ts](file:///d:/trae_projects/crawlful-hub/server/src/domains/Logistics/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](file:///d:/trae_projects/crawlful-hub/.trae/rules/project_rules.md)

---
**规格维护者**：AI-1 (Kernel) | **当前版本**：V32.0  
**看板索引**：[collaboration-board.md](file:///d:/trae_projects/crawlful-hub/docs/governance/collaboration-board.md)