# ALKIS-Objektartenkatalog — Versionsüberblick

Dieser Ordner enthält den vollständigen ALKIS-Objektartenkatalog (AAA-Anwendungsschema) in zwei
Versionen, je als Baum aus atomaren Markdown-Wissensdateien (eine je Objektart/Datentyp).

| Version | Ordner | Bedeutung | Katalog-Stand |
|---|---|---|---|
| GID6 | [`gid6/INDEX.md`](gid6/INDEX.md) | **Aktueller Produktivstand** — das, was der sächsische WFS-Dienst tatsächlich ausliefert | AAA-Anwendungsschema 6.0.1 |
| GID7 | [`gid7/INDEX.md`](gid7/INDEX.md) | **Zielstand** — künftige Umstellung | AAA-Anwendungsschema 7.1.2 |

**Für die laufende Plugin-Entwicklung (WFS-Zugriff) ist GID6 maßgeblich**, solange die Umstellung
nicht vollzogen ist. GID7 dient dem Abgleich, was sich mit der Umstellung ändert (siehe `diff`-Modus
unten) — nicht als Quelle für aktuellen Produktivcode.

## Woher die Dateien kommen

Beide Bäume sind **maschinell aus den Katalog-XML-Dateien erzeugt** (nicht von Hand gepflegt, nicht
von Hand editieren). Die Rohdaten liegen bewusst außerhalb der Versionskontrolle unter
`referenz/alkis/` (siehe `.gitignore`):

- `referenz/alkis/ALKIS-Anwendungsschema_6.0.1.xml`
- `referenz/alkis/ALKIS-Anwendungsschema_7_1_2.xml`

Neu erzeugen (überschreibt den jeweiligen Ordner vollständig):

```
python _werkzeuge/parse_alkis.py generate gid6 "AAA-Anwendungsschema 6.0.1 (Produktivstand)" ../../../referenz/alkis/ALKIS-Anwendungsschema_6.0.1.xml
python _werkzeuge/parse_alkis.py generate gid7 "AAA-Anwendungsschema 7.1.2 (Zielstand)" ../../../referenz/alkis/ALKIS-Anwendungsschema_7_1_2.xml
```

## Zwei Werkzeuge statt Duplizieren

Um Wissen nicht in vielen Dateien redundant vorzuhalten (Drift-Risiko, Tokenkosten), löst das Skript
Vererbung und Versionsunterschiede **on demand** auf, statt sie statisch in jede Datei zu kopieren:

**Vererbungskette einer Klasse auflösen** (alle effektiven Attribute/Relationen inkl. geerbter,
ohne Datei-Hopping über die Oberklassen):

```
python _werkzeuge/parse_alkis.py resolve <pfad-zur-xml> AX_Grenzpunkt
```

**Zwei Versionen für eine Klasse vergleichen** (nur die Unterschiede, berechnet statt gepflegt):

```
python _werkzeuge/parse_alkis.py diff referenz/alkis/ALKIS-Anwendungsschema_6.0.1.xml referenz/alkis/ALKIS-Anwendungsschema_7_1_2.xml AX_Grenzpunkt
```

## Siehe auch

- [`../alkis_objektarten.md`](../alkis_objektarten.md) — schlanke Praxis-Übersicht dessen, was
  `sn_verfahrensgebiet` tatsächlich aus dem (GID6-)WFS-Dienst nutzt, inkl. abweichender/abgeflachter
  Feldnamen im realen Dienst.
- [`../fallstricke.md`](../fallstricke.md), [`../glossar.md`](../glossar.md)