Pontos a validar da documentação¶

Esta página consolida os Pontos a validar registrados na documentação da Drexies Agro. Seu objetivo é facilitar a consulta das informações que ainda dependem de confirmação funcional, técnica ou operacional.

Os itens abaixo são pendências de validação documental. Eles não representam, por si só, defeitos, solicitações de desenvolvimento ou mudanças planejadas no sistema.

Classificação dos itens

A Equipe de Dados Sonar é responsável pelas validações documentais da Drexies Agro. Esta página não atribui responsáveis individuais diferentes para cada item. Prioridade, prazo e status de andamento não estão definidos, pois essas informações não foram comprovadas nas fontes consultadas.

Regras de negócio¶

#	O que precisa ser validado	Por que a validação é necessária	Páginas impactadas
1	Regra oficial de distribuição dos produtores nas classes A, B, C e D, incluindo a distribuição proporcional e o fallback em quartis.	O código apresenta esses mecanismos, mas não comprova que correspondam à política oficial de classificação.	Indicadores, FAQ, Glossário
2	Uso do fallback técnico de R$ 2.500/ha e a referência de negócio que deve substituí-lo quando necessário.	O valor foi identificado como fallback no código e não deve ser tratado como regra oficial sem confirmação.	Indicadores
3	Faixas, metodologias e critérios usados pelos fornecedores externos para scores, restritivos e indicadores de risco e conformidade.	Esses critérios não estão integralmente definidos no repositório e dependem dos contratos e manuais vigentes.	Indicadores

Financeiro e DRE¶

#	O que precisa ser validado	Por que a validação é necessária	Páginas impactadas
4	Componentes, sinais, nomes, bases, percentuais, médias, participações e fórmula financeira oficial da DRE.	O código comprova cálculos técnicos, mas não substitui a validação contábil e de negócio.	Telas e Funcionalidades, Indicadores, FAQ, Glossário
5	Interpretação oficial de Volume de Venda, médias e participação na DRE.	A implementação apresenta esses valores, mas sua interpretação financeira oficial não foi comprovada.	Indicadores

Acessos e segurança¶

#	O que precisa ser validado	Por que a validação é necessária	Páginas impactadas
6	Comportamento de `telas_permitidas` ausente ou vazia para usuários comuns.	No frontend analisado, essa condição concede acesso às quatro telas funcionais; falta confirmar se o comportamento é intencional.	Acessos, Perfis e RLS, FAQ
7	Comportamento de uma identidade autenticada sem registro correspondente em `user_profiles`.	A verificação de usuário inativo depende da existência desse perfil, mas o comportamento funcional esperado não está definido.	Acessos, Perfis e RLS
8	Uso de `user` como fallback quando um usuário autenticado possui perfil, mas não possui papel em `user_roles`.	O fallback está implementado no `AuthContext`, porém não há comprovação de que seja a regra funcional pretendida.	Acessos, Perfis e RLS
9	Significado de listas vazias de concessionárias e filiais e abrangência territorial esperada.	É necessário confirmar se listas vazias representam acesso irrestrito ou ausência de acesso e onde o escopo deve ser aplicado.	Acessos, Perfis e RLS
10	Matriz completa de ações permitidas para Administrador Global, Administrador e Usuário, incluindo envio, aprovação, negação, comissão e remoção de planos.	O frontend e as migrations demonstram controles específicos, mas não comprovam uma matriz funcional completa.	Telas e Funcionalidades, Acessos, Perfis e RLS, FAQ
11	Matriz final de RLS por tabela e operação no Supabase remoto.	As migrations locais contêm políticas criadas, removidas e substituídas e não comprovam isoladamente o estado publicado.	Acessos, Perfis e RLS, FAQ
12	Contas protegidas e gatilhos efetivamente configurados no ambiente publicado.	O repositório contém mecanismos de proteção, mas a configuração remota precisa ser confirmada sem expor identificadores pessoais.	Telas e Funcionalidades, Acessos, Perfis e RLS
13	Estado real do Supabase remoto em relação às migrations, tipos gerados, funções, gatilhos, enum de papéis e políticas locais.	O ambiente remoto pode divergir do histórico e dos artefatos mantidos no repositório.	Fontes de Dados e Linhagem, Acessos, Perfis e RLS
14	Necessidade de aplicar o escopo territorial por RLS ou backend, além dos filtros atuais do frontend.	A filtragem visual identificada não comprova isolamento territorial integral no banco.	Acessos, Perfis e RLS

