Skip to content

Home

Jump to bottom
ren-AI-ssance® edited this page Jun 8, 2026 · 2 revisions

🚀 Louis Smart CRM

Das intelligente, KI-gestützte Beziehungsmanagement (CRM) mit rechtssicherer, zertifizierter E-Rechnungs-Engine (ZUGFeRD 2.2+ / Factur-X 1.0) nach europäischem Standard (EN 16931).

Louis Smart CRM ist eine hochentwickelte, moderne Fullstack-Anwendung, die ein flexibles Kundenbeziehungsmanagement nahtlos mit autonomer künstlicher Intelligenz (Louis AI) und einer manipulationssicheren, GoBD-konformen Rechnungs-Engine verbindet.

✨ Hauptfunktionen & Highlights

1. 🤖 Louis AI — Der autonome CRM-Copilot

  • State-of-the-Art ReAct Agenten-Loop: Louis AI agiert als vollwertiger Agent, der CRM-Befehle im natürlichen Sprachfluss interpretiert, Daten abfragt, E-Mails entwirft oder Berichte zusammenstellt.
  • Context-Aware Hybrid Search (RAG): Durch eine hochentwickelte Kombination aus geometrischer Vektorsuche (pgvector mit Kosinus-Ähnlichkeit) und klassischem Keyword-Matching liefert Louis AI hochpräzise und kontextbezogene Antworten bezüglich Kunden, Unternehmen und Rechnungsverläufen.
  • Intelligente Fallback-Suche: Ein robuster, In-Memory-Vektoralgorithmus garantiert den vollen Funktionsumfang der KI-Suche auch beim Betrieb außerhalb einer Cloud-Infrastruktur oder im lokalen Testmodus.
  • Louis QA Critic Loop: Bevor KI-generierte Daten oder Finanzentwürfe freigegeben werden, durchlaufen sie eine interne, mathematische und regulatorische Validierungsinstanz:
    • Summenprüfungen auf Cent-Ebene (Netto + USt. = Brutto).
    • Validierung gegen strenge Zod-Schema-Schnittstellen zur Vermeidung von Halluzinationen.

2. 🧾 Zertifizierte E-Rechnungs-Engine (ZUGFeRD / Factur-X)

  • 100% Konformität mit EN 16931: Vollwertige Erstellung von E-Rechnungen, die den gesetzlichen Bestimmungen (ZUGFeRD 2.2+ / Factur-X 1.0) entsprechen – Pflicht für B2B-Umsätze in Deutschland.
  • PDF/A-3b & Mustangproject: Visuell ansprechende Rechnungen kombiniert mit maschinenlesbarem XML-Datenstrom (Factur-X), verschmolzen über eine gehärtete Java-Infrastruktur.
  • Präzise Rundung nach GoBD: Finanzrechtlich einwandfreie Rundungskalkulationen (roundFiscal) verhindern Steuerdifferenzen selbst bei komplexen Misch-Umsatzsteuersätzen oder mehrzeiligen Großrechnungen.
  • B2G-optimierte XRechnung: Integrierte Unterstützung für Rechnungen an Bundesbehörden und öffentliche Auftraggeber inklusive Leitweg-ID.
  • Hermetisch geschlossener Core: Zum Schutz der steuerrechtlichen Zulassung ist die Rechnungs-Erstellungskernschicht (zugferd.ts und pdfHelper.ts) als Read-Only versiegelt, was Regressionsfehler und Sicherheitsverletzungen ausschließt.

3. 👥 Dynamisches Kontakt- & Firmenmanagement

  • Strukturiertes Datenjournal: Ganzheitliche 360-Grad-Ansichten für Unternehmen und Kontaktpersonen inklusive chronologischem Interaktionsverlauf.
  • Massenimport & CSV-Integrität: Intuitive Werkzeuge zur Datenmigration, abgesichert durch automatische Dublettenprüfung und Datenkorrektur bei unvollständigen Postanschriften oder Telefonnummern.
  • Intelligente Assistenten: KI-gestützte Vorlagen-Generatoren für personalisierte Anschreiben, Vertriebse-Mails und Service-Tickets.

4. 🔒 Sicherheit, Transparenz & DSGVO-Compliance

  • Lückenloses Audit-Log: Jeder Datenbankzugriff, jede Statusänderung und jeder KI-Schnittstellenaufruf wird fälschungssicher protokolliert.
  • Datenportabilität: Konforme Ein-Klick-Datenexporte (Download aller personenbezogenen Datensätze als JSON) zur Erfüllung von DSGVO-Auskunftsansprüchen.
  • E-Mail & SMTP Integration: Eigene SMTP-Einstellungen inklusive Test-Werkzeugen für den sicheren, authentifizierten Versand direkt aus dem CRM.
  • Resiliente Datenhaltung: Ein duales Speichersystem sichert den transparenten Umschaltbetrieb zwischen der PostgreSQL-Produktivdatenbank und einer lokalen JSON-Fallback-Datei (.local_fallback_db.json) ohne Datenverlust im laufenden Betrieb.

