Giter Club home page Giter Club logo

currency-convert-api's Introduction

Conversor de moedas

NodeJS TypeScript Mongodb Jest Express.js NPM Docker ESLint

Instruções do projeto

API foi desenvolvida utilizando uma arquitetura bem definida e tentando deixar ao máximo desacoplada, utilizando TDD como metodologia de trabalho e seguindo um pouco as boas práticas do Clean Architecture para fazer a distribuição das responsabilidades em camadas, e sempre que possível utilizando os princípios do SOLID.

Tecnologias utilizadas

A utilização das tecnologias foi pensada a fim de facilitar o desenvolvimento, tais como: NodeJS e Typescript como stack principal, Express para roteamento das rotas e subir o servidor, Axios para chamadas a endpoits externos, Mongodb para a persistência dos dados, Husky, Eslint, Prettier, Linter-staged para configuração de linter, Jest para rodar os teste de unidade e integração, e Shelf/jest-mongodb para facilitar os teste de integração com o banco mocado em memória, Docker para facilitar o desenvolvimento e deploy.

Alguns patterns utilizados

  • Composite
  • Adapter
  • Factory
  • Dependency Injection
  • Single Responsibility

Instruções para rodar o projeto

Os requisitos necessários são:

  • Node >= 16
  • npm >= 8
  • Mongodb > 4
  • docker >= 20
  • docker-compose >= 1.29

Faça o clone do projeto e rode o comando npm install para instalar as dependências.

npm install

Configurar as variáveis de ambiente criando um arquivo .env na raiz do projeto, e seguindo o exemplo do arquivo .env.example.

Rodar Docker

Subir o container pra rodas as aplicações

docker-composer up

ou

npm run docker:up

Startar ambiente de desenvolvimento

Subir o servidor de desenvolvimento atravéz do comando npm run dev

npm run dev

Build

npm run build

Startar o ambiente de produções

npm start

Testes

Rodar todos os testes

npm test

Rodar testes de unidade

npm run test:unit

Rodar testes covarage

Cobertura de teste

npm run test:ci

Principais funcionalidades

  • Conversão de moedas
  • Listar transações por usuários

Endpoints da aplicação

Rota de conversão de moedas

[POST] /convert

Request body

{
	"userId": string,
	"originCurrency": string,
	"originAmount": number,
	"destinationCurrency": string
}

Responses

Generic badge

{
	"trasactionId": string,
	"userId": string,
	"originCurrency": string,
	"originAmount": number,
	"destinationCurrency": string,
	"destinationValue": number,
	"currencyTax": number,
	"timeConvert": string
}

Generic badge

{
    "error": "string"
}

Rota de transações por usuários

[GET] /transactions/${userId}

Request params

{
	"userId": string,
}

Responses

Generic badge

[
	{
		"userId": string,
		"originCurrency": string,
		"originAmount": number,
		"destinationCurrency": string,
		"currencyTax": number,
		"timeConvert": string
	}
]

Generic badge

{
    "error": "string"
}

currency-convert-api's People

Contributors

juniorpaula avatar

Watchers

 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.