Changes for page Schwarmspeicher Electrify

Last modified by Patrizia Gurschka on 2026/09/10 14:58

From version 8.2
edited by Patrizia Gurschka
on 2026/09/10 07:15
Change comment: Auto-saved during real-time collaboration
To version 26.1
edited by Patrizia Gurschka
on 2026/09/10 13:19
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,81 +1,34 @@
1 -**🔋  Schwarmspeicher Electrify**
1 +|(% style="width:650px" %)(((
2 += 🔋  Schwarmspeicher Electrify =
2 2  
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.
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.
6 6  
7 7  **Zielgruppe: **Vertriebs-/Projektentwicklungsteam und IT/DevOps-Betrieb.
8 -)))
9 -
10 -
11 -)))|(((
12 -|(((
8 +{{/info}}
9 +)))|(% style="width:418px" %)(((
13 13  **Auf dieser Seite**
14 14  
15 -â–Ș Schwarmspeicher Electrify
12 +{{toc/}}
16 16  
17 -○ Übersicht
18 -
19 -○ Technologie-Stack
20 -
21 -○ Projektstruktur
22 -
23 -○ Use-Case-Umschalter
24 -
25 -○ Hauptfunktionen
26 -
27 -▫ Dashboard
28 -
29 -▫ Projektverwaltung
30 -
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 70  
71 71  )))
72 72  
17 +== Überblick ==
73 73  
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.
74 74  
75 -== Ü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)
76 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.
26 +== Architektur ==
78 78  
28 +[[image:1789039138746-630.png||height="552" width="563"]]
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 +
79 79  == Technologie-Stack ==
80 80  
81 81  **Frontend: **React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · Leaflet + leaflet.markercluster (Kartendarstellung) · Recharts (Diagramme) · XLSX (Excel-Import/-Export)
... ... @@ -82,37 +82,9 @@
82 82  
83 83  **Backend: **Supabase (self-hosted) — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
84 84  
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 -
113 113  == Hauptfunktionen ==
114 114  
115 -=== Dashboard ===
40 +=== 1. Dashboard ===
116 116  
117 117  Zentrale Übersicht ĂŒber Projekte, Status, Kennzahlen und Projektfortschritt.
118 118  
... ... @@ -119,7 +119,7 @@
119 119  * Schwarmspeicher: Dashboard.tsx — Pipeline-Summary, kW/kWh-KPIs, Plan-vs-Ist-Charts pro Meilenstein
120 120  * PV-Co-Location: CoLocationDashboard.tsx — gleiche Struktur, Einheiten angepasst (kWp/kW), zweite Übersichtskarte zeigt Standortpartner-Anzahl statt Gemeinden
121 121  
122 -=== Projektverwaltung / Standortverwaltung ===
47 +=== 2. Projektverwaltung / Standortverwaltung ===
123 123  
124 124  Standorte anlegen, bearbeiten, importieren, Historie, Dokumente, sortierbare Tabelle mit Meilenstein-Filter, Bulk-Bearbeitung, Als-abgebrochen-markieren/Reaktivieren.
125 125  
... ... @@ -128,11 +128,11 @@
128 128  
129 129  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.
130 130  
131 -=== Gemeinden ===
56 +=== 3. Gemeinden ===
132 132  
133 133  Verwaltung der Gemeinden (CreateGemeindeForm, nur Schwarmspeicher). Edge Function fetch-noe-gemeinden lĂ€dt NÖ-Gemeinden.
134 134  
135 -=== Kartenansicht ===
60 +=== 4. Kartenansicht ===
136 136  
137 137  Interaktive Karte aller Standorte (Leaflet + Clustering), Adresssuche, Vollbildmodus, FlĂ€chenauswahl (Shift+Ziehen), Trafokarte-NÖ-Layer mit Legende.
138 138  
... ... @@ -140,16 +140,16 @@
140 140  * PV-Co-Location: CoLocationMap
141 141  * Gemeinsam genutzt: LocationPickerMap (Einzelstandort-Kartenauswahl), src/lib/mapCoordinates.ts (dedupeCoordinates — verhindert sofortiges Auftrennen bei identischen Koordinaten)
142 142  
143 -=== Potenzialanalyse ===
68 +=== 5. Potenzialanalyse ===
144 144  
145 145  Bewertung möglicher Standorte (PotenzialTabelle, PotenzialPage) — nur Schwarmspeicher, kein Pendant bei PV-Co-Location.
146 146  
147 -=== Pipeline ===
72 +=== 6. Pipeline ===
148 148  
149 149  * Schwarmspeicher: VorprojektePipeline, VorprojektTimeline
150 150  * PV-Co-Location: CoLocationPipeline (Felder an kWp/BESS-kW angepasst; kein Pendant zu VorprojektTimeline)
151 151  
152 -=== Meilensteinverwaltung ===
77 +=== 7. Meilensteinverwaltung ===
153 153  
154 154  Projektfortschritt ĂŒber Meilensteine, matrixartige Übersicht mit Bulk-Setzen, Gruppierung.
155 155  
... ... @@ -156,7 +156,7 @@
156 156  * Schwarmspeicher: MeilensteinMatrix, MeilensteinQuickEdit (inkl. Sonderfall-Dialog NetzvertragAnpassungDialog)
157 157  * 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)
158 158  
159 -=== Stockend ===
84 +=== 8. Stockend ===
160 160  
161 161  Zeigt Standorte, bei denen die Lead-Time zwischen zwei Meilensteinen ĂŒberschritten ist, konfigurierbare Regeln.
162 162  
... ... @@ -163,7 +163,7 @@
163 163  * Schwarmspeicher: StuckPage
164 164  * PV-Co-Location: CoLocationStuckPage (eigene, getrennt gespeicherte Lead-Time-Regeln entlang der neuen Meilensteinkette)
165 165  
166 -=== Forecast ===
91 +=== 9. Forecast ===
167 167  
168 168  Monatliche Zielvorgaben, Plan-vs-Ist-Charts pro Kennzahl.
169 169  
... ... @@ -170,7 +170,7 @@
170 170  * Schwarmspeicher: ForecastPage (kW und kWh pro Monat/Meilenstein, nach Land AT/DE getrennt)
171 171  * PV-Co-Location: CoLocationForecastPage — 4 KPI-Charts entlang Netzantrag gestellt / Netzvertrag erhalten / Standort gebaut / Standort live Trading (kein Land-Split)
172 172  
173 -=== Aufgabenverwaltung ===
98 +=== 10. Aufgabenverwaltung ===
174 174  
175 175  Projektbezogene Aufgaben, jeweils eigene, komplett getrennte Liste pro Use-Case.
176 176  
... ... @@ -177,7 +177,7 @@
177 177  * Schwarmspeicher: TaskManager, TasksPage, Hook useTasks()
178 178  * PV-Co-Location: CoTaskManager, CoLocationTasksPage, Hook useCoTasks()
179 179  
180 -=== Dokumentenverwaltung ===
105 +=== 11. Dokumentenverwaltung ===
181 181  
182 182  Zu jedem Standort und jedem Standortpartner können Dokumente hochgeladen werden.
183 183  
... ... @@ -184,7 +184,7 @@
184 184  * Schwarmspeicher: StandortDokumente, PartnerDokumente, Hook useDokumente()
185 185  * PV-Co-Location: CoLocationStandortDokumente, CoLocationPartnerDokumente, Hook useCoDokumente() — eigener Storage-Bucket co-dokumente
186 186  
187 -=== Standortpartner ===
112 +=== 12. Standortpartner ===
188 188  
189 189  Verwaltung von Projektpartnern, eigene, komplett getrennte Partnerliste pro Use-Case.
190 190  
... ... @@ -191,15 +191,15 @@
191 191  * Schwarmspeicher: StandortpartnerManager, StandortpartnerTable
192 192  * PV-Co-Location: CoLocationStandortpartnerManager, CoLocationStandortpartnerTable
193 193  
194 -=== Benutzerverwaltung ===
119 +=== 13. Benutzerverwaltung ===
195 195  
196 196  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.
197 197  
198 -=== Audit Log ===
123 +=== 14. Audit Log ===
199 199  
200 200  Nachvollziehbarkeit von Änderungen (AuditLogPage), tabellenĂŒbergreifend ĂŒber beide Use-Cases.
201 201  
202 -=== Landingpage „FlĂ€che verpachten" ===
127 +=== 15. Landingpage „FlĂ€che verpachten" ===
203 203  
204 204  Ă–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.
205 205  
... ... @@ -214,8 +214,6 @@
214 214  * In FlaecheVerpachtenPage.tsx sind Firmenname und Telefonnummer aktuell Platzhalter (Rateware). Vor dem Livegang unbedingt durch die echten Kontaktdaten ersetzen.
215 215  )))
216 216  
217 -
218 -
219 219  == Routing ==
220 220  
221 221  |**Pfad**|**Seite**|**Use-Case**|**Login nötig**
... ... @@ -238,8 +238,6 @@
238 238  |/pv-colocation/stockend|Stockende Standorte|PV-Co-Location|ja
239 239  |/flaeche-verpachten|Landingpage „FlĂ€che verpachten"|—|NEIN – öffentlich
240 240  
241 -
242 -
243 243  == Datenzugriff ==
244 244  
245 245  Der Zugriff erfolgt ĂŒber Custom Hooks, die sĂ€mtliche Kommunikation mit Supabase kapseln:
... ... @@ -266,8 +266,6 @@
266 266  useUseCase()   useAuth()
267 267  )))
268 268  
269 -
270 -
271 271  == Supabase ==
272 272  
273 273  **Authentication: **Login, PasswortĂ€nderung, Rollenverwaltung.
... ... @@ -282,12 +282,10 @@
282 282  
283 283  **Storage: **zwei Buckets — dokumente (Schwarmspeicher) und co-dokumente (PV-Co-Location).
284 284  
285 -== Architektur ==
204 +== Use-Case-Umschalter ==
286 286  
287 -[[image:1789017284336-190.png]]
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.
288 288  
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 -
291 291  == Offene Punkte / zu verifizieren ==
292 292  
293 293  |(((
... ... @@ -299,8 +299,6 @@
299 299  * KPI-Zuordnung im PV-Co-Location-Forecast (Netzantrag = kWp, die ĂŒbrigen drei Meilensteine = kW) ist eine Annahme — bei Bedarf auf eine einheitliche Einheit umstellen.
300 300  )))
301 301  
302 -
303 -
304 304  == Server ==
305 305  
306 306  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,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