Ir para o conteúdo

Inventário por Camada

Inventário completo de todos os documentos do sistema, organizados por camada. Cada documento tem o stage em que deve ser criado, o responsável e a referência ISO quando aplicável.

Legenda de stages:

MVP Stage 0 — necessário antes de publicar qualquer coisa
S1 Stage 1 — quando houver projeto público / open source
S2 Stage 2 — quando houver clientes pagantes
S3 Stage 3 — escala / preparação para certificação


Camada 1 — Corporate

Documento Stage Responsável
Visão e Missão MVP Founder
Estrutura Organizacional S2 Founder
Plano Estratégico S2 Founder

Atualização: Anual ou quando houver mudança estratégica relevante.


Camada 2 — Governance

Documento ID Stage ISO¹ Responsável
Política de Segurança POL-SEC-001 MVP 27001 A.5 Founder/Security
Política de Controle de Acesso POL-ACC-001 MVP 27001 A.8 Security
Política de Gestão de Mudanças POL-CHG-001 S1 20000-1 §8.5 Ops
Política de Gestão de Incidentes POL-INC-001 S1 20000-1 §8.6 Ops
Política de Backup POL-BAK-001 S1 27001 A.8.13 Ops
Política de Desenvolvimento Seguro POL-DEV-001 S1 27001 A.8.25 Dev
Política de Privacidade Interna POL-PRV-001 S2 27701 Legal
ADR Log ADR-0001+ MVP — Dev Lead
GOVERNANCE.md — S1 — Founder
CONTRIBUTING.md — S1 — Dev Lead
CODE_OF_CONDUCT.md — S1 — Founder

Atualização: Políticas: revisão anual mínima. ADRs: imutáveis.

[VERIFY] Referências ISO

Confirmar na ISO/IEC 27001:2022 os controles exatos do Anexo A aplicáveis ao contexto de uma empresa de API pequena. As referências acima são aproximadas e podem diferir da numeração oficial da versão 2022.


Camada 3 — Product

Documento ID Stage ISO¹ Responsável
Service Master Record SVC-BR-001 MVP 20000-1 §8.2 Product Owner
SLA Document SLA-BR-001 S2 20000-1 §8.2 Product/Ops
SLO Document SLO-BR-001 S1 — Ops/Dev
SLI Definitions — S1 — Ops/Dev
Support Tiers — S2 20000-1 §8.6 Ops
Product Roadmap — S1 — Product Owner
Deprecation Notices — S1 — Dev Lead

Atualização: Service Master Record: a cada mudança relevante no serviço. SLA: revisão com clientes.


Camada 4 — API

Documento Stage Responsável
README.md MVP Dev
openapi.yaml MVP Dev
Getting Started MVP Dev
Errors Reference MVP Dev
Versioning Policy MVP Dev Lead
CHANGELOG.md MVP Dev
SECURITY.md (disclosure) MVP Security
Limitations MVP Dev/Product
Authentication Guide S1 Dev/Security
Rate Limits S1 Dev/Ops
Deprecation Policy S1 Dev Lead
Examples / Cookbook S1 Dev
SLA (na doc da API) S2 Product/Ops
SDK Reference S2 Dev

Atualização: OpenAPI e CHANGELOG: a cada release. Outros: conforme mudanças.


Camada 5 — Data

Documento ID Stage Responsável
Source Record SRC-BR-001 MVP Data Engineer
Dataset Record DATA-BR-001 MVP Data Engineer
Field Documentation FIELD-BR-001-xxx MVP Data Engineer
Data Lineage — MVP Data Engineer
Third-party Data Attribution — MVP Legal/Data
Data Quality Report — S1 Data Engineer
Freshness Report — S1 Data/Ops
Transformation Log — S1 Data Engineer
Data Provenance Record — S1 Data Engineer

Atualização: Source Records: quando a fonte mudar. Dataset Records: a cada versão. Quality Reports: periodicamente.


Camada 6 — Service Management

