Files

18 KiB
Raw Blame History

HiveGrid Website — Rework-Mapping

Arbeitsgrundlage für Team + KI-Agenten während des Landing-Reworks. Nicht für User. Lebendes Dokument — bei Bedarf anpassen.

Zweck: Mapping-Arbeit sichtbar machen — welche Sektion existiert wo, in welchem Zustand, was ist zu tun, welche Referenzen. So können Dejan, Haris, David und die KI parallel und ohne Rückfragen weiterarbeiten.


Team & Rollen

Person Rolle
Dejan Grundgerüst, Layout, Elemente, Animationen, Infra, Deployment
Haris Marketing-Texte. Kommt ins Spiel, sobald Dejan das Grundgerüst mit Platzhaltern gebaut hat und die Placeholder gegen finale Texte getauscht werden.
David Screens/Screenshots (teils animiert) aus der echten HiveGrid-Software. Ersetzen die aktuellen Placeholder-Screens.
Noah Mitgründer / Handwerksmeister. Ansprechpartner für Content-Entscheidungen (Newsletter, Testimonial-Video, Story).

Environments

Live — hivegrid.de

  • Aktuell noch der v1-Stand von damals.
  • Deployed aus Branch main via .gitea/workflows/deploy.yml → Coolify (App-UUID d108flfj9rk5hdm6p4b85er7).

Dev — dieser Repo, Branch dejan

  • Aktueller Arbeits-Branch.
  • Route /playground = Prototyp der neuen Landing. Wird später zur Startseite (/).
  • Die aktuelle / = Ableger von v1, bleibt bis Playground produktionsreif ist.
  • Playground ist in Production per notFound() gesperrt + noindex (siehe app/playground/page.tsx).

Vorlage / Inspiration

  • /Users/dejancosic/Downloads/hivegrid-v3.html — Haris' Vorarbeit, lokal auf Dejans Rechner (nicht im Repo).
  • Nur zur Inspiration. Keine finalen Texte, Reihenfolge nicht bindend.

User-Journey (Zielaufbau der neuen Landing)

Reihenfolge auf /playground iterieren, dann in die echte Landing migrieren. Jede Sektion ist unten mit Element-Referenz, Code-Pfad, Status und offenen Punkten gemapped.

1. Hero — Menschlichkeit

  • Idee: echtes Foto oder kurze Video-Aufnahme aus unserem Büro. Kein rendered Dashboard-Screenshot mehr. Transportiert Schlichtheit + „vom Handwerker für den Handwerker", nicht vibe-coded.
  • Referenzen (Inspiration):
  • Aktuell auf /playground: Text-Hero „Verknüpfen statt ersetzen" mit Honeycomb rechts — wandert zu Sektion 2.
  • TODO:
    • Hero neu bauen als Foto/Video-First-Hero
    • Asset von David (Bürofoto/-video)
    • Kernbotschaft-Copy von Haris

2. Pain-Point — „Verknüpfen statt ersetzen"

  • Element: Honeycomb mit Tool-Logos (kwp, DATEV, Google Drive, Teams, Outlook, Google Calendar) + zentralem HiveGrid-Hub, verbunden über glimmende Datenlinien.
  • Code: app/playground/HoneycombSection.tsx
  • Status: gebaut ✅ (bare + inline Varianten für lg+ und <lg)
  • Details: Kernbestandteil dieser Sektion. Drum herum: spezifische Probleme + spezifische Zahlen (Copy von Haris).