🛠️ Tech-Stack

Front-End (Client)

  • React 18 mit TypeScript
  • Vite als ultraschnelles Build-Tool (HMR / Produktions-Volloptimierung)
  • Tailwind CSS für ein maßgeschneidertes, hochauflösendes UI-Design mit Fokus auf Typografie und Kontraste
  • Framer Motion für fließende Übergänge und intuitive Micro-Interaktionen
  • tRPC Client für durchgehende, compile-zeitgeprüfte Typensicherheit von der DB bis zum Button Click

Back-End (Server)

  • Node.js mit Express
  • tRPC Server zur Realisierung typsicherer Schema-API-Schnittstellen
  • @google/genai SDK zur Steuerung von Gemini-Modellen auf Enterprise-Niveau
  • Mustangproject CLI & pdf-lib zur standardisierten Erzeugung valider XMP/Metadata PDF/A-3b Hybriddateien

Datenhaltung & Infrastruktur

  • PostgreSQL (mit pgvector für die semantische KI-Suche)
  • Local JSON Fallback DB für unterbrechungsfreie Entwicklungsumgebungen und Offline-Szenarien
  • Docker & Docker-Compose: Minimalisiertes, headless Java JRE Container-Image zur reibungslosen, systemunabhängigen Rechnungsgenerierung

🏗️ Systemarchitektur (High-Level)

                       ┌──────────────────────────────────────┐
                       │           React Client (UI)          │
                       └──────────────────┬───────────────────┘
                                          │ (Typstarke tRPC-Requests)
                                          ▼
                       ┌──────────────────────────────────────┐
                       │          Express tRPC-Server         │
                       └─────┬──────────────────────────┬─────┘
                             │                          │
                             ▼                          ▼
               ┌───────────────────────────┐      ┌─────────────┐
               │ Louis AI Orchestrator     │      │ DB-Router   │
               │ (ReAct Loop & QA Critic)  │      │ & Fallback  │
               └─────────────┬─────────────┘      └──────┬──────┘
                             │                           │ (Dual-Write)
                             ▼                           ▼
                       [ LLM API ]               [(PG / Local JSON)]

📦 Erste Schritte

Voraussetzungen

  • Node.js (v18+)
  • Java Runtime (JRE 17+, wird für das Rechnungs-Rendering über Mustangproject benötigt)
  • Optional: Docker & Docker-Compose

Installation

  1. Repository klonen und Abhängigkeiten installieren: 
    npm install
  2. Kopiere die Datei .env.example nach .env und trage deine API-Schlüssel ein (z.B. GEMINI_API_KEY).
  3. Starte den Entwicklungsserver im lokalen Modus: 
    npm run dev
    Das CRM schaltet bei fehlender PostgreSQL-Verbindung automatisch auf den sicheren .local_fallback_db.json Modus um.

Produktions-Build

Erstellt eine optimierte Variante des Frontends und kompiliert den Express-Server in ein optimiertes CommonJS-Bündel:

npm run build

📋 Lizenz & Compliance-Hinweis

Das System respektiert die deutschen Rechnungslegungsstandards nach GoBD und EN 16931. Bitte beachte, dass Modifikationen an den Dateien im Verzeichnis src/lib/zugferd.ts und src/server/pdfHelper.ts die Validität der erzeugten E-Rechnungen unbrauchbar machen und zur Folge haben können, dass die erzeugten Dokumente im steuerrechtlichen Sinne nicht mehr anerkannt werden.

⚖️ Open-Source-Lizenzierung (GPLv3)

Louis Smart CRM ist freie Software und wird unter den Bedingungen der GNU General Public License, Version 3 (GPLv3) veröffentlicht.

  • Lizenzgeber & Copyright-Inhaber: ren-AI-ssance® — info@ren-ai-ssance.de
  • Bedingungen: Sie dürfen dieses Programm weiterverbreiten und/oder modifizieren unter Beachtung der GPLv3-Bestimmungen. Eine Kopie der Lizenz finden Sie in der beiliegenden Datei LICENSE im Root-Verzeichnis dieser Software.

📦 Drittanbieter-Lizenzen (Credits)

Um die vollständige Gesetzeskonformität herzustellen, stützt sich dieses System auf bewährte Open-Source-Kernkomponenten:

  1. Mustangproject Library (CII/Factur-X):
  2. pdf-lib:
    • Funktion: Dynamische PDF layout-Zeichnung und visuelle Tabellenerstellung.
    • Lizenz: MIT License
    • Urheber: Andrew Dillon & pdf-lib Contributors — pdf-lib.js.org

ren-AI-ssance®

Clone this wiki locally