[コア] 大量ページ時のパフォーマンス改善（ページdepth永続化）

[gakigaki]

概要

• pagesテーブルにdepthカラムを追加し、左右値から初期計算するマイグレーションを追加しました。
• Pageモデルに深さ再計算のユーティリティ（recalcDepthWithDescendants/recalcAllDepths）を追加し、ページ作成・階層移動後にdepthを更新するようにしました。
• withDepth()依存を排除し、読み取り時はdepthカラムを参照するように変更しました（SiteManageのフレーム出力含む）。
• 移行完了後に全ページのdepthを再計算する処理を追加しました。
• 全件再計算コマンド php artisan pages:recalc-depth を追加しました。
• 深さ再計算のユニットテストを追加しました。

背景・目的

• ページ数が多い場合、withDepth()が相関サブクエリで負荷となりレスポンス劣化していました。
• depthを永続化して更新時に再計算することで、読み取り時のコストを削減し、大規模ページでもパフォーマンスを向上させるためです。

特記事項

• 既存データはマイグレーション実行でdepthが初期計算されます。
• 階層整合性が疑わしい場合は php artisan pages:recalc-depth を実行してください。

テスト

• docker compose exec webapp php artisan test --filter=PageDepthTest

レビュー完了希望日

関連Pull requests/Issues

参考

DB変更の有無

有り

チェックリスト

• プルリクエストにわかりやすいタイトルとラベルを付けました。https://github.com/opensource-workshop/connect-cms/wiki/Pull-requests-Rule