文档
技术架构与技术栈
技术架构与技术栈
深入了解 Postion 的底层。探索我们的系统架构、现代技术栈以及确保速度、规模和安全的核心设计原则。
1. 系统架构图
核心流程:
- 用户通过 Next.js 前端访问站点(
[username].postions.app或自定义域名)。 - Cloudflare 边缘网络处理请求,提供全球 CDN 加速。
- API 请求通过 Next.js API Routes 发送到后端服务。
- 后端服务使用 Prisma ORM 与 PostgreSQL 数据库交互,获取内容数据。
- 支付流程由 Stripe API 处理,订阅状态通过 Webhooks 同步。
- AI 相关功能(如写作助手、SEO 元数据生成)通过兼容 OpenAI 的 API 中转实现。
- Newsletter 功能基于 Stalwart 邮件服务器(JMAP)实现。
2. 技术栈
- 前端: Next.js 14 (React),Tailwind CSS,BuouUI
- 后端: Next.js API Routes,TypeScript
- 数据库: PostgreSQL
- ORM: Prisma
- 支付: Stripe
- 域名: Cloudflare
- AI 服务: 兼容 OpenAI 的 API 中转,Vercel AI SDK
- 部署/托管: 单容器,通过 Dokploy 部署
- 认证: NextAuth.js
- 内容分发: Cloudflare 边缘网络 (CDN)
设计考量: 我们选择了以 Cloudflare 和 Next.js 为核心的全栈 TypeScript 方案,以实现最大的开发效率和卓越的性能(尤其是 SEO 方面)— 完美契合内容平台的需求。
3. 核心数据架构
User:存储用户信息和认证详情。Site:存储每个创作者的站点配置(子域名、自定义域名、模板、品牌等)。一个User可以拥有多个Site。Post:存储文章内容、元数据和发布状态。关联到Site。Subscription:存储用户订阅关系,关联到 Stripe 的Subscription。Webhook:存储创作者配置的开发者 Webhook 端点。
4. 核心设计原则
- 多租户: 不同创作者的内容和配置在数据库层面通过
siteId隔离。 - 性能优先: 我们利用增量静态再生 (ISR) 和 CDN 缓存确保内容页面在毫秒级加载。
- 安全与可靠: 所有支付信息由 Stripe 处理;我们不存储敏感支付数据。我们利用平台原生安全功能(如 Cloudflare 防火墙)防止常见攻击。
- 可扩展性: CDN 和应用缓存承担了公开页面的大部分流量。