Changes for page Schwarmspeicher Electrify
Last modified by Patrizia Gurschka on 2026/09/10 14:58
From version 18.1
edited by Patrizia Gurschka
on 2026/09/10 12:41
on 2026/09/10 12:41
Change comment:
There is no comment for this version
To version 27.5
edited by Patrizia Gurschka
on 2026/09/10 14:39
on 2026/09/10 14:39
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
-
... ... @@ -14,15 +14,18 @@ 14 14 15 15 ))) 16 16 17 - 18 - 19 19 == Überblick == 20 20 21 21 **Schwarmspeicher Electrify **unterstützt den gesamten Projektlebenszyklus: Standortidentifikation, Genehmigungen, Projektsteuerung und Dokumentation — für beide Use-Cases parallel, über einen Umschalter in der Seitenleiste. 22 22 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) 25 + 23 23 == Architektur == 24 24 25 -[[image:178901 7284336-190.png||height="353" width="762"]]28 +[[image:1789039138746-630.png||height="586" width="598"]] 26 26 27 27 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 28 28 ... ... @@ -32,34 +32,6 @@ 32 32 33 33 **Backend: **Supabase (self-hosted) — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS) 34 34 35 -== Projektstruktur == 36 - 37 -|((( 38 -📁 src/ 39 - 40 -📁 components/ UI-Komponenten (Schwarmspeicher + CoLocation*-Pendants) 41 - 42 -📁 pages/ Seiten der Anwendung 43 - 44 -📁 hooks/ Datenzugriffe und Business-Logik 45 - 46 -📁 integrations/ Supabase Client 47 - 48 -📁 types/ TypeScript-Modelle 49 - 50 -📁 lib/ Hilfsfunktionen (u.a. mapCoordinates.ts) 51 - 52 -📁 supabase/ 53 - 54 -📁 migrations/ SQL-Migrationen (inkl. komplettes PV-Co-Location-Schema) 55 - 56 -📁 functions/ Edge Functions 57 -))) 58 - 59 -== Use-Case-Umschalter == 60 - 61 -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. 62 - 63 63 == Hauptfunktionen == 64 64 65 65 === 1. Dashboard === ... ... @@ -78,6 +78,13 @@ 78 78 79 79 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. 80 80 56 +==== Meilensteinverwaltung ==== 57 + 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 + 81 81 === 3. Gemeinden === 82 82 83 83 Verwaltung der Gemeinden (CreateGemeindeForm, nur Schwarmspeicher). Edge Function fetch-noe-gemeinden lädt NÖ-Gemeinden. ... ... @@ -99,21 +99,14 @@ 99 99 * Schwarmspeicher: VorprojektePipeline, VorprojektTimeline 100 100 * PV-Co-Location: CoLocationPipeline (Felder an kWp/BESS-kW angepasst; kein Pendant zu VorprojektTimeline) 101 101 102 -=== 7. Meilensteinverwaltung===84 +=== 7. Stockend === 103 103 104 -Projektfortschritt über Meilensteine, matrixartige Übersicht mit Bulk-Setzen, Gruppierung. 105 - 106 -* Schwarmspeicher: MeilensteinMatrix, MeilensteinQuickEdit (inkl. Sonderfall-Dialog NetzvertragAnpassungDialog) 107 -* 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) 108 - 109 -=== 8. Stockend === 110 - 111 111 Zeigt Standorte, bei denen die Lead-Time zwischen zwei Meilensteinen überschritten ist, konfigurierbare Regeln. 112 112 113 113 * Schwarmspeicher: StuckPage 114 114 * PV-Co-Location: CoLocationStuckPage (eigene, getrennt gespeicherte Lead-Time-Regeln entlang der neuen Meilensteinkette) 115 115 116 -=== 9. Forecast ===91 +=== 8. Forecast === 117 117 118 118 Monatliche Zielvorgaben, Plan-vs-Ist-Charts pro Kennzahl. 119 119 ... ... @@ -120,7 +120,7 @@ 120 120 * Schwarmspeicher: ForecastPage (kW und kWh pro Monat/Meilenstein, nach Land AT/DE getrennt) 121 121 * PV-Co-Location: CoLocationForecastPage — 4 KPI-Charts entlang Netzantrag gestellt / Netzvertrag erhalten / Standort gebaut / Standort live Trading (kein Land-Split) 122 122 123 -=== 10. Aufgabenverwaltung ===98 +=== 9. Aufgabenverwaltung === 124 124 125 125 Projektbezogene Aufgaben, jeweils eigene, komplett getrennte Liste pro Use-Case. 126 126 ... ... @@ -127,7 +127,7 @@ 127 127 * Schwarmspeicher: TaskManager, TasksPage, Hook useTasks() 128 128 * PV-Co-Location: CoTaskManager, CoLocationTasksPage, Hook useCoTasks() 129 129 130 -=== 1 1. Dokumentenverwaltung ===105 +=== 10. Dokumentenverwaltung === 131 131 132 132 Zu jedem Standort und jedem Standortpartner können Dokumente hochgeladen werden. 133 133 ... ... @@ -134,7 +134,7 @@ 134 134 * Schwarmspeicher: StandortDokumente, PartnerDokumente, Hook useDokumente() 135 135 * PV-Co-Location: CoLocationStandortDokumente, CoLocationPartnerDokumente, Hook useCoDokumente() — eigener Storage-Bucket co-dokumente 136 136 137 -=== 1 2. Standortpartner ===112 +=== 11. Standortpartner === 138 138 139 139 Verwaltung von Projektpartnern, eigene, komplett getrennte Partnerliste pro Use-Case. 140 140 ... ... @@ -141,15 +141,15 @@ 141 141 * Schwarmspeicher: StandortpartnerManager, StandortpartnerTable 142 142 * PV-Co-Location: CoLocationStandortpartnerManager, CoLocationStandortpartnerTable 143 143 144 -=== 1 3. Benutzerverwaltung ===119 +=== 12. Benutzerverwaltung === 145 145 146 146 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. 147 147 148 -=== 1 4. Audit Log ===123 +=== 13. Audit Log === 149 149 150 150 Nachvollziehbarkeit von Änderungen (AuditLogPage), tabellenübergreifend über beide Use-Cases. 151 151 152 -=== 1 5. Landingpage „Fläche verpachten" ===127 +=== 14. Landingpage „Fläche verpachten" (im Aufbau) === 153 153 154 154 Ö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. 155 155 ... ... @@ -164,8 +164,6 @@ 164 164 * In FlaecheVerpachtenPage.tsx sind Firmenname und Telefonnummer aktuell Platzhalter (Rateware). Vor dem Livegang unbedingt durch die echten Kontaktdaten ersetzen. 165 165 ))) 166 166 167 - 168 - 169 169 == Routing == 170 170 171 171 |**Pfad**|**Seite**|**Use-Case**|**Login nötig** ... ... @@ -188,8 +188,6 @@ 188 188 |/pv-colocation/stockend|Stockende Standorte|PV-Co-Location|ja 189 189 |/flaeche-verpachten|Landingpage „Fläche verpachten"|—|NEIN – öffentlich 190 190 191 - 192 - 193 193 == Datenzugriff == 194 194 195 195 Der Zugriff erfolgt über Custom Hooks, die sämtliche Kommunikation mit Supabase kapseln: ... ... @@ -216,8 +216,6 @@ 216 216 useUseCase() useAuth() 217 217 ))) 218 218 219 - 220 - 221 221 == Supabase == 222 222 223 223 **Authentication: **Login, Passwortänderung, Rollenverwaltung. ... ... @@ -232,7 +232,10 @@ 232 232 233 233 **Storage: **zwei Buckets — dokumente (Schwarmspeicher) und co-dokumente (PV-Co-Location). 234 234 204 +== Use-Case-Umschalter == 235 235 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. 207 + 236 236 == Offene Punkte / zu verifizieren == 237 237 238 238 |((( ... ... @@ -239,13 +239,9 @@ 239 239 ⚠️ **Vor einem breiteren Rollout klären** 240 240 241 241 * E-Mail-Versand für Landingpage-Anfragen (RESEND_API_KEY / LEAD_NOTIFY_EMAIL) ist noch nicht final eingerichtet — Anfragen werden bis dahin nur in der Pipeline gespeichert, ohne Benachrichtigung. 242 -* Migrationsdateien in supabase/migrations/ müssen noch ins Git-Repo committet werden, falls noch nicht geschehen (Datenbank selbst ist bereits aktuell). 243 -* types.ts kennt die neuen co_*-Tabellen nicht — führt zu TypeScript-Warnungen beim Bauen (bewusst akzeptiert, kein Laufzeitfehler). 244 244 * KPI-Zuordnung im PV-Co-Location-Forecast (Netzantrag = kWp, die übrigen drei Meilensteine = kW) ist eine Annahme — bei Bedarf auf eine einheitliche Einheit umstellen. 245 245 ))) 246 246 247 - 248 - 249 249 == Server == 250 250 251 251 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