Changes for page Schwarmspeicher Electrify

Summary

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

Details

Page properties

Content

...	...	@@ -14,12 +14,21 @@
14	14
15	15	)))
16	16
	17	+== Überblick ==
17	17
	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.
18	18
19		-== Übersicht ==
	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)
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.
	26	+== Architektur ==
22	22
	28	+[[image:1789039138746-630.png||height="586" width="598"]]
	29	+
	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	+
23	23	== Technologie-Stack ==
24	24
25	25	**Frontend: **React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · Leaflet + leaflet.markercluster (Kartendarstellung) · Recharts (Diagramme) · XLSX (Excel-Import/-Export)
...	...	@@ -26,34 +26,6 @@
26	26
27	27	**Backend: **Supabase (self-hosted) — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
28	28
29		-== Projektstruktur ==
30		-
31		-|(((
32		-📁 src/
33		-
34		-📁   components/   UI-Komponenten (Schwarmspeicher + CoLocation*-Pendants)
35		-
36		-📁   pages/   Seiten der Anwendung
37		-
38		-📁   hooks/   Datenzugriffe und Business-Logik
39		-
40		-📁   integrations/   Supabase Client
41		-
42		-📁   types/   TypeScript-Modelle
43		-
44		-📁   lib/   Hilfsfunktionen (u.a. mapCoordinates.ts)
45		-
46		-📁 supabase/
47		-
48		-📁   migrations/   SQL-Migrationen (inkl. komplettes PV-Co-Location-Schema)
49		-
50		-📁   functions/   Edge Functions
51		-)))
52		-
53		-== Use-Case-Umschalter ==
54		-
55		-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.
56		-
57	57	== Hauptfunktionen ==
58	58
59	59	=== 1. Dashboard ===
...	...	@@ -72,6 +72,13 @@
72	72
73	73	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.
74	74
	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	+
75	75	=== 3. Gemeinden ===
76	76
77	77	Verwaltung der Gemeinden (CreateGemeindeForm, nur Schwarmspeicher). Edge Function fetch-noe-gemeinden lädt NÖ-Gemeinden.
...	...	@@ -93,21 +93,14 @@
93	93	* Schwarmspeicher: VorprojektePipeline, VorprojektTimeline
94	94	* PV-Co-Location: CoLocationPipeline (Felder an kWp/BESS-kW angepasst; kein Pendant zu VorprojektTimeline)
95	95
96		-=== 7. Meilensteinverwaltung ===
	84	+=== 7. Stockend ===
97	97
98		-Projektfortschritt über Meilensteine, matrixartige Übersicht mit Bulk-Setzen, Gruppierung.
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)
102		-
103		-=== 8. Stockend ===
104		-
105	105	Zeigt Standorte, bei denen die Lead-Time zwischen zwei Meilensteinen überschritten ist, konfigurierbare Regeln.
106	106
107	107	* Schwarmspeicher: StuckPage
108	108	* PV-Co-Location: CoLocationStuckPage (eigene, getrennt gespeicherte Lead-Time-Regeln entlang der neuen Meilensteinkette)
109	109
110		-=== 9. Forecast ===
	91	+=== 8. Forecast ===
111	111
112	112	Monatliche Zielvorgaben, Plan-vs-Ist-Charts pro Kennzahl.
113	113
...	...	@@ -114,7 +114,7 @@
114	114	* Schwarmspeicher: ForecastPage (kW und kWh pro Monat/Meilenstein, nach Land AT/DE getrennt)
115	115	* PV-Co-Location: CoLocationForecastPage — 4 KPI-Charts entlang Netzantrag gestellt / Netzvertrag erhalten / Standort gebaut / Standort live Trading (kein Land-Split)
116	116
117		-=== 10. Aufgabenverwaltung ===
	98	+=== 9. Aufgabenverwaltung ===
