Static Mirror 生成機能 #483

オープン
みてるぞが2026-11-16 12:44:33 +09:00に作成 · 1件のコメント
オーナー

目的

タグ広場のある時点の状態を静的 HTML として保存し、FC2 等の静的 Web ホスティングへ配置できる機能を実装したい。

最大の目的は、タグ広場の運営者や元サーバが将来存在しなくなっても、第三者がサイトの保存版を閲覧・複製・再公開できるようにすることである。

今回は完成実装ではなく、動作する縦断的な PoC を作成する。

1. 完成形として維持する要件

過去の設計議論で、以下の方針を採用している。

  • 全ユーザがフロントエンドからスナップショット生成を開始できる。
  • 任意の過去時点を指定でき、その時点の公開状態を復元できる。
  • 公開可能な Post、Tag、Tag Description、Help、Material 等の閲覧用ページを対象とする。
  • 静的 HTML 群を ZIP にまとめてダウンロードできる。
  • 配置先では DB、Node.js、SvelteKit server、外部 API を必要としない。
  • 内部リンクは保存版内で完結する。
  • 検索も静的サイト内で利用可能にする。
  • ログイン、作成、編輯等の操作を撤去した閲覧専用 UI とする。
  • 全ページにスナップショットであることとデータ取得時点を表示する。
  • 元のタグ広場の対応ページへ移動できるリンクを設ける。
  • 本家 URL は各 HTML に初期値を持たせ、共通設定 JS によって後から変更できる構造とする。
  • 共通設定 JS が存在しなくても、HTML 自体の閲覧は成立する。
  • ミラーの全ページに noindex を設定する。
  • ZIP を取得した第三者が、元の運営者の協力なしで公開・管理できる。

これらは完成形の要件であり、今回すべてを実装する必要はない。

2. 今回の PoC の実装範囲

まず現在状態を対象とし、以下を実装する。

2.1 静的サイト生成

最低限、次の HTML を生成する。

archive/
  index.html
  robots.txt
  assets/
    archive.css
    archive.js
  ja/
    posts/
      index.html
      123/
        index.html
    tags/
      index.html
      456/
        index.html
  search-index.json
  archive-config.js
  manifest.json

この構造は例であり、既存の locale routing に応じて適切に変更してよい。

実装上の要件:

  • サーバ側で静的 HTML を生成する。
  • 通常の SvelteKit SSR route を単純にクローリングする方法に限定しない。
  • 生成処理は共通 application logic を再利用する。
  • HTML escape、URL validation 等を適切に行う。
  • 内部リンクと静的資産への参照は相対 URL とし、サブディレクトリ配備に対応する。
  • index.html に一覧への導線を設ける。
  • Post / Tag の一覧と詳細から相互に移動できる。
  • JavaScript 無効時も主要な閲覧とリンク移動ができる。
  • 検索は静的 JSON と client-side JavaScript を使ってよい。
  • 外部画像や動画への依存は明示し、ローカルへ取り込めていない資産を自己完結していると称しない。

現行 UI の全再現は不要。ただし、単なる JSON dump を HTML で包んだものではなく、閲覧可能なサイトとして成立させる。

2.2 ZIP 出力

生成した静的サイト一式を ZIP としてダウンロード可能にする。

ZIP 展開後、そのディレクトリを通常の静的 HTTP サーバに置くだけで閲覧できること。

manifest.json には最低限以下を記録する。

  • アーカイブ形式のバージョン
  • 生成日時
  • データ基準時点
  • 対象 locale
  • 出力対象 resource と件数
  • 出力対象外の機能・データ
  • 各ファイルの相対 path と SHA-256

生成日時とデータ基準時点を混同しないこと。

2.3 フロントエンドからの操作

一般ユーザがアクセスできるスナップショット生成画面を試作する。

画面には以下を設ける。

  • スナップショット生成の操作
  • データ基準時点の表示
  • 生成状態・進捗
  • 成功時の ZIP ダウンロード
  • 失敗時の理由の表示

PoC では生成件数・同時実行数を制限してよい。ただし、その制限を明示すること。

重い生成処理を HTTP request 内で無制限に同期実行しないこと。既存の background job 構造がなければ、PoC 用の最小構成でよいが、その限界を報告すること。

未認証利用者による大量ジョブ作成を防ぐため、rate limit 等の安全対策を設ける。安全に一般公開できない段階では、開発環境限定で有効化してよい。

3. 任意時点の復元について

最終仕様では、利用者が任意の日時を指定できなければならない。

ただし、今回は現在状態の生成を優先する。

既存の post_versions、tag_versions その他の immutable history を調査し、過去時点の復元に必要な情報が揃っているか評価すること。

