domingo, 10 de dezembro de 2017

A importância da revisão da literatura no projeto

Olá!

Nesta semana, a equipe 4labz passou pela última avaliação, na qual mostramos para os professores os ajustes feitos na documentação e na aplicação conforme havia sido apontado no dia da nossa banca.

Ao final da avaliação, o professor Aires nos questionou se a revisão da literatura que constava na nossa documentação tinha feito diferença durante o desenvolvimento do projeto.

Já adiantando, a resposta é sim!!!!

O ponto central era o fato de nós termos focado uma boa parte da revisão no tema do nosso projeto, e não somente nas tecnologias utilizadas. Nós propusemos uma aplicação para gerenciar Notas Fiscais Eletrônicas (NF-e), e foi justamente esse o maior foco da nossa revisão de literatura.

Estudar sobre notas fiscais, apesar de não ser, digamos, empolgante no início, acabou se mostrando interessante por nos ensinar bastante sobre um tema que é muito, mas muito maior do que nós imaginávamos.

E aqui podemos destacar dois grandes diferenciais que esse estudo teve durante todo o projeto: ele auxiliou na análise do sistema que seria desenvolvido e também forneceu elementos para justificar algumas mudanças que tivemos que fazer principalmente no início do projeto.

Para contextualizar o que estamos dizendo, é importante destacar que tivemos certa dificuldade no início do projeto em definir como seria o nosso sistema. Elencamos algumas características que desejávamos e as incluímos nas conversas iniciais com os professores da disciplina. Porém, com o passar dos dias, já fazendo o levantamento das informações em manuais oficiais da NF-e e outras fontes também, percebemos que algumas das propostas feitas aos professores não seriam possíveis de ser implementadas.

Ou seja, seria necessário fazer mudanças no sistema proposto e aprovado. E como justificar? Aqui a revisão da literatura teve papel fundamental. Como exemplo de mudança, podemos citar a proposta de fazer um sistema de comunicação com web services das Secretarias da Fazenda dos Estados para que todas as NF-e de um usuário específico fossem localizadas e baixadas pela nossa aplicação. Porém, buscando informações sobre como desenvolver tal funcionalidade, esbarramos na necessidade da utilização de certificado digital com o CPF do usuário para que fosse possível estabelecer comunicação com os web services. E, diferente das empresas, que geralmente possuem certificado digital com seu CNPJ, é raro encontrar pessoas físicas que possuam certificado digital.

Além disso, ela ajudou muito em várias decisões e implementações. Por exemplo, como fazer para identificar que uma chave de acesso de um documento fiscal pertence à uma NF-e? Ela poderia ser de outro tipo de documento, como uma Nota Fiscal de Consumidor Eletrônica (NFC-e) ou uma Nota Fiscal de Serviços Eletrônica (NFS-e). Uma vez que a nossa aplicação engloba, inicialmente, apenas NF-e, a utilização de uma chave de acesso de outro tipo de documento fiscal geraria um erro porque cada um está em uma base de dados diferente. Estudando sobre o tema, nós verificamos que as posições 21 e 22 da chave de acesso indicam o código do tipo do documento fiscal. As NF-e possuem o código 55. Assim, pudemos implementar um leitor de arquivos direcionado para o tipo de documento fiscal englobado pela nossa aplicação.

Enfim, para não alongar ainda mais esta publicação, deixamos duas dicas: a primeira, dê especial atenção à revisão da literatura do tema escolhido para sua aplicação. Ela possibilitará fazer uma melhor análise do sistema proposto. Também irá justificar eventuais mudanças na proposta inicial. E, durante todo o desenvolvimento, certamente ela ajudará a chegar em soluções para codificar funcionalidades da aplicação.

A segunda (e muito importante!!!!) dica é: estruture a revisão no documento que será entregue de modo que ela traga não só os conceitos, mas também que ela reflita aquilo que está englobado na aplicação. Lembre que os professores já conhecem as tecnologias, provavelmente eles já sabem a teoria e entenderão como elas foram aplicadas no projeto, mas o assunto-tema da aplicação possivelmente será algo novo para eles, daí a importância de detalhar melhor essa parte na documentação.

Um abraço!!!

domingo, 3 de dezembro de 2017

