Files
HiveGrid-Wireframes/hivegrid-cloud/.planning/ENTITY-MODELL-ERKLAERUNG.md
T

165 lines
12 KiB
Markdown

---
pdf_options:
format: A4
margin: 18mm
printBackground: true
css: |-
* { box-sizing: border-box; }
body { font-family: -apple-system, "Segoe UI", Helvetica, Arial, sans-serif; font-size: 11px; line-height: 1.55; color: #1c1c1c; }
h1 { font-size: 23px; color: #b8730a; margin-bottom: 2px; }
h1 + p.sub { color: #777; font-size: 11px; margin-top: 0; margin-bottom: 18px; }
h2 { font-size: 15px; color: #1c1c1c; border-bottom: 2px solid #f5a623; padding-bottom: 4px; margin-top: 26px; break-after: avoid; page-break-after: avoid; }
h3 { font-size: 12.5px; color: #b8730a; margin-top: 16px; margin-bottom: 4px; break-after: avoid; page-break-after: avoid; }
p { orphans: 3; widows: 3; margin: 6px 0; }
ul { margin: 6px 0 6px 0; padding-left: 18px; }
li { margin: 4px 0; orphans: 2; widows: 2; break-inside: avoid; page-break-inside: avoid; }
strong { color: #b8730a; }
.card { break-inside: avoid; page-break-inside: avoid; background: #fafafa; border: 1px solid #ececec; border-left: 3px solid #f5a623; border-radius: 5px; padding: 9px 13px; margin: 9px 0; }
.card h3 { margin-top: 0; }
.flow { break-inside: avoid; page-break-inside: avoid; background: #f6f9fe; border: 1px solid #e2ecf8; border-left: 3px solid #3d7fd6; border-radius: 5px; padding: 9px 13px; margin: 9px 0; }
.flow h3 { color: #2c5fa0; }
.rel { break-inside: avoid; page-break-inside: avoid; margin: 5px 0; padding: 5px 10px; border-left: 2px solid #e0c089; background: #fffdf7; border-radius: 3px; }
.intro { break-inside: avoid; page-break-inside: avoid; background: #fff7e8; border: 1px solid #f0dcb0; border-radius: 5px; padding: 11px 14px; margin: 10px 0 4px 0; }
.note { color: #555; font-size: 10px; font-style: italic; }
table { border-collapse: collapse; width: 100%; font-size: 10px; margin: 6px 0; break-inside: avoid; page-break-inside: avoid; }
th, td { border: 1px solid #ccc; padding: 4px 7px; text-align: left; vertical-align: top; }
th { background: #fff7e8; }
.pagebreak { page-break-after: always; }
---
# Das HiveGrid-Datenmodell — einfach erklärt
<p class="sub">Projekt-zentrisches CRM/Pipeline-Modell · Stand 14.06.2026 · für Design &amp; Produkt (nicht-technisch)</p>
<div class="intro">
<strong>Die Grundidee in einem Satz:</strong> Es gibt <strong>ein zentrales Objekt — das Projekt</strong>. Alles andere ist entweder eine Vorstufe davor (der Lead), eine Brille darauf (die Pipeline), ein Beteiligter (Kontakte, Mitarbeiter) oder etwas, das daran hängt (Termine, Rechnungen, Checklisten, Aufgaben, Dokumente). „Deal" und „Auftrag" sind <strong>keine eigenen Dinge</strong> mehr, sondern nur Namen von Pipelines — also verschiedene Sichten auf dasselbe Projekt.
</div>
## Die Bausteine
<div class="card">
<h3>Lead — die Vorstufe</h3>
Ein Sammelbecken für eingehende Anfragen aus allen Quellen (Formular, Website, Social Media, Liste, CSV, manuell, E-Mail, Anruf). Felder dürfen hier noch leer sein. Der wichtigste Punkt ist die <strong>Weiterverarbeitungsfreigabe</strong> (Ja / Nein / Unklar) — sie ist die Grenze zwischen „nur eine Anfrage" und „echtes Projekt".
</div>
<div class="card">
<h3>Projekt — der Kern</h3>
Der eigentliche Arbeitsdatensatz. Trägt alle festen Angaben (Name, Quelle, Priorität, Start/Deadline, Auftragsvolumen, Adressen, zuständige Person, Projektleiter …) und beliebige <strong>selbst definierte Felder</strong>. Jedes Projekt läuft in <strong>genau einer Pipeline</strong> und steht dort auf <strong>genau einem Status</strong>.
</div>
<div class="card">
<h3>Pipeline — die Brille</h3>
Eine frei benennbare Ansicht auf Projekte („Vertrieb", „Aufträge", „Wartungsverträge" …). Der Admin legt pro Pipeline fest:
<ul>
<li>welche <strong>Status-Schritte</strong> (Spalten) es gibt,</li>
<li>welche <strong>Felder sichtbar oder Pflicht</strong> sind (auch je Status),</li>
<li><strong>wer</strong> die Pipeline sehen und bearbeiten darf.</li>
</ul>
</div>
<div class="card">
<h3>Kontakt — Personen &amp; Organisationen</h3>
Ein Oberbegriff: ein Kontakt ist <strong>entweder eine Privatperson oder eine Organisation</strong>. Dazu kommen ein Status (Kontakt / Kunde / Bestandskunde) und mehrere Erreichbarkeiten. <strong>Hauptkontakt</strong> und <strong>Sekundärkontakt</strong> sind keine Eigenschaft des Kontakts selbst, sondern eine <strong>Beziehung</strong> zwischen Kontakten.
</div>
<div class="card">
<h3>Anhänge am Projekt (Sub-Bereiche)</h3>
Termine, <strong>Rechnungen</strong>, Checklisten (mit Punkten), die <strong>Abnahme</strong> (ein eigenes, nach Unterschrift gesperrtes Protokoll) und — <strong>ab Version 2</strong> — KWP-/Schnittstellen-Felder. „Mängel" ist dabei einfach eine Checkliste mit dem Namen „Mängel".
</div>
<div class="card">
<h3>Querschnitt — hängt überall dran</h3>
<strong>Aufgaben, Aktivitäten (der Verlauf), Dokumente und Tags</strong> können an jeder Sache hängen — an einem Projekt, einem Kontakt oder einem Lead.
</div>
<div class="pagebreak"></div>
## Die Beziehungen — in einfachen Sätzen
<h3>Vom Lead zum Projekt</h3>
<div class="rel">Ein Lead wird zu <strong>höchstens einem</strong> Projekt.</div>
<div class="rel">Ein Projekt entsteht aus <strong>höchstens einem</strong> Lead — kann aber auch direkt ohne Lead angelegt werden.</div>
<div class="rel">Ein Lead kann mit <strong>einem</strong> Kontakt verknüpft werden; der Kontakt bleibt eigenständig.</div>
<h3>Projekt und Pipeline</h3>
<div class="rel">Ein Projekt liegt in <strong>genau einer</strong> Pipeline.</div>
<div class="rel">Eine Pipeline enthält <strong>beliebig viele</strong> Projekte.</div>
<div class="rel">Eine Pipeline hat <strong>mehrere</strong> Status-Schritte; ein Projekt steht immer auf <strong>genau einem</strong> Status-Schritt.</div>
<div class="rel">Eine Pipeline bestimmt selbst, <strong>welche</strong> Felder sichtbar oder Pflicht sind und <strong>wer</strong> sie sehen darf.</div>
<h3>Kontakte</h3>
<div class="rel">Ein Kontakt ist <strong>entweder</strong> eine Privatperson <strong>oder</strong> eine Organisation.</div>
<div class="rel">Ein Kontakt kann <strong>mehrere</strong> E-Mail-Adressen und <strong>mehrere</strong> Telefonnummern haben.</div>
<div class="rel">Eine Organisation kann <strong>mehrere</strong> Hauptkontakte und <strong>mehrere</strong> Sekundärkontakte haben.</div>
<div class="rel">Eine Privatperson kann <strong>selbst</strong> Hauptkontakt sein und zusätzlich <strong>mehrere</strong> Sekundärkontakte haben.</div>
<div class="rel">Ein Kontakt kann an <strong>mehreren</strong> Projekten beteiligt sein, und ein Projekt kann <strong>mehrere</strong> Kontakte haben — jeweils mit einer Rolle (Auftraggeber, Bauherr, Rechnungsempfänger, Ansprechpartner).</div>
<h3>Beteiligte und Adressen</h3>
<div class="rel">Ein Projekt hat <strong>eine</strong> zuständige Person und <strong>einen</strong> Projektleiter.</div>
<div class="rel">Ein Projekt kann <strong>mehrere</strong> Monteure haben, und ein Monteur kann an <strong>mehreren</strong> Projekten arbeiten.</div>
<div class="rel">Ein Projekt hat <strong>eine</strong> Projektadresse und <strong>optional je eine</strong> separate Rechnungs- und Bauherradresse.</div>
<h3>Anhänge am Projekt</h3>
<div class="rel">Ein Projekt kann <strong>beliebig viele</strong> Termine, Rechnungen, Checklisten, Aufgaben und Dokumente haben — jedes davon gehört zu <strong>genau einem</strong> Projekt.</div>
<div class="rel">Eine Checkliste besteht aus <strong>mehreren</strong> Punkten; jeder Punkt gehört zu <strong>genau einer</strong> Checkliste.</div>
<div class="rel">Eine Abnahme gehört zu <strong>genau einem</strong> Projekt, bindet <strong>eine</strong> Mängel-Checkliste ein und sammelt <strong>mehrere</strong> Unterschriften (Kunde und Monteur). Nach der Unterschrift ist sie gesperrt.</div>
<div class="rel">Ein Projekt kann <strong>mehrere</strong> KWP-/Schnittstellen-Felder tragen — <strong>erst ab Version 2</strong> (in Version 1 noch nicht enthalten; KWP-Anbindung kommt nach dem Launch).</div>
<h3>Eigene Felder &amp; Querschnitt</h3>
<div class="rel">Ein Betrieb kann <strong>beliebig viele</strong> eigene Felder definieren; jedes davon lässt sich pro Pipeline ein-/ausblenden und zur Pflicht machen.</div>
<div class="rel">Aufgaben, Aktivitäten, Dokumente und Tags können an <strong>jeder</strong> Sache hängen — Projekt, Kontakt oder Lead.</div>
## Was das für den Nutzer bedeutet
<div class="card">
<strong>1. Der Betrieb baut sich sein CRM selbst.</strong> Jeder SHK-Betrieb legt eigene Pipelines an, benennt sie, blendet Felder ein/aus, macht Felder zur Pflicht und legt fest, wer reinschauen darf — ohne Entwickler.
</div>
<div class="card">
<strong>2. Keine Brüche, keine Doppelerfassung.</strong> Ein Auftrag ist derselbe Datensatz wie der frühere „Deal" — er wechselt nur die Pipeline. Der Verlauf bleibt lückenlos vom ersten Kontakt bis zur Abnahme.
</div>
<div class="card">
<strong>3. Ein klarer Status statt zwei.</strong> „Status" heißt immer: wo steht das Projekt in <em>dieser</em> Pipeline. Kein verwirrender zweiter Gesamtstatus.
</div>
<div class="card">
<strong>4. Flexible Kontaktwelt.</strong> Privatkunden, Firmen mit mehreren Ansprechpartnern, Sekundärkontakte — alles abbildbar, und ein Kontakt taucht überall im richtigen Zusammenhang auf.
</div>
<div class="card">
<strong>5. Rechtssichere Abnahme &amp; Rechnungen am Projekt.</strong> Die Abnahme bleibt unveränderlich mit Unterschrift; Rechnungen lassen sich direkt am Projekt führen.
</div>
## Die Abläufe — so fühlt es sich an
<div class="flow">
<h3>A · Anfrage wird zum Projekt</h3>
Anfrage landet als Lead in der Inbox. Der Sachbearbeiter prüft und setzt die Weiterverarbeitungsfreigabe auf <strong>Ja</strong> → ein Projekt entsteht, die bekannten Daten werden übernommen, der Kunde wird als Kontakt verknüpft. Bei <strong>Nein/Unklar</strong> bleibt es ein Lead.
</div>
<div class="flow">
<h3>B · Projekt wandert durch den Vertrieb</h3>
Im Kanban der Vertriebs-Pipeline zieht man das Projekt von Spalte zu Spalte (= Status). Bei „gewonnen" taucht <strong>dasselbe</strong> Projekt in der Auftrags-Pipeline auf — mit deren Feldern und Schritten. Keine Übergabe, kein Neuanlegen.
</div>
<div class="flow">
<h3>C · Admin richtet eine neue Pipeline ein</h3>
Beispiel „Wartungsverträge": Spalten definieren, festlegen welche Felder sichtbar/pflichtig sind und welche Rollen Zugriff haben. Ab sofort können Projekte dort laufen.
</div>
<div class="flow">
<h3>D · Monteur auf der Baustelle</h3>
Öffnet das Projekt mobil → Abnahme-Checkliste abarbeiten, Mängel mit Foto und Schweregrad erfassen → Kunde und Monteur unterschreiben auf dem Display → Protokoll wird gesperrt und als PDF abgelegt. Funktioniert <strong>offline</strong>.
</div>
<div class="flow">
<h3>E · Büro arbeitet am Projekt</h3>
Rechnung am Projekt anlegen, Termin einplanen, Aufgabe an einen Kollegen zuweisen, Dokument anhängen — alles hängt am selben Projekt.
</div>
<div class="flow">
<h3>F · Kontaktpflege mit Rückschreiben</h3>
In der Projektansicht steht die Telefonnummer des Auftraggebers; man ändert sie direkt dort → die Änderung wird <strong>auf den Kontakt zurückgeschrieben</strong> (das Feld „gehört" dem Kontakt, wird nur im Projekt angezeigt). Der Verlauf hält fest, wer wann was geändert hat.
</div>
<div class="intro">
<strong>Kurz:</strong> ein Datensatz, viele konfigurierbare Brillen. „Vertrieb" und „Auftrag" werden über die Pipeline-Konfiguration unterschieden statt über getrennte Datentöpfe — flexibler für den Betrieb. <span class="note">Die sorgfältig durchdachte Stelle dabei sind Sichtbarkeit &amp; Rechte pro Pipeline — voll ausgebaut: einzelne Felder lassen sich <strong>pro Rolle/Gruppe</strong> ein- oder ausblenden (z.B. das Auftragsvolumen nur für den Vertrieb).</span>
</div>