Skip to content
View ZoneCNH's full-sized avatar

Block or report ZoneCNH

Block user

Prevent this user from interacting with your repositories and sending you notifications. Learn more about blocking users.

You must be logged in to block users.

Maximum 250 characters. Please don’t include any personal information such as legal names or email addresses. Markdown is supported. This note will only be visible to you.
Report abuse

Contact GitHub support about this user’s behavior. Learn more about reporting abuse.

Report abuse
ZoneCNH/README.md

你好,我是 ZoneCNH 👋

量化交易基础设施工程师 | 构建高性能、高可靠的金融数据与交易系统

🔧 技术栈

Go 🐹 (主要) · Rust 🦀 (底层) · Python 🐍 (脚本/数据) · TypeScript ⚡ (前端)

🏗️ 分层架构

📐 完整依赖拓扑、域间关系、运行时组装与子模块明细 → ARCHITECTURE.md

🔄 三引擎数据流全景、M×S 联合决策矩阵与契约清单 → DATAFLOW.md

📊 项目状态监控、健康度与风险追踪 → STATUS.md

🗺️ 六阶段交付路线图、任务编号与验收标准 → ROADMAP.md

🧱 Foundation 公开规格、依赖矩阵、执行跟踪与 ADR → module/

📋 19 个基座 Foundation 模块规格,另含 5 个 L2.5 领域共享规划/基线规格(L2.5 不作整体 release/factory 声明) → module/

🧭 Spec 治理模板、生命周期、追溯与评分规则 → docs/governance/

📜 系统宪法(AI 代理最高治理文件)→ CONSTITUTION.md

入口: x.go (Composition Root: 启动 / 配置 / 组装)
      │
      ▼
标准: xlib-standard · xlib-harness · xlib-evidence · xlibgate(标准源、门禁生成/执行、证据收集、Trust Alignment,不参与运行时)
      │
      ▼
L0: kernel (stdlib-only primitives)
      │
      ▼
L1 运行时: configx / observex / resiliencx / schedulex
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 (19) / macro-data (10) / alternative-data
分析域: factor-engine / feature-store / factor-eval / market_regime / macro_regime / regime-engine / ms_brain / flowx
       三引擎: market_engine(market facts → S state) / macro_engine(macro facts → M state) / regime_engine(M+S → action/risk/permission)
决策域: signal-factory / backtest-engine / optimizer / backtestx / strategyx / maestro
执行域: risk-engine → order-engine → portfolio-engine / settlement ; riskx / orderx / positionx

反馈: backtest → factor-eval;fills / PnL / exposure events → 决策域
横切: alertx (告警) / observex (可观测)

L2.5 v1.0.0 执行计划基线

模块 当前版本 目标版本 状态 模块文档
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);不作为运行时 import 依赖 公开
  • xlib-harness — 模块生成器与门禁执行器:generate/scaffold、spec-lint、boundary-check、traceability-gate;✅ v0.1.0 GitHub Release 已发布 公开
  • xlib-evidence — 证据收集与发布运行时:collect-coverage、generate-manifest、validate-manifest、report;✅ v0.1.0 GitHub Release 已发布 公开
  • kernel — L0 标准库扩展原语(error/time/context/lifecycle/health/sync) 公开
  • configx — 显式配置加载、多源合并、StrictDecode、SecretString 脱敏、Provenance 追踪与 EffectiveConfigHash 公开
  • observex — vendor-neutral 日志、指标、追踪、健康与脱敏契约 公开
  • resiliencx — 运行时弹性策略(timeout/retry/circuit/bulkhead/rate/fallback) 公开
  • schedulex — 任务调度运行时(cron/interval/delay、Overlap/Misfire 策略、Locker 扩展点、Clock 注入、v1.0.0 已发布,98.2% 覆盖) 公开
  • testkitx — 测试专用 evidence/golden/fixture/boundary 工具包 公开
  • xlibgate — import 边界、go.mod、Go baseline、release evidence、Trust Alignment 门禁 公开

公开投影口径:版本 / release / factory 状态以 .foundationx/status/index.json + .foundationx/blockers.json 为准;当前 BLK-001/002/003/006/007/008 open,因此 README 不声明 Foundation 单一 100% 或 factory-grade。

configx v1.0.0、observex v0.3.1、testkitx v0.4.0、resiliencx v0.4.9 已发布;此前版本误标已修正。

