量化交易基础设施工程师 | 构建高性能、高可靠的金融数据与交易系统
Go 🐹 (主要) · Rust 🦀 (底层) · Python 🐍 (脚本/数据) · TypeScript ⚡ (前端)
📐 完整依赖拓扑、域间关系、运行时组装与子模块明细 → docs/architecture/(主叙事已迁移,根目录 ARCHITECTURE.md 保留兼容入口)
🔄 活跃事实链路、M×S 联合决策矩阵与契约清单 → docs/architecture/01-overview.md · docs/architecture/08-contracts.md
🧭
06-dataflow.md/07-three-engines.md仅保留历史投影与迁移对照📊 项目状态监控、健康度与风险追踪 → STATUS.md
🗺️ 六阶段交付路线图、任务编号与验收标准 → ROADMAP.md
🧱 Foundation 公开规格、依赖矩阵、执行跟踪与 ADR → module/
📋 19 个基座 Foundation 模块规格,另含 5 个 L2.5 领域共享规划/基线规格(L2.5 不作整体 release/factory 声明) → module/
🧭 Spec 治理模板、生命周期、追溯与评分规则 → docs/governance/
📜 系统宪法(AI 代理最高治理文件)→ CONSTITUTION.md
入口: composer (Composition Root: 启动 / 配置 / 组装)
│
▼
标准: xlib_standard · xlib_harness · xlib_evidence · xlibgate(标准源、门禁生成/执行、证据收集、Trust Alignment,不参与运行时)
│
▼
L0: kernel (stdlib-only primitives)
│
▼
L1 primitives: configx / observex / resiliencx / schedulex
L1 Assembly: bootstrap (process assembly below composer)
L1 测试: testkitx (test-only)
│
▼
基座扩展: redisx / kafkax / natsx / postgresx / taosx / ossx / clickhousex / contracts / transportx
│
▼
L2.5: domainx / decimalx / domain_market / domain_macro / domain_exchange (5/5 已发布;domain_market v1.1.0,其余 v1.0.0+;5/5 GitHub Release 已观测对账;5/5 factory grade;live/soak N/A)
│
▼
业务流: 数据域 → 分析域 ↔ 决策域 → 执行域
数据域: market_data (14) / macro_data (11) / alternative_data
分析域: factor_engine / feature_store / factor_eval / market_regime / macro_regime / regime_engine / ms_brain / flowx
三引擎: market_regime / macro_regime / regime_engine(活跃事实链路;market_engine / macro_engine 仅保留在投影与迁移文档)
决策域: signal_factory / optimizer / backtestx / strategyx / maestro
执行域: riskx / orderx / positionx / settlement
反馈: backtest → factor_eval;fills / PnL / exposure events → 决策域
横切: alertx (告警) / observex (可观测)
| 模块 | 当前版本 | 目标版本 | 状态 | 模块文档 |
|---|---|---|---|---|
decimalx |
v1.0.0 | v1.0.0 | v1.0.0 GitHub Release 已发布;API freeze 完成 | module/decimalx |
domainx |
v1.0.1 | v1.0.1 | 领域共享值对象基线;v1.0.1 GitHub Release 已发布 | module/domainx |
domain_market |
v1.1.0 | v1.1.0 | 市场数据域模型 + canonical 类型(ProductLine/InstrumentKey/MarketFactEnvelope)+ Binance C/S ingestion 语义 | module/domain_market |
domain_macro |
v1.0.0 | v1.0.0 | v1.0.0 GitHub Release 已发布;no-lookahead 冻结 | module/domain_macro |
domain_exchange |
v1.0.0 | v1.0.0 | v1.0.0 GitHub Release 已发布;Exchange SPI 冻结 | module/domain_exchange |
成熟度口径:5/5 已发布 v1.0.0+ GitHub Release(decimalx v1.0.0/domain_market v1.1.0/domain_macro v1.0.0/domain_exchange v1.0.0/domainx v1.0.1);5/5 factory grade;live/soak N/A(纯值对象库,无运行时服务不需 EXT CI/adoption/soak 证据)。
依赖顺序:decimalx -> domainx -> domain_market / domain_macro -> domain_exchange。v1.0.0 是各模块的发布版本,GitHub Release/tag 已观测并对账。5/5 factory grade;live/soak N/A(纯值对象库)。
domainx 已归入 L2.5 领域共享层;机器事实层将其作为 L2.5 模块单独计入 20-module projection,不并入 19 个基座组件数。
- xlib_standard — 标准事实源、Go Reference Template(Generator/Harness/Evidence 已拆分至 xlib_harness / xlib_evidence);v1.0.1 GitHub Release 已发布,CI/Docker/Worktree/adoption 与本地 release-preflight 通过;不作为运行时 import 依赖
公开 - xlib_harness — 模块生成器与门禁执行器:generate/scaffold、spec-lint、boundary-check、traceability-gate、format-check;✅ v0.1.6 GitHub Release 已发布,Release run 27855366871 与 main CI run 27855396013 通过,覆盖率 100.0%,pinned gitleaks CLI secret scan 已对齐
公开 - xlib_evidence — 证据收集与发布运行时:collect-coverage、generate-manifest、validate-manifest、remote-evidence、report;✅ v0.2.4 GitHub Release 已发布,release evidence assets 已归档,本地 Go runtime 验收通过(go test/race/vet/build/coverage 100.0%)
公开 - kernel — L0 标准库扩展原语(error/time/context/lifecycle/health/sync)
公开 - configx — 显式配置加载、多源合并(File/Env/Map/Args)、StrictDecode、SecretString 脱敏、Provenance 追踪、EffectiveConfigHash、Bind() 强类型绑定、ConfigSnapshot 热更新与回滚、RemoteSource SPI、配置文档自动生成
公开 - observex — vendor-neutral 日志、指标、追踪、健康与脱敏契约
公开 - resiliencx — 运行时弹性策略(timeout/retry/circuit/bulkhead/rate/fallback、Compose、InstrumentStrategy、panic recovery);v1.0.2 GitHub Release 已发布,Release Check 27777166525 通过
公开 - schedulex — 任务调度运行时(cron/interval/delay、Overlap/Misfire 策略、Locker 扩展点、Clock 注入、v1.0.0 已发布,98.2% 覆盖)
公开 - bootstrap — L1 Assembly 通用进程组装层(位于 L1 primitives 之上、composer 入口之下):configx/observex/resiliencx + lifecycx 统一组装 + 7 存储 adapter 可选构造(StoreSet 位掩码);不承载业务语义 / service listener / domain contracts;✅ v0.1.0 GitHub Release 已发布,规格 v0.1.7
公开 - testkitx — 测试专用 evidence/golden/fixture/boundary 工具包
公开 - xlibgate — import 边界、go.mod、Go baseline、release evidence、Trust Alignment 门禁
公开
公开投影口径:版本 / release / factory 状态以
.foundationx/status/index.json+.foundationx/blockers.json和 GitHub Release 实际证据为准;2026-06-23 核查发现natsx仅有v1.0.3远端 tag,GitHub Releasev1.0.3尚不存在;Foundation factory 投影不得把 tag 直接等同 Release。
configxv1.1.0、observexv0.3.3、testkitxv0.4.0、resiliencxv1.0.2 已发布;resiliencx Release Check 27777166525 通过,此前版本误标已修正。
- postgresx — PostgreSQL — 关系型存储、事务、迁移(v1.0.0 已发布;live integration 通过;factory_grade_allowed=false;单元测试 52.4% + Docker integration skip,BLK-006 open)
公开 - redisx — Redis L2 adapter(v1.1.0 已发布;KV/TTL、Hash/List、Pipeline、Cache-aside、Lock/RateLimit、Pool、Persistence restart recovery;PR #19、release-preflight、GitHub Release 与 dev Redis 集成验证通过)
公开 - clickhousex — ClickHouse — OLAP 查询、批量写入(v1.0.10 本地 release evidence 已闭合;Exec/Query/Rows/InsertBatch、metrics/tracing/logger/retry/error mapping 与 100.0% 覆盖率门禁已对齐;真实 ClickHouse live 集成与 60s soak 已验证;远端 push / GitHub Release / Actions 待触发;BLK-003 resolved;非 factory)
公开 - taosx — TDengine L2 adapter contract(pkg/taosx v1.0.5 本地发布候选;CI/release 已加入 taosx-coverage-check,pkg/taosx 100.0% 覆盖;TDengine dev live gate 已通过且保持显式 opt-in;未执行外部 tag/GitHub Release;非 factory)
公开 - kafkax — Kafka — 消息队列、事件流(v1.1.0 已发布;真实 broker gates 已验证)
公开 - natsx — NATS 内部通信模块(v1.0.3 remote tag 已存在,GitHub Release v1.0.3 待补;Spec v1.2.0;Core NATS / JetStream、Drain/reconnect/degraded health、canonical
FOUNDATIONX_NATS_*配置和真实 dev auth live gate 已验证;FR-009/010 runtime adapter PR #17 已合并,JetStream IngestAdapter 域适配契约 pkg/natsx/ingest 解耦 binance PR-007c/d;正式四源 98+ arbiter 与生产 TLS gate 待补,BLK-001/BLK-002 open;非 factory)公开 - ossx — Aliyun OSS 对象存储 L2 adapter(v1.2.1;真实 adapters/aliyun + 流式 SPI + multipart + presign + retry/circuit + observex hooks;pkg/ossx 100% 覆盖;BLK-010 resolved ✅;PR #8 merged)
公开
- contracts — 跨域稳定端口、事件协议与 DTO 契约(含 §8.4 Binance C/S ingestion contract);✅ v1.5.0 GitHub Release 已发布(P0 RegimeSnapshot/RegimeCard/DecisionCard;P1 SignalIntent DTO)
公开 - transportx — 应用通信底座规格基线(Envelope/Endpoint、ServiceIdentity、QoS、Codec、RPC、EventBus、Stream、Outbox/Inbox、Audit Plane、Data Classification、SchemaRegistry 与 conformance gates);✅ v1.1.1-spec GitHub Release 已发布
公开
- decimalx — 高精度十进制类型(Decimal/Price/Qty/Ratio/Money);v1.0.0 GitHub Release 已发布
公开 - domainx — 领域共享值对象:Order/Position/Trade/Portfolio/ExecutionReport 枚举与类型;L2.5 design baseline;公开 v1.0.1 GitHub Release/tag 已观测并已对账为 release=true;factory grade;live/soak N/A(纯值对象库)
公开 - domain_market — 市场数据域模型(Tick/Quote/Bar/OrderBook)+ canonical 类型(ProductLine/InstrumentKey/MarketFactEnvelope)+ Binance C/S ingestion 语义;v1.1.0
公开 - domain_macro — 宏观经济领域共享模型:国家/地区/指标/发布日历、MacroPoint/MacroState;v1.0.0 GitHub Release 已发布
公开 - domain_exchange — 交易域模型(VenueAdapter 13 方法接口);v1.0.0 GitHub Release 已发布
公开
行情接收与分发:
- market_data — Downstream Dispatch Port 接收侧模块;接收 adapter 归一化事件,执行校验、幂等、排序和分发
公开
交易所 SDK / C/S Module:
- binance — 币安 Binance Market Data C/S Module (Spot/USDⓈ-M/COIN-M/Options);spec v3.5.0 Registered;2026-06-23 PR #19 本地 lifecycle/runtime/release-gate evidence 已归档(实现提交
c7967dd7eec6523927f2157a2e7c49a0f2fb820d,证据刷新56a7f5c7eb174e352fc91371227877365c6ae299);FR-012~FR-030 已补本地 lifecycle 规划/admin 合约与确定性测试;release_closeable=NO(未覆盖 live websocket / historical REST / natsx PubAck+ManualAck / 外部存储、fanout、query / remote CI / release tag)公开 - okx — OKX
公开 - bybit — Bybit
公开 - bitget — Bitget
公开 - kucoin — KuCoin
公开 - gate — Gate.io
公开 - mexc — MEXC
公开 - htx — HTX (火币)
公开 - coinbase — Coinbase
公开 - hyperliquid — Hyperliquid
公开 - lighter — Lighter
公开 - upbit — Upbit
公开 - coinglass — Coinglass 加密货币数据
公开
-
macro_data — 宏观数据聚合调度(Receiver + DualWriteSink);dispatch 独立进程
公开 -
fred — 美联储经济数据 (FRED)
公开 -
treasury — 美国国债/财政数据
公开 -
yield_curve — 收益率曲线
公开 -
bea — 美国经济分析局 (BEA)
公开 -
ecb — 欧洲央行 (ECB)
公开 -
uk_cb — 英国央行
公开 -
japan_cb — 日本央行
公开 -
eastmoney — 东方财富
公开 -
jin10 — 金十数据 SDK(开放 API + Flash 快讯)
公开 -
yahoo — Yahoo Finance
公开
- alternative_data — 链上数据、社交情绪、新闻 NLP
公开
- factor_engine — 因子计算引擎
公开 - feature_store — 特征存储与版本管理
公开 - factor_eval — 因子评估
公开 - market_regime — 市场状态识别(S1-S7:多头趋势/挤空/空头/踩踏/震荡/低波/压缩)
私有 - macro_regime — 宏观经济体制识别(M1-M7:流动牛市/再通复苏/软着繁荣/鹰派通胀/衰退降息/信用去杠/滞胀冲击)
私有 - regime_engine — M×S 联合决策引擎(M state + S state → action A-E / risk_tier / position_caps / trade_permission)
私有 - ms_brain — M×S 系统架构分析体系
私有 - flowx — 数据流管线引擎(流式 ETL、窗口聚合、背压控制)
公开
- signal_factory — 信号生成与组合
公开 - optimizer — 参数优化
公开 - backtestx — 回测引擎(事件驱动、Walk-Forward、蒙特卡洛)
公开 - strategyx — 策略工厂(策略注册、参数管理、信号组合)
公开 - maestro — 工作流编排引擎(DAG 工作流、状态机、错误恢复)
公开
历史占位
backtest_engine已于 2026-06-22 移除(迁移至 backtestx)。
- settlement — 结算与对账
公开 - riskx — 风控引擎(事前风控、回撤控制、熔断机制)
公开 - orderx — 订单管理器(订单生命周期、SOR、状态机)
公开 - positionx — 仓位管理器(实时仓位追踪、PnL、敞口监控)
公开
历史占位
risk_engine/order_engine/portfolio_engine已于 2026-06-22 移除(分别迁移至 riskx / orderx / positionx)。
- alertx — 告警引擎
公开 - x.go — 治理/工具 CLI(goalcli + templatex);运行时 Composition Root 职责由 composer 承担
私有 - composer — 数据域组合根:25 进程编排 + HTTP health + Docker Compose;RegimeCoordinator(dispatch→regime→engine→signal_factory 全链路);SinkPort 适配器(MarketRegimeSink/MacroRegimeSink);v0.2.0
公开 - module — 项目技术规范、接口定义与 Goal 适配模块索引
- docs/governance — Spec → Code 交付治理、模板、门禁与评分规则
- docs/sre/foundation-cicd-plan.md — 基座层 19 模块 + L2.5 领域共享 CI/CD 部署执行方案(SRE 机器池 4 阶段)
- docs/RSI_SG_001_complete_standard_v1.1_zh.md — RSI 递归自我改进完整标准中文版 v1.1
构建稳定可靠的量化基础设施 ⚡