📝 変更履歴

Welfare TIME の機能と変更点を、バージョンごとにまとめています。

バージョン番号は セマンティックバージョニング に従います。

• メジャー：APIの形式を変えるなど、利用者の対応が必要な変更を含むときに上げます。
• マイナー：機能を追加したときに上げます。
• パッチ：不具合を修正したときに上げます。

1.0.0 になるまでは開発中の扱いとし、APIの形式を変えるような大きな変更でもマイナーを上げます。

毎朝の自動更新によるデータのコミットは、バージョンの対象に含めません。

v0.3.0（2026-09-27）

変更点

• キッチンカーの定期出店（毎週決まった曜日の出店）を取り込むようにしました。後期から取得元のページに定期出店の欄が加わり、これまでは読み飛ばしていました。
• フッタに、バージョン番号とコードの最終更新日時を表示するようにしました。
• ヘルプに、このページ（変更履歴）を追加しました。フッタのバージョン番号からも開けます。
• 開発用のタスクの実行を、make から just に移行しました。

この時点での機能

サイト

• 京都産業大学の食堂、コンビニ、ショップ、ATM、キッチンカーの営業情報をカードで一覧できます。
• 現在時刻から「営業中」「準備中」「営業終了」を判定して表示します。
• 前日・翌日のボタンやカレンダーで日付を切り替えられ、「今日」ボタンで当日に戻れます。
• 表示する施設をカテゴリや営業中かどうかで絞り込んだり、並び替えたりできます。
• キャンパスマップと施設の一覧を並べて表示し、施設の場所を地図上で確認できます。
• 各施設の公式ページや、情報の取得元へのリンクを表示します。
• ライトモードとダークモードを切り替えられます。
• スマートフォンのホーム画面に追加して、アプリのように使えます。
• フッタに、バージョン番号とコードの最終更新日時を表示します。バージョン番号をクリックすると、変更履歴のページを開けます。

データの収集

• 大学サイトが公開する食堂のPDFから、営業日と営業時間を抽出します。
• SHOP STOP のページから、キッチンカーの単日出店と定期出店の予定を取得します。
• 毎朝7時頃に GitHub Actions でデータを更新し、サイトとAPIを公開し直します。
• キッチンカーの出店記録を data/kitchen_cars_past.json に蓄積します。取得元から消えた過去の出店も残ります。
• マスターに登録されていない店舗は、日々の更新を止めずにまとめて警告します。

API

静的な JSON API を公開しています。詳細は APIリファレンス にあります。

• /api/schedule/today、tomorrow、yesterday：前日・当日・翌日の営業情報を返します。
• /api/schedule/YYYY-MM-DD：指定した日の営業情報を返します。
• /api/schedule/week、/api/schedule/weeks/{n}：週単位の営業情報を返します。
• /api/shops、/api/shops/{shop-id}：店舗の情報と営業日時の一覧を返します。
• /api/status：データ全体の更新状況と範囲を返します。

v0.2.0（2026-08-04）

APIの形式を変更しました。APIを利用している場合は対応が必要です。

変更点

• 日付ごとのAPIで cafeterias と kitchen_cars に分かれていた配列を、facilities の1つにまとめました。
• キッチンカーの店舗IDを、店名から SHOP STOP の店舗IDに変えました。店名が変わっても同じ店舗として扱えます。
• APIが返す取得元のURL（sources[].url）を絶対URLにしました。相対URLのままでは、解決すると存在しないURLになっていました。
• サイトの名前を「Welfare TIME」に統一し、ベースURLやアイコンのパスの誤りを直しました。
• マスターに登録されていない店舗を、日々の更新を止めずにまとめて警告するようにしました。
• スクレイパーとAPI生成の回帰テストを追加し、PRと main への push でテストを実行するようにしました。

v0.1.0（2026-07-31）

最初の公開版です。

機能

• 大学サイトの食堂のPDFと SHOP STOP のキッチンカーの出店情報を毎朝取得し、サイトとAPIで公開します。
• 食堂、コンビニ、ショップ、ATM、キッチンカーの営業情報をカードで一覧できます。
• 日付の切り替え、カレンダー、再読み込みのボタンを備えています。
• キャンパスマップと施設の一覧を連動して表示します。
• ダークモードと、スマートフォンのホーム画面への追加に対応しています。
• キッチンカーの過去の出店記録を蓄積します。取得元から過去の情報が消えても、その日に何が出店していたかが残ります。