Skip to Content

Changes for page Schwarmspeicher Electrify

Last modified by Patrizia Gurschka on 2026/09/10 14:58
From version 6.1
edited by Patrizia Gurschka
on 2026/09/09 14:24
Change comment: There is no comment for this version
To version 5.1
edited by Patrizia Gurschka
on 2026/09/09 14:21
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,160 +1,154 @@
1 -= 🔋  Schwarmspeicher Electrify =
1 +macro:box
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.|(((
4 4  **Auf dieser Seite**
5 5  
6 -• 🔋 Schwarmspeicher Electrify
5 +macro:toc
7 7  
8 -• Übersicht
7 +* (((
8 +[[🔋 Schwarmspeicher Electrify>>path:#HD83DDD0BSchwarmspeicherElectrify]]
9 9  
10 -• Technologie-Stack
10 +* [[Übersicht>>path:#HDCbersicht]]
11 +* [[Technologie-Stack>>path:#HTechnologie-Stack]]
12 +* [[Projektstruktur>>path:#HProjektstruktur]]
13 +* (((
14 +[[Hauptfunktionen>>path:#HHauptfunktionen]]
11 11  
12 -• Projektstruktur
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 +)))
13 13  
14 -• Hauptfunktionen
15 15  
16 -▪ Dashboard
17 17  
18 -▪ Projektverwaltung
42 += 🔋 Schwarmspeicher Electrify =
19 19  
20 -▪ Standortverwaltung
44 +macro:info
21 21  
22 -▪ Gemeinden
46 +Information
23 23  
24 -▪ Kartenansicht
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**.
25 25  
26 -▪ Potenzialanalyse
50 +Click and drag to move
27 27  
28 -▪ Pipeline
52 +== Übersicht ==
29 29  
30 -▪ Meilensteinverwaltung
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.
31 31  
32 -▪ Aufgabenverwaltung
56 +== Technologie-Stack ==
33 33  
34 -▪ Dokumentenverwaltung
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
35 35  
36 -▪ Standortpartner
60 +**Backend:** Supabase — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
37 37  
38 -▪ Stockende Projekte
62 +**Tests:** Vitest 3.2.4 · Playwright 1.57.0
39 39  
40 -▪ Forecast
64 +== Projektstruktur ==
41 41  
42 -▪ PV Co-Location
66 +macro:code
43 43  
44 -▪ Benutzerverwaltung
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
45 45  
46 -▪ Audit Log
47 -
48 -• Routing
49 -
50 -• Datenzugriff
51 -
52 -• Supabase
53 -
54 -• Architektur
55 -
56 -• Server
57 -)))
58 -
59 -
60 -
61 -Übersicht
62 -
63 -**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.
64 -
65 -Technologie-Stack
66 -
67 -**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
68 -
69 -**Backend: **Supabase — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
70 -
71 -**Tests: **Vitest 3.2.4 · Playwright 1.57.0
72 -
73 -Projektstruktur
74 -
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/
76 +supabase/
83 83  ├── migrations/
84 84  ├── functions/
85 85  └── config.toml
86 86  
81 +Click and drag to move
87 87  
83 +== Hauptfunktionen ==
88 88  
89 -Hauptfunktionen
85 +=== Dashboard ===
90 90  
91 -Dashboard
92 -
93 93  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.
94 94  
95 -Projektverwaltung
89 +=== Projektverwaltung ===
96 96  
97 97  Verwaltung aller Batteriespeicherprojekte: anzeigen, Detailansicht, bearbeiten, Projektstatus und Meilensteine. Komponenten: ProjectTable, ProjectDetail. PV Co-Location besitzt eine eigene Projektansicht mit CoLocationProjectTable und CoLocationStandortDetail.
98 98  
99 -Standortverwaltung
93 +=== Standortverwaltung ===
100 100  
101 101  Standorte anlegen, bearbeiten, importieren, Historie und Dokumente. Komponenten: StandortDetail, CreateStandortForm, StandortImportDialog, StandortDokumente. PV Co-Location ergänzt eigene Formulare, Import, Bulk-Edit und Detailansichten.
102 102  
103 -Gemeinden
97 +=== Gemeinden ===
104 104  
105 105  Verwaltung der Gemeinden (Komponente CreateGemeindeForm). Zusätzlich existiert eine Supabase Edge Function zum Abruf von NÖ-Gemeinden (supabase/functions/fetch-noe-gemeinden).
106 106  
107 -Kartenansicht
101 +=== Kartenansicht ===
108 108  
109 109  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.
110 110  
111 -Potenzialanalyse
105 +=== Potenzialanalyse ===
112 112  
113 113  Bewertung möglicher Standorte. Komponenten: PotenzialTabelle, PotenzialPage. Die Potenzialanalyse ist aktuell dem Schwarmspeicher-Use-Case zugeordnet.
114 114  
115 -Pipeline
109 +=== Pipeline ===
116 116  
117 117  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.
118 118  
119 -Meilensteinverwaltung
113 +=== Meilensteinverwaltung ===
120 120  
121 121  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.
122 122  
123 -Aufgabenverwaltung
117 +=== Aufgabenverwaltung ===
124 124  
125 125  Projektbezogene Aufgaben. Komponenten: TaskManager, TasksPage. Hook: useTasks(). PV Co-Location verwendet mit CoTaskManager, CoLocationTasksPage und useCoTasks() eine eigene, vom Schwarmspeicher getrennte Aufgabenliste.
126 126  
127 -Dokumentenverwaltung
121 +=== Dokumentenverwaltung ===
128 128  
129 129  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.
130 130  
131 -Standortpartner
125 +=== Standortpartner ===
132 132  
133 133  Verwaltung von Projektpartnern. Komponenten: StandortpartnerManager, StandortpartnerTable. Für PV Co-Location existieren separate Komponenten und Datenzugriffe für Standortpartner.
134 134  
135 -Stockende Projekte
129 +=== Stockende Projekte ===
136 136  
137 137  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.
138 138  
139 -Forecast
133 +=== Forecast ===
140 140  
141 141  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.
142 142  
143 -PV Co-Location
137 +=== PV Co-Location ===
144 144  
145 145  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.
146 146  
147 -Benutzerverwaltung
141 +=== Benutzerverwaltung ===
148 148  
149 149  Anmeldung, Passwortänderung und Rollen. Komponenten: AuthProvider, ProtectedRoute, BenutzerPage, ChangePasswordDialog. Backend: Supabase Authentication. Die Anwendung unterstützt zudem eine verpflichtende Passwortänderung über useMustChangePassword().
150 150  
151 -Audit Log
145 +=== Audit Log ===
152 152  
153 153  Nachvollziehbarkeit von Änderungen über AuditLogPage und audit_log. Der Zugriff auf das Änderungsprotokoll ist über die vorhandenen Datenbankregeln auf Administratoren eingeschränkt.
154 154  
155 -Routing
149 +== Routing ==
156 156  
157 -|**Seite**|**Beschreibung**
151 +|=Seite|=Beschreibung
158 158  |Dashboard|Startseite
159 159  |Projekte|Projektübersicht
160 160  |Pipeline|Vorprojekte
... ... @@ -167,17 +167,17 @@
167 167  |Benutzer|Benutzerverwaltung
168 168  |Login|Anmeldung
169 169  
164 +**Schwarmspeicher-Routen:** / · /projekte · /pipeline · /potenzial · /karte · /stockend · /forecast · /tasks · /benutzer · /historie
170 170  
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
171 171  
172 -**Schwarmspeicher-Routen: **/ · /projekte · /pipeline · /potenzial · /karte · /stockend · /forecast · /tasks · /benutzer · /historie
168 +== Datenzugriff ==
173 173  
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
175 -
176 -Datenzugriff
177 -
178 178  Der Zugriff erfolgt über Custom Hooks, die die Kommunikation mit Supabase kapseln. React Query übernimmt Laden, Mutationen und Cache-Invalidierung.
179 179  
180 -|Schwarmspeicher:
172 +macro:code
173 +
174 +Schwarmspeicher:
181 181  useStandorte()
182 182  useGemeinden()
183 183  useVorprojekte()
... ... @@ -186,7 +186,8 @@
186 186  useStandortpartner()
187 187  useMonatsziele()
188 188  useDokumente()
189 -\\PV Co-Location:
183 +
184 +PV Co-Location:
190 190  useCoLocationStandorte()
191 191  useCoLocationStandortpartner()
192 192  useCoVorprojekte()
... ... @@ -194,45 +194,56 @@
194 194  useCoMonatsziele()
195 195  useCoDokumente()
196 196  
192 +Click and drag to move
197 197  
194 +== Supabase ==
198 198  
199 -Supabase
196 +**Authentication:** Login, Passwortänderung, Rollenverwaltung und geschützte Routen.
200 200  
201 -**Authentication: **Login, Passwortänderung, Rollenverwaltung und geschützte Routen.
198 +**Datenbank:** Wird über SQL-Migrationen verwaltet (supabase/migrations/). Die Migrationen definieren Tabellen, Policies und Datenbankfunktionen.
202 202  
203 -**Datenbank: **Wird über SQL-Migrationen verwaltet (supabase/migrations/). Die Migrationen definieren Tabellen, Policies und Datenbankfunktionen.
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.
204 204  
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.
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.
206 206  
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 -
209 209  **Edge Functions:**
210 210  
211 -• fetch-noe-gemeinden — lädt Gemeinden aus Niederösterreich
206 +* fetch-noe-gemeinden — lädt Gemeinden aus Niederösterreich
207 +* manage-users — Benutzerverwaltung
212 212  
213 -• manage-users — Benutzerverwaltung
209 +macro:info
214 214  
215 -|**ⓘ  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.
211 +Information
216 216  
217 -Architektur
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.
218 218  
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"]
215 +Click and drag to move
231 231  
217 +== Architektur ==
232 232  
219 +macro:mermaid
233 233  
234 -Server
221 +macro:velocity
235 235  
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 +
236 236  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.
237 237  
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.
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.