ValueOn AG 0e4a0e0e62 fixes comcoach

2026-04-16 14:20:31 +02:00

19 KiB

Raw Blame History

Customer Demo Enablement — Bling, PWG, Quid/ServiceHunter

Beschreibung und Kontext

Drei potenzielle Kunden haben konkrete Use Cases formuliert (siehe local/notes/use-cases-inputs-customers.md). Dieses Dokument analysiert alle Kundenwünsche gegen den Ist-Zustand der Plattform und definiert einen priorisierten Umsetzungsplan, der mit minimalem Aufwand maximale Demo-Abdeckung und produktive Nutzbarkeit liefert.

Kunden:

Kunde	Branche	Hauptinteresse	Status
Bling (Kevin, Julian, Silvan)	Treuhandbüro	Belegverarbeitung, Budget, Dashboards, Mandantenmanagement	Trial geplant
PWG (Markus Brütsch)	Stiftung (Immobilien/Wohnen, 200+ Liegenschaften)	Belegverarbeitung Abacus, KI-Arbeitsplatz, Coaching, Neutralisierung	Workshop 16.04.2026
Quid/ServiceHunter (David Christen)	SaaS/Dienstleistung	KPI-Dashboard, Zeiterfassung, Prognosen, Konsolidierung	Follow-up geplant

Business-Treiber: Jeder Kunde erwartet eine funktionsfähige Demo seines Haupt-Use-Cases. Demos, die end-to-end durchlaufen, konvertieren zu Trials. Trials konvertieren zu zahlenden Kunden.

Abhängigkeiten:

PWG-Demo wird parallel in c-work/1-plan/2026-04-trustee-tooling-and-demo-prep.md vorbereitet (Trustee Agent-Tools, Graph-Editor Nodes, Performance)
UI-Enhancements für Erstnutzer-Erlebnis in c-work/1-plan/2026-04-porta-ui-enhancements-team-meeting.md
INT-Stabilität in c-work/1-plan/2026-04-gateway-int-stability-and-bugfixes.md

Risiko bei Nicht-Umsetzung: Kunden sehen nur generische AI-Chat-Funktionalität statt branchenspezifische Lösungen. Differenzierung zu ChatGPT/Copilot nicht erlebbar.

Analyse: Kundenwünsche vs. Ist-Zustand

Legende

Symbol	Bedeutung
✅	Vorhanden und demo-fähig
🔧	Teilweise vorhanden, Anpassung nötig
🆕	Muss neu gebaut werden
⏳	In Arbeit (andere Plandokumente)
❌	Nicht im Scope (zu komplex / kein ROI für Demo)

Bling (Treuhandbüro)

#	Use Case	Status	Was existiert	Was fehlt
1.1	Belegverarbeitung & Spesen	⏳	Trustee-Feature mit `extractFromFiles`, `processDocuments`, `syncToAccounting`; SharePoint-Nodes im Graph-Editor; Abacus/Bexio/RMA-Connectors	Graph-Editor Demo-Workflow (in trustee-tooling-plan Phase 4); Bexio-spezifische Testdaten
1.2	Budget / Soll-Ist-Vergleich	🔧	Agent kann Dateien lesen (Excel), `aggregateTable` für Trustee-Daten, `createChart` Tool	Fehlend: Demo-Prompt + Budget-Excel; Agent braucht Anleitung zum Vergleich Soll vs. Ist über Kontennummern
1.3	Cashflow-Rechnung	🔧	Agent kann Trustee-Daten aggregieren und analysieren	Fehlend: Prompt-Template für Cashflow-Berechnung; Beispieldaten mit Bilanz + ER
1.4	Dashboard – Kennzahlen	🔧	Agent hat `createChart`, kann rechnen, kann Dateien schreiben	Fehlend: Prompt-Templates für Kennzahlen (ROI, Gewinn, Kapitalverlust etc.)
1.5	Liquiditätsplanung	🔧	Agent + Trustee-Daten + Budget-Logik	Fehlend: Prompt-Template; komplexer als Budget (braucht Prognose-Logik)
1.6	Gastro-Echtzeit-Rentabilität	❌	—	Kassensystem-/Virux-Integration fehlt komplett; erst sinnvoll wenn Kevin Use Case liefert
1.7	Abschlussunterstützung	🔧	Agent + Trustee-Daten	Fehlend: Prompt-Templates für Abgrenzungen, Saldovalidierung, Vorjahresvergleich
1.8	Mandantenmanagement	✅	Multi-Tenant-Plattform mit Feature-Store; ein Login, mehrere Mandate, strikte Datentrennung (RBAC)	Nur UX-Polishing für die Demo nötig

