Ir para o conteúdo

Teams e Permissões


Estrutura de Teams

Organization
├── @maintainers      → admin em todos os repos
├── @developers       → write em api-*, data-*; read em docs-*
├── @data-engineers   → write em data-*; read em api-*
├── @security         → write em docs-company/policies; read em tudo
└── @community        → read em repos públicos (automático GitHub)

Stage 0 — Solo/Microequipe

Uma única pessoa tem permissão de admin. Teams são criados nominalmente mas não geram overhead operacional. O mesmo fundador acumula todos os papéis.

A estrutura de teams existe para que, quando a equipe crescer, as permissões já estejam definidas e não precisem ser redesenhadas.


Permissões por Repositório

Repositório @maintainers @developers @data-engineers @security
.github admin write read read
docs-company admin read read write
docs-governance admin write read read
templates admin write read read
api-* admin write read read
data-* admin read write read
infra-core admin read read read

Acesso de Clientes Externos

PAID / PLAN DEPENDENT

Acesso de clientes externos via GitHub Teams requer plano pago para Organizations com repositórios privados.

Alternativas gratuitas:

  • Tokens de acesso específicos por repositório (Personal Access Tokens com escopo limitado)
  • GitHub Apps para controle granular de permissões por instalação
  • Fine-grained tokens com permissão de leitura por repositório específico

CODEOWNERS

Cada repositório deve ter um arquivo CODEOWNERS na raiz ou em .github/. Ele garante que revisões de código e documentação sejam solicitadas automaticamente ao responsável correto.

Exemplo para api-{nome}:

# CODEOWNERS
# Sintaxe: <padrão> <@usuário ou @equipe>

# Código da API → desenvolvedores
/src/             @org/developers

# OpenAPI spec → maintainers (mudança de contrato requer aprovação)
openapi.yaml      @org/maintainers

# Documentação → qualquer desenvolvedor
/docs/            @org/developers

# Políticas de segurança → security
SECURITY.md       @org/security

# Service record → maintainers
service.yaml      @org/maintainers

Matriz RACI Simplificada

Em uma microempresa, uma mesma pessoa pode acumular múltiplas funções. A tabela abaixo mostra como os papéis se distribuem quando a equipe crescer.

Atividade Founder Developer Security Ops Data Legal
Criar repositório R I I I I —
Aprovar OpenAPI spec A R — — — —
Escrever política de segurança A I R I — C
Responder incidente A R C R C —
Publicar release A R C C — —
Aprovar SLA A C — C — C
Revisar fontes de dados A C — — R —
Revisar documentos legais A — I — — R

R = Responsável (executa) · A = Accountable (aprova) · C = Consultado · I = Informado

No Stage 0: o Founder é R e A em praticamente tudo. A tabela serve para documentar a intenção, não a realidade atual.