118	118
119	119	Projektbezogene Aufgaben, jeweils eigene, komplett getrennte Liste pro Use-Case.
120	120
...	...	@@ -121,7 +121,7 @@
121	121	* Schwarmspeicher: TaskManager, TasksPage, Hook useTasks()
122	122	* PV-Co-Location: CoTaskManager, CoLocationTasksPage, Hook useCoTasks()
123	123
124		-=== 11. Dokumentenverwaltung ===
	105	+=== 10. Dokumentenverwaltung ===
125	125
126	126	Zu jedem Standort und jedem Standortpartner können Dokumente hochgeladen werden.
127	127
...	...	@@ -128,7 +128,7 @@
128	128	* Schwarmspeicher: StandortDokumente, PartnerDokumente, Hook useDokumente()
129	129	* PV-Co-Location: CoLocationStandortDokumente, CoLocationPartnerDokumente, Hook useCoDokumente() — eigener Storage-Bucket co-dokumente
130	130
131		-=== 12. Standortpartner ===
	112	+=== 11. Standortpartner ===
132	132
133	133	Verwaltung von Projektpartnern, eigene, komplett getrennte Partnerliste pro Use-Case.
134	134
...	...	@@ -135,15 +135,15 @@
135	135	* Schwarmspeicher: StandortpartnerManager, StandortpartnerTable
136	136	* PV-Co-Location: CoLocationStandortpartnerManager, CoLocationStandortpartnerTable
137	137
138		-=== 13. Benutzerverwaltung ===
	119	+=== 12. Benutzerverwaltung ===
139	139
140	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	141
142		-=== 14. Audit Log ===
	123	+=== 13. Audit Log ===
143	143
144	144	Nachvollziehbarkeit von Änderungen (AuditLogPage), tabellenübergreifend über beide Use-Cases.
145	145
146		-=== 15. Landingpage „Fläche verpachten" ===
	127	+=== 14. Landingpage „Fläche verpachten" (im Aufbau) ===
147	147
148	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	149
...	...	@@ -158,8 +158,6 @@
158	158	* In FlaecheVerpachtenPage.tsx sind Firmenname und Telefonnummer aktuell Platzhalter (Rateware). Vor dem Livegang unbedingt durch die echten Kontaktdaten ersetzen.
159	159	)))
160	160
161		-
162		-
163	163	== Routing ==
164	164
165	165	|**Pfad**|**Seite**|**Use-Case**|**Login nötig**
...	...	@@ -182,8 +182,6 @@
182	182	|/pv-colocation/stockend|Stockende Standorte|PV-Co-Location|ja
183	183	|/flaeche-verpachten|Landingpage „Fläche verpachten"|—|NEIN – öffentlich
184	184
185		-
186		-
187	187	== Datenzugriff ==
188	188
189	189	Der Zugriff erfolgt über Custom Hooks, die sämtliche Kommunikation mit Supabase kapseln:
...	...	@@ -210,8 +210,6 @@
210	210	useUseCase()   useAuth()
211	211	)))
212	212
213		-
214		-
215	215	== Supabase ==
216	216
217	217	**Authentication: **Login, Passwortänderung, Rollenverwaltung.
...	...	@@ -226,14 +226,10 @@
226	226
227	227	**Storage: **zwei Buckets — dokumente (Schwarmspeicher) und co-dokumente (PV-Co-Location).
228	228
	204	+== Use-Case-Umschalter ==
229	229
230		-== Architektur ==
	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.
231	231
232		-[[image:1789017284336-190.png||height="353" width="762"]]
233		-
234		-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
235		-
236		-
237	237	== Offene Punkte / zu verifizieren ==
238	238
239	239	|(((
...	...	@@ -240,13 +240,9 @@
240	240	⚠️  **Vor einem breiteren Rollout klären**
241	241
242	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	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	246	)))
247	247
248		-
249		-
250	250	== Server ==
251	251
252	252	Das Projekt liegt unter /mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal und läuft in einem eigenständigen Docker-Compose-Stack (schwarmspeicher-electrify_lokal).

1789037109962-994.png

Author

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

Size

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

Content

1789039075740-139.png

Author

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

Size

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

Content

1789039120837-667.png

Author

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

Size

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

Content

1789039138746-630.png

Author

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

Size

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

Content