AIclinicalresearch/docs/01-平台基础层/07-数据库/00-数据库架构总览.md

数据库架构总览

版本: v1.0
更新日期: 2026-02-27
数据来源: 本地开发数据库实时查询

---

1. 基本信息

项目	值
数据库引擎	PostgreSQL 15.15
ORM	Prisma 6.17.0
数据库名	ai_clinical_research
Schema 数量	14 个（含 public）
表总数	96 张
列总数	1217 个
索引总数	339 个
外键关系	53 条
扩展	pgvector 0.8.1, pg_bigm 1.2
迁移历史	14 个已应用迁移

---

2. Schema 全景图

                    AI 临床研究平台 — 数据库 Schema 全景图
 ┌─────────────────────────────────────────────────────────────────────────┐
 │                        platform_schema (19 表)                         │
 │  用户、租户、权限、模块、pg-boss 队列                                    │
 │  tenants → users → tenant_members → departments                       │
 │  modules → permissions → role_permissions → user_modules               │
 │  job / queue / schedule / subscription (pg-boss 异步任务)               │
 ├─────────────────────────────────────────────────────────────────────────┤
 │                        capability_schema (4 表)                        │
 │  Prompt 模板管理 + 系统知识库                                            │
 │  prompt_templates → prompt_versions                                    │
 │  system_knowledge_bases → system_kb_documents                          │
 ├─────────────────────────────────────────────────────────────────────────┤
 │  agent_schema (6 表)          │  ekb_schema (3 表)                     │
 │  通用 Agent 定义/编排/追踪     │  企业知识库(向量)                       │
 │  agent_definitions            │  ekb_knowledge_base                    │
 │    → agent_stages             │    → ekb_document                      │
 │    → agent_prompts            │      → ekb_chunk (vector 1024)         │
 │    → agent_sessions           │                                        │
 │      → agent_traces           │                                        │
 │    → reflexion_rules          │                                        │
 ├───────────────────────────────┴────────────────────────────────────────┤
 │                   admin_schema (2 表)                                   │
 │  运营管理：admin_operation_logs, simple_logs                            │
 ├─────────────────────────────────────────────────────────────────────────┤
 │                                                                         │
 │  ┌── 业务模块层 ──────────────────────────────────────────────────────┐  │
 │  │                                                                     │  │
 │  │  iit_schema (20 表)        │  ssa_schema (11 表)                   │  │
 │  │  IIT 临床试验管理 Agent     │  智能统计分析                          │  │
 │  │  projects (中心)            │  ssa_sessions (中心)                   │  │
 │  │    → conversation_history  │    → ssa_messages                     │  │
 │  │    → audit_logs            │    → ssa_execution_logs               │  │
 │  │    → pending_actions       │    → ssa_workflows                    │  │
 │  │    → task_runs             │      → ssa_workflow_steps             │  │
 │  │    → user_mappings         │  ssa_tools_library (vector 1024)      │  │
 │  │  field_metadata, qc_logs   │  ssa_r_code_library                   │  │
 │  │  equery, critical_events   │  ssa_decision_table                   │  │
 │  │  skills, weekly_reports    │  ssa_guardrail_config                 │  │
 │  │  agent_trace, record_summary│  ssa_param_mapping                   │  │
 │  │  qc_reports, qc_project_stats│ ssa_interpretation_templates        │  │
 │  │                             │                                      │  │
 │  │  asl_schema (11 表)        │  rvw_schema (1 表)                    │  │
 │  │  AI 智能文献                │  稿件审查                             │  │
 │  │  screening_projects (中心)  │  review_tasks                        │  │
 │  │    → literatures           │                                       │  │
 │  │    → screening_tasks       │  dc_schema (6 表)                     │  │
 │  │    → screening_results     │  数据清洗整理                          │  │
 │  │    → fulltext_screening_*  │  dc_templates                         │  │
 │  │  research_tasks            │    → dc_extraction_tasks              │  │
 │  │  extraction_templates      │      → dc_extraction_items            │  │
 │  │    → extraction_project_*  │  dc_tool_c_sessions                   │  │
 │  │      → extraction_tasks    │  dc_tool_c_ai_history                 │  │
 │  │        → extraction_results│  dc_health_checks                     │  │
 │  │                             │                                      │  │
 │  │  aia_schema (3 表)         │  protocol_schema (2 表)               │  │
 │  │  AI 智能问答                │  方案 Agent                           │  │
 │  │  projects → conversations  │  protocol_contexts                    │  │
 │  │    → messages              │    → protocol_generations             │  │
 │  │                             │                                      │  │
 │  │  pkb_schema (5 表)         │  public (3 表)                        │  │
 │  │  个人知识库                 │  _prisma_migrations                   │  │
 │  │  knowledge_bases           │  users (遗留), admin_logs (遗留)       │  │
 │  │    → documents             │                                       │  │
 │  │    → batch_tasks           │                                       │  │
 │  │      → batch_results       │                                       │  │
 │  │  task_templates            │                                       │  │
 │  └─────────────────────────────┴──────────────────────────────────────┘  │
 └─────────────────────────────────────────────────────────────────────────┘

