Skip to content

About

Chawts, is a Django-based web application designed to centralize health tracking for children, making it easier for users to monitor and share health data.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

332 Commits

Folders and files

Repository files navigation

README

Python Version Django Version FontAwesome Version Charts.js Version Pillow Version ReportLab Version

Contents

About

Our Chawts App is a Django-based web application designed to centralize health tracking for children, making it easier for users to monitor and share health data.

Features

User Registration & Child Profiles :

  • Parents or carers can sign up as a User, to start using the app, or view the app as a guest with example data
  • Users can either create a new child or import an existing child using a private, single use, share code.

Health Data Tracking :

  • Users can log and track a child's growth, food intake, sleep and medication.
  • User can view Data graphically on each tracking page via graphs, and view summary info on the dashboard

Profiles And Permissions :

  • Users can edit their own profile and edit a child's details (Including customizable profile picture)

Data Export & Sharing :

  • All logged data can be exported as a PDF for easy printing and sharing with a health practitioner or other caregivers

Security :

  • Authentication
    • Users Login and Registration handled with Secure authentication system
    • Passwords are hashed using SHA256, never stored as plaintext
  • Role-Based Access Control (RBAC)
    • Only Primary guardians of a child had edit permissions of a child
    • Only Primary guardians of a child can view the secret share code of a child
    • Only Primary guardians of a child can export a PDF with the share code of a child
    • Admin users can manage users and data as needed
  • Share code system
    • Share code is only randomly generated
    • Share code regenerated use preventing multiple use of the same code
    • 62¹⁰ unique codes (839 quadrillion), making guessing infeasible
  • CSRF & SQL injection prevention
    • CSRF tokens used, preventing Cross-Site Request Forgery (CSRF) attacks. See implementation report for more info.
    • Data stored using Django's secure ORM preventing SQL injection

Prerequisites

Before doing anything, you'll need to make sure you have both Python and Git available.

  1. Check Python

    python --version

    If not installed, download from : https://www.python.org/downloads/

  2. Git

    git --version

    If not installed, download from : https://git-scm.com/downloads

Usage

If you have installed the app before, you can start it quickly, If you haven't installed it yet, skip to the Installation Guide below.

  1. Navigate to the project directory

    cd 24-25_CE201-col_team02
  2. Run the startup script

    .\startup.ps1

Installation

Automatic Installation (Windows with Powershell)

  1. Clone the repository

    git clone https://cseegit.essex.ac.uk/24-25-ce201-col/24-25_CE201-col_team02
    cd 24-25_CE201-col_team02
  2. Run the powershell setup script:

    .\setup.ps1

Manual Installation

  1. Clone the repository locally

    git clone https://cseegit.essex.ac.uk/24-25-ce201-col/24-25_CE201-col_team02
    cd 24-25_CE201-col_team02
  2. Set up a Virtual Environment

    # Windows
    python -m venv venv
    venv\Scripts\activate
    
    # MacOS
    python3 -m venv venv
    source venv/bin/activate
  3. Install dependencies

    pip install -r requirements.txt
  4. Run database migrations

    # Use relevant python version for you system
    python manage.py migrate
  5. (Optional) Create an admin user

    python manage.py createsuperuser
  6. Run the development server

    python manage.py runserver
  7. (Optional) Load example data

    python manage.py loaddata fixtures\example_data.json

About

Chawts, is a Django-based web application designed to centralize health tracking for children, making it easier for users to monitor and share health data.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages