# AI 合同平台 V2 数据库环境登记表

日期：2026-06-28

## 当前结论

`yuqei-contract-v2-smoke` Docker 环境已完成当前 V2 代码部署和数据库核验，正式登记为当前 V2 dev/smoke 权威环境。

权威范围：

- 用于 V2 本地联调、准生产 smoke、迁移验证、接口压测、安全扫描后的回归验证。
- 不代表正式生产数据库。
- 旧库和临时库保持只读/对照状态，不作为后续默认写入目标。

## 权威 V2 Smoke 环境

远端主机：`192.168.3.90`

Docker project：`yuqei-contract-v2-smoke`

远端项目目录：`/opt/apps/ai-contract-platform-v2-smoke`

| 服务 | 宿主机端口 | 状态 |
| --- | --- | --- |
| PostgreSQL | `15432` | running / healthy |
| Redis | `16379` | running / healthy |
| MinIO API | `19000` | running / healthy |
| MinIO Console | `19001` | running / healthy |
| Contract API | `18100` | running / healthy |
| AI Platform API | `18101` | running / healthy |
| Contract Web | `13000` | running / healthy |

数据库：

| 数据库 | 归属 | 核验状态 |
| --- | --- | --- |
| `yuqei_contract` | 合同平台 | 存在，迁移头 `20260628_0017` |
| `yuqei_ai` | AI 中台 | 存在，迁移头 `20260624_0018` |
| `yuqei_ops` | 运维预留 | 存在，当前 0 张业务表 |

扩展：

| 数据库 | 扩展状态 |
| --- | --- |
| `yuqei_contract` | `pg_trgm` 已启用 |
| `yuqei_ai` | `pg_trgm`、`vector` 已启用 |

核心表核验：

`yuqei_contract` 已确认存在：

- `contracts`
- `contract_files`
- `review_tasks`
- `contract_audit_events`
- `contract_search_documents`
- `template_lifecycle_events`
- `template_edit_drafts`
- `legal_asset_lifecycle_events`
- `legal_asset_edit_drafts`
- `legal_change_impact_scans`

`yuqei_ai` 已确认存在：

- `ai_provider_configs`
- `prompt_templates`
- `knowledge_documents`
- `knowledge_chunks`
- `ai_run_audits`
- `ai_quality_improvement_actions`
- `worker_run_executions`

## 非权威环境登记

| 环境 | 入口 | 当前状态 | 结论 | 写入策略 |
| --- | --- | --- | --- | --- |
| V1/旧单体库 | 宿主机 PostgreSQL `5432` / `ai_contract_platform` | 存在，47 张表，迁移头 `20260619_0045` | V1 历史库或旧后端库 | V2 禁止写入，只读参考 |
| V2 合同临时测试库 | 宿主机 PostgreSQL `5432` / `yuqei_contract` | 存在，12 张表，迁移头 `20260628_0017` | 仅合同 API 临时测试库，不是完整三库 V2 环境 | 不再作为默认开发/验收目标 |
| 宿主机 V2 AI 库 | 宿主机 PostgreSQL `5432` / `yuqei_ai` | 不存在 | 宿主机 5432 未完整落地 V2 三库 | 不适用 |
| 宿主机 V2 运维库 | 宿主机 PostgreSQL `5432` / `yuqei_ops` | 不存在 | 宿主机 5432 未完整落地 V2 三库 | 不适用 |

## 后续连接策略

### 本地 Codex 浏览器联调

推荐：

- 前端继续本地运行：`http://localhost:3000`
- 后端可本地运行：`http://localhost:8100`
- 本地后端数据库连接指向权威 smoke PostgreSQL：`192.168.3.90:15432/yuqei_contract`
- AI Platform 联调指向权威 smoke AI Platform 或本地 AI Platform 连接 `192.168.3.90:15432/yuqei_ai`

注意：

- 功能验收不再默认使用 SQLite。
- 宿主机 `5432/yuqei_contract` 仅作临时库和迁移对照，不作为默认目标。

### V1 资产迁移

- `ai_contract_platform` 只读保留。
- V1 资产通过脚本按 V2 模型导入。
- 不复制 V1 单体表结构。

## Phase 0 完成状态

已完成：

1. 部署当前 V2 代码到 Docker smoke。
2. 未重置 Docker volumes。
3. 远端项目代码已备份。
4. 三库存在性核验通过。
5. Contract API 迁移头核验通过。
6. AI Platform 迁移头核验通过。
7. PostgreSQL 扩展核验通过。
8. 核心表核验通过。
9. API/Web 容器健康状态核验通过。

下一阶段进入 Phase 1：运行时 `schema check` 与环境防误连。