127 lines
2.3 KiB
Markdown
127 lines
2.3 KiB
Markdown
# 🚀 DealHub
|
|
|
|
**DelHub** is a **Recommendation & Deal Discovery Platform** built with **Laravel**, where verified brokers share deals and recommendations, and users discover trusted content through likes, favorites, search, and trending logic.
|
|
|
|
---
|
|
|
|
## 📌 Features
|
|
|
|
### 🌐 Public / User
|
|
|
|
* View all approved deals and listings
|
|
* Like ❤️, Favorite ⭐, and Report 🚩 deals
|
|
* Search deals with category filters
|
|
* Discover trending, most liked, and recent deals
|
|
* View broker contact information
|
|
|
|
### 🧑💼 Broker
|
|
|
|
* Create and manage deal posts
|
|
* Upload images and external links
|
|
* Public broker profile with listings
|
|
* View analytics (views, likes, clicks)
|
|
* Broker dashboard with performance insights
|
|
|
|
### 👑 Admin
|
|
|
|
* Manage users and brokers (CRUD)
|
|
* Login as User/Broker (for support/debugging)
|
|
* Approve or reject broker listings
|
|
* Feature or block deals
|
|
* Admin analytics dashboard
|
|
|
|
---
|
|
|
|
## 🧱 Tech Stack
|
|
|
|
* **Backend:** Laravel
|
|
* **Frontend:** Blade + Tailwind CSS
|
|
* **Authentication:** Laravel Breeze
|
|
* **Database:** MySQL
|
|
* **Version Control:** Git & GitHub
|
|
|
|
---
|
|
|
|
## 🗂️ Core Modules
|
|
|
|
* Authentication & Role Management
|
|
* Listings (Deals)
|
|
* User Interactions (Like, Favorite, Report)
|
|
* Tracking (Views & Clicks)
|
|
* Search & Discovery
|
|
* Broker Profiles & Analytics
|
|
* Admin Dashboard & Controls
|
|
* Landing Page (Home, About, Contact)
|
|
|
|
---
|
|
|
|
## 🖥️ Landing Page Includes
|
|
|
|
* Header with navigation
|
|
* Hero banner
|
|
* About section
|
|
* How it works
|
|
* Contact form
|
|
* Footer with links
|
|
|
|
---
|
|
|
|
Used for:
|
|
|
|
* Trending deals
|
|
* Homepage highlights
|
|
* Category top listings
|
|
|
|
---
|
|
|
|
## ⚙️ Installation
|
|
|
|
```bash
|
|
git clone https://git.sentientgeeks.us/joydip.manna/dealhub.git
|
|
cd dealhub
|
|
composer install
|
|
npm install
|
|
npm run dev
|
|
php artisan migrate
|
|
php artisan serve
|
|
```
|
|
|
|
---
|
|
|
|
## 🔐 Roles
|
|
|
|
* **Admin**
|
|
* **Broker**
|
|
* **User**
|
|
|
|
Role-based access is handled via middleware.
|
|
|
|
---
|
|
|
|
## 📈 Future Enhancements
|
|
|
|
* Notifications
|
|
* Deal expiry & auto-hide
|
|
* API support
|
|
* Mobile app integration
|
|
* Advanced analytics charts
|
|
|
|
---
|
|
|
|
## 👨💻 Author
|
|
|
|
**DelHub**
|
|
Built with ❤️ using Laravel
|
|
|
|
---
|
|
|
|
If you want, I can also:
|
|
|
|
* Shorten this README
|
|
* Make it more **technical**
|
|
* Add **screenshots section**
|
|
* Add **API documentation**
|
|
* Customize it for **company/internal use**
|
|
|
|
Just tell me 👍
|