adaptador-planilhas/docs/cursor-prompts/spreadsheet-adapter/02-REPO-AUDIT-PLAN.md

PROMPT 02 — Auditoria do repositório e plano de integração

Use 01-MASTER-CONTEXT.md como contexto obrigatório.

Tarefa

Antes de escrever funcionalidades, faça uma auditoria técnica do repositório Elo Pro para descobrir os padrões reais que o Adaptador deve reutilizar.

Inspecione especificamente

1. Estrutura Next.js/App Router e convenções de pastas.
2. Implementação atual de Supabase:
   • browser client;
   • server client;
   • SSR/cookies;
   • middleware;
   • refresh de sessão;
   • logout.
3. Como o app resolve workspace_id ativo e membership.
4. Tipos/papéis reais existentes (owner/admin/gestor/agent ou equivalentes).
5. RLS/migrations existentes e helpers de autorização.
6. Sistema de feature flags/planos/módulos.
7. Design System Elo Pro: componentes, tokens, Tailwind, fontes, ícones e layouts.
8. TanStack Query: QueryClient, providers, query keys e padrão de mutations.
9. Sentry: client/server/edge, scrubbing e tags.
10. Redis: conexão, helpers, namespaces e fallback.
11. Audit log existente.
12. Storage existente e políticas de bucket.
13. Padrão para Route Handlers/Server Actions.
14. Estratégia de testes, fixtures, Vitest e E2E se houver.
15. CI/CD, migrations e ambientes.

Não faça ainda

• Não crie tabelas.
• Não implemente telas.
• Não instale biblioteca XLSX.
• Não altere autenticação.

Saída esperada

Crie docs/spreadsheet-adapter/00-repo-integration-audit.md contendo:

• padrões existentes que serão reutilizados;
• caminhos/arquivos relevantes;
• diferenças entre o MASTER CONTEXT e o estado atual do repo;
• decisões já resolvidas pelo repo;
• OPEN DECISIONS somente para o que realmente não estiver definido;
• arquitetura proposta do módulo em 1 diagrama Mermaid;
• plano de implementação por fases e dependências.

No chat do Cursor, finalize com:

1. resumo de no máximo 15 bullets;
2. lista dos arquivos inspecionados mais importantes;
3. lista de decisões que exigem confirmação humana.

Não altere código de produção nesta etapa.