From fe31e48e721df8bb48386a0664328dee928e5b2f Mon Sep 17 00:00:00 2001 From: igor Date: Thu, 11 Jun 2026 17:13:35 +0200 Subject: [PATCH] detailed draft for wizard steps --- docs/wizard.md | 173 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 173 insertions(+) create mode 100644 docs/wizard.md diff --git a/docs/wizard.md b/docs/wizard.md new file mode 100644 index 0000000..d390419 --- /dev/null +++ b/docs/wizard.md @@ -0,0 +1,173 @@ +# WebWizard - Detailný Návrh Sprievodcu (Wizard) + +Tento dokument popisuje používateľskú cestu, logiku otázok a štruktúru zberu dát pre AI generátor webstránok. + +--- + +## 1. Prehľad celého wizardu + +Proces je navrhnutý tak, aby minimalizoval kognitívnu záťaž ("mentálnu náročnosť") a pôsobil ako inteligentný dialóg. + +```ascii +[ START ] + | +(Krok 1) Segmentácia Biznisu <------------------+ + | | (Ak "Iné", AI vygeneruje +(Krok 2) Základná Identita | dynamické otázky) + | | +(Krok 3) Smart Otázky (Dynamicky podľa segmentu)-+ + | +(Krok 4) Vizuálny Štýl & Branding + | +(Krok 5) Štruktúra & Moduly + | +(Krok 6) Magické Generovanie (Progress) + | +(Krok 7) Interaktívny Náhľad (Preview) + | +(Krok 8) Publikovanie & Hosting +``` + +--- + +## 2. Detailný rozpis krokov + +### Krok 1: Segmentácia Biznisu +* **Účel:** Okamžité nastavenie kontextu pre AI. Od tohto kroku závisí tón komunikácie a ďalšie otázky. +* **Otázky:** + 1. **V akej oblasti podnikáte?** + * **Typ:** Radio cards (Ikona + Text) + * **Možnosti:** Gastro, Krása & Zdravie, Remeslá, Právne služby, IT & Kreatíva, Reality, Auto-Moto, Ubytovanie, Iné. + * **Povinné:** Áno. + 2. **Vyberte podkategóriu:** + * **Typ:** Select / Chips (Dynamicky podľa voľby vyššie). + * **Povinné:** Áno. +* **Využitie:** AI vyberie správnu "personu" a špecifický slovník (napr. pre advokáta formálny, pre kaviareň priateľský). + +### Krok 2: Základná Identita +* **Účel:** Zber faktických údajov, ktoré nesmú byť vymyslené AI. +* **Otázky:** + 1. **Názov vašej firmy / projektu:** (Text, Povinné) + 2. **Váš slogan (ak máte):** (Text, Voliteľné - ak chýba, AI navrhne 3 varianty v náhľade) + 3. **Kde vás zákazníci nájdu?** (Text, Voliteľné - pre online biznis netreba) + 4. **Kontaktné údaje (Tel/Email):** (Text, Povinné) +* **Využitie:** Naplnenie hlavičky (Header), päty (Footer) a kontaktnej sekcie. + +### Krok 3: Smart Otázky (Dynamicky podľa segmentu) +* **Účel:** Získať "expertízu", vďaka ktorej web nebude pôsobiť genericky. +* **Príklady otázok (viď sekciu 5 pre detaily):** + * *Reštaurácia:* "Máte denné menu?", "Prijímate rezervácie?" + * *Remeselník:* "Ponúkate havarijnú službu 24/7?", "Máte certifikáty?" +* **Využitie:** AI vytvorí špeciálne bloky obsahu (napr. rezervačný formulár, tabuľka s otváracími hodinami). + +### Krok 4: Vizuálny Štýl & Branding +* **Účel:** Určenie estetického smerovania bez nutnosti byť grafikom. +* **Otázky:** + 1. **Aký štýl sa vám páči?** + * **Typ:** Vizuálne karty (Náhľad dizajnu) + * **Možnosti:** Minimalistický, Luxusný, Firemný, Kreatívny, Technický. + 2. **Vyberte si farebnú paletu:** + * **Typ:** Farebné presety (3 ladiace farby) alebo Color Picker. + 3. **Máte logo?** + * **Typ:** Upload / "Nemám, vygenerujte mi textové". +* **Využitie:** Generovanie CSS premenných a výber Google Fonts. + +### Krok 5: Štruktúra & Moduly +* **Účel:** Definícia rozsahu webu. +* **Otázka:** Čo má váš web obsahovať? + * **Typ:** Checkbox list. + * **Možnosti:** O nás, Služby, Cenník, Galéria fotiek, FAQ, Referencie zákazníkov, Kontaktný formulár. +* **Využitie:** AI vygeneruje sekcie na domovskej stránke (Single Page design). + +--- + +## 3. Typy podnikania (Kategorizácia) + +| Skupina | Podkategórie | +| :--- | :--- | +| **Gastro** | Reštaurácia, Kaviareň, Bistro, Donáška, Vináreň, Cukráreň | +| **Krása & Zdravie** | Kaderníctvo, Kozmetika, Barber, Zubná ambulancia, Masáže, Fitness | +| **Remeslá** | Inštalatér, Elektrikár, Stolár, Maliar, Hodinový manžel, Kominár | +| **Právne & Fin. služby** | Advokát, Účtovník, Notár, Finančný poradca, Exekútor | +| **Auto-Moto** | Autoservis, Pneuservis, Autopožičovňa, Detailing, Autoškola | +| **IT & Kreatíva** | Programátor, Grafik, Fotograf, Marketingová agentúra, Copywriter | +| **Reality & Staveb.** | Realitná kancelária, Architekt, Správa budov, Stavebná firma | +| **Vzdelávanie** | Doučovanie, Jazyková škola, Škôlka, Umelecká škola | + +--- + +## 4. Dynamické otázky (Príklady) + +* **Gastro:** + * Ponúkate rozvoz jedla? (Áno/Nie) + * Máte špeciálne denné menu? (Áno/Nie) + * Prijímate online rezervácie stolov? (Áno/Nie) +* **Ubytovanie:** + * Počet izieb/kapacita? (Číslo) + * Čas Check-in a Check-out? (Text) + * Ponúkate parkovanie a WiFi v cene? (Checkboxy) +* **Právne služby:** + * V ktorých oblastiach práva pôsobíte? (Chips: Trestné, Rodinné, Obchodné...) + * Ponúkate prvú konzultáciu zdarma? (Áno/Nie) +* **Auto-Moto:** + * Ktoré značky servisujete? (Text/Všetky) + * Máte odťahovú službu? (Áno/Nie) + +--- + +## 5. Riešenie pre neznámy typ ("Iné") + +Ak používateľ nenájde svoju kategóriu, aktivuje sa **AI Concierge Workflow**: + +1. **Vstup:** Používateľ zvolí "Iné" a napíše: "Chovateľ včiel a predaj medu". +2. **AI Analýza:** Backend okamžite pošle tento text DAIAPI. +3. **Real-time generovanie:** AI vráti 3 relevantné otázky: + * "Máte vlastný e-shop alebo len osobný odber?" + * "Ponúkate exkurzie na včelnicu?" + * "Máte certifikát BIO kvality?" +4. **Kontinuita:** Používateľ tieto otázky dostane v Kroku 3, akoby boli v systéme odjakživa. +5. **Uloženie:** Systém zapíše túto novú kategóriu do `data/admin/pending_categories.json`. + +--- + +## 6. Administrácia (JSON Štruktúra) + +### `data/categories.json` (Definícia) +```json +{ + "gastro": { + "label": "Gastro", + "subcategories": ["restaurant", "cafe", "bistro"], + "smart_questions": [ + { "id": "delivery", "label": "Ponúkate rozvoz?", "type": "boolean" }, + { "id": "menu", "label": "Máte denné menu?", "type": "boolean" } + ] + } +} +``` + +### `data/admin/pending_categories.json` (AI návrhy) +```json +{ + "bee_farmer": { + "original_input": "Chovateľ včiel", + "ai_generated_questions": [ + { "id": "q1", "label": "Máte BIO certifikát?", "type": "boolean" } + ], + "usage_count": 1, + "status": "pending" + } +} +``` + +--- + +## 7. Minimalizácia počtu otázok (Optimization) + +| Stratégia | Implementácia | +| :--- | :--- | +| **Povinné minimum** | Iba Názov, Email a Typ biznisu. Ostatné je dobrovoľné. | +| **AI Inference** | Ak používateľ napíše názov "Pizzeria u Petra", AI v Kroku 1 automaticky predvolí "Gastro -> Reštaurácia". | +| **Defaulting** | Vizuálny štýl je prednastavený na "Minimalistický" - používateľ môže len kliknúť "Ďalej". | +| **Skip Option** | Každý krok (okrem 1 a 2) má tlačidlo "Preskočiť a nechať na AI". | +| **Smart Defaults** | Otázky v Kroku 5 (Obsah) sú vopred zaškrtnuté podľa typu biznisu (napr. pre reštauráciu je "Cenník/Menu" automaticky ON). |