Louis Smart CRM – Version 1.0.1 (New Features, Bugfixes)

🚀 Release v1.0.1: MCP Integration, Telegram Bot Gateway & Intelligente Workflow-Trigger

Wir freuen uns, euch heute das erste offizielle Update von Louis Smart CRM vorstellen zu dürfen! Neben wichtigen Stabilitäts-Optimierungen und Bugfixes in den Bereichen Workflows, Session-Management und E-Rechnungen haben wir mächtige neue Kernfunktionen implementiert, die das CRM noch intelligenter, flexibler und mobiler machen.

---

🛠️ 1. Optimierungen & Bugfixes

🌐 Internationalisierung (i18n)

• 100% Übersetzungsstatus: Die Lokalisierung für die Sprachen Deutsch und Englisch wurde vollständig finalisiert.
• Begriffskonsistenz: Interne Bezeichnungen und Benennungen in der UI wurden systemweit vereinheitlicht.

🧾 Rechnungen & Belege

• 0% Umsatzsteuer-Support: Ein Fehler wurde behoben, der zuvor bei der Erstellung von steuerfreien Rechnungen (0% USt.) eine Fehlermeldung auslöste. Diese können ab sofort reibungslos und GoBD-konform generiert werden.
• Erweitertes Rechnungslayout: Das Rechnungslayout wurde um das dynamische Feld „Kundenbezeichnung“ erweitert.
• UI-Polishing: Kleinere visuelle Darstellungsfehler im Rechnungsmodul wurden beseitigt.

🔑 Login & Session-Management

• Sicherer Logout: Es wurde ein Edge-Case behoben, bei dem es im Abmeldevorgang in seltenen Fällen zu Datenbankkonflikten mit der USER ID kam. Sessions werden nun sauber terminiert.

---

✨ 2. Neue Funktionen & Highlights

🔌 1. Model Context Protocol (MCP) Integration

Mit der Implementierung des modernen Model Context Protocol (MCP) öffnet sich Louis Smart CRM für externe KI-Ökosysteme.

• Asynchrone SSE-Architektur: Ein maßgeschneiderter MCP-Server ist direkt in das Express-Backend integriert und kommuniziert ressourcenschonend via Server-Sent Events (SSE).
• Standardisiertes JSON-RPC 2.0: Befehle, Initialisierungen und Werkzeugaufrufe (tools/list, tools/call) laufen über ein standardisiertes Protokoll.
• Kompatibilität mit externen Clients: Ermöglicht es Editoren und Clients wie Claude Desktop, Cursor oder Windsurf, direkt über natürliche Sprache auf CRM-Werkzeuge zuzugreifen.
• Sicherheitskonzept (Human-in-the-Loop): Über das MCP generierte Entitäten (Kontakte, Firmen, Belege) verbleiben stets im Status draft (Entwurf) und erfordern eine manuelle Freigabe im CRM-Adminbereich.

✈️ 2. Lokale Telegram Bot Anbindung (Conversational Co-Pilot)

Steuert euer CRM ab sofort direkt von unterwegs über das Smartphone – ganz ohne mobile Weboberfläche!

• Echte Konversation statt Befehle: Dank des integrierten ReAct-Agentenloops (Reasoning + Acting) versteht Louis freie deutsche Textanweisungen. Ihr könnt Daten suchen, Umsatzanalysen anfordern oder Rechnungsentwürfe erstellen.
• Zero-Trust Zugriffskontrolle: Nur explizit im Administrationspanel freigeschaltete, numerische Telegram-IDs erhalten Zugriff, während unbefugte Anfragen sofort blockiert werden.
• Lokaler Transport & DSGVO-Konformität: Die Übertragung läuft vollständig verschlüsselt zwischen eurem lokalen Host/Docker-Container und der offiziellen Telegram API ohne externe Proxy-Server der Entwickler.
• Transparente Auditierung: Jeder Zugriff und jede Aktion über Telegram wird namentlich und revisionssicher im CRM-Audit-Log protokolliert.

⚡ 3. Erweiterte automatisierte Workflows & Intelligente Trigger

Die Workflow-Engine (src/server/ai/workflowEngine.ts) wurde massiv aufgewertet, um repetitive Geschäftsprozesse vollautomatisch im Hintergrund abzuarbeiten.

• Drei Workflow-Arten: Unterstützung von manuellen (MANUAL), ereignisgesteuerten (CRM_EVENT) und zeitgesteuerten (TIMER / Cron-System) Auslösern.
• Vier neue, intelligente System-Trigger:
  • 🟢 invoice.paid: Zündet sofort, wenn der Zahlungseingang registriert und die Rechnung als "bezahlt" gebucht wird (z. B. für automatischen Mail-Versand).
  • 🔴 invoice.overdue: Ein Hintergrund-Scheduler prüft kontinuierlich Fälligkeiten und stößt beim Überschreiten des due_date automatisch den Mahnlauf-Entwurf an.
  • 👥 contact.updated & 🏢 company.updated: Reagiert in Echtzeit auf Stammdatenänderungen zur Absicherung von Konsistenzprüfungen und Audit-Logs.
