Wiki source code of Schwarmspeicher Electrify

Last modified by Patrizia Gurschka on 2026/10/19 16:08

version	line-number	content
17.1	1	\|(% style="width:650px" %)(((
11.2	2	= 🔋 Schwarmspeicher Electrify =
1.1	3
10.2	4	{{info}}
28.3	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.
8.2	6
	7	Zielgruppe: Vertriebs-/Projektentwicklungsteam und IT/DevOps-Betrieb.
10.2	8	{{/info}}
17.1	9	)))\|(% style="width:418px" %)(((
15.1	10	Auf dieser Seite
8.2	11
15.1	12	{{toc/}}
	13
	14
	15	)))
	16
29.2	17	= Überblick =
15.1	18
29.2	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.
15.1	20
22.1	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)
29.2	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)
22.1	24	* Orchestrierung: eigener Docker-Compose-Stack, nginx als Reverse-Proxy (TLS-Terminierung + same-origin-Routing zu Supabase/Kong)
21.2	25
29.2	26	= Architektur =
18.1	27
29.2	28	[[image:Architektur_Schwarmspeicher.png\|\|height="510" width="537"]]
18.1	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
29.2	32	= Technologie-Stack =
15.1	33
29.2	34	Frontend: React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · Leaflet + leaflet.markercluster (Kartendarstellung) · Recharts (Diagramme) · XLSX (Excel-Import/-Export)
15.1	35
29.2	36	Backend: Supabase (self-hosted) — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
15.1	37
29.2	38	= Hauptfunktionen =
1.1	39
29.2	40	== 1. Dashboard ==
6.1	41
8.2	42	Zentrale Übersicht über Projekte, Status, Kennzahlen und Projektfortschritt.
1.1	43
29.2	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
1.1	46
29.2	47	== 2. Projektverwaltung / Standortverwaltung ==
1.1	48
29.2	49	Standorte anlegen, bearbeiten, importieren, Historie, Dokumente, sortierbare Tabelle mit Meilenstein- und Akquisiteur-Filter, Bulk-Bearbeitung, Als-abgebrochen-markieren/Reaktivieren.
1.1	50
29.2	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
1.1	53
29.2	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
8.2	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.
1.1	59
29.2	60	=== Meilensteinverwaltung ===
27.2	61
	62	Projektfortschritt über Meilensteine, matrixartige Übersicht mit Bulk-Setzen, Gruppierung.
	63
29.2	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)
27.2	66
29.2	67	== 3. Gemeinden ==
1.1	68
8.2	69	Verwaltung der Gemeinden (CreateGemeindeForm, nur Schwarmspeicher). Edge Function fetch-noe-gemeinden lädt NÖ-Gemeinden.
1.1	70
29.2	71	== 4. Kartenansicht ==
1.1	72
29.2	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.
1.1	74
29.2	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
1.1	78
29.2	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.
1.1	80
29.2	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
8.2	85	Bewertung möglicher Standorte (PotenzialTabelle, PotenzialPage) — nur Schwarmspeicher, kein Pendant bei PV-Co-Location.
1.1	86
29.2	87	== 6. Pipeline ==
1.1	88
29.2	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)
1.1	91
29.2	92	== 7. Stockend ==
1.1	93
8.2	94	Zeigt Standorte, bei denen die Lead-Time zwischen zwei Meilensteinen überschritten ist, konfigurierbare Regeln.
1.1	95
29.2	96	* Schwarmspeicher: StuckPage
	97	* PV-Co-Location: CoLocationStuckPage (eigene, getrennt gespeicherte Lead-Time-Regeln entlang der neuen Meilensteinkette)
