Especificação Funcional: Importação dos dados dos diários

Esta funcionalidade permite ao usuário a importação dos dados dos diários de classe: notas, faltas e aulas dadas para os alunos e turmas cadastrados no sistema.

A importação dos diários de classe consiste em recuperar as notas, faltas e aulas dadas informadas pelo professor no sistema web e alimentar o cadastro de notas das turmas das quais estão informadas no arquivo de diários, este arquivo é exportado através de uma funcionalidade do sistema web. O sistema deverá permitir que o usuário selecione um arquivo de diários válido e, após abrir o arquivo, o sistema deverá exibir uma lista com cada período letivo de cada diário do arquivo. Essa lista deve conter, para cada diário e período letivo, as seguintes informações:

• Código: número de identificação do diário no sistema web;
• Escola: escola da qual pertence o diário;
• Curso / Ano letivo: curso, ano letivo e período letivo dos quais pertencem o diário;
• Série: série da qual pertence o diário;
• Turma: turma e turno dos quais pertencem o diário;
• Disciplina: disciplina e classificação das quais pertencem o diário;
• Professor: professor da turma para a disciplina da qual pertence o diário;
• Período letivo: período letivo do qual pertence o diário;
• Situação: situação do período letivo do diário quanto à importação:
  • Sem lançamentos: o período letivo (normal) não tem nenhuma aula registrada e por isso não poderá ser importado (períodos letivos do tipo “recuperação” não precisam de aulas dadas para serem importados);
  • Não importado: o período letivo não tem nenhum impedimento e pode ser importado normalmente;
  • Importado: o período letivo já foi importado e poderá ser reimportado quando necessário.
• Data/hora da importação: data e hora da importação do período letivo (apenas para períodos já importados).

Para realizar a operação, o usuário deverá selecionar um dos itens (diário / período letivo) exibidos na listagem de diários e solicitar a importação dos dados, através do botão Importar. Ao selecionar cada item, o sistema realiza todas as validações necessárias e exibe na listagem de tarefas todas as advertências e erros encontrados. Se o diário não tiver nenhum impedimento (erro que impeça a importação), o sistema deverá habilitar o botão Importar, para que todos os dados sejam importados para os alunos e turmas dos diários selecionados.

O arquivo de diários deve ser escrito no formato XML, conforme as especificações predefinidas no {criar a documentação do layout do arquivo de diários e adicionar o link aqui…}

Para garantir que a importação ocorra da maneira correta, algumas verificações devem ser realizadas pelo sistema antes de processar o arquivo:

1. Abrir o arquivo de diários, em modo texto, e verificar a presença de alguns elementos que indiquem que o documento é um arquivo de diários:
   1. O indicador de que o arquivo se trata de um documento xml;
   2. O nó raiz do arquivo;
   3. A versão do layout do arquivo;
2. Verificar se o arquivo está definido como somente leitura;

Caso alguma das validações falhe, o sistema não deverá processar o arquivo e o usuário deverá ser informado para que possa providenciar um arquivo de diários válido ou resolver os problemas encontrados.

Assim que um arquivo de diários válido for aberto, o usuário poderá selecionar seus itens que são exibidos na listagem de diários, no momento que o usuário seleciona um item o sistema deve iniciar as comparações dos dados do arquivo com os dados do sistema para montar uma lista de tarefas de diários. Ao final do processo de comparação, a lista de tarefas de diários deverá ser exibida para o usuário para que ele visualize cada um dos erros ou advertências que foram localizados. Somente após a confirmação do usuário, o sistema deverá processar efetivamente a importação do arquivo de diários.

O sistema deve realizar as comparações dos dados mais genéricos para os mais específicos, gerando a lista de tarefas na mesma ordem em que as verificações ocorrem. As tarefas da lista devem ser divididas nas seguintes categorias:

• Advertência (): tarefas de diários que necessitam ser analisadas, que podem gerar perda de dados. Ex: , etc;
• Erro (): verificações que o sistema não é capaz de realizar. Ex: , etc.

