Especificação funcional: Importar transferência

Resumo

A importação de transferência de alunos salva os dados do arquivo no banco de dados do sistema.

Descrição

Para facilitar a inclusão dos alunos transferidos de escolas em um mesmo município, a importação de transferência se faz necessária.

Um usuário da escola que o aluno está sendo transferido deve gerar um arquivo de transferência do aluno, através da funcionalidade de exportação de transferência, esse arquivo deve estar de acordo com um layout predefinido, contendo as informações do aluno. Após gerar esse arquivo, o mesmo deve ser enviado ao usuário da escola que o aluno está sendo matriculado para que possa ser realizada a importação da transferência do aluno.

De posse desse arquivo, o usuário do sistema deverá abrir o arquivo de transferência e, através da funcionalidade de importação de transferência, processar os dados contidos no arquivo. O sistema deve, então, realizar as importação dos dados, fazendo com que o aluno seja matriculado na escola e obtenha as notas e faltas, assim como as séries anteriores no histórico contidas no arquivo.

Estrutura do arquivo de transferência

O arquivo de transferência deve ser escrito no formato XML, conforme as especificações predefinidas no layout do arquivo de atualizações e de acordo com as regras definidas no esquema (arquivo .xsd) adequado.

Validações realizadas antes da importação

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

Abrir o arquivo de transferência, em modo texto, e verificar a presença de alguns elementos que indiquem que o documento é um arquivo de transferência:
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;
4. A indicação do nome do schema que deve ser usado para validar o arquivo.
Verificar se o arquivo está definido como somente leitura;
Validar o arquivo de atualizações de acordo com o Schema adequado, na versão adequada;

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 transferência válido ou resolver os problemas encontrados.

Identificar as disciplinas da transferência

Caso o sistema não consiga identificar alguma disciplina do arquivo com as disciplinas da turma que o aluno será matriculado (através da área disciplinar e do nome), deve ser exibida a tela para que o usuário indique qual disciplina da turma é equivalente à cada disciplina não localizada do arquivo.

Quando uma ou mais disciplinas não forem indicadas pelo usuário, o sistema deve exibir uma mensagem informando que as disciplinas não identificadas terão seus dados perdidos na importação da transferência. Caso o usuário clique em “Sim” o procedimento deve continuar e as disciplinas não identificadas não serão importadas; caso clique em “Não” a tela deve manter-se aberta para que o usuário continue a edição.

Para que o usuário possa identificar as disciplinas do arquivo, basta que ele selecione a linha da disciplina e clique no botão “Localizar uma disciplina da turma”, que deve abrir a tela “Localizar disciplina” onde serão exibidas as disciplinas da turma do aluno, que ainda não foram associadas às disciplinas do arquivo. Com isso essa listagem é atualizada à cada seleção de disciplinas, ou seja, uma disciplina selecionada anteriormente não será mais exibida nessa listagem para a próxima disciplina a ser localizada pelo usuário.

Geração da lista de tarefas de transferência

Assim que um arquivo de transferência válido for aberto, o sistema deve iniciar as comparações dos dados do arquivo com os dados do sistema para montar uma lista de tarefas de transferência. Ao final do processo de comparação, a lista de tarefas de transferência deverá ser exibida para o usuário para que ele visualiza cada uma das alterações que serão realizadas. Somente após a confirmação do usuário, o sistema deverá processar efetivamente as operações no arquivo de transferência.

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:

Tarefa (): tarefas de transferência, são as etapas para a realização da importação dos dados. Ex: , etc.
Advertência (): tarefas de transferência que podem 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 na lista de tarefas a executar, o sistema não deverá realizar nenhuma alteração no arquivo de transferências. 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 transferências 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.

Tipo	Descrição	Motivo	Ações quando executada
	O arquivo possui mais do que um aluno.	Transferências devem ser exportadas individualmente. Provavelmente o usuário está tentando importar um arquivo com vários alunos	O botão “Importar” deve estar desabilitado.

Curso

Tipo	Descrição	Motivo	Ações quando executada
	A escola selecionada não possui nenhum curso vinculado.	É provável que não tenham sido vinculados os cursos na escola selecionada.	O botão “Importar” deve está desabilitado.
	A escola selecionada não possui vinculado o curso do arquivo.	É provável que não tenha sido vinculado o curso do arquivo na escola selecionada ou que não esteja ativo.	O botão “Importar” deve está desabilitado.

Série

