Hilfe – Portal & Offline-Start

1. Überblick: Was macht die Startseite „Portal – Start“?

Die Startseite Portal – Start.html ist dein Kontrollzentrum:

Reiter „Dashboard“: Zeigt Kennzahlen über deine Einträge (Anzahl, heute erstellt, Kategorien).
Reiter „Daten“: Tabelle zum Suchen und Filtern deiner Einträge (nur Lesen).
Reiter „Berichte“: Erzeugt eine druckbare HTML-/PDF-Ansicht aus den aktuellen Daten.
Reiter „Hilfe“: Kurze Bedienanleitung direkt in der App.
Button „⚙️ Admin“: Öffnet admin.html für Backups, Beispieldaten und Statistiken.
Button „➡️ Zum Portal“: Öffnet das externe Online-Portal (z. B. businessconnecthub.pages.dev).

Wichtig: Alle deine Arbeitsdaten aus dem Offline-Portal werden lokal im Browser gespeichert (localStorage). Nichts wird automatisch an einen Server geschickt.

2. Manifest-Forum herunterladen & Desktop-Icon

Unten auf der Startseite gibt es den Block „Manifest‑Forum: Teilnahme für Einsteiger“ mit dem Button Manifest‑Forum herunterladen. Dieser lädt die Datei manifest-forum.html herunter.

Speichere die Datei an einem Ort, den du wiederfindest (z. B. „Dokumente\ManifestForum\“).
Mit Doppelklick öffnest du das Offline-Forum direkt im Browser.
Alle Beiträge, die du dort erstellst, bleiben in deinem Browser gespeichert.

Desktop-Icon (Windows, macOS, Linux):

Windows: Rechtsklick auf die Datei manifest-forum.html → „Senden an“ → „Desktop (Verknüpfung erstellen)“.
macOS: Datei im Finder markieren → mit gedrückter ⌘-Taste auf den Desktop ziehen (Alias wird erstellt).
Linux (GNOME/KDE): Rechtsklick → „Verknüpfung erstellen“ oder Datei auf den Desktop ziehen.

So hast du immer eine eindeutige, verifizierte Manifest-Version als Startpunkt und musst nicht jedes Mal neu herunterladen.

3. Installation als App (PWA) auf Handy & Desktop

Die Kombination aus manifest-portal.webmanifest und sw.js macht das Portal zu einer Progressive Web App (PWA). Viele Browser bieten deshalb automatisch an:

Auf dem Handy: „Zum Startbildschirm hinzufügen“ (Android/Chrome, Edge, teilweise iOS/Safari).
Auf dem Desktop: „App installieren“ oder „Als App installieren“ in der Browser-Menüleiste.

Wichtig: Die Installation passiert nur mit deiner ausdrücklichen Zustimmung. Ohne Klick auf den Button des Browsers wird keine App installiert.

Empfohlener Ablauf:

Öffne das Portal im Browser (z. B. Portal – Start.html lokal oder die Online-URL).
Warte auf den Hinweis deines Browsers „Installieren“ / „Zum Startbildschirm hinzufügen“.
Bestätige nur, wenn du dieser Installation vertraust.

Die PWA-Installation erstellt kein zusätzliches Benutzerkonto, sondern nur eine Verknüpfung zur bestehenden Portal-Oberfläche mit Offline-Fähigkeit.

4. API-Anbindung – woher kommen API-Schlüssel & Endpunkte?

Das Portal selbst bringt keine fertige Fremd-API mit. Stattdessen gibt es Felder, in die du eigene API-URLs einträgst (z. B. im Manifest-Forum oder im Manifest-Portal).

Mögliche Quellen für APIs und API-Schlüssel:

Eigener Server:
- Du betreibst einen eigenen Backend-Server (z. B. Node.js/Express, Python/FastAPI).
- Du definierst dort einen Endpoint, z. B. POST /api/manifest/submit oder GET /api/manifest/list.
- Die URL dieses Endpoints trägst du in die App ein (z. B. Feld „API-Endpoint“).
API-Marktplätze (Beispiele):
- RapidAPI – viele REST-APIs (Text, Bilder, Finanzen, etc.).
- Google Cloud APIs – z. B. Vision, Translate, Maps.
- Microsoft Azure AI Services – z. B. Sprache, Textanalyse, Übersetzung.
- IBM Developer – Watson-basierte APIs.

Typischer Ablauf zur API-Nutzung:

Registriere dich bei einem API-Anbieter (oder richte deinen eigenen Server ein).
Erzeuge dort einen API-Schlüssel (meist als „API key“, „Bearer Token“ oder „Client Secret“ bezeichnet).
Trage die Basis-URL (z. B. https://deine-seite.tld/api/manifest/submit) und den Schlüssel in die Eingabefelder der App ein.
Teste mit der Funktion „Payload anzeigen“, welche JSON-Daten gesendet würden.
Erst wenn alles passt, „Beiträge senden“ anklicken.

Die App sendet niemals automatisch ohne deine Aktion – du entscheidest, wann etwas an eine API übertragen wird.

5. Verifikation & Verbindung zum Online-Portal

Einige Funktionen (z. B. im Manifest-Portal) nutzen ein Token + HMAC-Signatur, um zu prüfen, ob eine Anfrage von einer echten Manifest-Datei stammt.

Das Offline-Manifest kennt einen gemeinsamen Token (z. B. MOT_ACCESS_TOKEN).
Beim Klick auf „Portal öffnen (verifiziert)“ wird ein Link zum Online-Portal geöffnet.
Im Link steckt im Hash (#mot=...&ts=...&sig=...) eine Signatur über Zeitstempel und Token.
Das Online-Portal kann diese Signatur prüfen und dann bestimmte Live-Funktionen freischalten.

Beispiel-Hash: #mot=mot-shared-token-v1&ts=1710000000000&sig=abcdef1234...

Für dich als Nutzer reicht: Öffne das Portal immer über die Buttons in der App – dann wird der Token automatisch mitgegeben, ohne dass du kryptografische Details kennen musst.

6. Zusammenfassung für Anwender:innen ohne Technik-Vorkenntnisse

Wenn du nur die Plattform nutzen willst, ohne selbst Server zu betreiben:

Nutze Portal – Start.html und manifest-forum.html lokal für deine Arbeit.
Erstelle dir ein Desktop-Icon für manifest-forum.html, um immer dieselbe, verifizierte Datei zu öffnen.
Nutze die Berichtsfunktionen (HTML/PDF), um Ergebnisse zu sichern oder zu drucken.
Verbinde dich mit einem Admin/Techniker, wenn du zusätzliche APIs oder Live-Funktionen (Signaling, WSS) aktivieren willst.

Alles Weitere – API-Schlüssel, Signaling-Server, eigene Hubs – kann später Schritt für Schritt ergänzt werden, ohne dass deine bestehenden Offline-Daten verloren gehen.