EstefanyaNascimento / Viver-sem-limites-Reprograma

 Bootcamp - Todas em Tech, turma 14° de Backend.

Projeto Final {Reprograma}💜

Viver sem limites é um projeto - API, que foi desenvolvido para a conclusão do curso de Backend {Reprograma}.

💜O PROJETO FINAL

É uma iniciativa para ajudar pessoas que precisam de muletas, andadores, cadeiras de rodas e equipamentos afins, mas não tem recursos para comprar estes equipamentos, assim esta API vai unir quem tem itens disponíveis para doação com quem está precisando deles no momento.

Desenvolver um aplicativo que conecta quem doa com quem precisa. O aplicativo armazena as informações de quem oferece itens para doar e de quem precisa deles para criar um banco de dados em que seja possível cruzar esses interesses, sem a necessidade de armazenar os itens.

💜Contextualização API - VIVER SEM LIMITES

De acordo com o último censo do IBGE, 46 milhões de brasileiros, cerca de 24% da população, têm algum grau de dificuldade em pelo menos uma das habilidades investigadas (enxergar, ouvir, caminhar ou subir degraus), ou possuir deficiência mental / intelectual. A grande maioria de hospitais e clínicas só tem o modelo convencional de cadeiras de rodas que é destinado para o atendimento de emergência para pessoas com mobilidade reduzida e paraplégicos. Apesar do plano nacional "Viver sem limites" para conseguir uma cadeira motorizada pelo SUS por exemplo pode demorar alguns meses, em alguns casos é preciso recorrer à justiça, o que tornou o processo ainda mais lento.

Pensando nesta demora do SUS, uma ação mais rápida e funcional foi a criação de uma API com o mesmo nome do programa Viver sem limites, onde pessoas com equipamentos para de ficientes e que desejam doar possam fazer isso sem custo. No futuro contato entre doadores e receptores sem muita burocracia.

A construção deste projeto consiste em uma API RESTFull fundamentada no CRUD, integrado com o banco de dados NoSQL, sendo possível listar, cadastrar, atualizar e deletar cadastros dos doadores de equipamentos para deficientes.

• Definição CRUD:

  CREATE (CRIAR)
  READ (LER, CONSULTAR)
  UPDATE (ATUALIZAR) 
  DELETE (DESTRUIÇÃO, REMOÇÃO)
  

💜Link

• Apresentação API - Viver sem limites

💜Funcionalidades

• Incentivar a doação de itens que estejam em bom estado e possa ser usado por outras pessoas com as mesmas condições de deficiência
• Listar todas as pessoas que estão cadastradas no sistema
• Cadastrar itens e doadores
• Atualizar lista de doadores e equipamentos disponíveis
• Deletar os itens já doados que não estão mais disponíveis

💜Tecnologias Utilizadas

Para a construção deste projeto, as seguintes tecnologias foram utilizadas:

💜Bibliotecas Aplicadas

Para a construção deste projeto, as seguintes bibliotecas foram aplicadas:

💜Arquitetura MVC

Arquitetura padrão da API Viver sem limites:

 📁 VIVER SEM LIMITES
   |
   |-  📁 assets
   |    |- 📑 img.png
   |
   |-  📁 src
   |    |
   |    |- 📁 controllers
   |         |- 📑 doador.js
   |
   |    |- 📁 database
   |         |- 📑 Config.js
   |
   |  
   |    |- 📁 models
   |         |- 📑 doadorSchema.js
   |
   |    |- 📁 routes
   |         |- 📑 doadorRouter.js 
   |         |- 📑 index.js
  
   |    |- 📑 app.js

   |- 📑 .env
   |- 📑 .env.example
   |- 📑 .gitignore
   |- 📑 package-lock.json
   |- 📑 package.json
   |- 📑 Procfile
   |- 📑 README.md
   |- 📑 server.js

💜Para rodar o projeto localmente

Faça instalação desta API, siga o passo a passo conforme abaixo:

• No terminal Git Bash, faça o clone da API VIVER SEM LIMITES:

  git clone https://github.com/EstefanyaNascimento/Viver-sem-limites-Reprograma
  

Siga os passos e inclua as informações abaixo:

Passo	Comando/informação
Faça o fork	botão de forkar
Faça o clone	git clone
Instale as dependências	npm i
Crie seu .env e inclua as variáveis e os valores	MONGODB_URL
utilize o script de dev	npm dev

MONGODB_URL = URL do MongoDb Atlas Banco de dados orientado a documentos e interface na nuvem.

💜Portas

Opções de Portas

• Local: http://localhost:5558/ - (rodando localmente)

• Heroku: https://viver-sem-limites-reprograma.herokuapp.com - (consumir API)

• Utilize o Postman ou Insomnia para chamar e testar os endpoints da API localmente ou via Heroku.

💜Rotas

Método HTTP	Tipo Rota	Endpoint	Descrição
GET	Pública	http://localhost:5558/	Mensagem de apresentação (Index)

💜Manipulação das Rotas dos doadores:

Método HTTP	Tipo Rota	Endpoint	Descrição
GET	Pública	/doadores/all	Retorna todo os dados de todos os doadores
POST	Pública	/doadores/create	Cadastra uma novo doador
PUT	Pública	/doadores/update/:id	Altera informações de um doador específico por id
DELET	Pública	/doadores/delete/:id	Remove um doador específico por id

💜 Collections da API que deverá retornar o seguinte JSON:

{
    "message": "Cadastro atualizado com sucesso!",
    "savedPutDoador": {
        "_id": "61bb47149788a1902f3e7355",
        "doador": "Divaneide",
        "idade": "23",
        "equipamento": "Bengalas",
        "bairro": "caxias",
        "cidade": "Ibura",
        "telefone": "3232 - 3250",
        "pessoabeneficiada": " Nao declarada",
        "createdAt": "2021-12-16T14:03:00.264Z",
        "updatedAt": "2021-12-17T14:54:48.114Z",
        "__v": 0
    }
}

💜 Projeto em Construção (Futuras melhorias)

• Integrar com o Maps para calcular a distância do doador e receptor mais próximo.
• Implantação de código HTML e CSS para criação de uma interface capaz de possibilitar a interação do usuário com aplicação;
• Desenvolver rotas para o receptor e doador interagirem e otimizar as doaçãoes e recebimentos.

Toda sugestão de melhoria deste projeto será muito bem-vinda!!!

💜 Referências

Doação de Cadeira de Rodas pelo SUS

Civida conecta pessoas

Universo senior

Inspiração para criação do Readme - Letícia Desidero

Inspiração para criação do Readme - Jenni

💜 Autora

Vamos nos conectar!

Feito com 💜 por Estefanya Alves
------------------------------