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/auth/jwt.ts

@@ -0,0 +1,25 @@
+export type UserRole = 'tenant_admin' | 'vendedor' | 'financeiro' | 'visualizador';
+
+export interface JwtPayload {
+  sub: string;
+  tipo: 'master' | 'tenant_user';
+  tenant_id: string | null;
+  role?: UserRole;
+  exp?: number;
+}
+
+/**
+ * Decodifica o payload do access token para ler identidade/papel no
+ * client. **Não valida assinatura nem expiração de verdade** — isso é
+ * responsabilidade exclusiva do backend em cada chamada de API; aqui é
+ * só para decisões de UI (qual área mostrar, quais itens de menu).
+ */
+export function decodeJwt(token: string): JwtPayload | null {
+  try {
+    const payload = token.split('.')[1];
+    const json = atob(payload.replace(/-/g, '+').replace(/_/g, '/'));
+    return JSON.parse(json) as JwtPayload;
+  } catch {
+    return null;
+  }
+}