catho / teste-apps

Repositório com o teste técnico para processo seletivo de desenvolvimento de apps

Teste para desenvolvedores mobile Catho

Este é o teste técnico para processo seletivo para trabalhar com desenvolvimento de apps mobile na Catho.

Desafio

Desenvolver uma tela de aplicativo seguindo o layout proposto como referência e uma api mockada para carregar os dados.

Layout

O seu aplicativo deve seguir o layout abaixo como referência.

Assets

Os assets estão disponíveis na pasta /api/assets/. Você pode utilizar ele dentro do aplicativo ou carregá-las utilizando o host da api http://localhost:4040/assets

---

Premissas

Importante: escolha uma linguagem conforme a vaga que está participando no processo.

• Para desenvolvedores Android: utilizar Kotlin, Java ou Flutter
• Para desenvolvedores IOS: utilizar Swift ou Flutter

O que será avaliado

• Organização e clareza de código
• Componentização
• Manutenabilidade
• Controle de qualidade
• Controle de versão
• Controle de release
• Performance
• Fidelidade ao layout
• Experiência de usuário

Melhorias

Realize o teste com os recursos disponíveis, porém anote e nos envie quaisquer sugestão de melhoria que julgar adequadas e por que deveríamos implementá-las.

Como aplicar

Você deve criar um repositório privado no GitHub.com e adicionar o usuário testecatho como colaborador do projeto. Ao finalizar o teste, por favor, envie-nos o link do repositório pelo e-mail [e-mail]. Você utilizará esse projeto apenas para rodar as apis.

Boa Sorte!

---

API

Abaixo, seguem os recursos e como executar a api que retornará os dados para a construção da tela.

Roteiro

1. Carregue as chaves de autenticação das apis (/keys);
2. Como não teremos uma tela de login, escolha um dos ids disponíveis no método /auth;
3. Agora você tem todos os dados de que necessita para implementar os demais recursos. A ordem dos requests fica a seu critério.

Features

1. Usuário visualiza a foto cadastrada. Para essa feature você deve usar o recurso /auth.
2. Usuário pode interagir com slider com sugestão de vagas (sugestão de até 5 vagas): caso opte por se aplicar a uma delas, o texto do botão muda para “CV enviado”. Para essa feature você deve usar o recurso /suggestion.
3. Usuário visualiza uma dica oferecida pela Catho. Para essa feature você deve usa o recurso /tips.
4. Usuário pode interagir com a dica, mencionando se ela foi útil ou não. Para essa feature você deve usar o recurso /survey.

Pré requisitos

• Docker ou NodeJs

Executando a api

Para rodar a api, execute uma das opções abaixo:

• Usando docker:

./scripts/mock-server-docker.sh

• Usando NodeJs:

./scripts/mock-server-local.sh

Recursos

Keys

curl --location --request GET 'localhost:4040/keys'

Response:

{
  "auth": "$authkey",
  "tips": "$tipskey",
  "suggestion": "$suggestionkey",
  "survey": "$surveykey"
}

propriedade	tipo	descrição
api name	sha512	chave de autorização para a api

Importante: Enviar a chave correspondente em todos os demais requests. Não enviar a chave ou enviar a chave errada causará um retorno com status 401.

---

Auth

curl --location --request GET 'http://localhost:4040/auth/$userId' \
--header 'x-api-key: $apiKey'

Headers:

header	tipo	descrição
x-api-key	string	chave de autenticação da api retornada pelo /keys

ids disponíveis
ee09bd39-4ca2-47ac-9c5e-9c57ba5a26dc
cc3431c3-d9c9-48e2-8a1f-c3c0260f0712

Response:

{
  "id": "ee09bd39-4ca2-47ac-9c5e-9c57ba5a26dc",
  "name": "Leticia da Silva",
  "token": "IltvYmplY3QgT2JqZWN0XSAi.eyJzdWIiOiJlZTA5YmQzOS00Y2EyLTQ3YWMtOWM1ZS05YzU3YmE1YTI2ZGMiLCJuYW1lIjoiTGV0aWNpYSBkYSBTaWx2YSIsImlhdCI6MTUxNjIzOTAyMn0.Dk_R9gr5RHJtl3FYjQFa7dgQySrL78d887Jk9WVdfIA",
  "photo": "/assets/ee09bd39-4ca2-47ac-9c5e-9c57ba5a26dc.jpg"
}

propriedade	tipo	descrição
id	uuid	id único de referência ao usuário
name	string	nome do usuário
token	string	token jwt de sessão do usuário
photo	string	path da foto do usuário

---

Suggestion

curl --location --request GET 'http://localhost:4040/suggestion' \
--header 'Authorization: $userToken' \
--header 'x-api-key: $apiKey'

Headers:

header	tipo	descrição
Authorization	string	token de acesso do usuário recuperado pelo /auth
x-api-key	string	chave de autenticação da api retornada pelo /keys

Response:

[
  {
    "jobAdTile": "Desenvolvedor Mobile - Android",
    "company": "CATHO",
    "date": "Hoje",
    "totalPositions": 1,
    "locations": [
      "Barueri (SP)"
    ],
    "salary": {
      "real": "",
      "range": "A Combinar"
    }
  }
]

Headers:

header	tipo	descrição
jobAdTitle	string	titulo da vaga
company	string	nome da empresa
date	string	data formatada
totalPositions	number	número de vagas no anúncio
locations	array	lista de localidades que as vagas atendem
salary	object
salary.real	string	salário real. Quando preenchido exibir o real
salary.range	string	faixa salarial da vaga. Somente exibido quando não existe salarial real preenchido

---

Tips

curl --location --request GET 'http://localhost:4040/tips' \
--header 'x-api-key: $apiKey'

Headers:

header	tipo	descrição
x-api-key	string	chave de autenticação da api retornada pelo /keys

Response:

[
  {
    "id": "ea9ff33d-16db-42e8-9913-3fb52f3cb992",
    "description": "Antes de enviar o seu currículo, que tal checar a última vez que você o atualizou? Uma informação a mais pode ser o ponta-pé que falta rumo à sua próxima entrevista de emprego.",
    "button": {
      "show": true,
      "label": "checar curriculo",
      "url": "https://www.catho.com.br"
    }
  }
]

propriedade	tipo	descrição
id	uuid	id único da dica
description	string	conteúdo da dica
button	object
button.show	boolean	informa se o botão deve ser exibido ou não
button.label	string	label do botão
button.url	string	url que deve ser carregada ao clicar no botão

---

Survey

curl --location --request POST 'http://localhost:4040/survey/tips/$tipId/$action' \
--header 'Authorization: $userToken' \
--header 'x-api-key: $apiKey'

Headers:

header	tipo	descrição
Authorization	string	token de acesso do usuário recuperado pelo /auth
x-api-key	string	chave de autenticação da api retornada pelo /keys

actions disponiveis
like
dislike

Response:

{
  "id": "70fe9fd8-1ff8-4eec-8735-ed6ccb85c782",
  "created-at": "2020-07-03T16:34:48.4848-03:00",
  "tipId": "ea9ff33d-16db-42e8-9913-3fb52f3cb992",
  "action": "like",
  "message": "Answer was registered"
}

propriedade	tipo	descrição
id	uuid	id único da resposta enviada
created-at	string	timestamp do envio da resposta
tipId	uuid	id único da dica para qual foi respondido
action	string	resposta enviada
message	string	descrição do status da request