Oracle trivadis ptbr

oracle-trivadis-ptbr — v2.0.0

Trivadis PL/SQL Guidelines 4.4 — padrão de nomenclatura, estrutura de código e checklist de revisão.

Desenvolvido por: Maxwell da Silva Oliveira — M&S do Brasil LTDA

Áreas cobertas

Área	Reference
Trivadis Guidelines 4.4	references/plsql-trivadis-guidelines.md

Referência cruzada: Esta skill documenta o padrão. As skills oracle-plsql-ptbr, oracle-apex-ptbr, oracle-ords-ptbr, oracle-dba-ptbr e oracle-tuning-ptbr aplicam Trivadis automaticamente em todo código gerado.

Quando ativar

• "Esse código segue Trivadis?" — revisão explícita de padrão
• "Qual prefixo usar para essa variável/cursor/constante?"
• "Como nomear essa tabela/coluna/package em PT-BR?"
• Checklist pré-deploy / pré-GMUD: validar naming antes de subir para produção
• Auditoria de código legado: identificar desvios do padrão
• Dúvidas sobre convenções: exceções locais vs globais, packages nativos Oracle em inglês, status values em PT-BR

Não usar para: geração de código PL/SQL (→ oracle-plsql-ptbr), APEX, ORDS, DBA ops, tuning.

Prefixos canônicos Trivadis

Prefixo	Uso	Exemplo
g_	Variável global (package)	g_ultima_execucao
gc_	Constante global (package)	gc_nome_pacote
l_	Variável local	l_total_pago
lc_	Constante local	lc_nome_unidade
p_	Parâmetro	p_id_fatura
r_	Record	r_fatura
t_	Type (collection, record)	t_lista_ids
co_	Cursor	co_faturas_pendentes
e_	Exception user-defined	e_estado_invalido

Checklist de revisão — o que verificar

1. Naming: variáveis, procedures, functions, tabelas e colunas em PT-BR (exceto keywords Oracle, pacotes nativos, prefixos Trivadis)
2. Prefixos Trivadis: g_, gc_, l_, lc_, p_, r_, t_, co_, e_ aplicados corretamente
3. Keywords em inglês: BEGIN, END, EXCEPTION, BULK COLLECT, FORALL, MERGE INTO nunca traduzidos
4. Pacotes nativos em inglês: DBMS_LOB, APEX_JSON, UTL_HTTP, DBMS_STATS nunca traduzidos
5. lc_nome_unidade declarado em toda procedure pública
6. gc_nome_pacote declarado no package body
7. Comentários em PT-BR — explicam o PORQUÊ, não o QUÊ
8. Status values em PT-BR: 'PENDENTE', 'PAGO', 'CANCELADO', 'ATIVO', 'PROCESSADO'
9. WHEN OTHERS THEN NULL ausente — sempre propagar com contexto
10. DBMS_OUTPUT ausente em produção — substituído por Logger

O que fica em inglês obrigatoriamente

Categoria	Exemplos
Keywords SQL/PL/SQL	BEGIN, END, EXCEPTION, BULK COLLECT, FORALL, RETURN, IS, AS
Pacotes Oracle nativos	DBMS_LOB, DBMS_OUTPUT, DBMS_STATS, APEX_JSON, UTL_HTTP
Funções built-in	SYSDATE, NVL, COALESCE, TO_DATE, INSTR, SUBSTR
Variáveis sistema APEX	:APP_USER, :APP_SESSION, :APP_ID
Hints	/*+ APPEND */, /*+ PARALLEL */, /*+ INDEX */
Prefixos Trivadis	g_, gc_, l_, lc_, p_, r_, t_, co_, e_

Referências cruzadas

Precisa de	Skill
Geração de código PL/SQL, packages	oracle-plsql-ptbr
Código dentro de APEX processes	oracle-apex-ptbr
Código dentro de ORDS handlers	oracle-ords-ptbr
Scripts DBA com padrão Trivadis	oracle-dba-ptbr