AndreasTharangandClaude Sonnet 5
ab416fb34c
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>
2.1 KiB
2.1 KiB
Dokumentation – Wegweiser
| Ordner | Charakter | Wann lesen |
|---|---|---|
status/STATUS.md |
lebend, kurz | immer zuerst – aktueller Stand, Baustellen |
architektur/modulkarte.md |
lebend | vor dem Lesen von Code: welche Datei, wie groß |
architektur/schnittstellen.md |
lebend | vor Änderungen an sn_basis, Projektvariablen, Docks, Release |
wissen/fallstricke.md |
lebend | bei Überraschungen; vor Arbeiten an WFS, Release, Qt |
wissen/glossar.md |
lebend | Fachbegriffe |
wissen/externe_dienste.md |
lebend | URLs, Abhängigkeiten |
entscheidungen/ |
append-only (ADR) | warum etwas so ist; neue Entscheidung = neue Datei |
leitfaden/03_arbeitsweise.md |
stabil | Einstieg für Entwickler, Arbeitszyklus, Checklisten |
leitfaden/04_werkzeuge_einrichten.md |
stabil | Einrichtung: Claude Code als CLI und in VS Code; von null zur ersten Aufgabe |
leitfaden/05_git_arbeitsweise.md |
verbindlich | Branches, Fix-Einstieg, Rückführung, Tags, was der Agent darf |
leitfaden/06_tests.md |
verbindlich | Testebenen, Testpflicht, Katalog, wie man Tests fachlich beurteilt |
tests/testkatalog.md |
generiert | was die Suite prüft – erzeugt von scripts/testkatalog.py |
tests/*.md |
lebend | Testkonzepte je Fachablauf, mit Mermaid; Vorlage in vorlagen/ |
konzept/07_qgis_tests_plan.md |
Vorschlag | Stufenplan für Tests gegen echtes QGIS |
konzept/08_repo_einrichten.md |
Prüfliste | Repo auf Gitea anlegen, stable und Branch-Schutz |
konzept/02_zusammenarbeit_ki_agenten.md |
stabil | Begründung und Aufbau der Zusammenarbeit |
analyse/01_projektanalyse.md |
Momentaufnahme 09/2026 | Zusammenspiel der Komponenten, Qualitätsbefund, Risiken |
analyse/00_* |
Momentaufnahme 09/2026 | Gesamtüberblick, Vergleich Alternativansatz (Vorarbeiten) |
vorlagen/ |
Vorlagen | Issue, PR, Übergabe, Testkonzept, Repo-AGENTS.md, CI-Workflow |
Regel: Lebende Dokumente werden mit jeder Änderung gepflegt, Momentaufnahmen nicht nachträglich geändert (neue Analyse = neue Datei mit Datum).