Files
HiveGrid-Wireframes/hivegrid-cloud/_bmad-output/pflichtenheft/blocks/block2.md
T

48 KiB
Raw Blame History

Block 2: Stammdaten

Diese vier Module verwalten die Stammdaten, mit denen Geerkens täglich arbeitet: Kontakte, Firmen, eingehende Anfragen (Leads), Dateien, und die globale Suche, die alles auffindbar macht.


Modul 1: CRM-Kern (Kontakte und Firmen)

Was es tut: Zentrale Verwaltung aller Personen und Firmen, mit denen Geerkens zu tun hat, Kunden, Interessenten, Lieferanten, Partner. Jeder Kontakt und jede Firma hat eine eigene Detail-Seite mit Stammdaten, Notizen, Verknüpfungen zu Angeboten und Projekten und einem chronologischen Verlauf aller Aktivitäten. Löst ab: HubSpot CRM (Kontakte- und Firmen-Bereich). Warum es wichtig ist: Der CRM-Kern ist das Fundament, fast alle anderen Module (Angebote, Projekte, Aufträge, Termine, Dateien) verlinken auf Kontakte oder Firmen. Wenn das schief liegt, kippt der Rest.

1.1 Was zu einem Kontakt gespeichert wird

1.1.1 Pro Person wird gespeichert: Anrede, Titel, Vor- und Nachname (Pflicht), eine oder mehrere Email-Adressen mit Typ (privat/geschäftlich/Rechnung), eine oder mehrere Telefonnummern mit Typ, Adresse (Straße, PLZ, Ort, Land), Geburtstag (optional), Notizen als Freitext, bevorzugte Sprache für Mails (Deutsch oder Englisch), Hauptverantwortlicher Mitarbeiter, Quelle (woher kam der Kontakt, Formular, Mail, WhatsApp, Telefon, manuell, Import, Empfehlung), Kennzeichen "Privatkunde oder Geschäftskontakt". 1.1.2 Mehrere Email-Adressen und Telefonnummern pro Person sind möglich. Eine kann als Primär-Adresse markiert werden, die wird in Listen und beim Anschreiben automatisch verwendet. 1.1.3 Ein Kontakt kann mit mehreren Firmen verknüpft sein (z.B. Geschäftsführer von Firma A und Beirat von Firma B). Pro Verknüpfung wird die Rolle dort hinterlegt (Geschäftsführer, Hausmeister, Bauherr, ...) und welche Firma die Hauptzugehörigkeit ist. 1.1.4 Tags (frei vergebbare Schlagworte mit Farbe, z.B. "VIP", "Bestandskunde", "Wartungsvertrag") können beliebig hinzugefügt werden. 1.1.5 Branchen-Standard-Felder werden beim Anlegen eines neuen Workspace automatisch eingerichtet: für SHK-Betriebe sind das z.B. "Heizungsanlage Hersteller", "Heizungsanlage Modell", "Letzte Wartung" (Datum), "Wartungsvertrag" (Ja/Nein). Diese Liste ist anpassbar. 1.1.6 Kontakte können archiviert werden (verschwinden aus Listen, bleiben aber gespeichert) und später wieder aktiviert werden. Endgültiges Löschen ist nur durch Admins möglich, mit Klartext-Warnung über alle bestehenden Verknüpfungen.

1.2 Was zu einer Firma gespeichert wird

1.2.1 Pro Firma wird gespeichert: Firmenname (Pflicht), Rechtsform (GmbH, AG, Einzelunternehmer, GbR, UG, ...), USt-Identifikationsnummer und Steuernummer, Branche, Webseite, Standort-Adresse, Notizen, Hauptverantwortlicher Mitarbeiter. 1.2.2 An jeder Firma hängen die verknüpften Kontakte mit ihrer Rolle, ein primärer Ansprechpartner kann markiert werden. 1.2.3 Firmen haben dieselben Möglichkeiten wie Kontakte: Tags, eigene Branchen-Standard-Felder (z.B. "Anzahl Anlagen", "Vertragsklasse Standard/Premium/Custom"), archivierbar.

1.3 Eigene Felder pro Workspace

1.3.1 Workspace-Admins können eigene Felder anlegen und unterschiedlich für Kontakte, Firmen und Leads konfigurieren. Verfügbare Feld-Typen: Text, Zahl, Datum, Auswahl-Liste mit fester Optionen-Liste, Mehrfach-Auswahl, Ja/Nein-Schalter, URL, Email-Adresse. 1.3.2 Pro eigenem Feld ist einstellbar: Beschriftung, Hilfetext (erscheint als Tooltip), Pflichtfeld ja/nein, Reihenfolge in der Anzeige. 1.3.3 Eigene Felder können archiviert werden, die bisher eingegebenen Werte bleiben erhalten, das Feld wird nur ausgeblendet. Sie können auch endgültig gelöscht werden, mit Klartext-Warnung über die Anzahl betroffener Einträge. 1.3.4 Eigene Felder können in den Listen-Ansichten als Spalte sichtbar gemacht und als Filter verwendet werden. 1.3.5 In Phase 2: eigene Felder als Auslöser oder Bedingung in der Automation-Engine, erweiterte Validierung (z.B. Zahl muss zwischen X und Y liegen), feldspezifische Berechtigungen (z.B. "nur HR sieht 'Personalnummer'").

1.4 Listen-Ansichten

1.4.1 Es gibt eine Kontakt-Liste, eine Firmen-Liste und eine Lead-Liste (Lead-Liste ist im Modul 2 detailliert). 1.4.2 In der Kontakt-Liste sind pro Eintrag sichtbar: Name, Hauptfirma, Primär-Email, Primär-Telefon, Tags, Verantwortlicher, letzte Aktivität. 1.4.3 Welche Spalten sichtbar sind, kann jeder Mitarbeiter für sich anpassen und speichern. 1.4.4 Listen können sortiert werden (Standard: nach letzter Aktivität, neueste oben). 1.4.5 Suche in der Liste funktioniert über Name, Email, Telefon, Notizen und eigene Felder gleichzeitig. 1.4.6 Filter sind kombinierbar: Verantwortlicher (mehrere wählbar), Tags (mehrere mit "und" oder "oder"), Firma, Erstellt-Zeitraum, "hat verknüpftes Angebot/Projekt", eigene Felder. Schalter "Archivierte anzeigen" ist standardmäßig aus. 1.4.7 Mehrfach-Auswahl per Häkchen ermöglicht Sammel-Aktionen: Tag hinzufügen oder entfernen, Verantwortlichen ändern, archivieren, gefilterte Auswahl als CSV exportieren. 1.4.8 Bei großen Listen (10.000+ Einträge) wird seitenweise nachgeladen ("Mehr laden"-Button), damit nichts hängt.

1.5 Detail-Ansicht eines Kontakts

1.5.1 Sichtbar sind alle Stammdaten, alle Email- und Telefonnummern, alle verknüpften Firmen mit Rolle, Tags, Verantwortlicher, alle verknüpften Angebote und Projekte, alle hinterlegten Dateien, alle eigenen Felder, Notizen und der Aktivitäten-Verlauf. 1.5.2 Jedes Stammdaten-Feld kann direkt in der Ansicht bearbeitet werden (Klick → ändern → speichern oder abbrechen), ohne in einen separaten Bearbeiten-Modus wechseln zu müssen. 1.5.3 Direkt aus der Kontakt-Ansicht möglich: Anrufen (per Click-to-Call wenn Telefonie verbunden ist, sonst öffnet Telefon-App des Geräts), Mail schreiben (Vorlagen-Auswahl, Empfänger vorausgefüllt), Termin buchen, Angebot anlegen (Kontakt vorausgewählt), Aufgabe anlegen, Tags ändern, Verantwortlichen ändern, Firma verknüpfen oder lösen. 1.5.4 Notizen sind im Markdown-Format (einfache Formatierung wie Fett, Listen, Links). 1.5.5 Wenn ein Kontakt keine Email und kein Telefon hat: Klartext-Hinweis "Keine Kontaktdaten hinterlegt, Anrufen/Mailen erst nach Eingabe möglich". 1.5.6 Wenn ein Kontakt archiviert ist: Banner "Kontakt ist archiviert, wieder aktivieren um zu bearbeiten". 1.5.7 Endgültiges Löschen mit offenen Verknüpfungen erfordert mehrstufige Bestätigung mit Auflistung, wie viele Angebote, Projekte, Dateien und Aktivitäten betroffen sind. 1.5.8 DSGVO-Daten-Export auf Knopfdruck: alle gespeicherten Daten zu diesem Kontakt als ZIP-Download (Admin-Berechtigung nötig).

