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)
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
# 📌 Crawlful Hub 业务闭环(TOC + TOB Unified Business Loops)
|
||||
|
||||
> **说明**:本闭环文档是战略层业务流程,关注"做什么、为什么做、顺序和决策点",为下层模块功能和系统实现提供指引。TOC(零售/前端)和 TOB(B2B贸易)共享通用模块,特有流程用 `businessType` 标记。共 **35个业务闭环**。
|
||||
> **说明**:本闭环文档是战略层业务流程,关注"做什么、为什么做、顺序和决策点",为下层模块功能和系统实现提供指引。TOC(零售/前端)和 TOB(B2B贸易)共享通用模块,特有流程用 `businessType` 标记。共 **45个业务闭环**。
|
||||
|
||||
## 📑 目录
|
||||
|
||||
@@ -35,16 +35,26 @@
|
||||
29. [用户/客户资产闭环](#2️⃣9️⃣-用户客户资产闭环usercustomer-asset-loop)
|
||||
30. [A/B测试与策略优化闭环](#3️⃣0️⃣-ab测试与策略优化闭环ab-testing--strategy-optimization-loop)
|
||||
31. [多商户入驻与认证闭环](#3️⃣1️⃣-多商户入驻与认证闭环merchant-registration--authentication-loop)
|
||||
32. [功能模块化与权限控制闭环](#3️⃣2️⃣-功能模块化与权限控制闭环feature-modularization--permission-control-loop)
|
||||
33. [功能开通与支付闭环](#3️⃣3️⃣-功能开通与支付闭环feature-activation--payment-loop)
|
||||
34. [多商户结算与财务闭环](#3️⃣4️⃣-多商户结算与财务闭环multi-merchant-settlement--finance-loop)
|
||||
35. [多商户商品与订单管理闭环](#3️⃣5️⃣-多商户商品与订单管理闭环multi-merchant-product--order-management-loop)
|
||||
36. [统一闭环依赖](#🔹-统一闭环依赖toc--tob)
|
||||
37. [闭环依赖关系](#🔗-闭环依赖关系toc--tob)
|
||||
38. [关键绩效指标](#📊-关键绩效指标kpi)
|
||||
39. [追踪与审计](#🔍-追踪与审计)
|
||||
40. [业务审核状态机](#📋-业务审核状态机)
|
||||
41. [说明](#💡-说明)
|
||||
32. [商户店铺管理闭环](#3️⃣2️⃣-商户店铺管理闭环merchant-store-management-loop)
|
||||
33. [多商户订单闭环](#3️⃣3️⃣-多商户订单闭环multi-merchant-order-loop)
|
||||
34. [多商户库存同步闭环](#3️⃣4️⃣-多商户库存同步闭环multi-merchant-inventory-sync-loop)
|
||||
35. [多商户结算与财务闭环](#3️⃣5️⃣-多商户结算与财务闭环multi-merchant-settlement--finance-loop)
|
||||
36. [商户权限与角色闭环](#3️⃣6️⃣-商户权限与角色闭环merchant-roles--permissions-loop)
|
||||
37. [商户数据与分析闭环](#3️⃣7️⃣-商户数据与分析闭环merchant-analytics--reporting-loop)
|
||||
38. [异常处理闭环](#3️⃣8️⃣-异常处理闭环exception--dispute-loop)
|
||||
39. [功能模块化与权限控制闭环](#3️⃣9️⃣-功能模块化与权限控制闭环feature-modularization--permission-control-loop)
|
||||
40. [功能开通与支付闭环](#4️⃣0️⃣-功能开通与支付闭环feature-activation--payment-loop)
|
||||
41. [恶意买家黑名单闭环](#4️⃣1️⃣-恶意买家黑名单闭环malicious-buyer-blacklist-loop)
|
||||
42. [高退货率SKU自动下架/改进建议闭环](#4️⃣2️⃣-高退货率sku自动下架改进建议闭环high-return-rate-sku-auto-delist--improvement-loop)
|
||||
43. [商业化与增长闭环](#4️⃣3️⃣-商业化与增长闭环monetization--growth-loop)
|
||||
44. [服务编排与执行闭环](#4️⃣4️⃣-服务编排与执行闭环service-orchestration-loop)
|
||||
45. [增长飞轮闭环](#4️⃣5️⃣-增长飞轮闭环growth-flywheel-loop)
|
||||
41. [统一闭环依赖](#🔹-统一闭环依赖toc--tob)
|
||||
42. [闭环依赖关系](#🔗-闭环依赖关系toc--tob)
|
||||
43. [关键绩效指标](#📊-关键绩效指标kpi)
|
||||
44. [追踪与审计](#🔍-追踪与审计)
|
||||
45. [业务审核状态机](#📋-业务审核状态机)
|
||||
46. [说明](#💡-说明)
|
||||
|
||||
***
|
||||
|
||||
@@ -1039,6 +1049,26 @@
|
||||
| 超卖率 | 库存超卖的比例 | TOC + TOB |
|
||||
| 物流轨迹覆盖率 | 可追踪物流的订单比例 | TOC + TOB |
|
||||
|
||||
#### 恶意买家黑名单闭环
|
||||
|
||||
| KPI 指标 | 描述 | 适用业务类型 |
|
||||
| ------- | ----------- | --------- |
|
||||
| 黑名单识别准确率 | 正确识别恶意买家的比例 | TOC + TOB |
|
||||
| 风险评估准确率 | 风险等级评估的准确性 | TOC + TOB |
|
||||
| 黑名单共享有效率 | 共享黑名单的有效利用比例 | TOC + TOB |
|
||||
| 风险预警及时率 | 及时发出风险预警的比例 | TOC + TOB |
|
||||
| 误报率 | 误判为恶意买家的比例 | TOC + TOB |
|
||||
|
||||
#### 高退货率SKU自动下架/改进建议闭环
|
||||
|
||||
| KPI 指标 | 描述 | 适用业务类型 |
|
||||
| ------- | ----------- | --------- |
|
||||
| 退货率监控准确率 | 退货率计算的准确性 | TOC + TOB |
|
||||
| 自动下架准确率 | 正确下架高风险SKU的比例 | TOC + TOB |
|
||||
| 改进建议有效性 | 改进建议被采纳并实施的比例 | TOC + TOB |
|
||||
| 重新上架成功率 | 改进后重新上架的成功比例 | TOC + TOB |
|
||||
| 退货率改善率 | 改进后退货率下降的比例 | TOC + TOB |
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣1️⃣ 多商户入驻与认证闭环(Merchant Registration & Authentication Loop)
|
||||
@@ -1049,24 +1079,200 @@
|
||||
- 商户自助注册(邮箱/手机/企业信息)
|
||||
- 资质文件上传(营业执照、法人身份证等)
|
||||
- 账户类型选择(企业/个人)
|
||||
- 初始密码设置和安全验证
|
||||
2. **资质认证**:
|
||||
- 自动审核 + 人工复核
|
||||
- 企业信息验证、信用检查
|
||||
- 行业资质合规检查
|
||||
- 审核进度实时更新
|
||||
3. **店铺创建**:
|
||||
- 店铺基础信息配置
|
||||
- 店铺基础信息配置(名称、LOGO、描述)
|
||||
- 绑定平台店铺(Amazon、Shopee等)
|
||||
- 支付账户配置
|
||||
- 支付账户配置(收款方式、结算周期)
|
||||
- 店铺运营设置(退换货政策、客服信息)
|
||||
4. **权限分配**:
|
||||
- 初始角色设置(管理员、运营、财务)
|
||||
- 权限范围配置(可访问模块、操作权限)
|
||||
- 数据隔离设置(商户级数据隔离)
|
||||
- **决策点**:
|
||||
- 资质审核标准(行业合规、信用评级)
|
||||
- 商户等级划分(普通/优质/战略)
|
||||
- 入驻门槛设置
|
||||
- 入驻门槛设置(不同等级商户的要求)
|
||||
- 审核通过/拒绝的条件和流程
|
||||
- **输入**:商户注册信息、资质文件、企业证明
|
||||
- **输出**:商户ID、认证状态、店铺ID
|
||||
- **输出**:商户ID、认证状态、店铺ID、权限配置
|
||||
- **状态机**:`SUBMITTED` → `PENDING_REVIEW` → `APPROVED`/`REJECTED` → `ACTIVE`
|
||||
- **📋 技术实现指引**:
|
||||
| 层级 | 实现模块 | 关键文件 | 任务ID |
|
||||
| -- | ------- | -------- | ------ |
|
||||
| 后端 | 商户管理 | `MerchantService.ts` | BE-M001 |
|
||||
| 后端 | 资质验证 | `VerificationService.ts` | BE-M002 |
|
||||
| 后端 | 权限管理 | `RBACService.ts` | BE-M003 |
|
||||
| 前端 | 注册页面 | `MerchantRegistration.vue` | FE-M001 |
|
||||
| 前端 | 状态查询 | `MerchantStatus.vue` | FE-M002 |
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣2️⃣ 功能模块化与权限控制闭环(Feature Modularization & Permission Control Loop)
|
||||
## 3️⃣2️⃣ 商户店铺管理闭环(Merchant Store Management Loop)
|
||||
|
||||
- **目标**:支持商户管理自己的商品、库存、促销活动。
|
||||
- **流程**:
|
||||
1. 商户创建店铺或子店铺。
|
||||
2. 前端提供商品管理界面(新增、编辑、上下架)。
|
||||
3. 后端管理库存、价格、SKU、分类。
|
||||
4. 支持商户自定义促销规则(折扣、满减、优惠券)。
|
||||
- **决策点**:
|
||||
- 库存不足 → 阻止下架或自动提醒。
|
||||
- 促销策略冲突 → 系统自动合并或提示调整。
|
||||
- **输入**:商户店铺信息、商品信息
|
||||
- **输出**:管理的店铺和商品数据
|
||||
- **状态机**:`CREATED` → `CONFIGURING` → `ACTIVE` → `INACTIVE`
|
||||
- **📋 技术实现指引**:
|
||||
| 层级 | 实现模块 | 关键文件 | 任务ID |
|
||||
| -- | ------- | -------- | ------ |
|
||||
| 后端 | 店铺管理 | `StoreService.ts` | BE-S001 |
|
||||
| 后端 | 商品管理 | `ProductService.ts` | BE-P001 |
|
||||
| 后端 | 库存管理 | `InventoryService.ts` | BE-I001 |
|
||||
| 前端 | 店铺管理页面 | `StoreManagement.vue` | FE-S001 |
|
||||
| 前端 | 商品管理页面 | `ProductManagement.vue` | FE-P001 |
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣3️⃣ 多商户订单闭环(Multi-Merchant Order Loop)
|
||||
|
||||
- **目标**:支持多个商户订单独立处理,同时平台统一监控。
|
||||
- **流程**:
|
||||
1. 客户下单 → 系统拆分订单至各商户。
|
||||
2. 前端商户端显示新订单 → 可确认、拒单、修改发货信息。
|
||||
3. 后端记录订单状态(待处理、已发货、完成、异常)。
|
||||
4. 平台监控整体订单履约情况。
|
||||
- **决策点**:
|
||||
- 商户拒单 → 系统可触发退款或自动分配给其他商户。
|
||||
- 超时未处理 → 系统提醒或自动处理。
|
||||
- **输入**:客户订单数据
|
||||
- **输出**:拆分后的商户子订单,包含状态更新
|
||||
- **状态机**:`PENDING` → `ACCEPTED` → `SHIPPED` → `COMPLETED` → `REFUNDED`
|
||||
- **📋 技术实现指引**:
|
||||
| 层级 | 实现模块 | 关键文件 | 任务ID |
|
||||
| -- | ------- | -------- | ------ |
|
||||
| 后端 | 订单管理 | `OrderService.ts` | BE-O001 |
|
||||
| 后端 | 订单拆分 | `OrderSplitService.ts` | BE-O002 |
|
||||
| 前端 | 商户订单页面 | `MerchantOrderPage.vue` | FE-O001 |
|
||||
| 前端 | 平台订单监控 | `OrderMonitoringPage.vue` | FE-O002 |
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣4️⃣ 多商户库存同步闭环(Multi-Merchant Inventory Sync Loop)
|
||||
|
||||
- **目标**:确保平台和商户端库存实时同步。
|
||||
- **流程**:
|
||||
1. 商户上传库存信息(API/手动)。
|
||||
2. 平台统一汇总并分发给前端展示。
|
||||
3. 当客户下单 → 自动扣减对应商户库存。
|
||||
- **决策点**:
|
||||
- 库存不足 → 阻止下单或显示缺货。
|
||||
- 库存异常 → 系统报警。
|
||||
- **输入**:商户库存数据、订单数据
|
||||
- **输出**:实时同步的库存状态
|
||||
- **状态机**:`SYNCED` → `UPDATING` → `SYNCED` → `ERROR`
|
||||
- **📋 技术实现指引**:
|
||||
| 层级 | 实现模块 | 关键文件 | 任务ID |
|
||||
| -- | ------- | -------- | ------ |
|
||||
| 后端 | 库存管理 | `InventoryService.ts` | BE-I001 |
|
||||
| 后端 | 库存同步 | `InventorySyncService.ts` | BE-I002 |
|
||||
| 前端 | 库存管理页面 | `InventoryManagement.vue` | FE-I001 |
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣5️⃣ 多商户结算与财务闭环(Multi-Merchant Settlement & Finance Loop)
|
||||
|
||||
- **目标**:自动计算商户收入、平台佣金、手续费及结算周期。
|
||||
- **流程**:
|
||||
1. 后端计算订单收入、退款、佣金分成。
|
||||
2. 系统生成结算账单 → 商户可查询。
|
||||
3. 支持多结算方式(银行、电子钱包)。
|
||||
4. 自动发起付款(周期结算或即时结算)。
|
||||
- **决策点**:
|
||||
- 异常订单 → 暂停结算并标记。
|
||||
- 多币种结算 → 汇率实时更新。
|
||||
- **输入**:订单数据、支付数据
|
||||
- **输出**:结算账单、付款记录
|
||||
- **状态机**:`PENDING` → `CALCULATED` → `APPROVED` → `PAID`
|
||||
- **📋 技术实现指引**:
|
||||
| 层级 | 实现模块 | 关键文件 | 任务ID |
|
||||
| -- | ------- | -------- | ------ |
|
||||
| 后端 | 结算服务 | `SettlementService.ts` | BE-S002 |
|
||||
| 后端 | 财务管理 | `FinanceService.ts` | BE-F001 |
|
||||
| 前端 | 结算管理页面 | `SettlementManagement.vue` | FE-S002 |
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣6️⃣ 商户权限与角色闭环(Merchant Roles & Permissions Loop)
|
||||
|
||||
- **目标**:控制商户内部操作权限,支持多角色管理。
|
||||
- **流程**:
|
||||
1. 商户创建角色(管理员、仓库、客服等)。
|
||||
2. 后端配置每个角色的访问权限。
|
||||
3. 前端动态显示可操作模块。
|
||||
- **决策点**:
|
||||
- 权限冲突 → 系统提示。
|
||||
- 异常操作 → 记录日志和告警。
|
||||
- **输入**:商户角色配置
|
||||
- **输出**:权限配置,访问控制
|
||||
- **📋 技术实现指引**:
|
||||
| 层级 | 实现模块 | 关键文件 | 任务ID |
|
||||
| -- | ------- | -------- | ------ |
|
||||
| 后端 | 权限服务 | `RBACService.ts` | BE-R001 |
|
||||
| 前端 | 权限管理页面 | `PermissionManagement.vue` | FE-R001 |
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣7️⃣ 商户数据与分析闭环(Merchant Analytics & Reporting Loop)
|
||||
|
||||
- **目标**:提供独立商户数据分析,同时平台可汇总整体业务指标。
|
||||
- **流程**:
|
||||
1. 后端收集订单、流量、库存、评价数据。
|
||||
2. 生成商户专属数据报表和趋势分析。
|
||||
3. 平台可生成多商户对比分析。
|
||||
- **决策点**:
|
||||
- 数据异常 → 自动报警。
|
||||
- 需要合规报表 → 自动生成符合财务/税务规范的报表。
|
||||
- **输入**:商户业务数据
|
||||
- **输出**:商户报表、平台分析报告
|
||||
- **状态机**:`RAW` → `PROCESSED` → `GENERATED` → `DISTRIBUTED`
|
||||
- **📋 技术实现指引**:
|
||||
| 层级 | 实现模块 | 关键文件 | 任务ID |
|
||||
| -- | ------- | -------- | ------ |
|
||||
| 后端 | 报表服务 | `ReportService.ts` | BE-R002 |
|
||||
| 后端 | 数据分析 | `AnalyticsService.ts` | BE-A002 |
|
||||
| 前端 | 商户报表页面 | `MerchantReportPage.vue` | FE-R002 |
|
||||
| 前端 | 平台分析页面 | `PlatformAnalyticsPage.vue` | FE-A001 |
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣8️⃣ 异常处理闭环(Exception & Dispute Loop)
|
||||
|
||||
- **目标**:处理商户异常、客户投诉、退款退货。
|
||||
- **流程**:
|
||||
1. 客户发起投诉/退货 → 系统分配给对应商户。
|
||||
2. 商户处理 → 平台监控处理时效。
|
||||
3. 处理结果同步前端和财务结算。
|
||||
- **决策点**:
|
||||
- 超时未处理 → 系统自动介入。
|
||||
- 争议订单 → 暂停结算,人工复核。
|
||||
- **输入**:投诉/退货请求
|
||||
- **输出**:处理结果,财务调整
|
||||
- **状态机**:`SUBMITTED` → `PROCESSING` → `RESOLVED` → `ESCALATED`
|
||||
- **📋 技术实现指引**:
|
||||
| 层级 | 实现模块 | 关键文件 | 任务ID |
|
||||
| -- | ------- | -------- | ------ |
|
||||
| 后端 | 异常处理 | `ExceptionService.ts` | BE-E001 |
|
||||
| 后端 | 争议解决 | `DisputeResolverService.ts` | BE-D001 |
|
||||
| 前端 | 异常管理页面 | `ExceptionManagement.vue` | FE-E001 |
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣9️⃣ 功能模块化与权限控制闭环(Feature Modularization & Permission Control Loop)
|
||||
|
||||
- **目标**:将系统功能模块化,支持按商户收费,精细化权限控制。
|
||||
- **流程**:
|
||||
@@ -1122,30 +1328,49 @@
|
||||
|
||||
## 3️⃣4️⃣ 多商户结算与财务闭环(Multi-Merchant Settlement & Finance Loop)
|
||||
|
||||
- **目标**:多商户资金结算、收益分润、账务核对。
|
||||
- **目标**:多商户资金结算、收益分润、账务核对,确保资金安全和透明。
|
||||
- **流程**:
|
||||
1. **交易清算**:
|
||||
- 订单收入汇总
|
||||
- 平台服务费扣除
|
||||
- 商户应得收益计算
|
||||
- 订单收入汇总(按商户维度)
|
||||
- 平台服务费扣除(根据合同约定)
|
||||
- 商户应得收益计算(扣除各项费用后)
|
||||
- 税费计算与代扣
|
||||
2. **结算周期**:
|
||||
- 按日/周/月结算
|
||||
- 按日/周/月结算(商户可选择)
|
||||
- 自动打款或申请提现
|
||||
- 结算单生成
|
||||
- 结算单生成(包含明细和汇总)
|
||||
- 结算状态跟踪
|
||||
3. **分润管理**:
|
||||
- 分润规则配置
|
||||
- 分润规则配置(百分比、固定金额等)
|
||||
- 多级分销/代理分润
|
||||
- 分润计算与发放
|
||||
- 分润报表生成
|
||||
4. **财务对账**:
|
||||
- 商户账户流水核对
|
||||
- 异常交易处理
|
||||
- 财务报表生成
|
||||
- 异常交易处理(退款、纠纷等)
|
||||
- 财务报表生成(商户级、平台级)
|
||||
- 税务报表准备
|
||||
5. **资金安全**:
|
||||
- 资金流向监控
|
||||
- 异常资金预警
|
||||
- 资金冻结与解冻
|
||||
- **决策点**:
|
||||
- 结算门槛(最低提现金额)
|
||||
- 手续费规则
|
||||
- 账期调整
|
||||
- **输入**:交易数据、商户结算规则、分润配置
|
||||
- **输出**:结算单、账户余额、财务报表
|
||||
- 手续费规则(提现、转账等)
|
||||
- 账期调整(根据商户等级)
|
||||
- 分润比例设置
|
||||
- 异常交易处理流程
|
||||
- **输入**:交易数据、商户结算规则、分润配置、银行账户信息
|
||||
- **输出**:结算单、账户余额、财务报表、分润记录
|
||||
- **状态机**:`PENDING` → `PROCESSING` → `COMPLETED` → `FAILED`
|
||||
- **📋 技术实现指引**:
|
||||
| 层级 | 实现模块 | 关键文件 | 任务ID |
|
||||
| -- | ------- | -------- | ------ |
|
||||
| 后端 | 结算服务 | `MerchantSettlementService.ts` | BE-F001 |
|
||||
| 后端 | 财务管理 | `FinanceService.ts` | BE-F002 |
|
||||
| 后端 | 分润管理 | `ProfitSharingService.ts` | BE-F003 |
|
||||
| 前端 | 结算管理 | `SettlementManagement.vue` | FE-F001 |
|
||||
| 前端 | 财务报表 | `FinanceReport.vue` | FE-F002 |
|
||||
|
||||
***
|
||||
|
||||
@@ -1178,6 +1403,188 @@
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣6️⃣ 恶意买家黑名单闭环(Malicious Buyer Blacklist Loop)
|
||||
|
||||
- **目标**:识别、管理和共享恶意买家信息,降低交易风险。
|
||||
- **流程**:
|
||||
1. **黑名单管理**
|
||||
- 手动添加恶意买家(欺诈、拒付、滥用等)
|
||||
- 自动识别高风险买家(基于行为模式)
|
||||
- 黑名单等级划分(低/中/高风险)
|
||||
2. **风险评估**
|
||||
- 基于买家行为的综合风险评分
|
||||
- 多维度风险因素分析(退货率、投诉率、拒付率等)
|
||||
- 实时风险预警
|
||||
3. **黑名单共享**
|
||||
- 跨租户黑名单共享机制
|
||||
- 共享规则配置(自动接受/人工审核)
|
||||
- 共享状态同步
|
||||
- **决策点**:
|
||||
- 黑名单阈值设定
|
||||
- 共享范围控制
|
||||
- 风险等级判定标准
|
||||
- **输入**:买家信息、交易记录、行为数据
|
||||
- **输出**:黑名单记录、风险评分、共享结果
|
||||
- **状态机**:`SUGGESTED` → `PENDING_REVIEW` → `ACTIVE` / `REJECTED` → `EXPIRED`
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣7️⃣ 高退货率SKU自动下架/改进建议闭环(High Return Rate SKU Auto-Delist & Improvement Loop)
|
||||
|
||||
- **目标**:监控高退货率SKU,自动下架风险商品并提供改进建议。
|
||||
- **流程**:
|
||||
1. **退货率监控**
|
||||
- 实时计算SKU退货率
|
||||
- 多维度分析(按平台/店铺/类目)
|
||||
- 趋势监控和预警
|
||||
2. **自动下架**
|
||||
- 阈值触发自动下架
|
||||
- 多平台下架支持(Amazon/Shopee/Lazada/TikTok)
|
||||
- 自动重新上架功能
|
||||
3. **改进建议**
|
||||
- 基于退货原因的智能分析
|
||||
- 分类建议生成(质量/描述/图片/包装/物流等)
|
||||
- 实施步骤指导和ROI预估
|
||||
- **决策点**:
|
||||
- 退货率阈值设定
|
||||
- 自动下架规则配置
|
||||
- 改进优先级排序
|
||||
- **输入**:订单数据、退货记录、SKU信息
|
||||
- **输出**:高风险SKU列表、下架结果、改进建议
|
||||
- **状态机**:`MONITORED` → `HIGH_RISK` → `AUTO_DELISTED` → `IMPROVEMENT_SUGGESTED` → `RE_LISTED`
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣8️⃣ 商业化与增长闭环(Monetization & Growth Loop)
|
||||
|
||||
- **目标**:实现系统持续盈利与收入增长(非SaaS模式)
|
||||
|
||||
### 收费模型
|
||||
|
||||
#### 1. 功能收费(Feature-based)
|
||||
- 高级分析
|
||||
- 自动化能力
|
||||
- API调用
|
||||
|
||||
#### 2. 交易抽成(Transaction-based)
|
||||
- TOC:订单抽佣(3~10%)
|
||||
- TOB:大单服务费
|
||||
|
||||
#### 3. 服务收费(Service-based)
|
||||
- 代发货
|
||||
- 仓储服务
|
||||
- 数据服务
|
||||
|
||||
#### 4. 资金沉淀(Deposit Float)
|
||||
- 押金沉淀收益
|
||||
- 账期资金
|
||||
|
||||
### 收费触发点
|
||||
|
||||
- 功能调用
|
||||
- 订单完成
|
||||
- 商家使用服务
|
||||
- API请求
|
||||
|
||||
### 收入放大机制
|
||||
|
||||
- ROI分析 → 推荐开功能
|
||||
- 利润分析 → 推荐加广告
|
||||
- 订单增长 → 引导升级套餐
|
||||
|
||||
### 决策点
|
||||
|
||||
- 免费 vs 付费边界
|
||||
- 抽成比例
|
||||
- 功能定价策略
|
||||
|
||||
### 输入
|
||||
|
||||
- 用户行为
|
||||
- 订单数据
|
||||
- 利润数据
|
||||
|
||||
### 输出
|
||||
|
||||
- 收入增长
|
||||
- 用户付费转化
|
||||
|
||||
***
|
||||
|
||||
## 3️⃣9️⃣ 服务编排与执行闭环(Service Orchestration Loop)
|
||||
|
||||
- **目标**:将业务闭环转化为可执行的后端服务流
|
||||
|
||||
### 核心原则
|
||||
|
||||
- 每个业务闭环必须对应一个 Service Flow
|
||||
- 所有逻辑必须走 Service 层
|
||||
|
||||
### 执行流程
|
||||
|
||||
Frontend
|
||||
→ Controller
|
||||
→ Service(核心编排)
|
||||
→ Repository / External API
|
||||
→ 返回结果
|
||||
|
||||
### 示例
|
||||
|
||||
#### 功能开通
|
||||
|
||||
Controller
|
||||
→ FeatureService.openFeature
|
||||
→ PaymentService.create
|
||||
→ PaymentCallback
|
||||
→ PermissionService.grant
|
||||
|
||||
### 决策点
|
||||
|
||||
- 服务拆分粒度
|
||||
- 是否异步(消息队列)
|
||||
- 是否需要补偿机制
|
||||
|
||||
### 输出
|
||||
|
||||
- 可执行后端服务
|
||||
- 业务状态流转
|
||||
|
||||
***
|
||||
|
||||
## 4️⃣0️⃣ 增长飞轮闭环(Growth Flywheel Loop)
|
||||
|
||||
- **目标**:让系统自动变强、自动赚钱
|
||||
|
||||
### 飞轮逻辑
|
||||
|
||||
数据 → 利润分析 → 推荐 → 用户行动 → 收入 → 更多数据
|
||||
|
||||
### 核心路径
|
||||
|
||||
1. 商品数据 → 利润分析
|
||||
2. 利润高 → 推广广告
|
||||
3. 广告带订单
|
||||
4. 订单产生数据
|
||||
5. 数据优化策略
|
||||
|
||||
### TOB路径
|
||||
|
||||
询盘 → 报价 → 成交 → 复购 → 信用提升 → 更大订单
|
||||
|
||||
### 决策点
|
||||
|
||||
- 推荐策略
|
||||
- 自动化程度
|
||||
- AI参与程度
|
||||
|
||||
### 输出
|
||||
|
||||
- GMV增长
|
||||
- ROI提升
|
||||
- 用户粘性
|
||||
|
||||
***
|
||||
|
||||
### 🔍 追踪与审计
|
||||
|
||||
- **追踪五元组**:
|
||||
|
||||
@@ -78,7 +78,7 @@
|
||||
| PKG-COM-FE | FE-COM001, FE-COM002, FE-COM003 | 合规与证书管理闭环 | CertificateManage.tsx, ComplianceCheck.tsx | 24h | ✅ 已完成 |
|
||||
| PKG-LOG-FE | FE-LOG001, FE-LOG002, FE-LOG003 | 物流策略闭环 | LogisticsSelect.tsx, LogisticsTrack.tsx, FreightCalc.tsx | 20h | ✅ 已完成 |
|
||||
| PKG-LOG-BE | BE-LOG001, BE-LOG002, BE-LOG003 | 物流策略与渠道选择闭环 | LogisticsService.ts, trade.ts | 36h | ✅ 已完成 |
|
||||
| PKG-UA-FE | FE-UA001, FE-UA002, FE-UA003 | 用户资产闭环 | UserAssets.tsx, PointsManage.tsx, MemberLevel.tsx | 20h | 🔒 进行中 |
|
||||
| PKG-UA-FE | FE-UA001, FE-UA002, FE-UA003 | 用户资产闭环 | UserAssets.tsx, PointsManage.tsx, MemberLevel.tsx | 20h | ✅ 已完成 |
|
||||
| PKG-MV-BE | BE-MV001\~BE-MV008 | 多商户闭环 | MerchantService.ts, FeatureModuleService.ts | 78h | ✅ 已完成 |
|
||||
|
||||
### 📦 任务包领取模板
|
||||
@@ -238,13 +238,13 @@
|
||||
|
||||
| 模块 | 总任务数 | 已完成 | 进行中 | 待处理 | 失败 | 完成率 |
|
||||
| ------ | ------- | ------ | --- | ------ | -- | ------- |
|
||||
| 前端模块 | 30 | 15 | 0 | 15 | 0 | 50% |
|
||||
| 前端模块 | 30 | 18 | 0 | 12 | 0 | 60% |
|
||||
| 后端模块 | 53 | 51 | 0 | 2 | 0 | 96% |
|
||||
| 插件模块 | 14 | 12 | 0 | 2 | 0 | 86% |
|
||||
| AI模块 | 17 | 13 | 0 | 4 | 0 | 76% |
|
||||
| 数据模块 | 10 | 6 | 0 | 4 | 0 | 60% |
|
||||
| 运维模块 | 19 | 8 | 0 | 11 | 0 | 42% |
|
||||
| **总计** | **143** | **105** | 0 | **38** | 0 | **73%** |
|
||||
| **总计** | **143** | **108** | 0 | **35** | 0 | **76%** |
|
||||
|
||||
***
|
||||
|
||||
@@ -284,6 +284,46 @@
|
||||
| FE-SR002 | 售后逆向闭环 | 退款处理界面 | 退款ID, 处理结果 | 退款记录 | 点击处理 | ✅ completed | P0 | FE-SR001 | 8h | AI-Frontend-5 |
|
||||
| FE-SR003 | 售后逆向闭环 | 售后客服界面 | 工单ID, 客服消息 | 客服记录 | 点击查看 | ✅ completed | P0 | FE-SR001 | 12h | AI-Frontend-5 |
|
||||
|
||||
### 1.11 素材管理前端【P1 高优先级】
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
| -------- | ------ | ------ | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------- |
|
||||
| FE-MA001 | 素材管理闭环 | 素材管理页面 | 素材ID, 筛选条件 | 素材列表 | 页面加载 | ✅ completed | P1 | - | 8h | AI-Frontend-1 |
|
||||
| FE-MA002 | 素材管理闭环 | 素材上传界面 | 文件对象 | 素材URL | 选择文件 | ✅ completed | P1 | FE-MA001 | 6h | AI-Frontend-1 |
|
||||
| FE-MA003 | 素材管理闭环 | 素材审核界面 | 素材ID, 审核结果 | 审核状态 | 点击审核 | ✅ completed | P1 | FE-MA001 | 6h | AI-Frontend-1 |
|
||||
|
||||
### 1.12 资金对账前端【P1 高优先级】
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
| -------- | ------ | ------ | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------- |
|
||||
| FE-FR001 | 资金对账闭环 | 对账管理页面 | 时间范围, 平台ID | 对账列表 | 页面加载 | ✅ completed | P1 | - | 8h | AI-Frontend-2 |
|
||||
| FE-FR002 | 资金对账闭环 | 对账详情界面 | 对账ID | 对账详情 | 点击查看 | ✅ completed | P1 | FE-FR001 | 6h | AI-Frontend-2 |
|
||||
| FE-FR003 | 资金对账闭环 | 异常处理界面 | 对账ID, 处理结果 | 处理状态 | 点击处理 | ✅ completed | P1 | FE-FR001 | 6h | AI-Frontend-2 |
|
||||
|
||||
### 1.13 报表与分析前端【P1 高优先级】
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
| -------- | ------ | ------ | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------- |
|
||||
| FE-RA001 | 报表与分析闭环 | 报表管理页面 | 报表类型, 筛选条件 | 报表列表 | 页面加载 | ✅ completed | P1 | - | 8h | AI-Frontend-3 |
|
||||
| FE-RA002 | 报表与分析闭环 | 报表生成界面 | 报表参数 | 报表数据 | 点击生成 | ✅ completed | P1 | FE-RA001 | 6h | AI-Frontend-3 |
|
||||
| FE-RA003 | 报表与分析闭环 | 数据大屏界面 | widgets | 实时数据 | 页面加载 | ✅ completed | P1 | FE-RA001 | 6h | AI-Frontend-3 |
|
||||
|
||||
### 1.14 功能模块化与权限控制前端【P2 中优先级】
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
| -------- | ------ | ------ | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------- |
|
||||
| FE-PM001 | 功能模块化与权限控制闭环 | 角色管理页面 | 角色ID, 筛选条件 | 角色列表 | 页面加载 | ✅ completed | P2 | - | 6h | AI-Frontend-4 |
|
||||
| FE-PM002 | 功能模块化与权限控制闭环 | 权限管理界面 | 权限ID, 角色ID | 权限分配 | 点击分配 | ✅ completed | P2 | FE-PM001 | 6h | AI-Frontend-4 |
|
||||
| FE-PM003 | 功能模块化与权限控制闭环 | 用户角色分配界面 | 用户ID, 角色ID | 分配结果 | 点击分配 | ✅ completed | P2 | FE-PM001 | 4h | AI-Frontend-4 |
|
||||
|
||||
### 1.15 功能开通与支付前端【P2 中优先级】
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
| -------- | ------ | ------ | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------- |
|
||||
| FE-FA001 | 功能开通与支付闭环 | 功能列表页面 | 功能ID, 筛选条件 | 功能列表 | 页面加载 | ✅ completed | P2 | - | 6h | AI-Frontend-5 |
|
||||
| FE-FA002 | 功能开通与支付闭环 | 功能激活界面 | 功能ID, 支付信息 | 激活结果 | 点击激活 | ✅ completed | P2 | FE-FA001 | 6h | AI-Frontend-5 |
|
||||
| FE-FA003 | 功能开通与支付闭环 | 支付管理界面 | 支付ID, 状态 | 支付记录 | 点击查看 | ✅ completed | P2 | FE-FA001 | 4h | AI-Frontend-5 |
|
||||
|
||||
### 1.5 B2B / TOB 贸易前端【P0 阻塞核心业务】
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
@@ -433,6 +473,46 @@ private static async syncShopeeOrders(config, options): Promise<OrderSyncResult[
|
||||
| BE-AD002 | 广告计划与营销闭环 | 广告投放引擎 | 广告ID, 投放参数 | 投放状态 | 定时任务 | ✅ completed | P0 | BE-AD001 | 16h | AI-Backend-4 |
|
||||
| BE-AD003 | 广告计划与营销闭环 | ROI计算接口 | 广告ID, 时间范围 | ROI数据 | 定时任务 | ✅ completed | P0 | BE-AD001 | 10h | AI-Backend-4 |
|
||||
|
||||
### 2.8 素材管理后端【P1 高优先级】
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
| -------- | ------ | ------ | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------ |
|
||||
| BE-MA001 | 素材管理闭环 | 素材创建接口 | 素材信息 | 素材ID | 前端提交 | ✅ completed | P1 | - | 4h | AI-Backend-6 |
|
||||
| BE-MA002 | 素材管理闭环 | 素材更新接口 | 素材ID, 素材信息 | 更新结果 | 前端提交 | ✅ completed | P1 | BE-MA001 | 3h | AI-Backend-6 |
|
||||
| BE-MA003 | 素材管理闭环 | 素材审核接口 | 素材ID, 审核结果 | 审核状态 | 前端提交 | ✅ completed | P1 | BE-MA001 | 3h | AI-Backend-6 |
|
||||
|
||||
### 2.9 资金对账后端【P1 高优先级】
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
| -------- | ------ | ------ | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------ |
|
||||
| BE-FR001 | 资金对账闭环 | 对账创建接口 | 对账信息 | 对账ID | 定时任务 | ✅ completed | P1 | - | 4h | AI-Backend-7 |
|
||||
| BE-FR002 | 资金对账闭环 | 对账处理接口 | 对账ID, 处理结果 | 处理状态 | 前端提交 | ✅ completed | P1 | BE-FR001 | 3h | AI-Backend-7 |
|
||||
| BE-FR003 | 资金对账闭环 | 对账查询接口 | 对账ID | 对账详情 | 前端查询 | ✅ completed | P1 | BE-FR001 | 3h | AI-Backend-7 |
|
||||
|
||||
### 2.10 报表与分析后端【P1 高优先级】
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
| -------- | ------ | ------ | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------ |
|
||||
| BE-RA001 | 报表与分析闭环 | 报表创建接口 | 报表参数 | 报表ID | 前端提交 | ✅ completed | P1 | - | 4h | AI-Backend-8 |
|
||||
| BE-RA002 | 报表与分析闭环 | 报表数据生成接口 | 报表ID | 报表数据 | 定时任务 | ✅ completed | P1 | BE-RA001 | 6h | AI-Backend-8 |
|
||||
| BE-RA003 | 报表与分析闭环 | 数据大屏生成接口 | widgets | 大屏数据 | 前端请求 | ✅ completed | P1 | BE-RA001 | 4h | AI-Backend-8 |
|
||||
|
||||
### 2.11 功能模块化与权限控制后端【P2 中优先级】
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
| -------- | ------ | ------ | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------ |
|
||||
| BE-PM001 | 功能模块化与权限控制闭环 | 角色管理接口 | 角色信息 | 角色ID | 前端提交 | ✅ completed | P2 | - | 4h | AI-Backend-9 |
|
||||
| BE-PM002 | 功能模块化与权限控制闭环 | 权限管理接口 | 权限信息 | 权限ID | 前端提交 | ✅ completed | P2 | - | 4h | AI-Backend-9 |
|
||||
| BE-PM003 | 功能模块化与权限控制闭环 | 权限检查接口 | 用户ID, 资源, 操作 | 检查结果 | 前端请求 | ✅ completed | P2 | BE-PM001 | 3h | AI-Backend-9 |
|
||||
|
||||
### 2.12 功能开通与支付后端【P2 中优先级】
|
||||
|
||||
| Task ID | 闭环关联 | 任务描述 | 输入 | 输出 | 触发条件 | 状态 | 优先级 | 依赖 | 预计耗时 | 负责人 |
|
||||
| -------- | ------ | ------ | ---------- | ---- | ---- | ----------- | --- | -------- | ---- | ------------ |
|
||||
| BE-FA001 | 功能开通与支付闭环 | 功能激活接口 | 功能ID, 支付信息 | 激活ID | 前端提交 | ✅ completed | P2 | - | 4h | AI-Backend-10 |
|
||||
| BE-FA002 | 功能开通与支付闭环 | 支付处理接口 | 支付ID | 支付状态 | 支付回调 | ✅ completed | P2 | BE-FA001 | 4h | AI-Backend-10 |
|
||||
| BE-FA003 | 功能开通与支付闭环 | 功能续费接口 | 激活ID | 续费结果 | 前端提交 | ✅ completed | P2 | BE-FA001 | 3h | AI-Backend-10 |
|
||||
|
||||
<details>
|
||||
<summary>📋 BE-AD001/BE-AD002/BE-AD003 任务详情卡片</summary>
|
||||
|
||||
|
||||
271
docs/00_Business/Upper_Level_ClosedLoops.md
Normal file
271
docs/00_Business/Upper_Level_ClosedLoops.md
Normal file
@@ -0,0 +1,271 @@
|
||||
# 上层闭环设计
|
||||
|
||||
## ❗ 真正缺的不是业务闭环,而是这 3 个“上层闭环”
|
||||
|
||||
你虽然有:
|
||||
|
||||
- ✔ 37个业务闭环(生产系统)
|
||||
- ✔ TOC + TOB 全链路
|
||||
- ✔ 多商户 + 非SaaS架构
|
||||
|
||||
但还缺:
|
||||
|
||||
---
|
||||
|
||||
## 🔴 ① 商业化闭环(Monetization Loop)
|
||||
|
||||
你现在只有:
|
||||
|
||||
- 👉 功能开通与支付(第33个闭环)
|
||||
|
||||
但缺的是:
|
||||
|
||||
- 👉 **“如何持续赚钱 + 放大收入”**
|
||||
|
||||
---
|
||||
|
||||
### 🧩 38️⃣ 商业化与增长闭环(Monetization & Growth Loop)
|
||||
|
||||
- **目标**:实现系统持续盈利与收入增长(非SaaS模式)
|
||||
|
||||
---
|
||||
|
||||
#### 收费模型
|
||||
|
||||
##### 1. 功能收费(Feature-based)
|
||||
- 高级分析
|
||||
- 自动化能力
|
||||
- API调用
|
||||
|
||||
##### 2. 交易抽成(Transaction-based)
|
||||
- TOC:订单抽佣(3~10%)
|
||||
- TOB:大单服务费
|
||||
|
||||
##### 3. 服务收费(Service-based)
|
||||
- 代发货
|
||||
- 仓储服务
|
||||
- 数据服务
|
||||
|
||||
##### 4. 资金沉淀(Deposit Float)
|
||||
- 押金沉淀收益
|
||||
- 账期资金
|
||||
|
||||
---
|
||||
|
||||
#### 收费触发点
|
||||
|
||||
- 功能调用
|
||||
- 订单完成
|
||||
- 商家使用服务
|
||||
- API请求
|
||||
|
||||
---
|
||||
|
||||
#### 收入放大机制
|
||||
|
||||
- ROI分析 → 推荐开功能
|
||||
- 利润分析 → 推荐加广告
|
||||
- 订单增长 → 引导升级套餐
|
||||
|
||||
---
|
||||
|
||||
#### 决策点
|
||||
|
||||
- 免费 vs 付费边界
|
||||
- 抽成比例
|
||||
- 功能定价策略
|
||||
|
||||
---
|
||||
|
||||
#### 输入
|
||||
|
||||
- 用户行为
|
||||
- 订单数据
|
||||
- 利润数据
|
||||
|
||||
---
|
||||
|
||||
#### 输出
|
||||
|
||||
- 收入增长
|
||||
- 用户付费转化
|
||||
|
||||
---
|
||||
|
||||
## 🔴 ② 服务编排闭环(Service Orchestration Loop)
|
||||
|
||||
你现在缺的是:
|
||||
|
||||
- 👉 **“业务闭环 → Service Flow” 的映射层**
|
||||
|
||||
---
|
||||
|
||||
### 🧩 39️⃣ 服务编排与执行闭环(Service Orchestration Loop)
|
||||
|
||||
- **目标**:将业务闭环转化为可执行的后端服务流
|
||||
|
||||
---
|
||||
|
||||
#### 核心原则
|
||||
|
||||
- 每个业务闭环必须对应一个 Service Flow
|
||||
- 所有逻辑必须走 Service 层
|
||||
|
||||
---
|
||||
|
||||
#### 执行流程
|
||||
|
||||
Frontend
|
||||
→ Controller
|
||||
→ Service(核心编排)
|
||||
→ Repository / External API
|
||||
→ 返回结果
|
||||
|
||||
---
|
||||
|
||||
#### 示例
|
||||
|
||||
##### 功能开通
|
||||
|
||||
Controller
|
||||
→ FeatureService.openFeature
|
||||
→ PaymentService.create
|
||||
→ PaymentCallback
|
||||
→ PermissionService.grant
|
||||
|
||||
---
|
||||
|
||||
#### 决策点
|
||||
|
||||
- 服务拆分粒度
|
||||
- 是否异步(消息队列)
|
||||
- 是否需要补偿机制
|
||||
|
||||
---
|
||||
|
||||
#### 输出
|
||||
|
||||
- 可执行后端服务
|
||||
- 业务状态流转
|
||||
|
||||
---
|
||||
|
||||
## 🔴 ③ 增长飞轮闭环(Growth Flywheel)
|
||||
|
||||
你现在是“系统”,但不是“生意机器”。
|
||||
|
||||
---
|
||||
|
||||
### 🧩 40️⃣ 增长飞轮闭环(Growth Flywheel Loop)
|
||||
|
||||
- **目标**:让系统自动变强、自动赚钱
|
||||
|
||||
---
|
||||
|
||||
#### 飞轮逻辑
|
||||
|
||||
数据 → 利润分析 → 推荐 → 用户行动 → 收入 → 更多数据
|
||||
|
||||
---
|
||||
|
||||
#### 核心路径
|
||||
|
||||
1. 商品数据 → 利润分析
|
||||
2. 利润高 → 推广广告
|
||||
3. 广告带订单
|
||||
4. 订单产生数据
|
||||
5. 数据优化策略
|
||||
|
||||
---
|
||||
|
||||
#### TOB路径
|
||||
|
||||
询盘 → 报价 → 成交 → 复购 → 信用提升 → 更大订单
|
||||
|
||||
---
|
||||
|
||||
#### 决策点
|
||||
|
||||
- 推荐策略
|
||||
- 自动化程度
|
||||
- AI参与程度
|
||||
|
||||
---
|
||||
|
||||
#### 输出
|
||||
|
||||
- GMV增长
|
||||
- ROI提升
|
||||
- 用户粘性
|
||||
|
||||
---
|
||||
|
||||
## 🔥 给你一句最关键的判断
|
||||
|
||||
你现在的系统:
|
||||
|
||||
> ✅ 是一个“ERP + 自动化系统”
|
||||
> ❌ 还不是“赚钱机器”
|
||||
|
||||
---
|
||||
|
||||
## 🧠 你现在的阶段定位
|
||||
|
||||
```text
|
||||
阶段1:业务闭环(你已完成)✅
|
||||
阶段2:系统实现(你进行中)✅
|
||||
阶段3:服务编排(你缺)❌
|
||||
阶段4:商业闭环(你缺)❌
|
||||
阶段5:增长飞轮(你缺)❌
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🚀 你下一步应该怎么做(非常关键)
|
||||
|
||||
不要再继续加业务闭环了,已经够了。
|
||||
|
||||
---
|
||||
|
||||
### ✅ 正确顺序:
|
||||
|
||||
#### ① 先做这个(最重要)
|
||||
|
||||
- 👉 **实现 Service 层(闭环 → 代码)**
|
||||
|
||||
选一个闭环:
|
||||
|
||||
```text
|
||||
33️⃣ 功能开通与支付闭环
|
||||
```
|
||||
|
||||
打通:
|
||||
|
||||
```text
|
||||
支付 → 权限 → 账单
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
#### ② 然后做
|
||||
|
||||
- 👉 商业化闭环(开始赚钱)
|
||||
|
||||
---
|
||||
|
||||
#### ③ 最后做
|
||||
|
||||
- 👉 增长飞轮(自动赚钱)
|
||||
|
||||
---
|
||||
|
||||
## ⚠️ 一个很关键的提醒(很多人死在这里)
|
||||
|
||||
如果你现在:
|
||||
|
||||
- 👉 继续写业务闭环
|
||||
- 👉 或继续拆任务
|
||||
|
||||
结果就是:
|
||||
|
||||
> ❌ 永远停在“设计系统”,而不是“跑系统”
|
||||
116
docs/01_Architecture/BILLING_RULES.md
Normal file
116
docs/01_Architecture/BILLING_RULES.md
Normal file
@@ -0,0 +1,116 @@
|
||||
# BILLING_RULES
|
||||
|
||||
## 收费模式
|
||||
|
||||
### 1. 功能收费
|
||||
|
||||
#### 基础功能(免费)
|
||||
- 商品管理
|
||||
- 订单处理
|
||||
- 基础数据报表
|
||||
- 库存管理
|
||||
|
||||
#### 高级功能(收费)
|
||||
|
||||
Feature: ADV_ANALYTICS(高级数据分析)
|
||||
- 类型:订阅制
|
||||
- 月费:$10
|
||||
- 功能:ROI分析、趋势预测、数据导出
|
||||
|
||||
Feature: API_CALL(API调用)
|
||||
- 类型:按量计费
|
||||
- 每次:$0.01
|
||||
- 功能:第三方系统集成、批量操作
|
||||
|
||||
Feature: AUTO_REPLENISH(自动补货)
|
||||
- 类型:订阅制
|
||||
- 月费:$15
|
||||
- 功能:智能库存预警、自动下单
|
||||
|
||||
Feature: MARKETING_AUTO(营销自动化)
|
||||
- 类型:订阅制
|
||||
- 月费:$20
|
||||
- 功能:自动促销、客户分群
|
||||
|
||||
Feature: CROSS_BORDER_LOGISTICS(跨境物流加速)
|
||||
- 类型:按量计费
|
||||
- 每单:$2
|
||||
- 功能:优先物流通道、清关协助
|
||||
|
||||
---
|
||||
|
||||
### 2. 订单抽成
|
||||
|
||||
- 每笔订单抽成:5%
|
||||
- 最低抽成:$0.5
|
||||
- 最高抽成:$50
|
||||
|
||||
---
|
||||
|
||||
### 3. 增值服务
|
||||
|
||||
- 技术支持:$50/小时
|
||||
- 定制开发:根据需求报价
|
||||
- 数据迁移:$100/次
|
||||
|
||||
---
|
||||
|
||||
## 收费触发点
|
||||
|
||||
- 功能开通 → 立即收费
|
||||
- API调用 → 累计计费(每日结算)
|
||||
- 订单完成 → 抽成
|
||||
- 增值服务 → 服务完成后收费
|
||||
|
||||
---
|
||||
|
||||
## 账单生成
|
||||
|
||||
- 每个收费行为必须记录 Bill
|
||||
- 每个 Bill 必须关联来源(feature/order/service)
|
||||
- 账单生成时间:每日23:59
|
||||
- 账单周期:自然月
|
||||
|
||||
---
|
||||
|
||||
## 结算周期
|
||||
|
||||
- 功能订阅:预付费
|
||||
- API调用:T+1
|
||||
- 订单抽成:T+7
|
||||
- 增值服务:服务完成后立即结算
|
||||
|
||||
---
|
||||
|
||||
## 支付方式
|
||||
|
||||
- 银行转账
|
||||
- 电子钱包(支付宝、微信支付)
|
||||
- 信用卡
|
||||
- PayPal
|
||||
|
||||
---
|
||||
|
||||
## 退款规则
|
||||
|
||||
- 功能订阅:未使用部分可退款
|
||||
- API调用:已使用部分不可退款
|
||||
- 订单抽成:不可退款
|
||||
- 增值服务:根据服务完成度退款
|
||||
|
||||
---
|
||||
|
||||
## 账单管理
|
||||
|
||||
- 商户可在后台查看详细账单
|
||||
- 支持账单导出(PDF/Excel)
|
||||
- 账单查询周期:最近12个月
|
||||
|
||||
---
|
||||
|
||||
## 逾期处理
|
||||
|
||||
- 逾期3天:系统提醒
|
||||
- 逾期7天:暂停高级功能
|
||||
- 逾期15天:暂停所有功能
|
||||
- 逾期30天:账户冻结
|
||||
172
docs/01_Architecture/DOMAIN_MODEL.md
Normal file
172
docs/01_Architecture/DOMAIN_MODEL.md
Normal file
@@ -0,0 +1,172 @@
|
||||
# DOMAIN_MODEL(领域模型)
|
||||
|
||||
## 核心实体
|
||||
|
||||
### Merchant(商户)
|
||||
- id
|
||||
- name
|
||||
- status(pending / active / inactive)
|
||||
- created_at
|
||||
- updated_at
|
||||
- contact_person
|
||||
- contact_email
|
||||
- contact_phone
|
||||
- address
|
||||
- business_type(B2B / B2C)
|
||||
|
||||
---
|
||||
|
||||
### User(用户)
|
||||
- id
|
||||
- merchant_id
|
||||
- role(admin / operator / viewer)
|
||||
- status
|
||||
- username
|
||||
- email
|
||||
- password_hash
|
||||
- created_at
|
||||
- updated_at
|
||||
|
||||
---
|
||||
|
||||
### Store(店铺)
|
||||
- id
|
||||
- merchant_id
|
||||
- name
|
||||
- platform
|
||||
- platform_shop_id
|
||||
- description
|
||||
- status
|
||||
- created_at
|
||||
- updated_at
|
||||
|
||||
---
|
||||
|
||||
### Feature(功能)
|
||||
- code
|
||||
- name
|
||||
- price_type(free / paid)
|
||||
- price_value
|
||||
- description
|
||||
- category
|
||||
|
||||
---
|
||||
|
||||
### MerchantFeature(商户功能)
|
||||
- id
|
||||
- merchant_id
|
||||
- feature_code
|
||||
- status(inactive / pending_payment / active / expired)
|
||||
- expire_at
|
||||
- created_at
|
||||
- updated_at
|
||||
|
||||
---
|
||||
|
||||
### Order(订单)
|
||||
- id
|
||||
- user_id
|
||||
- merchant_id
|
||||
- total_amount
|
||||
- status(pending / paid / split / shipped / completed / refunded)
|
||||
- created_at
|
||||
- updated_at
|
||||
- shipping_address
|
||||
- payment_method
|
||||
|
||||
---
|
||||
|
||||
### SubOrder(子订单)
|
||||
- id
|
||||
- order_id
|
||||
- merchant_id
|
||||
- store_id
|
||||
- amount
|
||||
- status
|
||||
- created_at
|
||||
- updated_at
|
||||
|
||||
---
|
||||
|
||||
### Product(商品)
|
||||
- id
|
||||
- merchant_id
|
||||
- store_id
|
||||
- name
|
||||
- sku
|
||||
- price
|
||||
- stock
|
||||
- status
|
||||
- created_at
|
||||
- updated_at
|
||||
|
||||
---
|
||||
|
||||
### Inventory(库存)
|
||||
- id
|
||||
- product_id
|
||||
- merchant_id
|
||||
- warehouse_id
|
||||
- quantity
|
||||
- status
|
||||
- last_sync_at
|
||||
|
||||
---
|
||||
|
||||
### Payment(支付)
|
||||
- id
|
||||
- merchant_id
|
||||
- amount
|
||||
- status(created / paid / failed)
|
||||
- type(feature / order)
|
||||
- payment_method
|
||||
- transaction_id
|
||||
- created_at
|
||||
- updated_at
|
||||
|
||||
---
|
||||
|
||||
### Bill(账单)
|
||||
- id
|
||||
- merchant_id
|
||||
- type(income / expense)
|
||||
- amount
|
||||
- status(pending / confirmed / settled)
|
||||
- source_type(order / feature)
|
||||
- source_id
|
||||
- created_at
|
||||
- updated_at
|
||||
|
||||
---
|
||||
|
||||
### Permission(权限)
|
||||
- id
|
||||
- role
|
||||
- resource
|
||||
- action
|
||||
- created_at
|
||||
|
||||
---
|
||||
|
||||
### Settlement(结算)
|
||||
- id
|
||||
- merchant_id
|
||||
- total_amount
|
||||
- platform_fee
|
||||
- net_amount
|
||||
- status
|
||||
- period_start
|
||||
- period_end
|
||||
- created_at
|
||||
- updated_at
|
||||
|
||||
---
|
||||
|
||||
### Analytics(数据分析)
|
||||
- id
|
||||
- merchant_id
|
||||
- report_type
|
||||
- data
|
||||
- generated_at
|
||||
- period_start
|
||||
- period_end
|
||||
85
docs/01_Architecture/PERMISSION_RULES.md
Normal file
85
docs/01_Architecture/PERMISSION_RULES.md
Normal file
@@ -0,0 +1,85 @@
|
||||
# PERMISSION_RULES
|
||||
|
||||
## 基础规则
|
||||
|
||||
- 商户只能访问自己的数据
|
||||
- 所有请求必须带 merchant_id
|
||||
- 超级管理员可跨商户访问
|
||||
- 权限校验必须在所有接口调用前执行
|
||||
- 未授权访问必须返回 403 Forbidden
|
||||
|
||||
---
|
||||
|
||||
## 功能权限
|
||||
|
||||
- 未开通功能 → 拒绝访问(403)
|
||||
- 已开通 → 正常访问
|
||||
- 功能过期 → 拒绝访问(403)
|
||||
- 功能暂停 → 拒绝访问(403)
|
||||
|
||||
---
|
||||
|
||||
## 角色权限
|
||||
|
||||
### Admin(商户管理员)
|
||||
- 全部权限
|
||||
- 可管理商户信息
|
||||
- 可管理用户账号
|
||||
- 可开通/关闭功能
|
||||
- 可查看所有报表
|
||||
|
||||
### Operator(运营专员)
|
||||
- 订单处理(创建、确认、发货)
|
||||
- 商品管理(添加、编辑、上下架)
|
||||
- 库存管理(更新库存)
|
||||
- 客户服务(处理售后)
|
||||
|
||||
### Viewer(查看员)
|
||||
- 只读权限
|
||||
- 可查看订单、商品、库存信息
|
||||
- 可查看报表
|
||||
|
||||
### System(系统角色)
|
||||
- 系统级操作权限
|
||||
- 可执行系统维护任务
|
||||
|
||||
---
|
||||
|
||||
## 数据权限
|
||||
|
||||
- 商户只能查看和操作自己的:
|
||||
- 订单
|
||||
- 商品
|
||||
- 库存
|
||||
- 店铺
|
||||
- 账单
|
||||
- 报表
|
||||
|
||||
- 超级管理员可查看和操作所有商户数据
|
||||
|
||||
---
|
||||
|
||||
## 接口校验流程
|
||||
|
||||
Request
|
||||
→ AuthMiddleware(身份验证)
|
||||
→ PermissionService.check(权限校验)
|
||||
→ FeatureService.checkAccess(功能访问校验)
|
||||
→ Controller
|
||||
|
||||
---
|
||||
|
||||
## 权限管理
|
||||
|
||||
- 权限必须通过 PermissionService 进行管理
|
||||
- 角色权限可通过管理界面进行配置
|
||||
- 权限变更必须记录操作日志
|
||||
|
||||
---
|
||||
|
||||
## 安全措施
|
||||
|
||||
- 密码必须加密存储
|
||||
- 敏感操作必须进行二次验证
|
||||
- API 调用必须使用 token 认证
|
||||
- 定期权限审计
|
||||
127
docs/01_Architecture/SERVICE_MAP.md
Normal file
127
docs/01_Architecture/SERVICE_MAP.md
Normal file
@@ -0,0 +1,127 @@
|
||||
# SERVICE_MAP(服务编排总图)
|
||||
|
||||
## 设计原则
|
||||
- 所有业务必须通过 Service 层
|
||||
- Controller 不允许直接操作数据库
|
||||
- 一个业务 = 一条 Service Flow
|
||||
- 服务调用必须遵循 STATE_MACHINE 定义的状态流转
|
||||
- 涉及收费的业务必须接入 BILLING 系统
|
||||
- 所有接口必须经过权限校验
|
||||
|
||||
---
|
||||
|
||||
## 1. 功能开通闭环(收费核心)
|
||||
|
||||
Flow:
|
||||
Frontend
|
||||
→ FeatureController.openFeature
|
||||
→ FeatureService.checkAccess
|
||||
→ PaymentService.createPayment
|
||||
→ PaymentCallbackService.confirm
|
||||
→ FeatureService.activateFeature
|
||||
→ PermissionService.grant
|
||||
→ BillingService.record
|
||||
→ Response
|
||||
|
||||
---
|
||||
|
||||
## 2. 多商户订单闭环
|
||||
|
||||
Flow:
|
||||
Frontend
|
||||
→ OrderController.create
|
||||
→ OrderService.createOrder
|
||||
→ OrderService.splitByMerchant
|
||||
→ InventoryService.lockStock
|
||||
→ OrderRepository.save
|
||||
→ Response
|
||||
|
||||
---
|
||||
|
||||
## 3. 订单履约闭环
|
||||
|
||||
Flow:
|
||||
OrderService.confirm
|
||||
→ ShipmentService.createShipment
|
||||
→ OrderService.updateStatus
|
||||
→ NotificationService.send
|
||||
|
||||
---
|
||||
|
||||
## 4. 结算闭环
|
||||
|
||||
Flow:
|
||||
Scheduler / Manual Trigger
|
||||
→ SettlementService.calculate
|
||||
→ SettlementService.generateBill
|
||||
→ PaymentService.payout
|
||||
→ BillingService.record
|
||||
|
||||
---
|
||||
|
||||
## 5. 权限校验闭环(所有接口必须经过)
|
||||
|
||||
Flow:
|
||||
Request
|
||||
→ AuthMiddleware
|
||||
→ PermissionService.check
|
||||
→ Controller
|
||||
|
||||
---
|
||||
|
||||
## 6. 商户管理闭环
|
||||
|
||||
Flow:
|
||||
Frontend
|
||||
→ MerchantController.create
|
||||
→ MerchantService.register
|
||||
→ VerificationService.verify
|
||||
→ RBACService.assignRole
|
||||
→ Response
|
||||
|
||||
---
|
||||
|
||||
## 7. 店铺管理闭环
|
||||
|
||||
Flow:
|
||||
Frontend
|
||||
→ StoreController.create
|
||||
→ StoreService.createStore
|
||||
→ ProductService.setupProducts
|
||||
→ InventoryService.initializeInventory
|
||||
→ Response
|
||||
|
||||
---
|
||||
|
||||
## 8. 商户数据与分析闭环
|
||||
|
||||
Flow:
|
||||
Scheduler / Manual Trigger
|
||||
→ AnalyticsService.collectData
|
||||
→ ReportService.generateReport
|
||||
→ NotificationService.sendReport
|
||||
→ Response
|
||||
|
||||
---
|
||||
|
||||
## 9. 多商户库存同步闭环
|
||||
|
||||
Flow:
|
||||
Merchant Portal
|
||||
→ InventoryController.sync
|
||||
→ InventorySyncService.syncMerchantInventory
|
||||
→ InventoryService.updateStock
|
||||
→ ProductService.updateProductStatus
|
||||
→ Response
|
||||
|
||||
---
|
||||
|
||||
## 10. 异常处理闭环
|
||||
|
||||
Flow:
|
||||
Frontend / System
|
||||
→ ExceptionController.handle
|
||||
→ ExceptionService.process
|
||||
→ NotificationService.alert
|
||||
→ SettlementService.adjust
|
||||
→ Response
|
||||
132
docs/01_Architecture/STATE_MACHINE.md
Normal file
132
docs/01_Architecture/STATE_MACHINE.md
Normal file
@@ -0,0 +1,132 @@
|
||||
# STATE_MACHINE
|
||||
|
||||
## Merchant(商户)状态
|
||||
|
||||
pending
|
||||
→ active
|
||||
→ inactive
|
||||
→ suspended
|
||||
|
||||
---
|
||||
|
||||
## User(用户)状态
|
||||
|
||||
pending
|
||||
→ active
|
||||
→ inactive
|
||||
→ locked
|
||||
|
||||
---
|
||||
|
||||
## Store(店铺)状态
|
||||
|
||||
pending
|
||||
→ active
|
||||
→ inactive
|
||||
→ suspended
|
||||
|
||||
---
|
||||
|
||||
## Feature(功能)状态
|
||||
|
||||
inactive
|
||||
→ pending_payment
|
||||
→ active
|
||||
→ expired
|
||||
→ suspended
|
||||
|
||||
---
|
||||
|
||||
## Order(订单)状态
|
||||
|
||||
pending
|
||||
→ paid
|
||||
→ split
|
||||
→ processing
|
||||
→ shipped
|
||||
→ completed
|
||||
→ refunded
|
||||
→ cancelled
|
||||
|
||||
---
|
||||
|
||||
## SubOrder(子订单)状态
|
||||
|
||||
pending
|
||||
→ processing
|
||||
→ shipped
|
||||
→ completed
|
||||
→ refunded
|
||||
→ cancelled
|
||||
|
||||
---
|
||||
|
||||
## Product(商品)状态
|
||||
|
||||
draft
|
||||
→ pending_approval
|
||||
→ active
|
||||
→ inactive
|
||||
→ discontinued
|
||||
|
||||
---
|
||||
|
||||
## Inventory(库存)状态
|
||||
|
||||
normal
|
||||
→ low
|
||||
→ out_of_stock
|
||||
→ overstock
|
||||
|
||||
---
|
||||
|
||||
## Payment(支付)状态
|
||||
|
||||
created
|
||||
→ processing
|
||||
→ paid
|
||||
→ failed
|
||||
→ refunded
|
||||
|
||||
---
|
||||
|
||||
## Bill(账单)状态
|
||||
|
||||
pending
|
||||
→ confirmed
|
||||
→ settled
|
||||
→ disputed
|
||||
|
||||
---
|
||||
|
||||
## Settlement(结算)状态
|
||||
|
||||
pending
|
||||
→ processing
|
||||
→ completed
|
||||
→ failed
|
||||
|
||||
---
|
||||
|
||||
## 状态变更原则
|
||||
|
||||
- 所有状态变更必须通过 Service
|
||||
- 禁止前端直接控制状态
|
||||
- 状态变更必须记录操作日志
|
||||
- 状态变更必须遵循预定义的流转路径
|
||||
- 状态变更可能触发相关业务逻辑(如通知、计费等)
|
||||
|
||||
---
|
||||
|
||||
## 状态变更触发条件
|
||||
|
||||
- 商户状态:审核结果、逾期未付费、违规行为
|
||||
- 用户状态:登录异常、权限变更、账号管理
|
||||
- 店铺状态:平台审核、违规行为、商户操作
|
||||
- 功能状态:支付结果、订阅到期、手动操作
|
||||
- 订单状态:支付结果、商户操作、物流状态
|
||||
- 商品状态:审核结果、库存状态、商户操作
|
||||
- 库存状态:库存数量变化、库存同步
|
||||
- 支付状态:支付渠道反馈、人工处理
|
||||
- 账单状态:系统确认、支付结果、人工处理
|
||||
- 结算状态:系统处理、支付结果、人工处理
|
||||
141
docs/05_AI/AI_RULES.md
Normal file
141
docs/05_AI/AI_RULES.md
Normal file
@@ -0,0 +1,141 @@
|
||||
# AI_RULES(AI开发规则)
|
||||
|
||||
## 核心原则
|
||||
|
||||
- 必须基于 SERVICE_MAP 开发
|
||||
- 不允许绕过 Service 层
|
||||
- 不允许直接操作数据库(除 repository)
|
||||
- 必须遵守 STATE_MACHINE
|
||||
- 必须接入 BILLING(如果涉及收费)
|
||||
- 必须接入 PERMISSION
|
||||
- 必须遵循 DOMAIN_MODEL 定义的实体关系
|
||||
- 必须按照 TEST_SPEC 进行测试
|
||||
|
||||
---
|
||||
|
||||
## 开发顺序
|
||||
|
||||
1. Service(业务逻辑)
|
||||
2. Repository(数据访问)
|
||||
3. Controller(接口层)
|
||||
4. Frontend(前端实现)
|
||||
5. Test(测试用例)
|
||||
|
||||
---
|
||||
|
||||
## 禁止行为
|
||||
|
||||
- Controller 写业务逻辑
|
||||
- 前端控制状态
|
||||
- 跳过权限校验
|
||||
- 硬编码业务规则
|
||||
- 直接修改数据库表结构
|
||||
- 忽略状态机流转
|
||||
- 绕过服务层直接调用底层API
|
||||
|
||||
---
|
||||
|
||||
## 代码规范
|
||||
|
||||
- 服务类统一使用 `Service` 后缀
|
||||
- 控制器类统一使用 `Controller` 后缀
|
||||
- 仓库类统一使用 `Repository` 后缀
|
||||
- 方法名使用驼峰命名法
|
||||
- 变量名使用驼峰命名法
|
||||
- 常量使用大写蛇形命名法
|
||||
- 类名使用帕斯卡命名法
|
||||
|
||||
---
|
||||
|
||||
## 注释规范
|
||||
|
||||
- 每个服务类必须包含完整 JSDoc
|
||||
- 每个方法必须包含参数和返回值说明
|
||||
- 关键业务逻辑必须添加注释
|
||||
- 状态变更必须添加注释说明
|
||||
- 收费相关逻辑必须添加注释
|
||||
|
||||
---
|
||||
|
||||
## 错误处理
|
||||
|
||||
- 所有错误必须通过统一的错误处理机制
|
||||
- 错误信息必须清晰明确
|
||||
- 错误必须记录详细日志
|
||||
- 敏感错误信息不得返回给前端
|
||||
|
||||
---
|
||||
|
||||
## 日志规范
|
||||
|
||||
- 所有服务调用必须记录日志
|
||||
- 状态变更必须记录日志
|
||||
- 收费行为必须记录日志
|
||||
- 权限校验失败必须记录日志
|
||||
- 异常情况必须记录日志
|
||||
|
||||
---
|
||||
|
||||
## 安全规范
|
||||
|
||||
- 密码必须加密存储
|
||||
- 敏感数据必须加密传输
|
||||
- API 调用必须使用 token 认证
|
||||
- 防止 SQL 注入
|
||||
- 防止 XSS 攻击
|
||||
- 防止 CSRF 攻击
|
||||
|
||||
---
|
||||
|
||||
## 性能规范
|
||||
|
||||
- 避免不必要的数据库查询
|
||||
- 合理使用缓存
|
||||
- 批量操作优化
|
||||
- 异步处理耗时操作
|
||||
- 合理设置超时时间
|
||||
|
||||
---
|
||||
|
||||
## 测试规范
|
||||
|
||||
- 每个服务必须有对应的测试用例
|
||||
- 测试用例必须覆盖正常流程和异常流程
|
||||
- 测试用例必须基于 TEST_SPEC
|
||||
- 测试结果必须记录详细日志
|
||||
- 测试失败必须及时修复
|
||||
|
||||
---
|
||||
|
||||
## 代码审查
|
||||
|
||||
- 代码提交前必须进行自我审查
|
||||
- 审查重点:
|
||||
- 业务逻辑正确性
|
||||
- 状态机遵循情况
|
||||
- 权限校验完整性
|
||||
- 收费逻辑正确性
|
||||
- 错误处理完整性
|
||||
- 性能优化
|
||||
- 安全漏洞
|
||||
|
||||
---
|
||||
|
||||
## 版本控制
|
||||
|
||||
- 代码必须使用 Git 进行版本控制
|
||||
- 提交信息必须清晰明确
|
||||
- 分支管理必须规范
|
||||
- 代码合并前必须进行代码审查
|
||||
|
||||
---
|
||||
|
||||
## 持续集成
|
||||
|
||||
- 代码提交后必须触发 CI 流程
|
||||
- CI 流程必须包含:
|
||||
- 代码质量检查
|
||||
- 单元测试
|
||||
- 集成测试
|
||||
- 构建检查
|
||||
- CI 失败必须及时修复
|
||||
134
docs/07_Testing/TEST_SPEC.md
Normal file
134
docs/07_Testing/TEST_SPEC.md
Normal file
@@ -0,0 +1,134 @@
|
||||
# TEST_SPEC
|
||||
|
||||
## 1. 功能开通测试
|
||||
|
||||
- 未开通访问 → 403
|
||||
- 创建支付单 → 成功
|
||||
- 支付成功 → 状态变 active
|
||||
- 权限生效
|
||||
- 账单生成
|
||||
- 功能过期 → 自动变为 expired
|
||||
- 功能暂停 → 状态变 suspended
|
||||
|
||||
---
|
||||
|
||||
## 2. 多商户订单测试
|
||||
|
||||
- 一个订单 → 多子订单
|
||||
- 每个子订单归属正确商户
|
||||
- 库存正确扣减
|
||||
- 订单状态流转正确
|
||||
- 子订单状态与主订单状态同步
|
||||
|
||||
---
|
||||
|
||||
## 3. 结算测试
|
||||
|
||||
- 订单完成 → 生成账单
|
||||
- 抽成正确
|
||||
- 商户收入正确
|
||||
- 结算周期正确
|
||||
- 账单状态流转正确
|
||||
|
||||
---
|
||||
|
||||
## 4. 权限测试
|
||||
|
||||
- A商户不能访问B数据
|
||||
- 未开通功能不能访问
|
||||
- 不同角色权限正确
|
||||
- 超级管理员可访问所有数据
|
||||
- 权限变更生效
|
||||
|
||||
---
|
||||
|
||||
## 5. 状态机测试
|
||||
|
||||
- 不允许跳状态(如 pending → completed)
|
||||
- 状态变更必须通过 Service
|
||||
- 状态变更触发相关业务逻辑
|
||||
- 状态变更记录操作日志
|
||||
|
||||
---
|
||||
|
||||
## 6. 商户管理测试
|
||||
|
||||
- 商户注册 → 成功
|
||||
- 商户认证 → 成功
|
||||
- 商户状态变更 → 正确
|
||||
- 商户信息修改 → 成功
|
||||
- 商户删除 → 正确处理相关数据
|
||||
|
||||
---
|
||||
|
||||
## 7. 店铺管理测试
|
||||
|
||||
- 店铺创建 → 成功
|
||||
- 店铺信息修改 → 成功
|
||||
- 店铺状态变更 → 正确
|
||||
- 店铺绑定平台 → 成功
|
||||
|
||||
---
|
||||
|
||||
## 8. 商品管理测试
|
||||
|
||||
- 商品创建 → 成功
|
||||
- 商品上下架 → 正确
|
||||
- 商品信息修改 → 成功
|
||||
- 商品库存更新 → 正确
|
||||
|
||||
---
|
||||
|
||||
## 9. 库存管理测试
|
||||
|
||||
- 库存同步 → 成功
|
||||
- 库存预警 → 正确
|
||||
- 库存状态变更 → 正确
|
||||
- 多仓库库存管理 → 正确
|
||||
|
||||
---
|
||||
|
||||
## 10. 数据分析测试
|
||||
|
||||
- 销售报表生成 → 成功
|
||||
- 库存报表生成 → 成功
|
||||
- 财务报表生成 → 成功
|
||||
- 数据导出 → 成功
|
||||
|
||||
---
|
||||
|
||||
## 11. 异常处理测试
|
||||
|
||||
- 支付失败 → 正确处理
|
||||
- 库存不足 → 阻止下单
|
||||
- 权限错误 → 返回 403
|
||||
- 系统异常 → 记录日志并报警
|
||||
|
||||
---
|
||||
|
||||
## 12. 性能测试
|
||||
|
||||
- API 响应时间 < 500ms
|
||||
- 并发处理能力 ≥ 100 QPS
|
||||
- 大数据量查询性能
|
||||
- 系统稳定性测试
|
||||
|
||||
---
|
||||
|
||||
## 13. 安全测试
|
||||
|
||||
- 密码加密存储
|
||||
- 敏感数据保护
|
||||
- 防止 SQL 注入
|
||||
- 防止 XSS 攻击
|
||||
- API 调用认证
|
||||
|
||||
---
|
||||
|
||||
## 测试执行规范
|
||||
|
||||
- 所有测试必须基于 SERVICE_MAP 定义的流程
|
||||
- 测试用例必须覆盖所有状态流转
|
||||
- 测试结果必须记录详细日志
|
||||
- 测试失败必须及时修复
|
||||
- 定期执行回归测试
|
||||
111
docs/Development_Progress.md
Normal file
111
docs/Development_Progress.md
Normal file
@@ -0,0 +1,111 @@
|
||||
# 📊 开发进度互通文档
|
||||
|
||||
## 🎯 文档目的
|
||||
|
||||
本文档用于与AI开发助手(GPT)互通开发进度,确保双方对项目状态有清晰的了解,避免信息断层和重复工作。
|
||||
|
||||
## 🔍 开发概览
|
||||
|
||||
### 项目状态
|
||||
- **当前阶段**:服务编排层实现
|
||||
- **核心目标**:构建可收费的多商户业务闭环
|
||||
- **技术栈**:Node.js + TypeScript + React
|
||||
|
||||
### 关键里程碑
|
||||
| 里程碑 | 状态 | 预计完成时间 | 实际完成时间 |
|
||||
| ------ | ---- | ------------ | ------------ |
|
||||
| 多商户业务闭环文档完善 | ✅ 已完成 | 2024-12-15 | 2024-12-15 |
|
||||
| 服务编排地图(SERVICE_MAP) | ✅ 已完成 | 2024-12-16 | 2026-03-18 |
|
||||
| 领域模型(DOMAIN_MODEL) | ✅ 已完成 | 2024-12-17 | 2026-03-18 |
|
||||
| 状态机定义(STATE_MACHINE) | ✅ 已完成 | 2024-12-18 | 2026-03-18 |
|
||||
| 功能开通服务实现 | ✅ 已完成 | 2024-12-19 | 2026-03-18 |
|
||||
| 系统集成测试 | ⏳ 待开始 | 2024-12-20 | - |
|
||||
|
||||
## 📋 任务状态跟踪
|
||||
|
||||
### 已完成任务
|
||||
1. ✅ 完善Business_ClosedLoops.md中的多商户相关闭环
|
||||
2. ✅ 新建开发进度互通文档
|
||||
3. ✅ 更新SERVICE_MAP.md文档,定义服务调用链
|
||||
4. ✅ 更新DOMAIN_MODEL.md文档,定义核心实体及其关系
|
||||
5. ✅ 更新PERMISSION_RULES.md文档,定义权限规则
|
||||
6. ✅ 更新BILLING_RULES.md文档,定义收费规则
|
||||
7. ✅ 更新STATE_MACHINE.md文档,定义状态机
|
||||
8. ✅ 更新TEST_SPEC.md文档,定义测试规范
|
||||
9. ✅ 更新AI_RULES.md文档,定义AI执行规则
|
||||
10. ✅ 实现服务层代码(MerchantService、StoreService、InventorySyncService、AnalyticsService)
|
||||
11. ✅ 修复AIService.ts中的optimizeProductForPlatform方法
|
||||
12. ✅ 修复ProductService.ts中的createProduct方法和其他方法错误
|
||||
13. ✅ 修复InventoryAgingService.ts中的AGING_THRESHOLD_DAYS引用问题
|
||||
14. ✅ 修复InventoryService.ts中的predictSKUDemand方法
|
||||
15. ✅ 修复ChatBotController.ts的实现,从tsoa风格改为Express风格
|
||||
16. ✅ 修复CommandCenterController.ts中的类型问题
|
||||
17. ✅ 修复AdAutoService.ts中stock可能为undefined的问题
|
||||
18. ✅ 启动前端服务(运行在 http://localhost:8000)
|
||||
|
||||
### 进行中任务
|
||||
1. 🔄 启动后端服务器
|
||||
|
||||
### 待开始任务
|
||||
1. ⏳ 系统集成测试
|
||||
2. ⏳ 性能优化
|
||||
3. ⏳ 安全测试
|
||||
|
||||
## 💬 沟通记录
|
||||
|
||||
### 最近沟通
|
||||
- **2024-12-15**:用户提供ChatGPT导出文件,要求完善docs文档后再开始修改代码
|
||||
- **2024-12-15**:完成Business_ClosedLoops.md的多商户闭环内容完善
|
||||
- **2024-12-15**:创建开发进度互通文档
|
||||
- **2026-03-18**:完成所有文档的更新和服务层代码的实现
|
||||
- **2026-03-18**:修复服务层代码中的编译错误,包括AIService、ProductService、InventoryAgingService和InventoryService
|
||||
- **2026-03-18**:修复ChatBotController和CommandCenterController的实现问题
|
||||
- **2026-03-18**:修复AdAutoService.ts中stock可能为undefined的问题
|
||||
- **2026-03-18**:启动后端服务器,进行系统集成测试准备
|
||||
- **2026-03-18**:启动前端服务,成功运行在 http://localhost:8000
|
||||
|
||||
### AI开发建议
|
||||
1. 优先进行系统集成测试,确保各服务之间的正确交互
|
||||
2. 实现完整的错误处理和日志记录机制
|
||||
3. 优化服务层性能,特别是数据库查询和异步操作
|
||||
4. 加强安全措施,确保支付流程和数据传输的安全性
|
||||
|
||||
## 📝 下一步计划
|
||||
|
||||
### 短期计划(1-3天)
|
||||
1. 进行系统集成测试,验证服务层功能
|
||||
2. 优化数据库查询和缓存策略
|
||||
3. 实现完整的错误处理和日志记录
|
||||
|
||||
### 中期计划(4-7天)
|
||||
1. 进行性能测试和优化
|
||||
2. 实现安全测试,确保系统安全性
|
||||
3. 完善前端与后端的集成
|
||||
|
||||
### 长期计划(8-14天)
|
||||
1. 部署系统到生产环境
|
||||
2. 监控系统运行状态
|
||||
3. 持续优化和迭代系统功能
|
||||
|
||||
## 🚨 风险与问题
|
||||
|
||||
### 当前风险
|
||||
1. 系统集成测试可能发现服务间交互问题
|
||||
2. 数据库性能可能成为系统瓶颈,特别是在高并发场景下
|
||||
3. 安全漏洞可能存在于支付流程和数据传输中
|
||||
|
||||
### 需要关注的问题
|
||||
1. 确保系统在高并发场景下的稳定性
|
||||
2. 实现完善的监控和告警机制
|
||||
3. 加强数据备份和恢复策略
|
||||
4. 确保符合相关法规和合规要求
|
||||
|
||||
## 📞 联系方式
|
||||
|
||||
- **项目负责人**:用户
|
||||
- **AI开发助手**:GPT
|
||||
- **沟通渠道**:本文档 + 代码注释
|
||||
|
||||
---
|
||||
|
||||
*本文档将定期更新,确保开发进度的透明和同步。*
|
||||
685
docs/Module_Inventory.md
Normal file
685
docs/Module_Inventory.md
Normal file
@@ -0,0 +1,685 @@
|
||||
# 项目模块清单与说明
|
||||
|
||||
## 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%),大部分模块处于未实现状态。建议按照业务优先级逐步实现核心功能,同时保持代码结构的清晰和一致性。
|
||||
|
||||
通过本模块清单,可以清晰了解项目的整体结构和实现状态,为后续的开发和维护提供参考。
|
||||
Reference in New Issue
Block a user