特に次を確認する。

  • 指定日時以前の最新 version を特定できるか。
  • 当時の Tag Name、Post Tag、親子関係を復元できるか。
  • 当時の publication policy を復元できるか。
  • 現在は公開禁止になっている過去データの漏洩を防げるか。
  • 時点の異なる現在状態を混ぜない、一貫したスナップショットを取得できるか。

正確な時点復元を保証できない場合、指定日時で復元できるかのような仮実装は禁止する。

今回は現在状態のみの対応として明示し、過去時点復元の不足要件を報告すること。

4. 公開制御と安全性

静的 ZIP は一度配布すると回収できないため、公開制御を特に慎重に扱うこと。

  • 公開抑止、除票、非公開情報、認証情報、監査専用情報を ZIP に含めない。
  • 既存の server-side publication policy を再利用する。
  • export 用に独立した、簡略化された権限判定を作らない。
  • 出力 HTML の本文、リンク、画像、JSON 等を通じた情報漏洩も防ぐ。
  • noindex を各 HTML に焼き込む。
  • 対象資産に現在の公開制御が適用できない場合は、安全に失敗させる。

既存の公開制御実装が未完成なら、全データを公開可能と仮定してはならない。必要なら固定のテストデータだけで静的生成の動作確認を進めること。

5. 実装上の制約

  • 本機能は DB backup / restore とは別の、閲覧用静的アーカイブ生成機能として実装する。
  • DB schema の変更・migration は今回は行わない。
  • SYSTEM_SPEC.md は勝手に書き換えない。
  • 既存の Post / Tag / publication policy / locale 等を大規模に再設計しない。
  • 新しい production dependency を勝手に追加しない。
  • 一般的な静的 Web ホスティングに対応し、特定サービス固有の API を必須にしない。
  • ソースコードのコーディングスタイルは AGENTS.md と既存プロジェクト規約に従う。
  • テスト、lint、build、DB migration は明示的に許可されない限り実行しない。
  • 不必要な別 repository や別 application を作成しない。

6. 完了条件

PoC の最低限の完成条件は次のとおり。

  1. フロントエンドから生成を開始できる。
  2. 少なくとも公開可能な Post / Tag の一覧・詳細が静的 HTML として出力できる。
  3. サイト全体を ZIP として取得できる。
  4. ZIP を展開して静的 HTTP サーバへ配置した場合、元のタグ広場のサーバが停止していても閲覧・ページ移動できる。
  5. データ取得時点と静的保存版である旨が表示される。
  6. 本家へのリンクがあり、配置先の変更によって内部リンクが壊れない。
  7. 未対応機能、出力件数の制限、データ保護上の制約が明示される。

7. 最終報告

実装後、次を報告すること。

  • 変更ファイル一覧と各ファイルの責務
  • 実装した機能
  • 仮実装・未実装の機能
  • 起動・生成・ZIP 取得の手順
  • 実施した検証と未実施の検証
  • 任意時点復元に必要な追加設計
  • 本番運用に移るための残課題

設計だけで終了せず、可能な限り動作するコードを作成すること。

ただし、完成させるために既存仕様の改変や安全性の妥協が必要なら、独断で実施せず制約として報告すること。

