adaptador-planilhas/docs/cursor-prompts/spreadsheet-adapter/00-README.md

Pacote de Prompts — Adaptador de Planilhas Elo Pro

Este pacote foi preparado para construir o MVP do Adaptador de Planilhas dentro do ecossistema Elo Pro usando Cursor.

Como usar

1. Coloque esta pasta dentro do repositório (por exemplo, docs/cursor-prompts/spreadsheet-adapter/) ou mantenha-a aberta ao lado do projeto.
2. Execute os prompts na ordem numérica. Não envie todos de uma vez.
3. Em cada etapa, peça ao Cursor para primeiro inspecionar o repositório e apresentar um plano curto, e somente então alterar código.
4. Após cada pacote, rode lint, typecheck e testes pertinentes, revise o diff e faça um commit antes de seguir.
5. Se o repositório Elo Pro já tiver implementações equivalentes (auth, workspace, RLS, design system, audit log, feature flags, Sentry, Supabase clients), reutilize-as. Não crie versões paralelas.
6. As pendências arquiteturais ainda não decididas (storage, job runner, TTL, biblioteca XLSX, soft delete) devem ser implementadas somente se houver uma decisão existente no repositório; caso contrário, documente a decisão necessária e use uma abstração que permita troca posterior.

Ordem recomendada

• 01-MASTER-CONTEXT.md — contexto fixo e regras que o agente deve respeitar em todas as etapas.
• 02-REPO-AUDIT-PLAN.md — auditoria do repositório Elo Pro e plano de integração.
• 03-FOUNDATION-ROUTES-FEATURE-FLAG.md — esqueleto do módulo e rotas.
• 04-AUTH-WORKSPACE-PERMISSIONS-RLS.md — identidade única, workspace, autorização e RLS.
• 05-DATABASE-MIGRATIONS.md — schema do módulo.
• 06-DESIGN-SYSTEM-APP-SHELL.md — UI Elo Pro, shell e estados comuns.
• 07-MODEL-MANAGEMENT.md — gestão de modelos e configuração de upload.
• 08-SOURCE-UPLOAD-VALIDATION.md — fontes, validação, abas e cabeçalho.
• 09-MAPPING-PREVIEW.md — mapeamento 1:1 e revisão.
• 10-JOBS-PROCESSING-EXPORTS.md — jobs, processamento sequencial e saídas.
• 11-REDIS-PROGRESS-RESILIENCE.md — lock, progresso, idempotência e falhas.
• 12-AUDIT-SENTRY-SECURITY.md — auditoria, observabilidade e hardening.
• 13-TESTING-QA.md — testes unitários, integração, RLS, E2E e performance.
• 14-DEPLOYMENT-OPERATIONS.md — staging, migrations, feature flag e rollback.
• 15-FINAL-GAP-REVIEW.md — revisão final contra o escopo.

Regra de precedência

Quando houver conflito de informação, siga:

1. Regra de negócio validada do produto.
2. Arquitetura e segurança já existentes do Elo Pro.
3. Comportamento útil comprovado pelo primeiro MVP.
4. Documento V2 do Adaptador.
5. Fluxos/protótipos antigos.

Não invente regra de negócio para preencher lacunas. Registre a lacuna em docs/decisions/ ou em uma seção OPEN DECISIONS no relatório da etapa.