chore(repo): sync wireframe structure and references
This commit is contained in:
1 parent
05d2d5777f
commit
d953a79e95
453 files changed
+36639
-621
No files matched your search
@@ -0,0 +1,313 @@
|
||||
# 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`
|
||||
Reference in new issue
Block a user