Enquanto existirem erros que impeçam a importação dos dados, o sistema não deverá realizar nenhuma alteração no arquivo de diários. Alguns desses erros poderão ser corrigidos pelo próprio usuário, enquanto outros deverão ser corrigidos através da geração de um novo arquivo de diários ou até mesmo de uma alteração manual do arquivo. Para auxiliar o usuário, o sistema deverá exibir informações detalhadas para cada tarefa, orientando o usuário sobre como ele deve proceder.

O sistema deverá importar todos os dados (notas, faltas e aulas dadas) do diário para disciplinas que forem dos tipos 'Principal' ou 'Individual' que possuírem o campo “Importar aulas e faltas da disciplina do diário” marcado no cadastro do professor vinculado à disciplina (no cadastro de turmas);

O sistema deverá importar apenas as notas do diário para disciplinas que forem dos tipos 'Conjunta' ou 'Individual' que não possuírem o campo “Importar aulas e faltas da disciplina do diário” marcado no cadastro do professor vinculado à disciplina (no cadastro de turmas). Nesse caso, os dados das faltas e aulas dadas do diário não serão exibidos na tela, mesmo que existam no arquivo do diário eletrônico.

O sistema deverá importar o caracter '-' para todas as notas dos alunos do diário, quando a disciplina não possuir critério de aprovação.

O sistema deverá importar o caracter '-' para todas as notas dos alunos do diário, quando a disciplina possuir tipo de avaliação igual a 'FORMATIVA (FICHAS)'.

O sistema deverá armazenar em seu banco de dados quais períodos letivos já foram importados e atualizar os dados de data e hora, caso o diário seja reimportado.

Ao carregar e exibir a lista de períodos letivos de um arquivo de diários, o sistema deverá identificar aqueles que ainda não foram preenchidos pelo professor através da quantidade de aulas dadas. Ao identificar um período letivo sem aulas dadas, o sistema deverá exibir esse item na lista com uma cor diferente dos demais e exibir também a situação “Sem lançamentos”. Caso o usuário selecione um desses períodos letivos, o sistema deverá exibir um erro na listagem de tarefas informando que o período letivo não possui aulas dadas, nesse caso não deve continuar a importação, nem mesmo marcar o período letivo como importado.

Essa validação só pode ser realizada para períodos letivos normais, pois os períodos letivos do tipo “Recuperação” não precisam ter aulas dadas registradas.

O sistema não deve recuperar os dados de aulas dadas e faltas do diário, ao importar um período letivo do tipo “Recuperação”.

O sistema não deve permitir que diários de turmas já finalizadas sejam importados. Ao tentar importar os dados de uma turma finalizada, o sistema deve exibir um erro na listagem de tarefas, nesse caso não deve realizar a importação dos diários da turma.

Não se aplica.

• O sistema deve listar todos os períodos letivos de todos os diários do arquivo aberto;
• O sistema deve exibir a situação “Sem lançamentos” para períodos letivos do tipo “Normal” que não tenham aulas cadastradas;
• O sistema deve exibir a situação “Não importado” para períodos letivos do tipo “Normal” que tenham aulas cadastradas; e para períodos letivos do tipo “Recuperação”;
• O sistema deve exibir a situação “Importado” para períodos letivos que já foram importados;
• O sistema deve exibir a data e a hora da importação para períodos letivos que já foram importados;
• O sistema deve exibir o campo “Data/hora da importação” sempre atualizado, de acordo com a última importação realizada;
• O sistema deve exibir o traço ”-” no campo de notas de todos os alunos da turma, quando a disciplina não possuir critério de avaliação e o período letivo for do tipo “Normal”;
• O sistema deve impedir a importação de dados de um período letivo sem lançamentos;
• O sistema deve impedir a importação de dados para uma turma já finalizada;
• O sistema deve realizar as “Ações quando executada” de cada erro e advertência informados nesse documentação;
• O sistema deve permitir que um diário seja importado quantas vezes o usuário solicitar;

Nenhuma informação adicional.