APP DE DELIVERY

Esta é uma aplicação Full-Stack que gerência pedidos e entregas de bebidas, desenvolvida por meu grupo e eu, durante o curso de Desenvolvimento Web Full-Stack da Trybe.

---

Front-End

Desenvolvido com a biblioteca React.js.

O que foi utilizado

• React, ContextAPI;
• CSS3, Slick Carousel;
• React-Router-Dom, Axios;

Video Apresentação

apresentacao_app_delivery.mp4

---

Back-End

Desenvolvido em Node.js, utilizando Express com Sequelize.

O que foi utilizado

• Node.js, Express, Sequelize;
• Md5, JsonWebToken, Cors;
• Mysql2;
• Mocha, Chai, Chai-http, Sinon.

Funcionalidades

• Login;
• Registro de novos usuários;
• Relatório de usuários vendedores;
• Registro de novos pedidos;
• Relatório de uma venda/compra especifica.
• Relatório de vendas/compras realizadas;
• Alteração de status da compra/venda;
• Relatório de produtos disponiveis.

Sainda mais sobre os Endpoints!

Endpoints

POST /login :

• Responsável pelo login de usuários cadastrados.

  Entrada:

  "body": {
    "email": "string",
    "password": "string",
  }

  Saida:

  {
    "id": "number",
    "name": "string",
    "email": "string",
    "role": "string",
    "token": "token jwt"
  }

POST /register :

• Responsável por registrar novos usuários, realizando a validação das informações. A senha é codificada usando md5, antes de salavr no banco de dados.

  Entrada:

  "body": {
    "name": "string",
    "email": "string",
    "password": "string",
    "role": "string",
  }

  Saida:

  {
    "name": "string",
    "email": "string",
    "role": "string",
    "token": "token jwt",
  }

POST /admin/register :

• Similar a user/register, porém o cadastro é ralizado por uma pessoa admin.

  Entrada:

  "headers": {
    "authorization": "token jwt valido"
  },
  "body": {
    "name": "string",
    "email": "string",
    "password": "string",
    "role": "string",
  }

  Saida:

  {
    "name": "string",
    "email": "string",
    "role": "string",
    "token": "token jwt",
  }

GET /sellers :

• Retorna todas as pessoas usuárias cadastradas como vendedoras.

  Saida:

  {
    "id": "number",
    "name": "string",
  }

POST /sales :

• Rsponsavel por registrar novas vendas.

  Entrada:

    "headers": {
      "authorization": "token jwt valido"
    },
    "body": {
      "name": "string",
      "sellerId": "number",
      "totalPrice": "decimal",
      "deliveryAddress": "string",
      "deliveryNumber": "string",
      "products": ["Array de produtos"],
    }

  Saida:

  {
    "newOrderId": "number",
  }

GET /sales?id :

• Retorna uma lista das compras referentes ao id pessoa usuária.

  Entrada:

    "query": {
      "id": "string"
    }

  Saida:

  ["Lista de objetos, cada objeto é uma compra"]

GET /sales/:id :

• Retorna a venda referente ao id informado.

  Entrada:

    "params": {
      "id": "string"
    }

  Saida:

    {
      "userID": "number",
      "sellerId": "number",
      "totalPrice": "decimal",
      "deliveryAddress": "string",
      "deliveryNumber": "string",
      "saleDate": "date",
      "status": "string",
      "seller": "informações do vendedor",
      "users": "informações do comprador",
      "products": ["Array de produtos"],
    }

GET /seller/orders :

• Retorna as vendas referentes a um vendedor especifico:

  Entrada:

    "headers": {
      "authorization": "token jwt valido"
    },

  Saida:

  ["Lista de objetos, cada objeto é uma venda"]

PATCH /sales/:id :

• Responsável por alterar o status de um pedido

  Entrada:

    "params": {
      "id": "string",
    },
    "body": {
      "status": "novo status",
    }

  Saida:

    {
      "status": "novo status",
    }

GET /products e GET /customer/products :

• Retorna uma todos os produtos registrados no banco.

  Saida:

  [
    ...,
    {
      "id": "number",
      "name": "string",
      "price": "decimal",
      "urlImage": "string",
    },
    ...,
  ]

---

Banco de Dados

O banco de dados utilizado foi o MySQL, um banco relacional, estruturado da seguinte forma:

Saiba mais sobre as Tabelas!

Tabelas

• users:
  • Armazena os dados das pessoas usuárias, tanto compradores quanto vendedores.
• sales:
  • Armazena as informações referentes as vendas, quem comprou, quem vendeu, onde foi entregue, a data da compra e o valor total.
• sales_products:
  • Tabela intermediária para a relação N:N entre vendas e produtos, também armazena a quantidade vendida do produto.
• products:
  • Armazena as informações referentes aos produtos, como nome, preço e sua imagem.

---