Frontend
Visão Geral
Stack e organização geral do gnoqcore-frontend.
Stack
- Framework: Next.js 16 (App Router, Turbopack, React Compiler habilitado)
- UI: React 19 + Tailwind CSS 4 + Radix UI (via
radix-ui) - Dados remotos: TanStack Query v5 + Axios
- Formulários: React Hook Form + Zod (
@hookform/resolvers) - Testes: Vitest
Para rodar localmente (variáveis de ambiente, scripts), veja Configuração e Execução Local.
Autenticação
O token JWT é salvo em cookie (token) e decodificado no client via usePermissions() (ver
Convenções) para exibir/esconder partes da UI. A validação real acontece no
backend — o frontend nunca deve confiar apenas na visibilidade de um item de menu como controle de acesso.
Páginas
Ver Funcionalidades para o inventário completo de todas as páginas — o que cada uma faz, qual permissão exige e a qual parte do backend ela se conecta.
Formulários
Ver Validação de Formulários para os padrões de schema Zod usados nas telas de cadastro (campos condicionais, transformação de payload, schema de criação vs. edição).