全部文章

SaaScaffold 包含哪些功能

九个圆角方块排成逐级上升的台阶

一个站点、一个数据库、一套积分账本

SaaScaffold 是 SaaS 站点的源码底座。每个部署都有自己的用户、订单、积分、任务和文件。部署内的模块共用一个数据库。支付验证和发放积分在同一笔事务中完成,AI 任务的结果也和对应积分变化一起写入。重试可以查回原记录,避免重复修改余额。

技术栈

TypeScript 应用使用 React 和 TanStack Start,运行在 Cloudflare Workers 上。Drizzle 支持 Cloudflare D1 和 PostgreSQL,公有和私有文件放在 R2。后台工作由 Cloudflare Queues 和 Cron 执行,事务邮件和 Turnstile 可按站点配置。

内置模块

  • 账号和认证。 邮箱验证、密码重置、Google 登录,以及由用户确认的登录方式绑定。
  • 支付和订阅。 Stripe、PayPal、Waffo 和 Dodo Payments 共用订单记录和积分账本。一次性购买或订阅周期付款通过验证后都可以发放积分。
  • 积分。 积分按批次过期。冻结、扣除、释放和管理员调整都记入账本。另见 AI 任务如何冻结和结算积分。
  • 存储和 AI。 公有和私有文件分开。AI 适配器可连接 APIMart、fal.ai、Kie 和 SeeAPI,具体能生成文本、图片、视频、语音还是音乐,取决于启用的模型。
  • 用户中心与管理后台。 用户可以查账号、订单、积分、文件和工单,管理员可以管理对应模块并配置通知。
  • Agent 手册。 Claude Code 和 Codex 可以按仓库手册完成换品牌、本地检查、配置和 Cloudflare 发布。

从本地开发开始

配置 Cloudflare 账号之前,可以先用本地 D1 运行。首次检出后,按仓库说明执行:

pnpm install
cp apps/web/.dev.vars.example apps/web/.dev.vars
pnpm db:migrate
pnpm dev

仓库含测试和发布检查。运行 PostgreSQL 测试时需要专用的临时测试库。

从代码到上线还要做什么?

每个部署独立配置和验收源码中的集成。上线前,请使用自己的账号,按发布清单验证支付、邮件和 AI 服务。SaaScaffold Early Access 以商业许可提供私有仓库的访问权限。包含内容和邮件申请流程见价格页。

资料和延伸阅读