# Export mit einer lokalen KI auswerten

Board-Eigentümer können die Inhalte eines Boards als JSON-Datei herunterladen. Der Export folgt dem versionierten Vertrag `thewuka-export/1` und kann während sowie nach Ablauf der Beteiligungsfrist erstellt werden. Standardmäßig enthält er nur sichtbare Beiträge; mit `include=pending` können Eigentümer zusätzlich Beiträge in Moderation aufnehmen. Abgelehnte Beiträge werden nie exportiert.

Thewuka enthält **keine integrierte KI-Anbindung** und übermittelt Exportdaten nicht an einen KI-Dienst. Wer eine KI-Auswertung wünscht, lädt die JSON-Datei bewusst in ein selbst gewähltes, vorzugsweise lokal betriebenes Werkzeug.

## Vollständiges Minimalbeispiel

```json
{
  "schema": "thewuka-export/1",
  "generated_at": "2025-03-01T12:00:00Z",
  "disclaimer": "Freitexte können personenbezogene Angaben enthalten; vertraulich behandeln.",
  "board": {
    "id": "b-3f8a1c2e",
    "title": "Unser Quartier",
    "description": "Ideen für ein gutes Zusammenleben",
    "deadline": "2025-03-31T18:00:00Z",
    "feedback_promise_date": "2025-04-15",
    "is_open": true,
    "tags": [
      "Mobilität"
    ]
  },
  "types": {
    "post_types": [
      "perception",
      "assumption",
      "wish",
      "question",
      "idea"
    ],
    "relation_labels": {
      "related": {
        "forward": "Gehört zusammen mit",
        "inverse": "Gehört zusammen mit",
        "symmetric": true
      },
      "complements": {
        "forward": "Ergänzt",
        "inverse": "Wird ergänzt von",
        "symmetric": false
      },
      "contradicts": {
        "forward": "Widerspricht",
        "inverse": "Wird widersprochen von",
        "symmetric": false
      },
      "solves": {
        "forward": "Ist eine Lösung für",
        "inverse": "Wird gelöst durch",
        "symmetric": false
      },
      "builds_on": {
        "forward": "Baut auf",
        "inverse": "Ist Grundlage für",
        "symmetric": false
      }
    }
  },
  "posts": [
    {
      "id": "p-91ab04d2",
      "type": "wish",
      "label": "Sicherer Schulweg",
      "text": "Wir wünschen uns einen geschützten Radweg zur Schule.",
      "tags": [
        "Mobilität"
      ],
      "status": "visible",
      "support_count": 12,
      "feedback": {
        "status": "reviewing",
        "text": "Die Verkehrsplanung prüft mögliche Strecken."
      },
      "comments": [
        {
          "id": "c-77e0aa11",
          "parent_id": null,
          "text": "Besonders wichtig ist die Kreuzung am Park.",
          "created_at": "2025-02-20T10:15:00Z"
        }
      ],
      "relations": {
        "outgoing": [],
        "incoming": [
          {
            "type": "solves",
            "post": "p-aaaa0001",
            "count": 2
          }
        ]
      }
    },
    {
      "id": "p-aaaa0001",
      "type": "idea",
      "label": "Temporäre Fahrradspur",
      "text": "Eine geschützte Fahrradspur könnte zunächst testweise eingerichtet werden.",
      "tags": [
        "Mobilität"
      ],
      "status": "visible",
      "support_count": 8,
      "feedback": {
        "status": null,
        "text": null
      },
      "comments": [],
      "relations": {
        "outgoing": [
          {
            "type": "solves",
            "post": "p-91ab04d2",
            "count": 2
          }
        ],
        "incoming": []
      }
    }
  ]
}
```

`count: 2` bedeutet, dass zwei Personen dieselbe Beziehung zwischen denselben Beiträgen und mit demselben Typ angelegt haben. Kurz-IDs bleiben über wiederholte Exporte stabil und können deshalb in einer Auswertung als Referenzen verwendet werden.

## Beispielprompt für ein lokal laufendes Modell

Die exportierte Datei kann beispielsweise einem lokal betriebenen Modell (etwa über Ollama) zusammen mit folgendem Prompt übergeben werden:

> Analysiere den beigefügten JSON-Export `thewuka-export/1`. Fasse die Anliegen nach Beitragstyp und Tag zusammen. Nenne besonders stark unterstützte Beiträge, offene Fragen und Lösungsideen ohne Feedback. Berücksichtige die gerichteten Beziehungen und deren `count`, ohne Beiträge doppelt zu zählen. Trenne Beobachtungen aus den Daten klar von deinen Interpretationen. Zitiere zur Nachvollziehbarkeit ausschließlich die Kurz-IDs der Beiträge. Gib keine personenbezogenen Vermutungen ab.

Das Ergebnis einer KI sollte immer fachlich geprüft werden. Automatisch erzeugte Zusammenfassungen können Inhalte auslassen, falsch gewichten oder Beziehungen missverstehen.

## Datenschutz und Freitexte

Der strukturierte Export enthält keine E-Mail-Adressen, Benutzer-, Autor- oder Ersteller-IDs, Pseudonyme, Tracking-Hashes oder Angaben dazu, wer einen Beitrag unterstützt hat. Beiträge und Kommentare sind jedoch Freitexte. Teilnehmende können darin selbst Namen, Orte oder andere personenbezogene und vertrauliche Angaben genannt haben. Deshalb gilt:

- Exportdateien vertraulich behandeln und nur an berechtigte Personen weitergeben.
- Vor der Nutzung externer Dienste Freitexte prüfen und gegebenenfalls anonymisieren.
- Wenn möglich ein lokales Modell verwenden, das keine Inhalte an Dritte sendet.
- Speicherfristen und Löschkonzepte der eigenen Organisation beachten.

Bei einer zukünftigen Änderung des Datenvertrags wird die Schema-Kennung versioniert. Auswertungswerkzeuge sollten deshalb vor der Verarbeitung prüfen, ob sie `thewuka-export/1` unterstützen.