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.
Camada 8 — Privacy / Legal¶
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.