Grotti 2.2.0: Auth, API-Tokens, MCP und Doku-Trennung.

README.md

@@ -51,7 +51,7 @@ Die Familie (Kobra 3 oder S1) liest Grotti aus dem Namen.
 .\.venv\Scripts\python.exe server.py
 ```
 
-Dann <http://127.0.0.1:8770/> öffnen. Handbuch in der Oberfläche unter **Doku**.
+Dann <http://127.0.0.1:8770/> öffnen. Bedienungsanleitung mit Screenshots in der Oberfläche unter **Doku** (Kapitel `Anleitung-*`), Technik-Notizen darunter.
 
 `config.json` und `data/` sind lokal und nicht im Git.
 
@@ -62,33 +62,39 @@ Dann <http://127.0.0.1:8770/> öffnen. Handbuch in der Oberfläche unter **Doku*
 | `server.py` | Start, Datenbank vorbereiten, Hintergrund-Threads |
 | `grotti/` | Kern: Moonraker, Warteschlange (`print_queue.py`), Senden (`send_queue.py`), Abräumen (`eject.py`), Zustandswächter (`watcher.py`), Ereignisse und Telegram (`notify.py`), Datenbank (`store.py`, `schema.sql`) |
 | `web/` | Flask-App (`app.py`), Seiten (`templates/`), CSS und JS (`static/`) |
-| `docs/` | Technische Notizen, gerendert unter `/doku/<name>` |
+| `docs/` | Bedienungsanleitung (`Anleitung-*.md`) unter `/doku`; Technik unter `docs/internal/` (nicht in der App) |
+| `web/static/doku/` | Screenshots für die Anleitung |
 | `CHANGELOG.md` | Änderungen je Version |
 
 ## API
 
-Alles unter `/api/v1`, JSON. Die wichtigsten Endpunkte:
+Alles unter `/api/v1`, JSON. Auth: Session-Cookie (UI) oder `Authorization: Bearer grt_…` (API-Token unter Einstellungen). Optional noch Shared-`token` in der Config (Migrationsbrücke).
 
 | Methode und Pfad | Zweck |
 | --- | --- |
+| `POST /auth/setup`, `/auth/login`, `/auth/logout` | Ersten Admin, Login, Logout |
+| `GET /me`, `/users`, `/tokens` | Konto, Benutzer (Admin), API-Tokens |
 | `GET /version` | Version |
 | `GET /drucker?live=1` | Drucker mit Live-Zustand, laufendem und wartendem Auftrag |
 | `POST /drucker/<host>/<aktion>` | Pause, Fortsetzen, Abbrechen, Fehler löschen |
 | `POST /drucker/<host>/steuern` | Temperatur, Speed, Flow, Lüfter |
 | `GET /dateien`, `POST /dateien` | Bibliothek, Upload |
 | `POST /senden` | Datei an Drucker. `confirm: true` ist Pflicht. `when_free: true` reiht ein. |
-| `GET /druck-queue`, `PATCH /druck-queue/<id>` | Warteschlange, Abbrechen (`status: cancelled`), Ablauf fortsetzen (`resume`) |
+| `GET /druck-queue`, `POST /druck-queue`, `PATCH /druck-queue/<id>` | Warteschlange (`confirm` beim Einreihen) |
 | `POST /spulen/<id>/einlegen` | Spule an Drucker/Platz; alte Rolle dort ins Regal |
 | `POST /ablauf` | Ablauf für Kobra 3 einreihen |
 | `GET /ereignisse?host=&kind=&since=&limit=` | Aktivität |
 | `POST /ereignisse/gelesen` | Alerts als gelesen |
 | `GET /spulen`, `GET /laeufe`, `GET /projekte` | Material, Protokoll, Projekte |
 
+MCP: `python -m grotti.mcp_server` mit `GROTTI_URL` und `GROTTI_TOKEN` (siehe `docs/internal/MCP.md`).
+
 ## Sicherheit
 
+- Login Pflicht (Setup legt den ersten Admin an). Rollen: Admin, Operator.
 - Druckstarts brauchen `confirm: true`. Die Oberfläche fragt per Zwei-Klick.
-- Keine freie G-code-Konsole.
-- Kein `FIRMWARE_RESTART`, GoKlipper hängt sich dabei auf. Fehler werden über „Fehler löschen“ geräumt.
+- Keine freie G-code-Konsole; Firmware-Neustart über Grotti ist gesperrt.
+- Für Internet: Reverse Proxy mit TLS; nicht den Entwickler-Server öffentlich freigeben.
 
 ## Versionen und Changelog