Prime Estate Pro – Estate Management System

Prime Estate Pro – Gated Community & Estate Management Suite

Prime Estate Pro is a production-ready, multi-role residential estate management web application built on Laravel, Bootstrap, and jQuery. Whether you manage a small gated community or a large estate with hundreds of residents, Prime Estate Pro gives every stakeholder — executives, residents, security guards, and domestic staff — a dedicated portal to perform their role seamlessly from any device.

🔴 Live Demo

Demo URL: https://primeestatepro.onecrib.com

Use the one-click role login buttons on the homepage to explore each portal instantly.

The Overdue Resident account demonstrates the automatic visitor-pass lockout system and lets you simulate live checkout payments via Paystack, Stripe, Flutterwave, or Razorpay without real credentials.

🧩 Who Is This For?

• Estate Developers & HOAs — Automate levy collection and resident communication
• Property Managers — Digitize gatehouse operations and visitor logging
• Laravel Developers — A premium, production-grade codebase to build on or resell
• SaaS Entrepreneurs — Ready-to-deploy multi-role platform with a web installer

⚙️ Core Features

👥 Multi-Role User System

Four distinct roles with dedicated dashboards and access levels:

• Super Admin (Estate Executive) — Full platform control
• Resident — Self-service portal for levies, passes, tickets, and polls
• Security Guard — Gatehouse console for visitor verification and panic alerts
• Domestic Staff — Digital ID card and entry permit display

New self-registered users are held in a Pending state until approved by the Super Admin — no unauthorized access.

🚪 Visitor Pass System

• Residents generate 6-digit PIN visitor passes with custom expiration windows
• Guards look up PIN codes at the gate in real time
• Full check-in/check-out logging with timestamps
• SMS alert triggers on visitor arrival (Africa's Talking / Twilio)
• Residents with overdue levies are automatically blocked from generating new passes

💳 Dues & Levies Engine

• Admin creates levy categories: Monthly, Annual, or One-Time
• Configurable grace period (in days) before lockout kicks in
• Residents view outstanding balances and pay directly through the portal
• Detailed payment history and receipts

🌐 4 Payment Gateways

• Paystack, Flutterwave, Stripe, and Razorpay — all configurable from the admin settings panel
• Built-in Payment Simulator — if secret keys contain mock or are empty, the system enters simulation mode automatically. No live credentials needed for testing.
• Admin controls which gateways appear to residents at checkout

🆘 Instant Panic / SOS Alerts

• A prominent panic button on the resident dashboard triggers an immediate distress alert
• The guard's gatehouse console polls every 3 seconds for new alerts
• On alert: the guard screen flashes a full-page distress banner with an audible siren beep
• Guards mark alerts as resolved to clear the console

📋 Notice Board

• Admin broadcasts estate-wide announcements with rich text
• All active residents see notices immediately on their dashboard
• Supports pinning and scheduling

🗳️ Community Polls

• Admin creates single-question polls with multiple options
• Residents cast one vote per poll
• Live result charts update in real time after voting

🎫 Support Tickets

• Residents raise maintenance or complaint tickets with optional photo attachments
• Tickets progress through statuses: Open → In Progress → Resolved
• Admin manages all tickets from a unified queue

📱 PWA — Installable as a Mobile App

• Ships with a Web App Manifest and Service Worker
• Installable on Android (Chrome), iOS (Safari), and desktop
• A floating "Install App" prompt appears for eligible users
• Offline caching for previously visited pages

🛠️ Web Installer (No CLI Required)

Guided 5-step browser-based installer:

1. Requirements & Permissions Check — PHP version, extensions, writable directories
2. Database Configuration — Live connection test before saving
3. Run Migrations & Seeders — One-click DB setup
4. Admin Account Setup — Create the Super Admin during install
5. Complete — Installer is permanently locked via a storage/installed lock file

⚙️ Dynamic Admin Settings Panel

Configure everything without touching .env after installation:

• Mail — SMTP host, port, credentials, encryption, sender name
• SMS — Provider selection (Africa's Talking / Twilio / Disabled), API keys, sender ID, sandbox/live mode
• Payments — Gateway API keys, active gateway selection, currency
• reCAPTCHA — Enable Google reCAPTCHA v2 on the registration form
• App Name — Rebrand the platform from the panel

📨 Notifications

Notifications are dispatched for: new registrations, account approval/suspension, visitor pass creation, levy payment confirmation, panic alerts, and ticket updates.

🔐 Security

• CSRF protection on all forms
• Role-based middleware on every route group
• Installer lock — /install route is permanently blocked after first run
• Email verification required for resident accounts
• Google reCAPTCHA v2 optional on registration
• Input validation via Laravel Form Requests throughout
• Old files deleted from storage on update; orphaned files cleaned on record deletion

🖥️ Tech Stack

📋 System Requirements

Required PHP Extensions: pdo, pdo_mysql, openssl, mbstring, tokenizer, xml, ctype, curl, zip

🚀 Installation

Option A — Web Installer (Recommended)
Upload the project, point your domain to the /public folder, and navigate to http://your-domain.com/install. The wizard walks you through everything in 5 steps — no terminal required.

Option B — Manual CLI

<code>composer install
cp .env.example .env
php artisan key:generate
php artisan migrate --seed
php artisan storage:link</code>

📁 What's Included

• ✅ Full Laravel source code (uncommented, production-ready)
• ✅ Database migrations and seeders
• ✅ Web installer (no CLI required for buyers)
• ✅ Demo mode with one-click role logins
• ✅ PWA manifest and service worker
• ✅ Pest test suite (DemoMode, installer lock)
• ✅ README with full installation & configuration guide