Changes for page Schwarmspeicher Electrify

Summary

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

Details

Page properties

Author

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

Tags

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

Content

...	...	@@ -1,93 +1,150 @@
1		-{{box cssClass="floatinginfobox" title="**Auf dieser Seite**"}}
2		-{{toc/}}
3		-{{/box}}
	1	+macro:box
4	4
	3	+**Auf dieser Seite**
	4	+
	5	+macro:toc
	6	+
	7	+* (((
	8	+[[🔋 Schwarmspeicher Electrify>>path:#HD83DDD0BSchwarmspeicherElectrify]]
	9	+
	10	+* [[Übersicht>>path:#HDCbersicht]]
	11	+* [[Technologie-Stack>>path:#HTechnologie-Stack]]
	12	+* [[Projektstruktur>>path:#HProjektstruktur]]
	13	+* (((
	14	+[[Hauptfunktionen>>path:#HHauptfunktionen]]
	15	+
	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	+)))
	39	+
	40	+
	41	+
5	5	= 🔋 Schwarmspeicher Electrify =
6	6
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}}
	44	+macro:info
10	10
	46	+Information
	47	+
	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**.
	49	+
	50	+Click and drag to move
	51	+
11	11	== Übersicht ==
12	12
13		-**Schwarmspeicher Electrify** unterstützt den gesamten Projektlebenszyklus: Standortidentifikation, Genehmigungen, Projektsteuerung und Dokumentation.
	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.
14	14
15	15	== Technologie-Stack ==
16	16
17		-**Frontend:** React 18 · TypeScript · Vite · Tailwind CSS · shadcn/ui · React Router · React Query · React Hook Form · Leaflet (Kartendarstellung) · Recharts (Diagramme)
	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
18	18
19	19	**Backend:** Supabase — PostgreSQL, Authentication, Storage, Edge Functions, Row Level Security (RLS)
20	20
	62	+**Tests:** Vitest 3.2.4 · Playwright 1.57.0
	63	+
21	21	== Projektstruktur ==
22	22
23		-{{code}}
	66	+macro:code
	67	+
24	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
	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
31	31
32	32	supabase/
33		- ├── migrations/
34		- ├── functions/
35		- └── config.toml
36		-{{/code}}
	77	+├── migrations/
	78	+├── functions/
	79	+└── config.toml
37	37
	81	+Click and drag to move
	82	+
38	38	== Hauptfunktionen ==
39	39
40	40	=== Dashboard ===
41	41
42		-Zentrale Übersicht über Projekte, Status, offene Aufgaben, Kennzahlen und Projektfortschritt (Komponente ##Dashboard.tsx##).
	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.
43	43
44	44	=== Projektverwaltung ===
45	45
46		-Verwaltung aller Batteriespeicherprojekte: anzeigen, Detailansicht, bearbeiten, Projektstatus, Meilensteine. Komponenten: ProjectTable, ProjectDetail.
	91	+Verwaltung aller Batteriespeicherprojekte: anzeigen, Detailansicht, bearbeiten, Projektstatus und Meilensteine. Komponenten: ProjectTable, ProjectDetail. PV Co-Location besitzt eine eigene Projektansicht mit CoLocationProjectTable und CoLocationStandortDetail.
47	47
48	48	=== Standortverwaltung ===
49	49
50		-Standorte anlegen, bearbeiten, importieren, Historie, Dokumente. Komponenten: StandortDetail, CreateStandortForm, StandortImportDialog, StandortDokumente.
	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.
51	51
52	52	=== Gemeinden ===
53	53
54		-Verwaltung der Gemeinden (Komponente CreateGemeindeForm). Zusätzlich existiert eine Supabase Edge Function zum Abruf von NÖ-Gemeinden (##supabase/functions/fetch-noe-gemeinden##).
	99	+Verwaltung der Gemeinden (Komponente CreateGemeindeForm). Zusätzlich existiert eine Supabase Edge Function zum Abruf von NÖ-Gemeinden (supabase/functions/fetch-noe-gemeinden).
55	55
56	56	=== Kartenansicht ===
57	57
58		-Darstellung aller Standorte auf einer interaktiven Karte (Leaflet, React Leaflet). Komponenten: ProjectMap, LocationPickerMap.
	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.
59	59
60	60	=== Potenzialanalyse ===
61	61
62		-Bewertung möglicher Standorte. Komponenten: PotenzialTabelle, PotenzialPage.
	107	+Bewertung möglicher Standorte. Komponenten: PotenzialTabelle, PotenzialPage. Die Potenzialanalyse ist aktuell dem Schwarmspeicher-Use-Case zugeordnet.
63	63
64	64	=== Pipeline ===
65	65
66		-Verwaltung von Vorprojekten. Komponenten: VorprojektePipeline, 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.
67	67
68	68	=== Meilensteinverwaltung ===
69	69
70		-Projektfortschritt über Meilensteine. Komponenten: MeilensteinMatrix, MeilensteinQuickEdit.
	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.
71	71
72	72	=== Aufgabenverwaltung ===
73	73
74		-Projektbezogene Aufgaben. Komponenten: TaskManager, TasksPage. Hook: ##useTasks()##.
	119	+Projektbezogene Aufgaben. Komponenten: TaskManager, TasksPage. Hook: useTasks(). PV Co-Location verwendet mit CoTaskManager, CoLocationTasksPage und useCoTasks() eine eigene, vom Schwarmspeicher getrennte Aufgabenliste.
75	75
76	76	=== Dokumentenverwaltung ===
77	77
78		-Zu jedem Standort können Dokumente verwaltet werden. Komponenten: StandortDokumente, PartnerDokumente.
	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.
79	79
80	80	=== Standortpartner ===
81	81
82		-Verwaltung von Projektpartnern. Komponenten: StandortpartnerManager, StandortpartnerTable.
	127	+Verwaltung von Projektpartnern. Komponenten: StandortpartnerManager, StandortpartnerTable. Für PV Co-Location existieren separate Komponenten und Datenzugriffe für Standortpartner.
83	83
	129	+=== Stockende Projekte ===
	130	+
	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.
	132	+
	133	+=== Forecast ===
	134	+
	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.
	136	+
	137	+=== PV Co-Location ===
	138	+
	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.
	140	+
84	84	=== Benutzerverwaltung ===
85	85
86		-Anmeldung, Passwortänderung, Rollen. Komponenten: AuthProvider, ProtectedRoute, BenutzerPage, ChangePasswordDialog. Backend: Supabase Authentication.
	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().
87	87
88	88	=== Audit Log ===
89	89
90		-Nachvollziehbarkeit von Änderungen (Seite AuditLogPage).
	147	+Nachvollziehbarkeit von Änderungen über AuditLogPage und audit_log. Der Zugriff auf das Änderungsprotokoll ist über die vorhandenen Datenbankregeln auf Administratoren eingeschränkt.
91	91
92	92	== Routing ==
93	93
...	...	@@ -97,6 +97,7 @@
97	97	|Pipeline|Vorprojekte
98	98	|Potenziale|Standortpotenziale
99	99	|Karte|Kartenansicht
	157	+|Stockend|Stockende Projekte / Standorte
100	100	|Forecast|Forecast
101	101	|Aufgaben|Aufgabenverwaltung
102	102	|Audit Log|Änderungsprotokoll
...	...	@@ -103,11 +103,17 @@
103	103	|Benutzer|Benutzerverwaltung
104	104	|Login|Anmeldung
105	105
	164	+**Schwarmspeicher-Routen:** / · /projekte · /pipeline · /potenzial · /karte · /stockend · /forecast · /tasks · /benutzer · /historie
	165	+
	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
	167	+
106	106	== Datenzugriff ==
107	107
108		-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.
109	109
110		-{{code}}
	172	+macro:code
	173	+
	174	+Schwarmspeicher:
111	111	useStandorte()
112	112	useGemeinden()
113	113	useVorprojekte()
...	...	@@ -115,34 +115,66 @@
115	115	usePotenzialDaten()
116	116	useStandortpartner()
117	117	useMonatsziele()
118		-{{/code}}
	182	+useDokumente()
119	119
	184	+PV Co-Location:
	185	+useCoLocationStandorte()
	186	+useCoLocationStandortpartner()
	187	+useCoVorprojekte()
	188	+useCoTasks()
	189	+useCoMonatsziele()
	190	+useCoDokumente()
	191	+
	192	+Click and drag to move
	193	+
120	120	== Supabase ==
121	121
122		-**Authentication:** Login, Passwortänderung, Rollenverwaltung.
	196	+**Authentication:** Login, Passwortänderung, Rollenverwaltung und geschützte Routen.
123	123
124		-**Datenbank:** Wird über SQL-Migrationen verwaltet (##supabase/migrations/##). Die Migrationen definieren Tabellen, Policies und Datenbankfunktionen.
	198	+**Datenbank:** Wird über SQL-Migrationen verwaltet (supabase/migrations/). Die Migrationen definieren Tabellen, Policies und Datenbankfunktionen.
125	125
	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.
	201	+
	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.
	203	+
126	126	**Edge Functions:**
127	127
128		-* ##fetch-noe-gemeinden## — lädt Gemeinden aus Niederösterreich
129		-* ##manage-users## — Benutzerverwaltung
	206	+* fetch-noe-gemeinden — lädt Gemeinden aus Niederösterreich
	207	+* manage-users — Benutzerverwaltung
130	130
	209	+macro:info
	210	+
	211	+Information
	212	+
	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.
	214	+
	215	+Click and drag to move
	216	+
131	131	== Architektur ==
132	132
133		-{{mermaid}}
134		-flowchart TD
135		- FE["React Frontend"] --> RQ["React Query"]
	219	+macro:mermaid
	220	+
	221	+macro:velocity
	222	+
	223	+macro:html
	224	+
	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
136	136	RQ --> SC["Supabase Client"]
137	137	SC --> AUTH["Auth"]
138		- SC --> DBS["Database"]
	233	+ SC --> DBS["Database / RLS"]
139	139	SC --> ST["Storage"]
140	140	DBS --> EF["Edge Functions"]
141		-{{/mermaid}}
	236	+ DBS --> AL["Audit Log / Trigger"]}}}
142	142
	238	+Click and drag to move
	239	+
143	143	== Server ==
144	144
145		-Das Projekt liegt unter ##/mnt/data/schwarmspeicher/schwarmspeicher-electrify_lokal## und läuft in einem Docker-Compose-Stack (##schwarmspeicher-electrify_lokal##).
	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.
146	146
147		-Erreichbar unter [[http://schwarmspeicher.spl-tele.com:8200>>http://schwarmspeicher.spl-tele.com:8200/]] — mit VPN und im SPL-TELE-Netzwerk.
148		-
	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.

noavatar.png

Author

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

Size

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

Content