feat: implement streak system with XP multipliers

app-modules/events/src/Actions/ProcessManualOverrideAction.php

@@ -0,0 +1,36 @@
+<?php
+
+declare(strict_types=1);
+
+namespace He4rt\Events\Actions;
+
+use He4rt\Events\Models\EventModel;
+use He4rt\Gamification\Character\Actions\IncrementExperience;
+use He4rt\Gamification\Character\Models\Character;
+
+final readonly class ProcessManualOverrideAction
+{
+    public function __construct(
+        private IncrementExperience $incrementExperience,
+    ) {}
+
+    /**
+     * Processa override manual
+     * - XP base é atribuído SEM multiplicador
+     * - Streak NÃO é incrementado nem zerado
+     */
+    public function execute(EventModel $event, string $userId): void
+    {
+        $character = Character::query()
+            ->where('user_id', $userId)
+            ->where('tenant_id', $event->tenant_id)
+            ->firstOrFail();
+
+        $baseXp = $event->xp_value;
+        $this->incrementExperience->incrementByEventAttendance(
+            (string) $character->id,
+            $baseXp,
+            1.0
+        );
+    }
+}

app-modules/events/src/Actions/ProcessVerifiedAttendanceAction.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace He4rt\Events\Actions;
+
+use He4rt\Events\Models\EventModel;
+use He4rt\Gamification\Character\Actions\CalculateStreakMultiplierAction;
+use He4rt\Gamification\Character\Actions\IncrementExperience;
+use He4rt\Gamification\Character\Actions\IncrementStreakAction;
+use He4rt\Gamification\Character\Models\Character;
+
+final readonly class ProcessVerifiedAttendanceAction
+{
+    public function __construct(
+        private VerifyAttendanceAction $verifyAttendance,
+        private IncrementStreakAction $incrementStreak,
+        private CalculateStreakMultiplierAction $calculateMultiplier,
+        private IncrementExperience $incrementExperience,
+    ) {}
+
+    /**
+     * Processa a verificação de presença com streak e multiplicador
+     * Usado por GPS, Discord, Código
+     */
+    public function execute(EventModel $event, string $userId): void
+    {
+        $this->verifyAttendance->execute($event, $userId);
+
+        $character = Character::query()
+            ->where('user_id', $userId)
+            ->where('tenant_id', $event->tenant_id)
+            ->firstOrFail();
+
+        $this->incrementStreak->execute((string) $character->id);
+        $character->refresh();
+        $multiplier = $this->calculateMultiplier->execute((string) $character->id);
+        $baseXp = $event->xp_value;
+        $this->incrementExperience->incrementByEventAttendance(
+            (string) $character->id,
+            $baseXp,
+            $multiplier
+        );
+    }
+}

app-modules/events/src/Actions/VerifyAttendanceAction.php

@@ -0,0 +1,22 @@
+<?php
+
+declare(strict_types=1);
+
+namespace He4rt\Events\Actions;
+
+use He4rt\Events\Models\EventModel;
+use Illuminate\Support\Facades\Date;
+
+final class VerifyAttendanceAction
+{
+    /**
+     * Marca a presença como verificada para um usuário em um evento
+     * Isso incrementa o streak e aplica o multiplicador de XP
+     */
+    public function execute(EventModel $event, string $userId): void
+    {
+        $event->attendees()->updateExistingPivot($userId, [
+            'verified_at' => Date::now(),
+        ]);
+    }
+}

app-modules/events/src/Jobs/ResetUnverifiedStreaksJob.php

