For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ja/docs/tanstack/admin.md (or send Accept: text/markdown).

管理コンソール

プラットフォーム検査、アナウンス、フィーチャーフラグ。

このガイドについて質問

初心者向けのウォークスルー

前提条件: 以下の 2 つの初心者向けガイドを読み、Web ローカルのセットアップを完了し、エディターでルートにあるこのモノリポジトリを開きます。 Web 設定は apps/web-tanstack/.env.local に属します。 TanStack Start はルート .env を読み取りません。デフォルトのフェイクモードの /dashboard はデータベースなしのデモです。 /auth には移行されたデータベースが必要です。

簡単に説明すると、ワークスペースは 1 つのチームの個別のユーザー、データ、設定です。サーバーは信頼できるバックエンドです。プロバイダーキーがブラウザーや電話コードに含まれないようにします。移行は、テーブルを作成または更新する、バージョン管理されたデータベースの変更です。 AI モデルは答えを返すエンジンです。モデルカタログは、使用可能なモデル ID と価格のサーバーのリストです。プロバイダーは、AI、電子メール、請求サービスなどの外部サービスです。資格は、ワークスペースで機能を使用できるようにする付与です。 Webhook は、あるサービスが別のサービスの URL に送信するメッセージです。

1. ローカルテストアカウントを作成する前に、サーバー専用の ADMIN_EMAILS リストに独自のアドレスを追加し、アプリを再起動します。

2. 移行されたテストデータベースにサインアップし、/admin を開きます。利用可能なユーザーと組織のページを調べます。

3. これにより、ワークスペースの所有権ではなく、プラットフォーム管理者が付与されます。アクセスが拒否された場合は、正確な電子メールとサーバーの構成を確認してください。任意のユーザーを昇格させたり、運用環境に対してテストしたりしないでください。

カスタムコードの場合は、提供された prompts/README.md から始めて、最も近いプロンプト (アプリ画面の場合は prompts/new-app-screen.md、パブリックページの場合は prompts/new-landing-page.md) をコピーします。サーバー、データベース、またはプロバイダーの作業については、コーディングエージェントにこのガイドのタスクを与え、AGENTS.md、.ai/PROJECT_CONTEXT.md、および一致する .ai/ ミラーを読み取るように依頼します。ここで指定されている正確なソースファイルを調べてください。ファイルをリストし、編集前にチェックします。ワークスペースの所有権とサーバーのみの秘密を保持します。そして差分を見せてください。必要な動作、入力フィールドと出力フィールド、許可されるロール、予想される成功とエラー、テストアカウント、プロバイダー、またはデバイスを指定します。サンプル値を使用します。絶対に本当の秘密を貼り付けないでください。

始める前に

【端末の基本】(/docs/tanstack/terminal-basics)

管理境界を作成する

ADMIN_EMAILS は、サーバー専用のカンマ区切りブートストラップリストです。リストされたユーザーは、サインアップ時にプラットフォーム管理者の役割を受け取ります。これを使用しない場合は、承認されたデータベース/管理パスを介してアクセスを許可します。最初の任意の訪問者を管理者にしないでください。

プラットフォーム管理者は、ワークスペース所有者/管理者とは異なります。 /admin とそのユーザー、組織、フラグ、アナウンス、待機リストのページは、プラットフォームの役割をチェックします。

実装されたコントロールを使用する

デフォルトの Better Auth エンジンは、管理者ユーザーの管理、禁止、および偽装を提供します。アプリは監査証跡を含むプラットフォームビューを構成します。偽装を検証済みの管理者アクセスに制限し、その状態を表示して、終了時に元の管理者セッションを復元します。

Auth.js は、Better Auth 管理プラグインを自動的に継承しません。エンジンを切り替える前に、admin.ts、admin-actions.ts、および認証プロバイダーの動作を確認してください。

特権アクションを確認する

非管理者による拒否、管理者アクセス、禁止されたユーザーのセッション、偽装の開始/停止、および有効にしたアクションをテストします。すべての管理ルートをパブリックインデックスの外側に保持します。

機能フラグ

【お知らせ】(/docs/tanstack/project-structure)

キャンセル待ち管理

インストールとセットアップ

/admin サーフェスは、ワークスペース、メンバー、プロダクト状態に対するオペレーターの検査ビューです。ADMIN_EMAILS(または消費側プロダクトの admin プラグイン設定)がアクセス可否を決め、各 admin ルートはサーバーで認可を再確認します。

フィーチャーフラグ(feature-flag-runtime.ts)は未設定のものをすべてデフォルトで無効化します — 欠落したフラグがサーフェスを黙って有効化することはありません。フラグごとのオーバーライドは featureFlagOverride テーブルにあります。

/admin                    operator dashboard
announcement-actions.ts   broadcast in-app notices
resolveFeatureFlags(...)  bulk flag resolution for a caller context

実装ワークフロー

admin アクションは検査とサポート業務(ワークスペース検索、メンバー管理、アナウンス配信)に使います。ミューテーションは監査され、認可はナビではなくアクション境界で確認される状態に保ってください。

機能はフラグの後ろでロールアウトします: コードをダークで出荷し、ワークスペース単位またはグローバルに有効化し、サーフェスが恒久的になったらフラグを外します。プラットフォーム権限借用は、プロダクトの PRODUCT.md が明示的に許可しない限り凍結されたままです。

検証とトラブルシューティング

非管理者が拒否されること、無効なフラグがそのサーフェスを端から端まで隠すこと(nav、ルート、アクション)、オーバーライドが対象にのみ解決されること、アナウンスが対象読者に届くことを確認します。admin テストは拒否パスを先にカバーすべきです。