30秒で分かる要点
foodtruck-mapとは?
Foodtruck Mapは、Bladeを中心に設計・実装したプロジェクトです。 主にBladeを使用し、公開コミットから機能追加と改善を積み重ねた過程を確認できます。
01 / 概要
プロジェクトの概要と目的
foodtruck map(foodtruck map.jp) キッチンカーが出店する場所を、住所と出典つきでまとめた地図。 本番URL: https://foodtruck map.jp 配信: Xserver( /home/xs501620/foodtruck map.jp/ ) Laravel。 public html は公開ディレクトリ、 app/ にアプリ本体 デプロイの癖(先に読むこと) 通常のデプロイ( deploy.yml )は public/ と resources/ しか送りません。 app/ routes/ database/ はサーバーに届きません。 このため、ビューから新しいルートやモデルを参照すると、本番だけ500になります (実際にトップとトラック一覧を落としたことがあります)。ビューが新しい ルートに触れるときは Route::has で存在を確認してから使ってください。 app/ routes/ database/ を送って migrate と seed まで流すのは import data.yml (手動実行) です。出店場所のデータを更新したら、 これを実行しないと本番に反映されません。 掲載しているデータ 自治体・公園管理者が公式に公表している出店場所だけを載せています。 推測で埋めることはしません。日々の出店予定は自治体が毎月更新するため 持たず、出典先の公式ページへ案内します。 合計115か所・51市区町村・12都道府県(東京77/千葉8/大阪6/神奈川6/埼玉4/ 栃木3/福岡3/秋田3/京都2/岐阜1/愛知1/茨城1)。 いちばん大きい出典は、公益財団法人 東京都公園協会の募集要項(都立公園46か所)です。 出店場所には4つの型があります。 公園 : 自治体が公園のにぎわいづくりのために誘致しているもの 庁舎 : 市役所・区役所・県庁の広場に平日の昼に出るもの(公園より続きやすい) 公園管理者の施設 : 動物園など、指定管理者が誘致しているもの 道の駅 : 屋外テラスや駐車場に出るもの データの作り直し scripts/f
本記事は公開されている構成と main ブランチのコミットを一次情報として整理しています。
02 / 使用技術
使用技術と役割
主要な実装言語として、プロダクトの中心機能を構成します。
03 / 設計
構成から読み解く設計
主な項目は です。
- 単一アプリケーション構成
- 機能単位の責務分割
04 / 変更履歴
コミットから見る実装の変遷
以下は既定ブランチの直近の変更です。リンク先で原文と一次情報を確認できます。
- app/ と routes/ もデプロイするca26d54をGitHubで確認 ↗
- トップページに、自治体が公表している出店場所115か所を出す55038fbをGitHubで確認 ↗
- actions/checkout と setup-node を v5 に上げる29c2df9をGitHubで確認 ↗
- 開発内容を統合89e7ba7をGitHubで確認 ↗
- 出店場所を115か所にする(12都道府県)4b6c46bをGitHubで確認 ↗
- 出店場所を112か所にする(11都道府県)af92481をGitHubで確認 ↗
- 市役所・区役所での出店6か所を足す(105か所)3c40477をGitHubで確認 ↗
- 出店場所を77か所から99か所に増やす22b7adaをGitHubで確認 ↗
- 出店場所を5か所足し、READMEを実態に合わせるabe7a9eをGitHubで確認 ↗
- 出店場所を23か所から72か所に増やすd1ee017をGitHubで確認 ↗
- LINE設定を本番に反映する仕組みを用意する3900169をGitHubで確認 ↗
- LINE連携が未設定のうちは、押せない表示にする4f3817eをGitHubで確認 ↗
05 / 学び
このプロジェクトから得られる学び
- 変更を小さく記録する
コミット単位で目的を分けると、実装の意図を追跡しやすくなります。
- 構成と技術選定を結び付ける
Bladeの採用理由と各ディレクトリの責務を説明できることが保守性につながります。
- READMEと実装を同時に育てる
説明とコードを近い状態に保つことが、再利用と振り返りを助けます。
06 / よくある質問
よくある質問
foodtruck-mapは何を作るプロジェクトですか?
Foodtruck Mapは、Bladeを中心に設計・実装したプロジェクトです。
foodtruck-mapの主要技術は何ですか?
Bladeを中心に構成されています。
この記事の情報源は何ですか?
公開README、リポジトリ構成、既定ブランチのGitHubコミット履歴です。
コメント
この記事へのコメント
お名前だけで投稿できます。アカウント登録やログインは不要です。 いただいたコメントは確認のうえ公開します。