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.
Navigation und Seitenverhalten (js/main.js)
- Sticky Header: setzt die Klasse
scrolledab 12 px Scrollhöhe. - Mobile Navigation:
.nav-toggleschaltet.mobile-menuund sperrt das Scrollen des Hintergrunds. Escape und Klick auf einen Link schließen das Menü. - Aktiver Link: vergleicht den Dateinamen der URL mit den
href-Werten von Navigation, mobilem Menü und Footer und setztaria-current="page". - Dropdown „Projekt“: öffnet und schließt per Klick, Escape oder Klick daneben. Der Auslöser wird
active, wenn ein Eintrag der aktuellen Seite im Menü steht. - Scroll-Reveal: Elemente mit Klasse
.revealerhalten perIntersectionObserverdie Klassevisible. Nach 2,5 Sekunden werden alle übrigen als Sicherheitsnetz sichtbar. OhneIntersectionObserversind sie sofort sichtbar. - 3D-Tilt: Das Monitor-Bild (
.monitor-frame) neigt sich beim Scrollen und mit der Maus (.alarm-monitor-3d). Beiprefers-reduced-motion: reduceentfällt die Animation. - Info-Banner:
.info-banner(auf allen Seiten außer Impressum und Datenschutz; Hinweis „nur technisch notwendige Funktionen“) erscheint nach 0,8 Sekunden, bis „Verstanden“ geklickt wurde. Die Wahl speichertlocalStorage["edvkretzer_info_banner_dismissed"]. IstlocalStoragenicht nutzbar, erscheint der Banner bei jedem Aufruf. - Jahr im Footer: Elemente mit
data-yearerhalten das aktuelle Jahr.
Status-Hinweis (Banner)
Beim Laden jeder Seite ruft main.js data/status.json mit cache: "no-store" ab. Der Banner erscheint nur, wenn:
- die Datei lesbar ist (HTTP 200, gültiges JSON),
activegenautrueist unduntilleer 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
- Lädt
data/apps.json(derzeit 28 Anwendungen) und zeigt eine Karte je Eintrag mit Icon, Name, Kategorien, Beschreibung, Tags und Link „Projekt-Website“. - Filter-Chips: Alle plus die sieben festen Kategorien. Die Liste der Kategorien steht im Code (
CATEGORIESinapps.js), nicht in der JSON. Ein Eintrag mit einer anderen Kategorie erscheint nur unter Alle. - Die Suche vergleicht Name, Beschreibung und Tags (Groß-/Kleinschreibung egal) und lässt sich mit dem Filter kombinieren.
- URL-Parameter
?kategorie=<Name>wählt eine Kategorie vor, wenn der Name inCATEGORIESsteht. - Die Felder werden ohne HTML-Escaping in die Seite geschrieben. Inhalte in
apps.jsonsind daher vertrauenswürdiger Text, kein Nutzereingabe-Feld.
Felder von apps.json: Konfiguration.
Release-Verlauf (js/updates.js)
- Lädt
data/releases.json, sortiert nach Datum absteigend und rendert eine Karte je Release: Datum, Tag (Feature,Fix,Major), Titel, Kurzfassung und Link „Release auf GitHub“. Der Link erscheint nur, wenn die URL mithttps://github.com/pkr-lab/capulus-core/releases/beginnt. - Die Daten erzeugt
scripts/build-releases.mjs, siehe Automatisierung. Titel und Text sind schon dort HTML-escaped. - Fehler: „Updates konnten nicht geladen werden.“ bzw. „Noch keine Releases.“
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.
- Zwei Abrufe parallel:
<basis>/api/status-page/<slug>(Gruppen und Monitore) und<basis>/api/status-page/heartbeat/<slug>(Heartbeats, Uptime). Der Slug isthomelab. Die Basis-URL steht Base64-kodiert inupdates.js, das ist nur Verschleierung gegen beiläufiges Auffinden, kein Schutz. - Der Status je Monitor ist der letzte Heartbeat:
1Online,0Down,2„Prüfung läuft“,3Wartung, sonst „Unbekannt“. Die Uptime der letzten 24 Stunden steht als Prozentwert daneben. - Die Zusammenfassung zeigt „Alle N Dienste erreichbar“ oder „X von N Diensten aktuell nicht erreichbar“.
pendingzählt hier nicht als Ausfall. - Der Browser ruft die Status-Page von der Website aus ab. Das funktioniert nur, weil der Uptime-Kuma-Ingress CORS-Header für die Website setzt (Uptime Kuma: CORS). Fehlt der Header, bleibt das Widget auf „Status gerade nicht abrufbar.“
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 |
- Der Session- und der Verifikations-Token liegen nur im Speicher der Seite (kein
localStorage, keine Cookies). Ein Neuladen beginnt von vorn. - Die Fehlertexte stehen in
MESSAGESim Skript (falscher Code mit Restversuchen, abgelaufen, gesperrt, Rate-Limit mit Wartezeit, Sitzung abgelaufen). Ausgegeben wird nur pertextContent. - Der Countdown für „erneut senden“ kommt vom Server (
resend_after), bei einem Limit ausretry_after. - Vorbelegung:
kontakt.html?interesse=<Text>oder?app=<Text>trägt den Text als Betreff ein (Anfrage: <Text>) und zeigt eine Notiz. - Mit deaktiviertem JavaScript bleibt das Formular verborgen und ein Hinweis mit der E-Mail-Adresse erscheint.
- Anhänge unterstützt das Formular nicht (das frühere Zammad-Widget konnte sie).
- Fällt ticket-gate aus, zeigt das Formular „Keine Verbindung zum Server“, der Rest der Seite läuft weiter.
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.