Changes for page Schwarmspeicher Electrify

Summary

• Page properties (3 modified, 0 added, 0 removed)
• Attachments (0 modified, 0 added, 1 removed)
  • noavatar.png

Details

Page properties

Author

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

Tags

...	...	@@ -1,1 +1,0 @@
1		-referenz|architektur

Content

...	...	@@ -1,166 +1,102 @@
1		-= 🔋  Schwarmspeicher Electrify =
	1	+{{box cssClass="floatinginfobox" title="**Auf dieser Seite**"}}
	2	+{{toc/}}
	3	+{{/box}}
2	2
3		-|**ⓘ   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.|(((
4		-**Auf dieser Seite**
	5	+= 🔋 Schwarmspeicher Electrify =
5	5
6		-• 🔋 Schwarmspeicher Electrify
	7	+{{info}}
	8	+**Zweck:** Webbasiertes Projektmanagementsystem zur Verwaltung von Batterie-Großspeicherprojekten in Deutschland und Österreich — vom Standort über Genehmigungen bis zur Projektsteuerung und Dokumentation.
	9	+{{/info}}
7	7
8		-• Übersicht
9		-
10		-• Technologie-Stack
11		-
12		-• Projektstruktur
13		-
14		-• Hauptfunktionen
15		-
16		-▪ Dashboard
17		-
18		-▪ Projektverwaltung
19		-
20		-▪ Standortverwaltung
21		-
22		-▪ Gemeinden
23		-
24		-▪ Kartenansicht
25		-
26		-▪ Potenzialanalyse
27		-
28		-▪ Pipeline
29		-
30		-▪ Meilensteinverwaltung
31		-
32		-▪ Aufgabenverwaltung
33		-
34		-▪ Dokumentenverwaltung
35		-
36		-▪ Standortpartner
37		-
38		-▪ Stockende Projekte
39		-
40		-▪ Forecast
41		-
42		-▪ PV Co-Location
43		-
44		-▪ Benutzerverwaltung
45		-
46		-▪ Audit Log
47		-
48		-• Routing
49		-
50		-• Datenzugriff
51		-
52		-• Supabase
53		-
54		-• Architektur
55		-
56		-• Server
57		-)))
58		-
59		-
60		-
61	61	== Übersicht ==
62	62
63		-**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.
	13	+**Schwarmspeicher Electrify** unterstützt den gesamten Projektlebenszyklus: Standortidentifikation, Genehmigungen, Projektsteuerung und Dokumentation.
64	64
65	65	== Technologie-Stack ==
66	66
67		-**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
	17	+**Frontend:** React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · React Hook Form · Leaflet (Kartendarstellung) · Recharts (Diagramme)
68	68
69		-**Backend: **Supabase — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
	19	+**Backend:** Supabase — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
70	70
71		-**Tests: **Vitest 3.2.4 · Playwright 1.57.0
72		-
73	73	== Projektstruktur ==
74	74
75		-|src/
76		-├── components/          UI-Komponenten und Fachkomponenten
77		-├── pages/               Seiten der Anwendung
78		-├── hooks/               Datenzugriffe und Business-Logik
79		-├── integrations/        Supabase Client und generierte Typen
80		-├── types/               TypeScript-Modelle, inkl. PV Co-Location
81		-└── lib/                 Hilfsfunktionen
82		-\\supabase/
83		-├── migrations/
84		-├── functions/
85		-└── config.toml
	23	+{{code}}
	24	+src/
	25	+ ├── components/ UI-Komponenten
	26	+ ├── pages/ Seiten der Anwendung
	27	+ ├── hooks/ Datenzugriffe und Business-Logik
	28	+ ├── integrations/ Supabase Client
	29	+ ├── types/ TypeScript-Modelle
	30	+ └── lib/ Hilfsfunktionen
86	86
	32	+supabase/
	33	+ ├── migrations/
	34	+ ├── functions/
	35	+ └── config.toml
	36	+{{/code}}
