Übersicht

Der Mindbox Bautagesbericht Standard definiert ein einheitliches, maschinenlesbares JSON-Format für den täglichen Bautagesbericht im Bahnbau. Er wurde im Rahmen des DB Mindbox Projekts gemeinsam mit den Bauunternehmen Leonhard Weiss, Rhomberg Sersa Rail Group und Willke entwickelt.

Ziele

Interoperabilität — ein Format, das alle Projektbeteiligten verwenden können
Maschinenlesbarkeit — direkte Integration in ERP-, Abrechnungs- und Projektmanagementsysteme
Vollständigkeit — alle relevanten Tagesbericht-Informationen in einer strukturierten Ressource

Struktur

Ein Bautagesbericht (Report) besteht aus einem Kopf-Objekt mit Projektbezug sowie 13 thematischen Abschnitten:

1. Kopfdaten

Berichtsnummer, Projekt, Baulos, Datum, Adresse

2. Wetterdaten

Beschreibung, Temperaturen, Niederschlag, Windstärke

3. Arbeitszeitraum

Arbeitsstart/-ende, Pausen

4. Personal

Anzahl, Stunden, Rolle/Funktion

5. Arbeitspositionen

Leistungsbeschreibung, Menge, Einheit

6. Subunternehmer

Firma, Gewerk, Ort, Mitarbeiterzahl

7. Geräte & Maschinen

Gerätename, -nummer, Betriebsstunden, Fremdmiete

8. Transport

Fahrzeugtyp, Anzahl, Betriebszeit

9. Stundenlohnarbeiten

Start-/Endzeit, Rapportnummer, Auftraggeber

10. Materialien

Materialbeschreibung, Menge, Einheit

11. Qualitätssicherung

Prüfart, Messwert, Einheit, Ort

12. Besondere Vorkommnisse

Kategorie, Beschreibung, Freigaben

13. Unterschriften

Rolle, Name, Zeitstempel, digitale Signatur

Datenmodell

Das zentrale Objekt ist ReportExpanded. Es enthält das Kopf-Objekt Report und alle untergeordneten Abschnitte als Arrays:

{
  "id": "uuid",
  "number": 42,
  "project_id": "uuid",
  "construction_lot": "Los 3 – Gleisbau",
  "trade": "Gleisbau",
  "date": { "year": 2025, "month": 6, "day": 12 },
  "client": "DB InfraGO AG",
  "version": 1,
  "state": "DRAFT",
  "address": { ... },
  "weather_data": [ ... ],
  "times": [ ... ],
  "personnel": [ ... ],
  "work_items": [ ... ],
  "subcontractor_work_items": [ ... ],
  "machines": [ ... ],
  "mileage": [ ... ],
  "hourly_wage_work": [ ... ],
  "materials": [ ... ],
  "quality_assurance": [ ... ],
  "remarks": [ ... ],
  "signatures": [ ... ]
}

Datentypen

Typ	Format	Beschreibung
`UUID`	RFC 4122	Eindeutige Objekt-Identifier
`DATE`	ISO 8601 Objekt (`year`, `month`, `day`)	Datum ohne Uhrzeit
`TIME`	Objekt (`hour`, `minute`, `second`, `nanosecond`)	Uhrzeit ohne Datum
`DECIMAL`	String oder Zahl	Präziser Dezimalwert (z.B. Stunden, Mengen)
`BOOLEAN`	`true` / `false`	Ja/Nein-Felder
`TIMESTAMP`	ISO 8601 mit Zeitzone	Datum + Uhrzeit

API

Die vollständige REST API ist als OpenAPI 3.0 Spezifikation dokumentiert.

Zur interaktiven API Referenz →