Changes for page Schwarmspeicher Electrify
Last modified by Patrizia Gurschka on 2026/09/10 14:58
From version 5.1
edited by Patrizia Gurschka
on 2026/09/09 14:21
on 2026/09/09 14:21
Change comment:
There is no comment for this version
To version 7.1
edited by Patrizia Gurschka
on 2026/09/09 14:25
on 2026/09/09 14:25
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,54 +1,63 @@ 1 - macro:box1 += 🔋 Schwarmspeicher Electrify = 2 2 3 +|**ⓘ Zweck: **Webbasiertes Projektmanagementsystem zur Verwaltung von Batterie-Großspeicherprojekten in Deutschland und Österreich — vom Standort über Genehmigungen bis zur Projektsteuerung und Dokumentation. Die aktuelle Anwendung enthält zusätzlich den eigenständigen Use-Case PV Co-Location.|((( 3 3 **Auf dieser Seite** 4 4 5 - macro:toc6 +• 🔋 Schwarmspeicher Electrify 6 6 7 -* ((( 8 -[[🔋 Schwarmspeicher Electrify>>path:#HD83DDD0BSchwarmspeicherElectrify]] 8 +• Übersicht 9 9 10 -* [[Übersicht>>path:#HDCbersicht]] 11 -* [[Technologie-Stack>>path:#HTechnologie-Stack]] 12 -* [[Projektstruktur>>path:#HProjektstruktur]] 13 -* ((( 14 -[[Hauptfunktionen>>path:#HHauptfunktionen]] 10 +• Technologie-Stack 15 15 16 -* [[Dashboard>>path:#HDashboard]] 17 -* [[Projektverwaltung>>path:#HProjektverwaltung]] 18 -* [[Standortverwaltung>>path:#HStandortverwaltung]] 19 -* [[Gemeinden>>path:#HGemeinden]] 20 -* [[Kartenansicht>>path:#HKartenansicht]] 21 -* [[Potenzialanalyse>>path:#HPotenzialanalyse]] 22 -* [[Pipeline>>path:#HPipeline]] 23 -* [[Meilensteinverwaltung>>path:#HMeilensteinverwaltung]] 24 -* [[Aufgabenverwaltung>>path:#HAufgabenverwaltung]] 25 -* [[Dokumentenverwaltung>>path:#HDokumentenverwaltung]] 26 -* [[Standortpartner>>path:#HStandortpartner]] 27 -* [[Stockende Projekte>>path:#HStockendeProjekte]] 28 -* [[Forecast>>path:#HForecast]] 29 -* [[PV Co-Location>>path:#HPVCo-Location]] 30 -* [[Benutzerverwaltung>>path:#HBenutzerverwaltung]] 31 -* [[Audit Log>>path:#HAuditLog]] 32 -))) 33 -* [[Routing>>path:#HRouting]] 34 -* [[Datenzugriff>>path:#HDatenzugriff]] 35 -* [[Supabase>>path:#HSupabase]] 36 -* [[Architektur>>path:#HArchitektur]] 37 -* [[Server>>path:#HServer]] 38 -))) 12 +• Projektstruktur 39 39 14 +• Hauptfunktionen 40 40 16 +▪ Dashboard 41 41 42 - =🔋 SchwarmspeicherElectrify =18 +▪ Projektverwaltung 43 43 44 - macro:info20 +▪ Standortverwaltung 45 45 46 - Information22 +▪ Gemeinden 47 47 48 - **Zweck:**Webbasiertes Projektmanagementsystem zur Verwaltung von Batterie-Großspeicherprojekten in Deutschland und Österreich — vom Standort über Genehmigungen bis zur Projektsteuerung und Dokumentation. Die aktuelle Anwendung enthält zusätzlich den eigenständigen Use-Case **PV Co-Location**.24 +▪ Kartenansicht 49 49 50 - Clickand drag to move26 +▪ Potenzialanalyse 51 51 28 +▪ Pipeline 29 + 30 +▪ Meilensteinverwaltung 31 + 32 +▪ Aufgabenverwaltung 33 + 34 +▪ Dokumentenverwaltung 35 + 36 +▪ Standortpartner 37 + 38 +▪ Stockende Projekte 39 + 40 +▪ Forecast 41 + 42 +▪ PV Co-Location 43 + 44 +▪ Benutzerverwaltung 45 + 46 +▪ Audit Log 47 + 48 +• Routing 49 + 50 +• Datenzugriff 51 + 52 +• Supabase 53 + 54 +• Architektur 55 + 56 +• Server 57 +))) 58 + 59 + 60 + 52 52 == Übersicht == 53 53 54 54 **Schwarmspeicher Electrify** unterstützt den gesamten Projektlebenszyklus: Standortidentifikation, Pipeline, Genehmigungen, Projektsteuerung, Forecast, Aufgaben und Dokumentation. Über einen Use-Case-Switcher kann zwischen **Schwarmspeicher** und **PV Co-Location** gewechselt werden. Der aktive Use-Case wird aus dem URL-Pfad abgeleitet. ... ... @@ -55,31 +55,28 @@ 55 55 56 56 == Technologie-Stack == 57 57 58 -**Frontend:** React 18.3.1 · TypeScript 5.8.3 · Vite 5.4.19 · Tailwind CSS 3.4.17 · shadcn/ui / Radix UI · React Router DOM 6.30.1 · TanStack React Query 5.83.0 · React Hook Form 7.61.1 · Zod 3.25.76 · Leaflet 1.9.4 / React Leaflet 4.2.1 · Recharts 2.15.4 · xlsx 0.18.567 +**Frontend: **React 18.3.1 · TypeScript 5.8.3 · Vite 5.4.19 · Tailwind CSS 3.4.17 · shadcn/ui / Radix UI · React Router DOM 6.30.1 · TanStack React Query 5.83.0 · React Hook Form 7.61.1 · Zod 3.25.76 · Leaflet 1.9.4 / React Leaflet 4.2.1 · Recharts 2.15.4 · xlsx 0.18.5 59 59 60 -**Backend:** Supabase — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)69 +**Backend: **Supabase — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS) 61 61 62 -**Tests:** Vitest 3.2.4 · Playwright 1.57.071 +**Tests: **Vitest 3.2.4 · Playwright 1.57.0 63 63 64 64 == Projektstruktur == 65 65 66 -macro:code 67 - 68 -src/ 69 -├── components/ UI-Komponenten und Fachkomponenten 70 -├── pages/ Seiten der Anwendung 71 -├── hooks/ Datenzugriffe und Business-Logik 72 -├── integrations/ Supabase Client und generierte Typen 73 -├── types/ TypeScript-Modelle, inkl. PV Co-Location 74 -└── lib/ Hilfsfunktionen 75 - 76 -supabase/ 75 +|src/ 76 +├── components/ UI-Komponenten und Fachkomponenten 77 +├── pages/ Seiten der Anwendung 78 +├── hooks/ Datenzugriffe und Business-Logik 79 +├── integrations/ Supabase Client und generierte Typen 80 +├── types/ TypeScript-Modelle, inkl. PV Co-Location 81 +└── lib/ Hilfsfunktionen 82 +\\supabase/ 77 77 ├── migrations/ 78 78 ├── functions/ 79 79 └── config.toml 80 80 81 -Click and drag to move 82 82 88 + 83 83 == Hauptfunktionen == 84 84 85 85 === Dashboard === ... ... @@ -90,65 +90,65 @@ 90 90 91 91 Verwaltung aller Batteriespeicherprojekte: anzeigen, Detailansicht, bearbeiten, Projektstatus und Meilensteine. Komponenten: ProjectTable, ProjectDetail. PV Co-Location besitzt eine eigene Projektansicht mit CoLocationProjectTable und CoLocationStandortDetail. 92 92 93 - ===Standortverwaltung===99 +Standortverwaltung 94 94 95 95 Standorte anlegen, bearbeiten, importieren, Historie und Dokumente. Komponenten: StandortDetail, CreateStandortForm, StandortImportDialog, StandortDokumente. PV Co-Location ergänzt eigene Formulare, Import, Bulk-Edit und Detailansichten. 96 96 97 - ===Gemeinden===103 +Gemeinden 98 98 99 99 Verwaltung der Gemeinden (Komponente CreateGemeindeForm). Zusätzlich existiert eine Supabase Edge Function zum Abruf von NÖ-Gemeinden (supabase/functions/fetch-noe-gemeinden). 100 100 101 - ===Kartenansicht===107 +Kartenansicht 102 102 103 103 Darstellung aller Standorte auf einer interaktiven Karte mit Leaflet / React Leaflet. Komponenten: ProjectMap, LocationPickerMap. PV Co-Location besitzt eine eigene Karte mit Standortselektion, Partnerfilter und Übergabe ausgewählter Standort-IDs an die Projektansicht. 104 104 105 - ===Potenzialanalyse===111 +Potenzialanalyse 106 106 107 107 Bewertung möglicher Standorte. Komponenten: PotenzialTabelle, PotenzialPage. Die Potenzialanalyse ist aktuell dem Schwarmspeicher-Use-Case zugeordnet. 108 108 109 - ===Pipeline===115 +Pipeline 110 110 111 111 Verwaltung von Vorprojekten. Komponenten: VorprojektePipeline, VorprojektTimeline. PV Co-Location besitzt eine separate Pipeline für co_vorprojekte mit Standortpartner, Kontakt, Standort-/kWp-/BESS-Potenzial, Realisierungswahrscheinlichkeit, Follow-up und nächsten Schritten. 112 112 113 - ===Meilensteinverwaltung===119 +Meilensteinverwaltung 114 114 115 115 Projektfortschritt über Meilensteine. Komponenten: MeilensteinMatrix, MeilensteinQuickEdit. PV Co-Location verwendet eine eigene Meilensteinmatrix und Quick-Edit-Logik. Zu den dort abgebildeten Schritten gehören u. a. Grundstücksvertrag, Netzzugangsvertrag, Fertigstellungsmeldung, BESS-Bezugsleistung und Inbetriebnahme. 116 116 117 - ===Aufgabenverwaltung===123 +Aufgabenverwaltung 118 118 119 119 Projektbezogene Aufgaben. Komponenten: TaskManager, TasksPage. Hook: useTasks(). PV Co-Location verwendet mit CoTaskManager, CoLocationTasksPage und useCoTasks() eine eigene, vom Schwarmspeicher getrennte Aufgabenliste. 120 120 121 - ===Dokumentenverwaltung===127 +Dokumentenverwaltung 122 122 123 123 Zu jedem Standort können Dokumente verwaltet werden. Komponenten: StandortDokumente, PartnerDokumente. PV Co-Location besitzt eigene Standort- und Partnerdokumente sowie den separaten Frontend-Zugriff auf den Storage-Bucket co-dokumente; Downloads werden als Signed URLs erzeugt. 124 124 125 - ===Standortpartner===131 +Standortpartner 126 126 127 127 Verwaltung von Projektpartnern. Komponenten: StandortpartnerManager, StandortpartnerTable. Für PV Co-Location existieren separate Komponenten und Datenzugriffe für Standortpartner. 128 128 129 - ===Stockende Projekte===135 +Stockende Projekte 130 130 131 131 Erkennung von Projekten bzw. Standorten, deren definierte Lead Times zwischen Meilensteinen überschritten sind. Für PV Co-Location sind die Lead-Time-Regeln in der UI anpassbar und werden derzeit im Browser-localStorage gespeichert. 132 132 133 - ===Forecast===139 +Forecast 134 134 135 135 Forecast auf Basis von Monatszielen und erreichten Meilensteinen. PV Co-Location enthält Plan-/Ist-Auswertungen für Netzzugangsvertrag, BESS beantragt, BESS bewilligt und BESS in Betrieb sowie eine Jahresauswahl und editierbare Monatsziele. 136 136 137 - ===PV Co-Location===143 +PV Co-Location 138 138 139 139 Zweiter fachlich getrennter Use-Case mit eigenen Routen, Seiten, Hooks und Datenobjekten. Enthalten sind Dashboard, Karte, Projekte, Pipeline, stockende Standorte, Forecast und Tasks. Die Use-Case-Umschaltung erfolgt über den Sidebar-Switcher; /pv-colocation/* aktiviert PV Co-Location, die übrigen Anwendungspfade den Schwarmspeicher. 140 140 141 - ===Benutzerverwaltung===147 +Benutzerverwaltung 142 142 143 143 Anmeldung, Passwortänderung und Rollen. Komponenten: AuthProvider, ProtectedRoute, BenutzerPage, ChangePasswordDialog. Backend: Supabase Authentication. Die Anwendung unterstützt zudem eine verpflichtende Passwortänderung über useMustChangePassword(). 144 144 145 - ===Audit Log===151 +Audit Log 146 146 147 147 Nachvollziehbarkeit von Änderungen über AuditLogPage und audit_log. Der Zugriff auf das Änderungsprotokoll ist über die vorhandenen Datenbankregeln auf Administratoren eingeschränkt. 148 148 149 - ==Routing==155 +Routing 150 150 151 -| =Seite|=Beschreibung157 +|**Seite**|**Beschreibung** 152 152 |Dashboard|Startseite 153 153 |Projekte|Projektübersicht 154 154 |Pipeline|Vorprojekte ... ... @@ -161,17 +161,17 @@ 161 161 |Benutzer|Benutzerverwaltung 162 162 |Login|Anmeldung 163 163 164 -**Schwarmspeicher-Routen:** / · /projekte · /pipeline · /potenzial · /karte · /stockend · /forecast · /tasks · /benutzer · /historie 165 165 166 -**PV-Co-Location-Routen:** /pv-colocation · /pv-colocation/projekte · /pv-colocation/pipeline · /pv-colocation/karte · /pv-colocation/stockend · /pv-colocation/forecast · /pv-colocation/tasks 167 167 168 - == Datenzugriff==172 +**Schwarmspeicher-Routen: **/ · /projekte · /pipeline · /potenzial · /karte · /stockend · /forecast · /tasks · /benutzer · /historie 169 169 170 - Der Zugriff erfolgtüberCustomHooks, diedieKommunikationmit Supabasekapseln. ReactQueryübernimmtLaden,MutationenundCache-Invalidierung.174 +**PV-Co-Location-Routen: **/pv-colocation · /pv-colocation/projekte · /pv-colocation/pipeline · /pv-colocation/karte · /pv-colocation/stockend · /pv-colocation/forecast · /pv-colocation/tasks 171 171 172 - macro:code176 +Datenzugriff 173 173 174 -Schwarmspeicher: 178 +Der Zugriff erfolgt über Custom Hooks, die die Kommunikation mit Supabase kapseln. React Query übernimmt Laden, Mutationen und Cache-Invalidierung. 179 + 180 +|Schwarmspeicher: 175 175 useStandorte() 176 176 useGemeinden() 177 177 useVorprojekte() ... ... @@ -180,8 +180,7 @@ 180 180 useStandortpartner() 181 181 useMonatsziele() 182 182 useDokumente() 183 - 184 -PV Co-Location: 189 +\\PV Co-Location: 185 185 useCoLocationStandorte() 186 186 useCoLocationStandortpartner() 187 187 useCoVorprojekte() ... ... @@ -189,56 +189,45 @@ 189 189 useCoMonatsziele() 190 190 useCoDokumente() 191 191 192 -Click and drag to move 193 193 194 -== Supabase == 195 195 196 - **Authentication:** Login, Passwortänderung, Rollenverwaltung und geschützte Routen.199 +Supabase 197 197 198 -** Datenbank:**Wird über SQL-Migrationenverwaltet (supabase/migrations/). DieMigrationendefinieren Tabellen,PoliciesundDatenbankfunktionen.201 +**Authentication: **Login, Passwortänderung, Rollenverwaltung und geschützte Routen. 199 199 200 -** Storage:**Der bestehendeBucket dokumente ist lautMigrationprivat undaufauthentifizierte Zugriffe beschränkt. DasPV-Co-Location-FrontendreferenziertzusätzlichdenBucketco-dokumente.203 +**Datenbank: **Wird über SQL-Migrationen verwaltet (supabase/migrations/). Die Migrationen definieren Tabellen, Policies und Datenbankfunktionen. 201 201 202 -** Audit:**Änderungenwerdenüberaudit_logundDatenbank-Triggerprotokolliert;dieAudit-Funktionist gegendirekteAusführungdurchPUBLIC/anon/authenticatedgehärtet.205 +**Storage: **Der bestehende Bucket dokumente ist laut Migration privat und auf authentifizierte Zugriffe beschränkt. Das PV-Co-Location-Frontend referenziert zusätzlich den Bucket co-dokumente. 203 203 207 +**Audit: **Änderungen werden über audit_log und Datenbank-Trigger protokolliert; die Audit-Funktion ist gegen direkte Ausführung durch PUBLIC/anon/authenticated gehärtet. 208 + 204 204 **Edge Functions:** 205 205 206 -* fetch-noe-gemeinden — lädt Gemeinden aus Niederösterreich 207 -* manage-users — Benutzerverwaltung 211 +• fetch-noe-gemeinden — lädt Gemeinden aus Niederösterreich 208 208 209 -ma cro:info213 +• manage-users — Benutzerverwaltung 210 210 211 - Information215 +|**ⓘ Technischer Hinweis: **Die Frontend-Hooks referenzieren mehrere co_* Datenobjekte (u. a. co_standorte, co_prozessschritte, co_standortpartner, co_vorprojekte, co_tasks, co_monatsziele und co_dokumente) sowie den Storage-Bucket co-dokumente. Im bereitgestellten supabase/migrations-Verzeichnis und in den generierten Supabase-Typen sind diese Co-Location-Objekte nicht vollständig enthalten. Für ein reproduzierbares Deployment sollten die fehlenden Schema-, RLS- und Storage-Migrationen ergänzt und die Typen anschließend neu generiert werden. 212 212 213 - **TechnischerHinweis:** Die Frontend-Hooks referenzieren mehrereco_* Datenobjekte (u. a. co_standorte, co_prozessschritte, co_standortpartner, co_vorprojekte, co_tasks, co_monatszieleund co_dokumente) sowie den Storage-Bucket co-dokumente. Im bereitgestellten supabase/migrations-Verzeichnis und in den generierten Supabase-Typen sind diese Co-Location-Objekte nicht vollständig enthalten. Für ein reproduzierbares Deployment sollten die fehlenden Schema-, RLS- und Storage-Migrationen ergänzt und die Typen anschließend neu generiert werden.217 +Architektur 214 214 215 -Click and drag to move 219 +|flowchart TD 220 + FE["React Frontend"] ~-~-> UC["UseCaseProvider / Router"] 221 + UC ~-~-> SS["Schwarmspeicher Pages"] 222 + UC ~-~-> CO["PV Co-Location Pages"] 223 + SS ~-~-> RQ["React Query"] 224 + CO ~-~-> RQ 225 + RQ ~-~-> SC["Supabase Client"] 226 + SC ~-~-> AUTH["Auth"] 227 + SC ~-~-> DBS["Database / RLS"] 228 + SC ~-~-> ST["Storage"] 229 + DBS ~-~-> EF["Edge Functions"] 230 + DBS ~-~-> AL["Audit Log / Trigger"] 216 216 217 -== Architektur == 218 218 219 -macro:mermaid 220 220 221 - macro:velocity234 +Server 222 222 223 -macro:html 224 - 225 -{{{flowchart TD 226 - FE["React Frontend"] --> UC["UseCaseProvider / Router"] 227 - UC --> SS["Schwarmspeicher Pages"] 228 - UC --> CO["PV Co-Location Pages"] 229 - SS --> RQ["React Query"] 230 - CO --> RQ 231 - RQ --> SC["Supabase Client"] 232 - SC --> AUTH["Auth"] 233 - SC --> DBS["Database / RLS"] 234 - SC --> ST["Storage"] 235 - DBS --> EF["Edge Functions"] 236 - DBS --> AL["Audit Log / Trigger"]}}} 237 - 238 -Click and drag to move 239 - 240 -== Server == 241 - 242 242 Für die lokale Entwicklung nennt die aktuelle README Node.js ≥ 18 oder Bun, Docker / Docker Compose und die Supabase CLI. Der Vite-Dev-Server läuft laut README auf Port 8200, Supabase Studio auf 127.0.0.1:54323. 243 243 244 -Die bisherige Dokumentation nennt zusätzlich den Betrieb unter /mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal in einem Docker-Compose-Stack sowie die Adresse [[http:~~/~~/schwarmspeicher.spl-tele.com:8200>>url:http://schwarmspeicher.spl-tele.com:8200]]im VPN und SPL-TELE-Netzwerk. Diese konkrete produktive Serverkonfiguration ist im bereitgestellten Quellpaket nicht enthalten und konnte daraus nicht erneut verifiziert werden.238 +Die bisherige Dokumentation nennt zusätzlich den Betrieb unter /mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal in einem Docker-Compose-Stack sowie die Adresse http:~/~/schwarmspeicher.spl-tele.com:8200 im VPN und SPL-TELE-Netzwerk. Diese konkrete produktive Serverkonfiguration ist im bereitgestellten Quellpaket nicht enthalten und konnte daraus nicht erneut verifiziert werden.