# クイックスタートガイド - Study Timer

このガイドでは、Study Timerアプリケーションをすぐに起動するための手順を説明します。

## 前提条件

- PHP 8.0 以上
- MySQL 8.0 以上
- ブラウザ（Chrome, Firefox, Safari等）

## 1分セットアップ

### ステップ 1: データベースを初期化

```bash
# MySQLにログイン
mysql -u root -p

# データベース作成スクリプトを実行
mysql> source /workspaces/haikus-for-codespaces/schema/init.sql;
```

### ステップ 2: PHPサーバーを起動

```bash
# プロジェクトディレクトリに移動
cd /workspaces/haikus-for-codespaces

# PHP Built-in サーバーを起動
php -S localhost:8000 router.php
```

### ステップ 3: ブラウザでアクセス

```
http://localhost:8000/public/login.html
```

## テストアカウント

自動的に作成できます。ログイン画面で「新規登録」をクリック：

- **名前**: テストユーザー
- **メール**: test@example.com
- **パスワード**: password123

## 主な機能

| ページ | 説明 | アクセス |
|-------|------|--------|
| ダッシュボード | 学習状況の概要 | `/public/index.html` |
| 学習記録 | タイマー機能 | ナビゲーション > 学習記録 |
| 統計 | 詳細分析 | ナビゲーション > 統計 |
| カレンダー | 月間ビュー | ナビゲーション > カレンダー |
| 目標設定 | 学習目標の設定 | ナビゲーション > 目標設定 |
| 設定 | アプリ設定 | ナビゲーション > 設定 |

## トラブルシューティング

### ポート8000が使用中

別のポートを使用：

```bash
php -S localhost:8001 router.php
```

その後 `http://localhost:8001/public/login.html` でアクセス

### MySQLに接続できない

1. MySQLサービスを起動：

```bash
# Linux/Mac
brew services start mysql

# Ubuntu
sudo systemctl start mysql

# Windows
net start MySQL80
```

2. `.env` ファイルの設定を確認

3. MySQLユーザーの権限を確認：

```bash
mysql -u root -p -e "SELECT USER();"
```

### データベースが見つからない

```bash
# MySQLで直接実行
CREATE DATABASE study_timer_db CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
USE study_timer_db;
source schema/init.sql;
```

## 次のステップ

1. **Gemini API キーの設定** (オプション)
   - 設定ページでAPIキーを追加してAI機能を有効化

2. **学習記録を追加**
   - 「学習記録」ページで学習時間を記録開始

3. **目標を設定**
   - 「目標設定」ページで平日/休日の学習目標を設定

4. **統計を確認**
   - 「統計」ページで学習パターンを分析

## サポート

問題が発生した場合は、以下を確認してください：

- ブラウザコンソール（F12 > Console）のエラー
- PHPサーバーのターミナル出力
- MySQLのエラーログ

## APIドキュメント

詳細なAPI仕様は [README.md](README.md) を参照してください。
