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-ptbreoracle-tuning-ptbraplicam 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
- Naming: variáveis, procedures, functions, tabelas e colunas em PT-BR (exceto keywords Oracle, pacotes nativos, prefixos Trivadis)
- Prefixos Trivadis:
g_,gc_,l_,lc_,p_,r_,t_,co_,e_aplicados corretamente - Keywords em inglês:
BEGIN,END,EXCEPTION,BULK COLLECT,FORALL,MERGE INTOnunca traduzidos - Pacotes nativos em inglês:
DBMS_LOB,APEX_JSON,UTL_HTTP,DBMS_STATSnunca traduzidos lc_nome_unidadedeclarado em toda procedure públicagc_nome_pacotedeclarado no package body- Comentários em PT-BR — explicam o PORQUÊ, não o QUÊ
- Status values em PT-BR:
'PENDENTE','PAGO','CANCELADO','ATIVO','PROCESSADO' WHEN OTHERS THEN NULLausente — sempre propagar com contextoDBMS_OUTPUTausente 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 |