Skip to content

Commit d5e15a1

Browse files
committed
docs: publish execution boundary release pins
1 parent 3ab4faa commit d5e15a1

2 files changed

Lines changed: 24 additions & 2 deletions

File tree

README.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -23,6 +23,17 @@ Current strategy implementations are sourced from `UsEquityStrategies`.
2323
Full strategy documentation now lives in [`UsEquityStrategies`](https://github.com/QuantStrategyLab/UsEquityStrategies). The strategy section below is kept as an execution-side summary.
2424
This runtime matrix is the authoritative enablement source for IBKR. `UsEquityStrategies` only describes strategy-layer compatibility and human-readable metadata.
2525

26+
### Execution boundary
27+
28+
The mainline runtime now follows one path only:
29+
30+
- `main.py` assembles platform inputs into `StrategyContext`
31+
- `strategy_runtime.py` loads the unified strategy entrypoint
32+
- `entrypoint.evaluate(ctx)` returns a shared `StrategyDecision`
33+
- `decision_mapper.py` maps that decision into IBKR orders, notifications, and runtime updates
34+
35+
`main.py` no longer reads private strategy constants or platform-only fields from strategy return payloads.
36+
2637
### Strategy
2738

2839
**Supported `STRATEGY_PROFILE` values**
@@ -337,6 +348,17 @@ gcloud run services update ibkr-quant \
337348

338349
完整策略说明现在放在 [`UsEquityStrategies`](https://github.com/QuantStrategyLab/UsEquityStrategies#global_etf_rotation)。下面的策略章节主要保留执行侧摘要。
339350

351+
### 执行边界
352+
353+
当前主线运行路径已经统一为:
354+
355+
- `main.py` 负责把平台输入组装成 `StrategyContext`
356+
- `strategy_runtime.py` 负责加载统一策略入口
357+
- `entrypoint.evaluate(ctx)` 返回共享的 `StrategyDecision`
358+
- `decision_mapper.py` 再把决策映射成 IBKR 订单、通知和运行时更新
359+
360+
`main.py` 已经不再直接读取策略私有常量,也不再依赖策略返回里的平台专属字段。
361+
340362
### 策略
341363

342364
**选池 (22只 + 1只避险):**

requirements.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
flask
22
gunicorn
3-
quant-platform-kit @ git+https://github.com/QuantStrategyLab/QuantPlatformKit.git@5174d9e40f79fffae47450a42e26434145d28b31
4-
us-equity-strategies @ git+https://github.com/QuantStrategyLab/UsEquityStrategies.git@84da76d1ed17e9cf8bec33d9f1f8020f61362a78
3+
quant-platform-kit @ git+https://github.com/QuantStrategyLab/QuantPlatformKit.git@v0.7.0
4+
us-equity-strategies @ git+https://github.com/QuantStrategyLab/UsEquityStrategies.git@v0.7.0
55
pandas
66
numpy
77
requests

0 commit comments

Comments
 (0)