detailed draft for wizard steps
This commit is contained in:
173
docs/wizard.md
Normal file
173
docs/wizard.md
Normal file
@ -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). |
|
||||
Reference in New Issue
Block a user