Skip to content

QGIS mit Linetra verbinden

Planer nutzen nur QGIS mit dem Linetra-Plugin (ADR-0030, ADR-0033): Verbindung, Schema anwenden, Import und Layerbaum steckt im Plugin; Zeichnen bleibt QGIS-Canvas. Schema schreiben Sie in Linetra Web. Keine zweite Desktop-App.

Plugin installieren

  1. Repo-Pfad linetra-plugin/ (oder Release-ZIP) einmal per ./scripts/link-dev.sh ins QGIS-Plugin-Verzeichnis linken (legt Links unter QGIS3 und QGIS4 an) bzw. ZIP unter Erweiterungen → Installieren aus ZIP.
  2. In QGIS: Erweiterungen → Verwalten und Installieren → Installiert → Linetra aktivieren.
  3. Menü Linetra → Dock anzeigen.

Anmelden (Dock)

Im Dock rechts nur:

  1. API-URL — lokal z. B. http://localhost:8000 (Port aus der Web-.env, BACKEND_PORT); Team: https://linetra-web.nasarek.dev (nicht mehr linetra.nasarek.dev / linetra-app.nasarek.dev — die leiten nur noch mit 301/308 um und brechen den Login-POST im Plugin).
  2. Benutzer / Passwort — dasselbe Linetra-Konto wie im Web-CMS (nicht der Postgres-Name linetra_edit).
  3. Anmelden. Optional Angemeldet bleiben (Standard an): nach einem QGIS-Neustart sind Sie wieder angemeldet, bis Sie Abmelden wählen. Ohne Haken endet die Sitzung mit QGIS. Danach prüft das Plugin, ob ein passendes Zertifikat (CN = persönlicher LOGIN) gespeichert ist.
  4. Fehlt es: Popup „Zertifikatsordner wählen“ — ZIP unter Kontomenü → Profil → QGIS-Cert-ZIP laden (eigenes Zertifikat) oder Organisation (Admin für Mitarbeiter) entpacken und den Ordner wählen. Fremde ZIPs (anderer Benutzer) werden abgelehnt. Mehrere Certs können gespeichert werden (Benutzerwechsel). Lokal (Docker ohne mTLS) bleibt die Abfrage unsichtbar.

Host, Port, Datenbank und persönlicher Cert-CN kommen vom API-Login (/auth/me). Die Statuszeile zeigt z. B. Konto Nasarek · rnasarek · linetra_nasarek @ host:5432 (nasarek_u_0fc67079). Nach dem API-Login setzt das Plugin das Postgres-Passwort unsichtbar. Layer laden öffnet kein extra Kennwortfenster. Am Server bleibt mTLS Pflicht; das Dashboard-Passwort tippst du nur einmal.

Schema und Formulare entstehen in Linetra Web (Schema-Management). Das Plugin wendet das effektive Projektschema an — Kind-Create gibt es im Plugin nicht. Im Dock: Anmelden, Projekt wählen (nur Projekte, denen Ihr Konto als Owner, Bearbeiter oder Reader zugeordnet ist), Laden (erstes Mal), danach Aktualisieren (nur wenn sich das Schema geändert hat). Owner und Bearbeiter können Layer schreiben; Reader laden dieselben Layer nur lesend. Die Layer stehen im QGIS-Layerbaum, nicht noch einmal im Dock.

Nach Laden / Aktualisieren:

  • Der QGIS-Projekttitel ist das Linetra-Projekt
  • Gruppen und Layer aus dem Projektschema (z. B. Phase → Planung / Genehmigung, Layer Querung / VAO)
  • geo_objects nach project_id und Feature-Kind
  • Formulare aus field_definitions (String/Zahl/Datum/Enum/Relation); Relationen lesen Namen aus der API
  • CMS-Felder ohne eigene Spalte in geo_objects.attrs (JSONB)
  • Keine Stammdaten-Layer — Akteure und andere Datensätze verwalten Sie in Linetra Web

VPN (WireGuard) ist für die Datenbank nicht nötig.

Wer nur das Web-CMS oder die Feld-App nutzt, braucht kein Client-Zertifikat. Der Tauri-Editor ist Legacy und für Capture nicht nötig.

Am Server: Zertifikat und das DB-Passwort aus der API (das Plugin setzt es, du tippst es nicht).

Ist (abgeschaltet)

Der frühere Team-Weg — WireGuard, Host 10.13.13.1, Port 3401, SSL aus, nur Passwort — ist zu. Ohne Client-Zertifikat gibt es am Server keinen Datenbank-Login.

Soll (live)

Team-QGIS spricht PgBouncer mit gegenseitigem TLS. Cert-CN ist der persönliche LOGIN {slug}_u_{user_id_hex8} (erbt von {slug}_edit / {slug}_read) — ADR-0055. Fremde Zertifikate einer anderen Person funktionieren am Proxy nicht. Lokal auf dem Rechner mit Docker bleibt oft ohne mTLS nur die Entwicklung.

Admins erzeugen Zertifikatspakete auch unter Organisation → Mitarbeiter. Jeder GIS-Nutzer kann sein eigenes ZIP unter Konto → Profil → QGIS-Cert-ZIP laden. Das ZIP enthält Cert, Key, CA und eine VERBINDUNG.txt. Im Plugin den entpackten Ordner wählen — einzelne Dateien musst du nicht heraussuchen. Nach User-Wechsel erneut anmelden; das Plugin wählt das gespeicherte Cert oder fragt erneut.

Manuelle Verbindung (ohne Plugin)

Falls Layer über den QGIS-Browser nötig sind:

  1. Browser → PostgreSQL → neue Verbindung.
  2. Felder ausfüllen:
Feld Lokal (Entwicklung) Team (Server)
Name z. B. linetra z. B. linetra
Host localhost Hostname vom Admin (nicht die alte VPN-IP)
Port 3401 5432
Datenbank linetra (Shared-Dev) linetra_<slug>
SSL-Modus deaktivieren verify-full
SSL-Zertifikat / Schlüssel / CA — Dateien aus dem QGIS-Cert-ZIP
Benutzer linetra_edit persönlicher CN aus dem ZIP / /auth/me (z. B. {slug}_u_0fc67079)
Passwort Wert aus .env (LINETRA_APP_PASSWORD) vom Plugin / Admin (Mandanten-Rolle), nicht leer
  1. Feld Dienst leer lassen.
  2. Ankreuzen: Auch geometrielose Tabelle anzeigen.
  3. Optional: Nur im Schema public nachsehen.
  4. Verbindung testen → speichern.

Die mitgelieferten .qgz-Dateien speichern das Datenbankpasswort nicht. QGIS fragt es beim Öffnen ab, falls gesetzt.

Layer laden

Stammdaten (Formulare, keine Karte, org-weit):

  • organizations → persons → projects (Akteure ohne Projektfilter)
  • geo_object_kinds (Produkt-Stamm, Value Relations)
  • optional: ref_project_status (Status-Dropdown)

Karte (projektbezogen): Layer mit project_id — siehe Karte nach Projekt filtern.

Formularansicht

  1. Layer → Attributtabelle → Formularansicht (unten rechts).
  2. Styles ggf. aus der DB laden (layer_styles).