fix(gateway): guard nats stream retention and writer timeouts

docs/ops/100k-capacity-baseline.md

@@ -88,6 +88,19 @@ systemd gateway 已配置 `LimitNOFILE=1048576`，需要持续保持。
 | Realtime MySQL | async queue depth | 不持续增长 |
 | Stat writer | `vehicle_stat_write_duration_ms_histogram_bucket` | p99 不持续上升 |
 
+## Retention Guardrails
+
+10W 车辆接入时，中间件只承担解耦和短期缓冲职责，不能成为长期历史库。
+
+| Component | Guardrail |
+| --- | --- |
+| NATS JetStream `VEHICLE_INGEST` | `NATS_STREAM_MAX_BYTES=21474836480`，`NATS_STREAM_MAX_AGE_HOURS=24`，`NATS_STREAM_ENSURE_TIMEOUT_SECONDS=60` |
+| Kafka `vehicle.raw.go.*` / `vehicle.fields.go.*` | `retention.ms=21600000`、`segment.ms=600000`、`segment.bytes=268435456` |
+| Fast writer | `FAST_WRITER_OPERATION_TIMEOUT_MS=1000`，避免 TDengine 批量写尾延迟导致整批重投 |
+| Root disk | 使用率低于 `80%`，超过 `85%` 进入容量告警 |
+
+如果 NATS `consumer_pending` 下降但仍高，说明系统在追历史积压；如果 `ack_pending=0` 且 Kafka lag 为 `0`，不要重启服务，重点观察 NATS data size 和 pending 下降斜率。
+
 ## 分阶段压测
 
 压测入口：