# HypoStars — Whitepaper projektu
### Kompletní přehled od začátku do dneška · stav k 27. 6. 2026

---

## 0. Co je HypoStars

**HypoStars** je hypoteční a finanční značka (web **hypostars.cz**) v komiksovém „superhrdinském" stylu — maskot **Hypouš** vs. záporák **Dluhomor**. Cíl: sbírat poptávky (leady) na hypotéky, refinancování, nebankovní financování a pojištění z Facebooku a Google a předávat je makléři (David Paclík). Provozováno technicky pod CzechAI / Bohemia Shield na vlastní infrastruktuře.

**Hodnota dle interního nacenění (mail 7. 6.):** ≈ **353 000 Kč** (replacement cost), reálná páka = hodnota hypotečních leadů (300–2000 Kč/lead, ~30–40 tis. Kč provize / uzavřená hypotéka).

---

## 1. Historie / timeline (rekonstruováno z 80+ záloh a paměti)

| Datum | Milník |
|---|---|
| **22. 5. 2026** | **Vznik.** Doména hypostars.cz přepsána ze staré Hostinger Horizons verze na **naše statické HTML** (server 179). Title „HypoStars — Hypotéka bez stresu". Marquee, spodní navigace, viewport `width=1440` (desktop i na mobilu = záměr). |
| 22.–23. 5. | Série „fitvp1–7" — ladění viewportu/fit, mobilní scroll fix (`overflow-x:hidden→clip`), marquee, nav, SEO, app obrázky. |
| 3. 6. | Sekce **banky**, panely, CTA, chat panel, Safari fixy, hypotéka tlačítko. |
| 5. 6. | **Hypouš avatar** do hera, gradienty, WhatsApp akce, sazby (rate), pojišťovny submit, hypobot. |
| **6. 6.** | **Teable báze „HypoStars Leady"** (FB hypoteční leady) napojena jako 5. destinace lead pipeline. PSČ pole do všech formulářů. |
| **8. 6.** | **Umami analytika** nasazena (umami.czechai.io). Před tímto datem návštěvnost neměřena. |
| 11. 6. | **Meta Pixel** + hypous postava, YouTube panel. |
| **14. 6.** | **Sjednocené menu + chatbot Hypouš** přes sdílený injektor `hs-shell.js` (místo kopírování do každé stránky). Bannery. |
| **19. 6.** | **Pexeso** hra (`/pexeso/`, embed Cloud Run). Social injektor. Cache gotcha (immutable assety). |
| 21. 6. | Soutěž, YouTube panel, čištění žlutého pruhu, Facebook sekce. |
| **24. 6.** | **Lead magnet „Spočítej si nabídku" `/nabidka/`** (kalkulačka 8 bank + OCR). Pixel + Lead event nasazen na hra/banky/bonus/soutez/reg. Oprava: hra.html padala do mrtvého formsubmitu → přepojeno na `/v1/hypostars/lead`. |
| **25. 6.** | `/nabidka/` sjednocena na **5 režimů**, `/zajem/` přesměrovává sem. |
| **26. 6.** | Spodní menu = moderní komiks „sticker" pilulky. SW `hs-v65→`. |
| **27. 6. (dnes)** | hero/Hypouš úprava (`herohypous-20260627`). SW aktuálně **hs-v78**. |

---

## 2. Infrastruktura

| Prvek | Hodnota |
|---|---|
| **Hosting** | Server **179** ([interni IP odstranena]), nginx, root `/var/www/hypostars/` |
| **Doména** | hypostars.cz + www (nginx vhost `hypostars.cz`) |
| **Servírování** | statické HTML, `try_files $uri $uri/ /index.html` (SPA fallback) |
| **Service Worker** | `service-worker.js`, `CACHE_NAME` = **hs-v78** (po každé změně bumpovat!) |
| **Backend nabídka** | PM2 **hypostars-nabidka** (port 5349, `/opt/hypostars-nabidka/`), nginx `/nabidka-api/` |
| **Backend agent** | PM2 **hypostars-agent** (online) |
| **Lead handler** | `/opt/router-api/server.py` ř.659 → `POST /v1/hypostars/lead` |
| **Caching gotcha** | assety `max-age=1 rok immutable` → Mac/Safari je necachuje znovu; nutný `?v=N` v URL skriptů + bump SW |

