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

01 / 概要

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

dart portal ダーツプロ総合アフィリエイトサイトの MVP バックエンド。 イベント情報の自動収集と、推しプロ × イベント × ギアのレコメンド API を提供します。 セットアップ イベント情報の更新 神戸六甲ボウルの来店イベントを取得し、 events.json に保存します。 API 起動 Swagger UI: http://127.0.0.1:8765/docs レコメンド API: POST /offers リクエスト例 設計書 全体設計・API・CMS・ロードマップは docs/DESIGN.md docs/DESIGN.md を参照してください。

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

02 / 使用技術

使用技術と役割

03 / 設計

構成から読み解く設計

主な項目は README.md、docs、events.json、main.py、requirements.txt、scrape_events.py です。

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

04 / 変更履歴

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

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

1. 2026/07/16
   プロジェクトの初期構成を作成ccdd6b8をGitHubで確認 ↗

05 / 学び

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

• 変更を小さく記録する

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

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

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

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

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

06 / よくある質問

よくある質問