# 環境構築手順書 (Setup Guide)

このドキュメントでは、「タスク管理システム」のソースコードをローカル環境で動作させるための手順を解説します。

## 1. 前提条件 (Prerequisites)
以下のソフトウェアがインストールされていることを確認してください。
- **XAMPP**: PHP 8.2以上, MariaDB (MySQL) が動作すること。
- **Node.js**: v18以上 (npmコマンドが使えること)
- **Composer**: PHPの依存管理ツール

## 2. セットアップ手順 (Setup Steps)

### 手順1: ファイルの展開
ダウンロードした `zbf-tasks-management-main.zip` を、XAMPPのプロジェクトフォルダ（例: `C:\xampp\htdocs`）に展開してください。

### 手順2: データベースの準備
1.  **XAMPP Control Panel** を開き、Apache と MySQL を Start します。
2.  ブラウザで [http://localhost/phpmyadmin](http://localhost/phpmyadmin) にアクセスします。
3.  「データベース」タブをクリックし、以下の名前で新規データベースを作成します。
    - データベース名: `task_management`
    - 照合順序: `utf8mb4_general_ci`
4.  作成したデータベースを選択し、「インポート」タブをクリックします。
5.  配布されている `task_management.sql` を選択し、インポートを実行します。

### 手順3: アプリケーションの設定
ターミナル（PowerShellやコマンドプロンプト）を開き、アプリケーションのディレクトリに移動します。

```bash
cd C:\xampp\htdocs\zbf-tasks-management-main\zbf-tasks-management-main\02_実装\02_アプリ\task_management_app
```

**以降のコマンドはすべてこのディレクトリ内で実行してください。**

1.  **環境設定ファイルの作成**
    `.env.example` をコピーして `.env` を作成します。
    ```bash
    cp .env.example .env
    ```
    ※ Windowsのコマンドプロンプトの場合は `copy .env.example .env`

2.  **依存ライブラリのインストール**
    ```bash
    composer install
    npm install
    ```

3.  **アプリケーションキーの生成**
    ```bash
    php artisan key:generate
    ```

4.  **データベース接続設定**
    テキストエディタで `.env` ファイルを開き、以下の部分を修正・確認します。
    ```ini
    DB_CONNECTION=mysql
    DB_HOST=127.0.0.1
    DB_PORT=3306
    DB_DATABASE=task_management
    DB_USERNAME=root
    DB_PASSWORD=
    ```
    ※ XAMPPのデフォルト設定であれば、PASSWORDは空欄でOKです。設定している場合は入力してください。

### 手順4: アプリケーションの起動
1.  **フロントエンドのビルド**
    ```bash
    npm run build
    ```
    （開発中は `npm run dev` でも可）

2.  **サーバーの起動**
    ```bash
    php artisan serve
    ```

3.  **ブラウザで確認**
    表示されたURL（例: [http://127.0.0.1:8000](http://127.0.0.1:8000)）にアクセスしてください。

## トラブルシューティング
- **"Vite manifest not found" エラー**: `npm run build` を実行してください。
- **"Table not found" エラー**: データベースのインポートが正しく行われているか確認してください。