1. Introduction

Pandora is a complete, self-hosted luxury real estate listing and brokerage management platform built for premium property agencies, multi-branch high-end real estate brands, and prestige brokerages that require a platform as refined as the properties they represent.

Unlike a typical property listing theme, Pandora is a full operations platform: it manages the entire client journey from first enquiry through to a confirmed sale, including viewing bookings, agent-negotiated pricing, payment tracking with receipts, refunds, and branch-level performance reporting.

Pandora is built in plain, dependency-light PHP and MySQL — no complex framework lock-in, no recurring SaaS fees, no per-seat licensing. A buyer owns the full source code outright.

2. Who This Is For

3. What Makes Pandora Different

4. Technology & Architecture

Pandora deploys cleanly on ordinary shared hosting with cPanel, a VPS, or local development environments (XAMPP/WAMP/Laragon) — no containerisation, Node build pipeline, or specialised infrastructure required.

5. Modules — Detailed Breakdown

5.1 Public Website

• Responsive home page with configurable hero carousel, featured properties, city browser, and top-agent showcase
• Full property search: keyword, city, type, listing type, bedroom count, price-range filters
• Side-by-side property comparison tool
• Photo galleries with keyboard and swipe navigation
• Video Tour embed — YouTube URLs (watch or share format) automatically converted to embeddable iframes; agents paste any YouTube link, no manual embed code needed
• Virtual Tour embed — Matterport, Kuula, CloudPano, Eyespy360 and other 3D tour platforms rendered inline; Matterport auto-play parameters applied automatically; full-screen link alongside the iframe
• Interactive Google Maps on property detail pages, with graceful fallback to address text when GPS coordinates are not set
• Agent directory with public profiles, ratings, active listings, and Email Agent compose modal — server-side PHPMailer; Reply-To set to sender's address so agent replies go directly to the client's inbox
• Branch directory, public contact form, save/favourite properties
• CMS static pages (About, Contact, Privacy Policy, Terms, Sitemap) — pre-seeded with dark Pandora luxury-themed content on fresh installation; editable via Summernote rich-text editor
• Four switchable visual themes: Luxe, Modern, Classic, Minimal
• AI chat assistant bubble — floating widget on all public pages powered by Google Gemini; live property database context injected per request; toggled on/off from System Settings

Benefit: A complete luxury storefront including immersive 3D tours, AI-assisted property discovery, and direct agent communication — no separate marketing site required.

5.2 User Accounts (Clients/Buyers/Renters)

• Self-service registration with mandatory email verification
• 30-day Remember Me persistent login — secure rotating token cookie; works across all five roles
• Personal dashboard: bookings, enquiries, saved properties, notifications
• Booking history with live status tracking and cancellation
• Star-rated reviews, gated to post-viewing completion, held for moderation
• Full payment history grouped by booking with running balance and branded printable receipts showing agency logo and name
• In-app notification centre, enquiry thread history, saved/favourited properties
• AI assistant available in the client dashboard — personalised experience; assistant is aware of the logged-in user's session context

Benefit: High-net-worth clients get a self-service portal matching their expectations, with AI-powered instant answers at any hour and professional branded receipts for every payment.

5.3 Agent Portal

• Personal dashboard: listings, pending bookings, completed visits, open enquiries, monthly revenue
• Property listing CRUD with draft → approval workflow, multi-photo upload with AJAX single-image delete (remove individual photos without re-uploading others), amenity selection, and full spec fields
• Video Tour URL field — paste any YouTube URL; auto-converted to embed on the public page
• Virtual Tour URL field — paste a Matterport or similar 3D tour URL; rendered inline with VR/XR permissions on the property page
• Booking management: confirm, complete, cancel with automatic email notifications at each step
• .ics calendar export, availability blocking calendar
• Enquiry inbox with reply threading, full payment recording workflow
• Editable public profile with bio, social links, WhatsApp, and performance stats

Benefit: Agents manage their full pipeline in one place, with 3D tour support giving clients an immersive pre-visit experience and AJAX image management reducing friction when updating listings.

5.4 Branch Manager Portal

• Branch-scoped dashboard, agent management, property approval queue, review moderation
• Branch-scoped payments view with confirmation and optional refund authority
• Branch performance reports with accurate Pending Payments count (bookings where confirmed payments fall short of agreed price), agent leaderboard, CSV export, print/PDF output

Benefit: Real, enforced authority over branch operations with financial reporting that correctly surfaces outstanding client balances.

5.5 Admin Panel (Admin & Super Admin)

• Platform-wide dashboard, user management, organisation management (Cities, Branches, Amenities)
• Platform-wide property, bookings, payments, and reviews oversight
• CMS with rich-text editor, portable link handling, menu manager, and pre-seeded luxury-themed pages
• Theme switcher, media library, activity log, system health diagnostic, roles & permissions
• Analytics & Reports with accurate Pending Payments KPI, trend charts, branch revenue, agent leaderboard, CSV export and print/PDF output
• System Settings across eleven tabs: Branding, Carousel, Homepage, Company, Maps, Email/SMTP (host, port, credentials, From address — fully configurable from the browser, no server file editing), Listings, Bookings, SEO, Security, and AI Assistant
• AI Assistant Settings tab: enable/disable toggle, API key field (server-side only, masked input), bot name, welcome message; free-tier and paid-tier guidance with Google pricing link provided inline

