Sistema de Gestão Financeira Residencial

Este projeto consiste em um sistema de gestão financeira residencial desenvolvido com ASP.NET no back-end e React + Vite no front-end. O sistema permite gerenciar pessoas e transações, além de gerar relatórios de totais (receitas, despesas e saldos) por pessoa e geral.

Tecnologias Utilizadas

Back-end:

• ASP.NET Core (Target Framework: .NET 9.0)
• C#
• Microsoft.AspNetCore.OpenApi

Front-end:

• React 18
• Vite
• React Router Dom
• CSS personalizado

Estrutura do Projeto

O repositório contém dois projetos principais:

back:

Responsável pela API REST que gerencia pessoas e transações, além dos endpoints de relatório.

Endpoints principais:

• GET /pessoas/listar
• POST /pessoas/cadastrar
• DELETE /pessoas/{id}
• POST /transacao/cadastrar
• GET /transacao/listar
• DELETE /transacao/{id}
• GET /relatorio/ListarTotais

front:

Interface web desenvolvida com React que consome a API do back-end.

• Possui páginas/rotas para cadastro e listagem de pessoas, cadastro e listagem de transações e para visualização de relatórios.
• Utiliza o Vite para desenvolvimento e hot-module reloading.

Pré-requisitos

• .NET 9.0 SDK
• Node.js (LTS)
• npm

Configuração do Ambiente

Back-end

1. Navegue até o diretório back:
2. Restaure as dependências (se necessário):

   dotnet restore

3. Execute a aplicação:

   dotnet run

   A API estará disponível em http://localhost:5175 (conforme configurado no arquivo launchSettings.json).

Observação: O back-end possui configuração de CORS para permitir requisições de qualquer origem.

Front-end

1. Navegue até o diretório front:
2. Instale as dependências:

   npm install

3. Inicie o servidor de desenvolvimento:

   npm run dev

   A aplicação será iniciada (normalmente em http://localhost:5173).

Funcionalidades

Cadastro e Listagem de Pessoas:

• Utilize as páginas de cadastro e listagem para registrar novas pessoas ou deletar pessoas cadastradas.

Cadastro e Listagem de Transações:

• Cadastro de transações com validação (por exemplo, menores de idade só podem registrar despesas) e listagem com possibilidade de exclusão.

Relatórios:

• Exibição dos totais de receitas, despesas e saldo por pessoa, além do saldo geral.

Uso

1. Acesse a interface web pelo navegador através da URL do front-end (ex.: http://localhost:5173).
2. Navegue pelo menu para acessar as diferentes funcionalidades:
   • Home: Página inicial com informações do sistema.
   • Pessoas: Páginas para listar e cadastrar pessoas.
   • Transações: Páginas para listar e cadastrar transações.
   • Relatórios: Página para visualizar as estatísticas financeiras.

Teste dos Endpoints

Você pode utilizar ferramentas como Postman ou Insomnia para testar os endpoints da API.

Exemplo de JSON para testar o endpoint de cadastro de transação:

{
  "valor": 150.0,
  "descricao": "Compra de materiais",
  "tipo": "despesa",
  "pessoa": {
    "id": 1
  }
}

Certifique-se de que a pessoa com o id utilizado existe, e observe as restrições de negócio definidas (ex.: apenas despesas são permitidas para menores de idade).