feat: Latest updates
This commit is contained in:
Satyam
@@ -14,24 +14,14 @@ In a competitive roofing market, speed and data are everything. Traditional spre
|
||||
- **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 Assistant" (Chatbot)
|
||||
Our AI is not just a support bot; it is a context-aware worker that understands your business data.
|
||||
|
||||
#### For Field Agents (Workers)
|
||||
- **"Smart Querying"**: Ask *“Show me the properties built before 2000”* or *“Which homeowner wants to sell?”*.
|
||||
- **Lead Qualification**: The AI knows which leads are "Hot" and prompts you to prioritize them.
|
||||
- **Risk Analysis**: Ask *“What is the current storm risk?”* to get a breakdown of wind speeds vs. roof vulnerability.
|
||||
|
||||
#### For Customers (Homeowners)
|
||||
- **Instant Diagnostics**: (Future) Schedule inspections without waiting on hold.
|
||||
- **Project Updates**: Check the status of their roof repair.
|
||||
|
||||
#### For Guests (Website Visitors)
|
||||
- **Lead Capture**: The AI engages visitors, answers generic questions about roofing services, and encourages them to sign up or request a free estimate.
|
||||
### 🤖 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.
|
||||
@@ -40,20 +30,25 @@ A 360-degree view of your territory's health.
|
||||
|
||||
---
|
||||
|
||||
## � KEY FEATURES (Latest Updates)
|
||||
## 🎨 KEY FEATURES (Latest Updates)
|
||||
|
||||
### 🎨 "LynkedUp Pro" Branding & UX
|
||||
### 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.
|
||||
- **Visual Polish**: Glassmorphism everywhere, custom "LynkedUp" loaders, and pulsing interactive elements.
|
||||
- **Dark Mode**: Fully supported system-wide dark mode with inverted map tiles for comfortable night viewing.
|
||||
- **System-Wide Dark Mode**: Inverted map tiles and high-contrast text for comfortable night viewing.
|
||||
|
||||
### 🌍 Advanced Mapping
|
||||
- **Lead Creation**: Click anywhere on the map to reverse-geocode addresses and create new leads on the fly.
|
||||
- **Polygon Visualization**: Color-coded property footprints indicating status (Hot Lead, Customer, etc.).
|
||||
### 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
|
||||
## 👥 USER ROLES & DEMO ACCOUNTS
|
||||
|
||||
To explore the platform, use these pre-configured accounts. **Password for ALL accounts is: `password`**
|
||||
|
||||
@@ -61,63 +56,28 @@ To explore the platform, use these pre-configured accounts. **Password for ALL a
|
||||
*The primary user. Can view maps, access detailed property data, and manage leads.*
|
||||
- **Username/ID**: `FA001` (Frank Agent)
|
||||
- **Alternates**: `FA002`, `FA003`, `FA004`, `FA005`
|
||||
- **Role Capabilities**:
|
||||
- Access Dashboard & Widget Data.
|
||||
- View/Edit Lead Status (Hot, Cold, Customer).
|
||||
- Use Chatbot with full data context.
|
||||
|
||||
### 2. Administrator
|
||||
*The manager. Sees all agents and global stats.*
|
||||
- **Username/ID**: `ADM01` (Adam Admin)
|
||||
- **Alternates**: `ADM02`, `ADM03`
|
||||
- **Role Capabilities**:
|
||||
- All Agent capabilities + User Management (Mock).
|
||||
|
||||
### 3. Customer (Homeowner)
|
||||
*The client. Limited view of their own property.*
|
||||
- **Username**: `alice`
|
||||
- **Alternates**: `bob`, `charlie`
|
||||
- **Role Capabilities**:
|
||||
- View personal property details.
|
||||
- Request Service.
|
||||
|
||||
---
|
||||
|
||||
## 💻 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-3-32b`) injected with dynamic system prompts.
|
||||
- **AI Engine**: Groq SDK (`qwen-32b`) injected with dynamic system prompts.
|
||||
- **Visuals**: `react-leaflet` (Maps), `recharts` (Analytics), `lucide-react` (Icons).
|
||||
|
||||
### 🧠 Deep Dive: How It Works
|
||||
|
||||
#### 1. The "Mock Store" (Data Layer)
|
||||
Located in `src/data/mockStore.jsx`. It generates ~60 realistic property records using weighted randomization algorithms to create organic-looking data distributions (e.g., 10% bad roofs, random build years).
|
||||
- **Why?**: To provide a rich, testable dataset without needing a live backend database.
|
||||
|
||||
#### 2. AI Context Injection
|
||||
Located in `src/components/Chatbot.jsx`.
|
||||
- When a user sends a message, we don't just send their text. We inject a **System Prompt** containing live dashboard metrics.
|
||||
- **Example Injection**:
|
||||
```text
|
||||
SYSTEM: You are a roofing assistant.
|
||||
CONTEXT:
|
||||
- 45 Total Properties
|
||||
- 12 Golden Leads (Top: 123 Maple Dr)
|
||||
- 8 Hot Leads needing canvassing
|
||||
```
|
||||
- This allows the AI to answer specific questions accurately.
|
||||
|
||||
#### 3. Leaflet Customization
|
||||
Located in `src/pages/Maps.jsx`.
|
||||
- We use custom SVGs overlays on the map.
|
||||
- **Reverse Geocoding**: Clicking a blank spot calls the OpenStreetMap API to fetch the address, allowing agents to "create" new property records on the fly.
|
||||
|
||||
### 🚀 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`.
|
||||
|
||||
Reference in New Issue
Block a user