Estudo do banco
O braço de dados levanta tabelas, relações, chaves estrangeiras que existem de fato, tipos de dinheiro e data e exclusão lógica, antes de alguém escrever consulta.
Entrega: mapa do banco, com o que está e o que faltaOcto para banco de dados · braço de dados
Ninguém altera o banco sem antes entendê-lo.
Restrições e chaves estrangeiras dão o controle dos dados; dinheiro pede tipo exato. Nesta etapa atua o braço de dados do Octo: estuda tabelas, relações, chaves estrangeiras reais, tipos de dinheiro e data e exclusão lógica antes de qualquer consulta ou alteração. O braço de desenvolvimento só altera o banco quando o plano aprovado manda, com a reversão pronta. O acesso ao banco de produção é autorizado pelo líder técnico.
BraçoDadosatua nesta etapa
Dinheironumerictipo exato no PostgreSQL
Fontes5listadas no fim da página
01
O que o Octo faz no banco.
Quatro entregas possíveis. Migration, modelo e acesso a produção são aprovados pelo líder técnico.
Migration com reversão
Quando o plano manda alterar o banco, a migration vem acompanhada da reversão, e a alteração em massa mostra antes quantas linhas vai tocar.
Entrega: migration e reversão para aprovaçãoRestrições que faltam
Aponta onde o banco confia só no código: chave estrangeira que não existe, coluna de dinheiro em tipo inexato, campo que deveria ser obrigatório.
Entrega: lista de restrições propostasDados pessoais e log
Mapeia onde há dado pessoal e confere que senha, identificador de sessão e dado pessoal sensível não vão para o log.
Entrega: mapa de dados pessoais para o encarregado
02
Oito braços, um banco entendido.
O mesmo ciclo do Octo, aplicado a esta etapa. Cada braço tem um papel estreito; quem comanda e aprova é o líder técnico da sua empresa.
-
Descoberta
Acha o banco
Qual banco, qual versão, onde ele roda e como o sistema se conecta.
-
Dados
Estuda o modelo
Tabelas, relações, chaves estrangeiras reais, dinheiro, data e exclusão lógica.
-
Segurança
Protege o dado
Dados pessoais, credenciais e o que o log grava.
-
Arquitetura
Planeja a mudança
Migration, reversão e ordem: banco antes do código.
-
Desenvolvimento
Altera só com plano
A migration roda com a reversão pronta e a contagem de linhas mostrada antes.
-
Revisão
Confere o resultado
Consulta pelo caminho real depois da migration, pelo conteúdo.
-
Publicação
Ordena a publicação
A migration sobe antes do código que depende dela.
-
Documentação
Registra o modelo
O mapa do banco fica no dossiê do sistema.
O Octo estuda e propõe; aprovar migration e modelo, autorizar o acesso ao banco de produção e decidir retenção e tratamento de dados pessoais com o encarregado é da sua equipe.
03
O que o Octo confere no banco.
Regras de referência. A documentação do banco que a sua empresa usa continua sendo a referência; os pontos de tipo vêm do PostgreSQL.
| Regra | O que o Octo confere | Base |
|---|---|---|
| Integridade referencial | Chave estrangeira declarada onde há relação | PostgreSQL, restrições |
| Dinheiro | Tipo exato (numeric), nunca real ou double precision | PostgreSQL, tipos numéricos |
| Injeção | Consulta parametrizada | OWASP Top 10 2025, A05 |
| Log | Sem senha, sem identificador de sessão, sem dado pessoal sensível | OWASP, Logging Cheat Sheet |
04
Do pedido à rotina.
Três degraus. Cada um só faz sentido depois que o anterior mostrou resultado na sua equipe.
Proposta, não promessa
Mapa do banco
O braço de dados estuda o banco que você já tem, sem alterar nada.
- Tabelas e relações reais
- Dinheiro, data e exclusão lógica
- Dados pessoais
Migrations com reversão
Toda alteração de banco passa a ter reversão e contagem antes.
- Migration e reversão
- Banco antes do código
Restrições no banco
As restrições que faltam entram aos poucos, cada uma numa atividade.
- Chaves estrangeiras declaradas
- Tipos corrigidos
05
Confirmado em fonte.
Cada ponto abaixo tem fonte publicada pela organização responsável pela norma, pela especificação ou pela ferramenta, ou em lei federal. As fontes estão na seção seguinte.
7
pontos com fonte publicada, cada um com a referência indicada ao lado.
- ConfirmadoRestrições
- No PostgreSQL, as restrições dão tanto controle sobre os dados das tabelas quanto se queira; os tipos sozinhos limitam pouco.Fonte: PostgreSQL, restrições
- ConfirmadoChave estrangeira
- A chave estrangeira mantém a integridade referencial entre duas tabelas relacionadas.Fonte: PostgreSQL, restrições
- ConfirmadoDinheiro
- O tipo numeric é especialmente recomendado para guardar valores monetários e outras quantidades em que a exatidão é exigida.Fonte: PostgreSQL, tipos numéricos
- ConfirmadoTipos inexatos
- Os tipos real e double precision são numéricos inexatos, de precisão variável.Fonte: PostgreSQL, tipos numéricos
- ConfirmadoInjeção
- A injeção continua no OWASP Top 10 de 2025, como A05:2025.Fonte: OWASP, Top 10 2025
- ConfirmadoLGPD
- A LGPD pede medidas de segurança, técnicas e administrativas, para proteger os dados pessoais.Fonte: Planalto, Lei 13.709/2018, art. 46
- ConfirmadoO que não vai para o log
- Não registrar em log senhas de autenticação, valores de identificação de sessão nem dados pessoais sensíveis.Fonte: OWASP, Logging Cheat Sheet
06
O que o Octo faz e o que fica com vocês.
O Octo prepara tudo, mas não assina. O documento que vale continua com quem responde por ele.
O Octo prepara
Mapeia, planeja, programa na branch da atividade, revisa com evidência e prepara a publicação: planos, código, revisões, relatórios de segurança e o dossiê do sistema.
Entrega: material pronto para conferirA sua equipe confere
Quem comanda é o líder técnico ou o desenvolvedor sênior da empresa: aprova o plano, revisa o PR e faz o merge. Nada vai para produção sem a aprovação de quem comanda.
Etapa: aprovação por quem comandaQuem assina e responde
O Octo não assina e não responde pelo sistema. Quem aceita o risco e responde pelo sistema em produção é o líder técnico; laudo ou parecer de segurança é assinado por profissional da empresa.
Responsável: líder técnico da empresa
07
Fontes.
Documentação do PostgreSQL, OWASP e legislação federal publicada no Planalto. Consultadas em 31/10/2026.
- PostgreSQL: restriçõesRestrições e chave estrangeira
- PostgreSQL: tipos numéricosnumeric para dinheiro; real e double precision inexatos
- OWASP: Top 10, edição 2025Os dez riscos de aplicação web
- Planalto: Lei 13.709/2018 (LGPD)Art. 46
- OWASP: Logging Cheat SheetO que não registrar
O seu banco entendido antes de mexer.
O diagnóstico começa pelo banco que você já tem, em leitura, sem alterar nada. Você recebe o mapa e decide com ele na mão.