## 目的 タグ広場のある時点の状態を静的 HTML として保存し、FC2 等の静的 Web ホスティングへ配置できる機能を実装したい。 最大の目的は、タグ広場の運営者や元サーバが将来存在しなくなっても、第三者がサイトの保存版を閲覧・複製・再公開できるようにすることである。 今回は完成実装ではなく、**動作する縦断的な PoC** を作成する。 ## 1. 完成形として維持する要件 過去の設計議論で、以下の方針を採用している。 - 全ユーザがフロントエンドからスナップショット生成を開始できる。 - 任意の過去時点を指定でき、その時点の公開状態を復元できる。 - 公開可能な Post、Tag、Tag Description、Help、Material 等の閲覧用ページを対象とする。 - 静的 HTML 群を ZIP にまとめてダウンロードできる。 - 配置先では DB、Node.js、SvelteKit server、外部 API を必要としない。 - 内部リンクは保存版内で完結する。 - 検索も静的サイト内で利用可能にする。 - ログイン、作成、編輯等の操作を撤去した閲覧専用 UI とする。 - 全ページにスナップショットであることとデータ取得時点を表示する。 - 元のタグ広場の対応ページへ移動できるリンクを設ける。 - 本家 URL は各 HTML に初期値を持たせ、共通設定 JS によって後から変更できる構造とする。 - 共通設定 JS が存在しなくても、HTML 自体の閲覧は成立する。 - ミラーの全ページに `noindex` を設定する。 - ZIP を取得した第三者が、元の運営者の協力なしで公開・管理できる。 これらは完成形の要件であり、今回すべてを実装する必要はない。 ## 2. 今回の PoC の実装範囲 まず現在状態を対象とし、以下を実装する。 ### 2.1 静的サイト生成 最低限、次の HTML を生成する。 ```text archive/ index.html robots.txt assets/ archive.css archive.js ja/ posts/ index.html 123/ index.html tags/ index.html 456/ index.html search-index.json archive-config.js manifest.json ``` この構造は例であり、既存の locale routing に応じて適切に変更してよい。 実装上の要件: - サーバ側で静的 HTML を生成する。 - 通常の SvelteKit SSR route を単純にクローリングする方法に限定しない。 - 生成処理は共通 application logic を再利用する。 - HTML escape、URL validation 等を適切に行う。 - 内部リンクと静的資産への参照は相対 URL とし、サブディレクトリ配備に対応する。 - `index.html` に一覧への導線を設ける。 - Post / Tag の一覧と詳細から相互に移動できる。 - JavaScript 無効時も主要な閲覧とリンク移動ができる。 - 検索は静的 JSON と client-side JavaScript を使ってよい。 - 外部画像や動画への依存は明示し、ローカルへ取り込めていない資産を自己完結していると称しない。 現行 UI の全再現は不要。ただし、単なる JSON dump を HTML で包んだものではなく、閲覧可能なサイトとして成立させる。 ### 2.2 ZIP 出力 生成した静的サイト一式を ZIP としてダウンロード可能にする。 ZIP 展開後、そのディレクトリを通常の静的 HTTP サーバに置くだけで閲覧できること。 `manifest.json` には最低限以下を記録する。 - アーカイブ形式のバージョン - 生成日時 - データ基準時点 - 対象 locale - 出力対象 resource と件数 - 出力対象外の機能・データ - 各ファイルの相対 path と SHA-256 生成日時とデータ基準時点を混同しないこと。 ### 2.3 フロントエンドからの操作 一般ユーザがアクセスできるスナップショット生成画面を試作する。 画面には以下を設ける。 - スナップショット生成の操作 - データ基準時点の表示 - 生成状態・進捗 - 成功時の ZIP ダウンロード - 失敗時の理由の表示 PoC では生成件数・同時実行数を制限してよい。ただし、その制限を明示すること。 重い生成処理を HTTP request 内で無制限に同期実行しないこと。既存の background job 構造がなければ、PoC 用の最小構成でよいが、その限界を報告すること。 未認証利用者による大量ジョブ作成を防ぐため、rate limit 等の安全対策を設ける。安全に一般公開できない段階では、開発環境限定で有効化してよい。 ## 3. 任意時点の復元について 最終仕様では、利用者が任意の日時を指定できなければならない。 ただし、今回は現在状態の生成を優先する。 既存の `post_versions`、`tag_versions` その他の immutable history を調査し、過去時点の復元に必要な情報が揃っているか評価すること。 特に次を確認する。 - 指定日時以前の最新 version を特定できるか。 - 当時の Tag Name、Post Tag、親子関係を復元できるか。 - 当時の publication policy を復元できるか。 - 現在は公開禁止になっている過去データの漏洩を防げるか。 - 時点の異なる現在状態を混ぜない、一貫したスナップショットを取得できるか。 **正確な時点復元を保証できない場合、指定日時で復元できるかのような仮実装は禁止する。** 今回は現在状態のみの対応として明示し、過去時点復元の不足要件を報告すること。 ## 4. 公開制御と安全性 静的 ZIP は一度配布すると回収できないため、公開制御を特に慎重に扱うこと。 - 公開抑止、除票、非公開情報、認証情報、監査専用情報を ZIP に含めない。 - 既存の server-side publication policy を再利用する。 - export 用に独立した、簡略化された権限判定を作らない。 - 出力 HTML の本文、リンク、画像、JSON 等を通じた情報漏洩も防ぐ。 - `noindex` を各 HTML に焼き込む。 - 対象資産に現在の公開制御が適用できない場合は、安全に失敗させる。 既存の公開制御実装が未完成なら、全データを公開可能と仮定してはならない。必要なら固定のテストデータだけで静的生成の動作確認を進めること。 ## 5. 実装上の制約 - 本機能は DB backup / restore とは別の、閲覧用静的アーカイブ生成機能として実装する。 - DB schema の変更・migration は今回は行わない。 - `SYSTEM_SPEC.md` は勝手に書き換えない。 - 既存の Post / Tag / publication policy / locale 等を大規模に再設計しない。 - 新しい production dependency を勝手に追加しない。 - 一般的な静的 Web ホスティングに対応し、特定サービス固有の API を必須にしない。 - ソースコードのコーディングスタイルは `AGENTS.md` と既存プロジェクト規約に従う。 - テスト、lint、build、DB migration は明示的に許可されない限り実行しない。 - 不必要な別 repository や別 application を作成しない。 ## 6. 完了条件 PoC の最低限の完成条件は次のとおり。 1. フロントエンドから生成を開始できる。 2. 少なくとも公開可能な Post / Tag の一覧・詳細が静的 HTML として出力できる。 3. サイト全体を ZIP として取得できる。 4. ZIP を展開して静的 HTTP サーバへ配置した場合、元のタグ広場のサーバが停止していても閲覧・ページ移動できる。 5. データ取得時点と静的保存版である旨が表示される。 6. 本家へのリンクがあり、配置先の変更によって内部リンクが壊れない。 7. 未対応機能、出力件数の制限、データ保護上の制約が明示される。 ## 7. 最終報告 実装後、次を報告すること。 - 変更ファイル一覧と各ファイルの責務 - 実装した機能 - 仮実装・未実装の機能 - 起動・生成・ZIP 取得の手順 - 実施した検証と未実施の検証 - 任意時点復元に必要な追加設計 - 本番運用に移るための残課題 **設計だけで終了せず、可能な限り動作するコードを作成すること。** ただし、完成させるために既存仕様の改変や安全性の妥協が必要なら、独断で実施せず制約として報告すること。
テツノニジカ がラベル ai:running を追加、 ai:ready を除去 2026-11-16 12:45:33 +09:00
テツノニジカ がラベル ai:running を除去 2026-11-16 13:11:59 +09:00
共同作業者

