PGos

byYogesh Yogi

Build a modern, enterprise-grade PG (Paying Guest) Management SaaS platform with React, Node.js, Express, PostgreSQL, Tailwind CSS, and JWT Authentication. The application must be responsive, secure, scalable, and run on localhost:8080. ## User Roles 1. Super Admin 2. PG Owner / Manager 3. Tenant 4. Staff (Optional) ## Authentication - Secure Login - Registration - Forgot Password - OTP Verification - Email Verification - Role-Based Access Control - JWT Authentication - Google Login (Optional) ## Super Admin Dashboard - Dashboard Overview - Total PGs - Total Owners - Total Tenants - Active Subscriptions - Revenue Analytics - Platform Analytics - User Management - Subscription Plans - Payment Management - Support Tickets - Reports - Notifications - System Settings - Audit Logs ## PG Owner Dashboard ### Dashboard Overview - Occupancy Rate - Available Rooms - Total Revenue - Pending Rent - Monthly Expenses - Maintenance Status - Recent Activities ### Property Management - Add/Edit PG - Multiple Buildings - Floor Management - Room Management - Bed Management - Room Types - Amenities ### Tenant Management - Add Tenant - Tenant Profile - Digital KYC - Rental Agreement - Check-in - Check-out - Room Transfer - Tenant History ### Rent Management - Monthly Rent - Security Deposit - Utility Bills - Auto Invoice - Payment Tracking - Due Reminders - Late Fee Calculation - Receipt Generation ### Finance - Income - Expenses - Profit & Loss - Cash Flow - Reports - GST Reports - Export Excel/PDF ### Maintenance - Raise Complaint - Assign Staff - Track Status - Maintenance History - Vendor Management ### Visitor Management - Visitor Entry - Approval System - Visitor History - QR Entry ### Staff Management - Staff Profiles - Attendance - Salary - Roles & Permissions ### Inventory - Furniture - Appliances - Consumables - Stock Alerts ### Notifications - SMS - Email - WhatsApp - Push Notifications ### Reports - Occupancy Report - Rent Report - Expense Report - Tenant Report - Maintenance Report ## Tenant Dashboard ### Dashboard - Current Room - Rent Status - Due Date - Notices - Upcoming Payments ### Features - Online Rent Payment - Payment History - Download Receipts - Digital Agreement - Maintenance Request - Visitor Request - Complaint Tracking - Notices - Announcements - Profile Management - Emergency Contact - Support Chat ## Staff Dashboard - Assigned Tasks - Maintenance Jobs - Attendance - Daily Work Status - Completed Tasks ## Common Features - Dark/Light Mode - Mobile Responsive - Real-time Notifications - Dashboard Charts - Calendar - Search & Filters - File Upload - Image Upload - PDF Generation - Excel Export - QR Code Generation - Multi-language - Activity Logs - Backup & Restore ## Database - PostgreSQL - Prisma ORM - Proper Relationships - Indexing - Soft Delete - Audit Tables ## Security - JWT Authentication - Role-Based Authorization - Password Hashing - SQL Injection Protection - XSS Protection - CSRF Protection - API Validation - Rate Limiting ## Technical Stack - React - TypeScript - Vite - Tailwind CSS - Express.js - PostgreSQL - Prisma ORM - JWT - React Query - Zustand - Chart.js - React Hook Form - Zod Validation ## UI Requirements - Professional SaaS Design - Modern Dashboard - Sidebar Navigation - Responsive Layout - Beautiful Cards - Charts - Data Tables - Modal Forms - Loading Skeletons - Toast Notifications ## Development - Run on localhost:8080 - Production-ready folder structure - Clean Architecture - Reusable Components - Modular Code - Best Practices - Proper Documentation - Generate the project module-by-module instead of generating everything at once.