Skip to content

danielboso/backend-challenge

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 

Repository files navigation

Desafio backend

Você deve desenvolver uma API HTTP para registro e obtenção de categorias.

As categorias formam uma árvore, onde cada categoria aponta para seu pai.

Exemplo:

- Moda
  - Feminino
    - Roupas
  - Masculino
    - Roupas
- Informática
  - Notebooks
  - Tablets

Esse é o esquema de uma categoria:

Nome do atributo Tipo Comentário
id number Identificador único da categoria
name string Nome da categoria
childrenIds Array<number> Lista de ids dos filhos da categoria. É uma lista vazia se a categoria é folha (não tem filhos)

POST /categories

A rota POST /categories deve receber uma única categoria e registrá-la. Segue um exemplo de requisições criando a árvore "Moda":

1. Cria a categoria de roupas masculinas

Requisição:
POST /categories
{
  "id": 300,
  "name": "Roupas",
  "childrenIds": []
}
Resposta:
{
  "ok": true
}

2. Cria a categoria de roupas femininas

POST /categories
{
  "id": 301,
  "name": "Roupas",
  "childrenIds": []
}

Resposta:
{
  "ok": true
}

3. Cria a categoria de moda masculina

Requisição:
POST /categories
{
  "id": 200,
  "name": "Masculina",
  "childrenIds": [300],
}

Resposta:
{
  "ok": true
}

4. Cria a categoria de moda feminina

Requisição:
POST /categories
{
  "id": 201,
  "name": "Feminina",
  "childrenIds": [301]
}

Resposta:
{
  "ok": true
}

5. Cria a categoria de moda

Requisição:
POST /categories
{
  "id": 100,
  "name": "Moda",
  "childrenIds": [200, 201]
}

Resposta:
{
  "ok": true
}

GET /categories

A rota GET/categories deve retornar uma lista com todas as categorias registradas. Exemplo:

Requisição:
GET /categories/1

Resposta:
[
  {
    "id": 1,
    "name": "Moda", 
    "childrenIds": [200, 201]
  },
  {
    "id": 201,
    "name": "Feminina",
    "childrenIds": [301]
  },
  ...
]

GET /categories/:id

A rota GET /categories/:id deve retornar os dados da categoria com o id passado. Exemplo:

Requisição:
GET /categories/1

Resposta:
{
  "id": 1,
  "name": "Moda", 
  "childrenIds": [200, 201]
}

Observação importante

Note que ao criar a árvore das categorias de moda, nós criamos as categorias em reverso (começando nas categorias mais internas). Se uma categoria for criada com ids de filhos que não existem, o backend deveria apontar um erro. No exemplo a seguir, as categorias 202 e 203 não existem e a resposta aponta o erro:

Requisição:
POST /categories
{
  "id": 2,
  "name": "Categoria exemplo",
  "childrenIds": [200, 201, 202, 203]
}

Resposta:
{
  "ok": false,
  "error": "InvalidCategories"
}

Requisitos

Os requisitos são:

  • Implementar todas as rotas descritas acima;
  • Tratar todos os erros de validação dos dados;
  • Implementar persistência;

Requisitos adicionais

Esses requisitos não são obrigatórios:

  • Suportar paginação no GET /categories;

Como começo?

Aqui vão as etapas:

  • Faça um fork desse repositório;
  • Crie uma Pull Request com sua fork

Tecnologias

Você pode utilizar qualquer linguagem/framework para desenvolver o servidor. Aqui vão algumas sugestões:

  • Node.js (Express, Koa, etc)
  • Ruby (Rails, Sinatra, etc.)
  • Python (Django, Flask, etc.)
  • Scala (Play, http4s, Scalatra, etc.)
  • qualquer outra linguagem :)

Requisitos para avaliação

  • Bom uso do git (commits concisos, boas mensagens de commit, etc)
  • Boas práticas de programação (nomes de variáveis, tamanho de funções, perfomance)
  • Código bem organizado e com uma boa arquitetura
  • Uso de bibliotecas para auxiliar o desenvolvimento

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published