Changes for page Schwarmspeicher Electrify
Last modified by Patrizia Gurschka on 2026/09/10 14:58
From version 11.2
edited by Patrizia Gurschka
on 2026/09/10 08:16
on 2026/09/10 08:16
Change comment:
Auto-saved during real-time collaboration
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,254 +1,244 @@ 1 -|(% style="width:788px" %)((( 2 -= 🔋 Schwarmspeicher Electrify = 1 +macro:box 3 3 3 +**Auf dieser Seite** 4 4 5 -{{info}} 6 -**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 +macro:toc 7 7 8 -* *Zielgruppe:**Vertriebs-/Projektentwicklungsteam und IT/DevOps-Betrieb.9 - {{/info}}7 +* ((( 8 +[[🔋 Schwarmspeicher Electrify>>path:#HD83DDD0BSchwarmspeicherElectrify]] 10 10 11 -|((( 12 -📁 src/ 10 +* [[Übersicht>>path:#HDCbersicht]] 11 +* [[Technologie-Stack>>path:#HTechnologie-Stack]] 12 +* [[Projektstruktur>>path:#HProjektstruktur]] 13 +* ((( 14 +[[Hauptfunktionen>>path:#HHauptfunktionen]] 13 13 14 -📁 components/ UI-Komponenten (Schwarmspeicher + CoLocation*-Pendants) 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 +))) 15 15 16 -📁 pages/ Seiten der Anwendung 17 17 18 -📁 hooks/ Datenzugriffe und Business-Logik 19 19 20 -? ?integrations/SupabaseClient42 += ?? Schwarmspeicher Electrify = 21 21 22 - 📁 types/ TypeScript-Modelle44 +macro:info 23 23 24 - 📁 lib/ Hilfsfunktionen (u.a.mapCoordinates.ts)46 +Information 25 25 26 - 📁supabase/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**. 27 27 28 - 📁 migrations/SQL-Migrationen(inkl. komplettes PV-Co-Location-Schema)50 +Click and drag to move 29 29 30 -📁 functions/ Edge Functions 31 -))) 52 +== Übersicht == 32 32 33 - ==Architektur==54 +**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. 34 34 35 - [[image:1789017284336-190.png||height="353"width="762"]]56 +== Technologie-Stack == 36 36 37 -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 38 -)))|(% style="width:280px" %)((( 39 - 40 -))) 58 +**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 60 +**Backend:** Supabase — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS) 42 42 62 +**Tests:** Vitest 3.2.4 · Playwright 1.57.0 43 43 44 -== Übersicht ==64 +== Projektstruktur == 45 45 46 - **SchwarmspeicherElectrify **unterstützt den gesamten Projektlebenszyklus:Standortidentifikation, Genehmigungen, Projektsteuerung und Dokumentation — für beide Use-Cases parallel, über einen Umschalter in der Seitenleiste.66 +macro:code 47 47 48 -== Technologie-Stack == 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 49 49 50 -**Frontend: **React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · Leaflet + leaflet.markercluster (Kartendarstellung) · Recharts (Diagramme) · XLSX (Excel-Import/-Export) 76 +supabase/ 77 +├── migrations/ 78 +├── functions/ 79 +└── config.toml 51 51 52 - **Backend:**Supabase (self-hosted)— PostgreSQL, Authentication, Storage,Edge Functions,Row Level Security (RLS)81 +Click and drag to move 53 53 54 -== Use-Case-Umschalter == 55 - 56 -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. 57 - 58 58 == Hauptfunktionen == 59 59 60 60 === Dashboard === 61 61 62 -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. 63 63 64 -* Schwarmspeicher: Dashboard.tsx — Pipeline-Summary, kW/kWh-KPIs, Plan-vs-Ist-Charts pro Meilenstein 65 -* PV-Co-Location: CoLocationDashboard.tsx — gleiche Struktur, Einheiten angepasst (kWp/kW), zweite Übersichtskarte zeigt Standortpartner-Anzahl statt Gemeinden 89 +=== Projektverwaltung === 66 66 67 - ===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. 68 68 69 -Standorte anlegen, bearbeiten, importieren, Historie, Dokumente, sortierbare Tabelle mitMeilenstein-Filter, Bulk-Bearbeitung,Als-abgebrochen-markieren/Reaktivieren.93 +=== Standortverwaltung === 70 70 71 -* Schwarmspeicher: ProjectTable, StandortDetail, CreateStandortFormNew, StandortImportDialog, StandortDokumente, AbbruchDialog, MeilensteinQuickEdit, MeilensteinMatrix, BulkEditStandortDialog 72 -* 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. 73 73 74 -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. 75 - 76 76 === Gemeinden === 77 77 78 -Verwaltung der Gemeinden (CreateGemeindeForm ,nur Schwarmspeicher).Edge Function fetch-noe-gemeindenlädtNÖ-Gemeinden.99 +Verwaltung der Gemeinden (Komponente CreateGemeindeForm). Zusätzlich existiert eine Supabase Edge Function zum Abruf von NÖ-Gemeinden (supabase/functions/fetch-noe-gemeinden). 79 79 80 80 === Kartenansicht === 81 81 82 - Interaktive Karte aller Standorte(Leaflet+ Clustering),Adresssuche,Vollbildmodus, Flächenauswahl(Shift+Ziehen),Trafokarte-NÖ-LayermitLegende.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. 83 83 84 -* Schwarmspeicher: ProjectMap 85 -* PV-Co-Location: CoLocationMap 86 -* Gemeinsam genutzt: LocationPickerMap (Einzelstandort-Kartenauswahl), src/lib/mapCoordinates.ts (dedupeCoordinates — verhindert sofortiges Auftrennen bei identischen Koordinaten) 87 - 88 88 === Potenzialanalyse === 89 89 90 -Bewertung möglicher Standorte (PotenzialTabelle, PotenzialPage)—nurSchwarmspeicher, keinPendant bei PV-Co-Location.107 +Bewertung möglicher Standorte. Komponenten: PotenzialTabelle, PotenzialPage. Die Potenzialanalyse ist aktuell dem Schwarmspeicher-Use-Case zugeordnet. 91 91 92 92 === Pipeline === 93 93 94 -* Schwarmspeicher: VorprojektePipeline, VorprojektTimeline 95 -* PV-Co-Location: CoLocationPipeline (Felder an kWp/BESS-kW angepasst; kein Pendant zu VorprojektTimeline) 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. 96 96 97 97 === Meilensteinverwaltung === 98 98 99 -Projektfortschritt über Meilensteine ,matrixartigeÜbersichtmitBulk-Setzen,Gruppierung.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. 100 100 101 -* Schwarmspeicher: MeilensteinMatrix, MeilensteinQuickEdit (inkl. Sonderfall-Dialog NetzvertragAnpassungDialog) 102 -* 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) 103 - 104 -=== Stockend === 105 - 106 -Zeigt Standorte, bei denen die Lead-Time zwischen zwei Meilensteinen überschritten ist, konfigurierbare Regeln. 107 - 108 -* Schwarmspeicher: StuckPage 109 -* PV-Co-Location: CoLocationStuckPage (eigene, getrennt gespeicherte Lead-Time-Regeln entlang der neuen Meilensteinkette) 110 - 111 -=== Forecast === 112 - 113 -Monatliche Zielvorgaben, Plan-vs-Ist-Charts pro Kennzahl. 114 - 115 -* Schwarmspeicher: ForecastPage (kW und kWh pro Monat/Meilenstein, nach Land AT/DE getrennt) 116 -* PV-Co-Location: CoLocationForecastPage — 4 KPI-Charts entlang Netzantrag gestellt / Netzvertrag erhalten / Standort gebaut / Standort live Trading (kein Land-Split) 117 - 118 118 === Aufgabenverwaltung === 119 119 120 -Projektbezogene Aufgaben, jeweils eigene,komplettgetrennteListepro Use-Case.119 +Projektbezogene Aufgaben. Komponenten: TaskManager, TasksPage. Hook: useTasks(). PV Co-Location verwendet mit CoTaskManager, CoLocationTasksPage und useCoTasks() eine eigene, vom Schwarmspeicher getrennte Aufgabenliste. 121 121 122 -* Schwarmspeicher: TaskManager, TasksPage, Hook useTasks() 123 -* PV-Co-Location: CoTaskManager, CoLocationTasksPage, Hook useCoTasks() 124 - 125 125 === Dokumentenverwaltung === 126 126 127 -Zu jedem Standort un djedem StandortpartnerkönnenDokumentehochgeladen werden.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. 128 128 129 -* Schwarmspeicher: StandortDokumente, PartnerDokumente, Hook useDokumente() 130 -* PV-Co-Location: CoLocationStandortDokumente, CoLocationPartnerDokumente, Hook useCoDokumente() — eigener Storage-Bucket co-dokumente 131 - 132 132 === Standortpartner === 133 133 134 -Verwaltung von Projektpartnern ,eigene,komplettgetrenntePartnerlisteproUse-Case.127 +Verwaltung von Projektpartnern. Komponenten: StandortpartnerManager, StandortpartnerTable. Für PV Co-Location existieren separate Komponenten und Datenzugriffe für Standortpartner. 135 135 136 -* Schwarmspeicher: StandortpartnerManager, StandortpartnerTable 137 -* PV-Co-Location: CoLocationStandortpartnerManager, CoLocationStandortpartnerTable 129 +=== Stockende Projekte === 138 138 139 - === Benutzerverwaltung===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. 140 140 141 - Anmeldung,Passwortänderung, Rollen (admin/user). Komponenten: AuthProvider, ProtectedRoute, BenutzerPage, LoginPage. Läuft über die EdgeFunction manage-users (SupabaseAdmin-API, prüft Admin-Rechte serverseitig). Nach Login wird immer auf "/" weitergeleitet, unabhängig von der zuvor besuchtenURL.133 +=== Forecast === 142 142 143 - ===Audit Log===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. 144 144 145 - NachvollziehbarkeitvonÄnderungen (AuditLogPage),tabellenübergreifendüber beide Use-Cases.137 +=== PV Co-Location === 146 146 147 - ===Landingpage„Flächeverpachten"===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. 148 148 149 - Öffentlicherreichbare Seite ohne Loginunter/flaeche-verpachten — für Grundstückseigentümer, die eine Fläche für einen Batteriespeicher zur Verfügungstellen wollen. Kartenbasierte Standortauswahl, Formular mit Honeypot-Spamschutz.141 +=== Benutzerverwaltung === 150 150 151 -* Legt über die Edge Function public-lead-intake automatisch einen neuen Eintrag in der Schwarmspeicher-Pipeline (vorprojekte) an 152 -* E-Mail-Benachrichtigung optional (RESEND_API_KEY + LEAD_NOTIFY_EMAIL) — Anfrage wird auch ohne E-Mail-Konfiguration zuverlässig gespeichert 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(). 153 153 145 +=== Audit Log === 154 154 147 +Nachvollziehbarkeit von Änderungen über AuditLogPage und audit_log. Der Zugriff auf das Änderungsprotokoll ist über die vorhandenen Datenbankregeln auf Administratoren eingeschränkt. 155 155 156 -|((( 157 -⚠️ **Hinweis: Platzhalter-Firmendaten** 158 - 159 -* In FlaecheVerpachtenPage.tsx sind Firmenname und Telefonnummer aktuell Platzhalter (Rateware). Vor dem Livegang unbedingt durch die echten Kontaktdaten ersetzen. 160 -))) 161 - 162 - 163 - 164 164 == Routing == 165 165 166 -|**Pfad**|**Seite**|**Use-Case**|**Login nötig** 167 -|/|Dashboard|Schwarmspeicher|ja 168 -|/projekte|Standorte|Schwarmspeicher|ja 169 -|/pipeline|Vorprojekte|Schwarmspeicher|ja 170 -|/potenzial|Potenzialanalyse|Schwarmspeicher|ja 171 -|/karte|Kartenansicht|Schwarmspeicher|ja 172 -|/forecast|Forecast|Schwarmspeicher|ja 173 -|/tasks|Aufgaben|Schwarmspeicher|ja 174 -|/stockend|Stockende Standorte|Schwarmspeicher|ja 175 -|/benutzer|Benutzerverwaltung|– (Admin)|ja 176 -|/historie|Audit Log|– (Admin)|ja 177 -|/pv-colocation|Dashboard|PV-Co-Location|ja 178 -|/pv-colocation/projekte|Standorte|PV-Co-Location|ja 179 -|/pv-colocation/pipeline|Vorprojekte|PV-Co-Location|ja 180 -|/pv-colocation/karte|Kartenansicht|PV-Co-Location|ja 181 -|/pv-colocation/forecast|Forecast|PV-Co-Location|ja 182 -|/pv-colocation/tasks|Aufgaben|PV-Co-Location|ja 183 -|/pv-colocation/stockend|Stockende Standorte|PV-Co-Location|ja 184 -|/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 185 185 164 +**Schwarmspeicher-Routen:** / · /projekte · /pipeline · /potenzial · /karte · /stockend · /forecast · /tasks · /benutzer · /historie 186 186 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 187 187 188 188 == Datenzugriff == 189 189 190 -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. 191 191 192 -|((( 193 -~/~/ Schwarmspeicher 172 +macro:code 194 194 195 -useStandorte() useGemeinden() useVorprojekte() 174 +Schwarmspeicher: 175 +useStandorte() 176 +useGemeinden() 177 +useVorprojekte() 178 +useTasks() 179 +usePotenzialDaten() 180 +useStandortpartner() 181 +useMonatsziele() 182 +useDokumente() 196 196 197 -useTasks() usePotenzialDaten() useStandortpartner() 184 +PV Co-Location: 185 +useCoLocationStandorte() 186 +useCoLocationStandortpartner() 187 +useCoVorprojekte() 188 +useCoTasks() 189 +useCoMonatsziele() 190 +useCoDokumente() 198 198 199 - useMonatsziele() useDokumente()useIsAdmin()192 +Click and drag to move 200 200 194 +== Supabase == 201 201 202 - ~/~/PV-Co-Location196 +**Authentication:** Login, Passwortänderung, Rollenverwaltung und geschützte Routen. 203 203 204 - useCoLocationStandorte()useCoLocationStandortpartner()198 +**Datenbank:** Wird über SQL-Migrationen verwaltet (supabase/migrations/). Die Migrationen definieren Tabellen, Policies und Datenbankfunktionen. 205 205 206 - 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. 207 207 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. 208 208 209 -~/~/ Use-Case-übergreifend 210 - 211 -useUseCase() useAuth() 212 -))) 213 - 214 - 215 - 216 -== Supabase == 217 - 218 -**Authentication: **Login, Passwortänderung, Rollenverwaltung. 219 - 220 -**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. 221 - 222 222 **Edge Functions:** 223 223 224 224 * fetch-noe-gemeinden — lädt Gemeinden aus Niederösterreich 225 -* manage-users — Benutzerverwaltung, prüft Admin-Berechtigung serverseitig 226 -* public-lead-intake — nimmt Anfragen der öffentlichen Landingpage entgegen 207 +* manage-users — Benutzerverwaltung 227 227 228 - **Storage: **zwei Buckets — dokumente (Schwarmspeicher) und co-dokumente (PV-Co-Location).209 +macro:info 229 229 230 - == ==211 +Information 231 231 232 - ==OffenePunkte/zu verifizieren==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. 233 233 234 -|((( 235 -⚠️ **Vor einem breiteren Rollout klären** 215 +Click and drag to move 236 236 237 -* 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. 238 -* Migrationsdateien in supabase/migrations/ müssen noch ins Git-Repo committet werden, falls noch nicht geschehen (Datenbank selbst ist bereits aktuell). 239 -* types.ts kennt die neuen co_*-Tabellen nicht — führt zu TypeScript-Warnungen beim Bauen (bewusst akzeptiert, kein Laufzeitfehler). 240 -* KPI-Zuordnung im PV-Co-Location-Forecast (Netzantrag = kWp, die übrigen drei Meilensteine = kW) ist eine Annahme — bei Bedarf auf eine einheitliche Einheit umstellen. 241 -))) 217 +== Architektur == 242 242 219 +macro:mermaid 243 243 221 +macro:velocity 244 244 245 - == Server ==223 +macro:html 246 246 247 -Das Projekt liegt unter /mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal und läuft in einem eigenständigen Docker-Compose-Stack (schwarmspeicher-electrify_lokal). 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"]}}} 248 248 249 - **Erreichbarunter:**238 +Click and drag to move 250 250 251 -* VPN: http:~/~/schwarmspeicher.spl-tele.com:8200 (SPL-TELE-Netzwerk) 252 -* Öffentlich: https:~/~/schwarmspeicher.electrify.at:8200 (Wildcard-Zertifikat *.electrify.at, Let's Encrypt, gültig bis 26.10.2026) 240 +== Server == 253 253 254 -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/. 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. 243 + 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