Changes for page Schwarmspeicher Electrify

Summary

• Page properties (1 modified, 0 added, 0 removed)

Details

Page properties

Content

...	...	@@ -1,12 +1,12 @@
1		-|(% style="width:650px" %)(((
	1	+|(% style="width:788px" %)(((
2	2	= 🔋  Schwarmspeicher Electrify =
3	3
4	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	+**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	6
7	7	**Zielgruppe: **Vertriebs-/Projektentwicklungsteam und IT/DevOps-Betrieb.
8	8	{{/info}}
9		-)))|(% style="width:418px" %)(((
	9	+)))|(% style="width:280px" %)(((
10	10	**Auf dieser Seite**
11	11
12	12	{{toc/}}
...	...	@@ -14,16 +14,12 @@
14	14
15	15	)))
16	16
17		-== Überblick ==
18	18
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		-== Architektur ==
	19	+== Übersicht ==
22	22
23		-[[image:1789017284336-190.png||height="353" width="762"]]
	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.
24	24
25		-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
26		-
27	27	== Technologie-Stack ==
28	28
29	29	**Frontend: **React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · Leaflet + leaflet.markercluster (Kartendarstellung) · Recharts (Diagramme) · XLSX (Excel-Import/-Export)
...	...	@@ -30,9 +30,37 @@
30	30
31	31	**Backend: **Supabase (self-hosted) — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
32	32
	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	+
33	33	== Hauptfunktionen ==
34	34
35		-=== 1. Dashboard ===
	59	+=== Dashboard ===
36	36
37	37	Zentrale Übersicht über Projekte, Status, Kennzahlen und Projektfortschritt.
38	38
...	...	@@ -39,7 +39,7 @@
39	39	* Schwarmspeicher: Dashboard.tsx — Pipeline-Summary, kW/kWh-KPIs, Plan-vs-Ist-Charts pro Meilenstein
40	40	* PV-Co-Location: CoLocationDashboard.tsx — gleiche Struktur, Einheiten angepasst (kWp/kW), zweite Übersichtskarte zeigt Standortpartner-Anzahl statt Gemeinden
41	41
42		-=== 2. Projektverwaltung / Standortverwaltung ===
	66	+=== Projektverwaltung / Standortverwaltung ===
43	43
44	44	Standorte anlegen, bearbeiten, importieren, Historie, Dokumente, sortierbare Tabelle mit Meilenstein-Filter, Bulk-Bearbeitung, Als-abgebrochen-markieren/Reaktivieren.
45	45
...	...	@@ -48,11 +48,11 @@
48	48
49	49	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.
50	50
51		-=== 3. Gemeinden ===
	75	+=== Gemeinden ===
52	52
53	53	Verwaltung der Gemeinden (CreateGemeindeForm, nur Schwarmspeicher). Edge Function fetch-noe-gemeinden lädt NÖ-Gemeinden.
54	54
55		-=== 4. Kartenansicht ===
	79	+=== Kartenansicht ===
56	56
57	57	Interaktive Karte aller Standorte (Leaflet + Clustering), Adresssuche, Vollbildmodus, Flächenauswahl (Shift+Ziehen), Trafokarte-NÖ-Layer mit Legende.
58	58
...	...	@@ -60,16 +60,16 @@
60	60	* PV-Co-Location: CoLocationMap
61	61	* Gemeinsam genutzt: LocationPickerMap (Einzelstandort-Kartenauswahl), src/lib/mapCoordinates.ts (dedupeCoordinates — verhindert sofortiges Auftrennen bei identischen Koordinaten)
62	62
63		-=== 5. Potenzialanalyse ===
	87	+=== Potenzialanalyse ===
64	64
65	65	Bewertung möglicher Standorte (PotenzialTabelle, PotenzialPage) — nur Schwarmspeicher, kein Pendant bei PV-Co-Location.
66	66
67		-=== 6. Pipeline ===
	91	+=== Pipeline ===
68	68
69	69	* Schwarmspeicher: VorprojektePipeline, VorprojektTimeline
70	70	* PV-Co-Location: CoLocationPipeline (Felder an kWp/BESS-kW angepasst; kein Pendant zu VorprojektTimeline)
71	71
72		-=== 7. Meilensteinverwaltung ===
	96	+=== Meilensteinverwaltung ===
73	73
74	74	Projektfortschritt über Meilensteine, matrixartige Übersicht mit Bulk-Setzen, Gruppierung.
75	75
...	...	@@ -76,7 +76,7 @@
76	76	* Schwarmspeicher: MeilensteinMatrix, MeilensteinQuickEdit (inkl. Sonderfall-Dialog NetzvertragAnpassungDialog)
77	77	* 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)
78	78
79		-=== 8. Stockend ===
	103	+=== Stockend ===
80	80
81	81	Zeigt Standorte, bei denen die Lead-Time zwischen zwei Meilensteinen überschritten ist, konfigurierbare Regeln.
82	82
...	...	@@ -83,7 +83,7 @@
83	83	* Schwarmspeicher: StuckPage
84	84	* PV-Co-Location: CoLocationStuckPage (eigene, getrennt gespeicherte Lead-Time-Regeln entlang der neuen Meilensteinkette)
85	85
86		-=== 9. Forecast ===
	110	+=== Forecast ===
87	87
88	88	Monatliche Zielvorgaben, Plan-vs-Ist-Charts pro Kennzahl.
89	89
...	...	@@ -90,7 +90,7 @@
90	90	* Schwarmspeicher: ForecastPage (kW und kWh pro Monat/Meilenstein, nach Land AT/DE getrennt)
91	91	* PV-Co-Location: CoLocationForecastPage — 4 KPI-Charts entlang Netzantrag gestellt / Netzvertrag erhalten / Standort gebaut / Standort live Trading (kein Land-Split)
92	92
93		-=== 10. Aufgabenverwaltung ===
	117	+=== Aufgabenverwaltung ===
94	94
95	95	Projektbezogene Aufgaben, jeweils eigene, komplett getrennte Liste pro Use-Case.
96	96
...	...	@@ -97,7 +97,7 @@
97	97	* Schwarmspeicher: TaskManager, TasksPage, Hook useTasks()
98	98	* PV-Co-Location: CoTaskManager, CoLocationTasksPage, Hook useCoTasks()
99	99
100		-=== 11. Dokumentenverwaltung ===
	124	+=== Dokumentenverwaltung ===
101	101
102	102	Zu jedem Standort und jedem Standortpartner können Dokumente hochgeladen werden.
103	103
...	...	@@ -104,7 +104,7 @@
104	104	* Schwarmspeicher: StandortDokumente, PartnerDokumente, Hook useDokumente()
105	105	* PV-Co-Location: CoLocationStandortDokumente, CoLocationPartnerDokumente, Hook useCoDokumente() — eigener Storage-Bucket co-dokumente
106	106
107		-=== 12. Standortpartner ===
	131	+=== Standortpartner ===
108	108
109	109	Verwaltung von Projektpartnern, eigene, komplett getrennte Partnerliste pro Use-Case.
110	110
...	...	@@ -111,15 +111,15 @@
111	111	* Schwarmspeicher: StandortpartnerManager, StandortpartnerTable
112	112	* PV-Co-Location: CoLocationStandortpartnerManager, CoLocationStandortpartnerTable
113	113
114		-=== 13. Benutzerverwaltung ===
	138	+=== Benutzerverwaltung ===
115	115
116	116	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.
117	117
118		-=== 14. Audit Log ===
	142	+=== Audit Log ===
119	119
120	120	Nachvollziehbarkeit von Änderungen (AuditLogPage), tabellenübergreifend über beide Use-Cases.
121	121
122		-=== 15. Landingpage „Fläche verpachten" ===
	146	+=== Landingpage „Fläche verpachten" ===
123	123
124	124	Ö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.
125	125
...	...	@@ -134,6 +134,8 @@
134	134	* In FlaecheVerpachtenPage.tsx sind Firmenname und Telefonnummer aktuell Platzhalter (Rateware). Vor dem Livegang unbedingt durch die echten Kontaktdaten ersetzen.
135	135	)))
136	136
	161	+
	162	+
