keel — Next.js SaaS模板

Keel 是一个面向多租户 SaaS 产品的全栈模板，后端使用 Django 6 与 Ninja，前端为 Next.js 15，两者通过 BFF 模式同源代理通信。它预置了认证（基于 django-allauth headless）、组织与成员管理、细粒度权限、Stripe 计费（套餐、结账、门户、webhook、席位与额度控制）、Celery 后台任务（分两层，支持 SSE 进度推送），以及营销站与应用壳分离的 Next.js 路由结构。核心设计是七条架构不变量，其中四条由 CI 强制检查，例如权限必须返回带原因的 Decision、每个 Ninja 资源必须声明组织作用域并配有测试工厂、跨租户访问返回 404 而非 403。项目自带生成器 CLI（`pnpm gen resource`）可一键生成完整 CRUD 垂直切片，`scripts/init.ts` 用于重命名项目并按需裁剪营销站、演示资源或计费形态。

适用场景是那些需要认真处理租户隔离、权限审计和异步任务边界的多租户 SaaS 项目，尤其是团队愿意阅读文档并遵循架构约束的场合。模板提供了大量测试与 CI 门禁，但这也意味着上手门槛不低：需要熟悉 Django、Next.js、Celery、Stripe 以及仓库内约定的服务层/选择器分层。本地开发依赖 Docker、uv、pnpm，并需通过 lvh.me 处理跨子域会话 cookie。

需要留意的是，模板明确声明不是托管产品或可配置框架，而是需要 fork 后自行拥有的代码库。Stripe 测试时钟覆盖、纯 domain 层等路线图项尚未实现，部署文档仅覆盖 Railway 路径。上线前应核对 Stripe 账户配置、邮件模板构建、Celery worker 启动，以及 CI 门禁在真实环境中的表现。