外观
数据库与数据流总览
FitDoc 后端使用 PostgreSQL 作为业务数据、审计日志、聊天记录、运动处方和 RAG 知识切片的统一持久化底座。当前生产库为阿里云 RDS core_base，public schema 已按 Alembic head 7d18e9f1a2b4 对齐。
当前基线
| 项目 | 当前值 |
|---|---|
| 数据库 | Aliyun RDS PostgreSQL |
| 数据库名 | core_base |
| PostgreSQL 版本 | 以 RDS show server_version 为准；运维手册记录为 PostgreSQL 18.1 |
| Alembic current | 7d18e9f1a2b4 |
| Extensions | vector 0.8.1、uuid-ossp 1.1、plpgsql 1.0 |
| 连接范围 | RDS 公网未开放，后端通过 ECS/VPC 内网访问 |
| 当前生产拓扑 | Nginx -> fitdoc-core:8001 -> RDS core_base |
表域划分
| 域 | 表 | 主要职责 |
|---|---|---|
| 用户与档案 | users、user_profiles、user_diseases、user_operations、user_health_profiles | 认证主体、基础资料、健康指标、疾病/手术史、评估快照 |
| Chat | chat_sessions、dialogue_logs、dialogue_logs_archive | 会话分组、对话记录、冷数据归档 |
| 运动与处方 | sport_schemes、sport_logs | 运动处方主表、运动执行记录 |
| 安全与陪伴 | safety_incidents、virtual_companion | 安全事件、虚拟陪练配置 |
| 认证与审计 | sms_verifications、login_logs、update_logs、data_migration_log、system_configs | 短信验证码、登录日志、资料变更日志、迁移记录、系统配置 |
| RAG | knowledge_chunks、rag_knowledge_items、rag_vector_index | 当前知识切片主表与 legacy RAG 残留表 |
| Migration | alembic_version | 数据库迁移版本记录 |
表清单
以下行数来自生产 catalog 估算值，只用于判断表规模和交接范围，不作为审计计数。
| 表名 | 估算行数 | 归属 | 说明 |
|---|---|---|---|
alembic_version | 1 | Migration | 当前 Alembic 版本 |
users | 40 | User | 用户认证与基础资料 |
user_profiles | 24 | User/Profile | 健康指标、肿瘤档案概览、assessment context |
user_diseases | 27 | User/Profile | 用户疾病史 |
user_operations | 170 | User/Profile | 用户手术史 |
user_health_profiles | 55 | Assessment | 安全检查与完整评估快照 |
sport_schemes | 163 | Sport/Prescription | 运动处方主表 |
sport_logs | 76 | Sport | 运动执行记录 |
chat_sessions | 149 | Chat | AI 会话分组 |
dialogue_logs | 363 | Chat | AI 对话记录 |
dialogue_logs_archive | 3 | Chat/Archive | 对话冷数据归档 |
safety_incidents | 0 | Safety | AI 安全事件 |
virtual_companion | 0 | Companion | 虚拟陪练配置 |
system_configs | 0 | System | 系统配置与 feature flag |
sms_verifications | 114 | Auth | 短信验证码 |
login_logs | 419 | Auth/Audit | 登录审计 |
update_logs | 1490 | Audit | 用户资料变更审计 |
data_migration_log | 1 | Migration | 数据迁移日志 |
knowledge_chunks | 1038 | RAG | 当前 RAG canonical 知识切片与向量表 |
rag_knowledge_items | 0 | RAG Legacy | 旧 RAG 知识表，保留但非主路径 |
rag_vector_index | 0 | RAG Legacy | 旧 RAG 向量索引表，保留但非主路径 |
结构阅读入口
| 文档 | 用途 |
|---|---|
| 核心业务表 | 查看业务表字段、关系、索引和读写路径。 |
| 知识库与 RAG 表 | 查看 knowledge_chunks、legacy RAG 表、知识文件与检索边界。 |
| ER 模型与表关系 | 查看用户、聊天、运动、评估、RAG 的表关系。 |
| 核心数据流 | 查看 App/API/use case/repository/DB/RAG 的读写链路。 |
来源锚点
- Production catalog: RDS
core_base只读查询alembic_version、pg_extension、information_schema、pg_constraint、pg_indexes - ORM:
apps/backend_service/app/models/ - Migrations:
apps/backend_service/alembic/versions/ - Repository:
apps/backend_service/app/repositories/ - Runtime docs:
docs/新服务器运维手册.md - Schema snapshot:
docs/数据库架构.md