Changes for page Schwarmspeicher Electrify

Summary

• Page properties (1 modified, 0 added, 0 removed)
• Attachments (0 modified, 0 added, 4 removed)
  • 1789037109962-994.png
  • 1789039075740-139.png
  • 1789039120837-667.png
  • 1789039138746-630.png

Details

Page properties

Content

...	...	@@ -14,18 +14,15 @@
14	14
15	15	)))
16	16
	17	+
	18	+
17	17	== Überblick ==
18	18
19	19	**Schwarmspeicher Electrify **unterstützt den gesamten Projektlebenszyklus: Standortidentifikation, Genehmigungen, Projektsteuerung und Dokumentation — für beide Use-Cases parallel, über einen Umschalter in der Seitenleiste.
20	20
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)
23		-* **Datenquellen:** Nominatim/OpenStreetMap (Geocoding) · Edge Function fetch-noe-gemeinden (NÖ-Gemeindedaten) · EVN-Trafokarte (WMS-Layer, Netzkapazitäten)
24		-* **Orchestrierung:** eigener Docker-Compose-Stack, nginx als Reverse-Proxy (TLS-Terminierung + same-origin-Routing zu Supabase/Kong)
25		-
26	26	== Architektur ==
27	27
28		-[[image:1789039138746-630.png||height="586" width="598"]]
	25	+[[image:1789017284336-190.png||height="353" width="762"]]
29	29
30	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	31
...	...	@@ -35,6 +35,34 @@
35	35
36	36	**Backend: **Supabase (self-hosted) — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
37	37
	35	+== Projektstruktur ==
	36	+
	37	+|(((
	38	+📁 src/
	39	+
	40	+📁   components/   UI-Komponenten (Schwarmspeicher + CoLocation*-Pendants)
	41	+
	42	+📁   pages/   Seiten der Anwendung
	43	+
	44	+📁   hooks/   Datenzugriffe und Business-Logik
	45	+
	46	+📁   integrations/   Supabase Client
	47	+
	48	+📁   types/   TypeScript-Modelle
	49	+
	50	+📁   lib/   Hilfsfunktionen (u.a. mapCoordinates.ts)
	51	+
	52	+📁 supabase/
	53	+
	54	+📁   migrations/   SQL-Migrationen (inkl. komplettes PV-Co-Location-Schema)
	55	+
	56	+📁   functions/   Edge Functions
	57	+)))
	58	+
	59	+== Use-Case-Umschalter ==
	60	+
	61	+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.
	62	+
38	38	== Hauptfunktionen ==
39	39
40	40	=== 1. Dashboard ===
...	...	@@ -53,13 +53,6 @@
53	53
54	54	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.
55	55
56		-==== Meilensteinverwaltung ====
57		-
58		-Projektfortschritt über Meilensteine, matrixartige Übersicht mit Bulk-Setzen, Gruppierung.
59		-
60		-* Schwarmspeicher: MeilensteinMatrix, MeilensteinQuickEdit (inkl. Sonderfall-Dialog NetzvertragAnpassungDialog)
61		-* 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)
62		-
63	63	=== 3. Gemeinden ===
64	64
65	65	Verwaltung der Gemeinden (CreateGemeindeForm, nur Schwarmspeicher). Edge Function fetch-noe-gemeinden lädt NÖ-Gemeinden.
...	...	@@ -81,14 +81,21 @@
81	81	* Schwarmspeicher: VorprojektePipeline, VorprojektTimeline
82	82	* PV-Co-Location: CoLocationPipeline (Felder an kWp/BESS-kW angepasst; kein Pendant zu VorprojektTimeline)
83	83
84		-=== 7. Stockend ===
	102	+=== 7. Meilensteinverwaltung ===
85	85
	104	+Projektfortschritt über Meilensteine, matrixartige Übersicht mit Bulk-Setzen, Gruppierung.
	105	+
	106	+* Schwarmspeicher: MeilensteinMatrix, MeilensteinQuickEdit (inkl. Sonderfall-Dialog NetzvertragAnpassungDialog)
	107	+* 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)
	108	+
	109	+=== 8. Stockend ===
	110	+
86	86	Zeigt Standorte, bei denen die Lead-Time zwischen zwei Meilensteinen überschritten ist, konfigurierbare Regeln.
87	87
88	88	* Schwarmspeicher: StuckPage
89	89	* PV-Co-Location: CoLocationStuckPage (eigene, getrennt gespeicherte Lead-Time-Regeln entlang der neuen Meilensteinkette)
90	90
91		-=== 8. Forecast ===
	116	+=== 9. Forecast ===
92	92
93	93	Monatliche Zielvorgaben, Plan-vs-Ist-Charts pro Kennzahl.
94	94
...	...	@@ -95,7 +95,7 @@
95	95	* Schwarmspeicher: ForecastPage (kW und kWh pro Monat/Meilenstein, nach Land AT/DE getrennt)
96	96	* PV-Co-Location: CoLocationForecastPage — 4 KPI-Charts entlang Netzantrag gestellt / Netzvertrag erhalten / Standort gebaut / Standort live Trading (kein Land-Split)
97	97
98		-=== 9. Aufgabenverwaltung ===
	123	+=== 10. Aufgabenverwaltung ===
