30秒で分かる要点
furusato-hikakuとは？
ふるさと納税比較 楽天市場に掲載されている実在のふるさと納税返礼品を、カテゴリ・都道府県・寄付額・レビューで比較するLaravelアプリです 主にBladeを使用し、公開コミットから機能追加と改善を積み重ねた過程を確認できます。
01 / 概要
プロジェクトの概要と目的
ふるさと納税比較 楽天市場に掲載されている実在のふるさと納税返礼品を、カテゴリ・都道府県・寄付額・レビューで比較するLaravelアプリです。 主な機能 楽天市場商品検索APIから最大1,500件をSQLiteへ同期 キーワード、カテゴリ、都道府県、寄付額による複合検索 人気、評価、寄付額、新着順での並べ替え 返礼品詳細、関連返礼品、利用者口コミ キーワードのLINEウォッチ通知 商品詳細URLを含む動的サイトマップ GitHub Actionsによる毎日3:20（日本時間）の自動同期 セットアップ .env に RAKUTEN APP ID 、 RAKUTEN ACCESS KEY 、必要に応じて RAKUTEN AFFILIATE ID を設定します。 楽天市場商品検索APIは1ページ30件・最大100ページです。通常はサーバー負荷とAPI利用制限を考慮して50ページを同期します。 品質確認 商品情報は楽天ウェブサービスから取得しています。寄付額・在庫・配送条件は申込前に掲載元の商品ページで確認してください。
本記事は公開されている構成と main ブランチのコミットを一次情報として整理しています。
02 / 使用技術
使用技術と役割
主要な実装言語として、プロダクトの中心機能を構成します。
03 / 設計
構成から読み解く設計
主な項目は です。
- 単一アプリケーション構成
- 機能単位の責務分割
04 / 変更履歴
コミットから見る実装の変遷
以下は既定ブランチの直近の変更です。リンク先で原文と一次情報を確認できます。
- 楽天カタログ同期のSSHを3回まで試すfe71474をGitHubで確認 ↗
- 診断用の sync-status.txt を外す4017089をGitHubで確認 ↗
- 楽天の認証情報を登録したので、デプロイを走らせて同期するe7b0b03をGitHubで確認 ↗
- 同期の結果を public/sync-status.txt に書き出す097dc94をGitHubで確認 ↗
- 返礼品の判定に店名も使う（テストが落ちていたのを直す）a8eb260をGitHubで確認 ↗
- 同期が動かない原因を潰す（SSHの接続回数と時間切れ）9b2279eをGitHubで確認 ↗
- 楽天APIの同期が本番で失敗する原因を潰し、ログで分かるようにする0c0b6e7をGitHubで確認 ↗
- 返礼品でない商品を取り込んでいたのを直し、カテゴリ全体に行き渡らせる1e8f169をGitHubで確認 ↗
- actions/checkout と setup-node を v5 に上げるe7fd753をGitHubで確認 ↗
- 中身が0件の検索ページを、検索結果に出さないようにする4beb5ddをGitHubで確認 ↗
- LINE連携が未設定のうちは、押せない表示にする4a2dcebをGitHubで確認 ↗
- 住民側のふるさと納税（控除額）も自治体ページに載せる89b29e1をGitHubで確認 ↗
05 / 学び
このプロジェクトから得られる学び
- 変更を小さく記録する
コミット単位で目的を分けると、実装の意図を追跡しやすくなります。
- 構成と技術選定を結び付ける
Bladeの採用理由と各ディレクトリの責務を説明できることが保守性につながります。
- READMEと実装を同時に育てる
説明とコードを近い状態に保つことが、再利用と振り返りを助けます。
06 / よくある質問
よくある質問
furusato-hikakuは何を作るプロジェクトですか？
ふるさと納税比較 楽天市場に掲載されている実在のふるさと納税返礼品を、カテゴリ・都道府県・寄付額・レビューで比較するLaravelアプリです
furusato-hikakuの主要技術は何ですか？
Bladeを中心に構成されています。
この記事の情報源は何ですか？
公開README、リポジトリ構成、既定ブランチのGitHubコミット履歴です。
コメント
この記事へのコメント
お名前だけで投稿できます。アカウント登録やログインは不要です。 いただいたコメントは確認のうえ公開します。