yuxuanhui
3cd280d068
- Created a global CSS file for styling the frontend with responsive design. - Introduced TypeScript types for various entities including Research, Alpha, and Account. - Implemented Playwright tests for account management and data synchronization workflows. - Configured TypeScript with strict settings and included necessary libraries. - Set up Vite as the build tool with React plugin and API proxy configuration. - Added a Python script to initialize environment variables securely.
5.0 KiB
WorldQuant Alpha 研究系统
确认日期：2026-09-07。项目位于 wq-alpha-system，面向个人单个 WorldQuant 账户。
已确认范围
- 首期：个人信息与会话、Alpha 列表与详情、本地研究记录、可靠同步、Docker 部署。
- Python + React + TypeScript + Semi Design，前后端分别位于 backend/ 和 frontend/，独立依赖与测试。
- PostgreSQL 存储数据，FastAPI 提供 OpenAPI 契约，HTTPX 统一异步调用 WorldQuant。
- React 19 使用 @douyinfe/semi-ui-19。Caddy 提供静态资源、API 代理与公网 HTTPS。
- 根目录包含两套完整 Compose、Dockerfile、Caddyfile、环境模板和部署说明。
- 从 WorldQuant 重新建立数据，不迁移旧库，不承担旧系统的兼容或维护。
- 平台数据只读；不回测、不触发检查、不修改平台属性、不正式提交。
首期产品能力
个人信息
系统登录与平台连接分开。单管理员，无开放注册；部署时设置初始密码，服务端哈希保存，HttpOnly Cookie 管理会话。 在个人页配置平台邮箱及密码，连接、重新连接、人工验证、断开与刷新资料。 平台凭据加密存储，解密密钥独立配置，不在前端持久化，也不进入日志或响应。 展示平台 ID、昵称、邮箱、身份与权限（以返回字段为准）、连接状态、最后同步时间。 提供本地显示名称、主题、时区和分页偏好，默认中文、浅色、Asia/Shanghai、25 条/页。 缺失资料显示“未提供”，不得虚构数据。
Alpha 管理
- 主界面为侧栏、筛选区、可排序分页表格、列显隐、多选、详情抽屉；任务进度在独立面板查看。
- 全量同步已提交/未提交、隐藏/可见 Alpha；指定 ID 导入及选中刷新；仅手动触发。
- 筛选 ID/名称/表达式、地区、Universe、类型、语言、平台状态、隐藏、日期、核心指标、本地标签/状态/收藏。
- 展示 REGULAR/SUPER、FASTEXPR/PYTHON、Selection/Combo、完整 settings、IS/OS、已有 checks。
- PnL 按需获取、缓存、曲线展示、刷新；可打开 BRAIN 原页面。
- 本地备注、标签、收藏与研究状态单独保存，同步不能覆盖。研究状态：inbox/candidate/optimizing/archived。
- 批量加减标签及改研究状态；CSV 按当前筛选与排序导出全部结果，不限制为 500 条。
- 指标缺失保留 null，不伪装成零；本地研究状态与平台状态、检查结果分开。
模块与接口
模块为账户、Alpha、同步任务、WorldQuant 集成。所有上游认证、会话、分页和退避集中封装。
页面读取本地数据库。/api/v1/auth 管理登录，/account 管理配置与资料，/alphas 管理查询及研究记录，/alphas/{id}/pnl 读取缓存，/sync-jobs 创建、查询、取消和重试任务。
长任务返回 job ID；前端轮询。首期单后端进程运行异步任务，任务及分页检查点持久化。
每页原子落库、按 Alpha ID 更新、失败重试及重启恢复；429 遵守 Retry-After，其余暂时性错误有界退避。
原始业务响应与结构化摘要分别保存，不存认证敏感字段。上游数据移动可能影响 offset 分页，通过 ID 去重及再次全量同步校正，不因一次未查到就删除本地记录。
路线图
| 阶段 | 能力 | 依据 |
|---|---|---|
| 一 | 账户、列表、研究记录、同步、部署 | 本文件首期范围 |
| 二 | 数据集/字段/算子、模板、批次队列、AST 校验、实验去重、暂停恢复 | 旧系统采样→密度→深度回测，以及 回测台账 |
| 三 | PnL 稳定性、比较、相关性、稳健性、跨区变体、Super Alpha 组合 | 旧系统有效分析能力 |
| 四 | 假设与实验记录、CLI/MCP、论坛检索、模型接入、预算及停止条件 | 决策摘要、可复盘流程 |
| 后续 | 平台回写、检查、提交、顾问表现 | 另行确认业务范围 |
AI 复用系统接口，不直接写数据库，模型可替换。论坛效果与阈值必须验证后才可成为规则。首期不提前建设后续空模块。
验收
- 登录成功/失败、退出、越权防护；凭据不泄露，公网 HTTPS。
- 平台连接、过期、人工验证、拒绝及网络错误。
- 多页、重复、更新、429、部分失败、取消与重启恢复；同步保留本地研究记录。
- 各 Alpha/语言类型、缺失指标和不同 PnL schema。
- 筛选、分页、排序、批量编辑和超 500 条 CSV 导出一致。
- Docker 空环境启动、重建持久化、备份恢复。
- 模拟上游自动化测试后，使用真实账户只读联调；未验证部分如实记录。
完成标准：空部署后连接个人账户、同步 Alpha、查询和查看详情、维护本地研究记录，重启与再次同步后数据仍然可靠。