====== Especificação funcional: Gestão de clientes ====== ===== Resumo ===== Gerenciamento dos clientes do sistema. ===== Descrição ===== Para que um usuário possa acessar o sistema, ele deve estar vinculado a um município. Esta funcionalidade permite que novos clientes (municípios) sejam cadastrados e tenham seu acesso ao sistema concedido ou revogado. Também é possível excluir todos os dados de um cliente através desse módulo. O acesso a esta funcionalidade só pode ser feito através da [[softwares:geoservicos.online:requisitos:gerais:area_administrativa|área administrativa]]. ==== Dados ==== |< 100% 19% 60% 7% 7% 7%>| ^ Campo ^ Descrição ^ Tipo ^ Tamanho ^ Obrigatório? ^ |Razão Social |Razão Social do cliente | Texto | 120 | Sim | |CNPJ |CNPJ | Texto | 18 | Sim | |Endereço |Endereço do cliente | Texto | 120 | Não | |Bairro |Bairro do cliente | -- | 120 | Não | |UF |Lista dos possíveis estados para serem selecionados | -- | -- | Sim | |Município |Lista dos municípios por estado | -- | -- | Sim | |CEP |CEP do cliente | Número | 9 | Não | |Telefones |Telefone do cliente | Número | | Não | |Logomarca |Logomarca selecionada no computador | Imagem(png) | -- | Não | |Ativo |determina se o cliente está ativo ou não Obs.: clientes novos são cadastrados como **ativos** por padrão| Sim/Não | -- | Sim | |E-mail do usuário administrador |E-mail do administrador do sistema para ser enviado o link para criação da senha | texto | 50 | Sim | |Nome do usuário administrador |Nome do usuário administrador, o nome será usado apenas para o envio do e-mail, não sendo gravado | texto | 120 | Sim | ==== Cadastro de novos clientes e criação do primeiro usuário ==== Ao incluir um novo cliente, o sistema deverá aceitar somente um CNPJ válido. Também é necessário verificar se a razão social já está sendo utilizada por outro cliente (ela deve ser única). O CEP e o endereço de e-mail do administrador também deverão ser validados durante a inclusão. O endereço de e-mail do administrador também deve ser único em todo o sistema, pois ele irá ser utilizado para criar a conta de usuário do administrador do município. Quando um novo cliente é cadastrado, o sistema deve enviar para o [[softwares:schoolweb:requisitos:prematricula:identity_server:home|Identity server]] o e-mail do administrador, para que seja criado o usuário administrativo, o usuário recebera um e-mail com o link para realizar a criação da conta. Depois da conta criada no identity server o usuário poderá ter acesso ao sistema. Acessando a área de gerenciamento de clientes, o usuário com as devidas permissões deve ter acesso à tela de listagem de clientes, onde poderá incluir novos clientes, alterar, visualizar detalhes e excluir clientes existentes. ==== Ativação/inativação ==== Um novo cliente estará automaticamente ativo, ou seja, seus usuários podem acessar o sistema, desde que também estejam ativos. Entretanto, quando um cliente é inativado, nenhum de seus usuários poderá acessar o sistema e esta condição deve ser informada no momento do login. A inativação pode ser feita por tempo indeterminado e deve manter os dados do cliente e dos usuários intactos. Quando um cliente inativo é reativado, todos os seus usuários ativos tem o acesso concedido novamente. ==== Exclusão ==== Se um cliente for excluído, todos os dados relacionados a ele devem ser apagados do banco de dados. O usuário deve confirmar a exclusão antes que qualquer ação seja feita. A exclusão é definitiva e remove permanentemente todos os dados do cliente, contas de usuário, configurações e cadastros relacionados ao município. ===== Configurações e preferências do usuário ===== Não aplicável. ===== Observações ===== * Devido as dependências circulares do domínio, ao deletar um cliente os registros que pertencem a ele, devem ser deletados manualmente no método de exclusão de cliente; * O sistema deve permitir que vários clientes de um mesmo município sejam cadastrados, desde que cada cliente tenha um CNPJ e uma Razão social específicos.