From a661eedbd30206e940ed8fb6a19f139311adbdfb Mon Sep 17 00:00:00 2001
From: yyamashita <8nmdh5w22f@privaterelay.appleid.com>
Date: Sun, 1 Nov 2026 08:59:15 +0900
Subject: 西荻窪周辺スタジオの空き枠一覧ページを追加
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 README.md | 27 +++++++++++++++++++++++++++
 1 file changed, 27 insertions(+)
 create mode 100644 README.md

(limited to 'README.md')

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1c041e2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,27 @@
+# studio-slots
+
+西荻窪周辺の音楽スタジオの空き枠を、日付ごとに一覧で見るためのローカルWebページ。
+
+```sh
+python3 server.py        # → http://localhost:8000
+```
+
+依存ライブラリなし（Python 3.9 以上）。
+
+## 構成
+
+- `studios.json` … スタジオの一覧（名前、部屋、営業時間、予約ページ、電話番号、使う provider）
+- `providers/` … 空き枠の取得元。`fetch(studio, date)` が `[{"room", "hour", "status"}]` を返す
+  - `sample` … 画面確認用のダミーデータ（今はすべてこれ）
+  - `manual` … `manual_slots.json` に手で書いた予約済み枠を読む
+- `server.py` … `/api/slots?date=YYYY-MM-DD` と `static/` を配信
+- `static/index.html` … 一覧画面
+
+## 実データに切り替えるには
+
+1. `studios.json` の部屋名と営業時間を実際のものに直す（今はすべて仮の値）
+2. `providers/` に取得用のモジュールを足して `providers/__init__.py` の `PROVIDERS` に登録する
+3. 該当スタジオの `"provider"` をそのモジュール名に変える
+
+リンキィディンクは Reserve Mart（reserve1.jp）で予約を受けていて、空き枠を見るには会員ログインが必要。
+ID とパスワードは `.env` などに置き、リポジトリには入れないこと。
-- 
cgit v1.3