Files
LynkedUpPro_CRM/README.md
T
2026-02-11 16:53:31 +05:30

4.3 KiB

Plano Realty CRM - Geospatial Field Service Platform

The Next Generation of Roofing Sales & Territory Management

Plano Realty CRM is an advanced, data-driven platform designed to revolutionize how roofing professionals in Plano, Texas manage their territories, leads, and customer interactions. By combining geospatial intelligence, AI-driven insights, and intuitive workflows, we bridge the gap between field agents and office operations.


🏛️ PART 1: PRODUCT OVERVIEW

🌟 Value Proposition

In a competitive roofing market, speed and data are everything. Traditional spreadsheets and paper maps leave money on the table. Plano Realty CRM solves this by providing:

  • Precision Targeting: Identify "Golden Leads" (older homes with high value) instantly on a map.
  • Operational Efficiency: Automate scheduling and follow-ups with our AI Concierge.
  • Real-Time Intelligence: Know the storm risk and roof condition of every property before you knock.

🤖 The "Plano AI Concierge" (Upgrade)

Our AI is now a full-fledged Sales & Support Engine:

  • For Guests: Acts as a "Seasoned Consultant" to triage emergencies (leaks) vs. sales (inspections). "Hook" logic converts casual visitors into leads.
  • For Employees: Answers complex queries like “What is my win rate this month?” or “Show me the average home value in this zip code.”
  • For Customers: Dynamic logic checks warranty status based on build year and offer personalized maintenance tips.

📊 The Data Dashboard

A 360-degree view of your territory's health.

  1. Golden Leads Scatter Plot: Visualizes high-value opportunities (High Value + Older Built Year).
  2. Risk Index Gauge: A real-time meter combining live wind speed data with the percentage of "Needs Repair" roofs.
  3. Revenue Potential: Bar charts showing which neighborhoods offer the highest ROI based on renovation needs.
  4. Roof Health: A visual breakdown of the entire territory's roof conditions (Good, Fair, Needs Repair).
  5. Owner Intent Funnel: Tracks the pipeline from "Willing to Sell" -> "Hot Leads".

🎨 KEY FEATURES (Latest Updates)

1. "LynkedUp Pro" Branding & UX

  • Glassmorphism UI: A premium, dark-mode-first aesthetic with "Spotlight" cards that glow on hover.
  • Smooth Animations: Global page transitions (Fade/Slide) and silky-smooth collapsible sidebar.
  • System-Wide Dark Mode: Inverted map tiles and high-contrast text for comfortable night viewing.

2. Advanced Geospatial Mapping

  • Interactive Polygons: Color-coded property footprints (Red=Hot Lead, Blue=Customer).
  • Reverse Geocoding: Click anywhere on the map to create a new property record instantly using OpenStreetMap data.

3. Role-Based Access Control (RBAC)

  • Field Agents: View assigned territories, update lead status, and request schedule changes.
  • Admins: Global view of all agents, approval workflows, and system settings.
  • Customers: (Coming Soon) Portal to view project status and request service.

👥 USER ROLES & DEMO ACCOUNTS

To explore the platform, use these pre-configured accounts. Password for ALL accounts is: password

1. Field Agent (Worker)

The primary user. Can view maps, access detailed property data, and manage leads.

  • Username/ID: FA001 (Frank Agent)
  • Alternates: FA002, FA003, FA004, FA005

2. Administrator

The manager. Sees all agents and global stats.

  • Username/ID: ADM01 (Adam Admin)
  • Alternates: ADM02, ADM03

3. Customer (Homeowner)

The client. Limited view of their own property.

  • Username: alice
  • Alternates: bob, charlie

💻 PART 2: DEVELOPER GUIDE

🛠 Tech Stack & Architecture

  • Frontend: React 18 (Vite), Tailwind CSS, Glassmorphism UI.
  • State: MockStore (Simulates Backend/DB), AuthContext (Session Management).
  • AI Engine: Groq SDK (qwen-32b) injected with dynamic system prompts.
  • Visuals: react-leaflet (Maps), recharts (Analytics), lucide-react (Icons).

🚀 Setup & Contribution

  1. Clone: git clone <repo>
  2. Install: pnpm install
  3. Env: Create .env with VITE_GROQ_API_KEY and VITE_OPENWEATHER_API_KEY.
  4. Run: pnpm run dev

Maintained by Satyam Rastogi