Instalace stafio-gateway-web

Repozitář se jmenuje stafio-gateway-web (nikoli stafio-web-gateway). Je to serverová přihlašovací brána na login.stafio.cz a strojové rozhraní na api.stafio.cz. Běžný uživatel otevře přihlašovací stránku; nic neinstaluje. Následující kroky jsou pro správce vlastní instalace.

Pro odesílání SMS z telefonu použijte návod na SMS bránu Android. Připojení Claude a ChatGPT popisuje návod MCP.

1. Získejte zdrojové kódy

Potřebujete Git, přístup k repozitáři a Node.js 22 s npm (stejná hlavní verze jako v Dockerfile), případně Docker.

git clone https://github.com/stafiocz/stafio-gateway-web.git
cd stafio-gateway-web
npm ci
npm run build

2. Nastavte prostředí pro místní spuštění

V kořeni vytvořte .env.local. Následující izolovaný příklad míří na váš lokální mock API na portu 8099; nenahrazuje skutečný backend a bez mocku se nepřihlásíte. Výchozí konfigurace bez těchto přepisů míří na produkční flotilu.

PORT=8080
GATEWAY_INSTANCES='[{"name":"local","api":"http://127.0.0.1:8099/api/","domains":[{"name":"local.example"}]}]'
SENDGRID_ROUTES='{"local_db":"http://127.0.0.1:8099/api/"}'
SENDGRID_BROADCAST_UNKNOWN=false

Pro schválené testovací prostředí nahraďte jméno, URL API a doménu skutečnými hodnotami od správce. GATEWAY_INSTANCES a SENDGRID_ROUTES nahrazují celé výchozí seznamy. Konfigurační soubor s přístupy neukládejte do Gitu.

3. Spusťte bránu

node --env-file=.env.local server/index.js

Otevřete http://127.0.0.1:8080. Server obsluhuje sestavený web i routy /auth/* a /webhooks/*. Samotné npm run dev backend nespustí; při vývoji ho spusťte v druhém terminálu, Vite na něj požadavky přeposílá.

Alternativa: Docker

Pro Docker vytvořte .env.docker se stejnými proměnnými, ale JSON hodnoty napište bez vnějších jednoduchých uvozovek. Pokud mock běží na hostiteli Docker Desktopu, nahraďte 127.0.0.1:8099 adresou host.docker.internal:8099; loopback uvnitř kontejneru znamená kontejner samotný.

docker build -t stafio-gateway-web:local .
docker run --rm --name stafio-gateway-local -p 127.0.0.1:8080:8080 --env-file .env.docker stafio-gateway-web:local

Důležité volby

Proměnná	Význam
INSTANCE_TIMEOUT_MS	timeout volání instance, výchozí 8000 ms
FORWARD_TIMEOUT_MS	timeout webhooku, výchozí 15000 ms
GATEWAY_REGISTRATION_INSTANCE	zapne registraci firem na určené instanci; bez hodnoty je vypnutá a vyžaduje připravenou šablonu vlastníka v backendu
VITE_GO_URL	adresa mobilní aplikace při sestavení webu; změna vyžaduje nový build

Ověření a provoz

Nejprve ověřte načtení přihlašovací stránky. Potom s účtem schváleného testovacího prostředí ověřte přihlášení a cílovou aplikaci. Chyby spojení hledejte v logu procesu nebo pomocí docker logs stafio-gateway-local. Lokální mock musí implementovat potřebné platform RPC; samotný statický web přihlášení neověří.

Produkční provoz vyžaduje HTTPS reverse proxy, správné DNS a přístup brány k API instancí. Stávající Stafio Swarm používá konfiguraci stafio/gateway.yml v repozitáři infrsastructure-ds. Pro produkci použijte jeho schválený postup nasazení a konkrétní tag image; místní příkazy výše nejsou nasazením do Stafio flotily.

Standardní integrační API se volá na API konkrétní instance, ne na přihlašovací bráně: viz návod API. Technické podklady pro správce jsou v repozitáři stafio-gateway-web (může vyžadovat přístup k repozitáři).