# 服务文件迁移计划

## 1. 目录结构约定

### 1.1 核心目录结构

```
services/
├── auth/             # 认证相关服务
├── compliance/       # 合规相关服务
├── finance/          # 财务相关服务
├── inventory/        # 库存相关服务
├── marketing/        # 营销相关服务
├── order/            # 订单相关服务
├── product/          # 商品相关服务 (注意：使用小写，与现有Product目录保持一致)
├── logistics/        # 物流相关服务
├── supplier/         # 供应商相关服务
├── customer/         # 客户相关服务
├── platform/         # 平台相关服务
├── analytics/        # 分析相关服务
├── ai/               # AI相关服务
├── core/             # 核心基础服务
├── integration/      # 集成相关服务
├── monitoring/       # 监控相关服务
├── security/         # 安全相关服务
├── settlement/       # 结算相关服务
├── sovereignty/      # 主权相关服务
├── webhook/          # Webhook相关服务
└── __tests__/        # 测试相关服务
```

### 1.2 命名约定

- **目录名**: 使用小写字母，单词之间用连字符 `-` 分隔（如 `order-fulfillment`）
- **文件名**: 使用驼峰命名法，以 `Service.ts` 结尾（如 `OrderService.ts`）
- **服务类名**: 使用驼峰命名法，以 `Service` 结尾（如 `OrderService`）

### 1.3 导入路径约定

- 使用相对路径导入，避免使用绝对路径
- 路径大小写与实际目录结构保持一致
- 导入语句格式：`import { ServiceName } from './directory/ServiceName';`

## 2. 迁移计划

### 2.1 第一阶段：分类整理

1. **Auth 服务**
   - 已存在，无需迁移

2. **Compliance 服务**
   - 已存在，无需迁移

3. **Finance 服务**
   - 已存在，无需迁移

4. **Inventory 服务**
   - 已存在，无需迁移

5. **Marketing 服务**
   - 已存在，无需迁移

6. **Order 服务**
   - 已存在，无需迁移

7. **Product 服务**
   - 已存在（当前为 `Product/`，需要保持一致）

8. **Logistics 服务**
   - 迁移：`LogisticsService.ts`, `LastMileOptimizerService.ts`, `LogisticTTLService.ts`, `LogisticTelemetryService.ts`, `LogisticsInsuranceService.ts`, `LogisticsIntelligenceService.ts`, `FailoverLogisticsService.ts`, `SeaFreightAdvisor.ts`, `WMSAdvisor.ts`

9. **Supplier 服务**
   - 迁移：`SupplierService.ts`, `SupplierRiskRadar.ts`, `SupplierRiskRadarService.ts`, `SupplierInquiryService.ts`, `SupplierBlacklistService.ts`

10. **Customer 服务**
    - 迁移：`CustomerService.ts`, `CustomerServiceAgent.ts`, `UserService.ts`, `UserAssetService.ts`, `UserValueAnalysisService.ts`, `MemberLevelService.ts`

11. **Platform 服务**
    - 迁移：`PlatformApiService.ts`, `PlatformAccountService.ts`, `PlatformFeeWatcher.ts`, `IndependentSiteService.ts`, `StoreService.ts`, `StoreCreationService.ts`

12. **Analytics 服务**
    - 迁移：`AnalyticsService.ts`, `PredictiveAnalysis.ts`, `MerchantAnalysisService.ts`, `MerchantBehaviorAnalysisService.ts`, `MerchantDataStatisticsService.ts`, `ShopReportAggregationService.ts`, `TrueROASService.ts`

13. **AI 服务**
    - 迁移：`AIService.ts`, `AIDecisionService.ts`, `AIDecisionSystem.ts`, `AIDecisionLogService.ts`, `AgentSwarmService.ts`, `BlacklistAI.ts`, `SentimentAIService.ts`, `IntelligentRecommendation.ts`, `B2BAIService.ts`, `InfluencerBotService.ts`, `NegotiationBotService.ts`

