feat(panel-admin): grupos Pessoas e Conteúdo na navegação por domínio

app-modules/contents/src/Data/TagList.php

@@ -4,7 +4,13 @@
 
 namespace He4rt\Contents\Data;
 
-final readonly class TagList
+use Illuminate\Contracts\Support\Arrayable;
+use JsonSerializable;
+
+/**
+ * @implements Arrayable<int, string>
+ */
+final readonly class TagList implements Arrayable, JsonSerializable
 {
     /** @param list<string> $tags */
     public function __construct(
@@ -52,4 +58,12 @@ public function contains(string $tag): bool
     {
         return in_array($tag, $this->tags, strict: true);
     }
+
+    /**
+     * @return list<string>
+     */
+    public function jsonSerialize(): array
+    {
+        return $this->tags;
+    }
 }

app-modules/identity/src/ExternalIdentity/Enums/IdentityProvider.php

@@ -123,7 +123,7 @@ public function getColor(): array
             self::Discord => Color::Blue,
             self::Twitch => Color::Purple,
             self::DevTo => Color::Gray,
-            self::Spotify => ['#1DB954'],
+            self::Spotify => Color::hex('#1DB954'),
             self::Steam => Color::Slate,
             self::GitHub => Color::Neutral,
             self::Xbox => Color::Green,

app-modules/identity/src/User/Enums/UserSituation.php

@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace He4rt\Identity\User\Enums;
+
+use App\Enums\Concerns\StringifyEnum;
+use Filament\Support\Contracts\HasColor;
+use Filament\Support\Contracts\HasDescription;
+use Filament\Support\Contracts\HasIcon;
+use Filament\Support\Contracts\HasLabel;
+use Filament\Support\Icons\Heroicon;
+
+/**
+ * Estado de acesso de um usuário, derivado de `banned_at` e `suspended_until`.
+ *
+ * Não existe coluna correspondente: quem escreve essas duas datas é
+ * {@see \He4rt\Moderation\Platform\WebModerationAdapter}, a partir de um caso
+ * de moderação. Aqui elas só são lidas.
+ */
+enum UserSituation: string implements HasColor, HasDescription, HasIcon, HasLabel
+{
+    use StringifyEnum;
+
+    case Active = 'active';
+    case Suspended = 'suspended';
+    case Banned = 'banned';
+
+    public function getLabel(): string
+    {
+        return match ($this) {
+            self::Active => 'Ativo',
+            self::Suspended => 'Suspenso',
+            self::Banned => 'Banido',
+        };
+    }
+
+    public function getColor(): string
+    {
+        return match ($this) {
+            self::Active => 'success',
+            self::Suspended => 'warning',
+            self::Banned => 'danger',
+        };
+    }
+
+    public function getDescription(): string
+    {
+        return match ($this) {
+            self::Active => 'Sem restrição ativa',
+            self::Suspended => 'Acesso bloqueado até a data de término',
+            self::Banned => 'Acesso revogado por decisão de moderação',
+        };
+    }
+
+    public function getIcon(): Heroicon
+    {
+        return match ($this) {
+            self::Active => Heroicon::OutlinedCheckCircle,
+            self::Suspended => Heroicon::OutlinedClock,
+            self::Banned => Heroicon::OutlinedNoSymbol,
+        };
+    }
+}

app-modules/identity/src/User/Models/User.php

@@ -12,10 +12,13 @@
 use He4rt\Gamification\Character\Models\Character;
 use He4rt\Identity\Database\Factories\UserFactory;
 use He4rt\Identity\ExternalIdentity\Models\ExternalIdentity;
+use He4rt\Identity\User\Enums\UserSituation;
 use He4rt\Identity\User\Observers\UserObserver;
+use He4rt\Profile\Models\Profile;
 use Illuminate\Database\Eloquent\Attributes\Hidden;
 use Illuminate\Database\Eloquent\Attributes\ObservedBy;
 use Illuminate\Database\Eloquent\Attributes\Table;
+use Illuminate\Database\Eloquent\Attributes\UseFactory;
 use Illuminate\Database\Eloquent\Casts\Attribute;
 use Illuminate\Database\Eloquent\Concerns\HasUuids;
 use Illuminate\Database\Eloquent\Factories\HasFactory;
@@ -38,8 +41,10 @@
  * @property string|null $remember_token
  * @property CarbonInterface|null $created_at
  * @property CarbonInterface|null $updated_at
+ * @property-read UserSituation $situation
  */
 #[ObservedBy(classes: UserObserver::class)]
+#[UseFactory(factoryClass: UserFactory::class)]
 #[Table(name: 'users')]
 #[Hidden('password', 'remember_token', 'email_verified_at')]
 final class User extends Authenticatable implements FilamentUser, HasMedia, HasName
@@ -72,6 +77,14 @@ public function character(): HasOne
         return $this->hasOne(Character::class);
     }
 
+    /**
+     * @return HasOne<Profile, $this>
+     */
+    public function profile(): HasOne
+    {
+        return $this->hasOne(Profile::class);
+    }
+
     public function getFilamentName(): string
     {
         return $this->username;
@@ -102,9 +115,12 @@ public function getFilamentAvatarUrl(): string
         return sprintf('https://github.com/%s.png', $this->username);
     }
 
-    protected static function newFactory(): UserFactory
+    /**
+     * @return Attribute<UserSituation, never>
+     */
+    protected function situation(): Attribute
     {
-        return UserFactory::new();
+        return Attribute::get($this->resolveSituation(...));
     }
 
     /**
@@ -136,4 +152,16 @@ protected function casts(): array
             'first_login_at' => 'datetime',
         ];
     }
+
+    private function resolveSituation(): UserSituation
+    {
+        $isBanned = $this->banned_at !== null;
+        $isSuspended = $this->suspended_until !== null && $this->suspended_until->isFuture();
+
+        return match (true) {
+            $isBanned => UserSituation::Banned,
+            $isSuspended => UserSituation::Suspended,
+            default => UserSituation::Active,
+        };
+    }
 }

app-modules/identity/tests/Unit/IdentityProviderColorTest.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+use He4rt\Identity\ExternalIdentity\Enums\IdentityProvider;
+
+/**
+ * O BadgeComponent do Filament indexa a paleta por tonalidade (50, 400, 600…).
+ * Uma cor declarada como hex solto renderiza a listagem inteira com
+ * "Undefined array key 50", e só aparece quando aquele provider cai na tela.
+ */
+test('todo provider expõe a paleta completa de tonalidades', function (IdentityProvider $provider): void {
+    expect($provider->getColor())
+        ->toBeArray()
+        ->toHaveKeys([50, 100, 200, 300, 400, 500, 600, 700, 800, 900, 950]);
+})->with(IdentityProvider::cases());

app-modules/identity/tests/Unit/UserSituationTest.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+use Carbon\CarbonInterface;
+use He4rt\Identity\User\Enums\UserSituation;
+use He4rt\Identity\User\Models\User;
+
+/**
+ * `situation` é derivado de duas colunas já carregadas: não há consulta por
+ * trás. Os modelos aqui são instanciados sem persistir, porque a suíte Unit
+ * roda sem banco (só a Feature recebe LazilyRefreshDatabase).
+ */
+function userWith(?CarbonInterface $bannedAt = null, ?CarbonInterface $suspendedUntil = null): User
+{
+    $user = new User();
+
+    $user->banned_at = $bannedAt;
+    $user->suspended_until = $suspendedUntil;
+
+    return $user;
+}
+
+test('banned_at preenchido devolve Banned', function (): void {
+    expect(userWith(bannedAt: now()->subDay())->situation)->toBe(UserSituation::Banned);
+});
+
+test('suspensão vigente devolve Suspended', function (): void {
+    expect(userWith(suspendedUntil: now()->addWeek())->situation)->toBe(UserSituation::Suspended);
+});
+
+test('suspensão vencida devolve Active', function (): void {
+    expect(userWith(suspendedUntil: now()->subDay())->situation)->toBe(UserSituation::Active);
+});
+
+test('sem punição devolve Active', function (): void {
+    expect(userWith()->situation)->toBe(UserSituation::Active);
+});
+
+test('banimento vence suspensão quando os dois estão preenchidos', function (): void {
+    $user = userWith(bannedAt: now()->subDay(), suspendedUntil: now()->addWeek());
+
+    expect($user->situation)->toBe(UserSituation::Banned);
+});