1.1	98
29.2	99	== 8. Forecast ==
5.1	100
8.2	101	Monatliche Zielvorgaben, Plan-vs-Ist-Charts pro Kennzahl.
5.1	102
29.2	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)
5.1	105
29.2	106	== 9. Aufgabenverwaltung ==
5.1	107
8.2	108	Projektbezogene Aufgaben, jeweils eigene, komplett getrennte Liste pro Use-Case.
5.1	109
29.2	110	* Schwarmspeicher: TaskManager, TasksPage, Hook useTasks()
	111	* PV-Co-Location: CoTaskManager, CoLocationTasksPage, Hook useCoTasks()
5.1	112
29.2	113	== 10. Dokumentenverwaltung ==
1.1	114
8.2	115	Zu jedem Standort und jedem Standortpartner können Dokumente hochgeladen werden.
1.1	116
29.2	117	* Schwarmspeicher: StandortDokumente, PartnerDokumente, Hook useDokumente()
	118	* PV-Co-Location: CoLocationStandortDokumente, CoLocationPartnerDokumente, Hook useCoDokumente() — eigener Storage-Bucket co-dokumente
1.1	119
29.2	120	== 11. Standortpartner ==
1.1	121
8.2	122	Verwaltung von Projektpartnern, eigene, komplett getrennte Partnerliste pro Use-Case.
1.1	123
29.2	124	* Schwarmspeicher: StandortpartnerTable (Tab „Standortpartner“ unter Projekte)
	125	* PV-Co-Location: CoLocationStandortpartnerManager, CoLocationStandortpartnerTable
1.1	126
29.2	127	== 12. Benutzerverwaltung ==
5.1	128
29.2	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".
5.1	130
29.2	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.).
1.1	132
29.2	133	== 13. Audit Log ==
	134
8.2	135	Nachvollziehbarkeit von Änderungen (AuditLogPage), tabellenübergreifend über beide Use-Cases.
6.1	136
30.1	137	== 14. Akquisiteure ==
6.1	138
29.2	139	Performance-Übersicht der Akquisiteure (AkquisiteurePerformancePage, AkquisiteurVerlaufCharts) — nur Schwarmspeicher, nur intern. Erfolg ist der Meilenstein „Vollmacht erhalten“.
1.1	140
29.2	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
6.1	144
30.1	145	== 15. Externe Akquisiteure und Teams ==
29.2	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
8.2	155	\|Pfad\|Seite\|Use-Case\|Login nötig
	156	\|/\|Dashboard\|Schwarmspeicher\|ja
	157	\|/projekte\|Standorte\|Schwarmspeicher\|ja
29.2	158	\|/pipeline\|Vorprojekte / In Akquise\|Schwarmspeicher\|ja
8.2	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
29.2	164	\|/akquisiteure\|Akquisiteure\|Schwarmspeicher\|ja
	165	\|/meine-standorte\|Meine Standorte\|– (externe Akquisiteure)\|ja
8.2	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
29.2	177
	178	= Datenzugriff =
	179
8.2	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
29.2	190	useAkquisePhase() useTrafoStationen() useBatterieKandidaten()
8.2	191
29.2	192	useAkquisiteurTeam useKannZuteilen() useUwZuteilungen()
	193
	194	useUwKapazitaeten()
	195
	196
8.2	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
29.3	208	= Supabase =
8.2	209
29.2	210	Authentication: Login, Passwortänderung, Rollenverwaltung.
8.2	211
29.2	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).
8.2	213
1.1	214	Edge Functions:
	215
8.2	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
29.2	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
1.1	222
29.2	223	Storage: zwei Buckets — dokumente (Schwarmspeicher) und co-dokumente (PV-Co-Location).
5.1	224
29.3	225	= Use-Case-Umschalter =
5.1	226
19.1	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
29.2	229	= Server =
14.1	230
8.2	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
29.2	233	Erreichbar unter:
8.2	234
32.1	235	Öffentlich: https:~/~/schwarmspeicher.electrify.at:8200 (Wildcard-Zertifikat *.electrify.at, Let's Encrypt, gültig bis 13.01.2027)
8.2	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/.