3. Lösungen — ScreenshotAccordion („Scroller")

  • Element: Interaktiver Modul-Scroller. Links Accordion mit Modul-Namen, rechts Screenshot des aktiven Moduls. Auto-Cycle + Klick.
  • Code: components/sections/ScreenshotAccordion.tsx
  • Aktuell auf hivegrid.de: Module „Verwaltung, Planung, Baustelle, Services" mit Screenshots pro Modul.
  • Status: existiert ✅ — Content pflegen (Module + Verweise auf /produkt/*)
  • TODO:
    • Placeholder-Screens (public/images/screenshot-*.webp) durch echte Software-Screens von David ersetzen
    • ggf. Modul-Liste an neue Produkt-Struktur angleichen

4. Noahs Geschichte

  • Element: Dark Section mit Noah-Foto + Gründer-Story-Text.
  • Code: app/playground/PlaygroundClient.tsx (Story-Section, #0f1a2e Background, 2-Col-Layout ab lg)
  • Status: existiert auf /playground ✅, aber muss umgebaut und cooler werden.
  • TODO:
    • Design-Overhaul (Prototyp auf /playground iterieren)
    • Idee: Video statt/zusätzlich zum Foto — Noah erzählt die Story on-camera
    • Text-Feinschliff mit Haris

5. Vergleich — HiveGrid vs. andere Lösungen

  • Element: Existiert bereits in Haris' Vorlage /Users/dejancosic/Downloads/hivegrid-v3.html
  • Status: nach /playground portieren
  • TODO: Element aus HTML-Vorlage übernehmen, in HiveGrid-Tokens/Tailwind übersetzen, in Playground einbauen

6. DSGVO-Sicherheit — Pattern Interruption

  • Element: Auch in Haris' HTML-Vorlage
  • Details: „Pattern Interruption" = bewusster Design-Bruch. Andere Farbe als Brand Identity (nicht Yellow/Teal), damit das Auge stolpert und die DSGVO-Message hängen bleibt. Ist so gewollt und soll bleiben.
  • Status: nach /playground portieren
  • TODO: Übernehmen aus HTML-Vorlage, Farb-/Style-Bruch beibehalten

7. FAQ

  • Element: Accordion-FAQ
  • Code: components/sections/FAQSection.tsx, Daten in lib/faqs.ts
  • Status: existiert auf live und dev ✅ — passt so
  • TODO: keine (evtl. Content-Refresh mit Haris)

8. CTAs — „Understory"-Style vereint mit HiveGrid-Design

  • Referenzen:
  • Aktuell auf live: gelbe CTA-Section mit „Demo buchen" + „Kontakt" Buttons (siehe components/ui/CTABanner.tsx)
  • Plan: Kombinieren
    • Understory-Layout (cooles Bild + starke Headline + CTA-Reihe)
    • HiveGrid-Farben (gelber Section-BG wie aktuell live)
    • Beide Buttons: „Demo buchen" (primär → Lead-Formular) + „Kontakt" (sekundär)
  • TODO:
    • CTABanner.tsx erweitern um Image-Slot
    • Bild-Asset von David
    • Layout an Understory anlehnen, Style-Tokens (Yellow) behalten
  • Referenz: https://tool-ctrl.de — Footer-Formular
  • Aktuell auf live: Lead-Formular nur unter /demo. Footer hat nur Newsletter + Links.
  • TODO:
    • Formular in components/layout/Footer.tsx einbauen (analog tool-ctrl.de Footer)
    • Dasselbe Backend nutzen wie /demo → POST /api/demo-request (siehe Lead-Flow unten)

10. Newsletter

  • Status: TBD mit Noah — entscheiden ob Newsletter bleibt oder raus.
  • Aktuell: Newsletter-Signup in components/layout/Footer.tsx eingebaut (+ Flow-Seiten unter /newsletter/*).
  • TODO: Abstimmung Noah → Entscheidung ja/nein → ggf. Newsletter-UI + Routes entfernen

Element-Inventar & Cross-Mapping

Chronologisches Inventar jeder der drei Landingpages, gefolgt von einer Cross-Mapping-Tabelle, die zeigt welche Sektion welchen Zweck auf welchem Stand erfüllt. Basis für die Entscheidungen: übernehmen / umbauen / droppen / verschieben.

Inventar — hivegrid.de (Live, v1)

Quelle: app/page.tsx auf main.

# Element (Code) Beschreibung Zweck
1 HeroSection Badge „SHK-SOFTWARE", Headline „Ihr Betrieb läuft organisiert, automatisiert und effizient.", Sub-Copy, 2 CTAs, Dashboard-Screenshot rechts, heyData-DSGVO-Siegel als Overlay Wertversprechen + Handlungsaufforderung
2 ScreenshotAccordion Badge „LÖSUNG"; „Der effizienteste Planungs- und Vertriebsprozess."; Modul-Accordion (Verwaltung / Planung / Baustelle / Services) mit Auto-Cycle + Screenshot rechts Module durchklickbar zeigen
3 FeaturesGrid 6 Feature-Cards mit Lucide-Icons (die 6 Produkte) Produkt-Overview
4 ChatDemoSectionClient Interaktive Phone-Preview mit Rules-basierten Antworten aus lib/chat-demo/assistant.ts „Wie fühlt sich das an"-Demo
5 HowItWorksSection 4 Schritt-Karten (01–04) mit Screens: Workflow erstellen → Trigger → Aktionen → Aktivieren Prozess erklären
6 AdvantagesSection 4 Vorteil-Kacheln (DSGVO, Mobile, Speed, Support) + heyData-Siegel Trust / USPs
7 CTABanner (1) „Bereit, Ihren Betrieb zu digitalisieren?" — 1 CTA (Demo) Mid-Page-CTA
8 FAQSection 6 FAQ (Datenquelle: lib/faqs.ts) Einwände abbauen
9 CTABanner (2) „Starten Sie jetzt mit HiveGrid." — Demo + Kontakt Final-CTA

Inventar — /playground (Dev, Branch dejan)

Quelle: app/playground/PlaygroundClient.tsx.

# Element (Code / Ort) Beschreibung Zweck
0 Dev-Marker (inline) Gelber Streifen „DEV PLAYGROUND — nicht live" Kennzeichnung als Prototyp
1 Hero (inline) + HoneycombSection „Verknüpfen statt ersetzen." mit Yellow-Highlight, 2 CTAs; Honeycomb als Full-Bleed-BG rechts (lg+) bzw. inline unter Text (<lg) Hook + Kernbotschaft + Tool-Visual
2 Noah-Story (inline) Dark Section (#0f1a2e), Noah-Foto + Story „Die Geschichte fängt auf der Baustelle an." + Autor-Card Social Proof / Origin
3 Feature-Grid (inline) 6 Feature-Karten (analog Live, Placeholder-Text) Produkt-Overview
4 Stats-Section (inline) 3 GSAP-Count-Up KPIs (1200+ Betriebe, 8 Std/Woche gespart, 99,9 % Verfügbarkeit) Zahlen-Wirkung
5 How-it-works (inline) 3 Schritt-Karten mit scrub-Progress-Linie (Einrichten / Verbinden / Automatisieren) Prozess minimalistisch
6 Dark CTA banner (inline) „Ein Call-to-Action mit Nachdruck." — Demo + Kontakt Mid/Final-CTA
7 FAQ (inline, playground-eigene 4 Fragen) Placeholder-<details> FAQ als UI-Demo, kein Live-Content

Inventar — hivegrid-v3.html (Haris' Vorlage)

Quelle: /Users/dejancosic/Downloads/hivegrid-v3.html. Nur Landing (Modul-Page und globaler Footer weggelassen).

# Element (v3) Beschreibung Zweck
1 Hero „Dein ganzer Betrieb. Endlich auf einen Blick." Gründer-Illustration (2 Handwerker Rücken-an-Rücken), 2 CTAs, 3 Trust-Badges, Float-Badge „∞ Eine Plattform statt 7 Insellösungen" Wertversprechen + Menschlichkeit
2 Proof Strip Partner-Logo + Stats „7 → 1 Programme" + Zeit-Ersparnis Instant Social Proof
3 Problem Section „Das Problem: Wechseln? Lieber nicht." 3 Cards + Chaos-Visual (7 zerstreute Tools) Pain-Point konkret machen
4 Solution Section „Die Lösung: Wir bauen auf dem auf, was du schon hast." 3 Bullets + Workflow-Flow-Diagramm Lösungs-Positioning
5 Story Section Navy-BG, Noah-Foto, Story + 3 Stats (7 Programme → 1 Plattform → X Std/Woche) Social Proof + Origin
6 Compare Section „Andere Lösungen vs. HiveGrid" — 2-Spalten-Vergleich mit X/✓, EMPFOHLEN-Pill Wettbewerbs-Abgrenzung
7 Trust Band Teal-BG (Pattern Interruption); Deutschland-Flagge + „100 % Made in Germany" + 4 Trust-Items Vertrauen (DSGVO) mit visuellem Bruch
8 Final CTA Navy-BG „In 30 Minuten siehst du deinen ganzen Betrieb" + 2 CTAs (Demo + Erstgespräch) + „Kein Vertrag / keine Kreditkarte" Final-Aktion
9 About Founders „Über uns: Zwei Welten. Ein Team." 2 Gründer-Kacheln (Handwerk & Technik) Team-Vorstellung

Cross-Mapping (Zweck × Stand)

Zeigt für jeden Zweck / jede Journey-Rolle, welche Sektion sie auf welchem Stand erfüllt. Leere Zelle = nicht vorhanden.

Zweck / Journey-Punkt hivegrid.de (Live) /playground (Dev) v3.html (Haris)
Hook / Wertversprechen (Hero) #1 HeroSection (Dashboard-Screenshot) #1 Text-Hero + Honeycomb #1 Gründer-Illustration + Float-Badge
Instant Social Proof — — #2 Proof Strip
Pain-Point (Journey 2) — #1 Honeycomb (visuell) #3 Problem + Chaos-Visual
Lösungs-Positioning — — #4 Solution + Flow-Diagramm
Modul-Übersicht als Scroller (Journey 3) #2 ScreenshotAccordion ✅ — (auf v3-Modul-Page, nicht Landing)
Produkt-Cards (Sekundär-Overview) #3 FeaturesGrid #3 Feature-Grid —
Chat-Demo (Live-only) #4 ChatDemoSectionClient — —
Wie funktioniert's #5 HowItWorksSection #5 How-it-works (in Solution enthalten)
KPI-Zahlen — #4 Stats (GSAP Count-up) (in Story enthalten)
Trust / Vorteile #6 AdvantagesSection + heyData — #7 Trust Band
Story / Noah (Journey 4) — #2 Dark Story #5 Navy Story
Vergleich vs. andere (Journey 5) — — #6 Compare Section ✅
DSGVO + Pattern Interruption (Journey 6) (nur als Kachel in Advantages) — #7 Teal Trust Band ✅
FAQ (Journey 7) #8 FAQSection ✅ #7 (Placeholder-Content) —
CTAs (Journey 8) #7 + #9 CTABanner #6 Dark CTA #8 Navy Final CTA
Über uns / Team (eigene Page /ueber-uns) — #9 About Founders

Legende: ✅ = bevorzugte Quelle für die neue Landing.

Beobachtungen zur weiteren Diskussion:

  • v3-Elemente Proof Strip (#2), Problem (#3), Solution (#4) existieren aktuell weder auf Live noch auf Playground → komplett neu bauen oder aus HTML portieren
  • Compare (#6, v3) und Trust Band mit Pattern Interruption (#7, v3) existieren nur auf v3 → aus HTML portieren (siehe Journey-Punkte 5 & 6)
  • ChatDemo existiert nur auf Live → Entscheidung: übernehmen oder droppen? (nicht in Journey enthalten)
  • HowItWorksSection existiert auf Live und Playground → auf Playground stark reduziert (3 statt 4 Schritte, minimalistischer). Entscheidung: welche Version behalten?
  • AdvantagesSection (Live) und v3 Trust Band überlappen konzeptionell → nur eine Variante auf der neuen Landing
  • Playground-Hero (Text + Honeycomb) wird laut Journey verschoben: Hero (1) wird echtes Foto/Video, Honeycomb rutscht in Sektion 2 (Pain-Point)

Content-Status

  • Alle Texte auf /playground sind Platzhalter (Lorem / wip-Wording).
  • Placeholder-Screens liegen in public/images/screenshot-*.webp und public/images/step-*.webp. Werden durch Davids echte Screens ersetzt.
  • Finale Texte kommen von Haris, sobald das Grundgerüst steht.

Konvention: Platzhalter mit TODO(haris) oder // PLACEHOLDER markieren, damit sie beim Text-Swap gefunden werden. Placeholder-Screens einheitlich in public/images/ benennen.


Lead-Flow

Details: app/api/demo-request/route.ts + lib/db/demo-requests.ts

Form → POST /api/demo-request
      ↓
   forwardToInbox()                       ← primary
      → POST {LEAD_INBOX_URL}/v1/leads
        Authorization: Bearer {LEAD_INBOX_KEY}
      ↓ (ok?)
      ja → ✅ fertig
      nein → insertDemoRequest() → /app/data/demo-requests.db (SQLite fallback)
  • LEAD_INBOX_URL + LEAD_INBOX_KEY als Env-Vars in Coolify setzen → Leads gehen an die zentrale Inbox.
  • ⚠️ SQLite-Fallback ist ephemer: In infrastructure/docker-compose.production.yml ist kein Volume für /app/data gemountet → jedes Deployment löscht die Fallback-DB. TODO: hivegrid_leads:/app/data Volume ergänzen, falls Fallback verlässlich sein soll.
  • Kein Admin-UI: Fallback-Leads nur via docker exec auslesbar.

SEO — Fundament erledigt

Siehe Commit d84175e feat(seo): SEO foundation.

Geliefert:

  • robots.ts, sitemap.ts, manifest.ts, opengraph-image.tsx (+ twitter re-export)
  • JSON-LD global: Organization, WebSite; Home: FAQPage; Produktseiten: SoftwareApplication + BreadcrumbList
  • Erweiterte Metadata + Canonical + Twitter Cards + Security Headers
  • Client-only Pages (/kontakt, /demo, /newsletter/abmelden) in Server-Wrapper + *Form.tsx gesplittet, damit metadata exportierbar
  • Hero-Screenshot auf next/image mit priority (LCP-Win)

Offen:

  • Google Search Console: Verifizierungs-Token in app/layout.tsx → metadata.verification.google eintragen.
  • Optional: statisches og-default.png (aktuell wird OG-Bild programmatisch generiert).
  • Rechtlich klären: /agb-Body nennt „HiveGrid GmbH" + „Gerichtsstand Hamburg", /impressum sagt „R&D² UG (haftungsbeschränkt)" in Bruchsal. Ausrichten.

Konventionen

  • Sprache: UI = Deutsch. Code-Kommentare = Englisch.
  • Next.js 16: breaking changes zu älteren Versionen — vor Code-Änderungen Docs in node_modules/next/dist/docs/ prüfen (siehe AGENTS.md).
  • Prototyping: neue Sektionen/Animationen zuerst auf /playground bauen, dann in die echte Landing übernehmen.
  • Tailwind v4 (@tailwindcss/postcss), Design-Tokens in app/globals.css als CSS-Variablen.
  • Animationen: GSAP + useGSAP in Client Components, alles hinter prefers-reduced-motion gaten.

Roadmap

Build (Dejan / KI):

  • SEO Foundation
  • Playground scaffolding (Hero mit Honeycomb, Noah-Story, Feature-Grid, Stats, How-it-works, CTA, FAQ)
  • Hero (1) neu bauen als Foto/Video-First-Hero
  • Pain-Point-Sektion (2) um Honeycomb herum bauen (Text + Zahlen)
  • ScreenshotAccordion (3) auf Playground einbauen, an neue Produkt-Struktur angleichen
  • Noah-Story (4) redesignen (Prototyp-Iterationen)
  • Vergleichs-Sektion (5) aus Haris' HTML portieren
  • DSGVO-Sektion (6) mit Pattern Interruption aus Haris' HTML portieren
  • CTA-Sektion (8) im „understory"-Stil bauen (Image-Slot in CTABanner.tsx)
  • Lead-Formular in Footer (9) integrieren
  • Playground → echte Landing migrieren (/playground Content wird zu /)

Content / Assets:

  • Haris: Platzhalter-Texte durch finalen Content ersetzen (TODO(haris) Marker suchen)
  • David: Bürofoto/-video für Hero (1)
  • David: echte Software-Screens für ScreenshotAccordion (3) → ersetzen public/images/screenshot-*.webp
  • David: Bild für neue CTA-Sektion (8)
  • Noah: Entscheidung Newsletter ja/nein (10)
  • Noah: ggf. Testimonial-Video für Story-Sektion (4)

Infra / Legal:

  • Lead-Inbox Volume-Mount in production docker-compose (falls SQLite-Fallback zählen soll)
  • Rechtliche Entity-Klärung (GmbH vs. UG) → AGB-Body + Footer-Copyright angleichen
  • Google Search Console verifizieren + Token in metadata.verification.google eintragen

Release:

  • Merge dejan → main → Deploy → hivegrid.de auf neue Version

Nützliche Referenzen