Módulo 5 - Folha de Pagamento & Retenções (payroll)

Módulo 5: Folha de Pagamento & Retenções (payroll)

O módulo Payroll automatiza o fechamento financeiro quinzenal ou mensal das funcionárias de limpeza, aplicando bonificações de pontualidade e retenção de fundos de emergência (Cash Reserve).

---

💵 1. Componentes do Pagamento da Funcionária

O valor líquido repassado a uma funcionária em cada período de pagamento é calculado como:

$$\text{Repasse Líquido} = \text{Total de Horas Trabalhadas} \times \text{Taxa/Hora} + \text{Bônus} - \text{Retenção de Reserva}$$

• Bônus de Avaliação 5 Estrelas: Bonificação automática quando o cliente deixa avaliação máxima.
• Bônus de Pontualidade: Aplicado quando 100% dos check-ins GPS foram realizados no horário correto.
• Cash Reserve (Reserva de Caixa): Retenção percentual temporária para cobrir eventuais avarias acidentais em imóveis. O saldo fica visível para a funcionária e é liberado periodicamente.

---

🛠️ 2. Arquivos Principais do Módulo

• Serviço de Períodos: src/features/payroll/services/PayrollPeriodService.ts
• Liquidação da Folha: src/features/payroll/services/PayrollSettlementLogic.ts
• Zustand Store: src/stores/payrollStore.ts
• Painel de Pagamentos: src/pages/Payroll.tsx