Deixe a estrutura compreensível
Prefira nomes de tabelas, coleções e campos que descrevam os dados em vez de abreviações internas. Mantenha valores consistentes: datas em formato previsível, status com um conjunto conhecido e identificadores com finalidade clara. Uma estrutura legível reduz ambiguidades quando o pedido usa termos do negócio.
Evite reunir conceitos sem relação em um campo sobrecarregado se o agente precisar filtrar ou comparar registros. Se um campo tiver mais de um significado, documente sua representação ou divida-o em campos mais claros antes de depender de consultas automáticas.
Inclua o contexto de negócio na consulta
Explique o significado de termos como ativo, qualificado ou vencido na sua organização. O esquema mostra que um campo existe, mas não revela todas as regras associadas aos valores. Informe também o período, o agrupamento e o formato de saída quando essas escolhas afetarem a resposta.
Revise uma amostra do resultado antes de usá-la em uma decisão. Confira se os campos e filtros correspondem à pergunta, principalmente quando há colunas ou coleções semelhantes. Se o resultado não estiver correto, refine as definições ou o pedido em vez de presumir que o esquema contém a regra de negócio.