Bling Demo-Strategie: Use Cases 1.1, 1.2, 1.4 und 1.8 sind die stärksten Demo-Kandidaten. 1.1 wird durch den PWG-Plan mitabgedeckt (gleiche Trustee-Pipeline, anderer Connector). 1.2 und 1.4 brauchen primär Prompt-Engineering + Testdaten. 1.8 ist bereits Plattform-Kernfunktion.

PWG (Stiftung)

#	Use Case	Status	Was existiert	Was fehlt
2.1	Belegverarbeitung Abacus	⏳	Abacus-Connector, Trustee-Pipeline, Graph-Editor Workflow	Wird in trustee-tooling-plan umgesetzt (Phase 1–4)
2.2	Coaching-Tool (Mietergespräche)	🔧	CommCoach-Feature mit Personas, Sessions, Scoring, Scheduler	Fehlend: Immobilien-spezifische Personas (Mietrückstand, Nebenkosten, PWG-Stil)
2.3	KI-Arbeitsplatz + Neutralisierung	✅	Workspace (auto-instance), Neutralization Feature (PII-Masking, Playground), Private LLM	Demo-Config nötig: Neutralisierung aktivieren, fiktives Mieterdossier testen
2.4	Abacus-Datenauswertung	⏳	Agent + `queryFeatureInstance` + `aggregateTable`	Abgedeckt durch trustee-tooling-plan (Phase 1)
2.5	Grundstücksanalyse	🔧	RealEstate-Feature (Skeleton), Geo-Connectors (SwissTopo, ÖREB WFS, ZH Parcels)	Feature ist noch Shell; für Demo reicht Agent + `webSearch` + `readUrl` auf öffentliche Quellen

PWG Demo-Strategie: 2.1 und 2.4 werden durch den trustee-tooling-plan abgedeckt. 2.3 ist demo-ready (Config + Testdaten). Grösster Hebel hier: 2.2 CommCoach mit Immobilien-Personas — zeigt sofortigen, greifbaren Mehrwert mit wenig Aufwand. 2.5 kann als Agent-Demo mit Web-Recherche gezeigt werden.

Quid/ServiceHunter

#	Use Case	Status	Was existiert	Was fehlt
3.1	KPI-Dashboard	🔧	Agent + `createChart` + Dateiverarbeitung (Excel/CSV)	Fehlend: Kein Treuhandball-/ERP-Connector; Daten müssen als CSV/Excel importiert werden; Prompt-Templates für KPI-Berechnung
3.2	Zeiterfassung & Support-Analyse	🆕	Agent kann Dateien lesen und analysieren	Fehlend: Kein Zendesk-Connector; Workaround: CSV/Excel-Export aus Zendesk manuell hochladen
3.3	Prognosen & Proaktive Steuerung	🔧	Agent kann rechnen, Trends erkennen, Charts erstellen	Fehlend: Prompt-Templates; historische Testdaten
3.4	Konsolidierung (international)	❌	Multi-Mandate Grundstruktur	Regelbasierte Konsolidierung ist hochkomplex; erst nach Follow-up mit Lars sinnvoll
3.5	Spesen-Automatisierung	⏳	Gleiche Trustee-Pipeline wie Bling/PWG	SharePoint/Google Drive → Trustee; minimal anpassbar

