Especificação Funcional: Cadastro de Atendimentos

Este módulo cadastra atendimentos para serviços prestados a um determinada propriedade.

O objetivo deste módulo é registrar os atendimentos realizados para as propriedades cadastrados no sistema. Através deste cadastro o usuário consegue identificar os serviços prestados para as propriedades e a quantidade de atendimentos realizadas para a propriedade específica. Consegue ainda discriminar quem solicitou o atendimento realizado para a propriedade.

O usuário pode, ao cadastrar ou alterar um atendimento, selecionar os serviço um a um, cada um com seus dados, assim como os do atendimento, como listados acima. Para isto o sistema deve permitir ao usuário incluir, alterar, excluir e visualizar serviços numa lista. Nesta lista os dados dos serviços não serão editados e devem ser exibidos os campos: descrição do serviço, quantidade solicitada, quantidade atendida, data prevista, data de execução, unidade de medida, valor unitário, valor total, status e descrição detalhada. O sistema exibirá uma outra tela com os detalhes do serviço para que o usuário possa preencher os campos.

Os campos em comum são:

• Objetivo do atendimento;
• Técnico responsável;
• Descrição detalhada;
• Informações adicionais;

Os campos que podem ter valores diferentes para cada serviço são:

• Quantidade solicitada;
• Quantidade atendida;
• Data prevista;
• Data de execução;
• Valor unitário;
• Estado.

Estes também podem ser informados uma única vez, junto com os campos em comum para facilitar o preenchimento dos valores para todos os serviços. Quando a alteração de um destes campos for feita desta forma, o valor correspondente deve ser replicado para todos os serviços no grid. Quando um valor for informado especificamente para um serviço, é este valor que deve ser salvo.

Os estados podem ser definidos pelo usuário no cadastro de serviços.

Os serviços devem ser diferenciados por cores na visão de atendimentos x serviços, de acordo com tipo do seu estado:

• Inicial: preto;
• Intermediário: laranja;
• Cancelado: cinza;
• Final: verde.

Não há restrição quando às mudanças de estado de um serviço.

O histórico de alterações no estado do serviço deve ser mantido automaticamente pelo sistema, não podendo ser alterado pelo usuário.

O usuário deve poder duplicar um atendimento, criando outro com os mesmos dados e os mesmos serviços do atendimento original. Quando um atendimento for duplicado a tela de cadastro deve ser mostrada para que o usuário possa alterar os dados antes de salvar. Se o usuário cancelar o cadastro, não haverá duplicação.

A ferramenta de impressão de OS foi criada devido a necessidade de gerar um documento contendo os dados de um serviço diretamente relacionado a um atendimento para que seja executado por um técnico responsável.

A impressão da OS deve permitir a definição de um modelo personalizado, criado de acordo com as necessidades do usuário. Cada serviço pode ter um modelo próprio. Caso um determinado serviço não tenha um modelo personalizado, a OS deve ser impressa segundo o modelo padrão do sistema. No modelo padrão, todos os campos listados abaixo devem estar presentes. Nos modelos personalizados, estes campos podem ser inseridos no texto com os códigos indicados nas tabelas abaixo.

Também é possível imprimir de uma vez os dados de um atendimento. A principal utilidade desta funcionalidade é listar todos os serviços atendidos ou previstos num dado atendimento, junto com os campos do próprio atendimento.

A impressão do atendimento deve permitir a definição de um modelo personalizado. Cada propriedade pode ter um modelo próprio. Caso o usuário logado no sistema não tenha um modelo personalizado, o atendimento deve ser impresso segundo o modelo padrão do sistema.

As tabelas abaixo mostram quais campos são usados na impressão das ordens de serviço e dos atendimentos. Nos modelos personalizados, estes campos podem ser inseridos no texto com os códigos indicados nas tabelas abaixo.

Ao consultar os serviços cadastrados, o usuário pode filtrar os serviços exibidos para imprimir automaticamente as ordens de serviço de cada um deles. A impressão deve respeitar os modelos personalizados de cada serviço, quando existirem. Todos os serviços com o mesmo modelo devem ser agrupados num só documento de modo que cada modelo seja impresso separadamente.

Obs.: As fotos do serviço serão inseridas no documento sem restrição de tamanho ou alinhamento. Cabe ao modelo determinar como as fotos serão exibidas.

* No modelo padrão a quantidade sempre vem acompanhada da unidade de medida.

Os seguintes campos das configurações do sistema também podem ser usados:

Uma OS deve conter ainda local para assinatura do solicitante, do técnico responsável pelo serviço e do cargo do responsável pela autorização do serviço.

O usuário deve ter a opção de visualizar no mapa os dados das propriedades para os quais foram registrados atendimentos. Para isso, o sistema deve utilizar os atendimentos filtrados na lista de atendimentos e exibir no mapa as propriedades correspondentes que contém feições.

O usuário deve ter a opção de exportar um arquivo com os dados dos serviços prestados. Os serviços serão selecionados a partir dos dados filtrados na tela de consulta de atendimentos, na visão Atendimentos x serviços.

A exportação deve ser feita num arquivo escolhido pelo usuário, no formato CSV, com os campos separados por ponto e vírgula (;).

