Files
raffaelandClaude Opus 5.5 d09f79b673 chore(infra): Gitea-Host auf git.hg-int.dev umstellen
Gitea läuft seit 2026-11-11 auf hivegrid-control (git.hg-int.dev);
git.tool-ctrl.de wird abgeschaltet.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-11 18:53:32 +01:00

310 lines
18 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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)**:
- <https://pro.bsport.io> — schlichter Foto-Hero
- <https://plancraft.com/de-de> — 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 <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**:
- Style-Idee: <https://www.cta.gallery/cta/understory>
- Demo-Flow: <https://pro.bsport.io/de/demo>
- **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**: <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):**
- [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: <https://git.hg-int.dev/toolctrl-labs/HiveGrid-Website>
- Live: <https://hivegrid.de>
- 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`