Pular para o conteúdo principal

Nomenclatura

Geral​

  • Português ou inglês: siga o idioma já dominante no repositório; não misture na mesma camada.
  • Evite abreviações obscuras (usr, tmp, calc) exceto siglas de domínio conhecidas (CNPJ, WL, RBAC).
  • Booleanos: prefixo is, has, can, should — isAtivo, hasPermissao.

PHP / backend legado Gevtech​

  • Funções de serviço: prefixo de domínio existente (backend_estabelecimento_listar).
  • Arquivos de API alinhados ao recurso (listar.php, criar.php) quando o padrão do módulo já for assim.

JavaScript / frontend​

  • camelCase para variáveis e funções; PascalCase para componentes React.
  • Constantes de config: UPPER_SNAKE_CASE.

SQL e migrations​

  • Tabelas/colunas em snake_case; nomes no singular ou plural conforme padrão do banco do projeto.
  • Scripts versionados com data ou sequência, conforme runbook do repositório.

Anti-patterns​

❌ $d, processData(), arquivo_final_v2.php
✅ $dataVencimento, calcularComissaoRepresentante(), exportar-transacoes.php