Bauprotokoll
Stand 24.09.2026, 22:00 121 Commits · 8 Arbeitstage · seit 11.09. 5.820 Zeilen Code · 64 technische Dateien gitlab.com/aendo-ai/prototyp
Bauprotokoll · Interner Projektstand

Prototyp — die Unternehmenswebsite ohne CMS

Abgleich des Implementierungsstands gegen gesamtkonzept-ai-native-website-plattform.md (34 Abschnitte). Seit dem letzten Protokoll ist aus dem n8n-Workflow ein eigener PHP-Website-Agent geworden, und die Beispielseite ist von „Mustermann GmbH“ auf das fertige Design von Foto Köpcke umgestellt. Der Weg von der Kundenmail bis zur Live-Seite läuft ohne Handarbeit. Seit 24.09. gilt die Freigabe nach Risiko: Riskante Änderungen warten auf ein „OK“ des Teams per E-Mail (docs/entscheidungen.md).

10Bereiche fertig
5Bereiche im Rohbau
4Bereiche offen
2bewusste Abweichungen vom Konzept
20 bewertete Konzeptbereiche · Abweichungen: §14 keine Vorschau, §13 Hinweis-Mail an fremde Absender

Projektkennzahlen

Stand 24.09.2026, aus Repo und Sitzungsprotokollen
Tokens verbraucht 553,7Mio.
Ausgabe (generiert)
1,44 Mio.
Eingabe neu
9,28 Mio.
Cache-Lesezugriffe
542,95 Mio.
API-Antworten
1.271

Claude Code, 14.–24.09. (Sonnet 5, Opus 5.5). Nicht enthalten: Chats auf claude.ai und das LLM des Website-Agenten bei mittwald.

Codezeilen gesamt 5.820
PHP-Logik (src/, bin/)
4.474
PHP-Templates
768
CSS
408
Shell
110
JavaScript
60

Dazu 694 Zeilen Konfiguration & Schema, ohne das generierte composer.lock.

Technische Dateien 64
Code (PHP, CSS, JS, Shell)
54
Konfiguration & Schema
10
Inhalte (YAML)
12
Assets (Bilder, Schriften, PDFs)
30
Dokumentation
4

110 Dateien im Repo insgesamt.

Commits 121
Entwicklung
48
vom Website-Agent
41
Merges
32
Arbeitstage
8

11.09.–24.09.2026. Agent-Commits sind Inhaltsänderungen aus Kundenmails.

Bauphasen

§30

Der vom Konzept vorgegebene Aufbauweg: erst der technische Beweis der Plattform, dann Agent und Mail-Automatisierung darüber.

1Statischer Seitengenerator
100 %

YAML → Build → statisches HTML. Foto-Köpcke-Onepage live, identisch zur Designvorlage.

13 Komponenten · 340 Elemente pixelgleich geprüft

2Tool Layer
100 %

Validierte Operationen statt Dateizugriff — jetzt auch Listeneinträge und Stammdaten.

15 Agent-Tools · Sandbox je Aufruf

3Agent-Integration
~85 %

Intent → Tool-Call → Validierung → Branch → Merge läuft. Die KI sieht aktuelle Inhalte. Es fehlt die Preview.

PHP-Pipeline statt n8n · gpt-oss-120b

4Mail-Gateway, Freigabe, Deployment
~75 %

Postfach, Absenderprüfung, Kunden-Mails, Freigabe nach Risiko per E-Mail, Mattermost, Sofort-Deploy und Selbstheilung hängender Merges stehen. Offen sind Tenant-Routing und SPF/DKIM.

RiskClassifier · bin/process-mailbox.php · bin/deploy.sh

Seit dem letzten Protokoll

18.09. → 24.09.
22.09.Architektur
  • aa084c5n8n-Workflow durch echten PHP-Website-Agent ersetzt (src/Agent/, Cronjob bin/process-mailbox.php)
23.09.Agent härten
  • —Aktueller Seiteninhalt im Prompt, keine leeren MRs mehr, IMAP-Timeout behoben; SMTP-Diagnose bin/test-smtp.php
  • 9a7a721Listen-Werkzeuge add_item/update_item/remove_item — „Leistung hinzufügen“ hatte die ganze Liste überschrieben, Daten wiederhergestellt
  • —Kunde vs. Team getrennt: Rückfragen und Ablehnungen per Mail an den Kunden, technische Fehler an Mattermost, Bestätigungsmail nach Erfolg
  • 7895cddGlobale Angaben per update_setting pflegbar (content/settings.yaml)
