Changes for page Schwarmspeicher Electrify
Last modified by Patrizia Gurschka on 2026/09/10 14:58
From version 13.2
edited by Patrizia Gurschka
on 2026/09/10 08:20
on 2026/09/10 08:20
Change comment:
Auto-saved during real-time collaboration
To version 27.2
edited by Patrizia Gurschka
on 2026/09/10 14:32
on 2026/09/10 14:32
Change comment:
Auto-saved during real-time collaboration
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 4 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,34 +1,12 @@ 1 -|(% style="width: 788px" %)(((1 +|(% style="width:650px" %)((( 2 2 = 🔋 Schwarmspeicher Electrify = 3 3 4 4 {{info}} 5 -**Zweck:** Webbasiertes Projektmanagementsystem zur Verwaltung von Batterie-Großspeicherprojekten in Deutschland und Österreich — vom Standort über Genehmigungen bis zur Projektsteuerung und Dokumentation. Deckt zwei Use-Cases ab: klassische Schwarmspeicher-Standorte und PV -Co-Location-Standorte.5 +**Zweck:** Webbasiertes Projektmanagementsystem zur Verwaltung von Batterie-Großspeicherprojekten in Deutschland und Österreich — vom Standort über Genehmigungen bis zur Projektsteuerung und Dokumentation. Deckt zwei Use-Cases ab: klassische Schwarmspeicher-Standorte und PV Co-Location-Standorte. 6 6 7 7 **Zielgruppe: **Vertriebs-/Projektentwicklungsteam und IT/DevOps-Betrieb. 8 8 {{/info}} 9 - 10 -|((( 11 -📁 src/ 12 - 13 -📁 components/ UI-Komponenten (Schwarmspeicher + CoLocation*-Pendants) 14 - 15 -📁 pages/ Seiten der Anwendung 16 - 17 -📁 hooks/ Datenzugriffe und Business-Logik 18 - 19 -📁 integrations/ Supabase Client 20 - 21 -📁 types/ TypeScript-Modelle 22 - 23 -📁 lib/ Hilfsfunktionen (u.a. mapCoordinates.ts) 24 - 25 -📁 supabase/ 26 - 27 -📁 migrations/ SQL-Migrationen (inkl. komplettes PV-Co-Location-Schema) 28 - 29 -📁 functions/ Edge Functions 30 -))) 31 -)))|(% style="width:280px" %)((( 9 +)))|(% style="width:418px" %)((( 32 32 **Auf dieser Seite** 33 33 34 34 {{toc/}} ... ... @@ -36,12 +36,21 @@ 36 36 37 37 ))) 38 38 17 +== Überblick == 39 39 19 +**Schwarmspeicher Electrify **unterstützt den gesamten Projektlebenszyklus: Standortidentifikation, Genehmigungen, Projektsteuerung und Dokumentation — für beide Use-Cases parallel, über einen Umschalter in der Seitenleiste. 40 40 41 -== Übersicht == 21 +* **Frontend:** React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · Leaflet + leaflet.markercluster (Kartendarstellung) · Recharts (Diagramme) · XLSX (Excel-Import/-Export) 22 +* **Backend:** Supabase (self-hosted) — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS) 23 +* **Datenquellen:** Nominatim/OpenStreetMap (Geocoding) · Edge Function fetch-noe-gemeinden (NÖ-Gemeindedaten) · EVN-Trafokarte (WMS-Layer, Netzkapazitäten) 24 +* **Orchestrierung:** eigener Docker-Compose-Stack, nginx als Reverse-Proxy (TLS-Terminierung + same-origin-Routing zu Supabase/Kong) 42 42 43 - **Schwarmspeicher Electrify **unterstützt den gesamten Projektlebenszyklus: Standortidentifikation,Genehmigungen, Projektsteuerung und Dokumentation — für beide Use-Cases parallel, über einen Umschalter in der Seitenleiste.26 +== Architektur == 44 44 28 +[[image:1789039138746-630.png||height="586" width="598"]] 29 + 30 +Zusätzlich übernimmt nginx im Frontend-Container TLS-Terminierung und same-origin-Routing (/auth, /rest, /storage, /realtime, /functions → supabase-kong) — dadurch läuft die App ohne CORS- oder Private-Network-Access-Probleme im Browser 31 + 45 45 == Technologie-Stack == 46 46 47 47 **Frontend: **React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · Leaflet + leaflet.markercluster (Kartendarstellung) · Recharts (Diagramme) · XLSX (Excel-Import/-Export) ... ... @@ -48,13 +48,9 @@ 48 48 49 49 **Backend: **Supabase (self-hosted) — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS) 50 50 51 -== Use-Case-Umschalter == 52 - 53 -Zwei Buttons oben in der Seitenleiste ("Schwarmspeicher" / "PV-Co-Location"). Welcher Use-Case aktiv angezeigt wird, leitet sich direkt aus der aktuellen URL ab (Hook useUseCase.tsx, /pv-colocation/*-Pfade vs. Rest) — nicht aus einem gespeicherten Zustand. Dadurch zeigt die Seitenleiste nach Login oder direktem Aufruf eines Links immer konsistent den richtigen Use-Case. 54 - 55 55 == Hauptfunktionen == 56 56 57 -=== Dashboard === 40 +=== 1. Dashboard === 58 58 59 59 Zentrale Übersicht über Projekte, Status, Kennzahlen und Projektfortschritt. 60 60 ... ... @@ -61,7 +61,7 @@ 61 61 * Schwarmspeicher: Dashboard.tsx — Pipeline-Summary, kW/kWh-KPIs, Plan-vs-Ist-Charts pro Meilenstein 62 62 * PV-Co-Location: CoLocationDashboard.tsx — gleiche Struktur, Einheiten angepasst (kWp/kW), zweite Übersichtskarte zeigt Standortpartner-Anzahl statt Gemeinden 63 63 64 -=== Projektverwaltung / Standortverwaltung === 47 +=== 2. Projektverwaltung / Standortverwaltung === 65 65 66 66 Standorte anlegen, bearbeiten, importieren, Historie, Dokumente, sortierbare Tabelle mit Meilenstein-Filter, Bulk-Bearbeitung, Als-abgebrochen-markieren/Reaktivieren. 67 67 ... ... @@ -70,11 +70,18 @@ 70 70 71 71 Import-Dialoge (beide Use-Cases) unterstützen: direkte Koordinatenspalten, DMS-Format, Koordinatenpaare im Adressfeld, Gemeinde-Auflösung per PLZ, mehrstufige strukturierte Geocoding-Anfragen (inkl. Konskriptionsnummern) mit Validierung gegen Gemeinde-Zentroide, sowie automatische Erkennung der Kopfzeile. 72 72 73 -=== Gemeinden ===56 +==== Meilensteinverwaltung ==== 74 74 58 +Projektfortschritt über Meilensteine, matrixartige Übersicht mit Bulk-Setzen, Gruppierung. 59 + 60 +* Schwarmspeicher: MeilensteinMatrix, MeilensteinQuickEdit (inkl. Sonderfall-Dialog NetzvertragAnpassungDialog) 61 +* PV-Co-Location: CoLocationMeilensteinMatrix, CoLocationMeilensteinQuickEdit — eigene Meilensteinkette: Vollmacht gestellt → Vollmacht erhalten → Netzantrag gestellt → Netzvertrag erhalten → Pachtvertrag unterschrieben → Standort gebaut → Standort live Trading (Kurzbeschriftungen: VM ges. / VM erh. / NA gest. / NV erh. / PV unt. / Gebaut / Trading) 62 + 63 +=== 3. Gemeinden === 64 + 75 75 Verwaltung der Gemeinden (CreateGemeindeForm, nur Schwarmspeicher). Edge Function fetch-noe-gemeinden lädt NÖ-Gemeinden. 76 76 77 -=== Kartenansicht === 67 +=== 4. Kartenansicht === 78 78 79 79 Interaktive Karte aller Standorte (Leaflet + Clustering), Adresssuche, Vollbildmodus, Flächenauswahl (Shift+Ziehen), Trafokarte-NÖ-Layer mit Legende. 80 80 ... ... @@ -82,30 +82,23 @@ 82 82 * PV-Co-Location: CoLocationMap 83 83 * Gemeinsam genutzt: LocationPickerMap (Einzelstandort-Kartenauswahl), src/lib/mapCoordinates.ts (dedupeCoordinates — verhindert sofortiges Auftrennen bei identischen Koordinaten) 84 84 85 -=== Potenzialanalyse === 75 +=== 5. Potenzialanalyse === 86 86 87 87 Bewertung möglicher Standorte (PotenzialTabelle, PotenzialPage) — nur Schwarmspeicher, kein Pendant bei PV-Co-Location. 88 88 89 -=== Pipeline === 79 +=== 6. Pipeline === 90 90 91 91 * Schwarmspeicher: VorprojektePipeline, VorprojektTimeline 92 92 * PV-Co-Location: CoLocationPipeline (Felder an kWp/BESS-kW angepasst; kein Pendant zu VorprojektTimeline) 93 93 94 -=== Meilensteinverwaltung===84 +=== 7. Stockend === 95 95 96 -Projektfortschritt über Meilensteine, matrixartige Übersicht mit Bulk-Setzen, Gruppierung. 97 - 98 -* Schwarmspeicher: MeilensteinMatrix, MeilensteinQuickEdit (inkl. Sonderfall-Dialog NetzvertragAnpassungDialog) 99 -* PV-Co-Location: CoLocationMeilensteinMatrix, CoLocationMeilensteinQuickEdit — eigene Meilensteinkette: Vollmacht gestellt → Vollmacht erhalten → Netzantrag gestellt → Netzvertrag erhalten → Pachtvertrag unterschrieben → Standort gebaut → Standort live Trading (Kurzbeschriftungen: VM ges. / VM erh. / NA gest. / NV erh. / PV unt. / Gebaut / Trading) 100 - 101 -=== Stockend === 102 - 103 103 Zeigt Standorte, bei denen die Lead-Time zwischen zwei Meilensteinen überschritten ist, konfigurierbare Regeln. 104 104 105 105 * Schwarmspeicher: StuckPage 106 106 * PV-Co-Location: CoLocationStuckPage (eigene, getrennt gespeicherte Lead-Time-Regeln entlang der neuen Meilensteinkette) 107 107 108 -=== Forecast === 91 +=== 8. Forecast === 109 109 110 110 Monatliche Zielvorgaben, Plan-vs-Ist-Charts pro Kennzahl. 111 111 ... ... @@ -112,7 +112,7 @@ 112 112 * Schwarmspeicher: ForecastPage (kW und kWh pro Monat/Meilenstein, nach Land AT/DE getrennt) 113 113 * PV-Co-Location: CoLocationForecastPage — 4 KPI-Charts entlang Netzantrag gestellt / Netzvertrag erhalten / Standort gebaut / Standort live Trading (kein Land-Split) 114 114 115 -=== Aufgabenverwaltung === 98 +=== . Aufgabenverwaltung === 116 116 117 117 Projektbezogene Aufgaben, jeweils eigene, komplett getrennte Liste pro Use-Case. 118 118 ... ... @@ -119,7 +119,7 @@ 119 119 * Schwarmspeicher: TaskManager, TasksPage, Hook useTasks() 120 120 * PV-Co-Location: CoTaskManager, CoLocationTasksPage, Hook useCoTasks() 121 121 122 -=== Dokumentenverwaltung === 105 +=== 11. Dokumentenverwaltung === 123 123 124 124 Zu jedem Standort und jedem Standortpartner können Dokumente hochgeladen werden. 125 125 ... ... @@ -126,7 +126,7 @@ 126 126 * Schwarmspeicher: StandortDokumente, PartnerDokumente, Hook useDokumente() 127 127 * PV-Co-Location: CoLocationStandortDokumente, CoLocationPartnerDokumente, Hook useCoDokumente() — eigener Storage-Bucket co-dokumente 128 128 129 -=== Standortpartner === 112 +=== 12. Standortpartner === 130 130 131 131 Verwaltung von Projektpartnern, eigene, komplett getrennte Partnerliste pro Use-Case. 132 132 ... ... @@ -133,15 +133,15 @@ 133 133 * Schwarmspeicher: StandortpartnerManager, StandortpartnerTable 134 134 * PV-Co-Location: CoLocationStandortpartnerManager, CoLocationStandortpartnerTable 135 135 136 -=== Benutzerverwaltung === 119 +=== 13. Benutzerverwaltung === 137 137 138 138 Anmeldung, Passwortänderung, Rollen (admin/user). Komponenten: AuthProvider, ProtectedRoute, BenutzerPage, LoginPage. Läuft über die Edge Function manage-users (Supabase Admin-API, prüft Admin-Rechte serverseitig). Nach Login wird immer auf "/" weitergeleitet, unabhängig von der zuvor besuchten URL. 139 139 140 -=== Audit Log === 123 +=== 14. Audit Log === 141 141 142 142 Nachvollziehbarkeit von Änderungen (AuditLogPage), tabellenübergreifend über beide Use-Cases. 143 143 144 -=== Landingpage „Fläche verpachten" === 127 +=== 15. Landingpage „Fläche verpachten" === 145 145 146 146 Öffentlich erreichbare Seite ohne Login unter /flaeche-verpachten — für Grundstückseigentümer, die eine Fläche für einen Batteriespeicher zur Verfügung stellen wollen. Kartenbasierte Standortauswahl, Formular mit Honeypot-Spamschutz. 147 147 ... ... @@ -156,8 +156,6 @@ 156 156 * In FlaecheVerpachtenPage.tsx sind Firmenname und Telefonnummer aktuell Platzhalter (Rateware). Vor dem Livegang unbedingt durch die echten Kontaktdaten ersetzen. 157 157 ))) 158 158 159 - 160 - 161 161 == Routing == 162 162 163 163 |**Pfad**|**Seite**|**Use-Case**|**Login nötig** ... ... @@ -180,8 +180,6 @@ 180 180 |/pv-colocation/stockend|Stockende Standorte|PV-Co-Location|ja 181 181 |/flaeche-verpachten|Landingpage „Fläche verpachten"|—|NEIN – öffentlich 182 182 183 - 184 - 185 185 == Datenzugriff == 186 186 187 187 Der Zugriff erfolgt über Custom Hooks, die sämtliche Kommunikation mit Supabase kapseln: ... ... @@ -208,8 +208,6 @@ 208 208 useUseCase() useAuth() 209 209 ))) 210 210 211 - 212 - 213 213 == Supabase == 214 214 215 215 **Authentication: **Login, Passwortänderung, Rollenverwaltung. ... ... @@ -224,14 +224,10 @@ 224 224 225 225 **Storage: **zwei Buckets — dokumente (Schwarmspeicher) und co-dokumente (PV-Co-Location). 226 226 204 +== Use-Case-Umschalter == 227 227 228 - ==Architektur==206 +Zwei Buttons oben in der Seitenleiste ("Schwarmspeicher" / "PV-Co-Location"). Welcher Use-Case aktiv angezeigt wird, leitet sich direkt aus der aktuellen URL ab (Hook useUseCase.tsx, /pv-colocation/*-Pfade vs. Rest) — nicht aus einem gespeicherten Zustand. Dadurch zeigt die Seitenleiste nach Login oder direktem Aufruf eines Links immer konsistent den richtigen Use-Case. 229 229 230 -[[image:1789017284336-190.png||height="353" width="762"]] 231 - 232 -Zusätzlich übernimmt nginx im Frontend-Container TLS-Terminierung und same-origin-Routing (/auth, /rest, /storage, /realtime, /functions → supabase-kong) — dadurch läuft die App ohne CORS- oder Private-Network-Access-Probleme im Browser 233 - 234 - 235 235 == Offene Punkte / zu verifizieren == 236 236 237 237 |((( ... ... @@ -243,10 +243,8 @@ 243 243 * KPI-Zuordnung im PV-Co-Location-Forecast (Netzantrag = kWp, die übrigen drei Meilensteine = kW) ist eine Annahme — bei Bedarf auf eine einheitliche Einheit umstellen. 244 244 ))) 245 245 246 - (% class="wikigeneratedid" id="HServer"%)219 +== Server == 247 247 248 -Server 249 - 250 250 Das Projekt liegt unter /mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal und läuft in einem eigenständigen Docker-Compose-Stack (schwarmspeicher-electrify_lokal). 251 251 252 252 **Erreichbar unter:**
- 1789037109962-994.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.gurschkap - Size
-
... ... @@ -1,0 +1,1 @@ 1 +60.0 KB - Content
- 1789039075740-139.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.gurschkap - Size
-
... ... @@ -1,0 +1,1 @@ 1 +303.9 KB - Content
- 1789039120837-667.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.gurschkap - Size
-
... ... @@ -1,0 +1,1 @@ 1 +114.2 KB - Content
- 1789039138746-630.png
-
- Author
-
... ... @@ -1,0 +1,1 @@ 1 +XWiki.gurschkap - Size
-
... ... @@ -1,0 +1,1 @@ 1 +302.8 KB - Content