digital-psychology/apps/docs/standards/04-database.md

04 数据库规范

引擎

PostgreSQL（主库）。本地可用 Docker Compose。

命名

• 表：snake_case 单数或清晰业务名，如 user_profile、payment_order、user_session。
• 禁止 tbl_ / t_ 前缀。
• 字段：snake_case。

公共字段

每张业务表默认包含：

id          BIGSERIAL PRIMARY KEY  -- 或 UUID，项目内统一一种
created_at  TIMESTAMPTZ NOT NULL DEFAULT now()
updated_at  TIMESTAMPTZ NOT NULL DEFAULT now()
deleted_at  TIMESTAMPTZ NULL          -- 软删除

迁移

• 使用 goose（或 golang-migrate），文件放 apps/api/migrations/。
• 迁移必须可回滚（提供 Down）。
• 禁止手改生产库结构而不留迁移文件。

索引

• 高频查询字段建索引；唯一业务键用 UNIQUE。
• 写迁移时注明索引意图。

敏感数据

• 生日等：最小化存储；访问打审计日志（后置也可先文档约定）。
• 密钥、支付信息不得明文进业务表。