add webui

webui/README.md

@@ -0,0 +1,65 @@
+# HPGL Plotter Web UI
+
+Flask web interface for uploading HPGL files, previewing and transforming them (flip, rotate, scale, center), and sending to the plotter. Intended to run on a Raspberry Pi connected to the plotter via USB.
+
+## Setup (Raspberry Pi)
+
+1. From the **project root** (mimaki/), install dependencies:
+
+   If you get **externally-managed-environment** (Python 3.11+ / PEP 668) and don’t want a venv, use:
+   ```bash
+   pip install --break-system-packages -r webui/requirements.txt
+   ```
+   Otherwise:
+   ```bash
+   pip install -r webui/requirements.txt
+   ```
+   Optional – use a venv to avoid touching system Python:
+   ```bash
+   python3 -m venv venv
+   source venv/bin/activate
+   pip install -r webui/requirements.txt
+   ```
+
+2. **Config:** Copy `config.example.ini` to `config.ini` and adjust (port, baudrate, web UI host/port, etc.). `config.ini` is gitignored.
+   ```bash
+   cp config.example.ini config.ini
+   ```
+   Edit `config.ini` to set the plotter port (e.g. `/dev/ttyUSB0`) and optionally web UI port/host.
+
+## Run
+
+From the **project root** (mimaki/):
+
+```bash
+python webui/app.py
+```
+
+Then open http://<raspi-ip>:5000 in a browser (e.g. http://192.168.1.10:5000).
+
+- **Host:** `0.0.0.0` so other devices on the network can connect.
+- **Port:** 5000 (override with `PORT=8080 python webui/app.py` if needed).
+
+For production, run behind gunicorn and optionally a reverse proxy:
+
+```bash
+pip install --break-system-packages gunicorn   # or omit if not using system Python
+gunicorn -w 1 -b 0.0.0.0:5000 "webui.app:app"
+```
+
+## Usage
+
+1. **Upload** – Choose an `.hpgl` or `.plt` file. It is validated and stored in `webui/uploads/`.
+2. **Preview** – The drawing is converted to SVG and shown in the browser.
+3. **Transform** – Flip, Rotate 90° / 180°, Scale + / −, Center. Each action updates the stored program and the preview.
+4. **Print** – Sends the current (transformed) program to the plotter: scale to fit, center, then write HPGL to serial.
+
+## API
+
+- `POST /api/upload` – Upload HPGL file (form field `file`).
+- `GET /api/svg` – Get current program as SVG (query: `width`, `height`).
+- `POST /api/transform` – Body: `{"action": "flip"|"rotate"|"scale"|"centralize", "angle": 90, "factor": 1.25}`.
+- `POST /api/print` – Send current program to plotter.
+- `GET /api/status` – `has_file`, `filename`, `plotter_ready`.
+
+Session is used to keep the current file path; no database.