Stone Wallet

Possível solução para o Desafio do Cartão de Multi-Crédito para a vaga de backend developer na Stone Pagamentos.

Sobre o projeto

Essa api foi criada utilizando as seguintes tecnologias:

Microsoft ASP.NET Core 2.0
Padrão Mediator com a bibilioteca MediatR
Validação de comandos (fail-fast) via middleware usando a biblioteca Fluent Validation
Log com a biblioteca Log4Net
Visualização dos logs da aplicação no PaperTrail
Autenticação de usuário baseada em token JWT Json Web Token
Banco de dados SQL com Heroku Postgres
Documentação da API gerada com o Swagger

Pontos de melhoria

Remover lançamento de exceptions do dominio e substituir por Domain Notifications.

Como rodar esse projeto em seu computador

Primeiramente será necessário instalar o .Net Core 2.0 SDK, em seguida use os seguintes comandos no terminal para clonar e executar o projeto:

git clone https://github.com/wellingtonjhn/backend-test-stone-wallet
cd stone-wallet\StoneWallet\StoneWallet.Api\
dotnet build
dotnet run

Neste momento, serão exibidas as configurações de inicialização no terminal, bem como o endereço e porta em que a aplicação está rodando. Basta copiar a url e acessar seus endpoints conforme exemplos abaixo, respeitando sempre a porta em que a aplicação está rodando.

Você também pode abrir o arquivo de Solution diretamente no Visual Studio, marcar o projet o StoneWallet.Api.csproj como default e pressionar a tecla F5 para executar a aplicação.

Documentação

Esse projeto conta com uma documentação dos endpoints da API feita através do Swagger. Após rodar a aplicação basta acessar a url "http://localhost:{port}/docs/", onde {port} deverá ser substituído pela porta em que a aplicação está rodando em seu computador.

Endpoints da API

Os exemplos abaixo utilizam a ferramenta de linha de comando CURL, mas você também pode utilizar o Postman para realizar as chamadas na api. Neste caso, basta importar para o Postman o arquivo Stone Wallet.postman_collection.json que está na raiz do repositório.

Registrar um novo usuário

curl -X POST http://localhost:51177/api/accounts/register \
  -H 'content-type: application/json' \
  -d '{
	"name" : "Wellington Nascimento",
	"email" : "wellington@email.com",
	"password" : "pass"
}'

Autenticar usuário

curl -X POST http://localhost:51177/api/accounts/login \
  -H 'content-type: application/json' \
  -d '{
	"email" : "wellington@email.com",
	"password" : "pass"
}'

Consultar informações do usuário (requer usuário logado)

curl -X GET http://localhost:51177/api/accounts/profile \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9 ...'

Alterar a senha do usuário logado (requer usuário logado)

curl -X PUT http://localhost:51177/api/accounts/profile/password \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9 ...' \
  -H 'content-type: application/json' \
  -d '{	"newPassword" : "new pass",	"newPasswordConfirmation" : "new pass" }'

Consultar informações da Wallet (requer usuário logado)

curl -X GET http://localhost:51177/api/wallets \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9 ...'

Adicionar Cartão de Crédito (requer usuário logado)

curl -X POST http://localhost:51177/api/wallets/creditcards \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9 ...' \
  -H 'content-type: application/json' \
  -d '{
	"number" : 1234567890987654,
	"dueDate" : "2017-10-15",
	"expirationDate" : "2022-03-12",
	"printedName" : "Wellington Nascimento",
	"cvv" : 567,
	"creditLimit" : 1500
}'

Alterar limite da Wallet (requer usuário logado)

curl -X PUT http://localhost:51177/api/wallets/limit \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9 ...' \
  -H 'content-type: application/json' \
  -d '{ "limit" : 1000 }'

Remover Cartão de Crédito (requer usuário logado)

curl -X DELETE http://localhost:51177/api/wallets/creditcards \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9 ...' \
  -H 'content-type: application/json' \
  -d '{ "creditCardId" : "77898ef0-152c-473d-aed2-0269ec910363" }'

Realizar uma Comprar através da Wallet (requer usuário logado)

curl -X POST http://localhost:51177/api/wallets/purchase \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9 ...' \
  -H 'content-type: application/json' \
  -d '{ "amount": 800 }'

Pagar um Cartão de Crédito (requer usuário logado)

curl -X POST \
  http://localhost:51177/api/wallets/creditcards/payment \
  -H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9 ...' \
  -H 'content-type: application/json' \
  -d '{	"cardId" : "379d2521-bffa-4941-8669-4f18f0e63777", "amount" : 500 }'