Skip to Content

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
Change comment: There is no comment for this version
To version 1.1
edited by Dimitri Rupp
on 2026/07/08 12:34
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.gurschkap
1 +XWiki.drupp
Tags
... ... @@ -1,1 +1,0 @@
1 -referenz|architektur
Content
... ... @@ -1,150 +1,93 @@
1 -macro:box
1 +{{box cssClass="floatinginfobox" title="**Auf dieser Seite**"}}
2 +{{toc/}}
3 +{{/box}}
2 2  
3 -**Auf dieser Seite**
4 -
5 -macro:toc
6 -
7 -* (((
8 -[[🔋 Schwarmspeicher Electrify>>path:#HD83DDD0BSchwarmspeicherElectrify]]
9 -
10 -* [[Übersicht>>path:#HDCbersicht]]
11 -* [[Technologie-Stack>>path:#HTechnologie-Stack]]
12 -* [[Projektstruktur>>path:#HProjektstruktur]]
13 -* (((
14 -[[Hauptfunktionen>>path:#HHauptfunktionen]]
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 -)))
39 -
40 -
41 -
42 42  = 🔋 Schwarmspeicher Electrify =
43 43  
44 -macro:info
7 +{{info}}
8 +**Zweck:** Webbasiertes Projektmanagementsystem zur Verwaltung von Batterie-Großspeicherprojekten in Deutschland und Österreich — vom Standort über Genehmigungen bis zur Projektsteuerung und Dokumentation.
9 +{{/info}}
45 45  
46 -Information
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**.
49 -
50 -Click and drag to move
51 -
52 52  == Übersicht ==
53 53  
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.
13 +**Schwarmspeicher Electrify** unterstützt den gesamten Projektlebenszyklus: Standortidentifikation, Genehmigungen, Projektsteuerung und Dokumentation.
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.5
17 +**Frontend:** React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · React Hook Form · Leaflet (Kartendarstellung) · Recharts (Diagramme)
59 59  
60 60  **Backend:** Supabase — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
61 61  
62 -**Tests:** Vitest 3.2.4 · Playwright 1.57.0
63 -
64 64  == Projektstruktur ==
65 65  
66 -macro:code
67 -
23 +{{code}}
68 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
25 + ├── components/ UI-Komponenten
26 + ├── pages/ Seiten der Anwendung
27 + ├── hooks/ Datenzugriffe und Business-Logik
28 + ├── integrations/ Supabase Client
29 + ├── types/ TypeScript-Modelle
30 + └── lib/ Hilfsfunktionen
75 75  
76 76  supabase/
77 -├── migrations/
78 -├── functions/
79 -└── config.toml
33 + ├── migrations/
34 + ├── functions/
35 + └── config.toml
36 +{{/code}}
80 80  
81 -Click and drag to move
82 -
83 83  == Hauptfunktionen ==
84 84  
85 85  === Dashboard ===
86 86  
87 -Zentrale Übersicht über Projekte, Status, offene Aufgaben, Kennzahlen und Projektfortschritt. Für PV Co-Location existiert ein eigenes Dashboard mit Kennzahlen zu aktiven Standorten, Modulleistung, BESS-Leistung, Standortpartnern, Pipeline sowie Plan-/Ist-Werten.
42 +Zentrale Übersicht über Projekte, Status, offene Aufgaben, Kennzahlen und Projektfortschritt (Komponente ##Dashboard.tsx##).
88 88  
89 89  === Projektverwaltung ===
90 90  
91 -Verwaltung aller Batteriespeicherprojekte: anzeigen, Detailansicht, bearbeiten, Projektstatus und Meilensteine. Komponenten: ProjectTable, ProjectDetail. PV Co-Location besitzt eine eigene Projektansicht mit CoLocationProjectTable und CoLocationStandortDetail.
46 +Verwaltung aller Batteriespeicherprojekte: anzeigen, Detailansicht, bearbeiten, Projektstatus, Meilensteine. Komponenten: ProjectTable, ProjectDetail.
92 92  
93 93  === Standortverwaltung ===
94 94  
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.
50 +Standorte anlegen, bearbeiten, importieren, Historie, Dokumente. Komponenten: StandortDetail, CreateStandortForm, StandortImportDialog, StandortDokumente.
96 96  
97 97  === Gemeinden ===
98 98  
99 -Verwaltung der Gemeinden (Komponente CreateGemeindeForm). Zusätzlich existiert eine Supabase Edge Function zum Abruf von NÖ-Gemeinden (supabase/functions/fetch-noe-gemeinden).
54 +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 101  === Kartenansicht ===
102 102  
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.
58 +Darstellung aller Standorte auf einer interaktiven Karte (Leaflet, React Leaflet). Komponenten: ProjectMap, LocationPickerMap.
104 104  
105 105  === Potenzialanalyse ===
106 106  
107 -Bewertung möglicher Standorte. Komponenten: PotenzialTabelle, PotenzialPage. Die Potenzialanalyse ist aktuell dem Schwarmspeicher-Use-Case zugeordnet.
62 +Bewertung möglicher Standorte. Komponenten: PotenzialTabelle, PotenzialPage.
108 108  
109 109  === Pipeline ===
110 110  
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.
66 +Verwaltung von Vorprojekten. Komponenten: VorprojektePipeline, VorprojektTimeline.
112 112  
113 113  === Meilensteinverwaltung ===
114 114  
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.
70 +Projektfortschritt über Meilensteine. Komponenten: MeilensteinMatrix, MeilensteinQuickEdit.
116 116  
117 117  === Aufgabenverwaltung ===
118 118  
119 -Projektbezogene Aufgaben. Komponenten: TaskManager, TasksPage. Hook: useTasks(). PV Co-Location verwendet mit CoTaskManager, CoLocationTasksPage und useCoTasks() eine eigene, vom Schwarmspeicher getrennte Aufgabenliste.
74 +Projektbezogene Aufgaben. Komponenten: TaskManager, TasksPage. Hook: ##useTasks()##.
120 120  
121 121  === Dokumentenverwaltung ===
122 122  
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.
78 +Zu jedem Standort können Dokumente verwaltet werden. Komponenten: StandortDokumente, PartnerDokumente.
124 124  
125 125  === Standortpartner ===
126 126  
127 -Verwaltung von Projektpartnern. Komponenten: StandortpartnerManager, StandortpartnerTable. Für PV Co-Location existieren separate Komponenten und Datenzugriffe für Standortpartner.
82 +Verwaltung von Projektpartnern. Komponenten: StandortpartnerManager, StandortpartnerTable.
128 128  
129 -=== Stockende Projekte ===
130 -
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 -
133 -=== Forecast ===
134 -
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 -
137 -=== PV Co-Location ===
138 -
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 -
141 141  === Benutzerverwaltung ===
142 142  
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().
86 +Anmeldung, Passwortänderung, Rollen. Komponenten: AuthProvider, ProtectedRoute, BenutzerPage, ChangePasswordDialog. Backend: Supabase Authentication.
144 144  
145 145  === Audit Log ===
146 146  
147 -Nachvollziehbarkeit von Änderungen über AuditLogPage und audit_log. Der Zugriff auf das Änderungsprotokoll ist über die vorhandenen Datenbankregeln auf Administratoren eingeschränkt.
90 +Nachvollziehbarkeit von Änderungen (Seite AuditLogPage).
148 148  
149 149  == Routing ==
150 150  
... ... @@ -154,7 +154,6 @@
154 154  |Pipeline|Vorprojekte
155 155  |Potenziale|Standortpotenziale
156 156  |Karte|Kartenansicht
157 -|Stockend|Stockende Projekte / Standorte
158 158  |Forecast|Forecast
159 159  |Aufgaben|Aufgabenverwaltung
160 160  |Audit Log|Änderungsprotokoll
... ... @@ -161,17 +161,11 @@
161 161  |Benutzer|Benutzerverwaltung
162 162  |Login|Anmeldung
163 163  
164 -**Schwarmspeicher-Routen:** / · /projekte · /pipeline · /potenzial · /karte · /stockend · /forecast · /tasks · /benutzer · /historie
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 -
168 168  == Datenzugriff ==
169 169  
170 -Der Zugriff erfolgt über Custom Hooks, die die Kommunikation mit Supabase kapseln. React Query übernimmt Laden, Mutationen und Cache-Invalidierung.
108 +Der Zugriff erfolgt über Custom Hooks, die sämtliche Kommunikation mit Supabase kapseln:
171 171  
172 -macro:code
173 -
174 -Schwarmspeicher:
110 +{{code}}
175 175  useStandorte()
176 176  useGemeinden()
177 177  useVorprojekte()
... ... @@ -179,66 +179,34 @@
179 179  usePotenzialDaten()
180 180  useStandortpartner()
181 181  useMonatsziele()
182 -useDokumente()
118 +{{/code}}
183 183  
184 -PV Co-Location:
185 -useCoLocationStandorte()
186 -useCoLocationStandortpartner()
187 -useCoVorprojekte()
188 -useCoTasks()
189 -useCoMonatsziele()
190 -useCoDokumente()
191 -
192 -Click and drag to move
193 -
194 194  == Supabase ==
195 195  
196 -**Authentication:** Login, Passwortänderung, Rollenverwaltung und geschützte Routen.
122 +**Authentication:** Login, Passwortänderung, Rollenverwaltung.
197 197  
198 -**Datenbank:** Wird über SQL-Migrationen verwaltet (supabase/migrations/). Die Migrationen definieren Tabellen, Policies und Datenbankfunktionen.
124 +**Datenbank:** Wird über SQL-Migrationen verwaltet (##supabase/migrations/##). Die Migrationen definieren Tabellen, Policies und Datenbankfunktionen.
199 199  
200 -**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.
201 -
202 -**Audit:** Änderungen werden über audit_log und Datenbank-Trigger protokolliert; die Audit-Funktion ist gegen direkte Ausführung durch PUBLIC/anon/authenticated gehärtet.
203 -
204 204  **Edge Functions:**
205 205  
206 -* fetch-noe-gemeinden — lädt Gemeinden aus Niederösterreich
207 -* manage-users — Benutzerverwaltung
128 +* ##fetch-noe-gemeinden## — lädt Gemeinden aus Niederösterreich
129 +* ##manage-users## — Benutzerverwaltung
208 208  
209 -macro:info
210 -
211 -Information
212 -
213 -**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.
214 -
215 -Click and drag to move
216 -
217 217  == Architektur ==
218 218  
219 -macro:mermaid
220 -
221 -macro:velocity
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
133 +{{mermaid}}
134 +flowchart TD
135 + FE["React Frontend"] --> RQ["React Query"]
231 231   RQ --> SC["Supabase Client"]
232 232   SC --> AUTH["Auth"]
233 - SC --> DBS["Database / RLS"]
138 + SC --> DBS["Database"]
234 234   SC --> ST["Storage"]
235 235   DBS --> EF["Edge Functions"]
236 - DBS --> AL["Audit Log / Trigger"]}}}
141 +{{/mermaid}}
237 237  
238 -Click and drag to move
239 -
240 240  == Server ==
241 241  
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.
145 +Das Projekt liegt unter ##/mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal## und läuft in einem Docker-Compose-Stack (##schwarmspeicher-electrify_lokal##).
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.
147 +Erreichbar unter [[http://schwarmspeicher.spl-tele.com:8200>>http://schwarmspeicher.spl-tele.com:8200/]] — mit VPN und im SPL-TELE-Netzwerk.
148 +
noavatar.png
Author
... ... @@ -1,1 +1,0 @@
1 -XWiki.drupp
Size
... ... @@ -1,1 +1,0 @@
1 -5.6 KB
Content