Property Management System - Backend
A scalable, modular, and secure backend system for managing real estate properties, built with NestJS following Clean Architecture principles.
The Property Management System (PMS) is a complete solution for real estate and property management that includes:
- 3 Web Dashboards:
- Admin & Supervisors Dashboard for managing system operations, approvals, financials, complaints, and monitoring statistics
- Brokers / Office Managers Dashboard for managing offices, properties, bookings, payments, and advertisements
- Service Providers Dashboard for managing and offering property-related services (maintenance, furnishing, cleaning, etc.)
- Mobile Application for end-users to explore, book, and manage properties and tourist places
- Role-based permissions with secure authentication
- Payment and invoicing system supporting online and manual payments
- Real-time notifications, support requests, and reporting system
- Service providers management for additional services related to properties
When accessing the platform for the first time, users are welcomed with a landing single page that showcases:
- Top 5 Brokers/Offices
- Top 5 Service Providers
- Contributors/Developers who worked on the project
From this entry page, the user can decide to either:
- Visit the Mobile Application to explore properties and tourist places as an end-user
- Join as a Broker (Office Manager) or Service Provider by submitting office/service details along with a verification document.
- The request is then sent to the Admin Dashboard for review and can be approved or rejected.
The system is built using Domain-Driven Design (DDD) and Clean Architecture for scalability and maintainability.
- Browse brokers/offices
- Browse tourist places
- Browse residential and tourist properties
- Filter and search
- Compare two properties or tourist places
- Book a property or tourist place
- Notifications
- My Bookings
- Profile management
- Explore and Trending properties
- Ads display
- Browse service providers and book services
- Request support
- **Rate **
- Submit complaints
- Favorites
- Post custom property requests
- View related properties
- 360° property view
- Add and edit office details
- Add, update, and manage properties
- View office statistics
- Filter and view my properties and tourist places
- Manage bookings, rents, and fees
- Configure payment methods (online or manual)
- Manage ads and respond to requests
- Request services and support
- Add and edit service details (e.g., cleaning, maintenance, landscaping)
- Activate or deactivate services
- Manage service availability
- Handle support requests from users and offices
- View service-related bookings and requests
- Review requests and approvals
- Register in the system
- Review office requests
- View all offices and services
- Manage properties, posts, and ads
- Monitor financial records
- Handle complaints and support
- Generate statistics and reports
- Manage offices and service providers
- Global (all regions)
- Specific region
- Manage finances and ads
- Manage user requests and posts
- Handle complaints and support
- Monitor system statistics
- Manage supervisors
- Oversee financial operations
The system provides 3 main web dashboards:
-
Admin & Supervisors Dashboard
- Manage supervisors and permissions
- Handle financial operations and advertisements
- Review and approve office and property requests
- Manage complaints, notifications, and system statistics
-
Broker / Office Manager Dashboard
- Add, update, and manage properties (for sale, rent, tourist places)
- Track bookings, payments, and office statistics
- Manage advertisements and respond to user requests
- Request support or services and update office details
-
Service Providers Dashboard
- Add and manage service details (e.g., maintenance, furnishing, cleaning)
- Activate or deactivate services
- Access support center for handling requests and issues
- Users can create a new account with email and password.
- A verification code is sent to the email for confirmation.
- Users can login after verifying their email or continue as guest users.
- Browse properties and tourist places
- Compare two properties or places in terms of details
- Add residential or tourist properties to favorites
- Browse service providers if they offer services related to the property
- Create a custom property request by posting:
- Desired budget
- Preferred location
- Additional description/details
- User selects a property and makes a reservation with a deposit
- Payment can be online or manual, depending on the office configuration
- If installments are allowed, invoices are generated for each installment
- If paying full amount, a single invoice is created
- Property status updates after last installment or full payment
- Users receive real-time notifications for bookings, payments, and property updates
- Users can mark notifications as read/unread
- User selects a property for sale.
- User can pay a deposit (online or manual, depending on office settings).
- If installments are supported:
- System generates multiple invoices (based on installment count).
- If full payment is chosen:
- A single purchase invoice is generated.
- Property status is updated after the final payment is completed.
- All invoices are available in the Owned Properties section.
- For online payments, the system generates a PDF invoice for the user.
- User selects a property for rent (configured as monthly or yearly by the office).
- User specifies the rental period (number of months or years).
- A deposit invoice is generated.
- Additional invoices are created for each rental month/year.
- User can pay invoices online or manually, depending on the office settings.
- Invoices are displayed under the Rented Properties section.
- For online payments, a PDF invoice is automatically generated.
- User selects a tourist place and chooses a range of consecutive days.
- System generates two invoices:
- Deposit invoice
- Rental invoice for the selected days
- Payments can be processed online or manually.
The Office Manager Dashboard provides real estate brokers with a complete control panel to manage their offices, properties, and bookings:
- View office information and details.
- Track number of properties categorized by rent, sale, or tourist places.
- Monitor warnings/violations assigned to the office.
- View financial earnings and statistics.
- Add a new property with detailed information and upload property images.
- The property is sent for Admin review and approval before being published.
- Add new tourist places with the same approval process.
- Filter and manage properties by:
- Status (available, booked, sold, etc.)
- Province
- Region
- Track property bookings made by users.
- Upload manual payment documents if payment was not electronic.
- Manage rental bookings and upload supporting invoices for manual payments.
- For tourist place bookings:
- View details per month.
- Track booked vs. available days.
- Access related financial records.
- Review user requests and suggest suitable properties based on their needs.
- Submit requests for advertising campaigns (image or promotional ads).
- Ads require Admin approval before publishing.
- Payments for ads can be processed electronically.
- Update and manage office profile details.
- Access and manage office notifications.
- Accessible only by the Director (Admin) or a Supervisor with system monitoring permissions
- Displays system-wide statistics:
- Total users, supervisors, brokers/offices, and service providers
- Total number of properties (for sale, for rent, tourist places)
- Total number of ads
- Top-rated offices and top-rated service providers
- Add new supervisors
- Assign or edit permissions for supervisors
- Delete supervisors if necessary
- Accessible by Director or Supervisors with financial permissions
- Manage and review:
- Advertisement requests (image-based or promotional)
- Invoices related to advertisements
- Approve or reject ad requests submitted by offices
- Accessible by Director or Supervisors with broker management permissions
- Manage offices and their submitted content:
- Review and approve/reject new property posts submitted by offices
- View all offices with their related properties
- Manage service providers:
- View all service providers and their active/inactive services
- Review user property requests (posts created by users requesting properties with budget, location, and details)
- Accessible by Director or Supervisors with system monitoring permissions
- View all system notifications
- Send new notifications to users, offices, or service providers
- Accessible by Director or Supervisors with complaints management permissions
- Review complaints submitted by users against offices
- View complaint details (office, user, reason)
- Approve or reject the complaint
- If approved, the office receives a warning (appears in the office dashboard)
- Platform-wide Q&A management
- Add or edit questions and answers related to platform usage
- Provide support resources for users, offices, and service providers
- Backend Framework: NestJS
- Database: PostgreSQL (via TypeORM)
- Authentication: JWT
- Mobile App: Flutter / React Native (based on project setup)
- Payments: Stripe & Manual payments
- Notifications: Firebase
- Validation: Class-validator & Pipes
- API Documentation: Swagger
# Clone the repository
git clone https://github.com/OnlyAbdullh/Property-Management-System-BackEnd.git
# Navigate into the project
cd Property-Management-System-BackEnd
# Install dependencies
npm install
# Set up environment variables
cp .env.example .env
# Run database seeder
npm run seed
# Start the application in watch mode
npm run start:dev**## 🔑 Environment Variables
Create a .env file in the root directory and add the following:
# Database
DB_HOST=localhost
DB_PORT=5432
DB_USERNAME=postgres
DB_PASSWORD=root
DB_NAME=yourDatabaseName
DB_SYNCHRONIZE=true
#Email
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_SECURE=false
SMTP_USER=yourEmail
SMTP_PASS=YourPassword
# JWT
JWT_TOKEN_SECRET=yourGeneratedToken
JWT_TOKEN_EXPIRES_IN=1h
JWT_REFRESH_TOKEN_SECRET=yourGeneratedToken
JWT_REFRESH_TOKEN_EXPIRES_IN=7d
#Stripe
STRIPE_SECRET_KEY=yourSecretKey
STRIPE_WEBHOOK_SECRET=yourSecretKey
#Firebase Configuration
FIREBASE_CONFIG_PATH=src/infrastructure/config/firebase/your-credential-file-name.json