makemd/docs/TASKS/code_mapping.md

任务与代码实现映射文档

目的：建立任务与代码实现的映射关系，确保任务状态与代码实际情况一致 更新日期：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. 重构优化：

   • 对服务层进行系统性重构，提高代码质量
   • 统一服务接口和命名规范