Voicebroadcast 是面向金融信息服务、财富管理及客户持仓跟踪场景的 AI 多语种语音报告平台。
客户持仓分散、关注标的不同，人工整理市场资讯、分析持仓并逐一发送报告，需要重复投入时间；统一内容也难以满足不同客户的个性化需求。同时，部分客户更习惯通过语音获取信息，并存在普通话、粤语和英语等不同语言偏好。
项目围绕“客户持仓—报告生成—语音播报—定时送达—访问追踪”构建业务流程，将外部 AI 内容生成、语音服务与企业微信集成。运营人员可以集中管理客户和交付任务，客户可以自助维护持仓及推送时间，通过手机阅读或收听与自身持仓相关的报告。
1. 客户与账户管理：支持后台客户管理、客户邮箱注册、邮箱验证、登录及密码重置；客户可完成企业微信身份绑定，用于接收报告消息。
2. 持仓方案与版本管理：支持系统方案目录、客户方案分配及多个持仓方案管理；支持 CSV、Excel 持仓导入，每次上传生成独立版本，保留历史快照，便于追溯报告输入。
3. AI 报告与多语种语音：对接外部 AI 内容及语音服务，生成持仓相关文字报告，以及普通话、粤语、英语三语音频；后台展示内容生成、音频生成和交付阶段的执行状态。
4. 自动推送策略：每个持仓方案可配置多个执行时间，支持策略启停、有效期、周末及节假日排除；支持手工生成、生成后立即发送及定时自动发送。
5. 客户门户与 H5 报告：客户可维护持仓、管理推送策略和查看历史报告；报告页支持持仓明细、多语种切换、音频播放、播放文本同步高亮及引用来源查看，并适配桌面与移动端。
6. 运营与交付追踪：提供运营总览、报告任务筛选分页、自动执行记录、企业微信交付日志及报告访问记录，支持查看失败原因和跟踪报告访问情况。
我负责项目的全栈研发，涵盖业务流程梳理、数据模型设计、前后端开发、第三方服务集成、测试及部署配置。
前端采用 React、TypeScript、Vite 和 React Router，开发运营后台、客户自助门户和 H5 报告页，完成表单交互、文件上传、任务状态展示、多语种报告阅读、音频与文本同步，以及桌面和移动端适配。后台与客户门户使用独立登录态，分别处理身份认证和页面访问控制。
后端采用Python、FastAPI、SQLAlchemy和PostgreSQL，使用 Alembic管理数据库迁移，并接入Redis 缓存任务数据。围绕客户、持仓方案、持仓版本、推送策略和报告任务组织业务模块，对接外部 AI 内容接口、语音结果回调、阿里云 OSS 音频存储及企业微信消息接口。
主要实现亮点与难点包括：
1. 多方案、多策略业务建模：将系统方案定义、客户持仓方案、不可变持仓版本和推送策略分层管理，支持一个客户多个方案、一个方案多个策略；报告任务绑定具体持仓版本，保证输入可追溯。
2. 多阶段任务协同：创建任务后先落库，由后台执行线程处理内容生成，接收并聚合三语音频结果。通过任务状态、执行阶段和音频进度分别表达处理情况，确保报告正文和三语音频完整就绪后再进入客户交付环节。
3. 定时调度与重复任务控制：实现按业务时区运行的策略扫描，结合有效期、节假日、企业微信绑定和可用持仓判断执行条件；按客户接收对象、策略、业务日期及执行时间进行去重，协调手工执行策略与定时扫描。
4. 报告访问与客户数据隔离：客户接口校验数据归属，分享报告使用独立Token，仅允许访问完整就绪的报告，同时记录访问次数，支持后台反查任务和客户。
5. 工程交付与排障：使用 Docker、GitHub Actions配置测试、生产环境发布流程，通过 pytest 覆盖账户、企微绑定、数据归属等关键业务。
评论