Merge pull request #21 from bertyuan/Documentationv1.2

docs: add comprehensive documentation for operations

1 files changed, 46 insertions, 0 deletions

diff --git a/Documentation/source/ja/introduction.rst b/Documentation/source/ja/introduction.rst
new file mode 100644
index 0000000..731db1e
--- /dev/null
+++ b/Documentation/source/ja/introduction.rst
@@ -0,0 +1,46 @@
+プロジェクト概要
+================
+
+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 としてここに整理します。