1.6 Detail-Ansicht einer Firma

1.6.1 Funktioniert genauso wie die Kontakt-Ansicht, mit zusätzlicher Verwaltung der verknüpften Kontakte (Rolle ändern, primären Ansprechpartner setzen). 1.6.2 Der Aktivitäten-Verlauf einer Firma zeigt alle Aktivitäten der verknüpften Kontakte plus firmen-eigene Aktivitäten.

1.7 Aktivitäten-Verlauf

1.7.1 An jedem Kontakt, jeder Firma, jedem Lead, jedem Angebot, jedem Projekt hängt ein chronologischer Verlauf, was passiert ist. 1.7.2 Erfasst werden automatisch: ein- und ausgehende Anrufe, gesendete und empfangene Mails (Phase 2: WhatsApp), Notizen, Tag-Änderungen, Verantwortlichen-Wechsel, Stage-Wechsel bei Angeboten/Projekten, Datei-Uploads, Formular-Eingänge, Aufgaben (angelegt/erledigt), Termine, Lead-Übernahmen, Angebot gewonnen/verloren, ausgelöste Automationen, KI-Aktionen. 1.7.3 Pro Eintrag ist sichtbar: Datum/Uhrzeit (relativ wenn jünger als 7 Tage, sonst absolut), wer es war (Mitarbeiter, System, Automation oder KI), Klartext-Beschreibung, Klick öffnet Detail-Anzeige mit allen Daten. 1.7.4 Filter im Verlauf: nach Aktivitäts-Typ, nach Mitarbeiter, nach Zeitraum. Suche im Klartext der Einträge. 1.7.5 Gruppierung nach Tagen: heute / gestern / diese Woche / älter. 1.7.6 Aktivitäten können nicht gelöscht und nicht bearbeitet werden, sie sind ein lückenloser Nachweis. Notizen sind die einzige Aktivität, die direkt erstellt werden kann. 1.7.7 Wer einen Kontakt nicht sehen darf, sieht auch dessen Aktivitäten nicht. Audit-Einträge (sicherheitsrelevant) sind nur mit Audit-Berechtigung sichtbar.

1.8 Suche und Duplikat-Erkennung

1.8.1 Innerhalb der Listen-Ansicht funktioniert Volltext-Suche über Name, Email, Telefon, Notizen, eigene Felder. 1.8.2 Bereits beim Tippen in einem Anlege-Formular wird gegen vorhandene Kontakte abgeglichen, bei exaktem Email- oder Telefon-Treffer kommt sofort ein Klartext-Hinweis "Es gibt bereits einen Kontakt mit dieser Email: [Name]" mit den Optionen "Diesen öffnen", "Trotzdem neu anlegen" oder "Daten zusammenführen". 1.8.3 Bei weichen Treffern (gleicher Vor-/Nachname plus gleiche Firma oder gleiche Postleitzahl) erscheint ein dezenter Hinweis "Möglicher Duplikat: [Name]", den der Mitarbeiter ignorieren kann. 1.8.4 Es gibt ein Admin-Werkzeug "Duplikate finden", das alle erkannten Duplikat-Paare auflistet. Pro Paar wird der Treffergrund angezeigt (gleiche Email / gleiche Telefonnummer / gleicher Name + Firma / gleicher Name + PLZ) sowie beide Datensätze nebeneinander mit Anzahl Aktivitäten und Verknüpfungen. 1.8.5 Beim Zusammenführen entscheidet der Admin pro Feld, welcher Wert übernommen wird. Verknüpfungen (Angebote, Projekte, Dateien, Aktivitäten) werden vollständig auf den Gewinner umgehängt. Tags werden vereinigt. Der Verlierer wird archiviert oder hart gelöscht (Workspace-Einstellung). Im Aktivitäten-Verlauf des Gewinners erscheint ein Merge-Eintrag mit Vorher-Nachher. 1.8.6 In Phase 2: KI-gestützte Smart-Duplikat-Erkennung, automatische Merge-Regeln (z.B. "bei exaktem Email-Match automatisch zusammenführen"), zeitgesteuerter Duplikat-Scan.

1.9 Tags (Schlagworte)

1.9.1 Tags haben einen Namen, eine Farbe (8 vordefinierte Farben für ein konsistentes Bild) und sind anwendbar auf bestimmte Entitäts-Typen (z.B. nur Kontakte, oder Kontakte und Firmen). 1.9.2 Mitarbeiter können Tags ad-hoc anlegen: einfach im Tag-Eingabefeld einen neuen Namen tippen → Vorschlag "+ Tag 'Bestandskunde' anlegen" → Klick → ist sofort gesetzt. 1.9.3 Es gibt eine Tag-Verwaltung (Admin), in der Tags umbenannt werden können (alle Verwendungen aktualisieren sich mit), die Farbe geändert werden kann, zwei Tags zusammengeführt werden können, oder ein Tag gelöscht werden kann (mit Warnung über die Anzahl betroffener Einträge). 1.9.4 Tags ohne Verwendung können automatisch nach 90 Tagen archiviert werden (Workspace-Einstellung).

1.10 Wer darf was sehen

Rolle (Bündel) Darf
Kein Zugriff nichts, CRM ist im Menü ausgeblendet
Eigene lesen nur Kontakte, Firmen und Leads sehen, bei denen er als Verantwortlicher eingetragen ist
Alle lesen alle Kontakte, Firmen, Leads sehen
Bearbeiten zusätzlich anlegen und ändern (eigene oder alle, je nach Lese-Stufe)
Admin zusätzlich endgültig löschen, eigene Felder verwalten, Duplikat-Werkzeug, Tag-Verwaltung, DSGVO-Export, Sammel-Aktionen

1.10.1 Wer nur "eigene lesen" hat und versucht, einen fremden Kontakt direkt aufzurufen, sieht eine "Nicht gefunden"-Seite (404), nicht "Zugriff verweigert" (403), damit nicht ableitbar ist, ob der Kontakt überhaupt existiert. 1.10.2 Bearbeiten-Funktionen werden bei fehlender Berechtigung gar nicht erst angezeigt, nicht ausgegraut. 1.10.3 Sammel-Aktionen ohne Berechtigung sind ausgegraut mit Tooltip "Hierfür benötigst du erweiterte Berechtigungen". 1.10.4 Wenn ein Mitarbeiter gerade in einer Liste arbeitet und ein Kontakt wird ihm entzogen (Verantwortlicher gewechselt), verschwindet der Eintrag live aus seiner Liste.

1.11 Verknüpfungen mit anderen Modulen

1.11.1 Kontakt → Angebot (Modul 3): jedes Angebot gehört zu einem Kontakt und/oder einer Firma. 1.11.2 Kontakt → Projekt (Modul 4): nach gewonnenem Angebot wird ein Projekt angelegt, das auf den Kontakt verweist. 1.11.3 Kontakt → Datei (Modul 23): Dateien können einem oder mehreren Kontakten zugeordnet werden. 1.11.4 Kontakt → Termin (Modul 6/25), Aufgabe (Modul 26), Mail-Konversation (Modul 9), Anruf (Modul 12), Formular-Eingang (Modul 5), Lead (Modul 2, nach Übernahme). 1.11.5 Kontakt ist suchbar in der globalen Suche (Modul 24).

