Society Parcel Handover Android App with OTP Verification and Guard Log

Every day, dozens of courier parcels land at a residential society's gate, and the security guard becomes their custodian. In most societies this runs on paper: a register entry, a parcel on a shelf, and a hope that the resident hears about it. Parcels get handed to the wrong person, sit unclaimed for days, or vanish entirely — and when a resident asks "where is my parcel?", nobody can answer with certainty. ParcelGate replaces the register with an Android app built for the guard's phone. Logging a parcel takes under 30 seconds: courier, tracking number, recipient flat picked from the resident directory, parcel type. The resident immediately gets an SMS that their parcel has arrived. At collection time, the guard generates a 4-digit OTP sent to the resident's registered mobile number; the handover completes only when the resident reads it back and the guard enters it. Every receipt and handover is written to an automatic guard log with timestamps, searchable by name, flat or tracking number. Parcels unclaimed beyond 48 hours are flagged for a reminder call, so nothing rots on the shelf.

1. The delivery agent arrives at the gate; the guard opens ParcelGate and taps "New parcel".
2. The guard selects the courier, enters the AWB/tracking number, picks the recipient flat from the resident directory and sets the parcel type — the entry saves to the cloud database in under 30 seconds.
3. The backend immediately sends an SMS to the resident's registered number: their parcel has arrived at the gate.
4. When someone comes to collect, the guard selects the parcel from the "Awaiting handover" list and taps "Generate OTP" — a random 4-digit, single-use OTP valid for 5 minutes is sent to the resident's number.
5. The resident reads out the OTP; the guard enters it on the in-app keypad. A match marks the parcel handed over; a mismatch is rejected and the guard asks the resident to read it again.
6. The handover is written to the guard log with timestamp, guard ID and OTP-verified status, and the parcel leaves the awaiting list.
7. A scheduled check flags parcels unclaimed for 48+ hours; the guard sees the alert on the log screen, makes the reminder call, and that call is logged too.

Tech stack:

• Kotlin, Android SDK (min API 28)
• Android Studio
• Firebase Firestore (cloud database)
• Firebase Authentication (guard login)
• Firebase Cloud Messaging (push notifications)
• SMS gateway API (MSG91 / Twilio) for OTP delivery
• Material Design 3 components
• Git

• [30-second parcel logging] The guard records courier, AWB/tracking number, recipient flat (picked from the resident directory) and parcel type the moment the delivery agent hands it over — no freehand flat numbers, no paper register.
• [OTP-verified handover] Before handing over, the guard generates a 4-digit OTP sent by SMS to the resident's registered number; the resident reads it out, the guard enters it on the in-app keypad, and only a match completes the handover.
• [Automatic guard log] Every receipt and handover is written to a chronological log with timestamp, guard ID, courier, tracking number and OTP-verified status — nothing depends on the guard remembering to write it down.
• [Resident arrival SMS] The moment a parcel is logged, the resident gets an SMS naming the courier and tracking number, so parcels stop piling up unnoticed at the gate.
• [48-hour unclaimed escalation] A scheduled check flags parcels unclaimed beyond 48 hours and prompts the guard to make a reminder call; the escalation itself is recorded in the log.
• [Search and filters] The log is searchable by resident name, flat number or tracking number, with filters for received, handed-over and unclaimed — answering "did my parcel come?" takes seconds.
• [Resident directory] The society admin maintains the flat-to-resident mapping with registered mobile numbers, so OTPs and SMS alerts always reach the right person.

• Complete Android source code (Kotlin) with all three screens: Home, Handover, Guard Log
• Firebase backend configuration guide (Firestore schema, auth rules, FCM setup)
• SMS gateway integration module with a test-mode switch for demoing without credits
• Resident directory import template (CSV)
• Setup and build instructions (debug build + signed release APK)
• Project report PDF (architecture, data flow, OTP design, testing notes)
• PPT presentation for final review
• Viva Q&A preparation document (Android lifecycle, Firebase, OTP security, runtime permissions)