# Goldhorse Ewealth Management System

专业的财富管理平台，为EAM（External Asset Manager）机构提供全方位的客户管理、开户、交易和报告服务。

## 系统概述

Goldhorse Ewealth Management是一个面向EAM机构的财富管理系统，帮助EAM机构管理其客户在Goldhorse（券商）的账户。系统符合香港证券及期货事务监察委员会（SFC）的监管要求。

## 核心功能

### 1. 客户管理
- **多视角查看**：支持Goldhorse视角和EAM视角查看客户持仓分布
- **权限分级**：
  - Admin：可查看全体RM下的客户
  - Team Leader：可查看其团队RM下的客户
  - RM：可查看自己的客户
  - Assistant：可由RM设置其查看权限
- **客户详情**：查看客户完整资产状况、持仓分析、风险评级等

### 2. 开户管理
- **多种客户类型**：
  - 个人客户
  - 香港公司
  - 海外公司
  - 信托机构
- **创新开户流程**（金马证券APP协同）：
  - **EAM预填资料**：EAM先为客户填写开户表格和上传证明文件
  - **PI专业投资者认证**：符合SFC规定的PI资格要求（资产≥HKD 8,000,000）
  - **双重签署机制**：
    - 客户文件（7份）：由客户通过金马证券APP签署
    - 三方协议（4份）：EAM先签署并2FA认证，再由客户APP签署
  - **APP无缝对接**：
    - EAM填写完成后生成专属链接
    - 资料自动传送至金马证券APP
    - 客户下载APP后可查看EAM已填内容
    - 客户完成电子签名后提交申请
  - **全程数字化**：电子签名、2FA认证、时间戳记录
  - **符合香港SFC要求**

### 3. 出入金管理
- **入金管理**：
  - EAM通过系统上传入金凭证
  - 上传银行凭证（如需要）
  - 系统记录入金时间和金额
  - 支持多币种入金
  - 实时更新客户账户余额
  
- **出金管理**：
  - EAM通过系统发出出金指令
  - 只能出金到已登记并经Goldhorse审批的银行账户
  - **海外私人银行智能支持** 🆕：
    - 自动识别私人银行账户类型
    - 自动显示Reference Number
    - 智能生成付款附言（符合各银行格式）
    - 显示最低入金金额要求
    - 费用自动估算（含中转行费用）
    - 特殊要求提示
  - 支持选择出金原因和备注
  - 出金需要二次确认
  - 完整的审批流程跟踪
  - 预计到账时间显示
  
- **银行账户管理**：
  - 支持3种银行类型（本地零售银行/海外私人银行/商业银行）
  - **海外私人银行特殊支持** 🆕：
    - 支持LGT、Julius Baer、UBS Private等主流私人银行
    - Reference Number管理
    - 中转行信息配置
    - Payment Instructions验证
    - 客户经理信息记录
    - 特殊入金指示说明
  - EAM可为客户添加银行账户
  - 添加时需上传银行证明文件
  - Goldhorse审批后方可使用
  - 支持多个银行账户管理
  - 显示账户审批状态（待审批/已审批/已拒绝）
  - 安全保障：只有已审批账户可用于出金

### 4. 产品超市 🆕
**产品浏览与展示平台**：
- ✅ 独立左侧导航模块
- ✅ 6大产品类别全覆盖
- ✅ 超市式产品浏览体验
- ✅ 与交易系统无缝集成

**产品类别**：
- **股票产品**：港股美股热力图、波动率分析、市场参考 🆕
  - 实时股票热力图（港股20只、美股20只热门股票）
  - 波动率分析（今日/昨日/周平均对比）
- **债券产品**：专业债券列表、多维度筛选、AI分析引擎 🆕
  - 专业表格展示（Bondsupermart风格）
  - 多维度筛选（YTM、期限、评级、流动性等）
  - 简化AI分析引擎
  - 直接交易功能
- **基金产品**：专业基金展示、多维度筛选、市场概览 🆕
  - 专业基金列表展示
  - 多维度筛选（基金公司、风险等级、收益率、管理费等）
  - 市场概览统计
  - 基金分类标签
- **结构化产品**：多种产品类型、收益分析、风险评级 🆕
  - 股票挂钩、商品挂钩、利率挂钩、外汇挂钩、混合型产品
  - 收益分析和风险评级
  - 保本比例显示
  - 产品特征标签
