Woehrle Stack — Zettle + Lexware Office XL + OWUI auf Hetzner

Ziel

Komplett-Stack fuer Weinhandel mit Weingalerie (Event-Location fuer Weinproben): Buchhaltung + TSE-Kasse + Lager + Ticketsystem + KI-Chat-Layer, alles auf Hetzner, 200 EUR/Monat brutto Endkundenpreis. Greenfield-Setup — Woehrle hat aktuell weder lexoffice noch Kasse noch OWUI.

Stack-Entscheidungen (nach 3 Recherche-Passes verfestigt)

Wo stehen wir gerade?

• Recherche abgeschlossen (3 Passes: POS, Buchhaltung, Buchhaltungs-API-Quality fuer MCP-Bau) — Stack-Entscheidungen verfestigt
• Plan-Dokument geschrieben: plan
• Kundenseite (Discovery + Vertrieb) liegt bei Alex — wir auf Technik-Track
• Naechster technischer Schritt: mcp-zettle + mcp-lexware Live-Test gegen echte API-Accounts. Beide Skeletons stehen (2026-05-18), 6+16=22 Tools registriert.

Naechste Meilensteine (Technik-Track)

• ⏳ mcp-zettle v0.1 (Read-Layer, 6 Tools) — siehe unit-13-mcp-zettle-eigenbau-v01-read-layer
• ⏳ mcp-lexware-office v2 Write-CRUD-Erweiterung — siehe unit-14-mcp-lexware-office-v2-write-erweiterung-crud
• ⏳ hi.events lokal in Docker testen (Reife-Check) + AGPL-Lizenz-Check parallel
• ⏳ OWUI-MVP-Demo gegen Test-Daten — siehe unit-15-voit-mvp-demo-gegen-test-daten
• ⏳ Hetzner-Projects anlegen (av-woehrle + av-events) — Phase-2-Start
• ⏳ mcp-hi-events Eigenbau (nach AGPL-OK) — Phase 2

Discovery-Inputs die wir von Alex brauchen (fuer Build-Entscheidungen)

• Wein-SKU-Anzahl — bei >500 muessen wir Zettle-Inventory-Limits beachten
• Event-Format — Online-VVK vs Tageskasse entscheidet hi.events-Setup-Tiefe
• Steuerberater + DATEV-Workflow — bestaetigt Lexware-Wahl
• Hardware-Bestand — bestehende Tablets/iPads/Bondrucker oder Neukauf
• Champion-Person bei Woehrle — wer wird geschult und ist Monats-Review-Kontakt

Wichtige Links

• Kunde: woehrle
• Plan: plan
• Pattern Festpreis: festpreis-phase1-notausgang
• MCP-Eigenbau-Skill: SKILL
• Hetzner-Projects-Pattern: projects
• Bestehender MCP (Read-only): lexware + mcp-lexware-office
• OWUI-Repo: ~/source/apps/open-webui-vf/ (Pattern-Vorlage)
• mcp-vf-hosted-Pattern (analoge Architektur fuer Custom Connector): mcp-vf-hosted

Risiken / offene Fragen

• TSE-Pflicht nach KassenSichV § 146a AO — Zettle hat Cloud-TSE nativ, also gedeckt. Aber: ELSTER-Meldung-Pflicht ab 2025 — Woehrle muss Kasse + TSE bei Finanzamt registrieren, Zustaendigkeit klaeren im Discovery.
• hi.events AGPL-3.0-Lizenz-Check — Phase-1-Blocker fuer Pfad A. Network-Use-Clause kann SaaS-Anbieten an Kunden problematisch machen. Vor Phase 2 mit hi.events-Devs klaeren. Fallback Cal.com (mcp-calcom ist live) ohne Verzoegerung.
• Ticketsystem-Pfad-Entscheidung im Discovery feinjustieren — Pfad A (hi.events Multi-Tenant) ist Default, Pfad B (Cal.com) bei AGPL-Blocker, Pfad C (Zettle-Artikel) wenn Woehrle nur Tageskasse-Verkauf will.
• Wein-SKU-Anzahl unbekannt — bei >500 SKUs koennte Zettle-Inventory eng werden. Im Discovery klaeren.
• Steuerberater-Bindung — wenn Woehrles Steuerberater nicht mit Lexware-DATEV-Export arbeitet, muss alternativer Workflow gefunden werden. Im Discovery klaeren.
• Phase-1-Notausgang verbindlich machen — nach 4 Wochen muss OWUI-Demo gegen Zettle-Test-Account und Lexware-Sandbox laufen, sonst zahlt Woehrle nur Phase-1-Pauschal.

Verworfene Optionen (Audit-Trail)

• Odoo CE self-hosted auf Hetzner: nicht GoBD-zertifiziert, keine fertige TSE-Anbindung, Setup-Kosten 3-8k EUR einmalig + 50 EUR/Monat. Teurer als 5 Jahre lexoffice. Bastelei mit Restrisiko.
• Stripe Terminal: keine TSE in DE.
• SumUp: Self-Service ja, aber API ist Payment-API, keine Product/Inventory-Endpoints fuer OWUI.
• Tillhub: Signup-Flow leitet auf Sales-Demo, kein transparenter Preis.
• collmex: UI von 2008 — Endkunden-Tauglichkeit nicht gegeben (auch wenn API-API-API gut waere).
• Pennylane: modernste API der Liste, aber DE-Markt-Eintritt erst Nov 2025, keine DATEV-Kanzlei-Bruecke. Beobachten fuer 2027.
• Ticketsystem-Eigenbau: 5-9 TW Setup + dauerhafte Wartung — klassisches „Marvin baut das selber”-Antipattern. Verworfen zugunsten hi.events Self-Host.
• Pretix self-hosted: Python/Django-Stack OK, aber kein One-Click-Deploy, kein Multi-Tenant von Tag 1. Verworfen zugunsten hi.events.
• TicketPAY fuer Woehrle: Gebuehr pro Ticket waere Margen-Killer bei kleinen Events. Bestehender MCP bleibt fuer andere Use-Cases relevant.

Token-Hygiene

• Zettle API-Key, Lexware OAuth-Credentials, Hetzner-Token, CF-Token: ALLE in ~/.config/op/ (1Password) oder Hetzner-Project-Env. NIE im Vault.
• AVV/DSGVO-Doku mit Woehrle vor Live-Gang abschliessen — Daten gehoeren Woehrle.

Notizen

• Erstes Wein-Vertical-Setup in unserem Portfolio — Patterns die hier entstehen wandern in intern/wissen/patterns/weinhandel-stack-pattern.md (entstehen NACH Live-Gang, nicht vorab spekulieren).
• mcp-zettle wird Standard-Stack-Layer — vorgesehen fuer naechste Retail-/Gastro-Kunden mit Zettle, nicht Woehrle-spezifisch.
• mcp-lexware-office v2 (Write-CRUD) wird Standard-Stack-Layer — relevant fuer alle KMU-Kunden mit lexoffice. Aufwand-Investition zahlt sich beim zweiten Kunden aus.
• hi.events als „App-as-a-Service”-Capability analog zu open-webui-vf — Multi-Tenant-Plattform die ab Kunde 2 mit Event-Bedarf null-Aufwand-Onboarding ermoeglicht (Organizer-Account in <30 Min). Eigenes Hetzner-Project av-events, nicht in Woehrle-Stack vermischt.
• mcp-hi-events komplettiert das Standard-Stack-Layer-Triple fuer KMU-Retail-Bundle (Zettle + Lexware + hi.events).