Os seguintes campos devem constar no arquivo:

• A data do cadastro de um novo atendimento deve ser a data corrente, podendo ser alterada pelo usuário;
• O campo Número de um novo atendimento deve ser gerado automaticamente, podendo ser alterado pelo usuário. O número do próximo atendimento deve ser o maior número existente no banco de dados + 1, considerando os registros que contém apenas caracteres numéricos no campo Número;
• O campo Número só estará acessível no cadastro de atendimentos individuais;
• O valor total do serviço deve ser calculado automaticamente mas pode ser alterado pelo usuário. Caso seja informado um valor diferente de zero para a quantidade atendida, o valor total do serviço deve ser calculado como: quantidade atendida x valor unitário; caso contrário o valor total deve ser calculado como: quantidade solicitada x valor unitário;
• A data de execução não deve ser posterior à data corrente.
• Na visualização dos dados, na visão ATENDIMENTOS X SERVIÇOS, as colunas referentes ao prazo de vencimento dos serviços devem conter os dados calculados em função das datas prevista e de execução, conforme a tabela acima.
• O serviço deve armazenar um histórico de modificações de estados (data, usuário que realizou a modificação e descrição do estado quando o serviço foi incluído ou alterado);
• Os valores unitário e total dos serviços devem ser exibidos com quatro casas decimais na tela de cadastro, no grid e ao exportar os dados do grid para o formato do Excel.
• Ao incluir ou alterar um atendimento, o usuário poderá incluir novos serviços, alterar, excluir e visualizar um serviço incluído e imprimir a ordem de serviço para o serviço selecionado.
• Quando a visão ATENDIMENTOS X SERVIÇOS estiver selecionada, a ação de excluir deve agir somente sobre o serviço selecionado. O sistema deve alertar o usuário caso o serviço selecionado seja o único no atendimento e excluir também o atendimento.
• Ao tentar imprimir uma OS para um atendimento ainda não salvo, o sistema deverá alertar o usuário de que o sistema irá salvar o atendimento caso ele confirme a impressão da OS.
• No cadastro de atendimentos individuais e de vários serviços de uma vez, deve ser mostrado o total das quantidades solicitadas, atendidas e dos valores totais de todos os serviços, recalculando automaticamente a cada alteração na lista de serviços ou nos valores.
• A lista de fotos de um serviço deve suportar, no máximo, 2 arquivos.
• Na listagem de fotos, o usuário deve poder incluir e excluir imagens, visualizar as miniaturas a as fotos em tamanho grande, além de salvar as imagens numa pasta de sua escolha.

• Os exportar os dados para o mapa, só devem ser exibidos os propriedade do atendimento que possuírem ao menos uma feição;
• Cada propriedade de atendimento deve ser exibido apenas uma vez, independente da quantidade de atendimentos prestados para ele;
• O sistema deve alertar que todos os registros podem ser exibidos no mapa quando não houver filtros ativos ao acionar a ferramenta de mapa;
• A ferramenta deve ser habilitada ou desabilitada de acordo com as permissões do perfil do usuário logado.
• As propriedade de atendimento devem ser listados no mapa com a lista de características das suas feições (quando houver) e com todos os seus dados vinculados: pessoas, atividades e outros pontos de atendimento;
• As propriedades vinculadas aos atendimentos listados na tela de consulta devem ser exibidos no mapa com um marcador para cada feição, sendo:
  • O marcador da primeira feição deverá conter as características da feição e os detalhes da propriedade;
  • Os marcadores das demais feições, quando existirem, deverão conter apenas as características de cada feição;
• As propriedades de atendimentos vinculados devem ser exibidos no mapa com um marcador para cada feição, contendo:
  • a lista de características das suas feições (quando houver);

• Quando houver modelo personalizado de OS para o serviço em questão, este deve ser usado na impressão da OS. Caso contrário, deve ser usado o modelo padrão;
• No modelo padrão, todos os campos descritos, salvo exceções documentadas, devem ser impressos corretamente na OS;
• Nos modelos personalizados, os campos que tem códigos correspondentes devem ser impressos corretamente na OS;
• Toda impressão de OS deve ficar registrada no histórico do serviço;
• Ao imprimir várias ordens de serviço de uma só vez todos os registros filtrados na tela de consulta devem impressos;
• Ao imprimir várias ordens de serviço deve ser gerado um documento para cada modelo presente na lista de serviços selecionados;
• Só é possível imprimir várias ordens de serviço se a visão ATENDIMENTOS x SERVIÇOS estiver selecionada;
• As fotos do serviço só serão exibidas se existirem para o serviço em questão. Se a primeira ou segunda fotos não existirem, a código correspondente não terá nenhum efeito.

• Somente um serviço e uma categoria podem ser exportados de uma vez, para que os campos personalizados sejam os mesmos para cada registro.
• O arquivo gerado deve estar no formato CSV, com campos separados por ponto e vírgula (;), com um registro por linha.
• Os campos de data devem estar no formato DD/MM/AAAA, quando houver data para exibir;
• Os campos decimais devem ter sempre 6 casas decimais.