01
因子工厂概述
什么是因子工厂 · 量化交易价值 · 核心功能模块
概念入门
02
RESTful API 设计原则
资源命名 · HTTP方法 · 状态码 · 版本控制
规范架构
03
项目初始化与环境搭建
FastAPI选型 · 目录结构 · 依赖管理 · 配置
环境FastAPI
04
数据模型与 Schema 设计
Pydantic模型 · 请求/响应体 · 校验序列化
模型Pydantic
05
数据库设计与 ORM
SQLAlchemy · 表关系 · 迁移 · 连接池
数据库ORM
06
用户认证与授权
JWT · OAuth2 · 密码加密 · 权限中间件
安全JWT
07
因子注册接口
POST /factors · 参数校验 · 重复检测 · 异步任务
核心POST
08
因子查询接口
GET /factors · 分页排序 · 多条件过滤 · 字段选择
查询分页
09
因子详情接口
GET /factors/{id} · 关联加载 · 缓存策略
详情缓存
10
因子更新接口
PUT /factors/{id} · 部分更新 · 乐观锁
更新乐观锁
11
因子删除接口
DELETE /factors/{id} · 软删除 · 级联清理
删除软删除
12
因子计算任务提交
POST /tasks · 参数封装 · 队列选择
任务异步
13
任务状态查询
GET /tasks/{id} · 轮询/Webhook · 超时处理
状态Webhook
14
任务结果获取
GET /tasks/{id}/result · 分片下载 · 临时清理
结果下载
15
因子数据上传
POST /factors/{id}/data · CSV/Parquet · 分块上传
上传文件
16
因子数据下载
GET /factors/{id}/data · 流式响应 · 压缩传输
下载流式
17
因子回测接口
POST /backtests · 参数配置 · 并行回测
回测并行
18
回测结果分析
GET /backtests/{id}/metrics · 绩效指标 · 图表数据
分析指标
19
因子组合管理
POST /portfolios · 权重分配 · 再平衡策略
组合权重
20
组合绩效跟踪
GET /portfolios/{id}/performance · 净值曲线 · 回撤
绩效净值
21
系统健康检查
GET /health · 组件状态 · 延迟监控
运维监控
22
API文档自动生成
Swagger/OpenAPI · 文档注释 · 交互测试
文档Swagger
23
错误处理与异常捕获
全局异常处理器 · 自定义错误码 · 友好信息
异常错误码
24
日志与监控
结构化日志 · 追踪ID · Prometheus · 告警
日志监控
25
接口限流与防护
令牌桶 · IP白名单 · SQL注入 · XSS过滤
安全限流
26
单元测试编写
pytest · Mock外部依赖 · 覆盖率报告
测试pytest
27
集成测试与契约测试
API夹具 · 数据库回滚 · 消费者契约
集成契约
28
性能优化
查询优化 · Redis缓存 · 异步 · 连接池调优
性能Redis
29
部署与 CI/CD
Docker · Kubernetes · GitLab CI · 蓝绿发布
部署CI/CD
30
生产运维与排障
问题排查 · 瓶颈定位 · 灰度发布 · 回滚
运维排障