Quid Demo-Strategie: 3.1 ist der stärkste Kandidat — mit manuell hochgeladenen CSV/Excel-Daten kann der Agent KPIs berechnen und visualisieren. 3.2 funktioniert als „Upload deine Zendesk-Exports und lass den Agent analysieren". 3.3 als Erweiterung von 3.1. 3.4 ist explizit zu komplex für eine erste Demo.

Synthese: Was bringt den grössten Demo-ROI?

Muster über alle Kunden hinweg

Capability	Bling	PWG	Quid	Aufwand	Priorität
Trustee-Pipeline (Belege → BuHa)	1.1	2.1	3.5	⏳ In Arbeit	P0 (bereits geplant)
Agent Prompt-Templates (Analyse + Charts)	1.2, 1.3, 1.4	2.4	3.1, 3.3	Klein (Prompts + Testdaten)	P1
CommCoach Immobilien-Personas	—	2.2	—	Klein (Persona-Config)	P1
Neutralisierungs-Demo-Setup	—	2.3	—	Klein (Config + Testdaten)	P1
CSV/Excel-Import als Datenquelle	—	—	3.1, 3.2	Mittel (Workspace-Dateien reichen)	P2
Multi-Mandate Demo-Setup	1.8	—	—	Klein (Demo-Mandanten anlegen)	P2
Grundstücks-Recherche via Agent	—	2.5	—	Klein (Prompt + Web-Tools)	P3
Zendesk-Connector	—	—	3.2	Gross (neuer Connector)	P4 (nicht für erste Demo)
Gastro-Integration	1.6	—	—	Gross (Kassen-/Lohn-API)	P4 (wartet auf Kevin)
Konsolidierung	—	—	3.4	Sehr gross	P4 (wartet auf Lars-Meeting)

Fokus und kritische Details

Prompt-Templates als Schlüssel-Asset

Der Agent kann bereits Trustee-Daten lesen, aggregieren und Charts erstellen. Was fehlt, sind vorkonfigurierte Prompt-Templates (als Workspace-Dateien oder System-Prompts), die den Agent zuverlässig zur gewünschten Analyse führen:

Budget-Vergleich: „Lade Budget-Excel, vergleiche mit Ist-Daten aus Trustee pro Kontonummer, erstelle Abweichungs-Chart"
Cashflow: „Berechne operativen Cashflow aus Bilanz + ER, berücksichtige Abschreibungen, zeige Warnung bei negativem Trend"
KPI-Dashboard: „Berechne Bruttogewinn, ROI, Gewinnmarge, Kapitalverlust-Check aus den Trustee-Daten"
Prognose: „Analysiere letzte 6 Monate, prognostiziere nächste 3 Monate mit linearer Extrapolation"

Diese Templates können als Workspace-Dateien (Markdown mit Instruktionen) oder als Graph-Editor System-Templates (Workflow mit ai.prompt-Node) umgesetzt werden.

CommCoach: Geringer Aufwand, hoher Wow-Effekt

CommCoach hat bereits: Persona-System, Session-Management, Scoring, Feedback. Für PWG braucht es nur 3–5 neue Personas im Immobilienkontext:

Mieter mit Zahlungsrückstand
Mieter mit Nebenkostenfragen
Neuer Mieter (Einzug/Vertragsklärung)
Schwieriger Nachbar (Lärmbeschwerde)

Neutralisierung: Bereits gebaut, nur konfigurieren

Das Feature ist vollständig: Playground, Text/Datei-Neutralisierung, Private-LLM-Integration. Für die Demo braucht es:

Ein fiktives Mieterdossier (PDF mit Namen, Adressen, Mietzinsen)
Neutralisierung aktiviert auf der Demo-Instanz
Vorführung: Original → neutralisiert → AI-Analyse → Re-Personalisierung

