Medicine Reminder Android App

Missing doses is the most common reason prescriptions fail — especially for elderly patients managing three or four medicines with different schedules. Phone alarms help, but a generic alarm cannot say "Metformin 500 mg, 1 tablet, after dinner," cannot tell whether the dose was actually taken, and cannot warn that only six tablets remain. A dedicated medicine reminder closes all three gaps: it models each medicine with its schedule, fires precise dose alarms, records confirmations into an adherence score, and tracks stock against the dosing rate to predict refill dates. This project implements that as a native Android app with exact-alarm scheduling, a daily dose timeline, adherence analytics, refill predictions and a caregiver-friendly design.

1. Adding a medicine captures name, dosage, times, instructions and duration; the schedule engine expands this into concrete dose events.
2. Each dose event is registered as an exact alarm with AlarmManager, with a boot receiver re-registering alarms after restarts.
3. When an alarm fires, a high-priority notification shows the medicine, dose and instructions with "taken" and "snooze 10 min" actions.
4. Confirmations write taken-timestamps to Room; the adherence engine compares scheduled vs taken-on-time doses for the weekly score.
5. Stock decrements on each confirmation; when remaining doses fall below the warning threshold, a refill reminder is scheduled.
6. A setup flow guides the user through exact-alarm permission and battery-optimization exemption so alarms survive Doze mode.

Tech stack:

• Kotlin
• Android Jetpack (MVVM)
• Room (medicines + dose events)
• AlarmManager · exact alarms
• Notifications API (actions)
• Boot receiver (alarm restore)
• Material Design 3

• [Per-medicine dose schedules] Each medicine carries its own times, dosage, and instructions (before/after food); supports multiple daily doses and weekly medicines.
• [Exact dose alarms] Alarms fire at the scheduled minute via AlarmManager with Doze-mode handling, labeled with the medicine name and dose.
• [Mark-taken flow] One tap confirms a dose; late confirmations are recorded with their actual time for honest adherence math.
• [Weekly adherence score] Taken-on-time vs scheduled doses aggregate into a weekly percentage ring with the personal-best streak.
• [Refill prediction] Stock counts decrement per confirmed dose; the app warns days before the predicted run-out date.
• [Daily dose timeline] Today's schedule as a chronological list — due now, taken, upcoming — so the whole day is visible at a glance.
• [Local-first privacy] All prescription data stays in an on-device Room database; nothing is uploaded anywhere.

• Complete Android app source code (Kotlin)
• Dose-scheduling engine documentation
• Build and install instructions (APK generation)
• Project report PDF (scheduling model, Android alarm behavior, adherence math, privacy design)
• PPT presentation for final review
• Viva Q&A preparation document (AlarmManager, Doze, Room, MVVM, boot receivers)

• The app is a reminder aid, not a medical device — it does not verify ingestion, and the report states this boundary explicitly.
• "Taken" confirmations are self-reported; adherence scores reflect confirmations, not observed behavior.
• Exact alarms require the SCHEDULE_EXACT_ALARM permission and battery-exemption; without them, Android may delay alarms.
• Drug-interaction checking is out of scope — the app never advises on combinations or dosages, only on timing.
• Refill predictions assume the logged stock count is accurate; unlogged extra tablets skew the prediction.
• One patient profile per install in this build; multi-profile support is designed as future scope.