add docs

doc/usage.md

@@ -0,0 +1,80 @@
+# Usage Guide
+
+This guide provides instructions on how to deploy, configure, and use the TestArena system.
+
+## Deployment
+
+The system is designed to be deployed on an Ubuntu server. An automated deployment script is provided.
+
+### Prerequisites
+*   Ubuntu 22.04 or later.
+*   ESP-IDF installed at `/home/asf/esp/esp-idf`.
+*   QEMU (XTENSA) installed and available in the system path.
+
+### Installation Steps
+1.  Clone the repository to `/home/asf/testarena_backend`.
+2.  Navigate to the directory: `cd /home/asf/testarena_backend`.
+3.  Run the deployment script with sudo:
+    ```bash
+    sudo ./deploy.sh
+    ```
+    This script will:
+    *   Install system dependencies (`nginx`, `sqlite3`, `perl`, etc.).
+    *   Set up a Python virtual environment and install requirements.
+    *   Configure Nginx as a reverse proxy.
+    *   Set up and enable systemd services for the API and Worker.
+
+## Managing Services
+
+Use standard `systemctl` commands to manage the TestArena services:
+
+```bash
+# Restart services
+sudo systemctl restart testarena-app testarena-worker
+
+# Check status
+sudo systemctl status testarena-app testarena-worker
+
+# View logs
+sudo journalctl -u testarena-worker -f
+```
+
+## Using the Dashboard
+
+Access the dashboard at `http://<server-ip>:8080/`.
+
+### Features:
+*   **Queue Monitor**: View all test queues, their status, and environment.
+*   **Search**: Filter queues by Queue ID using the search box.
+*   **Sorting**: Click on table headers (Queue ID, Environment, Status) to sort the data.
+*   **Actions**:
+    *   **Abort**: Stop a running or waiting queue.
+    *   **Delete**: Permanently remove a queue's data from the database and filesystem.
+*   **Live Logs**: View real-time system logs in the sidebar.
+
+## Submitting a Test Queue
+
+You can submit a new test queue by sending a POST request to `/api/queue`.
+
+### Example Payload:
+```json
+{
+    "source": "feature/new-sensor",
+    "QUEUE_12345": [
+        "Production_Env",
+        {
+            "TASK_001": "path/to/scenario_1.xml",
+            "TASK_002": "path/to/scenario_2.xml"
+        }
+    ]
+}
+```
+
+## Viewing Results
+
+Test results are stored in `/home/asf/testarena/<queue_id>/`.
+*   `queue_log.txt`: The full execution log for the entire queue.
+*   `<task_id>/execution_report.html`: A detailed HTML report for a specific task.
+*   `<task_id>/<case_id>-logging.html`: Individual logs for each test case.
+
+You can also browse results via the web interface at `http://<server-ip>:8080/results/`.