ZENOVA Labs logo
ZENOVA LabsCloud / Networking / IoT / AI

Referencia

zenova.sk ako end-to-end referencia delivery flow pre Azure web

Táto referencia ukazuje kompletný tok od návrhu architektúry a HLD, cez implementáciu vo VS Code, validáciu a GitHub Actions workflowy, až po nasadenie a prevádzku webu v Azure.

Public repository on GitHub
Typ projektuprodukčný web + verejná end-to-end delivery referencia
HostingAzure Static Web Apps Standard
IaC smerBicep a dokumentované decision records
Jazykový model`/` a `/en/` bez doménového routing overkillu

Architecture snapshot

Ako tento web funguje ako malý, ale reprezentatívny Azure projekt

Cieľom nebolo pridať čo najviac vrstiev. Cieľom bolo ukázať čistý tok od HLD a rozhodnutí v repozitári, cez lokálnu implementáciu a workflowy, až po produkčný web so SK a EN vetvou v Azure.

Source of truth Public GitHub repo

Obsah, frontend, decision records a verejné workflow smerovanie v jednom repozitári.

Delivery layer Build a CI/CD základ

Statický build, validácia konfigurácie a pripravený priestor pre test a prod delivery model.

Hosting Azure Static Web Apps Standard

Rozumný produkčný hosting bez zbytočnej edge komplexity pre tento rozsah webu.

Experience layer zenova.sk / a /en/

Stabilné SEO URL vetvy, responzívny frontend a referencie ako dôkazová obsahová vrstva.

Delivery model

Ako tento projekt prechádza od lokálneho vývoja po produkčný web

Local

npm start

Lokálny vývoj v devcontainery a rýchle overenie layoutu, SEO routingu a detailných referencií na `localhost:8000`.

PR preview

SWA preview

Pull request vrstva pre obsahový a vizuálny review cez Azure Static Web Apps preview environments, aktivovaná po bootstrap phase 2.

Test

OIDC + staged bootstrap

Stabilné non-prod prostredie cez `deploy-test.yml`, verejné parametre, enterprise edge smer a GitHub Environment `test`.

Production

zenova.sk

Kontrolovaný staged release cez `deploy-prod.yml`, SWA Standard a kanonickú doménu `zenova.sk` s vetvami `/` a `/en/`.

Situácia

Cieľom nebolo len prerobiť firemnú stránku. Cieľom bolo vytvoriť malý, ale reprezentatívny webový projekt, ktorý bude fungovať v produkcii a zároveň poslúži ako verejná end-to-end referencia pre návrh, delivery a prevádzku Azure webu.

  • bez CMS a bez databázy
  • verejný GitHub repozitár bez interných secrets
  • potreba oddeliť produkčný web od interných plánov, ale zachovať verejnú technickú hodnotu projektu

Návrh riešenia

Web je postavený ako statický viacstránkový frontend so samostatnou SK a EN vetvou, s hostingom na Azure Static Web Apps Standard a enterprise edge smerom. Architektonické rozhodnutia sú popísané priamo v repozitári a infra smer je pripravený na staged bootstrap v Bicep a ďalšie CI/CD rozšírenie.

  • Azure Static Web Apps Standard s enterprise edge smerom ako produkčný základ
  • viacstránkový model namiesto jednej preťaženej landing page
  • SEO-friendly URL vetvy cez `/` a `/en/`
  • dokumentované rozhodnutia pre edge a IaC vrstvu

Delivery model v praxi

Repo už dnes ukazuje verejnú kostru delivery modelu bez toho, aby zverejňoval secrets. Bicep foundation, workflowy a dokumentácia sú v repozitári, ale environment variables, OIDC a SWA tokeny ostávajú mimo neho a prvý bootstrap je zámerne staged.

  • subscription-level `infra/main.bicep` a verejné `test` / `prod` parametre
  • `ci-validation`, `infra-whatif`, `deploy-test`, `deploy-prod` a `preview-pr` workflowy
  • jasné rozdelenie medzi phase 1 infra bootstrapom, phase 2 app deployom a manuálnym environment setupom mimo repo

Prečo je to zaujímavé ako referencia

Projekt ukazuje, že aj malý firemný web môže byť navrhnutý ako technicky čistá Azure referencia. Hodnota nie je len v hostingu, ale aj v tom, ako sa pracuje s decision records, verejnou dokumentáciou, baseline infra importom a postupným budovaním delivery vrstvy.

  • produkčný web a technická referenčná ukážka v jednom
  • rozumný rozsah bez zbytočného enterprise over-engineeringu
  • jasná upgrade cesta pre IaC, test/prod prostredia a ďalšie referencie

Výsledok

zenova.sk sa stáva nielen predajnou a SEO vrstvou firmy, ale aj vlastným dôkazom schopnosti navrhnúť a odkomunikovať Azure webový projekt end-to-end. Práve preto je verejný GitHub repozitár dôležitou súčasťou tejto referencie.

  • prehľadnejšia štruktúra webu pre vyhľadávanie aj obchod
  • reálne prepojenie webu, Azure architektúry a repozitárovej dokumentácie
  • verejný projekt, ktorý sa dá ukázať klientovi aj použiť ako technický referenčný asset

Repo a ďalší krok

Ak chceš podobný statický Azure web alebo verejný showcase projekt, vieme navrhnúť rovnaký delivery model aj pre tvoje prostredie

Súčasťou tohto use case je aj verejný GitHub repozitár, v ktorom sú zachytené rozhodnutia, dokumentácia, workflowy aj samotná implementácia webu.

Otvoriť GitHub repo Kontaktovať ZENOVA Labs