DESAFIO TÉCNICO: JUNTOS SOMOS +

Desafio feito para o code-challenge da Juntos Somos +.

Descrição

A aplicação JSMClientsRegistries foi desenvolvida para armazenar os pacotes de dados enviados e também permite a busca por clientes elegíveis.

Contempla:

Upload de arquivos JSON e CSV para a database em SQLite.
Busca paginada por lista de clientes de acordo com região e tipo informados.

Endpoint

    GET/api/Client/ElegibleList

É necessário informar:

região (norte, nordeste, sul, sudeste ou centro-oeste);
tipo (normal, special ou laborious);
quantidade de resultados que deseja por página;
número da página que deseja acessar.

Upload de Arquivos

Upload de dados automático para o banco de dados (SQLite) ao executar a API, sendo gerada a database JSMClientsRegistries.db.

É necessário escolher o método em JSMClientsRegistries.Infra > Migrations > 20221014170337_Inputs.cs para definir se o upload será feito do arquivo CSV ou do JSON, bastando comentar o método que não for utilizado:

var clientList = DeserializeClientListCsv();
//var clientList = DeserializeClientListJson();

Os arquivos devem ser colocados na pasta JSMClientsRegistries.Files e possuir o nome input-backend.json ou input-backend.csv. Se necessário, basta alterar o nome ou caminho em JSMClientsRegistries.Infra > Migrations > 20221014170337_Inputs.cs.

Desabilitar upload automático

Para desabilitar o upload automático, basta ir em JSMClientsRegistries.API > Startup.cs e comentar o comando:

//context.Database.Migrate();

Regras de Negócio

Clientes classificados de acordo com as cinco regiões do país na saída de dados (identificado pelo estado).
Clientes rotulados como special, normal ou laborious de acordo com coordenadas informadas.
Adaptação dos contatos telefônicos para o formato E.164.
Nacionalidade padrão: BR.
Gênero formatado para um único caracter, f ou m.
Campo age removido.
Estrutura formatada conforme Output abaixo (retirado do code-challenge):

{
  "type": "laborious"
  "gender": "m",
  "name": {
    "title": "mr",
    "first": "quirilo",
    "last": "nascimento"
  },
  "location": {
    "region": "sul"
    "street": "680 rua treze ",
    "city": "varginha",
    "state": "paraná",
    "postcode": 37260,
    "coordinates": {
      "latitude": "-46.9519",
      "longitude": "-57.4496"
    },
    "timezone": {
      "offset": "+8:00",
      "description": "Beijing, Perth, Singapore, Hong Kong"
    }
  },
  "email": "quirilo.nascimento@example.com",
  "birthday": "1979-01-22T03:35:31Z",
  "registered": "2005-07-01T13:52:48Z",
  "telephoneNumbers": [
    "+556629637520"
  ],
  "mobileNumbers": [
    "+553270684089"
  ],
  "picture": {
    "large": "https://randomuser.me/api/portraits/men/83.jpg",
    "medium": "https://randomuser.me/api/portraits/med/men/83.jpg",
    "thumbnail": "https://randomuser.me/api/portraits/thumb/men/83.jpg"
  },
  "nationality": "BR"
}

Ferramentas

ASP.NET Core 5.0
SQLite
Entity Framework Core
AutoMapper
Swagger

iW90 / juntossomosmais-codechallenge