---

3. Schema 清单

#	Schema	表数	列数	归属模块	职责描述
1	platform_schema	19	~200	平台基础层	用户、租户、权限、pg-boss 任务队列
2	capability_schema	4	~38	通用能力层	Prompt 模板管理、系统知识库
3	agent_schema	6	~71	通用能力层	通用 Agent 定义、编排、运行追踪
4	ekb_schema	3	~38	通用能力层	企业知识库（向量检索）
5	admin_schema	2	~21	运营管理	操作日志、简单日志
6	iit_schema	20	~246	IIT Manager Agent	项目管理、质控、eQuery、重大事件
7	ssa_schema	11	~117	智能统计分析	会话、工作流、工具库、R 代码库
8	asl_schema	11	~235	AI 智能文献	文献筛选、全文复筛、数据提取
9	rvw_schema	1	~26	稿件审查	审查任务
10	dc_schema	6	~83	数据清洗	模板、提取任务、AI 对话
11	aia_schema	3	~32	AI 智能问答	项目、对话、消息
12	protocol_schema	2	~29	方案 Agent	方案上下文、方案生成
13	pkb_schema	5	~66	个人知识库	知识库、文档、批处理
14	public	3	~31	系统/遗留	Prisma 迁移表 + 遗留 users/admin_logs

合计：14 个 Schema，96 张表，~1217 列

---

4. 向量检索表

Schema	表	向量列	维度	用途
iit_schema	conversation_history	embedding	1536	IIT 对话语义搜索
ekb_schema	ekb_chunk	embedding	1024	企业知识库 RAG 检索
ssa_schema	ssa_tools_library	embedding	1024	SSA 工具语义匹配

---

5. pg-boss 任务队列表

platform_schema 中有 5 张 pg-boss 管理的表：

表	职责
job	活跃任务
job_common	公共任务配置
queue	队列定义
schedule	定时任务调度
subscription	事件订阅

详细使用指南见 docs/07-运维文档/01-PgBoss队列监控与维护.md

---

6. 跨文档索引

关注点	文档位置
数据库开发规范	docs/04-开发规范/09-数据库开发规范.md
迁移历史	docs/01-平台基础层/07-数据库/01-Prisma迁移历史与变更日志.md
环境差异	docs/01-平台基础层/07-数据库/02-环境状态对照表.md
技术债务	docs/01-平台基础层/07-数据库/03-技术债务追踪.md
种子数据	docs/01-平台基础层/07-数据库/04-种子数据管理.md
扩展特性	docs/01-平台基础层/07-数据库/05-PostgreSQL扩展与特性.md
部署迁移	docs/05-部署文档/*/01-数据库迁移方案.md
运维注意事项	docs/07-运维文档/03-数据库迁移注意事项.md
Prisma 操作指南	docs/09-架构实施/J技术架构咨询/数据库同步规范与Prisma操作指南.md