diff --git a/docs/reference.md b/docs/reference.md index b2b746e..e9ef679 100644 --- a/docs/reference.md +++ b/docs/reference.md @@ -84,12 +84,12 @@ **值非法即拒绝启动**(无条件自检,不等 `autostart`): -| 校验 | 条件 | 依据 | +| 校验项 | 条件 | 执行方 | |---|---|---| -| `msgx.operation-day.zone` | 必须是可解析的 IANA 时区 | `PARAM:msgx.operation-day.zone` | -| `msgx.operation-day.cutoff-hour` | 取值 0–23 | `PARAM:msgx.operation-day.cutoff-hour` | -| `kafka.producers.default.acks` / `enable-idempotence` / `max-in-flight-requests-per-connection` | 联合满足幂等生产前提(`all`+`true`+`1`;旧 Broker 降级组合见 `D2`) | `D2` | -| `msgx.pipeline.backoff-ms` | 档位数必须等于 `max-attempts - 1` | 退避表(implementation.md「参数」) | +| 运营日时区(`PARAM:msgx.operation-day.zone`) | 必须是可解析的 IANA 时区 | 启动自检 `OperationDayZoneCheck` | +| 切日边界(`PARAM:msgx.operation-day.cutoff-hour`) | 取值 0–23 | 启动自检 `OperationDayZoneCheck` | +| Kafka 生产者幂等三项 | `D2` 三键联合满足幂等生产前提(`all`+`true`+`1`;旧 Broker 降级组合见 `D2`) | 启动自检 `KafkaD3Check` | +| 退避表(`PARAM:msgx.pipeline.backoff-ms`) | 档位数必须等于 max-attempts − 1 | 启动自检 `PipelineConfigCheck` | **缺值**:带环境变量占位的必需键(`MSGX_PG_URL`、`MSGX_MAILBOX_URL`、`MSGX_KAFKA_SERVERS` 等)缺失时由 DI 解析失败拒绝启动,无需自检代码。