pesky/tb-health-check repository overview

⁠ToughBlue IT Health Check

Web application for ToughBlue Uganda’s IT Health Check programme: capture on-site assessment answers, generate scored client reports, and print engineer questionnaires.

Built with Python 3.12, Flask, and Gunicorn. Assessment data is stored in SQLite on a persistent volume.

⁠What it does

• Tabbed questionnaire with triage-based sections (core + optional)
• Draft saving, preview reports, and final completion workflow
• Scored reports: domain charts, benchmarks, findings, and recommendations
• Printable client questionnaire (/print)
• Health endpoint for monitoring (/health)

⁠Image tags

⁠Quick start (Docker run)

docker run -d \
  --name tb-health-check \
  -p 8095:8080 \
  -e SECRET_KEY="replace-with-a-long-random-string" \
  -e FLASK_ENV=production \
  -v tb-healthcheck-data:/app/data \
  --restart unless-stopped \
  pesky/tb-health-check:stage

Open http://localhost:8095⁠

Check health:

curl http://localhost:8095/health

⁠Recommended: Docker Compose

Clone the GitLab repo and use the production compose file:

git clone ssh://[email protected]:2424/tb-owners/it-health-check.git
cd it-health-check
cp .env.example .env
# Edit .env: SECRET_KEY, HEALTHCHECK_TAG (stage or lts)

docker compose -f docker-compose.prod.yml pull
docker compose -f docker-compose.prod.yml up -d

⁠Environment variables

⁠Ports

⁠Data persistence

Mount /app/data to keep SQLite assessments across container restarts:

-v tb-healthcheck-data:/app/data

⁠Source & support

• GitLab: https://gitlab.toughblue.com/tb-owners/it-health-check⁠
• Maintainer: ToughBlue Uganda Ltd. · https://ug.toughblue.com⁠