14. **Core 服务**
    - 迁移：`CoreServicePriorityService.ts`, `CoreBusinessService.ts`, `BullMQService.ts`, `BullMQDeadLetterService.ts`, `AsyncOperationService.ts`, `ContentGapService.ts`, `DatabaseOptimizationService.ts`, `DeployService.ts`, `DevOpsService.ts`, `EdgeSyncService.ts`, `ExperimentService.ts`, `FeatureActivationService.ts`, `InfrastructureService.ts`, `MessageProcessingService.ts`, `ProcurementAuditService.ts`, `QuotaCircuitBreakerService.ts`, `ReasoningPipelineService.ts`, `SelfHealingService.ts`, `SemanticLogService.ts`, `SmartPricingService.ts`, `TaskCenterService.ts`, `UnifiedTaskService.ts`, `UsageService.ts`

15. **Integration 服务**
    - 迁移：`CrossBorderService.ts`, `CrossBorderIntegrationService.ts`, `CustomsDeclarationService.ts`, `DataIsolationService.ts`, `DataManagementService.ts`, `GreenSupplyChainService.ts`, `GreenSupplyService.ts`, `LiveScriptService.ts`, `ManufacturingCoordinationService.ts`, `OmnichannelCommunicationService.ts`, `PackingOptimizer.ts`, `PathSimulatorService.ts`, `PoolSourcingService.ts`, `SupplyChainService.ts`, `SyncService.ts`, `TraceabilityService.ts`, `TracingTopoService.ts`, `UnifiedFulfillmentService.ts`

16. **Monitoring 服务**
    - 迁移：`MonitoringAlertService.ts`, `GlobalCSMonitor.ts`, `PRMonitorService.ts`, `LeaderboardService.ts`, `MerchantMonitorService.ts`, `StoreService.ts`, `StuckTrackingService.ts`

17. **Security 服务**
    - 迁移：`AutoCircuitBreakerService.ts`, `ConfidentialSharingService.ts`, `CongestionFailoverService.ts`, `ContainerQuotaService.ts`, `DeadlockAdvisor.ts`, `TEEComputeService.ts`, `ZKPSovereignAdmissionService.ts`

18. **Settlement 服务**
    - 迁移：`MerchantSettlementService.ts`, `TaxService.ts`, `TaxReportService.ts`, `TaxIncentivesService.ts`, `TaxBonusService.ts`, `PaymentRiskService.ts`, `PayoutAppealService.ts`, `MicroCreditService.ts`, `CreditLimitService.ts`, `LiquidityHedgingService.ts`

19. **Sovereignty 服务**
    - 迁移：`SovereigntyGovernanceService.ts`, `SovereigntyIdentityService.ts`, `SovereigntyReputationService.ts`, `SovereigntyReputationV2Service.ts`, `SovereigntySettlementService.ts`, `SovereignCreditPoolService.ts`, `SovereignLedgerService.ts`, `SovereignLogisticsV2Service.ts`, `SovereignMediationService.ts`, `BrandSovereigntyService.ts`, `BlockchainTraceabilityService.ts`

20. **Webhook 服务**
    - 迁移：`WebhookService.ts`

### 2.2 第二阶段：修复导入路径

1. 遍历所有服务文件，更新导入路径
2. 修复由于目录结构变化导致的导入错误
3. 确保所有导入路径大小写正确

### 2.3 第三阶段：验证和测试

1. 启动后端服务，验证所有服务正常加载
2. 运行测试，确保所有功能正常
3. 检查TypeScript编译错误

## 3. 注意事项

### 3.1 Windows目录大小写问题

- Windows文件系统大小写不敏感，但TypeScript编译器和导入路径是大小写敏感的
- 确保所有目录和文件名称的大小写与导入路径一致
- 统一使用小写目录名，避免大小写混合

### 3.2 依赖关系处理

- 迁移过程中注意处理服务之间的依赖关系
- 先迁移基础服务，再迁移依赖于它们的服务
- 确保迁移后所有依赖关系仍然有效

### 3.3 备份和回滚

- 在迁移前备份整个services目录
- 制定回滚计划，以防迁移过程中出现问题
- 分阶段迁移，每个阶段完成后验证功能

## 4. 迁移进度跟踪

| 阶段 | 状态 | 完成时间 | 备注 |
|------|------|----------|------|
| 目录结构设计 | ✅ | 2026-03-23 | 已完成 |
| 第一阶段：分类整理 | 🔄 | - | 进行中 |
| 第二阶段：修复导入路径 | ⏳ | - | 待开始 |
| 第三阶段：验证和测试 | ⏳ | - | 待开始 |
