Rebase Labs

Uma app web para listagem de exames médicos.

Índice

• Tech Stack
• Dependências
• Funcionalidades
• Prints da App
• Rodando a aplicação
• Testes (RSpec)
• Queries
• Bash
• API
  • GET /tests
  • GET /test/:token
  • POST /import
• Desligando a Aplicação

Tech Stack

🐋 Docker
💎 Ruby
🎩 Sinatra
🐘 PostgreSQL
🔎 RSpec
🥋 Sidekiq
🟥 Redis

Dependências

Funcionalidades

• Leitura de arquivo CSV de exames médicos e inserção no banco de dados
• Exibição de listagem de exames médicos numa aplicação front-end
• Pesquisa de exames médicos a partir de um token
• Recebimento de arquivo CSV via aplicação front-end, sendo processado de forma assíncrona e eventualmente adicionado ao banco de dados

Prints da App

Rodando a aplicação

Execute o seguinte comando na pasta raiz do projeto para rodar a aplicação via Docker:

make up

A aplicação front-end (exams-app) estará rodando em http://localhost:4000/, equanto a back-end API (exams-server) estará rodando em http://localhost:3000/

Caso queira rodar a aplicação liberando o mesmo terminal para executar outros comandos, execute:

make up-terminal

para popular o banco de dados com uma lista de exames, execute:

make import

Testes (RSpec)

Para rodar os testes, execute o comando a seguir com os containers da aplicação rodando:

make test

Os testes também podem rodar individualmente para o server (make test-server) e para a app front-end (make test-app)

Queries

Para fazer queries diretamente no Banco de Dados, execute o comando a seguir com a aplicação rodando:

make sql

Bash

Para abrir o terminal (bash) dentro dos containers server e app, respectivamente, execute os comandos:

make server-bash

make app-bash

API

O back-end da aplicação é o service chamado server no docker-compose.yml, que tem o container_name de exams-server. Com a aplicação rodando, o server disponibiliza três endpoints:

GET /tests

Retorna um JSON com todos os exames resultantes de uma Query no banco de dados, como no exemplo:

[
  {
    "result_token": "IQCZ17",
    "result_date": "2021-08-05",
    "cpf": "048.973.170-88",
    "name": "Emilly Batista Neto",
    "email": "[email protected]",
    "birthday": "2001-03-11",
    "doctor": {
      "crm": "B000BJ20J4",
      "crm_state": "PI",
      "name": "Maria Luiza Pires"
    },
    "tests": [
      {
        "type": "hemácias",
        "limits": "45-52",
        "result": "97"
      },
      {
        "type": "leucócitos",
        "limits": "9-61",
        "result": "89"
      }
    ]
  },
  {
    "result_token": "0W9I67",
    "result_date": "2021-07-09",
    "cpf": "048.108.026-04",
    "name": "Juliana dos Reis Filho",
    "email": "[email protected]",
    "birthday": "1995-07-03",
    "doctor": {
      "crm": "B0002IQM66",
      "crm_state": "SC",
      "name": "Maria Helena Ramalho"
    },
    "tests": [
      {
        "type": "plaquetas",
        "limits": "11-93",
        "result": "18"
      },
      {
        "type": "glicemia",
        "limits": "25-83",
        "result": "6"
      }
    ]
  }
]

GET /tests/:token

A partir de um params[:token], retorna um JSON com o exame que tem seu token rastreado a partir uma Query no banco de dados, como no exemplo:

GET /tests/2VPICQ

[
  {
    "result_token": "2VPICQ",
    "result_date": "2021-04-23",
    "cpf": "077.411.587-40",
    "name": "Ígor Moura",
    "email": "[email protected]",
    "birthday": "1991-02-27",
    "doctor": {
      "crm": "B000BJ20J4",
      "crm_state": "PI",
      "name": "Maria Luiza Pires"
    },
    "tests": [
      {
        "type": "hemácias",
        "limits": "45-52",
        "result": "81"
      },
      {
        "type": "leucócitos",
        "limits": "9-61",
        "result": "61"
      },
      {
        "type": "plaquetas",
        "limits": "11-93",
        "result": "77"
      }
    ]
  }
]

POST /import

A partir de um arquivo CSV recebido como params[:file], executa uma operação lógica em que, caso o CSV seja um arquivo válido, executa um ImportJob para enfileiramento (enqueue) da importação dos dados, que são eventualmente gravados no banco de dados.

As respostas podem ser:

  response.status = 200
  response.body = { success: true }

ou:

  response.status = 400
  response.body = { success: false, error: 'Descrição do erro' }

Desligando a aplicação

Para derrubar os containers da aplicação, execute o comando na pasta raiz do projeto:

make down

Para apagar todos os containers e volumes do projeto na sua máquina, execute:

make clean