Skip to content

docs+chore: alinha docs e config operacional com o hosting atual (Azure)#63

Merged
johnlaff merged 1 commit into
mainfrom
docs/fix-stale-status
Jul 10, 2026
Merged

docs+chore: alinha docs e config operacional com o hosting atual (Azure)#63
johnlaff merged 1 commit into
mainfrom
docs/fix-stale-status

Conversation

@johnlaff

@johnlaff johnlaff commented Jul 10, 2026

Copy link
Copy Markdown
Owner

O quê e por quê

Vários docs vivos e comentários operacionais ainda descreviam a Netlify como produção e premissas que deixaram de valer após a migração para Azure App Service (Brazil South, container B1 com Always On), servida em archtime.app. Documento que mente sobre produção é armadilha para o próximo leitor. Este PR alinha todas as referências vivas com a realidade atual, verificada no banco e na Azure.

Contexto → mudança

Verificação read-only: banco de produção com migrations 0000–0008 aplicadas, audit_log.ip_address removida, RLS write-lockdown completo; App Service B1 com alwaysOn=true, co-locado com o Supabase (sa-east-1, São Paulo).

Status e docs vivos

Arquivo Correção
plans/README.md 0007/0008 marcadas "aplicação pendente" → aplicadas e verificadas em produção
AGENTS.md hash = HMAC-SHA256 versionado por keyId em produção (fallback legado sem keyring); latência app↔banco caiu com a co-location; com Always On não há cold start de ociosidade (só em deploy/restart)
.env.local.example / ci.yml NEXT_PUBLIC_APP_URL dummy apontava para domínio Netlify; ci.yml não referencia mais netlify.toml como fonte da versão do Node

Config, comentários e código

Arquivo Correção
build-image.yml / Dockerfile / next.config.ts descreviam Netlify como produção atual → Azure é o hosting; build-image dispara o deploy via webhook
src/lib/server/security.ts saneamento de Host é do App Service (roteia por hostname), não do edge da Netlify (comentário de lógica ativa; ADR 0004)
src/app/layout.tsx fallback de metadataBasearchtime.app
README.md HMAC qualificado como keyed em produção; gatilho do build-image qualificado (ignora mudanças só de docs)

Deixado intacto (de propósito)

Registros point-in-time: ADRs (0004 já tem seção "Atualização"; 0003 cita Netlify só no contexto histórico), plans/001–024, docs/plans/*, docs/superpowers/*. Também: fixtures de teste com netlify.app, o matcher dormente isSameNetlifySitePreview (ADR 0004) e o resíduo netlify.toml + @netlify/plugin-nextjs (decisão de remoção à parte).

Como verificar

  • Gates locais: tsc limpo, 295 testes verdes, Biome limpo (183 arquivos), react-doctor zerado.
  • CI (verify) roda tsc + testes + lint + react-doctor + build.
  • Sem mudança de comportamento em produção: layout.tsx só troca um fallback inerte quando NEXT_PUBLIC_APP_URL está setado (produção); security.ts é comentário.

@johnlaff johnlaff changed the title docs: corrige status stale de migrations e refs de hosting docs+chore: alinha docs e config operacional com o hosting atual (Azure) Jul 10, 2026
@johnlaff
johnlaff force-pushed the docs/fix-stale-status branch from a803a61 to a22e25e Compare July 10, 2026 17:06
Producao migrou para Azure App Service (Brazil South, container B1 com Always
On), servida em archtime.app; a Netlify foi neutralizada. Varios docs e
comentarios operacionais ainda descreviam a Netlify como producao e premissas
que nao valem mais.

Status e docs vivos:
- plans/README.md: migrations 0007/0008 marcadas como aplicacao pendente ja
  estao aplicadas e verificadas em producao (ledger 0000-0008 completo).
- AGENTS.md: hash de integridade e HMAC-SHA256 versionado por keyId em producao
  (fallback legado hmac-v1:<digest> sem keyring); latencia app-banco caiu com a
  co-location (App Service + Supabase em Sao Paulo); com Always On nao ha cold
  start de ociosidade -- so em deploy/restart. O custo residual de um read no
  servidor e o hop extra e o worker unico do B1.
- .env.local.example / ci.yml: NEXT_PUBLIC_APP_URL dummy apontava para o dominio
  Netlify; ci.yml deixa de referenciar netlify.toml como fonte da versao do Node.

Config e comentarios:
- build-image.yml / Dockerfile / next.config.ts: descreviam Netlify como
  producao atual; Azure e o hosting. build-image dispara o deploy via webhook.
- src/lib/server/security.ts: o saneamento de Host e do App Service (roteia por
  hostname), nao do edge da Netlify (comentario de logica ativa; ADR 0004).
- src/app/layout.tsx: fallback de metadataBase aponta para archtime.app.
- README.md: HMAC qualificado como keyed em producao; gatilho do build-image
  qualificado (ignora mudancas so de docs).

Registros point-in-time (ADRs, plans/001-024, docs/plans, docs/superpowers),
fixtures de teste, o matcher dormente isSameNetlifySitePreview (ADR 0004) e o
residuo netlify.toml permanecem intactos.
@johnlaff
johnlaff force-pushed the docs/fix-stale-status branch from a22e25e to 580191a Compare July 10, 2026 17:18
@johnlaff
johnlaff merged commit 036a35d into main Jul 10, 2026
1 check passed
@johnlaff
johnlaff deleted the docs/fix-stale-status branch July 10, 2026 17:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant