B-156 memos一覧ページ最適化 — 実装計画

1. 現状分析サマリー

サイズ見積もり

.generated/memo-index.json 全体: 30.09 MB (3,138件)
contentHtmlを除外した場合: 1.02 MB
削減率: 96.6% (約29MB削減)

一覧ページ /memos は getAllPublicMemos() を呼んで全メモ（contentHtml含む）を MemoFilter クライアントコンポーネントにpropsとして渡している。MemoCardはcontentHtmlを一切使っていない（subject, from, to, date, tags, replyCountのみ）。これがISRペイロード肥大の直接原因。

contentHtmlを使っている箇所（変更不要）

/memos/[id]/page.tsx -> MemoDetail (dangerouslySetInnerHTML)
/memos/thread/[id]/page.tsx -> MemoThreadView (dangerouslySetInnerHTML)
src/lib/feed-memos.ts -> RSS/Atom feed生成（description, content）
src/lib/cross-links.ts -> PublicMemo型をre-exportしているが、contentHtmlは直接使わない

contentHtmlを使っていない箇所（今回の修正対象）

/memos/page.tsx -> MemoFilter -> MemoCard（一覧ページ。contentHtml不要）

2. 実装計画

Step 1: PublicMemoSummary型の定義（memos-shared.ts）

src/memos/_lib/memos-shared.ts に、contentHtmlを除外した軽量型を追加する。

PublicMemoSummary = Omit<PublicMemo, 'contentHtml'> として定義
既存の PublicMemo 型は変更しない（後方互換性維持）

Step 2: getAllPublicMemoSummaries() 関数の追加（memos.ts）

src/memos/_lib/memos.ts に新しい関数を追加する。

getAllPublicMemoSummaries(): PublicMemoSummary[] — contentHtmlを除外したメモ配列を返す
内部実装: getPublicMemosFromIndex() の結果から contentHtml を除外してマッピング
キャッシュ: 別途 _cachedSummaries を持つか、毎回mapするかはビルダー判断（1.02MBなので毎回mapでも問題ない）

Step 3: MemoFilterコンポーネントのprops型変更（MemoFilter.tsx）

MemoFilterProps.memos の型を PublicMemo[] から PublicMemoSummary[] に変更
importを PublicMemoSummary に切り替え

Step 4: MemoCardコンポーネントのprops型変更（MemoCard.tsx）

MemoCardProps.memo の型を PublicMemo から PublicMemoSummary に変更
importを PublicMemoSummary に切り替え
実装内容の変更は不要（すでにcontentHtml未使用）

Step 5: 一覧ページの呼び出し変更（memos/page.tsx）

getAllPublicMemos() を getAllPublicMemoSummaries() に変更
importを更新

Step 6: テストの更新

src/app/memos/feed/__tests__/memo-feed.test.ts — 変更不要（feed-memos.tsは引き続きgetAllPublicMemosを使う）
src/memos/__tests__/memos.test.ts — 変更不要（normalizeRoleのテストのみ）
新規テスト追加: getAllPublicMemoSummaries() がcontentHtmlを含まないことを確認するテストを追加

3. 変更しないファイル（影響なし確認済み）

以下のファイルは引き続き PublicMemo（contentHtml含む）を使用し、変更不要:

src/app/memos/[id]/page.tsx — 個別メモページ（contentHtml必要）
src/app/memos/thread/[id]/page.tsx — スレッドページ（contentHtml必要）
src/memos/_components/MemoDetail.tsx — 個別メモ表示（contentHtml必要）
src/memos/_components/MemoThreadView.tsx — スレッド表示（contentHtml必要）
src/lib/feed-memos.ts — RSS/Atom feed（contentHtml必要）
src/lib/cross-links.ts — 相互リンク（PublicMemo型をre-export、contentHtml直接使用なし）
src/app/sitemap.ts — サイトマップ（getAllPublicMemosを使うがcontentHtml不使用。ただし型変更は不要のためそのまま）
scripts/build-memo-index.ts — インデックス生成スクリプト（変更不要）

4. 確認手順

ビルド前確認

npm run build

ビルド成功およびペイロードサイズがVercel上限(19.07MB)以内であることを確認。

サイズ確認

npx next experimental-analyze

または .next/server/app/memos.html のISRペイロードサイズを確認。

機能確認

一覧ページ /memos が正常に表示されること
ロールフィルタ・タグフィルタが正常に動作すること
ページネーションが正常に動作すること
個別メモページ /memos/[id] が正常に表示されること（contentHtml含む）
スレッドページ /memos/thread/[id] が正常に表示されること
RSS/Atomフィードが正常に生成されること

テスト

npm test

既存テストが全て通ることを確認。

5. リスク評価

リスク: 低 — 変更は型の追加と一覧ページのデータソース切り替えのみ。既存のPublicMemo型・関数は一切変更しない。
期待効果: 大 — ISRペイロードが約30MBから約1MBに削減。Vercelデプロイ上限(19.07MB)を大幅に下回る。
サイトマップへの影響: sitemap.tsもgetAllPublicMemosを使っているが、sitemapはcontentHtmlを使わない。ただしsitemapはSSGで個別にレンダリングされるため、一覧ページのペイロードには含まれない。必要であれば将来的にgetAllPublicMemoSummariesに切り替え可能だが、今回のスコープ外。

6. 変更ファイル一覧（ビルダーへの指示用）

src/memos/_lib/memos-shared.ts — PublicMemoSummary型追加
src/memos/_lib/memos.ts — getAllPublicMemoSummaries()関数追加、型re-export追加
src/memos/_components/MemoFilter.tsx — props型をPublicMemoSummaryに変更
src/memos/_components/MemoCard.tsx — props型をPublicMemoSummaryに変更
src/app/memos/page.tsx — getAllPublicMemoSummariesに切り替え
テストファイル（新規または既存に追加）— getAllPublicMemoSummariesのテスト