常用功能
查看模板内置的模块和常用功能,了解如何配置、使用并完成上线检查。
本章说明
这里介绍模板已经写好的模块和功能,重点说明怎么配置、怎么使用,以及上线前要检查什么。这里不讲如何从零实现这些功能,也不是产品搭建步骤。如果你刚开始使用 Saavo 模板,请先阅读实践概览。
阅读说明
每篇文章都按下面的顺序编写。你可以先了解现有实现,再决定需要修改哪些配置、编写哪些业务代码。
模板已经做了什么
介绍可以直接使用的页面、API、Service 和底层服务。
默认配置和行为
说明仓库当前启用了什么,以及默认情况下会怎样运行。
需要修改哪些配置
列出需要替换的域名、凭据、产品规则和示例内容。
怎么接入自己的业务
说明应该使用哪些 Service、Guard、Reaction、Repository 或 API,避免重复实现模板已有的功能。
上线前怎么检查
检查正常流程、失败情况和生产环境配置,确认功能确实可以使用。
模块
下面这些模块都有相对完整的页面、API 和数据流程,可以根据产品需要直接启用或调整。
用户认证与账户
处理注册、登录、邮箱验证、密码重置、OAuth 登录和两步验证。
权限与权益
使用角色、能力、动态权益和用量配额控制功能访问。
支付与套餐
配置 Stripe Checkout、订阅、一次性购买、账单门户和支付状态。
工单与支持
提供用户工单、对话、附件、状态流转和后台处理功能。
访问统计
了解第一方数据采集、统计后台、数据保留策略和第三方统计服务。
OAuth 2.0 授权服务器
管理 OAuth 客户端、Scope、授权码、访问令牌、撤销和内省。
联盟计划
管理推荐关系、佣金记录、月度结算和打款资料。
Cookie 同意管理
让用户分别选择是否接受偏好、统计和营销 Cookie。
博客
发布多语言文章,并管理草稿、归档和内容集合。
文档系统
使用 Fumadocs 管理目录、MDX 组件和多语言文档。
管理后台
集中管理用户、支付、权限、日志、统计和其他业务数据。
功能
下面这些功能主要为业务模块提供支撑,也可以在开发新功能时直接复用。
国际化
配置界面语言、多语言路由、本地化文案和服务端翻译。
定时任务
使用 Cloudflare Cron Trigger 定时触发并分派任务。
文件存储
使用 R2 或 KV 上传、读取和清理文件,并设置有效期。
邮件
通过 Cloudflare Email 或 Resend 发送模板邮件并限制发送频率。
通知
发送站内通知,或接入 Slack、Discord、Telegram 等外部通道。
动态优惠码
通过专属链接选择预先配置的 Stripe Coupon,展示优惠价格并在结账时自动应用。
后台任务
了解 Queue、Reaction Command,以及任务的重试、幂等和失败恢复。
从哪里开始
建议先阅读用户认证与账户、权限与权益、支付与套餐,再根据产品需要查看其他文章。如果你已经明确要开发什么,可以直接前往常见开发场景查找对应做法。