Changes for page Schwarmspeicher Electrify

Last modified by Patrizia Gurschka on 2026/09/10 14:58

Manage
- Copy
Actions
- Export
- Print Preview
Viewers
- Source
- Children
- Content
- Comments
- Attachments (6)
- History
- Information
- Likes

From 13.1 to 12.1

From version 12.1

edited by Patrizia Gurschka
on 2026/09/10 08:16

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

Raw
Rendered

Summary

Page properties (3 modified, 0 added, 0 removed)
Attachments (0 modified, 0 added, 2 removed)
- 1789017284336-190.png
- noavatar.png

Details

Page properties

Author

@@ -1,1 +1,1 @@
--XWiki.gurschkap
++XWiki.drupp

Tags

...	...	@@ -1,1 +1,0 @@
1		-referenz\|architektur

Content

@@ -1,255 +1,148 @@
--|(% style="width:788px" %)(((
--= 🔋  Schwarmspeicher Electrify =
++{{box cssClass="floatinginfobox" title="**Auf dieser Seite**"}}
++{{toc/}}
++{{/box}}
--{{info}}
--**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.
++= 🔋 Schwarmspeicher Electrify =
--**Zielgruppe: **Vertriebs-/Projektentwicklungsteam und IT/DevOps-Betrieb.
++{{info}}
++**Zweck:** Webbasiertes Projektmanagementsystem zur Verwaltung von Batterie-Großspeicherprojekten in Deutschland und Österreich — vom Standort über Genehmigungen bis zur Projektsteuerung und Dokumentation.
  {{/info}}
--|(((
--📁 src/
--
--📁   components/   UI-Komponenten (Schwarmspeicher + CoLocation*-Pendants)
--
--📁   pages/   Seiten der Anwendung
--
--📁   hooks/   Datenzugriffe und Business-Logik
--
--📁   integrations/   Supabase Client
--
--📁   types/   TypeScript-Modelle
--
--📁   lib/   Hilfsfunktionen (u.a. mapCoordinates.ts)
--
--📁 supabase/
--
--📁   migrations/   SQL-Migrationen (inkl. komplettes PV-Co-Location-Schema)
--
--📁   functions/   Edge Functions
--)))
--
--== Architektur ==
--
--[[image:1789017284336-190.png||height="353" width="762"]]
--
--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
--)))|(% style="width:280px" %)(((
--{{toc/}}
--
--
--)))
--
--
--
  == Übersicht ==
--**Schwarmspeicher Electrify **unterstützt den gesamten Projektlebenszyklus: Standortidentifikation, Genehmigungen, Projektsteuerung und Dokumentation — für beide Use-Cases parallel, über einen Umschalter in der Seitenleiste.
++**Schwarmspeicher Electrify** unterstützt den gesamten Projektlebenszyklus: Standortidentifikation, Genehmigungen, Projektsteuerung und Dokumentation.
  == Technologie-Stack ==
--**Frontend: **React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · Leaflet + leaflet.markercluster (Kartendarstellung) · Recharts (Diagramme) · XLSX (Excel-Import/-Export)
++**Frontend:** React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · React Hook Form · Leaflet (Kartendarstellung) · Recharts (Diagramme)
--**Backend: **Supabase (self-hosted) — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
++**Backend:** Supabase — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
--== Use-Case-Umschalter ==
++== Projektstruktur ==
--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.
++{{code}}
++src/
++ ├── components/     UI-Komponenten
++ ├── pages/          Seiten der Anwendung
++ ├── hooks/          Datenzugriffe und Business-Logik
++ ├── integrations/   Supabase Client
++ ├── types/          TypeScript-Modelle
++ └── lib/            Hilfsfunktionen
++supabase/
++ ├── migrations/
++ ├── functions/
++ └── config.toml
++{{/code}}
++
  == Hauptfunktionen ==
  === Dashboard ===
