chore(agent): remover permissoes de commit da IA no projeto e wiki (apenas sugerir texto) e manter push automatico exclusivo no .agent
This commit is contained in:
parent
212d2578f4
commit
26a4f98dab
116 changed files with 1162 additions and 1315 deletions
82
global/rules/uso-estrito-enums-tabelas.md
Normal file
82
global/rules/uso-estrito-enums-tabelas.md
Normal file
|
|
@ -0,0 +1,82 @@
|
|||
---
|
||||
type: rule
|
||||
name: uso-estrito-enums-tabelas
|
||||
description: Uso estrito de constantes canônicas de Tabelas e Enums exportados por *-comuns (proibição de magic strings)
|
||||
scope: global
|
||||
trigger: always_on
|
||||
updatedAt: "2026-10-14"
|
||||
---
|
||||
|
||||
# Regra: Uso Estrito de Enums e Constantes de Tabelas (Eliminação de Strings Literais)
|
||||
|
||||
## Contexto
|
||||
|
||||
A utilização de strings mágicas (magic strings) e literais soltos para representar tabelas de banco de dados ou valores de enums é uma fonte crônica de bugs silenciosos em runtime. Quando um valor de enum ou nome de tabela é refatorado, o TypeScript não detecta comparações literais soltas (`u.papel === "administrador"`, `db("tickets")`), quebrando regras de negócio e consultas.
|
||||
|
||||
---
|
||||
|
||||
## Regra Fundamental
|
||||
|
||||
**É terminantemente proibido utilizar strings literais para referenciar tabelas do banco de dados ou valores que pertençam a enums canônicos.**
|
||||
|
||||
Todo desenvolvedor e agente de IA deve obrigatoriamente:
|
||||
1. Consultar `memorias-ia/modulo.yml` para identificar o módulo e importar as definições a partir do pacote compartilhado `<modulo>-comuns`;
|
||||
2. Utilizar a constante canônica `Tabelas` (ou `tabelas`) para toda e qualquer referência a tabelas no banco de dados (Knex, migrations, queries);
|
||||
3. Utilizar os objetos de Enum canônicos correspondentes para toda comparação, atribuição e checagem condicional de estado, papel, tipo ou severidade.
|
||||
|
||||
---
|
||||
|
||||
## 1. Referência a Tabelas de Banco de Dados
|
||||
|
||||
### ❌ Proibido
|
||||
```typescript
|
||||
db("tickets")
|
||||
db("usuarios as u")
|
||||
db("tarefas_manutencao")
|
||||
```
|
||||
|
||||
### ✅ Correto
|
||||
```typescript
|
||||
// Importar do pacote <modulo>-comuns do projeto atual
|
||||
import { Tabelas } from "<modulo>-comuns";
|
||||
|
||||
db(Tabelas.tickets)
|
||||
db(`${Tabelas.usuarios} as u`)
|
||||
db(Tabelas.tarefas_manutencao)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. Comparações e Atribuições de Enums
|
||||
|
||||
### ❌ Proibido
|
||||
```typescript
|
||||
if (ticket.status === "resolvido") { ... }
|
||||
if (usuario.papel === "administrador") { ... }
|
||||
if (tarefa.tipo_manutencao === "corretiva_bug") { ... }
|
||||
if (msg.tipo_mensagem === "nota_interna_equipe") { ... }
|
||||
```
|
||||
|
||||
### ✅ Correto
|
||||
```typescript
|
||||
// Importar os enums canônicos do pacote <modulo>-comuns
|
||||
import {
|
||||
StatusTicket,
|
||||
TipoUsuarioInterno,
|
||||
TipoManutencaoSoftware,
|
||||
TipoMensagem,
|
||||
} from "<modulo>-comuns";
|
||||
|
||||
if (ticket.status === StatusTicket.resolvido) { ... }
|
||||
if (usuario.papel === TipoUsuarioInterno.administrador) { ... }
|
||||
if (tarefa.tipo_manutencao === TipoManutencaoSoftware.corretiva_bug) { ... }
|
||||
if (msg.tipo_mensagem === TipoMensagem.nota_interna_equipe) { ... }
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Impacto
|
||||
|
||||
- Refatorações seguras assistidas pelo compilador TypeScript (`tsc --noEmit`);
|
||||
- Zero regressões causadas por erros tipográficos em nomes de tabelas ou enums;
|
||||
- Código fortemente tipado em todas as camadas (`*-comuns`, `*-back`, `*-front` e `*-migracao`).
|
||||
Loading…
Add table
Add a link
Reference in a new issue