ユースケース定義書

本ブログは認証を持たない公開・読み取り専用のサイトである。そのため、参考リポジトリのような「ログインユーザーによる作成・編集・削除」のユースケースは存在しない。記事の作成・編集・公開はmicroCMSの管理画面で行い、本アプリは配信（閲覧）のみを担う。

アクター定義

アクター名	ID	説明	主な行動
読者	Reader	サイトを訪れる一般の閲覧者。ログイン不要	記事を探す・読む、著者情報を見る
商談相手	Client	ポートフォリオとして本ブログを見る発注検討者。行動は読者と同じ	ブログの内容・実装品質・プロフィールページの経歴を確認する
運営者	Owner	ブログの著者（本人）。microCMS管理画面で記事を管理する	記事の入稿・公開（アプリ外の操作）

Reader と Client は画面上の操作が同一のため、ユースケース上は Reader にまとめて記述する。区別が必要なのは「プロフィールページ」（UC-PROFILE-View）の設計意図のみ。案件獲得の判断材料になるため、経歴・スキルを読みやすく載せる。

ユースケース一覧

記事の探索

UC-ARTICLE-List（Reader）
- トップページ（/）で記事をカード形式で閲覧できる。トップページが記事一覧を兼ねており、別ページ（旧/blogs）への遷移なしに全件へアクセスできる
- 件数表示（「◯件中 ◯〜◯件を表示」）で、絞り込み後の該当件数と現在の表示範囲がわかる
- 公開日の新しい順に並ぶ
UC-ARTICLE-Paginate（Reader）
- 表示件数（ページサイズ。10 / 20 / 30件など）を切り替えられる
- ページ番号、または「前へ」「次へ」でページを移動できる
- 表示件数の変更、カテゴリ・検索・月の絞り込みの変更は、いずれも1ページ目に戻る
UC-ARTICLE-FilterByCategory（Reader）
- サイドバーの「カテゴリー」一覧（記事に紐づくカテゴリから動的に生成）から、興味のあるカテゴリに絞り込める。一覧上部にカテゴリタブは持たない（旧案から廃止）
- 絞り込み中は、ヘッダー直下がパンくず（HOME > カテゴリ名）に切り替わり、見出しも「◯◯」の記事一覧に変わる（04_ui_design.md参照）
UC-ARTICLE-Search（Reader）
- サイドバーの検索ボックスに入力した語で、記事をタイトルの部分一致で絞り込める
- 本文一致はスコープ外
UC-ARTICLE-FilterByMonth（Reader）
- ARCHIVE（年月）から、その月に公開された記事へ絞り込める
- 絞り込み中は、ヘッダー直下がパンくず（HOME > YYYY年M月）に切り替わり、見出しも「YYYY年M月の記事一覧」に変わる（04_ui_design.md参照）
UC-TOPIC-Browse（Reader）
- サイドバーの「カテゴリー」（一覧＋件数）を見て、興味のあるカテゴリの記事へ移動できる（UC-ARTICLE-FilterByCategoryと同じ操作を指す）

記事の閲覧

UC-ARTICLE-Read（Reader）
- 記事カードをクリックして記事詳細ページ（/blogs/[id]）を開き、タイトル・公開日・カテゴリ・本文を読める
- 詳細ページ上部にパンくず（HOME > 記事タイトル）を表示し、トップへ戻れる
UC-ARTICLE-Share（Reader）
- 記事詳細ページのシェアボタンから、記事のURLとタイトルをX・Facebook・はてなブックマークで共有できる
- アイコンにカーソルを当てる（キーボードではフォーカスする）と「Xでシェアする」などのツールチップで操作内容が分かる
- 各サービスの共有画面は新規タブで開き、記事ページは閉じない。ログインや投稿の確定は各サービス側で行う（本アプリはSNSのAPIを呼ばない）

サイト情報

UC-ABOUT-View（Reader）
- 「このブログについて」（/about）でブログのコンセプトを読める
UC-PROFILE-View（Reader / Client）
- ヘッダーの「プロフィール」または著者カードの「more」から、内部のプロフィールページ（/profile）を開ける
- 著者の自己紹介・経歴・スキルを読める
UC-PROFILE-OpenSns（Reader / Client）
- 著者カードのSNSアイコン（GitHub / X など）から、外部のSNSを新規タブで開ける
UC-APP-Install（Reader）
- スマホのホーム画面やPCのアプリ一覧にブログを追加し、ブラウザのアドレスバーなしの画面（standalone）で開ける