Fratres blood reminders

A web application to remind people that they can do a new donation after a time frame.

This has been developed inside my local FRATRES group to help the reminding process of the donors.

This is my first django / python application, please be gently.

Current features

Admin panel with user/password authentication screenshot
Support import from Fratres SIF software CSV of donors (Informazioni Associati -> Soci and Cessati) and donations (Informazioni Donatori -> Donazioni)
Donor management (personal data, contact information, blood type) screenshot 1 screenshot 2 screenshot 3
Donations management
Reminders management (not really sending any reminder) screenshot
Public charts page with Chart.js screenshot

Roadmap

Sending personal reminders via SMS
Sending personal reminders via WhatsApp
Sending reminders automatically based on a schedule
Sending reminders based on current blood availability (https://web2.e.toscana.it/crs/meteo/)

Usage (docker-composer)

Configure the following environment variables in a .env file:

SECRET_KEY=kahlaiwoopeex2ooQuoTei2ch
DB_NAME=reminders
DB_USER=reminders
DB_PASS=to6oc9Ahl6oogei
DB_HOST=db
DB_PORT=5432
DB_PATH=./pgdata
ADMIN_PASSWORD=changeme
ADMIN_USERNAME=admin
ADMIN_EMAIL=[email protected]

Build and run with docker-composer:

docker-compose up --build

Access admin panel at localhost:8000/admin

Default credentials:

username: admin
password: changeme

Docker environment variables reference

SECRET_KEY: generate one here
ADMIN_USERNAME: the username of the first created superadmin user (default: admin)
ADMIN_PASSWORD: the password of the first created superadmin user (default: changeme)
ADMIN_EMAIL: the email of the first created superadmin user (default: [email protected])
DB_*: configures postgres container
DONATIONS_PROJECTION: in the charts page, used by the first chart to draw a line as a target donation for every mounth (comma separated integers)
DONATIONS_EXPECTED: in the charts page, used by the second chart for the target amount of yearly donations for the current year.
APP_LOG_LEVEL: configure default logging level (defaults to INFO)

Development