# 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)**: - — schlichter Foto-Hero - — Handwerker-Fokus mit echten Aufnahmen - **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 - Demo-Flow: - **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 ### 9. Lead-Formular im Footer - **Referenz**: — 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 (` | 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):** - [x] SEO Foundation - [x] 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 - Repo: - Live: - Coolify (Deploy): App-UUID `d108flfj9rk5hdm6p4b85er7` - Deploy-Workflow: `.gitea/workflows/deploy.yml` - Design-Tokens: `app/globals.css` - Produkt-Daten: `lib/produkt-daten.ts` - FAQ-Daten: `lib/faqs.ts` - Site-Config (Nav, Footer, Produkte): `lib/site.config.ts`