Saltar al contenido
BeryX
Volver a la guía de la aplicación

Documentación de BeryX

Este documento técnico está disponible en portugués.

Sugestões

Recomendações acionáveis geradas em cada scan, por heurísticas e, quando disponível, por IA. Usa esta página para rever, aprovar ou dispensar correções e acompanhar cada uma até um scan confirmar que o problema desapareceu.

O que podes fazer

  • Filtrar por «Estado», «Categoria» e «Dataset»; por omissão vês só as sugestões no estado «Proposta».
  • Rever cada sugestão: a origem, quando vem de um problema resolvido, de um sinal, de uma recalibração ou de um pack, a descrição, o valor atual e o proposto num ajuste de limite, e o código da correção, que copias com «Copiar SQL» ou «Copiar PySpark».
  • Avançar o estado com «Aprovar correção», «Marcar como aplicada» ou «Dispensar»; depois de aplicada, o próximo scan confirma automaticamente se o problema deixou de ser detetado, exceto no enriquecimento, que o scan não mede e que marcas com «Marcar como verificada» depois de confirmares os valores na fonte. Uma sugestão dispensada pode voltar com «Reabrir».
  • Ensaiar uma correção antes de a aceitar com «Ensaiar (só leitura)» (administradores, plano Team e acima): o BeryX conta na fonte as linhas que o passo 1 devolve e mostra no cartão «Ensaio: afeta N linhas (x%)». Ensaia, nunca aplica: o passo 2 nunca corre, e um passo 1 que não seja um SELECT sobre a tabela do dataset fica bloqueado sem consultar a fonte.
  • Abrir um Pull Request com «Abrir PR» numa sugestão aprovada: o código vai para um branch do teu repositório git, para revisão humana, e nada é escrito nas fontes de dados; «Atualizar estado» mostra se o PR já foi merged ou fechado. A descrição do PR leva o título, a regra proposta e o link para a sugestão, mas não o texto da descrição, que pode citar valores lidos nos dados.
  • Selecionar várias sugestões («Selecionar todos os visíveis») e dispensá-las de uma vez; «Aceitar» em massa e «Aceitar todas as heurísticas deste dataset» só aparecem a administradores.

Ver também

  • Plano do dia do steward — as sugestões pendentes, ordenadas por risco e impacto, para aprovar em lote.
  • Regras — onde ficam as regras criadas ao aceitar sugestões de regra.
  • Packs de regras — propor regras curadas que chegam aqui como sugestões.

English

Suggestions

Actionable recommendations generated on every scan, by heuristics and, when available, by AI. Use this page to review, approve or dismiss fixes and follow each one until a scan confirms the problem has gone.

What you can do

  • Filter by "Status", "Category" and "Dataset"; by default you only see suggestions in the "Proposed" status.
  • Review each suggestion: its source, when it comes from a resolved issue, a signal, a threshold tuning or a pack, the description, the current and proposed value for a threshold tuning, and the fix code, which you copy with "Copy SQL" or "Copy PySpark".
  • Move the status forward with "Approve fix", "Mark as applied" or "Dismiss"; once applied, the next scan automatically confirms whether the problem is no longer detected, except for enrichment, which the scan does not measure and which you mark with "Mark as verified" after checking the values on the source. A dismissed suggestion can come back with "Reopen".
  • Rehearse a fix before accepting it with "Rehearse (read-only)" (administrators, Team plan and above): BeryX counts at the source the rows that step 1 returns and shows "Rehearsal: affects N rows (x%)" on the card. It rehearses, never applies: step 2 never runs, and a step 1 that is not a SELECT over the dataset's table is blocked without querying the source.
  • Open a pull request with "Open PR" on an approved suggestion: the code goes to a branch in your git repository for human review, and nothing is written to the data sources; "Refresh status" shows whether the PR has been merged or closed. The PR description carries the title, the proposed rule and the link to the suggestion, but not the description text, which may quote values read from the data.
  • Select several suggestions ("Select all visible") and dismiss them in one go; bulk "Accept" and "Accept all heuristics for this dataset" are only shown to administrators.

See also

  • Steward daily plan — pending suggestions, ranked by risk and impact, to approve in bulk.
  • Rules — where the rules created by accepting rule suggestions end up.
  • Rule packs — propose curated rules that arrive here as suggestions.