作成日:

見た目は変えずに裏側を大掃除。個人サイトのコードを丁寧に整え直したお話(前編)

個人サイト「霊狐の神楽舞」の見た目はそのままに、裏側のプログラムを丁寧に整え直す大掃除を進めています。今回は、安心して作業を進めるための工夫や、長く継ぎ足してきたコードを少しずつ片付けていった制作の裏側を前編として綴ります。

長く個人サイトを育てていると、季節の演出や思いついた機能を少しずつ足していくうちに、裏側の仕組みがだんだんと複雑になっていくものです。鳥居や社殿の佇まいはそのままに、見えない床下や収納棚をきれいに片付けて、これからも気持ちよく手を入れられる場所にしておきたい。そんな思いから、今回は大掛かりなコードの整理(リファクタリング)に取り組んでみました。

見た目は変えずに裏側を大掃除。個人サイトのコードを丁寧に整え直したお話(前編) (Gemini 画像生成)
見た目は変えずに裏側を大掃除。個人サイトのコードを丁寧に整え直したお話(前編) (Gemini 画像生成)

1. 「お参りの景色を絶対に崩さない」ための、小さな見張り役

大掃除を始めるにあたり、最初にひとつだけ固く決めた約束がありました。それは、「サイトを訪れてくださる方に見える景色やページの仕組みは、何ひとつ変えない」ということです。

新しい機能を増やしながら片付けも進めてしまうと、もしどこかで表示が崩れたときに、何が原因なのか分からなくなってしまいます。そこで今回は純粋に裏側の整理だけに集中し、まずは「片付けの前と後で、サイトの出力結果がまったく同じかどうかを自動で確かめるチェック役」を作るところから始めました。

トップページや社務日誌、奉納絵巻のギャラリーなど、主要なページをひと通り見回って結果を比べる仕組みです。ただ、実際に動かしてみると、ただ画面を比べるだけではうまくいかない可愛らしい落とし穴がありました。

ページを開くたびに訪問者数のカウンタが1つずつ増えたり、初めて表示されるタイミングで画像の準備が走ったりするため、普通に比べるだけでは毎回「少しだけ違いがある」と判定されてしまうのです。そこで、チェックが終わったらカウンタをそっと元の数字に戻し、落ち着いた2回目の表示を基準にする工夫を加えました。頼もしい見張り役がそばにいてくれるおかげで、安心して大掃除へ踏み出せるようになりました。

2. 継ぎ足してきた歴史と向き合い、小さな区切りで進める

見張り役が整ったところで、次はサイト全体のファイルをひと通り見渡し、今の状態を冷静に棚卸ししてみました。長年その時々の「これをやってみたい」を形にしてきただけあって、数字にして眺めてみると、なかなかの歴史が積み重なっています。

見直したポイントお掃除前のようす今回の整理で目指したこと
ルールの厳格さ昔ながらの緩やかな書き方が残っているファイルごとに厳格なチェックを入れる
長くなりすぎた処理1つの処理が数百〜千行近くまで育っている役割ごとの小さな単位へ分け直す
データの受け渡しあちこちから共通の箱を直接覗き見ている必要な情報だけを明示的に渡す形へ
見た目と計算の同居画面を描く途中にファイル操作が混ざっている「裏方の計算」と「画面の表示」を分ける

一気にすべてを書き換えてしまいたくなる気持ちを抑え、今回は作業をいくつかの段階に細かく分けることにしました。ひとつの区切りを終えるごとに、見張り役によるチェックと記録の更新を欠かさず挟む。急がば回れの進め方ですが、こうした小さな確認の積み重ねが、結果的に一番の近道になってくれます。

3. 1文字のズレも見逃さないチェックに助けられた場面

実際の整理では、画面の表示を担当するファイルに混ざり込んでいた「データの読み込み」や「集計の計算」を、裏方の専用ファイルへ少しずつお引っ越しさせていきました。

ただ、既存の仕組みを外から呼び出しているページまで一度に書き換えるのは危ういため、外側の窓口はそのまま残しつつ、中身の処理だけを新しい担当へ引き継ぐ方法を選んでいます。たとえるなら、社務所の受付窓口の場所は変えずに、奥の作業机だけを綺麗に並べ替えるようなイメージです。

この作業の中で印象的だったのが、あるボタンの表示を整えていたときのことでした。見た目はまったく同じはずなのに、見張り役が「わずかに違いがある」と教えてくれたのです。

不思議に思って調べてみると、なんと改行の種類がほんの少しだけ違っていたことが分かりました。普段目で見ているだけでは絶対に気づけないような1文字の違いまで見つけてくれるのは、少し驚くと同時に、とても心強く感じられます。また、すでに別の場所で安全に整えられた文字をもう一度変換してしまわないよう、状況に応じた専用の通り道を用意するなど、細かな手当てを重ねながら進めました。

4. 大きく育ちすぎた処理を、小さな小部屋へ分け直す

表示まわりの整理が落ち着いたあとは、画像生成やSNS連携、日誌の集計などを支えている裏方のモジュール群にも手を入れていきました。

中でも目を引いたのが、1つの処理の中に「データの読み込み」「期間ごとの集計」「ランキングの並び替え」「グラフ用の整形」などがぎゅっと詰め込まれ、1,000行近くまで育っていた箇所です。書いた当時の熱量は伝わってくるものの、後から読み返すとどこで何をしているのかを辿るだけで一苦労してしまいます。

これらをいきなり作り直すのではなく、意味のあるまとまりごとに少しずつ切り分け、20個以上の小さな役割へと丁寧に分け直しました。それぞれが50行以内の見通しの良い小部屋に収まったことで、画面をスクロールしなくても処理の流れがひと目で把握できるようになっています。

こうして裏方のファイル群をすべて見直し終えたとき、見張り役から「すべてのページで変更前と完全一致」という結果が返ってきました。外から見えるサイトの景色は昨日までと何ひとつ変わっていないのに、床下や柱の組み方だけが静かに新しくなっている。そんな達成感は、個人サイトを長く育てているからこそ味わえる静かな喜びなのかもしれません。

5. おわりに:後半戦は来週の土曜日へ

前半戦となる基盤と裏方モジュールの整理を無事に終えて、ひとまずほっと胸を撫で下ろしました。少し技術寄りのお掃除ではありましたが、こうして足元を整えておくと、これから先で新しい企画や季節の演出を思いついたときにも、迷わず気持ちよく手を動かせるようになります。

まだこの先には、社務日誌のエンジンや各ページの細かな整理など、後半戦の作業が残っています。続きは来週の土曜日(11月21日)に、また少しずつ進めていく予定です。後半戦のお掃除が無事に終わりましたら、そのときもまた、制作の舞台裏として綴ってみたいと思います。