1. Introduction

NestIQ is a complete, self-hosted real estate listing and agency management platform built for forward-thinking property agencies, multi-branch real estate businesses, and independent brokerages that need intelligent tools to run efficiently and serve clients well.

NestIQ is a full operations platform: it manages the entire client journey from first property search through to a completed transaction — including viewing bookings, agent-negotiated deal pricing, payment recording with receipts, refunds, and branch-level performance analytics. It is the operational backbone that connects a professional property website with the day-to-day management tools a real estate business actually needs.

NestIQ is built in plain, dependency-light PHP and MySQL — no framework lock-in, no recurring SaaS fees, no per-seat licensing. A buyer owns the full source code and runs it on infrastructure they control.

2. Who This Is For

3. What Makes NestIQ Different

4. Technology & Architecture

NestIQ 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 (sale/rent/short-let), 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 on property pages; Matterport auto-play parameters applied automatically; full-screen link provided 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 for direct agent-client communication
• Branch directory, public contact form with spam protection, save/favourite properties
• CMS static pages (About, Contact, Privacy Policy, Terms, Sitemap) — pre-seeded with ready-to-use content on fresh installation; editable via Summernote rich-text editor
• Four switchable visual themes for flexible public-site appearance
• 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 with no code changes required

Benefit: A complete, professional property portal — video and 3D virtual tours, AI-assisted property discovery, direct agent contact — without building or maintaining a separate marketing site.

5.2 User Accounts (Clients/Buyers/Renters)

• Self-service registration with mandatory email verification before login
• 30-day Remember Me persistent login — secure rotating token cookie; works across all five roles; no session expiry when opted in at login
• 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 before publishing
• 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: Clients self-serve their own history — reducing inbound support calls — while AI-powered instant answers handle routine questions at any hour.

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; automatically converted to embed on the public property 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 status change
• .ics calendar export — sync viewing schedule into Google Calendar, Outlook, or Apple Calendar; availability blocking calendar
• Enquiry inbox with reply threading, full payment recording workflow with agreed-price setting
• Editable public profile: bio, designation, social links, WhatsApp, and performance stats

Benefit: Agents manage their full pipeline — listings, bookings, payments, communications — without leaving the platform; 3D tour support adds a compelling buyer experience with no extra tooling.

5.4 Branch Manager Portal

• Branch-scoped dashboard, direct agent management, property approval queue (scoped to their branch), review moderation
• Branch-scoped payments view with payment confirmation and optional refund authority
• Branch performance reports: revenue, bookings, accurate Pending Payments count (bookings where confirmed payments fall short of agreed price), agent leaderboard, top properties by views — selectable time period, CSV export, printable

Benefit: A Branch Manager has genuine, enforced authority over their branch's operations and finances — not a label, but a real scope boundary with reporting that shows outstanding client balances accurately.

5.5 Admin Panel (Admin & Super Admin)

• Platform-wide dashboard, user management across all five roles, organisation management (Cities, Branches, Amenities)
• Platform-wide property, bookings, payments, and reviews oversight
• CMS with rich-text page editor, portable link handling, drag-free menu manager, and pre-seeded content pages
• Theme switcher, media library, activity log, system health diagnostic, roles & permissions
• Analytics & Reports: platform-wide KPIs including accurate Pending Payments metric, booking/sales trend charts, branch revenue table, agent leaderboard — CSV export and print/PDF
• System Settings across eleven tabs: Branding, Carousel, Homepage, Company, Maps, Email/SMTP (host, port, credentials, encryption, From name/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 (server-side only, masked), bot name, welcome message; free-tier and paid-tier guidance with Google pricing link inline

Benefit: A non-technical Super Admin can fully run the platform after initial setup — SMTP, AI, branding, permissions all configured from the browser with no server access required.

5.6 AI Assistant

NestIQ includes a built-in AI chat assistant powered by Google Gemini, deployable across the entire platform 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 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 unavailable, ensuring consistent uptime
• Fully configurable from Admin Settings: enable/disable, API key, bot name, welcome message — no code deployment required for any configuration change
• Compatible with Google Gemini's free tier (testing and light traffic) 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 ever shown to visitors

Benefit: A 24/7 property assistant that knows the agency's actual live 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: Real estate transactions in many markets are settled offline at a negotiated price. NestIQ is built around this reality — agents record what was paid and when, not what a gateway processed.

• 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 per payment record
• Automatic invoice numbering (INV-2026-00001 format, per year)
• Automatic email receipts and in-app notifications on payment recording
• Branded printable receipts — agency logo and name displayed prominently; accessible by client, agent, and admin; 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 proper bookkeeping layer with professional branded receipts and accurate outstanding-balance reporting that keeps management informed of real cash-flow status.

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 per role
• Branch-level data scoping enforced in code; cannot be accidentally widened via settings
• Super Admin permanently fully privileged — guaranteed recovery account

Benefit: Roles are genuinely configurable job functions — buyers decide exactly what each role can and cannot do without code changes.

5.9 Notifications & Communications

• Branded transactional emails for every key event: registration verification, welcome, booking confirmed/cancelled/completed, listing approved/rejected, payment received, refund processed, password reset
• SMTP fully configurable from Admin Settings — host, port, credentials, encryption, From name and address; DB settings override .env automatically; no server file editing for any mail change
• Email Agent modal on agent public profiles — compose and send a direct email 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 and contact points
• 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 with no code changes

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

7. Ownership, Customisation & Branding

NestIQ is sold as a complete, ownable codebase — no subscription, no per-seat fee, no dependency on the seller's infrastructure after delivery:

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

8.1 Payment Methods Supported

NestIQ does not process payments online. The following methods record how a client physically paid an agent, for bookkeeping purposes:

Clients pay the agent directly, and the agent records that payment so both parties have a receipt, running balance, and complete audit trail — in the dashboard and by email. If a payment gateway integration (Flutterwave, Paystack, Stripe, or PayPal) is required, please contact Lakesoft Solutions.

9. What's New in Version 1.1

10. Summary

NestIQ is the smart operational backbone for a real estate agency — not just a listings portal, but the system a growing multi-branch brokerage actually runs its business on: agents managing their pipeline, managers governing their branch, admins controlling the platform, and a complete, auditable payment and reporting layer underneath all of it.

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 external dependencies.

Its self-hosted, dependency-light architecture and self-service installer make it deployable in under an hour, while its depth — branch-scoped authority, configurable permissions, agent-negotiated deal tracking, AI assistant, and full CMS control — gives it the substance to replace the spreadsheets, WhatsApp threads, and disconnected tools many agencies currently rely on.