ek_converter/lib.rs
1//! # ek-converter —— enkeep ek 生态的持仓账本与开平转换器
2//!
3#![doc = include_str!("../README.md")]
4//!
5//! ---
6//!
7//! Python 原稿:`enkeep_trade/enkeep_trade/trader/converter.py`(447 行)。
8//!
9//! ## 全局决定(DESIGN.md 有全文)
10//!
11//! 1. **一个结构体一个文件**:[`holding`] 放账本 [`PositionHolding`]与
12//! 三条拆分策略;[`converter`] 放表管理 [`OffsetConverter`];枚举
13//! [`ConvertMode`] 独立一处(生态同款纪律)。
14//! 2. **双层 API**:入口层([`converter::OffsetConverter`])带合约闸门
15//! (`Option<&ContractData>`),账本层([`holding::PositionHolding`])纯状态零合约参数。
16//! 3. **合约按次传入**(决策①):不注入宿主、不要 trait,纯算法零宿主依赖。
17//! 4. **错误面最窄**(决策②③):畸形 `en_orderid` 返回 `false` 不 panic;
18//! 拆分结果保持 `Vec<OrderRequest>`(空 = 拒单),与原稿一致。
19//! 5. **零第三方**:f64 账本 + `HashMap`,不引 log/serde;0.1.5 起**零 dev-deps**
20//! (跨 crate 集成套 `tests/assembly.rs` 已整文件迁至 `ek-station/tests/assembly.rs`,
21//! 本 crate 因此是纯叶子:依赖图只有 `ek-data`);
22//! 保真向量由 `probe/gen_vectors.py`(跑原稿)生成后硬编码进 tests。
23//!
24//! ## Python → Rust 对照总表
25//!
26//! | Python(converter.py) | Rust |
27//! |---|---|
28//! | `OffsetConverter`(20-101) | [`converter::OffsetConverter`] |
29//! | `PositionHolding`(104-289) | [`holding::PositionHolding`] |
30//! | `convert_order_request_shfe/lock/net`(291/325/372)| [`holding::PositionHolding::convert_order_request_shfe`] / [`…_lock`](holding::PositionHolding::convert_order_request_lock) / [`…_net`](holding::PositionHolding::convert_order_request_net) |
31//! | `(lock: bool, net: bool=False)` | [`ConvertMode`] |
32//!
33#![warn(missing_docs)]
34#![deny(rustdoc::broken_intra_doc_links)]
35
36pub mod convert_mode;
37pub mod converter;
38pub mod holding;
39
40pub use convert_mode::ConvertMode;
41pub use converter::OffsetConverter;
42pub use holding::PositionHolding;