Web Platform for PG Management

Project overview (what I want)

This web app will be used by owners/managers of paying-guest (PG) houses or hostels to manage rooms, tenants, bookings, maintenance, payments, invoices, staff, and reports. It must be secure, reliable, mobile-friendly, and easy for non-technical staff to use. Expect an admin panel, manager dashboard for daily operations, and a tenant portal (and optionally a basic mobile responsive UI).

I want a solid, extensible system — not quick hackwork. Follow best practices, include automated tests, and document everything.

Scope & core features (must-have)

Authentication & RBAC

Admin, Manager, Accountant, Staff, Tenant roles.

Email/password + optional OTP for tenants. Password reset.

Property & Room Management

Add properties (PG locations), floors, room types, room units.

Room status: vacant, occupied, reserved, under maintenance.

Assign room to tenant with move-in / move-out dates.

Tenant Management

Tenant profile, ID document uploads, emergency contact.

Tenant history (past rooms, payments, complaints).

Bulk import CSV of tenants.

Booking & Lease Management

Create bookings, provisional holds, booking confirmation.

Lease terms, security deposit tracking, prorated rent calculation, notice periods.

Billing & Payments

Recurring rent invoices, custom charges (electricity, water, maintenance).

Payment recording (cash / bank transfer / UPI / card).

Generate printable receipts & PDF invoices.

Maintenance / Complaints

Tenant can raise request; staff can update status and assign technician.

Maintain log and cost tracking.

Inventory & Assets

Track furniture/equipment per room and property. Maintenance & depreciation notes.

Attendance / Staff Management (basic)

Staff list, roles, basic attendance log or shift schedule.

Reports & Dashboards

Occupancy rate, monthly revenue, arrears/aging report, upcoming checkouts, deposit ledger.

Export to CSV/PDF.

Notifications

Email templates for invoices, payment reminders, booking confirmation. Optional SMS/WhatsApp integration as an extra.

Audit & Activity Log

Track important actions (who changed rent, who checked in/out, deleted records).

Settings & Config

Tax rules, invoice numbering, currency, bank account details, room rent cycles.

Deployment & DevOps

Dockerized app, CI pipeline (GitHub Actions/GitLab CI), deployable to AWS EC2 / ECS or DigitalOcean. Provide deployment scripts and docs.

Documentation & Handover

API documentation (OpenAPI/Swagger), architecture diagram, setup & run instructions, basic user manual for staff.