ai-contract-platform/project-docs/V2-active-database-registry-2026-06-28.md

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 与环境防误连。