KSH-Ortsverzeichnis – Datenmodell, Aufbau und Zuordnung

Speicherung des Ortsverzeichnisses und der Adresszuordnungen, Aufbau und Zuordnungspunkte, Rechteschlüssel und die Zuordnung im Hintergrund.

Überblick

Das KSH-Ortsverzeichnis (Code, Name, Postleitzahl, Komitat, Bezirk, Region, NUTS) und die Zuordnung der Firmenadressen dazu. Das Verzeichnis nutzen die Auflösung der Komitatsnamen in KSH-Daten, der Immobilienpreisbericht (Komitat, NUTS) und die Firmenkacheln.

Datenmodell

Die Tabellennamen tragen in der Datenbank das installationseigene Präfix.

TabelleRolleHauptfelder
ksh_settlementOrtsverzeichnisCode, Name, normalisierter und ASCII-Name, Postleitzahl, Komitat, Bezirk, Region, NUTS, Status
address_kshZuordnung Adresse–OrtAdresse, Ort, Status, Punktzahl, Namens-Hash
addressAdressstamm (nur lesend)Ort

Ablauf

  1. Speichern: Der Name ist Pflicht; die Bibliothek ksh bildet einen normalisierten und einen ASCII-Namen; bei leerem Code lautet er A plus 12 Zeichen des SHA1 des normalisierten Namens.
  2. Aufbau (buildaddresses): Upsert ins Verzeichnis aus den eindeutigen Ortsnamen des Adressstamms; Komitat und NUTS werden nicht überschrieben; Rückgabe: verarbeitet, neu, aktualisiert, unvollständig.
  3. Zuordnung (match): info=1 liefert eine Übersicht, die Verarbeitung läuft in Stapeln zu 200 (start, limit). Nach dem normalisierten Ortsnamen: Treffer mit NUTS Status 1 (Punktzahl 100), ohne NUTS Status 2 (70), kein Treffer Status 4 (0); Upsert in address_ksh.
  4. Unvollständige Zeile: leeres Komitat oder NUTS; die Anzahl steht im Listenkopf.

Berechtigungen

  • list (Inhaltsbereich: Regeln ksh_settlement / ksh_settlement_id), edit (Formular), Speichern canSave(), status, delete, build, match, debug (letztes SQL der Liste).

Hintergrundaufgabe

Der Einstieg cron/kshmatch führt dieselbe Zuordnung in Stapeln zu 500 aus. Er ist ein direkter Einstieg, kein Element der zentralen Warteschlange; eine Authentifizierungsprüfung ist im Controller nicht erkennbar.

Bekannte Einschränkungen

  • Das Löschen ist physisch, ohne Prüfung der Zuordnungen in address_ksh.
  • Für den Schlüssel statusdelete gibt es keinen Endpunkt.
  • Die ungarische Feldbeschriftung lautet „Kiegyenlítés“ und der deutsche Menüpunkt „Abrechnungen“ — Übersetzungsfehler; das Feld enthält den Ortsnamen.