Changes for page Schwarmspeicher Electrify
Last modified by Patrizia Gurschka on 2026/09/10 14:58
From version 8.1
edited by Patrizia Gurschka
on 2026/09/10 07:14
on 2026/09/10 07:14
Change comment:
Uploaded new attachment "1789017284336-190.png", version {1}
To version 11.1
edited by Patrizia Gurschka
on 2026/09/10 08:02
on 2026/09/10 08:02
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,238 +1,257 @@ 1 -= 🔋 Schwarmspeicher Electrify = 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.|((( 4 -**Auf dieser Seite** 3 +|(% style="width:788px" %)((( 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. 5 5 6 -• 🔋 Schwarmspeicher Electrify 7 +**Zielgruppe: **Vertriebs-/Projektentwicklungsteam und IT/DevOps-Betrieb. 8 +{{/info}} 7 7 8 -• Übersicht 10 +|((( 11 +📁 src/ 9 9 10 - •Technologie-Stack13 +📁 components/ UI-Komponenten (Schwarmspeicher + CoLocation*-Pendants) 11 11 12 - •Projektstruktur15 +📁 pages/ Seiten der Anwendung 13 13 14 - •Hauptfunktionen17 +📁 hooks/ Datenzugriffe und Business-Logik 15 15 16 - ▪Dashboard19 +📁 integrations/ Supabase Client 17 17 18 - ▪Projektverwaltung21 +📁 types/ TypeScript-Modelle 19 19 20 - ▪Standortverwaltung23 +📁 lib/ Hilfsfunktionen (u.a. mapCoordinates.ts) 21 21 22 - ▪Gemeinden25 +📁 supabase/ 23 23 24 - ▪Kartenansicht27 +📁 migrations/ SQL-Migrationen (inkl. komplettes PV-Co-Location-Schema) 25 25 26 -▪ Potenzialanalyse 29 +📁 functions/ Edge Functions 30 +))) 27 27 28 - ▪Pipeline32 +== Architektur == 29 29 30 - ▪ Meilensteinverwaltung34 +[[image:1789017284336-190.png||height="353" width="762"]] 31 31 32 -▪ Aufgabenverwaltung 36 +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 37 +)))|(% style="width:280px" %)((( 38 +|((( 39 +{{toc/}} 40 +))) 33 33 34 -▪ Dokumentenverwaltung 42 + 43 +))) 35 35 36 -▪ Standortpartner 37 37 38 -▪ Stockende Projekte 39 39 40 - ▪Forecast47 +== Übersicht == 41 41 42 - ▪PVCo-Location49 +**Schwarmspeicher Electrify **unterstützt den gesamten Projektlebenszyklus: Standortidentifikation, Genehmigungen, Projektsteuerung und Dokumentation — für beide Use-Cases parallel, über einen Umschalter in der Seitenleiste. 43 43 44 - ▪Benutzerverwaltung51 +== Technologie-Stack == 45 45 46 - ▪AuditLog53 +**Frontend: **React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · Leaflet + leaflet.markercluster (Kartendarstellung) · Recharts (Diagramme) · XLSX (Excel-Import/-Export) 47 47 48 - •Routing55 +**Backend: **Supabase (self-hosted) — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS) 49 49 50 - •Datenzugriff57 +== Use-Case-Umschalter == 51 51 52 - •Supabase59 +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. 53 53 54 - •Architektur61 +== Hauptfunktionen == 55 55 56 -• Server 57 -))) 63 +=== Dashboard === 58 58 65 +Zentrale Übersicht über Projekte, Status, Kennzahlen und Projektfortschritt. 59 59 67 +* Schwarmspeicher: Dashboard.tsx — Pipeline-Summary, kW/kWh-KPIs, Plan-vs-Ist-Charts pro Meilenstein 68 +* PV-Co-Location: CoLocationDashboard.tsx — gleiche Struktur, Einheiten angepasst (kWp/kW), zweite Übersichtskarte zeigt Standortpartner-Anzahl statt Gemeinden 60 60 61 -== Übersicht ==70 +=== Projektverwaltung / Standortverwaltung === 62 62 63 - **Schwarmspeicher Electrify** unterstützt dengesamtenProjektlebenszyklus:Standortidentifikation,Pipeline, Genehmigungen,Projektsteuerung,Forecast,Aufgabenund Dokumentation.Über einenUse-Case-Switcher kann zwischen **Schwarmspeicher**und**PV Co-Location**gewechselt werden. Deraktive Use-Case wird aus dem URL-Pfad abgeleitet.72 +Standorte anlegen, bearbeiten, importieren, Historie, Dokumente, sortierbare Tabelle mit Meilenstein-Filter, Bulk-Bearbeitung, Als-abgebrochen-markieren/Reaktivieren. 64 64 65 -== Technologie-Stack == 74 +* Schwarmspeicher: ProjectTable, StandortDetail, CreateStandortFormNew, StandortImportDialog, StandortDokumente, AbbruchDialog, MeilensteinQuickEdit, MeilensteinMatrix, BulkEditStandortDialog 75 +* PV-Co-Location: CoLocationProjectTable, CoLocationStandortDetail, CreateCoLocationForm, CoLocationImportDialog, CoLocationStandortDokumente, CoLocationAbbruchDialog, CoLocationMeilensteinQuickEdit, CoLocationMeilensteinMatrix, CoLocationBulkEditDialog 66 66 67 - **Frontend:**React18.3.1 · TypeScript5.8.3 · Vite5.4.19 · TailwindCSS3.4.17·shadcn/ui/RadixUI · ReactRouterDOM 6.30.1 · TanStackReactQuery5.83.0 · React HookForm7.61.1· Zod3.25.76· Leaflet1.9.4 / ReactLeaflet4.2.1· Recharts2.15.4 · xlsx 0.18.577 +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. 68 68 69 - **Backend:**Supabase— PostgreSQL, Authentication, Storage, EdgeFunctions,Row Level Security (RLS)79 +=== Gemeinden === 70 70 71 - **Tests:**Vitest3.2.4· Playwright1.57.081 +Verwaltung der Gemeinden (CreateGemeindeForm, nur Schwarmspeicher). Edge Function fetch-noe-gemeinden lädt NÖ-Gemeinden. 72 72 73 -== Projektstruktur==83 +=== Kartenansicht === 74 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/ 83 -├── migrations/ 84 -├── functions/ 85 -└── config.toml 85 +Interaktive Karte aller Standorte (Leaflet + Clustering), Adresssuche, Vollbildmodus, Flächenauswahl (Shift+Ziehen), Trafokarte-NÖ-Layer mit Legende. 86 86 87 +* Schwarmspeicher: ProjectMap 88 +* PV-Co-Location: CoLocationMap 89 +* Gemeinsam genutzt: LocationPickerMap (Einzelstandort-Kartenauswahl), src/lib/mapCoordinates.ts (dedupeCoordinates — verhindert sofortiges Auftrennen bei identischen Koordinaten) 87 87 91 +=== Potenzialanalyse === 88 88 89 - == Hauptfunktionen==93 +Bewertung möglicher Standorte (PotenzialTabelle, PotenzialPage) — nur Schwarmspeicher, kein Pendant bei PV-Co-Location. 90 90 91 -=== Dashboard===95 +=== Pipeline === 92 92 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. 97 +* Schwarmspeicher: VorprojektePipeline, VorprojektTimeline 98 +* PV-Co-Location: CoLocationPipeline (Felder an kWp/BESS-kW angepasst; kein Pendant zu VorprojektTimeline) 94 94 95 -=== Projektverwaltung ===100 +=== Meilensteinverwaltung === 96 96 97 - Verwaltung aller Batteriespeicherprojekte: anzeigen, Detailansicht,bearbeiten,Projektstatus undMeilensteine.Komponenten: ProjectTable, ProjectDetail. PV Co-Location besitzt eine eigeneProjektansicht mitCoLocationProjectTableundCoLocationStandortDetail.102 +Projektfortschritt über Meilensteine, matrixartige Übersicht mit Bulk-Setzen, Gruppierung. 98 98 99 -Standortverwaltung 104 +* Schwarmspeicher: MeilensteinMatrix, MeilensteinQuickEdit (inkl. Sonderfall-Dialog NetzvertragAnpassungDialog) 105 +* 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) 100 100 101 - Standorteanlegen, bearbeiten, importieren, Historie und Dokumente. Komponenten:StandortDetail, CreateStandortForm, StandortImportDialog, StandortDokumente. PV Co-Location ergänzt eigene Formulare, Import, Bulk-Editund Detailansichten.107 +=== Stockend === 102 102 103 - Gemeinden109 +Zeigt Standorte, bei denen die Lead-Time zwischen zwei Meilensteinen überschritten ist, konfigurierbare Regeln. 104 104 105 -Verwaltung der Gemeinden (Komponente CreateGemeindeForm). Zusätzlich existiert eine Supabase Edge Function zum Abruf von NÖ-Gemeinden (supabase/functions/fetch-noe-gemeinden). 111 +* Schwarmspeicher: StuckPage 112 +* PV-Co-Location: CoLocationStuckPage (eigene, getrennt gespeicherte Lead-Time-Regeln entlang der neuen Meilensteinkette) 106 106 107 - Kartenansicht114 +=== Forecast === 108 108 109 - Darstellung aller Standorte auf einer interaktivenKarte mit Leaflet / React Leaflet. Komponenten: ProjectMap, LocationPickerMap. PV Co-Locationbesitzt eine eigene Karte mit Standortselektion, Partnerfilter und Übergabe ausgewählter Standort-IDsan die Projektansicht.116 +Monatliche Zielvorgaben, Plan-vs-Ist-Charts pro Kennzahl. 110 110 111 -Potenzialanalyse 118 +* Schwarmspeicher: ForecastPage (kW und kWh pro Monat/Meilenstein, nach Land AT/DE getrennt) 119 +* PV-Co-Location: CoLocationForecastPage — 4 KPI-Charts entlang Netzantrag gestellt / Netzvertrag erhalten / Standort gebaut / Standort live Trading (kein Land-Split) 112 112 113 - Bewertungmöglicher Standorte. Komponenten: PotenzialTabelle, PotenzialPage. Die Potenzialanalyse istaktuell dem Schwarmspeicher-Use-Case zugeordnet.121 +=== Aufgabenverwaltung === 114 114 115 -P ipeline123 +Projektbezogene Aufgaben, jeweils eigene, komplett getrennte Liste pro Use-Case. 116 116 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. 125 +* Schwarmspeicher: TaskManager, TasksPage, Hook useTasks() 126 +* PV-Co-Location: CoTaskManager, CoLocationTasksPage, Hook useCoTasks() 118 118 119 - Meilensteinverwaltung128 +=== Dokumentenverwaltung === 120 120 121 - Projektfortschritt überMeilensteine. Komponenten:MeilensteinMatrix, MeilensteinQuickEdit. PV Co-Locationverwendeteine eigeneMeilensteinmatrixund Quick-Edit-Logik. ZudendortabgebildetenSchrittengehören u.a. Grundstücksvertrag, Netzzugangsvertrag,Fertigstellungsmeldung, BESS-Bezugsleistung und Inbetriebnahme.130 +Zu jedem Standort und jedem Standortpartner können Dokumente hochgeladen werden. 122 122 123 -Aufgabenverwaltung 132 +* Schwarmspeicher: StandortDokumente, PartnerDokumente, Hook useDokumente() 133 +* PV-Co-Location: CoLocationStandortDokumente, CoLocationPartnerDokumente, Hook useCoDokumente() — eigener Storage-Bucket co-dokumente 124 124 125 - ProjektbezogeneAufgaben. Komponenten: TaskManager, TasksPage. Hook: useTasks(). PV Co-Location verwendetmit CoTaskManager, CoLocationTasksPageund useCoTasks() eine eigene, vom Schwarmspeichergetrennte Aufgabenliste.135 +=== Standortpartner === 126 126 127 - Dokumentenverwaltung137 +Verwaltung von Projektpartnern, eigene, komplett getrennte Partnerliste pro Use-Case. 128 128 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. 139 +* Schwarmspeicher: StandortpartnerManager, StandortpartnerTable 140 +* PV-Co-Location: CoLocationStandortpartnerManager, CoLocationStandortpartnerTable 130 130 131 - Standortpartner142 +=== Benutzerverwaltung === 132 132 133 - VerwaltungvonProjektpartnern. Komponenten:StandortpartnerManager,StandortpartnerTable.FürPVCo-Location existierenseparateKomponentenundDatenzugriffe fürStandortpartner.144 +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. 134 134 135 - StockendeProjekte146 +=== Audit Log === 136 136 137 - ErkennungvonProjektenbzw. Standorten, deren definierteLead Timeszwischen Meilensteinenüberschrittensind.FürPV Co-Location sind dieLead-Time-Regeln inderUI anpassbar und werden derzeit im Browser-localStorage gespeichert.148 +Nachvollziehbarkeit von Änderungen (AuditLogPage), tabellenübergreifend über beide Use-Cases. 138 138 139 - Forecast150 +=== Landingpage „Fläche verpachten" === 140 140 141 - Forecast aufBasis vonMonatszielenunderreichtenMeilensteinen.PV Co-LocationenthältPlan-/Ist-Auswertungen fürNetzzugangsvertrag, BESS beantragt,BESSbewilligt undBESSin Betriebsowie eineJahresauswahl undeditierbareMonatsziele.152 +Ö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. 142 142 143 -PV Co-Location 154 +* Legt über die Edge Function public-lead-intake automatisch einen neuen Eintrag in der Schwarmspeicher-Pipeline (vorprojekte) an 155 +* E-Mail-Benachrichtigung optional (RESEND_API_KEY + LEAD_NOTIFY_EMAIL) — Anfrage wird auch ohne E-Mail-Konfiguration zuverlässig gespeichert 144 144 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 148 148 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(). 159 +|((( 160 +⚠️ **Hinweis: Platzhalter-Firmendaten** 150 150 151 -Audit Log 162 +* In FlaecheVerpachtenPage.tsx sind Firmenname und Telefonnummer aktuell Platzhalter (Rateware). Vor dem Livegang unbedingt durch die echten Kontaktdaten ersetzen. 163 +))) 152 152 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 156 156 157 -|**Seite**|**Beschreibung** 158 -|Dashboard|Startseite 159 -|Projekte|Projektübersicht 160 -|Pipeline|Vorprojekte 161 -|Potenziale|Standortpotenziale 162 -|Karte|Kartenansicht 163 -|Stockend|Stockende Projekte / Standorte 164 -|Forecast|Forecast 165 -|Aufgaben|Aufgabenverwaltung 166 -|Audit Log|Änderungsprotokoll 167 -|Benutzer|Benutzerverwaltung 168 -|Login|Anmeldung 167 +== Routing == 169 169 169 +|**Pfad**|**Seite**|**Use-Case**|**Login nötig** 170 +|/|Dashboard|Schwarmspeicher|ja 171 +|/projekte|Standorte|Schwarmspeicher|ja 172 +|/pipeline|Vorprojekte|Schwarmspeicher|ja 173 +|/potenzial|Potenzialanalyse|Schwarmspeicher|ja 174 +|/karte|Kartenansicht|Schwarmspeicher|ja 175 +|/forecast|Forecast|Schwarmspeicher|ja 176 +|/tasks|Aufgaben|Schwarmspeicher|ja 177 +|/stockend|Stockende Standorte|Schwarmspeicher|ja 178 +|/benutzer|Benutzerverwaltung|– (Admin)|ja 179 +|/historie|Audit Log|– (Admin)|ja 180 +|/pv-colocation|Dashboard|PV-Co-Location|ja 181 +|/pv-colocation/projekte|Standorte|PV-Co-Location|ja 182 +|/pv-colocation/pipeline|Vorprojekte|PV-Co-Location|ja 183 +|/pv-colocation/karte|Kartenansicht|PV-Co-Location|ja 184 +|/pv-colocation/forecast|Forecast|PV-Co-Location|ja 185 +|/pv-colocation/tasks|Aufgaben|PV-Co-Location|ja 186 +|/pv-colocation/stockend|Stockende Standorte|PV-Co-Location|ja 187 +|/flaeche-verpachten|Landingpage „Fläche verpachten"|—|NEIN – öffentlich 170 170 171 171 172 -**Schwarmspeicher-Routen: **/ · /projekte · /pipeline · /potenzial · /karte · /stockend · /forecast · /tasks · /benutzer · /historie 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/tasks191 +== Datenzugriff == 175 175 176 -D atenzugriff193 +Der Zugriff erfolgt über Custom Hooks, die sämtliche Kommunikation mit Supabase kapseln: 177 177 178 -Der Zugriff erfolgt über Custom Hooks, die die Kommunikation mit Supabase kapseln. React Query übernimmt Laden, Mutationen und Cache-Invalidierung. 195 +|((( 196 +~/~/ Schwarmspeicher 179 179 180 -|Schwarmspeicher: 181 -useStandorte() 182 -useGemeinden() 183 -useVorprojekte() 184 -useTasks() 185 -usePotenzialDaten() 186 -useStandortpartner() 187 -useMonatsziele() 188 -useDokumente() 189 -\\PV Co-Location: 190 -useCoLocationStandorte() 191 -useCoLocationStandortpartner() 192 -useCoVorprojekte() 193 -useCoTasks() 194 -useCoMonatsziele() 195 -useCoDokumente() 198 +useStandorte() useGemeinden() useVorprojekte() 196 196 200 +useTasks() usePotenzialDaten() useStandortpartner() 197 197 202 +useMonatsziele() useDokumente() useIsAdmin() 198 198 199 -Supabase 200 200 201 - **Authentication:**Login,Passwortänderung, Rollenverwaltung und geschützte Routen.205 +~/~/ PV-Co-Location 202 202 203 - **Datenbank: **Wird über SQL-Migrationenverwaltet(supabase/migrations/). Die Migrationen definieren Tabellen, Policies undDatenbankfunktionen.207 +useCoLocationStandorte() useCoLocationStandortpartner() 204 204 205 - **Storage: **Der bestehende Bucket dokumente ist laut Migrationprivat und auf authentifizierteZugriffebeschränkt. DasPV-Co-Location-Frontend referenziert zusätzlich denBucket co-dokumente.209 +useCoVorprojekte() useCoTasks() useCoMonatsziele() useCoDokumente() 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 208 212 +~/~/ Use-Case-übergreifend 213 + 214 +useUseCase() useAuth() 215 +))) 216 + 217 + 218 + 219 +== Supabase == 220 + 221 +**Authentication: **Login, Passwortänderung, Rollenverwaltung. 222 + 223 +**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. 224 + 209 209 **Edge Functions:** 210 210 211 -• fetch-noe-gemeinden — lädt Gemeinden aus Niederösterreich 227 +* fetch-noe-gemeinden — lädt Gemeinden aus Niederösterreich 228 +* manage-users — Benutzerverwaltung, prüft Admin-Berechtigung serverseitig 229 +* public-lead-intake — nimmt Anfragen der öffentlichen Landingpage entgegen 212 212 213 - • manage-users —Benutzerverwaltung231 +**Storage: **zwei Buckets — dokumente (Schwarmspeicher) und co-dokumente (PV-Co-Location). 214 214 215 - |**ⓘTechnischerHinweis:**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.233 +== == 216 216 217 - Architektur235 +== Offene Punkte / zu verifizieren == 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"] 237 +|((( 238 +⚠️ **Vor einem breiteren Rollout klären** 231 231 240 +* 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. 241 +* Migrationsdateien in supabase/migrations/ müssen noch ins Git-Repo committet werden, falls noch nicht geschehen (Datenbank selbst ist bereits aktuell). 242 +* types.ts kennt die neuen co_*-Tabellen nicht — führt zu TypeScript-Warnungen beim Bauen (bewusst akzeptiert, kein Laufzeitfehler). 243 +* KPI-Zuordnung im PV-Co-Location-Forecast (Netzantrag = kWp, die übrigen drei Meilensteine = kW) ist eine Annahme — bei Bedarf auf eine einheitliche Einheit umstellen. 244 +))) 232 232 233 233 234 -Server 235 235 236 - Fürdie lokale Entwicklung nennt die aktuelle README Node.js ≥ 18 oder Bun, Docker / Docker Compose und dieSupabaseCLI. DerVite-Dev-Serverläuft laut README auf Port 8200, Supabase Studio auf 127.0.0.1:54323.248 +== Server == 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. 250 +Das Projekt liegt unter /mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal und läuft in einem eigenständigen Docker-Compose-Stack (schwarmspeicher-electrify_lokal). 251 + 252 +**Erreichbar unter:** 253 + 254 +* VPN: http:~/~/schwarmspeicher.spl-tele.com:8200 (SPL-TELE-Netzwerk) 255 +* Öffentlich: https:~/~/schwarmspeicher.electrify.at:8200 (Wildcard-Zertifikat *.electrify.at, Let's Encrypt, gültig bis 26.10.2026) 256 + 257 +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/.