Skip to main content

New PRD

Assumptions

  • Timeline: 4 weeks (1 month)

  • Scope: Broker-first MVP with lead management, basic AI assistance, and panoramic / virtual tours

  • Team: Ideally 2–3 developers + 1 product/UX working in parallel


Week 1 – Product, Architecture, and Core Skeleton

Product & UX

  • Lock final scope with broker-first focus:

    • Brokers as the primary entity

    • Properties discovered only through brokers

    • Controlled visibility (public / sneak-peek / private)

  • Define end-to-end user journeys for:

    • Broker Admin

    • Broker Employees (manager, agent, viewer)

    • End users (renters/buyers)

  • Create low-fidelity wireframes for:

    • Broker public profile page

    • Broker dashboard:

      • Employees

      • Properties

      • Leads

    • User broker discovery flow

    • Broker detail page with:

      • Public listings

      • Sneak-peek listings

    • Lead/contact creation flow

    • Property viewing (public and shared/private)

    • AI assistance entry point (broker side)

    • Panoramic / virtual tour viewer

Architecture & Setup

  • Choose tech stack:

    • Frontend: React / Next.js

    • Backend: Node.js (NestJS or similar)

    • Database: PostgreSQL

    • Cache: Redis

    • Vector search: pgvector (or equivalent)

    • Storage: Object storage for images and 360° media

  • Set up:

    • Repositories and basic CI

    • Dev and staging environments

    • Authentication base (email + password, roles stubbed)

  • Define initial data models & API contracts:

    • Entities:

      • User

      • Broker / Agency

      • Employee

      • Property

      • Property Privacy Level (Public / Sneak-Peek / Private)

      • Lead

      • Media (images, 360° tours)

      • Location

      • Activity Log

    • APIs:

      • Auth

      • Broker & employee management

      • Property CRUD

      • Lead creation

      • Broker public pages

      • Media upload & access

Goal (Week 1):
Clear UX flows, finalized data models, API contracts defined, and frontend + backend skeletons running with auth stubbed or implemented.


Week 2 – Core Broker & User MVP

Backend Implementation

  • Implement models & migrations for:

    • Users, brokers/agencies, employees

    • Properties with privacy levels

    • Leads with basic statuses

    • Locations

  • Implement core APIs:

    • Authentication (signup, login, session handling)

    • Broker creation and profile management

    • Employee invite, role assignment, and access control

    • Property lifecycle:

      • Draft → Pending Review → Published / Rejected

    • Lead creation and assignment to broker/employees

  • Integrate geocoding:

    • Address → latitude/longitude during property creation

    • Store and index location data

Frontend Implementation

  • Broker dashboard:

    • Employee management (invite, role view)

    • Property creation and editing

    • Property approval workflow

    • Lead list (basic)

  • User flows:

    • Browse brokers

    • Broker public profile page

    • View public and sneak-peek listings

    • Contact broker form

  • Access control:

    • Anonymous browsing with limits

    • Signup wall after limit exceeded

Goal (Week 2):

  • Brokers can fully manage inventory and employees

  • Users can browse brokers and submit leads

  • Property approval and RBAC work end-to-end


Week 3 – AI Assistance & Panoramic / Virtual Tours

AI Assistance (Broker-Focused)

  • Implement embeddings + vector search over broker inventory

  • Index:

    • Property title and description

    • Location text

    • Key attributes (rent, type, size, amenities)

  • AI capabilities:

    • Match lead requirements to broker properties

    • Rank properties for a specific lead

  • API:

    • Input: lead context or free-text query

    • Output: ranked list of broker properties

Panoramic / Virtual Tours

  • Define minimal v1 support:

    • 360° images and/or external virtual tour links

  • Backend:

    • Media upload and association with properties

    • Storage and access control for tours

  • Frontend:

    • Integrated 360° viewer on property pages

    • View available tours for public and shared properties

Controlled Property Sharing

  • Allow brokers to:

    • Share private properties with specific users

    • Track which leads can view which properties

  • User can view shared properties only within the platform

Goal (Week 3):

  • Brokers can shortlist properties using AI

  • Users can view panoramic tours for shared properties

  • Private property sharing works securely


Week 4 – Hardening, Analytics, and Launch Prep

UX & Polish

  • Improve validation and error handling

  • Add loading and empty states

  • Responsive layouts for mobile and tablet

  • Refine broker public pages:

    • Branding

    • Public inventory

    • Contact actions

Security & RBAC

  • Finalize permission enforcement for:

    • Broker Admin

    • Manager

    • Agent

    • Viewer

    • User

    • Platform Admin

  • Security hardening:

    • Rate limiting

    • Input validation

    • Secure sessions and cookies

Analytics

  • Broker dashboard metrics:

    • Leads received

    • Properties shared

    • Property views per lead

  • Platform admin metrics:

    • Active brokers

    • Total leads

    • Active properties

  • Activity/event tracking:

    • Broker profile views

    • Property views

    • Lead creation

    • Property sharing actions

Testing & Stabilization

  • Unit tests for core services

  • End-to-end tests:

    • Broker signup

    • Property approval

    • User contact flow

    • Private property sharing

  • Manual QA across major devices and browsers

Launch Readiness

  • Seed demo brokers and sample properties

  • Document:

    • Known limitations

    • Technical debt

    • Post-MVP roadmap

  • Prepare deployment and rollback plans

Goal (Week 4):

  • Stable broker-first MVP

  • All core workflows verified

  • Ready for pilot users