--Zentrale Übersicht über Projekte, Status, Kennzahlen und Projektfortschritt.
++Zentrale Übersicht über Projekte, Status, offene Aufgaben, Kennzahlen und Projektfortschritt (Komponente ##Dashboard.tsx##).
--* Schwarmspeicher: Dashboard.tsx — Pipeline-Summary, kW/kWh-KPIs, Plan-vs-Ist-Charts pro Meilenstein
--* PV-Co-Location: CoLocationDashboard.tsx — gleiche Struktur, Einheiten angepasst (kWp/kW), zweite Übersichtskarte zeigt Standortpartner-Anzahl statt Gemeinden
++=== Projektverwaltung ===
--=== Projektverwaltung / Standortverwaltung ===
++Verwaltung aller Batteriespeicherprojekte: anzeigen, Detailansicht, bearbeiten, Projektstatus, Meilensteine. Komponenten: ProjectTable, ProjectDetail.
--Standorte anlegen, bearbeiten, importieren, Historie, Dokumente, sortierbare Tabelle mit Meilenstein-Filter, Bulk-Bearbeitung, Als-abgebrochen-markieren/Reaktivieren.
++=== Standortverwaltung ===
--* Schwarmspeicher: ProjectTable, StandortDetail, CreateStandortFormNew, StandortImportDialog, StandortDokumente, AbbruchDialog, MeilensteinQuickEdit, MeilensteinMatrix, BulkEditStandortDialog
--* PV-Co-Location: CoLocationProjectTable, CoLocationStandortDetail, CreateCoLocationForm, CoLocationImportDialog, CoLocationStandortDokumente, CoLocationAbbruchDialog, CoLocationMeilensteinQuickEdit, CoLocationMeilensteinMatrix, CoLocationBulkEditDialog
++Standorte anlegen, bearbeiten, importieren, Historie, Dokumente. Komponenten: StandortDetail, CreateStandortForm, StandortImportDialog, StandortDokumente.
--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.
--
  === Gemeinden ===
--Verwaltung der Gemeinden (CreateGemeindeForm, nur Schwarmspeicher). Edge Function fetch-noe-gemeinden lädt NÖ-Gemeinden.
++Verwaltung der Gemeinden (Komponente CreateGemeindeForm). Zusätzlich existiert eine Supabase Edge Function zum Abruf von NÖ-Gemeinden (##supabase/functions/fetch-noe-gemeinden##).
  === Kartenansicht ===
--Interaktive Karte aller Standorte (Leaflet + Clustering), Adresssuche, Vollbildmodus, Flächenauswahl (Shift+Ziehen), Trafokarte-NÖ-Layer mit Legende.
++Darstellung aller Standorte auf einer interaktiven Karte (Leaflet, React Leaflet). Komponenten: ProjectMap, LocationPickerMap.
--* Schwarmspeicher: ProjectMap
--* PV-Co-Location: CoLocationMap
--* Gemeinsam genutzt: LocationPickerMap (Einzelstandort-Kartenauswahl), src/lib/mapCoordinates.ts (dedupeCoordinates — verhindert sofortiges Auftrennen bei identischen Koordinaten)
--
  === Potenzialanalyse ===
--Bewertung möglicher Standorte (PotenzialTabelle, PotenzialPage) — nur Schwarmspeicher, kein Pendant bei PV-Co-Location.
++Bewertung möglicher Standorte. Komponenten: PotenzialTabelle, PotenzialPage.
  === Pipeline ===
--* Schwarmspeicher: VorprojektePipeline, VorprojektTimeline
--* PV-Co-Location: CoLocationPipeline (Felder an kWp/BESS-kW angepasst; kein Pendant zu VorprojektTimeline)
++Verwaltung von Vorprojekten. Komponenten: VorprojektePipeline, VorprojektTimeline.
  === Meilensteinverwaltung ===
--Projektfortschritt über Meilensteine, matrixartige Übersicht mit Bulk-Setzen, Gruppierung.
++Projektfortschritt über Meilensteine. Komponenten: MeilensteinMatrix, MeilensteinQuickEdit.
--* Schwarmspeicher: MeilensteinMatrix, MeilensteinQuickEdit (inkl. Sonderfall-Dialog NetzvertragAnpassungDialog)
--* 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)
--
--=== Stockend ===
--
--Zeigt Standorte, bei denen die Lead-Time zwischen zwei Meilensteinen überschritten ist, konfigurierbare Regeln.
--
--* Schwarmspeicher: StuckPage
--* PV-Co-Location: CoLocationStuckPage (eigene, getrennt gespeicherte Lead-Time-Regeln entlang der neuen Meilensteinkette)
--
--=== Forecast ===
--
--Monatliche Zielvorgaben, Plan-vs-Ist-Charts pro Kennzahl.
--
--* Schwarmspeicher: ForecastPage (kW und kWh pro Monat/Meilenstein, nach Land AT/DE getrennt)
--* PV-Co-Location: CoLocationForecastPage — 4 KPI-Charts entlang Netzantrag gestellt / Netzvertrag erhalten / Standort gebaut / Standort live Trading (kein Land-Split)
--
  === Aufgabenverwaltung ===
--Projektbezogene Aufgaben, jeweils eigene, komplett getrennte Liste pro Use-Case.
++Projektbezogene Aufgaben. Komponenten: TaskManager, TasksPage. Hook: ##useTasks()##.
--* Schwarmspeicher: TaskManager, TasksPage, Hook useTasks()
--* PV-Co-Location: CoTaskManager, CoLocationTasksPage, Hook useCoTasks()
--
  === Dokumentenverwaltung ===
--Zu jedem Standort und jedem Standortpartner können Dokumente hochgeladen werden.
++Zu jedem Standort können Dokumente verwaltet werden. Komponenten: StandortDokumente, PartnerDokumente.
--* Schwarmspeicher: StandortDokumente, PartnerDokumente, Hook useDokumente()
--* PV-Co-Location: CoLocationStandortDokumente, CoLocationPartnerDokumente, Hook useCoDokumente() — eigener Storage-Bucket co-dokumente
--
  === Standortpartner ===
--Verwaltung von Projektpartnern, eigene, komplett getrennte Partnerliste pro Use-Case.
++Verwaltung von Projektpartnern. Komponenten: StandortpartnerManager, StandortpartnerTable.
--* Schwarmspeicher: StandortpartnerManager, StandortpartnerTable
--* PV-Co-Location: CoLocationStandortpartnerManager, CoLocationStandortpartnerTable
--
  === Benutzerverwaltung ===
--Anmeldung, Passwortänderung, Rollen (admin/user). 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.
++Anmeldung, Passwortänderung, Rollen. Komponenten: AuthProvider, ProtectedRoute, BenutzerPage, ChangePasswordDialog. Backend: Supabase Authentication.
  === Audit Log ===
--Nachvollziehbarkeit von Änderungen (AuditLogPage), tabellenübergreifend über beide Use-Cases.
++Nachvollziehbarkeit von Änderungen (Seite AuditLogPage).
--=== Landingpage „Fläche verpachten" ===
--
--Öffentlich erreichbare Seite ohne Login unter /flaeche-verpachten — für Grundstückseigentümer, die eine Fläche für einen Batteriespeicher zur Verfügung stellen wollen. Kartenbasierte Standortauswahl, Formular mit Honeypot-Spamschutz.
--
--* Legt über die Edge Function public-lead-intake automatisch einen neuen Eintrag in der Schwarmspeicher-Pipeline (vorprojekte) an
--* E-Mail-Benachrichtigung optional (RESEND_API_KEY + LEAD_NOTIFY_EMAIL) — Anfrage wird auch ohne E-Mail-Konfiguration zuverlässig gespeichert
--
--
--
--|(((
--⚠️  **Hinweis: Platzhalter-Firmendaten**
--
--* In FlaecheVerpachtenPage.tsx sind Firmenname und Telefonnummer aktuell Platzhalter (Rateware). Vor dem Livegang unbedingt durch die echten Kontaktdaten ersetzen.
--)))
--
--
--
  == Routing ==
--|**Pfad**|**Seite**|**Use-Case**|**Login nötig**
--|/|Dashboard|Schwarmspeicher|ja
--|/projekte|Standorte|Schwarmspeicher|ja
--|/pipeline|Vorprojekte|Schwarmspeicher|ja
--|/potenzial|Potenzialanalyse|Schwarmspeicher|ja
--|/karte|Kartenansicht|Schwarmspeicher|ja
--|/forecast|Forecast|Schwarmspeicher|ja
--|/tasks|Aufgaben|Schwarmspeicher|ja
--|/stockend|Stockende Standorte|Schwarmspeicher|ja
--|/benutzer|Benutzerverwaltung|– (Admin)|ja
--|/historie|Audit Log|– (Admin)|ja
--|/pv-colocation|Dashboard|PV-Co-Location|ja
--|/pv-colocation/projekte|Standorte|PV-Co-Location|ja
--|/pv-colocation/pipeline|Vorprojekte|PV-Co-Location|ja
--|/pv-colocation/karte|Kartenansicht|PV-Co-Location|ja
--|/pv-colocation/forecast|Forecast|PV-Co-Location|ja
--|/pv-colocation/tasks|Aufgaben|PV-Co-Location|ja
--|/pv-colocation/stockend|Stockende Standorte|PV-Co-Location|ja
--|/flaeche-verpachten|Landingpage „Fläche verpachten"|—|NEIN – öffentlich
++|=Seite|=Beschreibung
++|Dashboard|Startseite
++|Projekte|Projektübersicht
++|Pipeline|Vorprojekte
++|Potenziale|Standortpotenziale
++|Karte|Kartenansicht
++|Forecast|Forecast
++|Aufgaben|Aufgabenverwaltung
++|Audit Log|Änderungsprotokoll
++|Benutzer|Benutzerverwaltung
++|Login|Anmeldung
--
--
  == Datenzugriff ==
  Der Zugriff erfolgt über Custom Hooks, die sämtliche Kommunikation mit Supabase kapseln:
--|(((
--~/~/ Schwarmspeicher
++{{code}}
++useStandorte()
++useGemeinden()
++useVorprojekte()
++useTasks()
++usePotenzialDaten()
++useStandortpartner()
++useMonatsziele()
++{{/code}}
--useStandorte()   useGemeinden()   useVorprojekte()
--
--useTasks()       usePotenzialDaten()   useStandortpartner()
--
--useMonatsziele() useDokumente()   useIsAdmin()
--
--
--~/~/ PV-Co-Location
--
--useCoLocationStandorte()        useCoLocationStandortpartner()
--
--useCoVorprojekte()   useCoTasks()   useCoMonatsziele()   useCoDokumente()
--
--
--~/~/ Use-Case-übergreifend
--
--useUseCase()   useAuth()
--)))
--
--
--
  == Supabase ==
--**Authentication: **Login, Passwortänderung, Rollenverwaltung.
++**Authentication:** Login, Passwortänderung, Rollenverwaltung.
--**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.
++**Datenbank:** Wird über SQL-Migrationen verwaltet (##supabase/migrations/##). Die Migrationen definieren Tabellen, Policies und Datenbankfunktionen.
  **Edge Functions:**
--* fetch-noe-gemeinden — lädt Gemeinden aus Niederösterreich
--* manage-users — Benutzerverwaltung, prüft Admin-Berechtigung serverseitig
--* public-lead-intake — nimmt Anfragen der öffentlichen Landingpage entgegen
++* ##fetch-noe-gemeinden## — lädt Gemeinden aus Niederösterreich
++* ##manage-users## — Benutzerverwaltung
--**Storage: **zwei Buckets — dokumente (Schwarmspeicher) und co-dokumente (PV-Co-Location).
++== Architektur ==
--==   ==
++{{mermaid}}
++flowchart TD
++    FE["React Frontend"] --> RQ["React Query"]
++    RQ --> SC["Supabase Client"]
++    SC --> AUTH["Auth"]
++    SC --> DBS["Database"]
++    SC --> ST["Storage"]
++    DBS --> EF["Edge Functions"]
++{{/mermaid}}
--== Offene Punkte / zu verifizieren ==
--
--|(((
--⚠️  **Vor einem breiteren Rollout klären**
--
--* E-Mail-Versand für Landingpage-Anfragen (RESEND_API_KEY / LEAD_NOTIFY_EMAIL) ist noch nicht final eingerichtet — Anfragen werden bis dahin nur in der Pipeline gespeichert, ohne Benachrichtigung.
--* Migrationsdateien in supabase/migrations/ müssen noch ins Git-Repo committet werden, falls noch nicht geschehen (Datenbank selbst ist bereits aktuell).
--* types.ts kennt die neuen co_*-Tabellen nicht — führt zu TypeScript-Warnungen beim Bauen (bewusst akzeptiert, kein Laufzeitfehler).
--* KPI-Zuordnung im PV-Co-Location-Forecast (Netzantrag = kWp, die übrigen drei Meilensteine = kW) ist eine Annahme — bei Bedarf auf eine einheitliche Einheit umstellen.
--)))
--
--
--
  == Server ==
--Das Projekt liegt unter /mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal und läuft in einem eigenständigen Docker-Compose-Stack (schwarmspeicher-electrify_lokal).
++Das Projekt liegt unter ##/mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal## und läuft in einem Docker-Compose-Stack (##schwarmspeicher-electrify_lokal##).
--**Erreichbar unter:**
++Erreichbar unter [[http://schwarmspeicher.spl-tele.com:8200>>http://schwarmspeicher.spl-tele.com:8200/]] — mit VPN und im SPL-TELE-Netzwerk.
--* VPN: http:~/~/schwarmspeicher.spl-tele.com:8200 (SPL-TELE-Netzwerk)
--* Öffentlich: https:~/~/schwarmspeicher.electrify.at:8200 (Wildcard-Zertifikat *.electrify.at, Let's Encrypt, gültig bis 26.10.2026)
--
--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/.

1789017284336-190.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.gurschkap

Size

...	...	@@ -1,1 +1,0 @@
1		-10.9 KB

Content

noavatar.png

Author

...	...	@@ -1,1 +1,0 @@
1		-XWiki.drupp

Size

...	...	@@ -1,1 +1,0 @@
1		-5.6 KB

Content

Changes for page Schwarmspeicher Electrify

Summary

Details

Applications

Navigation

Verwandte Themen

Recently Created

Recently Modified

Changes for page Schwarmspeicher Electrify

Summary

Details

Applications

Tag Cloud

Verwandte Themen

Recently Created

Recently Modified