基座 · 存储与中间件

  • postgresx — PostgreSQL — 关系型存储、事务、迁移(v1.0.0 已发布;live integration 通过;factory_grade_allowed=false;单元测试 52.4% + Docker integration skip,BLK-006 open) 公开
  • redisx — Redis L2 adapter(v1.0.1 已发布;KV/TTL、Hash/List、Pipeline、Cache-aside、Lock/RateLimit、Pool、Persistence restart recovery;Docker-backed Redis 验证通过) 公开
  • clickhousex — ClickHouse — OLAP 查询、批量写入(v1.0.1 GitHub Release 已发布;Docker ClickHouse CI 已部署;BLK-003 open;非 factory) 公开
  • taosx — TDengine L2 adapter contract(pkg/taosx v1.0.1;真实 taosWS WebSocket 集成已验证;SPEC 评分 67,BLK-007 open;非 factory) 公开
  • kafkax — Kafka — 消息队列、事件流(v1.0.2 已发布;真实 broker gates 已验证) 公开
  • natsx — NATS 内部通信模块(v1.0.0 已发布;Core NATS / JetStream、Drain/reconnect/degraded health、canonical FOUNDATIONX_NATS_* 配置和真实 dev auth live gate 已验证;正式四源 98+ arbiter 与生产 TLS gate 待补,BLK-001/BLK-002 open;非 factory) 公开
  • ossx — Aliyun OSS 对象存储 L2 adapter(v1.0.1 已发布;真实 Aliyun OSS 集成、race、vet、build、release-check 与 100.0% 覆盖已验证(仅覆盖验证口径,不等同于 factory-ready);BLK-008 open:API 文档 / integration evidence / quickstart / release manifest 未归档;非 factory;S3/MinIO/Azure/GCS Provider 仅保留扩展位) 公开

基座 · 契约与传输

  • contracts — 跨域稳定端口、事件协议与 DTO 契约(含 §8.4 Binance C/S ingestion contract);✅ v1.2.0 GitHub Release 已发布 公开
  • transportx — 应用通信底座规格基线(Envelope/Endpoint、ServiceIdentity、QoS、Codec、RPC、EventBus、Stream、Outbox/Inbox、Audit Plane、Data Classification、SchemaRegistry 与 conformance gates);✅ v1.1.1-spec GitHub Release 已发布 公开

L2.5 · 领域共享层

  • 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(14: 1 dispatch + 12 SDK + 1 C/S Module)

行情接收与分发:

  • market-data — Downstream Dispatch Port 接收侧模块;接收 adapter 归一化事件,执行校验、幂等、排序和分发 公开

交易所 SDK / C/S Module:

  • binance — 币安 Binance Market Data C/S Module (Spot/USDⓈ-M/COIN-M/Options);spec v1.0.0 公开
  • 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

  • fred — 美联储经济数据 (FRED) 公开
  • treasury — 美国国债/财政数据 公开
  • yield-curve — 收益率曲线 公开
  • bea — 美国经济分析局 (BEA) 公开
  • ecb — 欧洲央行 (ECB) 公开
  • uk-cb — 英国央行 公开
  • japan-cb — 日本央行 公开
  • eastmoney — 东方财富 公开
  • jin10 — 金十数据 SDK(开放 API + Flash 快讯) 公开
  • yahoo — Yahoo Finance 公开

数据域 · alternative-data

分析域

  • 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 — 信号生成与组合 公开
  • backtest-engine — 事件驱动回测引擎 公开
  • optimizer — 参数优化 公开
  • backtestx — 回测引擎(事件驱动、Walk-Forward、蒙特卡洛) 公开
  • strategyx — 策略工厂(策略注册、参数管理、信号组合) 公开
  • maestro — 工作流编排引擎(DAG 工作流、状态机、错误恢复) 公开

执行域

  • risk-engine — 风险管理引擎 公开
  • order-engine — 订单执行引擎 公开
  • portfolio-engine — 投资组合管理 公开
  • settlement — 结算与对账 公开
  • riskx — 风控引擎(事前风控、回撤控制、熔断机制) 公开
  • orderx — 订单管理器(订单生命周期、SOR、状态机) 公开
  • positionx — 仓位管理器(实时仓位追踪、PnL、敞口监控) 公开

横切 · 入口

📊 GitHub 统计

GitHub 统计


构建稳定可靠的量化基础设施 ⚡

@ZoneCNH's activity is private