Skip to Content

Wiki source code of Schwarmspeicher Electrify

Last modified by Patrizia Gurschka on 2026/10/19 16:08
Show last authors
1 |(% style="width:650px" %)(((
2 = 🔋  Schwarmspeicher Electrify =
3
4 {{info}}
5 **Zweck:** Webbasiertes Projektmanagementsystem zur Verwaltung von Batterie-Großspeicherprojekten in Deutschland und Österreich – vom Standort über Genehmigungen bis zur Projektsteuerung und Dokumentation. Deckt zwei Use-Cases ab: klassische Schwarmspeicher-Standorte und PV-Co-Location-Standorte. Externe Akquisiteure arbeiten in einem eigenen, eingeschränkten Bereich nur an den ihnen zugeteilten Schwarmspeicher-Standorten.
6
7 **Zielgruppe: **Vertriebs-/Projektentwicklungsteam und IT/DevOps-Betrieb.
8 {{/info}}
9 )))|(% style="width:418px" %)(((
10 **Auf dieser Seite**
11
12 {{toc/}}
13
14
15 )))
16
17 = Ăśberblick =
18
19 Schwarmspeicher Electrify unterstützt den gesamten Projektlebenszyklus: Standortidentifikation, Akquise, Genehmigungen, Projektsteuerung und Dokumentation — für beide Use-Cases parallel, über einen Umschalter in der Seitenleiste.
20
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, Straßenkarte) · basemap.at (Luftbild) · Edge Function fetch-noe-gemeinden (NÖ-Gemeindedaten) · EVN-Trafokarte (WMS-Layer, Netzkapazitäten, UW-Versorgungsgebiete) · Netz NÖ (Kapazitätsliste der Umspannwerke) · Tabelle trafo_stationen (Trafostationen, einmalig aus der EVN-Trafokarte übernommen, danach eigene Bearbeitung) · BEV-Kataster (Grundstücksgrenzen per WMS, Gst.Nr/Einlagezahl/KG-Nr per Vektorkacheln) · Land NÖ OGD (Windkraftzonen und Windkraftanlagen) · OpenStreetMap/Overpass (Positionen der Umspannwerke)
24 * **Orchestrierung:** eigener Docker-Compose-Stack, nginx als Reverse-Proxy (TLS-Terminierung + same-origin-Routing zu Supabase/Kong)
25
26 = Architektur =
27
28 [[image:Architektur_Schwarmspeicher.png||height="510" width="537"]]
29
30 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
31
32 = Technologie-Stack =
33
34 **Frontend:** React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · Leaflet + leaflet.markercluster (Kartendarstellung) · Recharts (Diagramme) · XLSX (Excel-Import/-Export)
35
36 **Backend:** Supabase (self-hosted) — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
37
38 = Hauptfunktionen =
39
40 == 1. Dashboard ==
41
42 Zentrale Ăśbersicht ĂĽber Projekte, Status, Kennzahlen und Projektfortschritt.
43
44 * **Schwarmspeicher:** Dashboard.tsx — Pipeline-Summary (Vorprojekte und Standorte in Akquise, darunter die Anzahl in Akquise), kW/kWh-KPIs, Plan-vs-Ist-Charts pro Meilenstein. Standorte in Akquise zählen in den Standort-Kennzahlen erst ab „Vollmacht erhalten“.
45 * **PV-Co-Location:** CoLocationDashboard.tsx — gleiche Struktur, Einheiten angepasst (kWp/kW), zweite Übersichtskarte zeigt Standortpartner-Anzahl statt Gemeinden
46
47 == 2. Projektverwaltung / Standortverwaltung ==
48
49 Standorte anlegen, bearbeiten, importieren, Historie, Dokumente, sortierbare Tabelle mit Meilenstein- und Akquisiteur-Filter, Bulk-Bearbeitung, Als-abgebrochen-markieren/Reaktivieren.
50
51 * **Schwarmspeicher:** ProjectTable, StandortDetail, CreateStandortFormNew, StandortImportDialog, StandortDokumente, AbbruchDialog, StandortAusscheiden, MeilensteinQuickEdit, MeilensteinMatrix, BulkEditStandortDialog, BatterieKandidaten
52 * **PV-Co-Location:** CoLocationProjectTable, CoLocationStandortDetail, CreateCoLocationForm, CoLocationImportDialog, CoLocationStandortDokumente, CoLocationAbbruchDialog, CoLocationMeilensteinQuickEdit, CoLocationMeilensteinMatrix, CoLocationBulkEditDialog
53
54 Unter „Projekte“ erscheinen Standorte, die über „Zur Akquise freigeben“ entstanden sind, erst ab dem Meilenstein „Vollmacht erhalten“; davor stehen sie in der Pipeline unter „In Akquise“. Die Seite hat die Tabs Standorte, Meilensteine und Standortpartner; die Buttons oben rechts richten sich nach dem Tab (Standorte: Import und Standort anlegen, Standortpartner: Neuer Standortpartner).
55
56 Im Standort-Dialog können alle Rollen einen Standort mit Begründung ausscheiden (die verknüpfte Trafostation wird mit ausgeschieden); Reaktivieren ist nur intern möglich. Das Feld „Betreuung“ wählt der Leiter bzw. seine Stellvertretung aus seinem Team. Die Batterie-Standorte werden als Rangliste (bis zu 4) mit Akzeptieren/Verwerfen und Eigentümerdaten geführt; Eigentümerdaten sind auch im Bearbeiten-Modus erfassbar. Hat ein Standort noch keine Rangliste, legt „Eigentümer erfassen“ den Batterie-Standort 1 aus der aktuellen Position an.
57
58 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.
59
60 === Meilensteinverwaltung ===
61
62 Projektfortschritt ĂĽber Meilensteine, matrixartige Ăśbersicht mit Bulk-Setzen, Gruppierung.
63
64 * **Schwarmspeicher:** MeilensteinMatrix, MeilensteinQuickEdit (inkl. Sonderfall-Dialog NetzvertragAnpassungDialog). Die Akquise-Meilensteine (Vollmacht gesendet/erhalten, Optionsvertrag gesendet/erhalten, Pachtvertrag unterschrieben) dĂĽrfen auch externe Akquisiteure setzen.
65 * **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)
66
67 == 3. Gemeinden ==
68
69 Verwaltung der Gemeinden (CreateGemeindeForm, nur Schwarmspeicher). Edge Function fetch-noe-gemeinden lädt NÖ-Gemeinden.
70
71 == 4. Kartenansicht ==
72
73 Interaktive Karte aller Standorte (Leaflet + Clustering), Adress- und Koordinatensuche, Vollbildmodus, Flächenauswahl (Shift+Ziehen), Zoom bis Stufe 21, Umschaltung Straßenkarte/Luftbild (basemap.at), Trafokarte-NÖ-Layer mit Legende.
74
75 * **Schwarmspeicher:** ProjectMap — Ebenen Trafokarte NÖ, Grundstücke (BEV-Kataster), Umspannwerke (Versorgungsgebiete mit Kapazität, Akquisiteur-Zuteilung je Gebiet, UW-Standorte als Dreiecke; mehrere UW am selben Ort als ein Dreieck mit Anzahl), Windkraft (Windkraftzonen und Windkraftanlagen des Landes NÖ). Klick auf eine Trafostation öffnet TrafoStationSheet mit „Zur Akquise freigeben“.
76 * **PV-Co-Location:** CoLocationMap
77 * **Gemeinsam genutzt:** LocationPickerMap (Einzelstandort-Kartenauswahl, Großbild über das ganze Fenster), KartenSuche (Adresse, Ort, PLZ oder Koordinaten), src/lib/mapCoordinates.ts (dedupeCoordinates — verhindert sofortiges Auftrennen bei identischen Koordinaten), src/lib/kartenZoom.ts, src/lib/koordinatenSuche.ts, src/lib/windkraft.ts
78
79 Die UW-Standorte werden aus OpenStreetMap (Overpass) importiert oder von Admins im Gebiets-MenĂĽ von Hand gesetzt (von Hand gesetzte Punkte ĂĽberschreibt der Import nicht). Umspannwerke der Netz-NĂ–-Liste ohne eigenes EVN-Gebiet (z. B. Windpark-Umspannwerke) werden unter dem SchlĂĽssel kap:<Name> gefĂĽhrt. Abweichende Schreibweisen zwischen Netz-NĂ–-Liste und EVN-Gebiet werden in der Tabelle uw_namen zugeordnet.
80
81 **Zur Akquise freigeben:** Im Dialog werden Name, Akquisiteur (vorbelegt aus dem UW-Gebiet) und bis zu 4 Batterie-Standorte nach Priorität festgelegt. Die Freigabe legt den Standort an (Netzbetreiber „Netz NÖ“), verknüpft die Trafostation und erstellt die Rangliste der Batterie-Standorte. Eine Trafostation kann nur einmal freigegeben werden.
82
83 == 5. Potenzialanalyse ==
84
85 Bewertung möglicher Standorte (PotenzialTabelle, PotenzialPage) — nur Schwarmspeicher, kein Pendant bei PV-Co-Location.
86
87 == 6. Pipeline ==
88
89 * **Schwarmspeicher:** zwei Reiter — **Vorprojekte** (VorprojektePipeline, VorprojektTimeline; Kennzahlen Vorprojekte, Pot. Standorte, Pot. BESS, Pot. kW, Pot. kWh; ohne Realisierungswahrscheinlichkeit und ohne Gewonnen/Verloren) und **In Akquise** (AkquisePipeline; zur Akquise freigegebene Standorte bis „Vollmacht erhalten“, Filter nach Akquisiteur, Kennzahlen, Spalten Gemeinde, Netzbetreiber, Trafo mit Koordinaten, Akquisiteur, Freigabedatum, letzter Meilenstein)
90 * **PV-Co-Location:** CoLocationPipeline (Felder an kWp/BESS-kW angepasst; kein Pendant zu VorprojektTimeline)
91
92 == 7. Stockend ==
93
94 Zeigt Standorte, bei denen die Lead-Time zwischen zwei Meilensteinen ĂĽberschritten ist, konfigurierbare Regeln.
95
96 * **Schwarmspeicher:** StuckPage
97 * **PV-Co-Location:** CoLocationStuckPage (eigene, getrennt gespeicherte Lead-Time-Regeln entlang der neuen Meilensteinkette)
98
99 == 8. Forecast ==
100
101 Monatliche Zielvorgaben, Plan-vs-Ist-Charts pro Kennzahl.
102
103 * **Schwarmspeicher:** ForecastPage (kW und kWh pro Monat/Meilenstein, nach Land AT/DE getrennt)
104 * **PV-Co-Location:** CoLocationForecastPage — 4 KPI-Charts entlang Netzantrag gestellt / Netzvertrag erhalten / Standort gebaut / Standort live Trading (kein Land-Split)
105
106 == 9. Aufgabenverwaltung ==
107
108 Projektbezogene Aufgaben, jeweils eigene, komplett getrennte Liste pro Use-Case.
109
110 * **Schwarmspeicher:** TaskManager, TasksPage, Hook useTasks()
111 * **PV-Co-Location:** CoTaskManager, CoLocationTasksPage, Hook useCoTasks()
112
113 == 10. Dokumentenverwaltung ==
114
115 Zu jedem Standort und jedem Standortpartner können Dokumente hochgeladen werden.
116
117 * **Schwarmspeicher:** StandortDokumente, PartnerDokumente, Hook useDokumente()
118 * **PV-Co-Location:** CoLocationStandortDokumente, CoLocationPartnerDokumente, Hook useCoDokumente() — eigener Storage-Bucket co-dokumente
119
120 == 11. Standortpartner ==
121
122 Verwaltung von Projektpartnern, eigene, komplett getrennte Partnerliste pro Use-Case.
123
124 * **Schwarmspeicher:** StandortpartnerTable (Tab „Standortpartner“ unter Projekte)
125 * **PV-Co-Location:** CoLocationStandortpartnerManager, CoLocationStandortpartnerTable
126
127 == 12. Benutzerverwaltung ==
128
129 Anmeldung, Passwortänderung, Rollen (admin/user/akquisiteur). 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; externe Akquisiteure auf "/meine-standorte".
130
131 Zusätzliche Rechte: „Akquise zuteilen“ (kann_akquise_zuteilen — Trafostationen freigeben und Akquisiteure zuteilen) und „sich selbst zuteilen“ (kann_sich_selbst_zuteilen — sich selbst als Akquisiteur eintragen). Bei externen Akquisiteuren werden in der Benutzerverwaltung der Leiter und optional die Stellvertretung festgelegt (siehe 16.).
132
133 == 13. Audit Log ==
134
135 Nachvollziehbarkeit von Ă„nderungen (AuditLogPage), tabellenĂĽbergreifend ĂĽber beide Use-Cases.
136
137 == 14. Akquisiteure ==
138
139 Performance-Übersicht der Akquisiteure (AkquisiteurePerformancePage, AkquisiteurVerlaufCharts) — nur Schwarmspeicher, nur intern. Erfolg ist der Meilenstein „Vollmacht erhalten“.
140
141 * Kennzahlen im wählbaren Zeitraum (30 / 90 Tage, 12 Monate, gesamt): aktive Akquisiteure, in Akquise, ohne Meilenstein seit über 30 Tagen, neu freigegeben, Vollmachten erhalten, Erfolgsquote
142 * Tabelle je Akquisiteur, sortierbar; zugeordnete Akquisiteure stehen unter ihrem Leiter
143 * Verlauf je Kalenderjahr fĂĽr Freigegeben, Vollmacht gesendet/erhalten und Optionsvertrag gesendet/erhalten, umschaltbar kumuliert/Monatswerte
144
145 == 15. Externe Akquisiteure und Teams ==
146
147 Externe Akquisiteure (Rolle akquisiteur) sehen nur „Meine Standorte“ (AkquisiteurPage, AkquisiteurStandortTabelle) mit ihren Standorten, Meilensteinen, Dokumenten, Batterie-Standorten und Tasks.
148
149 * **Leiter:** Akquisiteur, dem andere Akquisiteure zugeordnet sind. Seine Standorte bleiben ihm zugeteilt; im Feld „Betreuung“ gibt er sie an ein Teammitglied weiter und sieht sie weiterhin in der Tabelle „An Team übergeben“.
150 * **Betreuer:** bearbeitet den Standort mit denselben Rechten wie einen eigenen.
151 * **Stellvertretung:** ĂĽbernimmt die Rolle des Leiters, betreut automatisch alle seine Standorte und vergibt die Betreuung im Team.
152
153 = Routing =
154
155 |**Pfad**|**Seite**|**Use-Case**|**Login nötig**
156 |/|Dashboard|Schwarmspeicher|ja
157 |/projekte|Standorte|Schwarmspeicher|ja
158 |/pipeline|Vorprojekte / In Akquise|Schwarmspeicher|ja
159 |/potenzial|Potenzialanalyse|Schwarmspeicher|ja
160 |/karte|Kartenansicht|Schwarmspeicher|ja
161 |/forecast|Forecast|Schwarmspeicher|ja
162 |/tasks|Aufgaben|Schwarmspeicher|ja
163 |/stockend|Stockende Standorte|Schwarmspeicher|ja
164 |/akquisiteure|Akquisiteure|Schwarmspeicher|ja
165 |/meine-standorte|Meine Standorte|– (externe Akquisiteure)|ja
166 |/benutzer|Benutzerverwaltung|– (Admin)|ja
167 |/historie|Audit Log|– (Admin)|ja
168 |/pv-colocation|Dashboard|PV-Co-Location|ja
169 |/pv-colocation/projekte|Standorte|PV-Co-Location|ja
170 |/pv-colocation/pipeline|Vorprojekte|PV-Co-Location|ja
171 |/pv-colocation/karte|Kartenansicht|PV-Co-Location|ja
172 |/pv-colocation/forecast|Forecast|PV-Co-Location|ja
173 |/pv-colocation/tasks|Aufgaben|PV-Co-Location|ja
174 |/pv-colocation/stockend|Stockende Standorte|PV-Co-Location|ja
175
176
177
178 = Datenzugriff =
179
180 Der Zugriff erfolgt über Custom Hooks, die sämtliche Kommunikation mit Supabase kapseln:
181
182 ~/~/ Schwarmspeicher
183
184 useStandorte()   useGemeinden()   useVorprojekte()
185
186 useTasks()       usePotenzialDaten()   useStandortpartner()
187
188 useMonatsziele() useDokumente()   useIsAdmin()
189
190 useAkquisePhase()   useTrafoStationen()   useBatterieKandidaten()
191
192 useAkquisiteurTeam   useKannZuteilen()   useUwZuteilungen()
193
194 useUwKapazitaeten()
195
196
197 ~/~/ PV-Co-Location
198
199 useCoLocationStandorte()        useCoLocationStandortpartner()
200
201 useCoVorprojekte()   useCoTasks()   useCoMonatsziele()   useCoDokumente()
202
203
204 ~/~/ Use-Case-ĂĽbergreifend
205
206 useUseCase()   useAuth()
207
208 = Supabase =
209
210 **Authentication:** Login, Passwortänderung, Rollenverwaltung.
211
212 **Datenbank:** Wird ĂĽber SQL-Migrationen verwaltet (supabase/migrations/), inkl. komplettes PV-Co-Location-Schema: co_standorte, co_standortpartner, co_prozessschritte, co_vorprojekte, co_monatsziele, co_dokumente, co_tasks. FĂĽr die Schwarmspeicher-Akquise u. a. trafo_stationen, standort_batterie_kandidaten, uw_kapazitaeten, uw_namen, uw_standorte, uw_zuteilungen und akquisiteur_team sowie das Feld standorte.betreuer_id. Die Rechte externer Akquisiteure laufen ĂĽber RLS mit den Funktionen akquise_standort_zugriff() und is_own_akquise_standort() (zugeteilt, betreut oder Stellvertretung des Leiters).
213
214 **Edge Functions:**
215
216 * fetch-noe-gemeinden — lädt Gemeinden aus Niederösterreich
217 * manage-users — Benutzerverwaltung, prüft Admin-Berechtigung serverseitig
218 * public-lead-intake — nimmt Anfragen der öffentlichen Landingpage entgegen
219 * uw-kapazitaeten-aktualisieren — lädt die Kapazitätsliste der Umspannwerke von Netz NÖ
220 * uw-trafos-zuordnen — ordnet Trafostationen den UW-Gebieten zu
221 * grundstuecke-ermitteln — ermittelt Grundstücksdaten zu Standorten
222
223 **Storage:** zwei Buckets — dokumente (Schwarmspeicher) und co-dokumente (PV-Co-Location).
224
225 = Use-Case-Umschalter =
226
227 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.
228
229 = Server =
230
231 Das Projekt liegt unter /mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal und läuft in einem eigenständigen Docker-Compose-Stack (schwarmspeicher-electrify_lokal).
232
233 Erreichbar unter:
234
235 Ă–ffentlich: https:~/~/schwarmspeicher.electrify.at:8200 (Wildcard-Zertifikat *.electrify.at, Let's Encrypt, gĂĽltig bis 13.01.2027)
236
237 Supabase (Postgres, Auth, Kong, Storage, Edge Functions) läuft als eigener Docker-Compose-Stack im selben Docker-Netzwerk wie der Frontend-Container. Edge Functions werden über einen zentralen main-Router an die jeweilige Unterfunktion weitergereicht; das Verzeichnis liegt unter /mnt/data/supabase/docker/docker/volumes/functions/.