Padrões de Desenvolvimento Keeptor

Padrões de Desenvolvimento Keeptor

Bem-vindo ao guia oficial de padrões de desenvolvimento da Keeptor Gestão e Tecnologia. Este documento é a referência obrigatória para todos os desenvolvedores do time.

Por que padrões importam? Trabalhamos com múltiplos clientes e projetos simultâneos. A padronização garante que qualquer desenvolvedor consiga navegar, entender e dar manutenção em código que não escreveu seja qual for o cliente ou projeto.


Escopo dos Padrões

Este guia cobre 3 áreas fundamentais do desenvolvimento na Keeptor:

ÁreaO que definePor que é crítico
Objetos de Banco de DadosNomenclatura de Procedures, Triggers, Functions, Views e demais objetosBanco com centenas de objetos fica ingerenciável sem padrão
Estrutura JavaHierarquia de pacotes, camadas, responsabilidadesEvita código espaguete e facilita onboarding de novos devs
Git e VersionamentoBranches, commits, rastreabilidadeHistórico limpo, rastreável e vinculado às tasks

Regra de Ouro

Se não está neste guia, pergunte antes de inventar. É preferível demorar 5 minutos perguntando do que gastar 2 horas refatorando depois.


Como Usar Este Guia

  1. Novos desenvolvedores: Leia todas as páginas antes do primeiro commit
  2. Desenvolvedores ativos: Consulte como referência rápida durante o desenvolvimento
  3. Tech Leads: Atualize quando houver decisões que mudem padrões

Versionamento deste Guia

VersãoDataAlteração
1.0.006/03/2026Versão inicial - Banco, Java, Git