Changes for page Schwarmspeicher Electrify
Last modified by Patrizia Gurschka on 2026/09/10 14:58
From version 26.1
edited by Patrizia Gurschka
on 2026/09/10 13:19
on 2026/09/10 13:19
Change comment:
There is no comment for this version
To version 8.2
edited by Patrizia Gurschka
on 2026/09/10 07:15
on 2026/09/10 07:15
Change comment:
Auto-saved during real-time collaboration
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 4 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,34 +1,81 @@ 1 -|(% style="width:650px" %)((( 2 -= đ Schwarmspeicher Electrify = 1 +**đ Schwarmspeicher Electrify** 3 3 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. 3 +|((( 4 +|((( 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 -{{/info}} 9 -)))|(% style="width:418px" %)((( 8 +))) 9 + 10 + 11 +)))|((( 12 +|((( 10 10 **Auf dieser Seite** 11 11 12 - {{toc/}}15 +âȘ Schwarmspeicher Electrify 13 13 14 - 15 -))) 17 +â Ăbersicht 16 16 17 - ==Ăberblick==19 +â Technologie-Stack 18 18 19 - **SchwarmspeicherElectrify **unterstĂŒtzt den gesamtenProjektlebenszyklus: Standortidentifikation, Genehmigungen, Projektsteuerung und Dokumentation â fĂŒr beide Use-Cases parallel, ĂŒber einen Umschalter in der Seitenleiste.21 +â Projektstruktur 20 20 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) 23 +â Use-Case-Umschalter 25 25 26 - ==Architektur ==25 +â Hauptfunktionen 27 27 28 - [[image:1789039138746-630.png||height="552" width="563"]]27 +â« Dashboard 29 29 30 - ZusĂ€tzlichĂŒbernimmt nginx im Frontend-ContainerTLS-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 Browser29 +â« Projektverwaltung 31 31 31 +â« Gemeinden 32 + 33 +â« Kartenansicht 34 + 35 +â« Potenzialanalyse 36 + 37 +â« Pipeline 38 + 39 +â« Meilensteinverwaltung 40 + 41 +â« Stockend 42 + 43 +â« Forecast 44 + 45 +â« Aufgabenverwaltung 46 + 47 +â« Dokumentenverwaltung 48 + 49 +â« Standortpartner 50 + 51 +â« Benutzerverwaltung 52 + 53 +â« Audit Log 54 + 55 +â« Landingpage "FlĂ€che verpachten" 56 + 57 +â Routing 58 + 59 +â Datenzugriff 60 + 61 +â Supabase 62 + 63 +â Architektur 64 + 65 +â Offene Punkte / zu verifizieren 66 + 67 +â Server 68 +))) 69 + 70 + 71 +))) 72 + 73 + 74 + 75 +== Ăbersicht == 76 + 77 +**Schwarmspeicher Electrify **unterstĂŒtzt den gesamten Projektlebenszyklus: Standortidentifikation, Genehmigungen, Projektsteuerung und Dokumentation â fĂŒr beide Use-Cases parallel, ĂŒber einen Umschalter in der Seitenleiste. 78 + 32 32 == Technologie-Stack == 33 33 34 34 **Frontend: **React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · Leaflet + leaflet.markercluster (Kartendarstellung) · Recharts (Diagramme) · XLSX (Excel-Import/-Export) ... ... @@ -35,9 +35,37 @@ 35 35 36 36 **Backend: **Supabase (self-hosted) â PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS) 37 37 85 +== Projektstruktur == 86 + 87 +|((( 88 +đ src/ 89 + 90 +đ  components/  UI-Komponenten (Schwarmspeicher + CoLocation*-Pendants) 91 + 92 +đ  pages/  Seiten der Anwendung 93 + 94 +đ  hooks/  Datenzugriffe und Business-Logik 95 + 96 +đ  integrations/  Supabase Client 97 + 98 +đ  types/  TypeScript-Modelle 99 + 100 +đ  lib/  Hilfsfunktionen (u.a. mapCoordinates.ts) 101 + 102 +đ supabase/ 103 + 104 +đ  migrations/  SQL-Migrationen (inkl. komplettes PV-Co-Location-Schema) 105 + 106 +đ  functions/  Edge Functions 107 +))) 108 + 109 +== Use-Case-Umschalter == 110 + 111 +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. 112 + 38 38 == Hauptfunktionen == 39 39 40 -=== 1.Dashboard ===115 +=== Dashboard === 41 41 42 42 Zentrale Ăbersicht ĂŒber Projekte, Status, Kennzahlen und Projektfortschritt. 43 43 ... ... @@ -44,7 +44,7 @@ 44 44 * Schwarmspeicher: Dashboard.tsx â Pipeline-Summary, kW/kWh-KPIs, Plan-vs-Ist-Charts pro Meilenstein 45 45 * PV-Co-Location: CoLocationDashboard.tsx â gleiche Struktur, Einheiten angepasst (kWp/kW), zweite Ăbersichtskarte zeigt Standortpartner-Anzahl statt Gemeinden 46 46 47 -=== 2.Projektverwaltung / Standortverwaltung ===122 +=== Projektverwaltung / Standortverwaltung === 48 48 49 49 Standorte anlegen, bearbeiten, importieren, Historie, Dokumente, sortierbare Tabelle mit Meilenstein-Filter, Bulk-Bearbeitung, Als-abgebrochen-markieren/Reaktivieren. 50 50 ... ... @@ -53,11 +53,11 @@ 53 53 54 54 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. 55 55 56 -=== 3.Gemeinden ===131 +=== Gemeinden === 57 57 58 58 Verwaltung der Gemeinden (CreateGemeindeForm, nur Schwarmspeicher). Edge Function fetch-noe-gemeinden lĂ€dt NĂ-Gemeinden. 59 59 60 -=== 4.Kartenansicht ===135 +=== Kartenansicht === 61 61 62 62 Interaktive Karte aller Standorte (Leaflet + Clustering), Adresssuche, Vollbildmodus, FlĂ€chenauswahl (Shift+Ziehen), Trafokarte-NĂ-Layer mit Legende. 63 63 ... ... @@ -65,16 +65,16 @@ 65 65 * PV-Co-Location: CoLocationMap 66 66 * Gemeinsam genutzt: LocationPickerMap (Einzelstandort-Kartenauswahl), src/lib/mapCoordinates.ts (dedupeCoordinates â verhindert sofortiges Auftrennen bei identischen Koordinaten) 67 67 68 -=== 5.Potenzialanalyse ===143 +=== Potenzialanalyse === 69 69 70 70 Bewertung möglicher Standorte (PotenzialTabelle, PotenzialPage) â nur Schwarmspeicher, kein Pendant bei PV-Co-Location. 71 71 72 -=== 6.Pipeline ===147 +=== Pipeline === 73 73 74 74 * Schwarmspeicher: VorprojektePipeline, VorprojektTimeline 75 75 * PV-Co-Location: CoLocationPipeline (Felder an kWp/BESS-kW angepasst; kein Pendant zu VorprojektTimeline) 76 76 77 -=== 7.Meilensteinverwaltung ===152 +=== Meilensteinverwaltung === 78 78 79 79 Projektfortschritt ĂŒber Meilensteine, matrixartige Ăbersicht mit Bulk-Setzen, Gruppierung. 80 80 ... ... @@ -81,7 +81,7 @@ 81 81 * Schwarmspeicher: MeilensteinMatrix, MeilensteinQuickEdit (inkl. Sonderfall-Dialog NetzvertragAnpassungDialog) 82 82 * 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) 83 83 84 -=== 8.Stockend ===159 +=== Stockend === 85 85 86 86 Zeigt Standorte, bei denen die Lead-Time zwischen zwei Meilensteinen ĂŒberschritten ist, konfigurierbare Regeln. 87 87 ... ... @@ -88,7 +88,7 @@ 88 88 * Schwarmspeicher: StuckPage 89 89 * PV-Co-Location: CoLocationStuckPage (eigene, getrennt gespeicherte Lead-Time-Regeln entlang der neuen Meilensteinkette) 90 90 91 -=== 9.Forecast ===166 +=== Forecast === 92 92 93 93 Monatliche Zielvorgaben, Plan-vs-Ist-Charts pro Kennzahl. 94 94 ... ... @@ -95,7 +95,7 @@ 95 95 * Schwarmspeicher: ForecastPage (kW und kWh pro Monat/Meilenstein, nach Land AT/DE getrennt) 96 96 * PV-Co-Location: CoLocationForecastPage â 4 KPI-Charts entlang Netzantrag gestellt / Netzvertrag erhalten / Standort gebaut / Standort live Trading (kein Land-Split) 97 97 98 -=== 10.Aufgabenverwaltung ===173 +=== Aufgabenverwaltung === 99 99 100 100 Projektbezogene Aufgaben, jeweils eigene, komplett getrennte Liste pro Use-Case. 101 101 ... ... @@ -102,7 +102,7 @@ 102 102 * Schwarmspeicher: TaskManager, TasksPage, Hook useTasks() 103 103 * PV-Co-Location: CoTaskManager, CoLocationTasksPage, Hook useCoTasks() 104 104 105 -=== 11.Dokumentenverwaltung ===180 +=== Dokumentenverwaltung === 106 106 107 107 Zu jedem Standort und jedem Standortpartner können Dokumente hochgeladen werden. 108 108 ... ... @@ -109,7 +109,7 @@ 109 109 * Schwarmspeicher: StandortDokumente, PartnerDokumente, Hook useDokumente() 110 110 * PV-Co-Location: CoLocationStandortDokumente, CoLocationPartnerDokumente, Hook useCoDokumente() â eigener Storage-Bucket co-dokumente 111 111 112 -=== 12.Standortpartner ===187 +=== Standortpartner === 113 113 114 114 Verwaltung von Projektpartnern, eigene, komplett getrennte Partnerliste pro Use-Case. 115 115 ... ... @@ -116,15 +116,15 @@ 116 116 * Schwarmspeicher: StandortpartnerManager, StandortpartnerTable 117 117 * PV-Co-Location: CoLocationStandortpartnerManager, CoLocationStandortpartnerTable 118 118 119 -=== 13.Benutzerverwaltung ===194 +=== Benutzerverwaltung === 120 120 121 121 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. 122 122 123 -=== 14.Audit Log ===198 +=== Audit Log === 124 124 125 125 Nachvollziehbarkeit von Ănderungen (AuditLogPage), tabellenĂŒbergreifend ĂŒber beide Use-Cases. 126 126 127 -=== 15.Landingpage âFlĂ€che verpachten" ===202 +=== Landingpage âFlĂ€che verpachten" === 128 128 129 129 Ă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. 130 130 ... ... @@ -139,6 +139,8 @@ 139 139 * In FlaecheVerpachtenPage.tsx sind Firmenname und Telefonnummer aktuell Platzhalter (Rateware). Vor dem Livegang unbedingt durch die echten Kontaktdaten ersetzen. 140 140 ))) 141 141 217 + 218 + 142 142 == Routing == 143 143 144 144 |**Pfad**|**Seite**|**Use-Case**|**Login nötig** ... ... @@ -161,6 +161,8 @@ 161 161 |/pv-colocation/stockend|Stockende Standorte|PV-Co-Location|ja 162 162 |/flaeche-verpachten|Landingpage âFlĂ€che verpachten"|â|NEIN â öffentlich 163 163 241 + 242 + 164 164 == Datenzugriff == 165 165 166 166 Der Zugriff erfolgt ĂŒber Custom Hooks, die sĂ€mtliche Kommunikation mit Supabase kapseln: ... ... @@ -187,6 +187,8 @@ 187 187 useUseCase()  useAuth() 188 188 ))) 189 189 269 + 270 + 190 190 == Supabase == 191 191 192 192 **Authentication: **Login, PasswortĂ€nderung, Rollenverwaltung. ... ... @@ -201,10 +201,12 @@ 201 201 202 202 **Storage: **zwei Buckets â dokumente (Schwarmspeicher) und co-dokumente (PV-Co-Location). 203 203 204 -== Use-Case-Umschalter ==285 +== Architektur == 205 205 206 - ZweiButtons 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 gespeichertenZustand. Dadurch zeigt die Seitenleiste nach Login oder direktem Aufruf eines Links immer konsistent den richtigen Use-Case.287 +[[image:1789017284336-190.png]] 207 207 289 +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. 290 + 208 208 == Offene Punkte / zu verifizieren == 209 209 210 210 |((( ... ... @@ -216,6 +216,8 @@ 216 216 * KPI-Zuordnung im PV-Co-Location-Forecast (Netzantrag = kWp, die ĂŒbrigen drei Meilensteine = kW) ist eine Annahme â bei Bedarf auf eine einheitliche Einheit umstellen. 217 217 ))) 218 218 302 + 303 + 219 219 == Server == 220 220 221 221 Das Projekt liegt unter /mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal und lĂ€uft in einem eigenstĂ€ndigen Docker-Compose-Stack (schwarmspeicher-electrify_lokal).
- 1789037109962-994.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.gurschkap - Size
-
... ... @@ -1,1 +1,0 @@ 1 -60.0 KB - Content
- 1789039075740-139.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.gurschkap - Size
-
... ... @@ -1,1 +1,0 @@ 1 -303.9 KB - Content
- 1789039120837-667.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.gurschkap - Size
-
... ... @@ -1,1 +1,0 @@ 1 -114.2 KB - Content
- 1789039138746-630.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.gurschkap - Size
-
... ... @@ -1,1 +1,0 @@ 1 -302.8 KB - Content