Storage Locker Nearの設計・技術選定・コミット履歴を解説

01 / 概要

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

Storage Locker Near 駅周辺のコインロッカーを、地図・口コミ・空き状況で探せるLaravelアプリです。 主な機能 ロッカー投稿（駅名、場所、サイズ別料金、徒歩時間） 駅・現在地ベースの検索 S/M/L別の空き状況レポート投稿 ロッカー詳細ページでの口コミ投稿 LINEログイン連携によるお気に入り登録 お気に入りロッカーに「空きあり」報告が出た際のLINE通知 sitemap.xml / robots.txt / OGP / JSON LD対応 技術スタック Laravel 12 Blade + Bootstrap 5 SQLite（開発時デフォルト） Vite LINE Login / LINE Messaging API セットアップ SQLiteファイルを使う場合: 開発起動 テスト・ビルド 本番デプロイ（GitHub Actions） main への push で .github/workflows/deploy.yml .github/workflows/deploy.yml が実行されます。 事前に以下の Repository Secrets を設定してください。 APP KEY SSH HOST SSH USERNAME SSH PRIVATE KEY DEPLOY PATH LINE通知の設定 必要な環境変数: LINE LOGIN CHANNEL ID LINE LOGIN CHANNEL SECRET LINE LOGIN REDIRECT URI LINE MESSAGING CHANNEL ACCESS TOKEN LINE MESSAGING CHANNEL SECRET 詳細は LINE SETUP.md を参照してください。 定期通知コマンド 空きあり報告の通知は、以下のコマンドで実行します。 サーバーではcronで定期実行してください。

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

02 / 使用技術

使用技術と役割

03 / 設計

構成から読み解く設計

主な項目は です。

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

04 / 変更履歴

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

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

1. 2026/08/19
   デプロイが本番の .env を壊さないようにする3b8ab14をGitHubで確認 ↗
2. 2026/08/18
   LINE連携が未設定のうちは、押せない表示にする2fb3134をGitHubで確認 ↗
3. 2026/08/15
   支援・購入への導線を追加する2f45141をGitHubで確認 ↗
4. 2026/08/11
   実装内容を更新6155b2bをGitHubで確認 ↗
5. 2026/08/11
   feat: コインロッカーデータを全国規模に拡充（47都道府県・160件超、北海道〜沖縄）c454b36をGitHubで確認 ↗
6. 2026/08/11
   説明資料を更新57e4b6eをGitHubで確認 ↗
7. 2026/08/11
   feat: 全国主要駅コインロッカー50件追加（東京・新宿・渋谷・大阪・京都・名古屋・博多・仙台・札幌・空港等）・GitHub Actionsデプロイ設定追加120d691をGitHubで確認 ↗
8. 2026/08/05
   機能・コンテンツを追加a46bb04をGitHubで確認 ↗
9. 2026/08/04
   機能・コンテンツを追加b9b7146をGitHubで確認 ↗
10. 2026/07/30
    実装内容を更新b7604f8をGitHubで確認 ↗
11. 2026/07/15
    機能・コンテンツを追加d61f05eをGitHubで確認 ↗
12. 2026/07/14
    機能・コンテンツを追加8b39ab6をGitHubで確認 ↗

05 / 学び

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

• 変更を小さく記録する

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

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

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

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

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

06 / よくある質問

よくある質問