Codex は途中実装を feature/483 に通常 push しました。PR は作成・更新していません。
PR が必要になったら ai:mode:branch を外して再予約してください。

開発環境限定の PoC を実装しました。

  • 公開認可・確定版を確認できる Post/Tag の一覧・詳細、静的検索、ZIP 出力
  • 相対リンク、noindex、基準時点、本家リンク、SHA-256 付き manifest
  • 一般利用者向けの生成画面、進捗・失敗表示、ZIP 取得
  • 各100件・8 MiB・同時生成1件・60秒間隔の制限、取得時の公開権限再確認

既存の開発サーバーで /ja/static-mirror を開き、生成後に ZIP を取得します。過去時点復元、Help、Tag Description、Material、画像・動画の同梱は未対応です。ジョブは非永続のため、本番化には durable worker 等が必要です。

回帰テストを4ファイル追加しました。指示どおり、テスト・lint・build・migration は実行していません。ZIP 展開・実画面確認も未実施です。

全変更ファイルの責務、起動手順、履歴復元の調査結果と残課題は 実装報告 に記載しました。

Codex 利用枠(取得: 2026-11-16 13:12 JST)
5 h の残量: 81.0%
5 h の恢復時刻: 2026-11-16 17:45 JST
1 週間の残量: 70.0%
1 週間の恢復時刻: 2026-11-21 00:26 JST

Codex は途中実装を `feature/483` に通常 push しました。PR は作成・更新していません。 PR が必要になったら `ai:mode:branch` を外して再予約してください。 開発環境限定の PoC を実装しました。 - 公開認可・確定版を確認できる Post/Tag の一覧・詳細、静的検索、ZIP 出力 - 相対リンク、`noindex`、基準時点、本家リンク、SHA-256 付き manifest - 一般利用者向けの生成画面、進捗・失敗表示、ZIP 取得 - 各100件・8 MiB・同時生成1件・60秒間隔の制限、取得時の公開権限再確認 既存の開発サーバーで `/ja/static-mirror` を開き、生成後に ZIP を取得します。過去時点復元、Help、Tag Description、Material、画像・動画の同梱は未対応です。ジョブは非永続のため、本番化には durable worker 等が必要です。 回帰テストを4ファイル追加しました。指示どおり、テスト・lint・build・migration は実行していません。ZIP 展開・実画面確認も未実施です。 全変更ファイルの責務、起動手順、履歴復元の調査結果と残課題は [実装報告]( /var/lib/gitea-codex-v4/runs/impl/issue-483-n_gqazl9/repo/docs/static-mirror.md) に記載しました。 Codex 利用枠(取得: 2026-11-16 13:12 JST) 5 h の残量: 81.0% 5 h の恢復時刻: 2026-11-16 17:45 JST 1 週間の残量: 70.0% 1 週間の恢復時刻: 2026-11-21 00:26 JST
テツノニジカ がコミットでこのイシューを参照 2026-11-16 13:12:01 +09:00
サインインしてこの会話に参加。
2 人の参加者
通知
期日
期日は設定されていません。
依存関係

依存関係は設定されていません。

リファレンス: miteruzo/btrc-hub#483