@hasanyrole('Developer|Administrator')

@else

@endhasanyrole

{{-- ==================================================================== DOCUMENTATION (MODAL) ==================================================================== --}}

Admin clicks Send / system triggers

Row written to notifications table

Real-time via Reverb WebSocket

Bell icon + feed updates

{{ __('Notifications persist in the database even after they are read — only "Clear read" deletes them. The feed paginates 15 per page.') }}

{{ __('Neutral updates. No action required from the recipient.') }}

{{ __('New feature announcement') }}
{{ __('Scheduled maintenance reminder') }}
{{ __('Newsletter / company update') }}

{{ __('Quota nearing limit') }}
{{ __('Pending approval required') }}
{{ __('Deprecated feature retiring soon') }}

{{ __('Emergency maintenance starting NOW') }}
{{ __('Security incident notification') }}
{{ __('Service outage / degradation') }}

{{ __('Broadcast to every active account in the system, regardless of role. Use for company-wide announcements only — over-using this trains users to ignore the bell icon.') }}

{{ __('Pick a specific role (e.g. Developer, Manager, Staff). Only users holding that role will see the notification. Precise — recommended default.') }}

@php $actions = [ ['icon'=>'bi-check2','color'=>'#22c55e','title'=>'Mark as read','desc'=>'Click a single notification card. Removes its unread highlight; stays in the feed.','boldWord'=>null], ['icon'=>'bi-check-all','color'=>'#3b82f6','title'=>'Mark all read','desc'=>'Bulk action. Marks every unread notification at once. Useful after vacation / morning catch-up.','boldWord'=>null], ['icon'=>'bi-trash3-fill','color'=>'#ef4444','title'=>'Clear read','desc1'=>'Permanently deletes ','boldWord'=>'already-read','desc2'=>' notifications. Unread ones are preserved. Cannot be undone.'], ['icon'=>'bi-x-lg','color'=>'#94a3b8','title'=>'Delete one','desc'=>'Dismiss a single notification (read or unread). Removes it from your feed only — other recipients still see theirs.','boldWord'=>null], ]; @endphp @foreach($actions as $a)

@if(isset($a['boldWord'])) {{ $a['desc1'] }}{{ $a['boldWord'] }}{{ $a['desc2'] }} @else {{ $a['desc'] }} @endif

@endforeach

{{ __('Lead with the most important info — recipients scan, not read') }}
{{ __('Keep title under 60 characters (it gets truncated on mobile)') }}
{{ __('Use plain language, avoid internal jargon') }}
{{ __('Include an action verb if user needs to do something ("Click here", "Approve", "Review")') }}
{{ __('Match the type to the urgency') }}

{{ __('Use SYSTEM ALERT for routine info — it loses meaning') }}
{{ __('Send the same message twice — there is no undo') }}
{{ __('Include sensitive data (passwords, tokens) — notifications are stored plaintext') }}
{{ __('Mass-send "All Users" for things only a few care about') }}
{{ __('Forget to test on the recipient role first (small group) before broadcasting') }}

DELIVERY PIPELINE:

[1] Admin submits form → NotificationCenterController::store()
[2] Recipients resolved:
       • "all"   → User::where('active', true)->get()
       • role-X → User::role('X')->get()
[3] Laravel SystemManagementNotification dispatched per user
       Channels: ['database', 'broadcast']
[4] database channel  → row in notifications table
[5] broadcast channel → Reverb WebSocket → bell icon updates live
[6] Recipient pulls feed → GET /notification-center/api/recent

# Feature flag: feature_notification_center in Global Settings
# When OFF, the menu hides for non-admins but admins still see it.

{{ __('CAPABILITY') }}	{{ __('REQUIRED ROLE / PERMISSION') }}	{{ __('NOTES') }}
{{ __('Read own feed') }}	`view notification center`	{{ __('Required to even open this page') }}
{{ __('Mark / delete own notifications') }}	`view notification center`	{{ __('Implicit — users can always manage their own feed') }}
{{ __('Send to a role') }}	{{ __('Role:') }} Developer {{ __('or') }} Administrator	{{ __('Anyone outside these roles will not see the Send button') }}
{{ __('Toggle the whole feature off') }}	`manage global settings`	{{ __('Global Settings → Notifications →') }} `feature_notification_center`

{{ __('SYMPTOM') }}	{{ __('LIKELY CAUSE') }}	{{ __('FIX') }}
{{ __('Sent but recipient sees nothing') }}	{{ __('Recipient has no matching role, or is inactive') }}	{{ __('Verify the user is active + holds the targeted role') }}
{{ __('Bell icon does not update live') }}	{{ __('Reverb WebSocket disconnected') }}	{{ __('Check Monitoring Center → Reverb status. Restart if IDLE during traffic.') }}
{{ __('"Clear read" did nothing') }}	{{ __('Nothing was read yet — only read items get purged') }}	{{ __('Mark as read first, then Clear read') }}
{{ __('Menu hidden in sidebar') }}	{{ __('Feature flag') }} `feature_notification_center` {{ __('is OFF') }}	{{ __('Global Settings → Notifications → enable the toggle') }}
{{ __('Send button missing') }}	{{ __('Account lacks Developer / Administrator role') }}	{{ __('Ask an admin to grant the role, or use CLI to seed') }}
{{ __('Feed empty even after sending') }}	{{ __('The notifications table was truncated') }}	{{ __('Send a fresh one — old data is gone, new ones will appear') }}

@php $tips = [ ['icon'=>'bi-target','title'=>'Be specific with audience','desc'=>'Target a role, not "All Users", whenever the message only matters to a subset. Saves everyone scroll time.'], ['icon'=>'bi-clock-history','title'=>'Mind the timing','desc'=>'Avoid sending non-urgent notifications outside business hours — push fatigue eats engagement.'], ['icon'=>'bi-funnel','title'=>'One topic per notification','desc'=>'If you have three things to say, send three notifications. Long mixed messages get skimmed.'], ['icon'=>'bi-chat-square-quote','title'=>'Test on yourself first','desc'=>'Send to "Developer" role first, check how it looks on mobile + desktop, then broadcast.'], ['icon'=>'bi-shield-check','title'=>'Never include secrets','desc'=>'Database rows persist until cleared. Passwords, tokens, payment info → never via notification.'], ['icon'=>'bi-bell-slash','title'=>'Respect the bell','desc'=>'Each unnecessary notification is one step closer to users disabling the bell entirely. Less is more.'], ]; @endphp @foreach($tips as $tip)

@endforeach

Notifications use Laravel's built-in Illuminate\Notifications with two channels: database (persistent storage) and broadcast (real-time via Reverb WebSocket). The notification class is App\Notifications\SystemManagementNotification. Per-user rows live in the notifications table with Laravel-standard UUIDs.

{{ __('Notification Center') }}