Descrição	Motivo	Ações quando executada
O curso %s não possui séries cadastradas no sistema.	O curso foi localizado como o curso equivalente ao do arquivo de transferência, pois os dados de modalidade e etapa são iguais. Mas é necessário que o curso possua séries cadastradas no sistema.	O botão “Importar” deve está desabilitado.
A série com etapa %s e %sª ordem não foi localizada no curso %s do sistema.	É provável que a etapa existente no arquivo ainda não tenha sido cadastrada ou esteja com a ordem diferente para o curso no sistema.	O botão “Importar” deve está desabilitado.
O tipo de carga horária da série %s é diferente do arquivo.	No sistema a série possui tipo de carga horária igual a %s, enquanto no arquivo o tipo de carga horária é igual a %s. É necessário que ambos os tipos de carga horária sejam equivalentes.	O botão “Importar” deve está desabilitado.

Disciplinas

Descrição	Motivo	Ações quando executada
A turma %s não possui disciplinas cadastradas no sistema.	É necessário que a turma possua disciplinas cadastradas no sistema.	O botão “Importar” deve está desabilitado.
A quantidade de disciplinas da turma %s é diferente do arquivo.	Existem disciplinas diferentes no arquivo. Serão importados os dados apenas das disciplinas existentes tanto no arquivo quanto no sistema.	Serão importados os dados das disciplinas existentes tanto no arquivo quanto no sistema.
O campo que isenta alunos à reprovação por frequência da disciplina %s é diferente do arquivo.	No sistema a disciplina %s alunos à reprovação por frequência, enquanto no arquivo %s. Os dados serão importados mesmo assim.	Os resultados finais da disciplina serão calculados mesmo assim, com base no valor do campo cadastrado na disciplina do sistema.
O critério de aprovação por notas da disciplina %s da série %s é diferente do arquivo.	No sistema a série possui critério de aprovação igual a %s, enquanto no arquivo o critério de aprovação é igual a %s. Dessa forma, não será possível importar nenhuma informação da disciplina existente no arquivo para o sistema.	Não deve importar as notas informadas no arquivo.
O tipo de avaliação da disciplina %s é diferente do arquivo.	No sistema a disciplina possui tipo de avaliação igual a %s, enquanto no arquivo o tipo de avaliação é igual a %s. É necessário que ambos os tipos de avaliação sejam equivalentes.	Não deve importar as notas informadas no arquivo.
A carga horária da disciplina %s da série %s é diferente do arquivo.	A disciplina possui valor de Carga horária no sistema igual a %s, enquanto no arquivo o valor é igual a %s. Os dados serão importados mesmo assim.	A carga horária da turma vai permanecer a mesma após a importação da transferência.

Períodos letivos

Descrição	Motivo	Ações quando executada
A série %s não possui períodos letivos cadastrados no sistema.	A série foi localizada como a série equivalente a do arquivo, pois os dados da etapa são iguais. Mas é necessário que a série possua períodos letivos cadastrados no sistema.	O botão “Importar” deve está desabilitado.
A série %s não possui períodos letivos do tipo %s cadastrados no sistema.	A série foi localizada como a série equivalente a do arquivo, pois os dados da etapa são iguais. Mas é necessário que a série possua períodos letivos do tipo %s cadastrados no sistema.	O botão “Importar” deve está desabilitado.
A quantidade de períodos letivos do tipo %s da série %s é diferente do arquivo.	Existem períodos letivos do tipo %s diferentes no arquivo. É necessário que haja a mesma quantidade de períodos letivos tanto no arquivo quanto no sistema, para a realização da importação da transferência do aluno.	O botão “Importar” deve está desabilitado.
O período letivo de ordem %sª não foi localizado na série %s no sistema.	É provável que a ordem existente no arquivo ainda não tenha sido cadastrada para o período letivo no sistema. Dessa forma, não será possível importar nenhuma informação do período letivo existente no arquivo para o sistema.	As informações (Notas e Faltas) referentes ao período letivo existente apenas no arquivo de transferência não serão importadas.
O tipo do período letivo %s da série %s é diferente do arquivo.	O período letivo foi localizado como o período letivo equivalente ao do arquivo, pois as ordens são iguais. No entanto, os tipos são diferentes, no sistema o tipo do período letivo é %s e no arquivo o tipo é %s. Dessa forma, não será possível importar nenhuma informação do período letivo para o sistema.	As informações (Notas e Faltas) referentes ao período letivo existente apenas no arquivo não serão importadas.
O nome do período letivo %s da série %s é diferente do arquivo.	O período letivo foi localizado como o período letivo equivalente ao do arquivo, pois as ordens são iguais. No entanto, os nomes são diferentes, no arquivo o período letivo possui o nome de %s. Os dados serão importados mesmo assim.	Deve importar as informações (Notas e Faltas) para o período letivo do sistema que seja equivalente à mesma ordem a do arquivo de transferência.
O peso do período letivo %s da série %s é diferente do arquivo.	O período letivo foi localizado como o período letivo equivalente ao do arquivo, pois as ordens são iguais. No entanto, os pesos são diferentes, no sistema o peso é %s e no arquivo é %s. É necessário que ambos os pesos sejam equivalentes.	O botão “Importar” deve está desabilitado.
A média do período letivo %s da série %s é diferente do arquivo.	O período letivo foi localizado como o período letivo equivalente ao do arquivo, pois as ordens são iguais. No entanto, as médias são diferentes, no sistema a média é %s e no arquivo é %s. Os dados serão importados mesmo assim.	Deve importar as informações (Notas e Faltas) para o período letivo do sistema que seja equivalente à mesma ordem a do arquivo de transferência.
Os dias letivos do período letivo %s da série %s são diferentes do arquivo.	O período letivo foi localizado como o período letivo equivalente ao do arquivo, pois as ordens são iguais. No entanto, os dias letivos são diferentes, no sistema os dias letivos são %s e no arquivo são %s. Os dados serão importados mesmo assim.	Deve importar as informações (Notas e Faltas) para o período letivo do sistema que seja equivalente à mesma ordem a do arquivo de transferência. Se as faltas no arquivo de transferência for maior que as aulas dadas na turma, as faltas não devem ser importadas.

