VF Liquiditaets-Cockpit — Phase 1

Problem Frame

Andre’s groesster Pain (aus Brainstorming 2026-05-18): er weiss nicht jederzeit wie viel Geld er hat, wie viel Puffer, wie weit der Runway reicht. Daraus folgend: keine klare rollende Planung. „Wie viele Events muessen wir machen diesen Monat? Wie viel Geld muessen wir einnehmen um Kosten zu decken?” sind Fragen ohne klare Antwort.

CRM-Tool, PM-Tool, Chat — das sind alles berechtigte Komponenten, aber sie sind NICHT der Pain. Der Pain ist Finanz-Steuerung. Wenn wir das zuerst loesen, haben wir den Hebel.

Was es konkret ist

Eine neue Seite im bestehenden av-cockpit-Dashboard. Single-Tenant (VF-spezifisch, kein Multi-Tenant-Refactor jetzt). Drei Bloecke:

Block 1 — Jetzt-Status (drei grosse Zahlen oben)

  • Bankstand summiert (alle VF-Konten ueber Papierkram-Bank-Anbindung)
  • Puffer = Saldo minus Verpflichtungen naechste 30 Tage (faellige Rechnungen rein + geplante Personalkosten + geplante Event-Vorkosten)
  • Runway in Monaten = Puffer / monatliche Durchschnitts-Burn-Rate

Block 2 — Diesen Monat (Ist vs Soll)

  • Eingenommen X von Ziel Y, mit Delta-Indicator
  • Ausgegeben X von Budget Y, mit Delta-Indicator
  • Offene Rechnungen raus: Liste mit Faellig-bis-Datum, Klick auf Eintrag → Papierkram
  • Faellige Rechnungen rein: Liste mit Faellig-bis-Datum
  • Geplante Events diesen Monat (aus TicketPay): Verkaufsstand bisher, erwarteter Umsatz, Auszahlungs-Datum

Block 3 — Forecast 90 Tage

  • Trend-Chart: Einnahmen vs Ausgaben Monatlich, mit Break-Even-Linie
  • Forecast-Bar: bei aktueller Event-Rate landen wir bei +N oder -N EUR Ende Monat / Quartal
  • Kurze „Was muss diesen Monat noch passieren”-Liste, abgeleitet aus den Zahlen (z.B. „2 weitere Events booken um Break-Even zu erreichen”, „diese 3 ueberfaelligen Rechnungen mahnen, Volume 4.200 EUR”)

Datenquellen

QuelleWofuerMCP-Status
PapierkramBank-Saldos (via FinTS-Integration in Papierkram), offene Rechnungen raus, offene Rechnungen rein, Kategorien-Burn der letzten 12 MonateMCP existiert, ~70 Tools
TicketPayGeplante Events, bisher verkaufte Tickets pro Event, Auszahlungs-Status, MwSt-SplitsMCP existiert, 14 Tools
ManuellForecast-Annahmen (monatliche Personalkosten, Marketing-Budget, geplante Events mit erwarteten Verkaufs-Quoten)JSON-File initial in intern/projekte/vf-liquiditaets-cockpit/forecast-assumptions.json. Phase-2-Option: nach Baserow umziehen wenn Andre selbst editieren will.

Wichtige Klarstellung (2026-05-18): Papierkram-MCP greift bereits auf VFs Account zu (Subdomain vibefactorygmbh, kein eigener AV-Account). Marvin operiert den Kunden-Account. Sparkassen-Anbindung in Papierkram existiert: Bank-Connection id 6 „Sparkasse Hamm” + id 3 „Standard”. Keine API-Key-Holung bei VF, kein zweiter MCP-Container noetig. Verifiziert via papierkram_list_bank_connections am 2026-05-18.

Daten-Pipeline

Cron-Job alle 4 Stunden (auf av-production-Lambda oder als Cron-Routine im agents-platform):

  1. Papierkram-MCP-Calls: bank_connections + bank_transactions (letzte 90d) + invoices (alle Status) + monatsabschluss
  2. TicketPay-MCP-Calls: list_events + list_orders + list_transactions
  3. Forecast-Annahmen aus JSON-File lesen
  4. Aggregieren + in finance_snapshots Postgres-Tabelle (av-production RDS) schreiben
  5. Cockpit-Build triggert oder Cockpit liest live aus der Tabelle

Cockpit-Seite rendert ueber Snapshot-Daten, nicht live durch alle MCPs. Schnell, deterministisch, audit-bar.

Auth + Hosting

  • Erweiterung des bestehenden av-cockpit auf dashboard.agenticventures.de
  • Route /vf (eigener Tenant-Bereich)
  • Cloudflare-Access-Policy erweitert: hello@marvinkuehlmann.com + Andre + Christoph (Email-Whitelist)
  • Keine eigene Auth-Logik, keine eigene VF-Subdomain in Phase 1 — Single-Tenant-Pragmatik

Erfolgs-Kriterien

  • Andre kann zu jedem Zeitpunkt in unter 30 Sekunden sehen: aktueller Bankstand, Puffer, Runway
  • Andre und Christoph nutzen die Seite mindestens 3x/Woche in der ersten Monat
  • Die Forecast-Logik liefert eine Aktions-Empfehlung pro Monat („du musst X tun bis Y”)
  • Daten sind nicht aelter als 4 Stunden

Was NICHT in Phase 1 ist

  • Kein Twenty, kein Plane, kein neuer Tool-Stack
  • Kein Multi-Tenant — nur VF
  • Keine Mobile-App, nur Web (Cockpit ist eh Mobile-tauglich gemacht)
  • Keine automatische Aktion (z.B. „Mahnung versenden”) — nur Sicht und Empfehlung
  • Keine Sparkassen-FinTS-direkt-Anbindung — laeuft ueber Papierkram

Naechste Schritte

Siehe plan fuer Tag-fuer-Tag und next-session-prompt fuer den naechsten Chat-Einstieg.

Vision danach

Wenn Phase 1 funktioniert und Andre/Christoph adoptiert haben, wird daraus Phase 2-4 des grossen Standard-Stack-Pfads. Detail: agentic-ventures-workplace-standard-stack.