Yozan Heishuの設計・技術選定・コミット履歴を解説

01 / 概要

プロジェクトの概要と目的

鷹山と平洲 上杉鷹山（1751 1822）と、その師・細井平洲（1728 1801）の総合サイト。 公開先は https://yozan heishu.jp このサイトの方針 この師弟については、出所のはっきりしない逸話や名言が数多く流通している。 だからこのサイトは、 出典をたどれるものだけを載せる という一点で他と分ける。 年号・出来事・言葉の原文は、東海市（愛知県／平洲の生地）と米沢市（山形県／鷹山の藩）の 公式ウェブサイトに記載されているものを典拠とする 各ページに出典リンクを置く 確認できない事柄は載せない。年表に空白の年があるのは、確認できていないため 座標は実在を確認できたものだけを持つ。推測で置かない。 地図に無い場所は「未登録」と明記し、住所で検索させる 言葉の解説では、意味の説明で終わらせず「いつ・誰に向けて語られたか」まで書く。 場面が分かると意味が変わることがあるため。「なせば成る」がその典型で、 若者への励ましではなく、改革をやり遂げた者が次代へ残した壁書の締めくくりだった。 構成 開発 地図データを取り直すとき（Overpass に負荷をかけるので、必要なときだけ）: 実装上の注意 同名の寺社に気をつける。 米沢市にも「観音寺」がある。平洲が学んだ東海市の観音寺と 取り違えかけた。 build places.mjs の判定は必ず地域とセットで行う。 江戸は機械抽出の対象から外している。 名前で絞ると「明治大学米沢嘉博記念図書館」 （漫画評論家の名を冠した図書館。米沢藩とは無関係）や加賀藩の屋敷跡まで拾ってしまう。 範囲が広すぎて名前だけでは判別できないため、江戸のゆかりの地は landmarks.js に出典つきで手で持っている。 重要な場所ほど地図に載っていない。 普門院、関根の郊迎跡、平洲が学んだ観音寺、 白子神社は、いずれも OpenStreetMap に未登録だった。機械抽出だけに頼ると核心が抜ける。 Overpass API は User Agent が無いと 406 を返す。名前だけの正規表現は重すぎて 504 になる。 典拠 東

本記事は公開されている構成と main ブランチのコミットを一次情報として整理しています。

02 / 使用技術

使用技術と役割

03 / 設計

構成から読み解く設計

主な項目は です。

• 単一アプリケーション構成
• 機能単位の責務分割

04 / 変更履歴

コミットから見る実装の変遷

以下は既定ブランチの直近の変更です。リンク先で原文と一次情報を確認できます。

1. 2026/08/16
   Search Console の所有権確認タグを入れる5c5c336をGitHubで確認 ↗
2. 2026/08/15
   長い引用に短い呼び名をつけ、題や導線で使う4a1bdb2をGitHubで確認 ↗
3. 2026/08/15
   上杉鷹山と細井平洲の総合サイトを立ち上げる46d67bdをGitHubで確認 ↗

05 / 学び

このプロジェクトから得られる学び

• 変更を小さく記録する

  コミット単位で目的を分けると、実装の意図を追跡しやすくなります。

• 構成と技術選定を結び付ける

  JavaScriptの採用理由と各ディレクトリの責務を説明できることが保守性につながります。

• READMEと実装を同時に育てる

  説明とコードを近い状態に保つことが、再利用と振り返りを助けます。

06 / よくある質問

よくある質問