用途:为 Grey Haven 多租户数据库 schema 提供统一规范,适用于 Drizzle ORM(TypeScript)与 SQLModel(Python)两种技术栈,用于设计新 schema、编写模型、迁移、RLS 策略、索引与关系,以及 PR 中的数据库代码审查。
主要能力与关键规则:字段一律使用 snake_case,禁止 camelCase;每张表必须包含 tenant_id 以实现数据隔离;所有表需有 created_at 与 updated_at 时间戳;带 tenant_id 的表需启用行级安全(RLS)并配置租户隔离策略。命名约定:布尔字段用 is_/has_/can_ 前缀,时间戳用 _at 后缀,外键用 _id 后缀。索引方面需为 tenant_id、外键、唯一约束字段及高频查询字段建立索引,并可用复合索引。关系需显式定义一对多等关联。查询应使用 ORM 而非原始 SQL,软删除使用 deleted_at 而非硬删除。
使用方式:Drizzle 安装命令为 bun add drizzle-orm postgres 与 bun add -d drizzle-kit,迁移命令为 bun run drizzle-kit generate:pg 与 bun run drizzle-kit push:pg。SQLModel 安装命令为 pip install sqlmodel psycopg2-binary,迁移使用 alembic revision --autogenerate -m "Add users table" 与 alembic upgrade head。RLS 通过 ALTER TABLE ... ENABLE ROW LEVEL SECURITY 与 CREATE POLICY 配置。
适用场景:设计新数据库 schema、创建 Drizzle 或 SQLModel 模型、编写迁移、设置 RLS、添加索引、定义表关系、审查数据库代码。
限制:资料未提供具体收费、价格、平台支持范围或性能效果数据;示例与参考文件均小于 500 行,具体内容需查阅对应文档。