feat: use postgres

notification/docs/runtime.md

@@ -129,7 +129,9 @@ Startup fails fast on invalid configuration or unavailable Redis.
 
 Required:
 
-- `NOTIFICATION_REDIS_ADDR`
+- `NOTIFICATION_REDIS_MASTER_ADDR`
+- `NOTIFICATION_REDIS_PASSWORD`
+- `NOTIFICATION_POSTGRES_PRIMARY_DSN`
 - `NOTIFICATION_USER_SERVICE_BASE_URL`
 
 Core process config:
@@ -144,12 +146,12 @@ Internal HTTP config:
 - `NOTIFICATION_INTERNAL_HTTP_READ_TIMEOUT` with default `10s`
 - `NOTIFICATION_INTERNAL_HTTP_IDLE_TIMEOUT` with default `1m`
 
-Redis connectivity:
+Redis connectivity (master/replica/password shape; the deprecated
+`NOTIFICATION_REDIS_ADDR`, `NOTIFICATION_REDIS_USERNAME`, and
+`NOTIFICATION_REDIS_TLS_ENABLED` env vars are rejected at startup):
 
-- `NOTIFICATION_REDIS_USERNAME`
-- `NOTIFICATION_REDIS_PASSWORD`
+- `NOTIFICATION_REDIS_REPLICA_ADDRS` (optional, comma-separated)
 - `NOTIFICATION_REDIS_DB`
-- `NOTIFICATION_REDIS_TLS_ENABLED`
 - `NOTIFICATION_REDIS_OPERATION_TIMEOUT`
 - `NOTIFICATION_INTENTS_STREAM`
 - `NOTIFICATION_INTENTS_READ_BLOCK_TIMEOUT`
@@ -157,6 +159,14 @@ Redis connectivity:
 - `NOTIFICATION_GATEWAY_CLIENT_EVENTS_STREAM_MAX_LEN`
 - `NOTIFICATION_MAIL_DELIVERY_COMMANDS_STREAM`
 
+PostgreSQL connectivity:
+
+- `NOTIFICATION_POSTGRES_REPLICA_DSNS` (optional, comma-separated)
+- `NOTIFICATION_POSTGRES_OPERATION_TIMEOUT`
+- `NOTIFICATION_POSTGRES_MAX_OPEN_CONNS`
+- `NOTIFICATION_POSTGRES_MAX_IDLE_CONNS`
+- `NOTIFICATION_POSTGRES_CONN_MAX_LIFETIME`
+
 Retry and retention:
 
 - `NOTIFICATION_PUSH_RETRY_MAX_ATTEMPTS`
@@ -164,9 +174,12 @@ Retry and retention:
 - `NOTIFICATION_ROUTE_BACKOFF_MIN`
 - `NOTIFICATION_ROUTE_BACKOFF_MAX`
 - `NOTIFICATION_ROUTE_LEASE_TTL`
-- `NOTIFICATION_DEAD_LETTER_TTL`
-- `NOTIFICATION_RECORD_TTL`
 - `NOTIFICATION_IDEMPOTENCY_TTL`
+- `NOTIFICATION_RECORD_RETENTION` (replaces the legacy
+  `NOTIFICATION_RECORD_TTL`; cascades to `routes` and `dead_letters`)
+- `NOTIFICATION_MALFORMED_INTENT_RETENTION` (replaces the legacy
+  `NOTIFICATION_DEAD_LETTER_TTL`)
+- `NOTIFICATION_CLEANUP_INTERVAL` (period of the SQL retention worker)
 
 User enrichment: