feat(activity): model UserReaction + factory e relação no Timeline (#542)

app-modules/activity/database/factories/UserReactionFactory.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace He4rt\Activity\Database\Factories;
+
+use He4rt\Activity\Reaction\Enums\TimelineReaction;
+use He4rt\Activity\Reaction\Models\UserReaction;
+use He4rt\Activity\Timeline\Timeline;
+use He4rt\Identity\User\Models\User;
+use Illuminate\Database\Eloquent\Factories\Factory;
+
+/** @extends Factory<UserReaction> */
+final class UserReactionFactory extends Factory
+{
+    protected $model = UserReaction::class;
+
+    /** @return array<string, mixed> */
+    public function definition(): array
+    {
+        return [
+            'user_id' => User::factory(),
+            'timeline_id' => Timeline::factory(),
+            'reaction' => fake()->randomElement(TimelineReaction::cases()),
+        ];
+    }
+}

app-modules/activity/src/Reaction/Models/UserReaction.php

@@ -0,0 +1,56 @@
+<?php
+
+declare(strict_types=1);
+
+namespace He4rt\Activity\Reaction\Models;
+
+use Carbon\CarbonInterface;
+use He4rt\Activity\Database\Factories\UserReactionFactory;
+use He4rt\Activity\Reaction\Enums\TimelineReaction;
+use He4rt\Activity\Timeline\Timeline;
+use He4rt\Identity\User\Models\User;
+use Illuminate\Database\Eloquent\Attributes\Table;
+use Illuminate\Database\Eloquent\Attributes\UseFactory;
+use Illuminate\Database\Eloquent\Concerns\HasUuids;
+use Illuminate\Database\Eloquent\Factories\HasFactory;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+
+/**
+ * @property string $id
+ * @property string $user_id
+ * @property string $timeline_id
+ * @property TimelineReaction $reaction
+ * @property CarbonInterface|null $created_at
+ * @property CarbonInterface|null $updated_at
+ * @property-read User $user
+ * @property-read Timeline $timeline
+ */
+#[UseFactory(factoryClass: UserReactionFactory::class)]
+#[Table(name: 'activity_user_reactions')]
+final class UserReaction extends Model
+{
+    /** @use HasFactory<UserReactionFactory> */
+    use HasFactory;
+    use HasUuids;
+
+    /** @return BelongsTo<User, $this> */
+    public function user(): BelongsTo
+    {
+        return $this->belongsTo(User::class);
+    }
+
+    /** @return BelongsTo<Timeline, $this> */
+    public function timeline(): BelongsTo
+    {
+        return $this->belongsTo(Timeline::class);
+    }
+
+    /** @return array<string, string> */
+    protected function casts(): array
+    {
+        return [
+            'reaction' => TimelineReaction::class,
+        ];
+    }
+}

app-modules/activity/src/Timeline/Timeline.php

@@ -7,6 +7,7 @@
 use Carbon\CarbonInterface;
 use He4rt\Activity\Database\Factories\TimelineFactory;
 use He4rt\Activity\Reaction\Concerns\HasReactions;
+use He4rt\Activity\Reaction\Models\UserReaction;
 use He4rt\Identity\User\Models\User;
 use Illuminate\Database\Eloquent\Attributes\Table;
 use Illuminate\Database\Eloquent\Concerns\HasUuids;
@@ -67,6 +68,12 @@ public function children(): HasMany
         return $this->hasMany(self::class, 'parent_id');
     }
 
+    /** @return HasMany<UserReaction, $this> */
+    public function userReactions(): HasMany
+    {
+        return $this->hasMany(UserReaction::class);
+    }
+
     protected static function newFactory(): TimelineFactory
     {
         return TimelineFactory::new();

app-modules/activity/tests/Unit/Reaction/UserReactionTest.php

@@ -0,0 +1,69 @@
+<?php
+
+declare(strict_types=1);
+
+use He4rt\Activity\Reaction\Enums\TimelineReaction;
+use He4rt\Activity\Reaction\Models\UserReaction;
+use He4rt\Activity\Timeline\Timeline;
+use He4rt\Identity\User\Models\User;
+use Illuminate\Database\QueryException;
+use Illuminate\Foundation\Testing\RefreshDatabase;
+use Illuminate\Support\Facades\DB;
+
+uses(RefreshDatabase::class);
+
+it('cria uma linha válida via factory com reaction como enum', function (): void {
+    UserReaction::factory()->create();
+
+    $reaction = UserReaction::query()->first();
+
+    expect($reaction)->not->toBeNull()
+        ->and($reaction->reaction)->toBeInstanceOf(TimelineReaction::class);
+
+    $this->assertDatabaseCount('activity_user_reactions', 1);
+});
+
+it('pertence ao usuário que reagiu', function (): void {
+    $user = User::factory()->create();
+    $reaction = UserReaction::factory()->for($user)->create();
+
+    expect($reaction->user)->toBeInstanceOf(User::class)
+        ->and($reaction->user->id)->toBe($user->id);
+});
+
+it('devolve as reações do post com os usuários donos', function (): void {
+    $timeline = Timeline::factory()->create();
+    $users = User::factory()->count(3)->create();
+
+    foreach ($users as $user) {
+        UserReaction::factory()
+            ->for($timeline)
+            ->for($user)
+            ->create();
+    }
+
+    $owners = $timeline->userReactions()->with('user')->get()->map(
+        fn (UserReaction $reaction): string => $reaction->user->id,
+    );
+
+    expect($timeline->userReactions)->toHaveCount(3)
+        ->and($owners->all())->toEqualCanonicalizing($users->pluck('id')->all());
+});
+
+it('rejeita segunda reação do mesmo usuário no mesmo post', function (): void {
+    $user = User::factory()->create();
+    $timeline = Timeline::factory()->create();
+
+    UserReaction::factory()->for($user)->for($timeline)->create();
+
+    expect(fn () => DB::transaction(
+        fn () => UserReaction::factory()->for($user)->for($timeline)->create(),
+    ))->toThrow(QueryException::class);
+
+    $this->assertDatabaseCount('activity_user_reactions', 1);
+});
+
+it('rejeita reaction fora do conjunto do enum', function (): void {
+    expect(fn () => UserReaction::factory()->create(['reaction' => 'xpto']))
+        ->toThrow(ValueError::class);
+});