# Livio PWA ## Místní kopie Webový kořen aplikace je `public/`. Nová kopie potřebuje místní soubor `public/data/demo.php`. V PowerShellu jej vytvoř z anonymní šablony. ```powershell if (-not (Test-Path public/data/demo.php)) { Copy-Item public/data/demo.example.php public/data/demo.php } ``` Místní fotografii pro Dnešní tip lze doplnit do `public/assets/images/tip.JPEG`. Soukromé profilové fotografie, místní data a konfigurace spravuj mimo Git. ## Serverová konfigurace Každé prostředí má vlastní neveřejný soubor `public/config/config.php` podle šablony `public/config/config.example.php`. PHP modul jej načte cestou od svého adresáře. Například z `public/index.php` použije `$config = require __DIR__ . '/config/config.php';`. Pro databázi, poštu a úložiště použije příslušný klíč `database`, `smtp` nebo `r2`. Na Apache adresář chrání `Require all denied` v `public/config/.htaccess`. Před vložením skutečných údajů na hosting ověř, že server vrací HTTP 403 pro soubory v adresáři včetně statického zkušebního souboru. Při použití jiného serveru zakaž celý adresář v jeho konfiguraci. Na Linuxu nastav souboru práva 600, případně 640 s vyhrazenou skupinou pro PHP. Na hosting přenes pouze produkční konfiguraci, zdrojový soubor ze složky `vzory` tam nepatří. ## Testovací přihlášení Údaje `111 / 111` otevřou Přehled na místní i veřejné adrese. Přehled načte existující `public/data/demo.php`, případně použije ukázkovou šablonu, pokud tento soubor chybí. Pro samostatný místní náhled spusť v kořeni projektu: ```powershell php -S 127.0.0.1:8080 -t public ``` Otevři `http://127.0.0.1:8080/`. Testovací příznak platí pouze v prohlížeči a neposkytuje přístup k API. Obsah Přehledu je součástí HTML a testovací formulář ho nechrání před přímým přečtením. ## Příprava vydání PWA Před distribucí spusť v kořeni projektu `php scripts/priprav-vydani.php`. Skript zapíše do `release.json` nový build jen při skutečné změně distribuovaných souborů. Soubor s verzí uchovej v historii a nasaď společně s odpovídajícím obsahem `public/`. Připravuj vydání z jedné aktuální distribuční kopie projektu a publikuj je jako jeden celek. Pro návrat ke staršímu kódu připrav nové vydání s vyšším číslem buildu. ## Průběžné ukládání změn Na větvi `main` nejprve zkontroluj `git status --short` a `git diff`. Pomocí `git add --` přidej konkrétní zkontrolované soubory, například `git add -- README.md`. Před commitem ověř obsah a seznam přidaných souborů. ```powershell git diff --cached --name-status git diff --cached git commit -m "Upřesni postup místního spuštění" git push origin main ```