Economic App

Api para uma aplicação de gerenciamento de gastos.

• Arquitetura em camadas
• Ports and Adapters
• Injeção de dependências
• Testes
• CI/CD

Features

• criar uma conta - fazer o registro de forma padrão com email e senha
• criar um gasto - registrar um gasto
• desativar uma conta
• deletar um gasto
• buscar gastos - buscar todos os gastos de um usuário
• atualizar conta - atualizar dados da conta, exceto a senha
• atualizar gasto - atualizar dados de um gasto
• gerar relatório de gastos - gerar relatório de gastos para um intervalo de tempo
• cadastro com o GitHub - cadastro com o github
• tratamento de disponibilidade com workers, graceful shutdown e verificando processos não tratados

TODO

• Implementação do domain
• Adicionar camada http para os domain services
• Login Authentication
• GitHub Authentication
• Postman documentation: https://documenter.getpostman.com/view/25046256/2sA3kUFMWH
• Error handler

Stack

• Node
• TypeScript
• Postgres
• Docker

Como usar

1. Clone o repositório
2. Instale as dependências

npm install

3. Inicie o container Docker com o banco de dados

docker-compose up -d

4. Crie o arqui de env. Para ambiente de desenvolvimento o arquivo deve ser o ".env.dev"

5. Inicie a aplicação com

npm run dev

Obs: é nescessario utilizar o Node 22.X >

Como atualizar/modificar

Para realizar alterações no banco de dados, é preciso fazer as alterações no arquivo "schema.prisma". Após isso, criar a migration com o comando

npm run migrate:dev

E aplicar a migration no banco de dadosc com o seguinte comando

npm run migrate:apply

Obs: Também é possível utilziar o prisma studio utilizando o comando

npm run prismastudio:dev

Os comandos foram criados de forma personalizada para poder pegar as variavéis de ambiente do arquivo ".env.dev"