====== Especificação Funcional: Cadastro de Localidades ======

===== Resumo =====

O cadastro de localidades gerencia as localidades onde estão situadas as propriedades. Através deste módulo é possível incluir novas localidades, excluir uma localidade cadastrada, editar e visualizar os dados das localidades cadastradas, entre outras.

===== Descrição =====

O Cadastro de Localidades deve permitir ao usuário subdividir o município em diferentes áreas. A figura abaixo ilustra como esta subdivisão é feita no sistema:

{{:softwares:geagro:requisitos:modulos:cadastros:divisao_municipio.png  |Subdivisão dos municípios}}

  * Os distritos são determinados pela divisão política do município.

  * As Localidades representam os nomes dos locais onde estão as Propriedades.

  * Os setores serão utilizados pelos usuários do sistema para subdividir o município em áreas de interesse -- por exemplo, questões econômicas -- e por isso não tem relação direta com as Localidades. Duas Propriedades situadas numa mesma Localidade podem estar em setores diferentes e vice versa.

Estes dados podem ser utilizados para gerar relatórios, gráficos e qualquer tipo de informação a respeito da produção em diferentes áreas do município.

Ao acessar este módulo, o sistema deve exibir uma lista com as Localidades já cadastradas para facilitar as operações de exclusão, edição e visualização dos dados. Esta lista, que deve exibir os dados mais importantes de cada Localidade, também deve permitir a organização e o filtro dos dados por qualquer campo que esteja visível, além de permitir que o usuário oculte/exiba campos, imprima e exporte o conteúdo da lista.

==== Dados da Localidade ====

|< 100% 19% 60% 7% 7% 7%>|
^  Campo                    ^  Descrição                                                                    ^  Tipo          ^  Tamanho   ^  Obrigatório?  ^
|Código                     | Código da Localidade                                                          |  Número        |  --        |  Sim           |
|Nome                       | Nome da Localidade                                                            |  Texto         |  80        |  Sim           |
|Distrito                   | Nome do distrito                                                              |  Texto         |  30        |  Sim           |
|Setor                      | Nome do setor                                                                 |  Texto         |  30        |  Não           |
|Município                  | Nome do município                                                             |  Texto         |  30        |  Sim           |
|Estado                     | Nome da UF                                                                    |  Texto         |  02        |  Sim           |
|País                       | Nome do país                                                                  |  Texto         |  30        |  Sim           |

==== Mesclar localidades ====

Para resolver problemas relacionados à duplicação de cadastros no sistema, o usuário deve ter a opção de mesclar localidades.

  - O usuário escolhe uma localidade cujo cadastro deseja manter no sistema;
  - O sistema automaticamente localiza e exibe outras localidades cujos nomes comecem com os mesmos caracteres da primeira para serem mescladas e excluídas do sistema;
  - O usuário pode acrescentar outras localidades  à lista de exclusão de acordo com o seu critério usando a funcionalidade de [[softwares:geagro:requisitos:modulos:outros:selecao_cadastros|seleção de registros]];
  - O usuário escolhe quais destas localidades devem ser unificadas com a primeira;
  - O sistema exibe confirmação antes de alterar quaisquer dados;
  - O sistema atualiza todas as referências das localidades na lista de exclusão para coincidirem com a localidade a ser mantida;
  - As localidades  na lista de exclusão são excluídas do sistema.

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

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

  * **Nome do campo** e **ordem**: define por qual campo e em que ordem serão ordenados os registros na tela de consulta do módulo;
  * **Visão padrão**: define a visão que será selecionada automaticamente ao abrir a tela de consulta do módulo;

===== Pontos de verificação =====

  * O sistema deve permitir a inclusão de uma localidade através da tela de seleção de localidades;
  * Ao incluir/alterar/excluir uma localidade, a operação deve ser registrada no log de ações;

==== Na inclusão/alteração de localidades ====

  * O sistema não deve salvar o cadastro sem que todos os campos obrigatórios estejam preenchidos;
  * O sistema deve validar os campos conforme seu tipo e tamanho;
  * Após a inclusão de uma localidade, esta deverá ser exibida imediatamente na lista de localidades cadastradas;
  * A ação do clique duplo sobre um item do grid deve ser alterar o registro selecionado.

==== Na exclusão de localidades ====

  * O sistema deve solicitar a confirmação da exclusão de uma localidade;
  * O sistema não deve permitir a exclusão de uma localidade caso haja ao menos uma propriedade associada a ela;
  * O sistema não deve permitir a exclusão de uma localidade caso haja ao menos uma pessoa associada a ela;
  * Após a exclusão de uma localidade, esta deverá ser eliminada imediatamente da lista de localidades.

==== Na mesclagem de localidades ====

  * Uma localidade não pode ser mesclada com ela mesma;
  * Uma localidade não pode ser adicionada mais de uma vez à lista de exclusão;
  * A operação de mesclagem deve registrar no log de ações os códigos dos registros que foram mesclados e excluídos;
  * Os dados das localidades excluídas devem ser transferidos para a localidade a ser mantida:
    * Endereços das pessoas
    * Endereços das propriedades;

A verificação deve ser feita através dos cadastros de pessoas e propriedades.
  

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

  * Alterações na visão de localidades podem afetar o agrupamento de dados na tela de consulta de localidades.

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