/doctor-lookup

A website where users may enter a medical issue (ie: “sore throat”, "rash", etc.) into a form, submit it, and receive a list of doctors in Portland who can treat their medical issue.

Primary LanguageJavaScript

Doctor Lookup

An application that utilizes the BetterDoctor API to provide information about available doctors in Portland, OR who treat numerous medical needs. , Feb 2020

By Benjamin Thom

Description

Users can enter a medical issue (ie: “sore throat”, "rash", etc.) or name into our form, submit it, and receive a list of doctors in Portland, OR who match the treatment or name specified.

Preview

Landing Page Preview

Project Specifications

Behavior Input Output
A user enters a medical issue and receives a list of doctors in the Portland area that fit the search query sore throat Doctors who provide treatment for "sore throat" in Portland, OR
A user enters a name to receive a list of doctors in the Portland area that fit the search query Bill Doctors whose names include "Bill" in Portland, OR
If the query response includes any doctors, the following information is included about each doctor: first name, last name, address, phone number, website and whether or not the doctor is accepting new patients NA first name, last name, address, phone number, website, and doctor is accepting new patients: true or false
If the API call results in an error, the application will return a notification to the user stating what the error is NA "There was an error handling your request"
If the query response doesn't include any doctors (for instance, if no doctors meet the search criteria), the application will return a notification that states that no doctors meet the criteria user input "No doctors found based on your search"

Setup/Installation Requirements

In Terminal:

  • Navigate to where you want this application to be saved, i.e.: cd desktop
  • Clone the file from GitHub with HTTPS git clone https://github.com/benjamin-thompdx/doctor-lookup.git
  • Open file in your preferred text editor
  • On Mac: open -a {your text editor} doctor-lookup
  • On Windows: doctor-lookup

Download Manually:

  • Navigate to https://github.com/benjamin-thompdx/doctor-lookup.
  • Click the green "Clone or Download" button.
  • Click "Download ZIP".
  • Click downloaded file to unzip.
  • Open folder called "doctor-lookup".
  • Right-click "index.html" and select your preferred browser or text editor.

Note For Editors:

  • Once cloned/downloaded, to run and make changes, in the terminal simply run $ npm install to download necessary dependencies
  • Run $ npm run build to create your dist folder with a bundle.js file
  • Obtain API key from https://developer.betterdoctor.com/
  • Create .env file in the root directory of doctor-lookup
  • Add the API key to .env file (API_KEY: input your API key here)
  • IMPORTANT Add .env file to .gitignore file
  • The API key will now be referenced within the doctor-service.js file
  • Lastly, run $ npm run start to run the application

Known Bugs

No known bugs at this time.

Support and contact details

Have a bug or an issue with this application? Open a new issue here on GitHub.

Technologies Used

  • HTML
  • CSS
  • Bootstrap
  • Javascript
  • jQuery
  • Webpack
  • Node.js
  • BetterDoctor API

License

MIT

Copyright (c) 2020 Benjamin Thom