- Add database migrations for plans, subscriptions, notification preferences, and notification log tables - Implement DispatchUserNotificationJob to handle channel resolution, daily limits, and logging (sent/tier_restricted/daily_limit) - Add SendScheduledWhatsAppJob for scheduled notification delivery - Create PlanFeatures service to resolve tier capabilities, check daily limits, and validate fuel
88 lines
2.8 KiB
PHP
88 lines
2.8 KiB
PHP
<?php
|
|
|
|
namespace App\Jobs;
|
|
|
|
use App\Models\NotificationLog;
|
|
use App\Models\User;
|
|
use App\Models\UserNotificationPreference;
|
|
use App\Services\PlanFeatures;
|
|
use Illuminate\Contracts\Queue\ShouldQueue;
|
|
use Illuminate\Foundation\Queue\Queueable;
|
|
|
|
/**
|
|
* Resolves allowed notification channels for a user and trigger, sends
|
|
* notifications, and logs every outcome (sent, daily_limit, tier_restricted).
|
|
*
|
|
* Actual sending is stubbed until FuelPriceAlert notification class exists.
|
|
*/
|
|
final class DispatchUserNotificationJob implements ShouldQueue
|
|
{
|
|
use Queueable;
|
|
|
|
/** @var string[] */
|
|
private const array ALL_CHANNELS = ['email', 'push', 'whatsapp', 'sms'];
|
|
|
|
public function __construct(
|
|
public readonly User $user,
|
|
public readonly string $triggerType,
|
|
public readonly string $fuelType,
|
|
public readonly ?float $price = null,
|
|
) {
|
|
$this->onQueue('notifications');
|
|
}
|
|
|
|
public function handle(): void
|
|
{
|
|
$features = PlanFeatures::for($this->user);
|
|
|
|
// Step 3: channels that pass tier + user-pref + daily-limit checks
|
|
$allowed = $features->channelsFor($this->triggerType);
|
|
|
|
// Step 4: send and log sent notifications
|
|
foreach ($allowed as $channel) {
|
|
// TODO: $this->user->notify(new FuelPriceAlert($this->triggerType, $this->fuelType, $this->price));
|
|
$this->log($channel, sent: true);
|
|
}
|
|
|
|
// Channels not in the allowed set — split into missed reasons
|
|
$notAllowed = array_diff(self::ALL_CHANNELS, $allowed);
|
|
|
|
foreach ($notAllowed as $channel) {
|
|
if (! $this->userHasEnabledPref($channel)) {
|
|
// User intentionally disabled — do not log (noise)
|
|
continue;
|
|
}
|
|
|
|
if ($features->canUseChannel($channel)) {
|
|
// Step 5: tier allows but daily limit exhausted
|
|
$this->log($channel, sent: false, missedReason: 'daily_limit');
|
|
} else {
|
|
// Step 6: tier does not allow the channel the user wanted
|
|
$this->log($channel, sent: false, missedReason: 'tier_restricted');
|
|
}
|
|
}
|
|
}
|
|
|
|
private function log(string $channel, bool $sent, ?string $missedReason = null): void
|
|
{
|
|
NotificationLog::create([
|
|
'user_id' => $this->user->id,
|
|
'channel' => $channel,
|
|
'trigger_type' => $this->triggerType,
|
|
'fuel_type' => $this->fuelType,
|
|
'price' => $this->price,
|
|
'sent' => $sent,
|
|
'missed_reason' => $missedReason,
|
|
'created_at' => now(),
|
|
]);
|
|
}
|
|
|
|
private function userHasEnabledPref(string $channel): bool
|
|
{
|
|
return UserNotificationPreference::where('user_id', $this->user->id)
|
|
->where('channel', $channel)
|
|
->where('enabled', true)
|
|
->exists();
|
|
}
|
|
}
|