öffentlichkeitsarbeit/readme.md hinzugefügt

2025-01-30 15:57:17 +00:00 · 2025-01-30 15:57:17 +00:00 · 596462f800
parent 72e07221db
commit 596462f800
1 changed files with 109 additions and 0 deletions
--- a/öffentlichkeitsarbeit/readme.md
+++ b/öffentlichkeitsarbeit/readme.md
@ -0,0 +1,109 @@
+# JSON-Datenstruktur für Social-Media-Profile und Organisationen
+
+## Übersicht
+Diese JSON-Datei speichert Social-Media-Profile von Personen und Organisationen, einschließlich ihrer Verknüpfungen mit Communities oder Labels wie **relilab** und **relimentar**. Zusätzlich ermöglicht die Struktur eine mehrfache Zuordnung von Personen zu Organisationen sowie Beziehungen zwischen Organisationen.
+
+---
+
+## Datenstruktur
+
+### Personen (`persons`)
+- **`name`** *(String)* – Name der Person
+- **`profiles`** *(Array)* – Liste der Social-Media-Accounts der Person
+  - **`platform`** *(String)* – Plattform (z.B. Twitter, Instagram, LinkedIn)
+  - **`handle`** *(String)* – Benutzername/Handle auf der Plattform
+  - **`mentionSyntax`** *(String)* – Syntax für Erwähnungen (`@handle` oder ID)
+  - **`profileLink`** *(String)* – Direktlink zum Profil
+  - **`category`** *(String)* – Einstufung (z.B. VIP, Bildung, BNE)
+  - **`firstSeen`** *(String, ISO-Zeitformat)* – Zeitpunkt der Ersterfassung
+  - **`lastUpdated`** *(String, ISO-Zeitformat)* – Letzte Aktualisierung
+  - **`organizationIds`** *(Array)* – Liste der zugehörigen Organisationen anhand ihrer `orgId`
+
+### Organisationen (`organizations`)
+- **`orgId`** *(String)* – Eindeutige Abkürzung für die Organisation
+- **`orgName`** *(String)* – Vollständiger Name der Organisation
+- **`handles`** *(Array)* – Social-Media-Profile der Organisation
+  - **`platform`** *(String)* – Plattform (z.B. Twitter, LinkedIn)
+  - **`handle`** *(String)* – Benutzername/Handle der Organisation
+  - **`mentionSyntax`** *(String)* – Erwähnungs-Syntax (`@handle` oder ID)
+  - **`profileLink`** *(String)* – Direktlink zum Profil
+- **`relatedOrgs`** *(Array, optional)* – Liste verwandter Organisationen anhand ihrer `orgId`
+
+### Beispielhafte JSON-Struktur
+```json
+{
+  "persons": [
+    {
+      "name": "Jörg Lohrer",
+      "profiles": [
+        {
+          "platform": "Mastodon",
+          "handle": "joerglohrer",
+          "mentionSyntax": "@joerglohrer",
+          "profileLink": "https://reliverse.social/@joerglohrer",
+          "category": "Bildung",
+          "firstSeen": "2025-02-01T09:00:00",
+          "lastUpdated": "2025-02-10T14:00:00",
+          "organizationIds": ["comenius", "relilab"]
+        }
+      ]
+    }
+  ],
+  "organizations": [
+    {
+      "orgId": "comenius",
+      "orgName": "Comenius-Institut",
+      "relatedOrgs": ["relilab"],
+      "handles": [
+        {
+          "platform": "Mastodon",
+          "handle": "ComeniusInst",
+          "mentionSyntax": "@ComeniusInst",
+          "profileLink": "https://reliverse.social/ComeniusInst"
+        }
+      ]
+    }
+  ]
+}
+```
+
+---
+
+## Nutzung
+
+### 1. **Abruf der Social-Media-Profile einer Person**
+**Filtere nach `name` oder einem bestimmten `handle`**, um zu sehen, welche Plattformen eine Person nutzt.
+
+### 2. **Organisationen einer Person ermitteln**
+**Nutze das Feld `organizationIds`**, um alle zugehörigen Organisationen zu einer Person nachzuschlagen.
+
+### 3. **Verknüpfte Organisationen abrufen**
+Über das Feld **`relatedOrgs`** kann man nachsehen, mit welchen anderen Organisationen eine Organisation kooperiert.
+
+### 4. **Automatisierte API-Integration**
+Da die Datei in JSON-Format vorliegt, kann sie über **JavaScript (Node.js, fetch)** oder **Python (`json`-Modul)** verarbeitet werden.
+
+#### Beispiel (JavaScript):
+```js
+fetch('https://raw.githubusercontent.com/user/repository/main/social_profiles.json')
+  .then(response => response.json())
+  .then(data => console.log(data.persons));
+```
+
+#### Beispiel (Python):
+```python
+import json
+import requests
+
+data = requests.get("https://raw.githubusercontent.com/user/repository/main/social_profiles.json").json()
+print(data["persons"])
+```
+
+---
+
+## Erweiterungsmöglichkeiten
+- **Weitere Kategorien** wie „Dozenten“, „Referenten“, „Netzwerkpartner“
+- **Mehrere Rollen innerhalb einer Organisation** (z.B. „Mitarbeiter“, „Community-Manager“)
+- **Erweiterung um Aktivitätsdaten** (z.B. letzter Tweet, letzte Veranstaltung)
+
+Diese JSON-Struktur ist flexibel erweiterbar und für verschiedene Anwendungsfälle anpassbar.