Track inventory, schedule inspections, scan QR codes, and report incidents — all from a single, role-based dashboard. Keep your organisation safe and compliant.
From inventory tracking to compliance reporting, OuchTracker covers every aspect of first aid kit management.
Create, edit, and organise kits by location. Track every item with name, category, quantity, and expiry date.
Generate printable QR codes for each kit. Scan to instantly access contents, start inspections, or file reports.
Step-through checklist inspections with quantity verification. Full audit trail maintained per kit.
Record items consumed during incidents. Stock is automatically deducted, keeping your inventory always accurate.
Admin and Checker roles with fine-grained permissions. Checkers only see kits assigned to them.
Items flagged as expired or expiring within 30 days with colour-coded alerts on the dashboard.
Install on any device — no app store needed. All kit data is pre-cached on first load. Checkers can inspect kits and file incidents with no connection; submissions queue and sync automatically when back online.
Export a print-ready Bill of Materials PDF for any kit — items grouped by category, colour-coded expiry status, kit QR code, and summary statistics included.
Full English and Greek (Ελληνικά) UI translations. Language preference is saved per user in the database and restored automatically on login.
A streamlined workflow for admins and checkers alike.
Admin creates kits with location info and adds items — manually or via CSV import. Assign checkers to each kit.
Generate and download QR codes for each kit. Stick them on the physical kit for instant on-site access.
Checkers scan the QR code and step through every item, recording quantities and notes. Inspections are logged automatically.
The admin dashboard shows expiry alerts, recent inspections, and incident reports. Everything in one place.
Export a branded Bill of Materials PDF for any kit — complete with QR code and expiry status — and insert it into the physical kit for offline reference.
A battle-tested stack that's easy to deploy and maintain.
Composition API
UI Framework
Backend API
ORM
Database
Containerised
Localisation
Clean, normalised schema designed for auditability and real-time stock tracking.
User ──< KitAssignees >── Kit ──< KitItem
│ │
│ ├──< InspectionLogItem >── InspectionLog >── User
│ └──< IncidentReportItem >── IncidentReport >── User
├──< InspectionLog
└──< IncidentReportAdmin or Checker, many-to-many with kits
Physical first-aid kit at a location
Item in a kit with expiry tracking
Per-session inspection with item snapshots
Just Docker and Docker Compose. Nothing else to install.
# Clone the repo
git clone https://github.com/athamour1/OuchTracker.git
cd OuchTracker
# Start everything (PWA dev server + HMR)
docker compose -f docker-compose.dev.yml up --build# Copy env and configure secrets
cp .env.prod.example .env.prod
# Pull pre-built PWA images and start
docker compose -f docker-compose.prod.yml \
--env-file .env.prod up -d
# Or pin to a specific release
IMAGE_TAG=v1.2.0 docker compose \
-f docker-compose.prod.yml \
--env-file .env.prod up -dadmin@ouchtracker.local
Admin1234!