*Notizen im FFG geförderten Projekt #905128: USEFLEDS – dieses Dokument ist öffentlich!*
# Datensammlung D3.1
*Motivation:* Basierend auf einem Vorschlag beim USEFLEDS Co-Creation Event am 22.Mai 2025 soll für jede Solution ein representativer Datensatz erstellt werden. Diese Daten können zB bei einem Hackathon verwendet werden, und sollen auch als Katalysator für die weitere Use-Case Entwicklung dienen.
<details><summary>Anmerkungen & Einschränkungen</summary>
* die bereitgestellten Daten sind öffentlich; jeder der Daten bereitstellt ist verantwortlich, dass die Daten entweder anonymisiert sind, oder vorher die schriftliche Zustimmung für die Weitergabe eingeholt wird
(zum Anonymisieren der Daten kann zB folgendes Service verwendet werden: https://anonymiser.ownyourdata.eu/)
* die Daten können entweder selbst gehostet werden, oder falls gewünscht kann OwnYourData die Infrastruktur dafür bereitstellen
* es ist geplant die Daten bis zum Projektende (Oktober 2027) bereitzustellen und danach offline zu nehmen
* Ausgangspunkt für die Identifikation relevanter Daten ist das Sequenzdiagramm zur "Datenebene" in der Use-Case Dokumentation -> jeder Pfeil zwischen zwei technischen Komponenten hat üblicherweise Daten die hier angegeben werden können
* die Teilnahme ist freiwillig und die Ergebnisse werden im *Deliverable 3.1 Data Flow Specification* dokumentiert
* diese Dokument ist öffentlich und kann von jedem gelesen werden, für Schreibzugriff bitte Email an christoph at ownyourdata punkt eu
</details>
## Use-Case "EEG Forecasting"
### Sequenzdiagramm Datenebene
```plantuml
@startuml
autonumber
database "Energiegemeinschaft" as provider_store
database "Datenintermediär" as di_store
queue "Forecasting\nService" as service
database "Datenempfänger" as consumer_store
== Setup ==
provider_store -> di_store : Datenquelle registrieren
service -> di_store: Service registrieren
provider_store -> di_store: Datenzugriff auf Ergebnisse\nregistrieren
consumer_store -> di_store: Datenzugriff auf Rohdaten und Ergebnisse\nregistrieren
== Datenbereitstellung==
provider_store -> di_store : igecos Daten bereitstellen
== Servicenutzung==
provider_store -> di_store: Servicenutzung beauftragen
di_store -> service : Service Request
di_store <- service : Service Response
== Datenzugriff==
di_store <- consumer_store : Rohdaten abfragen
di_store <- provider_store : Ergebnisse abfragen
di_store <- consumer_store : Ergebnisse abfragen
@enduml
```
```plantuml
@startuml
autonumber
database "Energy Community" as provider_store
database "Data Intermediary" as di_store
queue "Forecasting\nService" as service
database "Data Consumer" as consumer_store
== Setup ==
provider_store -> di_store : Register data source
service -> di_store: Register service
provider_store -> di_store: Register data access to results
consumer_store -> di_store: Register data access to raw data and results
== Data Provision ==
provider_store -> di_store : Provide igecos data
== Service Usage ==
provider_store -> di_store: Request service usage
di_store -> service : Service Request
di_store <- service : Service Response
== Data Access ==
di_store <- consumer_store : Request raw data
di_store <- provider_store : Request results
di_store <- consumer_store : Request results
@enduml
```
### Details der einzelnen Schritte
<details><summary><strong>1) Datenquelle registrieren</strong></summary>
*Beschreibung:* Die Registrierung der Energiegemeinschaft erfolgt durch die Anmeldung am Datenintermediär und dem Ausfüllen eines "Data Sharing Agreements".
*Datenmodell:*
* Data Sharing Agreement: [`D2AeegRaw`](https://soya.ownyourdata.eu/D2AeegRaw/yaml) ([Formular](https://soya-form.ownyourdata.eu/?schemaDri=D2AeegRaw))
*Datensätze:*
* Beispiel (anonymisiert): [JSON](https://playground2.data-container.net/api/data?id=141&f=plain), [Formular](https://playground2.data-container.net/?itemId=141)
* Anzahl: 1
</details>
<details><summary><strong>2) Service registrieren</strong></summary>
*Beschreibung:* Die Registrierung eines Serviceanbieters erfolgt durch die Anmeldung am Datenintermediär und dem Ausfüllen eines "Service Provision Agreements".
*Datenmodell:*
* Data Provision Agreement: [`SPAeegForecast`](https://soya.ownyourdata.eu/SPAeegForecast/yaml) ([Formular](https://soya-form.ownyourdata.eu/?schemaDri=SPAeegForecast))
*Datensätze:*
* Beispiel (anonymisiert): [JSON](https://playground2.data-container.net/api/data?id=142&f=plain), [Formular](https://playground2.data-container.net/?itemId=142)
* Anzahl: 1
</details>
<details><summary><strong>3&4) Datenzugriff registrieren</strong></summary>
*Beschreibung:* Für den Datenzugriff (auf Rohdaten oder Ergebnisdaten) muss am Datenintermediär von einem registrierten Bentuzer ein "Data Disclosure Agreement" ausgefüllt werden.
*Datenmodell:*
* Data Disclosure Agreement: [`D3AeegRaw`](https://soya.ownyourdata.eu/D3AeegRaw/yaml) ([Formular](https://soya-form.ownyourdata.eu/?schemaDri=D3AeegRaw)) und [`D3AeegForecast`](https://soya.ownyourdata.eu/D3AeegForecast/yaml)
*Datensätze:*
* Beispiel für `D3AeegRaw` (anonymisiert): [JSON](https://playground2.data-container.net/api/data?id=143&f=plain), [Formular](https://playground2.data-container.net/?itemId=143)
* Anzahl: 1
</details>
<details><summary><strong>5) igecos Daten bereitstellen & 9) Rohdaten abfragen</strong></summary>
*Beschreibung:* Die Daten werden von igecos Devices in Form von aggregierten Viertelstundendaten bereitgestellt. Dieses Datenformat entspricht auch dem Rohdatenformat, welches weitergeben werden kann.
*Datensätze:*
* Beispiel: [JSON](https://playground2.data-container.net/api/data?id=144&f=plain)
* Anzahl: 1.000
</details>