NodeJs Bagy Server

Arquitetura

A arquitetura do projeto segue alguns principios do DDD, no qual os arquivos são organizados por dominio da aplicação. Eu busquei desacoplar a camada de infra da camada de domínio para possibilitar uma maior flexibilidade em relação as dependecias de infra do projeto.

Responsabilidades

Tipo	Pasta	Responsabilidade
Resolver	module/(name_module)/schemas	Mutations e Queries do graphql
Repository	modules/(name_module)/infra/typeorm/repository	Manipulação do banco com o o typeorm
Interface Repository	modules/(name_module)/repository	Cria um interface dos repositorios para comunicação com os servers.
Entity	modules/(name_module)/entities	Modelos da reporesentação das entidades no banco de dados
Services	modules/(name_module)/services	Executa um bound de ações com regras de negócios especificas. ex.: Registar Compra
Types Input	modules/(name_module)/schemas/types-input	Define um DTO para envio de dados para uma Mutation no graphql
Fake	modules/(name_module)/**/fakes	Define classes fakes para execucão de testes

SOLID

Busquei atender alguns principios do SOLID como Principio da Responsabilidade Única e o Princípio da Substituição de Liskov na dependecia dos services com os repositorios.

Executando o projeto

Docker

git clone https://github.com/lucascco/bagy-server.git

cd bagy-server

Este comando pode demorar um tempo docker build -t lucascco/bagy-server .

docker run -p 4000:8080 -d lucascco/bagy-server

Agora é só acessar http://localhost:4000/graphql do seu navegador.

Sem Docker

git clone https://github.com/lucascco/bagy-server.git

cd bagy-server

yarn or npm install

yarn dev:server or npm dev:server

Agora é só acessar http://localhost:8080/graphql do seu navegador.

Data base

O banco de dados ja vem pre populado com dois usuarios de testes e alguns produtos.

Mutation - Create Customer

mutation createCustomer {
  createCustomer(
    customer: {
      name: "User Test 2",
      email: "user_test_2@gmail.com",
      cpf: "678676876",
      dtBirth: "1991-02-11",
    },
    address: {
      street: "Rua Necessio dos Santos"
      neighborhood: "SJB"
      city: "Belo Horizonte"
			state: "MG"
      country: "BR"
      number: "110"
      cep: "31515040"
    }
  ) { name id }
}

Mutation - Create Product

mutation createProduct {
  createProduct(
    product: {
      name: "Notebook Mac 13",
      image: "path_image",
      description: "Notebook da Apple de 13 polegdas",
      weight: 3,
      price: 8000,
      qttStock: 10
    }
  ) { name, qttStock, price }
}

Mutation - Create Order

testEmailUrl: é o link para o email de teste no https://ethereal.email/

mutation {
  createOrder(order:{
    idCustomer: 1,
    installment: 2,
    listProducts: [
      {
        id: 1,
        qtt: 1
      }
    ]
  }) {
    testEmailUrl
    order {
      id
      dtOrder
      installment
      customer {
        name
      }
      status
    }
    products { id name qttStock}
  }
}

Exemplo de resposta

{
  "data": {
    "createOrder": {
      "testEmailUrl": "https://ethereal.email/message/XxcQDYg3UQaGbOu0XxcQEQWftlH5NRHQAAAAAa.K5zuJeAuH8GgnnSaJAec",
      "order": {
        "id": "1",
        "dtOrder": "2020-07-21 12:55:56",
        "installment": 2,
        "customer": {
          "name": "User Test 1"
        },
        "status": "approved"
      },
      "products": [
        {
          "id": "1",
          "name": "Notebook Mac 13",
          "qttStock": 9
        }
      ]
    }
  }
}

Querys

Get all Clientes

{
  allCostumers {
		id
    name
    orders {
      id
      dtOrder
      status
    }
  }
}

Get all Produtos

{
  allProducts {
    id name price qttStock
  }
}

Testes Unitários

Foquei os testes unitários no service de Order, pois concentra o core da aplicação, com a responsabilidade de registrar uma compra para um usuário e enivar um email.

Para executar os testes

yarn test