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 用户反馈、系统通知、全局与定向公告 运营
Admin 用户、积分、码、公告、支付和 AI 任务查看 管理控制台
Testing Vitest、BDD 辅助工具、Mock D1 和 R2、E2E、覆盖率 测试
Deployment prepare-cloudflare 自动化、DNS、CN 域名、密钥、部署命令 部署

阅读指南

刚刚克隆了模板?

快速开始 开始。首次使用时把 Quick Start 链接交给 AI 助手,它会安装 create-opcstack-app,以后创建项目可以直接调用这个 Skill。

即将上生产?

  1. 部署 — 了解部署路径和资源供给。
  2. 认证 — 锁定注册和 OAuth。
  3. 支付积分 — 接入计费。
  4. 管理控制台 — 运营已部署的产品。
  5. 测试 — 上线前跑一遍。

在模板本身上工作?

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