========================================================================
PC 環境構築手順 (PC Environment Setup)
========================================================================


1. 前提条件 (Prerequisites)
------------------------------------------------------------------------

    1-1. OS

    ・Windows 11 Home

    1-2. Python

    ・バージョン: 3.12.10
    ・インストール元: Microsoft Store 版
    ・確認コマンド:

        $ python --version

    1-3. pip

    ・Python に同梱されているものを使用する．


2. venv の作成 (Create Virtual Environment)
------------------------------------------------------------------------

    2-1. 作成

    プロジェクトルートで以下を実行する．

        $ cd c:\Users\rinto\source\RobotCar
        $ python -m venv .venv

    ・`.venv/` ディレクトリが作成される．
    ・`.venv/` は Git 管理外とする（`.gitignore` に追加）．

    2-2. 有効化

    ■ PowerShell の場合

        $ .venv\Scripts\Activate.ps1

    ■ コマンドプロンプトの場合

        $ .venv\Scripts\activate.bat

    ■ Git Bash の場合

        $ source .venv/Scripts/activate

    ・有効化するとプロンプトの先頭に `(.venv)` が表示される．

    2-3. pip のアップグレード

        $ python -m pip install --upgrade pip


3. ライブラリのインストール (Install Libraries)
------------------------------------------------------------------------

    3-1. 一括インストール

    `requirements_pc.txt` を使用して一括インストールする．

        $ pip install -r requirements_pc.txt

    3-2. インストールされるライブラリ

    ・PySide6 (6.10.2): GUI フレームワーク
    ・opencv-python (4.13.0.92): 画像処理
    ・pyzmq (27.1.0): ZMQ 通信
    ・numpy (2.4.3): 数値計算（OpenCV の依存ライブラリ）
    ・python-dotenv (1.2.2): .env ファイルからの環境変数読み込み

    3-3. インストール確認

        $ pip freeze

    上記コマンドで `requirements_pc.txt` に記載されたライブラリと
    バージョンが表示されることを確認する．


4. 動作確認 (Verification)
------------------------------------------------------------------------

    4-1. ライブラリの import 確認

    以下を Python で実行し，エラーが出ないことを確認する．

        $ python -c "import PySide6; import cv2; import zmq; import dotenv; print('OK')"