RoomRadar 📡
日本大学理工学部の空き教室リアルタイム検索サービス。
年度・学期・曜日・時限・校舎を選ぶだけで、時間割データをもとに授業が入っていない教室を表示します。
⚠️ 本サービスは、学生が「自主創造プロジェクト」の一環として開発・運営している試験運用中のサービスです。大学が公式に提供するサービスではありません。
リンク
構成
├── app.py # 検索アプリ本体（Flask・Render でホスティング）
├── index.html # ランディングページ（GitHub Pages）
├── dashboard.html # 運営チーム用アナリティクス画面（GitHub Pages）
├── schedule_final.db # 時間割データベース（複数年度・検索の元データ）
├── rr_logo.png # ロゴ（LP から参照）
├── requirements.txt
│
├── data/
│ ├── source/ # 時間割の原本 ※ source/README.md 参照
│ │ ├── 2025/ # 過去年度（サイト上で切り替えて見られる）
│ │ ├── 2026/ # いま使っている年度
│ │ └── 2027/ # 翌年度の置き場（公開されたらここへ）
│ ├── classes_2025.csv # 授業の生データ一覧（年度ごと。教員名・単位・対象学年も含む）
│ ├── classes_2026.csv
│ ├── instagram_*.json # Instagram インサイト集計（2026-08 で収集終了・ダッシュボード表示用に凍結）
│ └── ga4_* # GA4 の利用状況（2026-10 に週次の記録として再開。ga4-weekly.yml が毎週月曜に更新）
│
├── assets/
│ ├── instagram/ # Instagram 投稿用画像（弔事ストーリーの雛形）
│ │ └── auto/ # 投稿ワークフローが生成する告知ストーリー
│ ├── posters/ # 学内掲示用ポスター（PNG / PDF / PPTX）
│ │ └── handoff/ # 外部デザインツール用素材（ロゴ・QR）
│ └── instagram-qr.png # LP に表示する Instagram QR
│
├── scripts/
│ ├── post_to_instagram.py # フィード / ストーリーズ投稿（必須タグ自動付与）
│ ├── make_poster.py # 学内掲示ポスター生成（PNG/PDF/PPTX・variant切替）
│ ├── make_story_promo.py # 新規投稿の告知ストーリー画像生成
│ ├── make_condolence_story.py # 弔事ストーリー（文面を差し替えて使う雛形）
│ ├── build_schedule_db.py # 原本の時間割表(.xls) → schedule_final.db を再構築
│ ├── export_classes.py # 原本 → 授業の生データ一覧 CSV
│ ├── refresh_ig_token.py # Instagramトークンを60日延長して Secret を更新
│ ├── inspect_timetable.py # 原本ファイルの構造を確認する道具
│ └── ops_healthcheck.py # 運用ヘルスチェック（本番URL・Actions・トークン → Issue）
│
├── tests/ # 運用スクリプト・hook・アプリの単体テスト（CI で実行）
├── .claude/ # Claude Code 用の設定（必須表記を守る hook / permissions / 手順書 skills）
│
└── .github/workflows/
├── ci.yml # push / PR で構文チェックとテスト
├── ops-healthcheck.yml # 毎週月曜 運用ヘルスチェック（異常なら Issue、復旧で自動クローズ）
├── ig-token-refresh.yml # 毎月1日 Instagramトークンを60日延長して Secret を更新
├── instagram-post.yml # 手動トリガーで投稿（feed / story 選択・同時ストーリー可）
├── ga4-weekly.yml # 毎週月曜 GA4 の利用状況を data/ga4_weekly.md に記録
└── render-deploy.yml # 検索アプリを授業のない時間にだけ Render に反映（2時間おきに判定）
運用メモ
reports.db（「実は使われていた」報告）は実行時に自動生成される揮発データで、リポジトリには含めません。仮予約は 2026-10 に廃止しました。- Instagram 投稿キャプションには規定の共通ハッシュタグ
#日大生プロジェクト がスクリプトで自動付与されます。
- ポスターは
python scripts/make_poster.py --print-files で再生成できます（A4縦・約392dpi、PDF/PPTX同時出力）。
- Claude Code on the web では
.claude/hooks/session-start.sh がセッション開始時に依存パッケージを自動インストールします。
- テストは
python -m unittest discover -s tests -v（pip install -r requirements.txt -r requirements-dev.txt が必要）。push / PR ごとに CI が同じものを回します。
- 運用ヘルスチェックは毎週月曜 09:00 JST に動き、本番 URL の応答と必須表記・Actions の失敗・Instagram トークンの有効性を検査します。異常があると「【運用ヘルスチェック】異常を検知しました」という Issue が開き、復旧すると自動で閉じます。
- Instagram 投稿・ポスター生成・画面検証の手順書は
.claude/skills/ にあります（Claude Code から /instagram-post /make-poster /verify-ui）。
- 引き継ぎ・定期作業・障害対応は
docs/OPERATIONS.md（運営ハンドブック）にまとめています。
- 時間割の入れ替え（年1回）は
python scripts/build_schedule_db.py --report で差分を確認してから --replace。既定では本番 DB を上書きしません。
日本大学自主創造プロジェクト ／ #日大生プロジェクト
