Häufig gestellte Fragen

Allgemein

Was ist QuoteNode?

QuoteNode ist eine self-hosted CRM- und Angebotsplattform für B2B- und B2C-Vertriebsteams. Sie bietet Kundenverwaltung, professionelle Angebotserstellung, gebrandete PDF-Erzeugung, nachverfolgbare öffentliche Links und Vertriebsanalysen — alles auf Ihrer eigenen Infrastruktur.

Für wen ist QuoteNode gedacht?

QuoteNode ist für Freelancer, Berater, kleine Agenturen und mittelständische Unternehmen konzipiert, die Angebote für Kunden erstellen und versenden. Besonders gut passt es zu Organisationen, die Datenhoheit, gebrandete Kundendokumente und einen strukturierten Vertriebsprozess benötigen.

Worin unterscheidet sich QuoteNode von SaaS-CRM-Plattformen?

QuoteNode ist self-hosted und single-tenant. Ihre Daten bleiben auf Ihrem Server. Es gibt keine gemeinsam genutzte Datenbank, keinen Vendor Lock-in, keine monatlichen Abogebühren und keine Abhängigkeit von externen Diensten. Sie kontrollieren die Infrastruktur, die Backups und den Zugriffsperimeter.

Bereitstellung und Infrastruktur

Was brauche ich, um QuoteNode zu betreiben?

Einen Server mit Docker Engine 24.0+, 2 GB RAM (4 GB empfohlen) und einer SSD mit mindestens 10 GB freiem Speicherplatz. QuoteNode wird als Docker-Container ausgeliefert und per Docker Compose bereitgestellt.

Kann ich QuoteNode zu Testzwecken auf meinem Laptop ausführen?

Ja. Das Docker-Compose-Setup funktioniert auf jeder Maschine mit installiertem Docker — Linux, macOS oder Windows (WSL2). So evaluieren die meisten Nutzer QuoteNode vor der Produktivbereitstellung.

Benötigt QuoteNode Internetzugang?

Nein. QuoteNode arbeitet vollständig offline. Keine Telemetrie, keine Analytics-Callbacks, kein externer Lizenzserver. Ausgehende Verbindungen entstehen nur dort, wo Sie sie ausdrücklich konfigurieren (SMTP für E-Mail-Versand und optional Quellen für Wechselkurse).

Kann ich QuoteNode hinter einer Unternehmens-Firewall betreiben?

Ja. QuoteNode ist für air-gapped und restriktive Netzwerkumgebungen ausgelegt. Es gibt keine externen Runtime-Abhängigkeiten.

Welche Datenbank verwendet QuoteNode?

PostgreSQL 16 oder neuer. Das ist die einzige unterstützte Datenbank-Engine. Die PostgreSQL-Instanz läuft als Container neben der Anwendung.

Lizenzierung und Preise

Ist QuoteNode wirklich kostenlos?

Die Freelancer Edition ist dauerhaft kostenlos und erfordert keine Kreditkarte. Sie enthält alle Kernfunktionen — Angebotserstellung, PDF-Generierung, öffentliche Links, Kundenverwaltung und Analysen — für bis zu 3 Benutzer. Die einzige Einschränkung ist ein “Powered by QuoteNode”-Badge auf öffentlichen Angebotsseiten und in PDFs.

Was beinhaltet die kostenpflichtige Lizenz?

Kostenpflichtige Editionen (Pro, Business, Enterprise) bieten höhere Benutzerlimits, White-Label-Fähigkeit (Entfernen des “Powered by”-Badges), erweiterte Vorlagen, priorisierten Support und SLA-Zusagen. Details finden Sie auf der Seite Preise.

Wie funktioniert die Lizenzierung technisch?

QuoteNode verwendet mit Ed25519 signierte Lizenzdateien, die vollständig offline verifiziert werden. Es wird kein externer Server kontaktiert. Kostenpflichtige Lizenzen sind jährlich — wenn eine Lizenz abläuft, funktionieren alle Funktionen normal weiter. Die einzige Änderung ist ein “Powered by QuoteNode”-Badge auf kundenorientierten Flächen und eine kleine Erinnerung in der UI. Keine Sperren, kein Read-only-Modus, keine deaktivierten Funktionen.

Was passiert, wenn ich meine Lizenz nicht verlängere?

Nichts geht kaputt. Ihre Instanz läuft mit voller Funktionalität weiter. Die jährliche Gebühr unterstützt die Weiterentwicklung — sie ist kein Kill-Switch. Wenn Sie bereit sind, verlängern Sie, um das Badge zu entfernen. Wenn Sie in einem Jahr sparen müssen, ist das völlig in Ordnung.

Kann ich später von Freelancer auf Pro upgraden?

Ja. Sie können jederzeit durch Einspielen einer neuen Lizenzdatei upgraden. Eine Datenmigration oder Neuinstallation ist nicht erforderlich.

Angebote und Workflow

Wie lange dauert es, ein Angebot zu erstellen?

Die meisten Angebote lassen sich in 2 bis 5 Minuten erstellen. Wählen Sie einen Kunden, fügen Sie Produkte aus Ihrem Katalog hinzu (mit automatischen Preisregeln), konfigurieren Sie die Vorlage und versenden Sie das Angebot. Das System übernimmt MwSt.-Berechnungen, Währungsumrechnung und PDF-Erzeugung automatisch.

Können meine Kunden Angebote ansehen, ohne ein Konto anzulegen?

Ja. Jedes Angebot kann über einen öffentlichen Link geteilt werden. Der Kunde sieht eine vollständig gebrandete, responsive Seite und kann annehmen, antworten oder ablehnen — ohne Registrierung.

Werden Angebote nachverfolgt?

