/PoweredByRamen

Primary LanguageHTMLMIT LicenseMIT

Team Name:

PoweredByRamen

Team Members:

  • Shiho You - 志保
  • Siyuan Chen - 斯源

About:

Django project to recreate Hawaii Department of Health's EAL Surfer form (originally in Excel format) as a web application for the HACC event. Resource materials provided by DoH: https://github.com/HACC17/challenges/tree/master/DOH_HEER

Prerequisites:

  • Basic command line knowledge
  • Python (v 2.7.x, might need some tweaking in the code if you're planning to use v 3.6.x)
  • Pip (v 9.0.1) or easy_install (v 36.4.0)
  • Sqlite3 (v 3.16.0 or equivalent)
  • Pdfkit (v 0.6.1)
  • Wkhtmltopdf (v 0.12.4)
  • Django (v 1.11.5)
  • (Optional) virtualenv (v 15.1.0)

Note: for some reason the "wkhtmltopdf" package doesn't install correctly, so you will need to install it from their official website, https://wkhtmltopdf.org/downloads.html, and add the executable to your environment path or copy the executable somewhere your system is able to find

How to run:

Optional -- create a virtualenv project (assuming you had installed it via pip) with command

virtualenv <projectName>
cd <projectName>
source  <projectName>/bin/activate
  1. Clone/Download project to desired folder
  2. Go into the cloned/downloaded project folder and Install required packages with command
pip -r requirements.txt
  1. Navigate into "EAL_Surfer" directory via cmd prompt/*NIX shell
  2. Run command
python manage.py runserver
  1. Open web browser and enter url: "http://127.0.0.1:8000/" (left it as default)
  2. Enjoy

Optional:

  1. There's an admin page for administrator to add/update/delete data from the back-end Sqlite DB
  2. Before that create a superuser for the app via. command
python manage.py createsuperuser
  1. Access the administrative page by going to "http://127.0.0.1:8000/admin"
  2. This page will prompt for username and password created in step 2
  3. Now you have admin access to the back-end DB