1.12 Phase 2 / bewusst NICHT in Phase 1

1.12.1 KI-gestütztes Smart-Match bei der Duplikat-Erkennung, Phase 1 nutzt feste Regeln. 1.12.2 Automatische Merge-Regeln und zeitgesteuerter Duplikat-Scan. 1.12.3 Eigene Felder als Trigger oder Bedingung in der Automation-Engine. 1.12.4 Erweiterte Validierung für eigene Felder (Regex, Zahlen-Bereich, abhängige Felder). 1.12.5 Berechtigungen pro eigenes Feld (z.B. "nur HR sieht 'Personalnummer'").

1.13 Klartext-Fehlertexte (Beispiele)

1.13.1 "Das Feld 'Heizungsanlage Hersteller' ist Pflicht." 1.13.2 "Es gibt bereits einen Kontakt mit dieser Email: Max Mustermann. [Diesen öffnen] [Trotzdem neu anlegen] [Daten zusammenführen]" 1.13.3 "15 Kontakte haben einen Wert in diesem Feld. Beim Löschen gehen Werte verloren. Stattdessen archivieren? [Archivieren] [Trotzdem löschen]" 1.13.4 "Dieser Tag ist 67 Mal verwendet. Beim Löschen werden alle Verknüpfungen entfernt, die Kontakte selbst bleiben."


Modul 2: Lead-Inbox (Eingehende Anfragen)

Was es tut: Sammelt alle unqualifizierten Eingänge an einer Stelle, Formular-Eingänge von der Webseite, Mails an die Info-Adresse, Anrufe von unbekannten Nummern, manuelle Einträge, und lässt das Vertriebs-Team triagieren: ernsthafte Anfrage oder Spam? Übernehmen oder verwerfen? Wer kümmert sich? Löst ab: HubSpot Lead-Bereich. Warum es wichtig ist: Geerkens kriegt ständig Anfragen über verschiedene Kanäle. Ohne zentrale Eingangs-Schublade gehen Anfragen unter oder werden doppelt bearbeitet.

2.1 Was ein Lead ist und wie er entsteht

2.1.1 Ein Lead ist eine "potenzielle Person", Daten sind noch nicht geprüft, vielleicht nicht mal vollständig. Erst beim Übernehmen ("Promotion") wird daraus ein vollwertiger Kontakt im CRM. 2.1.2 Ein Lead enthält: Vor- und Nachname (alle optional, Formulare sind manchmal dünn), Email, Telefon, Nachricht (Freitext), Quelle (woher kam er), Status, Verantwortlicher, Eingangs-Datum. 2.1.3 Quellen: Formular-Eingang (von einem Web-Formular), Mail (an die verbundene Mailbox, wenn Absender kein bekannter Kontakt ist), WhatsApp (Phase 2), Telefon (Anruf von unbekannter Nummer), manueller Eintrag (Mitarbeiter trägt selbst ein), Import (Phase 2), Empfehlung, sonstige. 2.1.4 Workspace-Admins können eigene Quellen anlegen (z.B. "Messe SHK 2027") mit Standard-Verantwortlichem und Standard-Tags. Manuell eingetragene Leads aus dieser Quelle landen vorsortiert.

2.2 Wie Leads automatisch entstehen

2.2.1 Formular-Eingang: Wenn jemand ein HiveGrid-Formular auf der Webseite abschickt (siehe Modul 5), wird automatisch ein Lead mit Quelle "Formular" angelegt. Bei Email- oder Telefon-Treffer auf einen vorhandenen Kontakt wird ein Hinweis im Lead-Detail angezeigt, das Zusammenführen ist immer Mensch-Entscheidung in Phase 1. 2.2.2 Eingehende Mail: Kommt eine Mail an die verbundene Mailbox von einem Absender, der kein bekannter Kontakt ist, wird ein Lead mit Quelle "Mail" angelegt und die Mail bleibt zugleich in der Inbox. Wenn der Absender bekannt ist, wird die Mail dem bestehenden Kontakt zugeordnet, kein Lead. 2.2.3 Anruf: Wenn ein Anruf von einer unbekannten Nummer eingeht, wird ein Lead mit Quelle "Telefon", der Nummer und einer Notiz "Anruf eingegangen am [Datum]" angelegt. Der Verantwortliche wird auf den Mitarbeiter gesetzt, der den Anruf entgegengenommen hat. Eine eventuelle Aufzeichnung wird verlinkt. 2.2.4 Manueller Eintrag: Mitarbeiter legen selbst einen Lead an (z.B. nach einem Messe-Gespräch). Beim Tippen wird live gegen vorhandene Kontakte geprüft. 2.2.5 Externe Quellen über Apps-Engine: Leads aus externen Marketing-Tools (z. B. Meta-Lead-Forms, Google-Lead-Ads, Funnel-Plattformen wie Funnelcockpit / Perspective Funnels) kommen über Adapter aus Modul 33a und werden mit Quelle „[Anbieter-Name]" angelegt. Konkrete Adapter-Implementierungen sind anhand des Bedarfs Geerkens priorisierbar.

2.3 Lead-Inbox (Listen-Ansicht)

2.3.1 Pro Lead sichtbar: Identität (Name falls vorhanden, sonst Email oder Telefon, sonst Quelle + Datum), Quelle, Status, Verantwortlicher, Eingangs-Datum, Vorschau der Nachricht (max. 80 Zeichen), letzte Aktivität. 2.3.2 Marker neben Einträgen: "Mögliches Duplikat" (wenn Email/Telefon mit existierendem Kontakt matcht), "Spam-Verdacht" (Anomalie-Erkennung hat angeschlagen), "Automatisch übernommen" (durch eine Automation). 2.3.3 Filter: Status (Standardmäßig sind "Neu" und "Qualifiziert" sichtbar), Quelle, Verantwortlicher (mit Sonderwert "Nicht zugewiesen"), Eingangs-Zeitraum, Tags, eigene Felder, Schalter "Spam ausblenden" (Standard ein), Schalter "Übernommene einblenden" (Standard aus). 2.3.4 Pro Eintrag direkt aus der Liste möglich, ohne in die Detail-Seite zu wechseln: Verantwortlichen zuweisen, Status setzen, zu Kontakt übernehmen (öffnet Modal), Spam markieren. 2.3.5 Sammel-Aktionen: Verantwortlichen zuweisen (auch per Round-Robin in einer Gruppe), Status setzen (mit Begründungs-Feld bei "verloren"), Tags ändern, Spam markieren mit Klartext-Bestätigung "124 Leads als Spam markieren? Sie werden in 30 Tagen automatisch gelöscht.", endgültig löschen, gefilterte Auswahl als CSV exportieren (Admin-Berechtigung). 2.3.6 Sortierung: Standard ist Eingangs-Datum, neueste oben. Andere Spalten sortierbar. 2.3.7 Neue Leads erscheinen automatisch in der Liste (Live-Aktualisierung), ohne dass die Seite neu geladen werden muss. 2.3.8 Mitarbeiter können bis zu 5 Filter-Kombinationen als "Gespeicherte Ansicht" speichern.

2.4 Lead-Detail-Ansicht

2.4.1 Sichtbar sind alle Lead-Daten plus die Quellen-Detail-Daten (z.B. welches Formular genau, mit welcher Submitter-IP, oder Mail-Header, oder Anruf-Aufzeichnungs-Link). 2.4.2 Treffer-Hinweise: "Es gibt einen Kontakt mit dieser Email: [Name], [Diesen Kontakt öffnen]" oder "Soft-Match: [Name + Adresse]". 2.4.3 Bei wiederholten Anfragen derselben Email innerhalb 30 Tagen wird der bisherige Verlauf angezeigt. 2.4.4 Direkt aus der Lead-Ansicht möglich: Annehmen (Status "Neu" wird "Qualifiziert"), zu Kontakt übernehmen (öffnet Übernahme-Modal), Spam markieren, Verloren markieren, Verantwortlichen ändern, Antwort senden (Mail, oder WhatsApp Phase 2), anrufen, Notiz hinzufügen, Aufgabe anlegen, Termin-Vorschlag senden. 2.4.5 Lead-Stammdaten können direkt geändert werden (Klick → ändern → speichern). 2.4.6 Endgültiges Löschen erfordert Klartext-Bestätigung.

