diff --git a/docs/README.md b/docs/README.md index e7f932a..12a169e 100644 --- a/docs/README.md +++ b/docs/README.md @@ -5,6 +5,7 @@ | `status/STATUS.md` | lebend, kurz | **immer zuerst** – aktueller Stand, Baustellen | | `wissen/fallstricke.md` | lebend | bei Überraschungen; vor Arbeiten am Konverter und am PICTURE-Import | | `wissen/glossar.md` | lebend | Fachbegriffe (Flurbereinigung, BPMN) | +| `wissen/vln_sn.md` | lebend | Vorbilder in der Organisation VLN_SN: HTML-Stil (EA-Bilanz), Workflow-System als Kandidat; Nutzungsbedingungen | | `entscheidungen/` | append-only (ADR) | warum etwas so ist; neue Entscheidung = neue Datei | | `leitfaden/03_arbeitsweise.md` | stabil | Einstieg, Arbeitszyklus, Checklisten | | `leitfaden/04_werkzeuge_einrichten.md` | stabil | Einrichtung: Claude Code als CLI und in VS Code; von null zur ersten Aufgabe | diff --git a/docs/status/STATUS.md b/docs/status/STATUS.md index c6804bd..1e2605d 100644 --- a/docs/status/STATUS.md +++ b/docs/status/STATUS.md @@ -28,6 +28,9 @@ Skills sind übernommen, alles QGIS- und Plugin-Spezifische ist entfernt. Kern i die Beispiele (Issue #12 usw.) sind erfunden und durch echte zu ersetzen, sobald es sie gibt. 5. **Umgang mit `sn-bpmn` in AG_QGIS klären.** Der Branch `BPMN-Skill` in `AG_QGIS/Projektwissen` ist durch dieses Repository abgelöst und kann dort nach Absprache gelöscht werden. +6. **Mit VLN_SN absprechen:** abgesprochener Lesezugriff auf die Repositories (damit Stil und Bausteine nicht neu + erfunden werden) und Nutzung des Workflow-Systems als Kandidat für das Fernziel „Prozesse ablaufen lassen“. Bis + dahin nur als Vorbild, siehe `docs/wissen/vln_sn.md`. ## Erledigt diff --git a/docs/wissen/vln_sn.md b/docs/wissen/vln_sn.md new file mode 100644 index 0000000..7de8c8e --- /dev/null +++ b/docs/wissen/vln_sn.md @@ -0,0 +1,71 @@ +# 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//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.