O TFC é um site informativo sobre partidas e classificações de futebol.

• Sobre o projeto
  • Contexto
  • Habilidades
  • Demo
• Tecnologias utilizadas
  • Front-end
  • Back-end
  • Banco de dados
• Uso
  • Documentação da API
    • Visão Geral
    • Exemplos
  • Banco de Dados
    • Diagrama ER
    • Seeders
    • Exemplo de um arquivo .env
• Instalação
  • Docker
  • Rodando testes
• Requisitos do projeto
• Status de desenvolvimento
• Desenvolvedora
• Agradecimentos

O desafio deste projeto foi desenvolver uma API (utilizando o método TDD) e integrar, através do docker-compose, as aplicações para que elas funcionem consumindo um banco de dados relacional.

Minha responsabilidade foi construir o back-end dockerizado (dockerfile do back e front) utilizando modelagem de dados através do Sequelize. E aplicar os conceitos de Programação Orientada a Objeto (POO) e os princípios SOLID.

O desenvolvimento teve que respeitar as regras de negócio para que a API seja consumida adequadamente pelo front-end disponibilizado, que exibe as informações tabeladas para a pessoa usuária do sistema.

Para algumas rotas, como adicionar uma partida, é necessário ter um token, portanto a pessoa usuária deverá estar logada para fazer as alterações, para tanto foi utilizado JWT para autenticação.

• Dockerização dos apps, network, volume e compose;
• Modelagem de dados com MySQL através do Sequelize;
• Criação e associação de tabelas usando models do sequelize;
• Construção de uma API REST com endpoints para consumir os models criados;
• Construção de um CRUD com TypeScript, utilizando ORM;
• Autenticação de rotas utilizando JWT.
• Programação Orientada a Objetos e princípios SOLID:
  • Implementar, em TypeScript: Classes, Instâncias, Atributos e Métodos.

Deploy: Em breve

(De volta ao topo)

• Docker

Fornecido pronto pela instituição

• React js

• TypeScript
• Node.js
• Express.js
• Sequelize
• JSON Web Token (JWT)
• Bcrypt.js

  Testes

  • Mocha
  • Chai
  • Sinon

• MySQL

(De volta ao topo)

🔐 : Necessário que o token gerado no login seja enviado no headers como "Authorization".

(De volta ao topo)

Clique nas setas para ver mais

• Método POST

  Exemplo de corpo da requisção válido

  {
    "email": "[email protected]",
    "password": "secret_user", 
  }

  Respostas

  • Status: 200 OK

    {
      "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpZCI6MSwicm9sZSI6ImFkbWluIiwiaWF0IjoxNjU0NTI3MTg5fQ.XS_9AA82iNoiVaASi0NtJpqOQ_gHSHhxrpIdigiT-fc" // jsonwebtoken gerado
    }

  • Status: 400 Bad Request

    { "message": "All fields must be filled" }

  • Status: 401 Unauthorized

    { "message": "Invalid email or password" }

• 🔐 Método GET

  Respostas - Status: 200 OK ```json { "role": "admin" } ```

  • Status: 401 Unauthorized

    { "message": "Token not found" }

    { "message": "Token must be a valid token" }

• Método GET

  Resposta

  • Status: 200 OK

    [
      {
        "id": 1,
        "teamName": "Avaí/Kindermann"
      },
      {
        "id": 2,
        "teamName": "Bahia"
      },
      {
        "id": 3,
        "teamName": "Botafogo"
      },
      ...
    ]

• Método GET

  Resposta

  • Status: 200 OK

    {
      "id": 5,
      "teamName": "Cruzeiro"
    }

• Método GET

  Resposta

  • Status: 200 OK

      [
        {
          "id": 1,
          "homeTeamId": 16,
          "homeTeamGoals": 1,
          "awayTeamId": 8,
          "awayTeamGoals": 1,
          "inProgress": false,
          "homeTeam": {
            "teamName": "São Paulo"
          },
          "awayTeam": {
            "teamName": "Grêmio"
          }
        },
        ...
        {
          "id": 41,
          "homeTeamId": 16,
          "homeTeamGoals": 2,
          "awayTeamId": 9,
          "awayTeamGoals": 0,
          "inProgress": true,
          "homeTeam": {
            "teamName": "São Paulo"
          },
          "awayTeam": {
            "teamName": "Internacional"
          }
        }
      ]

• 🔐 Método POST

  Requisição

  {
    "homeTeamId": 16, // O valor deve ser o id do time
    "awayTeamId": 8, // O valor deve ser o id do time
    "homeTeamGoals": 2,
    "awayTeamGoals": 1,
  }

  Respostas

  • Status: 201 Created

    {
      "id": 1,
      "homeTeamId": 16,
      "homeTeamGoals": 2,
      "awayTeamId": 8,
      "awayTeamGoals": 1,
      "inProgress": true,
    }

  • Status: 401 Unauthorized

    { "message": "Token not found" }

    { "message": "Token must be a valid token" }

  • Status: 404 Not Found

    { "message": "There is no team with such id!" }

  • Status: 422 Unprocessable Entity

    { "message": "It is not possible to create a match with two equal teams" }

