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 6.1
edited by Patrizia Gurschka
on 2026/09/09 14:24
Change comment: There is no comment for this version

Summary

Details

Page properties
Content
... ... @@ -1,154 +1,160 @@
1 -macro:box
1 += 🔋  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:toc
6 +• 🔋 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 -= 🔋 Schwarmspeicher Electrify =
18 +▪ Projektverwaltung
43 43  
44 -macro:info
20 +▪ Standortverwaltung
45 45  
46 -Information
22 +▪ 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 -Click and drag to move
26 +▪ Potenzialanalyse
51 51  
52 -== Übersicht ==
28 +▪ Pipeline
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.
30 +▪ Meilensteinverwaltung
55 55  
56 -== Technologie-Stack ==
32 +▪ Aufgabenverwaltung
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
34 +▪ Dokumentenverwaltung
59 59  
60 -**Backend:** Supabase — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
36 +▪ Standortpartner
61 61  
62 -**Tests:** Vitest 3.2.4 · Playwright 1.57.0
38 +▪ Stockende Projekte
63 63  
64 -== Projektstruktur ==
40 +▪ Forecast
65 65  
66 -macro:code
42 +▪ PV Co-Location
67 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
44 +▪ Benutzerverwaltung
75 75  
76 -supabase/
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/
77 77  ├── migrations/
78 78  ├── functions/
79 79  └── config.toml
80 80  
81 -Click and drag to move
82 82  
83 -== Hauptfunktionen ==
84 84  
85 -=== Dashboard ===
89 +Hauptfunktionen
86 86  
91 +Dashboard
92 +
87 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.
88 88  
89 -=== Projektverwaltung ===
95 +Projektverwaltung
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|=Beschreibung
157 +|**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 über Custom Hooks, die die Kommunikation mit Supabase kapseln. React Query übernimmt Laden, Mutationen und Cache-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:code
176 +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-Migrationen verwaltet (supabase/migrations/). Die Migrationen definieren Tabellen, Policies und Datenbankfunktionen.
201 +**Authentication: **Login, Passwortänderung, Rollenverwaltung und geschützte Routen.
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.
203 +**Datenbank: **Wird über SQL-Migrationen verwaltet (supabase/migrations/). Die Migrationen definieren Tabellen, Policies und Datenbankfunktionen.
201 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.
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 -macro:info
213 +• manage-users — Benutzerverwaltung
210 210  
211 -Information
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.
212 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.
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:velocity
234 +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.