Dados e integrações¶

#	O que precisa ser validado	Por que a validação é necessária	Páginas impactadas
15	Conteúdo, abas, cabeçalhos, ID correto, frequência de atualização e responsável operacional do Google Sheets.	O repositório não comprova o estado atual da planilha, e o ID do README diverge daquele configurado na Edge Function.	Fontes de Dados e Linhagem, Atualização e Sincronização, FAQ
16	Contratos, produtos habilitados, limites, cotas, custos, versões e disponibilidade das APIs externas documentadas.	Esses dados podem depender dos contratos e das configurações vigentes fora do repositório.	Fontes de Dados e Linhagem, FAQ
17	Secrets configurados no Supabase e os ambientes em que estão disponíveis.	O código referencia integrações, mas não comprova quais credenciais estão configuradas em cada ambiente; seus valores não devem ser registrados.	Fontes de Dados e Linhagem
18	Origem, carga e atualização de `drexies_silos` e `drexies_revendas`, distinguindo-as dos resultados do Google Maps.	O processo efetivo de alimentação dessas estruturas não foi comprovado no repositório.	Fontes de Dados e Linhagem, Atualização e Sincronização
19	Processo real de revisão, publicação e reversão de Edge Functions e migrations.	Os arquivos locais não demonstram integralmente o processo operacional usado nos ambientes publicados.	Fontes de Dados e Linhagem
20	Existência de rotinas agendadas, cron jobs, webhooks ou automações configuradas diretamente no Supabase remoto.	Essas rotinas podem existir fora do repositório analisado.	Atualização e Sincronização
21	Responsáveis pela atualização de produtores, propriedades, produtos, preços, manejos, silos, revendas e parâmetros de mercado.	A responsabilidade operacional por essas fontes não está definida no código.	Atualização e Sincronização

Persistência e atualização¶

#	O que precisa ser validado	Por que a validação é necessária	Páginas impactadas
22	Políticas de retenção, expiração, atualização e reconsulta dos resultados da AgRisk e dos contatos da eEmóvel.	O código permite consultas sob demanda e atualização forçada, mas não estabelece toda a política operacional de reconsulta.	Fontes de Dados e Linhagem, Atualização e Sincronização, FAQ
23	Adequação dos tempos de cache do frontend e do cache climático de 24 horas às políticas operacionais esperadas.	Os tempos implementados são comprovados, mas sua adequação operacional ainda não foi confirmada.	Atualização e Sincronização
24	Persistência e compartilhamento definitivos dos registros de RDV e dos ajustes manuais da DRE.	No código analisado, esses dados ficam no `localStorage`, sem comprovação de sincronização entre navegadores, dispositivos ou usuários.	Fontes de Dados e Linhagem, Atualização e Sincronização, FAQ
25	Processo real de sincronização, promoção e consistência dos dados entre ambientes.	O repositório não comprova integralmente o fluxo operacional entre os ambientes utilizados.	Atualização e Sincronização
26	Comportamento efetivo no ambiente publicado para invalidação, recarga e permissões após mutações.	O comportamento identificado no código precisa ser confrontado com a configuração e as políticas realmente publicadas.	Atualização e Sincronização

Funcionalidades a validar¶

#	O que precisa ser validado	Por que a validação é necessária	Páginas impactadas
27	Finalidade e eventual publicação da página `AdminPriceLists.tsx`.	A gestão de tabelas de preço existe no código, mas não possui rota registrada e não está comprovada como funcionalidade normalmente disponível.	Telas e Funcionalidades

Atualização desta consolidação¶

Quando uma validação for concluída:

atualize primeiro a página de origem com a informação comprovada;
remova ou revise o item correspondente nesta consolidação;
registre a alteração documental no Changelog.