logo

概览

OPCStack 模板文档索引与阅读指南

OPCStack 是给 One Person Company 准备的 Cloudflare-native AI SaaS 模板。内置认证、支付、积分、D1 Sharding、R2、KV、Queues、Cron、AI 任务、部署自动化和测试体系

模块地图

模块 提供的能力 文档
Web + API SvelteKit SSR、Hono API、预渲染静态页面 前端、API 契约
Database D1、Drizzle、用户数据分片、读副本、自动迁移 数据库
Storage R2 公共/私有/临时路径、浏览器直传、图片变体 存储
Async 队列、Cron、Durable Objects 队列与 Cron
Auth Better Auth、邮箱、Google、GitHub、LinuxDO、Turnstile、内测码 认证
Credits 钱包、账本、注册奖励、每日签到、邀请奖励、兑换码、过期 积分
Payments Dodo、Creem、一次性包、订阅、Webhook、退款扣回 支付
AI 聊天、图像、TTS、实时、视频提供商,带 R2 输出的异步任务 AI
Operations 用户反馈、系统通知、全局与定向公告 运营
Testing Vitest、BDD 辅助工具、Mock D1 和 R2、E2E、覆盖率 测试
Deployment prepare-cloudflare 自动化、DNS、CN 域名、密钥、部署命令 部署

阅读指南

刚刚克隆了模板?

快速开始 开始。最快的方式是让 AI 助手引导你:打开你的 AI 编码工具,引用 @BOOTSTRAP.md @AGENTS.md,它会逐步带你完成本地配置。

即将上生产?

  1. 部署 — 了解部署路径和资源供给。
  2. 认证 — 锁定注册和 OAuth。
  3. 支付积分 — 接入计费。
  4. 测试 — 上线前跑一遍。

在模板本身上工作?

  1. 架构 — 了解设计原则和系统概览。
  2. 数据库 — 了解分片模型和 Saga 规则。
  3. 部署 — 了解 prepare-cloudflare 自动化。
  4. src/api-contract/ 里的 API 契约 — 了解契约约定。