Agent Zero
81 lines
2.5 KiB
Markdown
81 lines
2.5 KiB
Markdown
# .wcadlib – Block-Bibliotheks-Paket-Spezifikation
|
||
|
||
WebCAD-Block-Bibliotheken können als `.wcadlib`-Paket geteilt werden.
|
||
Es gibt zwei Formate:
|
||
|
||
## Format 1: JSON-Paket (F1)
|
||
|
||
Ein einzelnes JSON-File mit folgender Struktur:
|
||
|
||
```json
|
||
{
|
||
"format": "wcadlib",
|
||
"version": 1,
|
||
"exported_at": "2026-08-29T00:00:00.000Z",
|
||
"folders": [
|
||
{ "id": "f1", "name": "Veranstaltungstechnik", "parent_id": null }
|
||
],
|
||
"blocks": [
|
||
{
|
||
"name": "Stuhl-Reihe",
|
||
"folder_id": "f1",
|
||
"block_data": "[{...CADElement-Array als JSON-String...]}",
|
||
"svg_data": "<svg ...>"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
- `block_data` = JSON-String eines **CADElement-Arrays**
|
||
- `svg_data` = eigenständiges SVG (Thumbnail), optional
|
||
- Ordner-Hierarchie via `parent_id` (Import ordnet IDs neu zu)
|
||
|
||
**Endpoints:** `GET /api/global-blocks/export`, `POST /api/global-blocks/import`
|
||
(schreibend: nur library-admin/Rolle admin, siehe H3)
|
||
|
||
## Format 2: ZIP-Paket (F7)
|
||
|
||
Ein echtes ZIP-Archiv mit fester Struktur:
|
||
|
||
```
|
||
library.wcadlib.zip
|
||
├── manifest.json { "format": "wcadlib-zip", "version": 1,
|
||
│ "exported_at": "...", "block_count": N, "folder_count": M }
|
||
├── blocks.json { "folders": [...], "blocks": [
|
||
│ { "name", "folder_id", "block_data",
|
||
│ "thumbnail": "thumbs/<id>.svg" } ] }
|
||
└── thumbs/
|
||
└── <blockId>.svg Thumbnails, Referenz aus blocks.json
|
||
```
|
||
|
||
- `manifest.format` MUSS `wcadlib-zip` sein (sonst 400)
|
||
- `blocks.json` MUSS vorhanden sein (sonst 400); `blocks`-Array Pflicht
|
||
- `thumbnail` verweist relativ auf `thumbs/<id>.svg`
|
||
|
||
**Endpoints:**
|
||
- `GET /api/global-blocks/export-zip` → `application/zip`
|
||
- `POST /api/global-blocks/import-zip` (Body = ZIP als application/zip;
|
||
schreibend: nur library-admin)
|
||
|
||
## Validierungsregeln (Import)
|
||
|
||
| Fehler | HTTP |
|
||
|---|---|
|
||
| Kein valides ZIP (Format 2) | 400 |
|
||
| blocks.json fehlt / invalides JSON | 400 |
|
||
| manifest.format unbekannt | 400 |
|
||
| Kein JSON/blocks-Array (Format 1) | 400 |
|
||
| Nicht authentifiziert | 401 |
|
||
| Rolle != admin (schreibend) | 403 |
|
||
|
||
## CAD-Element-Konventionen (block_data)
|
||
|
||
- `rect`: `x/y` = **Zentrum** der BBox
|
||
- `circle`/`arc`: `el.x/el.y` = **Zentrum**, Winkel in Grad (0° = 3 Uhr, CCW)
|
||
- `line`: `properties.x1/y1/x2/y2`
|
||
- `polyline`/`polygon`: `properties.points`
|
||
- `block_instance`: `properties.blockId` + optional `attrValues` (D12)
|
||
|
||
Beim Drop auf die Zeichenfläche werden Element-IDs neu generiert und
|
||
die Position per Drop-Punkt übersetzt – der Bestand bleibt unverändert.
|