adaptador-planilhas/docs/cursor-prompts/spreadsheet-adapter/04-AUTH-WORKSPACE-PERMISSIONS-RLS.md

PROMPT 04 — Autenticação Elo Pro, workspace, permissões e RLS

Use o MASTER CONTEXT. Este é um pacote de segurança crítica.

Objetivo

Garantir que o Adaptador opere integralmente com a identidade e o workspace existentes do Elo Pro.

Implementar/validar

1. Resolver sessão via mecanismo Supabase SSR já existente.
2. Resolver usuário/perfil sem segunda consulta desnecessária quando contexto já estiver disponível.
3. Resolver workspace ativo e validar workspace_members no servidor.
4. Helpers de autorização do módulo reutilizando os helpers Elo Pro quando existirem:
   • canUseSpreadsheetAdapter
   • canManageSpreadsheetModels
   • canUploadSpreadsheetModel Os nomes podem variar; a semântica deve permanecer.
5. Preparar políticas RLS para as futuras tabelas do módulo segundo as convenções do repo.
6. Garantir que workspace_id nunca seja confiado diretamente a payload de cliente.
7. Integrar feature flag à autorização.
8. Garantir comportamento correto ao trocar workspace.

Perfis esperados

• owner/admin: podem gerir modelos/configuração.
• gestor/agent: podem operar adaptações.
• upload de modelo por não-admin somente se setting do workspace permitir.
• Superadmin segue mecanismos globais existentes, sem bypass local criado pelo Adaptador.

Testes obrigatórios

• usuário sem sessão;
• usuário autenticado sem membership;
• workspace A tentando ler/escrever B;
• agent tentando ação administrativa;
• admin/owner executando ação administrativa;
• feature flag desligada;
• troca de workspace invalidando cache/dados anteriores.

Restrições

Não altere o modelo central de autenticação para “facilitar” o módulo. O Adaptador deve se adaptar ao Elo Pro.

Entrega

Documente em docs/spreadsheet-adapter/02-auth-workspace-permissions.md:

• fluxo de autenticação;
• fonte do workspace;
• matriz de permissões efetiva;
• estratégia RLS;
• testes executados.