大規模Webサイトの緊急静的化・本番公開対応
要点
- 過去90日間で数百万人規模の利用実績がある大規模商用Webサイトの緊急静的化対応
- トップページおよび262HTMLファイルの改修
- 複数の既存技術にまたがる依存関係の調査
案件背景
数百万人規模のアクティブユーザーを有する大規模Webサイトにおいて、システム上の制約により、必要最小限のページ・機能を静的HTMLで公開する緊急対応を実施。
CakePHP、Movable Type、SSI、JavaScriptなど、複数の技術が混在する既存環境を調査し、動的処理への依存関係を整理。既存のデザインと必要な導線を維持しながら、静的環境で動作する構成へ変更した。
技術調査・実装方針の設計・改修・検証・本番公開対応を中心に担当。Claude Codeを活用し、打ち合わせを含む総工数28時間で本番公開まで完了できた。
CakePHP、Movable Type、SSI、JavaScriptなど、複数の技術が混在する既存環境を調査し、動的処理への依存関係を整理。既存のデザインと必要な導線を維持しながら、静的環境で動作する構成へ変更した。
技術調査・実装方針の設計・改修・検証・本番公開対応を中心に担当。Claude Codeを活用し、打ち合わせを含む総工数28時間で本番公開まで完了できた。
課題
- PHP・SSI・APIなどの動的処理に依存する既存ページを、静的環境でも表示できる状態にする必要があった
- 複数の技術・世代の異なる実装が混在し、変更による影響範囲を把握しにくい構造だった
- サーバー環境の制約により、既存のJavaScriptや外部ライブラリが正常に動作しない箇所があった
- 必要な導線を維持しつつ、静的化後に利用できない機能やページへの導線を整理する必要があった
- 緊急対応のため、調査・実装・検証・公開までを短期間で進める必要があった
やったこと
- CakePHP・Movable Type・SSI・JavaScriptの依存関係を調査し、静的化に必要な変更箇所を整理
- 既存HTMLをベースにトップページ・下層262ページを静的化
- PHPによる動的出力を静的HTMLや既存生成ファイルの参照に置き換え
- 販売導線・ページ間リンク・アセット参照パスを調整
- SSI無効化による表示不具合を目視確認し、対象ページへの導線を整理
- 外部CDNの読み込み不具合に対し、必要なJavaScriptライブラリをローカル配置
- ローカル確認環境の構築、ステージング環境での検証、本番公開対応を実施
- Claude Codeを使用して多数のファイルにまたがる調査・改修を進め、変更内容と留意事項をドキュメント化
実現したこと
- トップページおよび対象ページの静的化を完了
- 静的環境でも必要な表示と販売導線を維持
- ステージング環境で発生したJavaScriptの表示不具合を解消
- 対象外ページ・機能を切り分け、公開範囲を限定
- 新設サーバーでの本番公開を完了し、クライアントによる確認を取得
設計のポイント
既存システムの依存関係を整理し、静的化に必要な変更範囲を限定
PHP・SSI・APIによる処理を一律に除去するのではなく、ページ表示に必要な処理と、静的化後に利用できない処理を切り分けた。
また、コード上でSSIを使用していることと、実際に表示不具合が発生していることは区別し、画面の目視確認に基づいて対応対象を特定。
既存の構成を全面的に作り直さず、公開要件を満たすために必要な変更へ絞ることで、改修範囲と検証対象を抑えた。
また、コード上でSSIを使用していることと、実際に表示不具合が発生していることは区別し、画面の目視確認に基づいて対応対象を特定。
既存の構成を全面的に作り直さず、公開要件を満たすために必要な変更へ絞ることで、改修範囲と検証対象を抑えた。
AIによる横断実装と、人間による表示・品質判断を分担
Claude Codeを利用し、複数ファイルにまたがる依存関係の調査やHTML・JavaScriptの修正を実施。
一方、実際の画面表示、利用者の導線、公開対象の判断については、コード解析だけでなく目視確認と要件との照合を行った。
AIに調査・実装を任せながら、対応範囲の判断と検証を人間が担うことで、複雑な既存環境に対する短期間の改修を進めた。
一方、実際の画面表示、利用者の導線、公開対象の判断については、コード解析だけでなく目視確認と要件との照合を行った。
AIに調査・実装を任せながら、対応範囲の判断と検証を人間が担うことで、複雑な既存環境に対する短期間の改修を進めた。
よくなったこと
複数の技術が混在する大規模Webサイトに対し、既存システムの調査から静的化の実装・検証・本番公開までをほぼ単独で担当。
AIコーディングエージェントによる横断的な実装と、技術的な判断・目視検証を組み合わせ、打ち合わせを含む総工数28時間で緊急公開を完了した。
AIコーディングエージェントによる横断的な実装と、技術的な判断・目視検証を組み合わせ、打ち合わせを含む総工数28時間で緊急公開を完了した。
補足
- 技術調査から本番公開まで、打ち合わせを含む総工数28時間で完了
- 262HTMLファイルを含む複数ページの静的化を実施
- 既存の動的処理への依存を整理し、必要最小限の公開状態を構築
- AIコーディングエージェントを活用した横断改修の実務経験を蓄積
- 公開完了後の保守・追加対応に向けて、変更内容と残存する制約を文書化