iomgaa/PolyGateway
1
0
Fork 0
Code Issues 3 Pull Requests Actions Packages Projects Releases 9 Wiki Activity

docs: revise M2 design per independent review findings

Browse Source
This commit is contained in:
iomgaa
2026-07-20 23:17:24 -04:00
parent 8aaf8f200b
commit dfd9dcfee4
2 changed files with 20 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files
research-wiki/designs/m2-distributed.md
+2 -2
View File
@@ -14,8 +14,8 @@ date: 2026-07-21
| 轴 | 选定 | 理由 |
|---|---|---|
| Redis 限流 | 单条六道闸 Lua 逐字移植(CHS scripts.py),key 前缀 `pgw:limit:` | 生产验证语义 + 保真成本最低 |
| Redis 熔断 | 五操作 Lua 逐字移植(provider_gate),epoch 仅开断 +1;probe_ttl 显式配置 + 装配守卫 | 不动 M1 冻结的 BreakerConfig |
| 契约测试 | conftest fixture 增 `redis` param + 真实 Redis(db3);时间语义用小 TTL 真实等待变体 | M1 预留接入方式,契约文件零改动 |
| Redis 熔断 | 五操作 Lua 逐字移植(provider_gate),epoch 仅开断 +1;probe_ttl 显式/派生配置 + 装配守卫(派生式补 `timeout+5` 项) | 不动 M1 冻结的 BreakerConfig |
| 契约测试 | conftest fixture 增 `redis` param + 真实 Redis(db3);时间语义 10 用例(限流 2+熔断 8)redis param 下经哨兵时钟 skip,由 1:1 真实等待 integration 变体覆盖 | 契约文件本体零改动;FakeClock 对服务器时钟不可注入,缩放会破坏绝对值断言 |
| 背压 stall | 在 RetryMW `_on_no_runnable` wait 分支内做双条件判死 + poll jitter | 挂接点 M1 已预留,不新增洋葱层 |
| Postgres 遥测 | DSN 自建 lazy 池(可注入 pool),失败静默降级,`ON CONFLICT DO NOTHING` | 与 SQLiteRecorder 对称;GovDoc taskrun 蓝本反转降级方向 |
| pricing | JSON 价格表文件(`PGW_PRICING_PATH`)/dict 注入,零内置单价;计算点在 TelemetryEmitter | 中转网关计费非官方价,内置表必然过时(P5) |