# 💖 Dham Seva — Sacred Seva & Itemized Donations Ecosystem
## Module Architecture & Financial Blueprint (`modaul/donation.md`)

> **Executive Overview:**  
> The **Dham Seva Seva & Donation Engine** powers continuous, frictionless spiritual contributions across Braj Dham and worldwide. Built on pure devotion, trust, and instant automated transparency.

---

## 🏛️ 1. Core Financial Features

1. **1-Click Golden Seva Matrix:**
   - त्वरित पूर्व-निर्धारित सेवा राशियां: `₹101`, `₹251`, `₹501`, `₹1100`, या कस्टम राशि।
   - मोबाइल पर सिंगल टैप से सीधे UPI (GPay, PhonePe, Paytm, BHIM) खुलता है।
2. **आइटमाइज्ड सेवा अभियान (Itemized Seva Drives):**
   - 🐄 **गौ सेवा महायज्ञ:** 1 दिन का हरा चारा (₹501), 1 माह की गौ चिकित्सा (₹2100), 1 शेड निर्माण (₹11000)।
   - 🥣 **साधु व वैष्णव अन्न क्षेत्र:** 101 संतों का महाप्रसाद (₹2500), नित्य भोजन सेवा (₹501)।
   - 🛕 **मंदिर दीपदान व पुष्प सेवा:** नित्य संध्या आरती दीपदान (₹101), फूल बंगला सेवा (₹5100)।
   - 🌊 **यमुना जी आरती व तट स्वच्छता:** सायंकालीन आरती महाप्रसाद (₹251)।
3. **तिथि व परिवार स्मृति सेवा संकल्प (Memory Seva Sankalp):**
   - श्रद्धालु अपने पूर्वजों की पुण्यतिथि, माता-पिता के जन्मदिन या वैवाहिक वर्षगांठ पर अग्रिम सेवा संकल्प ले सकते हैं।
   - सिस्टम उस तिथि को स्वतः यजमान के नाम से गौशाला या मंदिर में सेवा अर्पित करता है और WhatsApp पर फोटो भेजता है।
4. **ऑटोमेटेड 80G रसीद व WhatsApp आभार:**
   - भुगतान पूरा होते ही 3 सेकंड में सरकारी 80G कर छूट रसीद (PDF) जनरेट होती है।
   - दानी के WhatsApp नंबर पर रसीद व श्री ठाकुर जी का मंगल आशीर्वाद सन्देश स्वतः प्रेषित होता है।

---

## 🗄️ 2. डेटाबेस आर्किटेक्चर

- `donations` (दान रिकॉर्ड, ट्रांजैक्शन ID, UTR, दानी नाम, पैन, 80G नंबर)
- `seva_items` (आइटमाइज्ड सेवा सूची व मूल्य)
- `seva_drives` (विशिष्ट मौसमी अभियान जैसे शीतकालीन कंबल सेवा, होली उत्सव सेवा)
- `whatsapp_templates` (दान पुष्टि व रसीद के स्वचालित संदेश)

---

## 🚀 3. संबंधित फाइल्स (File Directory)

- **Controllers:**
  - `app/Http/Controllers/Admin/DonationAdminController.php`
  - `app/Http/Controllers/Frontend/DonationController.php`
  - `app/Services/DonationService.php`
- **Views:**
  - `resources/views/admin/donations/*`
  - `resources/views/frontend/donations/*`
  - `resources/views/receipts/donation_receipt.blade.php`

---

*स्थिति: 100% पूर्ण, टेस्टेड एवं प्रोडक्शन में कार्यरत।*