2.5 Übernahme zu Kontakt

2.5.1 Mitarbeiter klickt "Als Kontakt übernehmen" → Modal öffnet sich mit Lead-Daten vorausgefüllt, alle Felder editierbar. 2.5.2 Optional: existierende Firma suchen oder eine neue anlegen, Rolle wählen. 2.5.3 Optional: gleichzeitig ein Angebot anlegen (Pipeline + Stufe + geschätztes Volumen, standardmäßig vorgeschlagen). 2.5.4 Automatischer Email-Abgleich: Wenn schon ein Kontakt mit dieser Email existiert, kann der Mitarbeiter wählen: (a) den bestehenden Kontakt aktualisieren (Standard, leere Felder werden ergänzt, ein Aktivitäts-Eintrag wird erzeugt), (b) trotzdem einen neuen Kontakt anlegen, (c) manuell einem anderen bestehenden Kontakt zuordnen (z.B. private vs. geschäftliche Email derselben Person), (d) als Spam markieren. 2.5.5 Bestätigen → in einem Schritt werden Kontakt, ggf. Firma und Verknüpfung, ggf. Angebot angelegt. Der Lead bekommt Status "Übernommen" und einen Verweis auf den entstandenen Kontakt. 2.5.6 Wenn Pflichtdaten für die Übernahme fehlen: "Um diesen Lead zu promovieren, brauchen wir mindestens Vor- und Nachname. [Daten ergänzen]".

2.6 Status-Verlauf eines Leads

2.6.1 Mögliche Status: "Neu" (unbearbeitet, Standard), "Qualifiziert" (manuell ernst eingestuft), "Übernommen" (wurde Kontakt, Status ist endgültig), "Verloren" (nicht weiterverfolgt, mit optionaler Begründung), "Spam" (markiert für automatische DSGVO-Löschung). 2.6.2 Übergänge: Neu → Qualifiziert (manuell oder durch Automation), Neu → Übernommen (durch Übernahme-Modal), Neu → Verloren oder Spam, Verloren ↔ Qualifiziert (z.B. Re-Engagement), Spam → Qualifiziert (False-Positive zurücknehmen). 2.6.3 Status "Übernommen" ist endgültig, wird nur durch Hard-Delete des entstandenen Kontakts mit zurückgenommen.

2.7 Automatische Löschung (DSGVO)

2.7.1 Leads im Status "Spam" werden nach 30 Tagen automatisch endgültig gelöscht (täglicher Job). 2.7.2 Leads im Status "Verloren" werden nach 90 Tagen endgültig gelöscht (Workspace-Admin kann das anpassen, "0 Tage" bedeutet "nie"). 2.7.3 Vor der automatischen Löschung wird im Lead-Detail eingeblendet: "Wird automatisch gelöscht am [Datum], [Status ändern um zu erhalten]". 2.7.4 Nach der Löschung bleibt ein anonymisierter Eintrag im Aktivitäts-Verlauf (kein Personenbezug) plus ein Audit-Eintrag.

2.8 Spam-Schutz und Anti-Flutung

2.8.1 Workspace-Admins können pro Quelle ein Stundenlimit setzen (Standard 100 Eingänge pro Stunde pro Quelle). Wird das überschritten, werden weitere Eingänge verworfen und ein Klartext-Hinweis geht an den Admin. 2.8.2 Pro IP-Adresse ist ein Stundenlimit für Formular-Eingänge konfigurierbar (Standard 20). 2.8.3 Anomalie-Erkennung: erkennt das System eine 10-fache Spitze gegenüber dem Üblichen, wird die Quelle automatisch pausiert und der Admin benachrichtigt: "Quelle 'Kontaktformular' wurde automatisch pausiert: 247 Submissions in 5 Minuten (10x üblich). Eingehende Leads werden verworfen. [Wieder aktivieren] [Anti-Spam-Einstellungen]". 2.8.4 Optionale Spam-Heuristiken (jede einzeln einschaltbar): IP auf Blocklist, Email-Domain ist Wegwerf-Mail-Anbieter, Honeypot-Feld im Formular gefüllt (Bot-Signal), Formular zu schnell abgeschickt (unter 3 Sekunden nach Laden, Bot-Signal). 2.8.5 Treffer-Verhalten ist wählbar: entweder "Quarantäne" (Status bleibt "Neu" mit Marker, Mensch entscheidet) oder "Direkt-Spam" (Status sofort "Spam" und im Default-Filter ausgeblendet).

2.9 Lead-Statistiken

2.9.1 Eigene Statistik-Seite mit Kennzahlen: eingegangene Leads im gewählten Zeitraum, Übernahme-Quote (Lead → Kontakt), Übernahme-Quote (Lead → gewonnenes Angebot), durchschnittliche Reaktionszeit (Eingang bis erste Antwort oder Status-Wechsel), Spam-Quote, offene Leads (nicht zugewiesen oder älter als 24 Stunden in "Neu"). 2.9.2 Aufschlüsselungen: nach Quelle (Volumen + Übernahme-Quote pro Quelle), nach Verantwortlichem, nach Tag, nach Wochentag/Tageszeit, aktuelle Status-Verteilung. 2.9.3 Trend-Anzeige: Lead-Volumen über Zeit, Übernahme-Quote über Zeit, Vergleich zur Vorperiode (Delta in Prozent). 2.9.4 Klick auf eine Quelle oder einen Mitarbeiter springt in die gefilterte Lead-Liste. 2.9.5 Aufschlüsselung "Nach Verantwortlichem" ist nur sichtbar für Mitarbeiter mit Lese-Berechtigung "Alle". Wer nur "Eigene" sehen darf, sieht nur eigene Zahlen. 2.9.6 Export der aktuellen Statistik-Sicht als CSV (Admin-Berechtigung).

2.10 Wer darf was sehen

Rolle (Bündel) Darf
Kein Zugriff nichts
Eigene lesen nur eigene Leads sehen, eigene Statistiken
Alle lesen alle Leads, alle Statistiken
Bearbeiten Leads anlegen, ändern, Status setzen, antworten, übernehmen
Admin Sammel-Aktionen, Export, Quellen-Verwaltung, Anti-Spam-Einstellungen, endgültig löschen

2.10.1 Bei Sammel-Auswahl mit gemischten Rechten: "Du hast 50 Leads ausgewählt. 12 davon sind nicht dir zugewiesen, diese werden übersprungen. [Trotzdem fortfahren] [Auswahl anpassen]". 2.10.2 Lead übernehmen erfordert sowohl Lead-Bearbeiten- als auch CRM-Bearbeiten-Recht (weil dabei ein Kontakt entsteht).

2.11 Lead-Routing pro Quelle (mandanten-konfigurierbar) [N4, 09.05.2026]

Erweiterung gem. Anmerkung Noah, 09.05.2026: Leads kommen aus immer mehr Quellen, perspektivisch auch aus eigenen Marketing-Funnels (siehe 2.12.X für Phase 2). Pro Quelle muss konfigurierbar sein, was nach Eingang automatisch passiert: in welche Vertriebs-Pipeline der Lead landet, wer als Verantwortlicher gesetzt wird, ob automatisch ein Verkaufsfall (Deal) angelegt wird. Manuelles Sortieren skaliert nicht.

