Instruções

Crie uma base de dados MongoDB que será acessada pela aplicação

Depois de baixar/clonar o respositório, entre no diretório raiz e digite

npm install

para instalar os pacotes JavaScript utilizados na aplicação.

Dentro do diretório raiz, crie o arquivo .env e adicione o seguinte conteúdo

PORT=5000
DB_CONNECTION=mongodb+srv://....mongodb.net:...

O valor da variável DB_CONNECTION deve ser a URL que dá acesso à sua base de dados.

Paginação

Utilizado o plugin mongoose-paginate. Exemplo de paginação correta na rota GET/categories:

http://localhost:5000/categories?perPage=5&page=2

Por padrão, os parametros foram definidos como perPage=10 e page=1.

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

mickaelcampos / backend-challenge