- **OTC产品**：场外交易产品、定制化投资解决方案 🆕
  - 衍生品、商品、信贷、货币、股权产品
  - 风险等级标识（低/中/高风险）
  - 交易对手方信息
  - 流动性评级
- **外汇产品**：全球外汇交易、24/7实时报价 🆕
  - 主要、次要、新兴、交叉货币对
  - 实时点差显示
  - 24/7交易时间
  - 货币对分类标签
  - 市场对比分析（港股vs美股指数对比）
  - 智能交易工具（选股器、风险计算器、技术分析）
  - 实时市场要闻和新闻追踪
- **债券产品**：专业化表格展示、简化筛选、Bondsupermart风格 🆕
  - 专业债券列表表格（YTM、价格、久期、评级、流动性）
  - 紧凑筛选器（快速筛选+专业条件）
  - 债券比较工具（最多3个债券对比）
  - 实时市场概览（US 10Y收益率、信用利差、市场状态）
  - 分页导航和排序功能
- **基金产品**：专业基金展示平台、丰富筛选条件 🆕
  - 专业基金列表（净值、收益、风险、评级、管理费）
  - 多维度筛选（基金公司、风险等级、收益范围、管理费、规模、地区、货币、评级）
  - 基金分类标签（ETF、共同基金、股票型、债券型、平衡型、货币型）
  - 实时市场概览（可投资基金数量、管理资产总额、合作基金公司、平均年化收益）
  - 基金公司logo和详细信息展示
- **债券产品**：专业债券产品展示（参考Bondsupermart设计）
- **基金产品**：多样化基金产品展示
- **结构性产品**：复杂结构产品展示
- **OTC产品**：场外交易产品展示
- **外汇产品**：外汇交易产品展示

### 5. 交易下单
**统一交易平台设计** 🆕：
- ✅ 所有交易默认在Goldhorse执行
- ✅ 无需手动选择托管账户
- ✅ 选择客户即确定交易主体
- ✅ 简化操作流程

**支持6种产品类型**：

1. **股票（Equity）**
   - 公开市场价格
   - 4种订单类型（市价/限价/止损/止盈）
   - 即时下单

2. **债券（Fixed Income）** ⭐
   - **MarketAxess API集成**
   - **设计参考**：基于 `D:\新建文件夹\bond` 目录中的图片内容
     - Bondsupermart专业债券平台界面风格
     - EasyView系统用户体验设计
     - 整合MarketAxess API实时数据展示
   - 询价 → 报价 → 确认 → 下单（3节点流程）
   - 做市商报价模式
   - 报价有效期15分钟
   - 支持多个做市商报价比较

3. **基金（Funds）**
   - 申购/赎回
   - 5种基金类型
   - 净值交易

4. **结构性票据（Structured Notes）** ⭐⭐
   - 13种产品类型（FCN/Step-down FCN/BEN/AQ/DQ等）
   - PI/Non-PI客户分类
   - Terms构建器
   - Solve For机制
   - 复杂参数配置

5. **OTC场外交易**
   - 仅限PI客户
   - Accumulator/Decumulator
   - 衍生品交易
   - 高风险产品

6. **外汇（FX）**
   - 实时汇率
   - 即时成交
   - 8种主要货币

### 5. 费用报告（全新升级 v3.0）
- **基于角色的多层级统计**：
  - Admin视角：按EAM机构统计（可见）
  - Team Leader视角：按团队统计（可见）
  - RM视角：按个人统计（可见）
  - RM助理：完全无法访问（权限限制）
  
- **三种费用类型**：
  - 管理费（Management Fee）：基于AUM收取
  - 表现费（Performance Fee）：基于超额收益收取
  - 前端费用（Front-end Fee）：交易佣金和手续费
  
- **两层费用分配系统**：
  - **第一层**：Goldhorse → EAM（由Goldhorse设定，默认70%）
  - **第二层**：EAM → RM（由EAM设定，默认80%）
  - **最终分配**：RM获得56%（70% × 80%），EAM保留14%，Goldhorse保留30%
  
- **可视化费用分配流程**：
  - 清晰的流程图展示费用流向
  - 实时计算预览分配结果
  - 多维度费用趋势图表

