QAExchange-RS 文档中心
版本: v1.5.0 最后更新: 2025-12-22
欢迎使用 QAExchange-RS 文档！本文档中心提供完整的系统架构、API 参考、集成指南和开发文档。
📸 系统截图
仪表盘与监控
账户管理
交易功能
持仓与风控
K线与行情
历史记录
📚 文档导航
🚀 01. 快速开始
新用户入门必读，快速搭建和运行 QAExchange-RS。
🏗️ 02. 系统架构
深入了解 QAExchange-RS 的核心架构设计。
- 系统总览 - 整体架构与模块划分
- 高性能架构 - P99 < 100μs 延迟设计
- 数据模型 - QIFI/TIFI/DIFF 协议详解
- 交易机制 - 撮合引擎与交易流程
- 解耦存储架构 - 零拷贝 + WAL 持久化
⚙️ 03. 核心模块
核心功能模块详细说明。
存储系统
- WAL 设计 - Write-Ahead Log 崩溃恢复
- MemTable 实现 - OLTP/OLAP 内存表
- SSTable 格式 - rkyv/Parquet 持久化
- 压缩策略 - 按数据类型动态压缩 ✨ 新增
- 二级索引 - 时序/合约/类型复合索引 ✨ 新增
- 查询引擎 - Polars SQL 查询
- 复制系统 - 主从复制与故障转移
撮合引擎 ✨ 新增
市场数据模块 ✨ 新增
通知系统
因子计算系统 ✨ 新增
- 因子计算系统 - 流批一体化因子引擎
- 增量算子 (RollingMean, EMA, RSI, MACD)
- Factor DAG 依赖图
- 物化视图缓存
- 因子 WAL 集成 - 异步持久化与恢复 ✨ 新增
集群管理 ✨ 新增
- 集群管理系统 - 一致性哈希分片
- 虚拟节点映射
- 带权重负载均衡
- 副本分布策略
📡 04. API 参考
完整的 API 文档和协议规范。
前后端交互协议 ✨ 新增
- 完整协议文档 - HTTP REST API + WebSocket DIFF 协议完整规范
WebSocket API
HTTP API
错误处理
- 错误码参考 - 完整错误码列表
🔌 05. 集成指南
前端集成和序列化指南。
前端集成
序列化
- 序列化指南 - rkyv/JSON 序列化最佳实践
🛠️ 06. 开发指南
开发、测试、部署文档。
- WebSocket 集成指南 - DIFF 协议接入详解
- 测试指南 - 单元测试与集成测试
- 部署指南 - 生产环境部署
- TLS 安全指南 - TLS/mTLS 证书配置 ✨ 新增
- 可观测性指南 - OpenTelemetry 集成 ✨ 新增
📖 07. 参考资料
术语表、常见问题、性能基准。
🎓 08. 高级主题
深度技术文档和实现报告。
技术路线图 ✨ 新增
- 2025-2026 技术路线图 - Phase 14-16+ 规划与里程碑
Phase 报告
- Phase 6-7 实现报告 - 复制系统与性能优化
- Phase 12-13 实现报告 - 可观测性与安全层 ✨ 新增
实现总结
技术深度
- 市场数据增强 - L1 缓存与 WAL 恢复
DIFF 测试报告
- 主测试报告 - DIFF 协议测试结果
🗄️ 09. 归档
历史文档和已废弃的计划。
🔍 快速查找
按角色查找
- 新手开发者: 快速开始 → 系统架构
- 前端开发者: WebSocket API → 前端集成
- 后端开发者: 核心模块 → 开发指南
- 运维工程师: 部署指南 → 性能基准
- 架构师: 高性能架构 → 高级主题
按主题查找
- 前后端协议: 完整协议文档 - HTTP REST API + WebSocket DIFF 协议完整规范 ✨ 推荐
- 撮合引擎: 撮合引擎模块, 测试指南, 性能基准, 压力测试 ✨ 新增
- 性能优化: 高性能架构, 解耦存储, 压缩策略, 二级索引, 撮合性能基准
- 数据持久化: WAL, SSTable, 压缩策略
- 市场数据: 快照生成器, K线聚合系统, K线实时推送, 数据生产测试 ✨ 新增
- 协议集成: 完整协议文档, DIFF 协议, 数据模型
- WebSocket: 协议规范, 前端集成, K线推送
- 测试部署: 测试指南, K线测试, 部署指南
- 因子计算: 因子系统, 因子 WAL 集成 - 流批一体化、增量算子、DAG 依赖、异步持久化 ✨ 更新
- 二级索引: 索引系统 - 时序索引、合约索引、类型索引、复合查询 ✨ 新增
- 集群管理: 集群系统 - 一致性哈希、分片路由、副本分布 ✨ 新增
- 查询引擎: 查询引擎 - Polars SQL、流批混合查询 ✨ 更新
- 可观测性: 可观测性指南 - OpenTelemetry 追踪、Prometheus 指标、Grafana 仪表盘 ✨ 新增
- 安全配置: TLS 安全指南 - TLS/mTLS 证书管理、rustls 配置 ✨ 新增
- 技术路线: 2025-2026 路线图 - Phase 14-16+ 技术规划 ✨ 新增
📊 文档版本信息
| 模块 | 版本 | 最后更新 | 状态 |
|---|---|---|---|
| 快速开始 | v1.0.0 | 2025-10-06 | ✅ 完整 |
| 系统架构 | v0.5.0 | 2025-12-18 | ✅ 完整（新增可观测性/安全层） |
| 核心模块 | v1.4.0 | 2025-12-17 | ✅ 完整（新增数据生产测试文档） |
| 撮合引擎 | v0.2.0 | 2025-12-17 | ✅ 新增（76测试/压力测试/性能基准） |
| 市场数据 | v0.2.0 | 2025-12-17 | ✅ 新增（22个数据生产测试） |
| 协议文档 | v1.0.0 | 2025-12-15 | ✅ 新增（HTTP REST + WebSocket DIFF） |
| API 参考 | v1.0.0 | 2025-10-06 | ✅ 完整 |
| 集成指南 | v1.0.0 | 2025-10-06 | ✅ 完整 |
| 开发指南 | v1.2.0 | 2025-12-18 | ✅ 完整（新增TLS/可观测性指南） |
| 参考资料 | v1.1.0 | 2025-12-18 | ✅ 完整（Phase 12-13 性能指标） |
| 高级主题 | v1.2.0 | 2025-12-18 | ✅ 完整（新增路线图/Phase 12-13报告） |
| 归档 | - | 2025-10-06 | ✅ 已归档 |
🤝 贡献文档
发现文档问题或想要改进？请参考 贡献指南（待创建）。
📮 反馈与支持
- 问题报告: 请提交 GitHub Issue
- 功能建议: 请提交 Feature Request
- 文档改进: 欢迎提交 Pull Request
最后更新: 2025-12-22 维护者: @yutiansut @quantaxis