文档

上手指南:如何配置和扩展这个启动模板。

快速开始

2025年9月29日

本地启动 Sushi SaaS 模板,查看 i18n 路由、健康检查和 MDX 博客,了解认证、支付与文档的配置入口。

setupi18nMDX
快速开始

认证与管理架构

2025年9月29日

深入说明本模板中的 Better Auth 会话机制、OAuth、RBAC,以及积分/配额等业务数据建模方式。

authadminoauthsessions
认证与管理架构

Stripe 集成与配置

2025年9月29日

使用 Stripe Checkout 完成支付,并通过 Webhook 最终写入积分。讲解环境变量配置、会话创建、回调处理以及签名 Webhook 的验证与处理。

Stripe支付webhook
Stripe 集成与配置

通知 - Slack 警报

2025年10月11日

为上传与支付配置简单的 Slack 通知,将其接入 Stripe Webhook 与存储错误,并通过轻量服务器工具灵活自定义。

通知Slackwebhooks
通知 - Slack 警报

私有文件上传(S3 / R2)

2025年10月07日

一步一步、面向新手地为应用添加“用户私有上传”,对接 S3 兼容存储。涵盖概念、配置、环境变量、API、UI、错误排查,以及 S3 与 R2 的切换。

storageuploadsS3R2
私有文件上传(S3 / R2)

日志与可观测性

2025年10月11日

Node、Edge 与 Workers 通用的结构化日志:请求ID、敏感信息脱敏与路由示例;适配 Vercel、Cloudflare 与 Node 服务器。

日志可观测性NodeEdge
日志与可观测性

邮件服务(Resend)

2025年9月29日

集成 Resend 发送事务性邮件。完成域名验证、创建 API Key,在服务端渲染欢迎/支付邮件模板,并通过 Resend 按环境配置发送。

emailResend模板
邮件服务(Resend)

数据库配置

2025年9月29日

使用 Postgres 与 Drizzle ORM 为 Better Auth 和业务表搭建数据层。

databaseDrizzlePostgres
数据库配置

账户、订单与积分

2025年9月29日

了解在 Sushi SaaS 模板中 users、orders 与 credits 台账如何协同工作,掌握余额计算、过期处理,以及授予 / 消费 / 查询积分的 API 与服务。

积分订单台账Stripe
账户、订单与积分

基于积分的任务 — 文本生成视频

2025年10月11日

使用通用的 `tasks` 表、积分台账与可插拔的文本转视频生成器,快速实现按量计费。本文涵盖表结构、API、配置常量与最小 UI。

creditstasksaivideo
基于积分的任务 — 文本生成视频

预约功能 — 可用时段、订金、Google 日历

2025年9月29日

基于营业时间的可用时段、Stripe Checkout 订金/全额支付、Webhook 确认、ICS 附件与 Google 日历链接,一体化的模块化预订功能。

reservationsStripecalendar
预约功能 — 可用时段、订金、Google 日历