- **灵活的设置系统**：
  - Goldhorse可按EAM单独设置分配比例
  - EAM可按RM单独设置分配比例
  - 可按费用类型分别设置（管理费、表现费、前端费用）
  - 支持统一比例或差异化设置

### 6. 设置管理
- **费用分配设置**：
  - Goldhorse设置各EAM的费用分配比例
  - EAM设置各RM的费用分配比例
  - 支持按费用类型单独配置
- **单笔调整功能**：支持针对特定交易调整返佣
- **RM权限设置**：设置RM和RM助理的查看权限和可见性

## 技术架构

### 前端技术栈
- **HTML5**：现代化的语义化标签
- **Tailwind CSS & 自定义CSS**：美观的响应式设计
- **Font Awesome 6.4.0**：丰富的图标库
- **Chart.js**：数据可视化图表
- **原生JavaScript**：轻量级交互逻辑

### 设计特点
- **响应式设计**：支持桌面和移动设备
- **现代化UI**：采用卡片式布局和渐变色设计
- **直观导航**：清晰的侧边栏导航和面包屑导航
- **用户友好**：符合UX最佳实践

## 文件结构

```
Goldhorse-Ewealth-Management/
│
├── assets/
│   ├── css/
│   │   └── common.css              # 共享样式文件
│   └── js/
│       └── common.js               # 共享JavaScript函数
│
├── login.html                      # 登录页面
├── dashboard.html                  # 主仪表盘
│
├── clients.html                    # 客户列表
├── client-detail.html              # 客户详情
│
├── onboarding.html                 # 开户管理列表
├── onboarding-individual.html      # 个人开户表单
├── onboarding-hk-company.html      # 香港公司开户
├── onboarding-overseas-company.html # 海外公司开户
├── onboarding-trust.html           # 信托机构开户
│
├── deposits-withdrawals.html       # 出入金管理
├── bank-accounts.html              # 银行账户管理
│
├── trading-stocks.html             # 股票交易（无需选托管账户）
├── trading-bonds.html              # 债券交易（MarketAxess API）
├── trading-funds.html              # 基金交易
├── trading-notes.html              # 结构性票据（13种产品）
├── trading-otc.html                # OTC交易（PI only）
├── trading-fx.html                 # FX交易
│
├── orders.html                     # 订单管理
│
├── fee-report.html                 # 费用报告
│
├── settings.html                   # 系统设置
│
└── README.md                       # 项目说明文档
```

## 快速开始

### 1. 部署方式

#### 方式一：直接打开HTML文件
1. 下载所有项目文件
2. 保持文件结构不变
3. 双击 `login.html` 在浏览器中打开

#### 方式二：使用本地服务器（推荐）
```bash
# 使用Python启动简单HTTP服务器
python -m http.server 8000

# 或使用Node.js的http-server
npx http-server -p 8000
```

然后在浏览器访问：`http://localhost:8000/login.html`

### 2. 登录系统

#### 测试账号
- **用户名**：admin
- **密码**：任意密码（演示版本）
- **角色**：可选择Goldhorse或EAM视角

### 3. 功能演示流程

1. **登录** → 选择角色（Goldhorse/EAM）→ 输入凭证
2. **仪表盘** → 查看总览数据、资产分布、客户统计
3. **客户管理** → 浏览客户列表 → 点击查看客户详情
4. **开户管理**（完整流程）：
   - EAM填写客户个人资料
   - 上传证明文件（包括PI财务证明）
   - 填写7份客户签署文件
   - EAM签署4份三方协议并完成2FA认证
   - 生成客户开户链接发送至客户
   - 客户下载金马证券APP登录
   - 客户查看并签署所有文件
   - 提交完整申请等待审核
5. **出入金管理**：
   - 添加客户银行账户 → 上传银行证明 → 等待Goldhorse审批
   - 入金：上传入金凭证和银行凭证
   - 出金：选择已审批的银行账户 → 填写出金指令 → 提交审批
6. **交易下单**：
   - 股票：选择客户 → 输入代码 → 填写数量 → 提交至Goldhorse
   - 债券：提交RFQ至MarketAxess → 等待报价 → 确认下单
   - 结构性票据：选择产品类型 → 构建Terms → 提交询价
