QAExchange-RS 文档中心
版本: v1.2.0 最后更新: 2025-11-26
欢迎使用 QAExchange-RS 文档！本文档中心提供完整的系统架构、API 参考、集成指南和开发文档。
📚 文档导航
🚀 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 文档和协议规范。
WebSocket API
HTTP API
错误处理
- 错误码参考 - 完整错误码列表
🔌 05. 集成指南
前端集成和序列化指南。
前端集成
序列化
- 序列化指南 - rkyv/JSON 序列化最佳实践
🛠️ 06. 开发指南
开发、测试、部署文档。
- WebSocket 集成指南 - DIFF 协议接入详解
- 测试指南 - 单元测试与集成测试
- 部署指南 - 生产环境部署
📖 07. 参考资料
术语表、常见问题、性能基准。
🎓 08. 高级主题
深度技术文档和实现报告。
Phase 报告
- Phase 6-7 实现报告 - 复制系统与性能优化
实现总结
技术深度
- 市场数据增强 - L1 缓存与 WAL 恢复
DIFF 测试报告
- 主测试报告 - DIFF 协议测试结果
🗄️ 09. 归档
历史文档和已废弃的计划。
🔍 快速查找
按角色查找
- 新手开发者: 快速开始 → 系统架构
- 前端开发者: WebSocket API → 前端集成
- 后端开发者: 核心模块 → 开发指南
- 运维工程师: 部署指南 → 性能基准
- 架构师: 高性能架构 → 高级主题
按主题查找
- 性能优化: 高性能架构, 解耦存储, 压缩策略, 二级索引
- 数据持久化: WAL, SSTable, 压缩策略
- 市场数据: 快照生成器, K线聚合系统, K线实时推送
- 协议集成: DIFF 协议, 数据模型
- WebSocket: 协议规范, 前端集成, K线推送
- 测试部署: 测试指南, K线测试, 部署指南
- 因子计算: 因子系统, 因子 WAL 集成 - 流批一体化、增量算子、DAG 依赖、异步持久化 ✨ 更新
- 二级索引: 索引系统 - 时序索引、合约索引、类型索引、复合查询 ✨ 新增
- 集群管理: 集群系统 - 一致性哈希、分片路由、副本分布 ✨ 新增
- 查询引擎: 查询引擎 - Polars SQL、流批混合查询 ✨ 更新
📊 文档版本信息
| 模块 | 版本 | 最后更新 | 状态 |
|---|---|---|---|
| 快速开始 | v1.0.0 | 2025-10-06 | ✅ 完整 |
| 系统架构 | v0.4.0 | 2025-11-24 | ✅ 完整（新增因子/集群/DSL层） |
| 核心模块 | v1.2.0 | 2025-11-26 | ✅ 完整（新增压缩策略/二级索引/因子WAL） |
| API 参考 | v1.0.0 | 2025-10-06 | ✅ 完整 |
| 集成指南 | v1.0.0 | 2025-10-06 | ✅ 完整 |
| 开发指南 | v1.0.0 | 2025-10-07 | ✅ 完整（新增K线测试） |
| 参考资料 | v0.5.0 | 2025-10-06 | 🚧 计划中 |
| 高级主题 | v1.1.0 | 2025-10-07 | ✅ 完整（新增K线实现总结） |
| 归档 | - | 2025-10-06 | ✅ 已归档 |
🤝 贡献文档
发现文档问题或想要改进？请参考 贡献指南（待创建）。
📮 反馈与支持
- 问题报告: 请提交 GitHub Issue
- 功能建议: 请提交 Feature Request
- 文档改进: 欢迎提交 Pull Request
最后更新: 2025-11-26 维护者: QAExchange-RS 开发团队