Documento ID Stage ISO¹ Responsável
Incident Template — MVP 20000-1 §8.6 Ops
Incident Severity Definitions — MVP 20000-1 §8.6 Ops
Incident Log INC-YYYY-XXXX MVP 20000-1 §8.6 Ops
Postmortem Template — MVP — Dev/Ops
Release Policy — MVP — Dev Lead
Release Checklist — MVP — Dev
Change Request Template CHG-YYYY-XXXX S1 20000-1 §8.5 Ops
Change Log — S1 20000-1 §8.5 Ops
Business Continuity Plan BCP-001 S2 22301 §8 Ops/Founder
Disaster Recovery Plan — S2 22301 §8.7 Ops

[VERIFY] Referências ISO

Confirmar referências específicas de seção da ISO/IEC 20000-1:2018 e ISO 22301:2019.


Camada 7 — Security

Documento ID Stage ISO¹ Responsável
Security Policy POL-SEC-001 MVP 27001 A.5.1 Founder/Security
Access Control Policy POL-ACC-001 MVP 27001 A.8.2 Security
Secrets Management Guide — MVP 27001 A.8.24 Dev/Security
SECURITY.md (disclosure) — MVP — Security
Security Incident Template — MVP 27001 A.5.26 Security
Vulnerability Management — S1 27001 A.8.8 Security
Dependency Management — S1 27001 A.8.8 Dev/Security
Asset Inventory — S1 27001 A.5.9 Security/Ops
Logging & Monitoring Policy — S1 27001 A.8.15 Ops/Security
Supplier Security — S2 27001 A.5.19 Security
Penetration Test Record — S2 27001 A.8.8 Security

[VERIFY] Referências ISO/IEC 27001:2022

Referências do Anexo A são da ISO/IEC 27001:2022. A numeração mudou em relação à versão 2013. Verificar na documentação oficial antes de uso em contexto de auditoria.


LEGAL REVIEW REQUIRED

Todos os documentos desta camada. A LGPD (Lei nº 13.709/2018) pode ser aplicável desde o momento em que a empresa coleta ou processa dados de pessoas físicas — inclusive no MVP. Consultar advogado especializado antes de publicar qualquer serviço que envolva dados pessoais. Isso inclui logs de acesso, análise de uso e qualquer enriquecimento que possa identificar pessoas.

Documento Stage Nota
Third-party Attribution MVP Documentar fontes públicas utilizadas
Data License S1 Licença de uso dos dados da API
Privacy Policy (externa) S2 LGPD — revisão jurídica obrigatória
Terms of Service S2 Contrato com clientes
API Terms S2 Condições específicas de uso da API
Acceptable Use Policy S2 O que é e não é permitido com a API
LGPD Compliance Docs S2 ISO 27701 alinhado
Data Processing Agreements S2 Com clientes enterprise

Camada 9 — Open Source

Documento Stage Responsável
LICENSE MVP Founder/Legal
README.md MVP Dev
SECURITY.md MVP Security
CHANGELOG.md MVP Dev
CONTRIBUTING.md S1 Dev Lead
CODE_OF_CONDUCT.md S1 Founder
GOVERNANCE.md S1 Founder
ROADMAP.md S1 Product

Camada 10 — Evidence

Registro ID Stage Finalidade de Auditoria
Incident Records INC-YYYY-XXXX MVP Provar resposta a incidentes
Release Records REL-YYYY-XXXX MVP Provar processo de release
Postmortem Records — MVP Provar melhoria contínua
Change Records CHG-YYYY-XXXX S1 Provar controle de mudança
Security Scan Results — S1 Provar gestão de vulnerabilidades
Backup Test Records — S1 Provar continuidade
Availability Reports — S2 Provar cumprimento de SLA
Access Review Records — S2 Provar controle de acesso
Risk Review Records — S2 Provar gestão de riscos
Supplier Review Records — S2 Provar gestão de fornecedores

Nota de rodapé:

¹ Referências ISO são aproximadas e usadas como orientação conceitual, não como afirmação de certificação ou conformidade obrigatória. Ver marcações [VERIFY] nas seções correspondentes.