# Notification System - Q&A

## Questions & Answers

### 1. **Why no toggle for Email/Push in Customer Channels?**

**Answer**: ✅ **FIXED!** Added toggles to Customer Channels.

**Implementation**:
- Added `Switch` component to Email and Push channels
- Added mutation to toggle channel enable/disable
- When disabled, customers won't see these options in their account page

**User Flow**:
```
Admin disables Email → Customer account page hides email notification preferences
Admin disables Push → Customer account page hides push notification preferences
```

---

### 2. **Flexibility: Optional Channels & WooCommerce Default Email**

**Answer**: ✅ **Excellent idea!** Here's the proposed implementation:

#### **A. Make All Channels Optional**
- ✅ Staff channels: Already have toggles
- ✅ Customer channels: Now have toggles (just added)
- Each channel can be completely disabled

#### **B. Global WooNooW Notification Toggle**

**Proposed Location**: `/settings/notifications` (main page)

**New Card**:
```
┌─────────────────────────────────────────┐
│ 🔔 Notification System                  │
│                                          │
│ ○ Use WooNooW Notifications (default)   │
│   Modern notification system with       │
│   multiple channels and templates       │
│                                          │
│ ○ Use WooCommerce Default Emails        │
│   Classic WooCommerce email system      │
│   (WooNooW notifications disabled)      │
│                                          │
│ [Save Changes]                           │
└─────────────────────────────────────────┘
```

**Behavior**:
- **When WooNooW is active**: WooCommerce default emails are disabled
- **When WooCommerce default is active**: WooNooW notifications are disabled
- Only one system can be active at a time

**Implementation Plan**:
1. Add global setting: `woonoow_notification_system` (values: `woonoow` | `woocommerce`)
2. Hook into WooCommerce email system:
   - If `woonoow`: Disable WC emails, enable WooNooW
   - If `woocommerce`: Enable WC emails, disable WooNooW
3. Add migration helper to switch between systems

---

### 3. **Backend Integration Status**

**Answer**: ⚠️ **Partially Wired**

#### **✅ Already Wired (Frontend → Backend)**:
1. **Channel Toggle**:
   - Endpoint: `POST /notifications/channels/toggle`
   - Payload: `{ channelId, enabled }`
   - Used in: Staff/Customer Channels tabs

2. **Event Toggle**:
   - Endpoint: `POST /notifications/events/update`
   - Payload: `{ eventId, channelId, enabled, recipient }`
   - Used in: Staff/Customer Events tabs

3. **Template Fetch**:
   - Endpoint: `GET /notifications/templates/{eventId}/{channelId}?recipient={type}`
   - Used in: EditTemplate page

4. **Template Save**:
   - Endpoint: `POST /notifications/templates/save`
   - Payload: `{ eventId, channelId, recipient, subject, body }`
   - Used in: EditTemplate page

#### **❌ Not Yet Wired (Need Backend Implementation)**:
1. **Email Configuration**:
   - Template Settings (colors, logo, branding)
   - Connection Settings (SMTP override)
   - **Status**: Frontend ready, backend needs implementation

2. **Push Configuration**:
   - Template Settings (icon, badge, sound)
   - Connection Settings (FCM/OneSignal)
   - **Status**: Frontend ready, backend needs implementation

3. **Channel Configuration**:
   - Global channel settings
   - **Status**: Frontend ready, backend needs implementation

4. **Global Notification System Toggle**:
   - Switch between WooNooW and WooCommerce
   - **Status**: Not implemented (proposed above)

---

## Backend TODO List

### Priority 1: Core Functionality
- [ ] Implement Email Configuration endpoints
  - `GET /notifications/email-settings`
  - `POST /notifications/email-settings/save`
- [ ] Implement Push Configuration endpoints
  - `GET /notifications/push-settings`
  - `POST /notifications/push-settings/save`
- [ ] Add global notification system toggle
  - `GET /notifications/system-mode`
  - `POST /notifications/system-mode/set`

### Priority 2: Integration
- [ ] Hook into WooCommerce email system
  - Disable WC emails when WooNooW is active
  - Re-enable WC emails when switched back
- [ ] Customer account page integration
  - Show/hide notification preferences based on enabled channels
  - Save customer notification preferences

### Priority 3: Enhancement
- [ ] Activity Log endpoints
  - `GET /notifications/activity-log`
  - Track sent notifications
- [ ] Addon system for channels
  - WhatsApp, Telegram, SMS integration points

---

## Recommended Next Steps

1. **Add Global Toggle** (High Priority)
   - Implement the WooNooW vs WooCommerce toggle
   - This gives users ultimate flexibility

2. **Wire Email Configuration** (Medium Priority)
   - Connect frontend to backend for email branding

3. **Wire Push Configuration** (Low Priority)
   - Can be done later, push is less critical

4. **Customer Account Integration** (High Priority)
   - Show notification preferences based on enabled channels
   - Let customers opt-in/opt-out per channel

---

## Architecture Summary

```
Frontend (React)
├── Notifications Main Page
│   └── [NEW] Global System Toggle (WooNooW vs WooCommerce)
├── Staff Notifications
│   ├── Channels (toggle on/off) ✅ Wired
│   └── Events (toggle + template edit) ✅ Wired
├── Customer Notifications
│   ├── Channels (toggle on/off) ✅ Just Added
│   └── Events (toggle + template edit) ✅ Wired
└── Channel Configuration
    ├── Email Config ⚠️ Frontend ready, backend needed
    ├── Push Config ⚠️ Frontend ready, backend needed
    └── Addons (future)

Backend (PHP)
├── NotificationsController ✅ Partially implemented
├── TemplateProvider ✅ Implemented
├── EventRegistry ✅ Implemented
└── [NEEDED] ConfigurationController
    ├── Email settings
    ├── Push settings
    └── Global system toggle
```

---

## Summary

**What's Working**:
- ✅ Channel enable/disable (Staff & Customer)
- ✅ Event enable/disable with template editing
- ✅ Template editor with markdown support
- ✅ Variable system

**What's Needed**:
- ⚠️ Backend for Email/Push configuration
- ⚠️ Global system toggle (WooNooW vs WooCommerce)
- ⚠️ Customer account page integration

**Recommendation**: Implement the global toggle first, as it provides the ultimate flexibility you want!