FoundationX — 量化交易基础设施
构建高性能、高可靠的金融数据与交易系统。 从基座原语到执行域，一套 Goal 驱动、Spec 可追溯的模块化量化生态。
 全域模块 |
 基座 + L2.5 |
 行情连接器 |
 宏观央行数据 |
┌─────────────────────────────────┐
入口 Entry │ composer · frontend │
└───────────────┬─────────────────┘
│
┌───────────────────────────────────────┴───────────────────────────┐
│ L2.5 领域共享层 │
│ decimalx · domainx · domain_market · domain_macro · domain_exchange │
└───────────────────────────────────────┬───────────────────────────┘
│
┌───────────────────────────────────────┴───────────────────────────┐
│ 基座 Foundation（20 模块 · 全 factory-grade） │
│ │
│ 标准 xlib_standard · xlib_harness · xlib_evidence · xlibgate │
│ L0 kernel │
│ L1 configx · observex · resiliencx · schedulex · bootstrap │
│ testkitx │
│ 存储 redisx · kafkax · natsx · postgresx · taosx · ossx │
│ clickhousex │
│ 契约 contracts · transportx │
└───────────────────────────────────────┬───────────────────────────┘
│
┌───────────────┬───────────────┬───────┴───────┬───────────────┬────┐
│ 数据域 │ 分析域 │ 决策域 │ 执行域 │横切 │
│ Data │ Analytics │ Decision │ Execution │XCUT│
│ │ │ │ │ │
│ 12 交易所连接 │ 因子计算/评估 │ 信号生成 │ 风控 │告警 │
│ 10 宏观央行源 │ 三引擎识别 │ 回测/优化 │ 订单/仓位 │ │
│ 链上/另类数据 │ 特征存储 │ 策略/编排 │ 结算对账 │ │
└───────────────┴───────────────┴──────────────┴──────────────┴────┘
分析域的核心是 M × S 联合决策矩阵：宏观体制（M）与市场体制（S）交叉，输出动作、风险层级、仓位上限与交易许可。
| 引擎 | 输入 | 输出状态 |
|---|---|---|
| macro_regime | 宏观流动 / 通胀 / 信用 | M1–M7：流动牛市 · 再通复苏 · 软着繁荣 · 鹰派通胀 · 衰退降息 · 信用去杠 · 滞胀冲击 |
| market_regime | 行情结构 / 波动 / 挤压 | S1–S7：多头趋势 · 挤空 · 空头 · 踩踏 · 震荡 · 低波 · 压缩 |
| regime_engine | M × S 联合 | 动作 A–E · risk_tier · position_caps · trade_permission |
| 模块 | 职责 | 版本 |
|---|---|---|
| kernel | L0 标准库原语（error/time/context/lifecycle/health/sync） | v1.1.0 |
| configx | 显式配置加载、多源合并、SecretString 脱敏、热更新回滚 | v1.1.0 |
| observex | vendor-neutral 日志/指标/追踪/健康/脱敏契约 | v0.3.4 |
| resiliencx | 运行时弹性（timeout/retry/circuit/bulkhead/rate/fallback） | v1.0.2 |
| schedulex | 任务调度（cron/interval/delay、Overlap/Misfire 策略） | v1.0.0 |
| bootstrap | L1 进程组装层（7 存储 adapter 可选构造） | v0.2.0 |
| testkitx | 测试专用 evidence/golden/fixture/boundary | v1.0.0 |
| redisx | Redis L2 adapter · live | v1.1.1 |
| kafkax | Kafka L2 adapter · live | v1.1.0 |
| natsx | NATS L2 adapter（Core + JetStream）· live | v1.0.4 |
| postgresx | PostgreSQL L2 adapter · live | v1.1.2 |
| taosx | TDengine L2 adapter · live | v1.0.2 |
| ossx | Aliyun OSS 对象存储 L2 adapter · live | v1.2.0 |
| clickhousex | ClickHouse OLAP L2 adapter · live | v1.0.9 |
| contracts | 跨域稳定端口、事件协议与 DTO 契约 | v0.4.7 |
| transportx | 应用通信底座（Envelope/RPC/EventBus/Outbox） | v1.1.1-spec |
| xlib_standard | 标准事实源 · Go Reference Template | v1.0.1 |
| xlib_harness | 模块生成器与门禁执行器 | v0.1.6 |
| xlib_evidence | 证据收集与发布运行时 | v0.2.4 |
| xlibgate | import / go.mod / baseline / release 机器门禁 | v1.0.0 |
| 模块 | 职责 | 版本 |
|---|---|---|
| decimalx | 高精度十进制（Decimal/Price/Qty/Ratio/Money） | v1.0.0 |
| domainx | 领域共享值对象（Order/Position/Trade/Portfolio） | v1.0.1 |
| domain_market | 市场数据域模型（Tick/Quote/Bar/OrderBook） | v1.1.0 |
| domain_macro | 宏观经济模型（MacroPoint/MacroState、no-lookahead） | v1.0.1 |
| domain_exchange | 交易域模型（VenueAdapter 13 方法 SPI） | v1.0.0 |
行情连接（12 交易所 + 聚合层）
| 模块 | 说明 |
|---|---|
| market_data | 下游分发端口：校验 / 幂等 / 排序 / 分发 |
| binance | Binance · Spot / USDⓈ-M / COIN-M / Options · production |
| okx · bybit · bitget | OKX · Bybit · Bitget |
| kucoin · gate · mexc | KuCoin · Gate.io · MEXC |
| htx · coinbase · upbit | HTX · Coinbase · Upbit |
| hyperliquid · lighter | Hyperliquid · Lighter |
| coinglass · orderbook | 加密聚合数据 · 订单簿引擎 |
宏观与央行数据（10 源 + 聚合层）
| 模块 | 说明 |
|---|---|
| macro_data | 宏观数据聚合调度（Receiver + DualWriteSink） |
| fred · treasury · yield_curve | 美联储 FRED · 美国国债 · 收益率曲线 |
| bea · ecb | 美国经济分析局 · 欧洲央行 |
| uk_cb · japan_cb | 英国央行 · 日本央行 |
| eastmoney · jin10 · yahoo | 东方财富 · 金十数据 · Yahoo Finance |
另类数据
| 模块 | 说明 |
|---|---|
| alternative_data | 链上数据 · 社交情绪 · 新闻 NLP |
| 模块 | 说明 |
|---|---|
| factor_engine | 因子计算引擎 |
| feature_store | 特征存储与版本管理 |
| factor_eval | 因子评估 |
| market_regime | 市场体制识别（S1–S7） |
| macro_regime | 宏观体制识别（M1–M7） |
| regime_engine | M × S 联合决策引擎 |
| ms_brain | M ×S 系统架构分析体系 |
| flowx | 数据流管线（流式 ETL · 窗口聚合 · 背压） |
| 模块 | 说明 |
|---|---|
| signal_factory | 信号生成与组合 |
| backtestx | 回测引擎（事件驱动 · Walk-Forward · 蒙特卡洛） |
| optimizer | 参数优化 |
| strategyx | 策略工厂（注册 · 参数 · 信号组合） |
| maestro | 工作流编排（DAG · 状态机 · 错误恢复） |
| 模块 | 说明 |
|---|---|
| riskx | 风控引擎（事前风控 · 回撤控制 · 熔断） |
| orderx | 订单管理器（生命周期 · SOR · 状态机） |
| positionx | 仓位管理器（实时追踪 · PnL · 敞口监控） |
| settlement | 结算与对账 |
| 模块 | 说明 |
|---|---|
| composer | 组合根：25 进程编排 + Docker Compose + RegimeCoordinator 全链路 |
| frontend | 统一前端平台（React 19 + Vite + Tailwind 4）· production |
| alertx | 告警引擎 |
| stdio.rs | Rust 标准库扩展模板（trait · 组合子 · 宏） |
每一行代码都可追溯到一个可验证的业务目标。
| 管线 | 说明 |
|---|---|
| Goal 驱动交付 | G0–G11 全生命周期，Goal → Spec → Design → Plan → Code → Ship |
| Spec → Code | 23 节结构化规格 · 需求追溯矩阵（FR→AC→TC→Evidence） |
| 四源评分 | Claude + Codex + Copilot + rules 四源独立评分 · composite ≥ 98 门禁 |
| 三 SSOT 分立 | registry（身份）· FOUNDATION-DEPS（依赖）· index.json（成熟度） |
| 宪法治理 | CONSTITUTION §0–§20 · 分支纪律 · 受控递归改进 |
CONSTITUTION · 架构文档 · 治理工作流 · 模块规格库
构建稳定可靠的量化基础设施 ⚡