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.