2.11.1 Pro Lead-Quelle (Formular, Mail-Postfach, Anruf-Nummer, externer Adapter, manuell) konfiguriert der Mandanten-Administrator ein Routing-Regelwerk. 2.11.2 Konfigurierbare Routing-Aktionen pro Quelle: - Status-Default (Neu / Qualifiziert). - Verantwortlicher-Default: konkrete Person, Round-Robin innerhalb einer Gruppe (z. B. Vertriebs-Team), oder Lead-Pool (Phase 2). - Tags-Default (eine oder mehrere). - Auto-Anlage Verkaufsfall: bei Quellen mit klarem Vertriebs-Intent (z. B. Funnel „PV-Anlage konfigurieren") kann automatisch ein Verkaufsfall in einer konfigurierbaren Ziel-Pipeline und Start-Stufe angelegt werden, mit Lead-Daten vorausgefüllt. - Auto-Pipeline-Zuweisung: in welche Sales-Pipeline geht der entstehende Verkaufsfall? Mehrere Pipelines möglich (z. B. „Premium-Pipeline" für Volumen über 10.000 Euro, sonst „Standard-Pipeline"). - Bedingungen pro Regel (zum Beispiel „nur wenn Volumen-Feld > X" oder „nur wenn Anlagen-Typ = Wärmepumpe"). 2.11.3 Mehrere Regeln pro Quelle möglich, in Reihenfolge geprüft, erste Treffer-Regel zählt. Letzte Regel ist Default-Fallback. 2.11.4 Beispiele für Geerkens: - Quelle „Kontaktformular Webseite" → Status „Neu", Verantwortlicher Round-Robin Vertriebs-Team, Tag „Webseite", Auto-Verkaufsfall in „Anlagen-Verkauf" Pipeline. - Quelle „Anruf 0800-Nummer" → Status „Neu", Verantwortlicher der Mitarbeiter im Anruf, kein Auto-Verkaufsfall (Mitarbeiter qualifiziert manuell). - Quelle „Funnel PV-Konfigurator" → Status „Qualifiziert" (weil Konfiguration ausgefüllt), Verantwortlicher Vertriebsleiter, Auto-Verkaufsfall mit Volumen aus Konfigurator. 2.11.5 Routing-Konfiguration ist auditierbar (siehe Modul 21). Routing-Aktionen werden im Lead-Aktivitäts-Strom mit Klartext geloggt: „Automatisch der Pipeline ‚Anlagen-Verkauf' zugewiesen, Regel ‚Webseite-Kontaktformular'." 2.11.6 Klassische Lead-Inbox bleibt unverändert: Leads ohne automatische Verkaufsfall-Anlage landen wie bisher in der Lead-Inbox zur manuellen Qualifizierung. Auto-Routing ist eine Erweiterung, kein Ersatz.

2.12 Phase 2 / bewusst NICHT in Phase 1

2.12.1 CSV/JSON-Lead-Import (z.B. Migration aus HubSpot/Quiply). 2.12.2 Sammel-Übernahme mehrerer Leads in einem Rutsch. 2.12.3 KI-Lead-Bewertung (automatische Priorisierung und Punktzahl). 2.12.4 WhatsApp als Quelle (vollständig, in Phase 1 nicht). 2.12.5 Round-Robin-Auto-Verteilung mit Tenant-Admin-Regeln auf Gruppen-Ebene. 2.12.6 Lead-Pool-Gruppen (nicht zugewiesene Leads sichtbar für Gruppen-Mitglieder). 2.12.7 Erweiterte Statistiken: Funnel-Visualisierung, Marketing-Kosten-Verknüpfung, Cohort-Analyse. 2.12.8 KI-gestützter Spam-Filter, KI-Antwort-Vorschläge, KI-Routing. 2.12.9 Eigene Marketing-Funnels in HiveGrid bauen (Funnel-Builder mit Schritt-Logik, Konfiguratoren, Lead-Magneten, Tracking) [N4]. Integration mit der Automation-Engine (M17) und der Lead-Inbox (M02). Bedeutet ein eigenes Sub-Modul, daher Phase 2.

2.13 Klartext-Hinweise

2.13.1 Inbox leer: "Noch keine Leads, sobald über Formulare, Mails oder Anrufe Eingänge kommen, erscheinen sie hier. [Formular anlegen] [Mail-Inbox verbinden]". 2.13.2 Filter ohne Treffer: "Keine Leads passen zu deinen Filtern. [Filter zurücksetzen]". 2.13.3 Lead älter als 24 Stunden ohne Verantwortlichen: "Seit X Stunden unbearbeitet, [Mir zuweisen]". 2.13.4 Spam markiert: "Lead als Spam markiert. Wird am [Datum + 30 Tage] automatisch gelöscht. [Wiederherstellen]". 2.13.5 Quelle pausiert (Admin-Sicht): "Quelle 'Messe SHK 2027' ist pausiert, eingehende Leads aus dieser Quelle werden derzeit verworfen. [Reaktivieren]".


Modul 23: Dateien (Dokumentenablage)

Was es tut: Zentrale Ablage für alle Dokumente, Bilder, Verträge, Fotos von der Baustelle, Angebote als PDF, eine Datei kann gleichzeitig zu mehreren Stellen gehören (Kontakt, Firma, Angebot, Projekt, Auftrag). Mit Versionsverwaltung, Vorschau im Browser und mobiler Foto-Aufnahme direkt von der Baustelle. Löst ab: Datei-Anhänge in HubSpot und ad-hoc Dropbox-Nutzung bei Geerkens. Warum es wichtig ist: Handwerker leben von Fotos und Dokumenten, Anlagen-Fotos vor Montage, Mess-Berichte, Wartungs-Protokolle, unterschriebene Aufträge. Ohne zentrale, durchsuchbare Ablage liegt das alles in WhatsApp-Chats und Mail-Anhängen.

23.1 Wo Dateien gespeichert werden

23.1.1 Alle Dateien werden auf europäischen Servern gespeichert (Scaleway in Frankreich, DSGVO-konform). Kein US-Cloud-Anbieter, keine Datenübertragung in die USA. 23.1.2 Dateien sind verschlüsselt gespeichert (Server-seitig). 23.1.3 Pro Workspace sind die Dateien strikt voneinander getrennt, kein Workspace kann auf Dateien eines anderen zugreifen. 23.1.4 Download-Links sind nicht öffentlich, sie sind anmeldepflichtig und nur kurze Zeit gültig (5 Minuten). 23.1.5 Tägliche Multi-Zonen-Sicherung durch den Anbieter, plus tägliche Snapshots.

23.2 Was zu einer Datei gespeichert wird

23.2.1 Pro Datei: Anzeige-Name (übernimmt den Original-Dateinamen beim Hochladen, ist aber später umbenennbar), Dateityp, Größe, Erstellt-Datum + wer hochgeladen hat, aktuelle Versionsnummer, Tags, Notizen, Verantwortlicher, Quelle (manuell hochgeladen / über Kunden-Portal / aus Formular-Eingang / aus Mail-Anhang / durch Automation / über externe Schnittstelle), Verknüpfungen zu anderen Einträgen (Kontakte, Firmen, Leads, Angebote, Projekte, Aufträge, Aufgaben, Termine, Mitarbeiter, Formular-Eingänge). 23.2.2 Dateien werden über eine Prüfsumme (SHA-256) erkannt, beim Hochladen wird geprüft, ob dieselbe Datei schon existiert (siehe Duplikat-Erkennung). 23.2.3 Dateien können archiviert werden (verschwinden aus Listen, bleiben aber gespeichert) und endgültig gelöscht werden (Admin-Recht; löscht alle Versionen und Vorschauen mit).

23.3 Hochladen

23.3.1 Hochladen über Drag-and-Drop in den Browser, Datei-Auswahl-Dialog, oder direkt aus der Detail-Ansicht eines Kontakts/Angebots/Projekts (Datei wird automatisch verknüpft). 23.3.2 Mehrere Dateien gleichzeitig hochladbar (Warteschlange wird abgearbeitet). 23.3.3 Pro Datei wird der Fortschritt angezeigt: Name, Prozent + Datentransfer ("12 MB von 47 MB"), geschätzte Restzeit. Bei Fehlschlag steht eine Klartext-Begründung da plus eine Wiederholen-Option. 23.3.4 Maximale Dateigröße: 500 MB Standard, vom Workspace-Admin bis 2 GB anhebbar. Phase 2: Speicher-Limits pro Subscription-Plan. 23.3.5 Bestimmte Dateitypen sind aus Sicherheitsgründen blockiert (z.B. ausführbare Programme): "Dateityp '[Typ]' ist aus Sicherheitsgründen nicht erlaubt".

23.4 Mobile-Upload und Baustelle

23.4.1 In der Mobile-App: Foto direkt mit der Kamera aufnehmen → wird sofort hochgeladen. 23.4.2 Bei Funkloch oder unterbrochener Verbindung: Foto wird lokal auf dem Gerät zwischengespeichert. Sobald wieder online, wird automatisch hochgeladen. 23.4.3 Bei großen Dateien und schwacher Verbindung: Hochladen geht häppchenweise (in 5-MB-Stücken) und kann nach Verbindungsabbruch fortgesetzt werden, ohne von vorn zu beginnen. 23.4.4 Klartext bei Verbindungsabbruch: "Verbindung unterbrochen. Bereits hochgeladene Daten bleiben, Upload wird fortgesetzt sobald du wieder online bist".

23.5 Versionsverwaltung

23.5.1 Wenn jemand eine neue Version derselben Datei hochlädt (z.B. überarbeitetes Angebot), bleibt die alte Version vorhanden. Versionsnummern sind fortlaufend (V1, V2, V3, ...). 23.5.2 Beim Hochladen einer neuen Version kann optional ein Änderungs-Hinweis hinterlegt werden ("Preise korrigiert", "Unterschrift hinzugefügt", ...). Ohne Hinweis wird ein Standard-Text "Version hochgeladen am [Datum]" gesetzt. 23.5.3 Bei Upload eines gleichnamigen Dokuments im Kontext eines Projekts/Angebots: "Es gibt bereits eine Datei 'angebot.pdf' in diesem Projekt. Möchtest du eine neue Version anlegen oder eine separate Datei?". 23.5.4 In der Detail-Ansicht ist der vollständige Versionsverlauf einsehbar: pro Version Datum, hochladende Person, Größe, Änderungs-Hinweis, jede Version einzeln herunterladbar und vorschaubar. 23.5.5 Zurück zu einer alten Version ("Rollback"): legt eine neue Version mit dem Inhalt der alten an. Es wird nichts überschrieben, der Verlauf bleibt lückenlos. 23.5.6 Endgültiges Löschen einer Datei entfernt alle Versionen, alle Vorschauen, alle Verknüpfungen.

23.6 Vorschau im Browser

23.6.1 Direkt im Browser angezeigt werden: PDFs, Bilder (JPEG, PNG, GIF, WebP, HEIC, HEIC wird automatisch in JPEG konvertiert für Browser-Kompatibilität), Office-Dokumente (Word, Excel, PowerPoint und LibreOffice-Pendants, werden in PDF umgewandelt), Videos (Browser-Player), Audio (Player), reiner Text und Markdown. 23.6.2 Für nicht unterstützte Dateitypen: nur Download-Funktion, mit Klartext-Hinweis "Für diesen Dateityp ist keine Vorschau verfügbar. [Herunterladen]". 23.6.3 Vorschau-Erstellung läuft im Hintergrund. Status sichtbar: "Vorschau wird erstellt, kann einen Moment dauern" / "Vorschau bereit" / "Vorschau fehlgeschlagen, Datei kann heruntergeladen und lokal geöffnet werden. [Erneut versuchen]". 23.6.4 Für jeden Versions-Stand wird eine eigene Vorschau erzeugt.

23.7 Listen-Ansicht (Datei-Browser)

23.7.1 Alle Dateien des Workspace in einer durchsuchbaren Liste, wahlweise als Tabelle oder als Kachel-Ansicht mit Vorschau-Bildchen. 23.7.2 Pro Eintrag sichtbar: Name, Typ, Größe, Erstellt-Datum + Ersteller, aktuelle Version, Tags, Verantwortlicher, verknüpfte Einträge (Anzahl + erste 1-2 als Klartext, Rest als "+N"), Quelle, Vorschau-Bildchen wenn verfügbar. 23.7.3 Filter: nach verknüpftem Eintrag (z.B. "alle Dateien zu Kunde Müller"), nach Typ-Gruppe (Bild / PDF / Office / Video / Audio / Sonstige), nach Verantwortlichem, nach Ersteller, nach Tags, nach Erstellt-Zeitraum, nach Quelle, nach Größe. 23.7.4 Datei-Browser ist auch eingebettet in den Detail-Seiten der anderen Module sichtbar, als "Dateien"-Sektion am Kontakt, an der Firma, am Angebot, am Projekt, am Lead, vorgefiltert auf den Eintrag. 23.7.5 Schnell-Vorschau beim Klick auf einen Eintrag (ohne in die Detail-Seite zu wechseln). 23.7.6 Sammel-Aktionen: Tag ändern, Verantwortlichen ändern, an Eintrag verknüpfen oder lösen, archivieren, gemeinsam als ZIP herunterladen, endgültig löschen.

23.8 Detail-Ansicht einer Datei

23.8.1 Sichtbar: Stammdaten, aktuelle Vorschau, Tags, Notizen, alle Verknüpfungen (gruppiert nach Typ, Kontakte, Firmen, Angebote, Projekte etc., mit optionaler Rolle pro Verknüpfung wie z.B. "Auftragsbestätigung", "Foto vor Montage", "Acceptance-Beleg"), Versionsverlauf, Aktivitäten-Verlauf (wer hat hochgeladen, wer hat verknüpft, wer hat umbenannt). 23.8.2 Direkt aus der Detail-Ansicht: aktuelle Version herunterladen, alte Version herunterladen, neue Version hochladen, umbenennen (Original-Datei bleibt unverändert, nur Anzeige-Name ändert sich), Notizen ändern, Tags ändern, Verantwortlichen ändern, Verknüpfung hinzufügen oder lösen, Vorschau erneut erzeugen (bei Fehlschlag), archivieren oder reaktivieren, endgültig löschen, DSGVO-Daten-Export, Permalink kopieren (anmeldepflichtige URL, kein öffentlicher Link in Phase 1).

23.9 Verknüpfungen mit anderen Modulen

23.9.1 Eine Datei kann gleichzeitig zu mehreren Einträgen gehören. Beispiel: Angebots-PDF gehört zum Kontakt, zum Angebot und nach Gewinn auch zum Projekt, das ist eine Datei, drei Verknüpfungen. 23.9.2 Verknüpfung optional mit Rollen-Beschreibung als Freitext ("Foto vor Montage", "Auftragsbestätigung", ...). 23.9.3 Verknüpfung hinzufügen erfordert sowohl Datei-Bearbeiten-Recht als auch Lese-Recht auf den Ziel-Eintrag. Klartext bei fehlendem Zugriff: "Du hast keinen Zugriff auf [Ziel-Name]. Bitte einen Kollegen mit Zugriff bitten, die Verknüpfung hinzuzufügen". 23.9.4 Datei-Uploads aus dem Kunden-Portal (Modul 15) werden automatisch dem zugehörigen Projekt/Angebot/Auftrag zugeordnet, mit Quelle "Kunden-Portal" und dem Namen des hochladenden Endkunden in der Anzeige. 23.9.5 Datei-Uploads aus Formular-Eingängen (Modul 5) werden automatisch der Formular-Einreichung zugeordnet. 23.9.6 HR-Dokumente am Mitarbeiter (z.B. Lohnabrechnungen) folgen Sonder-Berechtigungen aus dem HR-Hub (Modul 14): Standard ist "nur der betroffene Mitarbeiter selbst plus HR-Admin", auch andere Datei-Lese-Rechte greifen hier nicht. 23.9.7 KWP-Archiv-Spiegelung (KWP → HiveGrid, einseitig) [N5, 09.05.2026] - Pro Kunde gibt es in HiveGrid ein Kunden-Archiv mit allen Dokumenten, die KWP zum Kunden ablegt (auftrags-übergreifend, also Stammdaten-Schreiben, Kunden-Korrespondenz, Wartungs-Verträge etc.). - Pro Projekt gibt es ein Projekt-Archiv mit den auftrags-spezifischen Dokumenten aus KWP. - Beim Sync wird automatisch geprüft, in welche Archiv-Ebene das Dokument gehört (anhand der KWP-Verknüpfung Auftrag/Kunde) und in HiveGrid entsprechend abgelegt. - Sync-Richtung ist einseitig: KWP → HiveGrid. HiveGrid-eigene Dokumente werden nicht automatisch nach KWP gepusht (sonst KWP-Speicher-Überlauf), nur auf manuellen Knopfdruck einzelner Dokumente. - Detail-Anforderungen siehe 19.2.5.

23.10 Duplikat-Erkennung beim Hochladen

23.10.1 Wird eine Datei hochgeladen, die per Prüfsumme schon im Workspace existiert, kommt der Hinweis: "Diese Datei existiert bereits als '[Name]' in diesem Workspace. [Neue Version anlegen] [Verknüpfung hinzufügen] [Trotzdem neu speichern]".

23.11 Wer darf was sehen

Rolle (Bündel) Darf
Kein Zugriff nichts
Eigene lesen nur Dateien sehen, die er hochgeladen hat oder bei denen er Verantwortlicher ist, plus Dateien an Einträgen, die er ohnehin sehen darf (z.B. eigene Projekte)
Alle lesen alle Dateien des Workspace
Bearbeiten hochladen, neue Version, umbenennen, Tags, Verknüpfen
Admin endgültig löschen, Speicher-Limits ändern (Phase 2), DSGVO-Export beliebiger Dateien

23.11.1 Wer eine Datei nicht sehen darf, sieht sie auch nicht in Suchergebnissen. 23.11.2 HR-Dokumente am Mitarbeiter sind ausgenommen, auch "Alle lesen" sieht hier nichts ohne HR-Berechtigung.

23.12 Klartext-Hinweise

23.12.1 Verbindung beim Upload unterbrochen: "Verbindung unterbrochen. Bereits hochgeladene Daten bleiben, Upload wird fortgesetzt sobald du wieder online bist". 23.12.2 Datei zu groß: "Datei ist [Größe] groß. Maximale Dateigröße in diesem Workspace: [Maximum]. Frag deinen Workspace-Admin, wenn du größere Dateien hochladen musst". 23.12.3 Speicher-Limit erreicht (Phase 2): "Speicher-Limit dieses Workspace ist erreicht. Bitte alte Dateien archivieren oder Plan upgraden". 23.12.4 Hard-Delete-Warnung: "Diese Datei hat [n] Versionen und ist mit [m] Einträgen verknüpft. Beim Löschen gehen alle Versionen und Verknüpfungen verloren. Stattdessen archivieren? [Archivieren] [Endgültig löschen]". 23.12.5 Kunden-Portal-Upload erkannt: "Diese Datei wurde von [Endkunde] über das Kunden-Portal hochgeladen am [Datum]".

23.13 Phase 2 / bewusst NICHT in Phase 1

23.13.1 OCR (Texterkennung in PDFs und Bildern), damit der Inhalt durchsuchbar wird. 23.13.2 KI-gestützte automatische Tag-Vorschläge basierend auf Inhalt. 23.13.3 Speicher-Limits pro Subscription-Plan. 23.13.4 Automatisches Archivieren von Dateien nach X Monaten ohne Zugriff. 23.13.5 Öffentliche Teilen-Links (z.B. Angebot per Link an Kunden, separat vom Kunden-Portal). 23.13.6 Wasserzeichen für PDFs (z.B. mit Empfänger-Name). 23.13.7 Versions-Vergleich (Diff-Ansicht für PDFs/Office). 23.13.8 Ordner-Strukturen (bewusst NICHT in Phase 1, Tags + Verknüpfungen + Filter ersetzen Ordner; Ordner würden inkonsistente Ablage fördern). 23.13.9 Datei-Sperre beim parallelen Bearbeiten (für Office-Online-Integration). 23.13.10 Kundeneigene Verschlüsselungs-Schlüssel (Enterprise-Stufe). 23.13.11 Download-Tracking (wer hat wann was heruntergeladen), bewusst nicht in Phase 1 wegen Audit-Last.


Modul 24: Globale Suche

Was es tut: Eine Suche, die alles im Workspace findet, Kontakte, Firmen, Leads, Angebote, Projekte, Dateien, Aufgaben, Mitarbeiter, Formular-Eingänge, über eine Tastenkombination (Cmd+K bzw. Strg+K) von überall aufrufbar. Findet sowohl Stichwort-Treffer als auch sinnverwandte Treffer (KI-Suche). Löst ab: Verteilte Such-Funktionen in HubSpot und das ständige Wechseln zwischen Modulen, um etwas wiederzufinden. Warum es wichtig ist: Mitarbeiter wissen oft nicht mehr, ob das Gesuchte ein Kontakt, ein Angebot oder ein Projekt war, die globale Suche schließt diese Lücke und macht die Plattform spürbar schneller.

24.1 Wie die Suche aufgerufen wird

24.1.1 Tastenkombination Cmd+K (Mac) oder Strg+K (Windows/Linux), funktioniert von jeder Seite in der App. 24.1.2 Klick auf das Such-Symbol in der Kopfzeile der App. 24.1.3 Auf dem Handy: Such-Symbol in der Kopfzeile, öffnet eine Vollbild-Suche. 24.1.4 Direkter Link auf eine vorab gefilterte Suche möglich (z.B. "/search?q=Schmidt", kann gespeichert oder geteilt werden, Filter werden in der URL mitgenommen).

24.2 Was durchsucht wird (Phase 1)

24.2.1 Kontakte, Firmen, Leads (aus Modul 1 und 2). 24.2.2 Angebote (aus Modul 3, Sales-Pipeline). 24.2.3 Projekte und Aufträge (aus Modul 4). 24.2.4 Formular-Eingänge (aus Modul 5). 24.2.5 Mitarbeiter (aus Modul 14, mit eingeschränkter Sichtbarkeit, normaler Mitarbeiter sieht nur sich selbst und ggf. Kollegen mit entsprechender HR-Berechtigung). 24.2.6 Dateien (aus Modul 23, Name, Notizen, Tags; OCR-Inhalt der Dateien erst in Phase 2). 24.2.7 Aufgaben (aus Modul 26). 24.2.8 Phase 2: Wiki-Seiten (Modul 16), Mail-Inhalte (Modul 9 mit DSGVO-Schicht), Chat-Nachrichten (Modul 13 mit sehr restriktiven Berechtigungen).

24.3 Wie gesucht wird

24.3.1 Stichwort-Suche: findet exakte Treffer und Wortformen (deutsche Stammform-Erkennung, "Heizung" findet auch "Heizungen", "geheizt"). Umlaute werden normalisiert. 24.3.2 KI-Suche (semantisch): findet sinngemäße Treffer auch ohne genaue Wort-Übereinstimmung. Beispiel: Suche nach "Wartung Frühjahr" findet auch ein Projekt "Saisonale Heizungsinspektion März". 24.3.3 Beide Pfade laufen gemeinsam, Treffer werden zusammengeführt mit einem Mischverhältnis von 70% Stichwort und 30% KI (in Phase 2 vom Workspace-Admin anpassbar). 24.3.4 Zusätzliche Treffer-Bevorzugung: aktuelle Aktivität (Eintrag wurde kürzlich bearbeitet), exakter Treffer im Titel, eigene Einträge des suchenden Mitarbeiters. 24.3.5 Die KI-Suche läuft ausschließlich über europäische Anbieter (Mistral primär, Scaleway als Backup, AlephAlpha als drittes Backup). Keine Datenübertragung in die USA.

24.4 Treffer-Ansicht (Schnell-Suche im Modal)

24.4.1 Sichtbar pro Treffer: Titel (z.B. Kontakt-Name, Angebots-Titel), Untertitel (z.B. Firma beim Kontakt, Stage beim Angebot), Typ-Indikator (Kontakt / Firma / Angebot / Datei / ...), Kontext-Auszug mit hervorgehobener Treffer-Stelle, letzte Aktivität (relativ). 24.4.2 Treffer sind nach Typ gruppiert (zuerst Kontakte, dann Angebote, dann Dateien, ...). 24.4.3 Tastatur-Bedienung: Pfeiltasten zum Navigieren, Enter zum Öffnen, Cmd+Enter um in neuem Tab zu öffnen, Esc zum Schließen. 24.4.4 Filter-Chips am oberen Rand: "Nur Kontakte", "Nur Dateien", "Nur Angebote" etc., Mehrfach-Auswahl möglich. 24.4.5 Bei leerer Eingabe: zuletzt durchgeführte Suchen (siehe 24.7). 24.4.6 Bei keinem Treffer: "Keine Treffer für '[Suchbegriff]'. Versuch andere Begriffe oder erweitere den Zeitraum-Filter". 24.4.7 Lade-Anzeige während die Suche läuft. Stichwort-Treffer erscheinen sofort (unter 500 ms), KI-Treffer werden nachgeladen (1-3 Sek bei Erst-Suche), die Liste füllt sich live auf. 24.4.8 "Alle Treffer anzeigen" springt in die Vollbild-Such-Seite mit denselben Filtern.

24.5 Vollbild-Such-Seite

24.5.1 Eigene Seite mit Such-Eingabe, vollständiger Trefferliste, seitenweise nachladbar (50 pro Seite). 24.5.2 Erweiterte Filter-Sektion: Typ (Mehrfach-Auswahl), Erstellt-Zeitraum, Verantwortlicher, Tags, modul-spezifische Filter (z.B. Stage bei Angebot-Filter), Schalter "Archivierte einbeziehen". 24.5.3 Sortierung wählbar: Relevanz (Standard), letzte Aktivität, Erstellt-Datum. 24.5.4 Trefferanzahl im Klartext: "1.247 Treffer in 0,3 Sek".

24.6 Wer sieht welche Treffer

24.6.1 Die Suche zeigt nur Treffer, die der suchende Mitarbeiter aufgrund seiner Berechtigungen ohnehin sehen darf. Wer nur "eigene Kontakte" lesen darf, sieht in der Suche auch nur eigene Kontakte. 24.6.2 Die Filterung passiert auf dem Server, bevor Treffer im Browser ankommen, es ist nicht möglich, durch geschicktes Suchen Existenz versteckter Einträge abzuleiten. 24.6.3 Trefferanzahl bezieht sich immer auf die für den Mitarbeiter sichtbaren Treffer. 24.6.4 Bei stark reduzierter Anzeige durch Berechtigungen: dezenter Hinweis "Es gibt weitere Treffer, die du aufgrund deiner Berechtigungen nicht siehst" (ohne konkrete Anzahl, damit nicht ableitbar). 24.6.5 Suchanfragen werden im Audit-Log protokolliert (Inhalt der Anfrage, Trefferanzahl, Zeitstempel).

24.7 Zuletzt durchgeführte Suchen

24.7.1 Pro Mitarbeiter werden die letzten 50 Suchen gespeichert (Suchbegriff, gewählte Filter, Trefferanzahl). 24.7.2 Bei leerer Sucheingabe werden die letzten Suchen angezeigt, Klick wiederholt die Suche. 24.7.3 Einzelne Einträge können gelöscht werden, oder alle auf einmal über die Mitarbeiter-Einstellungen. 24.7.4 Auto-Bereinigung: ältere als 90 Tage werden automatisch entfernt. 24.7.5 Zuletzt durchgeführte Suchen sind privat, kein Workspace-Admin sieht sie. Beim DSGVO-Daten-Export des Mitarbeiters sind sie Teil des Exports.

24.8 Wie schnell die Suche ist

24.8.1 Erste Antwort (Stichwort-Treffer) unter 500 ms im Median. 24.8.2 KI-Treffer: 300 ms bei warmer Cache (häufige Anfrage), 1-3 Sek bei kalter Cache (Erst-Anfrage). 24.8.3 Zwischen Tippen und Such-Auslösung 300 ms Wartezeit (sonst würde bei jedem Buchstaben eine Anfrage rausgehen). 24.8.4 Neue oder geänderte Einträge erscheinen 5-10 Sekunden nach der Änderung in der Suche. Klartext-Hinweis falls direkt nach Anlegen gesucht und nicht gefunden: "Neue Einträge erscheinen ein paar Sekunden nach dem Anlegen in der Suche".

24.9 Was passiert wenn die KI-Suche ausfällt

24.9.1 Wenn der primäre KI-Anbieter nicht erreichbar ist, wird automatisch auf den nächsten ausgewichen. 24.9.2 Wenn alle KI-Anbieter ausfallen: Stichwort-Suche läuft trotzdem, Banner im Such-Modal: "Erweiterte semantische Suche ist gerade nicht verfügbar, Treffer kommen nur aus der Volltext-Suche".

24.10 Wer darf die Suche nutzen

Rolle (Bündel) Darf
Kein Zugriff Suche im Header ist ausgeblendet (sehr selten, Standard ist "darf suchen")
Suchen Suche nutzen
Such-Admin Re-Indexierung manuell anstoßen, Index-Statistiken sehen

24.10.1 Was tatsächlich gefunden wird, wird über die Modul-Berechtigungen (CRM, Angebote, Dateien etc.) gesteuert, die Suche selbst hat sehr leichte Berechtigungen.

24.11 Klartext-Hinweise

24.11.1 Keine Treffer: "Keine Treffer für '[Suchbegriff]'. Versuch andere Begriffe oder erweitere den Zeitraum-Filter". 24.11.2 Suchbegriff zu kurz: "Tippe mindestens 2 Zeichen für die Suche". 24.11.3 KI-Suche aus: "Erweiterte semantische Suche ist gerade nicht verfügbar, Treffer kommen nur aus der Volltext-Suche". 24.11.4 Server-Fehler: "Suche ist gerade nicht erreichbar. Bitte in einer Minute nochmal versuchen". 24.11.5 Re-Indexierung läuft (Admin-Aktion): "Such-Index wird neu aufgebaut. Suche kann temporär unvollständig sein. Status: [Fortschritt]%".

24.12 Phase 2 / bewusst NICHT in Phase 1

24.12.1 Gespeicherte Suchen: Mitarbeiter speichert Suchbegriff + Filter unter einem Namen, ruft sie aus Dropdown auf. 24.12.2 Erweiterte Such-Operatoren wie "kontakt:max@firma.de status:aktiv typ:angebot". 24.12.3 Such-Statistik für Workspace-Admins: häufige Suchen, Suchen ohne Treffer (Hinweis auf fehlende Inhalte), Klick-Quote pro Treffer. 24.12.4 Personalisierte Reihenfolge: Treffer-Bevorzugung basierend auf bisherigem Klick-Verhalten. 24.12.5 Mehrsprachige Suche (sobald die Plattform mehrere Sprachen unterstützt). 24.12.6 OCR-Inhalte aus PDFs und Bildern werden mitdurchsucht (sobald OCR aus Modul 23 aktiv ist). 24.12.7 Wiki-Seiten, Mail-Inhalte, Chat-Nachrichten als durchsuchbare Quellen. 24.12.8 Workspace-Admin kann Mischverhältnis Stichwort/KI selbst anpassen.