137	137	== Routing ==
138	138
139	139	|**Pfad**|**Seite**|**Use-Case**|**Login nötig**
...	...	@@ -156,6 +156,8 @@
156	156	|/pv-colocation/stockend|Stockende Standorte|PV-Co-Location|ja
157	157	|/flaeche-verpachten|Landingpage „Fläche verpachten"|—|NEIN – öffentlich
158	158
	185	+
	186	+
159	159	== Datenzugriff ==
160	160
161	161	Der Zugriff erfolgt über Custom Hooks, die sämtliche Kommunikation mit Supabase kapseln:
...	...	@@ -182,6 +182,8 @@
182	182	useUseCase()   useAuth()
183	183	)))
184	184
	213	+
	214	+
185	185	== Supabase ==
186	186
187	187	**Authentication: **Login, Passwortänderung, Rollenverwaltung.
...	...	@@ -196,10 +196,14 @@
196	196
197	197	**Storage: **zwei Buckets — dokumente (Schwarmspeicher) und co-dokumente (PV-Co-Location).
198	198
199		-== Use-Case-Umschalter ==
200	200
201		-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.
	230	+== Architektur ==
202	202
	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	+
203	203	== Offene Punkte / zu verifizieren ==
204	204
205	205	|(((
...	...	@@ -211,6 +211,8 @@
211	211	* KPI-Zuordnung im PV-Co-Location-Forecast (Netzantrag = kWp, die übrigen drei Meilensteine = kW) ist eine Annahme — bei Bedarf auf eine einheitliche Einheit umstellen.
212	212	)))
213	213
	248	+
	249	+
214	214	== Server ==
215	215
216	216	Das Projekt liegt unter /mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal und läuft in einem eigenständigen Docker-Compose-Stack (schwarmspeicher-electrify_lokal).