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

01 / 概要

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

golf search golf search は、全国47都道府県のゴルフ場を都道府県別に検索し、目的タグ、口コミ、前泊ホテル、天気予報までまとめて比較できる Laravel アプリケーションです。 主な機能 全国47都道府県からのゴルフ場検索 「早朝プレー」「ナイター」「温泉付き」などのタグ絞り込み 利用者口コミの投稿・閲覧 気象庁データによる都道府県別天気予報表示 楽天トラベル API を使った前泊ホテル提案 sitemap.xml と llms.txt による検索・参照最適化 開発手順 品質確認 全国対応について トップページに全国47都道府県を表示します。 検索結果、FAQ、サイトマップは都道府県ごとに生成されます。 楽天GORA の keyword 検索結果は住所先頭の都道府県名で再フィルタし、他県コースの混入を防いでいます。 必要な環境変数 RAKUTEN APP ID RAKUTEN ACCESS KEY RAKUTEN AFFILIATE ID APP URL

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

02 / 使用技術

使用技術と役割

03 / 設計

構成から読み解く設計

主な項目は です。

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

04 / 変更履歴

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

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

1. 2026/09/02
   前泊ホテルの取得失敗を1時間焼き付けないようにするf364243をGitHubで確認 ↗
2. 2026/09/02
   前泊ホテルを地区コードで引く（キーワードだけでは0件だった）d364cd1をGitHubで確認 ↗
3. 2026/09/01
   楽天市場APIのバージョンを 20260701 に直すdbc72d4をGitHubで確認 ↗
4. 2026/09/01
   楽天市場APIは別アプリの資格情報を使えるようにする86f00e0をGitHubで確認 ↗
5. 2026/09/01
   ゴルフ練習場（OSM 386件）と、楽天市場のゴルフ用品を都道府県ページに足す1bf6e66をGitHubで確認 ↗
6. 2026/09/01
   http を https へ301で寄せる597ad9aをGitHubで確認 ↗
7. 2026/09/01
   デプロイ先を Secret ではなく workflow に書く（伏せ字で原因が読めなくなるため）8cca772をGitHubで確認 ↗
8. 2026/09/01
   デプロイ先の設定を直したので、もう一度流す1377739をGitHubで確認 ↗
9. 2026/09/01
   都道府県の検索を areaCode に変える（keyword だと18県が0件になっていた）288b36cをGitHubで確認 ↗
10. 2026/08/30
    ゴルフ場の取得を、失敗が焼き付かない作りにする15e80e7をGitHubで確認 ↗
11. 2026/08/21
    actions/checkout と setup-node を v5 に上げる8b1d8beをGitHubで確認 ↗
12. 2026/08/19
    都道府県ページをパス型URLにし、公開前の不具合を直す674a48aをGitHubで確認 ↗

05 / 学び

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

• 変更を小さく記録する

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

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

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

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

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

06 / よくある質問

よくある質問