Systemüberblick
Status: 🚧 Dokumentation in Arbeit
Architektur-Konzept
Die p2d2-Plattform basiert auf einer modernen Web-Architektur mit folgenden Kernkomponenten:
Frontend-Architektur
- Astro Framework: Statische Seiten-Generierung und Komponenten-basierte Entwicklung
- TypeScript: Typsichere Entwicklung für bessere Code-Qualität
- TailwindCSS: Utility-first CSS Framework für konsistentes Design
- OpenLayers: Kartendarstellung und Geodaten-Visualisierung
Backend-Services
- Astro Endpoints: Server-seitige Funktionen für dynamische Inhalte
- Geodaten-Services: Integration von WMS/WMTS-Diensten
- Daten-Synchronisation: Automatisierte Aktualisierung von Kommunen-Daten
Datenmanagement
- Content Collections: Strukturierte Verwaltung von Kommunen-Daten
- Geodaten-Quellen: Integration externer Geodienste
- Lokale Storage: Browser-basierte Datenspeicherung
Systemkomponenten
Karten-Modul
- OpenLayers-basierte Kartendarstellung
- Layer-Management für verschiedene Geodaten-Quellen
- Interaktive Kartenfunktionen (Zoom, Pan, Feature-Selection)
Feature-Editor
- Geometrie-Editor für Polygone und Linien
- Integration mit OpenStreetMap
- Daten-Synchronisation mit Backend
Kommunen-Verwaltung
- Content-Collections für strukturierte Daten
- Dynamisches Routing basierend auf Kommunen-Daten
- Responsive Benutzeroberfläche
UI-Komponenten
- Wiederverwendbare Astro-Komponenten
- Konsistentes Design-System
- Mobile-optimierte Darstellung
Datenfluss
- Initialisierung: Laden der Basiskonfiguration und Kommunen-Daten
- Karten-Rendering: Aufbau der Karte mit konfigurierten Layern
- Benutzer-Interaktion: Handling von Karten-Interaktionen und Editor-Funktionen
- Daten-Persistierung: Speicherung von Benutzer-Eingaben und Konfigurationen
Technologie-Stack
| Bereich | Technologie |
|---|---|
| Framework | Astro |
| Programmiersprache | TypeScript |
| Styling | TailwindCSS |
| Karten-Engine | OpenLayers |
| Build-Tool | Vite |
| Deployment | Caddy + Systemd |
Nächste Schritte
- [ ] Detaillierte Architektur-Diagramme erstellen
- [ ] Komponenten-Interaktionen dokumentieren
- [ ] Datenfluss-Diagramme vervollständigen
- [ ] Performance-Considerations dokumentieren