# 中台系统与Goldhorse Ewealth CRM系统集成架构设计

## 🎯 系统集成概述

### 系统架构图
```
┌─────────────────────────────────────────────────────────────────┐
│                    系统集成架构图                                │
├─────────────────────────────────────────────────────────────────┤
│  ┌─────────────────┐    ┌─────────────────┐    ┌──────────────┐ │
│  │ Goldhorse       │    │   中台系统      │    │  外部系统    │ │
│  │ Ewealth CRM     │◄──►│   (PMS)         │◄──►│  (MarketAxess│ │
│  │ (面向客户)       │    │  (内部管理)     │    │   Bloomberg) │ │
│  └─────────────────┘    └─────────────────┘    └──────────────┘ │
└─────────────────────────────────────────────────────────────────┘
```

## 📋 四大核心交互模块

### 1. 开户流程集成 🔐

#### 1.1 数据流向
```
客户提交资料 → Goldhorse CRM → 中台系统 → 审批流程 → 结果回传
```

#### 1.2 集成接口设计
- **接口类型**: RESTful API + WebSocket实时推送
- **数据格式**: JSON
- **认证方式**: OAuth 2.0 + JWT Token
- **传输协议**: HTTPS (TLS 1.3)

#### 1.3 关键数据字段
```json
{
  "customer_id": "CRM_CUST_001",
  "application_type": "INDIVIDUAL",
  "personal_info": {
    "name": "张伟",
    "id_number": "A123456789",
    "phone": "+852-1234-5678",
    "email": "zhangwei@email.com"
  },
  "kyc_documents": [
    {
      "type": "ID_CARD",
      "file_url": "https://storage.example.com/docs/id_card.pdf",
      "upload_time": "2025-01-15T10:30:00Z"
    }
  ],
  "risk_profile": {
    "risk_level": "R3",
    "investment_experience": "INTERMEDIATE",
    "annual_income": 500000
  }
}
```

#### 1.4 审批流程状态同步
- **状态定义**: PENDING → UNDER_REVIEW → APPROVED/REJECTED
- **实时推送**: WebSocket推送状态变更
- **审批记录**: 完整的审批历史记录

### 2. 产品库同步 📦

#### 2.1 产品数据同步机制
```
中台产品上架 → 产品信息推送 → Goldhorse CRM → 客户可见
```

#### 2.2 产品信息结构
```json
{
  "product_id": "BOW465",
  "product_name": "大成港元货币市场基金",
  "product_type": "FUND",
  "risk_level": "R1",
  "basic_info": {
    "issuer": "大成国际资产管理有限公司",
    "currency": "HKD",
    "nav": 1.0000,
    "management_fee": 0.60
  },
  "trading_info": {
    "min_investment": 10000,
    "trading_hours": "09:00-17:00",
    "settlement": "T+1"
  },
  "compliance": {
    "sfc_approved": true,
    "cross_border_eligible": true,
    "suitability_requirements": ["R1", "R2"]
  }
}
```

#### 2.3 同步策略
- **实时同步**: 产品信息变更立即推送
- **批量同步**: 每日凌晨全量同步
- **版本控制**: 产品信息版本管理
- **冲突解决**: 中台系统为权威数据源

### 3. 下单流程风控集成 ⚡

#### 3.1 风控检查流程
```
客户下单 → Goldhorse CRM → 中台风控检查 → 风控结果 → 订单处理
```

#### 3.2 风控检查项目
1. **客户购买力检查**
   - 账户余额验证
   - 信用额度检查
   - 持仓集中度分析

2. **产品适合性检查 (Suitability)**
   - 客户风险等级 vs 产品风险等级
   - 投资经验匹配度
   - 投资目标一致性

3. **价格合理性检查**
   - 市场价格对比
   - 价格偏离度分析
   - 异常价格预警

