wurenzhi
15ee1758f5
- 移除extension模块，将功能迁移至node-agent - 修复类型导出问题，使用export type明确类型导出 - 统一数据库连接方式，从直接导入改为使用config/database - 更新文档中的项目结构描述 - 添加多个服务的实用方法，如getForecast、getBalances等 - 修复类型错误和TS1205警告 - 优化RedisService调用方式 - 添加新的实体类型定义 - 更新审计日志格式，统一字段命名
411 lines
19 KiB
Markdown
411 lines
19 KiB
Markdown
# 全局功能方案
|
|
|
|
> **创建日期**: 2026-03-20
|
|
> **状态**: 设计中
|
|
> **优先级**: 最高
|
|
|
|
---
|
|
|
|
## 1. 全局功能架构
|
|
|
|
### 1.1 功能模块总览
|
|
|
|
```
|
|
┌─────────────────────────────────────────────────────────────────────────────┐
|
|
│ Crawlful Hub 功能架构 │
|
|
├─────────────────────────────────────────────────────────────────────────────┤
|
|
│ │
|
|
│ ┌─────────────────────────────────────────────────────────────────────┐ │
|
|
│ │ 业务功能层 (Business Layer) │ │
|
|
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
|
|
│ │ │ 商品管理 │ │ 订单管理 │ │ 营销管理 │ │ 财务管理 │ │ 库存管理 │ │ │
|
|
│ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │
|
|
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
|
|
│ │ │ 物流管理 │ │ B2B贸易 │ │ 合规管理 │ │ 多商户 │ │ 客户服务 │ │ │
|
|
│ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │
|
|
│ └─────────────────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
│ ┌─────────────────────────────────────────────────────────────────────┐ │
|
|
│ │ AI自动化层 (AI Layer) │ │
|
|
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
|
|
│ │ │ 自动选品 │ │ 自动定价 │ │ 自动上架 │ │ 智能客服 │ │ 异常检测 │ │ │
|
|
│ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │
|
|
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
|
|
│ │ │ 跨境套利 │ │ 广告优化 │ │ 库存预测 │ │ 风险预警 │ │ 策略市场 │ │ │
|
|
│ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │
|
|
│ └─────────────────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
│ ┌─────────────────────────────────────────────────────────────────────┐ │
|
|
│ │ Agent执行层 (Agent Layer) │ │
|
|
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
|
|
│ │ │ 平台采集 │ │ 自动刊登 │ │ 订单处理 │ │ 广告投放 │ │ 库存同步 │ │ │
|
|
│ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │
|
|
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
|
|
│ │ │ 价格调整 │ │ 退货处理 │ │ 客服回复 │ │ 数据同步 │ │ 健康监控 │ │ │
|
|
│ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │
|
|
│ └─────────────────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
│ ┌─────────────────────────────────────────────────────────────────────┐ │
|
|
│ │ 后台管理层 (Admin Layer) │ │
|
|
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
|
|
│ │ │ 用户管理 │ │ 租户管理 │ │ 权限管理 │ │ 审批流程 │ │ 审计日志 │ │ │
|
|
│ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │
|
|
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
|
|
│ │ │ 配额管理 │ │ 系统配置 │ │ 监控告警 │ │ 数据分析 │ │ 报表中心 │ │ │
|
|
│ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │
|
|
│ └─────────────────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
│ ┌─────────────────────────────────────────────────────────────────────┐ │
|
|
│ │ 基础设施层 (Infrastructure Layer) │ │
|
|
│ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │
|
|
│ │ │ 数据库 │ │ 缓存 │ │ 消息队列 │ │ 任务调度 │ │ 日志系统 │ │ │
|
|
│ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │
|
|
│ └─────────────────────────────────────────────────────────────────────┘ │
|
|
│ │
|
|
└─────────────────────────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## 2. 业务功能模块
|
|
|
|
### 2.1 商品管理模块
|
|
|
|
| 功能 | 描述 | 前端页面 | 后端服务 |
|
|
|------|------|----------|----------|
|
|
| 商品采集 | 多平台商品数据采集 | ProductList | ProductService, Node Agent |
|
|
| 商品编辑 | 商品信息编辑、SKU管理 | ProductDetail | ProductService |
|
|
| 商品刊登 | 多平台一键刊登 | ProductPublishForm | AutoListingService |
|
|
| 商品定价 | 智能定价、利润计算 | AIPricing | PricingService |
|
|
| 商品分析 | ROI分析、利润监控 | ROIAnalysis, ProfitMonitor | ArbitrageService |
|
|
| 跨平台管理 | 多平台商品同步 | CrossPlatformManage | ProductService |
|
|
|
|
### 2.2 订单管理模块
|
|
|
|
| 功能 | 描述 | 前端页面 | 后端服务 |
|
|
|------|------|----------|----------|
|
|
| 订单列表 | 订单查询、筛选、导出 | OrderList | OrderService |
|
|
| 订单详情 | 订单详细信息、操作 | OrderDetail | OrderService |
|
|
| 异常订单 | 异常订单处理 | ExceptionOrder | OrderService |
|
|
| 订单聚合 | 多店铺订单汇总 | OrderAggregation | OrderAggregationService |
|
|
| 订单履约 | 发货、物流跟踪 | - | UnifiedFulfillmentService |
|
|
|
|
### 2.3 营销管理模块
|
|
|
|
| 功能 | 描述 | 前端页面 | 后端服务 |
|
|
|------|------|----------|----------|
|
|
| 广告计划 | 广告创建、管理 | AdPlanPage | MarketingService |
|
|
| 广告投放 | 自动投放、优化 | AdDelivery | AdOpsService |
|
|
| ROI分析 | 广告效果分析 | ROIAnalysis | MarketingService |
|
|
| 竞品分析 | 竞品监控、分析 | Competitors | CompetitorService |
|
|
| A/B测试 | 策略测试优化 | ABTestConfig, ABTestResults | ABTestService |
|
|
|
|
### 2.4 财务管理模块
|
|
|
|
| 功能 | 描述 | 前端页面 | 后端服务 |
|
|
|------|------|----------|----------|
|
|
| 交易记录 | 交易流水查询 | Transactions | FinanceService |
|
|
| 资金对账 | 多平台对账 | Reconciliation | ReconciliationService |
|
|
| 利润核算 | 利润计算、分析 | ProfitReport | OrderProfitService |
|
|
| 结算管理 | 商户结算 | MerchantSettlementManage | SettlementService |
|
|
|
|
### 2.5 库存管理模块
|
|
|
|
| 功能 | 描述 | 前端页面 | 后端服务 |
|
|
|------|------|----------|----------|
|
|
| 库存查询 | 库存实时查询 | InventoryForecast | InventoryService |
|
|
| 库存预测 | AI库存预测 | InventoryForecast | InventoryForecastService |
|
|
| 仓库管理 | 多仓库管理 | Warehouses | WMSWaveService |
|
|
| 补货建议 | 智能补货建议 | - | InventoryRLOptimizerService |
|
|
|
|
### 2.6 物流管理模块
|
|
|
|
| 功能 | 描述 | 前端页面 | 后端服务 |
|
|
|------|------|----------|----------|
|
|
| 物流跟踪 | 订单物流追踪 | LogisticsTrack | LogisticsTrackerService |
|
|
| 运费计算 | 智能运费计算 | FreightCalc | DynamicShippingService |
|
|
| 物流渠道 | 渠道选择管理 | LogisticsSelect | LogisticsService |
|
|
|
|
### 2.7 B2B贸易模块
|
|
|
|
| 功能 | 描述 | 前端页面 | 后端服务 |
|
|
|------|------|----------|----------|
|
|
| 企业报价 | B2B报价管理 | EnterpriseQuote | B2BTradeService |
|
|
| 批量订单 | 批量订单处理 | BatchOrder | B2BTradeService |
|
|
| 合同管理 | 合同创建、管理 | ContractManage | B2BTradeService |
|
|
|
|
### 2.8 合规管理模块
|
|
|
|
| 功能 | 描述 | 前端页面 | 后端服务 |
|
|
|------|------|----------|----------|
|
|
| 证书管理 | 合规证书管理 | CertificateManage | CertificateDatabaseService |
|
|
| 合规检查 | 自动合规检查 | ComplianceCheck | ComplianceService |
|
|
| 证书提醒 | 过期提醒 | CertificateExpiryReminder | CertificateDatabaseService |
|
|
|
|
### 2.9 多商户模块
|
|
|
|
| 功能 | 描述 | 前端页面 | 后端服务 |
|
|
|------|------|----------|----------|
|
|
| 商户管理 | 商户入驻、管理 | MerchantManage | MerchantService |
|
|
| 商户订单 | 商户订单管理 | MerchantOrderManage | MerchantOrderService |
|
|
| 商户店铺 | 商户店铺管理 | MerchantShopManage | MerchantShopService |
|
|
| 商户结算 | 商户结算管理 | MerchantSettlementManage | MerchantSettlementService |
|
|
|
|
### 2.10 客户服务模块
|
|
|
|
| 功能 | 描述 | 前端页面 | 后端服务 |
|
|
|------|------|----------|----------|
|
|
| 客服中心 | 客服工单管理 | CustomerService | CustomerService |
|
|
| 售后处理 | 退货、退款处理 | RefundProcess, ReturnApply | AfterSalesService |
|
|
| 客户资产 | 会员、积分管理 | MemberLevel, PointsManage | UserAssetService |
|
|
|
|
---
|
|
|
|
## 3. AI自动化模块
|
|
|
|
### 3.1 自动选品
|
|
|
|
```typescript
|
|
interface AutoSelectionConfig {
|
|
platforms: string[];
|
|
categories: string[];
|
|
priceRange: { min: number; max: number };
|
|
profitThreshold: number;
|
|
scoreWeights: {
|
|
profitRate: number;
|
|
salesVolume: number;
|
|
competition: number;
|
|
trend: number;
|
|
};
|
|
}
|
|
```
|
|
|
|
### 3.2 自动定价
|
|
|
|
```typescript
|
|
interface AutoPricingConfig {
|
|
strategy: 'MAX_PROFIT' | 'MAX_VOLUME' | 'BALANCED';
|
|
minProfitRate: number;
|
|
competitorTracking: boolean;
|
|
dynamicAdjustment: boolean;
|
|
adjustmentFrequency: 'HOURLY' | 'DAILY' | 'WEEKLY';
|
|
}
|
|
```
|
|
|
|
### 3.3 自动上架
|
|
|
|
```typescript
|
|
interface AutoListingConfig {
|
|
platforms: string[];
|
|
auto_pricing: boolean;
|
|
auto_description: boolean;
|
|
auto_images: boolean;
|
|
schedule: {
|
|
startTime: string;
|
|
endTime: string;
|
|
interval: number;
|
|
};
|
|
}
|
|
```
|
|
|
|
### 3.4 智能客服
|
|
|
|
```typescript
|
|
interface ChatBotConfig {
|
|
enabled: boolean;
|
|
autoReply: boolean;
|
|
intentRecognition: boolean;
|
|
escalationThreshold: number;
|
|
supportedLanguages: string[];
|
|
}
|
|
```
|
|
|
|
### 3.5 异常检测
|
|
|
|
```typescript
|
|
interface AnomalyDetectionConfig {
|
|
metrics: string[];
|
|
thresholds: Record<string, number>;
|
|
alertChannels: ('EMAIL' | 'SMS' | 'WEBHOOK')[];
|
|
autoRecovery: boolean;
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 4. Agent执行模块
|
|
|
|
### 4.1 平台采集Agent
|
|
|
|
| 平台 | 采集内容 | 适配器 |
|
|
|------|----------|--------|
|
|
| TikTok Shop | 商品、订单、广告 | TikTokAdapter |
|
|
| Temu | 商品、订单 | TemuAdapter |
|
|
| Amazon | 商品、订单、广告 | AmazonAdapter |
|
|
| Shopee | 商品、订单 | ShopeeAdapter |
|
|
| AliExpress | 商品、订单 | AliExpressAdapter |
|
|
| 1688 | 商品、供应商 | Ali1688Adapter |
|
|
|
|
### 4.2 自动化操作Agent
|
|
|
|
| 操作 | 描述 | 触发方式 |
|
|
|------|------|----------|
|
|
| 商品刊登 | 自动刊登到目标平台 | 定时/手动 |
|
|
| 价格调整 | 根据策略调整价格 | 定时/事件 |
|
|
| 库存同步 | 多平台库存同步 | 定时/事件 |
|
|
| 订单处理 | 自动确认、发货 | 事件驱动 |
|
|
| 广告投放 | 自动创建、优化广告 | 定时/事件 |
|
|
| 客服回复 | 自动回复客户消息 | 事件驱动 |
|
|
|
|
### 4.3 Agent任务调度
|
|
|
|
```typescript
|
|
interface AgentTaskScheduler {
|
|
// 任务优先级
|
|
priority: 'HIGH' | 'MEDIUM' | 'LOW';
|
|
|
|
// 任务依赖
|
|
dependencies: string[];
|
|
|
|
// 重试策略
|
|
retry: {
|
|
maxAttempts: number;
|
|
backoff: 'LINEAR' | 'EXPONENTIAL';
|
|
interval: number;
|
|
};
|
|
|
|
// 超时设置
|
|
timeout: number;
|
|
|
|
// 并发控制
|
|
concurrency: {
|
|
maxConcurrent: number;
|
|
perShop: number;
|
|
};
|
|
}
|
|
```
|
|
|
|
---
|
|
|
|
## 5. 后台管理模块
|
|
|
|
### 5.1 用户管理
|
|
|
|
| 功能 | 描述 | 权限 |
|
|
|------|------|------|
|
|
| 用户列表 | 用户CRUD操作 | ADMIN |
|
|
| 角色管理 | 角色定义、权限分配 | ADMIN |
|
|
| 权限管理 | 细粒度权限控制 | ADMIN |
|
|
| 登录日志 | 登录记录查询 | ADMIN, MANAGER |
|
|
|
|
### 5.2 租户管理
|
|
|
|
| 功能 | 描述 | 权限 |
|
|
|------|------|------|
|
|
| 租户列表 | 租户CRUD操作 | SUPER_ADMIN |
|
|
| 租户配置 | 租户级配置管理 | ADMIN |
|
|
| 租户隔离 | 数据隔离验证 | SYSTEM |
|
|
| 配额管理 | 租户资源配额 | ADMIN |
|
|
|
|
### 5.3 审批流程
|
|
|
|
| 功能 | 描述 | 触发场景 |
|
|
|------|------|----------|
|
|
| 价格审批 | 价格变动审批 | 利润率低于阈值 |
|
|
| 退款审批 | 退款申请审批 | 大额退款 |
|
|
| 订单审批 | 特殊订单审批 | 异常订单 |
|
|
| 合同审批 | B2B合同审批 | 新合同签订 |
|
|
|
|
### 5.4 审计日志
|
|
|
|
| 功能 | 描述 | 存储方式 |
|
|
|------|------|----------|
|
|
| 操作日志 | 用户操作记录 | 数据库 |
|
|
| 系统日志 | 系统事件记录 | 文件 + 数据库 |
|
|
| 审计追溯 | 操作链路追溯 | 数据库 |
|
|
| 合规报告 | 合规性报告生成 | 定时生成 |
|
|
|
|
### 5.5 监控告警
|
|
|
|
| 功能 | 描述 | 通知方式 |
|
|
|------|------|----------|
|
|
| 系统监控 | 服务健康状态 | Dashboard + 邮件 |
|
|
| 业务监控 | 业务指标监控 | Dashboard + 邮件 |
|
|
| 异常告警 | 异常事件告警 | 邮件 + 短信 + Webhook |
|
|
| 性能监控 | 性能指标监控 | Dashboard |
|
|
|
|
### 5.6 数据分析
|
|
|
|
| 功能 | 描述 | 输出方式 |
|
|
|------|------|----------|
|
|
| 业务报表 | 业务数据报表 | Dashboard + 导出 |
|
|
| 趋势分析 | 数据趋势分析 | Dashboard |
|
|
| 对比分析 | 多维度对比 | Dashboard |
|
|
| 预测分析 | AI预测分析 | Dashboard |
|
|
|
|
---
|
|
|
|
## 6. 功能权限矩阵
|
|
|
|
| 角色 | 商品 | 订单 | 营销 | 财务 | 库存 | B2B | 合规 | 商户 | 系统 |
|
|
|------|------|------|------|------|------|-----|------|------|------|
|
|
| ADMIN | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
|
|
| MANAGER | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ❌ |
|
|
| OPERATOR | ✅ | ✅ | ✅ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ |
|
|
| FINANCE | ❌ | ❌ | ❌ | ✅ | ❌ | ✅ | ❌ | ✅ | ❌ |
|
|
| SOURCING | ✅ | ❌ | ❌ | ❌ | ✅ | ✅ | ❌ | ❌ | ❌ |
|
|
| LOGISTICS | ❌ | ✅ | ❌ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |
|
|
| ANALYST | 👁️ | 👁️ | 👁️ | 👁️ | 👁️ | 👁️ | 👁️ | 👁️ | ❌ |
|
|
|
|
---
|
|
|
|
## 7. 实现路线图
|
|
|
|
### Phase 1: 核心功能 (Week 1-2)
|
|
|
|
- [x] 商品管理闭环
|
|
- [x] 订单管理闭环
|
|
- [x] 财务管理闭环
|
|
- [x] 用户权限管理
|
|
|
|
### Phase 2: 业务扩展 (Week 3-4)
|
|
|
|
- [x] 营销管理闭环
|
|
- [x] 库存管理闭环
|
|
- [x] 物流管理闭环
|
|
- [x] B2B贸易闭环
|
|
|
|
### Phase 3: AI自动化 (Week 5-6)
|
|
|
|
- [x] 自动选品
|
|
- [x] 自动定价
|
|
- [x] 自动上架
|
|
- [x] 智能客服
|
|
|
|
### Phase 4: Agent执行 (Week 7-8)
|
|
|
|
- [ ] Node Agent部署
|
|
- [ ] 平台适配器完善
|
|
- [ ] 任务调度优化
|
|
- [ ] 反检测增强
|
|
|
|
### Phase 5: 后台管理 (Week 9-10)
|
|
|
|
- [x] 审批流程
|
|
- [x] 审计日志
|
|
- [x] 监控告警
|
|
- [x] 数据分析
|
|
|
|
---
|
|
|
|
## 8. 相关文档
|
|
|
|
- [前后端插件闭环架构](./17_Frontend_Backend_Plugin_ClosedLoop.md)
|
|
- [业务闭环总览](../00_Business/Business_ClosedLoops.md)
|
|
- [服务编排总图](./04_Service_Map.md)
|
|
- [Node Agent设计](../04_Plugin/01_NodeAgent_Design.md)
|
|
|
|
---
|
|
|
|
*最后更新: 2026-03-20*
|