Ziel und Nicht-Ziele

Ziel:

Für jeden der drei Kunden mindestens 2 Use Cases end-to-end demo-fähig
Prompt-Templates als wiederverwendbares Asset (nicht nur einmalige Demo-Hacks)
Demo-Mandanten mit realistischen Testdaten pro Kunde
CommCoach mit Immobilien-Personas für PWG
Neutralisierungs-Demo-Flow getestet

Explizit NICHT:

Keine neuen Connector-Implementierungen (Zendesk, Kassensystem, Virux)
Keine regelbasierte Konsolidierung
Keine Gastro-Echtzeit-Integration
Keine neuen Frontend-Features (UI-Enhancements laufen separat)
Kein Abacus-Produktivzugang (Demo mit Sandbox/Mockdaten)

Betroffene Module

Gateway: features/commcoach/ (Persona-Seeding), features/trustee/ (Demo-Daten), features/neutralization/ (Demo-Config)
Frontend: keine Änderungen (UI-Enhancements separat)
DB-Migration: nein
Andere Komponenten: Testdaten (Excel, PDF, CSV), Prompt-Templates (Workspace-Dateien)

Entscheidungen

Datum	Entscheidung	Begründung
2026-04-09	Prompt-Templates statt Custom-Code für Analyse-Use-Cases	Agent + bestehende Tools (aggregateTable, createChart) reichen; Templates sind schnell erstellbar und wartbar
2026-04-09	Quid-Demo ohne Zendesk-Connector — CSV/Excel-Upload Workaround	Zendesk-Connector hat hohen Aufwand, CSV-Import zeigt den gleichen Analyse-Mehrwert
2026-04-09	Gastro-UC und Konsolidierung auf P4 (nicht für erste Demo)	Warten auf Kunden-Input (Kevin) bzw. Prozessverständnis (Lars-Meeting)
2026-04-09	CommCoach-Personas als schnellster Wow-Effekt für PWG priorisiert	Feature ist gebaut; 3–5 Persona-Definitionen im Immobilienkontext genügen

Umsetzungs-Checkliste

Phase 1: Demo-Infrastruktur (Prio: hoch — Grundlage für alle Demos)

Demo-Mandant "Bling Demo" anlegen mit Bexio-Testverbindung
- Trustee-Instanz mit connectorType: bexio
- Workspace-Instanz
- Graph-Editor-Instanz
- 2–3 Demo-User (Admin, Buchhalter, Mandant)
Demo-Mandant "PWG Demo" anlegen (ergänzend zu trustee-tooling-plan Phase 5)
- Trustee-Instanz mit connectorType: abacus
- Workspace-Instanz
- CommCoach-Instanz
- Neutralisierung-Instanz
Demo-Mandant "Quid Demo" anlegen
- Workspace-Instanz
- Graph-Editor-Instanz

Phase 2: Prompt-Templates & Analyse-Flows (Prio: hoch — betrifft alle 3 Kunden)

Prompt-Template: Budget-Vergleich (Soll/Ist)
- Workspace-Datei mit Instruktionen für den Agent
- Schritte: Budget-Excel lesen → Trustee-Daten aggregieren (SUM pro Konto) → Abweichungen berechnen → Chart erstellen → Zusammenfassung
- Testdaten: Budget-Excel mit 10–15 Konten, passend zu Demo-Buchhaltungsdaten
Prompt-Template: KPI-Dashboard / Kennzahlen
- Bruttogewinn, ROI, Gewinnmarge, hälftiger Kapitalverlust, Überschuldungs-Check
- Agent soll mehrere Charts erstellen und kritische Werte highlighten
- Wiederverwendbar für Bling (1.4) und Quid (3.1)
Prompt-Template: Cashflow-Rechnung
- Bilanz + ER aus Trustee → operativer/investiver/finanzieller Cashflow
- Nicht-Cash-Positionen (Abschreibungen) erkennen und bereinigen
- Warnungen bei kritischen Werten
Prompt-Template: Prognose (Trend-Analyse)
- Historische Daten analysieren (6 Monate) → nächste 3 Monate prognostizieren
- Einfache lineare Extrapolation + Saisonalitätshinweis
- Chart mit Ist vs. Prognose
- Für Bling (1.5) und Quid (3.3)
Prompt-Template: Jahresabschluss-Checks
- Saldovalidierung, Vorjahresvergleich, Abgrenzungsbuchungen identifizieren
- Für Bling (1.7)

