SaasOne v2.0 Docs
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_factorid, email, role, twoFactorEnabledBetter Auth 认证骨架,支持密码、第三方 OAuth 与 2FA
用户画像 (Profile)user_profileuser_id, display_name, avatar_url, bio个性化展示、开发者公开主页与社交信息
商业计费 (Billing)subscriptions, invoices, payment_recordsuser_id, plan_id, status, current_period_end套餐订阅状态、账单流水、多通道聚合支付审计对账
AI 网关 (AI Gateway)ai_wallets, ai_usage_logs, ai_api_keysuser_id, balance, free_quota, model, cost用户代币钱包余额、调用审计流水与用户自带 BYOK Key 加密存储
资产商城 (Store)skills, skill_purchases, templates, store_ordersslug, price, download_url, license_key152 技能库、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/saasone

Drizzle 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。