Glossário

Branches: dev = staging, main = prod.
Commits: Conventional Commits em pt-BR.
Versão: semver; a tag é a fonte da versão .
Deploy: sempre via Portainer (nunca docker stack CLI direto).

Termos do domínio da H7 Soluções, para decodificar o jargão de forma consistente. Este glossário espelha o CONTEXT.md do projeto.

Termo	Significado
H7 Soluções	Empresa dona do ecossistema.
h7-host	Aplicação principal (React+Tailwind frontend, FastAPI backend).
h7-docs	Este site de documentação (Docusaurus).
Hermes	Agente de IA (Nous Research) usado como ferramenta de dev/ops.
s38	Servidor de produção (200.123.234.38, SSH 52022, user `h7solucoes`).
Swarm	Docker Swarm rodando no s38.
Traefik	Reverse proxy / roteador (labels nos serviços).
Portainer	Painel de gestão do Swarm.
GHCR	GitHub Container Registry (org `ia-faz`).
DEV	Ambiente local: container Hermes edita + commit + push.
Staging	Ambiente intermediário (branch `dev`), domínio `dev.*`.
Prod	Ambiente de produção (branch `main`), domínio raiz.
Release	Bump semver + tag + release GitHub; obrigatória na promoção dev→prod.
oauth2-proxy	Proxy de autenticação Google OIDC (forward-auth no Traefik).
Allowlist	Domínios de e-mail autorizados.
Stack	Definição Docker Swarm (YAML) gerenciada pelo Portainer.

Convenções