camilafagundesandClaude Opus 5 a1ceef6c5f CI com serviços reais e imagem Linux; deploy só manual
O CI rodava lint, typecheck, testes e build, e nada mais: os drivers de
Postgres e Redis nunca eram exercitados, e não havia build de imagem nem
pipeline de deploy.

- Job `services`: Postgres e Redis efêmeros. Roda a suíte de serviços, aplica
  as quatro migrations, confere idempotência, confere que `--dry-run` não
  altera nada e que o shim é pulado com ADAPTER_APPLY_IDENTITY_SHIM=0.
- Job `image`: build da imagem Linux e validação do artefato. Conteúdo de
  runtime, usuário não-root, ausência de .env, docs, testes e vitest na
  imagem, os oito scripts operacionais transformando e executando, entrypoint
  recusando subcomando desconhecido, fail-fast com código diferente de zero
  na web e no worker, liveness com cabeçalhos de segurança, compose completo
  até `ready`, heartbeat do worker, jornada assíncrona entre processos e
  desligamento gracioso exigindo `SIGTERM recebido` em menos de 25s.
- `.github/scripts/async-journey.sh` percorre web → Redis → worker → download
  dos três formatos, atravessando a fronteira de processo que a suíte de
  testes não cobre.
- Deploy com gatilho único `workflow_dispatch`: não há deploy automático em
  push, tag ou merge. Migration, deploy e liberação da feature flag são jobs
  separados, cada um com seu ambiente de aprovação manual.
- Nenhum segredo entra em comando de shell. Um input de workflow interpolado
  em `run:` é injeção, então `workspace_id` passa por variável de ambiente e
  é validado como UUID antes de qualquer escrita. O deploy usa heredoc citado
  e `permissions: contents: read` no topo.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-10-15 20:39:56 -03:00
2026-10-02 23:59:36 -03:00
2026-10-02 23:59:36 -03:00

Adaptador de Planilhas

Módulo do Elo Pro para validar planilhas XLSX/CSV, mapear colunas para um modelo e gerar um arquivo novo. Não há login, senha ou tabela de usuários própria.

Desenvolvimento local

npm install
copy .env.example .env.local

No .env.local, para o piloto sem o host do Elo Pro:

ADAPTER_DEV_AUTH=1
ADAPTER_DEV_AUTH_SECRET=um-segredo-local
ADAPTER_JOB_MODE=inline
npm run dev

Abra /login e escolha uma identidade de desenvolvimento. Isso não pede senha: apenas assume um vínculo que o seed cria em profiles e workspace_members.

Produção

Obrigatórios: DATABASE_URL, NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY, SUPABASE_STORAGE_BUCKET, REDIS_URL, SPREADSHEET_TEMP_TTL_SECONDS, ELO_PRO_LOGIN_URL.

A feature flag spreadsheet_adapter nasce desligada. Habilite por workspace com npm run flag -- <workspace_id> on usando a conexão de serviço, nunca pelo browser.

O processamento de produção deve usar ADAPTER_JOB_MODE=worker e o processo npm run worker. O modo inline existe para desenvolvimento.

Verificação

npm run lint
npm run typecheck
npm test
npm run build
S
Description
No description provided
Readme
560 KiB
0 Stars 1 Watchers 0 Forks
Languages
TypeScript 92.7%
PLpgSQL 6.9%
CSS 0.2%
JavaScript 0.2%