Files
WebWizard/docs/wizard.md
2026-06-11 17:13:35 +02:00

6.9 KiB

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.

[ 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)

{
  "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)

{
  "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).