Technischer Rahmen
- Status
- Pausiert
- Laufzeit
- 2026-07-20 – 2026-09-18
- Aufwand
- 44 MT
- Veröffentlicht
- 2026-09-18 11:16
- Fortschritt
- 90 %
- Offene Issues
- 0
- Akzeptierte Restrisiken
- 7 / 7
- Fehlgeschlagene Testläufe
- 0
Pausiert · 90 %
Kfz-Kennzeichenregister Deutschland
Kennzeichen- und Verwaltungsdatenbank mit 694 regulären/Landes-Datensätzen, 10 Sonderkennzeichen, 16 Bundesländern, Orts-/PLZ-Suche, Detailseiten, PWA/Offline-Bestand und eigener Bludit-Administration.
20Anforderungen
14Testfälle
14bestandene Testläufe
10Projektaufgaben
7Risiken bewertet
5Artefakte
Stack
Der Bludit-Core bleibt für Projekterweiterungen unverändert. Fachlogik und Darstellung liegen in Plugins und Themes.
Projektziele
Was das Projekt erreichen soll
Vollständiges Kennzeichenregister bereitstellen
Deutsche Kfz-Kennzeichen inklusive Verwaltungsbezug, Gemeinden/Ortsteilen, Historie und Quellen strukturiert recherchierbar machen.
Abnahmekriterien
Register enthält 694 reguläre/Landes-Datensätze und 10 Sonderkennzeichen.
Alle 16 Bundesländer sind abgedeckt.
Detailseiten führen Herkunft, Verwaltungs- und Ortsdaten nachvollziehbar zusammen.
Schnelle Recherche ermöglichen
Nutzer sollen Kennzeichen ebenso über Orte und Postleitzahlen finden können.
Abnahmekriterien
Suche reagiert auf Kürzel, Herkunft, Gemeinden, Ortsteile und PLZ.
A–Z, Bundesländer und Sonderkennzeichen sind separat browsbar.
Offline-Nutzung ermöglichen
Der umfangreiche Registerbestand soll auf Wunsch vollständig lokal im Browser nutzbar sein.
Abnahmekriterien
Service Worker ist aktiv.
Datenbestand kann lokal gecacht werden.
Datenrevision invalidiert veraltete Caches nach Änderungen.
Datenpflege in Bludit integrieren
Korrekturen und Erweiterungen sollen ohne direkte Dateibearbeitung im Webspace möglich sein.
Abnahmekriterien
Adminsuche, JSON-Bearbeitung, Neuanlage, Import, Export und Reset sind vorhanden.
Eigene Änderungen liegen updatefest im Workspace.
Bludit-Core unangetastet lassen
Kennzeichen-Fachlogik soll vollständig über Plugin und Theme integriert werden.
Abnahmekriterien
bl-kernel bleibt unverändert.
Öffentliche Routen, Sitemap, PWA und Administration werden ausschließlich über Erweiterungspunkte umgesetzt.
User Stories
Fachlicher Nutzen
Kennzeichen direkt finden
Als Besucher möchte ich ein Kürzel eingeben und sofort den passenden Datensatz öffnen, ich Herkunft und Verwaltungsbezug schnell nachschlagen kann.
Über Ortsnamen suchen
Als Besucher möchte ich nach Gemeinde, Ortsteil oder PLZ suchen, ich auch ohne bekanntes Kennzeichen den zuständigen Datensatz finde.
Register strukturiert browsen
Als Besucher möchte ich A–Z, Bundesländer und Sonderkennzeichen öffnen, ich den Bestand auch ohne konkrete Suchanfrage erkunden kann.
Register offline mitnehmen
Als Nutzer möchte ich den Vollbestand lokal speichern, die Informationen auch ohne Netzverbindung verfügbar bleiben.
Daten im CMS korrigieren
Als Administrator möchte ich Datensätze direkt im Bludit-Backend pflegen, keine manuelle Dateibearbeitung auf dem Webspace nötig ist.
Korrekturen updatefest halten
Als Administrator möchte ich eigene Änderungen außerhalb der Plugin-Basis speichern, Plugin-Updates meine Datenkorrekturen nicht überschreiben.
Detailseiten verlinken
Als Redakteur möchte ich auf eine stabile Kennzeichen-URL verweisen, ein einzelner Datensatz direkt geteilt und indexiert werden kann.
Use Cases
Zentrale Abläufe
UC-001Kennzeichen suchen
Akteur: Besucher
Standardablauf
1. Suchfeld öffnen.
2. Kürzel, Ort oder PLZ eingeben.
3. Treffer auswählen.
4. Detailinformationen lesen.
Alternativen / Fehlerfälle
Keine Treffer: verständliche Leermeldung anzeigen.
UC-002Register durchstöbern
Akteur: Besucher
Standardablauf
1. A–Z, Bundesländer oder Sonderkennzeichen wählen.
2. Gruppe öffnen.
3. Kennzeichen auswählen.
Alternativen / Fehlerfälle
Fehlende optionale Gruppe: Oberfläche bleibt bedienbar.
UC-003Offline-Bestand installieren
Akteur: Besucher
Standardablauf
1. App installieren.
2. Offline-Bestand anfordern.
3. Cacheaufbau abwarten.
4. Verbindung trennen und Register öffnen.
Alternativen / Fehlerfälle
Speicher reicht nicht: Installation wird abgebrochen, Online-Nutzung bleibt möglich.
UC-004Kennzeichendaten bearbeiten
Akteur: Administrator
Standardablauf
1. Kennzeichenregister im Backend öffnen.
2. Datensatz suchen.
3. JSON bearbeiten.
4. Validieren und speichern.
5. Frontend prüfen.
Alternativen / Fehlerfälle
Ungültiges JSON: Speichern wird mit Fehlermeldung verhindert.
UC-005Datensatz importieren/exportieren
Akteur: Administrator
Standardablauf
1. Datensatz exportieren.
2. JSON extern bearbeiten.
3. Import auswählen.
4. Validierung bestätigen.
Alternativen / Fehlerfälle
Fehlerhafte Struktur: Import wird abgewiesen.
UC-006Override zurücksetzen
Akteur: Administrator
Standardablauf
1. Datensatz öffnen.
2. Reset wählen.
3. Bestätigen.
4. Basisdatensatz prüfen.
Alternativen / Fehlerfälle
Kein Override: Reset ist wirkungslos und beschädigt Basis nicht.
Requirements Engineering
Anforderungsbaseline
USR 8SYS 6SEC 3SRS 3
| ID | Typ | Anforderung | Status | Review |
|---|---|---|---|---|
| USR-001 | USR | Kennzeichen über Kürzel suchenBesucher müssen ein Kennzeichen direkt über sein Kürzel finden können. | Getestet | Geprüft & Freigegeben |
| USR-002 | USR | Orte und Postleitzahlen durchsuchenBesucher müssen Datensätze über Herkunft, Gemeinde, Ortsteil und PLZ finden können. | Getestet | Geprüft & Freigegeben |
| USR-003 | USR | Register A–Z durchsuchenAlle regulären Kennzeichen müssen alphabetisch browsbar sein. | Getestet | Geprüft & Freigegeben |
| USR-004 | USR | Nach Bundesland filternKennzeichen müssen nach den 16 Bundesländern gegliedert darstellbar sein. | Getestet | Geprüft & Freigegeben |
| USR-005 | USR | Sonderkennzeichen anzeigenSonderkennzeichen müssen getrennt vom regulären Register abrufbar sein. | Getestet | Geprüft & Freigegeben |
| USR-006 | USR | Kennzeichendetail teilenJeder Datensatz muss über eine stabile URL wie /kennzeichen/ME erreichbar sein. | Getestet | Geprüft & Freigegeben |
| USR-007 | USR | Vollbestand offline nutzenNutzer müssen den Registerbestand als PWA lokal speichern können. | Getestet | Geprüft & Freigegeben |
| USR-008 | USR | Daten im Backend pflegenAdministratoren müssen Kennzeichendaten ohne direkten Dateizugriff bearbeiten können. | Getestet | Geprüft & Freigegeben |
| SYS-001 | SYS | Vollständige Katalogdaten bereitstellenDas System muss 694 reguläre/Landes-Datensätze, 10 Sonderkennzeichen und 16 Bundesländer verarbeiten. | Getestet | Geprüft & Freigegeben |
| SYS-002 | SYS | Detaildaten dateibasiert ladenKennzeichendetails müssen aus separaten JSON-Dateien effizient nachgeladen werden. | Getestet | Geprüft & Freigegeben |
| SYS-003 | SYS | Suchindex für große Datenmenge verwendenSuche muss einen vorberechneten Index statt vollständiger Dateiscans pro Anfrage verwenden. | Getestet | Geprüft & Freigegeben |
| SYS-004 | SYS | Workspace-Overrides priorisierenEigene Datenkorrekturen müssen die Plugin-Basis überlagern, ohne Originaldateien zu verändern. | Getestet | Geprüft & Freigegeben |
| SYS-005 | SYS | Import, Export und Reset anbietenDie Administration muss JSON-Import, Export und Rücksetzen auf den Basisdatensatz unterstützen. | Getestet | Geprüft & Freigegeben |
| SYS-006 | SYS | Kennzeichen-Sitemap erzeugenÖffentliche Kennzeichendetailseiten müssen in einer separaten XML-Sitemap auffindbar sein. | Getestet | Geprüft & Freigegeben |
| SEC-001 | SEC | Schreibzugriffe authentifizierenDatenänderungen dürfen nur für angemeldete berechtigte Bludit-Benutzer möglich sein. | Getestet | Geprüft & Freigegeben |
| SEC-002 | SEC | Schreibvorgänge gegen CSRF schützenÄnderungsoperationen müssen die vorhandenen Bludit-Schutzmechanismen nutzen. | Getestet | Geprüft & Freigegeben |
| SEC-003 | SEC | Bludit-Core unverändert lassenDie Integration darf keine Datei in bl-kernel verändern. | Getestet | Geprüft & Freigegeben |
| SRS-001 | SRS | PWA-Datenrevision verwaltenNach Datenänderungen muss eine neue Cache-Revision ausgeliefert werden. | Getestet | Geprüft & Freigegeben |
| SRS-002 | SRS | Frontend fehlertolerant rendernFehlende optionale DOM-Bereiche dürfen keinen kompletten Registerabbruch verursachen. | Getestet | Geprüft & Freigegeben |
| SRS-003 | SRS | Responsive und zugänglich darstellenSuche, Register und Detailseiten müssen auf Desktop und Mobilgeräten bedienbar bleiben. | Getestet | Geprüft & Freigegeben |
Verification
Tests & Nachweise
14Testfälle
14Testläufe
14Passed
0Failed
| Test | Zweck | verifiziert | Status |
|---|---|---|---|
| TC-001 | Kürzelsuche MEME wird gefunden und die Detailseite ist erreichbar. | USR-001USR-006 | Bestanden |
| TC-002 | Ortssuche HildenPassende Datensätze, darunter ME, werden gefunden. | USR-002SYS-003 | Bestanden |
| TC-003 | PLZ-Suche 40822Kennzeichen mit passender Orts-/PLZ-Zuordnung werden gefunden. | USR-002SYS-003 | Bestanden |
| TC-004 | A–Z-Register ladenKatalog wird ohne JavaScript-Fehler angezeigt. | USR-003SRS-002 | Bestanden |
| TC-005 | BundesländeransichtBundeslandfilter zeigt passende Kennzeichen. | USR-004 | Bestanden |
| TC-006 | SonderkennzeichenSonderkennzeichen werden separat und fehlerfrei geladen. | USR-005SYS-002 | Bestanden |
| TC-007 | Direktlink KennzeichenServerseitig geroutete Detailseite wird vollständig gerendert. | USR-006 | Bestanden |
| TC-008 | Offline-InstallationRegister bleibt nach erfolgreicher Installation offline nutzbar. | USR-007SRS-001 | Bestanden |
| TC-009 | Admin-Datensatz ändernÄnderung landet im Workspace und ist im Frontend sichtbar. | USR-008SYS-004SEC-001SEC-002 | Bestanden |
| TC-010 | JSON Export/ImportImport validiert und aktualisiert den Override-Datensatz. | SYS-005 | Bestanden |
| TC-011 | Reset auf BasisOriginaldatensatz aus Plugin-Basis wird wieder verwendet. | SYS-004SYS-005 | Bestanden |
| TC-012 | Sitemap prüfenXML ist gültig und enthält Detail-URLs. | SYS-006 | Bestanden |
| TC-013 | Core-IntegritätKeine Core-Datei ist verändert. | SEC-003 | Bestanden |
| TC-014 | Responsive RegisteransichtBedienelemente bleiben nutzbar und Inhalte lesbar. | SRS-003 | Bestanden |
Projektplan
Work Breakdown Structure
1.0
Projektstart & Datenmodell2026-07-20 – 2026-07-24
Scope, Datenstruktur, Quellenfelder und technische Architektur festlegen.
100%
2.0
Basisdaten aufbereiten2026-07-23 – 2026-08-05
Kennzeichenkatalog, Bundesländer, Sonderkennzeichen und Metadaten normalisieren.
100%
3.0
Detaildaten & Ortszuordnung2026-07-27 – 2026-08-21
Gemeinden, Ortsteile, PLZ, Historie und Quellen in Detaildatensätze überführen und validieren.
100%
4.0
Suchindex & Kataloglogik2026-08-10 – 2026-08-28
Catalog, Code-Map und Suchindex aufbauen und performant ausliefern.
100%
5.0
Register-Frontend & Detailseiten2026-08-17 – 2026-09-02
Suche, A–Z, Bundesländer, Sonderkennzeichen und Detaildarstellung responsiv umsetzen.
100%
6.0
PWA & Offline-Bestand2026-08-31 – 2026-09-07
Manifest, Service Worker, Daten-Cache und Offline-Installation umsetzen.
100%
7.0
Bludit-Plugin & Routing2026-09-03 – 2026-09-11
Datenendpunkte, Detailrouting, Sitemap und Workspace-Speicher in Bludit integrieren.
100%
8.0
Bludit-Theme2026-09-08 – 2026-09-14
Kennzeichen-Webseite als eigenständiges Bludit-Theme mit Info- und Datenseiten integrieren.
100%
9.0
Administration & Datenpflege2026-09-10 – 2026-09-16
Adminsuche, Bearbeitung, Neuanlage, JSON-Import/-Export, Reset und Overrides umsetzen.
100%
10.0
Systemtest, Fehlerkorrektur & Release2026-09-15 – 2026-09-18
Browser-, Daten-, PWA- und Administrationsprüfungen durchführen und Release 1.0.1 abschließen.
100%
Risk Management
Risiken und Restrisiken
RISK-001Initial 9 → Rest 2
Großer Offline-Datenbestand
Offline-Cache schlägt auf Geräten mit wenig Speicher fehl.
Maßnahmen
Optionale Offline-Installation, transparente Größenangabe und versionsgebundener Cache.
AkzeptiertRestrisiko akzeptiert
RISK-002Initial 12 → Rest 3
Inkonsistente Ortszuordnungen
Suche oder Detailseite zeigt unvollständige Zuordnung.
Maßnahmen
Strukturierte Quellenfelder, Validierung, Stichprobentests und getrennte Detaildateien.
AkzeptiertRestrisiko akzeptiert
RISK-003Initial 15 → Rest 3
Datenverlust bei Plugin-Update
Eigene Korrekturen gehen bei Update verloren.
Maßnahmen
Workspace-Overrides außerhalb des Plugin-Verzeichnisses.
AkzeptiertRestrisiko akzeptiert
RISK-004Initial 10 → Rest 4
Unberechtigte Datenänderung
Daten werden manipuliert.
Maßnahmen
Bludit-Authentifizierung, Rollenprüfung und CSRF-Schutz auf Schreiboperationen.
AkzeptiertRestrisiko akzeptiert
RISK-005Initial 9 → Rest 2
Veralteter PWA-Cache
Frontend zeigt nach Korrektur alte Werte.
Maßnahmen
Datenrevision wird in Cache-/Service-Worker-Version übernommen.
AkzeptiertRestrisiko akzeptiert
RISK-006Initial 6 → Rest 2
Frontend-Abbruch durch fehlendes DOM-Element
Registeransicht bricht beim Umschalten ab.
Maßnahmen
Robuste Elementauflösung und Regressionstest für A–Z/Bundesländer/Sonderkennzeichen.
AkzeptiertRestrisiko akzeptiert
RISK-007Initial 8 → Rest 2
Abhängigkeit von Core-Hacks
CMS-Update überschreibt Projektanpassungen.
Maßnahmen
Fachlogik ausschließlich über Plugin, Theme und Workspace; Core-Integritätstest.
AkzeptiertRestrisiko akzeptiert
System Inventory
Assets
Kennzeichen-Basisdaten
694 reguläre/Landes-Datensätze plus Sonderkennzeichen und Metadaten.
Detaildatenbestand
704 Detail-JSON-Dateien mit Verwaltungs-, Orts-, Historien- und Quellenangaben.
Suchindex
Vorberechneter Suchindex für Kürzel, Herkunft, Orte und PLZ.
MD Kennzeichenregister Plugin
Bludit-Fachlogik, Routing, Datenendpunkte, Administration und Workspace-Overrides.
MD Kennzeichen Theme
Öffentliche Register- und Detaildarstellung.
Service Worker
PWA- und Offline-Caching inklusive Datenrevision.
Bludit 3.22.0
Unveränderter CMS-Core für Benutzer, Sessions, Plugin- und Theme-System.
Workspace Overrides
Updatefeste eigene Korrekturen unter bl-content/workspaces.
Kennzeichen-Sitemap
XML-Sitemap der öffentlich erreichbaren Kennzeichendetails.
Software Supply Chain
SBOM
| Komponente | Version | Supplier | Lizenz | Scope |
|---|---|---|---|---|
| BluditFlat-File CMS / unveränderte Projektbasis. | 3.22.0 | Bludit | MIT | required |
| MD KennzeichenregisterPlugin für Daten, Routing, PWA, Sitemap und Administration. | 1.0.1 | MD | MIT | required |
| MD Kennzeichen ThemeÖffentliche Register- und Detailoberfläche. | 1.0.1 | MD | MIT | required |
| PHPServerseitige Plugin- und Routing-Laufzeit. | 8.x | PHP Group | PHP License | required |
| JavaScriptSuche, UI-Zustände und PWA-Clientlogik. | ES6+ | ECMAScript | required | |
| Service Worker APIOffline- und Cache-Management. | Browser API | W3C / Browser | required | |
| Cache APILokale Speicherung des Registerbestands. | Browser API | W3C / Browser | required | |
| JSON DatenbasisKatalog, Suchindex, Code-Map und 704 Detaildatensätze. | Schema 5.1-gn250-full-join | Projekt | required | |
| Python Build ToolErzeugung und Validierung der Webdaten. | 3.x | Python Software Foundation | PSF | development |
| HTML5/CSS3Semantische und responsive Frontenddarstellung. | Web Standards | WHATWG/W3C | required |
ISO 14001 / Lebenszyklus
Umweltaspekte
Serverbetrieb / Hosting
Webseite und Datenendpunkte benötigen Hostingressourcen.
Maßnahmen
Flat-File-Architektur, statische JSON-Daten, vorberechnete Suchindizes und Browser-Caching nutzen.
Offline-Datenpaket
Der vollständige Offline-Bestand verursacht einmalig eine größere Datenübertragung.
Maßnahmen
Offline-Installation bleibt optional; Daten werden lokal wiederverwendet und nur revisionsabhängig erneuert.
Lokaler PWA-Cache
Offline-Nutzung belegt lokalen Gerätespeicher.
Maßnahmen
Größe transparent kommunizieren und Cache über Browsermechanismen löschbar halten.
Updatefeste Datenhaltung
Unnötige Neuübertragung kompletter Datenbestände soll vermieden werden.
Maßnahmen
Workspace-Overrides und getrennte Basisdaten reduzieren Vollersetzungen bei kleinen Korrekturen.
Wiederverwendbare CMS-Basis
Eigene Core-Forks erhöhen langfristig Wartungs- und Updateaufwand.
Maßnahmen
Bludit-Core unverändert lassen und Funktionen modular über Plugin/Theme kapseln.
Nachweise & Downloads
Öffentliche Artefakte
ProjektübersichtArchitektur · 1.0.1Visualisierte Projektübersicht mit Datenumfang, Architektur und Laufzeit.ProjektdokumentationDokumentation · 1.0.1Projektziele, Datenumfang, Kernfunktionen und technische Architektur.Requirements BaselineRequirements · 1.0.1Export der freigegebenen Anforderungsbaseline.SysteminventarInventar · 1.0.1Maschinenlesbarer Überblick über Datenumfang, Routen und Architektur.SBOMSBOM · 1.0.1CycloneDX-artige Komponentenübersicht des Projekts.