AI-powered care home handover and shift management system
HandOver, Feature Overview
HandOver is a voice-first shift handover and care records platform built for care homes. Care workers record a short voice note about a resident, and the system transcribes it, translates it into English, and turns it into a structured handover report using AI. Urgent issues are pushed to managers in real time. Instead of rushed written handovers and lost details between shifts, care teams get one searchable, auditable record of every resident, every shift, and every follow-up.
About This Project
HandOver is a voice-first shift handover system for care homes. It replaces typed handover notes with a 30-second voice recording that is automatically converted into a structured, searchable report.
Instead of relying on paper notes, rushed verbal updates, or scattered messages, care managers get one clean dashboard to review handovers, monitor urgent incidents, manage residents, track shifts, and oversee their care team, while care workers record handovers from a web or mobile app.
Core Features
1. Voice-First Handover Recording
Care workers record a short voice note about a resident at the end of a shift from the web or mobile app. Supports WAV, MP3, M4A, WebM and OGG audio files up to 25 MB, so staff can speak naturally instead of typing.
2. Local Whisper Transcription
Audio is transcribed on the platform's own infrastructure using OpenAI Whisper. Resident voice recordings are not sent to a third party for transcription, which supports the privacy expectations of care providers.
3. AI-Structured Handover Reports
Google Gemini converts each transcript into a structured report containing a summary, key events, medications given, incidents, follow-up actions, mood notes, and the resident's name, all written in clear English.
4. Multilingual Voice Notes
Care workers can speak in English, Urdu, Arabic or other languages. The AI translates the note into fluent English, corrects likely speech-recognition errors, and marks uncertain corrections inline so managers can see what to double-check.
5. Safety-First Urgency Detection
Every handover is automatically flagged low, medium, or high. High urgency is applied to safety concerns, injuries, medication errors, and urgent medical issues. Ambiguous wording near terms like "fall" or "injury" is interpreted conservatively.
6. Real-Time Urgent Alerts
High-urgency handovers instantly notify managers over WebSockets, with a Redis pub/sub channel so alerts work across multiple API workers. Registered mobile devices also receive push notifications.
7. Follow-Up Tracking
AI-suggested follow-up actions start as open items and can be marked resolved by workers or managers, so the open follow-ups count shrinks as work is completed.
8. Resident Profile Management
Complete digital resident records covering personal details, room and ward, admission and discharge status, medical conditions, allergies, current medications, mobility, dietary and communication needs, care and risk levels, behaviour notes, emergency contacts, and language preferences.
9. Shift Management and Auto Clock-Out
Workers clock in and out of timezone-aware shifts. A scheduled background job automatically closes any stale shift every 15 minutes, so managers never see inaccurate, ever-growing durations.
10. Resident Assignment System
Managers assign care workers to specific residents and track who assigned whom and when, so each handover is tied to the right carer and resident.
11. Team and Staff Administration
Managers can view and manage staff with employee IDs, job titles, departments, employment type, shift patterns, join dates, employment status, and emergency contacts. Role changes are tracked with a previous-role history.
12. Role-Based Access
Separate manager and care worker experiences. Managers get the full dashboard, team, alerts, and audit tools, while care workers get a focused interface for recording and reviewing handovers.
13. Manager Dashboard and Handover Feed
A live dashboard shows active residents, recent urgent handovers, unread alerts, and total handovers on record, with a recent-handover feed and quick actions for adding residents, managing the team, and reviewing alerts.
14. Notification Center
In-app notification history for urgent handovers and system events, with read and unread tracking.
15. Append-Only Audit Log
Middleware records sensitive actions in an append-only audit trail, giving managers a clear accountability record that supports care-compliance expectations.
16. Secure Authentication
JWT-based sessions, email OTP verification with rate limiting, a password reset flow, and Cloudflare Turnstile bot protection on signup. Expired pending signups are cleaned up automatically by a scheduled job.
17. Cross-Platform Web and Mobile Apps
A React manager dashboard for the web and an Expo / React Native app for care staff, using secure on-device token storage. Both share the same API and design language.
18. Resilient AI Pipeline
Gemini calls are protected by retry logic with exponential backoff and a circuit breaker that opens after repeated failures, so a temporary AI outage does not crash the platform. Transcription and summarisation run asynchronously in Celery workers, so the app stays fast.
Platform Summary
| AREA | CAPABILITY |
|---|---|
| Handover Capture | Voice recording on web and mobile, up to 25 MB audio |
| Transcription | Local Whisper, no third-party audio processing |
| AI Reporting | Structured summaries, medications, incidents, follow-ups, mood notes |
| Languages | Multilingual input with English output and uncertainty markers |
| Urgency | Automatic low, medium, high flagging with conservative safety rules |
| Alerts | Real-time WebSocket and mobile push notifications |
| Residents | Full digital profiles, risk and care levels, admission and discharge |
| Shifts | Timezone-aware shifts with automatic clock-out |
| Team | Staff profiles, assignments, role-based access |
| Compliance | Append-only audit log, OTP-verified accounts |
| Reliability | Circuit breaker, retries, async Celery processing |
| Quality | 390+ automated tests, CI pipeline, load testing |
Technology Stack
| SYSTEM LAYER | TECHNOLOGY USED | OPERATIONAL PURPOSE |
|---|---|---|
| Backend API | FastAPI, Python, SQLAlchemy | Handles high-speed API requests, business logic, and database access |
| Database Engine | PostgreSQL, Alembic | Stores residents, handovers, shifts, and audit records with versioned migrations |
| Speech-to-Text | OpenAI Whisper | Transcribes voice notes locally without sending audio to third parties |
| AI Summarisation | Google Gemini | Translates and converts transcripts into structured handover reports |
| Background Jobs | Celery, Celery Beat | Runs transcription, summarisation, auto clock-out, and cleanup jobs |
| Real-Time Layer | WebSockets, Redis pub/sub | Delivers instant urgent alerts across multiple API workers |
| Web Frontend | React, Vite, React Router | Delivers a fast manager dashboard in the browser |
| Mobile App | Expo, React Native | Lets care staff record and review handovers on their phones |
| Security Layer | JWT, OTP verification, slowapi, Cloudflare Turnstile | Manages secure logins, rate limiting, and bot protection |
| Email and Push | Gmail SMTP, device push tokens | Sends verification emails and mobile notifications |
| Deployment | Docker, Gunicorn, Uvicorn, Nginx | Runs the full stack in containers behind a reverse proxy |
| Quality and CI | Pytest, GitHub Actions, Locust | Automated testing, continuous integration, and load testing |