O objetivo do projeto é construir um sistema de folha de pagamento. O sistema consiste do gerenciamento de pagamentos dos empregados de uma empresa. Além disso, o sistema deve gerenciar os dados destes empregados, a exemplo os cartões de pontos. Empregados devem receber o salário no momento correto, usando o método que eles preferem, obedecendo várias taxas e impostos deduzidos do salário.
- Alguns empregados são horistas. Eles recebem um salário por hora trabalhada. Eles submetem "cartões de ponto" todo dia para informar o número de horas trabalhadas naquele dia. Se um empregado trabalhar mais do que 8 horas, deve receber 1.5 a taxa normal durante as horas extras. Eles são pagos toda sexta-feira.
- Alguns empregados recebem um salário fixo mensal. São pagos no último dia útil do mês (desconsidere feriados). Tais empregados são chamados "assalariados".
- Alguns empregados assalariados são comissionados e portanto recebem uma comissão, um
percentual das vendas que realizam. Eles submetem resultados de vendas que informam a
data e valor da venda. O percentual de comissão varia de empregado para empregado. Eles
são pagos a cada 2 sextas-feiras; neste momento, devem receber o equivalente de 2 semanas
de salário fixo mais as comissões do período.
- Empregados podem escolher o método de pagamento.
- Podem receber um cheque pelos correios
- Podem receber um cheque em mãos
- Podem pedir depósito em conta bancária
- Alguns empregados pertencem ao sindicato (para simplificar, só há um possível sindicato). O sindicato cobra uma taxa mensal do empregado e essa taxa pode variar entre empregados. A taxa sindical é deduzida do salário. Além do mais, o sindicato pode ocasionalmente cobrar taxas de serviços adicionais a um empregado. Tais taxas de serviço são submetidas pelo sindicato mensalmente e devem ser deduzidas do próximo contracheque do empregado. A identificação do empregado no sindicato não é a mesma da identificação no sistema de folha de pagamento.
- A folha de pagamento é rodada todo dia e deve pagar os empregados cujos salários vencem naquele dia. O sistema receberá a data até a qual o pagamento deve ser feito e calculará o pagamento para cada empregado desde a última vez em que este foi pago.
| Func | Título | Breve descrição |
|---|---|---|
| 1 | Adição de um empregado | Um novo empregado é adicionado ao sistema. Os seguintes atributos são fornecidos: nome, endereço, tipo (hourly, salaried, commissioned) e os atributos associados (salário horário, salário mensal, comissão). Um número de empregado (único) deve ser escolhidoautomaticamente pelo sistema. |
| 2 | Remoção de um empregado | Um empregado é removido do sistema. |
| 3 | Lançar um Cartão de Ponto | O sistema anotará a informação do cartão de ponto e a associará ao empregado correto. |
| 4 | Lançar um Resultado Venda | O sistema anotará a informação do resultado da venda e a associará ao empregado correto. |
| 5 | Lançar uma taxa de serviço | O sistema anotará a informação da taxa de serviço e a associará ao empregado correto. |
| 6 | Alterar detalhes de um empregado | Os seguintes atributos de um empregado podem ser alterados: nome, endereço, tipo (hourly, salaried, commisioned), método de pagamento, se pertence ao sindicato ou não, identificação no sindicato, taxa sindical. |
| 7 | Rodar a folha de pagamento para hoje | O sistema deve achar todos os empregados que devem ser pagos no dia indicado, deve calcular o valor do salário e deve providenciar o pagamento de acordo com o método escolhido pelo empregado |
| 8 | Undo/redo | Qualquer transação associada as funcionalidades 1 a 7 deve ser desfeita (undo) ou refeita (redo). |
| 9 | Agenda de Pagamento | Cada empregado é pago de acordo com uma "agenda de pagamento". Empregados podem selecionar a agenda de pagamento que desejam. Por default, as agendas "semanalmente", "mensalmente" e "bi-semanalmente" são usadas, como explicado na descrição geral. Posteriormente, um empregado pode pedir para ser pago de acordo com qualquer uma dessas agendas. |
| 10 | Criação de Novas Agendas de Pagamento | A direção da empresa pode criar uma nova agenda de pagamento e disponibilizá-la para os empregados escolherem, se assim desejarem. Uma agenda é especificada através de um string. Alguns exemplos mostram as possibilidades: "mensal 1": dia 1 de todo mês ; "mensal $": último dia útil de todo mês; "semanal 1 segunda": toda semana às segundas-feiras; "semanal 2 segunda": a cada 2 semanas às segundas-feiras ; etc. |
-
- Na classe App método Main há repetições na estrutura condicional (switch case) do menu inicial.
- Há a repetição da verificação da lista de empregados (se está vazia).
- Na classe Configs método mudarInfoEmpregado há repetição na estrututra condicional para cada opção que pode ser escolhida.
- Na classe Configs métodos novoEmpregado e mudarInfoEmpregado há a repetição do condicional (switch case) na seleção do tipo de empregado.
- Na classe App método Main há repetições na estrutura condicional (switch case) do menu inicial.
-
- Nas classes App método Main e Configs método mudarInfoEmpregado há a repetição na estrutura condicional (switch case).
- A classe Configs método novoEmpregado é demasiadamente grande, recolhe muitas informações sozinha.
-
- A classe Configs possui muitos métodos.
-
- Muitos construtores, setter e getters de várias classes não são utilizados.
-
- A maioria das classes apenas armazenam dados e possuem getters e setters.
Para esse tipo de solução, o problema apresentado se comporta da seguinte forma: Há uma série de passos que é repetida na mesma ordem, mas com alguma alteração que faz com que não sejam exatamente iguais. Esse padrão de projeto comportamental define o esqueleto de um algoritmo na superclasse mas deixa as subclasses sobrescreverem etapas específicas do algoritmo sem modificar sua estrutura.
- O problema foi solucionado com a implementação da classe Auxiliar, com vários métodos criados para reduzir a quantidade de código duplicado. Métodos empregadoViaTipo, estruturaMudarEmpregadoInfo e estruturaFolhaDePagamento são exemplos.
- Antes
- Depois
- Para tratar as exceptions existentes no código,a classe Entradas, a qual possui métodos para tratar a leitura de Int, String, etcs. Foi atualizada para que os métodos utilizem try/catch.
-
Um bad smell do tipo código duplicado estava presente na classe App método Main, o qual havia repetição na verificação do tamanho da lista, em todos os casos, e sempre que estava vazia, ocorria um break. Para retirar essa repetição, foi colocado um único condicional if antes do switch case.
-
A classe Configs era um bad smell Large Class e foi dividida em duas, sendo criada a classe Auxiliar que conta com implementações novas (templates), e algumas coisas já existentes na antiga classe.
-
O método novoEmpregado, da classe Configs configura um bad smell Long Method, e o mesmo foi refatorado, sendo dividido com a classe Auxiliar e seus métodos.
-
Foi criado o método limparConsole, que pode ser chamado pelo usuário para limpar o console.
-
Alguns métodos setters, getters não estavam sendo usados, o que configurava um bad smell do tipo "speculativy generality", portanto, foram excluídos.