refatoração dos agents

global/rules/zod-validacao-padrao

@@ -149,57 +149,17 @@ produto.nome = produto.nome.trim()
 produto.codigo = produto.codigo?.toUpperCase()
 ```
 
-### 8. Composição de schemas em vez de duplicação
+### 8. Composição e Enums Zod
 
 ```typescript
-// ✅ CORRETO — composição
-const zEndereco = z.object({
-  rua: z.string(),
-  cidade: z.string(),
-  uf: z.string().length(2),
-})
+// ✅ Composição de schemas via extend/partial
+const zEndereco = z.object({ rua: z.string(), cidade: z.string() })
+const zEmpresaCriar = z.object({ nome: z.string(), endereco: zEndereco })
+const zEmpresaEditar = zEmpresaCriar.partial()
 
-const zEmpresaCriar = z.object({
-  nome: z.string(),
-  endereco: zEndereco,
-})
-
-const zEmpresaEditar = zEmpresaCriar.partial() // todos opcionais
-
-const zEmpresaResposta = zEmpresaCriar.extend({
-  codigo: z.string().uuid(),
-  criadoEm: z.string().datetime(),
-})
-
-// ❌ ERRADO — copiar campos entre schemas
-const zEmpresaEditar = z.object({
-  nome: z.string().optional(),    // duplicou!
-  endereco: z.object({            // duplicou!
-    rua: z.string().optional(),
-    cidade: z.string().optional(),
-  }),
-})
-```
-
-### 9. Enums Zod para valores de domínio
-
-```typescript
-// ✅ CORRETO — enum Zod quando os valores vêm de dados externos
+// ✅ Enum Zod para valores de domínio
 export const zStatusLicenca = z.enum(["ativa", "vencida", "suspensa", "cancelada"])
 export type tipoStatusLicenca = z.infer<typeof zStatusLicenca>
-
-// Usar em outros schemas
-const zLicencaCriar = z.object({
-  status: zStatusLicenca,
-  // ...
-})
-
-// ✅ TAMBÉM CORRETO — TypeScript enum quando já existe no projeto
-// e o schema referencia o enum
-import { StatusLicenca } from "./enums"
-const zLicencaCriar = z.object({
-  status: z.nativeEnum(StatusLicenca),
-})
 ```
 
 ### 10. Bibliotecas proibidas para validação
@@ -233,57 +193,20 @@ app.post("/usuarios", async (req, res) => {
 })
 ```
 
-### Webhook com fila
+### Variáveis de ambiente e Frontend
 
 ```typescript
-// ✅ Correto — valida antes de enfileirar
-const zPayloadWebhook = z.object({
-  tabela: z.enum(["empreendedores", "empreendimentos", "usuarios"]),
-  dados: z.array(z.unknown()).min(1),
-})
-
-app.post("/webhook/:tabela", async (req, res) => {
-  const resultado = zPayloadWebhook.safeParse({
-    tabela: req.params.tabela,
-    dados: req.body,
-  })
-  if (!resultado.success) {
-    return res.status(400).json({ erro: "Payload inválido" })
-  }
-  await fila.add("sync", resultado.data)
-  return res.json({ ok: true })
-})
-```
-
-### Variáveis de ambiente
-
-```typescript
-// ✅ Correto — validar no boot da aplicação
-const zAmbiente = z.object({
+// ✅ Validar env no boot da aplicação
+export const ambiente = () => z.object({
   DATABASE_URL: z.string().url(),
-  REDIS_HOST: z.string().default("localhost"),
-  REDIS_PORT: z.coerce.number().default(6379),
-  BASE_URL: z.string().url(),
-  SESSAO_BACK: z.string().uuid(),
   NODE_ENV: z.enum(["development", "production", "test"]).default("development"),
-})
-
-export const ambiente = () => zAmbiente.parse(process.env)
-```
-
-### Frontend (formulário Vue)
-
-```typescript
-// ✅ Correto — schema compartilhado validando antes de enviar
-import { zUsuarioCriar } from "projeto-comuns/tabelas/usuarios"
+}).parse(process.env)
 
+// ✅ Frontend: usar schema compartilhado antes de enviar
 const salvar = async () => {
-  const resultado = zUsuarioCriar.safeParse(formulario.value)
-  if (!resultado.success) {
-    erros.value = resultado.error.flatten().fieldErrors
-    return
-  }
-  await api.post("/usuarios", resultado.data)
+  const res = zUsuarioCriar.safeParse(formulario.value)
+  if (!res.success) return (erros.value = res.error.flatten().fieldErrors)
+  await api.post("/usuarios", res.data)
 }
 ```