amosrodrigues/api-digital-cash

Boa vindas ao Projeto DG.CASH! 🚀

Tecnologias   |   Projeto   |   Instruções   |   Contato

---

✨ Tecnologias ✅

Esse projeto foi desenvolvido com as seguintes tecnologias:

Frontend

• NextJS
• TypeScript
• Stitches
• Radix-ui

Backend

• NodeJS
• Express
• TypeORM
• TypeScript
• PostgreSQL

---

💻 Projeto ✅

A aplicação é um app para gerenciar transações financeiras de uma carteira digital, que contém as seguintes funcionalidades:

• Realizar cadastro de usuário/conta com saldo inicial de R$ 100,00;

• Fazer login e autenticação para acesso e realizações de trasações;

• Visualizar o saldo atual;

• Listar transações realizadas por data e/ou creditadas, debitadas e todas;

• Fazer logof;

Sobre o desenvolvimento (conceitos e fundamentos):

Frontend

• Utilização do ContextApi para gerencimento de estado;

• React-hook-form para criação e validação de fomulário;

• Imutabilidade do estado

• Cookies para armazenamento do token obtido na autenticação.

• Componentização

• Hooks

• Estilização dos componentes utilizando a lib Stitches.

• Criação de componentes acessíveis (modal, tabs) com a lib Radix-ui.

Backend

• Utilização de token com JWT (jsonwebtoken) para autenticação de acesso ás rotas http;

• Arquitetura seguindo os princípios SOLID, API REST e REST-FULL;

• Utilização da extesão ESLint no vscode para padronização de ecrita do código.

---

🚀 Instruções ✅

Para instalação

1. Descompacte o arquivo zip e acesse o diretório ngcash-test.

2. Utilizando o Docker e Docker-compose previamente instalados execute o senguite comando:

   • docker-compose up ou docker-compose up -d para sair do terminal interativo após concluir.

3. Após a conclusão da etapa anterior acesse a interface inserindo a url http://localhost:3000 em seu navegar.

4. Para rodar os projetos individualmente:

Frontend

• Entre no diretório web e execute yarn && yarn dev ou npm install && npm run dev para instalar as dependências.

• Após a conclusão da etapa anterior acesse a interface inserindo a url http://localhost:3000 em seu navegar.

Backend

• Entre no diretório server.

• Será necessário subir um container com a imagem do postgres ou ter o postgres instalado.

• Execute o comando docker para subir um container do postgres e o comando para rodar o app:

  • docker run --name ngcash -e POSTGRES_USER=docker -e POSTGRES_DB=dgcash -e POSTGRES_PASSWORD=dgcash -e TZ=America/Sao_Paulo -p 5432:5432 -d postgres

  • Altere o arquivo contido no diretório src/database/index.ts na linha 10 substitua [database] para [localhost].

  • yarn && yarn dev ou npm install && npm run dev

5. Após as etapas anteriores poderá retornar a interface realizar seu cadastro e fazer login: 🎲

---

📞 Contato ✅

👋🏻 Espero que tenha curtido! 💜 💚