Files
Projektwissen/docs/wissen/vln_sn.md
T

72 lines
4.3 KiB
Markdown
Raw Normal View History

# VLN_SN – Vorbilder und Kandidaten in der Nachbar-Organisation
Stand 25.09.2026. Die Gitea-Organisation
[`VLN_SN`](https://entwicklung.flurneuordnung-sachsen.de/VLN_SN) enthält Repositories, die für uns als Vorbild oder
als späteres Werkzeug in Frage kommen. Diese Datei hält fest, was dort liegt und unter welchen Bedingungen wir es
nutzen dürfen, damit nicht jede Sitzung neu sucht.
## Zugriff und Bedingungen
- **Nur lesen, nur öffentlich.** Die Repositories sind ohne Anmeldung über die Gitea-API lesbar, wie es auch
`scripts/gitea.py` für unsere Organisation macht. Einen abgesprochenen Lesezugriff gibt es noch nicht. Er ist
angefragt bzw. soll angefragt werden, damit nicht alles neu erfunden werden muss.
- **Nichts übernehmen, nur als Vorbild.** Bis zur Absprache wird kein Code und kein Stylesheet von dort kopiert.
Eigene Umsetzungen dürfen sich an Aufbau und Aussehen orientieren.
- **Workflow nur nach Rücksprache.** Das Workflow-System ist noch nicht produktiv. Sein MCP-Server (Anmeldung mit
Token) wird nicht angesprochen.
Nachsehen (nur lesend, Beispiel):
```bash
curl -s "https://entwicklung.flurneuordnung-sachsen.de/api/v1/orgs/VLN_SN/repos?limit=50"
curl -s "https://entwicklung.flurneuordnung-sachsen.de/api/v1/repos/VLN_SN/<Repo>/git/trees/main?recursive=1"
```
## Bestand (25.09.2026)
| Repository | Inhalt | Bedeutung für uns |
|---|---|---|
| `EA-Bilanz` | Web-Anwendung (Prototyp) für die Eingriffs- und Kompensationsbilanz: HTML, Bootstrap 5, jQuery, OpenLayers | **Vorbild für den HTML-Stil** |
| `Workflow` | Dokumentation eines Workflow-Systems: Abläufe als XML, 122 beschriebene Aufgabentypen | **Kandidat für das Fernziel**, Prozesse ablaufen zu lassen |
| `API_Karte_QGISDemo` | Python-Beispiel zu einer Karten-API | derzeit keine |
| `MeinVLN-Vorlagen`, `Bauakte`, `MeinVLN_Beteiligung` | nur README | derzeit keine |
| `MeinVLN`, `MeinVLN_Antraege`, `MeinVLN_Datenaustausch`, `MeinVLN_Videokonferenz`, `Vorerhebung`, `oFB-Zugang`, `Ministerium` | leer | derzeit keine |
## HTML-Stil (Vorbild EA-Bilanz)
Beschreibung, keine Übernahme:
- **Grundlage:** Bootstrap 5.3 und Bootstrap Icons. EA-Bilanz lädt beides von einem CDN. Wir betten es lokal ein,
weil unsere Werkzeuge offline arbeiten (Issue folgt, siehe `werkzeuge/vorschau/README.md` als Muster für eine
eingebettete Bibliothek).
- **Aufbau:** oben eine dunkle Navigationsleiste mit Titel und einer kleinen Knopfgruppe (Icon plus Beschriftung;
die Beschriftung entfällt auf schmalen Bildschirmen). Darunter ein Arbeitsbereich in voller Höhe, auf breiten
Bildschirmen zweispaltig, auf schmalen untereinander.
- **Anmutung:** hellgrauer Hintergrund (Bootstrap-Variable `--bs-tertiary-bg`), weiße Flächen, Grundschrift etwas
kleiner (0,9 rem). Karten mit farbigem linken Rand je Kategorie. Zahlen in Tabellenziffern, rechtsbündig.
- **Weiteres:** eigene Druckansicht (Navigation und Bedienelemente ausgeblendet) und Hilfe als Modal (F1 bzw.
?-Knopf, mit Suche und Bildschirmfotos).
- Die eigene CSS ist klein, fast alles kommt aus Bootstrap. Eine ähnliche Ansicht entsteht also schon durch
Bootstrap plus wenige eigene Regeln.
## Workflow (Kandidat für das Fernziel)
Fernziel der AG ist, Prozesse nicht nur zu modellieren, sondern auch ablaufen zu lassen. Das Workflow-System ist
dafür ein Kandidat:
- **Abläufe als XML:** eine Datei je Workflow-Typ mit Schritten (Tasks), sequenziell oder parallel.
- **Zustand serverseitig:** Bearbeiter werden per E-Mail-Link beteiligt.
- **Status:** `RUNNING`, `WAITING`, `COMPLETED`, `ERROR`, `CANCELLED`.
Die Aufgabentypen (`tasks/*.md`) liegen nah an Elementen unserer Prozessmodelle:
- **Genehmigen und Zuständigkeit:** `approve_reject`, `assign_group`, `person_pick`, `escalate`, `quorum`
- **Fristen und Wiedervorlage:** `frist_rechner`, `wiedervorlage`, `wait_until`, `schedule_resume`
- **Post und Nachricht:** `posteingang`, `postausgang`, `email`, `signal_fire`/`signal_wait`
- **Ablaufsteuerung:** `if`, `decision_table`, `foreach_parallel`, `loop_foreach`, `subworkflow`, `try_catch`,
`stop`, `return_to`
- **Fachlich:** viele `geo_*` (Flächen, Grenzen, Gemarkung), `pdf_*` (Stempel, Siegel, Signatur), `bauakte_*`,
`aktenzeichen_vergabe`
Eine Abbildung „BPMN-Element → Workflow-Aufgabe“ wäre der erste Schritt, sobald die Nutzung abgesprochen ist.