ドキュメント
プラットフォームアーキテクチャ概要

プラットフォームアーキテクチャ概要

Postion のマルチテナントアーキテクチャ、ルーティングシステム、コア技術インフラを理解しましょう。開発者や上級ユーザー向けの技術ディープダイブです。

技術基盤

Postion は、スケーラビリティ、セキュリティ、開発者体験を考慮して設計された、モダンでハイパフォーマンスなテクノロジースタックの上に構築されています。このドキュメントでは、プラットフォームアーキテクチャの概要を解説します。

このドキュメントは、開発者、技術ユーザー、そして Postion が内部でどのように動作しているか興味のある方を対象としています。

コアテクノロジースタック

プラットフォームは業界をリードするテクノロジーを活用しています:

レイヤーテクノロジー目的
フレームワークNext.js 14App Router 搭載のフルスタック React フレームワーク
言語TypeScript型安全な開発
データベースPostgreSQL + Prismaリレーショナルデータ+型安全な ORM
決済Stripeサブスクリプション&単品決済
ストレージCloudflare R2メディアファイルストレージ
メールResend + Stalwartトランザクション&マーケティングメール
AIOpenAI 互換リレー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ニュースレターキャンペーン
CRMFanRelationship, FanTag, FanSegmentファン管理
APIApiKey, 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 : has

Stripe 統合

決済処理はすべて Stripe を通じて行われ、2 つの主要機能を使用しています:

Stripe サブスクリプション

購読者からの定期収益用:

  • 月額・年額の請求サイクル
  • 自動決済リトライ
  • サブスクリプション管理ポータル

クリエイターへの支払い

支払いは Postion がまとめて受け取り、各クリエイターの残高に記録します:

  • プランに応じたプラットフォーム手数料(Free 5%、Launch 2%、Pro 0%)。カード決済手数料は実費をクリエイターが負担
  • 残高が $100 に達すると、銀行口座・PayPal・USDT ウォレットへ出金可能
  • 各取引にプラットフォーム手数料と決済手数料を表示

詳しくは 報酬と手数料 をご覧ください。

ストレージインフラ

メディアファイルはクラウドオブジェクトストレージに保存されます:

  • プライマリ:Cloudflare R2 による信頼性が高くスケーラブルなストレージ
  • CDN:高速な読み込みのためのグローバルコンテンツ配信
  • フォーマット:画像、動画、ドキュメントなどに対応

ストレージにはフェアユースが適用されます。詳しくは ストレージ&クオータ をご覧ください。

パフォーマンス&スケーラビリティ

Postion は大規模でもパフォーマンスを発揮するよう構築されています:

⚡ エッジキャッシュ

公開ページを CDN エッジにキャッシュし、世界中で最小限のレイテンシを実現。

📦 スマートキャッシング

静的コンテンツと API レスポンスのインテリジェントなキャッシュ。

🔄 インクリメンタルレンダリング

公開サイトはインクリメンタル静的再生成で、新鮮さと速さを保ちます。

より詳しい技術情報