scripts/testkatalog.py schreibt jetzt zusaetzlich zu testkatalog.md ein
eigenstaendiges, lokal oeffenbares HTML-Dashboard (docs/tests/testkatalog.html):
je Testdatei ein Mermaid-Baumdiagramm Datei -> Testgruppe -> Testfall,
Statusfarbe aus der Baseline, plus Filter (rot/uebersprungen/schwach
beschrieben) und Volltextsuche. Generiert direkt aus denselben
Paketkatalog-Dataclasses wie der Markdown-Katalog, kein zweiter Parse-Schritt.
--pruefen prueft jetzt beide Dateien; --ohne-html erzeugt/prueft nur die
Markdown-Datei; --html-ausgabe setzt ein anderes Ziel. Mermaid laedt von
cdnjs.cloudflare.com (Fallstrick dokumentiert: ohne Internetverbindung bleiben
nur die Diagramme leer).
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Bisher gab es keinen Platz fuer rein fachliche Ablaufbeschreibungen
unabhaengig von Tests: docs/ ist projektuebergreifendes Wissen,
docs/tests/ ist testkonzept-gebunden. projekte/<paket>/ablaeufe/
schliesst diese Luecke, gegliedert nach Plugin-Paketname wie in
workspace.toml.
Erster Eintrag: projekte/sn_verfahrensgebiet/ablaeufe/alkis-laden.md,
uebernommen aus Plugin_SN_Verfahrensgebiet/docs/aus_alkis_laden.md
(dort entstanden, bevor es dieses Wissensrepo gab).
scripts/pruefe_umlaute.py findet String-Inhalte und Kommentare mit
Leerzeichen, die einen bekannten ASCII-Wortstamm statt Umlaut/ss enthalten
(gueltig, verfuegbar, fuer, ueber, ...). Technische Bezeichner ohne
Leerzeichen (aktion-Codes, Variablen-Keys, WFS-Feldnamen) werden von der
Heuristik nicht erfasst. Aktuell ueber den gesamten Workspace grün.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MneDjzrjmbpQt8udFYxN9e
hallo.py, setup_workspace.py und link_qgis_profile.py gingen bisher fest
davon aus, dass die Repos aus workspace.toml direkte Unterordner von
Projektwissen sind. Eine optionale, nicht versionierte workspace.local.toml
mit [workspace] repos_root = "..." kann das jetzt lokal ueberschreiben, z. B.
wenn die Klone zusaetzlich unter einem separaten src-Ordner liegen und von
dort in mehrere QGIS-Profile verlinkt werden. Ohne diese Datei bleibt das
Verhalten fuer alle unveraendert.
Atomare Markdown-Wissensdateien je Objektart/Datentyp (Beschreibung, Attribute,
Codelisten, Bildungsregeln, Konsistenzbedingungen, Relationen inkl. Gegenrolle),
maschinell erzeugt aus den ADV-Katalog-XML unter referenz/alkis/ (unversioniert).
Zwei getrennte Baeume, weil operativ noch GID6 laeuft und GID7 erst der Zielstand
ist: docs/wissen/alkis/gid6/ (189 Klassen, WFS-Produktivstand, fuer Plugin-Code
massgeblich) und docs/wissen/alkis/gid7/ (209 Klassen, kuenftige Umstellung).
Vererbung wird nicht in jede Datei hineinkopiert (Drift-/Tokenrisiko), sondern per
Inline-Hinweis auf die Oberklasse referenziert plus on-demand ueber
_werkzeuge/parse_alkis.py resolve aufgeloest; ein diff-Modus vergleicht eine
Klasse zwischen beiden Versionen. alkis_objektarten.md verweist jetzt auf beide
Versionsbaeume.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Neu in docs/wissen: wfs_dienste.md (ALKIS-WFS-Endpunkte der saechsischen
Dienste, erprobte Anfragen je Objektart, die vom WAF blockierten
Normfaelle) und alkis_objektarten.md (die von sn_verfahrensgebiet
genutzten AAA-Objektarten mit Attributen, Filterkonventionen und den
FlurbG-Werten von artderfestlegung).
Neu in docs/konzept: 09_alkis7_umstellung.md - Vergleich ALKIS 6 (GID 6.0)
gegen ALKIS 7 (GID 7.1) und die konkrete Anpassungsliste fuer
sn_verfahrensgebiet (fest verdrahteter NAS-Namespace, abgeflachte
WFS-Feldnamen, Codelisten, Tests). Als offene Baustelle 14 in STATUS.md
verlinkt.
Quellmaterial (OK-AAA 7.1.2, ALKIS-FSK 2.1.0, EA-Modellexporte, ~180 MB)
liegt lokal unter referenz/ und wird per .gitignore nicht versioniert;
Herkunft ist in alkis_objektarten.md dokumentiert.
Querverweise aus externe_dienste.md, fallstricke.md, docs/README.md
ergaenzt; Glossar um NAS, ZUSO/REO, OK-AAA erweitert.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NqvdHqySjQMVowB3G3Vf3U
Zwischen Schritt 3 und 4 der README steht jetzt ein eigener Schritt, der
Claude Code per npm installiert und den Workspace-Ordner AG_QGIS in den
PATH aufnimmt (PowerShell für Windows, export fuer Linux/macOS). Ohne
beides laesst sich der KI-gestuetzte Arbeitsablauf nicht nutzen.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NqvdHqySjQMVowB3G3Vf3U
Gitea fragt den Standardbranch schon beim Anlegen ab, nicht erst beim
ersten Push. Mit Begruendung und dem Abgleich zu den bestehenden Repos:
acht Code-Repos stehen auf unstable, main nur die drei ohne Kanalmodell.
Das Repository wird oeffentlich. Der technische Befund (fest verdrahtete
Pfade in .vscode/) steht auch ohne den Windows-Benutzernamen einer
konkreten Person.
Gitea ordnet Commits ueber die E-Mail-Adresse dem Benutzerkonto zu. Passt
sie nicht, erscheinen Commits ohne Zuordnung, und nachtraeglich laesst sich
das nur durch Umschreiben der Historie korrigieren.
- 04_werkzeuge_einrichten.md: Einrichtung mit Begruendung, Hinweis auf
--local fuer privat mitgenutzte Rechner, Punkt in der Pruefliste.
- 08_repo_einrichten.md: Pruefschritt vor dem Push praezisiert.
- fallstricke.md: Eintrag unter Umgebung und Werkzeuge.
Erster Stand des Repositories AG_QGIS/Projektwissen (bisher Arbeitstitel
"Workspace", ADR 0006). Der lokale Ordner heisst weiter AG_QGIS, weil darin
auch die Plugin-Klone liegen.
Git verbindlich (ADR 0007), aus dem bisherigen Wiki-Konzept entwickelt:
- docs/leitfaden/05_git_arbeitsweise.md mit Kanal-Kette, Branch-Namen und
Gitea-Branch-Schutz.
- Der Einstiegspunkt eines Fixes richtet sich nach dem Kanal, in dem der
Fehler sitzt; ein Fix an testing oder stable ist erst mit der
Rueckfuehrung nach unten abgeschlossen. Das fehlte bisher.
- Der stabile Kanal heisst stable, nicht main: der Release-Workflow in
Repository:hidden/workflows fuehrt git checkout "$CHANNEL" aus, der
Branchname muss also dem Kanalnamen entsprechen. Er existiert in keinem
Plugin-Repo und ist vom Maintainer anzulegen.
- Der Mensch drueckt ab: .claude/settings.json sperrt push, merge, tag.
- scripts/hallo.py und /hallo holen den Stand aller Klone, per
Fast-Forward wo gefahrlos; nie mergen, stashen oder verwerfen.
Ticketzugriff:
- scripts/gitea.py liest Issues, Kommentare und PRs ueber die oeffentliche
API, ohne Token, nur GET. Schreibendes nur als Entwurf in entwuerfe/.
- Skill sn-ticket.
Tests (ADR 0009):
- docs/leitfaden/06_tests.md: Testebenen, Testpflicht, und wie eine
Fachperson beurteilt, ob Tests fachlich sinnvoll sind.
- scripts/testkatalog.py erzeugt docs/tests/testkatalog.md per ast-Parsing,
ohne Import und ohne QGIS. Befund: nur 100 von 332 Tests haben einen
Docstring, sn_basis keinen einzigen von 87.
- Vorlage und erste Testkonzept-Seite mit Mermaid. Dabei gefunden und gegen
origin geprueft: _ermittle_gebietstyp_aus_fbschl hat keinen Test, obwohl
PR #44/#45 genau diese Funktion tolerant gemacht hat.
- docs/konzept/07_qgis_tests_plan.md: Stufenplan fuer Tests gegen echtes
QGIS. Dabei aufgefallen: QGIS 3.40 ist seit Januar 2026 End of Life,
qgis_min steht aber noch darauf.
Werkzeuge (ADR 0008):
- 04_werkzeuge_einrichten.md nur noch Claude Code als CLI und in VS Code.
- .vscode/ entfernt, brauchbare Einstellungen als persoenliche Vorlage.
Ausserdem: README als Einstieg neu aufgebaut, Mermaid-Diagramm in
schnittstellen.md repariert (unmaskierte Klammern, rendert seither nicht).
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Daniel
22ottomi
AndreasTharang