🔔 Push Notification System

🎯 Purpose

This module allows Admin to:

• Send push notifications to Customer App users

• Send push notifications to Vendor App users

• Send immediately or schedule for later

🧭 Step-By-Step Walkthrough

✅ Step 1: Navigate to Push Notifications

Go to:

Admin Panel → Push Notifications

You will see 3 tabs:

• Compose

• History

• Scheduled

✍️ Step 2: Compose Notification

Click Compose tab.

You will see:

• Title *

• Body *

• Image URL (Optional)

• Target App *

• Audience *

• Schedule toggle

• Send Now button

• Live Preview panel

🏷 Step 3: Enter Notification Title

Enter a short headline.

Example:

• “Limited Time Offer”

• “Order Successfully Picked”

⚠ Title is mandatory.

📝 Step 4: Enter Notification Body

Write the message content.

Example:

• “Sell your old phone today and get instant cash.”

• “Your pickup has been confirmed.”

⚠ Body is mandatory.

Live Preview updates automatically.

🖼 Step 5: (Optional) Add Image URL

If required, paste image link:

https://example.com/banner.jpg

If empty → Normal text notification is sent.

📱 Step 6: Select Target App

Choose where notification should go:

• Customer App

• Vendor App

Example Use:

• Offer → Customer App

• Order assignment → Vendor App

⚠ This is mandatory.

👥 Step 7: Select Audience

Choose:

1️⃣ All Users

Notification sent to all users.

2️⃣ Topic

Sent only to users subscribed to specific topic.

3️⃣ Specific Users

Send to selected user IDs.

⏰ Step 8: Choose Send Type

Option A: Send Now

• Keep Schedule toggle OFF

• Click Send Now

• Notification sent immediately

Option B: Schedule for Later

• Turn ON Schedule toggle

• Select Date & Time

• Save

• Notification will auto-send at selected time

⚠ Cannot select past time.

🚀 Step 9: Click Send Now

When clicked:

1. System validates required fields

2. Creates notification record

3. Sends push via FCM/APNS

4. Saves entry in History

📜 History Tab

Shows:

• Title

• Target App

• Audience

• Date & Time

• Status (Sent / Failed)

Used for tracking past campaigns.

📅 Scheduled Tab

Shows:

• Upcoming notifications

• Scheduled date/time

• Option to edit or cancel (if supported)

🔄 Live Preview Panel

Right side shows:

• How notification looks on mobile

• Target app selected

• Audience selected

Helps verify before sending.

⚙️ Behind the Scenes Flow

Admin clicks Send
        ↓
Backend validates data
        ↓
Push request sent to FCM/APNS
        ↓
Notification delivered to selected app

🧪 How the Push Notification Works?