Qualidade de dados e prontidão de registros
Entenda o que bloqueia análises confiáveis e defina quando um registro está pronto para um processo.
O Blocchi separa três perguntas que costumam se misturar:
| Conceito | Pergunta |
|---|---|
| Qualidade de dados | Os dados estão corretos, completos, consistentes, atualizados e confiáveis? |
| Prontidão de métrica | O Blocchi tem evidência mapeada suficiente para calcular esta métrica? |
| Prontidão de registro | Este registro específico está apto a avançar em um processo de negócio? |
Qualidade de dados (/app/data/quality)
A página responde a uma pergunta para o workspace inteiro: dá para confiar nos seus dados? Ela cobre todas as fontes conectadas (CRMs externos, Blocchi CRM, arquivos, financeiro e outras), não um produto. Não há uma nota de qualidade combinada: cada número é algo sobre o qual você pode agir.
- Em todas as fontes — problemas abertos, quantos deles bloqueiam uma ação de negócio, registros prontos contra os que precisam de atenção, e fontes falhando, desatualizadas (sem sincronização bem-sucedida em 24 horas) ou nunca sincronizadas.
- Fontes — uma linha por fonte com o estado da sincronização, a cobertura do mapeamento (campos mapeados entre os campos que a entidade tem), a prontidão dos registros que ela alimenta e os problemas abertos que a citam. Cada linha leva à correção que mais importa para ela: corrigir uma sincronização com falha, fazer a primeira sincronização, concluir um mapeamento, revisar problemas ou ver a prontidão. O Blocchi CRM é gravado no próprio Blocchi, então está sempre ao vivo e não tem mapeamento; um arquivo está tão atual quanto a última importação. A prontidão é avaliada por registro, então duas fontes que alimentam os mesmos registros mostram os mesmos números. Problemas que envolvem várias fontes (duplicados, valores conflitantes) entram na fila de correção, não em uma linha.
- Fila de correção — com Data+, os principais problemas da caixa de curadoria e correções sugeridas que você aceita ou rejeita ali mesmo; cada decisão guarda a evidência e pode ser desfeita em Resolução de qualidade. Sem Data+, a página mostra quantos problemas foram detectados e o que o Data+ acrescenta. Ela nunca mostra um "tudo certo" vazio.
- Quem depende destes dados — os produtos que leem estas fontes. Receita vem primeiro: qual CRM é contado (o Blocchi nunca mistura dois; um admin escolhe um em Modelo comercial,
/app/commercial-model), quando ele sincronizou e se cada número de Receita está completo, com um link para a correção. Jurídico leva às operações jurídicas quando o Jurídico está ativo.
Quando o CRM contado é externo, a seção de Receita também leva às verificações de higiene dele (atividade, datas de fechamento, contatos). Elas mostram como o CRM é mantido, não se os números estão completos; a página de Revenue Dá para confiar nos dados do CRM? trata delas.
A mesma leitura está disponível para integrações em GET /api/v1/data-plus/quality e na ferramenta MCP somente leitura blocchi.get_data_quality. Os números valem para o workspace inteiro, então quem só acessa os próprios registros ou os da equipe não a vê.
AI Cleanup Studio
No Data+, o responsável pela curadoria pode abrir /app/data-plus/cleanup-studio para avaliar um dataset persistido, com histórico retido ou uma fonte Live autorizada pelo tenant, propor regras de limpeza manualmente ou com IA e comparar valores antes da aprovação. A IA recebe metadados agregados dos campos, não linhas brutas. Valores ambíguos ficam em quarentena e a fonte original permanece intacta.
As receitas aprovadas são versionadas e reversíveis. Elas são reaplicadas no Studio e nos indicadores SQL de datasets persistidos. No histórico retido, o Blocchi cria versões derivadas imutáveis em Parquet (Supabase Storage ou GCS), preservando cada snapshot original. Limites do produto: a materialização histórica suporta no máximo 100.000 registros por snapshot imutável; agrupamentos, faixas e detalhamentos históricos suportam até 10.000 registros por snapshot. Acima desses limites, o Blocchi bloqueia a publicação ou consulta, em vez de exibir resultados parciais. A ampliação desses limites está fora do escopo atual. CRMs externos, tabelas operacionais e identidades Party canônicas não são modificados automaticamente. As contagens usam amostras de até 500 registros.
Fontes Live autorizadas pelo tenant também aplicam a receita aprovada antes dos filtros e dos cálculos de indicadores, agrupamentos e distribuições. Limite do produto: métricas e detalhamentos de fontes Live suportam no máximo 10.000 registros por dataset, com leitura completa e conferida. Acima desse limite ou com uma leitura incompleta, o Blocchi bloqueia a consulta, sem exibir resultados parciais; use sincronização persistida. Não está previsto ampliar esse limite nesta entrega.
O endpoint REST somente leitura GET /api/v1/data-plus/cleanup-profile e a ferramenta MCP blocchi.get_cleanup_profile retornam apenas resumos de qualidade a um responsável autorizado pela curadoria. Não expõem valores das linhas nem aceitam alterações. A resposta inclui as contagens da validação completa mais recente.
Visualizar mudanças aprovadas em outras páginas: no Data Explorer, selecione Ver receita aprovada para consultar valores derivados dos registros permitidos, ou informe cleaned=approved na leitura REST/MCP. O detalhamento de indicadores também pode retornar a projeção. A busca e a ordenação do Explorer continuam usando a fonte original; as agregações SQL persistidas usam a receita aprovada de forma consistente. As fontes originais, objetos Parquet históricos, conexões live-only e perfis Golden Party permanecem intactos.
Prontidão de registros (/app/data/readiness)
Defina o que significa um registro estar pronto — por exemplo prontidão para qualificação de oportunidade ou prontidão para onboarding de cliente.
- Crie zero, um ou vários checklists por entidade semântica. Os checklists se ligam a entidades do Blocchi, não a objetos do provedor, então continuam portáveis.
- Cada verificação tem uma condição, critérios opcionais de aplicabilidade, uma gravidade (bloqueante, obrigatória ou recomendada), um peso, orientação de correção e uma ordem.
- Comece por um modelo sugerido; aplicá-lo cria uma cópia sua que você pode personalizar.
Cada registro é avaliado em um de quatro estados:
| Status | Significado |
|---|---|
| Pronto | Nenhuma verificação aplicável falhou e nenhuma evidência obrigatória ou bloqueante é desconhecida. |
| Precisa de atenção | Uma verificação não bloqueante falhou, ou falta evidência obrigatória. |
| Bloqueado | Pelo menos uma verificação bloqueante falhou. |
| Não se aplica | Nenhuma verificação se aplica ao registro. |
A nota percentual é secundária: uma falha bloqueante nunca fica escondida atrás de uma nota alta. A prontidão é usada, por exemplo, ao mover uma oportunidade de etapa no Pipeline.
Relacionados
Última atualização em