Files

314 lines
16 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 — Offene Punkte
Living-Doc: was an der neuen Landing unter `/` noch offen ist. Nicht nur Polish,
sondern auch inhaltliche/strukturelle Themen. Das historische Sektions- und
Journey-Mapping liegt im temporären Landingpage-Archiv.
**Stand:** 29.07.2026 · Arbeits-Branch `dejan` → Merge nach `main` deployt
automatisch auf **staging.hivegrid.de**. Prod (`hivegrid.de`) nur per manueller
Promotion (siehe `docs/deployment.md`).
## Reihenfolge (Logik)
Erst **Struktur** (was steht überhaupt auf der Seite), dann **Inhalte** füllen,
dann **Mobile** polieren. So wird nichts doppelt angefasst.
| # | Punkt | Phase | Prio | Wer |
|---|-------|-------|------|-----|
| 1 | ~~Pain-Stats-Cards evaluieren~~ ✓ bleiben drin | Struktur | — | Dejan |
| 2 | ~~MCP-Subpage + Nav~~ ✓ „KI-Brücke" live (Drittanbieter-Naming Rest) | Struktur | — | Dejan · Team |
| 3 | Echte Screens in den Scroller | Inhalt | Mittel | David |
| 4 | Echte Preise | Inhalt | Mittel | Noah |
| 5 | Text-Review (final) | Inhalt | Hoch | Haris |
| 6 | Mobile-Optimierung | Polish | Hoch | Dejan |
| 7 | Hero-Video spielt auf Prod nicht (Safari · CDN-gzip) | Technik | Hoch | Dejan |
| 8 | Noah-Video in Story-Sektion embedden (wenn Noah es schickt) | Inhalt | Mittel | Dejan · Noah |
| 9 | Alte Team-Fotos raus (wenn alle neuen da) | Inhalt | Niedrig | Dejan · Team |
| 10 | ~~Waitlist: „So geht's weiter" animieren~~ ✓ Scroll-Timeline | Struktur | — | Dejan |
| 11 | Landing-Scroller: Module + Texte getauscht ✓ · Screens offen | Inhalt | Mittel | David → Dejan |
| 12 | Leads: Ziel validieren + End-to-End-Testing | Technik | Hoch | Dejan |
| 13 | ~~Waitlist: Subpage-Module als Carousel~~ ✓ „Das bekommst du" | Struktur | — | Dejan |
| 14 | ~~Pricing: Blur-Text nicht markier-/kopierbar~~ ✓ | Technik | — | Dejan |
| 15 | ~~MCP / KI-Brücke — Feinschliff~~ ✓ (Screens/Text-Review offen) | Polish | — | Dejan |
| 16 | Webinar-Software researchen + `/webinare`-Seite bauen | Inhalt | Mittel | Dejan |
| 17 | Über-uns: Struktur + Texte ✓ · **Fotos** offen | Inhalt | Mittel | David → Dejan |
| 18 | Geerkens-Kunden-CTA unter Noah später neu bewerten | Struktur | Niedrig | Team |
---
## Phase A · Struktur & Scope (zuerst)
Entscheidungen, die das Layout/den Umfang der Seite verändern. Müssen zuerst
fallen, sonst basieren Text-Review und Mobile-Pass auf einem beweglichen Ziel.
### 1. Pain-Stats-Cards evaluieren (7 · 5,4 h · 0) — ✓ ERLEDIGT (23.07.2026)
**Entscheidung: bleiben erstmal drin.** Layout der Sektion damit fixiert, Text-Review
und Mobile-Pass können darauf aufsetzen. (Zahlen ggf. später mit Noah/Haris belegen.)
Die drei Metrik-Cards unter dem Honeycomb (`painStats` in
`components/landing/LandingPageClient.tsx`) — ursprünglich zu prüfen, ob überhaupt nötig.
- Wirken sie belegt/mehrwertig oder generisch/erfunden?
- Optionen: streichen · durch **echte, belegbare Zahlen** (mit Quelle) ersetzen ·
anders inszenieren.
- **Warum zuerst:** streichen/ersetzen ändert das Layout der Sektion → betrifft
Text-Review und Mobile.
- Entscheidung mit Noah/Haris.
### 2. MCP-Subpage + weitere Drittanbieter-Integrationen — ✓ ERLEDIGT (Subpage) (29.07.2026)
**Subpage steht + ist verlinkt.** Route `/ki-anbindung`, Nav- und Footer-Eintrag
**„KI-Brücke"** (`lib/site.config.ts`). 9 Sektionen aus `MCP-SUBPAGE-CONTENT.md`
gebaut, Framing „In Kürze / Early Access", vom Team nachgeschärft (echte
Client-Logos, Codex statt ChatGPT, Redesign). Scope-Entscheidung damit gefallen.
- **Kurz-Verständnis (bleibt als Referenz):** HiveGrid hostet keine eigene KI,
sondern ist über einen MCP-Server **KI-anschließbar** — externe Clients docken
per OAuth 2.1 an, lesen Daten und führen freigegebene Aktionen aus. „Verknüpfen
statt ersetzen".
- **Rest offen:** „Technischer Steckbrief" (Endpoints/OAuth/Scopes) wurde aus dem
Deck übernommen und ist **nicht** gegen `HiveGrid-Cloud/apps/mcp` verifiziert →
vor Prod-Vermarktung gegenprüfen. Und: **weitere Drittanbieter** im Honeycomb
benennen (**Bauhow** u. a.; aktuell: kwp, DATEV, Google Drive, Teams, Outlook,
Google Calendar).
- Subpage-Copy geht in den finalen Text-Review (#5) mit ein.
---
## Phase B · Inhalte befüllen (wenn Struktur steht)
### 3. Echte Screens in den Scroller (ScreenshotAccordion)
Das Lösungs-Modul (`components/sections/ScreenshotAccordion.tsx`) zeigt aktuell
**Platzhalter-Screens**.
- Ersetzen durch echte Software-Aufnahmen von **David** (teils animiert).
- Assets: `public/images/screenshot-*.webp`, `public/images/step-*.webp`.
- Betrifft auch die Produktseiten-Accordions (`lib/produkt-daten.ts`).
- Ggf. Modul-Liste an die finale Produkt-Struktur angleichen.
### 4. Echte Preise
`/preise` (`app/preise/page.tsx`) nutzt **erfundene Pakete ohne Preise**
(Angebots-Modell, „Angebot anfordern").
- Finale Paket-Struktur, Feature-Zuordnung und – falls gewünscht – echte
Preise mit **Noah** festlegen.
- `PLACEHOLDER`-Kommentar ist im File hinterlegt.
### 5. Text-Review (final — bewusst spät)
Alle Copy auf der neuen Landing + Pricing ist **Platzhalter/wip** (Du-Voice).
- Finale Texte von **Haris**; Marker `TODO(haris)` / `PLACEHOLDER` suchen.
- Betroffen: Hero-Botschaft, Pain-Points, Story (Noah), FAQ, CTA-Copy,
Pricing-Paketnamen + Feature-Listen, ggf. MCP-Seite.
- **Warum spät:** braucht finalen Content (Preise, MCP, Screens) — sonst wird
zweimal gelesen.
---
## Phase C · Polish (zum Schluss)
### 6. Mobile-Optimierung (großes Paket)
Die neue Landing + Subpages sind **Desktop-first** gebaut. Mobile braucht einen
eigenen, systematischen Durchgang. **Absichtlich ganz am Ende**, damit Inhalt
und Struktur erst final sind und nicht doppelt angefasst werden.
- **Schon unterwegs gefixt:** Hero-Scroll-Jitter (`dvh` → `svh`), Showcase-Card
auf Mobile ausgeblendet, Problem-Card-Badges auf Mobile zentriert, Honeycomb
stapelt unter `lg`.
- **Offen:** kompletter Sweep aller Sektionen auf realen Geräten — Hero,
Honeycomb-Feld, Scroller, Story, CTAs, Pricing, Chat, Footer-Formular. Dazu
Touch-Targets, Font-Scaling, Abstände, Overflow-Checks.
---
## Phase D · Technik / Deployment
### 7. Hero-Video spielt auf Prod nicht (Safari) — CDN-Kompression
Das Hero-Video (`/videos/hero-test.mp4`, eingebunden in
`components/landing/LandingPageClient.tsx`) läuft auf **Staging** und in **Chrome**,
aber in **Safari auf Prod** nicht — läuft kurz an, stockt, bleibt stehen.
- **Ursache (gemessen):** Prod hinter **Cloudflare** liefert das mp4
**gzip-komprimiert** (`content-encoding: gzip`). Ein komprimierter Stream lässt
sich nicht in Byte-Ranges zerlegen → CF antwortet `200` (ganze Datei) ohne
`Accept-Ranges` statt `206`. **Safari** braucht für `<video>` zwingend
Range/`206` → stockt. Chrome lädt die ganze Datei und spielt → daher
browser-inkonsistent. **Staging** (kein CDN davor) liefert `206` → dort ok.
Das Asset selbst ist einwandfrei (H.264, faststart, 2,2 MB).
- **Schon erledigt (im Repo, gemerged):**
- `Cache-Control: … no-transform` für `/videos/*` (`next.config.ts`) — korrektes
Origin-Signal, **CF ignoriert es aber** (gemessen).
- CI-Step **„Ensure Cloudflare leaves /videos uncompressed"** in
`.gitea/workflows/promote.yml` (+ Standalone `scripts/cf-disable-video-compression.sh`):
setzt per CF-API eine Compression-Rule `/videos/* → off`, idempotent, direkt
vor dem bestehenden Cache-Purge.
- **Noch offen / manuell nötig:** Nach dem Promote ist Live **weiterhin gzip** →
der Auto-Step greift nicht, sehr wahrscheinlich weil der **CF-Token nur
Cache-Purge** darf, **nicht** Rulesets schreiben. Zu tun (eins von beiden):
1. **CF-Token** um Permission **„Zone → Config Rules: Edit"** erweitern → dann
macht der Promote-Step es künftig automatisch. *(nachhaltig)*
2. **Oder einmalig im CF-Dashboard:** Rules → Compression Rules → `URI Path`
starts with `/videos/` → **Compression: Off** → dann Cache purgen.
- **Verifizieren** (Ziel: `206` · `accept-ranges` · **kein** `content-encoding`):
`curl -sI -H 'Range: bytes=0-1023' https://hivegrid.de/videos/hero-test.mp4`
- **Falls danach immer noch gzip:** dann komprimiert nicht CF, sondern der
**Prod-Origin** (Coolify/Traefik) selbst → dort gzip für `video/*` abschalten
(Staging hat es aus).
- **Kein Notfall:** Der Hero hat ein `poster`-Standbild als Fallback, die Seite
bricht also nicht — es fehlt nur das Bewegtbild in Safari.
---
## Weitere Todos (aufgenommen 29.07.2026)
### 8. Noah-Video in die Story-Sektion embedden
Die dunkle Noah-Story-Sektion (`components/landing/LandingPageClient.tsx`) zeigt
aktuell nur das Standbild `/images/team/noah.webp` (Play-Button wurde entfernt,
da noch kein Video da).
- Sobald **Noah** das Founder-Story-Video schickt: als echtes `<video>` einbinden
(Poster = jetziges Standbild, `playsInline`, Controls oder Klick-to-Play).
- **Achtung Prio #7:** dasselbe CDN-/Range-Thema wie beim Hero — Video unter
`/videos/` ablegen, damit die `no-transform`/Compression-Regel greift.
### 9. Alte Team-Fotos ersetzen
- Die aktuellen Team-Bilder (`public/images/team/*`, u. a. auf `/ueber-uns`) sind
teils Platzhalter/alt.
- **Raus, sobald alle neuen Fotos vorliegen** — gesammelt tauschen, nicht
stückweise (einheitlicher Look, Crop, Format).
### 10. Waitlist: „So geht's weiter" animieren — ✓ ERLEDIGT (29.07.2026)
Die „So geht's weiter"-Sektion (`app/waitlist/WaitlistNext.tsx`) als
**Scroll-Progress-Timeline** neu gebaut: mitlaufende Fill-Linie (GSAP
ScrollTrigger), Waben leuchten beim Erreichen auf, Icon in der Wabe,
Schrittzahl daneben. `prefers-reduced-motion`-Fallback. Name unverändert.
### 11. Landing-Scroller: die 4 Module tauschen — ✓ CONTENT DONE, Screens offen (29.07.2026)
Der Lösungs-Scroller (`components/sections/ScreenshotAccordion.tsx`, Daten
`solutionModules` in `components/landing/LandingPageClient.tsx`) hat jetzt die gültigen 4 Module.
**Struktur, Reihenfolge und Texte sind fertig** (Copy auf Basis von
`hivegrid-cloud` recherchiert, nicht geraten):
1. **Projektmanagement** — bleibt (Slot 1)
2. **Workflow-Engine** — no-code Wenn-Dann → `/produkt/workflow-engine`
3. **Chat** — Auto-Projektkanäle, Foto → Projektdatei, Nachricht → Aufgabe → `/produkt/chat`
4. **Form Builder** — Drag-&-drop-Formulare, Link/QR/Embed, Einsendung → Lead/Auftrag
- **Offen — Screens (Blocker):** die echten Screens kommen von **David**, werden
dann von **Dejan** eingebaut. Aktuell: Slot 1 hat seinen Screen (Kanban-Screen
kommt noch), Slot 2 hat einen Platzhalter (`screenshot-planung.webp`), Slots
3+4 zeigen den generierten Platzhalter. Assets → `public/images/`.
- **Form Builder hat noch keine Subpage** (`/produkt/*`) → href bewusst weggelassen
(kein „Mehr zu"-Link). Wenn eine `/produkt/formulare`-Seite kommt, dranhängen.
- **Überschneidung mit #3** (Echte Screens) — dies ist die konkrete Modul-Liste dazu.
### 12. Leads: Ziel validieren + Testing
- **Prüfen, wohin Leads tatsächlich landen:** Waitlist-Formular (`/waitlist`) und
Footer-/Kontakt-Formular — Backend/Webhook/E-Mail-Ziel verifizieren.
- **End-to-End testen** (echte Testeinsendung ankommen sehen), inkl.
Fehlerfälle/Doppelsendung.
- DSGVO im Blick: wo werden die Daten gespeichert, Double-Opt-in falls Marketing.
### 13. Waitlist: Subpage-Module als Carousel — ✓ ERLEDIGT (29.07.2026)
Sektion **„Das bekommst du"** (`app/waitlist/WaitlistModules.tsx`) nach der
Timeline: Carousel mit den echten interaktiven Modulen (Chat, E-Mail-Builder,
Kanban, Workflow-Editor, Freigaben — **Vertrieb ausgenommen**), display-only
(`inert` + `pointer-events:none`), Peek+Fade-Frame, „Live ausprobieren"-CTA je
Modul zur Subpage. Onboarding-Hints im Carousel ausgeblendet, Freigaben-Modul
mobil responsive gemacht.
### 14. Pricing: Blur-Text nicht markier-/kopierbar — ✓ ERLEDIGT (29.07.2026)
Der „Bald verfügbar"-Look auf `/preise` (blurred Dummy-Cards + Absperrband) ist
**gewollt und bleibt 1:1**. Problem war nur: man konnte den verschwommenen Text
trotzdem markieren + kopieren → Dummy-Daten im Klartext.
- **Fix:** Am Blur-Grid (`app/preise/page.tsx`) die `user-select: none`-Prefixes
ergänzt (`WebkitUserSelect`/`MozUserSelect` + Tailwind `select-none`). React
emittiert bei Inline-`userSelect` nur die unpräfixierte Property — **Safari**
braucht `-webkit-`, sonst ließ sich weiter markieren.
- **Verifiziert** in WebKit: Selektion des Blur-Grids liefert 0 Zeichen; Look
unverändert. **Unabhängig von #4** (echte Preise bleiben davon unberührt).
### 15. MCP / KI-Brücke — Feinschliff — ✓ ERLEDIGT (29.07.2026)
Polish-Durchgang der Subpage (`app/ki-anbindung/page.tsx`) inkl. des Feedbacks
vom technischen Kollegen komplett umgesetzt:
- **Neue animierte `RequestFlow`-Sektion** („So läuft eine Anfrage durch":
Deine KI → MCP → HiveGrid, Auto-Advance 3,5 s, kein Layout-Sprung, generische
KI-Station) ersetzt das statische Brücken-Diagramm.
- **`HeroConnect`**: interaktive Connect-Karte (Claude/ChatGPT-Tabs), Breite
fixiert.
- Hero: „Live ansehen"-Button raus, Stacked-Layout zentriert.
- „Was HiveGrid nicht ist"-Sektion entfernt · Domain-Waben mit Icons statt
Buchstaben · „+ weitere MCP-fähige Clients" · kein „bzw." · Monteure-Beispiel.
- **Technischer Steckbrief gegen `hivegrid-cloud/apps/mcp` verifiziert:**
15 Tools (10 Read / 5 Write), Endpoint, Transport, Scopes stimmen.
- **Rest (nicht Teil von #15):** finaler Text-Review läuft über #5;
„weitere Drittanbieter (Bauhow)" betrifft das Landing-Honeycomb, nicht diese
Seite.
### 16. Webinar-Software researchen + `/webinare`-Seite bauen
Webinare als Kanal aufsetzen: Plattform wählen + eigene Seite auf der Website.
- **Vorarbeit liegt vor:** `webinar.md` (Research — Plattformwahl DE/EU-hosted,
technisches Setup, Website-Integration, Recht/DSGVO). Noch untracked.
- **To do:** finale Plattform-Entscheidung · eigene `/webinare`-Seite in Next.js
(Anmeldung + On-Demand-Replay) · Lead-Fluss in eigenes Backend (siehe #12).
- DSGVO/Marken-Konsistenz beachten (EU/DE-Hosting, Double-Opt-in fürs Marketing).
### 17. Über-uns-Seite überarbeiten — Struktur + Texte ✓, Fotos offen (30.07.2026)
`/ueber-uns` (`app/ueber-uns/page.tsx`) komplett neu: **volles Team (8 Personen)
nach Abteilung, echte Bios** (kundentauglich, kein interner Kram). Datengetrieben
über benannte Member-Consts + `departments`-Array.
- **Abteilungen (Reihenfolge):** Geschäftsführung (Noah, Raffael) · Marketing
(Dejan, David) · Entwicklung (Aki, Raffael) · Produkt & Design (David,
Michelle) · Vertrieb (Haris) · System-Infrastruktur (Arthur). David & Raffael
bewusst je 2×. Grid-Spalten adaptiv (2 Leute → 2 Spalten voll, 3 → 3 Spalten).
- **Offen — Fotos (Blocker):** David bereitet neue Fotos vom **ganzen Team** vor.
Aktuell nur Noah/David/Raffael mit (alten) Fotos, Rest = Platzhalter-Kacheln
(Initialen). Sobald Davids Set da ist: pro Person `img`/`objectPos` setzen +
das **Gruppenfoto** (aktuell „Team-Foto folgt"-Platzhalter). → **Dejan** baut ein.
- **Nicht committen/pushen**, solange Platzhalter drin sind.
- Copy geht in den finalen Text-Review (#5) mit ein.
### 18. Geerkens-Kunden-CTA unter Noah später neu bewerten
Der CTA „So arbeitet die Geerkens GmbH heute mit HiveGrid“ ist auf der Landing
vorerst vollständig ausgeblendet. Noahs Story geht dadurch ohne Zwischenmodul
direkt in „Verbinden statt ersetzen“ und das Integrations-Grid über.
- Später entscheiden, ob echte Kundendaten bzw. ein belastbares Kundenbeispiel
genug Mehrwert für eine Wiedereinführung liefern.
- Vorhandene Copy als Referenz: „Angebote, Baustellen und Wartung an einem Ort.“
- Bei einer Rückkehr nicht automatisch den bisherigen Kanban-Platzhalter
reaktivieren, sondern Inhalt und Position im finalen Journey-Review prüfen.
---
## Referenzen
- **Historisches Sektions-/Journey-Mapping:**
`archive/landingpage-experiments-delete-after-finalization/REWORK_MAPPING.md`
- **Deployment:** `docs/deployment.md` (main-Push → Staging automatisch; Prod
per manueller Promotion). Staging: `staging.hivegrid.de`.
- **Landingpage:** `/` rendert direkt `components/landing/LandingPageClient.tsx`.
Frühere Playground-Routen liegen nur noch im ausgeschlossenen Archiv.
- **Design-Tokens:** `app/globals.css` · **Chamfer-Shape:** `lib/chamfer.ts`