API - Sistema de Controle de Gastos Residenciais

Desenvolvimento de uma API de suporte para um sistema que permite que pessoas possam gerenciar suas transações monetárias.

Onde encontrar o Aplicativo

Clique aqui para abrir o repositório do aplicativo deste projeto. Leia o README do aplicativo para compreender seu funcionamento.

Funcionalidades (Aplicação C#)

• Cadastro de pessoas (Inserção, deleção e listagem.);

• Cadastro de transações (Inserção e listagem.);

• Consulta/Listagem de gastos totais separados por tipos (Total de despesas, total de receitas e saldo total.).

Consulta de Totais de Gastos

A API retornará um JSON contendo a listagem de todas as pessoas e seus gastos. Gastos calculados:

• Total de despesas de cada pessoa;

• Total de receitas de cada pessoa;

• Saldo total de cada pessoa (Receitas - despesas.).

Estrutura - Banco de Dados

• Tabela Pessoa: id, nome e idade;

• Tabela Transacao: id, descricao, valor, tipo e id da pessoa (Criador da transação.).

Como Rodar o Banco de Dados da API

• Abra algum SGBD (MySQL Workbench, SQLyog, etc.) e execute o arquivo "DDL.sql", localizado na pasta "Database";

• Se necessário, altere os parâmetros de conexão com o banco de dados localizados no arquivo "Config.php", dentro da pasta "Api".

Como Executar a API

• Abra, através de um terminal, a pasta "Api" do projeto, como especificado abaixo:

cd\

cd "Caminho, desde a raíz, até a pasta do repositório."/Api

• Execute o seguinte comando no terminal, após o passo anterior:

php -S 0.0.0.0:8000

O host especificado acima permite que o PHP aceite requisições de hosts de outros dispositivos além do da máquina onde está rodando. Como o emulador android é considerado um host separado da máquina que o executa, essa configuração é obrigatória.

Para que o ambiente esteja pronto para uso, o terminal deve exibir uma saída parecida com essa:

Development Server (http://0.0.0.0:8000) started

Tenha em mente que para o funcionamento correto, é preciso possuir o PHP instalado na máquina e ter o caminho até seu executável declarado no PATH das variáveis de ambiente do sistema operacional. A API não funcionará se for executada em uma pasta que não seja a especificada anteriormente.

Tutoriais - PHP (Fonte: Tiago A. Silva)

• Instalação: Clique aqui;

• Visual Studio Code: Clique aqui;

• Configuração: Clique aqui.