docs: 统一术语、收紧需求验收范围、修正 Q3 归属
- "自有业务数据库" → "自有 PG",与 specification/architecture 统一 - US-05 AC1 钉死现场 7 类子类型,白名单其余待 Q3 确认后增补 - US-05 AC3 恢复未映射字段唯一键(信箱编号+路径+出现序号) - US-09 AC1 恢复旧请求作废可观察约束 - implementation.md VIPP/未映射字段去掉误引 Q3(不在 Q3 范围) - 精简 architecture/requirements 系统定位复述与实现机制泄漏
This commit is contained in:
+5
-5
@@ -6,7 +6,7 @@
|
||||
|
||||
## 1. 参数注册表
|
||||
|
||||
「依据」列含义:**契约** = 由 [specification.md](specification.md) 的 `C-x` 决定;**现役** = 沿用 legacy 行为基线;**假定** = 无依据的占位值,必须在对应 `Q` 关闭后重评;**安全默认** = 关闭态,需显式开启。
|
||||
「依据」列含义:**契约** = 由 [specification.md](specification.md) 的 `C-x` 决定;**现役** = 沿用 legacy 行为基线;**实现** = 当前代码采用的机制,取值并非需求契约;**假定** = 无依据的占位值,必须在对应 `Q` 关闭后重评;**安全默认** = 关闭态,需显式开启。
|
||||
|
||||
### 1.1 管道节奏与重试(`msgx.pipeline.*`)
|
||||
|
||||
@@ -61,9 +61,9 @@
|
||||
| `mailbox.shared-mysql.url` | 环境变量 | 安全 | 零入库,见 `.env.example`;同组 `username` / `password` |
|
||||
| `datasources.default.connection-timeout` | `5000` | 假定 | 自有 PG 池(毫秒数,非 Duration 字面量);同组 `validation-timeout=3000`、`idle-timeout=300000`、`max-lifetime=1800000` |
|
||||
| `datasources.default.data-source-properties.connectTimeout` | `3` | 假定 | 驱动级连接超时(秒);同组 `socketTimeout=30` |
|
||||
| `kafka.producers.default.acks` | `all` | 契约(`D2`) | 允许环境变量覆盖 |
|
||||
| `kafka.producers.default.enable-idempotence` | `true` | 契约(`D2`) | 允许环境变量覆盖 |
|
||||
| `kafka.producers.default.max-in-flight-requests-per-connection` | `1` | 契约(`D2`) | 启动自检钉住三项联合满足 `D2`;允许环境变量覆盖 |
|
||||
| `kafka.producers.default.acks` | `all` | 实现(`D2`) | 允许环境变量覆盖 |
|
||||
| `kafka.producers.default.enable-idempotence` | `true` | 实现(`D2`) | 允许环境变量覆盖 |
|
||||
| `kafka.producers.default.max-in-flight-requests-per-connection` | `1` | 实现(`D2`) | 启动自检校验当前三项配置;允许环境变量覆盖 |
|
||||
|
||||
环境变量清单以 `.env.example` 为准。
|
||||
|
||||
@@ -100,7 +100,7 @@
|
||||
| 回填与投递 | `processing/BackfillService.kt`、`delivery/Dispatcher.kt`、`infra/kafka/KafkaDeliveryPort.kt` |
|
||||
| 维护作业 | `jobs/JobRunner.kt`、`jobs/HistorySweepJob.kt`、`jobs/EventCleanupJob.kt`、`infra/persistence/SnapshotLogPurge.kt` |
|
||||
| 持久化与恢复 | `infra/persistence/`(含 `jdbc/JdbcPgRepositories.kt`、`jdbc/JdbcCminmsgInboxRepository.kt`)、`infra/retry/`(`ProcFailure` / `ReplayService` / `FailureScheduler`) |
|
||||
| 启停与配置 | `PipelineLifecycle.kt`、`config/PipelineProps.kt`、`config/HistoryProps.kt`、`config/OperationDayProps.kt`(含运营日时区启动自检)、`config/MailboxProps.kt`、`config/KafkaD3Check.kt`(`D2` 三联合启动自检) |
|
||||
| 启停与配置 | `PipelineLifecycle.kt`、`config/PipelineProps.kt`、`config/HistoryProps.kt`、`config/OperationDayProps.kt`(含运营日时区启动自检)、`config/MailboxProps.kt`、`config/KafkaD3Check.kt`(当前 Kafka 生产配置自检) |
|
||||
| 指标与健康 | `infra/metrics/PipelineMetrics.kt`、`infra/metrics/JobActivity.kt`、`infra/health/BacklogSnapshotProvider.kt`、`infra/health/JobRunnerHealthIndicator.kt` |
|
||||
| 迁移 | `src/main/resources/db/migration/`(单基线 `V1__flight_state_baseline.sql`;`oracle11g/` 为占位) |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user