﻿======================================================================
  サイトサーベイツール (SiteSurveyTool) 使い方ガイド
  バージョン: v1.2.0
  配布元: https://irohive.com/tools/
======================================================================


■ このツールについて
----------------------------------------------------------------------
Windows PC上でインストール不要で動作する、無線LAN環境の計測・可視化
ツールです。フロアマップ上にピンを設置して Wi-Fi品質（信号強度・
Ping・スループット・VoIP品質）を計測し、ヒートマップで電波の分布を
可視化します。

  主な用途:
    ・新オフィスのAP（アクセスポイント）配置検討
    ・既存環境の電波の弱点特定
    ・Wi-Fi品質の定期モニタリング・報告書作成


■ 動作環境（追加インストール不要・すべてWindows標準付属）
----------------------------------------------------------------------
  ・Windows 10 / 11（Home・Pro どちらも可）
  ・PowerShell 5.1 以上（Windowsに標準搭載）
  ・Edge / Chrome 等の標準ブラウザ
  ・Wi-Fi接続済みの無線LANアダプター

  ※ このツールは Windows 専用です（macOS / Linux 非対応）
  ※ Node.js・Python・追加アプリのインストールは一切不要です


======================================================================
■ 起動方法
======================================================================

1. ZIPを任意のフォルダに解凍します
   例: C:\Tools\SiteSurveyTool

2. 解凍したフォルダ内の「Start.bat」をダブルクリックします

3. PowerShellのウィンドウが起動します
   ─ 初回起動時に「このアプリがデバイスに変更を加えることを許可しますか？」
     と表示された場合は「はい」を選択してください
   ─ 「WindowsファイアウォールがPowerShellの機能の一部をブロックしています」
     と表示された場合は「アクセスを許可する」を選択してください

4. 自動的にブラウザが開き、ツールの画面が表示されます
   表示されない場合は、ブラウザで以下のURLを手動で開いてください:
     http://localhost:8080/


======================================================================
■ 使い方（基本手順）
======================================================================

【Step 1】プロジェクトを作成する
  ・画面上部の「＋ 新規プロジェクト」ボタンをクリック
  ・プロジェクト名（例: 本社2Fサーベイ）を入力して作成

【Step 2】フロアを追加する
  ・「＋ フロア追加」でフロアを作成します
  ・以下のいずれかでフロアマップを用意します:
      [方法A] 画像アップロード
              フロア画像（PNG / JPG）を「マップ画像をアップロード」から
              読み込みます。CAD図面や手書きのスキャン画像も使えます。
      [方法B] グリッドエディタ
              画像がない場合はグリッドエディタで間取りを手書き作成できます

【Step 3】計測ポイント（ピン）を設置する
  ・サイドバーの「📍 ピン設置モード」ボタンをONにします
  ・マップ上の計測したい場所をクリックします
  ・計測モードを選択して「計測実行」します:
      Ping        ... 遅延（RTT）・パケットロス率を計測
      スループット ... ダウンロード速度（Mbps）を計測
      VoIP品質    ... ジッター・MOS値を計測（音声通話品質の目安）
  ・ピンをクリックすると自動的に計測が開始されます

【Step 4】結果を確認する
  ・下部のダッシュボードでグラフ・数値サマリーを確認
  ・画面右上のセレクタでヒートマップを切り替えて電波分布を可視化:
      信号強度 ... 電波の強さ（dBm）の分布
      Ping遅延 ... 遅延が大きいエリアを特定
      ジッター ... VoIP品質が悪いエリアを特定

【Step 5】エクスポートする
  ・PNG エクスポート ... ヒートマップ画像をダウンロード
  ・CSV エクスポート ... 全ピンの計測データを Excel で開けるCSV出力
  ・PDF 印刷      ... ブラウザの印刷機能で報告書レイアウトで保存


======================================================================
■ その他のモード
======================================================================

画面上部のタブでモードを切り替えられます:

  🗺  フロアサーベイ
      フロアマップ上でピンを設置して計測・ヒートマップ表示（基本モード）

  ⚡  即時計測
      フロアマップなしで、今いる場所のWi-Fi品質をすぐに確認したい場合

  🚶  リアルタイム歩行テスト
      歩きながら自動的にWi-Fi品質を連続記録し、品質変化をリアルタイムで確認


======================================================================
■ 停止方法
======================================================================

「Stop.bat」をダブルクリックするとサーバーが停止します。
ブラウザのタブは手動で閉じてください。

※ Stop.bat を実行せずにPCをシャットダウンした場合も問題ありません。
  次回 Start.bat を実行すると自動的に起動します。


======================================================================
■ データの保存場所
======================================================================

計測データは以下のフォルダにのみ保存されます（外部への送信は一切なし）:

  SiteSurveyTool\data\projects\<プロジェクトID>\

  保存内容:
    project.json  ... プロジェクト設定（名前・フロア情報）
    pins.json     ... 各ピンの座標・計測結果の履歴
    map.png       ... アップロードしたフロアマップ画像

ツールを完全に削除する場合は、解凍したフォルダをそのまま削除してください。


======================================================================
■ トラブルシューティング
======================================================================

【ブラウザが自動で開かない場合】
  → ブラウザのアドレスバーに http://localhost:8080/ を入力してください

【「WindowsによってPCが保護されました」と表示される場合】
  → 「詳細情報」をクリック → 「実行」を選択してください

【「ブロックされました」「このファイルは信頼できません」と表示される場合】
  → Start.bat を右クリック → 「プロパティ」を開く
  → 下部の「セキュリティ: □ブロックの解除」にチェックを入れて「OK」
  → 同様に Stop.bat / server\Server.ps1 にも行ってから再度実行してください

【PowerShellウィンドウにエラーが表示される場合】
  → Start.bat を右クリック → 「管理者として実行」を試してください

【Wi-Fi情報が「未接続」と表示される場合】
  → Wi-Fiに接続していることを確認してください
  → 有線LAN(イーサネット)のみ接続中の場合、Wi-Fi情報は取得できません
  → Wi-Fiアダプターが無効になっていないか確認してください

【ポート8080で起動できないエラーが出る場合】
  → 別のアプリがポート8080を使用している可能性があります
  → 不要なアプリを終了してから再度 Start.bat を実行してください


======================================================================
■ ファイル構成
======================================================================

SiteSurveyTool\
  ├── README.txt      ← このファイル
  ├── Start.bat       ← 起動スクリプト（ダブルクリックで起動）
  ├── Stop.bat        ← 停止スクリプト（ダブルクリックで停止）
  ├── server\
  │   └── Server.ps1  ← バックエンドサーバー本体（PowerShell製）
  ├── data\
  │   └── projects\  ← 計測データの保存先（起動時に自動作成）
  └── ui\            ← ブラウザ画面のファイル群（変更不要）


======================================================================
  © IroHive.com  |  https://irohive.com/tools/
======================================================================