24.09.Foto Köpcke & Betrieb
  • cd3a1e5Design fotokoepcke_26 vollständig übernommen: Layout, 3 neue Komponenten, Assets; Mustermann-Inhalte archiviert
  • —Sync nach main verwendet offenen MR weiter; Entwurfs-MR !64 hatte seit 23.09. 19:56 jede Übernahme blockiert
  • 0b9b777Pull-Deploy bin/deploy.sh als zweiter Cronjob: Fast-Forward, composer bei Bedarf, Build
  • —Hinweis-Mail an nicht autorisierte Absender (Autoresponder-Erkennung, max. 1×/24 h)
  • d499718Aufgeräumt: Tool-API für n8n (prototyp-api, /api-gateway/) entfernt, CI auf optionalen SSH-Trigger reduziert
  • —Grundsatzentscheidung umgesetzt: Freigabe nach Risiko per E-Mail-Antwort („OK“ / „Nein <Begründung>“), keine Vorschau, Sofort-Deploy nach Veröffentlichung
  • —MR !76/!77 blieben offen: GitLab berechnet den Merge-Status nur auf Anforderung. Der Merge fragt jetzt mit with_merge_status_recheck ab, hängende Agent-MRs werden bei jedem Lauf nachgeholt (beide um 21:39 automatisch gemergt und ausgerollt)
  • —Deploy-Cronjob lief ins Leere (HOME: unbound variable). deploy.sh kommt jetzt ohne HOME/PATH aus und schreibt var/deploy.log

Stand nach Konzeptabschnitt

Jeder Eintrag verweist auf den Abschnitt im Gesamtkonzept. „Fehlt“ nennt, was bis zum Konzeptumfang noch aussteht.

Fundament
§5Statische Website
Fertig