7. **费用报告** → 查看返佣和管理费报告
8. **设置** → 配置返佣比例、权限、RM设置等

## 主要页面说明

### 登录页面（login.html）
- 现代化的双栏布局设计
- 支持Goldhorse和EAM两种角色登录
- 2FA双重身份验证提示
- 记住登录状态功能

### 仪表盘（dashboard.html）
- 多视角切换（我的视角/团队视角/Goldhorse视角）
- 关键指标展示（总资产、负债、净资产、客户数量）
- 资产变动趋势图表
- 客户分配和托管分配统计
- 重要提醒（风险评级到期、客户生日等）

### 客户管理（clients.html & client-detail.html）
- 客户列表筛选和搜索
- 多维度数据展示（净资产、总资产、负债、RM等）
- 客户详情页展示完整持仓信息
- 多标签页管理（Profile、资产分析、风险分析、到期管理、交易记录、合规、文档、RM团队）
- **交易记录管理** 🆕：
  - 客户历史交易记录完整展示
  - 交易统计概览（总交易次数、金额、平均交易额、成功率）
  - 多维度筛选（产品类型、时间范围、交易状态、方向、金额范围）
  - 交易详情查看、导出、刷新功能

### 开户管理（onboarding.html & onboarding-*.html）
- 开户申请列表和状态跟踪
- **开户节点可视化**：每个客户显示当前所在节点和6步进度条
- 创新的双重签署流程（EAM + 客户）
- **个人客户开户完整流程**：
  - 6步进度跟踪（EAM填写 → 文件准备 → EAM签署 → 生成链接 → 客户APP签署 → 审核）
  - 7份客户签署文件管理
  - 4份三方协议文件（EAM+客户共同签署）
  - PI专业投资者认证（包含财务证明上传）
  - 电子签名和2FA认证功能
  - 金马证券APP对接说明
- 不同客户类型的专属表单
- 完整的文件上传和管理系统

### 出入金管理（deposits-withdrawals.html & bank-accounts.html）
- **入金功能**：
  - 上传入金凭证（转账截图/银行回单）
  - 上传银行凭证（如月结单等补充文件）
  - 记录入金日期和金额
  - 支持多币种
- **出金功能**：
  - 发出出金指令
  - 只能出金到已审批的登记银行账户
  - 填写出金原因和备注
  - 二次确认和审批流程
- **银行账户管理**：
  - EAM为客户添加银行账户
  - 上传银行证明文件（存折/月结单/开户证明）
  - Goldhorse审批流程
  - 显示审批状态和拒绝原因
  - 只有已审批账户可用于出金操作

### 交易下单（trading-*.html）
- **统一设计**：所有交易默认在Goldhorse执行，无需选托管账户
- **债券交易（MarketAxess）** ⭐：
  - 3节点流程：提交RFQ → 等待报价 → 确认下单
  - MarketAxess API实时对接
  - 多做市商报价比较
  - 报价有效期管理
  - 收益率计算
- **结构性票据** ⭐：
  - 13种产品类型支持
  - PI/Non-PI客户分类
  - Terms动态构建器
  - Solve For智能求解
  - 复杂参数配置
- **股票交易**：实时行情、自选股、快速下单
- **基金交易**：申购/赎回、5种基金类型
- **OTC交易**：PI客户专属、高风险衍生品
- **FX交易**：实时汇率、8种货币

### 费用报告（fee-report.html）v3.0 全新升级
- **三种角色视角**：
  - Admin视角：EAM机构统计
  - Team Leader视角：团队统计  
  - RM视角：个人统计
  - RM助理：无权访问
  
- **三种费用类型**：
  - 管理费：基于AUM收取
  - 表现费：基于超额收益
  - 前端费用：交易佣金
  
- **两层分配系统**：
  - Goldhorse → EAM（默认70%）
  - EAM → RM（默认80%）
  - 完整分配流程可视化
  
- **费用设置功能**：
  - Goldhorse设置给EAM的比例
  - EAM设置给RM的比例
  - 可按费用类型单独设置
  - 实时预览分配结果
  
- **可视化图表**：
  - 堆叠柱状图展示费用趋势
  - 分配流程图
  - 费用占比分析
  
- **导出功能**：
  - CSV导出
  - PDF详细报告

