PGnex Executive Manager: Complete 14-Step Listing Architecture, Operational Balancing & Host OS

dashboard 1. Platform Overview & Problem Solving

Managing modern student hostels and co-living facilities in high-density education and corporate IT hubs (e.g., Pune, Bengaluru, Delhi NCR, Hyderabad, Kota) presents operational hurdles. Operators deal with fragmented WhatsApp communications, untracked cash handoffs, unnotified move-outs, deposit disputes, and manual spreadsheet accounting that leaks revenue.

PGnex Executive Manager replaces manual overhead by unifying all operational phases into an autonomous operating system—from initial listing verification and room-level inventory configuration to 1st-of-the-month billing automation, real-time rent collection, two-way room shifts, and instant UPI payouts.

hub 2. Ecosystem Synergy: Student Marketplace vs. Host Console Routing

The platform operates as a dual-sided marketplace and enterprise infrastructure engine:

trending_up 3. Host Business Value: Automation ROI vs. Manual Operational Losses

Properties switching from paper registers, personal WhatsApp groups, and spreadsheets to PGnex Executive Manager experience an immediate reduction in revenue leakage, eliminated vacancy lag, and protected deposit settlements.

analytics 3B. Operations Balancing Curves & Industry Benchmark Reports

For enterprise property managers, institutional co-living investors, and operators scaling across multiple branches, workload balancing and operational velocity are paramount. Below is the quantitative audit comparing daily operational strain and cash flow velocity before versus after deploying PGnex Executive Manager.

Competitive Benchmark Matrix

How PGnex Executive Manager compares directly against alternative options in the Indian rental and coliving landscape:

account_tree 4. Global Engine Architecture (admin_pgadmin.js)

The operational backbone of the PGnex Executive Manager Host Console is driven by a centralized JavaScript orchestration engine delivered via /static/js/admin_pgadmin.js. Built on a resilient Hub-and-Spoke model, it decouples navigation, modal states, and data polling from the individual viewport layers.

Core Architectural Guarantees:

