> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# コンテンツ管理

自由なライフサイクルと公開リード境界を持つ型付き CMS エントリ。

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

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

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

1. ワークスペース所有者または管理者としてサインインし、`/content` を開き、フォームを使用して一意のスラッグを含む投稿、ページ、ドキュメント、またはレポートを作成します。下書きとして保存してから公開します。

2. ステータスが公開済みに変わったことを確認します。重複したスラッグまたは管理アクセス権のないメンバーは失敗します。

3. ゲート テストの場合は、`required_entitlement=ai.reference-task` を使用します。認可が確認されていない場合、ページにはティーザーのみを表示する必要があります。

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

[始める前に](https://supastack.dev/ja/docs/web/before-you-start.md)

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

[Webローカル設定](https://supastack.dev/ja/docs/web/ship-in-5-minutes.md)

[エージェント プロンプトとプロジェクト メモリ](https://supastack.dev/ja/docs/web/agents.md)


## ワークスペースエントリを作成する

`/content` マネージャーは、`post`、`page`、`doc`、および `report` エントリを処理します。 `content_entry` 行には、ドラフト/公開/アーカイブの状態、ワークスペース スコープのスラッグ、および作成者が含まれます。管理アクションには、適切な所有者/管理者の役割が必要です。

この CMS は、`src/resources` にあるキットの型指定されたパブリック docs/blog カタログとは別のものです。製品は、独自のページ構成を通じて CMS エントリをレンダリングできます。


## サーバー上の本体をゲートします

`required_entitlement` は NULL 可能です。未設定のエントリはゲート解除されます。ゲートされたエントリの場合、サーバー専用の `content-queries.ts` は、読み取り可能なコンテンツまたは空の本文を持つロックされたティーザーを投影します。 `content-access.ts` は投影を所有します。クライアントが提供する権利の主張を決して信用しないでください。

パブリッシュすると `content.published` が発行されます。スケジュールされたダイジェストでは、出版チームの最近のエントリを要約できます。作成されたコンテンツもアカウントのエクスポートに参加します。


## 公開とアクセスを確認する

ドラフトの可視性、パブリッシュ/アーカイブの移行、重複したスラッグ、間違ったワークスペース、無料のエントリ、非アクティブな有料の助成金をテストします。サーバーがアクセスを担当しながら、プレゼンテーションにはペイウォール ブロックを使用します。

【有料コンテンツチュートリアル】(/docs/web/setup-ai)

[コンテンツダイジェスト](https://supastack.dev/ja/docs/web/project-structure.md)

[ペイウォール プレゼンテーション](https://supastack.dev/ja/docs/web/project-structure.md)


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

ワークスペースの /content サーフェスで CMS エントリを管理します — post、page、doc が推奨タイプですが、URL セーフなプロダクトタイプ(小文字・数字・ダッシュ・アンダースコア、64 文字以内)なら何でも受け付けます。content_entry テーブルは全行を workspaceId でスコープし、createdBy を記録し、slug を workspace と type ごとに一意に保ちます。

エントリは自由な draft ↔ published ↔ archived ライフサイクルを移動します — src/content.ts の evaluateContentStatusChange が無効または変化のない遷移を拒否し、publishedAt は初回公開時に打刻され、その後の非公開化を越えて残るため、読者は元の日付を保持します。

```
/content                    workspace CMS surface
src/content.ts              input + lifecycle rules
src/content-actions.ts      member+ mutations
content_entry               workspaceId, type, slug, status
```


## 実装ワークフロー

member 以上がエントリを作成します — すべての mutation は requireWorkspaceWriter(workspace-access.ts)を通じてセッション、アクティブなワークスペース、少なくとも member ロールを解決するため、guest は読み取り専用です。normalizeContentEntryInput は書き込み前に type、1〜255 文字のタイトル、URL セーフな slug を検証します。

listPublishedContentEntries は意図的な公開リード境界です: 明示的な workspaceId を受け取り、セッションを必要とせず、公開済みの行のみを返します — ストアフロントページ、ブログ、ドキュメントがワークスペースコンテンツを描画する経路です。公開すると content.published の外向け webhook が発行され、作成されたエントリは GDPR データエクスポートに含まれます。


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

draft → publish → archive の一往復、同一タイプ内の slug 重複、クロスワークスペースの読み取りを確認してください。公開境界が下書きや他ワークスペースの行を決して返さないこと、content.published が公開アクションごとに一度だけ発火することを確かめます。


## 次へ

[コマース](https://supastack.dev/ja/docs/web/commerce.md)