18ª Semana (27/11 - 04/12) - Apresentação para a banca e finalização do projeto

Olá.

Nesta segunda-feira, dia 27 de novembro de 2017, realizamos a nossa apresentação para a banca da disciplina de A6PGP. Estavam presentes os professores Aires, Daniel e Ivan, que, após a nossa apresentação, realizaram diversos comentários e apontaram correções pertinentes em nosso projeto.

Como nos sortearam para apresentar no último dia, tivemos apenas uma semana para realizar os ajustes necessários. Como a correção já estava em andamento desde a apresentação do primeiro grupo, conseguimos terminar algumas a tempo para a apresentação para a banca e as outras ficaram para a segunda entrega (e de novo, recomendamos o mesmo para as futuras equipes).

Na aplicação, realizamos as seguintes modificações:
  • Cadastro de garantia: agora o cadastro pode ser feito por produto, apenas informando o período da garantia, sem a necessidade de cadastrar um novo lembrete manualmente.
  • Recuperação de senha: o método de recuperação de senha foi alterado para que o usuário atualize sua nova senha, ao invés de sobrescrevermos com uma senha aleatória que era enviada por e-mail.
  • Lembretes: os lembretes enviados agora ficam em seções separadas dos lembretes a enviar.
  • Compartilhamento de nota: agora, a nota compartilhada só aparecerá para o usuário destinatário após confirmação do mesmo. 
Além destes ajustes, algumas outras pequenas correções apontadas pela banca foram aplicadas, como renomeação do pacote do projeto, reordenação do menu, alteração do tipo de gráfico do consumo e etc.

Na documentação, foram efetuadas as diversas correções apontadas pelos professores nos documentos impressos, além de inclusão de novas seções como a de justificativa de escolhas de tecnologias, alterações realizadas e o manual técnico.

Com isso, está tudo pronto para a entrega final do projeto! Amanhã, segunda-feira (04/12/2017), teremos a nossa última avaliação. 


Estamos muito orgulhosos com o trabalho realizado durante o semestre, tanto na documentação quanto na aplicação. Nosso esforço foi reconhecido pelos professores e colegas de turma. Parabéns equipe! 


17ª Semana (20/11 - 26/11) - Preparação para a apresentação (finalmente)

Olá.

Nesta penúltima semana de projeto, demos continuidade às correções tanto no aplicação quanto na documentação, além de concluirmos a apresentação para segunda-feira, dia 27 de novembro.

Seguindo o nosso levantamento de tópicos a serem corrigidos e aprimorados, demos prioridade para as tarefas que deveriam ser apresentadas para a banca.

Na aplicação, foi implementada a funcionalidade de leitura de arquivos PDF e XML das notas fiscais, anteriormente documentadas como implementação futura. Além disso, corrigimos bugs principalmente no cadastro das notas e a finalização da exportação dos gráficos da página de consumo. Também preparamos duas versões off-line da aplicação, nas quais uma utilizava o banco de dados que estava na Amazon e a outra com o banco de dados local. Com isso, a apresentação da aplicação não seria afetada caso o servidor falhasse ou tivéssemos problemas de conexão (recomendamos o mesmo para todos as futuras equipes).

A documentação foi atualizada de acordo com as novas funcionalidades implementadas, além de concluirmos o Diagrama de Atividades dos principais fluxos da Nota Digital.

E por fim, os nossa apresentação de slides ficou pronta! Assim, tudo estava devidamente preparado para a apresentação :D A seguir, estão alguns slides que apresentamos: 





O quadro a seguir apresenta mais detalhadamente as atividades realizadas por cada integrante da equipe durante a semana:

Resumo das atividades realizadas - 17ª semana
IntegranteAtividades
Caique BorgesDiagrama de classes; Leitor de XML; Correção de bugs. 
Fausto Tozo
Implementação Content Security Policy; Atualização dos requisitos, casos de uso e descrição dos casos de uso.
Maíra TabataApresentação de slides; Modal para explicação de chave de acesso para o usuário; Relatório de consumo; Correção de bugs.
Vivian BrazãoAjustes revisão da literatura; Diagrama de atividades; Novo relatório do StatsSVN; Nova versão do Gource.
Quadro 1 - Atividades realizadas durante a décima sétima semana

Até o próximo post (da última semana)!