---
inclusion: fileMatch
fileMatchPattern:
  - "**/migrations/**/*.*"
  - "**/*.sql"
  - "**/*schema*.*"
  - "**/*ddl*.*"
  - "**/*.prisma"
---

# Database Schema Documentation Rules

当你修改任何可能影响 PostgreSQL schema/表结构的内容时（迁移脚本/DDL/表定义/ORM 模型）：

1) 必须同步更新 BD 手册目录：
   docs/database

2) 文档最低要求：
   - 变更说明：新增/修改/删除的表、字段、约束、索引
   - 兼容性：对 ETL、后端 API、小程序字段映射的影响
   - 回滚策略：如何撤销（DDL 回滚 / 数据回填）
   - 验证步骤：最少包含 3 条校验 SQL