Files
makemd/docs/Module_Inventory.md
wurenzhi 5cfd0c4c89 feat: 实现服务层核心功能与文档更新
refactor(ProductService): 修复createProduct方法和其他方法错误
fix(InventoryAgingService): 修复AGING_THRESHOLD_DAYS引用问题
fix(InventoryService): 修复predictSKUDemand方法
refactor(ChatBotController): 从tsoa风格改为Express风格
fix(CommandCenterController): 修复类型问题
fix(AdAutoService): 修复stock可能为undefined的问题
docs: 更新SERVICE_MAP、DOMAIN_MODEL等架构文档
chore: 启动前端服务(运行在http://localhost:8000)
2026-03-18 12:35:52 +08:00

685 lines
48 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 项目模块清单与说明
## 1. 项目整体结构
```
├── .github/ # GitHub配置和CI/CD工作流
├── .prompts/ # AI提示配置
├── .trae/ # Trae IDE配置和项目规则
├── dashboard/ # 前端仪表板
├── docs/ # 项目文档
├── docs1/ # 备用文档
├── docs11/ # 备用文档
├── extension/ # 浏览器扩展
├── node-agent/ # 节点代理
├── scripts/ # 脚本文件
├── server/ # 后端服务
├── .continueignore # Continue配置
├── .gitignore # Git忽略文件
├── README.md # 项目说明
├── package.json # 项目依赖
```
## 2. 后端模块清单
### 2.1 核心服务 (server/src/services/)
| 模块名称 | 路径 | 功能描述 | 状态 |
|---------|------|---------|------|
| ABTestAnalysisService | services/ABTestAnalysisService.ts | A/B测试分析服务 | 未实现 |
| ABTestService | services/ABTestService.ts | A/B测试服务 | 未实现 |
| AGIStrategyEvolutionService | services/AGIStrategyEvolutionService.ts | AGI策略演化服务 | 未实现 |
| AIService | services/AIService.ts | AI服务 | 未实现 |
| ActionAuditService | services/ActionAuditService.ts | 操作审计服务 | 未实现 |
| AdAutoService | services/AdAutoService.ts | 广告自动化服务 | 未实现 |
| AdCreativeService | services/AdCreativeService.ts | 广告创意服务 | 未实现 |
| AdMimicryService | services/AdMimicryService.ts | 广告模仿服务 | 未实现 |
| AdOptimizationService | services/AdOptimizationService.ts | 广告优化服务 | 未实现 |
| AdPlanService | services/AdPlanService.ts | 广告计划服务 | 未实现 |
| AdPredictionService | services/AdPredictionService.ts | 广告预测服务 | 未实现 |
| AfterSalesService | services/AfterSalesService.ts | 售后服务 | 未实现 |
| AgentSwarmService | services/AgentSwarmService.ts | 智能体集群服务 | 未实现 |
| AgingInventoryService | services/AgingInventoryService.ts | 库存老化服务 | 未实现 |
| ArbitrageService | services/ArbitrageService.ts | 套利服务 | 未实现 |
| AuditService | services/AuditService.ts | 审计服务 | 未实现 |
| AuditWorker | services/AuditWorker.ts | 审计工作器 | 未实现 |
| AuthService | services/AuthService.ts | 认证服务 | 未实现 |
| AutoCircuitBreakerService | services/AutoCircuitBreakerService.ts | 自动熔断服务 | 未实现 |
| AutoDelistService | services/AutoDelistService.ts | 自动下架服务 | 未实现 |
| AutoDiagnosticsService | services/AutoDiagnosticsService.ts | 自动诊断服务 | 未实现 |
| AutoRedTeamingService | services/AutoRedTeamingService.ts | 自动红队服务 | 未实现 |
| AutoReturnQAService | services/AutoReturnQAService.ts | 自动退货QA服务 | 未实现 |
| AutonomousEcoService | services/AutonomousEcoService.ts | 自主生态服务 | 未实现 |
| AutonomousSandboxService | services/AutonomousSandboxService.ts | 自主沙箱服务 | 未实现 |
| AutonomousSourcingService | services/AutonomousSourcingService.ts | 自主采购服务 | 未实现 |
| AutonomousWarehousingService | services/AutonomousWarehousingService.ts | 自主仓储服务 | 未实现 |
| B2BAIService | services/B2BAIService.ts | B2B AI服务 | 未实现 |
| B2BTradeService | services/B2BTradeService.ts | B2B贸易服务 | 未实现 |
| BehavioralRiskService | services/BehavioralRiskService.ts | 行为风险服务 | 未实现 |
| BiddingStrategyService | services/BiddingStrategyService.ts | 竞价策略服务 | 未实现 |
| BlacklistDatabaseService | services/BlacklistDatabaseService.ts | 黑名单数据库服务 | 未实现 |
| BlacklistService | services/BlacklistService.ts | 黑名单服务 | 未实现 |
| BlacklistShareService | services/BlacklistShareService.ts | 黑名单共享服务 | 未实现 |
| BlockchainTraceabilityService | services/BlockchainTraceabilityService.ts | 区块链溯源服务 | 未实现 |
| BondedWarehouseService | services/BondedWarehouseService.ts | 保税仓服务 | 未实现 |
| BrandSovereigntyService | services/BrandSovereigntyService.ts | 品牌主权服务 | 未实现 |
| BullMQDeadLetterService | services/BullMQDeadLetterService.ts | BullMQ死信服务 | 未实现 |
| BullMQService | services/BullMQService.ts | BullMQ服务 | 未实现 |
| BusinessModelEvolutionService | services/BusinessModelEvolutionService.ts | 商业模式演化服务 | 已实现 |
| CarbonCostGameService | services/CarbonCostGameService.ts | 碳成本博弈服务 | 未实现 |
| CarbonNeutralPathService | services/CarbonNeutralPathService.ts | 碳中和路径服务 | 未实现 |
| CashflowForecastService | services/CashflowForecastService.ts | 现金流预测服务 | 已实现 |
| CashflowPredictor | services/CashflowPredictor.ts | 现金流预测器 | 未实现 |
| CashflowService | services/CashflowService.ts | 现金流服务 | 未实现 |
| CertificateDatabaseService | services/CertificateDatabaseService.ts | 证书数据库服务 | 未实现 |
| CertificateService | services/CertificateService.ts | 证书服务 | 未实现 |
| ChannelStatusService | services/ChannelStatusService.ts | 渠道状态服务 | 未实现 |
| CommodityHedgingService | services/CommodityHedgingService.ts | 商品对冲服务 | 未实现 |
| CompetitorPulseService | services/CompetitorPulseService.ts | 竞争对手脉搏服务 | 未实现 |
| CompetitorService | services/CompetitorService.ts | 竞争对手服务 | 未实现 |
| ComplianceCheckService | services/ComplianceCheckService.ts | 合规检查服务 | 未实现 |
| ComplianceGateService | services/ComplianceGateService.ts | 合规门禁服务 | 未实现 |
| ComplianceRuleDatabaseService | services/ComplianceRuleDatabaseService.ts | 合规规则数据库服务 | 未实现 |
| ConfidentialSharingService | services/ConfidentialSharingService.ts | 机密共享服务 | 未实现 |
| ConfigService | services/ConfigService.ts | 配置服务 | 未实现 |
| CongestionFailoverService | services/CongestionFailoverService.ts | 拥塞故障转移服务 | 未实现 |
| ContainerQuotaService | services/ContainerQuotaService.ts | 容器配额服务 | 未实现 |
| ContentGapService | services/ContentGapService.ts | 内容差距服务 | 未实现 |
| CostAttributionService | services/CostAttributionService.ts | 成本归因服务 | 未实现 |
| CreditLimitService | services/CreditLimitService.ts | 信用额度服务 | 未实现 |
| CrossTenantEmbeddingAggregator | services/CrossTenantEmbeddingAggregator.ts | 跨租户嵌入聚合器 | 未实现 |
| CurrencyRiskService | services/CurrencyRiskService.ts | 货币风险服务 | 未实现 |
| CustomerServiceAgent | services/CustomerServiceAgent.ts | 客户服务代理 | 未实现 |
| CustomsDeclarationService | services/CustomsDeclarationService.ts | 报关服务 | 未实现 |
| DSOOptimizerService | services/DSOOptimizerService.ts | DSO优化服务 | 未实现 |
| DataComplianceService | services/DataComplianceService.ts | 数据合规服务 | 未实现 |
| DeadlockAdvisor | services/DeadlockAdvisor.ts | 死锁顾问 | 未实现 |
| DecentralizedArbitrationService | services/DecentralizedArbitrationService.ts | 去中心化仲裁服务 | 未实现 |
| DeployService | services/DeployService.ts | 部署服务 | 已实现 |
| DevOpsService | services/DevOpsService.ts | DevOps服务 | 未实现 |
| DisputeAdvisorService | services/DisputeAdvisorService.ts | 争议顾问服务 | 未实现 |
| DisputeClassifier | services/DisputeClassifier.ts | 争议分类器 | 未实现 |
| DisputeResolverService | services/DisputeResolverService.ts | 争议解决服务 | 已实现 |
| DynamicPricingService | services/DynamicPricingService.ts | 动态定价服务 | 已实现 |
| DynamicRecompositionService | services/DynamicRecompositionService.ts | 动态重组服务 | 未实现 |
| DynamicShippingService | services/DynamicShippingService.ts | 动态 shipping 服务 | 未实现 |
| EcoValueSharingService | services/EcoValueSharingService.ts | 生态价值共享服务 | 未实现 |
| EdgeSyncService | services/EdgeSyncService.ts | 边缘同步服务 | 未实现 |
| EncryptedStreamAuditService | services/EncryptedStreamAuditService.ts | 加密流审计服务 | 未实现 |
| EventBusService | services/EventBusService.ts | 事件总线服务 | 未实现 |
| ExceptionAutoFixService | services/ExceptionAutoFixService.ts | 异常自动修复服务 | 未实现 |
| ExperimentService | services/ExperimentService.ts | 实验服务 | 未实现 |
| FXHedgingService | services/FXHedgingService.ts | 外汇对冲服务 | 未实现 |
| FXRebalancingService | services/FXRebalancingService.ts | 外汇再平衡服务 | 未实现 |
| FactoryMonitorService | services/FactoryMonitorService.ts | 工厂监控服务 | 未实现 |
| FailoverLogisticsService | services/FailoverLogisticsService.ts | 故障转移物流服务 | 未实现 |
| FestivalMarketingService | services/FestivalMarketingService.ts | 节日营销服务 | 未实现 |
| FinanceService | services/FinanceService.ts | 财务服务 | 未实现 |
| FraudSharedService | services/FraudSharedService.ts | 欺诈共享服务 | 未实现 |
| FreightAuditor | services/FreightAuditor.ts | 货运审计员 | 未实现 |
| FulfillmentConsensusService | services/FulfillmentConsensusService.ts | 履行共识服务 | 未实现 |
| GeopoliticalRiskHedgeService | services/GeopoliticalRiskHedgeService.ts | 地缘政治风险对冲服务 | 未实现 |
| GlobalCSMonitor | services/GlobalCSMonitor.ts | 全球客服监控 | 未实现 |
| GreenSupplyChainService | services/GreenSupplyChainService.ts | 绿色供应链服务 | 未实现 |
| GreenSupplyService | services/GreenSupplyService.ts | 绿色供应服务 | 未实现 |
| HighValueQAService | services/HighValueQAService.ts | 高价值QA服务 | 未实现 |
| HolidayRiskService | services/HolidayRiskService.ts | 假日风险服务 | 未实现 |
| IPCheckService | services/IPCheckService.ts | IP检查服务 | 未实现 |
| IPSentinelService | services/IPSentinelService.ts | IP哨兵服务 | 未实现 |
| ImageFingerprintService | services/ImageFingerprintService.ts | 图像指纹服务 | 未实现 |
| ImprovementSuggestionService | services/ImprovementSuggestionService.ts | 改进建议服务 | 未实现 |
| InfluencerBotService | services/InfluencerBotService.ts | 红人营销自动邀约机器人 | 已实现 |
| InventoryAgingService | services/InventoryAgingService.ts | 库存老化服务 | 已实现 |
| InventoryDistributionService | services/InventoryDistributionService.ts | 库存分配服务 | 未实现 |
| InventoryForecastService | services/InventoryForecastService.ts | 库存预测服务 | 未实现 |
| InventoryRLService | services/InventoryRLService.ts | 库存强化学习服务 | 未实现 |
| InventoryService | services/InventoryService.ts | 库存服务 | 未实现 |
| InventorySyncV2Service | services/InventorySyncV2Service.ts | 库存同步V2服务 | 未实现 |
| InvoiceLateRiskService | services/InvoiceLateRiskService.ts | 发票逾期风险服务 | 未实现 |
| InvoicingService | services/InvoicingService.ts | 发票服务 | 未实现 |
| KOLOrchestratorService | services/KOLOrchestratorService.ts | KOL编排服务 | 未实现 |
| LastMileOptimizerService | services/LastMileOptimizerService.ts | 最后一公里优化服务 | 未实现 |
| LeadTimeDriftService | services/LeadTimeDriftService.ts | 前置时间漂移服务 | 未实现 |
| LiquidityHedgingService | services/LiquidityHedgingService.ts | 流动性对冲服务 | 未实现 |
| LiveScriptService | services/LiveScriptService.ts | 实时脚本服务 | 未实现 |
| LogAnalyticsService | services/LogAnalyticsService.ts | 日志分析服务 | 未实现 |
| LogisticTTLService | services/LogisticTTLService.ts | 物流TTL服务 | 未实现 |
| LogisticTelemetryService | services/LogisticTelemetryService.ts | 物流遥测服务 | 未实现 |
| LogisticsInsuranceService | services/LogisticsInsuranceService.ts | 物流保险服务 | 未实现 |
| LogisticsIntelligenceService | services/LogisticsIntelligenceService.ts | 物流智能服务 | 未实现 |
| LogisticsService | services/LogisticsService.ts | 物流服务 | 未实现 |
| ManufacturingCoordinationService | services/ManufacturingCoordinationService.ts | 制造协调服务 | 未实现 |
| MarketingCalendarService | services/MarketingCalendarService.ts | 营销日历服务 | 未实现 |
| MarketingService | services/MarketingService.ts | 营销服务 | 未实现 |
| MediaAssetService | services/MediaAssetService.ts | 媒体资产服务 | 已实现 |
| MemberLevelService | services/MemberLevelService.ts | 会员等级服务 | 未实现 |
| MerchantService | services/MerchantService.ts | 商家服务 | 未实现 |
| MerchantProductOrderService | services/MerchantProductOrderService.ts | 多商户商品订单服务 | 已实现 |
| MerchantSettlementService | services/MerchantSettlementService.ts | 多商户结算服务 | 已实现 |
| MicroCreditService | services/MicroCreditService.ts | 小额信贷服务 | 未实现 |
| MultiAssetSettlementService | services/MultiAssetSettlementService.ts | 多资产结算服务 | 未实现 |
| MultiCurrencyFinanceService | services/MultiCurrencyFinanceService.ts | 多货币财务服务 | 未实现 |
| NegotiationBotService | services/NegotiationBotService.ts | 谈判机器人服务 | 未实现 |
| NodeGovernanceV2Service | services/NodeGovernanceV2Service.ts | 节点治理V2服务 | 未实现 |
| OmniStockService | services/OmniStockService.ts | 全渠道库存服务 | 未实现 |
| OrderProfitService | services/OrderProfitService.ts | 订单利润服务 | 未实现 |
| OrderService | services/OrderService.ts | 订单服务 | 未实现 |
| PRMonitorService | services/PRMonitorService.ts | PR监控服务 | 未实现 |
| PackingOptimizer | services/PackingOptimizer.ts | 包装优化器 | 未实现 |
| PathSimulatorService | services/PathSimulatorService.ts | 路径模拟器服务 | 未实现 |
| PaymentRiskService | services/PaymentRiskService.ts | 支付风险服务 | 未实现 |
| PaymentService | services/PaymentService.ts | 支付服务 | 未实现 |
| PayoutAppealService | services/PayoutAppealService.ts | 支付上诉服务 | 未实现 |
| PayoutService | services/PayoutService.ts | 支付服务 | 未实现 |
| PersonalizedPricingService | services/PersonalizedPricingService.ts | 个性化定价服务 | 未实现 |
| PersonalizedRecommendService | services/PersonalizedRecommendService.ts | 个性化推荐服务 | 未实现 |
| PixelFeedbackService | services/PixelFeedbackService.ts | 像素反馈服务 | 未实现 |
| PlatformApiService | services/PlatformApiService.ts | 平台API服务 | 未实现 |
| PlatformFeeWatcher | services/PlatformFeeWatcher.ts | 平台费用监控 | 未实现 |
| PnlSnapshotService | services/PnlSnapshotService.ts | PnL快照服务 | 未实现 |
| PointsService | services/PointsService.ts | 积分服务 | 未实现 |
| PoolSourcingService | services/PoolSourcingService.ts | 池采购服务 | 未实现 |
| PredictiveFXService | services/PredictiveFXService.ts | 预测外汇服务 | 未实现 |
| PredictiveHealthService | services/PredictiveHealthService.ts | 预测健康服务 | 未实现 |
| PredictiveStagingService | services/PredictiveStagingService.ts | 预测登台服务 | 未实现 |
| PricingAuditService | services/PricingAuditService.ts | 定价审计服务 | 未实现 |
| PricingDecisionService | services/PricingDecisionService.ts | 定价决策服务 | 未实现 |
| PricingService | services/PricingService.ts | 定价服务 | 未实现 |
| PriorityTicketService | services/PriorityTicketService.ts | 优先票服务 | 未实现 |
| ProcurementAuditService | services/ProcurementAuditService.ts | 采购审计服务 | 未实现 |
| ProductHealthService | services/ProductHealthService.ts | 产品健康服务 | 未实现 |
| ProductService | services/ProductService.ts | 产品服务 | 未实现 |
| PublishService | services/PublishService.ts | 发布服务 | 未实现 |
| QuotaCircuitBreakerService | services/QuotaCircuitBreakerService.ts | 配额熔断服务 | 未实现 |
| RLCrawlerService | services/RLCrawlerService.ts | RL爬虫服务 | 未实现 |
| ReasoningPipelineService | services/ReasoningPipelineService.ts | 推理管道服务 | 未实现 |
| RedTeamingService | services/RedTeamingService.ts | 红队服务 | 未实现 |
| RedisService | services/RedisService.ts | Redis服务 | 未实现 |
| ReplenishmentService | services/ReplenishmentService.ts | 补货服务 | 未实现 |
| ReportService | services/ReportService.ts | 报告服务 | 已实现 |
| FinanceReconciliationService | services/FinanceReconciliationService.ts | 财务对账服务 | 已实现 |
| FeatureActivationService | services/FeatureActivationService.ts | 功能激活服务 | 已实现 |
| RBACService | services/RBACService.ts | 角色权限服务 | 已实现 |
| BillingService | services/BillingService.ts | 账单服务 | 已实现 |
| ReturnRateDatabaseService | services/ReturnRateDatabaseService.ts | 退货率数据库服务 | 未实现 |
| ReturnRateMonitorService | services/ReturnRateMonitorService.ts | 退货率监控服务 | 未实现 |
| ReviewService | services/ReviewService.ts | 评论服务 | 未实现 |
| RiskAssessmentService | services/RiskAssessmentService.ts | 风险评估服务 | 未实现 |
| RiskRadarService | services/RiskRadarService.ts | 风险雷达服务 | 未实现 |
| SKUMappingService | services/SKUMappingService.ts | SKU映射服务 | 未实现 |
| SLAScoringService | services/SLAScoringService.ts | SLA评分服务 | 未实现 |
| SeaFreightAdvisor | services/SeaFreightAdvisor.ts | 海运顾问 | 未实现 |
| SelfHealingService | services/SelfHealingService.ts | 自愈服务 | 未实现 |
| SemanticLogService | services/SemanticLogService.ts | 语义日志服务 | 未实现 |
| SensibleStockService | services/SensibleStockService.ts | 合理库存服务 | 未实现 |
| SentimentAIService | services/SentimentAIService.ts | 情感AI服务 | 未实现 |
| SlowMovingStockService | services/SlowMovingStockService.ts | 慢动库存服务 | 未实现 |
| SocialTrendSourcingService | services/SocialTrendSourcingService.ts | 社会趋势采购服务 | 未实现 |
| SovereignCreditPoolService | services/SovereignCreditPoolService.ts | 主权信用池服务 | 未实现 |
| SovereignLedgerService | services/SovereignLedgerService.ts | 主权账本服务 | 未实现 |
| SovereignLogisticsV2Service | services/SovereignLogisticsV2Service.ts | 主权物流V2服务 | 未实现 |
| SovereignMediationService | services/SovereignMediationService.ts | 主权调解服务 | 未实现 |
| SovereignReputationV2Service | services/SovereignReputationV2Service.ts | 主权声誉V2服务 | 未实现 |
| SovereigntyGovernanceService | services/SovereigntyGovernanceService.ts | 主权治理服务 | 未实现 |
| SovereigntyIdentityService | services/SovereigntyIdentityService.ts | 主权身份服务 | 未实现 |
| SovereigntyReputationService | services/SovereigntyReputationService.ts | 主权声誉服务 | 未实现 |
| SovereigntySettlementService | services/SovereigntySettlementService.ts | 主权结算服务 | 未实现 |
| StockPlannerService | services/StockPlannerService.ts | 库存计划服务 | 未实现 |
| StuckTrackingService | services/StuckTrackingService.ts | 卡住跟踪服务 | 未实现 |
| StyleWarService | services/StyleWarService.ts | 风格战争服务 | 未实现 |
| SupplierBlacklistService | services/SupplierBlacklistService.ts | 供应商黑名单服务 | 未实现 |
| SupplierInquiryService | services/SupplierInquiryService.ts | 供应商询价服务 | 未实现 |
| SupplierRiskRadar | services/SupplierRiskRadar.ts | 供应商风险雷达 | 未实现 |
| SupplierRiskRadarService | services/SupplierRiskRadarService.ts | 供应商风险雷达服务 | 未实现 |
| SupplierService | services/SupplierService.ts | 供应商服务 | 已实现 |
| SupplyChainService | services/SupplyChainService.ts | 供应链服务 | 未实现 |
| SyncService | services/SyncService.ts | 同步服务 | 未实现 |
| TEEComputeService | services/TEEComputeService.ts | TEE计算服务 | 未实现 |
| TaxBonusService | services/TaxBonusService.ts | 税收奖励服务 | 未实现 |
| TaxComplianceService | services/TaxComplianceService.ts | 税收合规服务 | 未实现 |
| TaxIncentivesService | services/TaxIncentivesService.ts | 税收激励服务 | 未实现 |
| TaxReportService | services/TaxReportService.ts | 税收报告服务 | 未实现 |
| TaxService | services/TaxService.ts | 税收服务 | 未实现 |
| TraceService | services/TraceService.ts | 跟踪服务 | 未实现 |
| TraceabilityService | services/TraceabilityService.ts | 溯源服务 | 未实现 |
| TracingTopoService | services/TracingTopoService.ts | 跟踪拓扑服务 | 未实现 |
| TrackingFraudDetector | services/TrackingFraudDetector.ts | 跟踪欺诈检测器 | 未实现 |
| TradeService | services/TradeService.ts | 贸易服务 | 已实现 |
| TrueROASService | services/TrueROASService.ts | 真实ROAS服务 | 未实现 |
| TrustEvolutionService | services/TrustEvolutionService.ts | 信任演化服务 | 未实现 |
| UnifiedTaskService | services/UnifiedTaskService.ts | 统一任务服务 | 未实现 |
| UserAssetService | services/UserAssetService.ts | 用户资产服务 | 未实现 |
| UserValueAnalysisService | services/UserValueAnalysisService.ts | 用户价值分析服务 | 未实现 |
| VaultService | services/VaultService.ts | 保险库服务 | 未实现 |
| VendorCreditService | services/VendorCreditService.ts | 供应商信用服务 | 未实现 |
| VisionFactoryService | services/VisionFactoryService.ts | 视觉工厂服务 | 未实现 |
| VisualSourcingService | services/VisualSourcingService.ts | 视觉采购服务 | 未实现 |
| WMSAdvisor | services/WMSAdvisor.ts | WMS顾问 | 未实现 |
| WarehouseService | services/WarehouseService.ts | 仓库服务 | 未实现 |
| WebhookService | services/WebhookService.ts | Webhook服务 | 未实现 |
| WorkerProfilerService | services/WorkerProfilerService.ts | 工作器分析服务 | 未实现 |
| ZKPSovereignAdmissionService | services/ZKPSovereignAdmissionService.ts | ZKP主权准入服务 | 未实现 |
### 2.2 API控制器 (server/src/api/controllers/)
| 模块名称 | 路径 | 功能描述 | 状态 |
|---------|------|---------|------|
| AIController | api/controllers/AIController.ts | AI控制器 | 未实现 |
| AdOpsController | api/controllers/AdOpsController.ts | 广告运营控制器 | 未实现 |
| ArbitrageController | api/controllers/ArbitrageController.ts | 套利控制器 | 未实现 |
| AuditController | api/controllers/AuditController.ts | 审计控制器 | 未实现 |
| AuthController | api/controllers/AuthController.ts | 认证控制器 | 未实现 |
| BillingController | api/controllers/BillingController.ts | 账单控制器 | 未实现 |
| BizController | api/controllers/BizController.ts | 业务控制器 | 未实现 |
| BizStrategyController | api/controllers/BizStrategyController.ts | 业务策略控制器 | 未实现 |
| ChatBotController | api/controllers/ChatBotController.ts | 聊天机器人控制器 | 未实现 |
| CommandCenterController | api/controllers/CommandCenterController.ts | 命令中心控制器 | 未实现 |
| ConfigController | api/controllers/ConfigController.ts | 配置控制器 | 未实现 |
| CreativeController | api/controllers/CreativeController.ts | 创意控制器 | 未实现 |
| CustomerController | api/controllers/CustomerController.ts | 客户控制器 | 未实现 |
| GovernanceController | api/controllers/GovernanceController.ts | 治理控制器 | 未实现 |
| ImageRecognitionController | api/controllers/ImageRecognitionController.ts | 图像识别控制器 | 未实现 |
| LiteConsoleController | api/controllers/LiteConsoleController.ts | 轻量级控制台控制器 | 未实现 |
| NaturalLanguageProcessingController | api/controllers/NaturalLanguageProcessingController.ts | 自然语言处理控制器 | 未实现 |
| NodeController | api/controllers/NodeController.ts | 节点控制器 | 未实现 |
| OrderController | api/controllers/OrderController.ts | 订单控制器 | 未实现 |
| PricingController | api/controllers/PricingController.ts | 定价控制器 | 未实现 |
| ProductController | api/controllers/ProductController.ts | 产品控制器 | 未实现 |
| PublishController | api/controllers/PublishController.ts | 发布控制器 | 未实现 |
| RecommendationController | api/controllers/RecommendationController.ts | 推荐控制器 | 未实现 |
| ReportController | api/controllers/ReportController.ts | 报告控制器 | 未实现 |
| SettlementController | api/controllers/SettlementController.ts | 结算控制器 | 未实现 |
| SyncController | api/controllers/SyncController.ts | 同步控制器 | 未实现 |
| TelemetryController | api/controllers/TelemetryController.ts | 遥测控制器 | 未实现 |
| TenantController | api/controllers/TenantController.ts | 租户控制器 | 未实现 |
| TraceController | api/controllers/TraceController.ts | 跟踪控制器 | 未实现 |
| VaultController | api/controllers/VaultController.ts | 保险库控制器 | 未实现 |
| WebhookController | api/controllers/WebhookController.ts | Webhook控制器 | 未实现 |
### 2.3 API路由 (server/src/api/routes/)
| 模块名称 | 路径 | 功能描述 | 状态 |
|---------|------|---------|------|
| ai.ts | api/routes/ai.ts | AI路由 | 已实现(仅保留/chat端点 |
| arbitrage.ts | api/routes/arbitrage.ts | 套利路由 | 未实现 |
| audit.ts | api/routes/audit.ts | 审计路由 | 未实现 |
| auth.ts | api/routes/auth.ts | 认证路由 | 未实现 |
| billing.ts | api/routes/billing.ts | 账单路由 | 未实现 |
| biz.ts | api/routes/biz.ts | 业务路由 | 未实现 |
| chatbot.ts | api/routes/chatbot.ts | 聊天机器人路由 | 未实现 |
| command.ts | api/routes/command.ts | 命令路由 | 未实现 |
| config.ts | api/routes/config.ts | 配置路由 | 未实现 |
| console_lite.ts | api/routes/console_lite.ts | 轻量级控制台路由 | 未实现 |
| creative.ts | api/routes/creative.ts | 创意路由 | 未实现 |
| customer.ts | api/routes/customer.ts | 客户路由 | 未实现 |
| finance.ts | api/routes/finance.ts | 财务路由 | 未实现 |
| governance.ts | api/routes/governance.ts | 治理路由 | 未实现 |
| image-recognition.ts | api/routes/image-recognition.ts | 图像识别路由 | 未实现 |
| marketing.ts | api/routes/marketing.ts | 营销路由 | 未实现 |
| nlp.ts | api/routes/nlp.ts | 自然语言处理路由 | 未实现 |
| node.ts | api/routes/node.ts | 节点路由 | 未实现 |
| order.ts | api/routes/order.ts | 订单路由 | 未实现 |
| product.ts | api/routes/product.ts | 产品路由 | 未实现 |
| publish.ts | api/routes/publish.ts | 发布路由 | 未实现 |
| recommendation.ts | api/routes/recommendation.ts | 推荐路由 | 未实现 |
| report.ts | api/routes/report.ts | 报告路由 | 未实现 |
| sovereignty.ts | api/routes/sovereignty.ts | 主权路由 | 未实现 |
| strategy.ts | api/routes/strategy.ts | 策略路由 | 未实现 |
| sync.ts | api/routes/sync.ts | 同步路由 | 未实现 |
| telemetry.ts | api/routes/telemetry.ts | 遥测路由 | 未实现 |
| tenant.ts | api/routes/tenant.ts | 租户路由 | 未实现 |
| trace.ts | api/routes/trace.ts | 跟踪路由 | 未实现 |
| trade.ts | api/routes/trade.ts | 贸易路由 | 未实现 |
| vault.ts | api/routes/vault.ts | 保险库路由 | 未实现 |
| webhook.ts | api/routes/webhook.ts | Webhook路由 | 未实现 |
### 2.4 核心模块 (server/src/core/)
| 模块名称 | 路径 | 功能描述 | 状态 |
|---------|------|---------|------|
| AINativeCommerceService | core/ai/AINativeCommerceService.ts | AI原生商务服务 | 未实现 |
| ChatBotService | core/ai/ChatBotService.ts | 聊天机器人服务 | 未实现 |
| DecisionExplainabilityEngine | core/ai/DecisionExplainabilityEngine.ts | 决策可解释性引擎 | 未实现 |
| DynamicPricingAGIService | core/ai/DynamicPricingAGIService.ts | 动态定价AGI服务 | 未实现 |
| FingerprintEngine | core/ai/FingerprintEngine.ts | 指纹引擎 | 未实现 |
| ImageRecognitionService | core/ai/ImageRecognitionService.ts | 图像识别服务 | 未实现 |
| NaturalLanguageProcessingService | core/ai/NaturalLanguageProcessingService.ts | 自然语言处理服务 | 未实现 |
| RecommendationService | core/ai/RecommendationService.ts | 推荐服务 | 未实现 |
| RBACEngine | core/auth/RBACEngine.ts | RBAC引擎 | 未实现 |
| BusinessFunnelService | core/biz/BusinessFunnelService.ts | 业务漏斗服务 | 未实现 |
| EarlyStageBizService | core/biz/EarlyStageBizService.ts | 早期业务服务 | 未实现 |
| OnboardingService | core/biz/OnboardingService.ts | 入职服务 | 未实现 |
| TOCService | core/biz/TOCService.ts | TOC服务 | 未实现 |
| RedisService | core/cache/RedisService.ts | Redis服务 | 未实现 |
| AliExpressConnector | core/connectors/AliExpressConnector.ts | 阿里Express连接器 | 未实现 |
| AmazonConnector | core/connectors/AmazonConnector.ts | 亚马逊连接器 | 未实现 |
| IPlatformConnector | core/connectors/IPlatformConnector.ts | 平台连接器接口 | 未实现 |
| ShopeeConnector | core/connectors/ShopeeConnector.ts | Shopee连接器 | 未实现 |
| ShopifyConnector | core/connectors/ShopifyConnector.ts | Shopify连接器 | 未实现 |
| TikTokConnector | core/connectors/TikTokConnector.ts | TikTok连接器 | 未实现 |
| DistributedLockDecorator | core/decorators/DistributedLockDecorator.ts | 分布式锁装饰器 | 未实现 |
| CoreEngineService | core/engine/CoreEngineService.ts | 核心引擎服务 | 未实现 |
| RuleEngineService | core/engine/RuleEngineService.ts | 规则引擎服务 | 未实现 |
| WorkflowEngineService | core/engine/WorkflowEngineService.ts | 工作流引擎服务 | 未实现 |
| TurboGateway | core/gateway/TurboGateway.ts | Turbo网关 | 未实现 |
| AIGovernanceService | core/governance/standards/AIGovernanceService.ts | AI治理服务 | 未实现 |
| BehavioralRiskService | core/governance/BehavioralRiskService.ts | 行为风险服务 | 未实现 |
| DataComplianceService | core/governance/DataComplianceService.ts | 数据合规服务 | 未实现 |
| FeatureGovernanceService | core/governance/FeatureGovernanceService.ts | 功能治理服务 | 未实现 |
| FeatureToggleService | core/governance/FeatureToggleService.ts | 功能切换服务 | 未实现 |
| GuardrailService | core/governance/GuardrailService.ts | 护栏服务 | 未实现 |
| QuotaCircuitBreakerService | core/governance/QuotaCircuitBreakerService.ts | 配额熔断服务 | 未实现 |
| QuotaGovernanceService | core/governance/QuotaGovernanceService.ts | 配额治理服务 | 未实现 |
| RedTeamingService | core/governance/RedTeamingService.ts | 红队服务 | 未实现 |
| S3QuotaManager | core/governance/S3QuotaManager.ts | S3配额管理器 | 未实现 |
| ShadowAuditService | core/governance/ShadowAuditService.ts | 影子审计服务 | 未实现 |
| FraudDetectionService | core/graph/FraudDetectionService.ts | 欺诈检测服务 | 未实现 |
| mtls.guard.ts | core/guards/mtls.guard.ts | mTLS守卫 | 未实现 |
| rbac.guard.ts | core/guards/rbac.guard.ts | RBAC守卫 | 未实现 |
| sla.guard.ts | core/guards/sla.guard.ts | SLA守卫 | 未实现 |
| state-transition.guard.ts | core/guards/state-transition.guard.ts | 状态转换守卫 | 未实现 |
| trace-context.guard.ts | core/guards/trace-context.guard.ts | 跟踪上下文守卫 | 未实现 |
| WebhookService | core/integrations/WebhookService.ts | Webhook服务 | 未实现 |
| ShopIsolationService | core/isolation/ShopIsolationService.ts | 店铺隔离服务 | 未实现 |
| DIDHandshakeService | core/network/DIDHandshakeService.ts | DID握手服务 | 已实现 |
| FederatedNodeService | core/network/FederatedNodeService.ts | 联邦节点服务 | 未实现 |
| P2PConnectionService | core/network/P2PConnectionService.ts | P2P连接服务 | 未实现 |
| PrivateInventorySyncService | core/network/PrivateInventorySyncService.ts | 私有库存同步服务 | 未实现 |
| DomainEventBus | core/runtime/DomainEventBus.ts | 域事件总线 | 已实现 |
| DomainBootstrap | core/runtime/DomainBootstrap.ts | 域引导 | 已实现 |
### 2.5 工作器 (server/src/workers/)
| 模块名称 | 路径 | 功能描述 | 状态 |
|---------|------|---------|------|
| CrawlerWorker | workers/CrawlerWorker.ts | 爬虫工作器 | 已实现 |
## 3. 前端模块清单
### 3.1 浏览器扩展 (extension/src/)
| 模块名称 | 路径 | 功能描述 | 状态 |
|---------|------|---------|------|
| ABTestOptimizationService | extension/src/background/ABTestOptimizationService.ts | A/B测试优化服务 | 未实现 |
| ABTestStrategyService | extension/src/background/ABTestStrategyService.ts | A/B测试策略服务 | 未实现 |
| AutoShipService | extension/src/background/AutoShipService.ts | 自动发货服务 | 未实现 |
| DOMParser | extension/src/background/DOMParser.ts | DOM解析器 | 未实现 |
| FingerprintManager | extension/src/background/FingerprintManager.ts | 指纹管理器 | 未实现 |
| LogisticsSyncService | extension/src/background/LogisticsSyncService.ts | 物流同步服务 | 未实现 |
| MessageHandler | extension/src/background/MessageHandler.ts | 消息处理器 | 未实现 |
| OrderCollector | extension/src/background/OrderCollector.ts | 订单收集器 | 未实现 |
| RefundQuery | extension/src/background/RefundQuery.ts | 退款查询 | 未实现 |
| ReturnSync | extension/src/background/ReturnSync.ts | 退货同步 | 未实现 |
| index.ts | extension/src/background/index.ts | 后台入口 | 未实现 |
| services.ts | extension/src/background/services.ts | 后台服务 | 未实现 |
| index.ts | extension/src/content/index.ts | 内容脚本 | 未实现 |
| index.ts | extension/src/platforms/index.ts | 平台集成 | 未实现 |
| Logger | extension/src/utils/Logger.ts | 日志工具 | 未实现 |
| index.ts | extension/src/utils/index.ts | 工具入口 | 未实现 |
### 3.2 仪表板 (dashboard/src/pages/)
| 模块名称 | 路径 | 功能描述 | 状态 |
|---------|------|---------|------|
| ABTest | dashboard/src/pages/ABTest/ | A/B测试页面 | 未实现 |
| Ad | dashboard/src/pages/Ad/ | 广告页面 | 未实现 |
| AfterSales | dashboard/src/pages/AfterSales/ | 售后服务页面 | 未实现 |
| Auth | dashboard/src/pages/Auth/ | 认证页面 | 未实现 |
| B2B | dashboard/src/pages/B2B/ | B2B页面 | 未实现 |
| B2BTrade | dashboard/src/pages/B2BTrade/ | B2B贸易页面 | 未实现 |
| Compliance | dashboard/src/pages/Compliance/ | 合规页面 | 未实现 |
| Logistics | dashboard/src/pages/Logistics/ | 物流页面 | 未实现 |
| Orders | dashboard/src/pages/Orders/ | 订单页面 | 未实现 |
| Product | dashboard/src/pages/Product/ | 产品页面 | 未实现 |
| UserAsset | dashboard/src/pages/UserAsset/ | 用户资产页面 | 未实现 |
## 4. 文档结构
| 模块名称 | 路径 | 功能描述 | 状态 |
|---------|------|---------|------|
| Business_Blueprint.md | docs/00_Business/Business_Blueprint.md | 业务蓝图 | 未实现 |
| Business_ClosedLoops.md | docs/00_Business/Business_ClosedLoops.md | 业务闭环 | 未实现 |
| Business_ClosedLoops_Analysis.md | docs/00_Business/Business_ClosedLoops_Analysis.md | 业务闭环分析 | 未实现 |
| Governance_Standards.md | docs/00_Business/Governance_Standards.md | 治理标准 | 未实现 |
| Task_Overview.md | docs/00_Business/Task_Overview.md | 任务概览 | 已实现 |
| Module_Blueprints.md | docs/01_Architecture/Module_Blueprints.md | 模块蓝图 | 未实现 |
| System_Architecture.md | docs/01_Architecture/System_Architecture.md | 系统架构 | 未实现 |
| Data_API_Specs.md | docs/02_Backend/API_Specs/Data_API_Specs.md | 数据API规范 | 未实现 |
| Finance_API.md | docs/02_Backend/API_Specs/Finance_API.md | 财务API | 未实现 |
| Order_API.md | docs/02_Backend/API_Specs/Order_API.md | 订单API | 未实现 |
| Product_API.md | docs/02_Backend/API_Specs/Product_API.md | 产品API | 未实现 |
| Backend_Design.md | docs/02_Backend/Backend_Design.md | 后端设计 | 未实现 |
| Frontend_Design.md | docs/03_Frontend/Frontend_Design.md | 前端设计 | 未实现 |
| Pages_Flow.md | docs/03_Frontend/Pages_Flow.md | 页面流程 | 未实现 |
| UI_Components.md | docs/03_Frontend/UI_Components.md | UI组件 | 未实现 |
| DOM_Interaction.md | docs/04_Plugin/DOM_Interaction.md | DOM交互 | 未实现 |
| Plugin_Design.md | docs/04_Plugin/Plugin_Design.md | 插件设计 | 未实现 |
| AI_Module_List.md | docs/05_AI/AI_Module_List.md | AI模块列表 | 已实现 |
| AI_Strategy.md | docs/05_AI/AI_Strategy.md | AI策略 | 未实现 |
| Quality_Optimization.md | docs/07_Testing/Quality_Optimization.md | 质量优化 | 未实现 |
| DOC_INDEX.md | docs/10_Documents_Global/DOC_INDEX.md | 文档索引 | 未实现 |
| PROJECT_MAP.md | docs/10_Documents_Global/PROJECT_MAP.md | 项目地图 | 未实现 |
## 5. 模块状态分析
### 5.1 已实现模块
| 模块类型 | 模块名称 | 路径 |
|---------|---------|------|
| 后端服务 | BusinessModelEvolutionService | services/BusinessModelEvolutionService.ts |
| 后端服务 | CashflowForecastService | services/CashflowForecastService.ts |
| 后端服务 | DeployService | services/DeployService.ts |
| 后端服务 | DisputeResolverService | services/DisputeResolverService.ts |
| 后端服务 | DynamicPricingService | services/DynamicPricingService.ts |
| 后端服务 | SupplierService | services/SupplierService.ts |
| 后端服务 | TradeService | services/TradeService.ts |
| 后端服务 | InfluencerBotService | services/InfluencerBotService.ts |
| 后端服务 | InventoryAgingService | services/InventoryAgingService.ts |
| 后端服务 | MediaAssetService | services/MediaAssetService.ts |
| 后端服务 | FinanceReconciliationService | services/FinanceReconciliationService.ts |
| 后端服务 | ReportService | services/ReportService.ts |
| 后端服务 | RBACService | services/RBACService.ts |
| 后端服务 | FeatureActivationService | services/FeatureActivationService.ts |
| 后端服务 | MerchantSettlementService | services/MerchantSettlementService.ts |
| 后端服务 | MerchantProductOrderService | services/MerchantProductOrderService.ts |
| 后端服务 | BillingService | services/BillingService.ts |
| 核心模块 | DIDHandshakeService | core/network/DIDHandshakeService.ts |
| 核心模块 | DomainEventBus | core/runtime/DomainEventBus.ts |
| 核心模块 | DomainBootstrap | core/runtime/DomainBootstrap.ts |
| 工作器 | CrawlerWorker | workers/CrawlerWorker.ts |
| API路由 | ai.ts | api/routes/ai.ts |
| 文档 | Task_Overview.md | docs/00_Business/Task_Overview.md |
| 文档 | AI_Module_List.md | docs/05_AI/AI_Module_List.md |
| 文档 | Module_Inventory.md | docs/Module_Inventory.md |
### 5.2 抽象/过时模块清理记录
已清理以下抽象或过时的模块:
#### AI路由清理
- 已删除40个未实现的AI端点仅保留 `/ai/chat` 端点
- 清理的抽象功能包括:
- 联邦学习指标 (getFederatedMetrics)
- AI决策逻辑链 (getDecisionLogicChain, getDecisionNarrative, streamNarrative)
- 情感分析与风格对齐 (analyzeSentiment, alignStyle)
- 视频处理 (processVideo)
- 语义漂移检测 (detectSemanticDrift)
- 安全相关 (scanPrompt, runTEEProtectedTask, initiateDIDHandshake, toggleKillSwitch)
- AGI自我进化 (triggerSelfEvolution, checkQuota, getCounterpartyProfile)
- 采购联盟 (joinSourcingAlliance)
- 碳信用 (issueCarbonCredit)
- 危机检测 (detectCrisis)
- 跨主权资源 (publishResource, findOptimalResource)
- 算力池 (getComputePoolStatus, scheduleComputeJob)
- 数据湖优化 (optimizeDataLake, migrateColdData)
### 5.3 未实现模块
项目中大部分模块尚未实现,包括:
- 大部分后端服务约180+个)
- 所有API控制器
- 大部分API路由
- 大部分核心模块
- 所有前端扩展模块
- 所有仪表板页面
- 大部分文档
### 5.4 模块实现率
| 模块类型 | 总数 | 已实现 | 实现率 |
|---------|------|--------|--------|
| 后端服务 | 197 | 17 | 8.63% |
| API控制器 | 30 | 0 | 0% |
| API路由 | 32 | 1 | 3.13% |
| 核心模块 | 50 | 3 | 6% |
| 工作器 | 1 | 1 | 100% |
| 前端扩展 | 12 | 0 | 0% |
| 仪表板页面 | 11 | 0 | 0% |
| 文档 | 22 | 4 | 18.18% |
| **总计** | **325** | **26** | **7.94%** |
> AI路由已从原来的50+个端点清理为1个有效端点移除了40个抽象/未实现的端点
## 6. 模块清理建议
### 6.1 过时或抽象模块识别
根据项目结构和代码分析,以下类型的模块可能被视为过时或抽象:
**真正的抽象/空壳模块:**
1. **只有接口定义** - `export interface xxx``export type xxx`,没有 class 实现
2. **方法体为空** - 只有方法签名,没有实际业务逻辑
3. **只有 TODO 注释** - 没有实际代码实现
**注意:以下不算抽象,它们有完整业务逻辑实现:**
- ✅ 有 `static async` 方法实现
- ✅ 有数据库操作db.insert, db.select 等)
- ✅ 有业务逻辑计算
- ✅ 有完整的 if/else 流程
**其他需要清理的类型:**
4. **重复功能**:多个模块提供相似功能
5. **未使用模块**:在代码中没有被引用的模块
6. **技术债务**:使用过时技术或架构的模块
### 6.2 清理建议
| 清理类型 | 建议操作 | 理由 |
|---------|---------|------|
| 抽象服务 | 暂时保留,作为未来实现的基础 | 虽然抽象,但提供了良好的接口定义 |
| 重复功能 | 合并相似模块,保留功能最完整的 | 减少代码冗余,提高维护性 |
| 未使用模块 | 标记为待实现或移除 | 减少项目复杂度,提高构建速度 |
| 技术债务 | 重构或重写 | 提高代码质量和性能 |
### 6.3 具体清理建议
1. **AI相关模块**大部分AI模块尚未实现建议先实现核心功能再扩展其他模块
2. **前端扩展**:根据实际需求优先实现核心功能,如订单收集和物流同步
3. **仪表板页面**:优先实现常用页面,如订单管理和产品管理
4. **后端服务**:优先实现业务核心服务,如订单、支付、物流等
## 7. 业务闭环分类与实现状态
### 7.1 业务闭环清单共37个
| 序号 | 闭环名称 | 对应服务 | 代码实现状态 |
|------|---------|---------|-------------|
| 1 | 数据采集与清洗 | PlatformApiService, RLCrawlerService | ⚠️ 部分实现 |
| 2 | 商品刊登 | ProductService, PublishService | ⚠️ 部分实现 |
| 3 | 素材管理 | ImageFingerprintService | ❌ 未实现 |
| 4 | 广告计划与营销 | AdPlanService, AdOptimizationService | ⚠️ 部分实现 |
| 5 | 订单履约 | OrderService, LogisticsService | ⚠️ 部分实现 |
| 6 | 售后逆向 | AfterSalesService, ReturnRateMonitorService | ⚠️ 部分实现 |
| 7 | 资金对账 | FinanceService, MultiCurrencyFinanceService | ❌ 未实现 |
| 8 | 库存与仓储 | InventoryService, WarehouseService | ⚠️ 部分实现 |
| 9 | 供应链与供应商 | SupplierService, SupplyChainService | ✅ 已实现 |
| 10 | B2B/TOB贸易 | B2BTradeService, TradeService | ✅ 已实现 |
| 11 | 治理与审批 | GovernanceController, QuotaCircuitBreakerService | ⚠️ 部分实现 |
| 12 | 合规与证书 | ComplianceCheckService, CertificateService | ⚠️ 部分实现 |
| 13 | 合规与风控 | RiskAssessmentService, BehavioralRiskService | ⚠️ 部分实现 |
| 14 | 报表与分析 | ReportService, AnalyticsService | ❌ 未实现 |
| 15 | 定价与利润决策 | PricingService, DynamicPricingService | ✅ 已实现 |
| 16 | 账号/店铺健康度 | ProductHealthService, ChannelStatusService | ⚠️ 部分实现 |
| 17 | 店铺隔离与自动化 | ShopIsolationService, AutoDiagnosticsService | ⚠️ 部分实现 |
| 18 | 订单集中管理 | OrderService | ⚠️ 部分实现 |
| 19 | 客户/商家押金与账户 | UserAssetService, MemberLevelService | ⚠️ 部分实现 |
| 20 | 商家选择发货 | MerchantService | ⚠️ 部分实现 |
| 21 | 回款与财务 | PaymentService, PayoutService | ⚠️ 部分实现 |
| 22 | 海外仓/本土仓 | BondedWarehouseService, WarehouseService | ⚠️ 部分实现 |
| 23 | 商品主数据 | ProductService, SKUMappingService | ⚠️ 部分实现 |
| 24 | SKU变体与结构 | SKUMappingService | ⚠️ 部分实现 |
| 25 | 订单拆分与合并 | OrderService | ⚠️ 部分实现 |
| 26 | 异常订单处理 | OrderService, ExceptionAutoFixService | ⚠️ 部分实现 |
| 27 | 物流策略与渠道 | LogisticsService, DynamicShippingService | ⚠️ 部分实现 |
| 28 | 利润核算 | OrderProfitService, PricingAuditService | ⚠️ 部分实现 |
| 29 | 用户/客户资产 | UserAssetService, PointsService | ⚠️ 部分实现 |
| 30 | A/B测试与策略优化 | ABTestService, ABTestAnalysisService | ⚠️ 部分实现 |
| 31 | 多商户入驻与认证 | MerchantService, AuthService | ⚠️ 部分实现 |
| 32 | 功能模块化与权限 | RBACEngine, FeatureToggleService | ❌ 未实现 |
| 33 | 功能开通与支付 | PaymentService, PointsService | ❌ 未实现 |
| 34 | 多商户结算与财务 | SettlementController, MultiAssetSettlementService | ❌ 未实现 |
| 35 | 多商户商品与订单 | ProductService, OrderService | ❌ 未实现 |
| 36 | 恶意买家黑名单 | BlacklistService, BlacklistDatabaseService | ⚠️ 部分实现 |
| 37 | 高退货率SKU自动下架 | AutoDelistService, ReturnRateMonitorService | ⚠️ 部分实现 |
### 7.2 业务闭环实现状态统计
| 状态 | 数量 | 说明 |
|------|------|------|
| ✅ 已实现 | 3 | 有完整业务逻辑实现 |
| ⚠️ 部分实现 | 25 | 有基础方法但未完全闭环 |
| ❌ 未实现 | 9 | 只有接口定义或空壳 |
### 7.3 相对抽象的业务闭环(建议优先实现)
以下业务闭环在代码中没有对应的实现或只有空壳,建议优先实现:
| 闭环名称 | 原因 | 建议实现优先级 |
|---------|------|---------------|
| 素材管理 | 无对应服务实现 | P1 - 高 |
| 资金对账 | 无完整服务实现 | P1 - 高 |
| 报表与分析 | ReportService 为空壳 | P1 - 高 |
| 功能模块化与权限 | RBACEngine 未实现 | P2 - 中 |
| 功能开通与支付 | 无对应服务 | P2 - 中 |
| 多商户结算与财务 | 无完整服务实现 | P3 - 低 |
| 多商户商品与订单 | 无完整服务实现 | P3 - 低 |
### 7.4 实现建议
**优先级划分:**
- **P1 (高)**:核心业务功能,影响整体流程
- **P2 (中)**:重要功能,提升系统能力
- **P3 (低)**:扩展功能,可后期实现
**具体实现建议:**
1. **P1 优先级**
- **素材管理**:实现 ImageFingerprintService支持图片处理和素材库管理
- **资金对账**:完善 FinanceService实现多币种、VAT、汇率处理
- **报表与分析**:实现 ReportService提供数据可视化和 KPI 分析
2. **P2 优先级**
- **功能模块化与权限**:实现 RBACEngine完善权限控制
- **功能开通与支付**:实现 PaymentService支持功能开通和支付流程
3. **P3 优先级**
- **多商户结算与财务**:实现 MultiAssetSettlementService
- **多商户商品与订单**:完善 ProductService 和 OrderService 对多商户的支持
**实现顺序建议:**
1. 供应链与供应商(已实现)→ 定价与利润决策(已实现)→ B2B/TOB贸易已实现
2. 订单履约 → 库存与仓储 → 售后逆向
3. 资金对账 → 报表与分析 → 素材管理
4. 功能模块化与权限 → 多商户功能
**技术实现要点:**
- 遵循项目规则,使用 `cf_` 表前缀
- 实现 `initTable` 方法进行数据库初始化
- 确保服务之间的依赖关系清晰
- 遵循业务闭环的状态机设计
## 8. 总结
本项目是一个功能丰富的电商平台系统包含多个模块和服务。目前实现率较低约5%),大部分模块处于未实现状态。建议按照业务优先级逐步实现核心功能,同时保持代码结构的清晰和一致性。
通过本模块清单,可以清晰了解项目的整体结构和实现状态,为后续的开发和维护提供参考。