68 lines
2.6 KiB
Markdown
68 lines
2.6 KiB
Markdown
# Krok 01 - Inicializácia projektu a základná štruktúra
|
|
|
|
## Kontext projektu
|
|
WebWizard je AI website concierge (MVP), ktorý umožňuje používateľom vytvoriť statický web prostredníctvom wizardu. Projekt využíva PHP 8.2, JSON súbory pre ukladanie dát, Vanilla JavaScript a lokálne DAIAPI pre generovanie obsahu. Celá architektúra je postavená na jednoduchosti bez externých frameworkov.
|
|
|
|
## Pred implementáciou si preštuduj
|
|
- `docs/mvp.md` - Celkový rozsah a ciele MVP.
|
|
- `docs/architecture.md` - Definícia adresárovej štruktúry a technologického stacku.
|
|
|
|
## Cieľ
|
|
Vytvoriť základnú adresárovú štruktúru projektu a zabezpečiť ochranu citlivých dát v priečinku `data/`. Nastaviť základný autoloading pre PHP triedy v `src/`.
|
|
|
|
## Požadované zmeny
|
|
1. Vytvorenie adresárovej štruktúry podľa `architecture.md`.
|
|
2. Vytvorenie `composer.json` so základným nastavením PSR-4 autoloadingu pre menný priestor `App\\` v priečinku `src/`.
|
|
3. Vytvorenie `.htaccess` v koreňovom adresári (alebo konfigurácia servera), ktorá zakáže priamy prístup do priečinka `data/`.
|
|
|
|
## Implementačné pravidlá
|
|
- Nepoužívaj žiadne externé knižnice v `composer.json` okrem vývojových nástrojov, ak sú potrebné.
|
|
- Adresárová štruktúra musí presne zodpovedať `architecture.md`.
|
|
- `data/` priečinok musí byť neverejný.
|
|
|
|
## Súbory ktoré je potrebné vytvoriť
|
|
- `data/users/.gitkeep` (a podobné pre ostatné podadresáre v data/)
|
|
- `data/projects/`
|
|
- `data/consent/`
|
|
- `data/llm/`
|
|
- `data/admin/`
|
|
- `exports/`
|
|
- `src/`
|
|
- `public/`
|
|
- `composer.json`
|
|
- `.htaccess` (v koreni projektu)
|
|
- `data/.htaccess` (na zablokovanie prístupu)
|
|
|
|
## Súbory ktoré je potrebné upraviť
|
|
Žiadne (inicializácia nového projektu).
|
|
|
|
## API a dátové štruktúry
|
|
V tomto kroku sa nedefinujú API endpointy.
|
|
|
|
## Frontend požiadavky
|
|
Nerelevantné pre tento krok.
|
|
|
|
## Backend požiadavky
|
|
- PHP 8.2.
|
|
- PSR-4 autoloading.
|
|
|
|
## Testovací scenár
|
|
1. Spusti `composer dump-autoload` a over, či nevznikli chyby.
|
|
2. Pokús sa v prehliadači pristúpiť na `http://localhost/data/` (alebo ekvivalent) a over, či dostaneš 403 Forbidden.
|
|
3. Over, či existujú všetky požadované adresáre.
|
|
|
|
## Definition of Done
|
|
- Adresárová štruktúra je vytvorená.
|
|
- Autoloading z `src/` funguje.
|
|
- Priečinok `data/` je chránený pred priamym prístupom z webu.
|
|
|
|
## Obmedzenia
|
|
- Nepridávaj žiadne frameworky (Laravel, Symfony, atď.).
|
|
- Nepridávaj databázu.
|
|
|
|
## Výstup
|
|
- zoznam vytvorených súborov
|
|
- zoznam upravených súborov
|
|
- stručné zhrnutie vykonaných zmien
|
|
- prípadné otvorené problémy
|