Noções Básicas de Governança

8 exemplos de governança em dezenas de serviços Node.js - 6 básicos e 2 intermediários. Objetivo: qualidade previsível sem que cada PR espere por um engenheiro sênior.

Pré-requisitos

• Equipe de plataforma ou arquitetura com mandato
• Repositório de template interno ou template de software Backstage
• Patrocinador executivo para padrões aplicados (não diretrizes opcionais)

Exemplos Básicos

1. O Que Governar

• Governe resultados (SLO, SLA de CVE), não cada escolha de importação

2. Scaffold de Caminho Dourado

npm create @acme/node-service
  → Template Fastify 5 + Prisma + OTel + GitHub Actions
  → docs/adr/000-template.md incluído
  → .nvmrc = 24.18.0

• Novos serviços começam em conformidade; o legado adota via backlog
• Veja API Scaffold Skill

Relacionado: Padrões de Codificação

3. Automatize Antes de Mandar

Política: sem CVE crítico em produção
Aplicação: CI falha em `npm audit --audit-level=critical`
Não: lembrete por e-mail para 40 equipes

4. Processo de Exceção

## Exceção EX-014: legacy-webhook em Node 20
**Razão:** TLS do fornecedor não será atualizado até 2026-10-01
**Dono:** @bob
**Expiração:** 2026-10-15 (falha automática na CI se não renovado)
**Risco aceito por:** EM + Segurança

• Exceções sem expiração se tornam dívida permanente

5. Níveis de Maturidade de Serviço

• Esforço de governança proporcional ao raio de explosão

6. Calendário de RFC e Padrões

Mensal: revisão de RFC do Node (30 min guilda de plataforma)
Trimestral: atualização de padrão de codificação (ESLint major)
Anual: planejamento da onda de atualização LTS

• Link Rastreando RFC e Diagnóstico do Node

Exemplos Intermediários

7. Painel de Conformidade

Painel da frota:
  - % em Node 24 LTS
  - % com exportador OTel configurado
  - Contagem de CVEs críticos abertos
  - ADR com mais de 2 anos (revisão obsoleta)

• Métricas vermelhas criam itens de sprint, não posts de vergonha

8. Guilda vs Polícia

Guilda de plataforma: propõe padrões, mantém templates
Líder técnico do esquadrão: adota no serviço, arquiva exceções
Segurança: veto em política de autenticação/PII

• A governança tem sucesso quando os esquadrões veem entrega mais rápida, não mais lenta

FAQs

Relacionados

• Padrões de Codificação - aplicação de estilo
• Governança de Dependências - cadeia de suprimentos
• Política de Atualização do Node - calendário LTS
• Melhores Práticas de Governança - lista condensada
• Melhores Práticas de Liderança Técnica - papel do esquadrão

Versões de Stack: Esta página foi escrita para Node.js 24.18.0 (Active LTS), npm 10+, TypeScript 5.6+, Express 5, Fastify 5, e NestJS 11.