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

📊 Banco de Dados

Nomenclatura de Procedures, Triggers, Functions, Views e demais objetos. Banco com centenas de objetos fica ingerenciável sem padrão.

→ Objetos de Banco de Dados

☕ Estrutura Java

Hierarquia de pacotes, camadas e responsabilidades. Evita código espaguete e facilita onboarding de novos devs.

→ Estrutura Java

🌿 Git e Versionamento

Branches, commits e rastreabilidade. Histórico limpo, rastreável e vinculado às tasks.

→ Git e Versionamento

🏷️ Nomenclaturas Keeptor

Convenções de nomes (entidades, módulos, FKs, options) usadas em toda a Plataforma Keeptor.

→ Nomenclaturas Keeptor

---

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