99	99
100	100	Projektbezogene Aufgaben, jeweils eigene, komplett getrennte Liste pro Use-Case.
101	101
...	...	@@ -102,7 +102,7 @@
102	102	* Schwarmspeicher: TaskManager, TasksPage, Hook useTasks()
103	103	* PV-Co-Location: CoTaskManager, CoLocationTasksPage, Hook useCoTasks()
104	104
105		-=== 10. Dokumentenverwaltung ===
	130	+=== 11. Dokumentenverwaltung ===
106	106
107	107	Zu jedem Standort und jedem Standortpartner können Dokumente hochgeladen werden.
108	108
...	...	@@ -109,7 +109,7 @@
109	109	* Schwarmspeicher: StandortDokumente, PartnerDokumente, Hook useDokumente()
110	110	* PV-Co-Location: CoLocationStandortDokumente, CoLocationPartnerDokumente, Hook useCoDokumente() — eigener Storage-Bucket co-dokumente
111	111
112		-=== 11. Standortpartner ===
	137	+=== 12. Standortpartner ===
113	113
114	114	Verwaltung von Projektpartnern, eigene, komplett getrennte Partnerliste pro Use-Case.
115	115
...	...	@@ -116,15 +116,15 @@
116	116	* Schwarmspeicher: StandortpartnerManager, StandortpartnerTable
117	117	* PV-Co-Location: CoLocationStandortpartnerManager, CoLocationStandortpartnerTable
118	118
119		-=== 12. Benutzerverwaltung ===
	144	+=== 13. Benutzerverwaltung ===
120	120
121	121	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.
122	122
123		-=== 13. Audit Log ===
	148	+=== 14. Audit Log ===
124	124
125	125	Nachvollziehbarkeit von Änderungen (AuditLogPage), tabellenübergreifend über beide Use-Cases.
126	126
127		-=== 14. Landingpage „Fläche verpachten" (im Aufbau) ===
	152	+=== 15. Landingpage „Fläche verpachten" ===
128	128
129	129	Ö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.
130	130
...	...	@@ -139,6 +139,8 @@
139	139	* In FlaecheVerpachtenPage.tsx sind Firmenname und Telefonnummer aktuell Platzhalter (Rateware). Vor dem Livegang unbedingt durch die echten Kontaktdaten ersetzen.
140	140	)))
141	141
	167	+
	168	+
142	142	== Routing ==
143	143
144	144	|**Pfad**|**Seite**|**Use-Case**|**Login nötig**
...	...	@@ -161,6 +161,8 @@
161	161	|/pv-colocation/stockend|Stockende Standorte|PV-Co-Location|ja
162	162	|/flaeche-verpachten|Landingpage „Fläche verpachten"|—|NEIN – öffentlich
163	163
	191	+
	192	+
164	164	== Datenzugriff ==
165	165
166	166	Der Zugriff erfolgt über Custom Hooks, die sämtliche Kommunikation mit Supabase kapseln:
...	...	@@ -187,6 +187,8 @@
187	187	useUseCase()   useAuth()
188	188	)))
189	189
	219	+
	220	+
190	190	== Supabase ==
191	191
192	192	**Authentication: **Login, Passwortänderung, Rollenverwaltung.
...	...	@@ -201,10 +201,7 @@
201	201
202	202	**Storage: **zwei Buckets — dokumente (Schwarmspeicher) und co-dokumente (PV-Co-Location).
203	203
204		-== Use-Case-Umschalter ==
205	205
206		-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.
207		-
208	208	== Offene Punkte / zu verifizieren ==
209	209
210	210	|(((
...	...	@@ -211,9 +211,13 @@
211	211	⚠️  **Vor einem breiteren Rollout klären**
212	212
213	213	* 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.
	242	+* Migrationsdateien in supabase/migrations/ müssen noch ins Git-Repo committet werden, falls noch nicht geschehen (Datenbank selbst ist bereits aktuell).
	243	+* types.ts kennt die neuen co_*-Tabellen nicht — führt zu TypeScript-Warnungen beim Bauen (bewusst akzeptiert, kein Laufzeitfehler).
214	214	* KPI-Zuordnung im PV-Co-Location-Forecast (Netzantrag = kWp, die übrigen drei Meilensteine = kW) ist eine Annahme — bei Bedarf auf eine einheitliche Einheit umstellen.
215	215	)))
216	216
	247	+
	248	+
217	217	== Server ==
218	218
219	219	Das Projekt liegt unter /mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal und läuft in einem eigenständigen Docker-Compose-Stack (schwarmspeicher-electrify_lokal).
...	...	@@ -220,6 +220,7 @@
220	220
221	221	**Erreichbar unter:**
222	222
223		-Öffentlich: https:~/~/schwarmspeicher.electrify.at:8200 (Wildcard-Zertifikat *.electrify.at, Let's Encrypt, gültig bis 26.10.2026)
	255	+* VPN: http:~/~/schwarmspeicher.spl-tele.com:8200 (SPL-TELE-Netzwerk)
	256	+* Öffentlich: https:~/~/schwarmspeicher.electrify.at:8200 (Wildcard-Zertifikat *.electrify.at, Let's Encrypt, gültig bis 26.10.2026)
224	224
225	225	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/.

1789037109962-994.png

Author

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

Size

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

Content

1789039075740-139.png

Author

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

Size

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

Content

1789039120837-667.png

Author

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

Size

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

Content

1789039138746-630.png

Author

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

Size

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

Content