• Método GET

  Opções de query: true ou false

  Ex:

  matches?inProgress=true
  

  Resposta

  • Status: 200 OK

    [
      {
        "id": 41,
        "homeTeamId": 16,
        "homeTeamGoals": 2,
        "awayTeamId": 9,
        "awayTeamGoals": 0,
        "inProgress": true,
        "homeTeam": {
          "teamName": "São Paulo"
        },
        "awayTeam": {
          "teamName": "Internacional"
        }
      },
      {
        "id": 42,
        "homeTeamId": 6,
        "homeTeamGoals": 1,
        "awayTeamId": 1,
        "awayTeamGoals": 0,
        "inProgress": true,
        "homeTeam": {
          "teamName": "Ferroviária"
        },
        "awayTeam": {
          "teamName": "Avaí/Kindermann"
        }
      }
    ]

• 🔐 Método PATCH

  Requisição:

  {
    "homeTeamGoals": 3,
    "awayTeamGoals": 1
  }

  Respostas

  • Status: 200 OK

    { "message": "Updated match!" } 

  • Status: 401 Unauthorized

    { "message": "Token not found" }

    { "message": "Token must be a valid token" }

• 🔐 Método PATCH

  Respostas

  • Status: 200 OK

      { "message": "Finished" }

  • Status: 401 Unauthorized

      { "message": "Token not found" }

      { "message": "Token must be a valid token" }

• Método GET

  Resposta

  • Status: 200 OK

    [
      {
        "name": "Palmeiras",
        "totalPoints": 13,
        "totalGames": 5,
        "totalVictories": 4,
        "totalDraws": 1,
        "totalLosses": 0,
        "goalsFavor": 17,
        "goalsOwn": 5,
        "goalsBalance": 12,
        "efficiency": "86.67"
      },
        ...
      {
        "name": "Napoli-SC",
        "totalPoints": 2,
        "totalGames": 6,
        "totalVictories": 0,
        "totalDraws": 2,
        "totalLosses": 4,
        "goalsFavor": 3,
        "goalsOwn": 15,
        "goalsBalance": -12,
        "efficiency": "11.11"
      }
    ]

• Método GET

  Resposta

  • Status: 200 OK

    [
      {
        "name": "Santos",
        "totalPoints": 9,
        "totalGames": 3,
        "totalVictories": 3,
        "totalDraws": 0,
        "totalLosses": 0,
        "goalsFavor": 9,
        "goalsOwn": 3,
        "goalsBalance": 6,
        "efficiency": "100.00"
      },
      ...
      {
        "name": "Bahia",
        "totalPoints": 0,
        "totalGames": 3,
        "totalVictories": 0,
        "totalDraws": 0,
        "totalLosses": 3,
        "goalsFavor": 0,
        "goalsOwn": 4,
        "goalsBalance": -4,
        "efficiency": "0.00"
      }
    ]

• Método GET

  Resposta

  • Status: 200 OK

    [
      {
        "name": "Palmeiras",
        "totalPoints": 6,
        "totalGames": 2,
        "totalVictories": 2,
        "totalDraws": 0,
        "totalLosses": 0,
        "goalsFavor": 7,
        "goalsOwn": 0,
        "goalsBalance": 7,
        "efficiency": "100.00"
      },
        ...
      {
        "name": "Napoli-SC",
        "totalPoints": 0,
        "totalGames": 3,
        "totalVictories": 0,
        "totalDraws": 0,
        "totalLosses": 3,
        "goalsFavor": 1,
        "goalsOwn": 10,
        "goalsBalance": -9,
        "efficiency": "0.00"
      }
    ]

(De volta ao topo)

1. Diagrama ER

2. Seeders

O banco de dados contém:

• tabela users com usuários válidos com hash das senhas e alguns inválidos, estes útimos utilizados para os testes avaliativos.
• tabela teams com a lista de todos os times que estão participando do campeonato.
• tabela matches com algumas partidadas finalizadas e outras em andamento.

3. Exemplo de um arquivo .env

Se estiver utilizar Docker as informações do DB_* vem do docker-compose, caso contrário se utilizar o MySql instalado na sua máquina.

  JWT_SECRET=jwt_secret
  APP_PORT=3001
  DB_USER=seu_user
  DB_PASS=sua_senha
  DB_HOST=localhost
  DB_PORT=3002

(De volta ao topo)

Caso deseje contribuir ou simplesmente rodar o projeto na sua máquina, siga as orientações:

⚠️ Configurações mínimas para execução do projeto

• Preferencialmente Sistema Operacional Distribuição Unix
• Node versão 16
• Docker
• Docker-compose versão >=1.29.2

1. Clone o repositório
   git clone [email protected]:ligiabicalho/Tech-Futebol-Clube.git
2. Navegue até a pasta do repositório clonado
   cd Tech-Futebol-Clube
3. Instale as dependências no diretório raiz
   npm install

1. Na raíz do projeto rode o comando:
   npm run compose:up
2. Em seguida abra o terminal interativo do container:
   docker exec -it app_backend sh
3. Instale as dependências dentro do container:
   npm install

Para rodar os testes de integração desenvolvidos por mim, entre na pasta backend e rode o comando:

• npm test

(De volta ao topo)

Clique na seta para ver a lista de requisitos que recebemos para desenvolver durante o processo avaliativo.

(De volta ao topo)

100% dos requisitos solicitados foram desenvolvidos.

No entanto, podemos pensar em ampliar a API criando rotas para criação e edição do perfil do usuário.

A Trybe e seus instrutures pelos ensinamentos, elaboração do desafio e mentorias técnicas. Aos colegas de turma pelas valiosas discussões, devidamente referenciadas nos comentários do código.

(De volta ao topo)