Alunos / Turmas

Descrição	Motivo	Ações quando executada
O aluno não possui os dados de transferência.	O aluno foi exportado sem os dados de transferência, provavelmente através da ferramenta de exportar alunos.	O botão “Importar” deve estar desabilitado.
O Código INEP do aluno %s já está cadastrado para outro aluno no sistema.	Como já existe outro aluno cadastrado no sistema com o mesmo Código INEP, não será possível realizar a importação do aluno.	O botão “Importar” deve está desabilitado.
A escola selecionada não possui nenhuma turma da série %s no sistema.	Como a escola não possui nenhuma turma da série, não será possível realizar a matrícula e a importação dos dados da transferência do aluno, apenas o cadastro do aluno será realizado no sistema.	Somente o cadastro do aluno deve ser importado.
O aluno %s está matriculado em série diferente do arquivo de transferência.	A série que o aluno está estudando não é compatível com a série informada no arquivo de transferência. Dessa forma, não é possível realizar a importação do aluno.	O botão “Importar” deve está desabilitado.
O aluno %s está matriculado, porém não está cursando o ano letivo no sistema.	A importação de transferência é realizada apenas para alunos que estão cursando o ano letivo no sistema. Como o aluno possui o resultado final igual a %s, não será possível realizar a importação.	O botão “Importar” deve está desabilitado.
O aluno %s já está matriculado em outra escola.	O aluno está matriculado na escola %s. Dessa forma, não é possível importá-lo para a escola selecionada.	O botão “Importar” deve está desabilitado.
A turma %s não possui a disciplina %s informada no arquivo.	Como a turma da matrícula do aluno não possui a disciplina, todas as notas e faltas referentes à disciplina existente no arquivo, não poderão ser importadas para o sistema.	As notas e faltas referentes à disciplina existente no arquivo, não poderão ser importadas para o sistema.
A turma %s não possui valor de carga horária no sistema.	Como a turma da matrícula do aluno não possui carga horária, todos os valores de faltas e aulas dadas do aluno existentes no arquivo, não poderão ser importados para o sistema.	Todos os valores de faltas e aulas dadas do aluno existentes no arquivo, não poderão ser importados para o sistema.
A carga horária da turma %s é menor do que a carga horária do aluno no arquivo de transferência.	Como a turma da matrícula do aluno possui carga horária menor do que a carga horária do aluno, não será possível importar a carga horária do arquivo para o sistema. O aluno ficará com o mesmo valor da turma.	As faltas do aluno presentes no arquivo de transferência deve ser importada, desde que o valor seja menor que o total de aulas dadas informado no sistema.
A carga horária da turma %s é menor do que a quantidade de faltas do aluno no arquivo de transferência.	Como a turma da matrícula do aluno possui carga horária menor do que a quantidade de faltas do aluno, não será possível importar as faltas do arquivo para o sistema. O aluno ficará sem faltas.	Não será possível importar as faltas do arquivo para o sistema. O aluno ficará sem faltas.
O aluno %s já está cadastrado no sistema.	Como o aluno já está cadastrado no sistema, seus dados no cadastro de alunos não serão alterados.	Os dados da transferência devem ser importados (Notas e Faltas), porém o cadastro do aluno não será atualizado.
O aluno %s já está matriculado no sistema.	Como o aluno já está matriculado no sistema, seus dados no cadastro de alunos não serão alterados.	Os dados da transferência devem ser importados (Notas e Faltas) e substituir as informações existentes, porém o cadastro do aluno não será atualizado.
O aluno %s possui notas cadastradas no sistema.	As notas e faltas existentes do aluno no sistema serão atualizadas de acordo com os dados do arquivo de transferência.	As notas e faltas existentes do aluno no sistema serão atualizadas de acordo com os dados do arquivo de transferência.

Notas

