# 环境状态对照表

> 版本: v1.0  
> 更新日期: 2026-02-27  
> 维护说明: 每次部署后更新此表，确保三环境状态可追溯

---

## 1. 环境概览

| 环境 | 数据库类型 | 地址 | 数据库名 | 用户 |
|------|----------|------|---------|------|
| **本地开发** | Docker (pgvector/pgvector:pg15) | localhost:5432 | ai_clinical_research | postgres |
| **测试环境** | 阿里云 RDS PostgreSQL 15 | pgm-2zex1m2y3r23hdn5so.pg.rds.aliyuncs.com:5432 | ai_clinical_research_test | airesearch |
| **生产环境** | 待部署 | — | — | — |

---

## 2. 迁移状态对比

> 截止日期：2026-02-27

| # | 迁移名 | 本地开发 | 测试 RDS | 说明 |
|---|--------|---------|---------|------|
| 1 | 20251010075003_init | ✅ | ✅ | |
| 2 | 20251010122727_add_conversation_metadata_deleted_at | ✅ | ✅ | |
| 3 | 20251012124747_add_batch_processing_module | ✅ | ✅ | |
| 4 | 20251014120128_add_review_tasks | ✅ | ✅ | |
| 5 | 20251208_add_column_mapping | ✅ | ✅ | |
| 6 | 20260128_add_system_knowledge_base | ✅ | ✅ | |
| 7 | 20260207112544_add_iit_manager_agent_tables | ✅ | ✅ | 0227 部署时应用 |
| 8 | 20260208134925_add_cra_qc_engine_support | ✅ | ✅ | 0227 部署时应用 |
| 9 | 20260219_add_ssa_module | ✅ | ✅ | 0227 部署时应用 |
| 10 | 20260223_add_deep_research_v2_fields | ✅ | ✅ | 0227 部署时应用 |
| 11 | 20260225_add_extraction_template_engine | ✅ | ✅ | 0227 部署时应用 |
| 12 | 20260227_patch_db_push_drift | ✅ | ✅ | 0227 部署时应用 |
| 13 | 20260226_add_equery_critical_events_cron | ✅ | ✅ | 0227 部署时应用 |
| 14 | 20260227_align_schema_with_db_types | ✅ | ❌ | 本地对齐，尚未部署到 RDS |

---

## 3. PostgreSQL 扩展对比

| 扩展 | 本地开发 | 测试 RDS | 说明 |
|------|---------|---------|------|
| plpgsql | 1.0 | 1.0 | PostgreSQL 内置 |
| pgvector (vector) | 0.8.1 | 0.8.0 | 向量搜索，RDS 版本略低 |
| pg_bigm | 1.2 | 1.2 | 中文全文检索 |

---

## 4. Schema 结构对比

| Schema | 本地开发 表数 | 测试 RDS 表数 | 差异说明 |
|--------|-------------|-------------|---------|
| platform_schema | 19 | 19 | 一致 |
| capability_schema | 4 | 4 | 一致 |
| agent_schema | 6 | 6 | 一致 |
| ekb_schema | 3 | 3 | 一致 |
| admin_schema | 2 | 2 | 一致 |
| iit_schema | 20 | 20 | 一致（0227 部署后） |
| ssa_schema | 11 | 11 | RDS 缺少 #14 的类型对齐 |
| asl_schema | 11 | 11 | 一致 |
| rvw_schema | 1 | 1 | 一致（0227 补 8 列后） |
| dc_schema | 6 | 6 | 一致 |
| aia_schema | 3 | 3 | 一致 |
| protocol_schema | 2 | 2 | 一致 |
| pkb_schema | 5 | 5 | 一致 |
| public | 3 | 3 | 一致 |

---

## 5. 已知的环境差异

### 5.1 测试 RDS 待部署项

| 项目 | 内容 | 优先级 | 风险 |
|------|------|--------|------|
| 迁移 #14 | ssa_workflows 类型精度对齐 + 重复 FK 清理 | 低 | 无数据影响，幂等 SQL |

### 5.2 本地开发特有

| 项目 | 说明 |
|------|------|
| `prisma db push` 产生的额外结构 | 部分表/列未通过迁移创建，已由 #12 drift patch 覆盖 |
| Shadow DB 重放失败 | #10 迁移依赖 `research_tasks`（非迁移创建），影响 `prisma migrate dev` |

---

## 6. 更新日志

| 日期 | 操作人 | 变更 |
|------|--------|------|
| 2026-02-27 | AI 助手 | 初始化文档，记录 0227 部署后状态 |

---

## 7. 维护规则

- **每次部署后**：更新第 2 节迁移状态和第 4 节表数
- **新增扩展后**：更新第 3 节扩展对比
- **发现差异时**：记录在第 5 节，标注优先级和风险