Files
csbot-prototype/documentation/99-zmeny.md
T
JiriUhlir 7b045a9f20 Nahrazeni sablony kompletnim webem a klientskym portalem
Web a portal Automia v jednom containeru. Express obsluhuje API
i zbuildovanou React aplikaci z dist/public.

Obsah:
- verejny web: homepage, sluzby, o nas, kontakt, 404
- prihlaseni pres JWT, demo ucty
- portal: prehled s grafem, tickety, incidenty, automatizace, konektory
- builder automatizaci: strom akci, vetveni podminkou
- katalog 25 konektoru v 8 kategoriich
- webhook s registrovanou adresou, token generuje server
- zivy dashboard pres SSE vcetne simulace provozu
- Swagger UI na /docs a OpenAPI na /openapi.json

Soulad s AGENTS.md:
- ROOT_PATH z prostredi, prefix proxy nikde nehardcodovan
- mount na koren i na prefix, funguje s handle_path i bez nej
- base tag a window.__BASE_PATH__ vkladane do index.html za behu
- OpenAPI servers obsahuje prefix, Try it out vola spravnou adresu
- povinne /health a /docs, port 3000, naslouchani na 0.0.0.0
- secrets jen z environment variables, nikdy v logu

Dokumentace ve slozce documentation/.
2026-07-31 17:00:37 +02:00

2.2 KiB

99 - Zaznam zmen

Nejnovejsi nahore.

2026-07-31

Prvni nasazeni aplikace do repozitare csbot-prototype.

Puvodni sablona byla holy Express s endpointy / a /health. Nahradil ji kompletni web a klientsky portal.

Pridano

  • Verejny web: homepage se sekcemi, sluzby, o nas, kontakt s formularem, 404.
  • Prihlaseni pres JWT s demo ucty.
  • Klientsky portal: prehled s grafem, tickety, incidenty, automatizace, konektory, nastaveni.
  • Builder automatizaci: strom akci, spoustec, vetveni podminkou.
  • Katalog 25 konektoru v 8 kategoriich.
  • Webhook s registrovanou adresou, token generuje server.
  • Zivy dashboard pres SSE, vcetne indikatoru spojeni a bublin s udalostmi.
  • Simulace provozu pod tlacitkem v postrannim menu portalu.
  • Swagger UI na /docs a OpenAPI definice na /openapi.json.
  • Dokumentace ve slozce documentation/.
  • .gitignore, ktery drzi node_modules a dist mimo repozitar.

Zmeneno oproti sablone

  • Aplikace prepnuta na ESM ("type": "module") a module: NodeNext.
  • Jeden container obsluhuje API i zbuildovanou React aplikaci z dist/public.
  • Dockerfile buildu je server i web, vysledny image dostava jen dist.
  • Port zustava 3000, naslouchani na 0.0.0.0 beze zmeny.

Reseni reverse proxy

  • ROOT_PATH se cte z prostredi, nikde neni hardcoded.
  • Aplikace se mountuje na koren i na prefix, funguje tedy at Caddy prefix odstrani nebo ne.
  • Server vklada do index.html znacku <base> a window.__BASE_PATH__, aby SPA nasla soubory i na vnorenych cestach.
  • OpenAPI servers obsahuje prefix, takze Swagger Try it out vola spravnou adresu.
  • Router ma strict: true, jinak by se presmerovani /docs na /docs/ zacyklilo.

Overeno lokalne

S ROOT_PATH=/apps/csbot-prototype:

  • /apps/csbot-prototype/health i /health vraci 200,
  • /apps/csbot-prototype/docs presmeruje na /docs/, ta vraci Swagger UI,
  • swagger-ui.css se nacte pres prefix,
  • OpenAPI servers obsahuje /apps/csbot-prototype,
  • index.html na vnorene ceste obsahuje spravny <base>,
  • prihlaseni pres prefix vraci token,
  • neexistujici cesta pod /api vraci JSON, ne HTML aplikace.

Znama omezeni

Data jsou v pameti, restart je vrati do vychoziho stavu. Obsah webu je ukazkovy. Ulozeny strom automatizace se nevykonava.