@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+namespace He4rt\Events\Jobs;
+
+use He4rt\Events\Models\EventModel;
+use He4rt\Gamification\Character\Actions\ResetStreakAction;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Support\Facades\DB;
+
+class ResetUnverifiedStreaksJob implements ShouldQueue
+{
+    use Dispatchable;
+    use InteractsWithQueue;
+    use Queueable;
+
+    public function __construct(
+        private readonly int $eventId,
+    ) {}
+
+    public function handle(): void
+    {
+        $event = EventModel::query()->findOrFail($this->eventId);
+
+        // Ignora eventos cancelados
+        if ($event->active === false) {
+            return;
+        }
+
+        // Busca usuários com status = attending (pré-confirmados)
+        // que NÃO têm verified_at (não verificaram presença)
+        $unverifiedAttendees = DB::table('events_attendees')
+            ->where('event_id', $this->eventId)
+            ->whereNotNull('status') // Que tenham status (estão confirmados)
+            ->whereNull('verified_at') // E não verificaram presença
+            ->get();
+
+        $resetStreakAction = new ResetStreakAction();
+
+        foreach ($unverifiedAttendees as $attendee) {
+            // Busca o character do usuário para este tenant
+            $character = DB::table('characters')
+                ->where('user_id', $attendee->user_id)
+                ->where('tenant_id', $event->tenant_id)
+                ->first();
+
+            if ($character) {
+                $resetStreakAction->execute($character->id);
+            }
+        }
+    }
+}

app-modules/events/src/Models/EventModel.php

@@ -24,6 +24,7 @@
 use Illuminate\Database\Eloquent\Relations\BelongsToMany;
 use Illuminate\Database\Eloquent\Relations\HasMany;
 use Illuminate\Database\Eloquent\Relations\HasManyThrough;
