Requisitos Funcionais - acnscoelho/ppp-gestao-gastos-domesticos-api GitHub Wiki
📝 Contexto
Os Requisitos Funcionais foram definidos com base na análise da estrutura da API de Gestão de Gastos Domésticos. O sistema foi desenvolvido para permitir que usuários gerenciem suas finanças pessoais de forma organizada.
🎯 Requisitos Identificados
| ID | Requisito Funcional | Descrição | Prioridade |
|---|---|---|---|
| RF01 | Gerenciamento de Usuários | O sistema deve permitir o cadastro, autenticação, visualização, atualização e exclusão de usuários. Cada usuário deve ter acesso protegido aos seus dados através de autenticação JWT. | 🔴 Alta |
| RF02 | Gerenciamento de Despesas Fixas | O sistema deve permitir criar, listar, visualizar, atualizar e excluir despesas fixas. Cada despesa deve ter nome, valor, status (Pendente/OK/Pago), valor pago e valor restante. | 🔴 Alta |
| RF03 | Gerenciamento de Despesas Variáveis | O sistema deve permitir criar, listar, visualizar, atualizar e excluir despesas variáveis. Cada despesa deve ter nome, valor, status (Pendente/OK/Pago), valor pago e valor restante. | 🔴 Alta |
| RF04 | Gerenciamento de Receitas | O sistema deve permitir que usuários autenticados criem, visualizem, atualizem e excluam suas receitas. Cada usuário pode ter apenas uma receita, que controla valor atual, valor anterior, valor usado e valor disponível. | 🔴 Alta |
| RF05 | Processamento de Pagamentos | O sistema deve permitir o registro de pagamentos para despesas (fixas ou variáveis). O pagamento deve deduzir o valor da receita disponível do usuário e atualizar o status da despesa automaticamente. | 🔴 Alta |
| RF06 | Consulta de Pagamentos | O sistema deve permitir consultar pagamentos por usuário, por despesa, por período ou visualizar todos os pagamentos. Deve também permitir excluir pagamentos. | 🟡 Média |
| RF07 | Dashboard e Relatórios Financeiros | O sistema deve fornecer um dashboard visual e relatórios em JSON com resumo financeiro completo, incluindo totais de despesas fixas, variáveis, receitas, pagamentos realizados e situação financeira final. | 🟡 Média |