コミッションプラットフォームアーキテクチャ
マルチテナントコミッションプラットフォーム上で、各ユーザー(アーティスト、クリエイター、フリーランサー)が公開ページと受注機能を持ちます。このスキルでは、ホスティングされたビルトインテンプレートを提供すると同時に、独自サイトを持つクリエイターが統合できるようにするためのアーキテクチャ上の決定について説明します。
3層ページシステム
中心的なアーキテクチャパターン:技術レベルと独立性に応じて、クリエイターを3つのレベルでサポートします。
┌─────────────────────────────────────────────────┐
│ レイヤー3: カスタムページホスティング │
│ 自身のHTML/CSS/JSをアップロード → │
│ /artist/alice で配信(uploads/ からの静的ファイル)│
├─────────────────────────────────────────────────┤
│ レイヤー2: 埋め込み可能ウィジェット │
│ 既存サイトに <script> タグを1つ貼り付ける │
│ → 「コミッションを依頼」ボタン + 注文フォーム │
├─────────────────────────────────────────────────┤
│ レイヤー1: ビルトインテンプレート │
│ レイアウトバリアントを選択するだけでセットアップ不要│
│ → /artist/alice で完全なページ │
└─────────────────────────────────────────────────┘
レイヤー1: ビルトインテンプレート
対象: 独自のウェブサイトを持っていない、または維持したくないクリエイター。
実装: CSS変数によるテーマ設定を備えたVueコンポーネント。
// ルート: /artist/:subdomain
routes.get('/artist/:subdomain', async (req, reply) => {
const artist = await artistService.getBySubdomain(req.params.subdomain)
if (artist.page_type === 'default') {
// ビルトインのVue SPA(またはSSR)をレンダリング
// page_theme フィールドがどのテンプレートバリアントを使用するかを制御
return reply.sendFile('index.html')
}
// ... レイヤー2〜3は他の場所で処理
})
テンプレート = レイアウト × パレット(直交する軸) — 最も重要なモデリング上の判断です。2つの「テンプレート」が主に色で異なる場合、それらは2つのテンプレートではなく、2つの配色をまとった1つのレイアウトです。色をテンプレートの次元にバンドルすると、構造コードが重複してテンプレート数が増加します(ユーザーから「同じページが色違いに見える」と指摘されます)。アーティストが独立して選択できるように軸を分割します:
| 軸 | 選択者 | 例 | 制御内容 |
|---|---|---|---|
| レイアウト(構造) | アーティスト | classic(2段組スタジオ)/ gallery(全画面ミュージアム)/ folio(1ページランディング)/ atelier(書籍風温かみのあるスタジオ) | 開始処理、カラムロジック、ギャラリー形状、ナビゲーション |
| パレット(雰囲気) | アーティスト | paper / ink / dusk / moss — それぞれライトとダークのバリアントで定義 | ページの地/面/テキスト色(--pal-* CSS変数) |
| アクセント + モード | 訪問者 | 5色のアクセントピッカー + ライト/ダーク設定 | --color-primary、html.dark |
主要ルール:
- パレットとはライトとダークのバリアントを持つ雰囲気であり、「ダークテーマ」ではありません。アーティストが
inkを選ぶと、ライトモードの訪問者は薄いグレーを、ダークモードの訪問者はダークチャコールを見ます。雰囲気は一貫し、明るさは訪問者に従います。 - アクセントカラー(ボタン/リンク/ハイライト)は常に訪問者のアクセント変数(
--color-primary)を使用し、パレット変数は使いません。2つのシステムは直交し続け、両方とも機能し続けます。 - 4つのレイアウト × 4つのパレット = 8つの定義から16の異なる外観。
- レイアウトは構造的に異なる必要があります(異なる開始処理、異なるカラムロジック)。そうでなければ1つのレイアウトに統合する必要があります。
機能するレイアウトアーキタイプ — それぞれ、アーティストの最も特徴的な資産(作品)で始まり、中央に配置された名前+経歴+ボタンのヒーローでは始まりません:
| レイアウト | 開始部分 | 特徴的な動き |
|---|---|---|
| gallery | 全ビューポートのアートワーク、名前は小さなコーナープレートとして | 編集的な大小交互ギャラリー、ホバーでズーム、クリックでプレビュー |
| classic | 代表作のバナー、名前はアートの上にオーバーレイ | デスクトップ2段組、スティッキーな情報カードと常時表示のコミッションCTA |
| folio | 分割画面:左にテキスト、右にアートワークを積み重ね | スクロール追跡ナビゲーションハイライト、モバイルハンバーガー + 下部固定CTA |
| atelier | 温かみのある書籍風の見開き、セリフ書体(Noto Serif SC) | 紙質の地、編集的な余白、たっぷりとしたホワイトスペース、文学的な雰囲気を持つアート重視 |
共有キットアーキテクチャ(実証済み):テンプレートはバックエンドのフィールド名を直接読み取らず、1つのアダプターコンポーザブル(useArtistData(props))が imgUrl()、statusText()(i18n)、socialLinks、heroArtwork を提供します。再利用可能な Tpl* コンポーネントはprops(`TplHero variant=