add docs

README.md

@@ -0,0 +1,28 @@
+# TestArena Backend
+
+TestArena is an automated build and test execution system for ESP32 projects. It provides a complete workflow for cloning repositories, building firmware, and running tests in a QEMU environment, all managed through a modern web dashboard.
+
+## 🚀 Quick Start
+
+1.  **Deploy**: Run `sudo ./deploy.sh` on your Ubuntu server.
+2.  **Access**: Open `http://<server-ip>:8080/` in your browser.
+3.  **Monitor**: Use the dashboard to track test queues and view real-time logs.
+
+## 📚 Documentation
+
+For detailed information, please refer to the documentation in the `doc/` folder:
+
+*   **[Architecture & Design](doc/architecture.md)**: How the system is built.
+*   **[Usage Guide](doc/usage.md)**: How to use and manage the system.
+*   **[API Reference](doc/api_reference.md)**: Integration details.
+*   **[Workflows](doc/flow_diagrams.md)**: Visual flowcharts of key processes.
+
+## 🛠️ Technology Stack
+
+*   **Backend**: FastAPI, SQLAlchemy, SQLite
+*   **Worker**: Python Subprocess, Bash
+*   **Frontend**: Vanilla HTML/JS (Glassmorphism UI)
+*   **Infrastructure**: Nginx, Systemd, ESP-IDF, QEMU
+
+---
+© 2025 TestArena Team