**Cizí/budoucí:** placený **FORPSI dedikovaný server** `81.2.216.196` (obj. S03768696) připraven pro budoucí migraci — **stav PARKED**, migrovat až na pokyn.

---

## 3. Produkt — stránky (✅ HOTOVÉ)

13 živých stránek (root + 12 podstránek):

| Stránka | Co je |
|---|---|
| **/** (index, 152 K) | Hlavní landing — hero Hypouš, „Tři kroky", CTA, formulář |
| **/banky/** (116 K) | Bankovní hypotéky + formulář |
| **/pojistovny/** (112 K) | Pojištění + formulář |
| **/nebankovni/** (80 K) | Nebankovní financování („aukce nebankovních případů") + formulář |
| **/nabidka/** (28 K) | 🧲 **Lead magnet** — kalkulačka 5 režimů (viz §5) |
| **/reg/** (48 K) | Registrační landing (REF 484184) |
| **/kalkulacka/** (60 K) | Hypoteční kalkulačka |
| **/mesto/** (76 K) | „Hypotown" / odběr novinek |
| **/kalendar/** (40 K) | Kalendář |
| **/bonus/** (28 K) | 🎮 Hra **Hypotown Arena** (runner) |
| **/pexeso/** (28 K) | 🃏 Pexeso (embed) |
| **/soutez/** (44 K) | Soutěž o dovolenou 25 000 Kč |
| **/zajem/** (4 K) | Přesměrování → /nabidka/ |

---

## 4. Lead pipeline (✅ HOTOVÉ, funkční)

Každý odeslaný formulář → `POST router.czechai.io/v1/hypostars/lead` → **5-násobná redundance**:

1. 🟣 **Discord** webhook
2. 📄 **CSV** `/opt/router-api/hypostars_leads.csv`
3. 🗄️ **PostgreSQL** `czechai_cockpit.leads`
4. 📧 **Email** na 4 adresy (info@bohemiashield.cz, info@czechai.io, info@hypostars.cz, obchod@bohemiashield.cz)
5. 📊 **Teable** báze „HypoStars Leady" (teable2.czechai.io, kanban pipeline, 15 polí)

**Stav leadů:** **51** v PG (k dnešku). Reálných cizích lidí ≈ **3** (Iveta Kmochová, Kamil Simonides hypotéka; Nikol Karmazínová pojištění) — zbytek testy + interní (Leoš/David). Export: `/v1/hypostars/leads-export?key=hs-leady-2026`.

---

## 5. Lead magnet „Spočítej si nabídku" (✅ HOTOVÉ)

**https://hypostars.cz/nabidka/** — jediná stránka, **5 režimů**:
- **Nová hypotéka** — výpočet 8 bank + zvýhodněná HypoStars sazba (anuita)
- **Mám hypotéku** — srovnání + upload smlouvy (PDF/Word/sken → **Chandra OCR**)
- **Prodávám** (odhad), **Investuju** (off-market), **Pojištění** (sběr + upload → makléř)

Backend PM2 `hypostars-nabidka` (5349). Sazby v `/opt/hypostars-nabidka/rates.json` (3-úrovňové: běžně / z reklamy / naše = max(floor 4.68, promo − 0.07)). FB funnel návod hotový.

---

## 6. Marketing & akvizice (✅ částečně)

- **Facebook skupina** ~230 000 členů (hlavní zdroj leadů)
- **Meta Pixel** `2505489676556288` + Lead event na klíčových stránkách
- **Umami** analytika (umami.czechai.io, web „hypostars") — ~393 návštěvníků/30 dní, ~60 z FB
- **Google Ads tag** `AW-18189137173` (konverze)
- **Marketing assety** (router-static): prezentace, reklama, bannery, premium, email šablony, talking avatary (HeyGen/LiveAvatar), komiksové obrázky Hypouš/Dluhomor

---

## 7. Gamifikace & engagement (✅ HOTOVÉ)

- 🎮 **Hypotown Arena** (`/bonus/`) — canvas runner, Hypouš vs Dluhomor, sprite z uživatelových assetů
- 🃏 **Pexeso** (`/pexeso/`) — embed, HYPO STARS karty
- 🏆 **Soutěž** o dovolenou 25 000 Kč (`/soutez/`)

---

## 8. Sdílená vrstva (✅ HOTOVÉ)

**`hs-shell.js`** — jeden injektor pro **menu + chatbota Hypouš** na všech 11 HTML. Chat → `router.czechai.io/openrouter` (gpt-oss-120b). Komiksové „sticker" menu + 4 social kolečka (FB/IG/TT/YT). Verze `?v=78`.

---

## 9. 🔴 Otevřené problémy & co je potřeba udělat

| Priorita | Co | Stav |
|---|---|---|
| 🔴 **Vysoká** | **Google Workspace platba selhává** → info@hypostars.cz před zrušením | ⚠️ čeká na uživatele (platbu nedělám sám) |
| 🔴 **Vysoká** | **Reálné sazby bank** v `rates.json` — teď placeholder | makléř musí doplnit 8 bank + discount |
| 🔴 **Vysoká** | **Konverze ~0,8 %** — 393 návštěv → 3 leady. Hlavní brzda = stránky těžké/roztříštěný traffic na hry | CRO + zlehčení (částečně: /nebankovni/ zlehčeno 12→2,8 MB) |
| 🟠 Střední | **/nabidka/ není nikde prolinkovaná** — vhodná jako landing pro FB reklamy | nasměrovat ads sem |
| 🟠 Střední | **Social handles nepotvrzené** (`hypostars` na FB/IG/TT) | uživatel potvrdit |
| 🟠 Střední | **Srovnávač** (porovnání bank/pojišťoven) | **dělá kolega** — nesahám |
| 🟡 Nízká | **Migrace na FORPSI server** 81.2.216.196 | PARKED, až bude klid + rotovat hesla |
| 🟡 Nízká | **CAPI server-side Lead** s dedup (relay aal-capi 5348) | nabídnuto, neuděláno |
| 🟡 Nízká | **PostHog** heatmapy/session recordings na 117 | možnost, nenapojeno |
| ⚪ Odmítnuto | Deanonymizace anonymních návštěvníků (emaily bez souhlasu) | GDPR — NE |

---

## 10. Shrnutí — co je „hotové" vs „zbývá"

**✅ HOTOVO (produkt stojí a funguje):** 13 stránek, 5-násobná lead pipeline, lead magnet s kalkulačkou + OCR, sjednocené menu/chatbot, 3 hry, Pixel + Umami + Google Ads tracking, Teable CRM, marketing assety, komiksový brand.

**🔧 ZBÝVÁ k „prodejní mašině":**
1. Doplnit reálné bankovní sazby (jinak kalkulačka neprodává)
2. Nasměrovat FB reklamy na `/nabidka/` jako landing
3. Vyřešit platbu Google Workspace (jinak padne firemní mail)
4. Zvýšit konverzi (zlehčit zbylé stránky, méně rozptylovat hrami u lead-funnelu)
5. Potvrdit social účty
6. (volitelně) CAPI dedup, PostHog, migrace na FORPSI

---

*Whitepaper sestavil Claude Code / CzechAI · 27. 6. 2026 · zdroje: 9 paměťových souborů + živá inventura serveru 179 + 80+ verzovaných záloh.*