Web-CMS nutzen

Das Linetra Web-CMS unter https://linetra-web.nasarek.dev pflegt Organisationen, Personen und Projekte. Die öffentliche Produktseite (Preise, Kontakt) liegt unter https://linetra-org.nasarek.dev. Geometrien erfassen Sie im Linetra Editor oder weiterhin in QGIS; die Web-Karte zeigt sie nur lesend (OpenLayers, Kacheln).

Anmelden

1. Seite öffnen → Login.
2. Benutzername und Passwort Ihres Linetra-Kontos eingeben (nicht die QGIS/Datenbank-Zugangsdaten linetra_edit / linetra_read).
3. Beim ersten Start legt der Server nur den Systemadmin aus LINETRA_BOOTSTRAP_ADMIN_* an (ohne Organisation). Unter Kontomenü → Nutzer → Organisationen legt dieser Sysadmin Kundenorganisationen inkl. erstem Organisationsadmin an; über ✎ in der Zeile einer Organisation öffnet sich deren Detailseite mit Namen und Mitarbeiter-Tabelle für weitere Organisationsadmins und Mitarbeiter; unter Kontomenü → System → Administratoren weitere Systemadmins. Mitarbeiter der eigenen Orga laden Organisationsadmins unter Kontomenü → Organisation ein. Nicht jeder Mitarbeiter braucht ein Login: Ohne Haken bei Web-Account (Login) werden nur Name und Telefonnummer gespeichert (z. B. Feldmitarbeiter, die nur per WhatsApp kommunizieren). Der Haken kann später über ✎ gesetzt werden; dann sind Benutzername und Passwort Pflicht. Bei der Telefonnummer wählen Sie Land und Vorwahl im Auswahlfeld (Standard: Deutschland, +49) und geben die Nummer wie gewohnt ein, auch mit führender 0. Jede Nummer darf nur einer Person gehören; über sie erkennt die Inbox, wer per WhatsApp schreibt.

Wenn die Anmeldung fehlschlägt: Benutzername/Passwort prüfen gilt nur bei ungültigen Zugangsdaten. Eine Meldung, dass die Anmeldung vorübergehend nicht möglich ist, bedeutet ein Server- oder Datenbankproblem (z. B. fehlende Migration) — nicht das Passwort.

Nach dem Login: oben Logo, Sprachschalter und Hell/Dunkel (Sonne/Mond); darunter links das aktuelle Projekt, Dashboard, Datenmanagement, und rechts das Kontomenü (Benutzername). Darunter liegen Profil, Organisation, Projekte und Einstellungen. Systemadmins ohne Impersonation sehen die linken Org-Nav-Einträge nicht — sie wählen in der Kopfzeile eine Organisation und agieren als Org-Admin (Impersonation); erst dann erscheinen Projekt, Dashboard und Datenmanagement.

Rollen

Die Organisationsrolle gilt für das ganze Organisationskonto. Was jemand in einem Projekt darf, bestimmt zusätzlich die Projektrolle; es gilt immer das Strengere von beiden.

Die Stammdaten-Felder Organisation, Projektleiter und Akteurszuweisung eines Projekts beschreiben externe Beteiligte (Unternehmen, Gemeinden, Personen) und vergeben keine Rechte.

Organisationen (Systemadmin)

Unter Kontomenü → Nutzer legen Systemadmins Kundenorganisationen an. Jede Organisation hat eine eigene Postgres-Datenbank (linetra_<kurzname>), getrennt von der App-/Control-DB. Zum endgültigen Löschen tippen Sie im Dialog den Kurznamen und bestätigen — gelöscht werden nur Katalogeinträge dieser Orga und ihre Tenant-DB, nicht die Control-DB. Ein Backup herunterladen (ZIP mit Dump der Tenant-DB und Metadaten) ist optional. Bewahren Sie ein ZIP lokal auf — es gibt keine Wiederherstellen-Schaltfläche in der Oberfläche.

Nur Org-Admins legen Projekte an und sehen und verwalten alle Projekte der Organisation, auch ohne Mitglied zu sein. Mitarbeiter und Kunden sehen ein Projekt erst mit Projektmitgliedschaft. Im QGIS-Plugin erscheinen dieselben Regeln für Mitgliedschaft und Schreibrechte: Leitung und Büro zeichnen, Feld sieht die Layer nur lesend.

Projektmitglieder

Mitglieder pflegen die Leitung des Projekts und Org-Admins unter Stammdaten → Projekte → Projekt oder Kontomenü → Projekte → Projekt im Abschnitt Projektmitglieder:

