Hilfe zum Manifest-Forum (Offline)

1. Grundprinzip: Alles zuerst lokal, nichts heimlich online

Das Manifest-Forum speichert deine Inhalte ausschließlich lokal im Browser:

• Daten liegen unter dem Schlüssel mot_forum_v1 in localStorage.
• Es gibt keinen automatischen Upload.
• Du entscheidest selbst, wann du exportierst oder an eine API sendest.

Wenn du die Datei auf einem USB-Stick oder in der Cloud speicherst und auf einem anderen Rechner öffnest, startet sie dort mit einer leeren lokalen Datenbank – die Offline-Daten werden nicht automatisch mitgenommen.

2. Beiträge erstellen & Reaktionen

Im linken Hauptbereich findest du den Block „Beitrag erstellen“ mit folgenden Feldern:

• Titel: Überschrift deines Beitrags.
• Inhalt: Freitext, mehrere Absätze möglich.
• Tags: Stichworte, kommagetrennt (z. B. chaos, ordnung, universum).
• Initialen: Kürzel (z. B. RDT), wird in der Liste angezeigt.
• Identity/Logo-URL: Optionaler Verweis auf ein Logo oder eine Data-URL.

Mit „Beitrag speichern“ wird der Beitrag in der lokalen Datenbank hinzugefügt. Rechts im Seitenbereich kannst du:

• Reaktionen auswählen (z. B. „Gefeliciteerd“, „Verheldernd“).
• Kommentare hinzufügen und löschen.

3. Export & Import – JSON und HTML

Im rechten Bereich gibt es drei wichtige Funktionsgruppen:

• „Daten“:
  • Export JSON – speichert die komplette lokale Datenbank als Datei manifest-forum.json.
  • Import JSON – lädt eine zuvor exportierte JSON-Datei wieder in die App.
• „Statische Webseite erzeugen“:
  • Download HTML – erzeugt eine schreibgeschützte HTML-Seite manifest-site.html mit allen Einträgen, ideal für eine Veröffentlichung im Web.
• „Veröffentlichen (API)“:
  • API-Endpoint (POST) – hier trägst du deine eigene Server-URL ein.
  • API-Schlüssel (optional) – z. B. ein Bearer-Token für Authentifizierung.
  • Beiträge senden – überträgt die Daten an den angegebenen Endpoint.
  • Payload anzeigen – zeigt dir die JSON-Nutzlast, bevor sie übertragen wird.

4. API-Quellen: Woher bekomme ich eine API und einen Schlüssel?

Das Manifest-Forum braucht deine API – es liefert keine fertige öffentliche API mit. Du hast im Prinzip zwei Wege:

• Eigener Manifest-Server (empfohlen für volle Kontrolle):
  • Richte einen kleinen Server ein (z. B. Node.js/Express, Python/FastAPI, PHP, Go).
  • Lege dort einen Endpoint an, z. B. POST /api/manifest/submit.
  • Akzeptiere in diesem Endpoint die JSON-Struktur, die das Manifest-Forum sendet (siehe „Payload anzeigen“).
  • Erzeuge einen API-Schlüssel (z. B. zufälliger Token), den du lokal in das Feld „API-Schlüssel“ einträgst.
• Nutzung externer API-Plattformen (Beispiele):
  • RapidAPI – Marktplatz mit tausenden REST-APIs.
  • Postman Public APIs – viele Beispiel-APIs.
  • Google Cloud API Library.
  • Microsoft Azure AI Services.

Typischer Minimal-Workflow mit eigenem Server:

1. Backend aufsetzen und /api/manifest/submit als POST-Endpoint implementieren.
2. API-URL und optionalen Schlüssel ins Manifest-Forum eintragen.
3. Mit „Payload anzeigen“ die JSON-Struktur prüfen.
4. Server so konfigurieren, dass nur autorisierte Schlüssel Daten annehmen.

Beispiel-Request (vereinfacht):\n POST https://deine-seite.tld/api/manifest/submit\n Authorization: Bearer DEIN-SCHLUESSEL\n Content-Type: application/json\n \n { "source":"manifest-of-thinkers-offline", "version":1, "sentAt":"...", "posts":[ ... ] }

5. Verknüpfung mit dem Online-Portal

Im rechten Bereich des Manifest-Forums wird dynamisch ein Block „Portal“ eingefügt mit Portal öffnen (verifiziert). Dieser:

• Erzeugt einen zeitgebundenen HMAC-Nachweis (MOT_ACCESS_TOKEN + Zeitstempel).
• Öffnet die Online-Seite manifest-portal.html mit einer Signatur im URL-Hash.
• Erlaubt dem Online-Portal, zu prüfen, ob der Aufruf von einer offiziellen Offline-Datei kommt.

Das bedeutet für dich: Öffne das Portal möglichst immer über diesen Button – dann läuft die Verifikation im Hintergrund und du musst keine Tokens manuell kopieren.

6. Sicherheit & Aufbewahrung

• Exportiere regelmäßig manifest-forum.json als Backup.
• Bewahre die HTML-Datei manifest-forum.html und dein JSON-Backup gemeinsam auf (z. B. in einem verschlüsselten Ordner).
• Gib API-Schlüssel niemals weiter oder speichere sie im Klartext in öffentlich erreichbaren Repositories.

Für juristisch relevante Einsätze (Notariat, Verträge etc.) sollte zusätzlich eine notarielle oder gerichtsfeste Archivierung erfolgen (z. B. mit Zeitstempeln, kryptografischen Hashes und unabhängigen Drittsystemen).