Start › Betrieb & Dokumentation

Betrieb & Dokumentation

Server, Domains, Deploy-Ablauf, Umgebungsvariablen, Backup, Tests, Überwachung, die 9 Hausregeln — und wo die Pläne, Stories, Handoffs und Gedächtnisse liegen.

Nach Art: Betrieb 5 · Dokument 21 · Funktion 2 · Integration 2

Bilderwand

LiveCOMPOS-Altsystem (Import, Historie, Export)

Für 29 weitere Seiten fehlt noch ein Bild — sie stehen unten in der Liste.

Leseordnung

• KonzeptArbeitsplatz-Modell (CRM-Redesign, laufend)FunktionDie Büro-Oberfläche wird grundlegend neu gestaltet: eigene Arbeitsplätze in der Seitenleiste, ein einheitliches Farb- und Schriftsystem, Bedienung über die F-Tasten. Welle 1 brachte die Mechanik, Welle 2 die täglich sichtbaren Flächen — Startseite, Auftrag, Listen, Live-Bühne. Der Stand ist mit dem laufenden System zusammengeführt, aber noch nicht eingespielt.
• LiveCOMPOS-Altsystem (Import, Historie, Export)FunktionDer komplette Datenbestand — Kunden, Fahrzeuge, Kassenbuch, Reifen, Termine — stammt ursprünglich aus dem alten Werkstattprogramm COMPOS und wurde per Excel-Import wiederholbar übernommen, ohne bei erneutem Einspielen Dubletten zu erzeugen. Im Kunden- und Fahrzeugdetail sieht das Büro die alte COMPOS-Historie eingebettet, und es gibt auch eine Rückrichtung: aktuelle Daten lassen sich wieder im COMPOS-Format exportieren.
• TeilweiseDomain & DNS (kfz-bozo.at)IntegrationDie Domain kfz-bozo.at (und die Test-Subdomain test.kfz-bozo.at) muss auf den Hetzner-Server zeigen, damit die Seite erreichbar ist. Wichtig: die eigentliche Live-Domain www.kfz-bozo.at zeigt aktuell noch auf die ALTE Website (Apache) — das neue System läuft nur unter test.kfz-bozo.at.
• LiveHetzner-Server + DockerIntegrationDie Website und das CRM laufen als Docker-Container auf einem gemieteten Server bei Hetzner (Deutschland). Ein vorgeschalteter Webserver übernimmt HTTPS und leitet Anfragen an den richtigen Container weiter — die aktuelle Konfigurationsdatei nennt dafür ausdrücklich host-nginx, nicht das in älteren Projektunterlagen genannte Caddy.
• LiveDatenbank-Migrationen (Schema-Pflege)BetriebWie neue Datenfelder und Tabellen sicher in die laufende Datenbank eingebaut werden, ohne bestehende Daten zu gefährden — jede Programmversion prüft beim Start automatisch, ob neue Spalten/Tabellen fehlen und legt sie nach.
• UnklarBackup & WiederherstellungBetriebDie Werkstattdaten liegen in einer Datei-basierten SQLite-Datenbank unter einem festen Ordner (DATA_DIR). Ein Runbook beschreibt Restic+S3-Backups mit 4-Stunden-Wiederherstellungsziel, aber die dafür nötigen Umgebungsvariablen sind nirgends im Projekt (.env.example) als vorhanden dokumentiert.
• UnklarHetzner-Migrations-RunbookDokumentEin Deploy läuft in festen Schritten: neuen Branch pushen, auf dem Server per Fast-Forward mergen, Dateirechte korrigieren, ein Skript ausführen, das baut und startet. Vorher wird eine Rückfall-Markierung gesetzt, damit man im Fehlerfall sofort zurück kann. Reine Text-/Logikänderungen brauchen nur einen Neustart, sichtbare Frontend-Variablen (NEXT_PUBLIC_*) brauchen einen kompletten Neubau des Images.
• LiveUmgebungsvariablen (.env.example)Betrieb30 Einstellungen steuern, welche externen Dienste angebunden sind: E-Mail (Microsoft Graph), KI (Anthropic), Zahlungs-/Kassendienst (Fiskaly), Kfz-Bewertung (SilverDAT), Unterschriften-Pad (Signotec), SMS, Google-Bewertungen. Ohne gesetzten Wert bleibt die jeweilige Funktion abgeschaltet statt kaputt.
• LiveHausregeln-Abschnitt in CLAUDE.mdDokumentNeun feste Arbeitsregeln für dieses Projekt, jede mit einem konkreten Vorfall dahinter, der sie ausgelöst hat — vom 'Kennzeichen ist kein Schlüssel' bis zum exakten Testkommando. Sie sind der wichtigste einzelne Einstiegspunkt für jeden neuen Bearbeiter.
• TeilweiseBetriebs-ÜberwachungBetriebZwei technische Endpunkte prüfen, ob die Anwendung läuft (Health-Check) und sammeln Meldungen über verbotene, potenziell bösartige Skript-Einbindungen im Browser (CSP-Report). Ein Kontrast-Wächter prüft nach jedem Deploy automatisch, ob irgendwo unsichtbarer Text entstanden ist.
• LiveTestlaufBetrieb391 automatisierte Testdateien prüfen das System (Vitest). Ein falsch gesetztes Kommandozeilen-Flag lässt den Testlauf fälschlich 'erfolgreich' melden, obwohl kein einziger Test gelaufen ist — deshalb gibt es einen exakt vorgeschriebenen Befehl.
• AbgelöstAudit-Dokumente (docs/audit/)DokumentNeun Prüfberichte aus verschiedenen Projektphasen (UX-Kritik, Edge-Case-Audit, Preis-Gegencheck, Bot-Meister-Prüfung) — Momentaufnahmen, keine laufend gepflegten Dokumente.
• UnklarDesign-Mockups (docs/design/)DokumentEinzelne HTML-Mockups und Konzeptnotizen für konkrete UI-Bausteine: Auftrags-Ausdruck, Einverständnis-Annahme, Mechaniker-App, Bühnen-Segmente, Kundenbericht-Ansichten.
• UnklarFiskaly/RKSV-Dokumente (docs/fiskaly/)DokumentRunbook, ein Gesprächsprotokoll und eine technische Spezifikation zur Registrierkassen-Sicherheitsverordnung (RKSV) über den Anbieter Fiskaly.
• TeilweiseHandoff-Dokumente (docs/handoff/ + Root HANDOFF-*.md)DokumentÜbergabedokumente zwischen Arbeitssitzungen für konkrete Einzelthemen: eine Server-Migration (2026-09-04), Mechaniker-Vorprotokoll-Merge, Hetzner-Agent-Prompt, sowie der Root-Datei HANDOFF-compos-export-v12.md für den CompOS-Datenexport.
• AbgelöstMASTERPLAN.mdDokumentDer ursprüngliche große Bauplan für 'CRM + ERP + KI-Werkstatt-Cockpit' von Mai 2026, mit Prinzipien, Phasenplan und einer Liste bekannter Widersprüche (z.B. drei verschiedene Deploy-Beschreibungen).
• LiveOwner-Claude-Gedächtnis (112 Dateien, ausserhalb des Repos)Dokument112 einzelne Kurznotizen, die der Besitzer-Assistent (Claude) bei früheren Sitzungen selbst geschrieben hat — jede hält einen Fakt fest, meist 'X ist jetzt LIVE in Produktion mit Commit Y' oder 'X wurde nie eingerichtet'. Liegen NICHT im Projekt-Repo, sondern in einem persönlichen Ordner auf dem Rechner des Besitzers und können darum vom Wiki nicht direkt verlinkt werden.
• TeilweisePlan-Dokumente (docs/plan/, 40 Dateien)Dokument40 Planungsdokumente (23 HTML, 17 Markdown) für einzelne Ausbaustufen (z.B. Sammelrechnung, Odoo-ERP-Härtung, Arbeitsplatz-Modell) — teils als HTML-Berichte für den Chef, teils als Markdown-Arbeitspläne für Entwickler. Jedes trägt (soll tragen) einen Status: aktiv, abgeschlossen oder abgelöst.
• LiveProjekt-Briefe (README/AGENTS/CLAUDE.md/DEPLOY.md)DokumentVier Dateien im Wurzelverzeichnis erklären neuen Mitarbeitern und KI-Assistenten, wie das Projekt tickt: was es ist (README), welche KI-Helfer es gibt (AGENTS.md, CLAUDE.md mit 9 Hausregeln), und wie man es auf den Server bringt (DEPLOY.md).
• UnklarPrompt-Vorlagen (docs/prompts/)DokumentVorformulierte Anweisungstexte für wiederkehrende KI-Aufträge, aktuell ein Prompt für Anhang-Idempotenz.
• TeilweiseRedesign-Dokumentation (docs/redesign/)DokumentDesign-Philosophie, Design-System und eine Abdeckungs-Karte für den laufenden Oberflächen-Umbau der Admin-Oberfläche.
• UnklarRecherche-Dokumente (docs/research/)DokumentVier Recherche-Ordner: Audatex (Schadenskalkulation), Signotec-Web-Integration, Wissensdatenbank, und eine Codex-CRM-Kritik — Grundlagenrecherchen bevor gebaut wurde.
• LiveZweites Claude-Gedächtnis auf dem ServerDokumentAuf dem Produktionsserver existiert ein EIGENES, zweites Gedächtnis mit acht Sitzungen und 124 weiteren Notiz-Dateien — unabhängig vom lokalen Gedächtnis des Besitzer-Rechners. Wer nur lokal sucht, sieht die Hälfte des Wissens nicht.
• UnklarShowcase-Seite (docs/showcase/)DokumentEine eigenständige HTML-Präsentationsseite mit fünf Bildschirmfotos zum Leistungskatalog und den Mechaniker-Aufgaben, dazu eine Vorschrift zum automatischen Nachschießen dieser Fotos.
• Nie eingerichtetSMS-Gateway-Doku (docs/sms/)DokumentEine Schritt-für-Schritt-Anleitung zur Einrichtung des SMS-Gateways: Handy-App installieren, Zugangsdaten hinterlegen, Rückkanal für Antworten und Zustellstatus einrichten, Test-SMS senden. Die Technik ist fertig gebaut, das Diensthandy wurde in der echten Werkstatt aber bis heute nicht eingerichtet.
• UnklarSPEC-Dokumente (docs/SPEC_*.md, docs/*-deferred.md)DokumentVier fachliche Spezifikationen (KI-Rückstau-Abgleich, Bot-Meister-Gedächtnis + dessen UX, Bozo-Checks, Ersatzteil-Angebote) plus drei zurückgestellte Phasen (phase3/4/5-deferred.md) — Dinge die bewusst NICHT gebaut wurden.
• TeilweiseStory-Dateien (docs/stories/, 64 Dateien)Dokument64 einzelne Arbeitsaufträge ('Stories') mit Status (offen/in Arbeit/fertig) — das ist die feinkörnigste Ebene der Planung, direkt unter den Plan-Dokumenten.
• TeilweiseVerkaufs-Dokumente (docs/verkauf/)DokumentZwei chef-/kundengerichtete HTML-Seiten: Feature-Reifegrad-Übersicht des ganzen Systems ('WerkstattOS') und ein Vergleich zu DAT-Partnerschaften — für Verkaufsgespräche gedacht, nicht für Entwickler.
• KonzeptWayfinder-Entscheidungstickets (docs/wayfinder/)DokumentEin noch offenes Themenfeld ('wissensdatenbank') aus dem Wayfinder-Werkzeug, das große Vorhaben in einzelne Entscheidungsfragen zerlegt, bevor gebaut wird.
• AbgelöstGenerierter Projekt-Wiki (.wiki/index.html)DokumentEin automatisch von einem KI-Werkzeug (wiki-keeper) erzeugter Übersichtsartikel mit Architektur-, Ablauf- und Datenbankdiagrammen — sollte eigentlich nach jedem großen Bau neu erzeugt werden, ist es aber seit Monaten nicht.