Implementa o MVP do Adaptador de Planilhas no Elo Pro.

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>

docs/decisions/0001-object-storage.md

@@ -0,0 +1,7 @@
+# ADR 0001 — Object storage
+
+Status: aberta, com adaptação provisória.
+
+Produção exige `SUPABASE_SERVICE_ROLE_KEY` e `SUPABASE_STORAGE_BUCKET`. O cliente só faz upload/download pelo Route Handler, depois da autorização. Sem essas variáveis, produção recusa subir o storage. Desenvolvimento usa `.data/storage`, fora da pasta pública do Next.
+
+Recomendação: bucket privado no Supabase Storage, ou S3 compatível atrás da mesma interface `ObjectStorage`.

docs/decisions/0002-sso-topology.md

@@ -0,0 +1,5 @@
+# ADR 0002 — Login único entre hosts
+
+Status: aberta.
+
+O Adaptador lê a sessão Supabase e o cookie `elo_pro_workspace_id`. Não copia usuários nem cria senha. A topologia de domínio e cookie compartilhado continua com a arquitetura do Elo Pro. `ELO_PRO_LOGIN_URL` é o destino quando não há sessão.

docs/decisions/0003-job-runner.md

@@ -0,0 +1,7 @@
+# ADR 0003 — Job runner
+
+Status: aberta, com dois modos explícitos.
+
+`ADAPTER_JOB_MODE=worker` apenas marca o job como `queued`. O processo `npm run worker` executa com o mesmo `runProcess`, lock e estado no PostgreSQL. `inline` executa na própria chamada e existe para desenvolvimento e teste. Produção sem a variável cai em `worker`.
+
+Recomendação: manter o worker como processo contínuo no piloto. Não depender do tempo de uma função serverless.

docs/decisions/0004-temp-ttl.md

@@ -0,0 +1,5 @@
+# ADR 0004 — TTL de temporários
+
+Status: aberta.
+
+`SPREADSHEET_TEMP_TTL_SECONDS` é obrigatório em produção e aceita de 1 segundo a 7 dias para não gravar um número de produto no código. Fora de produção, a omissão usa 3600 segundos só para o ambiente local. A limpeza não apaga chaves que contenham `/models/`.

docs/decisions/0005-xlsx-library.md

@@ -0,0 +1,11 @@
+# ADR 0005 — Biblioteca de planilha
+
+Status: aberta. Implementação provisória: ExcelJS (MIT) atrás de `readSpreadsheet`, `buildXlsx` e CSV próprio.
+
+Alternativas consideradas:
+
+- ExcelJS, MIT, leitura e escrita, manutenção ativa, não promete preservar a formatação do modelo.
+- SheetJS comunitário, leitura muito usada; a licença das versões atuais precisa de revisão jurídica antes de produção.
+- ExcelJS para grade e geração de arquivo novo, que é o comportamento do MVP: a saída não sobrescreve o modelo.
+
+O binário do modelo é só lido. O teste de jornada compara os bytes antes e depois. Trocar de biblioteca não deve vazar para os componentes React.

docs/decisions/0006-action-blue.md

@@ -0,0 +1,9 @@
+# ADR 0006 — Azul de ação e exclusão de modelo
+
+## Azul de ação
+
+O escopo fixa Bright Blue `#2F8FFF` e pede o azul primário do token oficial, que não estava no repositório. Uso provisório: `#0B3D91` em `--color-action`, com texto branco. Substituir quando o pacote do Design System Elo Pro for ligado.
+
+## Exclusão
+
+Status: aberta. O schema marca `deleted` e preenche `deleted_at`, mantém o arquivo e o histórico. A exclusão física pode ser feita depois sem migração destrutiva. Enquanto houver job em `validating`, `ready`, `queued` ou `processing`, a exclusão é recusada.