Build aus content/*.yaml nach dist/; zur Laufzeit kein CMS, keine Datenbank.

prototyp.liermann.ai · HTTP 200 · „Foto Köpcke – Ihr Fotofachgeschäft in Buxtehude“

§6Komponentenmodell
Rohbau

13 Komponenten im Foto-Köpcke-Design, darunter neu infobar, highlight und offers. cards kann Icon-Kacheln und Bildkarten.

Fehlt: Galerie, Team, Termine, Video, Logos, Testimonials, echte Karte

hero · infobar · text · text_image · image · cards · highlight · offers · faq · contact · cta · news · downloads

§7Website-Schema
Fertig

site.yaml für Seiten und Sektionen; components.schema.json mit Feldern und Beschreibungen, die das LLM direkt liest.

site.id fotokoepcke · 8 Sektionen · Collections deaktiviert

§8Strukturierte Inhalte
Fertig

Seiteninhalt in home.yaml; Stammdaten (Adresse, Telefon, Öffnungszeiten, Navigation, Footer) einmalig in settings.yaml, überall automatisch verwendet.

„Samstag bis 13 Uhr“ per Mail → an 4 Stellen korrekt übernommen

§9Tool Layer
Fertig

Jede Änderung läuft über geprüfte Operationen. Ganze Listen zu überschreiben ist gesperrt, Icon-Namen und Öffnungszeiten werden validiert.

Fehlt: search_knowledge; build_preview und replace_asset nur per CLI

update_content · add/remove_section · add/update/remove_item · update_setting · bulk_remove_images · news/event-Tools

Agent & Kommunikation
§10Kundenspezifische Wissensbasis
Offen

Keine Knowledge Base angebunden. Die KI kennt nur Schema, Inhalte und die Mail selbst, weder Schreibstil noch Firmenwissen.

—

§11Austauschbare KI-Infrastruktur
Fertig

Das LLM läuft in Deutschland (mittwald AI Hosting) über eine OpenAI-kompatible API; Modell und URL sind konfigurierbar. Statt OpenClaw oder n8n steuert eine eigene PHP-Pipeline den Ablauf.

gpt-oss-120b · LlmClientInterface

§12E-Mail als Benutzeroberfläche
Fertig

Das Funktionspostfach verarbeitet Anfragen samt Anhang. Rückfragen laufen als Dialog über [Ref: …] (max. 4 Runden), nach Erfolg geht eine Bestätigung an den Kunden.

prototyp@liermann.ai · IMAP · SMTP 465/SSL getestet

§13Mail-Sicherheit
Rohbau

Absender-Allowlist aktiv, Autoresponder werden erkannt. Der Inhalt von Anhängen erreicht das LLM nicht, nur der Dateiname.

Fehlt: SPF/DKIM/DMARC-Prüfung, Grenzen für Dateityp und -größe, Malware-Scan. Abweichung: Fremde Absender bekommen eine Hinweis-Mail.

allowedSenders · looksAutomated() · NoticeThrottle

§18Klassifizierung
Rohbau

Implizit dreigeteilt: ausführbares Tool, Rückfrage (ask_customer) oder unknown mit Übergabe ans Team.

Fehlt: Taxonomie (CONTENT_CHANGE … DESIGN_CHANGE) mit Geschäftsregeln inklusive/Angebot in der Anwendung

ToolCallParser · handOverToTeam()

§17 · §19Leistungserweiterungen & Vertriebsassistent
Offen

Eine neue Seite oder ein Redesign landet als „manuelle Prüfung“ beim Team. Eine Einordnung als Angebot oder eine Vorbereitung dafür fehlt.

Test „neue Unterseite Team“ → unknown

Versionierung, Freigabe & Betrieb
§14GitLab als Rückgrat
Abweichung

Jede Änderung wird zu Branch, Commit und MR nach develop, dann develop → main. Der Server baut direkt nach der Veröffentlichung neu, der Cronjob greift als Rückfalllösung. Der Agent hat keinen SSH-Zugang.

Entschieden: keine Vorschau-Website. Geprüft wird anhand des Vorher/Nachher in der Freigabe-Mail (E-2026-09-24-1).

GitLabClient (Merge mit Status-Recheck) · retryStuckMerges() · bin/deploy.sh (nur Fast-Forward)

§15Persönliche Freigabe
Fertig

Freigabe nach Risiko. Texte, Öffnungszeiten und einfache Listeneinträge gehen sofort live. Anhänge, Bilder, Links, Löschungen, neue Sektionen und Stammdaten warten auf ein „OK“ per Antwort-Mail, „Nein <Begründung>“ lehnt ab. Die Freigabe erfolgt per E-Mail statt über Mattermost.

RiskClassifier · approverEmails · Token im Betreff · E-2026-09-24-1

§16Enthaltene Änderungen
Rohbau

Abgedeckt sind Texte, Telefon, Adresse und Öffnungszeiten, Bilder, Downloads, FAQ, neue Sektionen und Listeneinträge.

Fehlt: SEO-Title/Description (kein Tool), Mitarbeiter, Termine, Umstrukturieren (Sektion verschieben); News aktuell deaktiviert

9 von 12 Konzeptpunkten

§22 · §23Monitoring & Plattformpflege
Offen

Fehler landen in Mattermost. Ob Cronjobs laufen oder der Deploy hängt, überwacht niemand.

—

§25Kündigung & Eigentum
Fertig

dist/ ist reines HTML mit lokalen Schriften und Assets und lässt sich ohne Plattform bei jedem Hoster betreiben.

keine externen Abhängigkeiten zur Laufzeit

Plattform & Skalierung
§20Migration bestehender Websites
Fertig

Am Beispiel erprobt: Das Foto-Köpcke-Design wurde manuell in Schema, Komponenten und Inhalte überführt. Text, Bilder und Layout sind maschinell gegen die Vorlage geprüft.

Text & Bilder identisch · 1400/900/375 px gleich

§26Multi-Tenant-Architektur
Rohbau

Mandantenwerte sind gebündelt (Config, tenantId, agent.local.php). Ein Postfach und ein Repo bedienen genau einen Mandanten.

Fehlt: Mandant aus Empfängeradresse, gemeinsamer Agent-Betrieb für mehrere Repos

deploy/targets.yaml · Config::allowedSenders()

§27 · §28Technische Basis & Repo
Fertig

PHP 8.4 und DDEV statt Astro, eigener PHP-Agent statt OpenClaw/n8n. Beide Abweichungen sind dokumentiert, das Konzept erlaubt sie ausdrücklich.

symfony/yaml · webklex/php-imap · phpmailer

§29Zentrale Plattformpakete
Offen

Renderer, Komponenten, Tool Layer und Agent liegen im Kundenrepo. Paketiert ist davon nichts.

—

Offene Punkte

aus dem Arbeitsverlauf
Freigabe-Adresse auf dem Server eintragen
Ohne approverEmails in config/agent.local.php veröffentlicht der Agent weiterhin alles sofort und vermerkt das in Mattermost. Erst mit der Adresse greift die Freigabe.
Betrieb
Mattermost-Webhook-URL stand in der Konfigurationsvorlage
Die echte URL war in config/agent.local.php.dist im Git. Sie ist jetzt durch einen Platzhalter ersetzt, steht aber noch in der Git-Historie. Den Webhook in Mattermost neu erzeugen.
Sicherheit
Deploy-Cronjob: Korrektur einmal von Hand ausrollen
Der Cronjob ist angelegt, brach aber bisher sofort ab (HOME: unbound variable). Die Korrektur braucht einen letzten manuellen Lauf von bash bin/deploy.sh. Danach im nächsten Merge in var/deploy.log prüfen, dass der Cron selbst ausrollt. /api-gateway/ ist live inzwischen weg (HTTP 404).
Betrieb
Systematischer LLM-Test ausstehend
Live bestätigt sind Einzelfälle: Öffnungszeiten, Telefonnummer, Aktionsbild. Ein Trockenlauf mit 15 vorbereiteten Kundenmails (echtes LLM, simuliertes GitLab/SMTP) steht noch aus.
Qualität
Keine automatisierten Tests im Repo
Alle Pipeline-Tests liefen als temporäre Skripte mit Fakes. Rückschritte wie das Überschreiben der Leistungsliste würden nicht automatisch auffallen.
Qualität
GitLab-Token-Leak, Rotation unbestätigt
Ein Personal Access Token war im Chat und in einer n8n-Exportdatei sichtbar. Am 24.09. wurde die lokale GitLab-CLI ungültig und neu angemeldet. Ob der geleakte Token widerrufen ist, bleibt ausdrücklich zu bestätigen. Der lokale Ordner n8n/ enthält noch einen echten API-Key.
Sicherheit
Anhänge werden nicht geprüft
Es gibt keine Grenzen für Dateityp und -größe und keinen Malware-Scan (§13). Jeder Anhang eines freigegebenen Absenders landet im Repo und auf der Website.
Sicherheit
Hinweis-Mail an nicht autorisierte Absender
Auf Wunsch eingebaut, entgegen §13 („wird nicht automatisch geantwortet“). Abgesichert durch Autoresponder-Erkennung und höchstens eine Mail pro Absender in 24 h.
Abweichung
Stammdaten doppelt im Fließtext — live sichtbar
Nach der Änderung auf 0160 299 40 90 zeigt die Seite beide Nummern: Der Passbilder-Button lautet weiter „04161 2516 anrufen“ (tel:+4941612516). Auch „Lange Straße 11“ im Hero und „Viverstraße 23“ im Badge sind Fließtext. Geplant ist, den Button aus den Stammdaten zu speisen.
Inhalt
Aktionsbild getauscht, Alt-Text und Link veraltet
Das Hero-Aktionsbild wurde per Mail ersetzt, Alt-Text und Link zeigen noch auf die LUMIX-Aktion. Beim Tausch sollte der Prompt nach Text und Ziel der neuen Aktion fragen.
Prompt
Aufräumreste
content/_archiv_mustermann/ (Löschen war blockiert), alte Test-Uploads unter public/assets/images/, Rückfrage-Dateien auf main aus MR !45, alter n8n-Workflow in der n8n-Instanz.
Hygiene
Prompt wächst mit jeder Seite
Der komplette Inhalt aller Seiten steht in jedem Prompt. Bei einer Onepage ist das unkritisch, bei 20+ Seiten kostet es Tokens und Präzision.
Skalierung