# MiTERU サイト運用 — 仕組みファイル一式

このZIPは、MiTERUサイトの「台帳駆動運用」を動かすための裏側ファイル一式です。
**目的：このファイル群をサイトのリポジトリと同じ場所に置き、AI（Claude Code / Codex等）にこのREADMEを読ませれば、構築元と同じ運用が始められる。**

## 前提

- 対象リポジトリ: miteru-site（サイトHTML一式。管制室 /console/ の「HTML一式のZIP」が実体）
- 初回セッティング（ファイル配置・パス調整・動作確認）は構築元（トーモ）が行う。以降の日常運用をこのファイル群とAIで回す
- 読者レベル: エンジニアでなくてよいが、AIに日本語で指示ができること

## 中身と役割

| ファイル | 役割 |
|---|---|
| miteru-news-ledger.json | お知らせ台帳（**唯一の正本**・全45件） |
| miteru_sync.py | 同期スクリプト。台帳からサイト各面（news.html・トップ最新3件・miteru.md・確認カード）を自動生成 |
| miteru_sync_verify.py | 検証スクリプト。生成の冪等性・マーカー外不変・既存ID保持をチェック |
| miteru-md-header.md | AIO用 miteru.md の冒頭部分の正本 |
| deploy.sh | デプロイ台本。公開対象だけを集めて Cloudflare Pages へ（管制室ZIPの再生成込み） |
| CLAUDE.md | AI向け運用ルール（Claude Code用の入口） |
| AGENTS.md | 同上（Codex用の入口。内容はCLAUDE.mdと同じルールを指す） |

## セッティング時に調整が必要な箇所（構築元が実施）

- `miteru_sync.py` 冒頭の `BASE`（台帳ファイルの置き場所）と `SITE`（サイトリポジトリのパス、41行目付近 `SITE = Path("/Users/pichikyo/dev/miteru-site")`）を、引き渡し先の環境に合わせて書き換える
- `deploy.sh` 内の台帳・スクリプト参照パス（`$HOME/inhouse-bot/` を参照している箇所）も同様に調整する
- Cloudflareアカウント・Pagesプロジェクトの認証再セットアップ（下記の手順で実施）

### 認証の再セットアップ手順

1. Cloudflareアカウントを作成する（無料でよい）。https://dash.cloudflare.com/sign-up
2. ターミナルでサイトのリポジトリに移動し、Cloudflareにログインする（ブラウザが開くので画面の指示に従って許可する）
   ```
   cd ~/dev/miteru-site
   npx wrangler login
   ```
3. Cloudflare Pagesのプロジェクトを新規作成する。ダッシュボード（Workers & Pages → Create → Pages）からでも、CLIからでもよい
4. `deploy.sh` 内のプロジェクト名（`--project-name=miteru-site` の部分）を、3で作った自分のプロジェクト名に書き換える
5. パスを自分の環境に合わせて調整する
   - `~/inhouse-bot/miteru_sync.py` 内の `SITE = Path("/Users/pichikyo/dev/miteru-site")` を、自分のサイトリポジトリの場所に書き換える
   - `deploy.sh` 内の `$HOME/inhouse-bot/` を参照している箇所を、台帳一式を置いた自分の場所に書き換える
6. 確認：`cd ~/dev/miteru-site && ./deploy.sh` を実行し、末尾に表示されるpages.devのURLをブラウザで開いてサイトが表示されればセットアップ完了

## 日常運用（AIへの頼み方）

1. AIに自然文で頼む：「◯◯に出演したので、お知らせに載せて」
2. AIが台帳に1件追加 → `python3 miteru_sync.py` → 管制室（/console/）で答え合わせ
3. OKなら `./deploy.sh` で本番反映

ルールの詳細（noの連番・カテゴリ4種・生成物の直接編集禁止など）は CLAUDE.md と管制室の「運用手引き」を参照。

## 困ったとき

サイトファイル（miteru-siteリポジトリ内）はGitで履歴管理されているため、どの時点にも戻せます。台帳・同期スクリプト（サイトのリポジトリの外にある正本。引き渡し後の環境ではGit管理されない）は、デプロイのたびに管制室へ保存されるバックアップZIP（`console/miteru-scheme-files.zip`）から復旧してください。詳しい手順は管制室の「困ったとき」を参照。判断に迷う場合は構築元（トーモ）へ。
