adaptador-planilhas/docs/cursor-prompts/spreadsheet-adapter/03-FOUNDATION-ROUTES-FEATURE-FLAG.md

PROMPT 03 — Fundação do módulo, rotas e feature flag

Use 01-MASTER-CONTEXT.md e a auditoria produzida no Prompt 02.

Objetivo

Criar o esqueleto do Adaptador dentro do Elo Pro sem duplicar infraestrutura já existente.

Implementar

1. Rota/página principal do Adaptador seguindo a convenção do App Router existente.
2. Entrada do módulo pelo mecanismo de navegação do Elo Pro.
3. Proteção por feature flag/plano/módulo conforme sistema existente.
4. Layout/shell inicial reutilizando navegação, workspace e componentes globais.
5. Rotas internas planejadas, por exemplo:
   • dashboard;
   • operação nova/atual;
   • configurações (somente perfis administrativos); Adapte nomes ao padrão do repo.
6. Boundary de erro e loading states no padrão Elo Pro.
7. Tipos centrais do domínio do Adaptador em local coerente com o repo.
8. Estrutura de módulos de domínio para evitar lógica pesada nos componentes React.

Regras

• Não crie login próprio.
• Não crie novo seletor de workspace se o Elo Pro já possui um.
• Não permita acesso ao módulo sem feature habilitada.
• Não implemente lógica de planilha ainda.
• Não introduza store global nova se não for necessária.

UX mínima

Dashboard inicial deve explicar o propósito e fornecer um CTA claro para iniciar uma adaptação, mas pode usar dados mockados somente dentro de testes/story fixtures. Em produção, não invente modelos/fonte falsos.

Testes

• acesso com módulo habilitado;
• acesso com módulo desabilitado;
• estado loading/error;
• rota de configurações inacessível a quem não tem permissão administrativa.

Entrega

• código;
• testes;
• docs/spreadsheet-adapter/01-foundation.md com rotas, guardas e decisões.
• reporte comandos rodados e resultados.