From 85090693243f96c0ef409064e03b5b1d1d0d8b7b Mon Sep 17 00:00:00 2001 From: Codex Night Worker Date: Sat, 21 Nov 2026 19:16:23 +0900 Subject: [PATCH] WIP: unverified Codex job issue-485-5_qxivvn --- docs/issue-485.md | 91 +++++++++++++++++++++++++++++++-- frontend/src/test/compileMdx.ts | 3 +- 2 files changed, 90 insertions(+), 4 deletions(-) diff --git a/docs/issue-485.md b/docs/issue-485.md index 1ee4c6a..7345635 100644 --- a/docs/issue-485.md +++ b/docs/issue-485.md @@ -1,4 +1,89 @@ -# Issue #485 メモ +# Issue #485: V1 投稿履歴の非 admin アクセス時 HTTP 503 -対象は V1 の `/posts/changes` の非 admin アクセス時に発生する HTTP 503。 -対応の経緯と検証状況は Gitea Issue #485 を参照する。 +対象は V1 の `/posts/changes`(locale prefix 付き URL を含む)。 +Issue では admin は表示でき、member・guest では HTTP 503 が発生すると報告されている。 +本番の根本原因、503 の解消、SQL の性能改善量は未確定。 + +既存の `feature/485`(引継ぎ時点 `6329958`)の成果を以下に整理する。 +文書の整理に加え、管理側ゲートで判明した MDX テスト補助コードの設定読取を修正する。 + +## コードから確認できる経路と未確定事項 + +- [HistoryAccess](../backend/app/models/history_access.rb) は admin に `TRUE` を返す。 + 非 admin には除票境界、タグ・外部タグ・親投稿の参照公開判定を適用する。 +- [PostVersionsController](../backend/app/controllers/post_versions_controller.rb) は + 公開条件と検索条件を適用して全件 count を取得する。 + count が主なボトルネックかどうかは、実行計画・計測がなく未判定。 +- [api.ts](../frontend/src/lib/api.ts) の SSR API timeout は10秒。 + [entry-server.tsx](../frontend/src/entry-server.tsx) はデータ準備中の API timeout 等を再送出し、 + [server.mjs](../frontend/server.mjs) は SSR 例外に対して原則503を返す。 + API 遅延が503につながる経路はあるが、本番でこの経路が発生した証拠は未取得。 +- シリアライズはユーザー名・タグ名・外部タグ名をページ内の ID で一括取得する構造。 + 本番の照会回数・所要時間の計測結果はない。 + +## 引継ぎ済みの修正 + +- `backend/app/models/history_access.rb`:除票境界の集約を、同じリソースキーと + `version_no` による後続除票の `NOT EXISTS` 判定に変更。 + JSON 参照の除票照会も履歴テーブルへの直接 JOIN に変更。 +- `backend/app/controllers/post_versions_controller.rb`:タグ条件なしでは、公開条件による + ページ選択後に直前版を結合。タグ条件ありでは、絞込に使う認可済み直前版を差分にも再利用。 + 正確な count と `created_at DESC, id DESC` の順序は維持する構造。 +- [prefetchers.ts](../frontend/src/lib/prefetchers.ts):URL の `id` を + `fetchPostChanges` の `post` 引数と `postsKeys.changes` の `post` に対応させる。 + [PostHistoryPage.tsx](../frontend/src/pages/posts/PostHistoryPage.tsx) の取得条件と一致させる修正。 +- [vite.config.ts](../frontend/vite.config.ts) と + [vitest.config.ts](../frontend/vitest.config.ts):既存成果には build 時の `jsxDev: false` と、 + 関数形式の Vite 設定を Vitest から読み込む変更も含まれる。 + +### SQL 構造の比較 + +比較元は引継ぎ済み修正の直前 `dda3d87`。実行計画・実測値の比較ではない。 + +| 対象 | 修正前 | 引継ぎ済みの構造 | +| --- | --- | --- | +| 除票境界 | リソースキーごとの `GROUP BY / MAX(version_no)` | 同一キーで対象版以降の除票を `NOT EXISTS` で照会 | +| JSON 参照の除票判定 | 除票キーを集約した派生表へ JOIN | 履歴テーブルへ直接 JOIN し、除票を1件検出すれば終了 | +| ページ取得 | ID の `pluck` 後に公開条件付きで本文を再取得 | ページ選択と差分取得を一つの SQL にまとめ、認可済み直前版を再利用 | +| count | 公開・検索条件適用後の正確な全件集計 | 同じ契約を維持。集計自体は残る | + +[schema.rb](../backend/db/schema.rb) には `post_versions(post_id, version_no)`、 +`tag_versions(tag_id, version_no)`、`nico_tag_versions(tag_id, version_no)` の +複合 unique index がある。新しい照会での利用状況は EXPLAIN による確認が必要。 +migration・schema・index の追加変更は行っていない。 + +## 引継ぎ済みの回帰テスト + +- [post_history_privacy_spec.rb](../backend/spec/requests/post_history_privacy_spec.rb): + anonymous・guest・member・admin の可視性、除票と恢復、タグ・外部タグ・親投稿参照、 + 非公開直前版の旧値と差分、認可済み直前版によるタグ追加・削除の絞込、空履歴、 + 複数ページの正確な件数・同時刻の表示順序、履歴 SELECT と直前版 JOIN の回数を確認する内容。 + タグ factory のロカール補完で第1版が重複しないためのデータ修正も含む。 +- [prefetchers.test.ts](../frontend/src/lib/prefetchers.test.ts):locale prefix の有無と + `ain-Kana`、投稿 ID とタグ・外部タグ条件、query key と取得条件の一致、 + 同じ QueryClient における投稿別履歴と全件履歴のキャッシュ分離を確認する内容。 +- [server.ssr.test.mjs](../frontend/server.ssr.test.mjs):ロカールと権限ごとの HTTP 200、 + 履歴テーブルの SSR、API の投稿・ページ条件と取得回数を確認する内容。 + API スタブを用いるため、Rails SQL の性能や公開判定の実証にはならない。 + +## 検証状況と残る確認 + +管理側ゲートは frontend の578件を実行し、571件合格・7件不合格だった。 +不合格はすべて `mdx-components.test.tsx` で、関数形式の Vite 設定から直接 +`plugins` を読んだために発生した。ログは `validation-step-57_7ge7z.log`。 +[compileMdx.ts](../frontend/src/test/compileMdx.ts) を、Vitest の設定と同様に +`viteConfig` に `command: 'serve', mode: 'test'` を渡してからプラグインを読む形に修正。 +GFM の表、見出し・段落・一覧、長いセル、raw・url の変換除外、内部リンクの +既存回帰テストは維持する。 +同じ検証では `frontend/help/.git` の権限修復エラーも別途報告されている。 + +担当エージェントはテスト・lint・build・DB 操作を実行していない。 +修正後の固定スイートによる再検証と合否判定は管理側に委ねる。 +この文書は修正後の合格記録ではない。 + +本番サービス・DB・外部認証情報にはアクセスしていない。 +EXPLAIN、実データ規模での前後比較、実画面での503解消確認は行っていない。 +全件 count、残る参照集約、`JSON_TABLE`・`snapshot_reference`、ソートの負荷は残る。 +共有の `HistoryAccess` を使う他の履歴経路についても回帰確認が必要。 +除票以前の版と参照履歴の秘匿、恢復後も解除しない規則、非公開直前版の差分遮断は +性能を理由に緩和せず、権限別の回帰テストと実行計画の両方で確認する。 diff --git a/frontend/src/test/compileMdx.ts b/frontend/src/test/compileMdx.ts index 587b8f5..1b1ac03 100644 --- a/frontend/src/test/compileMdx.ts +++ b/frontend/src/test/compileMdx.ts @@ -10,7 +10,8 @@ type Transform = (source: string, id: string) => Promise<{ code: string } | null export const transformMdx = async (source: string, suffix = '.mdx') => { - const plugins = viteConfig.plugins?.flat () as { name: string; transform: Transform }[] + const config = viteConfig ({ command: 'serve', mode: 'test' }) + const plugins = config.plugins?.flat () as { name: string; transform: Transform }[] const plugin = plugins.find (entry => entry.name === '@mdx-js/rollup') if (plugin == null) throw new Error ('The application MDX compiler is not registered')