# 🏛️ Dham Seva — Grand Homepage Architecture & Roadmap
## Complete Master Blueprint (`pages/homepage.md`)

> **Executive Vision:**  
> The Dham Seva Homepage is the supreme spiritual and commercial gateway to Sri Braj Dham. It is engineered with three driving pillars:
> 1. **Universal Discovery (Google-Style 100vh Hero Search):** Instant, frictionless search across all Temples, Sacred Kathas, Services, Vendors, and Festivals.
> 2. **Multi-Touchpoint Devotional Giving (Continuous Seva & Donations):** 5 emotionally resonant, varied donation formats (Urgent Campaigns, 1-Click Matrix, Tithi Seva, Top Ticker, Sticky Bottom Bar) maximizing donor conversion and seva participation.
> 3. **Sacred E-Commerce & Service Directory:** Amazon/Flipkart-style spiritual marketplace + IndiaMART/Justdial-style verified yatri services with instant Call/WhatsApp lead generation.
> 4. **100% Dynamic Admin Control:** Every section, heading, banner, and target amount is fully editable and toggleable from the Admin Panel (`/admin/home-sections`) with zero hardcoding.

---

## 📑 12 Master Homepage Sections

```mermaid
flowchart TD
    S1["Section 01: Google-Style Universal Search Hero (100vh)"] --> S2["Section 02: IndiaMART / Justdial Services Directory"]
    S2 --> S3["Section 03: Seva Touchpoint 1 — 1-Click Seva Matrix (₹101 to ₹1100)"]
    S3 --> S4["Section 04: Amazon / Flipkart Style Sacred Braj Haat (Products)"]
    S4 --> S5["Section 05: Seva Touchpoint 2 — Active Cause Campaigns (Live Progress)"]
    S5 --> S6["Section 06: 84 Kos Sacred Braj Darshan (Geography)"]
    S6 --> S7["Section 07: Devotee Authors & Sacred Kathas Hub"]
    S7 --> S8["Section 08: Daily Live Darshan & Temple Aarti Timings"]
    S8 --> S9["Section 09: Seva Touchpoint 3 — Tithi & Family Memory Seva Sankalp"]
    S9 --> S10["Section 10: Spiritual Calendar & Upcoming Festivals"]
    S10 --> S11["Section 11: 24x7 Yatri Helpline & Offline Yatra Slip"]
    S11 --> S12["Section 12: Seva Touchpoint 4 — Persistent Sticky Golden Seva Bar"]
```

---

## 🌟 Detailed Section Breakdown

### 1️⃣ SECTION 01: Google-Style Universal Search Hero (Full Viewport - 100vh)
- **Visuals:** Full screen height (`100vh`), cinematic high-res Braj background image (`/images/hero/hero-main.jpg`), subtle golden lighting orbs, and dark vignette overlay.
- **Top Urgency Ticker (Seva Touchpoint 0):**  
  `🚩 आज का पावन संकल्प: 100 असहाय गौवंश हेतु नित्य गौ-ग्रास सेवा — [मात्र ₹101 से सहयोग करें ↗]`
- **Grand Typography:**  
  `Dham Seva — Sri Dham Braj`  
  *“दर्शन करें • कथाएँ पढ़ें • सेवा से जुड़ें • ब्रज का सान्निध्य पाएँ”*
- **The Google-Style Search Engine (`#hero-search`):**
  - Full-width, clean white/cream rounded bar (`height: 64px`, `border-radius: 999px`, box-shadow: `0 12px 40px rgba(0,0,0,0.25)`).
  - Search icon 🔍 + Microphone/Voice icon + Gold Action Search button.
  - Placeholder: `श्री धाम वृंदावन, मंदिर, कथा, बाज़ार, संत या सेवा खोजें...`
  - **Live Auto-Suggest Flyout:**  
    Typing 2+ characters instantly categorizes matches into:
    - 🛕 **Temples:** e.g., *Banke Bihari Ji, Radharaman Ji*
    - 📜 **Kathas:** e.g., *Bihari Ji Praakatya Rahasya*
    - 🏪 **Services:** e.g., *Dharamshala, Pandit, Cab*
    - 🛍️ **Products:** e.g., *Mathura Peda, Tulsi Mala*
- **Quick Category Chips:**  
  `🛕 मंदिर दर्शन` • `📜 पावन कथाएँ` • `🛍️ ब्रज उत्पाद` • `🏨 धर्मशाला/होटल` • `👤 तीर्थ पुरोहित` • `🐄 गौ सेवा` • `🎉 आगामी उत्सव`