Descrição	Motivo	Ações quando executada
A nota da disciplina %s no %s é maior que o peso do período letivo.	A nota não pode ser maior que o peso informado para o período letivo. No sistema o peso do período letivo é igual a %s, enquanto no arquivo de transferência a nota é igual a %s. Dessa forma, a nota não será importada.	As notas não serão importadas.
A nota da disciplina %s no %s não possui valor numérico.	Como o período letivo é avaliado por média, apenas notas numéricas são aceitas no sistema. A nota possui valor igual a %s, e dessa forma não será salva.	As notas não serão importadas.
A nota da disciplina %s no %s possui valor diferente de -.	Como a disciplina não aprova por notas, apenas notas iguais a - são aceitas no sistema. A nota possui valor a igual a %s, e dessa forma não será salva.	As notas não serão importadas.
O valor das faltas da disciplina %s no %s é maior que as aulas da nova turma.	O valor das faltas no arquivo de transferência é igual a %s, enquanto as aulas da turma no sistema possui o valor de %s. Dessa forma, não serão importadas as faltas.	As faltas não serão importadas.
A turma %s não possui aulas para a disciplina %s no %s.	É provável que não tenham sido lançadas as aulas do período letivo ainda no sistema. Dessa forma, não será possível importar as faltas para o sistema.	As faltas não serão importadas.

Pontos de verificação

O sistema deve processar apenas arquivos de transferência válidos, de acordo com o layout definido para arquivos de transferência;
O sistema deve exibir desabilitado o campo Escola (deve ser exibido apenas o nome da escola), dessa forma, a escola será selecionada através da tela “Localizar escola”;
O sistema deve listar na tela de localização de escolas, todas as escolas cadastradas no sistema, para que o usuário possa decidir para qual escola o aluno será importado;
O sistema deve exibir desabilitado o campo Turma (deve ser exibido apenas o nome da turma), dessa forma, a turma será selecionada através da tela “Localizar turma regular”;
O sistema deve listar na tela de localização de turmas regulares:
- Se o aluno não estiver matriculado ainda na escola selecionada: todas as turmas cadastradas no sistema (da série e curso informados no arquivo), e todas as turmas dos demais cursos vinculados na escola;
- Se o aluno já estiver matriculado na escola selecionada: apenas a turma que o aluno encontra-se matriculado no sistema, e todas as turmas dos demais cursos vinculados na escola;
O sistema deve exibir uma lista das ações realizadas antes de proceder com a importação;
O sistema deve exibir informações detalhadas sobre cada tarefa que será realizada no arquivo;
O sistema deve impedir que a importação aconteça caso exista algum erro na lista de tarefas a serem executadas;
O sistema, ao processar a importação, deve executar exatamente as ações definidas para cada tarefa;
O sistema deve informar ao usuário que a importação foi concluída ao final do processo;
O sistema deve salvar e fechar o arquivo de transferência após a importação;
O sistema não deve corromper o arquivo de transferência após a importação;
O sistema não deve apagar o arquivo de transferência após o processo.

Aluno não cadastrado

O sistema deve incluir o aluno;
O sistema deve realizar a matrícula do aluno, na escola selecionada pelo usuário e com isso seu histórico deverá ser gerado contendo a série da matrícula;
O sistema deve realizar a matrícula na primeira turma da série em que o aluno está cursando;
O sistema deve importar as notas e faltas contidas no arquivo, para o cadastro de notas do aluno, para todas as disciplinas existentes tanto no sistema quanto no arquivo;
O sistema deve importar as séries anteriores do histórico contidas no arquivo, para o histórico do aluno;

Aluno cadastrado e não matriculado

O sistema não deve atualizar os dados do cadastro do aluno;
O sistema deve realizar a matrícula do aluno, na escola selecionada pelo usuário e com isso seu histórico deverá ser gerado contendo a série da matrícula;
O sistema deve realizar a matrícula na primeira turma da série em que o aluno está cursando;
O sistema deve importar as notas e faltas contidas no arquivo, para o cadastro de notas do aluno, para todas as disciplinas existentes tanto no sistema quanto no arquivo;
O sistema deve importar as séries anteriores do histórico contidas no arquivo, para o histórico do aluno;

Aluno já matriculado

O sistema só poderá importar a transferência, se o aluno estiver matriculado na mesma escola selecionada pelo usuário;
O sistema só poderá importar a transferência, se o aluno estiver matriculado na mesma série informada no arquivo;
O sistema só poderá importar a transferência, se o aluno estiver com resultado final igual a Cursando;
O sistema não deve atualizar os dados do cadastro do aluno;
O sistema deve importar as notas e faltas contidas no arquivo, para o cadastro de notas do aluno, para todas as disciplinas existentes tanto no sistema quanto no arquivo;
O sistema não deve importar as séries anteriores do histórico contidas no arquivo;

Observações

Nenhuma.