1. Einen Mitarbeiter der Organisation auswählen. Auch Mitarbeiter ohne Login (markiert mit „ohne Web-Login“) können Mitglied werden, z. B. Feldmitarbeiter, die nur per Telegram oder WhatsApp erreichbar sind. Wer schon Mitglied ist, steht ausgegraut mit seiner Projektrolle in der Auswahl („bereits im Projekt: Leitung“).
2. Die Projektrolle wählen (Leitung, Büro oder Feld) und Mitglied hinzufügen klicken.
3. In der Liste lässt sich die Projektrolle je Mitglied umstellen; Telefon und Messenger zeigen, wie die Person erreichbar ist.

Wer ein Projekt anlegt, wird dessen Leitung. Ein Projekt kann mehrere Leitungen haben; die letzte Leitung kann nur ein Org-Admin entfernen oder herabstufen. In der Mitarbeiterliste der Organisation steht, in wie vielen Projekten jemand Mitglied ist.

Akteure und Produkttypen gelten für alle Projekte der Organisation; GIS-Layer bleiben projektbezogen.

Klick auf den Projektnamen öffnet die Liste der Ihnen zugeordneten Projekte; die letzte Auswahl bleibt aktiv. + legt ein neues Projekt an (Sie sind Leitung), ✎ öffnet die Projektseite, × löscht nach Rückfrage (Leitung oder Org-Admin) — inklusive Geometrien, Versionen und projekteigener Schemata. Dashboard zeigt die Karte des gewählten Projekts. Datenmanagement öffnet ein Submenü mit Schemata und Datensätze. Berichte (/reports) und die Identify-Karte (/map) bleiben eigene Seiten; Dokumentation steht im Fuß der Seite. Hell/Dunkel stellen Sie über das Sonne/Mond-Icon in der Kopfzeile ein; das API-Log unter Kontomenü → Status.

Eigenes Konto

Im Kontomenü (Ihr Benutzername rechts) öffnen Sie Profil (Name, Kontakt, Benutzername, Passwort). Organisationsmitglieder sehen zusätzlich Organisation (Kontodaten und Mitarbeiter) und Projekte. Darunter stehen die Einträge, die Ihre Rolle sieht: für Organisationsadmins Einstellungen, für Systemadmins Struktur, System, Nutzer und Status. Systemadmins ohne Impersonation haben kein Organisationskonto und sehen Profil, diese Einträge und Abmelden.

Projekte und Akteure

Akteure und Objekttypen pflegen Sie unter Datenmanagement → Datensätze. Eine Entität öffnen, dann + / ✎ / × für die Datensätze (mit Rückfrage beim Löschen). Ein Projekt bearbeiten oder nach QGIS exportieren: auf dem Dashboard unter der Karte Projekt öffnen. Neben dem Projekttitel schaltet Anpassen auf die Feldliste: vorgegebene Felder bleiben, optionale Felder fügen Sie für das ganze Organisationskonto hinzu, bearbeiten oder entfernen sie. Daten zeigt wieder Formular (inkl. optionaler Felder), Export und Chat. Jedes Projekt hat fest Name, Akteurszuweisung, Notizen, Status (aktiv) und Zeitraum — diese Systemfelder lassen sich nicht löschen. Dateien folgen später.

Neu anlegen und speichern. Nach Speichern bleibt die Seite offen und zeigt Gespeichert. Fehlt ein Pflichtfeld oder lehnt die API den Request ab, steht die Meldung direkt über den Buttons. Ohne Projektrolle Leitung (oder als Gast) sind Speichern/Löschen deaktiviert.

Akteure im Detail

Objekte im Detail

Unter Datenmanagement → Datensätze pflegen Sie Typen in geo_object_kinds (Anzeigename und technischer Code). Beispiele aus dem Seed: Glasfasertrasse, TKG-Antrag, VAO, Querung. Neue Typen legen Sie mit Neu an; der Code ist danach unveränderlich. Konkrete Geometrien und Fachfelder erfassen Sie im Linetra Editor (Optionen → Produkte für Kartenfarbe) oder in QGIS. Dieselbe Leitung erscheint danach unter Datensätze, sobald das Projekt in der Kopfzeile gewählt ist.

Server-Log

Unter Einstellungen → System → KI-Agent (nur Systemadmins) steuern Sie die Modelle des Feld-Assistenten. Die Seite hat zwei Unterseiten.

