craftdex-export.json
Aufbau der maschinenlesbaren Exportdatei, Format Version 1.
craftdex-export.json liegt im Stammverzeichnis der ZIP-Datei. Sie enthält alle Tabellen vollständig und ein Verzeichnis aller Dateien. Für Programme, die Daten aus CraftDex übernehmen, ist sie die maßgebliche Quelle: Anders als bei den CSV-Dateien bleiben Zahlen, Wahrheitswerte, Listen und null als solche erhalten.
Aufbau
{
"format": "craftdex-export",
"version": 1,
"created_at": "2026-11-20T14:05:00.000Z",
"company": { "id": "5b0c…", "name": "Musterbau GmbH" },
"excluded": ["users.pin_hash", "users.push_token", "mail_accounts.secret"],
"tables": {
"users": [{ "id": "a1f3…", "name": "Max Mustermann", "role": "worker" }],
"sites": [{ "id": "c7e2…", "name": "Neubau Lindenstraße", "status": "aktiv" }]
},
"files": [
{
"bucket": "site-photos",
"path": "c7e2…/1795190678846.jpg",
"zip_path": "dateien/site-photos/c7e2…/1795190678846.jpg",
"size": 482113,
"sha256": "9f2b…",
"content_type": "image/jpeg"
}
]
}Felder
| Feld | Typ | Bedeutung |
|---|---|---|
format | Text | immer craftdex-export |
version | Zahl | Version des Formats, derzeit 1 |
created_at | Zeitpunkt (UTC) | wann der Export erstellt wurde |
company | Objekt | id und name des Betriebs |
excluded | Liste | Spalten, die bewusst nicht exportiert werden, als tabelle.spalte (warum) |
tables | Objekt | je Tabelle eine Liste aller Zeilen; Schlüssel ist der Tabellenname, die Zeilen haben die Spalten aus Tabellen und Spalten |
files | Liste | alle Dateien des Betriebs, siehe unten |
Einträge in files
| Feld | Bedeutung |
|---|---|
bucket | Ablage in CraftDex, zum Beispiel site-photos |
path | Pfad innerhalb der Ablage, ohne die Kennung des Betriebs |
zip_path | Pfad der Datei in der ZIP-Datei |
size | Größe in Byte |
sha256 | SHA-256-Prüfsumme, hexadezimal (prüfen) |
content_type | Dateityp, soweit bekannt, sonst null |
Reihenfolge der Zeilen
Die Zeilen jeder Tabelle sind stabil sortiert, in der Regel nach id. Zwei Exporte desselben Stands ergeben dieselbe Reihenfolge.
Versionen
version wird erhöht, wenn sich das Format so ändert, dass ein Programm für die alte Version die Datei nicht mehr richtig lesen würde, etwa wenn ein Feld wegfällt oder seine Bedeutung ändert. Neue Tabellen oder neue Spalten erhöhen die Version nicht; Programme sollten unbekannte Tabellen und Spalten deshalb überspringen. Alle Änderungen stehen unter Änderungen.