Erik
7.2 KiB
Bauakte
Die digitale Bauakte des VLN Managers — ein webbasiertes Dokumentenmanagement, das Projektbeteiligten gesicherten Zugriff auf Bauunterlagen, Pläne und Fotos je Maßnahme bzw. Verfahren gibt.
- Web: https://bauakte.vlnsachsen.de (Aufruf je Akte über einen individuellen Zugangscode)
- API: https://api.flurneuordnung-sachsen.de/v2 (siehe API-Zugang)
Sinn und Zweck
In einem Flurneuordnungs- bzw. Baumaßnahmen-Verfahren entstehen über die gesamte Laufzeit Pläne, Gutachten, Verträge, Stellungnahmen und Fotos. Diese Unterlagen müssen für sehr unterschiedliche Beteiligte verfügbar sein — den Verband, die Teilnehmergemeinschaften (TG) sowie externe Firmen und Behörden — ohne dass dabei jeder alles sehen oder verändern darf.
Die Bauakte bündelt diese Unterlagen je Maßnahme an einem Ort und stellt sicher, dass
- alle Beteiligten denselben, aktuellen Stand sehen,
- jeder nur die für ihn freigegebenen Inhalte erreicht,
- Beiträge von außen kontrolliert in die Akte gelangen (Freigabe-Workflow),
- Geodaten und Baustellenfotos direkt im Browser sichtbar werden — ohne Spezialsoftware.
Damit ersetzt die Bauakte verstreute E-Mail-Anhänge, Netzlaufwerke und manuelle Dateiweitergabe durch eine nachvollziehbare, rollenbasierte Ablage.
Funktionen
Dateiverwaltung & Vorschau
- Strukturierte Ablage in einem Ordnerbaum je Akte; Anlegen, Umbenennen und Löschen von Ordnern und Dateien (für berechtigte Nutzer).
- Vorschau im Browser für PDF und Bilder.
- Geo-Vorschau für gängige Geodaten-Formate (u. a. DXF/DWG, GeoTIFF, GeoJSON, KML, GPX, GPKG) — einzeln oder mehrere Dateien gemeinsam als Karte mit Übernahme von Farben und Stilen aus der Datei.
- Download einzelner Dateien sowie ZIP-Export ganzer Ordner.
Upload mit Freigabe-Workflow
- Mehrfach-Upload per Drag-and-Drop.
- Beiträge von Beteiligten, die nicht zum Verband gehören, landen zunächst in einer Freigabe-Warteschlange und werden erst nach Prüfung durch die verantwortliche Person in der Akte sichtbar. So bleibt der Aktenbestand kuratiert.
Baustellenfotos
- Aufnahme bzw. Upload von georeferenzierten Baustellenfotos (Standort aus Live-GPS oder aus den Bilddaten), die anschließend verortet auf der Karte erscheinen.
Verteiler & externer Portalzugang
- Je Akte lassen sich Verteiler (Kontakte mit Anrede und Funktion) pflegen.
- Externe Beteiligte erhalten über zeitlich befristete, passwortgeschützte Zugangslinks Zugriff auf ausgewählte Ordner — ohne eigenes Benutzerkonto.
- Verteilerlisten gruppieren Kontakte und benachrichtigen sie automatisch per E-Mail, wenn neue Unterlagen hochgeladen werden.
Träger öffentlicher Belange (TÖB)
- Eigener Upload-Modus für TÖB-Stellungnahmen, die automatisch in einer geordneten Ordnerstruktur abgelegt werden.
- Ermittlung der räumlich zuständigen Träger anhand des Verfahrensgebiets (und ergänzend der Foto-Standorte).
Cloud-Synchronisation
- Eine Akte kann optional mit einem Cloud-Ordner gespiegelt werden, sodass Unterlagen auch über die gewohnte Dateiablage bearbeitet werden können. Änderungen werden in beide Richtungen abgeglichen.
Zugriff & Rollen
Der Zugriff ist rollenbasiert; sichtbar ist jeweils nur, was der jeweiligen Rolle zusteht:
| Rolle | Zugang | Upload |
|---|---|---|
| Verband | alle Akten, volle Bearbeitung | direkt in die Ablage |
| Teilnehmergemeinschaft (TG) | nur die eigenen Akten | über den Freigabe-Workflow |
| Externe (Firma/Behörde) | nur freigegebene Ordner per Zugangslink | nur falls ausdrücklich erlaubt |
API-Zugang
Die Bauakte ist Teil des VLN Managers und über dessen v2-REST-API ansprechbar. Damit lassen sich Akten, Ordner, Dateien und Fotos programmatisch lesen und befüllen — z. B. aus den Office-Add-ins oder eigenen Werkzeugen.
- Basis-URL:
https://api.flurneuordnung-sachsen.de/v2 - Spezifikation (OpenAPI 3.0):
GET /v2/openapi - Status:
GET /v2/health
Authentifizierung
Geschützte Endpunkte erwarten eines der folgenden Verfahren:
| Schema | Ort | Wert |
|---|---|---|
X-API-Key |
Header | API-Key |
X-UserAuth |
Header | persönliches Zugriffs-Token |
userauth |
Query-Parameter | persönliches Zugriffs-Token |
- Login:
POST /v2/person/loginmit{ "mail": "…", "password": "…" }→ liefert das persönliche Token. - Das eigene Token kann zusätzlich über
GET /v2/config/clientabgerufen werden.
Die Sichtbarkeit der Akten richtet sich nach dem angemeldeten Nutzer: Der Verband sieht alle Akten, andere Rollen nur ihre eigenen.
Bauakten lesen (read-only)
| Methode | Pfad | Beschreibung |
|---|---|---|
GET |
/bauakten |
Sichtbare Bauakten auflisten |
GET |
/bauakten/{id} |
Detail einer Akte (mit zugehörigen Maßnahmen) |
GET |
/bauakten/{id}/folders |
Ordnerbaum der Akte |
GET |
/bauakten/{id}/files |
Dateien eines Ordners (paginiert) |
GET |
/bauakten/{id}/inbox |
Offene Einträge der Freigabe-Warteschlange |
GET |
/bauakten/{id}/verteiler |
Verteiler-Kontakte und -Listen |
GET |
/bauakten/{id}/toeb-relevant |
Räumlich zuständige TÖB-Stellen |
Dateien hoch- und herunterladen
Das Hoch- und Herunterladen läuft über die generische Dateiverwaltung der API:
| Methode | Pfad | Beschreibung |
|---|---|---|
POST |
/dateisystem/file/upload |
Datei(en) hochladen (multipart/form-data) |
GET |
/dateisystem/file/{uuid}/download |
Datei streamen (?redirect=1 → 302) |
POST |
/dateisystem/file/{uuid}/rename |
Umbenennen |
DELETE |
/dateisystem/file/{uuid} |
Datei löschen |
Baustellenfotos
Georeferenzierte Fotos je Akte; abgesichert über den jeweiligen Zugangscode der Akte:
| Methode | Pfad | Beschreibung |
|---|---|---|
GET |
/maps/bauakte?code=… |
Kopfdaten der Akte (Name, Status) |
GET |
/maps/bauakte-fotos?code=… |
Fotos als GeoJSON-FeatureCollection |
GET |
/maps/bauakte-foto/{id}?code=…&size=thumb|full |
Bilddatei ausliefern |
POST |
/maps/bauakte-foto |
Foto hochladen (multipart, optional lat/lon/heading) |
Beispiel
# 1) Anmelden und Token merken
TOKEN=$(curl -s https://api.flurneuordnung-sachsen.de/v2/person/login \
-H 'Content-Type: application/json' \
-d '{"mail":"name@vlnsachsen.de","password":"…"}' \
| jq -r '.data.userauth')
# 2) Sichtbare Bauakten auflisten
curl -s https://api.flurneuordnung-sachsen.de/v2/bauakten \
-H "X-UserAuth: $TOKEN"
# 3) Ordnerbaum einer Akte abrufen
curl -s https://api.flurneuordnung-sachsen.de/v2/bauakten/{id}/folders \
-H "X-UserAuth: $TOKEN"
Antwort-Konventionen: Nutzdaten stecken meist in einer Hülle { "data": … }; Fehler werden
nach RFC 7807 als application/problem+json zurückgegeben.
Verwandte Module
Die Bauakte arbeitet mit weiteren Modulen des VLN Managers zusammen — u. a. mit den Maßnahmen (jede Akte ist mit Maßnahmen verknüpft), dem Web-GIS (Verfahrensgebiete, Foto-Verortung), den Servicetermin-Werkzeugen und der Cloud-Ablage. Für die Ablage aus Microsoft Office heraus existieren passende Word-, Excel- und Outlook-Add-ins.