./README.md

# kaisetsu-hoso

動画から字幕・解説ナレーションを自動生成するツール。Quintia 社内用。

## このリポジトリの構成

```
kaisetsu-hoso/
├── kaisetsu-app/          アプリ本体（Next.js 16）
│   └── README.md          ← 開発するならまずこれを読む
├── scripts/
│   └── setup-dotenv-key.sh  1Password から復号キーを取得して shell rc に書く（初回のみ）
├── .githooks/
│   └── pre-commit         平文シークレットのコミットを防ぐ
├── CLAUDE.md              Claude Code 用の設計メモ（将来の自分 & AI 用）
└── prompt.txt             Claude Code への指示のメモ書き
```

## はじめかた

営業・開発どちらでも共通の手順は `kaisetsu-app/README.md` を参照。要点だけ：

```bash
brew install node ffmpeg
brew install --cask 1password-cli
op signin                              # quintia.1password.com
bash scripts/setup-dotenv-key.sh       # 復号キーを ~/.zshrc に注入 + pre-commit 有効化
source ~/.zshrc
cd kaisetsu-app && npm ci && npm run dev
```

ブラウザで `http://localhost:3000` を開く。ローカル開発には GCP も Python も不要。

## 触る前に読むべき2つのドキュメント

- **`kaisetsu-app/README.md`** — セットアップ、トラブルシューティング、Claude Code への頼み方
- **`CLAUDE.md`** — 3つの切替可能バックエンド（storage / whisper / Gemini）、ジョブ実行の2経路、など設計判断の背景