Ja. Das System verfolgt, wann ein Kunde den öffentlichen Link öffnet, das PDF herunterlädt, antwortet, annimmt oder ablehnt. Auf der Angebotsdetailseite sehen Sie Öffnungsanzahl, Zeitstempel und das Land des Kunden (via GeoIP).

Kann ich Angebote in mehreren Währungen erstellen?

Ja. QuoteNode unterstützt mehrere Währungen mit automatischer Wechselkursumrechnung. Sie können pro Angebot eine andere Währung festlegen. Pipeline-Berichte rechnen alle Werte in Ihre Basiswährung um.

Was passiert, wenn ein Angebot abläuft?

Der Angebotsstatus wechselt zu “Abgelaufen”, und der öffentliche Link zeigt einen Ablaufhinweis an. Sie können das abgelaufene Angebot mit einem Klick klonen und eine neue Version mit neuer Gültigkeitsdauer erzeugen.

Sicherheit

Wie werden Kundendaten auf öffentlichen Links geschützt?

Öffentliche Links verwenden kryptografisch zufällige 256-Bit-Token. In der Datenbank wird nur der SHA-256-Hash gespeichert. Links können mit Passwort geschützt, rate-limitiert und jederzeit widerrufen werden. Bot-Erkennung verhindert automatisierten Missbrauch.

Hat QuoteNode einen Audit-Trail?

Ja. Jede Mutation im System wird in einem append-only Audit-Log erfasst: wer was wann und von welcher IP-Adresse geändert hat. Das Log ist unveränderlich — Einträge können selbst von Administratoren weder bearbeitet noch gelöscht werden.

Unterstützt QuoteNode Zwei-Faktor-Authentifizierung?

Ja. TOTP-basierte Zwei-Faktor-Authentifizierung wird für alle Benutzer unterstützt und kann für Administratoren erzwungen werden.

Daten und Backups

Wie werden Backups gehandhabt?

QuoteNode enthält ein integriertes Backup-System. Ein dedizierter Backup-Worker führt einen geplanten Job aus (standardmäßig täglich um 2:00 Uhr), der einen vollständigen Datenbank-Dump erstellt und alle hochgeladenen Dateien sowie generierten PDFs archiviert. Backups werden lokal gespeichert und optional per rclone in einen Remote-Speicher hochgeladen.

Kann ich ein Backup auf meinen Computer herunterladen?

Ja. Administratoren können Backup-Archive direkt aus dem Admin-Panel herunterladen (Einstellungen > Backup). Klicken Sie beim jeweiligen erfolgreichen Backup-Eintrag auf die Download-Schaltfläche.

Kann ich meine Backups verschlüsseln?

Ja. Setzen Sie die Umgebungsvariable BACKUP_GPG_RECIPIENT auf eine GPG-Key-ID. Sowohl der Datenbank-Dump als auch das Dateiarchiv werden vor der Speicherung verschlüsselt. Das ist insbesondere dann zu empfehlen, wenn Backups in Cloud-Speichern von Drittanbietern liegen.

Wie stelle ich ein Backup wieder her?

Verwenden Sie das im Repository enthaltene Skript restore.sh. Für eine bestehende Installation führen Sie ./restore.sh backup-datei.tar.gz aus. Für einen frischen Server (Disaster Recovery) führen Sie ./restore.sh --fresh-install backup-datei.tar.gz aus. Das Skript übernimmt Datenbank-Restore, Dateiwiederherstellung und das Starten der Anwendung automatisch. Die vollständige Anleitung finden Sie im Backup & Recovery Wiki.

Was passiert, wenn ich Backups vergesse?

Wenn automatische Backups aktiviert sind (empfohlen), sichert das System täglich ohne manuelles Eingreifen. Das Admin-Panel zeigt eine Warnung an, wenn in den letzten 48 Stunden kein erfolgreiches Backup aufgezeichnet wurde. Sie können außerdem jederzeit manuell ein Backup im Admin-Panel auslösen.

Wie lange werden Backups aufbewahrt?

Standardmäßig werden die 7 zuletzt erfolgreichen Backups lokal aufbewahrt. Ältere Dateien werden nach jedem erfolgreichen Backup automatisch gelöscht. Für Remote-Backups (über rclone hochgeladen) gelten die Lifecycle-Regeln Ihres Speicheranbieters.

Technisch

Welchen Technologie-Stack verwendet QuoteNode?

Backend: Java 25 mit Spring Boot 4. Frontend: Vue 3 mit Vite, PrimeVue 4 und Tailwind CSS 4. Datenbank: PostgreSQL 16. PDF-Generierung: Gotenberg (Chromium-basiert). Reverse Proxy: Caddy 2 mit automatischem HTTPS.

Wie werden Datenbank-Migrationen gehandhabt?

QuoteNode verwendet Flyway für das Schema-Management. Migrationen laufen automatisch beim Start des Backends. Bestehende Migrationen werden nie verändert — Schemaänderungen sind immer additiv.

Kann ich die PDF-Vorlage für Angebote anpassen?

Ja. Das Vorlagensystem unterstützt konfigurierbare Spalten (SKU, Bilder, Beschreibungen, Rabatte), mehrere Preis-Darstellungsmodi (Netto/Brutto/komplette Aufschlüsselung), Produktbilder, eigene Geschäftsbedingungen und das Branding Ihres Unternehmens.

Wie funktioniert die PDF-Generierung?

Das Backend rendert ein HTML-Dokument aus dem Angebots-Snapshot mit Thymeleaf-Vorlagen und sendet es anschließend an Gotenberg (einen Chromium-basierten Container) zur Umwandlung in ein druckfertiges PDF. Kleine Angebote werden synchron erzeugt (unter 3 Sekunden); große Angebote nutzen asynchrone Hintergrundverarbeitung mit Benachrichtigung bei Fertigstellung.