扩展

扩展 SaaScaffold,不必分叉底座

你的代码、文案和数据表与底座分开存放,你可以在上面做自己的产品,同时照常合并每次底座更新。

你的文件与底座的文件

修改标为“你的”的文件,不动底座文件,更新就能顺利合并。

路径存放什么归属
apps/web/src/site/config.ts本站配置,以及新增的导航、页脚和 SEO 条目你的
apps/web/src/site/messages.ts本站文案,以及对底座措辞的覆盖你的
packages/db/src/schema/site/你自己的数据表你的
packages/db/migrations/site/你的数据表对应的迁移你的
site/站点信息、建站清单、部署状态和执行记录你的
apps/web/src/i18n/messages.ts底座文案。要改措辞,在 src/site/messages.ts 里写同名键底座
apps/web/src/config/site-config.base.ts底座的导航、SEO 路径和配置校验底座
packages/db/src/schema/pg/, sqlite/底座数据表,每个模块一个文件底座
packages/db/migrations/pg/, d1/底座迁移及其历史底座

两条迁移通道

底座和本站各自记录迁移历史,你的数据表不会与底座更新冲突。

数据库底座历史本站历史
PostgreSQLdrizzle.__drizzle_migrationsdrizzle.__drizzle_site_migrations
Cloudflare D1d1_migrationsd1_site_migrations

pnpm db:migrate 和 pnpm release 都先执行底座迁移,再执行本站迁移。

合并底座更新

更新以 Git 提交的形式发布在上游分支。

  1. 合并更新

    合并上游分支并保留你的修改。你自己的文件很少冲突。

  2. 执行迁移

    pnpm db:migrate 把新的底座迁移应用到本地数据库。

  3. 运行测试

    先跑单元测试,部署前再跑完整检查。

  4. 发布

    经你授权后,pnpm release 执行迁移并部署。

接入新供应商

新的支付或 AI 供应商只是边缘的新代码,中间的业务规则保持不变。

支付渠道

你要写的

  • 负责收银台、通知和退款的适配器
  • 它的密钥和设置从哪里读取
  • 它在后台和订单页面上的名称
  • 它真正支持的订阅操作

直接复用的

  • 订单快照与服务端核查
  • 防重复的事件处理
  • 付款与积分的原子写入
  • 积分账本、退款流程和后台订单

AI 供应商

你要写的

  • 针对其 API 的请求与结果映射
  • 如实声明它能做到什么
  • 它所提供模型的目录条目
  • 它在 Worker 中需要的密钥

直接复用的

  • 报价与积分冻结
  • 队列、租约和每五分钟一次的巡检
  • 输出校验与可选的内容审核
  • 私有交付与结算

让它保持可扩展的约定

几条约定承担了大部分工作。

  • 路由保持精简;服务端 action 负责权限和输入校验;每个模块的数据读写在 repository.ts,业务规则在 service.server.ts。
  • 必须一起生效的写入,例如付款和它发放的积分,放在同一个原子调用里。
  • 需要给底座表加字段?新建一张以底座表主键为主键的本站表,例如 site_user_profiles.user_id。
  • 已发布的订阅商品不再修改。新价格使用新的商品 ID,已有订阅者保持原有条款。

获取 SaaScaffold 源码

一次购买,填写 GitHub 用户名即可领取私有仓库的访问权限。

购买了解 Agent 如何使用它