diff --git a/config/appVersion.js b/config/appVersion.js index 3514beb22..7c11bb63f 100644 --- a/config/appVersion.js +++ b/config/appVersion.js @@ -1,2 +1,2 @@ // /config/appVersion -export const APP_VERSION = "1.1.196"; +export const APP_VERSION = "1.1.197"; diff --git a/docs/components/README.md b/docs/components/README.md new file mode 100644 index 000000000..53c7cd71e --- /dev/null +++ b/docs/components/README.md @@ -0,0 +1,77 @@ + + +# đŸ§© `components/` – Übersicht ĂŒber alle UI-Komponenten + +Dieses Verzeichnis enthĂ€lt die gesamten React-Komponenten der TALAS-Kartenanwendung. +Sie sind thematisch gegliedert in Teilbereiche fĂŒr KontextmenĂŒs, POIs, Polylinien, Modale und die zentrale `MapComponent`. + +--- + +## 📁 StrukturĂŒbersicht + +```bash +components/ +├── contextmenu/ # Komponenten fĂŒr rechte Maustaste & Kontextaktionen +│ ├── CoordinatePopup.js +│ └── useMapContextMenu.js + +├── gisPolylines/ # Polylinien (Kabelstrecken) +│ ├── PolylineContextMenu.js +│ └── icons/ +│ ├── CircleIcon.js +│ ├── EndIcon.js +│ ├── StartIcon.js +│ └── SupportPointIcons.js + +├── icons/devices/overlapping/ # ZusĂ€tzliche Overlap-Icons fĂŒr GerĂ€te +│ └── PlusRoundIcon.js + +├── mainComponent/ # Hauptkomponenten fĂŒr Karteninitialisierung +│ ├── MapComponent.js +│ └── hooks/ +│ └── useInitializeMap.js + +├── pois/ # POI-spezifische Modale +│ ├── AddPOIModal.js +│ └── PoiUpdateModal.js + +├── uiWidgets/ # UI-Widgets +│ ├── CoordinateInput.js +│ ├── VersionInfoModal.js +│ ├── TestScript.js +│ └── mapLayersControlPanel/ +│ ├── EditModeToggle.js +│ └── MapLayersControlPanel.js +``` + +--- + +## 🔎 Beschreibung der Hauptbereiche + +### `contextmenu/` + +Rechtsklick-MenĂŒs fĂŒr Marker, POIs, Polylinien. Steuert Anzeige & Verhalten. + +### `gisPolylines/` + +Komponenten fĂŒr das Zeichnen, Bearbeiten und Interagieren mit Linien/Strecken. + +### `mainComponent/` + +Zentrale Leaflet-Map-Logik & Initialisierung via `MapComponent` und `useInitializeMap`. + +### `pois/` + +Modale fĂŒr das HinzufĂŒgen und Bearbeiten von POIs (Points of Interest). + +### `uiWidgets/` + +Komponenten wie Eingabefelder fĂŒr Koordinaten-Suche, Infoboxen und Control Panel fĂŒr GerĂ€te Layers . + +--- + +## ✅ Besonderheiten + +- Verwendet **Tailwind CSS** fĂŒr Styling +- Integration mit Redux, Leaflet, OverlappingMarkerSpiderfier +- VollstĂ€ndig modular & testbar aufgebaut diff --git a/docs/components/contextmenu/CoordinatePopup.md b/docs/components/contextmenu/CoordinatePopup.md index 5ccb4858a..05048fe80 100644 --- a/docs/components/contextmenu/CoordinatePopup.md +++ b/docs/components/contextmenu/CoordinatePopup.md @@ -13,11 +13,11 @@ Zeigt ein modales Fenster mit Koordinateninformationen an, z. B. aus einem Kon ## Props -| Name | Typ | Beschreibung | -|-------------|-----------|------------------------------------| -| `isOpen` | `boolean` | Steuert Sichtbarkeit des Modals | -| `coordinates` | `string` | Zu zeigende Koordinaten (z. B. `"53.2,8.1"`) | -| `onClose` | `function` | Wird bei Klick auf „Schließen“ ausgelöst | +| Name | Typ | Beschreibung | +| ------------- | ---------- | -------------------------------------------- | +| `isOpen` | `boolean` | Steuert Sichtbarkeit des Modals | +| `coordinates` | `string` | Zu zeigende Koordinaten (z. B. `"53.2,8.1"`) | +| `onClose` | `function` | Wird bei Klick auf „Schließen“ ausgelöst | ## Design @@ -29,3 +29,4 @@ Zeigt ein modales Fenster mit Koordinateninformationen an, z. B. aus einem Kon - Nutzt `navigator.clipboard.writeText` oder Fallback mit `document.execCommand("copy")` - Stoppt Event-Bubbling, um Klick außerhalb zu erkennen +🔙 [ZurĂŒck zur Übersicht](./README.md) diff --git a/docs/components/contextmenu/README.md b/docs/components/contextmenu/README.md new file mode 100644 index 000000000..9a2cff810 --- /dev/null +++ b/docs/components/contextmenu/README.md @@ -0,0 +1,43 @@ + + +# đŸ–±ïž `contextmenu/` – KontextmenĂŒ-Komponenten + +Dieses Verzeichnis enthĂ€lt Komponenten und Hooks zur Anzeige und Steuerung von KontextmenĂŒs in der Leaflet-Kartenanwendung. Sie dienen der Interaktion mit POIs, Koordinaten und Layer-Objekten per Rechtsklick. + +--- + +## 📂 Enthaltene Dateien + +| Datei | Beschreibung | +| ------------------------------------------------ | ---------------------------------------------------------------------- | +| [`CoordinatePopup.js`](./CoordinatePopup.md) | Zeigt ein kleines Kontextfenster mit Koordinaten und Copy-Funktion | +| [`useMapContextMenu.js`](./useMapContextMenu.md) | Hook zur Initialisierung und Verwaltung des KontextmenĂŒs auf der Karte | + +--- + +## 🔄 Verwendung + +Diese Komponenten sind typischerweise eingebunden in: + +- [`MapComponent.js`](../mainComponent/MapComponent.md) +- [`PolylineContextMenu.js`](../gisPolylines/PolylineContextMenu.md) +- Marker- und Linienfunktionen aus `setupDevices`, `setupPolylines` + +--- + +## 🎯 Ziel + +Ermöglicht einfache Benutzerinteraktion mit: + +- GerĂ€ten +- Koordinaten +- POIs +- Streckenabschnitten + +--- + +## 📚 Weitere Dokumentation + +Alle Markdown-Dateien fĂŒr Komponenten befinden sich im `/docs/components/contextmenu/` Verzeichnis. + +🔙 [ZurĂŒck zu `components`](../README.md) diff --git a/docs/components/contextmenu/useMapContextMenu.md b/docs/components/contextmenu/useMapContextMenu.md index 134d4cbd0..4c88560ee 100644 --- a/docs/components/contextmenu/useMapContextMenu.md +++ b/docs/components/contextmenu/useMapContextMenu.md @@ -7,8 +7,8 @@ Wird typischerweise in `initializeMap()` oder `MapComponent` verwendet. ## KontextmenĂŒeintrĂ€ge -| Eintrag | Funktion | -|---------------------|------------------------------------------------| +| Eintrag | Funktion | +| -------------------- | ----------------------------------------------- | | Koordinaten anzeigen | Öffnet `CoordinatePopup` mit aktueller Position | | Reinzoomen | Zoomt 3 Stufen nĂ€her an das Zentrum heran | | Rauszoomen | Zoomt 3 Stufen heraus | @@ -18,15 +18,7 @@ Wird typischerweise in `initializeMap()` oder `MapComponent` verwendet. ## Parameter ```js -addItemsToMapContextMenu( - map, - menuItemAdded, - setMenuItemAdded, - setShowCoordinatesModal, - setShowPoiModal, - setPopupCoordinates, - openPopupWithCoordinates -) +addItemsToMapContextMenu(map, menuItemAdded, setMenuItemAdded, setShowCoordinatesModal, setShowPoiModal, setPopupCoordinates, openPopupWithCoordinates); ``` ## Besonderheiten @@ -34,3 +26,5 @@ addItemsToMapContextMenu( - PrĂŒft auf `localStorage.editMode` fĂŒr POI-Eintrag - FlyTo-Animationen fĂŒr Zoom-VorgĂ€nge mit dynamischer Dauer - Modularer Aufbau: `openPopupWithCoordinates` wird extern ĂŒbergeben + + 🔙 [ZurĂŒck zu contextmenu ](./README.md)