Agentic Ventures Wiki

Tag 1 — Daten-Discovery Prompt (Sonnet-Session)

3 Min. Lesezeit

Tag 1 — Daten-Discovery Prompt

Diesen Block direkt in eine frische Sonnet-Session (Claude Code oder opencode) reinpasten:

=== VF Liquiditaets-Cockpit Phase 1 — Tag 1 Daten-Discovery ===

## Rolle
Du bist Senior Full-Stack-Engineer mit Next.js + TypeScript + Postgres + AWS. Plus Domain-Wissen Liquiditaets-Steuerung KMU.

## Kontext — lies in dieser Reihenfolge
1. /Users/marvinkuehlmann/source/agentic-ventures/intern/projekte/vf-liquiditaets-cockpit/_index.md
2. /Users/marvinkuehlmann/source/agentic-ventures/intern/projekte/vf-liquiditaets-cockpit/plan.md
3. /Users/marvinkuehlmann/source/agentic-ventures/intern/capabilities/mcps/papierkram.md
4. /Users/marvinkuehlmann/source/agentic-ventures/intern/capabilities/mcps/ticketpay.md

## Was schon erledigt ist (nicht nochmal pruefen)
- Papierkram-MCP greift bereits auf VFs Account zu (Mandant `vibefactorygmbh`). Marvin operiert den Kunden-Account, nicht seinen eigenen.
- Sparkasse Hamm ist als Bank-Connection in Papierkram angebunden (id 6). Zweite Connection „Standard" hat id 3.
- AVV-/Datenschutz-Status wurde von Marvin gegen-checked und freigegeben.
- av-cockpit ist das Ziel-Repo (~/source/apps/av-cockpit, Next.js 16 + Tailwind v4 + Recharts, live unter dashboard.agenticventures.de).

## Deine Aufgabe — Tag 1 vom plan.md

Ziel: klar haben, welche Felder aus welchen MCPs wir wirklich brauchen, und ein TypeScript-Interface plus Mock-JSON-File als Deliverable.

### Schritt 1 — Papierkram-Daten ziehen
Rufe in dieser Reihenfolge auf, schreib pro Call NUR Schema + Counts + Aggregate ins Chat, NICHT die vollstaendigen Inhalte:

1. `papierkram_monatsabschluss(2026, 5)` — aktueller Monat
2. `papierkram_monatsabschluss(2026, 4)` — letzter abgeschlossener Monat
3. `papierkram_monatsabschluss(2026, 3)` — Monat davor (fuer Burn-Trend)
4. `papierkram_offene_posten(only_overdue=false)` — Forderungen
5. `papierkram_list_bank_transactions(bank_connection_id=6, page_size=100)` — Sparkasse Hamm letzte 100
6. `papierkram_list_bank_transactions(bank_connection_id=3, page_size=100)` — Standard letzte 100
7. `papierkram_list_vouchers(document_date_range_start="2026-04-01", document_date_range_end="2026-05-31", page_size=50)` — Ausgaben

### Schritt 2 — TicketPay-Daten ziehen
8. `ticketpay_list_events(size=20)` — alle Events, sortiert
9. Fuer die 3 jeweils naechsten Upcoming-Events: `ticketpay_event_bilanz(event_id)` — Verkaufsstand + erwartete Auszahlung

### Schritt 3 — Daten-Modell schreiben
Output-File: `~/source/apps/av-cockpit/src/lib/finance-schema.ts`

Enthaelt:
- Interface `FinanceSnapshot` mit allen Feldern fuer die drei Cockpit-Bloecke (Jetzt-Status, Diesen Monat, 90-Tage-Forecast)
- Interface `BankAccount`, `OpenInvoice`, `OpenVoucher`, `UpcomingEvent`
- TypeScript Enum fuer Status-Felder
- Kommentare WOHER jedes Feld kommt (Papierkram-Endpoint oder TicketPay-Endpoint)

### Schritt 4 — Mock-JSON anlegen
Output-File: `~/source/apps/av-cockpit/src/data/vf-snapshot-mock.json`

Enthaelt eine ECHTE Stichprobe basierend auf den Tag-1-Calls oben — aber mit anonymisierten Kunden-Namen (Kunde A, Kunde B etc.) und gerundeten Werten (auf 100 EUR). Zweck: lokale Dev-Daten ohne Live-MCP-Calls.

### Schritt 5 — plan.md updaten
Falls du im Schritt 1-2 auf was Ueberraschendes triffst (Felder fehlen, Daten anders strukturiert als gedacht, Quirks), update intern/projekte/vf-liquiditaets-cockpit/plan.md Section „Tag 1" mit dem Befund. Sonst die Tag-1-Checkboxen abhaken.

## Output am Ende der Session
- finance-schema.ts (committed in av-cockpit, aber NICHT pushen)
- vf-snapshot-mock.json (committed in av-cockpit)
- Kurzes Status-Update in intern/projekte/vf-liquiditaets-cockpit/_index.md: was funktioniert, was ist anders als geplant
- Tag-2-Skizze in plan.md gegen-checken (Snapshot-Cron-Job)

## Datenschutz-Constraints
- Keine vollstaendigen Bank-Transaktions-Listen oder Kunden-Namen im Chat-Output. Nur Counts, Aggregate, Schema.
- Echte Werte gehen ins Mock-JSON-File, aber anonymisiert und gerundet.
- Bei Unklarheit: Marvin fragen, nicht raten.

## Skill
ce:work — Build-Phase. Wenn du auf Architektur-Fragen triffst (Snapshot-Persistenz, Forecast-Algorithmus): mit ce:plan im Sub-Skill.

## Nicht in Scope fuer Tag 1
- Cockpit-UI bauen (das ist Tag 3-5)
- Cron-Job einrichten (Tag 2)
- AVV-Diskussion (geklaert)
- Multi-Tenant-Refactor (Phase 4)

=== Ende ===

Was Marvin daraus bekommen hat (Tag 1 Ergebnis)

  • CSV mit Schemas aus Papierkram + TicketPay (Pfad: vom Sonnet-Output, in Tag-2-Prompt eintragen)
  • Vermutlich finance-schema.ts in av-cockpit (zu verifizieren)
  • Status-Update am _index.md falls Quirks gefunden

Graphansicht

Backlinks