docs(I2): plugin guide (API v2 + example), library spec (wcadlib JSON+ZIP), changelog 2.0, readme rewrite

README.md

@@ -1,21 +1,74 @@
-# Web CAD Neu
+# WebCAD
 
-Web-basiertes 2D-CAD für Event-Bestuhlungspläne.
+Web-basiertes 2D-CAD mit Kollaboration, Plugin-System und Fokus auf
+Veranstaltungsplanung (Bestuhlung, Bühnen, Layouts).
+
+## Features
+
+- **Zeichnen:** Linien, Rechtecke, Kreise, Bögen, Ellipsen, Splines, Polylinien, Text, MTEXT, Bemaßungen, Hatch
+- **Modifizieren:** Move/Copy/Rotate/Scale/Mirror, Trim/Extend/Fillet/Chamfer, Stretch/Break/Join/Explode/Align/Lengthen, Polyline-Editor, Grips (Vertex/Center), Arrays (rect/polar/path)
+- **Event-Tools:** Stühle, Sitzreihen (Drag), Sitzblöcke, ArcRows, Tische, Bühnen (mit Höhen-Attribut), Vorhang, Scheinwerfer, Absperrungen, Vorlagenkatalog, Gäste-Verwaltung mit Sitzplatz-Zuweisung, CSV-Sitzlistent-Export
+- **Snaps:** Endpoint, Midpoint, Center, Intersection, Quadrant, Perpendicular, Tangent, Grid, Polar-Tracking
+- **Bibliothek:** Globale Block-Bibliothek mit Ordnern, Suche, Favoriten, Thumbnails; Builtin-Kataloge (Event/Architektur/Landschaft); Export/Import als .wcadlib (JSON oder ZIP)
+- **Import/Export:** DXF (Import mit ELLIPSE/SPLINE/MTEXT/POINT/ATTDEF + Fehlerreport; Export R12/2000 mit BLOCKS/ATTR), SVG (echte Geometrie-Konvertierung mit Path-Parser), PDF (je Layout, maßstabsgetreu), PNG, JSON
+- **Layouts & Plot:** Layout-Verwaltung mit Viewport-Minimap, Titelblock mit Attributen, PDF-Export, Browser-Print
+- **Kollaboration:** Yjs CRDT, kollaborativ korrektes Undo/Redo (nur eigene Operationen)
+- **Modi:** simple (Grundwerkzeuge) / pro (Vollpalette), localStorage-persistiert
+- **Templates:** 6 Branchen-Presets (Halle, OpenAir, Saal, Messe, Büro, Garten)
+- **i18n:** de/en (Grundlage, erweiterbar über `src/i18n/strings.ts`)
+- **Rollen:** admin (library-admin, globaler Schreibzugriff) / planer (lesen + eigene Zeichnungen)
 
 ## Stack
-- Frontend: React + TypeScript + Vite + HTML Canvas
-- Backend: Node.js + TypeScript + Fastify + SQLite
-- Collaboration: Yjs CRDT
+
+- **Frontend:** React 18 + TypeScript + Vite + PixiJS v8 (WebGL-Renderer, Canvas2D-Fallback) + zustandsfreier Service-Layer
+- **Backend:** Node.js + TypeScript + Fastify 5 + SQLite (better-sqlite3)
+- **Kollaboration:** Yjs + y-websocket
+- **Tests:** Vitest (697 FE + 287 BE), Playwright E2E, tsc-Strict-Mode
 
 ## Entwicklung
+
 ```bash
-npm install
-npm run dev
+# Backend
+ cd backend && npm install && npm run dev   # http://localhost:3001
+
+# Frontend
+cd frontend && npm install && npm run dev   # http://localhost:5173
+```
+
+### Tests
+
+```bash
+cd frontend && npm test    # 697 Vitest-Tests
+cd backend  && npm test    # 287 Vitest-Tests
+
+cd frontend && npx tsc --noEmit   # Typecheck
+cd frontend && npm run build      # Production-Build
 ```
-- Frontend: http://localhost:5173
-- Backend: http://localhost:3001
 
 ## Docker
+
 ```bash
 docker-compose up --build
 ```
+
+## Plugin-Entwicklung
+
+Siehe [docs/PLUGIN_GUIDE.md](docs/PLUGIN_GUIDE.md) – Plugin-API v2 mit
+Werkzeugen, Panels und Bibliotheks-Providern, inkl. Minimal-Beispiel.
+
+## Bibliotheks-Pakete (.wcadlib)
+
+Siehe [docs/LIBRARY_SPEC.md](docs/LIBRARY_SPEC.md) – JSON- und ZIP-Format,
+Validierungsregeln, Endpoints und CAD-Element-Konventionen.
+
+## Architektur-Regeln
+
+- `kernel/**` importiert niemals React
+- `render/pixi/**` kennt keine React-Components
+- React kennt den Renderer nur über CanvasArea
+- Eine Werkzeug-Aktion = eine `doc.transact()` = ein Undo-Schritt
+
+## Roadmap & Status
+
+Alle funktionalen Phasen (A–H) sind abgeschlossen. Aktueller Stand und
+Task-Log: [ROADMAP.md](ROADMAP.md).