Phase 3: CommCoach Immobilien-Personas (Prio: hoch — PWG-Demo 16.04)

Persona: Mieter mit Zahlungsrückstand
- Kontext: 3 Monate Mietrückstand, hat Mahnungen erhalten, ist genervt
- Schwierigkeitsgrad: mittel
- Lernziel: Empathisches Einfordern, Zahlungsvereinbarung vorschlagen
Persona: Mieter mit Nebenkostenfragen
- Kontext: Nebenkostenabrechnung erhalten, versteht Positionen nicht, emotional aufgebracht
- Schwierigkeitsgrad: leicht
- Lernziel: Geduldig erklären, auf Rechtsgrundlage verweisen
Persona: Neuer Mieter (Einzugsfragen)
- Kontext: Fragen zu Wohnungsübergabe, Schlüssel, Hausordnung, Kaution
- Schwierigkeitsgrad: leicht
- Lernziel: Willkommenskultur, klare Informationsvermittlung
Persona: Schwieriger Nachbar (Lärmbeschwerde)
- Kontext: Beschwert sich über Lärm, droht mit Mietminderung
- Schwierigkeitsgrad: schwer
- Lernziel: Deeskalation, Mediation anbieten, Rechte und Pflichten
Persona-Seeding in CommCoach onRegister oder als manuelles Setup-Skript

Phase 4: Neutralisierungs-Demo (Prio: hoch — PWG-Demo 16.04)

Fiktives Mieterdossier erstellen (PDF)
- Enthält: Name, Adresse, Mietzins, Zahlungshistorie, Korrespondenz
- Realistisch aber komplett fiktiv (DSGVO-konform)
Demo-Flow dokumentieren
- Original-PDF hochladen → Neutralisierung zeigen (Namen → Platzhalter)
- Neutralisierten Text an AI senden → Analyse erhalten
- Re-Personalisierung demonstrieren
- Optional: Private LLM für sensitive Daten zeigen
Neutralisierungs-Config auf Demo-Instanz konfigurieren und testen

Phase 5: Testdaten & Demo-Skripte (Prio: mittel)

Bling-Testdaten: Bexio-kompatible Buchhaltungsdaten (Journal, Kontoplan, Bilanz/ER)
Bling-Testdaten: Budget-Excel (Soll-Werte 2026 pro Konto)
Bling-Testdaten: 3–5 Musterbelege (Rechnung, Spesenbeleg, Bankbeleg)
PWG-Testdaten: Abacus-kompatible Daten (bereits in trustee-tooling-plan)
Quid-Testdaten: CSV/Excel mit Umsatzdaten (6 Monate), Kundenliste mit Margen, Support-Zeiterfassung
Demo-Skript Bling: Schritt-für-Schritt mit Screenshots/Notizen
Demo-Skript PWG: Schritt-für-Schritt (ergänzend zu trustee-tooling-plan)
Demo-Skript Quid: Schritt-für-Schritt

Phase 6: Quid-spezifisch — Datenanalyse ohne Connector (Prio: mittel)

