This project is a prototype version of a Medical Provider Marketplace where people can find a doctor or other healthcare provider to book an appointment with. Users are able to search the marketplace for providers, see a list of all medical providers, and select a provider to book an appointment with. Inspired on a similar concept called Zocdoc.
Click here for the live demo.
- Clone repository
cd
into the cloned folder- Create a virtual environment (
python -m venv env
) - Activate the virtual environment (
source env/bin/activate
) - Install requirements (
pip install -r requirements
) - Create an
.env
file to store important credentials:
SECRET_KEY=your-secret-key-here
DEBUG=True
- Make migrations
python manage.py makemigrations api
python manage.py migrate
- Create app superuser (
python manage.py createsuperuser
) - Start server (
python manage.py runserver
)
Alternatively, you can start the server with Heroku CLI using the command heroku local
, but make sure to run python manage.py collectstatic
first!
Installation of psycopg2
might be cumbersome if built from source. You might want to check out this post. Alternatively, you might want to simply install the binary itself (already included in requirements.txt
as psycopg2-binary
).
If you would like to set it up with a custom PostgreSQL database, you'd have to make changes in .env
, setting the DB_USER
, DB_NAME
, DB_PASSWORD
, DB_HOST
and DB_PORT
variables. Make sure to create the appropriate PostgreSQL roles with login permissions.
Additionally, if you plan on hosting it, set HOST_URL
to the host URL (i.e. https://www.example-backend.com).
Finally, if you plan on using a frontend with it, set FRONTEND_APP_URL
to the actual origin (i.e. https://www.example-frontend.com).
If used in production, remember to set DEBUG
to False
.
The build and maintenance progress is being documented here, for anyone interested.
This project was bootstrapped with Django Admin.