Agent Zero
75 lines
3.1 KiB
Markdown
75 lines
3.1 KiB
Markdown
# WebCAD
|
||
|
||
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 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
|
||
# 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
|
||
```
|
||
|
||
## 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).
|