Demo-Flow: CSV/Excel hochladen → Agent analysiert
- Quid lädt Buchhaltungs-Export (CSV) und Zendesk-Export (CSV) in den Workspace
- Agent liest beide Dateien, verknüpft über Quid-ID / E-Mail
- Berechnet KPIs: Kundenmarge, ACV, Lifetime Value, Support-Kosten pro Kunde
- Erstellt Dashboard-Charts
Prompt-Template: Multi-Source KPI-Analyse
- Instruktionen für den Agent: „Lies die hochgeladenen Dateien, identifiziere gemeinsame Identifier, berechne folgende KPIs..."

Querschnitt-Checks

API-Endpunkte: keine neuen nötig
DB-Schema / Migration: nein
Frontend-Komponenten: nein (separater Plan)
RBAC / Permissions: Demo-User mit passenden Rollen
Neutralisierung betroffen? ja (Phase 4)
Navigation / Routing: nein
Billing-Impact? Demo-Mandanten brauchen ausreichend Guthaben / Trial-Modus

Akzeptanzkriterien

#	Kriterium (Given-When-Then)	Prio	Kunde
1	Given Bling-Demo-Mandant mit Bexio-Daten und Budget-Excel, When der Agent den Budget-Vergleich-Prompt ausführt, Then zeigt er Soll/Ist-Abweichungen pro Konto mit Chart	must	Bling
2	Given Bling-Demo-Mandant, When der Agent den KPI-Dashboard-Prompt ausführt, Then erstellt er mindestens 3 Kennzahlen-Charts (Bruttogewinn, ROI, Gewinnmarge)	must	Bling
3	Given PWG-Demo-Mandant mit CommCoach-Instanz, When ein User eine Coaching-Session mit Persona "Mieter mit Zahlungsrückstand" startet, Then spielt die KI den Mieter realistisch im Immobilienkontext	must	PWG
4	Given PWG-Demo-Mandant mit aktivierter Neutralisierung, When ein fiktives Mieterdossier hochgeladen und analysiert wird, Then werden PII-Daten vor dem LLM-Call neutralisiert und nach der Analyse re-personalisiert	must	PWG
5	Given Quid-Demo-Mandant mit hochgeladenen CSV-Dateien (Buchhaltung + Zendesk-Export), When der Agent die KPI-Analyse ausführt, Then verknüpft er Daten über gemeinsame IDs und erstellt Margen- und Support-Kosten-Charts	should	Quid
6	Given Demo-Mandant mit 2+ Mandaten, When ein Bling-Admin zwischen Mandanten wechselt, Then sieht er jeweils nur die Daten des aktiven Mandanten (Datentrennung funktioniert)	must	Bling
7	Given Cashflow-Prompt und Trustee-Daten, When der Agent die Analyse durchführt, Then berechnet er korrekten operativen Cashflow unter Berücksichtigung von Abschreibungen	should	Bling

Testplan

ID	AC	Art	Automatisiert	Methode	Status
T1	1	e2e	nein	Manuell: Budget-Excel + Trustee-Daten + Agent-Prompt im Workspace	pending
T2	2	e2e	nein	Manuell: KPI-Prompt im Workspace mit Trustee-Daten	pending
T3	3	e2e	nein	Manuell: CommCoach-Session mit Immobilien-Persona starten	pending
T4	4	e2e	nein	Manuell: PDF hochladen → Neutralisierung → Analyse → Re-Personalisierung	pending
T5	5	e2e	nein	Manuell: CSV-Upload → Agent-Prompt → Charts prüfen	pending
T6	6	e2e	nein	Manuell: Mandantenwechsel, Daten prüfen	pending
T7	7	e2e	nein	Manuell: Cashflow-Prompt → Ergebnis gegen manuelle Berechnung prüfen	pending

Abschluss

b-reference/ aktualisiert (ggf. neue Feature-Docs unter b-reference/gateway/features/)
TOPICS.md aktualisiert (falls neues Thema)
Dieses Dokument → z-archive/ verschoben

19 KiB Raw Blame History Unescape Escape