• Agenten: Jede Aufgabe des Assistenten ist ein Agent mit eigenem Anbieter und Modell, zum Beispiel Feldnachricht verstehen (liest Meldungen, ordnet sie Aufgaben zu, erkennt „erledigt“ oder „Problem“). Unter jeder Aufgabe steht die Empfehlung (mittel oder hoch) für jeden Anbieter, zum Beispiel „qwen2.5:7b-instruct · Haiku · GPT mini“. Mit dem Stift wählen Sie Anbieter und Modell; im Dialog bietet die Seite die passenden Modelle des Anbieters per Klick an und warnt, wenn ein Modell dort nicht existiert. Die Modellliste erscheint als Vorschlag, sobald der Anbieter verbunden ist; ein anderer Name lässt sich frei eintippen. Für Modelle mit Denkstufe (OpenAI GPT-5 und o-Serie, Ollama gpt-oss) gibt es zusätzlich das Feld Aufwand (niedrig, mittel, hoch). Agenten, die ein Modell aufrufen (derzeit Feldnachricht verstehen), haben außerdem das Feld Anweisungen: den Text, den das Modell zu jeder Nachricht bekommt. Sie können ihn anpassen, zum Beispiel wann ein Problem als Stillstand zählt; das Antwortformat ist fest und nicht Teil des Texts. Änderungen gelten ab der nächsten Nachricht, Standardtext wiederherstellen setzt den eingebauten Text zurück. Agenten mit dem Hinweis Geplant (Dokument heraussuchen, Dokument zuordnen, Scans lesen, Tageszusammenfassung) ruft noch keine Funktion auf; Sie können ihr Modell aber schon vorbereiten. Offline-Assistent bedeutet: Ollama hat keine Server-URL, es läuft die einfache Schlüsselwort-Erkennung.
• Anbieter: Ollama läuft auf dem eigenen Server (Server-URL), Anthropic und OpenAI sind gehostete Dienste (API-Schlüssel; bei OpenAI optional eine andere Server-URL für kompatible Dienste). Der Stift öffnet die Verbindung und darunter die Modellliste des Anbieters: eine kleine Tabelle mit Häkchen (für Agenten anbieten), Name, Version und Modell-ID; Speichern sichert Verbindung und Liste zusammen. Das Pulssymbol testet die Verbindung und zeigt die Modelle, die der Anbieter meldet. Zeilen lassen sich ändern, mit + hinzufügen und mit × löschen; Neueste vom Anbieter ergänzen trägt neue Modelle nach. Bei leerer Liste startet die Tabelle mit der neuesten Version je Modellfamilie, zum Beispiel „Haiku 4.5“. Nur angehakte Modelle erscheinen in der Auswahl der Agenten. API-Schlüssel werden verschlüsselt gespeichert und nie wieder angezeigt; ein leeres Feld behält den Schlüssel, Gespeicherten Schlüssel entfernen löscht ihn.

Achtung: Bei Anthropic und OpenAI werden Nachrichtentexte an den Anbieter gesendet; dafür brauchen Sie einen Auftragsverarbeitungsvertrag.

Unter Kontomenü → Status sehen Systemadmins die letzten Ereignisse des API-Prozesses (Debug, Info, Warning, Error, Critical). Die Prozessebene (ausgegraut, mit ✎ änderbar) ist die Schwelle: darunter wird nicht in den Ringspeicher geschrieben. Info meint nur grobe Normalvorgänge (Start/Stop, Login, Nutzeränderungen) — nicht jeden HTTP-Request. Access-Zeilen erscheinen erst bei Prozessebene Debug und nur in den Container-Logs, nicht in dieser Liste. Die farbigen Schweregrad-Chips darunter sind dieselbe Art Schwelle für die Anzeige (Debug = die meisten Zeilen, Critical = die wenigsten). Sortierung, Seitengröße und Blättern gelten für die Trefferliste. Vorgabe LOG_LEVEL in der Umgebung; UI-Änderung gilt bis zum Neustart. Der Ringspeicher geht beim Neustart verloren. Celery- und Next.js-Logs bleiben in den Container-Logs.

Darstellung

Hell, Dunkel oder Systemvorgabe stellen Sie über das Sonne/Mond-Icon oben rechts in der Kopfzeile ein (Klick wechselt zyklisch).

Dashboard-Karte

Nach dem Login zeigt Übersicht (/) die Karte des aktuellen Projekts in der Seitenbreite (nicht randlos), darunter Projektkennzahlen und die Projektdaten (Name, Code, Status, Organisation, Projektleiter, Ort). Rechts an der Karte (auf schmalen Screens darunter) steht der Layer-Explorer wie in QGIS:

