Frontend completo (Etapas 11-18) e extensões de backend (Etapas 13 e 18)

Adiciona o frontend Next.js em frontend/ (setup, design system,
autenticação/tema, layout/navegação, área master, área tenant completa:
clientes, produtos, vendas, recebimentos, whatsapp, e-mail, alertas,
equipe e perfil). Estende o backend de forma aditiva e autorizada:
cookie httpOnly para refresh token (Etapa 13) e CRUD de equipe +
edição de perfil do tenant (Etapa 18, módulo src/modules/equipe/ novo
e PUT /tenant/perfil). Detalhes completos em Etapas/V2/*.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

frontend/lib/validators/customers.ts

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+
+/** Espelha `DOCUMENTO_REGEX` (`src/modules/customers/documento.util.ts`) — CPF/CNPJ, sem dígito verificador. */
+const DOCUMENTO_REGEX = /^(\d{11}|\d{14}|\d{3}\.\d{3}\.\d{3}-\d{2}|\d{2}\.\d{3}\.\d{3}\/\d{4}-\d{2})$/;
+
+/** Espelha `CreateCustomerDto`/`UpdateCustomerDto` (`src/modules/customers/dto/`). */
+export const customerSchema = z.object({
+  razao_social: z.string().min(2, 'Informe pelo menos 2 caracteres'),
+  nome_fantasia: z.string().optional(),
+  documento: z
+    .string()
+    .optional()
+    .refine((v) => !v || DOCUMENTO_REGEX.test(v), { message: 'Informe um CPF ou CNPJ válido' }),
+  email: z.email('E-mail inválido').optional().or(z.literal('')),
+  telefone_whatsapp: z.string().optional(),
+  endereco: z.string().optional(),
+  cidade: z.string().optional(),
+  uf: z.string().length(2, 'UF deve ter 2 letras').optional().or(z.literal('')),
+  observacoes: z.string().optional(),
+});
+
+export type CustomerFormValues = z.infer<typeof customerSchema>;
+
+/** Espelha `CreateContactDto`/`UpdateContactDto`. */
+export const customerContactSchema = z.object({
+  nome: z.string().min(2, 'Informe pelo menos 2 caracteres'),
+  cargo: z.string().optional(),
+  email: z.email('E-mail inválido').optional().or(z.literal('')),
+  telefone_whatsapp: z.string().optional(),
+  principal: z.boolean(),
+});
+
+export type CustomerContactFormValues = z.infer<typeof customerContactSchema>;