Service + Factory + DI
Guia introdutório dos padrões de código mais comuns do projeto. Feito para
Sistema de Auditoria — Rastreamento de Eventos no SuperApp
Entenda como o sistema de auditoria registra e consulta eventos de usuário no SuperApp, incluindo arquitetura, segurança, padrões de uso e extensibilidade.
AutoCarousel — Carrossel com avanço automático
Aprenda a usar o componente AutoCarousel para criar carrosseis com avanço automático e dots de navegação em qualquer parte do projeto.
BrandLogo — Logo de produto
Componente global para exibir o logo de um produto, com fallback para texto quando nenhuma imagem é fornecida.
Arquitetura de rotas por produto no monorepo — Next.js App Router
O superapp hospeda vários produtos (emplacamento, belite, intranet, operacional) num único app Next.js, cada um com sua própria pasta de topo em app/[locale]/. Um shell compartilhado (_shared/team-workspace) concentra as features comuns a todos (settings, membros, billing) para evitar duplicação, enquanto cada produto mantém suas próprias features de negócio. Este documento mapeia a árvore atual e descreve o passo a passo para adicionar um produto novo (TEC-448).
Design System — Extranets Associação Digital
Entenda a arquitetura CSS das extranets Associação Digital: tokens estruturais compartilhados, temas por cliente e como adicionar um novo produto.
Header e Footer — Site Público Abracaf
Documentação do Header e Footer do site público Abracaf: comportamento de scroll-collapse, menu mobile via Sheet e estrutura do rodapé.
Design Tokens — Extranets (extranet-base.css)
Tokens de design compartilhados entre todos os clientes extranet (Abracaf, Assobens, ABCNissan): layout, tipografia, bordas, sombras e transições.
Fluxo de teste visual via worktree (IA/agente)
Quando um agente de IA precisa validar mudanças visuais (CSS, componentes, layout) antes de commitar, o padrão usado neste projeto é subir uma segunda instância do next dev isolada, num worktree separado, sem interferir no pnpm dev que o desenvolvedor já tem rodando.
Middleware — proxy.ts
Documentação do middleware global da aplicação: matcher, handlers por rota e como adicionar exclusões de path.
Rate Limiting em Server Actions e Route Handlers
Aprenda como implementar rate limiting por IP em server actions usando o utilitário createRateLimiter do projeto.
ReportTable — Tabela de Relatórios com variante Pivot
Como usar o componente ReportTable do @kit/ui em suas variantes standard e pivot, com suporte a ordenação por coluna, agrupamento hierárquico e exportação.
Estrutura de Tabelas - Fenabrave Emplacamento
📋 Visão Geral