Communitygithub.com

AxelBeary/Inkglean

マルチテナント型コミッション/マーケットプレイスプラットフォームのアーキテクチャパターン — テンプレート化されたユーザーページ、埋め込み可能なウィジェット、カスタムページホスティング。ホスティングされたテンプレートを提供しつつ、外部サイトとの統合を可能にする3層ページシステムについて説明します。

Inkglean とは?

AxelBeary/Inkgleanは、マルチテナント型のコミッションまたはマーケットプレイスプラットフォーム向けに設計されたアーキテクチャスキルです。各ユーザー(アーティスト、クリエイター、フリーランサー)が公開ページと受注機能を持ち、ホスティングされたテンプレートと外部サイト統合の両方をサポートする3層ページシステムを中心に据えています。Layer 1はVueコンポーネントとCSS変数によるビルトインテンプレート、Layer 2は単一のスクリプトタグで既存サイトに注文ボタンを埋め込むウィジェット、Layer 3はアーティスト自身のHTML/CSS/JSをアップロードしてカスタムページをホスティングする機能を提供します。各テンプレートは「レイアウト(構造)」と「パレット(雰囲気)」という直交する軸に分割され、CSSカスタムプロパティによるテーマ管理と、アーティストのアクセントカラーによる訪問者の設定上書きなどの高度なパターンを実装しています。このスキルは、複数テンプレート間でのロジック共有(useArtistData、useOrderForm)、ステップバイステップの注文フォーム、プレビューモード、ドラッグ&ドロップ画像置換など、実用的な実装パターンを多数カバーしています。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/AxelBeary/Inkglean/tree/HEAD/docs/comms/archive/skills/software-development/commission-platform-architecture

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

コミッションプラットフォームアーキテクチャ

マルチテナントコミッションプラットフォーム上で、各ユーザー(アーティスト、クリエイター、フリーランサー)が公開ページと受注機能を持ちます。このスキルでは、ホスティングされたビルトインテンプレートを提供すると同時に、独自サイトを持つクリエイターが統合できるようにするためのアーキテクチャ上の決定について説明します。

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=

関連スキル