• Stationary Universal Dock: The mobile navigation dock (#pgnexUniversalHostDock) resides permanently at z-index: 999999. Rather than re-rendering on page changes, a CSS GPU slider pill glides to the active tab in 0.24s cubic-bezier(0.2, 1.1, 0.35, 1).
• Viewport-Isolated Shape-Morph Loader: When switching routes, the loader only blankets the content viewport (bottom: var(--pgnex-dock-h) on phones), leaving the navigation bar and header buttons accessible.
• Adaptive SWR Delta Poller: Minimizes server requests by computing a state hash every 18 seconds (activePgId:shifts:bookings:messages). If the hash is identical, zero DOM nodes re-render.

checklist_rtl 5. End-to-End Onboarding & Listing Workflow (14 Steps)

The PGnex Executive Manager listing engine guides property owners through a connected 14-step onboarding pipeline:
Account Creation → Profile → Dashboard → Basic Details → Verification → Building Architecture → Room Setup → Pricing → Amenities → Photos → Review & Submit → Admin Audit → Approval → Ongoing Operations.

fact_check 6. Master Data Invariants & Validation Rules

To maintain data consistency across web clients, mobile apps, and database records, PGnex Executive Manager enforces eight core architectural rules:

swap_horiz 7. Multi-PG Active Context Engine (select_pg.html)

Enterprise operators managing multiple properties (e.g., Boys Wing, Girls Wing, Executive Annex) switch contexts using the Multi-Property Context Switcher.

Active property state is synchronized using a three-tier storage pattern:

• URL Query Parameter: ?pg_id=124 takes priority during deep links, shared URLs, and browser history transitions.
• LocalStorage: localStorage.setItem("active_pg_id", "124") preserves the active property between browser sessions and tab reloads.
• SameSite Cookies: document.cookie = "active_pg_id=124; path=/; max-age=2592000; SameSite=Lax" ensures backend Django REST API endpoints receive property context on incoming requests.

function appendPgContext(targetUrl) {
    if (!activePgId || targetUrl.startsWith("#") || targetUrl.startsWith("tel:")) {
        return targetUrl;
    }
    const url = new URL(targetUrl, window.location.origin);
    if (!url.searchParams.has("pg_id")) {
        url.searchParams.set("pg_id", activePgId);
    }
    return url.pathname + url.search + url.hash;
}

event_available 8. Tenant Inquiries & Bed Allotment (confirm_bookings.html)

Resident inquiries arrive in booking_requested or pending status. Property managers review applicant profiles, confirm room types, and allocate specific room and bed numbers.

Bed Allotment Workflow:

Selecting Allocate & Confirm opens the Allotment Modal. The manager selects:

• Target Room Number: Chosen via live inventory dropdown showing currently available rooms (e.g., Room 204).
• Floor & Bed Selection: Floor and Bed chips (Floor 1-4, Bed A-D) populate bed allocations.
• Rent Confirmation: Displays the assessed monthly rate before confirming.
• Confirmation Dispatch: Sends POST /api/seller/bookings/{id}/confirm/. The applicant moves to active resident status and is added to the live rent ledger.

swap_calls 9. Room Shifts, Vacating Notices & Dispute Resolution

Bed transfers and departure requests are managed through change_room_request.html, structured into two operational views:

1. Pending Action Queue:

2. Active Resident Directory:

Provides an overview of all current residents. Managers can initiate internal room transfers or issue formal departure notices with custom clearance dates.

event_repeat 10. Rent Cycles, Ledgers & 13-Day Alert Automation

PGnex Executive Manager enforces a standardized 1st-of-the-month billing cycle across all managed properties.

Billing Cycle Progress Formula:

// Calculate days in target month:
total_days = new Date(year, month + 1, 0).getDate();
day_elapsed = (current_month === target_month) ? now.getDate() : 1;
days_remaining = Math.max(0, total_days - day_elapsed);
progress_pct = ((day_elapsed / total_days) * 100).toFixed(1);

// 13-Day Alert Window Trigger:
is_alert_active = (days_remaining <= 13);

Automated 13-Day Alert Schedule:

When days_remaining <= 13, the dashboard circular gauge switches to an active warning state, and the system sends automated reminders via WhatsApp and Push notifications with personalized payment links.

gavel 11. 3-Tier Security Deposit Out-Settlement Engine

During tenant move-outs, security deposits are reconciled using a standardized 3-tier settlement workflow:

savings 12. Payouts & Mandatory ₹15 Reserve Buffer

Online rent payments settle into the property's financial escrow. Managers access funds through withdrawal.html, featuring real-time balance tracking.

Payout Execution:

Managers request payouts by entering an amount and their verified UPI VPA (e.g., host@okhdfcbank). Payouts route via 24x7 IMPS rails with settlements completing in under 60 seconds, accompanied by downloadable PDF settlement advice slips with UTR tracking codes.

chat 13. Resident Live Chat & In-Browser Canvas Compression

Replaces personal messaging threads with a dedicated communications desk built directly into message.html.

• WebSocket Messaging (WSS): Real-time messaging with automatic heartbeat pings every 25 seconds.
• In-Browser Canvas Image Compression: Compresses high-res photo uploads (up to 15MB) down to under 70KB in WebP format using an HTML5 Canvas before transfer, saving data and time.
• Read Receipts: Outgoing chat bubbles display real-time "Sent" and "Seen" timestamps.
• Mobile Keyboard Optimization: When opening a conversation on mobile devices, body.mobile-chat-open hides the bottom dock to prevent keyboard overlap.

terminal 14. Machine-Readable API Reference & Data Contracts

Core REST endpoints and WebSocket channels for mobile clients and third-party integrations:

quiz 15. Frequently Asked Questions (FAQ)

Q: How do offline cash payments work with the automated rent ledger?

When a tenant pays rent in cash at reception, the manager goes to rents.html, selects Pending Dues, and taps Record Cash on the tenant's row. The system marks the month as paid, clears the tenant from the 13-day overdue alert sequence, updates the circular cycle gauge, and generates a printable cash receipt PDF.

Q: What happens if an owner edits property details after listing approval?

Standard listing updates (such as amenity tags, house rules, or photo ordering) take effect immediately. Critical modifications—including property address, GPS pin, legal ownership name, or registered bank accounts—flag the listing for admin review to safeguard tenant security.

Q: How does PGnex Executive Manager prevent duplicate bed bookings?

The platform enforces Room as Source of Truth. Every bed maintains an atomic status in PostgreSQL. When an allotment confirmation begins, the target bed record is temporarily locked. If two inquiries target the same bed simultaneously, the first completed transaction is confirmed while the second is prompted to choose another available bed.

Q: Why does the withdrawal system enforce a ₹15 reserve buffer?

The ₹15.00 buffer prevents banking webhook reconciliation failures, avoids micro-overdraft penalties, and keeps the property's financial escrow account active between billing cycles.