====== Especificação funcional: Gráfico de Produção Rural do Município por Categorias de Produtos ======

===== Resumo =====
O gráfico de produção exibe um comparativo da produção do município num determinado período de tempo.

===== Descrição =====
Para comparar a produção de diferentes produtos ou categorias, o gráfico deve obter os dados das notas fiscais cadastradas e exibir o valor total das notas de cada produto/categoria. Quando o gráfico estiver exibindo os dados por produtos, a descrição e a unidade de medida deve ser usados para diferenciá-los, ou seja, produtos com a mesma descrição e unidades de medida diferentes devem ser considerados como distintos.

O usuário deve ter as opções de imprimir o gráfico e de exportá-lo como um arquivo de imagem no formato JPEG.


==== Estrutura do gráfico ====

O gráfico deverá ser composto por:
  * Título, contendo a razão social do cliente, seguido da descrição do gráfico e do período considerado. Caso algum filtro tenha sido aplicado, deve incluir também os campos e os valores filtrados;
  * Dados, com os seus respectivos rótulos;
  * Legenda com os rótulos e valores de cada grupo.

==== Exemplo ====

<charter>
title = Prefeitura Municipal - Produção Rural do Município - 01/01/2011 a 31/12/2011
size = 800x300
align = center
type = pie3d
labelSerie = 2
piePercentages = false
pieLabels = true

7,5,3,2
Café: 7.000, Bovinos: 5.000, Frutas: 3.000, Demais categorias: 2.000
</charter>

===== Configurações e preferências do usuário =====

==== Configurações do sistema ====

  * **Percentual do grupo Outros**: Valor a ser usado para agrupar dados que representem determinada percentagem em relação ao total. Todos os grupos que estiverem abaixo da percentagem indicada devem ser reunidos num único grupo, indicado pelo rótulo "Demais produtos" ou "Demais categorias", de acordo com o filtro selecionado. O usuário poderá alterar o valor do parâmetro.

==== Filtros ====

  * **Por valor ou por quantidade**: Define se os dados são obtidos somando o valor ou a quantidade de cada item nas notas fiscais;
  * **Por produto ou por categoria**: Define se os dados são agrupados por produtos ou por categorias de produtos, conforme o cadastro de categorias do sistema (e não as categorias definidas pela SEFAZ);
  * **Período**: Datas inicial e final para filtrar as notas fiscais por data de emissão. Os valores padrão são o primeiro e o último dias do ano corrente;
  * **Natureza de operação**: Será exibida uma lista com todas as possíveis naturezas de operação e o gráfico poderá exibir somente os dados das notas com a natureza selecionada ou com todas as naturezas de operação;
  * **Distrito**: Será exibida uma lista com todos os distritos das localidades cadastradas e o gráfico poderá exibir somente os dados das notas emitidas no distrito selecionado ou em todos os distritos.

==== Outras opções ====

  * **Zoom**: Nível de zoom do gráfico em %;
  * **Exibir legenda**: O usuário terá a opção de exibir ou não a legenda junto ao gráfico.
 
===== Pontos de verificação =====
  * O sistema deve exibir os valores com o símbolo de moeda quando o filtro por valor estiver selecionado;
  * A soma dos produtos de uma categoria na exibição por produtos deve ser igual ao valor apresentado na exibição por categoria;
  * O sistema não deve exibir o grupo "Demais produtos" ou "Demais categorias" se o //Percentual do grupo Outros// estiver definido com valor 0 (zero);
  * A data inicial não poder ser maior que a data final.

===== Observações =====

Para que a exibição por categorias seja feita de forma adequada, é necessário que os produtos estejam cadastrados em suas respectivas categorias. Produtos cadastrados nas categorias incorretas podem distorcer as informações do gráfico. Produtos que não forem classificados serão exibidos na categoria padrão -- "OUTROS".

~~DISCUSSION|Sugira mudanças, aponte falhas ou contribua de alguma forma aqui:~~