Benefit: All platform configuration — SMTP, AI, branding, permissions — in one place, with no server file access required for any routine operational change.

5.6 AI Assistant

Pandora includes a built-in AI chat assistant powered by Google Gemini, deployable platform-wide with a single toggle in System Settings.

• Floating chat bubble on all public pages and admin/agent dashboards when enabled
• Live property database context — the assistant automatically knows the current approved listings and can recommend specific properties in response to natural-language queries
• Role-aware responses — logged-in users receive a personalised experience; guests get property-discovery assistance
• All API calls are server-side — the Gemini API key is never sent to the browser or visible in page source
• Model fallback chain — automatically tries the next available Gemini model if the primary is at quota
• Fully configurable from Admin Settings: enable/disable, API key, bot name, welcome message — no code deployment required
• Compatible with Google Gemini's free tier (testing and low-traffic use) and paid tiers (production); guidance and pricing link provided inline in the settings tab
• Graceful degradation — if the API is unavailable or not configured, the widget is hidden; no broken UI shown to visitors

Benefit: A 24/7 property concierge that knows the agency's actual current inventory — deployable in under five minutes with a free Google AI Studio API key, switchable off instantly if needed.

5.7 Payments & Invoicing

Design philosophy: High-value real estate transactions are typically settled by bank transfer or cash at a negotiated price. Pandora is built around this reality rather than forcing an online-checkout model.

• Agent-set Agreed Price per booking, independent of the public listing price
• Full and instalment payments, with balance-overflow prevention
• Payment method, date, reference number, and notes captured per payment record
• Automatic invoice numbering (INV-2026-00001 format, sequential per year)
• Automatic email receipts and in-app notifications on payment recording
• Branded printable receipts — agency logo and name displayed prominently; client, agent, and admin all have access; clean print output without browser chrome
• Refunds with mandatory reason, sequential reference numbers, and full audit trail
• Payment status always derived live — balances can never silently drift out of sync
• Accurate pending-balance reporting in both Admin and Branch Manager dashboards — consistent with what agents and clients see in their own views

Benefit: A real bookkeeping layer with professional branded receipts and accurate outstanding-balance reporting that gives management a reliable picture of pipeline revenue.

5.8 Roles & Permissions System

• Five built-in roles: User, Agent, Branch Manager, Admin, Super Admin
• 16-module permission matrix with per-action granularity; changes apply instantly platform-wide
• Sidebar navigation automatically hides inaccessible modules
• Branch-level data scoping enforced in code; cannot be accidentally widened via settings
• Super Admin permanently fully privileged — guaranteed recovery account

Benefit: Turns roles into genuinely configurable job functions — buyers tailor exactly what each role can do without code changes, and prove via the Activity Log who did what.

5.9 Notifications & Communications

• Branded transactional emails for every key event: verification, welcome, booking lifecycle, listing lifecycle, payments, refunds, password reset
• SMTP fully configurable from Admin Settings — host, port, credentials, encryption, From name and address; DB settings override .env; no server file editing for any mail change
• Email Agent modal on agent public profiles — compose and send via PHPMailer; Reply-To set to sender's address so agent replies land directly in the client's inbox, not a platform inbox
• In-app notification centre per role with unread-count badges
• WhatsApp deep-link integration on agent profiles
• Extended footer social icons: Facebook, Instagram, WhatsApp, LinkedIn, and YouTube — each appears only when configured, no dead icons
• Footer Credit Text — admin-configurable "Powered by …" credit; blank to hide completely, supporting white-label deployments

Benefit: Every actor is kept informed automatically. SMTP changes take effect immediately without redeployment. The Email Agent modal creates a direct professional communication channel.

7. Ownership, Customisation & Branding

Pandora is sold as a complete, ownable codebase — no subscription, no per-seat fee, no seller-side dependency after delivery:

• Re-brand entirely via System Settings (name, logo, colours, fonts, theme, footer credit text) — no code edits required
• Extend or modify any module — plain, readable PHP, no proprietary framework abstractions
• White-label for resale to multiple luxury real estate clients (subject to licence terms agreed at sale)
• Configure AI independently per deployment — each instance uses its own Gemini API key, bot name, and on/off state
• Run on any infrastructure — shared hosting, VPS, or local development (XAMPP/WAMP/Laragon)

8.1 Payment Methods Supported

Pandora does not process payments online. These methods record how a client physically paid an agent, for bookkeeping purposes. If a gateway integration (Flutterwave, Paystack, Stripe, PayPal) is required for a specific deployment, please contact Lakesoft Solutions.

9. What's New in Version 1.1

10. Summary

Pandora is the operational backbone for a luxury real estate brokerage — not just a premium listings website, but the system a prestige multi-branch agency would actually run its business on: agents managing their pipeline, managers governing their branch, admins controlling the platform, and a complete, auditable payment and reporting layer underneath.

Version 1.1 extends the platform with AI-powered property discovery, immersive 3D virtual tour support, direct agent-to-client email communication, and a series of operational improvements — without increasing infrastructure complexity or introducing new mandatory dependencies.

Its self-hosted, dependency-light architecture makes it deployable in under an hour, while its depth — branch-scoped authority, configurable permissions, agent-negotiated payment tracking, switchable luxury themes, AI assistant, and full CMS control — gives it the substance to replace the spreadsheets, WhatsApp groups, and disconnected tools many brokerages currently stitch together.