+use Illuminate\Support\Facades\Date;
 
 /**
  * @property bool $active
@@ -33,6 +34,7 @@
  * @property string $description
  * @property string $location
  * @property int $max_attendees
+ * @property int $xp_value
  * @property int $attendees_count
  * @property int $waitlist_count
  * @property int $tenant_id
@@ -59,6 +61,7 @@ class EventModel extends Model
         'end_at',
         'location',
         'max_attendees',
+        'xp_value',
         'attendees_count',
         'waitlist_count',
         'tenant_id',
@@ -190,6 +193,31 @@ public function sponsors(): BelongsToMany
             ->withTimestamps();
     }
 
+    public function isVerificationWindowClosed(): bool
+    {
+        return Date::now()->greaterThanOrEqualTo(
+            $this->end_at->copy()->addMinutes(30)
+        );
+    }
+
+    public function verifyAttendance(int $userId): void
+    {
+        $this->attendees()->updateExistingPivot($userId, [
+            'verified_at' => Date::now(),
+        ]);
+    }
+
+    public function hasVerifiedAttendance(int $userId): bool
+    {
+        $attendee = $this->attendees()->where('user_id', $userId)->first();
+
+        if (!$attendee) {
+            return false;
+        }
+
+        return $attendee->pivot->verified_at !== null;
+    }
+
     /** @return Attribute<int, never> */
     protected function duration(): Attribute
     {

app-modules/events/src/Models/Pivot/EventAttend.php

@@ -4,12 +4,14 @@
 
 namespace He4rt\Events\Models\Pivot;
 
+use Carbon\Carbon;
 use He4rt\Events\Enums\AttendingStatusEnum;
 use Illuminate\Database\Eloquent\Relations\Pivot;
 
 /**
  * @property AttendingStatusEnum $status
  * @property int $attend_order
+ * @property Carbon|null $verified_at
  */
 class EventAttend extends Pivot
 {
@@ -18,12 +20,19 @@ class EventAttend extends Pivot
     protected $fillable = [
         'status',
         'attend_order',
+        'verified_at',
     ];
 
+    public function isVerified(): bool
+    {
+        return $this->verified_at !== null;
+    }
+
     protected function casts(): array
     {
         return [
             'status' => AttendingStatusEnum::class,
+            'verified_at' => 'datetime',
         ];
     }
 }

app-modules/gamification/src/Character/Actions/CalculateStreakMultiplierAction.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace He4rt\Gamification\Character\Actions;
+
+use He4rt\Gamification\Character\Enums\StreakMultiplierEnum;
+use He4rt\Gamification\Character\Models\Character;
+
+final readonly class CalculateStreakMultiplierAction
+{
+    public function execute(string $characterId): float
+    {
+        $character = Character::query()->findOrFail($characterId);
+        $streak = $character->streak ?? 0;
+
+        return StreakMultiplierEnum::fromStreak($streak)->getMultiplier();
+    }
+}

app-modules/gamification/src/Character/Actions/IncrementExperience.php

@@ -9,21 +9,32 @@
 
 class IncrementExperience
 {
-    public function incrementByTextMessage(string $characterId, string $message): int
+    public function incrementByTextMessage(string $characterId, string $message, float $multiplier = 1.0): int
     {
         $character = Character::query()->findOrFail($characterId);
         $experience = Character::generateTextExperience($message, $character->level, false);
-        $character->increment('experience', $experience);
+        $finalExperience = (int) ($experience * $multiplier);
+        $character->increment('experience', $finalExperience);
 
-        return $experience;
+        return $finalExperience;
     }
 
-    public function incrementByVoiceMessage(string $characterId, VoiceStatesEnum $voiceState): int
+    public function incrementByVoiceMessage(string $characterId, VoiceStatesEnum $voiceState, float $multiplier = 1.0): int
     {
         $character = Character::query()->findOrFail($characterId);
         $experience = $voiceState->getExperienceMultiplier() * $character->level;
-        $character->increment('experience', $experience);
+        $finalExperience = (int) ($experience * $multiplier);
+        $character->increment('experience', $finalExperience);
 
-        return $experience;
+        return $finalExperience;
+    }
+
+    public function incrementByEventAttendance(string $characterId, int $baseXp, float $multiplier = 1.0): int
+    {
+        $character = Character::query()->findOrFail($characterId);
+        $finalExperience = (int) ($baseXp * $multiplier);
+        $character->increment('experience', $finalExperience);
+
+        return $finalExperience;
     }
 }

app-modules/gamification/src/Character/Actions/IncrementStreakAction.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace He4rt\Gamification\Character\Actions;
+
+use He4rt\Gamification\Character\Models\Character;
+
+final readonly class IncrementStreakAction
+{
+    public function execute(string $characterId): void
+    {
+        $character = Character::query()->findOrFail($characterId);
+        $character->increment('streak');
+    }
+}

app-modules/gamification/src/Character/Actions/ResetStreakAction.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace He4rt\Gamification\Character\Actions;
+
+use He4rt\Gamification\Character\Models\Character;
+
+final readonly class ResetStreakAction
+{
+    public function execute(string $characterId): void
+    {
+        $character = Character::query()->findOrFail($characterId);
+        $character->update(['streak' => 0]);
+    }
+}

app-modules/gamification/src/Character/Enums/StreakMultiplierEnum.php

@@ -0,0 +1,45 @@
+<?php
+
+declare(strict_types=1);
+
+namespace He4rt\Gamification\Character\Enums;
+
+use Filament\Support\Contracts\HasLabel;
+
+enum StreakMultiplierEnum: int implements HasLabel
+{
+    case None = 0;       // 1.0x
+    case Bronze = 3;     // 1.1x (streak 3-4)
+    case Silver = 5;      // 1.25x (streak 5-9)
+    case Gold = 10;       // 1.5x (streak 10+)
+
+    public static function fromStreak(int $streak): self
+    {
+        return match (true) {
+            $streak >= 10 => self::Gold,
+            $streak >= 5 => self::Silver,
+            $streak >= 3 => self::Bronze,
+            default => self::None,
+        };
+    }
+
+    public function getMultiplier(): float
+    {
+        return match ($this) {
+            self::None => 1.0,
+            self::Bronze => 1.1,
+            self::Silver => 1.25,
+            self::Gold => 1.5,
+        };
+    }
+
+    public function getLabel(): string
+    {
+        return match ($this) {
+            self::None => '1.0x',
+            self::Bronze => '1.1x',
+            self::Silver => '1.25x',
+            self::Gold => '1.5x',
+        };
+    }
+}