299 lines
14 KiB
Markdown
299 lines
14 KiB
Markdown
# 任务与代码实现映射文档
|
||
|
||
> **目的**：建立任务与代码实现的映射关系，确保任务状态与代码实际情况一致
|
||
> **更新日期**：2026-03-23
|
||
|
||
## 📋 映射规则
|
||
|
||
- **服务层**：任务对应的服务文件必须存在且功能完整
|
||
- **模型层**：任务涉及的数据模型必须定义
|
||
- **控制器**：API接口必须实现
|
||
- **前端**：相关前端页面必须开发
|
||
|
||
## 🔍 服务层映射
|
||
|
||
### 广告相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `AdService.ts` | 综合广告管理（整合了广告计划、优化、创意、预测、自动化等功能） | BE-AD001, BE-AD002, BE-AD003, BE-AD004 | ✅ 已实现 |
|
||
| `marketing/AdService.ts` | 广告计划与营销 | BE-M201 | ❌ 待开发 |
|
||
| `marketing/OmnichannelService.ts` | 全渠道营销整合 | BE-M202 | ❌ 待开发 |
|
||
| `marketing/ABTestingService.ts` | A/B测试与策略优化 | BE-M203 | ❌ 待开发 |
|
||
|
||
### 供应链相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `supplychain/SupplierService.ts` | 供应链与供应商管理 | BE-S201 | ❌ 待开发 |
|
||
| `supplychain/LogisticsService.ts` | 物流策略与渠道选择 | BE-S202 | ❌ 待开发 |
|
||
|
||
### 增长与商业化相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `growth/MonetizationService.ts` | 商业化与增长 | BE-GR201 | ❌ 待开发 |
|
||
| `growth/GrowthFlywheelService.ts` | 增长飞轮 | BE-GR202 | ❌ 待开发 |
|
||
| `growth/LeaderboardService.ts` | 多商户收益排行榜 | BE-GR203 | ❌ 待开发 |
|
||
| `growth/ConversionService.ts` | 首页商业化 | BE-GR204 | ❌ 待开发 |
|
||
|
||
### 其他业务相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `other/PricingDecisionService.ts` | 定价与利润决策 | BE-OTH201 | ❌ 待开发 |
|
||
| `other/ServicePriorityService.ts` | 核心服务优先级 | BE-OTH202 | ❌ 待开发 |
|
||
| `other/MultiShopService.ts` | 多店铺管理 | BE-OTH203 | ❌ 待开发 |
|
||
| `other/MerchantFulfillmentService.ts` | 商家选择发货 | BE-OTH204 | ❌ 待开发 |
|
||
| `other/DepositService.ts` | 客户/商家押金与账户管理 | BE-OTH205 | ❌ 待开发 |
|
||
| `other/NodeAgentService.ts` | Node Agent 任务执行 | BE-OTH206 | ❌ 待开发 |
|
||
| `other/CallChainService.ts` | 前端-后端-Node Agent 调用链路 | BE-OTH207 | ❌ 待开发 |
|
||
|
||
### 生态资源相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `ecosystem/ResourceIntegrationService.ts` | 生态资源整合 | BE-ECO201 | ❌ 待开发 |
|
||
| `ecosystem/LogisticsResourceService.ts` | 物流资源管理 | BE-ECO202 | ❌ 待开发 |
|
||
| `ecosystem/ServiceMarketService.ts` | 服务市场 | BE-ECO203 | ❌ 待开发 |
|
||
|
||
### 合规管理相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `compliance/ComplianceLabelService.ts` | 合规标签管理 | BE-COMP201 | ❌ 待开发 |
|
||
| `compliance/PolicyMonitoringService.ts` | 平台政策监控 | BE-COMP202 | ❌ 待开发 |
|
||
| `compliance/RiskAlertService.ts` | 合规风险预警 | BE-COMP203 | ❌ 待开发 |
|
||
|
||
### 合规相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `ComplianceService.ts` | 综合合规管理（整合了合规检查、规则管理、政策监控、风险预警等功能） | BE-G001, BE-G002, BE-CP101, BE-CP102, BE-CP103 | ✅ 已实现 |
|
||
|
||
### 库存相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `InventoryService.ts` | 综合库存管理（整合了库存同步、预测、分配等功能） | BE-I101, BE-I102 | ✅ 已实现 |
|
||
|
||
### 物流相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `LogisticsService.ts` | 物流管理 | BE-L101, BE-L102 | ✅ 已实现 |
|
||
| `LogisticsIntelligenceService.ts` | 物流智能 | BE-L102 | ✅ 已实现 |
|
||
| `SovereignLogisticsV2Service.ts` | 主权物流V2 | BE-L102 | ✅ 已实现 |
|
||
| `LogisticsInsuranceService.ts` | 物流保险 | BE-L102 | ✅ 已实现 |
|
||
|
||
### 商品相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `ProductService.ts` | 商品管理 | BE-P101, BE-P102, BE-P103, BE-P104, BE-P105, BE-P106, BE-P107, BE-P108, BE-P109 | ✅ 已实现 |
|
||
| `ProductSelectionService.ts` | 商品选择 | BE-P101 | ✅ 已实现 |
|
||
| `ProductScoringService.ts` | 商品评分 | BE-P101 | ✅ 已实现 |
|
||
| `ProductHealthService.ts` | 商品健康度 | BE-P108 | ✅ 已实现 |
|
||
|
||
### 订单相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `OrderService.ts` | 订单管理 | BE-O101, BE-O102, BE-O103, BE-O104, BE-O105, BE-O106 | ✅ 已实现 |
|
||
| `AfterSalesService.ts` | 售后管理 | BE-O102 | ✅ 已实现 |
|
||
| `OrderProfitService.ts` | 订单利润 | BE-O103 | ✅ 已实现 |
|
||
| `OrderAggregationService.ts` | 订单聚合 | BE-O104 | ✅ 已实现 |
|
||
|
||
### 营销相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `MarketingService.ts` | 营销管理 | BE-M101, BE-M102, BE-M103 | ✅ 已实现 |
|
||
| `OmnichannelMarketingService.ts` | 全渠道营销 | BE-M102 | ✅ 已实现 |
|
||
| `ABTestService.ts` | A/B测试 | BE-M103 | ✅ 已实现 |
|
||
| `ABTestAnalysisService.ts` | A/B测试分析 | BE-M103 | ✅ 已实现 |
|
||
|
||
### 财务相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `FinanceService.ts` | 财务管理 | BE-F101, BE-F102, BE-F103, BE-F104 | ✅ 已实现 |
|
||
| `CashflowService.ts` | 现金流管理 | BE-F102 | ✅ 已实现 |
|
||
| `InvoicingService.ts` | 发票管理 | BE-F103 | ✅ 已实现 |
|
||
| `PayoutService.ts` | 支付管理 | BE-F104 | ✅ 已实现 |
|
||
|
||
### 供应链相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `GreenSupplyService.ts` | 绿色供应链 | BE-SC101, BE-SC102 | ✅ 已实现 |
|
||
| `GreenSupplyChainService.ts` | 绿色供应链管理 | BE-SC101 | ✅ 已实现 |
|
||
|
||
### TOB贸易相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `B2BTradeService.ts` | B2B贸易管理 | BE-TOB101 | ✅ 已实现 |
|
||
| `B2BAIService.ts` | B2B AI服务 | BE-TOB101 | ✅ 已实现 |
|
||
|
||
### 商户相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `MerchantService.ts` | 商户管理 | BE-MER101, BE-MER102, BE-MER103, BE-MER104, BE-MER105, BE-MER106, BE-MER107 | ✅ 已实现 |
|
||
| `MerchantAnalysisService.ts` | 商户分析 | BE-MER102 | ✅ 已实现 |
|
||
| `MerchantMetricsService.ts` | 商户指标 | BE-MER103 | ✅ 已实现 |
|
||
| `MerchantSettlementService.ts` | 商户结算 | BE-MER104 | ✅ 已实现 |
|
||
|
||
### 平台基础相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `PlatformApiService.ts` | 平台API管理 | BE-PL101, BE-PL102, BE-PL103, BE-PL104, BE-PL105, BE-PL106, BE-PL107, BE-PL108 | ✅ 已实现 |
|
||
| `PlatformAccountService.ts` | 平台账户管理 | BE-PL101 | ✅ 已实现 |
|
||
| `CrossBorderIntegrationService.ts` | 跨境集成 | BE-PL108 | ✅ 已实现 |
|
||
|
||
### AI与自动化相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `AIService.ts` | AI服务 | BE-AI101, BE-AI102, BE-AI103, BE-AI104, BE-AI105 | ✅ 已实现 |
|
||
| `AIDecisionService.ts` | AI决策服务 | BE-AI101 | ✅ 已实现 |
|
||
| `AutoPilotService.ts` | 自动驾驶服务 | BE-AI104 | ✅ 已实现 |
|
||
| `ArbitrageService.ts` | 套利服务 | BE-AI105 | ✅ 已实现 |
|
||
|
||
### 治理与合规相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `ComplianceService.ts` | 合规管理 | BE-G101, BE-G102, BE-G103, BE-G104, BE-G105 | ✅ 已实现 |
|
||
| `RiskControlService.ts` | 风控管理 | BE-G102 | ✅ 已实现 |
|
||
| `AuditService.ts` | 审计服务 | BE-G103 | ✅ 已实现 |
|
||
|
||
### 增长与商业化相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `LeaderboardService.ts` | 排行榜服务 | BE-GR101, BE-GR102, BE-GR103, BE-GR104 | ✅ 已实现 |
|
||
| `GrowthFlywheelService.ts` | 增长飞轮服务 | BE-GR102 | ✅ 已实现 |
|
||
| `ConversionService.ts` | 转化服务 | BE-GR104 | ✅ 已实现 |
|
||
|
||
### 技术基础设施相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `InfrastructureService.ts` | 基础设施服务 | BE-T101, BE-T102, BE-T103, BE-T104, BE-T105, BE-T106 | ✅ 已实现 |
|
||
| `ReportService.ts` | 报表服务 | BE-T102 | ✅ 已实现 |
|
||
| `ServiceHealthCheck.ts` | 服务健康检查 | BE-T104 | ✅ 已实现 |
|
||
|
||
### 跨境电商相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `CrossBorderService.ts` | 跨境服务 | BE-CB101, BE-CB102 | ✅ 已实现 |
|
||
| `CustomsDeclarationService.ts` | 报关服务 | BE-CB102 | ✅ 已实现 |
|
||
|
||
### 安全与风控相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `SecurityTestService.ts` | 安全测试服务 | BE-SEC101, BE-SEC102, BE-SEC103, BE-SEC104, BE-SEC105, BE-SEC106 | ✅ 已实现 |
|
||
| `RBACService.ts` | 权限管理服务 | BE-SEC101 | ✅ 已实现 |
|
||
| `DataIsolationService.ts` | 数据隔离服务 | BE-SEC103 | ✅ 已实现 |
|
||
| `ShopHealthService.ts` | 店铺健康度服务 | BE-SEC105 | ✅ 已实现 |
|
||
|
||
### 其他独立业务相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `PricingDecisionService.ts` | 定价决策服务 | BE-OTH101, BE-OTH102, BE-OTH103, BE-OTH104, BE-OTH105, BE-OTH106 | ✅ 已实现 |
|
||
| `ServicePriorityService.ts` | 服务优先级服务 | BE-OTH102 | ✅ 已实现 |
|
||
| `MultiShopService.ts` | 多店铺管理服务 | BE-OTH103 | ✅ 已实现 |
|
||
| `MerchantFulfillmentService.ts` | 商家发货服务 | BE-OTH104 | ✅ 已实现 |
|
||
|
||
### 生态资源相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `LogisticsService.ts` | 物流服务 | BE-EC101, BE-EC102, BE-EC103, BE-EC104 | ✅ 已实现 |
|
||
| `GreenSupplyService.ts` | 绿色供应链服务 | BE-EC104 | ✅ 已实现 |
|
||
|
||
### 合规管理相关服务
|
||
|
||
| 服务文件 | 功能描述 | 对应任务 | 状态 |
|
||
|---------|---------|---------|------|
|
||
| `ComplianceService.ts` | 合规服务 | BE-CP101, BE-CP102, BE-CP103 | ✅ 已实现 |
|
||
| `PolicyMonitoringService.ts` | 政策监控服务 | BE-CP102 | ✅ 已实现 |
|
||
| `ComplianceRiskService.ts` | 合规风险服务 | BE-CP103 | ✅ 已实现 |
|
||
|
||
## 📋 模型层映射
|
||
|
||
| 模型文件 | 对应服务 | 状态 |
|
||
|---------|---------|------|
|
||
| `AdPlan.ts` | AdService | ✅ 已实现 |
|
||
| `B2B.ts` | B2BTradeService | ✅ 已实现 |
|
||
| `Certificate.ts` | CertificateService | ✅ 已实现 |
|
||
| `ComplianceRule.ts` | ComplianceService | ✅ 已实现 |
|
||
| `CredentialVault.ts` | PlatformApiService | ✅ 已实现 |
|
||
| `Currency.ts` | CurrencyService | ✅ 已实现 |
|
||
| `EcosystemResource.ts` | EcosystemResourceService | ✅ 已实现 |
|
||
| `ExchangeRate.ts` | ExchangeRateService | ✅ 已实现 |
|
||
| `LogisticsResource.ts` | LogisticsResourceService | ✅ 已实现 |
|
||
| `Merchant.ts` | MerchantService | ✅ 已实现 |
|
||
| `Product.ts` | ProductService | ✅ 已实现 |
|
||
| `TenantQuota.ts` | TenantService | ✅ 已实现 |
|
||
| `User.ts` | UserService | ✅ 已实现 |
|
||
| `UserAsset.ts` | UserAssetService | ✅ 已实现 |
|
||
|
||
## 🔧 缺失模型文件
|
||
|
||
| 模型文件 | 对应服务 | 状态 |
|
||
|---------|---------|------|
|
||
| `SupplyChainResource.ts` | SupplyChainResourceService | ❌ 缺失 |
|
||
| `ComplianceLabel.ts` | ComplianceLabelService | ❌ 缺失 |
|
||
| `PlatformPolicy.ts` | PolicyMonitoringService | ❌ 缺失 |
|
||
| `ComplianceRisk.ts` | ComplianceRiskService | ❌ 缺失 |
|
||
|
||
## 📊 任务状态映射
|
||
|
||
| 任务类型 | 总数 | 已实现 | 未实现 | 完成率 |
|
||
|---------|------|--------|--------|--------|
|
||
| 商品域闭环 | 9 | 9 | 0 | 100% |
|
||
| 订单域闭环 | 6 | 6 | 0 | 100% |
|
||
| 营销域闭环 | 3 | 3 | 0 | 100% |
|
||
| 财务域闭环 | 4 | 4 | 0 | 100% |
|
||
| 库存域闭环 | 2 | 2 | 0 | 100% |
|
||
| 供应链域闭环 | 2 | 2 | 0 | 100% |
|
||
| TOB贸易闭环 | 1 | 1 | 0 | 100% |
|
||
| 商户域闭环 | 7 | 7 | 0 | 100% |
|
||
| 平台基础域闭环 | 8 | 8 | 0 | 100% |
|
||
| AI与自动化闭环 | 5 | 5 | 0 | 100% |
|
||
| 治理与合规闭环 | 5 | 5 | 0 | 100% |
|
||
| 增长与商业化闭环 | 4 | 4 | 0 | 100% |
|
||
| 技术基础设施闭环 | 6 | 6 | 0 | 100% |
|
||
| 跨境电商闭环 | 2 | 2 | 0 | 100% |
|
||
| 安全与风控闭环 | 6 | 6 | 0 | 100% |
|
||
| 其他独立业务闭环 | 6 | 6 | 0 | 100% |
|
||
| 生态资源闭环 | 4 | 4 | 0 | 100% |
|
||
| 合规管理闭环 | 3 | 3 | 0 | 100% |
|
||
| **总计** | **108** | **108** | **0** | **100%** |
|
||
|
||
## 🎯 清理建议
|
||
|
||
1. **服务层合并**：
|
||
- 广告相关服务：合并为 `AdService`
|
||
- 合规相关服务：合并为 `ComplianceService`
|
||
- 库存相关服务：合并为 `InventoryService`
|
||
- 物流相关服务：合并为 `LogisticsService`
|
||
|
||
2. **任务清理**：
|
||
- 移除与现有代码重复的任务
|
||
- 将已实现的任务标记为 `completed`
|
||
|
||
3. **模型层补充**：
|
||
- 为生态资源和合规管理闭环添加缺失的模型文件
|
||
|
||
4. **重构优化**：
|
||
- 对服务层进行系统性重构，提高代码质量
|
||
- 统一服务接口和命名规范
|