mateuspontess / gerenciador

Web App baseado em um projeto de MVC com Java puro e JSP

Gerenciador de Empresas

Sobre

Esse projeto foi desenvolvido na base de um projeto simples de MVC. Nele foi desenvolvido um back-end mais robusto e um front-end dinâmico. A base desse projeto foi criada no curso Java Web: crie aplicações com Servlets e MVC da Alura, a versão base se encontra na branch versao-original-alura. O conteúdo das outras branches já não condiz mais em quase nada com o projeto base. Essa é uma aplicação web de registro de empresas com Java legado, o usuário insere um nome e a data de abertura, pode editar o cadastro e também arquivar.

Desenvolvimento do projeto

É meu primeiro projeto web, nele tive a primeira vez de muitas coisas, por isso, preferi por não usar frameworks e libs no front-end, para conseguir resolver tudo da maneira mais crua, de forma que exercitasse bastante a minha lógica, criatividade e conhecimento de algorítmos. Esse projeto surgiu como um treinamento para praticar CSS e alguns conceitos de backend. A medida que fui desenvolvendo surgiram novas ideias e foi tomando novas proporções.

Aprendizado

Tecnologias aprendidas

• CSS
• JSP
• JavaScript

Conhecimentos de tecnologias, conceitos e ferramentas consolidados

• Jakarta Persistence API (JPA)
• Arquitetura MVC
• Testes automatizados de unidade com Junit
• Testes automatizados de integração com Junit e H2
• Bean Validation
• Validações server-side e client-side
• Manipulação e tratamento de exceções
• Tratamento de resposta ao cliente
• Serialização e desserialização
• Requisições em formato Json
• Expressões Regulares
• Anotações personalizadas
• Padrão de design DTO
• Padrão de projeto Builder
• Paginação
• Criptografia de senhas com Bcrypt

Tecnologias utilizadas

• Java 17
• Maven
• Jakarta Servlet
• Jakarta Validation
• JPA / Hibernate
• MySQL / H2 (test)
• Bcrypt
• Junit Jupiter
• Mockito
• Gson
• Lombok
• Expressões Regulares
• JSP
• CSS
• JavaScript (Front-end)

Principais Melhorias

• Reestruturação de pacotes.
• Gerenciamento de dependências com Maven.
• Relacionamento entre objetos.
• Persistência com banco de dados relacional com JPA.
• Criptografia de senha.
• Validação de entradas server-side com Bean Validation.
• Testes automatizados de unidade e integração.
• Padrões de design: services, repositories e DTOs.
• Paginação de consultas.
• Migração da biblioteca javax-servlet para jakarta-servlet.
• Validação de formulários client-side.
• Estilização com CSS.
• Páginas dinâmicas com JS.
• Modularização do front-end.

Novas funções

• Criar Usuario.
• Criar Empresa.
• Listar somente Empresa do Usuario.
• Listar somente Empresa ativa ou somente arquivada.
• Editar Empresa de forma dinâmica.
• Arquivar Empresa de forma dinâmica.
• Pesquisar por registros Empresa.

---

Login

• Antes de enviar o formulário para o servidor é verificado se os campos atendem às regras mínimas dos campos.

---

Cadastro de Usuario

• Sempre que o formulário é submetido, é disparada uma requisição AJAX que verifica se o login digitado já existe.

---

Lista Empresas do Usuario

• Os objetos Empresa possuem relacionamento com Usuario.
• O Usuario só pode editar e arquivar empresas relacionadas consigo.
• As remoções são exclusões lógicas, definidas pelo atributo ativo.
• Os botões arquivar/desarquivar quando clicados enviam uma requisição assíncrona para o servidor que altera o atributo ativo da Empresa no banco de dados. Se a requisição for bem-sucedida, o elemento clicado será removido da view.

---

Lista Empresas

• Somente empresas com ativo == true serão listadas.

---

Pesquisa Empresas

• Caso nenhum registro seja encontrado, irá aparecer uma mensagem de erro como resultado da pesquisa.
• Somente empresas com atributo ativo == true serão recuperadas.

Tratamento das entradas nos formulários server-side

• Mesmo que o usuário consiga inserir entradas que estão em desacordo com as regras dos campos, são feitas validações com Bean Validation do lado do servidor.

Considerações finais

Consigo ver diversas melhorias que posso fazer, mas pretendo apenas melhorar o que já está pronto. Este projeto está finalizado e não irei mais implementar coisas novas nele, farei apenas refatorações.

Pontos fracos

• Segurança: merecia mais atenção, ficou de lado nesse projeto, mas o foco era entregar código back e front funcionando.

• CSS: a escrita está complexa e acoplada, visivelmente um novato.

• JS: apesar de bem completo, e de ter sido uma escolha usar ele puro, a falta de libs/framework gerou uma complexidade desnecessária no código, tornando a manutenção amendrontadora. Também acredito que dava para desacoplar mais as funções e separar melhor as responsabilidades por arquivos.

• Simplicidade: o CRUD ficou muito simples, merecia mais funções e uma maior complexidade da entidade Empresa, seria onde o R do CRUD seria bem aplicado, apesar de ele existe sim na aplicação. Mas o foco estava mesmo em entregar código funcional, trazer diversos dados pra essa entidade não iria mudar muita coisa.

• Responsividade: como eu estava iniciando, dispensei a responsividade para não aumentar a complexidade.

• Separação de responsabilidades: O controller EmpresaController com a responsabilidade de receber requisições json e requisições de apresentação me incomoda, pois apesar de fazer o trabalho de um controller, ele está lidando com tipos diferentes de trabalho, indo contra o S dos princípios SOLID.

• Ordenação: esqueci.

Destaque

• Completude: é um projeto bem completo, não ficou limitado a demonstrar uma única coisa. Nele você vai encontrar: implementação de persistência com JPA; arquitetura mvc com services e repositories; CRUD completo; criptografia de senha; validações server-side com Bean Validation e client-side com JS; anotações personalizadas; expressões regulares; DTOs e wrappers com Records; paginação end-to-end; tratamento de erros; desserialização de objeto Java para Json; classes Util para abstração de código repetitivo; testes automatizados de unidade e integração; tratamento de respostas ao cliente; requisições assíncronas com JS; JSP; HTML; CSS; JS manipulando o DOM; modularização do front; interface dinâmica.

  Em vez de um micro-projeto abordando uma simulação de um caso de teste, um caso de validação, um caso de arquitetura e etc, aqui temos uma aplicação completa, funcional e com diversos conceitos implementados na prática.