---

### 2️⃣ SECTION 02: IndiaMART / Justdial Style — Pilgrimage Services Directory
- **Concept:** B2B/B2C pilgrimage utility strip connecting yatris directly to verified vendors with instant lead generation.
- **Service Categories Grid:**
  1. 🏨 **Dharamshala, Ashram & Hotel Booking:** Clean, satvik stays close to temples.
  2. 👤 **Verified Teerth Purohits & Pandits:** Puja, Hawan, Shradh, and Kashi/Braj rituals.
  3. 🚕 **84 Kos Parikrama Cabs & E-Rickshaws:** Fixed rates, trusted local drivers.
  4. 🍲 **Satvik Catering & Bhandara Seva:** Pure desi ghee prasadam for yatris & sadhus.
  5. 📸 **Braj Yatra Guides & Photography:** Experienced local guides.
- **Vendor Card Structure (Justdial/IndiaMART Style):**
  - Business Logo / Thumbnail + `✓ Verified Vendor` Blue Badge.
  - Rating: `4.9 ★ (140+ Reviews)` + Location pill (e.g. *Parikrama Marg, Vrindavan*).
  - Highlights: `24x7 Check-in`, `AC Rooms`, `Satvik Bhojan`.
  - **3 Instant CTA Buttons:**
    - `📞 Call Now` (direct tel: trigger)
    - `💬 WhatsApp Enquiry` (prefilled WhatsApp message with listing name)
    - `📝 Get Best Quote` (instant lead modal)

---

### 3️⃣ SECTION 03: Seva Touchpoint 1 — 1-Click Interactive Golden Seva Matrix
- **Concept:** Ultra-low friction, high-conversion donation strip placed early on the page.
- **Visuals:** Rich gold-saffron gradient background (`linear-gradient(135deg, #F2B622, #AC6106)`), shimmer border, and devotional icons.
- **Header:**  
  *“ठाकुर जी की पावन सेवा में अपना नित्य सहयोग समर्पित करें”*  
  *(Your small contribution feeds cows, serves sadhus, and maintains sacred kunds)*
- **Interactive Quick-Amount Matrix:**
  - `[ ₹101 ]` — 1 समय का गौ ग्रास (Cow Fodder)
  - `[ ₹251 ]` — 1 साधु भोजन सेवा (Sadhu Prasadam)
  - `[ ₹501 ]` — पावन दीपदान व मंदिर सेवा (Temple Light & Seva)
  - `[ ₹1,100 ]` — अन्न क्षेत्र सेवा (Bhandara Seva)
  - `[ अन्य राशि (Custom) ]`
- **Instant Checkout:**  
  Clicking any amount opens the seamless Razorpay/UPI QR modal with instant 80G tax receipt guarantee.

---

### 4️⃣ SECTION 04: Amazon / Flipkart Style — Sacred Braj Haat (E-Commerce Products Grid)
- **Concept:** Vibrant, trusted multi-vendor spiritual marketplace with e-commerce design patterns.
- **Category Filter Tabs:**  
  `🔥 Bestseller` • `✨ New Arrival` • `🌸 Puja Samagri` • `🍬 Braj Prasad` • `📿 Tulsi Mala`
