プラットフォームアーキテクチャ概要
Postion のマルチテナントアーキテクチャ、ルーティングシステム、コア技術インフラを理解しましょう。開発者や上級ユーザー向けの技術ディープダイブです。
技術基盤
Postion は、スケーラビリティ、セキュリティ、開発者体験を考慮して設計された、モダンでハイパフォーマンスなテクノロジースタックの上に構築されています。このドキュメントでは、プラットフォームアーキテクチャの概要を解説します。
このドキュメントは、開発者、技術ユーザー、そして Postion が内部でどのように動作しているか興味のある方を対象としています。
コアテクノロジースタック
プラットフォームは業界をリードするテクノロジーを活用しています:
| レイヤー | テクノロジー | 目的 |
|---|---|---|
| フレームワーク | Next.js 14 | App Router 搭載のフルスタック React フレームワーク |
| 言語 | TypeScript | 型安全な開発 |
| データベース | PostgreSQL + Prisma | リレーショナルデータ+型安全な ORM |
| 決済 | Stripe | サブスクリプション&単品決済 |
| ストレージ | Cloudflare R2 | メディアファイルストレージ |
| メール | Resend + Stalwart | トランザクション&マーケティングメール |
| AI | OpenAI 互換リレー | AI ライティングアシスタント |
マルチテナントアーキテクチャ
Postion は マルチテナントアーキテクチャ を採用しており、各ユーザーは複数の独立したサイト(パブリケーション)を作成できます。これが「ユーザー → サイト → コンテンツ」階層の基盤です。
仕組み
┌─────────────────────────────────────────────────────┐
│ ユーザーアカウント │
│ (請求、プロフィール、グローバル設定) │
├─────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ サイト A │ │ サイト B │ │ サイト C │ │
│ │ (テックブログ)│ │ (ポートフォリオ)│ │(ニュースレター)│ │
│ ├─────────────┤ ├─────────────┤ ├─────────────┤ │
│ │ • 投稿 │ │ • 投稿 │ │ • 投稿 │ │
│ │ • タグ │ │ • タグ │ │ • タグ │ │
│ │ • テンプレート│ │ • テンプレート│ │ • テンプレート│ │
│ │ • 購読者 │ │ • 購読者 │ │ • 購読者 │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────┘
主な特徴
🌐 独立したドメイン
各サイトは独自のサブドメイン(blog.postions.app)やカスタムドメイン(yourblog.com)を持てます。
👥 分離された購読者
購読者リストはサイトごとに独立。サイト A の購読者が自動的にサイト B に登録されることはありません。
💳 統一された請求
サイトは分離されていますが、請求と出金の設定はユーザーアカウントレベルで管理されます。
🎨 個別のブランディング
各サイトに独自のテンプレート、カラー、フォント、外観設定を設定できます。
ルーティングアーキテクチャ
ミドルウェアベースのルーティングシステムが、ホスト名に基づいてリクエストをインテリジェントに処理します。
リクエストの流れ
flowchart TD
A[受信リクエスト] --> B{ホスト名の確認}
B -->|postion.app| C[メインプラットフォームルート]
B -->|その他のドメイン| D[テナントサイトルート]
C --> E{パスの確認}
E -->|/dashboard, /login, /site, /post| F[認証済みルート]
E -->|/sso-bridge| G[SSO 処理]
E -->|その他| H[/home/* にリライト]
D --> I[/domain/* にリライト]
I --> J[テナントサイトのレンダリング]ルートカテゴリ
| カテゴリ | パス | 説明 |
|---|---|---|
| 認証済み | /dashboard, /site/*, /post/* | ユーザーログインが必要 |
| SSO | /sso-bridge | シングルサインオン処理 |
| 公開プラットフォーム | /home/*, /blog, /pricing | マーケティング&公開ページ |
| テナントサイト | *.postions.app, カスタムドメイン | ユーザー作成のパブリケーション |
コンテンツセキュリティ
コンテンツ保護を真剣に取り組んでいます。Postion には有料コンテンツを保護するアンチパイラシー機能が内蔵されています。
セキュリティ機能
ウォーターマーク:オーバーレイにサイト名とログイン中の閲覧者の表示名を表示。
コピー防止:デリケートなコンテンツのコピー&ペーストと右クリック保護(オプション)。
注意: コンテンツセキュリティ機能は Pro プランで利用可能で、サイトの一般設定からサイト全体に対して有効化します。
データベースアーキテクチャ
データベースは、論理的なドメインに整理された 42 以上のモデルで構成されています:
コアドメイン
| ドメイン | 主要モデル | 目的 |
|---|---|---|
| ユーザーシステム | User, Account, Session, UserProfile | 認証&プロフィール |
| サイトシステム | Site, Template, TemplatePricing | マルチテナントパブリケーション |
| コンテンツ | Post, Tag, PostPricing | コンテンツ管理 |
| サブスクリプション | Plan, Subscription, Transaction | マネタイズ |
| メール | Subscribe, EmailCampaign, EmailSend | ニュースレターキャンペーン |
| CRM | FanRelationship, FanTag, FanSegment | ファン管理 |
| API | ApiKey, ApiUsage, Webhook | 開発者プラットフォーム |
データの関連性
erDiagram
USER ||--o{ SITE : 所有
SITE ||--o{ POST : 含む
SITE ||--o{ PLAN : 提供
PLAN ||--o{ SUBSCRIPTION : 持つ
SUBSCRIPTION ||--o{ TRANSACTION : 生成
POST ||--o| POST_PRICING : 持つ
POST ||--o{ POST_PURCHASE : 持つ
USER ||--o| SETTLEMENT_ACCOUNT : hasStripe 統合
決済処理はすべて Stripe を通じて行われ、2 つの主要機能を使用しています:
Stripe サブスクリプション
購読者からの定期収益用:
- 月額・年額の請求サイクル
- 自動決済リトライ
- サブスクリプション管理ポータル
クリエイターへの支払い
支払いは Postion がまとめて受け取り、各クリエイターの残高に記録します:
- プランに応じたプラットフォーム手数料(Free 5%、Launch 2%、Pro 0%)。カード決済手数料は実費をクリエイターが負担
- 残高が $100 に達すると、銀行口座・PayPal・USDT ウォレットへ出金可能
- 各取引にプラットフォーム手数料と決済手数料を表示
詳しくは 報酬と手数料 をご覧ください。
ストレージインフラ
メディアファイルはクラウドオブジェクトストレージに保存されます:
- プライマリ:Cloudflare R2 による信頼性が高くスケーラブルなストレージ
- CDN:高速な読み込みのためのグローバルコンテンツ配信
- フォーマット:画像、動画、ドキュメントなどに対応
ストレージにはフェアユースが適用されます。詳しくは ストレージ&クオータ をご覧ください。
パフォーマンス&スケーラビリティ
Postion は大規模でもパフォーマンスを発揮するよう構築されています:
⚡ エッジキャッシュ
公開ページを CDN エッジにキャッシュし、世界中で最小限のレイテンシを実現。
📦 スマートキャッシング
静的コンテンツと API レスポンスのインテリジェントなキャッシュ。
🔄 インクリメンタルレンダリング
公開サイトはインクリメンタル静的再生成で、新鮮さと速さを保ちます。
より詳しい技術情報
- Public API ドキュメント:REST API で連携を構築
- Webhook ガイド:リアルタイムのイベント通知を受信
- カスタムドメイン:独自ドメインを接続