### 设置（settings.html）
- 返佣比例设置和单笔调整
- 权限管理（Admin、Team Leader、RM、Assistant）
- RM返佣设置
- 通知设置
- 系统偏好设置

## 权限体系

### 角色权限说明

| 角色 | 查看范围 | 主要权限 |
|------|---------|---------|
| **Admin** | 全部客户 | 所有功能完全访问 |
| **Team Leader** | 团队客户 | 管理团队RM和客户 |
| **RM** | 个人客户 | 管理自己的客户和交易 |
| **Assistant** | 根据设置 | 由RM授权的查看权限 |

## 数据安全

- 客户端数据验证
- 表单输入验证
- 文件类型和大小限制
- 2FA双重身份验证
- 会话管理和超时控制
- 符合SFC监管要求

## 浏览器兼容性

- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+

## 响应式设计

系统支持以下屏幕尺寸：
- 桌面端：1920px, 1440px, 1280px
- 平板：768px, 1024px
- 移动端：320px - 767px

## 自定义和扩展

### 修改主题颜色
在 `assets/css/common.css` 中修改CSS变量：
```css
:root {
    --primary-color: #4A90E2;
    --secondary-color: #5CB3FF;
    --success-color: #28A745;
    /* ... 其他颜色变量 */
}
```

### 添加新功能
1. 创建新的HTML页面
2. 在侧边栏菜单中添加链接
3. 使用共享的CSS和JS资源
4. 遵循现有的设计模式

## 开发路线图

### 即将推出的功能
- [ ] 实时WebSocket推送
- [ ] 高级图表分析工具
- [ ] 移动端专用APP
- [ ] 多语言支持
- [ ] PDF报告生成
- [ ] API接口文档

### 未来增强
- [ ] 人工智能投资建议
- [ ] 自动化合规检查
- [ ] 区块链交易记录
- [ ] 社交化投资社区

## 技术支持

如有问题或建议，请联系：
- Email: support@goldhorse.com
- Phone: +852 1234 5678
- Website: www.goldhorse.com

## 许可证

本项目为Goldhorse Ewealth Management私有系统，版权所有。

## 版本历史

### v1.4.0 (2025-10-12) - 客户管理与费用报告全面升级
- ✅ **客户管理优化** 🆕：
  - 移除多托管机构模式，统一托管在Goldhorse
  - 新增详细资产分析（收益率、夏普比率、最大回撤）
  - 新增风险分析（集中度、流动性、市场风险、信用风险）
  - 新增到期管理功能（产品到期提醒）
  - 新增RM团队管理（主理RM和RM助理配置）
  - 新增权限矩阵（Admin、Team Leader、RM、Assistant）
  - 新增客户历史交易记录管理 🆕
  
- ✅ **RM日历系统** 🆕⭐：
  - 产品到期事件自动同步到RM日历
  - 月历视图、列表视图、时间轴视图
  - 智能提醒（到期前3天、1天）
  - RM和RM助理同步接收通知
  - 事件管理（新增、编辑、完成、导出）
  
- ✅ **费用报告v3.0** 🆕⭐⭐：
  - 基于角色的多层级统计（Admin/Team Leader/RM）
  - RM助理完全无法访问
  - 三种费用类型（管理费、表现费、前端费用）
  - 两层费用分配系统（Goldhorse→EAM→RM）
  - 可视化费用分配流程图
  - 灵活的费用比例设置
  - 实时预览分配结果
  
- ✅ **债券交易Bondsupermart风格** 🆕：
  - 参考专业债券平台Bondsupermart设计
  - 强大的债券搜索和筛选功能
  - 清晰的买入/卖出价格展示
  - 专业债券计算器（YTM、久期、凸度）
  - 一键快速下单 + RFQ询价两种方式
  - 颜色编码的信用评级系统
  - 交易节点处理：部分成交选项、价格变化提醒、成交状态管理 🆕
  
