Ir para o conteúdo

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.


Stage 0
Founder / Solo
  • 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)
Stage 1
Open Source
  • 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
Stage 2
Commercial API
  • 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
Stage 3
Scaled Company
  • 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.md
  • docs-company/ — estrutura + 2–3 políticas básicas
  • templates/ — api-template
  • api-{nome}/README.md
  • api-{nome}/openapi.yaml — spec first
  • api-{nome}/service.yaml — Service Master Record
  • api-{nome}/CHANGELOG.md
  • api-{nome}/LICENSE
  • api-{nome}/SECURITY.md
  • api-{nome}/docs/getting-started.md
  • ADR-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.md com 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_CONDUCT
  • ROADMAP.md público
  • data-{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.