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

48 KiB
Raw Blame History

项目模块清单与说明

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 xxxexport 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%),大部分模块处于未实现状态。建议按照业务优先级逐步实现核心功能,同时保持代码结构的清晰和一致性。

通过本模块清单,可以清晰了解项目的整体结构和实现状态,为后续的开发和维护提供参考。