Orte / Postleitzahlen (GeoLocalities)
Zweck
GeoLocality ist ein PLZ-/Ort-Stammdatensatz mit Verknuepfung zu einem Bundesland. Pro Eintrag werden postalCode, name (Ort), countryCode (ISO-Land-Code), municipalityKey (AGS) und Koordinaten gepflegt. Stammdaten werden typisch durch Sync-Jobs gepflegt — die Form-Felder sind read-only.
GeoLocalities werden bei der Adress-Erfassung in Standorten, Kunden, Lieferanten und Mitarbeitern als Auto-Vervollstaendigungs-Quelle verwendet — PLZ → Ort → Bundesland.
Voraussetzungen
Berechtigungen (CASL)
| Action | Subject | Wirkung | Keycloak-Rolle |
|---|---|---|---|
view | FE_GeoLocality, GeoLocality | Liste/Detail aufrufbar | — |
create/update/delete | GeoLocality | Pflegen (typisch Sync) | APP_SPEAMCORE_CREATE/UPDATE/DELETE_GEO_LOCALITY |
Schritt-für-Schritt-Anleitung
- Orte (
/geo-localities) — Volltextsuche aufpostalCode,name. - Detail zeigt PLZ, Ort, Land, Gemeindeschluessel und Koordinaten.
Toolbar (Detail-Seite)
Schlanke Toolbar oben rechts:
| Icon | Aktion (aria-label) | CASL | Wirkung |
|---|---|---|---|
| ← | Zurückgehen | — | Zurück zur Liste. |
| 🏠 | Zur Startseite gehen | — | Springt auf das Dashboard / /. |
| ⏮/◀/▶/⏭ | Pagination | — | Navigation durch die gefilterte Liste — Massen-Bearbeitung ohne Liste-Sprung. |
Globale Floating-Drawer (links)
Wie auf jeder Detail-Seite verfuegbar — siehe Floating-Quickbar:
- KAL. (Mini-Kalender)
- ZEIT (Persoenliche Wochen-Arbeitszeit)
- ARBEIT (Eigene bevorstehende Aufträge)
Felder und Eingaben
| Feldname | Pflicht | Datentyp | Wirkung beim Ausfuellen | Voraussetzung |
|---|---|---|---|---|
geoStateId | ja | UUID | Verweis auf Bundesland. | — |
countryCode | ja (read-only) | String (ISO 2) | Land-Code. | — |
postalCode | ja (read-only) | String | Postleitzahl. | — |
name | ja (read-only) | String | Ortsname. | — |
municipalityKey | nein (read-only) | String | AGS (Amtlicher Gemeindeschluessel). | — |
latitude, longitude | nein (read-only) | Decimal | Koordinaten. | — |
Wiederverwendbare Konzepte
Verknuepfungen zu anderen Modulen
- Standorte, Kunden, Lieferanten, Mitarbeiter — Adress-Auto-Vervollstaendigung.
- Bundeslaender —
GeoLocality.geoStateIdreferenziert einen State.
API/Schnittstellen
| Methode | Endpoint | Zweck | CASL |
|---|---|---|---|
GET | /api/geo-localities | Liste (volltext-suchbar) | view GeoLocality |
POST | /api/geo-localities | Anlegen | create GeoLocality |
GET | /api/geo-localities/:id | Detail | view GeoLocality |
PATCH | /api/geo-localities/:id | Ändern | update GeoLocality |
DELETE | /api/geo-localities/:id | Soft-Delete | delete GeoLocality |
Versionshinweise
- 2026-04-30: Initiale Veroeffentlichung.