🍱 冷凍弁当 在庫管理
冷凍弁当（ベルーナなど）の在庫を、配送予定と食事ルールから自動で計算するアプリです。
GitHub Pages で公開できる静的サイトで、サーバーもデータベースも不要。GitHub の無料プランだけで使えます。
できること
| 機能 | 内容 |
|---|
| 在庫の自動計算 | 基準の在庫 ＋ 配送 − 食事 で、いまの在庫と今後の推移を計算 |
| 配送の登録 | 到着日はランダムでOK。個数は既定 10個（設定で変更可）、1件ずつ個数も変更可 |
| 食事ルール | 火曜17:00・木曜17:00・土曜12:00 に1食／8月の水曜・第5水曜・水曜の祝日 12:00 に1食 |
| 食べた数の修正 | 予定ごとに ＋/− で修正（0＝食べなかった、2以上＝多く食べた）。メモも残せる |
| 臨時の記録 | 予定外に食べた分、廃棄などの在庫補正、実数での数え直し（棚卸し） |
| カレンダー | 月ごとに 🍱食事・📦配送・その日の終わりの在庫を一覧。日付を押すとその日を編集 |
| 在庫切れ予測 | 「このままだと ○月○日に在庫切れ」を表示。残りが少なくなると色が変わる |
| 祝日の判定 | アプリ内で計算（振替休日・国民の休日を含む）。外部サービス不要 |
食事ルールの詳細
- 毎週 火曜 17:00／木曜 17:00／土曜 12:00 に 1食
- 8月の水曜／第5水曜／水曜が祝日 の日は 12:00 に 1食
- 水曜の条件が重なっても（例：8月の第5水曜）その日は 1食として数えます
- 条件はすべて設定画面でオン・オフできます
使いはじめ
- アプリを開き、ホームの 「在庫の個数を入力する」 で、いま冷凍庫にある個数を登録します。
- 配送タブで、到着日と個数（既定10個）を登録します。
- あとは、食べた数が予定と違ったときにホームやカレンダーで ＋/− を押して直すだけです。
食べた数が予定どおりなら、操作は不要です（自動で減ります）。
データの保存方法（3通り）
1. この端末に自動保存（既定・設定不要）
変更するたびにブラウザの localStorage へ自動保存されます。同じ端末の同じブラウザで開けば、そのまま続きを使えます。
2. バックアップファイル（機種変更・別端末へ移すとき）
設定タブ →「バックアップを書き出す」で JSON ファイルを保存。新しい端末では「バックアップを読み込む」で復元します。
3. GitHub同期（複数の端末で同じ在庫を見たいとき・任意）
データを、このリポジトリの data/inventory.json にコミットして共有します。
- 読み込みはトークン不要です。公開ページなので、別の端末でアプリを開くと自動で最新データを読み込みます。
- 保存（コミット）にはアクセストークンが必要です。
トークンの作り方:
- GitHub → Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token
- Repository access: このリポジトリだけを選択
- Permissions → Repository permissions → Contents: Read and write （これ以外は不要）
- 生成されたトークンをコピーし、アプリの設定タブ「アクセストークン」に貼り付け
トークンはお使いの端末のブラウザ（localStorage）にのみ保存され、公開されるページやバックアップJSONには含まれません。
共用のパソコンでは「GitHubに保存」を使わず、バックアップファイルでの持ち運びをおすすめします。
「変更を自動でGitHubに保存する」をオンにすると、操作の数秒後にまとめてコミットされます。
GitHub Pages での公開手順
- このブランチの内容を
main ブランチに取り込みます（プルリクエストをマージ、など）。
- GitHub のリポジトリ → Settings → Pages を開きます。
- Source を
Deploy from a branch、Branch を main / / (root) にして Save。
- 1〜2分ほどで公開URLが表示されます。スマホでそのURLを開き、ホーム画面に追加するとアプリのように使えます。
追加の設定やビルドは不要です（.nojekyll を置いてあるので、そのまま配信されます）。
ファイル構成
index.html 画面の構造
css/style.css スタイル（スマホ優先・ダークモード対応）
js/util.js 日付・DOMの共通処理
js/holidays.js 日本の祝日計算（振替休日・国民の休日を含む）
js/engine.js 食事予定の生成と在庫計算
js/store.js 保存（localStorage／JSON／GitHub同期）
js/app.js 画面の組み立てと操作
data/inventory.json GitHub同期で使うデータファイル
manifest.webmanifest ホーム画面に追加するための設定
動作環境
スマートフォン・パソコンの最近のブラウザ（Safari / Chrome / Edge / Firefox）。
外部のライブラリやサービスは使っていないため、オフラインでも一度開いたページはそのまま操作できます。
