项目计划书 · Statement of Work · v1.0
惠理风险报告
自动化生成平台
Value Partners Group — Risk Reporting Automation Platform
查看在线 DEMO
↗
Demo · 平台演示视频
惠理风险报告自动化平台 — 功能演示
点击播放，了解平台报告生成、飞书集成与分发全流程
▶
01 · 项目概述
Project Overview
10+
风险报告种类
3
报告频率（周/月/年）
4
外部数据源
100%
飞书生态集成
本平台旨在为惠理集团（Value Partners Group）提供端到端的风险报告自动化能力，覆盖数据采集（VIPER、VPFS、Bloomberg、Morningstar）、数据清洗与 ETL 转换、报告生成与分发的全流程。平台深度集成飞书开放生态，支持报告在飞书内的查看、审批与推送，并提供完整的运维文档与交接包，确保 BAU（Business-as-Usual）平稳接手。
02 · 技术架构
Technical Architecture
Frontend
Vue 3 + Vite
页面框架 + 路由（Vue Router）
页面框架 + 路由（Vue Router）
Apache ECharts + ECharts-GL
图表可视化引擎
图表可视化引擎
html2canvas + jsPDF
图表型 PDF 导出
图表型 PDF 导出
Jinja2 模板
文字型 PDF（后端渲染）
文字型 PDF（后端渲染）
Backend
Python + FastAPI
高性能异步 API 框架
高性能异步 API 框架
Pandas + Openpyxl
数据解析与科学计算
数据解析与科学计算
APScheduler
任务调度中心
任务调度中心
lark_oapi（飞书官方 SDK）
飞书开放生态集成
飞书开放生态集成
安全认证模块
账号密码 / SSO / 第三方授权
账号密码 / SSO / 第三方授权
Middleware & Infra
MySQL 8
关系型数据库
关系型数据库
Nginx（开启压缩）
反向代理 + 网关
反向代理 + 网关
Redis
缓存层
缓存层
Gunicorn + Uvicorn Worker
进程管理，4–6 并发 Worker
进程管理，4–6 并发 Worker
服务器配置 · Server Spec
OS：Ubuntu 22.04 LTS
CPU：4 核
内存：8 GB RAM
存储：SSD（推荐）
并发：4–6 Uvicorn Worker
CPU：4 核
内存：8 GB RAM
存储：SSD（推荐）
并发：4–6 Uvicorn Worker
数据源集成 · Data Sources
VIPER（内部基金数据）
VPFS（财务系统）
Bloomberg（市场数据）
Morningstar（基金评级/表现）
Factset / Aladdin（扩展）
VPFS（财务系统）
Bloomberg（市场数据）
Morningstar（基金评级/表现）
Factset / Aladdin（扩展）
03 · 报告范围
Report Scope
| 编号 | 频率 | 报告名称 | 产物格式 | 主要依赖 | 时效 (BD) |
|---|---|---|---|---|---|
| #1 | 每周 | 基金绩效报告（领导委员会 LC） | Excel + 打印件 | Morningstar / VIPER | 每周五下午 |
| #2 | 每月 | 月度投资表现与风险汇报（PPT） | PowerPoint | 2a · 2b · 2c · 2d · 2e | T + 12 |
| #2a | 每月 | 月度绩效报告（基金 + 集团层面） | Excel | Morningstar / AUM | T + 8 |
| #2b | 每月 | 月度风险报告（标准差 / 跟踪误差） | Excel | Morningstar | T + 8 |
| #2c | 每月 | 月度流动性风险报告 | Excel | SOP / VIPER | T + 8 |
| #2d | 临时 | 交易对手风险报告（负面新闻触发） | Excel | Bloomberg | Ad-hoc |
| #2e | 每月 | 资产集中度风险报告（Top 10 持仓） | Excel | VIPER Holdings | T + 8 |
| #3 | 每月 | VPJR 风险监控报告 | Excel / Aladdin | Daiwa / Sales Team | T + 5 |
| #19 | 每年 | 年度交易对手信用风险监控（经纪商） | Excel | Bloomberg / Middle Office | 每年 2 月 |
04 · 开发计划
Development Timeline
Phase 01
认证 & 基础模块
2 – 4 BD
- 安全认证开发：账号密码登录（2 BD）；若接入 SSO / 第三方 OAuth，额外 +2 BD
- 用户管理：角色权限配置，收件人名单版本控制
- 报告管理中心：报告列表、状态追踪、手动触发入口
- 基础 CI/CD：GitHub / Azure DevOps 仓库配置，Nginx 网关部署
Phase 02
报告开发
72 BD
- 每张报告 × 8 BD，共 9 张报告
- 报告模板开发（2 BD）：UI/UX 布局、品牌规范、可视化图表
- 源数据接入（2 BD）：直接上传 / 飞书文件读取 / 系统自动转存飞书，解析入库
- 计算逻辑 & 入库（2 BD）：Python 转换规则、数据质量预检（Pre-Check）
- 报告产物（1 BD）：展示页 / PDF 下载 / 打印 / 自动邮件分发
- 飞书集成（1 BD）：飞书机器人推送 + 数据库更新
Phase 03
单报告测试
9 BD
- 每张报告 × 1 BD 功能测试 + 数据校验
- 业务方（VP Risk & Performance）参与 UAT 确认
- 边界条件测试：节假日、零值价格、汇率缺失、延迟数据等
Phase 04
集成测试
5 BD
- 全流程端到端测试（数据摄入 → 计算 → 分发）
- APScheduler 定时触发验证（周度 / 月度 / 年度任务）
- 故障演练：Pre-Check 失败重试（每 15 分钟，最长 2 小时）、降级报告输出
- 性能压测：4–6 Uvicorn Worker 并发生成场景
Phase 05
文档 & 交接
3 – 5 BD
- 技术运维手册（Technical Runbook）PDF + Markdown
- 数据字典 & 数据血缘文档
- 飞书知识库同步：每张报告的 SOP 页面
- 两次线上 KT（Knowledge Transfer）录像，每次 90 分钟
- 生产上线检查清单（D14 Transition Checklist）
TOTAL ESTIMATED DURATION
不含项目启动 & 需求确认阶段
≈ 91 – 95 BD
约 4.5 个自然月
05 · 核心交付物
Key Deliverables
D1 · Data Pipeline
ETL 代码库
所有转换任务的 Python/SQL 代码，含注释与单元测试
GitHub / Azure DevOps
D2 · Architecture
数据架构设计图
Bronze / Silver / Gold 三层数据流可视化图及字段规范
Visio / Lucidchart + Doc
D5 · Wireframes
报告线框图
全部报告的低保真原型，业务方签字确认
PowerPoint / Figma
D6 · Reports
报告代码 & 配置
生产环境 Power BI / HTML 报告，调度配置已完成
已部署至生产环境
D9 · Runbook
技术运维手册
分步操作流程、故障排查、上下班交接流程
PDF + Markdown
D12 · UAT
UAT 测试报告
记录测试结果、差异分析，包含 VP 团队签字
PDF + 附件
D13 · KT
知识转移录像
两场 90 分钟深度录像（架构、运营、故障处理）
MP4 + 飞书文档
D15 · Support
上线后支持计划
1 个月质保期，含升级联系方式与应急处置流程
PDF
06 · 按需付费
On-Demand Pricing
项目交付后，如有持续优化或新增需求，按以下标准计费。
Tier 1
2.5 BD
现有报告更新 / 优化
对已交付报告进行数据逻辑调整、样式修改、字段新增或分发规则变更等维护性工作。
- 计算逻辑小幅调整
- 收件人名单 / 分发规则变更
- 图表样式 / 字段展示优化
Tier 2
5 BD
新增标准报告
新增结构清晰、数据源已接入的报告，例如新基金 Factsheet、标准绩效一览表等。
- 数据源已存在于系统内
- 布局与现有模板一致
- 含基础 UAT 验收
Tier 3
10 BD
新增复杂报告
涉及新数据源接入、复杂计算逻辑或全新页面布局的报告开发，需完整需求确认与测试流程。
- 新数据源 ETL 接入
- 复杂计算 / 跨报告依赖
- 完整 UAT + 文档更新
NOTE
BD = 工作日（Business Day）。以上为单项报告工作量估算，实际报价以需求确认后为准。紧急需求（交付时间压缩至 50% 以内）附加 50% 费率。