celso-patiri / 15-boardcamp Goto Github PK

CRUD de Categorias [Create|Read]

• GET /categories
• POST /categories
  • Regras de Negócio
    • name não pode estar vazio ⇒ nesse caso, deve retornar status 400
    • name não pode ser um nome de categoria já existente ⇒ nesse caso deve retornar status 409

CRUD de Jogos [Create|Read]

• GET /games
  • Regras de Negócio
    • Caso seja passado um parâmetro name na query string da requisição, os jogos devem ser filtrados para retornar somente os que começam com a string passada (case insensitive). Exemplo:
      • Para a rota /games?name=ba, deve ser retornado uma array somente com os jogos que comecem com "ba", como "Banco Imobiliário", "Batalha Naval", etc
• POST /games
  • Regras de Negócio
    • name não pode estar vazio; stockTotal e pricePerDay devem ser maiores que 0; categoryId deve ser um id de categoria existente; ⇒ nesses casos, deve retornar status 400
    • name não pode ser um nome de jogo já existente ⇒ nesse caso deve retornar status 409

CRUD de Clientes [Create|Read|Update]

• GET /customers

  • Regras de Negócio
    • Caso seja passado um parâmetro cpf na query string da requisição, os clientes devem ser filtrados para retornar somente os com CPF que comecem com a string passada.

• GET /customers/:id

  • Regras de Negócio:
    • Se o cliente com id dado não existir, deve responder com status 404

• POST /customers

  • Regras de negócio
    • cpf deve ser uma string com 11 caracteres numéricos; phone deve ser uma string com 10 ou 11 caracteres numéricos; name não pode ser uma string vazia; birthday deve ser uma data válida; ⇒ nesses casos, deve retornar status 400
    • cpf não pode ser de um cliente já existente; ⇒ nesse caso deve retornar status 409

• PUT /customers/:id

  • Regras de negócio:
    • cpf deve ser uma string com 11 caracteres numéricos; phone deve ser uma string com 10 ou 11 caracteres numéricos; name não pode ser uma string vazia; birthday deve ser uma data válida ⇒ nesses casos, deve retornar status 400
    • cpf não pode ser de um cliente já existente ⇒ nesse caso deve retornar status 409

CRUD de Aluguéis [Create|Read|Update|Delete]

• GET /rentals
  • Response: lista com todos os aluguéis, contendo o customer e o game do aluguel em questão em cada aluguel

    [
      {
        id: 1,
        customerId: 1,
        gameId: 1,
        rentDate: "2021-06-20",
        daysRented: 3,
        returnDate: null, // troca pra uma data quando já devolvido
        originalPrice: 4500,
        delayFee: null,
        customer: {
          id: 1,
          name: "João Alfredo",
        },
        game: {
          id: 1,
          name: "Banco Imobiliário",
          categoryId: 1,
          categoryName: "Estratégia",
        },
      },
    ];

  • Regras de Negócio
    • Caso seja passado um parâmetro customerId na query string da requisição, os aluguéis devem ser filtrados para retornar somente os do cliente solicitado. Exemplo:
      • Para a rota /rentals?customerId=1, deve ser retornado uma array somente com os aluguéis do cliente com id 1
    • Caso seja passado um parâmetro gameId na query string da requisição, os aluguéis devem ser filtrados para retornar somente os do jogo solicitado. Exemplo:
      • Para a rota /rentals?gameId=1, deve ser retornado uma array somente com os aluguéis do jogo com id 1
• POST /rentals
  • Regras de Negócio
    • Ao inserir um aluguel, os campos rentDate e originalPrice devem ser populados automaticamente antes de salvá-lo:
      • rentDate: data atual no momento da inserção
      • originalPrice: daysRented multiplicado pelo preço por dia do jogo no momento da inserção
    • Ao inserir um aluguel, os campos returnDate e delayFee devem sempre começar como null
    • Ao inserir um aluguel, deve verificar se customerId se refere a um cliente existente. Se não, deve responder com status 400
    • Ao inserir um aluguel, deve verificar se gameId se refere a um jogo existente. Se não, deve responder com status 400
    • daysRented deve ser um número maior que 0. Se não, deve responder com status 400
    • Ao inserir um aluguel, deve-se validar que existem jogos disponíveis, ou seja, que não tem alugueis em aberto acima da quantidade de jogos em estoque. Caso contrário, deve retornar status 400
• POST /rentals/:id/return
  • Regras de Negócio
    • Ao retornar um aluguel, o campo returnDate deve ser populado com a data atual do momento do retorno
    • Ao retornar um aluguel, o campo delayFee deve ser automaticamente populado com um valor equivalente ao número de dias de atraso vezes o preço por dia do jogo no momento do retorno.
    • Ao retornar um aluguel, deve verificar se o id do aluguel fornecido existe. Se não, deve responder com status 404
    • Ao retornar um aluguel, deve verificar se o aluguel já não está finalizado. Se estiver, deve responder com status 400
• DELETE /rentals/:id
  • Regras de Negócio
    • Ao excluir um aluguel, deve verificar se o id fornecido existe. Se não, deve responder com status 404
    • Ao excluir um aluguel, deve verificar se o aluguel já não está finalizado (ou seja, returnDate já está preenchido). Se estiver, deve responder com status 400