docs(provider): 补充模型服务商配置说明

.craftkit/designs/engineering-baseline/database-design.md

@@ -34,6 +34,7 @@ replacedBy: null
 erDiagram
     AUTH_USER ||--o| USER_PROFILE : has
     AUTH_USER ||--o{ AGENT_RUN : owns
+    AUTH_USER ||--o{ MODEL_PROVIDER_CONFIG : owns
     AGENT_RUN ||--o{ AGENT_RUN_EVENT : contains
     AGENT_RUN ||--o{ TOOL_CALL : contains
     AGENT_RUN ||--o{ HUMAN_APPROVAL : requests
@@ -89,6 +90,21 @@ erDiagram
 - `lock_version >= 0`。
 - token、耗时和费用非负。
 
+### 4.2.1 `agent_runtime_model_provider_config`
+
+| 字段 | 类型建议 | 说明 |
+| --- | --- | --- |
+| `owner_id` | `ForeignKey(PROTECT)` | 用户私有归属 |
+| `provider_code` | `CharField` | 对应代码中的服务商稳定编码 |
+| `encrypted_api_key` | `TextField` | Fernet 密文，禁止通过页面或 Admin 展示 |
+| `key_hint` | `CharField` | 仅保存末四位提示 |
+| `status`、`enabled`、`is_default` | 状态字段 | 连接状态和当前默认选择 |
+| `default_model_id` | `CharField` | 用户选择或预设推荐模型 |
+| `available_models` | `JSONField` | 最近一次验证取得的模型标识快照 |
+| `last_verified_at`、`last_error_code` | 审计字段 | 验证时间和稳定错误码 |
+
+唯一约束为 `(owner_id, provider_code)`。API Key 加密主密钥只从部署环境读取，不进入数据库；主密钥轮换必须先完成密文重加密，不能直接替换后重启。
+
 跨字段状态不变量仍由服务层验证，因为 SQLite 与 PostgreSQL 对复杂检查约束和时间语义的行为需要保持一致。
 
 ### 4.3 `agent_runtime_agent_run_event`