diff --git a/README.md b/README.md index c41ade8..a97a2e0 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,9 @@ -# ToolCTRL — Landing Page +# ToolCTRL — Website -Eine-Seiten-Website im Visitenkarten-Stil für den Messeauftritt: Landing Page -plus Lead-Formular zur Kontaktsammlung. Monochrom (weiß / schwarz), an die -ToolCTRL Brand Identity angelehnt, ohne externe Abhängigkeiten. +Mehrseitige Website im Visitenkarten-Stil: Landing Page mit Lead-Formular, +TechDay-2026-Seite, AI-GameJam-Seite mit Datei-Upload sowie Impressum und +Datenschutz. Monochrom (weiß / schwarz), an die ToolCTRL Brand Identity +angelehnt. Der Server läuft ohne npm-Pakete (nur Node-Standardbibliothek). ## Starten @@ -10,35 +11,85 @@ ToolCTRL Brand Identity angelehnt, ohne externe Abhängigkeiten. node server.js ``` -Der Server sucht automatisch einen freien Port (zuerst `4317`) und gibt die -URL aus, z. B. `http://127.0.0.1:4317`. Stoppen mit `Strg + C`. +Der Server sucht automatisch einen freien Port (zuerst `4317`) und gibt lokale +und Netzwerk-URL aus. Stoppen mit `Strg + C`. -Voraussetzung: Node.js (getestet mit v26). Keine Installation, keine `npm`-Pakete. +Voraussetzung: Node.js (getestet mit v26). ## Aufbau ``` -public/ statische Website (HTML, CSS, JS, Assets) - index.html Landing Page + Kontaktformular - styles.css Designsystem - script.js Formular-Logik & Mobile-Navigation - assets/ Logos, Emblem, Favicon, Icon-Set -server.js abhängigkeitsfreier Node-HTTP-Server + Lead-Endpunkt -leads/ gesammelte Anfragen (wird automatisch angelegt) - leads.csv Anfragen als CSV — direkt in Excel öffenbar - leads.ndjson dieselben Anfragen als JSON pro Zeile +public/ statische Website + index.html Landing Page + Kontaktformular + techday.html TechDay Bruchsal 2026 + gamejam.html AI GameJam (eigenes Styling, Spiel-Upload) + impressum.html Impressum + datenschutz.html Datenschutzerklärung + styles.css Designsystem + script.js Formular-Logik & Mobile-Navigation + assets/ Logos, Emblem, Favicon, Icons, Schriften, Mockups +server.js abhängigkeitsfreier Node-HTTP-Server + API +leads/ gesammelte Kontaktanfragen (wird automatisch angelegt) +gamejam/ GameJam-Einreichungen, Metadaten (wird automatisch angelegt) ``` +`leads/`, `gamejam/` und hochgeladene Spiele sind per `.gitignore` vom Repo +ausgeschlossen. + ## Leads -Jede abgesendete Anfrage landet sofort lokal auf der Platte — in `leads.csv` -**und** `leads.ndjson`. So geht auf der Messe keine Anfrage verloren, auch -ohne Internet. Ein Honeypot-Feld fängt einfache Spam-Bots ab. +`POST /api/lead` (JSON, Pflichtfelder `name`, `email`, `nachricht`). Jede +Anfrage landet sofort lokal in `leads/leads.csv` **und** `leads.ndjson` — so +geht auf der Messe nichts verloren. Ein Honeypot-Feld fängt einfache Bots ab. -Endpunkt: `POST /api/lead` (JSON). Pflichtfelder: `name`, `email`, `nachricht`. +## GameJam-Upload & Virenscan (ClamAV) + +`POST /api/gamejam/upload` nimmt eine `.html`-Datei entgegen (max. 5 MB). +**Jede hochgeladene Datei wird vor dem Speichern per ClamAV auf Viren +geprüft.** Befund → Ablehnung; ist der Scanner nicht erreichbar, wird der +Upload ebenfalls abgelehnt (fail-closed, kein ungeprüftes Speichern). + +Der Server spricht den ClamAV-Daemon `clamd` direkt über sein Socket-Protokoll +an — keine zusätzliche Abhängigkeit. Voraussetzung: ClamAV ist installiert und +`clamd` läuft. Beim Start meldet der Server `Virenscan: aktiv` bzw. eine +Warnung, falls `clamd` nicht erreichbar ist. + +### ClamAV einrichten — macOS + +```bash +brew install clamav +cd "$(brew --prefix)/etc/clamav" +cp freshclam.conf.sample freshclam.conf +cp clamd.conf.sample clamd.conf +# In BEIDEN Dateien die Zeile "Example" entfernen oder auskommentieren. +# In clamd.conf zusätzlich diese zwei Zeilen aktivieren (Raute entfernen): +# TCPSocket 3310 +# TCPAddr 127.0.0.1 +freshclam # Virendefinitionen laden (einmalig) +clamd # Daemon starten +``` + +### ClamAV einrichten — Linux (Debian/Ubuntu) + +```bash +sudo apt install clamav clamav-daemon +# In /etc/clamav/clamd.conf: TCPSocket 3310 und TCPAddr 127.0.0.1 setzen +sudo systemctl restart clamav-daemon +``` + +### Konfiguration + +Host/Port und An/Aus stehen in `server.js` im Objekt `CLAMAV`. Mit +`enabled: false` läuft der Upload ohne Virenscan (nur für lokale Tests +ohne ClamAV gedacht). + +### Funktion testen + +Eine Datei mit der EICAR-Testsignatur hochladen — `clamd` meldet dann +`Eicar-Test-Signature FOUND`, der Upload wird abgelehnt. ## Hinweis für die Messe -Für den QR-Code am Stand sollte der Rechner mit dem Server im selben WLAN -erreichbar sein. Soll die Seite öffentlich laufen, hinter einen Reverse-Proxy -mit HTTPS setzen oder bei einem Hoster bereitstellen — `tool-ctrl.de`. +Für den QR-Code am Stand muss der Rechner im selben WLAN erreichbar sein. +Soll die Seite öffentlich laufen, hinter einen Reverse-Proxy mit HTTPS setzen +oder bei einem Hoster bereitstellen — `tool-ctrl.de`. diff --git a/public/index.html b/public/index.html index b9f04f6..6637141 100644 --- a/public/index.html +++ b/public/index.html @@ -4,7 +4,7 @@
- ToolCTRL plant, baut und betreibt individuelle Software — von der - Prozessautomatisierung über interne Tools bis zur Integration - bestehender Systeme. Schnell umgesetzt, sauber konstruiert, - zuverlässig im Betrieb. + Ganze Branchen arbeiten noch mit veralteten, zusammengestückelten + Insellösungen. Wir bei ToolCTRL bauen die Alternative: Software mit + echtem Fokus auf Bedienung und Gestaltung, die gut funktioniert, + klar aussieht und sich schnell bedienen lässt.