• Idempotency Guard (Doppel-Ausführungsschutz): Ein zweistufiges Schutzsystem (In-Memory-Sliding-Window für 15 Sekunden + Datenbank-Audit vor dem Start) verhindert zuverlässig Race Conditions und Mehrfachausführungen (z. B. doppelte Mahnungs-Mails).
• Resiliente Fehlerbehandlung: Sollte ein Einzelschritt (z. B. wegen eines SMTP-Timeouts) fehlschlagen, wechselt die Instanz kontrolliert in den Zustand FAILED und dokumentiert die exakte Ursache im execution_log.

---

Louis Smart CRM – Version 1.0.0 (Initial Release)

Wir freuen uns, die allererste stabile Version von Louis Smart CRM zu veröffentlichen! Dieses Release liefert ein intelligentes, typsicheres und vollständig gesetzeskonformes CRM-System für den modernen B2B- und B2G-Geschäftsverkehr. Louis SMART CRM wurde speziell für für Solo-Selbstständige, Gründer, Kleinunternehmen und Mini-Teams entwickelt.

Sichere und rechtskonforme Rechnungen nach europäischen Norm EN 16931, des ZUGFeRD-Standards (2.2+) / Factur-X 1.0 und der deutschen XRechnung 3.0 (inklusive Leitweg-ID-Validierung für Behörden).

🌟 Die Highlights dieses Releases

1. 📊 Echtzeit-Controlling-Dashboard (Bento-Grid)

• Umsatz-Uhr & Fälligkeits-Radar: Interaktive Finanzdiagramme (Recharts/D3) zur sofortigen Visualisierung gebuchter Umsatzerlöse und zur Einteilung von Rechnungen nach Fälligkeit (Zahlungsziel vs. Mahnstufen).
• System-Status-Monitor: Direkte Live-Rückmeldung über den technischen Zustand der Infrastruktur (Datenbank-Modus, SMTP-Schnittstelle und Audit-Logs).

2. 🤖 Louis AI Copilot (Human-in-the-Loop)

• Autonomer ReAct-Agentenloop: Steuerung des gesamten CRM über natürliche Sprache basierend auf Googles Gemini-Modellen.
• Sicherheits-Guardrail: Die KI agiert rein entwurfsbasiert. Alle vorgeschlagenen Änderungen werden im proposedChanges-Panel gelistet und erst nach expliziter menschlicher Freigabe gebucht oder versendet.
• QA-Critic-Layer: Automatische, programmgestützte Plausibilitätsprüfung zur Vermeidung von Berechnungsfehlern und Halluzinationen vor dem Datenexport.

3. 🧾 Rechtssichere E-Rechnungs-Engine

• Volle Compliance: Vollständige Erfüllung aller gesetzlichen Anforderungen der europäischen Norm EN 16931, des ZUGFeRD-Standards (2.2+) / Factur-X 1.0 und der deutschen XRechnung 3.0 (inklusive Leitweg-ID-Validierung für Behörden).
• Hybrid-Verschmelzung: Kombination des visuellen PDF-Layouts (pdf-lib) mit dem maschinenlesbaren XML-Datenstrom zu einer manipulationssicheren PDF/A-3b Hybriddatei via Mustangproject CLI.
• Finanzamtskonforme Rundung: Implementierung einer GoBD-konformen roundFiscal-Logik auf Positionsebene zur Vermeidung von Fließkommadifferenzen.

4. 💾 Duales Speicherkonzept (Maximale Resilienz)

• Produktivbetrieb: Hochperformanter Zugriff auf eine PostgreSQL-Datenbank mit aktivierter pgvector-Erweiterung für semantische KI-Ähnlichkeitssuchen.
• Offline-Fallback: Automatisches und geräuschloses Ausweichen auf ein lokales In-Memory-Dateisystem (.local_fallback_db.json) bei fehlender DB-Verbindung.

🔒 5. Sicherheit, Transparenz & DSGVO

• Unveränderbares Audit-Log: Lückenlose, revisionssichere Append-Only-Aufzeichnung aller sensiblen Nutzeraktionen und autonomen KI-Schritte.
• DSGVO-Datenportabilität: Automatisierter 1-Klick-Export aller personenbezogenen Daten als strukturiertes JSON/ZIP-Archiv (Art. 20 DSGVO).
• Intelligentes Löschkonzept: Physische Löschung von Kontakten (Art. 17 DSGVO) unter strikter Einhaltung der gesetzlichen 10-jährigen GoBD-Aufbewahrungsfrist für bereits geschriebene Rechnungsdaten.

---

🛠️ Technische Voraussetzungen

• Node.js: Version 18.x oder höher (empfohlen v20.x LTS).
• Java Runtime Environment (JRE): JRE 17 oder höher (globaler java-CLI-Pfad für das Mustangproject-Modul).
• Datenbank: Eine laufende PostgreSQL-Instanz (v14+ mit pgvector) oder direkter Start über das integrierte lokale JSON-Fallback-System.

📦 Installations-Quickstart

# 1. Abhängigkeiten installieren
npm install

# 2. Entwicklungsumgebung starten (nutzt standardmäßig Port 3000)
npm run dev

# 3. Docker-Compose (vorkonfiguriert inkl. PostgreSQL + pgvector)
docker-compose up --build -d