67 lines
2.4 KiB
Markdown
67 lines
2.4 KiB
Markdown
# Krok 20 - Kvalitatívne Validácie a Error Handling Fixes
|
|
|
|
## Kontext projektu
|
|
Pred dokončením MVP je potrebné vykonať finálnu revíziu kódu, opraviť drobné chyby a zabezpečiť súlad so všetkými technickými požiadavkami.
|
|
|
|
## Pred implementáciou si preštuduj
|
|
- `docs/architecture.md` - Celý dokument, najmä sekcie 12 a 13.
|
|
- `docs/mvp.md` - "Website Quality Requirements".
|
|
|
|
## Cieľ
|
|
Vykonať plošnú kontrolu kvality, optimalizovať výkon (v rámci možností) a zabezpečiť robustné ošetrenie chýb.
|
|
|
|
## Požadované zmeny
|
|
1. Revízia backendu:
|
|
- Kontrola všetkých `try-catch` blokov.
|
|
- Odstránenie `var_dump` a debug logov.
|
|
- Overenie bezpečnosti (path traversal, sanitizácia vstupov).
|
|
2. Revízia frontendu:
|
|
- Kontrola konzoly prehliadača na JS chyby.
|
|
- Optimalizácia načítavania assetov.
|
|
- Finálne doladenie CSS (responzivita, prístupnosť).
|
|
3. Revízia generovaného webu:
|
|
- Validácia HTML cez W3C (mock test).
|
|
- Kontrola relatívnych ciest.
|
|
- Overenie funkčnosti bez JavaScriptu (kde je to možné).
|
|
4. Dokumentácia:
|
|
- Aktualizácia `README.md` s inštrukciami pre inštaláciu a spustenie.
|
|
|
|
## Implementačné pravidlá
|
|
- Kód musí byť čistý, komentovaný a v súlade s PSR štandardmi.
|
|
- Žiadne "hidden" závislosti.
|
|
- Systém musí fungovať na štandardnom PHP 8.2 hostingu.
|
|
|
|
## Súbory ktoré je potrebné vytvoriť
|
|
- `README.md` (aktualizácia/vytvorenie)
|
|
|
|
## Súbory ktoré je potrebné upraviť
|
|
- Plošne všetky súbory podľa potreby.
|
|
|
|
## API a dátové štruktúry
|
|
Žiadne zmeny, len stabilizácia.
|
|
|
|
## Frontend požiadavky
|
|
- Plynulý zážitok bez "preblikávania" alebo neošetrených stavov.
|
|
|
|
## Backend požiadavky
|
|
- Stabilný výkon, žiadne memory leaky pri spracovaní úloh.
|
|
|
|
## Testovací scenár
|
|
1. Prejdi celým procesom od prvej návštevy až po export pre 3 rôzne kategórie biznisu.
|
|
2. V každom kroku skús zadať neplatné dáta a over, či ich systém správne odmietne.
|
|
3. Skontroluj vygenerované ZIP archívy na rôznych zariadeniach/prehliadačoch.
|
|
|
|
## Definition of Done
|
|
- Systém je stabilný, bezpečný a pripravený na nasadenie.
|
|
- Kvalita kódu a výstupu spĺňa MVP požiadavky.
|
|
- Všetky známe chyby sú opravené.
|
|
|
|
## Obmedzenia
|
|
- Nepridávaj nové funkcie, ktoré nie sú v MVP scope.
|
|
|
|
## Výstup
|
|
- zoznam vytvorených súborov
|
|
- zoznam upravených súborov
|
|
- stručné zhrnutie vykonaných zmien
|
|
- prípadné otvorené problémy
|