PKR-Lab

Komponenten

Quelle: pkr-lab/pkr-lab-docs/EDV-Kretzer/komponenten.md

Komponenten

Alle dynamischen Teile der Website. Die Seite besteht sonst aus statischem HTML. Es gibt weder Build-Schritt noch Framework, es gibt keine Abhängigkeiten zur Laufzeit. Das Kontaktformular spricht über fetch mit ticket-gate.

Code: js/, data/, HTML-Seiten im Repo-Root


Überblick

Komponente Datei Seiten Datenquelle
Navigation, Header, Scroll-Reveal, 3D-Tilt, Info-Banner js/main.js alle –
Status-Hinweis (Banner) js/main.js alle data/status.json
Anwendungskatalog js/apps.js anwendungen.html data/apps.json
Release-Verlauf js/updates.js updates.html data/releases.json
Status-Widget js/updates.js updates.html öffentliche Uptime-Kuma-Status-Page
Kontaktformular mit E-Mail-Bestätigung js/kontakt-verifizierung.js kontakt.html ticket-gate (Host ticket-gate-tech)
Stylesheet css/style.css, css/animations.css alle –

Die Seiten, die js/apps.js und js/updates.js einbinden, sind genau anwendungen.html und updates.html. Beide Skripte beenden sich selbst, wenn ihr Zielelement fehlt.



Status-Hinweis (Banner)

Beim Laden jeder Seite ruft main.js data/status.json mit cache: "no-store" ab. Der Banner erscheint nur, wenn:

  1. die Datei lesbar ist (HTTP 200, gültiges JSON),
  2. active genau true ist und
  3. until leer oder ungültig ist oder in der Zukunft liegt.

Er wird als erstes Element in den <body> eingefügt (role="status", Klasse status-banner status-<level>).

Feld Bedeutung
active Banner an oder aus
level maintenance (Standardtitel „Wartung“), incident („Störung“), info („Hinweis“). Unbekannte Werte gelten als info
title optional, leer = Standardtitel der Art
message Text, wird als reiner Text eingesetzt (kein HTML)
areas[] Anzeige „Betroffen: …“
since „Seit …“, vom Workflow gesetzt
until „voraussichtlich bis …“, danach blendet sich der Banner von selbst aus

Fehler beim Abruf werden verschluckt, der Banner bleibt dann aus. Die Datei schreiben die Workflows status.yml bzw. der n8n-Schalter, siehe Automatisierung und Nutzung. Der Banner liegt bewusst auf dem Webserver bei netcup und nicht im Cluster, damit er auch bei einem Cluster-Ausfall sichtbar bleibt.


Anwendungskatalog (js/apps.js)

flowchart LR
    A[anwendungen.html] --> B[fetch data/apps.json]
    B -->|ok| C[init: Filter und Raster rendern]
    B -->|Fehler| E[Hinweis: Katalog konnte nicht geladen werden]
    C --> D[Suchfeld und Filter-Chips]
    D --> C
    P["?kategorie=Monitoring"] --> C

Felder von apps.json: Konfiguration.


Release-Verlauf (js/updates.js)


Status-Widget (js/updates.js)

Zeigt den Live-Status der öffentlichen Dienste aus der öffentlichen Status-Page von Uptime Kuma (Uptime Kuma). Es werden nur Daten angezeigt, kein Link und kein iframe zum Dienst.


Kontaktformular mit E-Mail-Bestätigung

kontakt.html enthält drei Formulare, js/kontakt-verifizierung.js blendet sie nacheinander ein (ES5, kein Framework, nur fetch). Das Skript zeigt nur an, die gesamte Prüfung macht ticket-gate (Server-Doku).

Schritt Elemente Aufruf
1. E-Mail #v-email, „Code senden“ POST /v1/session (beim ersten Mal), POST /v1/verify/request
2. Code #v-code (inputmode="numeric", autocomplete="one-time-code"), „Code prüfen“, „Code erneut senden (60 s)“ mit Countdown POST /v1/verify/confirm
3. Ticket Name (optional), Betreff, Nachricht, Zustimmung zur Datenschutzerklärung POST /v1/tickets

Debugging und Fehlersuche

Symptom Ursache Lösung
Katalog oder Verlauf bleibt leer, Hinweistext „… konnte nicht geladen werden“ Seite per file:// geöffnet oder data/*.json nicht erreichbar Über Webserver öffnen (python3 -m http.server 8000), im Browser Netzwerk-Tab prüfen
Katalogkarte fehlt unter dem Filter Kategorie nicht in CATEGORIES Kategorie in apps.js ergänzen oder bestehende wählen
Katalog kaputt nach JSON-Änderung JSON-Syntaxfehler python3 -m json.tool data/apps.json
HTML aus apps.json wird ausgeführt Felder ohne Escaping keine Tags und Sonderzeichen unmaskiert in apps.json schreiben
Verlauf zeigt alte Releases releases.yml lief nicht oder schlug fehl Actions → „Release-Verlauf“ prüfen, Automatisierung
„Status gerade nicht abrufbar.“ Status-Page nicht erreichbar, Slug falsch oder CORS-Header fehlt Entwicklertools → Konsole und Netzwerk; Ursachen siehe oben; Uptime Kuma
„Noch keine öffentliche Status-Page konfiguriert.“ Status-Page homelab enthält keine Monitore Monitore in Uptime Kuma auf die Page legen
Alle Monitore „Unbekannt“ Heartbeats leer (neuer Monitor) oder Heartbeat-Abruf lieferte keine Liste kurz warten, …/api/status-page/heartbeat/homelab prüfen
Banner erscheint nicht trotz active: true until liegt in der Vergangenheit, JSON ungültig, Datei nicht deployt data/status.json im Repo und auf dem Server prüfen, Deployment-Lauf prüfen
Banner bleibt nach Wartungsende active noch true und until leer Workflow „Status-Hinweis“ mit aktiv aus starten
Kontaktformular bleibt unsichtbar oder meldet „Keine Verbindung“ JavaScript aus, ticket-gate nicht erreichbar, Origin nicht erlaubt Konsole, E-Mail-Weg aus dem Hinweis, ticket-gate: Fehlersuche
Info-Banner erscheint bei jedem Besuch localStorage blockiert (Privatmodus) erwartet
Inhalte bleiben unsichtbar IntersectionObserver löst nicht aus nach 2,5 Sekunden Fallback, sonst Konsole prüfen

Allgemeines: Debugging und Fehlersuche.