AI: address issue #483
このコミットが含まれているのは:
+61
-5
@@ -24,11 +24,15 @@ Vite の既存 `/api` proxy は3002番ポートを参照する。これらの起
|
||||
|
||||
一覧・詳細・相互リンクは JavaScript 無効でも利用できる。検索は HTTP 配信した
|
||||
`search-index.json` を JavaScript が読む。`file://` からの検索は保証しない。
|
||||
Post はタイトルに加えて、出力対象の関連 Tag の全言語名・別名から検索できる。
|
||||
非公開・廃止・件数上限外の Tag や、関連しない Tag の名前は Post の検索項目に含めない。
|
||||
外部動画・画像・サムネール・素材ファイルは取得も同梱もしない。Post の外部 URL は
|
||||
通常のリンクとして残すため、そのリンク先の閲覧は外部サイトの存続に依存する。
|
||||
|
||||
各 HTML に静的保存版の表示、UTC のデータ基準時点、`noindex, nofollow`、
|
||||
本家への絶対リンクを焼き込む。内部リンク・CSS・JS は相対参照。
|
||||
本家リンクの初期オリジンは `https://hub.nizika.monster`。request の Host、
|
||||
forwarded header、API のオリジンは採用しない。
|
||||
`archive-config.js` の `window.archiveConfig.origin` を HTTP(S) の本家基点 URL
|
||||
(例: `https://example.org`)に変更すれば本家リンクをまとめて変更できる。
|
||||
設定 JS が削除・欠落・不正な場合や JS 無効時にも HTML の初期リンクが残る。
|
||||
@@ -54,6 +58,8 @@ URL に JSON を格納しない。`at` 等の任意時点入力・未知の生
|
||||
- 同時実行1件、全セッションを通じて新規登録は60秒に1件、登録から処理期限60秒。
|
||||
競合・受付制限は429と `Retry-After`。状態取得・取得時の短いロック競合は503。
|
||||
- ZIP とジョブの認可期限は10分。次のジョブ登録で前の ZIP / ジョブは置き換える。
|
||||
queued / running の予約は cooldown が過ぎても置き換えない。75秒を超えた予約は
|
||||
状態取得又は次の受付で failed にし、実行ロックが空いている場合だけ次を受け付ける。
|
||||
期限後も最後のファイルがディスクに残り得るが、API では取得できない。
|
||||
容量は単一 ZIP と作業ファイルに限定され、無制限に蓄積しない。
|
||||
|
||||
@@ -63,7 +69,9 @@ Rails の既存 Active Job と `:async` adapter を使い、生成は HTTP reque
|
||||
受付・状態・ZIP は `backend/tmp/static_mirror/` の単一 spool を使う。
|
||||
プロセス間の filesystem lock で実行枠と更新を制御する。各ファイルは0600、directory は
|
||||
0700で作成する。Web プロセス再起動で非永続キューが失われる点が PoC の限界。
|
||||
進まない queued / running は75秒後の状態取得で failed になる。再開や再実行はしない。
|
||||
進まない queued / running は75秒経過後の状態取得又は次の受付で failed になる。
|
||||
worker は受付中の短い実行ロック競合を待ち、競合だけを理由に queued を放棄しない。
|
||||
再開や再実行はしない。実行ロック待ちも登録からの60秒の処理期限に含まれる。
|
||||
|
||||
失敗コードは `too_large`、`generation_timeout`、`publication_changed`、
|
||||
`generation_failed`、`worker_stopped`。内部の例外本文・パス・資源属性は応答に含めない。
|
||||
@@ -78,19 +86,47 @@ legacy record は安全側で対象外とする。公開不可の参照を含む
|
||||
廃止 Tag は対象外。HTML / 検索 JSON / manifest の件数には認可済みの出力集合だけが入る。
|
||||
user、actor、履歴版番号、監査、認証、blob 情報は投影しない。
|
||||
|
||||
公開条件の調査範囲は V1 の Post / Tag / TagName / Locale の model、schema、
|
||||
閲覧 controller・representation、HistoryAccess と Material の抑止経路。
|
||||
Post / Tag / TagName には別の private / visibility カラムや、汎用の公開抑止 scope は
|
||||
見つからなかった。Tag の `deprecated_at` は除票とは別の廃止状態で、通常の Post
|
||||
表示からも除外されるため、ミラーから引き続き除外する。Locale の廃止後も配布しない。
|
||||
`MaterialImportBlock`、`MaterialSyncSuppression` は著作権・個人情報等を理由にした
|
||||
素材取込・同期の抑止であり、Post / Tag の汎用認可として流用しない。Material と
|
||||
関連ファイル・監査用の理由・同期元情報は全て出力対象外のままにする。
|
||||
既存の通常 Post / Tag 閲覧経路が共通認可を一律適用しているとは仮定せず、
|
||||
ミラー自身は必ず HistoryAccess を経由する。新たな抑止条件を導入する場合には
|
||||
適用範囲を確認して共通認可と静的配布契約を更新する必要がある。
|
||||
|
||||
`CountsExporter.with_read_snapshot` の既存 repeatable-read 境界を再利用し、Post、Tag、
|
||||
全言語 TagName、PostTag、publication revision を同じ読み取り view から取得する。
|
||||
これには既存 HistoryAccess の SQL が動作する MySQL 環境が必要。未対応の adapter や
|
||||
未整備の DB では生成失敗とし、認可を迂回した出力へフォールバックしない。
|
||||
`data_at` はこの現在状態読み取りの開始時刻であり、履歴の指定日時復元を表さない。
|
||||
`data_at` は DB 読み取り transaction を要求する直前の、取得処理開始時の
|
||||
サーバー時計(UTC)。manifest の `data_at_basis: capture_started_at` に意味を記録する。
|
||||
MySQL の read view は後の最初の consistent read で成立するため、その厳密な成立時刻や
|
||||
`data_at` 以前のコミットだけを含むことは保証しない。履歴の指定日時復元も表さない。
|
||||
独立した worker では repeatable-read を開始するが、呼出元の transaction がある場合は
|
||||
既存 helper の契約どおり、その transaction の view と分離レベルを引き継ぐ。
|
||||
`generated_at` はファイル生成後の別の時刻。
|
||||
|
||||
生成の最後と状態・ZIP 取得時に既存 artifact policy / discard revision を再検証する。
|
||||
静的配布契約は `StaticMirror::PUBLICATION_POLICY` の
|
||||
`static-mirror-public-projection-1`。Counts 用 `HistoryAccess::ARTIFACT_POLICY`、
|
||||
`authority`、`authorised_artifact?` は使わない。共通 HistoryAccess の現在版認可と
|
||||
全後続除票の revision 検知は再利用し、集計件数の例外や admin の配布モードは設けない。
|
||||
旧 Counts 契約の metadata しかない ZIP は再生成を必要とする。
|
||||
|
||||
生成の最後と状態・ZIP 取得時に、別の読み取り transaction で共通 discard revision と
|
||||
出力対象 ID の公開投影を再取得する。SQL query cache を使わず、対象の存在、確定版、
|
||||
Tag / Locale の廃止、タイトル・URL・category、全言語名・別名・文字体系、関連の変更を
|
||||
検知する。除票を伴わない訂正・削除も投影 digest の不一致として配布を止める。
|
||||
対象 ID と digest はサーバー側ジョブ metadata にだけ置き、manifest や API 状態応答へ
|
||||
出さない。対象は各100件・名前2,000行以内の一括取得で、行ごとの追加 query は行わない。
|
||||
生成中の除票は失敗にし、生成後の除票では古い ZIP の再取得を404にする。
|
||||
ZIP は再認可後のバイト列として返し、遅延 sendfile に古いパスを渡さない。
|
||||
HTTP 応答は既存境界の `private, no-store`。ダウンロード済み ZIP の回収や、
|
||||
最終認可と送出の間に発生する公開制御変更の完全な排他は保証できない。
|
||||
新しい公開制御を導入する場合は共通 policy と artifact revision の連動が必要。
|
||||
新しい公開制御を導入する場合は共通 policy と静的配布契約の連動が必要。
|
||||
|
||||
本文・名前・URL は escape する。外部リンクは HTTP(S)・host・userinfo 不在を検証し、
|
||||
不正な URL はリンクとして出さない。外部 URL の取得は行わないため SSRF 用 DNS 検査を
|
||||
@@ -132,14 +168,20 @@ HTTP 応答は既存境界の `private, no-store`。ダウンロード済み ZIP
|
||||
|
||||
- `backend/spec/services/static_mirror_spec.rb`: ZIP の CRC / 構造、全ファイルの hash、
|
||||
内部参照、escape、基準時点、公開権限、後続除票、言語名・別名、容量・件数上限。
|
||||
今回は Counts 契約との独立性、除票なしの訂正・廃止・関連変更、取得開始時刻の意味、
|
||||
Post 検索への関連名の投影を追加。
|
||||
- `backend/spec/requests/static_mirrors_spec.rb`: 一般受付、非同期境界、所有権、
|
||||
公開制御変更、失敗・期限・競合・全体 rate limit、開発環境制限、CSRF と BAN。
|
||||
今回は Host に依存しない本家リンク、訂正後の取得拒否、queued 予約の保持・期限切れ、
|
||||
実 filesystem lock を使う受付競合待ちを追加。
|
||||
- `frontend/src/pages/StaticMirrorPage.test.tsx`: 開始、進捗、取得、失敗、
|
||||
受付エラー、認可喪失、日本語 fallback の言語属性。
|
||||
- `frontend/src/lib/staticMirrorAssets.test.ts`: 静的検索の相対参照・escape と
|
||||
サブディレクトリ配備、本家設定の欠落・不正・変更。
|
||||
今回は Tag 名・別名から関連 Post が見つかるケースを追加。検索 JS の変更は不要。
|
||||
|
||||
実施したのは既存コードの調査と差分の目視確認のみ。テスト、lint、build、型検査、
|
||||
実施したのは既存コードの調査、差分の目視確認と `git diff --check`(成功)。
|
||||
テスト、lint、build、型検査、
|
||||
migration、実ブラウザーでの表示、ZIP 展開・HTTP 配置は実行していない。
|
||||
管理者指定の suite による結果確認と、サブディレクトリ配置・JS 無効・原サーバー停止・
|
||||
設定 JS 欠落・静的検索の実画面確認が残る。
|
||||
@@ -149,6 +191,20 @@ rate limit、容量・時間・負荷の実測、公開制御の監査と変更
|
||||
asset の権利・保管方針、追加 resource の安全な投影、UI 文言・翻訳の確定が必要。
|
||||
本 PoC の開発環境制限を単に外して公開することは想定しない。
|
||||
|
||||
## 今回のレビュー対応の変更ファイル
|
||||
|
||||
| ファイル | 修正と理由 |
|
||||
| --- | --- |
|
||||
| `backend/app/controllers/static_mirrors_controller.rb` | request オリジンを生成処理へ渡さず、本家リンクへの Host 混入を防止 |
|
||||
| `backend/app/jobs/static_mirror_job.rb` | 静的配布専用の再認可、queued 予約と期限切れの共通処理、worker のロック待ちでジョブ消失を防止 |
|
||||
| `backend/app/services/static_mirror.rb` | Counts と独立した公開投影の再検証、関連 Tag 名を含む Post 検索、正規の本家リンク初期値、`data_at_basis` |
|
||||
| `backend/spec/services/static_mirror_spec.rb` | 専用契約・訂正・廃止・関連変更・検索投影・時刻意味の回帰テスト |
|
||||
| `backend/spec/requests/static_mirrors_spec.rb` | 本家オリジン・ZIP 再認可・queued 予約・実行ロック競合の回帰テスト |
|
||||
| `frontend/src/lib/staticMirrorAssets.test.ts` | 名前・別名を使う Post 検索の回帰テスト |
|
||||
| `docs/static-mirror.md` | 公開条件の調査結果、配布契約、ロックと時刻の保証範囲・未解決事項を更新 |
|
||||
|
||||
V2、DB schema / migration、既存の Counts 契約・共通認可、UI 文言は変更していない。
|
||||
|
||||
## 変更ファイルの責務
|
||||
|
||||
| ファイル | 責務 |
|
||||
|
||||
新しいイシューから参照
ユーザーをブロックする