21 张核心表
2026-11-21·8 分钟
数据库:Cloudflare 数据库与 Drizzle
PGlite / PostgreSQL / Cloudflare D1 三种形态共用一套 Drizzle Schema,含 21 张核心表设计与迁移指南。
21 张核心数据表全景域划分#
系统表结构定义位于 lib/schema.ts 与 lib/auth-schema.ts,按照业务领域划分为五大核心域:
| 业务域 | 数据表名 | 核心字段与关联 | 业务职责 |
|---|---|---|---|
| 认证中心 (Auth) | user, session, account, verification, two_factor | id, email, role, twoFactorEnabled | Better Auth 认证骨架,支持密码、第三方 OAuth 与 2FA |
| 用户画像 (Profile) | user_profile | user_id, display_name, avatar_url, bio | 个性化展示、开发者公开主页与社交信息 |
| 商业计费 (Billing) | subscriptions, invoices, payment_records | user_id, plan_id, status, current_period_end | 套餐订阅状态、账单流水、多通道聚合支付审计对账 |
| AI 网关 (AI Gateway) | ai_wallets, ai_usage_logs, ai_api_keys | user_id, balance, free_quota, model, cost | 用户代币钱包余额、调用审计流水与用户自带 BYOK Key 加密存储 |
| 资产商城 (Store) | skills, skill_purchases, templates, store_orders | slug, price, download_url, license_key | 152 技能库、17 UI 模板、订单与授权 License 验证 |
三种数据库形态一套 Schema#
数据访问层遵循“一套 Drizzle Schema,三种落地形态”:本地零配置 PGlite → 自托管 / 云端 PostgreSQL → Cloudflare 部署时切 D1 或经 Hyperdrive 连接中央 Postgres。切换只是环境变量的差异,21 张表结构完全不变:
env三种数据库形态的配置
# 形态 1:本地开发(零依赖,进程内 WASM Postgres)
PGLITE_DIR=./.pglite
# 形态 2:自托管 / 云 PostgreSQL(Docker、RDS、Neon 等)
DATABASE_URL=postgresql://postgres:root@localhost:5432/saasone
# 形态 3:Cloudflare Workers + Hyperdrive(边缘加速,个位数毫秒延迟)
# DATABASE_URL=postgresql://user:pass@hyperdrive-id.aws-region.neon.tech/saasoneDrizzle Kit 迁移与架构更新#
开发阶段推荐使用 db:push 直接同步表结构变更;生产环境使用 db:generate 生成版本化 SQL 迁移脚本:
bashDrizzle 常用运维命令
# PGlite 模式初始化全部表结构
PGLITE_DIR=./.pglite node scripts/migrate.mjs
# 开发模式直接推送到目标数据库(不中断运行)
pnpm exec drizzle-kit push
# 生产环境生成 SQL 差异文件(存入 drizzle/ 目录)
pnpm exec drizzle-kit generate
# 启动 Drizzle Studio 本地可视化管理面板
pnpm exec drizzle-kit studio双模式自适应数据库连接池#
在 lib/db.ts 中,系统会根据环境变量智能分流:若未配置外部 PostgreSQL,自动初始化单例模式的 PGlite 内存/持久化数据库,并在 Next.js 开发热重载(HMR)期间复用实例,防止频繁建立连接导致端口耗尽。
单进程约束
PGlite 数据目录同一时刻只允许一个进程打开:多个 dev server / 脚本并行访问同一
.pglite 目录会导致 WASM Aborted() 崩溃。重建数据目录:停掉所有进程 → 移走旧目录 → 重跑 scripts/migrate.mjs。