1. Projekt in der Kopfzeile wählen, falls noch keins gesetzt ist.
2. Der Baum zeigt Gruppen und Layer des Projektschemas. Häkchen blendet Geometrien ein oder aus. Aufklappen eines Layers listet Features (nur Lesen).
3. Die Karte zeichnet die sichtbaren Layer und zoomt auf die Geometrien des aktuellen Projekts. Ein Klick auf eine Geometrie oder ein Feature im Baum öffnet die Attribute als Popup (Feldbezeichnungen aus dem Schema; leere Werte werden ausgeblendet).
4. Die Farbfelder neben den Layern sind die gemeinsame Legende mit dem Editor. Editor- und Admin-Konten wählen eine Farbe per Klick (nativer Farbwähler); die Karte übernimmt sie sofort. Leser sehen die Farben, können sie aber nicht ändern.

Die Webkarte speichert keine Geometrien. Erfassen Sie sie im Linetra Editor oder in QGIS (Layer-Änderungen dort speichern). Danach Übersicht neu laden; der Layer-Explorer zeigt die Objektzahl, die Karte zoomt auf die Features.

Unter der Karte stehen Kennzahlen zum aktuellen Projekt: Anzahl der Geo-Objekte (nach Schema-Art), optionale Summen über Zahlenfelder aus dem Schema, Verfahren nach Status sowie eine Tabelle der Verfahren in Vorbereitung. Zur Analyse öffnet die detaillierteren Diagramme. Darunter folgen die Stammdaten des Projekts; Projekt öffnen führt zur Projektseite (Bearbeiten, Chat, Export).

Verfahren

Unter Verfahren (/verfahren) sehen Planer und Behörden Anträge je Abschnitt: Status, Auflagen, Fristen und das Audit-Protokoll. Behörden sehen nur Anträge, deren Geometrie ihr Gemeindegebiet schneidet. Geometrien ändern Sie nicht hier — nur im Editor.

Berichte und PDF

Berichte zeigt Diagramme (Projekte nach Status, nach Organisation, Personen nach Organisation).
PDF exportieren lädt eine Zusammenfassung herunter.

Identify-Karte

Unter Karte (/map) sehen Sie projektbezogene Geo-Objekte schreibgeschützt (OpenLayers, OSM/Carto-Basemap) und können ein Objekt anklicken.

1. Das aktuelle Projekt in der Kopfzeile wählen (Klick öffnet die Liste). Stufe (Planung / Normierung / Produkt) und optional das Produkt aus der Liste der für diese Stufe hinterlegten Arten wählen.
2. Vorhandene Objekte erscheinen in der Layerfarbe aus dem gemeinsamen Katalog (gleiche Farben wie auf dem Dashboard und im Editor).
3. Klick zeigt Attribute und Kommentare. Bei einer aus der Planung kopierten Normierung steht Quelle (Planung). Neue oder geänderte Geometrien im Linetra Editor oder in QGIS erfassen — die Webkarte speichert nichts.

Chat und Tickets

Auf der Projektseite: Nachrichten Kunde ↔ Betreiber und Tickets (Status). Ein optionales Jira-Aktenzeichen ist nur intern; Jira bleibt Ihr Betriebswerkzeug.

QGIS-Export

Auf der Projektseite (Dashboard → Projekt öffnen) QGIS 3.40 LTR oder QGIS 4.2 wählen. Der Export wird erstellt und als ZIP heruntergeladen. Entpacken und project.qgs in QGIS öffnen — linetra.gpkg muss daneben liegen.

Das Paket enthält:

• GeoPackage linetra.gpkg (EPSG:25832): eine Tabelle je Stufe × Produktart, inkl. Beilage-Felder und Bauabschnitte
• Projektdatei project.qgs mit Layergruppen (Planung, Normierung, Produkte, Abschnitte), Farben und OpenStreetMap-Basemap
• Projekt-Stammdaten als Attributtabelle (ohne Geometrie)
• Leere Layer für alle Produktarten des Projekts (Kind-Packs), damit in QGIS sofort der vollständige Katalog sichtbar ist

Ziel: QGIS 3.40 LTR; zusätzlich gegen 4.2 getestet. Kein fiber_routes-Dump und keine Live-Datenbankverbindung.

Dokumentation

Dokumentation im Fuß der Seite öffnet das Benutzerhandbuch unter /documentation/.