- **Product Card UI (Amazon/Flipkart Tokens):**
  - Product Image with zoom on hover.
  - Floating Badges: `20% OFF`, `100% Satvik`, `Bestseller`.
  - Vendor attribution: `विक्रेता: श्री बांके बिहारी प्रसादम भंडार (✓ Verified)`.
  - Title: *शुद्ध देशी घी मथुरा पेड़ा (500g फैमिली पैक)*.
  - Price: **₹349** <del style="color:#94a3b8;">₹435</del> *(Save ₹86)*.
  - Star Rating: `4.9 ★ (280+ Reviews)`.
  - **Action Buttons:**  
    - `🛒 Add to Cart`  
    - `🟢 WhatsApp Order` (Order directly via shopkeeper's WhatsApp).

---

### 5️⃣ SECTION 05: Seva Touchpoint 2 — Crowdfunding & Medical Relief (क्राउडफंडिंग व जीवन रक्षा अभियान)
- **Concept:** Transparent multi-user crowdfunding ecosystem (Medical, Gau Seva, Trusts, Education) with real-time goals, live donors recognition, and category-driven fields. Details in [`pages/crowdfunding.md`](file:///d:/TBDST/Back_Up/Ai%20Work/Dham%20Seva/pages/crowdfunding.md).
- **Featured Live Campaigns Grid:**
  - **🏥 Medical:** *7-Year-Old Aarav's Open Heart Surgery at AIIMS*  
    `₹1,85,000 raised` of `₹2,50,000 goal` *(74% funded | 142 Donors)* • Verified Hospital Seal.
  - **🐄 Gau Seva:** *Winter Shelter & Medical Surgery for 350 Injured Cows*  
    `₹1,20,000 raised` of `₹1,50,000 goal` *(80% funded | 95 Donors)*.
  - **🍲 Trust & Sadhu Seva:** *Daily Annakshetra for 500 Sadhus in Vrindavan*  
    `₹3,10,000 raised` of `₹5,00,000 goal` *(62% funded | 210 Donors)*.
- **Public Donors Wall Preview:**  
  Live scroll of real contributors: `श्रीमती सुनीता शर्मा (जयपुर, राजस्थान) — ₹1,100` • `रमेश अग्रवाल (इंदौर, म.प्र.) — ₹501`.
- **Dual Action Buttons:**
  - `[ 🙏 अभी सहयोग करें ]` ➔ Opens Instant UPI / 80G Checkout Modal.
  - `[ ➕ क्या आपको सहायता चाहिए? अपना निःशुल्क अभियान शुरू करें ]` ➔ Links to `/fundraiser/create`.

---

### 6️⃣ SECTION 06: 84 Kos Sacred Braj Darshan (Interactive Sacred Geography)
- **Concept:** Visual atlas of Braj Mandal's 8 divine pilgrimage centers connecting directly to `/explore/{slug}` and Temple profiles.
- **Destinations Grid:**
  1. **वृंदावन (Vrindavan):** The realm of divine Raas Leela & 5,000 temples.
  2. **मथुरा (Mathura):** Lord Krishna's divine birth place (Janmabhoomi).
  3. **गोवर्धन (Govardhan):** Sri Giriraj Ji, the hill of divine protection.
  4. **बरसाना (Barsana):** The palace and realm of Sri Radha Rani.
  5. **नंदगांव (Nandgaon):** Nanda Baba's abode & Pan Sarovar.
  6. **गोकुल (Gokul):** Krishna's sweet childhood leelas on the Yamuna bank.
  7. **राधा कुंड (Radha Kund):** The crest-jewel of holy kunds.
  8. **बलदेव (Baldeo):** Sri Dauji Maharaj's divine throne.
- **Card Elements:** Hero photo, Temple count badge, Distance from Mathura junction, and "दर्शन करें" button.

---

### 7️⃣ SECTION 07: ✍️ Devotee Authors & Sacred Kathas Hub
- **Concept:** Spotlight on devotee scholars, kathavachaks, and verified pilgrim authors.
- **Top Authors Strip:**
  - Circular avatar with golden border.
  - Name + Vanity Handle (`/@username`) + Spiritual title (*भागवत कथा व्यास*).
  - Follower count & `⭐ Verified Scholar` badge.
- **Trending Kathas Cards:**
  - Category Badge: `🛕 मंदिर दर्शन`, `🧘‍♂️ संत चरित्र`, `📜 लीला कथाएँ`.
  - Title, author name, reading time (`⏱️ 4 min read`), and audio katha icon.
  - Action: Read Katha + Seva Donation trigger.

---

### 8️⃣ SECTION 08: 🌸 Daily Live Darshan & Temple Aarti Timings
- **Concept:** Real-time pilgrimage schedule helping yatris plan their day across Mathura-Vrindavan.
- **Temple Tabs:** `बांके बिहारी जी` • `राधारमण जी` • `राधावल्लभ जी` • `इस्कॉन` • `द्वारकाधीश जी`
- **Schedule Table:**
  - 🌅 **मंगला आरती:** 05:00 AM – 05:30 AM
  - ☀️ **श्रृंगार आरती व दर्शन:** 07:45 AM – 12:00 PM
  - 🍲 **राजभोग आरती:** 11:55 AM
  - 🌙 **संध्या व शयन आरती:** 05:30 PM – 09:30 PM
- **Live Status Indicator:** `🟢 पट खुले हैं (Open for Darshan)` or `⏳ पट बंद हैं (Reopens at 5:30 PM)`.

---

### 9️⃣ SECTION 09: Seva Touchpoint 3 — Tithi & Family Memory Seva Sankalp
- **Concept:** High-ticket, deeply personal donation avenue for birthdays, wedding anniversaries, and ancestor remembrance (Pitru Shradh).
- **Form Wizard:**
  - Step 1: Select Occasion (🎂 Birthday / 💍 Anniversary / 🕯️ Pitru Tithi / 🌸 Gratitude).
  - Step 2: Choose Seva (Gau Seva, Sadhu Bhandara, Temple Deepdan, Vidya Daan).
  - Step 3: Enter Devotee Name & Gotra for Sankalp recitation by priests.
  - Step 4: Confirm Seva amount & receive Digital Blessings / Sankalp Patra.

---

### 🔟 SECTION 10: 🎉 Upcoming Spiritual Calendar & Festivals
- **Concept:** Dynamic countdown and schedule for all major Braj festivals.
- **Festivals Showcase:**
  - 🎨 **बरसाना लठमार होली (Barsana Lathmar Holi)** — Live countdown timer.
  - 🌕 **शरद पूर्णिमा महारास उत्सव (Sharad Purnima)**
  - ⛰️ **गोवर्धन अन्नकूट परिक्रमा (Govardhan Annakut)**
  - 🌸 **श्री राधाष्टमी व श्रीकृष्ण जन्माष्टमी (Radhashtami & Janmashtami)**
- Features: History, darshan guidelines, crowd alerts, and temple routes.

---

### 1️⃣1️⃣ SECTION 11: 👜 24x7 Yatri Helpline & Offline Yatra Slip
- **Concept:** Essential pilgrim safety and offline utility.
- **Emergency Helplines:** Police (100 / 0565-2540333), Ambulance (108), Women Helpline (181), Tourist Help (1363).
- **1-Click Action:**  
  `👜 अपनी डिजिटल यात्रा पर्ची डाउनलोड करें (Download Offline Yatra Slip)`  
  *(Contains all temple timings, emergency contacts, and yatra checklist offline)*.

---

### 1️⃣2️⃣ SECTION 12: Seva Touchpoint 4 — Persistent Sticky Golden Seva Bar
- **Concept:** Non-intrusive, elegant floating bar at the bottom of the screen (Mobile & Desktop).
- **Copy:**  
  `🚩 श्री राधा-कृष्ण कृपा | ब्रज सेवा में जुड़ें — मात्र ₹101 से शुरुआत करें`
- **CTA:** `[ 🙏 अभी सेवा करें ]` (Opens quick checkout modal).

---

## ⚙️ Backend Admin Control Architecture (`/admin/home-sections`)

Every single section is backed by:
1. **Database Table:** `homepage_sections` (`section_key`, `content`, `is_active`, `is_visible`, `sort_order`, `style`).
2. **Configuration File:** `config/homepage_sections.php` (Defines editable text, image, repeater, and color fields).
3. **Admin Controller:** `App\Http\Controllers\Admin\HomeSectionAdminController.php`.
4. **Admin UI:** `/admin/home-sections` (Toggle visibility, reorder via drag/sort, live form editor for titles, banners, amounts, and copy).

---

## 🚀 Step-by-Step Implementation Roadmap

| Phase | Milestone | Deliverable |
| :--- | :--- | :--- |
| **Phase 1** | **Roadmap & Architecture** | `pages/homepage.md` created & committed. |
| **Phase 2** | **Backend Config & Database Sync** | Update `config/homepage_sections.php` with all 12 sections, products, services, campaigns, and dynamic fields. |
| **Phase 3** | **HomeController Data Aggregation** | Update `HomeController.php` to fetch real database entities: Directory Products, Services, Active Campaigns, Authors, Kathas, Temples, and Festivals. |
| **Phase 4** | **Blade Template Overhaul** | Upgrade `resources/views/frontend/home.blade.php` with clean modular partials for all 12 sections. |
| **Phase 5** | **Google-Style Universal Search Engine** | Implement 100vh Hero with real-time auto-suggest dropdown across all models. |
| **Phase 6** | **E-Commerce & Directory Integration** | Amazon/Flipkart product cards with WhatsApp order + Justdial service cards with Call/Quote actions. |
| **Phase 7** | **Multi-Touchpoint Seva Engines** | Connect 1-click Matrix, Cause Campaigns, Tithi Sankalp, and Sticky Bar to `DonationService`. |
| **Phase 8** | **Admin Panel Verification** | Test `/admin/home-sections` to verify every section can be turned on/off and edited seamlessly. |
| **Phase 9** | **End-to-End Browser Testing** | Subagent verification on `http://localhost:8000/` across desktop and mobile screens. |

---

*This blueprint is verified, structured, and ready for immediate implementation.*