87	87
88		-
89	89	== Hauptfunktionen ==
90	90
91	91	=== Dashboard ===
92	92
93		-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.
	42	+Zentrale Übersicht über Projekte, Status, offene Aufgaben, Kennzahlen und Projektfortschritt (Komponente ##Dashboard.tsx##).
94	94
95	95	=== Projektverwaltung ===
96	96
97		-Verwaltung aller Batteriespeicherprojekte: anzeigen, Detailansicht, bearbeiten, Projektstatus und Meilensteine. Komponenten: ProjectTable, ProjectDetail. PV Co-Location besitzt eine eigene Projektansicht mit CoLocationProjectTable und CoLocationStandortDetail.
	46	+Verwaltung aller Batteriespeicherprojekte: anzeigen, Detailansicht, bearbeiten, Projektstatus, Meilensteine. Komponenten: ProjectTable, ProjectDetail.
98	98
99		-Standortverwaltung
	48	+=== Standortverwaltung ===
100	100
101		-Standorte anlegen, bearbeiten, importieren, Historie und Dokumente. Komponenten: StandortDetail, CreateStandortForm, StandortImportDialog, StandortDokumente. PV Co-Location ergänzt eigene Formulare, Import, Bulk-Edit und Detailansichten.
	50	+Standorte anlegen, bearbeiten, importieren, Historie, Dokumente. Komponenten: StandortDetail, CreateStandortForm, StandortImportDialog, StandortDokumente.
102	102
103		-Gemeinden
	52	+=== Gemeinden ===
104	104
105		-Verwaltung der Gemeinden (Komponente CreateGemeindeForm). Zusätzlich existiert eine Supabase Edge Function zum Abruf von NÖ-Gemeinden (supabase/functions/fetch-noe-gemeinden).
	54	+Verwaltung der Gemeinden (Komponente CreateGemeindeForm). Zusätzlich existiert eine Supabase Edge Function zum Abruf von NÖ-Gemeinden (##supabase/functions/fetch-noe-gemeinden##).
106	106
107		-Kartenansicht
	56	+=== Kartenansicht ===
108	108
109		-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.
	58	+Darstellung aller Standorte auf einer interaktiven Karte (Leaflet, React Leaflet). Komponenten: ProjectMap, LocationPickerMap.
110	110
111		-Potenzialanalyse
	60	+=== Potenzialanalyse ===
112	112
113		-Bewertung möglicher Standorte. Komponenten: PotenzialTabelle, PotenzialPage. Die Potenzialanalyse ist aktuell dem Schwarmspeicher-Use-Case zugeordnet.
	62	+Bewertung möglicher Standorte. Komponenten: PotenzialTabelle, PotenzialPage.
114	114
115		-Pipeline
	64	+=== Pipeline ===
116	116
117		-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.
	66	+Verwaltung von Vorprojekten. Komponenten: VorprojektePipeline, VorprojektTimeline.
118	118
119		-Meilensteinverwaltung
	68	+=== Meilensteinverwaltung ===
120	120
121		-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.
	70	+Projektfortschritt über Meilensteine. Komponenten: MeilensteinMatrix, MeilensteinQuickEdit.
122	122
123		-Aufgabenverwaltung
	72	+=== Aufgabenverwaltung ===
124	124
125		-Projektbezogene Aufgaben. Komponenten: TaskManager, TasksPage. Hook: useTasks(). PV Co-Location verwendet mit CoTaskManager, CoLocationTasksPage und useCoTasks() eine eigene, vom Schwarmspeicher getrennte Aufgabenliste.
	74	+Projektbezogene Aufgaben. Komponenten: TaskManager, TasksPage. Hook: ##useTasks()##.
126	126
127		-Dokumentenverwaltung
	76	+=== Dokumentenverwaltung ===
128	128
129		-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.
	78	+Zu jedem Standort können Dokumente verwaltet werden. Komponenten: StandortDokumente, PartnerDokumente.
130	130
131		-Standortpartner
	80	+=== Standortpartner ===
132	132
133		-Verwaltung von Projektpartnern. Komponenten: StandortpartnerManager, StandortpartnerTable. Für PV Co-Location existieren separate Komponenten und Datenzugriffe für Standortpartner.
	82	+Verwaltung von Projektpartnern. Komponenten: StandortpartnerManager, StandortpartnerTable.
134	134
135		-Stockende Projekte
	84	+=== Benutzerverwaltung ===
136	136
137		-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.
	86	+Anmeldung, Passwortänderung, Rollen. Komponenten: AuthProvider, ProtectedRoute, BenutzerPage, ChangePasswordDialog. Backend: Supabase Authentication.
138	138
139		-Forecast
	88	+=== Audit Log ===
140	140
141		-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.
	90	+Nachvollziehbarkeit von Änderungen (Seite AuditLogPage).
142	142
143		-PV Co-Location
	92	+== Routing ==
144	144
145		-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.
146		-
147		-Benutzerverwaltung
148		-
149		-Anmeldung, Passwortänderung und Rollen. Komponenten: AuthProvider, ProtectedRoute, BenutzerPage, ChangePasswordDialog. Backend: Supabase Authentication. Die Anwendung unterstützt zudem eine verpflichtende Passwortänderung über useMustChangePassword().
150		-
151		-Audit Log
152		-
153		-Nachvollziehbarkeit von Änderungen über AuditLogPage und audit_log. Der Zugriff auf das Änderungsprotokoll ist über die vorhandenen Datenbankregeln auf Administratoren eingeschränkt.
154		-
155		-Routing
156		-
157		-|**Seite**|**Beschreibung**
	94	+|=Seite|=Beschreibung
158	158	|Dashboard|Startseite
159	159	|Projekte|Projektübersicht
160	160	|Pipeline|Vorprojekte
161	161	|Potenziale|Standortpotenziale
162	162	|Karte|Kartenansicht
163		-|Stockend|Stockende Projekte / Standorte
164	164	|Forecast|Forecast
165	165	|Aufgaben|Aufgabenverwaltung
166	166	|Audit Log|Änderungsprotokoll
...	...	@@ -167,17 +167,11 @@
167	167	|Benutzer|Benutzerverwaltung
168	168	|Login|Anmeldung
169	169
	106	+== Datenzugriff ==
170	170
	108	+Der Zugriff erfolgt über Custom Hooks, die sämtliche Kommunikation mit Supabase kapseln:
171	171
172		-**Schwarmspeicher-Routen: **/ · /projekte · /pipeline · /potenzial · /karte · /stockend · /forecast · /tasks · /benutzer · /historie
173		-
174		-**PV-Co-Location-Routen: **/pv-colocation · /pv-colocation/projekte · /pv-colocation/pipeline · /pv-colocation/karte · /pv-colocation/stockend · /pv-colocation/forecast · /pv-colocation/tasks
175		-
176		-Datenzugriff
177		-
178		-Der Zugriff erfolgt über Custom Hooks, die die Kommunikation mit Supabase kapseln. React Query übernimmt Laden, Mutationen und Cache-Invalidierung.
179		-
180		-|Schwarmspeicher:
	110	+{{code}}
181	181	useStandorte()
182	182	useGemeinden()
183	183	useVorprojekte()
...	...	@@ -185,54 +185,34 @@
185	185	usePotenzialDaten()
186	186	useStandortpartner()
187	187	useMonatsziele()
188		-useDokumente()
189		-\\PV Co-Location:
190		-useCoLocationStandorte()
191		-useCoLocationStandortpartner()
192		-useCoVorprojekte()
193		-useCoTasks()
194		-useCoMonatsziele()
195		-useCoDokumente()
	118	+{{/code}}
196	196
	120	+== Supabase ==
197	197
	122	+**Authentication:** Login, Passwortänderung, Rollenverwaltung.
198	198
199		-Supabase
	124	+**Datenbank:** Wird über SQL-Migrationen verwaltet (##supabase/migrations/##). Die Migrationen definieren Tabellen, Policies und Datenbankfunktionen.
200	200
201		-**Authentication: **Login, Passwortänderung, Rollenverwaltung und geschützte Routen.
202		-
203		-**Datenbank: **Wird über SQL-Migrationen verwaltet (supabase/migrations/). Die Migrationen definieren Tabellen, Policies und Datenbankfunktionen.
204		-
205		-**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		-
207		-**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		-
209	209	**Edge Functions:**
210	210
211		-• fetch-noe-gemeinden — lädt Gemeinden aus Niederösterreich
	128	+* ##fetch-noe-gemeinden## — lädt Gemeinden aus Niederösterreich
	129	+* ##manage-users## — Benutzerverwaltung
212	212
213		-• manage-users — Benutzerverwaltung
	131	+== Architektur ==
214	214
215		-|**ⓘ  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.
	133	+{{mermaid}}
	134	+flowchart TD
	135	+ FE["React Frontend"] --> RQ["React Query"]
	136	+ RQ --> SC["Supabase Client"]
	137	+ SC --> AUTH["Auth"]
	138	+ SC --> DBS["Database"]
	139	+ SC --> ST["Storage"]
	140	+ DBS --> EF["Edge Functions"]
	141	+{{/mermaid}}
216	216
217		-Architektur
	143	+== Server ==
218	218
219		-|flowchart TD
220		- FE["React Frontend"] ~-~-> UC["UseCaseProvider / Router"]
221		- UC ~-~-> SS["Schwarmspeicher Pages"]
222		- UC ~-~-> CO["PV Co-Location Pages"]
223		- SS ~-~-> RQ["React Query"]
224		- CO ~-~-> RQ
225		- RQ ~-~-> SC["Supabase Client"]
226		- SC ~-~-> AUTH["Auth"]
227		- SC ~-~-> DBS["Database / RLS"]
228		- SC ~-~-> ST["Storage"]
229		- DBS ~-~-> EF["Edge Functions"]
230		- DBS ~-~-> AL["Audit Log / Trigger"]
	145	+Das Projekt liegt unter ##/mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal## und läuft in einem Docker-Compose-Stack (##schwarmspeicher-electrify_lokal##).
231	231
	147	+Erreichbar unter [[http://schwarmspeicher.spl-tele.com:8200>>http://schwarmspeicher.spl-tele.com:8200/]] — mit VPN und im SPL-TELE-Netzwerk.
232	232
233		-
234		-Server
235		-
236		-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.
237		-
238		-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 im VPN und SPL-TELE-Netzwerk. Diese konkrete produktive Serverkonfiguration ist im bereitgestellten Quellpaket nicht enthalten und konnte daraus nicht erneut verifiziert werden.

noavatar.png

Author

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

Size

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

Content