文档
技术架构与技术栈

技术架构与技术栈

深入了解 Postion 的底层。探索我们的系统架构、现代技术栈以及确保速度、规模和安全的核心设计原则。

1. 系统架构图

核心流程:

  1. 用户通过 Next.js 前端访问站点([username].postions.app 或自定义域名)。
  2. Cloudflare 边缘网络处理请求,提供全球 CDN 加速。
  3. API 请求通过 Next.js API Routes 发送到后端服务。
  4. 后端服务使用 Prisma ORM 与 PostgreSQL 数据库交互,获取内容数据。
  5. 支付流程由 Stripe API 处理,订阅状态通过 Webhooks 同步。
  6. AI 相关功能(如写作助手、SEO 元数据生成)通过兼容 OpenAI 的 API 中转实现。
  7. 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 和应用缓存承担了公开页面的大部分流量。

© Postion 2026 — BuouTech Inc.