Satyam
2eaac6b84a
- Add Owner, Contractor, Vendor, Subcontractor dashboards and role-based routing - Owner now has superuser access to all Admin pages (dashboard, schedule, leaderboard) - Redesign landing page mobile menu as slide-in sidebar (replaces broken Framer Motion overlay) - Add body scroll lock to app sidebar for mobile consistency - Fix Team Schedule to match Admin Dashboard design language (ambient glows, gradient header, SpotlightCard, zinc palette) - Fix login page tab overflow — use abbreviated labels and grid layout for 6 role tabs - Fix Recharts ResponsiveContainer warnings — replace height="100%" with fixed pixel heights - Fix lightbox image viewer — unified nav bar, touch swipe support, no more overlapping text - Add AI Assistant page, People/Vendor/Document management for Owner role - Expand mock data store with contractor, vendor, and subcontractor data
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 Admins: Provides instant summaries of urgent actions (Unassigned Leads, Pending Signatures) and business health.
- For Customers: Dynamic logic checks warranty status based on build year and offers personalized maintenance tips.
📊 The Data Dashboard
A 360-degree view of your territory's health.
- Admin Action Center: A dedicated command center for managers to assign leads, approve schedules, and track urgent tasks.
- Golden Leads Scatter Plot: Visualizes high-value opportunities (High Value + Older Built Year).
- Risk Index Gauge: A real-time meter combining live wind speed data with the percentage of "Needs Repair" roofs.
- Revenue Potential: Bar charts showing which neighborhoods offer the highest ROI based on renovation needs.
- Roof Health: A visual breakdown of the entire territory's roof conditions (Good, Fair, Needs Repair).
🎨 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. Admin Action Center (NEW)
- Unassigned Leads: Instant visibility into new opportunities that need an owner.
- Hot Leads: Track high-value prospects that haven't been contacted in >7 days.
- Smart Assignment: "One-click" agent assignment with a searchable modal.
- Urgency Counters: visual badges highlighting pending signatures and reschedule requests.
3. 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.
4. 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.
5. Enterprise-Grade Reliability (NEW)
- Resilient AI: Chatbot restores user input on network failure, preventing frustration.
- Global Error Boundaries: Catches unexpected crashes and offers a graceful "Reload" option.
- Visual Feedback: Comprehensive toast notifications for all data actions (Success/Error states).
👥 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, global stats, and the Action Center.
- 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). - Reliability:
sonner(Toasts), Error Boundaries, Layout Portals.
🚀 Setup & Contribution
- Clone:
git clone <repo> - Install:
pnpm install - Env: Create
.envwithVITE_GROQ_API_KEYandVITE_OPENWEATHER_API_KEY. - Run:
pnpm run dev
Maintained by Satyam Rastogi