# 困ったときは

Mail Studio は **Claude Code に聞けば解決できる** ように設計されています。まずはそこから試してください。

---

## 1. まず Claude Code に聞く（最短ルート）

このフォルダには Claude Code 用の指示書（`CLAUDE.md`）が同梱されています。フォルダ内で `claude` を起動して質問すると、**あなたの環境の状態を実際に確認したうえで**答えてくれます。

```bash
cd mail-studio      # 解凍したフォルダ
claude
```

そのまま話しかけてください。

| 状況 | 聞き方の例 |
|---|---|
| セットアップを始めたい | 「セットアップガイド.md に従って、最初から手伝ってください」 |
| どこまで進んだか分からない | 「今どこまでセットアップできているか診断してください」 |
| エラーが出た | 「デプロイでこのエラーが出ました（エラー文を貼る）。直してください」 |
| メールが届かない | 「テスト送信したのにメールが届きません。原因を切り分けてください」 |
| 使い方が分からない | 「ステップメールを3通作りたいです。手順を教えてください」 |
| 機能を足したい | 「登録フォームに『会社名』の入力欄を追加してください」 |

Claude Code は無料トライアルがあります → https://claude.com/claude-code

---

## 2. 自分で調べる

| 知りたいこと | 見るファイル |
|---|---|
| セットアップの全手順 | `セットアップガイド.md` |
| よくあるトラブルと対処 | `セットアップガイド.md` の末尾 FAQ |
| 管理画面の使い方 | デプロイ後 `https://<あなたのWorker>/manual/mail-studio/` |
| システム概要 | `README.md` |
| 詳しい仕様 | `docs/SRS.md`（要件）`docs/SDD.md`（設計） |
| 安全設計の方針 | `CONSTRAINTS.md` / `SECURITY.md` |

---

## 3. つまずきやすい上位5つ

**① `wrangler` でエラーが出る**
→ ほぼ認証切れか設定書き換え漏れです。

```bash
npx wrangler whoami                  # ログイン状態を確認
npx wrangler login                   # 切れていたらログインし直し
grep database_id wrangler.jsonc      # REPLACE_WITH_... のままなら書き換えが必要
```

**② メールが1通も届かない**
→ 上から順に確認してください。

1. `wrangler.jsonc` の `DRY_RUN` が `"true"` のまま（＝実送信されない仕様です）
2. 配信が「承認済み」になっていない
3. Resend でドメインが **Verified** になっていない（DNS 反映に最大24時間）
4. Resend のダッシュボード → Logs にエラーが出ていないか
5. 迷惑メールフォルダ

**③ 予約した配信が動かない**
→ Cron は毎分動きますが、管理画面の「▶ スケジューラ実行」で即時実行して確認できます。

**④ 管理画面のパスワードを忘れた**
→ 再設定できます。

```bash
npx wrangler secret put ADMIN_PASSWORD
npm run deploy
```

**⑤ ローカルで動かない（`npm run dev`）**
→ ローカル用 DB の初期化を忘れていることが多いです。

```bash
npm run db:init      # ローカルD1にスキーマ適用
npm run dev
```

---

## 4. 動作確認のしかた

改造したあとは、必ずこの2つを通してからデプロイしてください。壊れていれば必ずここで止まります。

```bash
npm test          # 99件のテスト（Cloudflare 不要・数秒で終わります）
npm run typecheck # 型チェック
```

---

## 5. 配布元への問い合わせ

上記でも解決しない場合は配布元にご連絡ください。以下があるとスムーズです。

- Mail Studio のバージョン（`package.json` の `version`）
- OS（Mac / Windows）と Node.js のバージョン（`node -v`）
- 実行したコマンド
- エラーメッセージ全文（**パスワード・API キー・メールアドレスは伏せてください**）

セキュリティ上の問題は `SECURITY.md` を参照のうえ、公開の場に書かずに直接ご連絡ください。
