プロジェクト概要
================

Next Blog は、読む体験を中心にしたフルスタックのブログプラットフォームです。公開サイトは Next.js App Router で構築し、コンテンツ管理には Payload CMS を使います。認証、コメント、アプリケーションデータは PostgreSQL、Drizzle ORM、better-auth、Fuma Comments で扱います。

プロダクト範囲
--------------

現在の主な機能は次のとおりです。

* Payload CMS による記事の作成、編集、公開;
* ホーム、記事一覧、記事詳細、タグページ、プロフィールページの表示;
* Google と GitHub OAuth によるログイン;
* ログインユーザー向けのコメント機能;
* 検索インデックス、RSS、サイトマップ、JSON-LD、Open Graph 画像の出力;
* Newsletter フォームと React Email テンプレート。

このプロジェクトは汎用コミュニティ CMS ではありません。公開側は読書体験に、管理側は編集作業に集中した個人向けの発信基盤です。

主要なロール
------------

.. list-table::
   :header-rows: 1
   :widths: 20 34 36

   * - ロール
     - 目的
     - 主な入口
   * - 訪問者
     - コンテンツを閲覧して読む。
     - ``/``、``/posts``、``/posts/[slug]``、``/tags``
   * - リピーター
     - タグで絞り込み、更新を追う。
     - ``/tags/[tag]``、``/rss.xml``
   * - ログインユーザー
     - コメントやアカウント関連操作を行う。
     - ``/login``、``/posts/[slug]``
   * - コンテンツ管理者
     - 記事を管理、予約、公開する。
     - ``/admin``

ドキュメント方針
----------------

``Documentation/source`` はこのリポジトリの正式な Sphinx ドキュメントソースです。``docs/`` の Markdown は調査メモや下書きとして残せますが、継続的に参照するエンジニアリング文書は reStructuredText としてここに整理します。