Changes for page Schwarmspeicher Electrify
Last modified by Patrizia Gurschka on 2026/09/10 14:58
From version 17.1
edited by Patrizia Gurschka
on 2026/09/10 12:31
on 2026/09/10 12:31
Change comment:
There is no comment for this version
To version 5.1
edited by Patrizia Gurschka
on 2026/09/09 14:21
on 2026/09/09 14:21
Change comment:
There is no comment for this version
Summary
-
Page properties (1 modified, 0 added, 0 removed)
-
Attachments (0 modified, 0 added, 1 removed)
Details
- Page properties
-
- Content
-
... ... @@ -1,259 +1,244 @@ 1 -|(% style="width:650px" %)((( 2 -= 🔋 Schwarmspeicher Electrify = 1 +macro:box 3 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. 6 - 7 -**Zielgruppe: **Vertriebs-/Projektentwicklungsteam und IT/DevOps-Betrieb. 8 -{{/info}} 9 -)))|(% style="width:418px" %)((( 10 10 **Auf dieser Seite** 11 11 12 - {{toc/}}5 +macro:toc 13 13 14 - 15 - )))7 +* ((( 8 +[[🔋 Schwarmspeicher Electrify>>path:#HD83DDD0BSchwarmspeicherElectrify]] 16 16 10 +* [[Übersicht>>path:#HDCbersicht]] 11 +* [[Technologie-Stack>>path:#HTechnologie-Stack]] 12 +* [[Projektstruktur>>path:#HProjektstruktur]] 13 +* ((( 14 +[[Hauptfunktionen>>path:#HHauptfunktionen]] 17 17 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 +))) 18 18 19 -== Übersicht == 20 20 21 -**Schwarmspeicher Electrify **unterstützt den gesamten Projektlebenszyklus: Standortidentifikation, Genehmigungen, Projektsteuerung und Dokumentation — für beide Use-Cases parallel, über einen Umschalter in der Seitenleiste. 22 22 23 -= =Technologie-Stack==42 += 🔋 Schwarmspeicher Electrify = 24 24 25 - **Frontend: **React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · Leaflet + leaflet.markercluster (Kartendarstellung) · Recharts (Diagramme) · XLSX (Excel-Import/-Export)44 +macro:info 26 26 27 - **Backend: **Supabase (self-hosted) — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)46 +Information 28 28 29 - ==Projektstruktur==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**. 30 30 31 -|((( 32 -📁 src/ 50 +Click and drag to move 33 33 34 - 📁components/ UI-Komponenten (Schwarmspeicher + CoLocation*-Pendants)52 +== Übersicht == 35 35 36 - 📁 pages/Seitender Anwendung54 +**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. 37 37 38 - 📁hooks/ Datenzugriffeund Business-Logik56 +== Technologie-Stack == 39 39 40 - 📁 integrations/SupabaseClient58 +**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 41 41 42 - 📁types/TypeScript-Modelle60 +**Backend:** Supabase — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS) 43 43 44 - 📁 lib/ Hilfsfunktionen(u.a.mapCoordinates.ts)62 +**Tests:** Vitest 3.2.4 · Playwright 1.57.0 45 45 46 - 📁supabase/64 +== Projektstruktur == 47 47 48 - 📁migrations/ SQL-Migrationen (inkl. komplettes PV-Co-Location-Schema)66 +macro:code 49 49 50 -📁 functions/ Edge Functions 51 -))) 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 52 52 53 -== Use-Case-Umschalter == 76 +supabase/ 77 +├── migrations/ 78 +├── functions/ 79 +└── config.toml 54 54 55 - Zwei Buttons oben in der Seitenleiste ("Schwarmspeicher" / "PV-Co-Location"). Welcher Use-Case aktivangezeigt wird,leitet sichdirektaus der aktuellen URL ab (Hook useUseCase.tsx, /pv-colocation/*-Pfade vs. Rest) — nicht aus einemgespeichertenZustand. Dadurch zeigt die Seitenleiste nach Loginoder direktemAufruf eines Links immer konsistent den richtigen Use-Case.81 +Click and drag to move 56 56 57 57 == Hauptfunktionen == 58 58 59 -=== 1.Dashboard ===85 +=== Dashboard === 60 60 61 -Zentrale Übersicht über Projekte, Status, Kennzahlen und Projektfortschritt. 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. 62 62 63 -* Schwarmspeicher: Dashboard.tsx — Pipeline-Summary, kW/kWh-KPIs, Plan-vs-Ist-Charts pro Meilenstein 64 -* PV-Co-Location: CoLocationDashboard.tsx — gleiche Struktur, Einheiten angepasst (kWp/kW), zweite Übersichtskarte zeigt Standortpartner-Anzahl statt Gemeinden 89 +=== Projektverwaltung === 65 65 66 - ===2.Projektverwaltung/Standortverwaltung===91 +Verwaltung aller Batteriespeicherprojekte: anzeigen, Detailansicht, bearbeiten, Projektstatus und Meilensteine. Komponenten: ProjectTable, ProjectDetail. PV Co-Location besitzt eine eigene Projektansicht mit CoLocationProjectTable und CoLocationStandortDetail. 67 67 68 -Standorte anlegen, bearbeiten, importieren, Historie, Dokumente, sortierbare Tabelle mitMeilenstein-Filter, Bulk-Bearbeitung,Als-abgebrochen-markieren/Reaktivieren.93 +=== Standortverwaltung === 69 69 70 -* Schwarmspeicher: ProjectTable, StandortDetail, CreateStandortFormNew, StandortImportDialog, StandortDokumente, AbbruchDialog, MeilensteinQuickEdit, MeilensteinMatrix, BulkEditStandortDialog 71 -* PV-Co-Location: CoLocationProjectTable, CoLocationStandortDetail, CreateCoLocationForm, CoLocationImportDialog, CoLocationStandortDokumente, CoLocationAbbruchDialog, CoLocationMeilensteinQuickEdit, CoLocationMeilensteinMatrix, CoLocationBulkEditDialog 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. 72 72 73 - Import-Dialoge(beide Use-Cases) unterstützen: direkte Koordinatenspalten, DMS-Format, Koordinatenpaare im Adressfeld,Gemeinde-Auflösungper PLZ, mehrstufige strukturierte Geocoding-Anfragen (inkl. Konskriptionsnummern) mit Validierung gegen Gemeinde-Zentroide, sowie automatische Erkennung der Kopfzeile.97 +=== Gemeinden === 74 74 75 - ===3. Gemeinden===99 +Verwaltung der Gemeinden (Komponente CreateGemeindeForm). Zusätzlich existiert eine Supabase Edge Function zum Abruf von NÖ-Gemeinden (supabase/functions/fetch-noe-gemeinden). 76 76 77 - Verwaltungder Gemeinden (CreateGemeindeForm, nur Schwarmspeicher). Edge Functionfetch-noe-gemeinden lädt NÖ-Gemeinden.101 +=== Kartenansicht === 78 78 79 - ===4. Kartenansicht===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. 80 80 81 - InteraktiveKarte aller Standorte(Leaflet + Clustering), Adresssuche, Vollbildmodus, Flächenauswahl(Shift+Ziehen), Trafokarte-NÖ-Layermit Legende.105 +=== Potenzialanalyse === 82 82 83 -* Schwarmspeicher: ProjectMap 84 -* PV-Co-Location: CoLocationMap 85 -* Gemeinsam genutzt: LocationPickerMap (Einzelstandort-Kartenauswahl), src/lib/mapCoordinates.ts (dedupeCoordinates — verhindert sofortiges Auftrennen bei identischen Koordinaten) 107 +Bewertung möglicher Standorte. Komponenten: PotenzialTabelle, PotenzialPage. Die Potenzialanalyse ist aktuell dem Schwarmspeicher-Use-Case zugeordnet. 86 86 87 -=== 5.Potenzialanalyse ===109 +=== Pipeline === 88 88 89 - Bewertungmöglicher Standorte(PotenzialTabelle,PotenzialPage)—nurSchwarmspeicher, keinPendant beiPV-Co-Location.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. 90 90 91 -=== 6. Pipeline ===113 +=== Meilensteinverwaltung === 92 92 93 -* Schwarmspeicher: VorprojektePipeline, VorprojektTimeline 94 -* PV-Co-Location: CoLocationPipeline (Felder an kWp/BESS-kW angepasst; kein Pendant zu VorprojektTimeline) 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. 95 95 96 -=== 7. Meilensteinverwaltung ===117 +=== Aufgabenverwaltung === 97 97 98 -Projektfo rtschrittüberMeilensteine,matrixartigeÜbersichtmitBulk-Setzen,Gruppierung.119 +Projektbezogene Aufgaben. Komponenten: TaskManager, TasksPage. Hook: useTasks(). PV Co-Location verwendet mit CoTaskManager, CoLocationTasksPage und useCoTasks() eine eigene, vom Schwarmspeicher getrennte Aufgabenliste. 99 99 100 -* Schwarmspeicher: MeilensteinMatrix, MeilensteinQuickEdit (inkl. Sonderfall-Dialog NetzvertragAnpassungDialog) 101 -* 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) 121 +=== Dokumentenverwaltung === 102 102 103 - ===8. Stockend===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. 104 104 105 - ZeigtStandorte, bei denen die Lead-Time zwischen zwei Meilensteinen überschrittenist, konfigurierbareRegeln.125 +=== Standortpartner === 106 106 107 -* Schwarmspeicher: StuckPage 108 -* PV-Co-Location: CoLocationStuckPage (eigene, getrennt gespeicherte Lead-Time-Regeln entlang der neuen Meilensteinkette) 127 +Verwaltung von Projektpartnern. Komponenten: StandortpartnerManager, StandortpartnerTable. Für PV Co-Location existieren separate Komponenten und Datenzugriffe für Standortpartner. 109 109 110 -=== 9. Forecast ===129 +=== Stockende Projekte === 111 111 112 - MonatlicheZielvorgaben,Plan-vs-Ist-ChartsproKennzahl.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. 113 113 114 -* Schwarmspeicher: ForecastPage (kW und kWh pro Monat/Meilenstein, nach Land AT/DE getrennt) 115 -* PV-Co-Location: CoLocationForecastPage — 4 KPI-Charts entlang Netzantrag gestellt / Netzvertrag erhalten / Standort gebaut / Standort live Trading (kein Land-Split) 133 +=== Forecast === 116 116 117 - ===10. Aufgabenverwaltung===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. 118 118 119 -P rojektbezogene Aufgaben, jeweils eigene, komplett getrennteListe pro Use-Case.137 +=== PV Co-Location === 120 120 121 -* Schwarmspeicher: TaskManager, TasksPage, Hook useTasks() 122 -* PV-Co-Location: CoTaskManager, CoLocationTasksPage, Hook useCoTasks() 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. 123 123 124 -=== 11. Dokumentenverwaltung ===141 +=== Benutzerverwaltung === 125 125 126 - ZujedemStandort undjedemStandortpartnerkönnenDokumentehochgeladenwerden.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(). 127 127 128 -* Schwarmspeicher: StandortDokumente, PartnerDokumente, Hook useDokumente() 129 -* PV-Co-Location: CoLocationStandortDokumente, CoLocationPartnerDokumente, Hook useCoDokumente() — eigener Storage-Bucket co-dokumente 145 +=== Audit Log === 130 130 131 - ===12.Standortpartner===147 +Nachvollziehbarkeit von Änderungen über AuditLogPage und audit_log. Der Zugriff auf das Änderungsprotokoll ist über die vorhandenen Datenbankregeln auf Administratoren eingeschränkt. 132 132 133 -Verwaltung von Projektpartnern, eigene, komplett getrennte Partnerliste pro Use-Case. 134 - 135 -* Schwarmspeicher: StandortpartnerManager, StandortpartnerTable 136 -* PV-Co-Location: CoLocationStandortpartnerManager, CoLocationStandortpartnerTable 137 - 138 -=== 13. Benutzerverwaltung === 139 - 140 -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. 141 - 142 -=== 14. Audit Log === 143 - 144 -Nachvollziehbarkeit von Änderungen (AuditLogPage), tabellenübergreifend über beide Use-Cases. 145 - 146 -=== 15. Landingpage „Fläche verpachten" === 147 - 148 -Ö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. 149 - 150 -* Legt über die Edge Function public-lead-intake automatisch einen neuen Eintrag in der Schwarmspeicher-Pipeline (vorprojekte) an 151 -* E-Mail-Benachrichtigung optional (RESEND_API_KEY + LEAD_NOTIFY_EMAIL) — Anfrage wird auch ohne E-Mail-Konfiguration zuverlässig gespeichert 152 - 153 - 154 - 155 -|((( 156 -⚠️ **Hinweis: Platzhalter-Firmendaten** 157 - 158 -* In FlaecheVerpachtenPage.tsx sind Firmenname und Telefonnummer aktuell Platzhalter (Rateware). Vor dem Livegang unbedingt durch die echten Kontaktdaten ersetzen. 159 -))) 160 - 161 - 162 - 163 163 == Routing == 164 164 165 -|**Pfad**|**Seite**|**Use-Case**|**Login nötig** 166 -|/|Dashboard|Schwarmspeicher|ja 167 -|/projekte|Standorte|Schwarmspeicher|ja 168 -|/pipeline|Vorprojekte|Schwarmspeicher|ja 169 -|/potenzial|Potenzialanalyse|Schwarmspeicher|ja 170 -|/karte|Kartenansicht|Schwarmspeicher|ja 171 -|/forecast|Forecast|Schwarmspeicher|ja 172 -|/tasks|Aufgaben|Schwarmspeicher|ja 173 -|/stockend|Stockende Standorte|Schwarmspeicher|ja 174 -|/benutzer|Benutzerverwaltung|– (Admin)|ja 175 -|/historie|Audit Log|– (Admin)|ja 176 -|/pv-colocation|Dashboard|PV-Co-Location|ja 177 -|/pv-colocation/projekte|Standorte|PV-Co-Location|ja 178 -|/pv-colocation/pipeline|Vorprojekte|PV-Co-Location|ja 179 -|/pv-colocation/karte|Kartenansicht|PV-Co-Location|ja 180 -|/pv-colocation/forecast|Forecast|PV-Co-Location|ja 181 -|/pv-colocation/tasks|Aufgaben|PV-Co-Location|ja 182 -|/pv-colocation/stockend|Stockende Standorte|PV-Co-Location|ja 183 -|/flaeche-verpachten|Landingpage „Fläche verpachten"|—|NEIN – öffentlich 151 +|=Seite|=Beschreibung 152 +|Dashboard|Startseite 153 +|Projekte|Projektübersicht 154 +|Pipeline|Vorprojekte 155 +|Potenziale|Standortpotenziale 156 +|Karte|Kartenansicht 157 +|Stockend|Stockende Projekte / Standorte 158 +|Forecast|Forecast 159 +|Aufgaben|Aufgabenverwaltung 160 +|Audit Log|Änderungsprotokoll 161 +|Benutzer|Benutzerverwaltung 162 +|Login|Anmeldung 184 184 164 +**Schwarmspeicher-Routen:** / · /projekte · /pipeline · /potenzial · /karte · /stockend · /forecast · /tasks · /benutzer · /historie 185 185 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 186 186 187 187 == Datenzugriff == 188 188 189 -Der Zugriff erfolgt über Custom Hooks, die sämtliche Kommunikation mit Supabase kapseln:170 +Der Zugriff erfolgt über Custom Hooks, die die Kommunikation mit Supabase kapseln. React Query übernimmt Laden, Mutationen und Cache-Invalidierung. 190 190 191 -|((( 192 -~/~/ Schwarmspeicher 172 +macro:code 193 193 194 -useStandorte() useGemeinden() useVorprojekte() 174 +Schwarmspeicher: 175 +useStandorte() 176 +useGemeinden() 177 +useVorprojekte() 178 +useTasks() 179 +usePotenzialDaten() 180 +useStandortpartner() 181 +useMonatsziele() 182 +useDokumente() 195 195 196 -useTasks() usePotenzialDaten() useStandortpartner() 184 +PV Co-Location: 185 +useCoLocationStandorte() 186 +useCoLocationStandortpartner() 187 +useCoVorprojekte() 188 +useCoTasks() 189 +useCoMonatsziele() 190 +useCoDokumente() 197 197 198 - useMonatsziele() useDokumente()useIsAdmin()192 +Click and drag to move 199 199 194 +== Supabase == 200 200 201 - ~/~/PV-Co-Location196 +**Authentication:** Login, Passwortänderung, Rollenverwaltung und geschützte Routen. 202 202 203 - useCoLocationStandorte()useCoLocationStandortpartner()198 +**Datenbank:** Wird über SQL-Migrationen verwaltet (supabase/migrations/). Die Migrationen definieren Tabellen, Policies und Datenbankfunktionen. 204 204 205 - useCoVorprojekte()useCoTasks()useCoMonatsziele()useCoDokumente()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. 206 206 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. 207 207 208 -~/~/ Use-Case-übergreifend 209 - 210 -useUseCase() useAuth() 211 -))) 212 - 213 - 214 - 215 -== Supabase == 216 - 217 -**Authentication: **Login, Passwortänderung, Rollenverwaltung. 218 - 219 -**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. 220 - 221 221 **Edge Functions:** 222 222 223 223 * fetch-noe-gemeinden — lädt Gemeinden aus Niederösterreich 224 -* manage-users — Benutzerverwaltung, prüft Admin-Berechtigung serverseitig 225 -* public-lead-intake — nimmt Anfragen der öffentlichen Landingpage entgegen 207 +* manage-users — Benutzerverwaltung 226 226 227 - **Storage: **zwei Buckets — dokumente (Schwarmspeicher) und co-dokumente (PV-Co-Location).209 +macro:info 228 228 211 +Information 229 229 230 - ==Architektur==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. 231 231 232 - [[image:1789017284336-190.png||height="353"width="762"]]215 +Click and drag to move 233 233 234 - Zusätzlichübernimmt nginx im Frontend-Container TLS-Terminierung und same-origin-Routing (/auth, /rest, /storage, /realtime, /functions → supabase-kong) — dadurchläuft die App ohne CORS- oder Private-Network-Access-Probleme im Browser217 +== Architektur == 235 235 219 +macro:mermaid 236 236 237 - == Offene Punkte / zuverifizieren ==221 +macro:velocity 238 238 239 -|((( 240 -⚠️ **Vor einem breiteren Rollout klären** 223 +macro:html 241 241 242 -* 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. 243 -* Migrationsdateien in supabase/migrations/ müssen noch ins Git-Repo committet werden, falls noch nicht geschehen (Datenbank selbst ist bereits aktuell). 244 -* types.ts kennt die neuen co_*-Tabellen nicht — führt zu TypeScript-Warnungen beim Bauen (bewusst akzeptiert, kein Laufzeitfehler). 245 -* KPI-Zuordnung im PV-Co-Location-Forecast (Netzantrag = kWp, die übrigen drei Meilensteine = kW) ist eine Annahme — bei Bedarf auf eine einheitliche Einheit umstellen. 246 -))) 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"]}}} 247 247 238 +Click and drag to move 248 248 249 - 250 250 == Server == 251 251 252 - Das Projektliegtunter/mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokalundläuft ineinemeigenständigen Docker-Compose-Stack (schwarmspeicher-electrify_lokal).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. 253 253 254 -**Erreichbar unter:** 255 - 256 -* VPN: http:~/~/schwarmspeicher.spl-tele.com:8200 (SPL-TELE-Netzwerk) 257 -* Öffentlich: https:~/~/schwarmspeicher.electrify.at:8200 (Wildcard-Zertifikat *.electrify.at, Let's Encrypt, gültig bis 26.10.2026) 258 - 259 -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/. 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.
- 1789017284336-190.png
-
- Author
-
... ... @@ -1,1 +1,0 @@ 1 -XWiki.gurschkap - Size
-
... ... @@ -1,1 +1,0 @@ 1 -10.9 KB - Content