- ✅ **债券智能交易系统v2.5** 🆕⭐⭐⭐：
  - 实时市场概览（US 10Y/EUR 10Y/市场状态）
  - AI智能建议（交易规模/流动性/时段）
  - 自动Pre-trade合规检查（6项检查<1秒）
  - 智能做市商路由（自动选择7家最优）
  - 实时询价监控（7家做市商响应进度）
  - 最优报价自动高亮（节省金额计算）
  - 一键最优执行（<5秒成交）
  - 5步骤执行进度可视化
  - WebSocket实时推送
  - 最佳执行分析报告
  - **MarketAxess API完整对接方案** 🆕🆕
    * FIX/REST/WebSocket多协议支持
    * 实时市场数据（报价/流动性/分析）
    * 完整RFQ流程（8步骤自动化）
    * OAuth 2.0安全认证
    * 符合SFC/MiFID II合规要求
    * UAT/生产环境配置
    * 小程序界面设计方案

### v1.3.0 (2025-10-12) - 交易系统全面升级
- ✅ **统一交易平台设计** 🆕：
  - 所有交易默认在Goldhorse执行
  - 移除托管账户选择
  - 简化操作流程
  - 提高交易效率
- ✅ **债券交易MarketAxess集成** ⭐：
  - MarketAxess API实时对接
  - 3节点询价流程（RFQ → 报价 → 下单）
  - 多做市商报价比较
  - 报价有效期自动管理
  - 实时收益率计算
- ✅ **结构性票据完整系统** ⭐⭐：
  - 13种产品类型（FCN/Step-down FCN/Sharkfin/BEN/DCN/ELN/WRA/Phoenix/AQ/DQ/VAN等）
  - PI/Non-PI客户分类
  - Terms动态构建器
  - Solve For智能求解（Strike↔Coupon）
  - 复杂参数配置（KO/KI/Barrier等）
  - 组合生成功能
- ✅ **OTC场外交易**：
  - PI客户专属
  - Accumulator/Decumulator
  - 各类衍生品支持
- ✅ **完整产品覆盖**：
  - 股票、债券、基金、结构性票据、OTC、FX全覆盖

### v1.2.0 (2025-10-12) - 出入金管理与海外私人银行支持
- ✅ **出入金管理系统**：
  - 入金：上传入金凭证和银行凭证
  - 出金：发出出金指令到已审批银行账户
  - 支持多币种（USD, HKD, CNY, EUR等）
  - 完整的审批流程和状态跟踪
- ✅ **银行账户管理**：
  - 3种银行类型（本地/海外私人银行/商业）
  - EAM为客户添加银行账户
  - 上传银行证明文件验证
  - Goldhorse审批机制
  - 审批状态实时显示
  - 安全保障：只有已审批账户可出金
- ✅ **海外私人银行专项支持** 🆕：
  - 支持LGT、Julius Baer、UBS Private等10+家私人银行
  - Reference Number智能管理
  - 付款附言自动生成（符合各银行格式）
  - 中转行信息配置
  - 最低入金金额提示
  - 特殊入金指示说明
  - 客户经理信息记录
  - 费用自动计算（含中转行）
  - Payment Instructions验证
- ✅ **开户节点可视化**：
  - 6个节点清晰显示
  - 彩色进度条和百分比
  - 节点分布统计图
  - 实时状态更新

### v1.1.0 (2025-10-12) - 开户流程重大升级
- ✅ **创新双重签署流程**：EAM预填 + 客户APP签署
- ✅ **PI专业投资者认证**：完整的SFC合规流程
- ✅ **7份客户签署文件**：
  1. 證券帳戶開戶表格
  2. 客戶風險披露聲明同意書
  3. W-8BEN (Individual)
  4. 客戶投資風險取向問卷
  5. 衍生產品認識評估問卷
  6. 專業投資者申請表格（PI證明）
  7. 虛擬資產知識評估問卷
- ✅ **4份三方協議文件**：
  1. Tripartite Agreement
  2. Letter of Authorization and Indemnity
  3. Letter of Consent
  4. Declaration - DMA
- ✅ **金马证券APP对接**：无缝资料传输和客户签署
- ✅ **电子签名与2FA认证**：全程数字化合规
- ✅ **6步清晰流程**：进度可视化跟踪

### v1.0.0 (2025-10-12)
- ✅ 完成核心功能开发
- ✅ 客户管理系统
- ✅ 开户管理流程
- ✅ 交易下单功能
- ✅ 费用报告系统
- ✅ 设置和权限管理
- ✅ 响应式设计
- ✅ 高保真UI设计

## 致谢

感谢所有参与项目开发和测试的团队成员。

---

**Goldhorse Ewealth Management** - 专业、安全、高效的财富管理平台