planovac / F0-08

Zkusebni delivery pruchod ma jasne dukazy pro PR preview i merge do main.

planovac / F0-07

Smoke scenar a diagnostika maji byt dohledatelne z aplikace i runtime endpointu.

production

Tato stranka overuje, ze minimalni Next.js aplikace vedle GitHub CI a Supabase baseline obsahuje i pouzitelny smoke scenar nad preview a production deploymenty, vcetne diagnostiky prostredi, URL, commitu a zdravotniho endpointu pro strojove overeni.

Zdroj detekce: VERCEL_TARGET_ENV = production

Zakladni URL: https://strkos-plan.online

Deployment URL: https://planovac-qy2p3oh1c-strelecs-projects.vercel.app

Branch deployment URL: https://planovac-git-main-strelecs-projects.vercel.app

Produkcni URL projektu: https://strkos-plan.online

Git ref: main

Commit: c437149

Mapovani preview a production pusobi konzistentne.Zdroj base URL: VERCEL_PROJECT_PRODUCTION_URLSmoke base URL: neni nastavena

Aplikace

App Router bezi z adresare app/ a repozitar ma pripraveny lint, build, CI workflow, Vercel konfiguraci, health endpoint a smoke runner pro navazujici preview overeni.

Prostredi

Ostre prostredi po merge do main. Musi pouzivat produkcni konfiguraci, produkcni URL a nikdy nesmi sahat do preview dat.

Explicitni rezim: NEXT_PUBLIC_APP_ENV ma prednost pred fallbackem z platformy.
Fallback: Pokud chybi explicitni hodnota, aplikace pouzije VERCEL_TARGET_ENV, potom VERCEL_ENV a az nakonec NODE_ENV.
Pravidlo: Preview a production musi mit rozdilne URL i oddelene neverejne konfigurace.

Vercel integrace

Pull requesty maji vznikat jako preview deployment a merge do main ma vest na production deployment se samostatnou konfiguraci i URL.

Repo konfigurace: vercel.json nastavuje Next.js preset a prikazuje instalaci pres npm ci.
Mapovani vetvi: Produkcni branch zustava main; ostatni vetve a pull requesty maji smerovat do preview.
Promenne: Preview a production pouzivaji odlisne hodnoty NEXT_PUBLIC_APP_ENV a NEXT_PUBLIC_APP_BASE_URL.
Diagnostika: Nasazena aplikace zobrazuje ref, deployment URL, produkcni URL a commit SHA pro dohledatelnost release.

GitHub CI a databaze

GitHub CI dal hlida build a repozitarove artefakty, zatimco Supabase baseline pripravuje migrace, preview metadata a demo data pro navazujici preview workflow. Smoke overeni se pousti explicitne nad nasazenou URL, aby slo stejne pouzit lokalne i po deployi.

CI workflow: .github/workflows/ci.yml
Status checks: install, lint, build, validate-supabase
Preview schema workflow: docs/provoz/supabase-baseline-a-preview-schema.md
Baseline migrace: supabase/migrations/20260331120000_f0_04_supabase_baseline.sql

Kontrola Vercel mapovani

Nasazeni ma kanonickou zakladni URL
VERCEL_PROJECT_PRODUCTION_URL poskytuje https://strkos-plan.online.
Deploy je dohledatelny na commit
Commit c437149 je k dispozici v runtime diagnostice.
Production pouziva produkcni domenu
Base URL strkos-plan.online odpovida produkcni domene projektu.

Zdravotni endpoint

Endpoint /api/health vraci JSON se stavem runtime diagnostiky. Smoke script z nej cte prostredi, commit a vysledky jednotlivych kontrol bez parsovani HTML.

URL: https://strkos-plan.online/api/health
HTTP status: 200 pri konzistentnim mapovani, jinak 503.
Payload: Obsahuje environment, baseUrl, commitSha a pole checks.

Mapovani promennych do Vercelu

Preview: NEXT_PUBLIC_APP_ENV=preview a NEXT_PUBLIC_APP_BASE_URL ma smerovat na preview host.
Production: NEXT_PUBLIC_APP_ENV=production a NEXT_PUBLIC_APP_BASE_URL ma smerovat na produkcni domenu.
System env vars: Ve Vercelu ma zustat zapnute automaticke vystaveni systemovych promennych pro diagnostiku v Next.js runtime.
Smoke URL: SMOKE_BASE_URL ma pro dane prostredi mirit na URL, proti ktere se spousti npm run smoke.
Oddeleni dat: Neverejne Supabase klice a preview schema prefix musi byt pro preview a production spravovane oddelene.

F0-08: Zkusebni delivery pruchod

Tato iterace zamerne nepridava novou domenovou funkcionalitu. Misto toho vytvari citelny dukaz, ze mala zmena umi projit pres pull request, preview deployment a navazujici merge do main.

Zmena je zamerne minimalni
Domovska stranka a provozni dokumentace rozsiruji dohledatelnost delivery bez zasahu do domenoveho chovani aplikace.
Pull request ma citelne preview dukazy
Tento commit uz dosel i mimo preview; dohledatelnost zustava zachovana pres commit c437149.
Merge do main musi potvrdit production deployment
Production runtime potvrzuje release na commitu c437149 a ma mit stejnou dohledatelnost jako preview.

Co ma reviewer overit

V pull requestu: Uspesne status checks install, lint, build a validate-supabase.
V preview verzi: Preview URL, zdrojovou vetev, commit SHA a odliseni preview od production.
Po merge do main: Stejny commit v production, badge production a dohledatelnou produkcni URL.
Runbook: docs/provoz/zkusebni-delivery-pruchod.md

Smoke scenar F0-07

Po deployi nastavte SMOKE_BASE_URL na preview nebo produkcni URL.
Spustte npm run smoke.
Ocekavejte uspesnou odpoved z /api/health a pritomnost klicovych markeru na homepage.
Pokud smoke selze, zkontrolujte badge prostredi, runtime URL a pole checks v health payloadu.

Aktualni vystupy faze 0

.github/workflows/ci.yml s joby install, lint, build a validate-supabase
npm skripty pro validaci .env.example a Supabase artefaktu
npm run smoke pro kontrolu homepage a /api/health nad SMOKE_BASE_URL
prvni verzovana SQL migrace v supabase/migrations/
demo seed dataset v supabase/seed/seed.sql
repo-side Vercel konfigurace ve vercel.json a runbook pro preview/production
zkusebni F0-08 evidence panel pro PR preview a navazujici merge do main
runtime endpoint /api/health s JSON diagnostikou prostredi, URL a commitu

Dalsi kroky

Dopsat smoke overeni migraci, seedu a aplikace v ramci F0-07.
Po merge do main potvrdit, ze stejny commit a diagnostika dosly i do production v ramci F0-08.
Spustit npm run smoke proti preview deploymentu po otevreni pull requestu.
Overit prvni zkuseni delivery pruchod pres PR a merge v ramci F0-08.