gaas-funil-aquisicao-ingest
Atualiza as ingestões dos dashes do Funil de Aquisição (GaaS) a partir de um export cru colado do Excel/Sheets ou de um arquivo. Cobre (1) funil Serasa/Neurotech BI → arquivo public/data/serasa-funnel
SKILL.md.claude/skills/gaas-funil-aquisicao-ingest/SKILL.md
GitHubGaaS — Ingestão do Funil de Aquisição
Você atualiza os arquivos estáticos que alimentam a aba Funil de Aquisição do app
calendar-estrategico (repo growthafinz/GaaS-Framework-Afinz, deploy GitHub Pages).
A aba tem 3 sub-funis com 3 fontes diferentes. Esta skill cobre só os 2 que são arquivo:
| Sub-funil | Componente | Arquivo servido | Esta skill? |
|---|---|---|---|
| Serasa/Neurotech | src/components/FunilAquisicaoView.tsx |
public/data/serasa-funnel-daily.csv |
✅ |
| App Afinz | src/components/AppAfinzFunnelView.tsx |
public/data/app-afinz-funnel-raw.tsv |
✅ |
| Mídia Paga → Install | src/components/PaidMediaFunnelView.tsx |
view Supabase v_b2c_app_install_daily |
❌ (auto) |
⚠️ Estes dois funis não têm importador — são arquivos colados na mão em
public/data/. A fonte da verdade do formato são os parsers emFunilAquisicaoView.tsx(parseCsv) eAppAfinzFunnelView.tsx(parseTsv+buildDaily). Se o app mudar esses parsers, reconfira os contratos abaixo antes de rodar.
⚠️ Atualização 2026-09-28 — o app lê do Supabase primeiro.
AppAfinzFunnelViewlêapp_afinz_funnel_daily_raw(TSV só em fallback) eSerasaSourceFunnelViewlêserasa_bi_neurotech_daily_funnel. Atualize sempre os dois: tabela + arquivo.
- App: para cada dia vindo do export novo,
deletedo dia +insert(PKbusiness_date, stage_code, status, marc_plurix; stage_code = cpf/onboarding/geo/docs/bio/ address/personalization/signature/auto_finalization/completed/loss). Dias preservados pelo merge ficam intocados. Dia corrente =partial+{current_day_open}.- Serasa: upsert por
dataa partir do 1º dia do export.- SQL do App passa de 200 KB: aplicar com
supabase db query --linked -f arquivo.sqla partir de uma pasta de scratch linkada (supabase init+supabase link --project-ref mipiwxadnpwtcgfcedym), não pelo MCPexecute_sql.- Export do BI do App (
Acompanhamento_Funil_B2C(DADOS BI APP).csv):;, cp1252, cabeçalho na linha 3 (Ano;2026antes), ~100k linhas vazias no fim, referências comMARC_PLURIXvazio (converter p/0), números com.de milhar, e ~50 linhasAPROVADO/NAOsem nome de etapa (descartadas — não têm estágio identificável). A janela do funil detalhado desse export começa ~28/07, por isso o merge com o antigo é obrigatório.- Export Serasa vem como
.xlsx(datas reais + linhaTotal) cobrindo só ~60 dias: mesclar por cima do CSV antigo antes de rodarbuild_funnel_files.py serasa.
Fluxo
- Receber o export cru. O usuário normalmente cola do Excel/Sheets (vem TAB-separado) ou anexa um arquivo. Salve o conteúdo verbatim num arquivo temporário (ex.: no scratchpad), sem editar — nem número, nem cabeçalho.
- Detectar qual funil é pelo cabeçalho:
- começa com
Data ... Consultas Neurotech ...→ Serasa (serasa) - começa com
created_data Etapa status MARC_PLURIX Contagem de CPF→ App Afinz (appafinz) - Um rótulo de lista tipo
1 -/2 -no início do cabeçalho é tolerado (o script remove).
- começa com
- Copiar o arquivo atual do repo para o scratchpad (necessário para o merge do App Afinz):
calendar-estrategico/public/data/<arquivo>→OLD_<arquivo>. - Rodar o script (ver Uso). Ele valida e emite o arquivo final.
- Conferir o relatório do script:
- Serasa:
CHECKSUM: OK(a linhaTotaldo export bate com o recalculado). SeDIVERGIU, pare e ache o dígito errado na transcrição — não suba. - App Afinz:
calendario continuo,referencias ... presentes, e a lista de dias preservados pelo merge (se houver). App Afinz não tem checksum — apresente ao usuário o resumo mensal de cartões concluídos pra ele bater o olho antes de subir.
- Serasa:
- Copiar o arquivo gerado para
calendar-estrategico/public/data/, mantendo CRLF (é a convenção dos arquivos no repo — evita diff-ruído de fim-de-linha). - Deploy é decisão do usuário. Os dashes são públicos. NÃO commite/push sem o "ok" dele.
O deploy é: commit em
maindecalendar-estrategico/.git→ push (GitHub Pages rebuilda). O repo de deploy écalendar-estrategico/.git(remotegrowthafinz/GaaS-Framework-Afinz), não o.gitda pasta pai nem o do home — confirme comgit remote get-url origin.
Uso do script
# Serasa (checksum via linha Total)
python scripts/build_funnel_files.py serasa <export_cru> <saida.csv>
# App Afinz (merge com o arquivo antigo p/ nunca regredir funil)
python scripts/build_funnel_files.py appafinz <export_cru> <saida.tsv> <arquivo_antigo.tsv>
O 4º argumento do appafinz (arquivo antigo) é opcional mas recomendado sempre: sem ele,
se o export novo vier com uma janela de funil mais curta que a atual, você perde histórico.
Contratos dos parsers (fonte da verdade)
Serasa → serasa-funnel-daily.csv
- Delimitador de saída
;. 8 colunas nesta ordem:Data ; Consultas Neurotech ; Aprovados Neurotech ; Pedidos Confirmados ; Env. da Foto Biometria ; Env. Documento ; Assinatura do Cartão ; Total Emitidos - Data
DD/MM/YYYY. Números pt-BR (1.518= 1518). Célula vazia = sem-dado (fica vazia, o app lê como null). - Linha
Total;...no fim é ignorada pelo parser, mas o script recalcula e usa a do export como checksum. - Atualização = arquivo inteiro (histórico completo). O export novo é a versão mais madura; dias recentes sofrem restatement (valores sobem conforme registros amadurecem) — normal.
App Afinz → app-afinz-funnel-raw.tsv
- Delimitador TAB. 5 colunas:
created_data ⇥ Etapa ⇥ status ⇥ MARC_PLURIX ⇥ Contagem de CPF. - Formato longo/raw (várias linhas por dia). A etapa é identificada pelo prefixo numérico:
0.→CPF,1.→Onboarding,2.→Geo,3.→Docs,4.→Bio,5.→Endereço,6.→Personalização,7.→Assinatura,8.→Concluído. (7.1ePerdasão ignorados pelo funil.) - Regra que quebra silencioso: o app só soma direito se cada dia tiver os dois tipos de linha:
- referência (CPF/Onboarding):
statusvazio eMARC_PLURIX = 0; - segmentada (etapas 2→8):
status = APROVADOeMARC_PLURIX = SIM(Plurix) ouNAO(Afinz).
- referência (CPF/Onboarding):
- Meses sem funil (só
0. Etapa de Digitação de CPF) são normais no começo do histórico — o funil detalhado começou ~fim de mai/2026.
Funil API Serasa (marketplace) → Supabase serasa_marketplace_daily_funnel
Fonte diferente das duas acima: é tabela Supabase, não arquivo. O usuário chama de
"funil api serasa BI". O componente é SerasaSourceFunnelView.tsx (source marketplace),
que lê 3 tabelas: serasa_marketplace_daily_funnel (esta), serasa_bi_neurotech_daily_funnel
e serasa_bi_daily_funnel.
- Export cru: arquivo
Sum_of_Qt_oferta,_Su_<timestamp>.xlsx— transposto (datas nas colunas), com as linhas:Data,Ofertas,Pedidos,Pedidos %,Confirmados,Confirmados %,Aprovados,Aprovados %. As%são conversões estágio-a-estágio (Pedidos%=pedidos/ofertas, Confirmados%=confirmados/pedidos, Aprovados%=aprovados/confirmados). - Destino:
serasa_marketplace_daily_funnel(PKdata, upsert). Colunas:ofertas, pedidos, pedidos_rate_source, confirmados, confirmados_rate_source, aprovados, aprovados_rate_source, quality_status, quality_notes, source_file, source_hash. - Constraints que quebram o upsert inteiro se violadas (validar ANTES):
- funil decrescente:
ofertas ≥ pedidos ≥ confirmados ≥ aprovados ≥ 0; *_rate_sourceem[0,1]e NOT NULL → dia de abertura (denominador 0) tem%vazio no xlsx; coerça pra 0 (o gerador do repo emitirianulle falharia);quality_status in ('complete','partial','suspect').
- funil decrescente:
- Dia aberto: marcar
data > lastClosedDatecomopartial+quality_notes={current_day_open}.lastClosedDate= ontem (o último dia fechado).
Como rodar:
python scripts/gen_serasa_marketplace.py <export.xlsx> <saida.sql> "<nome_do_xlsx>" <YYYY-MM-DD_lastClosed>
Depois aplicar o SQL no Supabase (projeto GaaS mipiwxadnpwtcgfcedym) via MCP execute_sql
(upsert idempotente on conflict (data) do update). Opcional: salvar o SQL como migration em
calendar-estrategico/supabase/migrations/ (paridade com o padrão existente — ver
scripts/generate-serasa-marketplace-seed.mjs e as migrations *_serasa_marketplace_*).
Escrita em backend de produção — só aplicar com o "ok" do usuário (ou quando ele já mandou "sobe isso"). Depois do upsert, confira
count/min/max/quality_statuse que o dia aberto ficoupartial.
⚠️ Redundância a vigiar: o Neurotech aparece tanto no arquivo
serasa-funnel-daily.csv(aba Funil de Aquisição /FunilAquisicaoView) quanto na tabela Supabaseserasa_bi_neurotech_daily_funnel(SerasaSourceFunnelViewsourcebi). São dois destinos para o mesmo dado — se um for atualizado e o outro não, divergem. Confirmar com o usuário se ambos precisam subir.
Gotchas do ambiente
- Path com acento (
Área de Trabalho): o Python quebra ao abrir esses caminhos direto do Git Bash. Trabalhe com nomes ASCII no scratchpad e mova propublic/datacomcp(bash lida com o acento). - Console cp1252 (Windows): evite emoji no output do script (já está sem).
- Nested git repos: de dentro de
ACALENDARIO APP/o git resolve pro repo do home (lixo). Sempre opere de dentro decalendar-estrategico/para git/deploy.
Verificação (opcional, recomendado antes de subir)
Suba o dev server (npm run dev em calendar-estrategico, porta 5173) e abra a aba
Funil de Aquisição. Confirme que os 3 sub-funis renderizam e que a última data bate com
o export. Sem erro no console = parser aceitou o formato.