camilafagundesandCursor
6e23f1533b
O módulo usa a identidade Supabase, isola cada workspace e registra storage, TTL, runner e biblioteca XLSX como decisões ainda abertas. Co-authored-by: Cursor <cursoragent@cursor.com>
43 lines
2.7 KiB
Markdown
43 lines
2.7 KiB
Markdown
# 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.
|