PG-Manager 🏠

PG-Manager is a modern, comprehensive Property Management System (PMS) designed for Hostel and Paying Guest (PG) owners. It simplifies the chaos of managing tenants, rooms, payments, and complaints into a single, beautiful dashboard.

🚀 Key Features

• Role-Based Access: Secure login/signup for Owners and Tenants.
• Tenant Management: Onboard new tenants, track lease dates, and manage active/past residents.
• Smart Room Allocation: Visual bed management with capacity tracking.
• Finance Dashboard:
  • Track Rent Payments (Cash, UPI, Bank).
  • Record Expenses (Utilities, Maintenance, Salaries).
  • Real-time Net Profit calculation.
• Complaint System: Tenant-raised issues with priority tracking (High/Medium/Low) and resolution workflow.
• Tenant Portal:
  • Dashboard: View rent due, payment history, and lease details.
  • Online Payments: Pay rent via UPI and submit transaction details for verification.
  • Dark Mode: Toggle between light and dark themes.
• Properties & Rooms: Manage multiple buildings and configure room capacity/pricing.
• Responsive Design: Built with Tailwind CSS for a seamless mobile and desktop experience.

🛠️ Tech Stack

• Backend: Python, Flask, Jinja2
• Database: PostgreSQL
• Frontend: HTML5, Tailwind CSS, JavaScript
• Authentication: Werkzeug Security

📚 Documentation

• Setup Guide: Step-by-step instructions to install and run the project locally.
• Contributing: Guidelines for code contributions and pull requests.

⚡ Quick Start

Windows (One-Command)

We provide a helper script to set up everything (Python venv, dependencies, database) in one go:

.\setup.ps1

Then, start the server:

npm run dev

Manual Setup

1. Clone the repo.
2. Setup database and environment variables (Detailed in SETUP.md).
3. Run:

   npm run dev

📄 License

This project is open-source and available under the MIT License.