#### 3.3 风控接口设计
```json
{
  "order_id": "ORD_20250115_001",
  "customer_id": "CRM_CUST_001",
  "product_id": "BOW465",
  "order_details": {
    "quantity": 100000,
    "price": 1.0000,
    "order_type": "MARKET_ORDER"
  },
  "risk_checks": {
    "affordability_check": {
      "required": true,
      "status": "PASSED",
      "available_balance": 500000,
      "required_amount": 100000
    },
    "suitability_check": {
      "required": true,
      "status": "PASSED",
      "customer_risk_level": "R1",
      "product_risk_level": "R1",
      "match": true
    },
    "price_check": {
      "required": true,
      "status": "PASSED",
      "market_price": 1.0000,
      "order_price": 1.0000,
      "deviation": 0.00
    }
  },
  "overall_status": "APPROVED",
  "rejection_reason": null
}
```

### 4. EAM管理集成 👥

#### 4.1 EAM权限管理
```json
{
  "eam_id": "EAM001",
  "eam_name": "华泰资产管理",
  "permissions": {
    "product_access": ["BOND", "FUND", "STRUCTURED"],
    "customer_access": ["VIP", "PREMIUM"],
    "trading_limits": {
      "max_order_size": 1000000,
      "daily_limit": 5000000
    }
  },
  "commission_settings": {
    "bond_commission": 0.25,
    "fund_commission": 0.30,
    "structured_commission": 0.35
  }
}
```

#### 4.2 返佣配置同步
- **实时同步**: EAM返佣设置变更立即生效
- **历史记录**: 返佣配置变更历史
- **权限控制**: 不同EAM的返佣设置权限

## 🔧 技术实现方案

### 1. API网关设计
```
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Goldhorse     │    │   API Gateway   │    │   中台系统      │
│   Ewealth CRM   │◄──►│   (Kong/Nginx)  │◄──►│   (PMS)         │
└─────────────────┘    └─────────────────┘    └─────────────────┘
```

### 2. 数据同步策略
- **实时同步**: 关键业务数据 (订单、风控结果)
- **准实时同步**: 产品信息、客户信息 (5分钟延迟)
- **批量同步**: 历史数据、报表数据 (每日)

### 3. 安全机制
- **API认证**: OAuth 2.0 + JWT
- **数据加密**: AES-256
- **传输安全**: TLS 1.3
- **访问控制**: RBAC权限模型

### 4. 监控与日志
- **API监控**: 响应时间、成功率
- **业务监控**: 订单处理量、风控通过率
- **日志记录**: 完整的操作审计日志
- **告警机制**: 异常情况实时告警

## 📊 数据流程图

### 开户流程
```
客户提交 → CRM验证 → 中台接收 → KYC检查 → 风险评估 → 审批决策 → 结果回传
```

### 产品同步流程
```
产品上架 → 中台审批 → 产品信息推送 → CRM接收 → 客户可见
```

### 下单风控流程
```
客户下单 → CRM提交 → 中台风控 → 检查结果 → 订单处理
```

### EAM管理流程
```
EAM设置 → 中台配置 → 权限同步 → 返佣设置 → CRM生效
```

## 🎯 实施计划

### 阶段一：基础集成 (4周)
- API网关搭建
- 基础数据同步
- 开户流程集成

### 阶段二：业务集成 (6周)
- 产品库同步
- 下单风控集成
- EAM管理集成

### 阶段三：优化完善 (4周)
- 性能优化
- 监控完善
- 安全加固

## 📈 预期效果

1. **效率提升**: 自动化流程减少人工操作
2. **风险控制**: 统一风控标准，降低业务风险
3. **数据一致性**: 实时同步确保数据准确性
4. **用户体验**: 无缝的系统切换体验
5. **管理效率**: 统一的管理界面和权限控制

---

*本设计方案涵盖了中台系统与Goldhorse Ewealth CRM系统的完整集成方案，确保两个系统之间的高效、安全、可靠的数据交互。*