Roadmap por Stage¶
A empresa cresce em quatro stages. Cada stage tem seu conjunto mínimo de documentos, processos e automação. Não antecipe stages sem necessidade real.
- GitHub Organization + 4 repos base
- openapi.yaml (spec first)
- service.yaml
- LICENSE (antes de publicar)
- SECURITY.md
- POL-SEC-001 mínima
- ADR-0001
- Incident via GitHub Issues
- Dependabot (gratuito)
- Secret Scanning (gratuito)
- docs-governance + CONTRIBUTING
- ROADMAP.md público
- Source Records (SRC-BR-*)
- Dataset Records (DATA-BR-*)
- Data Lineage básico
- Política de mudanças
- SLO/SLI definitions
- CodeQL (gratuito OSS)
- Postmortem template
- infra-core
- SLA formal por serviço
- Terms of Service + ToU
- Privacy Policy (LGPD)
- Business Continuity Plan
- Risk Register
- Status page (svc-status)
- SLA reporting automatizado
- Access Reviews periódicos
- Supplier Security
- SDKs
- ISMS (ISO 27001)
- SMS (ISO 20000-1)
- PIMS (ISO 27701)
- BCMS (ISO 22301)
- Developer Portal
- Docs EN + PT-BR
- Enterprise SLA tiers
- Penetration testing formal
- Papéis dedicados
Stage 0 — Founder / Solo Developer¶
Objetivo: Existir de forma profissional. Ter código versionado, documentação mínima, processo básico de release e segurança fundamental.
.github/profile/README.md— cartão de visita da Organization.github/SECURITY.md— disclosure de segurança.github/PULL_REQUEST_TEMPLATE.mddocs-company/— estrutura + 2–3 políticas básicastemplates/— api-templateapi-{nome}/README.mdapi-{nome}/openapi.yaml— spec firstapi-{nome}/service.yaml— Service Master Recordapi-{nome}/CHANGELOG.mdapi-{nome}/LICENSEapi-{nome}/SECURITY.mdapi-{nome}/docs/getting-started.mdADR-0001— decisão de arquitetura do repo
- Branch protection em
main(mesmo solo) - PR obrigatório antes de merge
- Release via GitHub Releases com tag semântica
- Incidentes registrados como GitHub Issues com label
incident
- OpenAPI validation (GitHub Action)
- Markdown lint
- Dependabot (gratuito)
- GitHub Secret Scanning (gratuito)
- Secret Scanning habilitado na Organization (gratuito)
- Dependabot alerts (gratuito)
- Secrets via GitHub Secrets, nunca hardcoded
SECURITY.mdcom email de disclosure
- GitHub Issues = incident log
- GitHub Releases = release record
- Git history = change evidence
Uma pessoa acumulando todas as funções. Teams criados nominalmente para não precisar redesenhar quando a equipe crescer.
Duração típica: Dias 1–14 antes de publicar qualquer coisa.
Stage 1 — Open Source¶
Objetivo: Ter projeto público profissional. Aceitar contribuições externas. Construir reputação e comunidade.
docs-governance/com GOVERNANCE, CONTRIBUTING, CODE_OF_CONDUCTROADMAP.mdpúblicodata-{nome}/— primeiro dataset- Source Records (
SRC-BR-xxx) - Dataset Records (
DATA-BR-xxx) - Field Documentation
- Data Lineage básico
- POL-CHG-001 — Política de Gestão de Mudanças
- POL-INC-001 — Política de Gestão de Incidentes
- Postmortem template
- ADRs relevantes
- Change Management leve (baseado em GitHub Issues/PRs)
- Postmortem para incidentes significativos
- Data quality básica
- CodeQL (gratuito para open source)
- Dependency review em PRs
- Link checking
- Changelog automático ou semi-automático
- CodeQL habilitado
- Dependency review em PRs
- Secrets Management documentado formalmente
1–3 pessoas. Funções começam a se diferenciar.
Stage 2 — Commercial API¶
Objetivo: Ter clientes pagantes com obrigações contratuais, SLA mensurável e suporte formal.
- SLA formal por serviço (
SLA-BR-001) - SLO/SLI definitions
- Support tier documentation
- Terms of Service ⚠️
[LEGAL REVIEW REQUIRED] - Privacy Policy (LGPD) ⚠️
[LEGAL REVIEW REQUIRED] - API Terms ⚠️
[LEGAL REVIEW REQUIRED] - Business Continuity Plan (
BCP-001) - Disaster Recovery Plan
- Asset Inventory
- Risk Register
- Supplier Security assessments
svc-status(status page pública)
- Formal Change Management
- SLA reporting periódico
- Access Reviews (periódico, com evidência)
- Backup Tests (com evidência)
- Vulnerability Management formal
- SLA metrics automáticas
- Availability reporting
- Status page updates
- Container scanning (se aplicável)
3–8 pessoas. Funções diferenciadas: pelo menos Dev, Ops e Product.
Stage 3 — Scaled Company¶
Objetivo: Múltiplos serviços, equipe, clientes internacionais, requisitos enterprise. Possível preparação para certificação ISO.
- ISMS — Information Security Management System (ISO 27001)
- SMS — Service Management System (ISO 20000-1)
- PIMS — Privacy Information Management System (ISO 27701)
- BCMS — Business Continuity Management System (ISO 22301)
- SDKs múltiplos
- Developer Portal
- Documentação internacional (EN + PT-BR)
- Enterprise SLA tiers
- Relatórios de penetration testing
Papéis dedicados: Security Officer, Ops Lead, Legal Counsel, Data Engineer, Product Manager.
[VERIFY] Referências ISO para Stage 3
ISO/IEC 27001:2022, ISO/IEC 20000-1:2018, ISO 22301:2019 e ISO/IEC 27701:2019. Confirmar referências de seção na documentação oficial antes de uso em contexto de auditoria.
Próximo passo¶
Consulte as Dependências entre Documentos para ver em que ordem criar os documentos do Stage 0.