From 1ecfb04759d3e4c6d270abcb1639172c72db7739 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Tue, 6 Oct 2026 19:45:35 -0300
Subject: [PATCH 01/77] =?UTF-8?q?docs(delas):=20spec=20da=20solicita=C3=A7?=
=?UTF-8?q?=C3=A3o=20da=20tag=20e=20do=20painel=20de=20modera=C3=A7=C3=A3o?=
=?UTF-8?q?=20He4rt=20Delas?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Descreve o design das issues #570 e #571: módulo delas, papel
delas-moderator via spatie/laravel-permission (ADR-0002 do identity),
espera de 15 dias, bloqueio de solicitantes e histórico de decisões.
---
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 335 ++++++++++++++++++
1 file changed, 335 insertions(+)
create mode 100644 docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
new file mode 100644
index 000000000..fb090692f
--- /dev/null
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -0,0 +1,335 @@
+---
+type: spec
+title: 'He4rt Delas: solicitação da tag e painel de moderação'
+status: draft
+date: 2026-10-06
+author: damacosta
+related:
+ issues: [570, 571]
+ modules: [delas, identity, panel-app, panel-admin]
+---
+
+# He4rt Delas: solicitação da tag e painel de moderação
+
+Spec cross-module: cria o módulo `delas` e altera `identity`, `panel-app` e `panel-admin`. Por
+isso fica em `docs/specs/` e não dentro de um módulo.
+
+## Contexto
+
+A He4rt Delas é a iniciativa da comunidade voltada a mulheres e pessoas que se identificam como
+mulheres. No Discord ela já existe como cargo: o `/cargo-delas`
+(`app-modules/bot-discord/src/SlashCommands/CargoDelasCommand.php`) deixa quem tem o cargo
+`comite_delas` conceder o cargo `he4rt_delas`. No Hub, não existe nada equivalente.
+
+As issues [#571](https://github.com/he4rt/heartdevs.com/issues/571) (solicitação da tag) e
+[#570](https://github.com/he4rt/heartdevs.com/issues/570) (painel de moderação) são duas metades
+da mesma feature e serão entregues juntas.
+
+Fatos do código atual que moldam o desenho:
+
+- **Autorização é `spatie/laravel-permission`, só com roles**
+ ([ADR-0002 do identity](../../app-modules/identity/docs/adr/0002-super-admin-via-spatie-permission.md)).
+ Roles são cases de `UserRole` (`super-admin`, `streamer`), criadas por migration no identity
+ (ex.: `2026_10_04_000000_create_streamer_role.php`) e atribuídas pelo `CheckboxList` de roles em
+ `panel-admin/src/Filament/Resources/Users/Schemas/UserForm.php`. `Gate::before` no
+ `IdentityServiceProvider` libera tudo para `super-admin`. O precedente de papel comum é
+ `streamer`, verificado por `Gate::define('use-streamer-tools')`.
+- **Fora de produção, o `/admin` é aberto a qualquer usuário autenticado**
+ (`User::canAccessPanel`).
+- **Não há perfil público.** "Exibir no perfil" significa a página de perfil do `/app`
+ (`panel-app/src/Pages/ProfilePage.php`) e o card de preview
+ (`components/profile-preview-card.blade.php`), visíveis só para a própria pessoa.
+
+## Objetivos
+
+1. Uma membra solicita a tag He4rt Delas no próprio perfil e acompanha o status.
+2. Moderadoras da He4rt Delas veem a fila de pendentes no Hub e aprovam, rejeitam ou bloqueiam.
+3. Super admins atribuem o papel de moderadora e podem conceder ou remover a tag diretamente.
+4. Toda decisão sobre a tag fica registrada com quem fez, quando e o motivo.
+5. Toda regra de acesso é aplicada no domínio, não só ocultando a interface.
+
+## Fora do escopo
+
+- Sincronizar a tag com o cargo `he4rt_delas` no Discord (os eventos de domínio deixam pronto).
+- Notificar a solicitante por e-mail ou Discord.
+- Perfil público e exibição da tag para outras pessoas.
+- Auditoria de atribuição de roles (concern do identity, vale para todas as roles).
+- Permissions granulares do Spatie (a ADR-0002 fica só em roles nesta fase).
+
+## Regras de negócio
+
+### Solicitação (membra)
+
+- A opção de solicitar aparece no perfil para contas novas e já existentes.
+- Ativar a opção abre um pop-up explicando o que é a He4rt Delas. A solicitação só é registrada
+ após a confirmação.
+- Enquanto pendente, o perfil mostra o texto de aguardando aprovação e **não** mostra a tag.
+- Após aprovada, a tag aparece no perfil.
+- Não é possível solicitar quando:
+ - já existe uma solicitação `pending` ou `approved`;
+ - a última solicitação foi `rejected` ou `revoked` e ainda não passou a espera
+ (ver [Espera](#espera-de-15-dias));
+ - existe um bloqueio ativo. O perfil informa apenas que não é possível solicitar, sem motivo.
+
+### Moderação (moderadoras da He4rt Delas)
+
+- Veem a fila de solicitações `pending`: nome/perfil da solicitante e data do pedido.
+- Aprovam ou rejeitam cada solicitação. Rejeição pede motivo, interno.
+- Bloqueiam uma solicitante, com motivo obrigatório. Bloquear rejeita a solicitação pendente, se
+ houver.
+- Não podem bloquear quem passa no gate `moderate-delas` (outras moderadoras e super admins,
+ via `Gate::before`) nem a si mesmas.
+- Desbloqueiam os bloqueios que elas mesmas fizeram.
+- O bloqueio vale **só** para solicitar a tag. Não é ban nem suspensão (`UserSituation`) e não
+ afeta a conta.
+
+### Administração (super admins)
+
+- Atribuem e retiram o papel `delas-moderator` pelo `UserForm` existente. O acesso some na
+ próxima requisição, porque `hasRole` lê `model_has_roles` a cada request.
+- Concedem a tag diretamente:
+ - se houver solicitação `pending`, ela é aprovada (`pending → approved`, `triggered_by=admin`);
+ - se não houver, é criada uma solicitação já `approved`;
+ - se a pessoa já tem a tag, a ação é recusada com exceção de domínio;
+ - se a pessoa estiver bloqueada, a interface mostra quem bloqueou, quando e o motivo, e exige
+ um motivo da admin. O bloqueio é encerrado na mesma transação.
+- Removem a tag (`approved → revoked`), com motivo obrigatório. O registro não é apagado. A
+ pessoa pode solicitar de novo após a espera, salvo se também for bloqueada.
+- Veem todos os bloqueios e desfazem qualquer um.
+
+### Espera de 15 dias
+
+`next_allowed_at = decided_at + config('delas.request_cooldown_days')` dias, com padrão `15`. A
+comparação é com `now()` em UTC. A data é exibida como DD/MM em
+`config('app.display_timezone')`.
+
+## Arquitetura
+
+### Módulo `delas`
+
+Novo módulo `app-modules/delas`, namespace `He4rt\Delas\`, dependente só de **identity**. Os
+painéis dependem dele, nunca o contrário.
+
+```
+identity ◀── delas ◀── panel-app
+ ▲ ▲
+ └── panel-admin ─┘
+```
+
+Entram junto com o módulo, conforme o guideline `domain/02-module-architecture`:
+
+- `composer.json` do módulo exigindo `he4rt/identity`, e `he4rt/delas` no `composer.json` raiz;
+- `CONTEXT.md` com glossário e "Não confundir com": **Tag He4rt Delas** ≠ Badge de
+ gamification; **Bloqueio** ≠ ban/suspensão do identity; **Moderadora He4rt Delas** ≠ moderação
+ de conteúdo do módulo `moderation`;
+- `docs/adr/0001-...` registrando as decisões desta spec;
+- linha no `CONTEXT-MAP.md`, na tabela e nas regras de dependência;
+- label `mod:delas` no guideline `workflow/02-triage-labels` e no GitHub;
+- `config/delas.php` dentro do módulo, carregado com `mergeConfigFrom`;
+- textos em `lang/{en,pt_BR}/`.
+
+Subdomínios: `src/TagRequest/`, `src/Block/`, `src/History/`.
+
+### Mudanças no identity
+
+- Case `DelasModerator = 'delas-moderator'` em `UserRole`, com label "Moderadora He4rt Delas",
+ cor, descrição e ícone (o enum usa `match` sem `default`).
+- Migration `create_delas_moderator_role`, igual à do streamer: `Role::findOrCreate` e
+ `forgetCachedPermissions` no `up`, remoção no `down`. O `RolesSeeder` já itera os cases.
+- State `UserFactory::delasModerator()`, seguindo `streamer()` e `superAdmin()`.
+
+O case precisa morar em `UserRole` porque enums não são extensíveis por outro módulo.
+
+### Autorização
+
+| Gate | `delas-moderator` | `super-admin` |
+| -------------------------------------------------------- | :---------------: | :-----------: |
+| `moderate-delas` (ver fila, aprovar, rejeitar, bloquear) | ✓ | ✓ |
+| `manage-delas-tag` (conceder/remover a tag direto) | | ✓ |
+
+- Os gates são definidos no `DelasServiceProvider`, porque são vocabulário do delas. Isso diverge
+ do `use-streamer-tools`, que fica no identity; a ADR do módulo registra a escolha.
+- `moderate-delas`: `$user->hasRole(UserRole::DelasModerator)`.
+- `manage-delas-tag`: `fn (): bool => false`, com comentário apontando que só `super-admin`
+ passa, via `Gate::before`.
+- Não há classes Policy. As actions de domínio recebem o ator no DTO, checam
+ `Gate::forUser($actor)->authorize(...)` e aplicam as regras de negócio com exceções de domínio
+ (`DelasException::cannotBlockModerator()` etc.), como fazem as actions do `events`.
+- "Não bloquear moderadora ou admin" é `Gate::forUser($target)->allows('moderate-delas')`.
+- O `CheckboxList` de roles do `UserForm` passa a ser visível só para `isSuperAdmin()`. Sem
+ isso, fora de produção qualquer pessoa autenticada atribuiria `delas-moderator`.
+
+### Modelo de dados
+
+Postgres. Migrations criadas com `make:migration --module=delas`. Chaves UUID com `HasUuids`,
+sobrescrevendo o stub do projeto (que gera bigint identity), como nos módulos `events`,
+`marketing` e `streaming`. Colunas de enum são `string` com `->comment(Enum::stringifyCases())`.
+Datas em `timestampTz`.
+
+#### `delas_tag_requests` (model `DelasTagRequest`)
+
+| coluna | tipo | nota |
+| --------------------------- | ---------------- | ----------------------------- |
+| `id` | uuid | PK |
+| `user_id` | uuid | FK `users`, cascade on delete |
+| `status` | string(20) | `DelasRequestStatus` |
+| `requested_at` | timestampTz | |
+| `decided_by` | uuid null | FK `users`, null on delete |
+| `decided_at` | timestampTz null | |
+| `decision_reason` | text null | interno |
+| `created_at` / `updated_at` | timestampTz | |
+
+Índice único parcial em `user_id` onde `status in ('pending', 'approved')`, via `DB::statement`
+(precedente: `identity/.../2026_07_07_000000_drop_multi_tenancy.php`). Ele garante uma
+solicitação ativa por pessoa e resolve a concorrência do primeiro pedido: a
+`UniqueConstraintViolationException` vira exceção de domínio.
+
+`DelasRequestStatus::canTransitionTo()`:
+
+```
+pending → approved | rejected
+approved → revoked
+```
+
+#### `delas_requester_blocks` (model `DelasRequesterBlock`)
+
+| coluna | tipo | nota |
+| --------------------------- | ---------------- | ----------------------------- |
+| `id` | uuid | PK |
+| `user_id` | uuid | FK `users`, cascade on delete |
+| `blocked_by` | uuid null | FK `users`, null on delete |
+| `reason` | text | obrigatório |
+| `blocked_at` | timestampTz | |
+| `lifted_by` | uuid null | FK `users`, null on delete |
+| `lifted_at` | timestampTz null | |
+| `lift_reason` | text null | |
+| `created_at` / `updated_at` | timestampTz | |
+
+Índice único parcial em `user_id` onde `lifted_at is null`.
+
+#### `delas_transitions` (model `DelasTransition`, `UPDATED_AT = null`)
+
+Histórico append-only, gravado pelas actions, sem trigger (ADR-0003 do events). Formato mais
+próximo de `squad_membership_events` (ação + trilha) do que de `events_enrollment_transitions`.
+
+| coluna | tipo | nota |
+| --------------------------- | --------------- | ------------------------------------------------------------------------------------------------ |
+| `id` | uuid | PK |
+| `user_id` | uuid | FK `users`, cascade on delete; a pessoa afetada |
+| `request_id` | uuid null | FK `delas_tag_requests`, cascade on delete |
+| `block_id` | uuid null | FK `delas_requester_blocks`, cascade on delete |
+| `action` | string(20) | `DelasAction`: `requested`, `approved`, `rejected`, `granted`, `revoked`, `blocked`, `unblocked` |
+| `from_status` / `to_status` | string(20) null | `DelasRequestStatus`, quando há mudança de status |
+| `actor_id` | uuid null | FK `users`, null on delete |
+| `triggered_by` | string(20) | `DelasTriggeredBy`: `user`, `moderator`, `admin`, `system` |
+| `reason` | text null | |
+| `created_at` | timestampTz | `useCurrent()` |
+
+Sem coluna `metadata`: nenhum fluxo a preenche, e um jsonb sem forma quebraria o
+`tests/Arch/NoLooseArrayCastsTest.php` (guideline `domain/06`).
+
+#### Models e enums
+
+- Os três models declaram `#[Table]`, `#[UseFactory]` e PHPDoc `@property` sincronizado
+ (guideline `domain/04`). Factories com states `pending`, `approved`, `rejected`, `revoked` e
+ `lifted`.
+- `DelasRequestStatus`, `DelasAction` e `DelasTriggeredBy` implementam `HasLabel`, `HasColor` e
+ `HasDescription` (guideline `domain/07`) e usam `StringifyEnum`. Labels em
+ `delas/lang/{en,pt_BR}/enums.php`. `DelasTriggeredBy` é próprio do módulo; o `TriggeredBy` do
+ `events` não pode ser importado.
+
+### Actions de domínio
+
+`final readonly`, `handle(DTO)`, sem sufixo `Action` (padrão de `CreateShortLink`,
+`ReviewAppeal`). As que mudam estado rodam em `DB::transaction` com `lockForUpdate()` e gravam
+a linha de histórico.
+
+| Action | Gate do ator | Faz |
+| ----------------------- | -------------------------------------------------------- | ------------------------------------------------------ |
+| `RequestDelasTag` | (própria pessoa) | valida ativa, espera e bloqueio; cria `pending` |
+| `ApproveDelasRequest` | `moderate-delas` | `pending → approved` |
+| `RejectDelasRequest` | `moderate-delas` | `pending → rejected`, com motivo |
+| `BlockDelasRequester` | `moderate-delas` | cria bloqueio e rejeita a pendente |
+| `UnblockDelasRequester` | `moderate-delas` (próprios) / `manage-delas-tag` (todos) | encerra bloqueio |
+| `GrantDelasTag` | `manage-delas-tag` | aprova a pendente ou cria `approved`; encerra bloqueio |
+| `RevokeDelasTag` | `manage-delas-tag` | `approved → revoked`, com motivo |
+
+A consulta `DelasEligibility` responde para o perfil: pode solicitar, por que não, e
+`next_allowed_at`.
+
+### Eventos de domínio
+
+`DelasTagRequested`, `DelasTagApproved`, `DelasTagRejected`, `DelasTagGranted`,
+`DelasTagRevoked`, `DelasRequesterBlocked`, `DelasRequesterUnblocked`. Classes `final readonly`,
+`Dispatchable`, `ShouldDispatchAfterCommit`, com payload de IDs escalares e enums
+(`requestId`, `userId`, `actorId`), sem models. Quando `GrantDelasTag` encerra um bloqueio,
+dispara também `DelasRequesterUnblocked`. Nenhum listener nesta entrega.
+
+### Interface
+
+**Hub (`/app`, `panel-app`)**
+
+- Perfil (`ProfilePage`): seção He4rt Delas com toggle e pop-up de confirmação, estado pendente,
+ data da próxima tentativa ou aviso de bloqueio. Tag no card de preview, separada dos badges.
+ Textos em `panel-app/lang/{en,pt_BR}/profile.php`.
+- Página He4rt Delas (nova), registrada em `AppPanelProvider->pages([...])`, com
+ `canAccess(): auth()->user()?->can('moderate-delas') ?? false`, como as páginas de streaming.
+ Abas "Pendentes" (aprovar, rejeitar, bloquear) e "Bloqueios" (desbloquear). Base visual:
+ `panel-admin/src/Moderation/Livewire/AppealQueue.php`.
+
+**Admin (`/admin`, `panel-admin`)**
+
+- Actions Filament `GrantDelasTagAction` e `RevokeDelasTagAction` em
+ `panel-admin/src/Filament/Resources/Users/Tables/UsersTable.php`, chamando as actions de
+ domínio.
+- Visibilidade do `CheckboxList` de roles no `UserForm` restrita a super admins.
+
+## Trade-offs e alternativas consideradas
+
+| Alternativa | Por que não |
+| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| Tag como role Spatie `he4rt-delas`, espelhando o Discord | Role não guarda solicitação, decisão, espera nem bloqueio; misturaria autorização com identidade |
+| Badge de `gamification` | Badges são progressão por XP/claim, sem fluxo de aprovação |
+| Tipo dentro de `onboarding` | Onboarding é a camada de entrada obrigatória; a tag é opcional e pode vir a qualquer momento |
+| Subdomínio em `profile` | Acoplaria o perfil a moderação e papéis; um módulo próprio isola a feature e as regras |
+| Permissions granulares (`delas.solicitacoes.decidir` etc.) | A ADR-0002 adota só roles nesta fase; gates nomeados permitem migrar depois sem mudar chamadas |
+
+## Testes
+
+Pest. Feature em `delas/tests/Feature` (grupo e `LazilyRefreshDatabase` vêm do `tests/Pest.php`),
+unitários em `delas/tests/Unit`.
+
+- `DelasRequestStatus::canTransitionTo` (unit).
+- Solicitar: `pending` só após confirmação; recusa se ativa, em espera ou bloqueada; duas
+ solicitações simultâneas, só uma passa.
+- Espera: bloqueada antes de `next_allowed_at` e liberada depois, com `travelTo`.
+- Aprovar e rejeitar: mudam status, gravam histórico com ator e data, recusam sem
+ `moderate-delas`; duas decisões simultâneas, só uma passa.
+- Bloqueio: motivo obrigatório; recusa bloquear moderadora, super admin ou a si mesma; moderadora
+ não desbloqueia bloqueio de outra.
+- Admin: concede com pendente aberta (aprova), sem solicitação (cria), já aprovada (recusa) e
+ bloqueada (encerra o bloqueio); remove a tag.
+- Papel: perde acesso ao retirar `delas-moderator`; o campo de roles não aparece para quem não é
+ super admin.
+- Páginas: seção He4rt Delas invisível e inacessível sem `moderate-delas`.
+- Arch (opcional): `He4rt\Delas` não importa `He4rt\Panel*`.
+
+Validação: `make check`, `make test` e `make test-shards`.
+
+## Entrega
+
+- Branch `feature/he4rt-delas`, PR único para `4.x` com `Closes #570` e `Closes #571`, no
+ template do repositório. Commits `feat(delas): ...` (e `feat(identity)`, `feat(panel-app)`,
+ `feat(panel-admin)` onde couber).
+- Labels nas issues: `type:feat`, `mod:delas`, `mod:identity`, `mod:panel-app`,
+ `mod:panel-admin`.
+
+## Pontos em aberto
+
+1. **Regras além das issues** (espera de 15 dias, bloqueio, concessão e remoção direta): alinhar
+ com a Alícia e a Sther nas issues.
+2. **Nome do papel**: `delas-moderator` cobre líder e moderadora, como na issue. Confirmar com a
+ Sther.
+3. **LGPD**: a tag revela identidade de gênero, dado sensível. Hoje só a própria pessoa e quem
+ modera a veem. Qualquer exibição pública futura precisa de decisão própria.
+4. **Rejeição**: a solicitante deve ver o motivo? Hoje, não.
From b4ba335d5da054a9db4c5010eb923e552179e859 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Tue, 6 Oct 2026 20:57:52 -0300
Subject: [PATCH 02/77] =?UTF-8?q?feat(delas):=20cria=20o=20m=C3=B3dulo=20d?=
=?UTF-8?q?elas?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Esqueleto do módulo de domínio da He4rt Delas: composer, service provider
com config (espera de 15 dias) e traduções, CONTEXT.md com glossário,
ADR-0001 com as decisões da spec, registro no CONTEXT-MAP e label mod:delas
na tabela de triagem.
---
.../workflow/02-triage-labels.blade.php | 1 +
CONTEXT-MAP.md | 30 ++++-----
app-modules/delas/CONTEXT.md | 28 +++++++++
app-modules/delas/composer.json | 30 +++++++++
app-modules/delas/config/delas.php | 17 +++++
app-modules/delas/database/factories/.gitkeep | 0
.../delas/database/migrations/.gitkeep | 0
app-modules/delas/database/seeders/.gitkeep | 0
...01-modulo-proprio-com-papel-e-historico.md | 62 +++++++++++++++++++
app-modules/delas/phpstan.ignore.neon | 2 +
app-modules/delas/phpstan.neon | 6 ++
.../delas/src/DelasServiceProvider.php | 20 ++++++
app-modules/delas/tests/Feature/.gitkeep | 0
app-modules/delas/tests/Unit/.gitkeep | 0
composer.json | 1 +
composer.lock | 41 +++++++++++-
16 files changed, 223 insertions(+), 15 deletions(-)
create mode 100644 app-modules/delas/CONTEXT.md
create mode 100644 app-modules/delas/composer.json
create mode 100644 app-modules/delas/config/delas.php
create mode 100644 app-modules/delas/database/factories/.gitkeep
create mode 100644 app-modules/delas/database/migrations/.gitkeep
create mode 100644 app-modules/delas/database/seeders/.gitkeep
create mode 100644 app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
create mode 100644 app-modules/delas/phpstan.ignore.neon
create mode 100644 app-modules/delas/phpstan.neon
create mode 100644 app-modules/delas/src/DelasServiceProvider.php
create mode 100644 app-modules/delas/tests/Feature/.gitkeep
create mode 100644 app-modules/delas/tests/Unit/.gitkeep
diff --git a/.ai/guidelines/workflow/02-triage-labels.blade.php b/.ai/guidelines/workflow/02-triage-labels.blade.php
index 56d22eb9a..58bead562 100644
--- a/.ai/guidelines/workflow/02-triage-labels.blade.php
+++ b/.ai/guidelines/workflow/02-triage-labels.blade.php
@@ -43,6 +43,7 @@
| `mod:bot-discord` | `bot-discord` | Discord bot |
| `mod:community` | `community` | Community features |
| `mod:contents` | `contents` | Published content catalogue |
+| `mod:delas` | `delas` | He4rt Delas tag & moderation |
| `mod:economy` | `economy` | Economy/wallet system |
| `mod:events` | `events` | Events & participation |
| `mod:gamification` | `gamification` | XP, levels, ranking |
diff --git a/CONTEXT-MAP.md b/CONTEXT-MAP.md
index 28a78d96b..08c3f5f44 100644
--- a/CONTEXT-MAP.md
+++ b/CONTEXT-MAP.md
@@ -9,21 +9,22 @@ This is a modular monorepo (`internachi/modular`). Each bounded context lives un
## Contexts
-| Context | Path | Description |
-| ------------------- | ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------- |
-| Moderation | `app-modules/moderation/` | Content moderation pipeline — classification, routing, enforcement, appeals |
-| Bot Discord | `app-modules/bot-discord/` | Discord bot runtime (Laracord websocket, slash commands, event handlers) |
-| Integration Discord | `app-modules/integration-discord/` | Discord platform transport (REST API via Saloon), OAuth, ETL |
-| Identity | `app-modules/identity/` | Users, tenants, external identities, authentication |
-| Events | `app-modules/events/` | Event participation lifecycle — enrollment, check-in, attendance, XP dispatch; community photo gallery (albums) |
-| Gamification | `app-modules/gamification/` | Character progression — XP, levels, badges, seasons, daily bonuses |
-| Panel Admin | `app-modules/panel-admin/` | Filament admin panel — dashboards, resources, moderation UI, marketing |
-| Integration Twitch | `app-modules/integration-twitch/` | Twitch platform transport (Helix API via Saloon), OAuth, EventSub webhooks |
-| Integration GitHub | `app-modules/integration-github/` | GitHub transport (REST via Saloon), OAuth, community contribution ingestion (backfill + webhooks) + event lake |
-| Onboarding | `app-modules/onboarding/` | Universal, mandatory entry layer — polymorphic onboarding state machines by type; owns the per-type completion gate (APTO) |
-| Squads | `app-modules/squads/` | Squad lifecycle, membership and governance (captain/sub-captain, elections, removal, reallocation) |
-| Marketing | `app-modules/marketing/` | Divulgação e sua medição — links curtos (`/l/{slug}`), destino versionado, captura crua de cliques |
+| Context | Path | Description |
+| ------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- |
+| Moderation | `app-modules/moderation/` | Content moderation pipeline — classification, routing, enforcement, appeals |
+| Bot Discord | `app-modules/bot-discord/` | Discord bot runtime (Laracord websocket, slash commands, event handlers) |
+| Integration Discord | `app-modules/integration-discord/` | Discord platform transport (REST API via Saloon), OAuth, ETL |
+| Identity | `app-modules/identity/` | Users, tenants, external identities, authentication |
+| Events | `app-modules/events/` | Event participation lifecycle — enrollment, check-in, attendance, XP dispatch; community photo gallery (albums) |
+| Gamification | `app-modules/gamification/` | Character progression — XP, levels, badges, seasons, daily bonuses |
+| Panel Admin | `app-modules/panel-admin/` | Filament admin panel — dashboards, resources, moderation UI, marketing |
+| Integration Twitch | `app-modules/integration-twitch/` | Twitch platform transport (Helix API via Saloon), OAuth, EventSub webhooks |
+| Integration GitHub | `app-modules/integration-github/` | GitHub transport (REST via Saloon), OAuth, community contribution ingestion (backfill + webhooks) + event lake |
+| Onboarding | `app-modules/onboarding/` | Universal, mandatory entry layer — polymorphic onboarding state machines by type; owns the per-type completion gate (APTO) |
+| Squads | `app-modules/squads/` | Squad lifecycle, membership and governance (captain/sub-captain, elections, removal, reallocation) |
+| Marketing | `app-modules/marketing/` | Divulgação e sua medição — links curtos (`/l/{slug}`), destino versionado, captura crua de cliques |
| Contents | `app-modules/contents/` | Canonical catalogue of content published on external platforms (articles now, video next) — delegated types + provider contract |
+| Delas | `app-modules/delas/` | He4rt Delas no Hub — solicitação da tag, decisão das moderadoras, bloqueios e histórico |
## Relationships
@@ -76,3 +77,4 @@ This is a modular monorepo (`internachi/modular`). Each bounded context lives un
- **Squads** depends on Onboarding (reads the `Squads`-completion gate, "APTO") and Identity (users/tenants). It never imports from presentation; the panels depend on it.
- **Marketing** owns short links and their click record. It depends only on **Identity** (`created_by` / `user_id` on a click) and on no other context. It renders no UI and registers no route: `portal` owns the public `/l/{slug}` edge and the "link unavailable" page, and `panel-admin` owns the staff CRUD and dashboards — both depend on `marketing`, never the reverse.
- **Contents** owns the canonical record of externally published content. It never talks HTTP (the `integration-*` modules implement its provider contract) and never awards anything — it emits `ArticlePublished` and `activity` decides. It depends on Identity (authorship resolution, `ExternalIdentityConnected`); `activity` and the panels depend on it, never the reverse.
+- **Delas** owns the He4rt Delas tag (request, decision, cooldown, blocks and their history). It depends only on **Identity** (`User`, the `delas-moderator` case of `UserRole`). It renders no UI: `panel-app` (profile request and moderators' queue) and `panel-admin` (direct grant/removal) depend on it, never the reverse.
diff --git a/app-modules/delas/CONTEXT.md b/app-modules/delas/CONTEXT.md
new file mode 100644
index 000000000..28ed92d83
--- /dev/null
+++ b/app-modules/delas/CONTEXT.md
@@ -0,0 +1,28 @@
+# Contexto do Delas
+
+Este módulo é a fonte da verdade sobre **quem faz parte da He4rt Delas no Hub**: a tag que a
+pessoa pede no perfil, a decisão das moderadoras, os bloqueios de quem não pode pedir e o
+histórico de cada uma dessas decisões.
+
+É um **módulo de domínio puro**: não tem rota, view nem Filament.
+
+- O `panel-app` mostra a solicitação no perfil e a fila das moderadoras.
+- O `panel-admin` concede e remove a tag direto.
+
+Os dois painéis dependem deste módulo, e este módulo só depende do `identity`.
+
+> **Status:** em implementação. O design está na
+> [spec](../../docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md) e as decisões na
+> [ADR-0001](docs/adr/0001-modulo-proprio-com-papel-e-historico.md).
+
+## Glossário
+
+| Termo | Definição | Não confundir com |
+| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| **Tag He4rt Delas** | Marca no perfil de que a pessoa faz parte da He4rt Delas. Existe quando a solicitação dela está `approved`. | Um Badge do `gamification`: badges vêm de XP ou claim, a tag vem de uma decisão. |
+| **Solicitação** | Uma linha em `delas_tag_requests`: o pedido da tag e a decisão sobre ele (`pending`, `approved`, `rejected`, `revoked`). | O cargo `he4rt_delas` do Discord, concedido pelo `/cargo-delas`. Os dois ainda não são sincronizados. |
+| **Moderadora He4rt Delas** | Quem tem a role `delas-moderator` (`UserRole::DelasModerator`) e passa no gate `moderate-delas`. Decide solicitações e bloqueia solicitantes. | A moderação de conteúdo do módulo `moderation` (Case, Appeal, Moderator). |
+| **Bloqueio** | Uma linha em `delas_requester_blocks`: impede a pessoa de solicitar a tag até ser desbloqueada. Sempre tem motivo. | Ban ou suspensão (`UserSituation` do `identity`): o bloqueio não afeta a conta nem o resto do Hub. |
+| **Espera** | Prazo depois de uma solicitação `rejected` ou `revoked` em que a pessoa não pode pedir de novo. Padrão de 15 dias (`delas.request_cooldown_days`). | O bloqueio: a espera acaba sozinha, o bloqueio só acaba quando alguém desbloqueia. |
+| **Concessão direta** | Super admin dá a tag sem solicitação e sem espera (`GrantDelasTag`). Encerra um bloqueio ativo, se houver. | Aprovar uma solicitação: aprovar é decisão sobre um pedido que a pessoa fez. |
+| **Histórico** | `delas_transitions`: uma linha por ação (solicitar, aprovar, rejeitar, conceder, remover, bloquear, desbloquear), com quem fez, quando e motivo. | Logs da aplicação: o histórico é dado de domínio, append-only, gravado pelas próprias actions. |
diff --git a/app-modules/delas/composer.json b/app-modules/delas/composer.json
new file mode 100644
index 000000000..544bf0517
--- /dev/null
+++ b/app-modules/delas/composer.json
@@ -0,0 +1,30 @@
+{
+ "name": "he4rt/delas",
+ "description": "",
+ "type": "library",
+ "version": "1.0.0",
+ "license": "proprietary",
+ "require": {
+ "he4rt/identity": "^1.0.0"
+ },
+ "autoload": {
+ "psr-4": {
+ "He4rt\\Delas\\": "src/",
+ "He4rt\\Delas\\Database\\Factories\\": "database/factories/",
+ "He4rt\\Delas\\Database\\Seeders\\": "database/seeders/"
+ }
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "He4rt\\Delas\\Tests\\": "tests/"
+ }
+ },
+ "minimum-stability": "stable",
+ "extra": {
+ "laravel": {
+ "providers": [
+ "He4rt\\Delas\\DelasServiceProvider"
+ ]
+ }
+ }
+}
diff --git a/app-modules/delas/config/delas.php b/app-modules/delas/config/delas.php
new file mode 100644
index 000000000..83f7cd150
--- /dev/null
+++ b/app-modules/delas/config/delas.php
@@ -0,0 +1,17 @@
+ (int) env('DELAS_REQUEST_COOLDOWN_DAYS', 15),
+];
diff --git a/app-modules/delas/database/factories/.gitkeep b/app-modules/delas/database/factories/.gitkeep
new file mode 100644
index 000000000..e69de29bb
diff --git a/app-modules/delas/database/migrations/.gitkeep b/app-modules/delas/database/migrations/.gitkeep
new file mode 100644
index 000000000..e69de29bb
diff --git a/app-modules/delas/database/seeders/.gitkeep b/app-modules/delas/database/seeders/.gitkeep
new file mode 100644
index 000000000..e69de29bb
diff --git a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
new file mode 100644
index 000000000..01563ebc9
--- /dev/null
+++ b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
@@ -0,0 +1,62 @@
+---
+type: adr
+title: 'Módulo próprio, papel do Spatie e histórico de decisões'
+module: delas
+status: accepted
+date: 2026-10-06
+deciders:
+ - damacosta
+related:
+ spec: 2026-10-06-he4rt-delas-tag-e-moderacao
+---
+
+# ADR-0001: Módulo próprio, papel do Spatie e histórico de decisões
+
+## Contexto
+
+As issues #570 e #571 pedem que uma pessoa solicite a tag He4rt Delas no perfil e que líderes
+ou moderadoras da He4rt Delas aprovem ou rejeitem o pedido dentro do Hub, com registro de quem
+decidiu e quando. No Discord isso já existe como cargo (`/cargo-delas`), mas no Hub não há nada.
+
+A feature tem estado (pedido, decisão, espera, bloqueio), papéis próprios e histórico. Ela
+precisa morar em algum lugar e ter uma forma de autorizar quem decide.
+
+## Alternativas consideradas
+
+- **Tag como role do Spatie (`he4rt-delas`).** Espelha o cargo do Discord, mas uma role não guarda
+ pedido, decisão, espera nem bloqueio, e mistura autorização com identidade.
+- **Badge do `gamification`.** Badges são progressão por XP ou claim, sem fluxo de aprovação.
+- **Tipo dentro do `onboarding`.** O onboarding é a camada de entrada obrigatória. A tag é
+ opcional e pode ser pedida a qualquer momento.
+- **Subdomínio do `profile`.** Acoplaria o perfil a papéis e moderação.
+- **Permissions granulares do Spatie.** A ADR-0002 do `identity` adota só roles nesta fase.
+
+## Decisão
+
+- **Módulo de domínio `delas`**, dependente só do `identity`. Os painéis dependem dele.
+- **Papel `delas-moderator`** como case de `UserRole` no `identity`, criado por migration, como a
+ role `streamer`. Líder e moderadora são o mesmo papel, como na issue.
+- **Gates nomeados no `DelasServiceProvider`**: `moderate-delas` (checa a role) e
+ `manage-delas-tag` (sempre `false`; só `super-admin` passa, pelo `Gate::before` do identity).
+ O código checa o gate, nunca o nome da role.
+ - _Diverge do `use-streamer-tools`, que fica no `IdentityServiceProvider`._ Aqui o gate é
+ vocabulário do delas, e o identity não deve conhecer regras de outro módulo.
+- **Solicitação com máquina de estados em enum** (`pending → approved | rejected`,
+ `approved → revoked`), como a ADR-0001 do `events`.
+- **Espera de 15 dias** depois de `rejected` ou `revoked`, configurável.
+- **Bloqueio** como registro próprio, com motivo obrigatório, feito por moderadoras e desfeito por
+ quem bloqueou ou por super admin.
+- **Histórico append-only** em `delas_transitions`, gravado pelas actions, sem trigger (ADR-0003
+ do `events`).
+
+## Consequências
+
+- O `identity` ganha um case em `UserRole`, uma migration de role e um state de factory.
+- O campo de roles do `UserForm` passa a ser visível só para super admin. Fora de produção o
+ `/admin` é aberto, e sem isso qualquer pessoa autenticada se daria `delas-moderator`.
+- A auditoria de quem atribuiu ou retirou `delas-moderator` não fica neste módulo: é concern do
+ `identity` e vale para todas as roles.
+- Sincronizar a tag com o cargo `he4rt_delas` do Discord fica para depois. Os eventos de domínio
+ deixam o gancho pronto.
+- A tag revela identidade de gênero, dado sensível pela LGPD. Hoje só a própria pessoa e quem
+ modera a veem; exibir a tag publicamente exige nova decisão.
diff --git a/app-modules/delas/phpstan.ignore.neon b/app-modules/delas/phpstan.ignore.neon
new file mode 100644
index 000000000..f51e71c3f
--- /dev/null
+++ b/app-modules/delas/phpstan.ignore.neon
@@ -0,0 +1,2 @@
+parameters:
+ ignoreErrors: []
diff --git a/app-modules/delas/phpstan.neon b/app-modules/delas/phpstan.neon
new file mode 100644
index 000000000..b577d0f29
--- /dev/null
+++ b/app-modules/delas/phpstan.neon
@@ -0,0 +1,6 @@
+includes:
+ - phpstan.ignore.neon
+
+parameters:
+ paths:
+ - src/
diff --git a/app-modules/delas/src/DelasServiceProvider.php b/app-modules/delas/src/DelasServiceProvider.php
new file mode 100644
index 000000000..2c8a8bfe4
--- /dev/null
+++ b/app-modules/delas/src/DelasServiceProvider.php
@@ -0,0 +1,20 @@
+mergeConfigFrom(__DIR__.'/../config/delas.php', 'delas');
+ }
+
+ public function boot(): void
+ {
+ $this->loadTranslationsFrom(__DIR__.'/../lang', 'delas');
+ }
+}
diff --git a/app-modules/delas/tests/Feature/.gitkeep b/app-modules/delas/tests/Feature/.gitkeep
new file mode 100644
index 000000000..e69de29bb
diff --git a/app-modules/delas/tests/Unit/.gitkeep b/app-modules/delas/tests/Unit/.gitkeep
new file mode 100644
index 000000000..e69de29bb
diff --git a/composer.json b/composer.json
index ecdc67069..5b9bf50b7 100644
--- a/composer.json
+++ b/composer.json
@@ -19,6 +19,7 @@
"he4rt/bot-discord": "^1.0.0",
"he4rt/community": "^1.0.0",
"he4rt/contents": "^1.0.0",
+ "he4rt/delas": "^1.0.0",
"he4rt/docs": "^1.0.0",
"he4rt/economy": "^1.0.0",
"he4rt/events": "^1.0.0",
diff --git a/composer.lock b/composer.lock
index cd0e45f87..89bde4578 100644
--- a/composer.lock
+++ b/composer.lock
@@ -4,7 +4,7 @@
"Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies",
"This file is @generated automatically"
],
- "content-hash": "3044d4f3dddf69acd834eca1f013788a",
+ "content-hash": "cc49a31c9de8f58e9b1b2a934ad73e9a",
"packages": [
{
"name": "anourvalar/eloquent-serialize",
@@ -3545,6 +3545,45 @@
"relative": true
}
},
+ {
+ "name": "he4rt/delas",
+ "version": "1.0.0",
+ "dist": {
+ "type": "path",
+ "url": "app-modules/delas",
+ "reference": "b5d246ffe28b5c571da00174c00565e3e7762d0e"
+ },
+ "require": {
+ "he4rt/identity": "^1.0.0"
+ },
+ "type": "library",
+ "extra": {
+ "laravel": {
+ "providers": [
+ "He4rt\\Delas\\DelasServiceProvider"
+ ]
+ }
+ },
+ "autoload": {
+ "psr-4": {
+ "He4rt\\Delas\\": "src/",
+ "He4rt\\Delas\\Database\\Factories\\": "database/factories/",
+ "He4rt\\Delas\\Database\\Seeders\\": "database/seeders/"
+ }
+ },
+ "autoload-dev": {
+ "psr-4": {
+ "He4rt\\Delas\\Tests\\": "tests/"
+ }
+ },
+ "license": [
+ "proprietary"
+ ],
+ "transport-options": {
+ "symlink": true,
+ "relative": true
+ }
+ },
{
"name": "he4rt/docs",
"version": "1.0",
From bb08513b5dc349134c07dcc850a99f45cc051ee4 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Tue, 6 Oct 2026 21:24:12 -0300
Subject: [PATCH 03/77] docs(delas): cluster He4rt Delas no admin e identidade
visual
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Super admins ganham um cluster próprio no /admin (dashboard, solicitações,
bloqueios, histórico e moderadoras); moderadoras seguem decidindo no Hub,
como pede a #570. A tabela de Usuários só exibe as roles. Registra a
paleta e as logos da He4rt Delas.
---
...01-modulo-proprio-com-papel-e-historico.md | 6 +++
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 42 ++++++++++++++++---
2 files changed, 42 insertions(+), 6 deletions(-)
diff --git a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
index 01563ebc9..4eed7fb57 100644
--- a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
+++ b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
@@ -48,6 +48,12 @@ precisa morar em algum lugar e ter uma forma de autorizar quem decide.
quem bloqueou ou por super admin.
- **Histórico append-only** em `delas_transitions`, gravado pelas actions, sem trigger (ADR-0003
do `events`).
+- **Dois espaços de interface.** Moderadoras decidem numa página do Hub (`/app`), como a #570
+ pede, porque não têm acesso ao `/admin`. Super admins têm um **cluster He4rt Delas** no
+ `/admin` (dashboard, solicitações, bloqueios, histórico e moderadoras), no formato do cluster de
+ Moderação. A tabela de Usuários só exibe as roles.
+ - _Alternativa descartada:_ abrir o `/admin` para moderadoras, limitado ao cluster. Contradiz a
+ ADR-0002 do `identity` ("o painel inteiro é super admin ou nada").
## Consequências
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index fb090692f..d7439cf26 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -85,8 +85,12 @@ Fatos do código atual que moldam o desenho:
### Administração (super admins)
-- Atribuem e retiram o papel `delas-moderator` pelo `UserForm` existente. O acesso some na
- próxima requisição, porque `hasRole` lê `model_has_roles` a cada request.
+Tudo acontece no cluster He4rt Delas do `/admin` (ver [Interface](#interface)). Super admins
+também passam no gate `moderate-delas` e podem decidir solicitações por lá.
+
+- Atribuem e retiram o papel `delas-moderator` na página Moderadoras do cluster. O `UserForm`
+ continua listando a role, como faz com todas. O acesso some na próxima requisição, porque
+ `hasRole` lê `model_has_roles` a cada request.
- Concedem a tag diretamente:
- se houver solicitação `pending`, ela é aprovada (`pending → approved`, `triggered_by=admin`);
- se não houver, é criada uma solicitação já `approved`;
@@ -279,11 +283,36 @@ dispara também `DelasRequesterUnblocked`. Nenhum listener nesta entrega.
**Admin (`/admin`, `panel-admin`)**
-- Actions Filament `GrantDelasTagAction` e `RevokeDelasTagAction` em
- `panel-admin/src/Filament/Resources/Users/Tables/UsersTable.php`, chamando as actions de
- domínio.
+Cluster **He4rt Delas** em `panel-admin/src/Delas/`, no mesmo formato do cluster de Moderação
+(`ModerationDashboard`, fila, appeals, `AuditLogPage`): slug `delas`, sidebar própria em
+`PanelAdminServiceProvider::buildNavigation` (match em `delas/`, com link de volta ao admin) e
+entrada na navegação padrão.
+
+| Página | Conteúdo |
+| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Dashboard | Cartões: pendentes agora, membras com a tag, tempo médio até a decisão, aprovadas e rejeitadas no mês, bloqueios ativos. Lista das últimas decisões. Gráficos ficam para depois |
+| Solicitações | Todas, com filtro por status. Aprovar e rejeitar as pendentes, conceder e remover a tag (`GrantDelasTagAction`, `RevokeDelasTagAction`) |
+| Bloqueios | Todos (ativos e encerrados), com desbloqueio |
+| Histórico | `delas_transitions`: data, ação, pessoa afetada, quem fez e motivo |
+| Moderadoras | Quem tem `delas-moderator`, com adicionar e revogar |
+
+- Todas as páginas do cluster exigem `manage-delas-tag` no `canAccess()`. Fora de produção o
+ `/admin` é aberto a qualquer pessoa autenticada, então o painel sozinho não protege.
+- A tabela de Usuários só **mostra** as roles (badges "Super admin", "Moderadora He4rt Delas"),
+ sem ações da He4rt Delas.
- Visibilidade do `CheckboxList` de roles no `UserForm` restrita a super admins.
+### Identidade visual
+
+- Paleta He4rt Delas (primária `#F485A2`; 50 `#FFD1EE` → 900 `#730835`) como tokens do design
+ system em `app-modules/he4rt/resources/css/support/themes.css` e `index.css`, usada só nos
+ elementos da He4rt Delas. O resto do Hub mantém os tokens da He4rt.
+- A tag usa o rosa claro com texto e ícone no tom 900. Texto branco só do tom 600 para cima
+ (WCAG AA).
+- Logos oficiais (ícone, vertical e horizontal) como SVG `currentColor` nos assets do design
+ system.
+- Protótipo de referência validado com a Danielle; tokens e assets a confirmar com a Sther.
+
## Trade-offs e alternativas consideradas
| Alternativa | Por que não |
@@ -311,7 +340,8 @@ unitários em `delas/tests/Unit`.
bloqueada (encerra o bloqueio); remove a tag.
- Papel: perde acesso ao retirar `delas-moderator`; o campo de roles não aparece para quem não é
super admin.
-- Páginas: seção He4rt Delas invisível e inacessível sem `moderate-delas`.
+- Páginas: seção He4rt Delas do Hub invisível e inacessível sem `moderate-delas`; páginas do
+ cluster do `/admin` inacessíveis sem `manage-delas-tag`, inclusive para moderadoras.
- Arch (opcional): `He4rt\Delas` não importa `He4rt\Panel*`.
Validação: `make check`, `make test` e `make test-shards`.
From 3f0cca97b046e238989607caf16193e257266dfb Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Tue, 6 Oct 2026 21:40:38 -0300
Subject: [PATCH 04/77] =?UTF-8?q?docs(delas):=20papel=20de=20l=C3=ADder=20?=
=?UTF-8?q?e=20regras=20de=20desbloqueio=20e=20autodecis=C3=A3o?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Acrescenta o papel delas-lead (gerencia moderadoras, concede e remove a
tag e vê o histórico completo, no Hub), os gates moderate-delas,
lead-delas e administer-delas, motivo obrigatório no desbloqueio e a
proibição de a moderadora decidir a própria solicitação.
---
app-modules/delas/CONTEXT.md | 19 +--
...01-modulo-proprio-com-papel-e-historico.md | 15 +-
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 152 +++++++++++-------
3 files changed, 109 insertions(+), 77 deletions(-)
diff --git a/app-modules/delas/CONTEXT.md b/app-modules/delas/CONTEXT.md
index 28ed92d83..874e1dba7 100644
--- a/app-modules/delas/CONTEXT.md
+++ b/app-modules/delas/CONTEXT.md
@@ -17,12 +17,13 @@ Os dois painéis dependem deste módulo, e este módulo só depende do `identity
## Glossário
-| Termo | Definição | Não confundir com |
-| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
-| **Tag He4rt Delas** | Marca no perfil de que a pessoa faz parte da He4rt Delas. Existe quando a solicitação dela está `approved`. | Um Badge do `gamification`: badges vêm de XP ou claim, a tag vem de uma decisão. |
-| **Solicitação** | Uma linha em `delas_tag_requests`: o pedido da tag e a decisão sobre ele (`pending`, `approved`, `rejected`, `revoked`). | O cargo `he4rt_delas` do Discord, concedido pelo `/cargo-delas`. Os dois ainda não são sincronizados. |
-| **Moderadora He4rt Delas** | Quem tem a role `delas-moderator` (`UserRole::DelasModerator`) e passa no gate `moderate-delas`. Decide solicitações e bloqueia solicitantes. | A moderação de conteúdo do módulo `moderation` (Case, Appeal, Moderator). |
-| **Bloqueio** | Uma linha em `delas_requester_blocks`: impede a pessoa de solicitar a tag até ser desbloqueada. Sempre tem motivo. | Ban ou suspensão (`UserSituation` do `identity`): o bloqueio não afeta a conta nem o resto do Hub. |
-| **Espera** | Prazo depois de uma solicitação `rejected` ou `revoked` em que a pessoa não pode pedir de novo. Padrão de 15 dias (`delas.request_cooldown_days`). | O bloqueio: a espera acaba sozinha, o bloqueio só acaba quando alguém desbloqueia. |
-| **Concessão direta** | Super admin dá a tag sem solicitação e sem espera (`GrantDelasTag`). Encerra um bloqueio ativo, se houver. | Aprovar uma solicitação: aprovar é decisão sobre um pedido que a pessoa fez. |
-| **Histórico** | `delas_transitions`: uma linha por ação (solicitar, aprovar, rejeitar, conceder, remover, bloquear, desbloquear), com quem fez, quando e motivo. | Logs da aplicação: o histórico é dado de domínio, append-only, gravado pelas próprias actions. |
+| Termo | Definição | Não confundir com |
+| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| **Tag He4rt Delas** | Marca no perfil de que a pessoa faz parte da He4rt Delas. Existe quando a solicitação dela está `approved`. | Um Badge do `gamification`: badges vêm de XP ou claim, a tag vem de uma decisão. |
+| **Solicitação** | Uma linha em `delas_tag_requests`: o pedido da tag e a decisão sobre ele (`pending`, `approved`, `rejected`, `revoked`). | O cargo `he4rt_delas` do Discord, concedido pelo `/cargo-delas`. Os dois ainda não são sincronizados. |
+| **Moderadora He4rt Delas** | Quem tem a role `delas-moderator` (`UserRole::DelasModerator`) e passa no gate `moderate-delas`. Decide solicitações e bloqueia solicitantes. | A moderação de conteúdo do módulo `moderation` (Case, Appeal, Moderator). |
+| **Líder He4rt Delas** | Quem tem a role `delas-lead` (`UserRole::DelasLead`) e passa no gate `lead-delas`. Tudo o que a moderadora faz, mais gerenciar moderadoras, conceder e remover a tag e ver o histórico completo, no Hub. | Super admin: a líder não entra no `/admin` nem nomeia outras líderes. |
+| **Bloqueio** | Uma linha em `delas_requester_blocks`: impede a pessoa de solicitar a tag até ser desbloqueada. Sempre tem motivo. | Ban ou suspensão (`UserSituation` do `identity`): o bloqueio não afeta a conta nem o resto do Hub. |
+| **Espera** | Prazo depois de uma solicitação `rejected` ou `revoked` em que a pessoa não pode pedir de novo. Padrão de 15 dias (`delas.request_cooldown_days`). | O bloqueio: a espera acaba sozinha, o bloqueio só acaba quando alguém desbloqueia. |
+| **Concessão direta** | Super admin dá a tag sem solicitação e sem espera (`GrantDelasTag`). Encerra um bloqueio ativo, se houver. | Aprovar uma solicitação: aprovar é decisão sobre um pedido que a pessoa fez. |
+| **Histórico** | `delas_transitions`: uma linha por ação (solicitar, aprovar, rejeitar, conceder, remover, bloquear, desbloquear), com quem fez, quando e motivo. | Logs da aplicação: o histórico é dado de domínio, append-only, gravado pelas próprias actions. |
diff --git a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
index 4eed7fb57..af4f9e73f 100644
--- a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
+++ b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
@@ -34,10 +34,13 @@ precisa morar em algum lugar e ter uma forma de autorizar quem decide.
## Decisão
- **Módulo de domínio `delas`**, dependente só do `identity`. Os painéis dependem dele.
-- **Papel `delas-moderator`** como case de `UserRole` no `identity`, criado por migration, como a
- role `streamer`. Líder e moderadora são o mesmo papel, como na issue.
-- **Gates nomeados no `DelasServiceProvider`**: `moderate-delas` (checa a role) e
- `manage-delas-tag` (sempre `false`; só `super-admin` passa, pelo `Gate::before` do identity).
+- **Papéis `delas-moderator` e `delas-lead`** como cases de `UserRole` no `identity`, criados por
+ migration, como a role `streamer`. A líder gerencia moderadoras, concede e remove a tag e vê o
+ histórico completo, tudo no Hub. _Vai além da #570_ ("atribuível apenas por admins do Hub"):
+ dá autonomia à He4rt Delas sem abrir o `/admin`.
+- **Gates nomeados no `DelasServiceProvider`**: `moderate-delas` (moderadora ou líder),
+ `lead-delas` (líder) e `administer-delas` (sempre `false`; só `super-admin` passa, pelo
+ `Gate::before` do identity).
O código checa o gate, nunca o nome da role.
- _Diverge do `use-streamer-tools`, que fica no `IdentityServiceProvider`._ Aqui o gate é
vocabulário do delas, e o identity não deve conhecer regras de outro módulo.
@@ -60,8 +63,8 @@ precisa morar em algum lugar e ter uma forma de autorizar quem decide.
- O `identity` ganha um case em `UserRole`, uma migration de role e um state de factory.
- O campo de roles do `UserForm` passa a ser visível só para super admin. Fora de produção o
`/admin` é aberto, e sem isso qualquer pessoa autenticada se daria `delas-moderator`.
-- A auditoria de quem atribuiu ou retirou `delas-moderator` não fica neste módulo: é concern do
- `identity` e vale para todas as roles.
+- Papéis alterados pelas actions do delas entram no histórico. Os alterados direto no `UserForm`
+ não: essa auditoria é concern do `identity` e vale para todas as roles.
- Sincronizar a tag com o cargo `he4rt_delas` do Discord fica para depois. Os eventos de domínio
deixam o gancho pronto.
- A tag revela identidade de gênero, dado sensível pela LGPD. Hoje só a própria pessoa e quem
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index d7439cf26..6fd09b1d1 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -53,7 +53,8 @@ Fatos do código atual que moldam o desenho:
- Sincronizar a tag com o cargo `he4rt_delas` no Discord (os eventos de domínio deixam pronto).
- Notificar a solicitante por e-mail ou Discord.
- Perfil público e exibição da tag para outras pessoas.
-- Auditoria de atribuição de roles (concern do identity, vale para todas as roles).
+- Auditoria de roles alteradas pelo `UserForm` (concern do identity). As alterações feitas pelas
+ actions do delas (`AddDelasModerator` etc.) entram no histórico.
- Permissions granulares do Spatie (a ADR-0002 fica só em roles nesta fase).
## Regras de negócio
@@ -79,18 +80,35 @@ Fatos do código atual que moldam o desenho:
houver.
- Não podem bloquear quem passa no gate `moderate-delas` (outras moderadoras e super admins,
via `Gate::before`) nem a si mesmas.
-- Desbloqueiam os bloqueios que elas mesmas fizeram.
+- Desbloqueiam os bloqueios que elas mesmas fizeram, com motivo obrigatório.
+- Não decidem a própria solicitação: ela fica para outra moderadora, uma líder ou um super admin.
- O bloqueio vale **só** para solicitar a tag. Não é ban nem suspensão (`UserSituation`) e não
afeta a conta.
+### Liderança (líderes da He4rt Delas)
+
+Papel `delas-lead`, atribuído só por super admins. A líder trabalha **na mesma página do Hub**,
+sem acesso ao `/admin`, e tem tudo o que a moderadora tem, mais:
+
+- números da He4rt Delas no topo da página;
+- histórico completo;
+- aba Moderadoras: adiciona e revoga `delas-moderator`. Não cria nem revoga líderes, e não age
+ sobre super admins;
+- desbloqueia qualquer bloqueio;
+- concede e remove a tag direto, com as mesmas regras da administração abaixo.
+
+> _Vai além da #570_, que diz que a permissão é "atribuível apenas por admins do Hub". Precisa do
+> ok da Sther e de um comentário na issue.
+
### Administração (super admins)
Tudo acontece no cluster He4rt Delas do `/admin` (ver [Interface](#interface)). Super admins
-também passam no gate `moderate-delas` e podem decidir solicitações por lá.
+passam em todos os gates (via `Gate::before`) e podem fazer tudo o que líderes e moderadoras
+fazem.
-- Atribuem e retiram o papel `delas-moderator` na página Moderadoras do cluster. O `UserForm`
- continua listando a role, como faz com todas. O acesso some na próxima requisição, porque
- `hasRole` lê `model_has_roles` a cada request.
+- Atribuem e retiram `delas-lead` e `delas-moderator` na página Moderadoras e líderes do
+ cluster. O `UserForm` continua listando as roles, como faz com todas. O acesso some na próxima
+ requisição, porque `hasRole` lê `model_has_roles` a cada request.
- Concedem a tag diretamente:
- se houver solicitação `pending`, ela é aprovada (`pending → approved`, `triggered_by=admin`);
- se não houver, é criada uma solicitação já `approved`;
@@ -136,25 +154,29 @@ Subdomínios: `src/TagRequest/`, `src/Block/`, `src/History/`.
### Mudanças no identity
-- Case `DelasModerator = 'delas-moderator'` em `UserRole`, com label "Moderadora He4rt Delas",
- cor, descrição e ícone (o enum usa `match` sem `default`).
-- Migration `create_delas_moderator_role`, igual à do streamer: `Role::findOrCreate` e
+- Cases `DelasModerator = 'delas-moderator'` ("Moderadora He4rt Delas") e
+ `DelasLead = 'delas-lead'` ("Líder He4rt Delas") em `UserRole`, com cor, descrição e ícone (o
+ enum usa `match` sem `default`).
+- Migration `create_delas_roles`, igual à do streamer: `Role::findOrCreate` das duas roles e
`forgetCachedPermissions` no `up`, remoção no `down`. O `RolesSeeder` já itera os cases.
-- State `UserFactory::delasModerator()`, seguindo `streamer()` e `superAdmin()`.
+- States `UserFactory::delasModerator()` e `UserFactory::delasLead()`, seguindo `streamer()` e
+ `superAdmin()`.
O case precisa morar em `UserRole` porque enums não são extensíveis por outro módulo.
### Autorização
-| Gate | `delas-moderator` | `super-admin` |
-| -------------------------------------------------------- | :---------------: | :-----------: |
-| `moderate-delas` (ver fila, aprovar, rejeitar, bloquear) | ✓ | ✓ |
-| `manage-delas-tag` (conceder/remover a tag direto) | | ✓ |
+| Gate | `delas-moderator` | `delas-lead` | `super-admin` |
+| ----------------------------------------------------------------------------------------------------- | :---------------: | :----------: | :-----------: |
+| `moderate-delas` (ver fila, aprovar, rejeitar, bloquear, desbloquear os próprios) | ✓ | ✓ | ✓ |
+| `lead-delas` (números, histórico completo, moderadoras, desbloquear qualquer, conceder/remover a tag) | | ✓ | ✓ |
+| `administer-delas` (cluster do `/admin`, atribuir e revogar líderes) | | | ✓ |
- Os gates são definidos no `DelasServiceProvider`, porque são vocabulário do delas. Isso diverge
do `use-streamer-tools`, que fica no identity; a ADR do módulo registra a escolha.
-- `moderate-delas`: `$user->hasRole(UserRole::DelasModerator)`.
-- `manage-delas-tag`: `fn (): bool => false`, com comentário apontando que só `super-admin`
+- `moderate-delas`: `$user->hasAnyRole([UserRole::DelasModerator, UserRole::DelasLead])`.
+- `lead-delas`: `$user->hasRole(UserRole::DelasLead)`.
+- `administer-delas`: `fn (): bool => false`, com comentário apontando que só `super-admin`
passa, via `Gate::before`.
- Não há classes Policy. As actions de domínio recebem o ator no DTO, checam
`Gate::forUser($actor)->authorize(...)` e aplicam as regras de negócio com exceções de domínio
@@ -197,17 +219,17 @@ approved → revoked
#### `delas_requester_blocks` (model `DelasRequesterBlock`)
-| coluna | tipo | nota |
-| --------------------------- | ---------------- | ----------------------------- |
-| `id` | uuid | PK |
-| `user_id` | uuid | FK `users`, cascade on delete |
-| `blocked_by` | uuid null | FK `users`, null on delete |
-| `reason` | text | obrigatório |
-| `blocked_at` | timestampTz | |
-| `lifted_by` | uuid null | FK `users`, null on delete |
-| `lifted_at` | timestampTz null | |
-| `lift_reason` | text null | |
-| `created_at` / `updated_at` | timestampTz | |
+| coluna | tipo | nota |
+| --------------------------- | ---------------- | ----------------------------------------------- |
+| `id` | uuid | PK |
+| `user_id` | uuid | FK `users`, cascade on delete |
+| `blocked_by` | uuid null | FK `users`, null on delete |
+| `reason` | text | obrigatório |
+| `blocked_at` | timestampTz | |
+| `lifted_by` | uuid null | FK `users`, null on delete |
+| `lifted_at` | timestampTz null | |
+| `lift_reason` | text null | obrigatório ao desbloquear; nulo enquanto ativo |
+| `created_at` / `updated_at` | timestampTz | |
Índice único parcial em `user_id` onde `lifted_at is null`.
@@ -216,18 +238,18 @@ approved → revoked
Histórico append-only, gravado pelas actions, sem trigger (ADR-0003 do events). Formato mais
próximo de `squad_membership_events` (ação + trilha) do que de `events_enrollment_transitions`.
-| coluna | tipo | nota |
-| --------------------------- | --------------- | ------------------------------------------------------------------------------------------------ |
-| `id` | uuid | PK |
-| `user_id` | uuid | FK `users`, cascade on delete; a pessoa afetada |
-| `request_id` | uuid null | FK `delas_tag_requests`, cascade on delete |
-| `block_id` | uuid null | FK `delas_requester_blocks`, cascade on delete |
-| `action` | string(20) | `DelasAction`: `requested`, `approved`, `rejected`, `granted`, `revoked`, `blocked`, `unblocked` |
-| `from_status` / `to_status` | string(20) null | `DelasRequestStatus`, quando há mudança de status |
-| `actor_id` | uuid null | FK `users`, null on delete |
-| `triggered_by` | string(20) | `DelasTriggeredBy`: `user`, `moderator`, `admin`, `system` |
-| `reason` | text null | |
-| `created_at` | timestampTz | `useCurrent()` |
+| coluna | tipo | nota |
+| --------------------------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `id` | uuid | PK |
+| `user_id` | uuid | FK `users`, cascade on delete; a pessoa afetada |
+| `request_id` | uuid null | FK `delas_tag_requests`, cascade on delete |
+| `block_id` | uuid null | FK `delas_requester_blocks`, cascade on delete |
+| `action` | string(20) | `DelasAction`: `requested`, `approved`, `rejected`, `granted`, `revoked`, `blocked`, `unblocked`, `moderator_added`, `moderator_removed` |
+| `from_status` / `to_status` | string(20) null | `DelasRequestStatus`, quando há mudança de status |
+| `actor_id` | uuid null | FK `users`, null on delete |
+| `triggered_by` | string(20) | `DelasTriggeredBy`: `user`, `moderator`, `lead`, `admin`, `system` |
+| `reason` | text null | |
+| `created_at` | timestampTz | `useCurrent()` |
Sem coluna `metadata`: nenhum fluxo a preenche, e um jsonb sem forma quebraria o
`tests/Arch/NoLooseArrayCastsTest.php` (guideline `domain/06`).
@@ -248,15 +270,17 @@ Sem coluna `metadata`: nenhum fluxo a preenche, e um jsonb sem forma quebraria o
`ReviewAppeal`). As que mudam estado rodam em `DB::transaction` com `lockForUpdate()` e gravam
a linha de histórico.
-| Action | Gate do ator | Faz |
-| ----------------------- | -------------------------------------------------------- | ------------------------------------------------------ |
-| `RequestDelasTag` | (própria pessoa) | valida ativa, espera e bloqueio; cria `pending` |
-| `ApproveDelasRequest` | `moderate-delas` | `pending → approved` |
-| `RejectDelasRequest` | `moderate-delas` | `pending → rejected`, com motivo |
-| `BlockDelasRequester` | `moderate-delas` | cria bloqueio e rejeita a pendente |
-| `UnblockDelasRequester` | `moderate-delas` (próprios) / `manage-delas-tag` (todos) | encerra bloqueio |
-| `GrantDelasTag` | `manage-delas-tag` | aprova a pendente ou cria `approved`; encerra bloqueio |
-| `RevokeDelasTag` | `manage-delas-tag` | `approved → revoked`, com motivo |
+| Action | Gate do ator | Faz |
+| -------------------------------------------- | -------------------------------------------------- | ---------------------------------------------------------------------------- |
+| `RequestDelasTag` | (própria pessoa) | valida ativa, espera e bloqueio; cria `pending` |
+| `ApproveDelasRequest` | `moderate-delas` | `pending → approved` |
+| `RejectDelasRequest` | `moderate-delas` | `pending → rejected`, com motivo |
+| `BlockDelasRequester` | `moderate-delas` | cria bloqueio e rejeita a pendente |
+| `UnblockDelasRequester` | `moderate-delas` (próprios) / `lead-delas` (todos) | encerra bloqueio |
+| `GrantDelasTag` | `lead-delas` | aprova a pendente ou cria `approved`; encerra bloqueio |
+| `RevokeDelasTag` | `lead-delas` | `approved → revoked`, com motivo |
+| `AddDelasModerator` / `RemoveDelasModerator` | `lead-delas` | atribui ou retira `delas-moderator`; recusa líderes e super admins como alvo |
+| `AddDelasLead` / `RemoveDelasLead` | `administer-delas` | atribui ou retira `delas-lead` |
A consulta `DelasEligibility` responde para o perfil: pode solicitar, por que não, e
`next_allowed_at`.
@@ -288,15 +312,15 @@ Cluster **He4rt Delas** em `panel-admin/src/Delas/`, no mesmo formato do cluster
`PanelAdminServiceProvider::buildNavigation` (match em `delas/`, com link de volta ao admin) e
entrada na navegação padrão.
-| Página | Conteúdo |
-| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Dashboard | Cartões: pendentes agora, membras com a tag, tempo médio até a decisão, aprovadas e rejeitadas no mês, bloqueios ativos. Lista das últimas decisões. Gráficos ficam para depois |
-| Solicitações | Todas, com filtro por status. Aprovar e rejeitar as pendentes, conceder e remover a tag (`GrantDelasTagAction`, `RevokeDelasTagAction`) |
-| Bloqueios | Todos (ativos e encerrados), com desbloqueio |
-| Histórico | `delas_transitions`: data, ação, pessoa afetada, quem fez e motivo |
-| Moderadoras | Quem tem `delas-moderator`, com adicionar e revogar |
+| Página | Conteúdo |
+| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Dashboard | Cartões: pendentes agora, membras com a tag, tempo médio até a decisão, aprovadas e rejeitadas no mês, bloqueios ativos. Lista das últimas decisões. Gráficos ficam para depois |
+| Solicitações | Todas, com filtro por status. Aprovar e rejeitar as pendentes, conceder e remover a tag (`GrantDelasTagAction`, `RevokeDelasTagAction`) |
+| Bloqueios | Todos (ativos e encerrados), com desbloqueio |
+| Histórico | `delas_transitions`: data, ação, pessoa afetada, quem fez e motivo |
+| Moderadoras e líderes | Quem tem `delas-moderator` ou `delas-lead`, com adicionar e revogar os dois papéis |
-- Todas as páginas do cluster exigem `manage-delas-tag` no `canAccess()`. Fora de produção o
+- Todas as páginas do cluster exigem `administer-delas` no `canAccess()`. Fora de produção o
`/admin` é aberto a qualquer pessoa autenticada, então o painel sozinho não protege.
- A tabela de Usuários só **mostra** as roles (badges "Super admin", "Moderadora He4rt Delas"),
sem ações da He4rt Delas.
@@ -333,7 +357,8 @@ unitários em `delas/tests/Unit`.
solicitações simultâneas, só uma passa.
- Espera: bloqueada antes de `next_allowed_at` e liberada depois, com `travelTo`.
- Aprovar e rejeitar: mudam status, gravam histórico com ator e data, recusam sem
- `moderate-delas`; duas decisões simultâneas, só uma passa.
+ `moderate-delas`; duas decisões simultâneas, só uma passa; moderadora não decide a própria
+ solicitação.
- Bloqueio: motivo obrigatório; recusa bloquear moderadora, super admin ou a si mesma; moderadora
não desbloqueia bloqueio de outra.
- Admin: concede com pendente aberta (aprova), sem solicitação (cria), já aprovada (recusa) e
@@ -341,7 +366,7 @@ unitários em `delas/tests/Unit`.
- Papel: perde acesso ao retirar `delas-moderator`; o campo de roles não aparece para quem não é
super admin.
- Páginas: seção He4rt Delas do Hub invisível e inacessível sem `moderate-delas`; páginas do
- cluster do `/admin` inacessíveis sem `manage-delas-tag`, inclusive para moderadoras.
+ cluster do `/admin` inacessíveis sem `administer-delas`, inclusive para moderadoras e líderes.
- Arch (opcional): `He4rt\Delas` não importa `He4rt\Panel*`.
Validação: `make check`, `make test` e `make test-shards`.
@@ -356,10 +381,13 @@ Validação: `make check`, `make test` e `make test-shards`.
## Pontos em aberto
-1. **Regras além das issues** (espera de 15 dias, bloqueio, concessão e remoção direta): alinhar
+1. **Papel `delas-lead`**: líder atribuindo `delas-moderator` vai além da #570. Precisa do ok da
+ Sther e de comentário na issue.
+
+2. **Regras além das issues** (espera de 15 dias, bloqueio, concessão e remoção direta): alinhar
com a Alícia e a Sther nas issues.
-2. **Nome do papel**: `delas-moderator` cobre líder e moderadora, como na issue. Confirmar com a
+3. **Nome do papel**: `delas-moderator` cobre líder e moderadora, como na issue. Confirmar com a
Sther.
-3. **LGPD**: a tag revela identidade de gênero, dado sensível. Hoje só a própria pessoa e quem
+4. **LGPD**: a tag revela identidade de gênero, dado sensível. Hoje só a própria pessoa e quem
modera a veem. Qualquer exibição pública futura precisa de decisão própria.
-4. **Rejeição**: a solicitante deve ver o motivo? Hoje, não.
+5. **Rejeição**: a solicitante deve ver o motivo? Hoje, não.
From 6b4ca89849a68aa32c321036610419227275a251 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Tue, 6 Oct 2026 21:48:14 -0300
Subject: [PATCH 05/77] =?UTF-8?q?feat(delas):=20pap=C3=A9is=20de=20moderad?=
=?UTF-8?q?ora=20e=20l=C3=ADder=20com=20gates=20da=20He4rt=20Delas?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
- UserRole ganha DelasModerator e DelasLead, criados por migration no
identity e com states na factory.
- DelasServiceProvider define moderate-delas, lead-delas e
administer-delas (este só para super admin, via Gate::before).
- A seção de papéis do UserForm fica visível só para super admin: fora de
produção o /admin é aberto e qualquer pessoa se daria um papel.
---
.../delas/src/DelasServiceProvider.php | 21 +++++++++++
app-modules/delas/tests/Feature/.gitkeep | 0
.../Feature/Authorization/DelasGatesTest.php | 33 +++++++++++++++++
.../database/factories/UserFactory.php | 18 ++++++++++
.../2026_10_07_004125_create_delas_roles.php | 33 +++++++++++++++++
.../src/Authorization/Enums/UserRole.php | 10 ++++++
.../Resources/Users/Schemas/UserForm.php | 1 +
.../Feature/Identity/UserResourceTest.php | 35 +++++++++++++++++++
8 files changed, 151 insertions(+)
delete mode 100644 app-modules/delas/tests/Feature/.gitkeep
create mode 100644 app-modules/delas/tests/Feature/Authorization/DelasGatesTest.php
create mode 100644 app-modules/identity/database/migrations/2026_10_07_004125_create_delas_roles.php
diff --git a/app-modules/delas/src/DelasServiceProvider.php b/app-modules/delas/src/DelasServiceProvider.php
index 2c8a8bfe4..25c885792 100644
--- a/app-modules/delas/src/DelasServiceProvider.php
+++ b/app-modules/delas/src/DelasServiceProvider.php
@@ -4,6 +4,9 @@
namespace He4rt\Delas;
+use He4rt\Identity\Authorization\Enums\UserRole;
+use He4rt\Identity\User\Models\User;
+use Illuminate\Support\Facades\Gate;
use Illuminate\Support\ServiceProvider;
class DelasServiceProvider extends ServiceProvider
@@ -16,5 +19,23 @@ public function register(): void
public function boot(): void
{
$this->loadTranslationsFrom(__DIR__.'/../lang', 'delas');
+
+ $this->defineGates();
+ }
+
+ /**
+ * Super admins passam em todos pelo `Gate::before` do identity.
+ */
+ private function defineGates(): void
+ {
+ Gate::define('moderate-delas', fn (User $user): bool => $user->hasAnyRole([
+ UserRole::DelasModerator,
+ UserRole::DelasLead,
+ ]));
+
+ Gate::define('lead-delas', fn (User $user): bool => $user->hasRole(UserRole::DelasLead));
+
+ // Ninguém além do super admin, que passa pelo Gate::before.
+ Gate::define('administer-delas', fn (User $user): bool => false);
}
}
diff --git a/app-modules/delas/tests/Feature/.gitkeep b/app-modules/delas/tests/Feature/.gitkeep
deleted file mode 100644
index e69de29bb..000000000
diff --git a/app-modules/delas/tests/Feature/Authorization/DelasGatesTest.php b/app-modules/delas/tests/Feature/Authorization/DelasGatesTest.php
new file mode 100644
index 000000000..ab39239f9
--- /dev/null
+++ b/app-modules/delas/tests/Feature/Authorization/DelasGatesTest.php
@@ -0,0 +1,33 @@
+value, UserRole::GUARD))->toBeInstanceOf(Role::class);
+})->with([UserRole::DelasModerator, UserRole::DelasLead]);
+
+test('cada papel passa só nos gates do seu nível', function (?string $state, bool $moderate, bool $lead, bool $administer): void {
+ $factory = User::factory();
+ $user = ($state === null ? $factory : $factory->{$state}())->create();
+
+ expect($user->can('moderate-delas'))->toBe($moderate)
+ ->and($user->can('lead-delas'))->toBe($lead)
+ ->and($user->can('administer-delas'))->toBe($administer);
+})->with([
+ 'membra comum' => [null, false, false, false],
+ 'moderadora' => ['delasModerator', true, false, false],
+ 'líder' => ['delasLead', true, true, false],
+ 'super admin' => ['superAdmin', true, true, true],
+]);
+
+test('ao perder o papel, a moderadora perde o gate na próxima leitura', function (): void {
+ $user = User::factory()->delasModerator()->create();
+
+ $user->removeRole(UserRole::DelasModerator);
+
+ expect($user->fresh()->can('moderate-delas'))->toBeFalse();
+});
diff --git a/app-modules/identity/database/factories/UserFactory.php b/app-modules/identity/database/factories/UserFactory.php
index f316e3a14..0fd5f6214 100644
--- a/app-modules/identity/database/factories/UserFactory.php
+++ b/app-modules/identity/database/factories/UserFactory.php
@@ -46,4 +46,22 @@ public function streamer(): static
$user->assignRole(UserRole::Streamer);
});
}
+
+ public function delasModerator(): static
+ {
+ return $this->afterCreating(function (User $user): void {
+ Role::findOrCreate(UserRole::DelasModerator->value, UserRole::GUARD);
+
+ $user->assignRole(UserRole::DelasModerator);
+ });
+ }
+
+ public function delasLead(): static
+ {
+ return $this->afterCreating(function (User $user): void {
+ Role::findOrCreate(UserRole::DelasLead->value, UserRole::GUARD);
+
+ $user->assignRole(UserRole::DelasLead);
+ });
+ }
}
diff --git a/app-modules/identity/database/migrations/2026_10_07_004125_create_delas_roles.php b/app-modules/identity/database/migrations/2026_10_07_004125_create_delas_roles.php
new file mode 100644
index 000000000..14243ab4e
--- /dev/null
+++ b/app-modules/identity/database/migrations/2026_10_07_004125_create_delas_roles.php
@@ -0,0 +1,33 @@
+ */
+ private const array ROLES = [UserRole::DelasModerator, UserRole::DelasLead];
+
+ public function up(): void
+ {
+ foreach (self::ROLES as $role) {
+ Role::findOrCreate($role->value, UserRole::GUARD);
+ }
+
+ resolve(PermissionRegistrar::class)->forgetCachedPermissions();
+ }
+
+ public function down(): void
+ {
+ Role::query()
+ ->whereIn('name', array_map(fn (UserRole $role): string => $role->value, self::ROLES))
+ ->where('guard_name', UserRole::GUARD)
+ ->delete();
+
+ resolve(PermissionRegistrar::class)->forgetCachedPermissions();
+ }
+};
diff --git a/app-modules/identity/src/Authorization/Enums/UserRole.php b/app-modules/identity/src/Authorization/Enums/UserRole.php
index 06c22d4b7..e7f548545 100644
--- a/app-modules/identity/src/Authorization/Enums/UserRole.php
+++ b/app-modules/identity/src/Authorization/Enums/UserRole.php
@@ -25,6 +25,8 @@ enum UserRole: string implements HasColor, HasDescription, HasIcon, HasLabel
case SuperAdmin = 'super-admin';
case Streamer = 'streamer';
+ case DelasModerator = 'delas-moderator';
+ case DelasLead = 'delas-lead';
public const string GUARD = 'web';
@@ -33,6 +35,8 @@ public function getLabel(): string
return match ($this) {
self::SuperAdmin => 'Super admin',
self::Streamer => 'Streamer',
+ self::DelasModerator => 'Moderadora He4rt Delas',
+ self::DelasLead => 'Líder He4rt Delas',
};
}
@@ -44,6 +48,8 @@ public function getColor(): array
return match ($this) {
self::SuperAdmin => Color::Red,
self::Streamer => Color::Purple,
+ self::DelasModerator => Color::Pink,
+ self::DelasLead => Color::Rose,
};
}
@@ -52,6 +58,8 @@ public function getDescription(): string
return match ($this) {
self::SuperAdmin => 'Acesso total ao painel admin. Passa por cima de qualquer verificação de permissão.',
self::Streamer => 'Conecta a Twitch com permissões de broadcaster para usar as ferramentas de live.',
+ self::DelasModerator => 'Aprova, rejeita e bloqueia solicitações da tag He4rt Delas no Hub.',
+ self::DelasLead => 'Tudo da moderadora, mais gerenciar moderadoras e conceder ou remover a tag He4rt Delas.',
};
}
@@ -60,6 +68,8 @@ public function getIcon(): Heroicon
return match ($this) {
self::SuperAdmin => Heroicon::OutlinedShieldCheck,
self::Streamer => Heroicon::OutlinedVideoCamera,
+ self::DelasModerator => Heroicon::OutlinedHeart,
+ self::DelasLead => Heroicon::OutlinedSparkles,
};
}
}
diff --git a/app-modules/panel-admin/src/Filament/Resources/Users/Schemas/UserForm.php b/app-modules/panel-admin/src/Filament/Resources/Users/Schemas/UserForm.php
index ffacc2c9f..8899b62de 100644
--- a/app-modules/panel-admin/src/Filament/Resources/Users/Schemas/UserForm.php
+++ b/app-modules/panel-admin/src/Filament/Resources/Users/Schemas/UserForm.php
@@ -55,6 +55,7 @@ public static function configure(Schema $schema): Schema
Section::make('Papéis')
->columnSpanFull()
->columns(1)
+ ->visible(fn (): bool => auth()->user()?->isSuperAdmin() ?? false)
->description('Quem tem super admin passa por cima de qualquer verificação de permissão.')
->schema([
CheckboxList::make('roles')
diff --git a/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php b/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php
index 5e9570718..04befda9f 100644
--- a/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php
+++ b/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php
@@ -294,3 +294,38 @@
->assertCanSeeTableRecords([$this->admin])
->assertCanNotSeeTableRecords([$regular]);
});
+
+test('quem não é super admin não vê os papéis no form', function (): void {
+ $this->actingAs(User::factory()->delasLead()->create());
+ $other = User::factory()->create();
+
+ livewire(EditUser::class, ['record' => $other->getKey()])
+ ->assertFormFieldHidden('roles');
+});
+
+test('quem não é super admin não concede papéis nem forçando o estado do form', function (): void {
+ $this->actingAs(User::factory()->delasLead()->create());
+ $other = User::factory()->create();
+ $role = Role::findByName(UserRole::DelasModerator->value, UserRole::GUARD);
+
+ livewire(EditUser::class, ['record' => $other->getKey()])
+ ->set('data.roles', [$role->getKey()])
+ ->call('save');
+
+ expect($other->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse();
+});
+
+test('salvar o form concede os papéis da He4rt Delas a outro usuário', function (): void {
+ $other = User::factory()->create();
+ $roleIds = Role::query()
+ ->whereIn('name', [UserRole::DelasModerator->value, UserRole::DelasLead->value])
+ ->pluck('id')
+ ->all();
+
+ livewire(EditUser::class, ['record' => $other->getKey()])
+ ->fillForm(['roles' => $roleIds])
+ ->call('save')
+ ->assertHasNoFormErrors();
+
+ expect($other->fresh()->hasAllRoles([UserRole::DelasModerator, UserRole::DelasLead]))->toBeTrue();
+});
From 07de5c2e9381daf5b04db6ccfd39dbb8908b76bb Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Tue, 6 Oct 2026 21:54:46 -0300
Subject: [PATCH 06/77] =?UTF-8?q?docs(delas):=20rosa=20da=20He4rt=20Delas?=
=?UTF-8?q?=20s=C3=B3=20nos=20pontos=20de=20marca?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
As telas seguem o visual normal do Hub e as cores semânticas do Filament;
o rosa fica na tag, na logo, no ícone do menu e no botão do pedido.
---
docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md | 9 +++++++--
1 file changed, 7 insertions(+), 2 deletions(-)
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index 6fd09b1d1..3d9f42c9a 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -328,9 +328,14 @@ entrada na navegação padrão.
### Identidade visual
+- As telas da He4rt Delas usam o visual normal do Hub e do Filament: superfícies neutras, tokens
+ da He4rt e as cores semânticas padrão (aprovar e aprovada em verde, rejeitar, remover e bloquear
+ em vermelho, pendente em âmbar, encerrado em cinza).
+- O rosa da He4rt Delas aparece **só nos pontos de marca**: a tag, a logo, o ícone do item no
+ menu e o botão principal do pedido ("Enviar solicitação" e o toggle do perfil). Sem degradês e
+ sem fundos rosados.
- Paleta He4rt Delas (primária `#F485A2`; 50 `#FFD1EE` → 900 `#730835`) como tokens do design
- system em `app-modules/he4rt/resources/css/support/themes.css` e `index.css`, usada só nos
- elementos da He4rt Delas. O resto do Hub mantém os tokens da He4rt.
+ system em `app-modules/he4rt/resources/css/support/themes.css` e `index.css`.
- A tag usa o rosa claro com texto e ícone no tom 900. Texto branco só do tom 600 para cima
(WCAG AA).
- Logos oficiais (ícone, vertical e horizontal) como SVG `currentColor` nos assets do design
From 0f5efd6c14dddd0fbdb90dda58c22aeb48bf23c5 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Tue, 6 Oct 2026 22:04:15 -0300
Subject: [PATCH 07/77] refactor(delas): tudo da He4rt Delas no Hub, sem
cluster no admin
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Moderadoras, líderes e super admins usam a mesma página do Hub, que mostra
mais partes conforme o papel. No /admin fica só a atribuição dos papéis
pelo formulário de usuário. Remove o gate administer-delas, que ficou sem
uso, e atualiza a spec e a ADR-0001.
---
...01-modulo-proprio-com-papel-e-historico.md | 17 ++--
.../delas/src/DelasServiceProvider.php | 3 -
.../Feature/Authorization/DelasGatesTest.php | 13 ++-
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 79 ++++++++-----------
4 files changed, 48 insertions(+), 64 deletions(-)
diff --git a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
index af4f9e73f..900a57f8f 100644
--- a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
+++ b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
@@ -38,9 +38,8 @@ precisa morar em algum lugar e ter uma forma de autorizar quem decide.
migration, como a role `streamer`. A líder gerencia moderadoras, concede e remove a tag e vê o
histórico completo, tudo no Hub. _Vai além da #570_ ("atribuível apenas por admins do Hub"):
dá autonomia à He4rt Delas sem abrir o `/admin`.
-- **Gates nomeados no `DelasServiceProvider`**: `moderate-delas` (moderadora ou líder),
- `lead-delas` (líder) e `administer-delas` (sempre `false`; só `super-admin` passa, pelo
- `Gate::before` do identity).
+- **Gates nomeados no `DelasServiceProvider`**: `moderate-delas` (moderadora ou líder) e
+ `lead-delas` (líder). Super admins passam nos dois pelo `Gate::before` do identity.
O código checa o gate, nunca o nome da role.
- _Diverge do `use-streamer-tools`, que fica no `IdentityServiceProvider`._ Aqui o gate é
vocabulário do delas, e o identity não deve conhecer regras de outro módulo.
@@ -51,12 +50,12 @@ precisa morar em algum lugar e ter uma forma de autorizar quem decide.
quem bloqueou ou por super admin.
- **Histórico append-only** em `delas_transitions`, gravado pelas actions, sem trigger (ADR-0003
do `events`).
-- **Dois espaços de interface.** Moderadoras decidem numa página do Hub (`/app`), como a #570
- pede, porque não têm acesso ao `/admin`. Super admins têm um **cluster He4rt Delas** no
- `/admin` (dashboard, solicitações, bloqueios, histórico e moderadoras), no formato do cluster de
- Moderação. A tabela de Usuários só exibe as roles.
- - _Alternativa descartada:_ abrir o `/admin` para moderadoras, limitado ao cluster. Contradiz a
- ADR-0002 do `identity` ("o painel inteiro é super admin ou nada").
+- **Tudo no Hub.** Moderadoras, líderes e super admins usam a mesma página He4rt Delas no `/app`,
+ que mostra mais partes conforme o papel. No `/admin` fica só a atribuição dos papéis, pela
+ seção Papéis do formulário de usuário que já existe.
+ - _Alternativas descartadas:_ um cluster He4rt Delas no `/admin` (dois lugares para manter, e
+ líderes não entram no `/admin`) e abrir o `/admin` para moderadoras (contradiz a ADR-0002
+ do `identity`: "o painel inteiro é super admin ou nada").
## Consequências
diff --git a/app-modules/delas/src/DelasServiceProvider.php b/app-modules/delas/src/DelasServiceProvider.php
index 25c885792..f297ab25a 100644
--- a/app-modules/delas/src/DelasServiceProvider.php
+++ b/app-modules/delas/src/DelasServiceProvider.php
@@ -34,8 +34,5 @@ private function defineGates(): void
]));
Gate::define('lead-delas', fn (User $user): bool => $user->hasRole(UserRole::DelasLead));
-
- // Ninguém além do super admin, que passa pelo Gate::before.
- Gate::define('administer-delas', fn (User $user): bool => false);
}
}
diff --git a/app-modules/delas/tests/Feature/Authorization/DelasGatesTest.php b/app-modules/delas/tests/Feature/Authorization/DelasGatesTest.php
index ab39239f9..852ebdc68 100644
--- a/app-modules/delas/tests/Feature/Authorization/DelasGatesTest.php
+++ b/app-modules/delas/tests/Feature/Authorization/DelasGatesTest.php
@@ -10,18 +10,17 @@
expect(Role::findByName($role->value, UserRole::GUARD))->toBeInstanceOf(Role::class);
})->with([UserRole::DelasModerator, UserRole::DelasLead]);
-test('cada papel passa só nos gates do seu nível', function (?string $state, bool $moderate, bool $lead, bool $administer): void {
+test('cada papel passa só nos gates do seu nível', function (?string $state, bool $moderate, bool $lead): void {
$factory = User::factory();
$user = ($state === null ? $factory : $factory->{$state}())->create();
expect($user->can('moderate-delas'))->toBe($moderate)
- ->and($user->can('lead-delas'))->toBe($lead)
- ->and($user->can('administer-delas'))->toBe($administer);
+ ->and($user->can('lead-delas'))->toBe($lead);
})->with([
- 'membra comum' => [null, false, false, false],
- 'moderadora' => ['delasModerator', true, false, false],
- 'líder' => ['delasLead', true, true, false],
- 'super admin' => ['superAdmin', true, true, true],
+ 'membra comum' => [null, false, false],
+ 'moderadora' => ['delasModerator', true, false],
+ 'líder' => ['delasLead', true, true],
+ 'super admin' => ['superAdmin', true, true],
]);
test('ao perder o papel, a moderadora perde o gate na próxima leitura', function (): void {
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index 3d9f42c9a..384cf7f85 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -87,37 +87,33 @@ Fatos do código atual que moldam o desenho:
### Liderança (líderes da He4rt Delas)
-Papel `delas-lead`, atribuído só por super admins. A líder trabalha **na mesma página do Hub**,
-sem acesso ao `/admin`, e tem tudo o que a moderadora tem, mais:
+Papel `delas-lead`, atribuído só por super admins, no `/admin`. A líder trabalha **na mesma
+página do Hub**, sem acesso ao `/admin`, e tem tudo o que a moderadora tem, mais:
- números da He4rt Delas no topo da página;
- histórico completo;
- aba Moderadoras: adiciona e revoga `delas-moderator`. Não cria nem revoga líderes, e não age
sobre super admins;
- desbloqueia qualquer bloqueio;
-- concede e remove a tag direto, com as mesmas regras da administração abaixo.
+- concede e remove a tag direto:
+ - se houver solicitação `pending`, ela é aprovada (`pending → approved`);
+ - se não houver, é criada uma solicitação já `approved`;
+ - se a pessoa já tem a tag, a ação é recusada com exceção de domínio;
+ - se a pessoa estiver bloqueada, a interface mostra quem bloqueou, quando e o motivo, e exige
+ um motivo. O bloqueio é encerrado na mesma transação;
+ - remover (`approved → revoked`) exige motivo. O registro não é apagado, e a pessoa pode
+ solicitar de novo após a espera, salvo se também for bloqueada.
> _Vai além da #570_, que diz que a permissão é "atribuível apenas por admins do Hub". Precisa do
> ok da Sther e de um comentário na issue.
### Administração (super admins)
-Tudo acontece no cluster He4rt Delas do `/admin` (ver [Interface](#interface)). Super admins
-passam em todos os gates (via `Gate::before`) e podem fazer tudo o que líderes e moderadoras
-fazem.
-
-- Atribuem e retiram `delas-lead` e `delas-moderator` na página Moderadoras e líderes do
- cluster. O `UserForm` continua listando as roles, como faz com todas. O acesso some na próxima
- requisição, porque `hasRole` lê `model_has_roles` a cada request.
-- Concedem a tag diretamente:
- - se houver solicitação `pending`, ela é aprovada (`pending → approved`, `triggered_by=admin`);
- - se não houver, é criada uma solicitação já `approved`;
- - se a pessoa já tem a tag, a ação é recusada com exceção de domínio;
- - se a pessoa estiver bloqueada, a interface mostra quem bloqueou, quando e o motivo, e exige
- um motivo da admin. O bloqueio é encerrado na mesma transação.
-- Removem a tag (`approved → revoked`), com motivo obrigatório. O registro não é apagado. A
- pessoa pode solicitar de novo após a espera, salvo se também for bloqueada.
-- Veem todos os bloqueios e desfazem qualquer um.
+- No `/admin`, a única coisa da He4rt Delas é atribuir e retirar `delas-lead` e `delas-moderator`,
+ pela seção Papéis do formulário de usuário (`UserForm`), que já existe. O acesso some na
+ próxima requisição, porque `hasRole` lê `model_has_roles` a cada request.
+- No Hub, passam em todos os gates (via `Gate::before`) e veem a página He4rt Delas como uma
+ líder.
### Espera de 15 dias
@@ -170,14 +166,11 @@ O case precisa morar em `UserRole` porque enums não são extensíveis por outro
| ----------------------------------------------------------------------------------------------------- | :---------------: | :----------: | :-----------: |
| `moderate-delas` (ver fila, aprovar, rejeitar, bloquear, desbloquear os próprios) | ✓ | ✓ | ✓ |
| `lead-delas` (números, histórico completo, moderadoras, desbloquear qualquer, conceder/remover a tag) | | ✓ | ✓ |
-| `administer-delas` (cluster do `/admin`, atribuir e revogar líderes) | | | ✓ |
- Os gates são definidos no `DelasServiceProvider`, porque são vocabulário do delas. Isso diverge
do `use-streamer-tools`, que fica no identity; a ADR do módulo registra a escolha.
- `moderate-delas`: `$user->hasAnyRole([UserRole::DelasModerator, UserRole::DelasLead])`.
- `lead-delas`: `$user->hasRole(UserRole::DelasLead)`.
-- `administer-delas`: `fn (): bool => false`, com comentário apontando que só `super-admin`
- passa, via `Gate::before`.
- Não há classes Policy. As actions de domínio recebem o ator no DTO, checam
`Gate::forUser($actor)->authorize(...)` e aplicam as regras de negócio com exceções de domínio
(`DelasException::cannotBlockModerator()` etc.), como fazem as actions do `events`.
@@ -280,7 +273,6 @@ a linha de histórico.
| `GrantDelasTag` | `lead-delas` | aprova a pendente ou cria `approved`; encerra bloqueio |
| `RevokeDelasTag` | `lead-delas` | `approved → revoked`, com motivo |
| `AddDelasModerator` / `RemoveDelasModerator` | `lead-delas` | atribui ou retira `delas-moderator`; recusa líderes e super admins como alvo |
-| `AddDelasLead` / `RemoveDelasLead` | `administer-delas` | atribui ou retira `delas-lead` |
A consulta `DelasEligibility` responde para o perfil: pode solicitar, por que não, e
`next_allowed_at`.
@@ -302,29 +294,27 @@ dispara também `DelasRequesterUnblocked`. Nenhum listener nesta entrega.
Textos em `panel-app/lang/{en,pt_BR}/profile.php`.
- Página He4rt Delas (nova), registrada em `AppPanelProvider->pages([...])`, com
`canAccess(): auth()->user()?->can('moderate-delas') ?? false`, como as páginas de streaming.
- Abas "Pendentes" (aprovar, rejeitar, bloquear) e "Bloqueios" (desbloquear). Base visual:
- `panel-admin/src/Moderation/Livewire/AppealQueue.php`.
+ O conteúdo depende do papel:
+
+ | Parte da página | Moderadora | Líder e super admin |
+ | -------------------------------------------------------------------------------------------------------------------------- | :---------: | :------------------: |
+ | Pendentes: aprovar, rejeitar, bloquear | ✓ | ✓ |
+ | Bloqueios: desbloquear | os próprios | todos |
+ | Histórico | decisões | completo, com filtro |
+ | Números no topo (pendentes, membras com a tag, tempo médio até a decisão, aprovadas e rejeitadas no mês, bloqueios ativos) | | ✓ |
+ | Moderadoras: adicionar e revogar `delas-moderator` | | ✓ |
+ | Conceder e remover a tag direto | | ✓ |
+
+ Base visual: `panel-admin/src/Moderation/Livewire/AppealQueue.php`.
**Admin (`/admin`, `panel-admin`)**
-Cluster **He4rt Delas** em `panel-admin/src/Delas/`, no mesmo formato do cluster de Moderação
-(`ModerationDashboard`, fila, appeals, `AuditLogPage`): slug `delas`, sidebar própria em
-`PanelAdminServiceProvider::buildNavigation` (match em `delas/`, com link de volta ao admin) e
-entrada na navegação padrão.
-
-| Página | Conteúdo |
-| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Dashboard | Cartões: pendentes agora, membras com a tag, tempo médio até a decisão, aprovadas e rejeitadas no mês, bloqueios ativos. Lista das últimas decisões. Gráficos ficam para depois |
-| Solicitações | Todas, com filtro por status. Aprovar e rejeitar as pendentes, conceder e remover a tag (`GrantDelasTagAction`, `RevokeDelasTagAction`) |
-| Bloqueios | Todos (ativos e encerrados), com desbloqueio |
-| Histórico | `delas_transitions`: data, ação, pessoa afetada, quem fez e motivo |
-| Moderadoras e líderes | Quem tem `delas-moderator` ou `delas-lead`, com adicionar e revogar os dois papéis |
-
-- Todas as páginas do cluster exigem `administer-delas` no `canAccess()`. Fora de produção o
- `/admin` é aberto a qualquer pessoa autenticada, então o painel sozinho não protege.
-- A tabela de Usuários só **mostra** as roles (badges "Super admin", "Moderadora He4rt Delas"),
- sem ações da He4rt Delas.
-- Visibilidade do `CheckboxList` de roles no `UserForm` restrita a super admins.
+Sem cluster nem página da He4rt Delas. Só:
+
+- a seção Papéis do `UserForm`, onde super admins atribuem `delas-lead` e `delas-moderator`,
+ visível só para super admins (fora de produção o `/admin` é aberto a qualquer pessoa
+ autenticada);
+- a tabela de Usuários, que só **mostra** as roles (badges), sem coluna da tag nem ações.
### Identidade visual
@@ -370,8 +360,7 @@ unitários em `delas/tests/Unit`.
bloqueada (encerra o bloqueio); remove a tag.
- Papel: perde acesso ao retirar `delas-moderator`; o campo de roles não aparece para quem não é
super admin.
-- Páginas: seção He4rt Delas do Hub invisível e inacessível sem `moderate-delas`; páginas do
- cluster do `/admin` inacessíveis sem `administer-delas`, inclusive para moderadoras e líderes.
+- Páginas: seção He4rt Delas do Hub invisível e inacessível sem `moderate-delas`.
- Arch (opcional): `He4rt\Delas` não importa `He4rt\Panel*`.
Validação: `make check`, `make test` e `make test-shards`.
From 80a534b4655bcbceddef88e481716a96732ef3cb Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Tue, 6 Oct 2026 22:14:49 -0300
Subject: [PATCH 08/77] =?UTF-8?q?feat(delas):=20l=C3=ADder=20e=20moderador?=
=?UTF-8?q?a=20exclusivas=20e=20com=20as=20cores=20da=20He4rt=20Delas?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
No formulário de usuário, marcar líder desmarca moderadora e vice-versa;
ao salvar com as duas, fica a líder. Os selos usam a paleta da He4rt
Delas: líder no rosa mais forte (#CF6481), moderadora no rosa claro
(#F485A2).
---
.../src/Authorization/Enums/UserRole.php | 4 +-
.../Resources/Users/Schemas/UserForm.php | 45 ++++++++++++++++++-
.../Feature/Identity/UserResourceTest.php | 40 +++++++++++++++--
3 files changed, 83 insertions(+), 6 deletions(-)
diff --git a/app-modules/identity/src/Authorization/Enums/UserRole.php b/app-modules/identity/src/Authorization/Enums/UserRole.php
index e7f548545..c4c17d7dc 100644
--- a/app-modules/identity/src/Authorization/Enums/UserRole.php
+++ b/app-modules/identity/src/Authorization/Enums/UserRole.php
@@ -48,8 +48,8 @@ public function getColor(): array
return match ($this) {
self::SuperAdmin => Color::Red,
self::Streamer => Color::Purple,
- self::DelasModerator => Color::Pink,
- self::DelasLead => Color::Rose,
+ self::DelasModerator => Color::hex('#F485A2'),
+ self::DelasLead => Color::hex('#CF6481'),
};
}
diff --git a/app-modules/panel-admin/src/Filament/Resources/Users/Schemas/UserForm.php b/app-modules/panel-admin/src/Filament/Resources/Users/Schemas/UserForm.php
index 8899b62de..a7c6fb05d 100644
--- a/app-modules/panel-admin/src/Filament/Resources/Users/Schemas/UserForm.php
+++ b/app-modules/panel-admin/src/Filament/Resources/Users/Schemas/UserForm.php
@@ -8,6 +8,7 @@
use Filament\Forms\Components\TextInput;
use Filament\Forms\Components\Toggle;
use Filament\Schemas\Components\Section;
+use Filament\Schemas\Components\Utilities\Set;
use Filament\Schemas\Schema;
use He4rt\Identity\Authorization\Enums\UserRole;
use He4rt\Identity\User\Models\User;
@@ -65,12 +66,14 @@ public static function configure(Schema $schema): Schema
->descriptions(self::roleDescriptions(...))
->disableOptionWhen(self::isOwnSuperAdminOption(...))
->in(fn (CheckboxList $component): array => array_keys($component->getOptions()))
+ ->live()
+ ->afterStateUpdated(fn (mixed $state, mixed $old, Set $set) => $set('roles', self::keepOneDelasRole($state, $old)))
->saveRelationshipsUsing(function (CheckboxList $component, ?User $record): void {
if ($record instanceof User && self::isEditingSelf($record)) {
$component->state(self::keepOwnSuperAdmin($component->getState(), $record));
}
- $roleIds = array_map(intval(...), $component->getState() ?? []);
+ $roleIds = array_map(intval(...), self::keepOneDelasRole($component->getState(), old: null));
DB::transaction(fn (): ?User => $record?->syncRoles($roleIds));
})
@@ -132,4 +135,44 @@ private static function roleDescriptions(): array
->mapWithKeys(fn (Role $role): array => [(int) $role->getKey() => UserRole::from($role->name)->getDescription()])
->all();
}
+
+ /**
+ * Líder e moderadora da He4rt Delas são exclusivas: a líder já faz tudo o
+ * que a moderadora faz. Fica o papel marcado por último; sem essa
+ * informação, fica a líder.
+ *
+ * @return array
+ */
+ private static function keepOneDelasRole(mixed $state, mixed $old): array
+ {
+ /** @var array $submittedKeys */
+ $submittedKeys = is_array($state) ? $state : [];
+ $keys = array_values(array_unique(array_map(strval(...), $submittedKeys)));
+
+ $leadKey = self::roleKey(UserRole::DelasLead);
+ $moderatorKey = self::roleKey(UserRole::DelasModerator);
+
+ if (!in_array($leadKey, $keys, strict: true) || !in_array($moderatorKey, $keys, strict: true)) {
+ return $keys;
+ }
+
+ /** @var array $previousKeys */
+ $previousKeys = is_array($old) ? $old : [];
+ $previous = array_map(strval(...), $previousKeys);
+ $moderatorJustChecked = in_array($leadKey, $previous, strict: true) && !in_array($moderatorKey, $previous, strict: true);
+
+ $discarded = $moderatorJustChecked ? $leadKey : $moderatorKey;
+
+ return array_values(array_filter($keys, fn (string $key): bool => $key !== $discarded));
+ }
+
+ private static function roleKey(UserRole $role): ?string
+ {
+ $key = Role::query()
+ ->where('name', $role->value)
+ ->where('guard_name', UserRole::GUARD)
+ ->value('id');
+
+ return $key === null ? null : (string) $key;
+ }
}
diff --git a/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php b/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php
index 04befda9f..332da6559 100644
--- a/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php
+++ b/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php
@@ -315,7 +315,40 @@
expect($other->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse();
});
-test('salvar o form concede os papéis da He4rt Delas a outro usuário', function (): void {
+test('salvar o form concede um papel da He4rt Delas a outro usuário', function (UserRole $role): void {
+ $other = User::factory()->create();
+
+ livewire(EditUser::class, ['record' => $other->getKey()])
+ ->fillForm(['roles' => [Role::findByName($role->value, UserRole::GUARD)->getKey()]])
+ ->call('save')
+ ->assertHasNoFormErrors();
+
+ expect($other->fresh()->hasRole($role))->toBeTrue();
+})->with([UserRole::DelasModerator, UserRole::DelasLead]);
+
+test('marcar moderadora desmarca líder da He4rt Delas', function (): void {
+ $other = User::factory()->create();
+ $lead = (string) Role::findByName(UserRole::DelasLead->value, UserRole::GUARD)->getKey();
+ $moderator = (string) Role::findByName(UserRole::DelasModerator->value, UserRole::GUARD)->getKey();
+
+ livewire(EditUser::class, ['record' => $other->getKey()])
+ ->fillForm(['roles' => [$lead]])
+ ->fillForm(['roles' => [$lead, $moderator]])
+ ->assertSchemaStateSet(['roles' => [$moderator]]);
+});
+
+test('marcar líder desmarca moderadora da He4rt Delas', function (): void {
+ $other = User::factory()->create();
+ $lead = (string) Role::findByName(UserRole::DelasLead->value, UserRole::GUARD)->getKey();
+ $moderator = (string) Role::findByName(UserRole::DelasModerator->value, UserRole::GUARD)->getKey();
+
+ livewire(EditUser::class, ['record' => $other->getKey()])
+ ->fillForm(['roles' => [$moderator]])
+ ->fillForm(['roles' => [$moderator, $lead]])
+ ->assertSchemaStateSet(['roles' => [$lead]]);
+});
+
+test('salvar com líder e moderadora mantém só a líder', function (): void {
$other = User::factory()->create();
$roleIds = Role::query()
->whereIn('name', [UserRole::DelasModerator->value, UserRole::DelasLead->value])
@@ -323,9 +356,10 @@
->all();
livewire(EditUser::class, ['record' => $other->getKey()])
- ->fillForm(['roles' => $roleIds])
+ ->set('data.roles', $roleIds)
->call('save')
->assertHasNoFormErrors();
- expect($other->fresh()->hasAllRoles([UserRole::DelasModerator, UserRole::DelasLead]))->toBeTrue();
+ expect($other->fresh()->hasRole(UserRole::DelasLead))->toBeTrue()
+ ->and($other->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse();
});
From 5199a7d26eac25798fc013470e1205a3f8208899 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Tue, 6 Oct 2026 22:25:24 -0300
Subject: [PATCH 09/77] =?UTF-8?q?feat(delas):=20modelagem=20de=20solicita?=
=?UTF-8?q?=C3=A7=C3=B5es,=20bloqueios=20e=20hist=C3=B3rico?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
- Enums DelasRequestStatus (máquina de estados), DelasAction (cada ação
com a sua cor) e DelasTriggeredBy, com rótulos em pt_BR e en.
- Tabelas delas_tag_requests, delas_requester_blocks e delas_transitions,
com índices únicos parciais: uma solicitação ativa e um bloqueio ativo
por pessoa.
- Models e factories com states; testes do enum e das garantias do banco.
---
app-modules/delas/database/factories/.gitkeep | 0
.../factories/DelasRequesterBlockFactory.php | 38 ++++++
.../factories/DelasTagRequestFactory.php | 59 ++++++++++
.../factories/DelasTransitionFactory.php | 34 ++++++
.../delas/database/migrations/.gitkeep | 0
...012009_create_delas_tag_requests_table.php | 40 +++++++
...12_create_delas_requester_blocks_table.php | 36 ++++++
..._012015_create_delas_transitions_table.php | 39 +++++++
app-modules/delas/lang/en/enums.php | 42 +++++++
app-modules/delas/lang/pt_BR/enums.php | 42 +++++++
.../src/Block/Models/DelasRequesterBlock.php | 95 +++++++++++++++
.../delas/src/History/Enums/DelasAction.php | 85 ++++++++++++++
.../src/History/Enums/DelasTriggeredBy.php | 72 ++++++++++++
.../src/History/Models/DelasTransition.php | 95 +++++++++++++++
.../TagRequest/Enums/DelasRequestStatus.php | 109 ++++++++++++++++++
.../src/TagRequest/Models/DelasTagRequest.php | 101 ++++++++++++++++
.../tests/Feature/Schema/DelasSchemaTest.php | 58 ++++++++++
app-modules/delas/tests/Unit/.gitkeep | 0
.../tests/Unit/DelasRequestStatusTest.php | 33 ++++++
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 30 ++---
20 files changed, 993 insertions(+), 15 deletions(-)
delete mode 100644 app-modules/delas/database/factories/.gitkeep
create mode 100644 app-modules/delas/database/factories/DelasRequesterBlockFactory.php
create mode 100644 app-modules/delas/database/factories/DelasTagRequestFactory.php
create mode 100644 app-modules/delas/database/factories/DelasTransitionFactory.php
delete mode 100644 app-modules/delas/database/migrations/.gitkeep
create mode 100644 app-modules/delas/database/migrations/2026_10_07_012009_create_delas_tag_requests_table.php
create mode 100644 app-modules/delas/database/migrations/2026_10_07_012012_create_delas_requester_blocks_table.php
create mode 100644 app-modules/delas/database/migrations/2026_10_07_012015_create_delas_transitions_table.php
create mode 100644 app-modules/delas/lang/en/enums.php
create mode 100644 app-modules/delas/lang/pt_BR/enums.php
create mode 100644 app-modules/delas/src/Block/Models/DelasRequesterBlock.php
create mode 100644 app-modules/delas/src/History/Enums/DelasAction.php
create mode 100644 app-modules/delas/src/History/Enums/DelasTriggeredBy.php
create mode 100644 app-modules/delas/src/History/Models/DelasTransition.php
create mode 100644 app-modules/delas/src/TagRequest/Enums/DelasRequestStatus.php
create mode 100644 app-modules/delas/src/TagRequest/Models/DelasTagRequest.php
create mode 100644 app-modules/delas/tests/Feature/Schema/DelasSchemaTest.php
delete mode 100644 app-modules/delas/tests/Unit/.gitkeep
create mode 100644 app-modules/delas/tests/Unit/DelasRequestStatusTest.php
diff --git a/app-modules/delas/database/factories/.gitkeep b/app-modules/delas/database/factories/.gitkeep
deleted file mode 100644
index e69de29bb..000000000
diff --git a/app-modules/delas/database/factories/DelasRequesterBlockFactory.php b/app-modules/delas/database/factories/DelasRequesterBlockFactory.php
new file mode 100644
index 000000000..0e2e33498
--- /dev/null
+++ b/app-modules/delas/database/factories/DelasRequesterBlockFactory.php
@@ -0,0 +1,38 @@
+ */
+final class DelasRequesterBlockFactory extends Factory
+{
+ protected $model = DelasRequesterBlock::class;
+
+ /** @return array */
+ public function definition(): array
+ {
+ return [
+ 'user_id' => User::factory(),
+ 'blocked_by' => User::factory(),
+ 'reason' => 'Pedidos repetidos com intenção de tumultuar a fila.',
+ 'blocked_at' => now(),
+ 'lifted_by' => null,
+ 'lifted_at' => null,
+ 'lift_reason' => null,
+ ];
+ }
+
+ public function lifted(string $reason = 'Situação esclarecida com o comitê.'): static
+ {
+ return $this->state(fn (): array => [
+ 'lifted_by' => User::factory(),
+ 'lifted_at' => now(),
+ 'lift_reason' => $reason,
+ ]);
+ }
+}
diff --git a/app-modules/delas/database/factories/DelasTagRequestFactory.php b/app-modules/delas/database/factories/DelasTagRequestFactory.php
new file mode 100644
index 000000000..4dc8ab78f
--- /dev/null
+++ b/app-modules/delas/database/factories/DelasTagRequestFactory.php
@@ -0,0 +1,59 @@
+ */
+final class DelasTagRequestFactory extends Factory
+{
+ protected $model = DelasTagRequest::class;
+
+ /** @return array */
+ public function definition(): array
+ {
+ return [
+ 'user_id' => User::factory(),
+ 'status' => DelasRequestStatus::Pending,
+ 'requested_at' => now(),
+ 'decided_by' => null,
+ 'decided_at' => null,
+ 'decision_reason' => null,
+ ];
+ }
+
+ public function pending(): static
+ {
+ return $this->state(['status' => DelasRequestStatus::Pending]);
+ }
+
+ public function approved(): static
+ {
+ return $this->decided(DelasRequestStatus::Approved);
+ }
+
+ public function rejected(?string $reason = 'Perfil sem informações suficientes.'): static
+ {
+ return $this->decided(DelasRequestStatus::Rejected, $reason);
+ }
+
+ public function revoked(?string $reason = 'A própria pessoa pediu a remoção.'): static
+ {
+ return $this->decided(DelasRequestStatus::Revoked, $reason);
+ }
+
+ private function decided(DelasRequestStatus $status, ?string $reason = null): static
+ {
+ return $this->state(fn (): array => [
+ 'status' => $status,
+ 'decided_by' => User::factory(),
+ 'decided_at' => now(),
+ 'decision_reason' => $reason,
+ ]);
+ }
+}
diff --git a/app-modules/delas/database/factories/DelasTransitionFactory.php b/app-modules/delas/database/factories/DelasTransitionFactory.php
new file mode 100644
index 000000000..289fb773c
--- /dev/null
+++ b/app-modules/delas/database/factories/DelasTransitionFactory.php
@@ -0,0 +1,34 @@
+ */
+final class DelasTransitionFactory extends Factory
+{
+ protected $model = DelasTransition::class;
+
+ /** @return array */
+ public function definition(): array
+ {
+ return [
+ 'user_id' => User::factory(),
+ 'request_id' => null,
+ 'block_id' => null,
+ 'action' => DelasAction::Requested,
+ 'from_status' => null,
+ 'to_status' => DelasRequestStatus::Pending,
+ 'actor_id' => null,
+ 'triggered_by' => DelasTriggeredBy::User,
+ 'reason' => null,
+ ];
+ }
+}
diff --git a/app-modules/delas/database/migrations/.gitkeep b/app-modules/delas/database/migrations/.gitkeep
deleted file mode 100644
index e69de29bb..000000000
diff --git a/app-modules/delas/database/migrations/2026_10_07_012009_create_delas_tag_requests_table.php b/app-modules/delas/database/migrations/2026_10_07_012009_create_delas_tag_requests_table.php
new file mode 100644
index 000000000..3b945c117
--- /dev/null
+++ b/app-modules/delas/database/migrations/2026_10_07_012009_create_delas_tag_requests_table.php
@@ -0,0 +1,40 @@
+uuid('id')->primary();
+ $table->foreignUuid('user_id')->constrained('users')->cascadeOnDelete();
+ $table->string('status', 20)->comment(DelasRequestStatus::stringifyCases());
+ $table->timestampTz('requested_at');
+ $table->foreignUuid('decided_by')->nullable()->constrained('users')->nullOnDelete();
+ $table->timestampTz('decided_at')->nullable();
+ $table->string('decision_reason', 500)->nullable()->comment('Uso interno: a solicitante não vê.');
+ $table->timestampsTz();
+
+ $table->index(['status', 'requested_at'], 'idx_delas_tag_requests_queue');
+ $table->index(['user_id', 'decided_at'], 'idx_delas_tag_requests_user_decided');
+ });
+
+ // No máximo uma solicitação ativa (pendente ou aprovada) por pessoa.
+ DB::statement(sprintf(
+ "CREATE UNIQUE INDEX uq_delas_tag_requests_active_user ON delas_tag_requests (user_id) WHERE status IN ('%s')",
+ implode("', '", DelasRequestStatus::activeValues()),
+ ));
+ }
+
+ public function down(): void
+ {
+ Schema::dropIfExists('delas_tag_requests');
+ }
+};
diff --git a/app-modules/delas/database/migrations/2026_10_07_012012_create_delas_requester_blocks_table.php b/app-modules/delas/database/migrations/2026_10_07_012012_create_delas_requester_blocks_table.php
new file mode 100644
index 000000000..425d99ecd
--- /dev/null
+++ b/app-modules/delas/database/migrations/2026_10_07_012012_create_delas_requester_blocks_table.php
@@ -0,0 +1,36 @@
+uuid('id')->primary();
+ $table->foreignUuid('user_id')->constrained('users')->cascadeOnDelete();
+ $table->foreignUuid('blocked_by')->nullable()->constrained('users')->nullOnDelete();
+ $table->string('reason', 500)->comment('Uso interno: a pessoa bloqueada não vê.');
+ $table->timestampTz('blocked_at');
+ $table->foreignUuid('lifted_by')->nullable()->constrained('users')->nullOnDelete();
+ $table->timestampTz('lifted_at')->nullable();
+ $table->string('lift_reason', 500)->nullable()->comment('Obrigatório ao desbloquear; nulo enquanto o bloqueio está ativo.');
+ $table->timestampsTz();
+
+ $table->index(['lifted_at', 'blocked_at'], 'idx_delas_requester_blocks_active');
+ });
+
+ // No máximo um bloqueio ativo por pessoa.
+ DB::statement('CREATE UNIQUE INDEX uq_delas_requester_blocks_active_user ON delas_requester_blocks (user_id) WHERE lifted_at IS NULL');
+ }
+
+ public function down(): void
+ {
+ Schema::dropIfExists('delas_requester_blocks');
+ }
+};
diff --git a/app-modules/delas/database/migrations/2026_10_07_012015_create_delas_transitions_table.php b/app-modules/delas/database/migrations/2026_10_07_012015_create_delas_transitions_table.php
new file mode 100644
index 000000000..7174144be
--- /dev/null
+++ b/app-modules/delas/database/migrations/2026_10_07_012015_create_delas_transitions_table.php
@@ -0,0 +1,39 @@
+uuid('id')->primary();
+ $table->foreignUuid('user_id')->constrained('users')->cascadeOnDelete();
+ $table->foreignUuid('request_id')->nullable()->constrained('delas_tag_requests')->cascadeOnDelete();
+ $table->foreignUuid('block_id')->nullable()->constrained('delas_requester_blocks')->cascadeOnDelete();
+ $table->string('action', 20)->comment(DelasAction::stringifyCases());
+ $table->string('from_status', 20)->nullable()->comment(DelasRequestStatus::stringifyCases());
+ $table->string('to_status', 20)->nullable()->comment(DelasRequestStatus::stringifyCases());
+ $table->foreignUuid('actor_id')->nullable()->constrained('users')->nullOnDelete();
+ $table->string('triggered_by', 20)->comment(DelasTriggeredBy::stringifyCases());
+ $table->string('reason', 500)->nullable();
+ $table->timestampTz('created_at')->useCurrent();
+
+ $table->index(['created_at'], 'idx_delas_transitions_time');
+ $table->index(['user_id', 'created_at'], 'idx_delas_transitions_user_time');
+ $table->index(['actor_id', 'created_at'], 'idx_delas_transitions_actor_time');
+ });
+ }
+
+ public function down(): void
+ {
+ Schema::dropIfExists('delas_transitions');
+ }
+};
diff --git a/app-modules/delas/lang/en/enums.php b/app-modules/delas/lang/en/enums.php
new file mode 100644
index 000000000..25484f489
--- /dev/null
+++ b/app-modules/delas/lang/en/enums.php
@@ -0,0 +1,42 @@
+ [
+ 'pending' => [
+ 'label' => 'Pending',
+ 'description' => 'Waiting for a He4rt Delas moderator to decide.',
+ ],
+ 'approved' => [
+ 'label' => 'Approved',
+ 'description' => 'The He4rt Delas tag shows on the profile.',
+ ],
+ 'rejected' => [
+ 'label' => 'Rejected',
+ 'description' => 'Not approved. The person can request again after the cooldown.',
+ ],
+ 'revoked' => [
+ 'label' => 'Removed',
+ 'description' => 'The tag was removed. The person can request again after the cooldown.',
+ ],
+ ],
+ 'action' => [
+ 'requested' => ['label' => 'Requested', 'description' => 'The person requested the He4rt Delas tag.'],
+ 'approved' => ['label' => 'Approved', 'description' => 'A pending request was approved.'],
+ 'rejected' => ['label' => 'Rejected', 'description' => 'A pending request was rejected.'],
+ 'granted' => ['label' => 'Granted', 'description' => 'The tag was granted directly, skipping the queue.'],
+ 'revoked' => ['label' => 'Removed the tag', 'description' => 'The tag was removed from someone who had it.'],
+ 'blocked' => ['label' => 'Blocked', 'description' => 'The person was prevented from requesting the tag.'],
+ 'unblocked' => ['label' => 'Unblocked', 'description' => 'The person can request the tag again.'],
+ 'moderator_added' => ['label' => 'Moderator added', 'description' => 'A lead gave the He4rt Delas moderator role.'],
+ 'moderator_removed' => ['label' => 'Moderator removed', 'description' => 'A lead removed the He4rt Delas moderator role.'],
+ ],
+ 'triggered_by' => [
+ 'user' => ['label' => 'The person', 'description' => 'Done by the person who requested the tag.'],
+ 'moderator' => ['label' => 'Moderator', 'description' => 'Done by a He4rt Delas moderator.'],
+ 'lead' => ['label' => 'Lead', 'description' => 'Done by a He4rt Delas lead.'],
+ 'admin' => ['label' => 'Admin', 'description' => 'Done by a super admin.'],
+ 'system' => ['label' => 'System', 'description' => 'Done automatically by the platform.'],
+ ],
+];
diff --git a/app-modules/delas/lang/pt_BR/enums.php b/app-modules/delas/lang/pt_BR/enums.php
new file mode 100644
index 000000000..410e32693
--- /dev/null
+++ b/app-modules/delas/lang/pt_BR/enums.php
@@ -0,0 +1,42 @@
+ [
+ 'pending' => [
+ 'label' => 'Pendente',
+ 'description' => 'Aguardando uma moderadora da He4rt Delas decidir.',
+ ],
+ 'approved' => [
+ 'label' => 'Aprovada',
+ 'description' => 'A tag He4rt Delas aparece no perfil.',
+ ],
+ 'rejected' => [
+ 'label' => 'Rejeitada',
+ 'description' => 'Não aprovada. A pessoa pode pedir de novo depois da espera.',
+ ],
+ 'revoked' => [
+ 'label' => 'Removida',
+ 'description' => 'A tag foi removida. A pessoa pode pedir de novo depois da espera.',
+ ],
+ ],
+ 'action' => [
+ 'requested' => ['label' => 'Solicitou', 'description' => 'A pessoa pediu a tag He4rt Delas.'],
+ 'approved' => ['label' => 'Aprovou', 'description' => 'Uma solicitação pendente foi aprovada.'],
+ 'rejected' => ['label' => 'Rejeitou', 'description' => 'Uma solicitação pendente foi rejeitada.'],
+ 'granted' => ['label' => 'Concedeu', 'description' => 'A tag foi concedida direto, sem passar pela fila.'],
+ 'revoked' => ['label' => 'Removeu a tag', 'description' => 'A tag foi removida de quem tinha.'],
+ 'blocked' => ['label' => 'Bloqueou', 'description' => 'A pessoa foi impedida de solicitar a tag.'],
+ 'unblocked' => ['label' => 'Desbloqueou', 'description' => 'A pessoa voltou a poder solicitar a tag.'],
+ 'moderator_added' => ['label' => 'Moderadora adicionada', 'description' => 'Uma líder deu o papel de moderadora He4rt Delas.'],
+ 'moderator_removed' => ['label' => 'Moderadora removida', 'description' => 'Uma líder retirou o papel de moderadora He4rt Delas.'],
+ ],
+ 'triggered_by' => [
+ 'user' => ['label' => 'Própria pessoa', 'description' => 'Ação feita por quem pediu a tag.'],
+ 'moderator' => ['label' => 'Moderadora', 'description' => 'Ação feita por uma moderadora He4rt Delas.'],
+ 'lead' => ['label' => 'Líder', 'description' => 'Ação feita por uma líder He4rt Delas.'],
+ 'admin' => ['label' => 'Admin', 'description' => 'Ação feita por um super admin.'],
+ 'system' => ['label' => 'Sistema', 'description' => 'Ação automática da plataforma.'],
+ ],
+];
diff --git a/app-modules/delas/src/Block/Models/DelasRequesterBlock.php b/app-modules/delas/src/Block/Models/DelasRequesterBlock.php
new file mode 100644
index 000000000..bd98267f3
--- /dev/null
+++ b/app-modules/delas/src/Block/Models/DelasRequesterBlock.php
@@ -0,0 +1,95 @@
+ */
+ use HasFactory;
+ use HasUuids;
+
+ protected $fillable = [
+ 'user_id',
+ 'blocked_by',
+ 'reason',
+ 'blocked_at',
+ 'lifted_by',
+ 'lifted_at',
+ 'lift_reason',
+ ];
+
+ /** @return BelongsTo */
+ public function user(): BelongsTo
+ {
+ return $this->belongsTo(User::class);
+ }
+
+ /** @return BelongsTo */
+ public function blocker(): BelongsTo
+ {
+ return $this->belongsTo(User::class, 'blocked_by');
+ }
+
+ /** @return BelongsTo */
+ public function lifter(): BelongsTo
+ {
+ return $this->belongsTo(User::class, 'lifted_by');
+ }
+
+ public function isActive(): bool
+ {
+ return $this->lifted_at === null;
+ }
+
+ /**
+ * @param Builder $query
+ * @return Builder
+ */
+ #[Scope]
+ protected function active(Builder $query): Builder
+ {
+ return $query->whereNull('lifted_at');
+ }
+
+ /** @return array */
+ protected function casts(): array
+ {
+ return [
+ 'blocked_at' => 'datetime',
+ 'lifted_at' => 'datetime',
+ ];
+ }
+}
diff --git a/app-modules/delas/src/History/Enums/DelasAction.php b/app-modules/delas/src/History/Enums/DelasAction.php
new file mode 100644
index 000000000..88e348bfd
--- /dev/null
+++ b/app-modules/delas/src/History/Enums/DelasAction.php
@@ -0,0 +1,85 @@
+value.'.label');
+ }
+
+ /**
+ * Cada ação tem a sua cor para o histórico ser lido de relance. Não é uma
+ * escala, então a rampa do claro ao vermelho não se aplica.
+ *
+ * @return array
+ */
+ public function getColor(): array
+ {
+ return match ($this) {
+ self::Requested => Color::Gray,
+ self::Approved => Color::Green,
+ self::Granted => Color::Emerald,
+ self::Rejected => Color::Red,
+ self::Revoked => Color::Orange,
+ self::Blocked => Color::Rose,
+ self::Unblocked => Color::Sky,
+ self::ModeratorAdded => Color::Indigo,
+ self::ModeratorRemoved => Color::Slate,
+ };
+ }
+
+ public function getDescription(): string
+ {
+ return __('delas::enums.action.'.$this->value.'.description');
+ }
+
+ public function getIcon(): Heroicon
+ {
+ return match ($this) {
+ self::Requested => Heroicon::OutlinedPaperAirplane,
+ self::Approved => Heroicon::OutlinedCheck,
+ self::Granted => Heroicon::OutlinedPlusCircle,
+ self::Rejected => Heroicon::OutlinedXMark,
+ self::Revoked => Heroicon::OutlinedMinusCircle,
+ self::Blocked => Heroicon::OutlinedNoSymbol,
+ self::Unblocked => Heroicon::OutlinedLockOpen,
+ self::ModeratorAdded => Heroicon::OutlinedUserPlus,
+ self::ModeratorRemoved => Heroicon::OutlinedUserMinus,
+ };
+ }
+
+ /**
+ * Ações que a moderação vê no histórico resumido (sem os pedidos em si).
+ */
+ public function isDecision(): bool
+ {
+ return $this !== self::Requested;
+ }
+}
diff --git a/app-modules/delas/src/History/Enums/DelasTriggeredBy.php b/app-modules/delas/src/History/Enums/DelasTriggeredBy.php
new file mode 100644
index 000000000..2b7d1a8dc
--- /dev/null
+++ b/app-modules/delas/src/History/Enums/DelasTriggeredBy.php
@@ -0,0 +1,72 @@
+isSuperAdmin() => self::Admin,
+ $actor->hasRole(UserRole::DelasLead) => self::Lead,
+ $actor->hasRole(UserRole::DelasModerator) => self::Moderator,
+ default => self::User,
+ };
+ }
+
+ public function getLabel(): string
+ {
+ return __('delas::enums.triggered_by.'.$this->value.'.label');
+ }
+
+ public function getColor(): string
+ {
+ return match ($this) {
+ self::User, self::System => 'gray',
+ self::Moderator => 'info',
+ self::Lead => 'primary',
+ self::Admin => 'danger',
+ };
+ }
+
+ public function getDescription(): string
+ {
+ return __('delas::enums.triggered_by.'.$this->value.'.description');
+ }
+
+ public function getIcon(): Heroicon
+ {
+ return match ($this) {
+ self::User => Heroicon::OutlinedUser,
+ self::Moderator => Heroicon::OutlinedHeart,
+ self::Lead => Heroicon::OutlinedSparkles,
+ self::Admin => Heroicon::OutlinedShieldCheck,
+ self::System => Heroicon::OutlinedCog6Tooth,
+ };
+ }
+}
diff --git a/app-modules/delas/src/History/Models/DelasTransition.php b/app-modules/delas/src/History/Models/DelasTransition.php
new file mode 100644
index 000000000..00a1d6863
--- /dev/null
+++ b/app-modules/delas/src/History/Models/DelasTransition.php
@@ -0,0 +1,95 @@
+ */
+ use HasFactory;
+ use HasUuids;
+
+ public const UPDATED_AT = null;
+
+ protected $fillable = [
+ 'user_id',
+ 'request_id',
+ 'block_id',
+ 'action',
+ 'from_status',
+ 'to_status',
+ 'actor_id',
+ 'triggered_by',
+ 'reason',
+ ];
+
+ /** @return BelongsTo */
+ public function user(): BelongsTo
+ {
+ return $this->belongsTo(User::class);
+ }
+
+ /** @return BelongsTo */
+ public function actor(): BelongsTo
+ {
+ return $this->belongsTo(User::class, 'actor_id');
+ }
+
+ /** @return BelongsTo */
+ public function request(): BelongsTo
+ {
+ return $this->belongsTo(DelasTagRequest::class, 'request_id');
+ }
+
+ /** @return BelongsTo */
+ public function block(): BelongsTo
+ {
+ return $this->belongsTo(DelasRequesterBlock::class, 'block_id');
+ }
+
+ /** @return array */
+ protected function casts(): array
+ {
+ return [
+ 'action' => DelasAction::class,
+ 'from_status' => DelasRequestStatus::class,
+ 'to_status' => DelasRequestStatus::class,
+ 'triggered_by' => DelasTriggeredBy::class,
+ 'created_at' => 'datetime',
+ ];
+ }
+}
diff --git a/app-modules/delas/src/TagRequest/Enums/DelasRequestStatus.php b/app-modules/delas/src/TagRequest/Enums/DelasRequestStatus.php
new file mode 100644
index 000000000..81655823a
--- /dev/null
+++ b/app-modules/delas/src/TagRequest/Enums/DelasRequestStatus.php
@@ -0,0 +1,109 @@
+
+ */
+ public static function activeValues(): array
+ {
+ return array_values(array_map(
+ fn (self $status): string => $status->value,
+ array_filter(self::cases(), fn (self $status): bool => $status->isActive()),
+ ));
+ }
+
+ public function getLabel(): string
+ {
+ return match ($this) {
+ self::Pending => __('delas::enums.request_status.pending.label'),
+ self::Approved => __('delas::enums.request_status.approved.label'),
+ self::Rejected => __('delas::enums.request_status.rejected.label'),
+ self::Revoked => __('delas::enums.request_status.revoked.label'),
+ };
+ }
+
+ /**
+ * Estados, não níveis: a rampa do claro ao vermelho não se aplica.
+ */
+ public function getColor(): string
+ {
+ return match ($this) {
+ self::Pending => 'warning',
+ self::Approved => 'success',
+ self::Rejected, self::Revoked => 'gray',
+ };
+ }
+
+ public function getDescription(): string
+ {
+ return match ($this) {
+ self::Pending => __('delas::enums.request_status.pending.description'),
+ self::Approved => __('delas::enums.request_status.approved.description'),
+ self::Rejected => __('delas::enums.request_status.rejected.description'),
+ self::Revoked => __('delas::enums.request_status.revoked.description'),
+ };
+ }
+
+ public function getIcon(): Heroicon
+ {
+ return match ($this) {
+ self::Pending => Heroicon::OutlinedClock,
+ self::Approved => Heroicon::OutlinedCheck,
+ self::Rejected => Heroicon::OutlinedXMark,
+ self::Revoked => Heroicon::OutlinedMinusCircle,
+ };
+ }
+
+ public function canTransitionTo(self $target): bool
+ {
+ return match ($this) {
+ self::Pending => in_array($target, [self::Approved, self::Rejected], strict: true),
+ self::Approved => $target === self::Revoked,
+ self::Rejected, self::Revoked => false,
+ };
+ }
+
+ /**
+ * Ocupa o lugar da pessoa: enquanto existir, não dá para pedir de novo.
+ */
+ public function isActive(): bool
+ {
+ return match ($this) {
+ self::Pending, self::Approved => true,
+ self::Rejected, self::Revoked => false,
+ };
+ }
+
+ /**
+ * Encerra a solicitação e abre a espera para um novo pedido.
+ */
+ public function startsCooldown(): bool
+ {
+ return !$this->isActive();
+ }
+}
diff --git a/app-modules/delas/src/TagRequest/Models/DelasTagRequest.php b/app-modules/delas/src/TagRequest/Models/DelasTagRequest.php
new file mode 100644
index 000000000..e3e5041d8
--- /dev/null
+++ b/app-modules/delas/src/TagRequest/Models/DelasTagRequest.php
@@ -0,0 +1,101 @@
+ */
+ use HasFactory;
+ use HasUuids;
+
+ protected $fillable = [
+ 'user_id',
+ 'status',
+ 'requested_at',
+ 'decided_by',
+ 'decided_at',
+ 'decision_reason',
+ ];
+
+ /** @return BelongsTo */
+ public function user(): BelongsTo
+ {
+ return $this->belongsTo(User::class);
+ }
+
+ /** @return BelongsTo */
+ public function decider(): BelongsTo
+ {
+ return $this->belongsTo(User::class, 'decided_by');
+ }
+
+ /** @return HasMany */
+ public function transitions(): HasMany
+ {
+ return $this->hasMany(DelasTransition::class, 'request_id');
+ }
+
+ /**
+ * @param Builder $query
+ * @return Builder
+ */
+ #[Scope]
+ protected function pending(Builder $query): Builder
+ {
+ return $query->where('status', DelasRequestStatus::Pending);
+ }
+
+ /**
+ * Pendentes ou aprovadas: as que ocupam o lugar da pessoa.
+ *
+ * @param Builder $query
+ * @return Builder
+ */
+ #[Scope]
+ protected function active(Builder $query): Builder
+ {
+ return $query->whereIn('status', DelasRequestStatus::activeValues());
+ }
+
+ /** @return array */
+ protected function casts(): array
+ {
+ return [
+ 'status' => DelasRequestStatus::class,
+ 'requested_at' => 'datetime',
+ 'decided_at' => 'datetime',
+ ];
+ }
+}
diff --git a/app-modules/delas/tests/Feature/Schema/DelasSchemaTest.php b/app-modules/delas/tests/Feature/Schema/DelasSchemaTest.php
new file mode 100644
index 000000000..8b3c2978c
--- /dev/null
+++ b/app-modules/delas/tests/Feature/Schema/DelasSchemaTest.php
@@ -0,0 +1,58 @@
+create();
+
+ DelasTagRequest::factory()->for($user)->{$first}()->create();
+
+ expect(fn () => DelasTagRequest::factory()->for($user)->{$second}()->create())
+ ->toThrow(UniqueConstraintViolationException::class);
+})->with([
+ 'pendente + pendente' => ['pending', 'pending'],
+ 'aprovada + pendente' => ['approved', 'pending'],
+]);
+
+test('solicitações encerradas não ocupam o lugar da pessoa', function (): void {
+ $user = User::factory()->create();
+
+ DelasTagRequest::factory()->for($user)->rejected()->create();
+ DelasTagRequest::factory()->for($user)->revoked()->create();
+ $pending = DelasTagRequest::factory()->for($user)->pending()->create();
+
+ expect(DelasTagRequest::query()->where('user_id', $user->getKey())->active()->sole()->is($pending))->toBeTrue();
+});
+
+test('o banco recusa dois bloqueios ativos da mesma pessoa, mas guarda os encerrados', function (): void {
+ $user = User::factory()->create();
+
+ DelasRequesterBlock::factory()->for($user)->lifted()->create();
+ DelasRequesterBlock::factory()->for($user)->create();
+
+ expect(DelasRequesterBlock::query()->where('user_id', $user->getKey())->count())->toBe(2)
+ ->and(fn () => DelasRequesterBlock::factory()->for($user)->create())
+ ->toThrow(UniqueConstraintViolationException::class);
+});
+
+test('o histórico guarda enums e só tem data de criação', function (): void {
+ $transition = DelasTransition::factory()->create([
+ 'action' => DelasAction::Approved,
+ 'from_status' => DelasRequestStatus::Pending,
+ 'to_status' => DelasRequestStatus::Approved,
+ ])->fresh();
+
+ expect($transition->action)->toBe(DelasAction::Approved)
+ ->and($transition->from_status)->toBe(DelasRequestStatus::Pending)
+ ->and($transition->to_status)->toBe(DelasRequestStatus::Approved)
+ ->and($transition->created_at)->not->toBeNull()
+ ->and($transition->getAttributes())->not->toHaveKey('updated_at');
+});
diff --git a/app-modules/delas/tests/Unit/.gitkeep b/app-modules/delas/tests/Unit/.gitkeep
deleted file mode 100644
index e69de29bb..000000000
diff --git a/app-modules/delas/tests/Unit/DelasRequestStatusTest.php b/app-modules/delas/tests/Unit/DelasRequestStatusTest.php
new file mode 100644
index 000000000..4ad07e43c
--- /dev/null
+++ b/app-modules/delas/tests/Unit/DelasRequestStatusTest.php
@@ -0,0 +1,33 @@
+canTransitionTo($target))->toBe($allowed);
+})->with([
+ [DelasRequestStatus::Approved, true],
+ [DelasRequestStatus::Rejected, true],
+ [DelasRequestStatus::Revoked, false],
+ [DelasRequestStatus::Pending, false],
+]);
+
+test('aprovada só vira removida', function (DelasRequestStatus $target, bool $allowed): void {
+ expect(DelasRequestStatus::Approved->canTransitionTo($target))->toBe($allowed);
+})->with([
+ [DelasRequestStatus::Revoked, true],
+ [DelasRequestStatus::Pending, false],
+ [DelasRequestStatus::Rejected, false],
+ [DelasRequestStatus::Approved, false],
+]);
+
+test('rejeitada e removida são finais', function (DelasRequestStatus $from): void {
+ foreach (DelasRequestStatus::cases() as $target) {
+ expect($from->canTransitionTo($target))->toBeFalse();
+ }
+})->with([DelasRequestStatus::Rejected, DelasRequestStatus::Revoked]);
+
+test('só pendente e aprovada ocupam o lugar da pessoa', function (): void {
+ expect(DelasRequestStatus::activeValues())->toBe(['pending', 'approved']);
+});
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index 384cf7f85..528f649fd 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -195,7 +195,7 @@ Datas em `timestampTz`.
| `requested_at` | timestampTz | |
| `decided_by` | uuid null | FK `users`, null on delete |
| `decided_at` | timestampTz null | |
-| `decision_reason` | text null | interno |
+| `decision_reason` | string(500) null | interno |
| `created_at` / `updated_at` | timestampTz | |
Índice único parcial em `user_id` onde `status in ('pending', 'approved')`, via `DB::statement`
@@ -217,11 +217,11 @@ approved → revoked
| `id` | uuid | PK |
| `user_id` | uuid | FK `users`, cascade on delete |
| `blocked_by` | uuid null | FK `users`, null on delete |
-| `reason` | text | obrigatório |
+| `reason` | string(500) | obrigatório |
| `blocked_at` | timestampTz | |
| `lifted_by` | uuid null | FK `users`, null on delete |
| `lifted_at` | timestampTz null | |
-| `lift_reason` | text null | obrigatório ao desbloquear; nulo enquanto ativo |
+| `lift_reason` | string(500) null | obrigatório ao desbloquear; nulo enquanto ativo |
| `created_at` / `updated_at` | timestampTz | |
Índice único parcial em `user_id` onde `lifted_at is null`.
@@ -231,18 +231,18 @@ approved → revoked
Histórico append-only, gravado pelas actions, sem trigger (ADR-0003 do events). Formato mais
próximo de `squad_membership_events` (ação + trilha) do que de `events_enrollment_transitions`.
-| coluna | tipo | nota |
-| --------------------------- | --------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
-| `id` | uuid | PK |
-| `user_id` | uuid | FK `users`, cascade on delete; a pessoa afetada |
-| `request_id` | uuid null | FK `delas_tag_requests`, cascade on delete |
-| `block_id` | uuid null | FK `delas_requester_blocks`, cascade on delete |
-| `action` | string(20) | `DelasAction`: `requested`, `approved`, `rejected`, `granted`, `revoked`, `blocked`, `unblocked`, `moderator_added`, `moderator_removed` |
-| `from_status` / `to_status` | string(20) null | `DelasRequestStatus`, quando há mudança de status |
-| `actor_id` | uuid null | FK `users`, null on delete |
-| `triggered_by` | string(20) | `DelasTriggeredBy`: `user`, `moderator`, `lead`, `admin`, `system` |
-| `reason` | text null | |
-| `created_at` | timestampTz | `useCurrent()` |
+| coluna | tipo | nota |
+| --------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `id` | uuid | PK |
+| `user_id` | uuid | FK `users`, cascade on delete; a pessoa afetada |
+| `request_id` | uuid null | FK `delas_tag_requests`, cascade on delete |
+| `block_id` | uuid null | FK `delas_requester_blocks`, cascade on delete |
+| `action` | string(20) | `DelasAction`: `requested`, `approved`, `rejected`, `granted`, `revoked`, `blocked`, `unblocked`, `moderator_added`, `moderator_removed` |
+| `from_status` / `to_status` | string(20) null | `DelasRequestStatus`, quando há mudança de status |
+| `actor_id` | uuid null | FK `users`, null on delete |
+| `triggered_by` | string(20) | `DelasTriggeredBy`: `user`, `moderator`, `lead`, `admin`, `system` |
+| `reason` | string(500) null | |
+| `created_at` | timestampTz | `useCurrent()` |
Sem coluna `metadata`: nenhum fluxo a preenche, e um jsonb sem forma quebraria o
`tests/Arch/NoLooseArrayCastsTest.php` (guideline `domain/06`).
From c5dad7fb7ed2b1e47b17c8ecfd0d69d7b3847376 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Tue, 6 Oct 2026 22:32:33 -0300
Subject: [PATCH 10/77] =?UTF-8?q?feat(delas):=20regras=20de=20solicita?=
=?UTF-8?q?=C3=A7=C3=A3o,=20decis=C3=A3o,=20bloqueio=20e=20equipe?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
- RequestDelasTag, ApproveDelasRequest, RejectDelasRequest, GrantDelasTag
e RevokeDelasTag; BlockDelasRequester e UnblockDelasRequester;
AddDelasModerator e RemoveDelasModerator.
- Cada action checa o gate do ator, roda em transação com lock e grava o
histórico; motivos obrigatórios onde a regra pede; ninguém decide a
própria tag; espera de 15 dias e bloqueio via DelasEligibility.
- Eventos de domínio (ShouldDispatchAfterCommit) para integrações futuras,
como o cargo he4rt_delas no Discord.
---
app-modules/delas/lang/en/enums.php | 7 ++
app-modules/delas/lang/en/exceptions.php | 21 ++++
app-modules/delas/lang/pt_BR/enums.php | 7 ++
app-modules/delas/lang/pt_BR/exceptions.php | 21 ++++
.../src/Block/Actions/BlockDelasRequester.php | 85 +++++++++++++
.../Block/Actions/UnblockDelasRequester.php | 78 ++++++++++++
.../Block/Events/DelasRequesterBlocked.php | 22 ++++
.../Block/Events/DelasRequesterUnblocked.php | 22 ++++
.../delas/src/Exceptions/DelasException.php | 100 +++++++++++++++
.../History/Actions/RecordDelasTransition.php | 43 +++++++
app-modules/delas/src/Support/Reason.php | 35 ++++++
.../Actions/ApproveDelasRequest.php | 66 ++++++++++
.../src/TagRequest/Actions/GrantDelasTag.php | 101 +++++++++++++++
.../TagRequest/Actions/RejectDelasRequest.php | 81 ++++++++++++
.../TagRequest/Actions/RequestDelasTag.php | 70 +++++++++++
.../src/TagRequest/Actions/RevokeDelasTag.php | 74 +++++++++++
.../Enums/DelasEligibilityState.php | 55 ++++++++
.../TagRequest/Events/DelasTagApproved.php | 22 ++++
.../src/TagRequest/Events/DelasTagGranted.php | 22 ++++
.../TagRequest/Events/DelasTagRejected.php | 22 ++++
.../TagRequest/Events/DelasTagRequested.php | 21 ++++
.../src/TagRequest/Events/DelasTagRevoked.php | 22 ++++
.../TagRequest/Queries/DelasEligibility.php | 84 +++++++++++++
.../ValueObjects/DelasEligibilityResult.php | 28 +++++
.../src/Team/Actions/AddDelasModerator.php | 52 ++++++++
.../src/Team/Actions/RemoveDelasModerator.php | 52 ++++++++
.../Feature/Block/BlockDelasRequesterTest.php | 96 ++++++++++++++
.../TagRequest/DecideDelasRequestTest.php | 108 ++++++++++++++++
.../TagRequest/GrantAndRevokeDelasTagTest.php | 117 ++++++++++++++++++
.../TagRequest/RequestDelasTagTest.php | 78 ++++++++++++
.../Team/ManageDelasModeratorsTest.php | 61 +++++++++
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 2 +-
32 files changed, 1674 insertions(+), 1 deletion(-)
create mode 100644 app-modules/delas/lang/en/exceptions.php
create mode 100644 app-modules/delas/lang/pt_BR/exceptions.php
create mode 100644 app-modules/delas/src/Block/Actions/BlockDelasRequester.php
create mode 100644 app-modules/delas/src/Block/Actions/UnblockDelasRequester.php
create mode 100644 app-modules/delas/src/Block/Events/DelasRequesterBlocked.php
create mode 100644 app-modules/delas/src/Block/Events/DelasRequesterUnblocked.php
create mode 100644 app-modules/delas/src/Exceptions/DelasException.php
create mode 100644 app-modules/delas/src/History/Actions/RecordDelasTransition.php
create mode 100644 app-modules/delas/src/Support/Reason.php
create mode 100644 app-modules/delas/src/TagRequest/Actions/ApproveDelasRequest.php
create mode 100644 app-modules/delas/src/TagRequest/Actions/GrantDelasTag.php
create mode 100644 app-modules/delas/src/TagRequest/Actions/RejectDelasRequest.php
create mode 100644 app-modules/delas/src/TagRequest/Actions/RequestDelasTag.php
create mode 100644 app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
create mode 100644 app-modules/delas/src/TagRequest/Enums/DelasEligibilityState.php
create mode 100644 app-modules/delas/src/TagRequest/Events/DelasTagApproved.php
create mode 100644 app-modules/delas/src/TagRequest/Events/DelasTagGranted.php
create mode 100644 app-modules/delas/src/TagRequest/Events/DelasTagRejected.php
create mode 100644 app-modules/delas/src/TagRequest/Events/DelasTagRequested.php
create mode 100644 app-modules/delas/src/TagRequest/Events/DelasTagRevoked.php
create mode 100644 app-modules/delas/src/TagRequest/Queries/DelasEligibility.php
create mode 100644 app-modules/delas/src/TagRequest/ValueObjects/DelasEligibilityResult.php
create mode 100644 app-modules/delas/src/Team/Actions/AddDelasModerator.php
create mode 100644 app-modules/delas/src/Team/Actions/RemoveDelasModerator.php
create mode 100644 app-modules/delas/tests/Feature/Block/BlockDelasRequesterTest.php
create mode 100644 app-modules/delas/tests/Feature/TagRequest/DecideDelasRequestTest.php
create mode 100644 app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php
create mode 100644 app-modules/delas/tests/Feature/TagRequest/RequestDelasTagTest.php
create mode 100644 app-modules/delas/tests/Feature/Team/ManageDelasModeratorsTest.php
diff --git a/app-modules/delas/lang/en/enums.php b/app-modules/delas/lang/en/enums.php
index 25484f489..7c4e20d72 100644
--- a/app-modules/delas/lang/en/enums.php
+++ b/app-modules/delas/lang/en/enums.php
@@ -39,4 +39,11 @@
'admin' => ['label' => 'Admin', 'description' => 'Done by a super admin.'],
'system' => ['label' => 'System', 'description' => 'Done automatically by the platform.'],
],
+ 'eligibility' => [
+ 'can_request' => ['label' => 'Can request', 'description' => 'The person can request the He4rt Delas tag.'],
+ 'pending' => ['label' => 'Awaiting approval', 'description' => 'There is a pending request.'],
+ 'member' => ['label' => 'Member', 'description' => 'The person has the He4rt Delas tag.'],
+ 'cooldown' => ['label' => 'Cooldown', 'description' => 'A recent rejection or removal prevents a new request for now.'],
+ 'blocked' => ['label' => 'Unavailable', 'description' => 'The person is blocked from requesting the tag.'],
+ ],
];
diff --git a/app-modules/delas/lang/en/exceptions.php b/app-modules/delas/lang/en/exceptions.php
new file mode 100644
index 000000000..963fe7c60
--- /dev/null
+++ b/app-modules/delas/lang/en/exceptions.php
@@ -0,0 +1,21 @@
+ 'This person already has a pending or approved request.',
+ 'in_cooldown' => 'You cannot request yet. Try again from :date.',
+ 'blocked' => 'It is not possible to request the He4rt Delas tag right now.',
+ 'invalid_transition' => 'A :from request cannot become :to.',
+ 'cannot_decide_own' => 'You cannot decide on your own tag. Someone else on the team has to.',
+ 'reason_required' => 'Provide a reason to continue.',
+ 'cannot_block_team' => 'Moderators, leads, admins and yourself cannot be blocked.',
+ 'already_blocked' => 'This person is already blocked.',
+ 'block_already_lifted' => 'This block has already been lifted.',
+ 'cannot_unblock_others' => 'Only whoever created the block or a lead can lift it.',
+ 'already_has_tag' => 'This person already has the He4rt Delas tag.',
+ 'has_no_tag' => 'This person does not have the He4rt Delas tag.',
+ 'cannot_manage_role' => 'Leads and super admins are managed in /admin.',
+ 'already_moderator' => 'This person is already a He4rt Delas moderator.',
+ 'not_moderator' => 'This person is not a He4rt Delas moderator.',
+];
diff --git a/app-modules/delas/lang/pt_BR/enums.php b/app-modules/delas/lang/pt_BR/enums.php
index 410e32693..154821e7e 100644
--- a/app-modules/delas/lang/pt_BR/enums.php
+++ b/app-modules/delas/lang/pt_BR/enums.php
@@ -39,4 +39,11 @@
'admin' => ['label' => 'Admin', 'description' => 'Ação feita por um super admin.'],
'system' => ['label' => 'Sistema', 'description' => 'Ação automática da plataforma.'],
],
+ 'eligibility' => [
+ 'can_request' => ['label' => 'Pode solicitar', 'description' => 'A pessoa pode pedir a tag He4rt Delas.'],
+ 'pending' => ['label' => 'Aguardando aprovação', 'description' => 'Há uma solicitação pendente.'],
+ 'member' => ['label' => 'Faz parte', 'description' => 'A pessoa tem a tag He4rt Delas.'],
+ 'cooldown' => ['label' => 'Em espera', 'description' => 'Uma rejeição ou remoção recente impede um novo pedido por enquanto.'],
+ 'blocked' => ['label' => 'Indisponível', 'description' => 'A pessoa está bloqueada de solicitar a tag.'],
+ ],
];
diff --git a/app-modules/delas/lang/pt_BR/exceptions.php b/app-modules/delas/lang/pt_BR/exceptions.php
new file mode 100644
index 000000000..dd5f7711e
--- /dev/null
+++ b/app-modules/delas/lang/pt_BR/exceptions.php
@@ -0,0 +1,21 @@
+ 'Já existe uma solicitação pendente ou aprovada para esta pessoa.',
+ 'in_cooldown' => 'Ainda não é possível solicitar. Tente de novo a partir de :date.',
+ 'blocked' => 'No momento, não é possível solicitar a tag He4rt Delas.',
+ 'invalid_transition' => 'Uma solicitação :from não pode passar para :to.',
+ 'cannot_decide_own' => 'Você não pode decidir sobre a própria tag. Outra pessoa da equipe precisa fazer isso.',
+ 'reason_required' => 'Informe o motivo para continuar.',
+ 'cannot_block_team' => 'Não é possível bloquear moderadoras, líderes, admins ou a si mesma.',
+ 'already_blocked' => 'Esta pessoa já está bloqueada.',
+ 'block_already_lifted' => 'Este bloqueio já foi encerrado.',
+ 'cannot_unblock_others' => 'Só quem fez o bloqueio ou uma líder pode desfazê-lo.',
+ 'already_has_tag' => 'Esta pessoa já tem a tag He4rt Delas.',
+ 'has_no_tag' => 'Esta pessoa não tem a tag He4rt Delas.',
+ 'cannot_manage_role' => 'Líderes e super admins são gerenciados no /admin.',
+ 'already_moderator' => 'Esta pessoa já é moderadora He4rt Delas.',
+ 'not_moderator' => 'Esta pessoa não é moderadora He4rt Delas.',
+];
diff --git a/app-modules/delas/src/Block/Actions/BlockDelasRequester.php b/app-modules/delas/src/Block/Actions/BlockDelasRequester.php
new file mode 100644
index 000000000..4c5494d77
--- /dev/null
+++ b/app-modules/delas/src/Block/Actions/BlockDelasRequester.php
@@ -0,0 +1,85 @@
+authorize('moderate-delas');
+
+ $reason = Reason::required($reason);
+
+ // Ninguém da equipe (nem super admin) é bloqueado, nem a si mesma.
+ throw_if(
+ $target->is($actor) || Gate::forUser($target)->allows('moderate-delas'),
+ DelasException::cannotBlockTeam(),
+ );
+
+ try {
+ [$block, $rejected] = DB::transaction(function () use ($target, $actor, $reason): array {
+ $pending = DelasTagRequest::query()->where('user_id', $target->getKey())->pending()->first();
+ $rejected = $pending instanceof DelasTagRequest
+ ? $this->rejectRequest->rejectInTransaction($pending, $actor, $reason)
+ : null;
+
+ $block = DelasRequesterBlock::query()->create([
+ 'user_id' => $target->getKey(),
+ 'blocked_by' => $actor->getKey(),
+ 'reason' => $reason,
+ 'blocked_at' => now(),
+ ]);
+
+ $this->recordTransition->handle(
+ action: DelasAction::Blocked,
+ subject: $target,
+ actor: $actor,
+ block: $block,
+ reason: $reason,
+ );
+
+ return [$block, $rejected];
+ });
+ } catch (UniqueConstraintViolationException) {
+ throw DelasException::alreadyBlocked();
+ }
+
+ if ($rejected instanceof DelasTagRequest) {
+ event(new DelasTagRejected($rejected->getKey(), $target->getKey(), $actor->getKey()));
+ }
+
+ event(new DelasRequesterBlocked($block->getKey(), $target->getKey(), $actor->getKey()));
+
+ return $block;
+ }
+}
diff --git a/app-modules/delas/src/Block/Actions/UnblockDelasRequester.php b/app-modules/delas/src/Block/Actions/UnblockDelasRequester.php
new file mode 100644
index 000000000..5b2274380
--- /dev/null
+++ b/app-modules/delas/src/Block/Actions/UnblockDelasRequester.php
@@ -0,0 +1,78 @@
+authorize('moderate-delas');
+
+ $reason = Reason::required($reason);
+
+ throw_unless(
+ $block->blocked_by === $actor->getKey() || Gate::forUser($actor)->allows('lead-delas'),
+ DelasException::cannotUnblockOthers(),
+ );
+
+ $lifted = DB::transaction(fn (): DelasRequesterBlock => $this->liftInTransaction($block, $actor, $reason));
+
+ event(new DelasRequesterUnblocked($lifted->getKey(), $lifted->user_id, $actor->getKey()));
+
+ return $lifted;
+ }
+
+ /**
+ * Para quem já está numa transação, como a concessão direta a alguém
+ * bloqueado. Não checa permissão: quem chama já checou.
+ *
+ * @throws DelasException
+ */
+ public function liftInTransaction(DelasRequesterBlock $block, User $actor, string $reason): DelasRequesterBlock
+ {
+ $locked = DelasRequesterBlock::query()->whereKey($block->getKey())->lockForUpdate()->firstOrFail();
+
+ throw_unless($locked->isActive(), DelasException::blockAlreadyLifted());
+
+ $locked->update([
+ 'lifted_by' => $actor->getKey(),
+ 'lifted_at' => now(),
+ 'lift_reason' => $reason,
+ ]);
+
+ $this->recordTransition->handle(
+ action: DelasAction::Unblocked,
+ subject: $locked->user,
+ actor: $actor,
+ block: $locked,
+ reason: $reason,
+ );
+
+ return $locked;
+ }
+}
diff --git a/app-modules/delas/src/Block/Events/DelasRequesterBlocked.php b/app-modules/delas/src/Block/Events/DelasRequesterBlocked.php
new file mode 100644
index 000000000..9ddf9afe4
--- /dev/null
+++ b/app-modules/delas/src/Block/Events/DelasRequesterBlocked.php
@@ -0,0 +1,22 @@
+ $nextAllowedAt->timezone(config('app.display_timezone'))->format('d/m'),
+ ]),
+ Response::HTTP_UNPROCESSABLE_ENTITY,
+ );
+ }
+
+ public static function blocked(): self
+ {
+ return new self(__('delas::exceptions.blocked'), Response::HTTP_FORBIDDEN);
+ }
+
+ public static function invalidTransition(DelasRequestStatus $from, DelasRequestStatus $to): self
+ {
+ return new self(
+ __('delas::exceptions.invalid_transition', ['from' => $from->getLabel(), 'to' => $to->getLabel()]),
+ Response::HTTP_UNPROCESSABLE_ENTITY,
+ );
+ }
+
+ public static function cannotDecideOwn(): self
+ {
+ return new self(__('delas::exceptions.cannot_decide_own'), Response::HTTP_FORBIDDEN);
+ }
+
+ public static function reasonRequired(): self
+ {
+ return new self(__('delas::exceptions.reason_required'), Response::HTTP_UNPROCESSABLE_ENTITY);
+ }
+
+ public static function cannotBlockTeam(): self
+ {
+ return new self(__('delas::exceptions.cannot_block_team'), Response::HTTP_FORBIDDEN);
+ }
+
+ public static function alreadyBlocked(): self
+ {
+ return new self(__('delas::exceptions.already_blocked'), Response::HTTP_CONFLICT);
+ }
+
+ public static function blockAlreadyLifted(): self
+ {
+ return new self(__('delas::exceptions.block_already_lifted'), Response::HTTP_CONFLICT);
+ }
+
+ public static function cannotUnblockOthers(): self
+ {
+ return new self(__('delas::exceptions.cannot_unblock_others'), Response::HTTP_FORBIDDEN);
+ }
+
+ public static function alreadyHasTag(): self
+ {
+ return new self(__('delas::exceptions.already_has_tag'), Response::HTTP_CONFLICT);
+ }
+
+ public static function hasNoTag(): self
+ {
+ return new self(__('delas::exceptions.has_no_tag'), Response::HTTP_UNPROCESSABLE_ENTITY);
+ }
+
+ public static function cannotManageRole(): self
+ {
+ return new self(__('delas::exceptions.cannot_manage_role'), Response::HTTP_FORBIDDEN);
+ }
+
+ public static function alreadyModerator(): self
+ {
+ return new self(__('delas::exceptions.already_moderator'), Response::HTTP_CONFLICT);
+ }
+
+ public static function notModerator(): self
+ {
+ return new self(__('delas::exceptions.not_moderator'), Response::HTTP_UNPROCESSABLE_ENTITY);
+ }
+}
diff --git a/app-modules/delas/src/History/Actions/RecordDelasTransition.php b/app-modules/delas/src/History/Actions/RecordDelasTransition.php
new file mode 100644
index 000000000..61ba8afd6
--- /dev/null
+++ b/app-modules/delas/src/History/Actions/RecordDelasTransition.php
@@ -0,0 +1,43 @@
+create([
+ 'user_id' => $subject->getKey(),
+ 'request_id' => $request?->getKey(),
+ 'block_id' => $block?->getKey(),
+ 'action' => $action,
+ 'from_status' => $from,
+ 'to_status' => $to,
+ 'actor_id' => $actor?->getKey(),
+ 'triggered_by' => $actor instanceof User ? DelasTriggeredBy::for($actor) : DelasTriggeredBy::System,
+ 'reason' => $reason,
+ ]);
+ }
+}
diff --git a/app-modules/delas/src/Support/Reason.php b/app-modules/delas/src/Support/Reason.php
new file mode 100644
index 000000000..00319fad7
--- /dev/null
+++ b/app-modules/delas/src/Support/Reason.php
@@ -0,0 +1,35 @@
+authorize('moderate-delas');
+
+ $approved = DB::transaction(function () use ($request, $actor): DelasTagRequest {
+ $locked = DelasTagRequest::query()->whereKey($request->getKey())->lockForUpdate()->firstOrFail();
+
+ throw_if($locked->user_id === $actor->getKey(), DelasException::cannotDecideOwn());
+ throw_unless(
+ $locked->status->canTransitionTo(DelasRequestStatus::Approved),
+ DelasException::invalidTransition($locked->status, DelasRequestStatus::Approved),
+ );
+
+ $locked->update([
+ 'status' => DelasRequestStatus::Approved,
+ 'decided_by' => $actor->getKey(),
+ 'decided_at' => now(),
+ ]);
+
+ $this->recordTransition->handle(
+ action: DelasAction::Approved,
+ subject: $locked->user,
+ actor: $actor,
+ request: $locked,
+ from: DelasRequestStatus::Pending,
+ to: DelasRequestStatus::Approved,
+ );
+
+ return $locked;
+ });
+
+ event(new DelasTagApproved($approved->getKey(), $approved->user_id, $actor->getKey()));
+
+ return $approved;
+ }
+}
diff --git a/app-modules/delas/src/TagRequest/Actions/GrantDelasTag.php b/app-modules/delas/src/TagRequest/Actions/GrantDelasTag.php
new file mode 100644
index 000000000..09f97bab2
--- /dev/null
+++ b/app-modules/delas/src/TagRequest/Actions/GrantDelasTag.php
@@ -0,0 +1,101 @@
+authorize('lead-delas');
+
+ throw_if($target->is($actor), DelasException::cannotDecideOwn());
+
+ $activeBlock = DelasRequesterBlock::query()->where('user_id', $target->getKey())->active()->first();
+ $reason = $activeBlock instanceof DelasRequesterBlock ? Reason::required($reason) : Reason::optional($reason);
+
+ [$request, $liftedBlock] = DB::transaction(function () use ($target, $actor, $reason, $activeBlock): array {
+ $current = DelasTagRequest::query()
+ ->where('user_id', $target->getKey())
+ ->active()
+ ->lockForUpdate()
+ ->first();
+
+ throw_if($current?->status === DelasRequestStatus::Approved, DelasException::alreadyHasTag());
+
+ $liftedBlock = $activeBlock instanceof DelasRequesterBlock
+ ? $this->unblock->liftInTransaction($activeBlock, $actor, (string) $reason)
+ : null;
+
+ $attributes = [
+ 'status' => DelasRequestStatus::Approved,
+ 'decided_by' => $actor->getKey(),
+ 'decided_at' => now(),
+ 'decision_reason' => $reason,
+ ];
+
+ if ($current instanceof DelasTagRequest) {
+ $current->update($attributes);
+ $request = $current;
+ } else {
+ $request = DelasTagRequest::query()->create([
+ 'user_id' => $target->getKey(),
+ 'requested_at' => now(),
+ ...$attributes,
+ ]);
+ }
+
+ $this->recordTransition->handle(
+ action: DelasAction::Granted,
+ subject: $target,
+ actor: $actor,
+ request: $request,
+ from: $current instanceof DelasTagRequest ? DelasRequestStatus::Pending : null,
+ to: DelasRequestStatus::Approved,
+ reason: $reason,
+ );
+
+ return [$request, $liftedBlock];
+ });
+
+ if ($liftedBlock instanceof DelasRequesterBlock) {
+ event(new DelasRequesterUnblocked($liftedBlock->getKey(), $target->getKey(), $actor->getKey()));
+ }
+
+ event(new DelasTagGranted($request->getKey(), $target->getKey(), $actor->getKey()));
+
+ return $request;
+ }
+}
diff --git a/app-modules/delas/src/TagRequest/Actions/RejectDelasRequest.php b/app-modules/delas/src/TagRequest/Actions/RejectDelasRequest.php
new file mode 100644
index 000000000..2170012d4
--- /dev/null
+++ b/app-modules/delas/src/TagRequest/Actions/RejectDelasRequest.php
@@ -0,0 +1,81 @@
+authorize('moderate-delas');
+
+ $reason = Reason::required($reason);
+
+ $rejected = DB::transaction(fn (): DelasTagRequest => $this->rejectInTransaction($request, $actor, $reason));
+
+ event(new DelasTagRejected($rejected->getKey(), $rejected->user_id, $actor->getKey()));
+
+ return $rejected;
+ }
+
+ /**
+ * Para quem já está numa transação, como o bloqueio, que rejeita a
+ * solicitação pendente junto.
+ *
+ * @throws DelasException
+ */
+ public function rejectInTransaction(DelasTagRequest $request, User $actor, string $reason): DelasTagRequest
+ {
+ $locked = DelasTagRequest::query()->whereKey($request->getKey())->lockForUpdate()->firstOrFail();
+
+ throw_if($locked->user_id === $actor->getKey(), DelasException::cannotDecideOwn());
+ throw_unless(
+ $locked->status->canTransitionTo(DelasRequestStatus::Rejected),
+ DelasException::invalidTransition($locked->status, DelasRequestStatus::Rejected),
+ );
+
+ $locked->update([
+ 'status' => DelasRequestStatus::Rejected,
+ 'decided_by' => $actor->getKey(),
+ 'decided_at' => now(),
+ 'decision_reason' => $reason,
+ ]);
+
+ $this->recordTransition->handle(
+ action: DelasAction::Rejected,
+ subject: $locked->user,
+ actor: $actor,
+ request: $locked,
+ from: DelasRequestStatus::Pending,
+ to: DelasRequestStatus::Rejected,
+ reason: $reason,
+ );
+
+ return $locked;
+ }
+}
diff --git a/app-modules/delas/src/TagRequest/Actions/RequestDelasTag.php b/app-modules/delas/src/TagRequest/Actions/RequestDelasTag.php
new file mode 100644
index 000000000..cd08595a9
--- /dev/null
+++ b/app-modules/delas/src/TagRequest/Actions/RequestDelasTag.php
@@ -0,0 +1,70 @@
+eligibility->for($user);
+
+ match ($eligibility->state) {
+ DelasEligibilityState::Pending, DelasEligibilityState::Member => throw DelasException::alreadyHasActiveRequest(),
+ DelasEligibilityState::Blocked => throw DelasException::blocked(),
+ DelasEligibilityState::Cooldown => throw DelasException::inCooldown($eligibility->nextAllowedAt ?? now()),
+ DelasEligibilityState::CanRequest => null,
+ };
+
+ try {
+ $request = DB::transaction(function () use ($user): DelasTagRequest {
+ $request = DelasTagRequest::query()->create([
+ 'user_id' => $user->getKey(),
+ 'status' => DelasRequestStatus::Pending,
+ 'requested_at' => now(),
+ ]);
+
+ $this->recordTransition->handle(
+ action: DelasAction::Requested,
+ subject: $user,
+ actor: $user,
+ request: $request,
+ to: DelasRequestStatus::Pending,
+ );
+
+ return $request;
+ });
+ } catch (UniqueConstraintViolationException) {
+ // Dois pedidos ao mesmo tempo: o índice único parcial deixa só um passar.
+ throw DelasException::alreadyHasActiveRequest();
+ }
+
+ event(new DelasTagRequested($request->getKey(), $user->getKey()));
+
+ return $request;
+ }
+}
diff --git a/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php b/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
new file mode 100644
index 000000000..f279b2769
--- /dev/null
+++ b/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
@@ -0,0 +1,74 @@
+authorize('lead-delas');
+
+ throw_if($target->is($actor), DelasException::cannotDecideOwn());
+
+ $reason = Reason::required($reason);
+
+ $revoked = DB::transaction(function () use ($target, $actor, $reason): DelasTagRequest {
+ $approved = DelasTagRequest::query()
+ ->where('user_id', $target->getKey())
+ ->where('status', DelasRequestStatus::Approved)
+ ->lockForUpdate()
+ ->first();
+
+ throw_unless($approved instanceof DelasTagRequest, DelasException::hasNoTag());
+
+ $approved->update([
+ 'status' => DelasRequestStatus::Revoked,
+ 'decided_by' => $actor->getKey(),
+ 'decided_at' => now(),
+ 'decision_reason' => $reason,
+ ]);
+
+ $this->recordTransition->handle(
+ action: DelasAction::Revoked,
+ subject: $target,
+ actor: $actor,
+ request: $approved,
+ from: DelasRequestStatus::Approved,
+ to: DelasRequestStatus::Revoked,
+ reason: $reason,
+ );
+
+ return $approved;
+ });
+
+ event(new DelasTagRevoked($revoked->getKey(), $target->getKey(), $actor->getKey()));
+
+ return $revoked;
+ }
+}
diff --git a/app-modules/delas/src/TagRequest/Enums/DelasEligibilityState.php b/app-modules/delas/src/TagRequest/Enums/DelasEligibilityState.php
new file mode 100644
index 000000000..ea928a621
--- /dev/null
+++ b/app-modules/delas/src/TagRequest/Enums/DelasEligibilityState.php
@@ -0,0 +1,55 @@
+value.'.label');
+ }
+
+ public function getColor(): string
+ {
+ return match ($this) {
+ self::CanRequest => 'primary',
+ self::Pending => 'warning',
+ self::Member => 'success',
+ self::Cooldown, self::Blocked => 'gray',
+ };
+ }
+
+ public function getDescription(): string
+ {
+ return __('delas::enums.eligibility.'.$this->value.'.description');
+ }
+
+ public function getIcon(): Heroicon
+ {
+ return match ($this) {
+ self::CanRequest => Heroicon::OutlinedHeart,
+ self::Pending => Heroicon::OutlinedClock,
+ self::Member => Heroicon::OutlinedCheckCircle,
+ self::Cooldown => Heroicon::OutlinedClock,
+ self::Blocked => Heroicon::OutlinedInformationCircle,
+ };
+ }
+}
diff --git a/app-modules/delas/src/TagRequest/Events/DelasTagApproved.php b/app-modules/delas/src/TagRequest/Events/DelasTagApproved.php
new file mode 100644
index 000000000..72ecefaf4
--- /dev/null
+++ b/app-modules/delas/src/TagRequest/Events/DelasTagApproved.php
@@ -0,0 +1,22 @@
+where('user_id', $user->getKey())
+ ->active()
+ ->first();
+
+ if ($active instanceof DelasTagRequest) {
+ return new DelasEligibilityResult(
+ state: $active->status === DelasRequestStatus::Approved ? DelasEligibilityState::Member : DelasEligibilityState::Pending,
+ request: $active,
+ );
+ }
+
+ if ($this->isBlocked($user)) {
+ return new DelasEligibilityResult(DelasEligibilityState::Blocked);
+ }
+
+ $nextAllowedAt = $this->nextAllowedAt($user);
+
+ if ($nextAllowedAt instanceof CarbonInterface && $nextAllowedAt->isFuture()) {
+ return new DelasEligibilityResult(DelasEligibilityState::Cooldown, nextAllowedAt: $nextAllowedAt);
+ }
+
+ return new DelasEligibilityResult(DelasEligibilityState::CanRequest);
+ }
+
+ public function hasTag(User $user): bool
+ {
+ return DelasTagRequest::query()
+ ->where('user_id', $user->getKey())
+ ->where('status', DelasRequestStatus::Approved)
+ ->exists();
+ }
+
+ public function isBlocked(User $user): bool
+ {
+ return DelasRequesterBlock::query()
+ ->where('user_id', $user->getKey())
+ ->active()
+ ->exists();
+ }
+
+ /**
+ * A partir de quando a pessoa pode pedir de novo, contado da última
+ * rejeição ou remoção. Nulo se nunca houve uma.
+ */
+ private function nextAllowedAt(User $user): ?CarbonInterface
+ {
+ $lastDecision = DelasTagRequest::query()
+ ->where('user_id', $user->getKey())
+ ->whereIn('status', [DelasRequestStatus::Rejected, DelasRequestStatus::Revoked])
+ ->max('decided_at');
+
+ if ($lastDecision === null) {
+ return null;
+ }
+
+ return CarbonImmutable::parse($lastDecision)->addDays(config()->integer('delas.request_cooldown_days'));
+ }
+}
diff --git a/app-modules/delas/src/TagRequest/ValueObjects/DelasEligibilityResult.php b/app-modules/delas/src/TagRequest/ValueObjects/DelasEligibilityResult.php
new file mode 100644
index 000000000..753c1587e
--- /dev/null
+++ b/app-modules/delas/src/TagRequest/ValueObjects/DelasEligibilityResult.php
@@ -0,0 +1,28 @@
+state === DelasEligibilityState::CanRequest;
+ }
+
+ public function hasTag(): bool
+ {
+ return $this->state === DelasEligibilityState::Member;
+ }
+}
diff --git a/app-modules/delas/src/Team/Actions/AddDelasModerator.php b/app-modules/delas/src/Team/Actions/AddDelasModerator.php
new file mode 100644
index 000000000..6b8c48a67
--- /dev/null
+++ b/app-modules/delas/src/Team/Actions/AddDelasModerator.php
@@ -0,0 +1,52 @@
+authorize('lead-delas');
+
+ throw_if(
+ $target->isSuperAdmin() || $target->hasRole(UserRole::DelasLead),
+ DelasException::cannotManageRole(),
+ );
+ throw_if($target->hasRole(UserRole::DelasModerator), DelasException::alreadyModerator());
+
+ DB::transaction(function () use ($target, $actor): void {
+ $target->assignRole(UserRole::DelasModerator);
+
+ $this->recordTransition->handle(
+ action: DelasAction::ModeratorAdded,
+ subject: $target,
+ actor: $actor,
+ );
+ });
+
+ return $target;
+ }
+}
diff --git a/app-modules/delas/src/Team/Actions/RemoveDelasModerator.php b/app-modules/delas/src/Team/Actions/RemoveDelasModerator.php
new file mode 100644
index 000000000..61039a8e9
--- /dev/null
+++ b/app-modules/delas/src/Team/Actions/RemoveDelasModerator.php
@@ -0,0 +1,52 @@
+authorize('lead-delas');
+
+ throw_if(
+ $target->isSuperAdmin() || $target->hasRole(UserRole::DelasLead),
+ DelasException::cannotManageRole(),
+ );
+ throw_unless($target->hasRole(UserRole::DelasModerator), DelasException::notModerator());
+
+ DB::transaction(function () use ($target, $actor): void {
+ $target->removeRole(UserRole::DelasModerator);
+
+ $this->recordTransition->handle(
+ action: DelasAction::ModeratorRemoved,
+ subject: $target,
+ actor: $actor,
+ );
+ });
+
+ return $target;
+ }
+}
diff --git a/app-modules/delas/tests/Feature/Block/BlockDelasRequesterTest.php b/app-modules/delas/tests/Feature/Block/BlockDelasRequesterTest.php
new file mode 100644
index 000000000..8def42620
--- /dev/null
+++ b/app-modules/delas/tests/Feature/Block/BlockDelasRequesterTest.php
@@ -0,0 +1,96 @@
+delasModerator()->create();
+ $target = User::factory()->create();
+ $request = DelasTagRequest::factory()->for($target)->pending()->create();
+
+ $block = resolve(BlockDelasRequester::class)->handle($target, $moderator, 'Pedidos repetidos.');
+
+ expect($block->isActive())->toBeTrue()
+ ->and($block->blocked_by)->toBe($moderator->getKey())
+ ->and($request->fresh()->status)->toBe(DelasRequestStatus::Rejected)
+ ->and(resolve(DelasEligibility::class)->for($target)->state)->toBe(DelasEligibilityState::Blocked)
+ ->and(DelasTransition::query()->oldest()->pluck('action')->all())
+ ->toEqualCanonicalizing([DelasAction::Rejected, DelasAction::Blocked]);
+});
+
+test('bloquear exige motivo', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+
+ expect(fn () => resolve(BlockDelasRequester::class)->handle(User::factory()->create(), $moderator, ' '))
+ ->toThrow(DelasException::class, __('delas::exceptions.reason_required'));
+});
+
+test('não bloqueia moderadora, líder, super admin nem a si mesma', function (string $state): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $target = $state === 'self' ? $moderator : User::factory()->{$state}()->create();
+
+ expect(fn () => resolve(BlockDelasRequester::class)->handle($target, $moderator, 'motivo'))
+ ->toThrow(DelasException::class, __('delas::exceptions.cannot_block_team'));
+})->with(['delasModerator', 'delasLead', 'superAdmin', 'self']);
+
+test('não bloqueia quem já está bloqueada', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $target = User::factory()->create();
+ resolve(BlockDelasRequester::class)->handle($target, $moderator, 'primeiro');
+
+ expect(fn () => resolve(BlockDelasRequester::class)->handle($target, $moderator, 'segundo'))
+ ->toThrow(DelasException::class, __('delas::exceptions.already_blocked'));
+});
+
+test('membra comum não bloqueia', function (): void {
+ expect(fn () => resolve(BlockDelasRequester::class)->handle(User::factory()->create(), User::factory()->create(), 'motivo'))
+ ->toThrow(AuthorizationException::class);
+});
+
+test('moderadora desbloqueia o próprio bloqueio, com motivo obrigatório', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $block = DelasRequesterBlock::factory()->create(['blocked_by' => $moderator->getKey()]);
+
+ expect(fn () => resolve(UnblockDelasRequester::class)->handle($block, $moderator, ''))
+ ->toThrow(DelasException::class, __('delas::exceptions.reason_required'));
+
+ resolve(UnblockDelasRequester::class)->handle($block, $moderator, 'Situação esclarecida.');
+
+ $block->refresh();
+
+ expect($block->isActive())->toBeFalse()
+ ->and($block->lifted_by)->toBe($moderator->getKey())
+ ->and($block->lift_reason)->toBe('Situação esclarecida.')
+ ->and(DelasTransition::query()->sole()->action)->toBe(DelasAction::Unblocked);
+});
+
+test('moderadora não desbloqueia o bloqueio de outra; líder desbloqueia qualquer um', function (): void {
+ $block = DelasRequesterBlock::factory()->create();
+
+ expect(fn () => resolve(UnblockDelasRequester::class)->handle($block, User::factory()->delasModerator()->create(), 'motivo'))
+ ->toThrow(DelasException::class, __('delas::exceptions.cannot_unblock_others'));
+
+ resolve(UnblockDelasRequester::class)->handle($block, User::factory()->delasLead()->create(), 'motivo');
+
+ expect($block->fresh()->isActive())->toBeFalse();
+});
+
+test('um bloqueio encerrado não é encerrado de novo', function (): void {
+ $lead = User::factory()->delasLead()->create();
+ $block = DelasRequesterBlock::factory()->lifted()->create();
+
+ expect(fn () => resolve(UnblockDelasRequester::class)->handle($block, $lead, 'de novo'))
+ ->toThrow(DelasException::class, __('delas::exceptions.block_already_lifted'));
+});
diff --git a/app-modules/delas/tests/Feature/TagRequest/DecideDelasRequestTest.php b/app-modules/delas/tests/Feature/TagRequest/DecideDelasRequestTest.php
new file mode 100644
index 000000000..b49f489b2
--- /dev/null
+++ b/app-modules/delas/tests/Feature/TagRequest/DecideDelasRequestTest.php
@@ -0,0 +1,108 @@
+delasModerator()->create();
+ $request = DelasTagRequest::factory()->pending()->create();
+
+ $this->freezeSecond();
+ resolve(ApproveDelasRequest::class)->handle($request, $moderator);
+
+ $request->refresh();
+ $transition = DelasTransition::query()->sole();
+
+ expect($request->status)->toBe(DelasRequestStatus::Approved)
+ ->and($request->decided_by)->toBe($moderator->getKey())
+ ->and($request->decided_at->toDateTimeString())->toBe(now()->toDateTimeString())
+ ->and(resolve(DelasEligibility::class)->hasTag($request->user))->toBeTrue()
+ ->and($transition->action)->toBe(DelasAction::Approved)
+ ->and($transition->triggered_by)->toBe(DelasTriggeredBy::Moderator)
+ ->and($transition->from_status)->toBe(DelasRequestStatus::Pending)
+ ->and($transition->to_status)->toBe(DelasRequestStatus::Approved);
+
+ Event::assertDispatched(DelasTagApproved::class);
+});
+
+test('moderadora rejeita com motivo: a tag não aparece e a solicitação sai das pendentes', function (): void {
+ Event::fake([DelasTagRejected::class]);
+ $moderator = User::factory()->delasModerator()->create();
+ $request = DelasTagRequest::factory()->pending()->create();
+
+ resolve(RejectDelasRequest::class)->handle($request, $moderator, ' Perfil sem informações. ');
+
+ $request->refresh();
+
+ expect($request->status)->toBe(DelasRequestStatus::Rejected)
+ ->and($request->decision_reason)->toBe('Perfil sem informações.')
+ ->and(DelasTagRequest::query()->pending()->exists())->toBeFalse()
+ ->and(resolve(DelasEligibility::class)->hasTag($request->user))->toBeFalse()
+ ->and(DelasTransition::query()->sole()->reason)->toBe('Perfil sem informações.');
+
+ Event::assertDispatched(DelasTagRejected::class);
+});
+
+test('rejeitar sem motivo é recusado', function (?string $reason): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $request = DelasTagRequest::factory()->pending()->create();
+
+ expect(fn () => resolve(RejectDelasRequest::class)->handle($request, $moderator, $reason))
+ ->toThrow(DelasException::class, __('delas::exceptions.reason_required'));
+})->with([null, '', ' ']);
+
+test('quem não é da equipe não aprova nem rejeita', function (): void {
+ $member = User::factory()->create();
+ $request = DelasTagRequest::factory()->pending()->create();
+
+ expect(fn () => resolve(ApproveDelasRequest::class)->handle($request, $member))->toThrow(AuthorizationException::class)
+ ->and(fn () => resolve(RejectDelasRequest::class)->handle($request, $member, 'motivo'))->toThrow(AuthorizationException::class)
+ ->and($request->fresh()->status)->toBe(DelasRequestStatus::Pending);
+});
+
+test('moderadora não decide a própria solicitação', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $request = DelasTagRequest::factory()->for($moderator)->pending()->create();
+
+ expect(fn () => resolve(ApproveDelasRequest::class)->handle($request, $moderator))
+ ->toThrow(DelasException::class, __('delas::exceptions.cannot_decide_own'))
+ ->and(fn () => resolve(RejectDelasRequest::class)->handle($request, $moderator, 'motivo'))
+ ->toThrow(DelasException::class, __('delas::exceptions.cannot_decide_own'));
+});
+
+test('uma solicitação já decidida não é decidida de novo', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $other = User::factory()->delasModerator()->create();
+ $request = DelasTagRequest::factory()->pending()->create();
+
+ resolve(ApproveDelasRequest::class)->handle($request, $moderator);
+
+ expect(fn () => resolve(RejectDelasRequest::class)->handle($request, $other, 'atrasada'))
+ ->toThrow(DelasException::class)
+ ->and($request->fresh()->status)->toBe(DelasRequestStatus::Approved)
+ ->and(DelasTransition::query()->count())->toBe(1);
+});
+
+test('super admin decide sem papel da He4rt Delas e fica registrado como admin', function (): void {
+ $admin = User::factory()->superAdmin()->create();
+ $request = DelasTagRequest::factory()->pending()->create();
+
+ resolve(ApproveDelasRequest::class)->handle($request, $admin);
+
+ expect(DelasTransition::query()->sole()->triggered_by)->toBe(DelasTriggeredBy::Admin);
+});
diff --git a/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php b/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php
new file mode 100644
index 000000000..7f3d33482
--- /dev/null
+++ b/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php
@@ -0,0 +1,117 @@
+delasLead()->create();
+ $target = User::factory()->create();
+
+ $request = resolve(GrantDelasTag::class)->handle($target, $lead);
+
+ expect($request->status)->toBe(DelasRequestStatus::Approved)
+ ->and(DelasTagRequest::query()->count())->toBe(1)
+ ->and(DelasTransition::query()->sole()->action)->toBe(DelasAction::Granted)
+ ->and(DelasTransition::query()->sole()->triggered_by)->toBe(DelasTriggeredBy::Lead);
+
+ Event::assertDispatched(DelasTagGranted::class);
+});
+
+test('conceder com solicitação pendente aprova essa solicitação', function (): void {
+ $lead = User::factory()->delasLead()->create();
+ $pending = DelasTagRequest::factory()->pending()->create();
+
+ $request = resolve(GrantDelasTag::class)->handle($pending->user, $lead);
+
+ expect($request->is($pending))->toBeTrue()
+ ->and($pending->fresh()->status)->toBe(DelasRequestStatus::Approved)
+ ->and(DelasTagRequest::query()->count())->toBe(1);
+});
+
+test('conceder ignora a espera', function (): void {
+ $lead = User::factory()->delasLead()->create();
+ $rejected = DelasTagRequest::factory()->rejected()->create();
+
+ resolve(GrantDelasTag::class)->handle($rejected->user, $lead);
+
+ expect(resolve(DelasEligibility::class)->hasTag($rejected->user))->toBeTrue();
+});
+
+test('conceder a quem está bloqueada exige motivo e encerra o bloqueio', function (): void {
+ Event::fake([DelasTagGranted::class, DelasRequesterUnblocked::class]);
+ $lead = User::factory()->delasLead()->create();
+ $block = DelasRequesterBlock::factory()->create();
+
+ expect(fn () => resolve(GrantDelasTag::class)->handle($block->user, $lead))
+ ->toThrow(DelasException::class, __('delas::exceptions.reason_required'));
+
+ resolve(GrantDelasTag::class)->handle($block->user, $lead, 'Esclarecido com o comitê.');
+
+ expect($block->fresh()->isActive())->toBeFalse()
+ ->and($block->fresh()->lift_reason)->toBe('Esclarecido com o comitê.')
+ ->and(DelasTransition::query()->pluck('action')->all())
+ ->toEqualCanonicalizing([DelasAction::Unblocked, DelasAction::Granted]);
+
+ Event::assertDispatched(DelasRequesterUnblocked::class);
+ Event::assertDispatched(DelasTagGranted::class);
+});
+
+test('não concede a quem já tem a tag nem a si mesma', function (): void {
+ $lead = User::factory()->delasLead()->create();
+ $approved = DelasTagRequest::factory()->approved()->create();
+
+ expect(fn () => resolve(GrantDelasTag::class)->handle($approved->user, $lead))
+ ->toThrow(DelasException::class, __('delas::exceptions.already_has_tag'))
+ ->and(fn () => resolve(GrantDelasTag::class)->handle($lead, $lead))
+ ->toThrow(DelasException::class, __('delas::exceptions.cannot_decide_own'));
+});
+
+test('moderadora não concede nem remove a tag direto', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $approved = DelasTagRequest::factory()->approved()->create();
+
+ expect(fn () => resolve(GrantDelasTag::class)->handle(User::factory()->create(), $moderator))->toThrow(AuthorizationException::class)
+ ->and(fn () => resolve(RevokeDelasTag::class)->handle($approved->user, $moderator, 'motivo'))->toThrow(AuthorizationException::class);
+});
+
+test('remover a tag exige motivo, não apaga o registro e abre a espera', function (): void {
+ Event::fake([DelasTagRevoked::class]);
+ $admin = User::factory()->superAdmin()->create();
+ $approved = DelasTagRequest::factory()->approved()->create();
+
+ expect(fn () => resolve(RevokeDelasTag::class)->handle($approved->user, $admin, reason: null))
+ ->toThrow(DelasException::class, __('delas::exceptions.reason_required'));
+
+ resolve(RevokeDelasTag::class)->handle($approved->user, $admin, 'A pessoa pediu a remoção.');
+
+ expect($approved->fresh()->status)->toBe(DelasRequestStatus::Revoked)
+ ->and(resolve(DelasEligibility::class)->for($approved->user)->state)->toBe(DelasEligibilityState::Cooldown)
+ ->and(DelasTransition::query()->sole()->triggered_by)->toBe(DelasTriggeredBy::Admin);
+
+ Event::assertDispatched(DelasTagRevoked::class);
+});
+
+test('não remove de quem não tem a tag', function (): void {
+ $lead = User::factory()->delasLead()->create();
+
+ expect(fn () => resolve(RevokeDelasTag::class)->handle(User::factory()->create(), $lead, 'motivo'))
+ ->toThrow(DelasException::class, __('delas::exceptions.has_no_tag'));
+});
diff --git a/app-modules/delas/tests/Feature/TagRequest/RequestDelasTagTest.php b/app-modules/delas/tests/Feature/TagRequest/RequestDelasTagTest.php
new file mode 100644
index 000000000..f396b047d
--- /dev/null
+++ b/app-modules/delas/tests/Feature/TagRequest/RequestDelasTagTest.php
@@ -0,0 +1,78 @@
+create();
+
+ $request = resolve(RequestDelasTag::class)->handle($user);
+
+ $transition = DelasTransition::query()->sole();
+
+ expect($request->status)->toBe(DelasRequestStatus::Pending)
+ ->and($transition->action)->toBe(DelasAction::Requested)
+ ->and($transition->triggered_by)->toBe(DelasTriggeredBy::User)
+ ->and($transition->actor_id)->toBe($user->getKey())
+ ->and(resolve(DelasEligibility::class)->for($user)->state)->toBe(DelasEligibilityState::Pending);
+
+ Event::assertDispatched(fn (DelasTagRequested $event): bool => $event->requestId === $request->getKey());
+});
+
+test('recusa quem já tem uma solicitação pendente ou aprovada', function (string $state): void {
+ $user = User::factory()->create();
+ DelasTagRequest::factory()->for($user)->{$state}()->create();
+
+ expect(fn () => resolve(RequestDelasTag::class)->handle($user))
+ ->toThrow(DelasException::class, __('delas::exceptions.already_has_active_request'));
+})->with(['pending', 'approved']);
+
+test('recusa quem está bloqueada', function (): void {
+ $user = User::factory()->create();
+ DelasRequesterBlock::factory()->for($user)->create();
+
+ expect(fn () => resolve(RequestDelasTag::class)->handle($user))
+ ->toThrow(DelasException::class, __('delas::exceptions.blocked'));
+});
+
+test('respeita a espera de 15 dias depois de uma rejeição ou remoção', function (string $state): void {
+ $this->travelTo(today());
+ $user = User::factory()->create();
+ DelasTagRequest::factory()->for($user)->{$state}()->create(['decided_at' => now()]);
+
+ $this->travelTo(now()->addDays(15)->subMinute());
+ expect(fn () => resolve(RequestDelasTag::class)->handle($user))->toThrow(DelasException::class);
+
+ $this->travelTo(now()->addMinutes(2));
+ expect(resolve(RequestDelasTag::class)->handle($user)->status)->toBe(DelasRequestStatus::Pending);
+})->with(['rejected', 'revoked']);
+
+test('a espera vem da config', function (): void {
+ config(['delas.request_cooldown_days' => 3]);
+ $user = User::factory()->create();
+ DelasTagRequest::factory()->for($user)->rejected()->create(['decided_at' => now()->subDays(4)]);
+
+ expect(resolve(DelasEligibility::class)->for($user)->canRequest())->toBeTrue();
+});
+
+test('quem tem a tag continua com ela mesmo bloqueada', function (): void {
+ $user = User::factory()->create();
+ DelasTagRequest::factory()->for($user)->approved()->create();
+ DelasRequesterBlock::factory()->for($user)->create();
+
+ expect(resolve(DelasEligibility::class)->for($user)->hasTag())->toBeTrue();
+});
diff --git a/app-modules/delas/tests/Feature/Team/ManageDelasModeratorsTest.php b/app-modules/delas/tests/Feature/Team/ManageDelasModeratorsTest.php
new file mode 100644
index 000000000..9d6d1d4e2
--- /dev/null
+++ b/app-modules/delas/tests/Feature/Team/ManageDelasModeratorsTest.php
@@ -0,0 +1,61 @@
+delasLead()->create();
+ $target = User::factory()->create();
+
+ resolve(AddDelasModerator::class)->handle($target, $lead);
+ expect($target->fresh()->can('moderate-delas'))->toBeTrue();
+
+ resolve(RemoveDelasModerator::class)->handle($target->fresh(), $lead);
+ expect($target->fresh()->can('moderate-delas'))->toBeFalse()
+ ->and(DelasTransition::query()->pluck('action')->all())
+ ->toEqualCanonicalizing([DelasAction::ModeratorAdded, DelasAction::ModeratorRemoved]);
+});
+
+test('moderadora não gerencia a equipe', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+
+ expect(fn () => resolve(AddDelasModerator::class)->handle(User::factory()->create(), $moderator))
+ ->toThrow(AuthorizationException::class);
+});
+
+test('líder não mexe em líderes nem em super admins', function (string $state): void {
+ $lead = User::factory()->delasLead()->create();
+ $target = User::factory()->{$state}()->create();
+
+ expect(fn () => resolve(AddDelasModerator::class)->handle($target, $lead))
+ ->toThrow(DelasException::class, __('delas::exceptions.cannot_manage_role'))
+ ->and(fn () => resolve(RemoveDelasModerator::class)->handle($target, $lead))
+ ->toThrow(DelasException::class, __('delas::exceptions.cannot_manage_role'));
+})->with(['delasLead', 'superAdmin']);
+
+test('não adiciona quem já é moderadora nem remove quem não é', function (): void {
+ $lead = User::factory()->delasLead()->create();
+
+ expect(fn () => resolve(AddDelasModerator::class)->handle(User::factory()->delasModerator()->create(), $lead))
+ ->toThrow(DelasException::class, __('delas::exceptions.already_moderator'))
+ ->and(fn () => resolve(RemoveDelasModerator::class)->handle(User::factory()->create(), $lead))
+ ->toThrow(DelasException::class, __('delas::exceptions.not_moderator'));
+});
+
+test('a moderadora removida mantém as decisões no histórico', function (): void {
+ $lead = User::factory()->delasLead()->create();
+ $moderator = User::factory()->delasModerator()->create();
+
+ resolve(RemoveDelasModerator::class)->handle($moderator, $lead);
+
+ expect($moderator->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse()
+ ->and(DelasTransition::query()->where('user_id', $moderator->getKey())->exists())->toBeTrue();
+});
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index 528f649fd..76651ecc0 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -259,7 +259,7 @@ Sem coluna `metadata`: nenhum fluxo a preenche, e um jsonb sem forma quebraria o
### Actions de domínio
-`final readonly`, `handle(DTO)`, sem sufixo `Action` (padrão de `CreateShortLink`,
+`final readonly`, `handle()` com parâmetros tipados (ator sempre explícito), sem sufixo `Action` (padrão de `CreateShortLink`,
`ReviewAppeal`). As que mudam estado rodam em `DB::transaction` com `lockForUpdate()` e gravam
a linha de histórico.
From d0182ebb3c989c45a4de5b1f5a6e36cdc7ecd9ba Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Tue, 6 Oct 2026 22:51:46 -0300
Subject: [PATCH 11/77] =?UTF-8?q?feat(panel-app):=20solicita=C3=A7=C3=A3o?=
=?UTF-8?q?=20da=20tag=20e=20modera=C3=A7=C3=A3o=20He4rt=20Delas=20no=20Hu?=
=?UTF-8?q?b?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
- Perfil: seção He4rt Delas com o pedido (pop-up de confirmação), os
estados pendente, membra, em espera e bloqueada, e a tag no card.
- Página He4rt Delas (gate moderate-delas): fila de pendentes com aprovar,
rejeitar e bloquear; bloqueios; histórico. Líderes e super admins veem
também os números, o histórico completo, a aba de moderadoras e as ações
de conceder e remover a tag.
- Logo e ícone oficiais da He4rt Delas e a paleta da marca no tema do Hub,
usada só na tag, na logo, no ícone do menu e no botão do pedido.
---
.../src/History/Queries/DelasOverview.php | 76 +++
app-modules/panel-app/lang/en/delas.php | 129 +++++
app-modules/panel-app/lang/pt_BR/delas.php | 129 +++++
app-modules/panel-app/resources/svg/delas.svg | 4 +
.../views/components/delas/callout.blade.php | 23 +
.../views/components/delas/logo.blade.php | 33 ++
.../views/components/delas/tag.blade.php | 15 +
.../components/profile-preview-card.blade.php | 6 +-
.../livewire/delas/profile-section.blade.php | 105 ++++
.../livewire/delas/request-modal.blade.php | 13 +
.../views/pages/delas/heading.blade.php | 6 +
.../views/pages/delas/moderation.blade.php | 17 +
.../resources/views/pages/profile.blade.php | 5 +-
.../Livewire/Delas/DelasProfileSection.php | 88 +++
.../src/Pages/Delas/DelasModerationPage.php | 543 ++++++++++++++++++
.../src/Pages/Delas/DelasStatsOverview.php | 67 +++
.../panel-app/src/Pages/ProfilePage.php | 17 +
.../panel-app/src/PanelAppServiceProvider.php | 12 +-
.../Feature/Delas/DelasModerationPageTest.php | 196 +++++++
.../Feature/Delas/DelasProfileSectionTest.php | 69 +++
app/Providers/Filament/AppPanelProvider.php | 3 +
resources/css/filament/app/theme.css | 15 +
22 files changed, 1568 insertions(+), 3 deletions(-)
create mode 100644 app-modules/delas/src/History/Queries/DelasOverview.php
create mode 100644 app-modules/panel-app/lang/en/delas.php
create mode 100644 app-modules/panel-app/lang/pt_BR/delas.php
create mode 100644 app-modules/panel-app/resources/svg/delas.svg
create mode 100644 app-modules/panel-app/resources/views/components/delas/callout.blade.php
create mode 100644 app-modules/panel-app/resources/views/components/delas/logo.blade.php
create mode 100644 app-modules/panel-app/resources/views/components/delas/tag.blade.php
create mode 100644 app-modules/panel-app/resources/views/livewire/delas/profile-section.blade.php
create mode 100644 app-modules/panel-app/resources/views/livewire/delas/request-modal.blade.php
create mode 100644 app-modules/panel-app/resources/views/pages/delas/heading.blade.php
create mode 100644 app-modules/panel-app/resources/views/pages/delas/moderation.blade.php
create mode 100644 app-modules/panel-app/src/Livewire/Delas/DelasProfileSection.php
create mode 100644 app-modules/panel-app/src/Pages/Delas/DelasModerationPage.php
create mode 100644 app-modules/panel-app/src/Pages/Delas/DelasStatsOverview.php
create mode 100644 app-modules/panel-app/tests/Feature/Delas/DelasModerationPageTest.php
create mode 100644 app-modules/panel-app/tests/Feature/Delas/DelasProfileSectionTest.php
diff --git a/app-modules/delas/src/History/Queries/DelasOverview.php b/app-modules/delas/src/History/Queries/DelasOverview.php
new file mode 100644
index 000000000..c8cdfbd47
--- /dev/null
+++ b/app-modules/delas/src/History/Queries/DelasOverview.php
@@ -0,0 +1,76 @@
+pending()->count();
+ }
+
+ public function oldestPendingAt(): ?CarbonInterface
+ {
+ $oldest = DelasTagRequest::query()->pending()->min('requested_at');
+
+ return $oldest === null ? null : CarbonImmutable::parse($oldest);
+ }
+
+ public function membersCount(): int
+ {
+ return DelasTagRequest::query()->where('status', DelasRequestStatus::Approved)->count();
+ }
+
+ /**
+ * Horas, em média, entre o pedido e a decisão da moderação (aprovar ou
+ * rejeitar) nos últimos dias. Concessões diretas não entram: não houve
+ * espera.
+ */
+ public function averageDecisionHours(int $days = 90): ?float
+ {
+ $seconds = DelasTransition::query()
+ ->join('delas_tag_requests', 'delas_tag_requests.id', '=', 'delas_transitions.request_id')
+ ->whereIn('delas_transitions.action', [DelasAction::Approved, DelasAction::Rejected])
+ ->where('delas_transitions.created_at', '>=', now()->subDays($days))
+ ->selectRaw('avg(extract(epoch from (delas_transitions.created_at - delas_tag_requests.requested_at))) as seconds')
+ ->value('seconds');
+
+ return $seconds === null ? null : (float) $seconds / 3_600;
+ }
+
+ /**
+ * @return array{approved: int, rejected: int}
+ */
+ public function decisionsSince(CarbonInterface $since): array
+ {
+ $counts = DelasTransition::query()
+ ->where('created_at', '>=', $since)
+ ->whereIn('action', [DelasAction::Approved, DelasAction::Granted, DelasAction::Rejected])
+ ->selectRaw('action, count(*) as total')
+ ->groupBy('action')
+ ->pluck('total', 'action');
+
+ return [
+ 'approved' => (int) ($counts[DelasAction::Approved->value] ?? 0) + (int) ($counts[DelasAction::Granted->value] ?? 0),
+ 'rejected' => (int) ($counts[DelasAction::Rejected->value] ?? 0),
+ ];
+ }
+
+ public function activeBlocksCount(): int
+ {
+ return DelasRequesterBlock::query()->active()->count();
+ }
+}
diff --git a/app-modules/panel-app/lang/en/delas.php b/app-modules/panel-app/lang/en/delas.php
new file mode 100644
index 000000000..32290e46c
--- /dev/null
+++ b/app-modules/panel-app/lang/en/delas.php
@@ -0,0 +1,129 @@
+ 'He4rt Delas',
+ 'profile' => [
+ 'intro' => 'He4rt Delas is the community initiative for women and people who identify as women.',
+ 'toggle' => 'I want to join He4rt Delas',
+ 'toggle_hint' => 'When you turn it on, we explain how it works before sending the request. Nothing is sent without your confirmation.',
+ 'pending_title' => 'He4rt Delas membership awaiting approval',
+ 'pending_body' => 'Request sent on :date. A He4rt Delas moderator will review it. Follow the status here.',
+ 'member_title' => 'You are part of He4rt Delas',
+ 'member_body' => 'The tag already shows on your profile card. For now, only you and the moderators can see it.',
+ 'cooldown_title' => 'You cannot request again yet',
+ 'cooldown_body' => 'You can request again on :date.',
+ 'blocked_title' => 'It is not possible to request the He4rt Delas tag right now.',
+ 'modal' => [
+ 'heading' => 'Request the He4rt Delas tag',
+ 'what' => 'He4rt Delas is the He4rt community initiative for women and people who identify as women: a space for exchange, support and visibility.',
+ 'steps' => [
+ 'A He4rt Delas moderator will review your request.',
+ 'Meanwhile, your profile shows the request as awaiting approval.',
+ 'Once approved, the tag shows on your profile card. For now, only you and the moderators can see it.',
+ ],
+ 'submit' => 'Send request',
+ 'cancel' => 'Not now',
+ ],
+ 'sent' => 'Request sent',
+ 'sent_body' => 'We will show the result here on your profile.',
+ ],
+ 'moderation' => [
+ 'heading' => 'Moderation',
+ 'title' => 'He4rt Delas moderation',
+ 'navigation' => 'He4rt Delas',
+ 'subtitle' => 'Review He4rt Delas tag requests. Every decision records who decided, when and why.',
+ 'tabs' => [
+ 'pending' => 'Pending',
+ 'blocks' => 'Blocks',
+ 'history' => 'History',
+ 'history_full' => 'Full history',
+ 'team' => 'Moderators',
+ ],
+ 'columns' => [
+ 'requester' => 'Requester',
+ 'person' => 'Person',
+ 'requested_at' => 'Requested at',
+ 'blocked_by' => 'Blocked by',
+ 'blocked_at' => 'Blocked at',
+ 'reason' => 'Reason (internal)',
+ 'date' => 'Date',
+ 'action' => 'Action',
+ 'actor' => 'Done by',
+ 'role' => 'Role',
+ 'decisions' => 'Decisions',
+ ],
+ 'empty' => [
+ 'pending' => 'No pending requests',
+ 'pending_body' => 'When someone requests the He4rt Delas tag, it shows up here.',
+ 'blocks' => 'No active blocks',
+ 'blocks_body' => 'People blocked from requesting the tag show up here.',
+ 'history' => 'Nothing in the history',
+ 'history_body' => 'Decisions about the tag show up here.',
+ 'team' => 'No moderators',
+ 'team_body' => 'Without moderators, only leads and super admins review the queue.',
+ ],
+ 'block_note' => 'A block only prevents new tag requests. It is not a ban or suspension and does not affect the account.',
+ 'reason_hint' => 'Internal: the person does not see this reason.',
+ 'history_hint' => 'Recorded in the history.',
+ 'actions' => [
+ 'approve' => 'Approve',
+ 'approve_heading' => 'Approve :name?',
+ 'approve_body' => "The He4rt Delas tag will show on @:username's profile.",
+ 'approved' => 'Request approved',
+ 'reject' => 'Reject',
+ 'reject_heading' => "Reject :name's request?",
+ 'reject_body' => ':name can request again from :date.',
+ 'reject_reason' => 'Rejection reason',
+ 'rejected' => 'Request rejected',
+ 'block' => 'Block',
+ 'block_heading' => 'Block :name from requesting the tag?',
+ 'block_body' => 'This only blocks requesting the He4rt Delas tag. It is not a ban or suspension and does not affect the account. The pending request will be rejected.',
+ 'block_reason' => 'Block reason',
+ 'block_disabled' => 'Moderators, leads, admins and yourself cannot be blocked.',
+ 'blocked' => 'Person blocked',
+ 'unblock' => 'Unblock',
+ 'unblock_heading' => 'Unblock :name?',
+ 'unblock_body' => 'The person can request the tag again, respecting the cooldown after a recent decision.',
+ 'unblock_reason' => 'Unblock reason',
+ 'unblock_disabled' => 'Only whoever created the block or a lead can lift it.',
+ 'unblocked' => 'Block lifted',
+ 'grant' => 'Grant tag',
+ 'grant_heading' => 'Grant the He4rt Delas tag',
+ 'grant_body' => 'A pending request gets approved; without one, an approved request is created. The cooldown is ignored. If the person is blocked, the reason is required and the block is lifted.',
+ 'grant_reason' => 'Reason',
+ 'granted' => 'Tag granted',
+ 'revoke' => 'Remove tag',
+ 'revoke_heading' => 'Remove the He4rt Delas tag',
+ 'revoke_body' => 'The record is kept. The person can request again after the cooldown.',
+ 'revoke_reason' => 'Removal reason',
+ 'revoked' => 'Tag removed',
+ 'person' => 'Person',
+ 'person_hint' => 'Search by name or @username.',
+ 'add_moderator' => 'Add moderator',
+ 'add_moderator_heading' => 'Add a He4rt Delas moderator',
+ 'add_moderator_body' => 'The person will see this page and decide requests. Leads are assigned by super admins in /admin.',
+ 'moderator_added' => 'Moderator added',
+ 'remove_moderator' => 'Revoke moderator',
+ 'remove_moderator_heading' => "Revoke :name's role?",
+ 'remove_moderator_body' => ':name loses access to this page on the next request. Their decisions stay in the history.',
+ 'moderator_removed' => 'Role revoked',
+ 'lead_only' => 'Leads are assigned by super admins in /admin.',
+ ],
+ 'stats' => [
+ 'pending' => 'Pending now',
+ 'pending_oldest' => 'oldest :when',
+ 'pending_none' => 'queue up to date',
+ 'members' => 'Members with the tag',
+ 'members_desc' => 'approved and granted',
+ 'avg_decision' => 'Average time to decision',
+ 'avg_decision_desc' => 'in the last 90 days',
+ 'month' => 'Decisions this month',
+ 'month_desc' => 'approved / rejected',
+ 'blocks' => 'Active blocks',
+ 'days' => ':value days',
+ 'blocks_desc' => 'only prevent new requests',
+ ],
+ ],
+];
diff --git a/app-modules/panel-app/lang/pt_BR/delas.php b/app-modules/panel-app/lang/pt_BR/delas.php
new file mode 100644
index 000000000..85273636a
--- /dev/null
+++ b/app-modules/panel-app/lang/pt_BR/delas.php
@@ -0,0 +1,129 @@
+ 'He4rt Delas',
+ 'profile' => [
+ 'intro' => 'A He4rt Delas é a iniciativa da comunidade para mulheres e pessoas que se identificam como mulheres.',
+ 'toggle' => 'Quero fazer parte da He4rt Delas',
+ 'toggle_hint' => 'Ao ativar, explicamos como funciona antes de enviar o pedido. Nada é enviado sem a sua confirmação.',
+ 'pending_title' => 'Inclusão no He4rt Delas aguardando aprovação',
+ 'pending_body' => 'Pedido enviado em :date. Uma moderadora da He4rt Delas vai analisar. Acompanhe o status por aqui.',
+ 'member_title' => 'Você faz parte da He4rt Delas',
+ 'member_body' => 'A tag já aparece no seu cartão de perfil. Por enquanto, só você e a moderação conseguem vê-la.',
+ 'cooldown_title' => 'Ainda não é possível pedir de novo',
+ 'cooldown_body' => 'Você poderá solicitar novamente em :date.',
+ 'blocked_title' => 'No momento, não é possível solicitar a tag He4rt Delas.',
+ 'modal' => [
+ 'heading' => 'Solicitar a tag He4rt Delas',
+ 'what' => 'A He4rt Delas é a iniciativa da comunidade He4rt para mulheres e pessoas que se identificam como mulheres: um espaço de troca, apoio e visibilidade.',
+ 'steps' => [
+ 'Uma moderadora da He4rt Delas vai analisar o seu pedido.',
+ 'Enquanto isso, seu perfil mostra o pedido como aguardando aprovação.',
+ 'Quando aprovado, a tag aparece no seu cartão de perfil. Hoje, só você e a moderação conseguem vê-la.',
+ ],
+ 'submit' => 'Enviar solicitação',
+ 'cancel' => 'Agora não',
+ ],
+ 'sent' => 'Solicitação enviada',
+ 'sent_body' => 'Avisaremos o resultado aqui no seu perfil.',
+ ],
+ 'moderation' => [
+ 'heading' => 'Moderação',
+ 'title' => 'Moderação He4rt Delas',
+ 'navigation' => 'He4rt Delas',
+ 'subtitle' => 'Analise os pedidos da tag He4rt Delas. Toda decisão fica registrada com quem decidiu, quando e o motivo.',
+ 'tabs' => [
+ 'pending' => 'Pendentes',
+ 'blocks' => 'Bloqueios',
+ 'history' => 'Histórico',
+ 'history_full' => 'Histórico completo',
+ 'team' => 'Moderadoras',
+ ],
+ 'columns' => [
+ 'requester' => 'Solicitante',
+ 'person' => 'Pessoa',
+ 'requested_at' => 'Pedido em',
+ 'blocked_by' => 'Bloqueada por',
+ 'blocked_at' => 'Bloqueada em',
+ 'reason' => 'Motivo (interno)',
+ 'date' => 'Data',
+ 'action' => 'Ação',
+ 'actor' => 'Quem fez',
+ 'role' => 'Papel',
+ 'decisions' => 'Decisões',
+ ],
+ 'empty' => [
+ 'pending' => 'Nenhuma solicitação pendente',
+ 'pending_body' => 'Quando alguém pedir a tag He4rt Delas, o pedido aparece aqui.',
+ 'blocks' => 'Nenhum bloqueio ativo',
+ 'blocks_body' => 'Pessoas bloqueadas de solicitar a tag aparecem aqui.',
+ 'history' => 'Nada no histórico',
+ 'history_body' => 'As decisões sobre a tag aparecem aqui.',
+ 'team' => 'Nenhuma moderadora',
+ 'team_body' => 'Sem moderadoras, só líderes e super admins analisam a fila.',
+ ],
+ 'block_note' => 'O bloqueio impede apenas novos pedidos da tag. Não é banimento nem suspensão e não afeta a conta da pessoa.',
+ 'reason_hint' => 'Uso interno: a pessoa não vê este motivo.',
+ 'history_hint' => 'Fica registrado no histórico.',
+ 'actions' => [
+ 'approve' => 'Aprovar',
+ 'approve_heading' => 'Aprovar :name?',
+ 'approve_body' => 'A tag He4rt Delas passa a aparecer no perfil de @:username.',
+ 'approved' => 'Solicitação aprovada',
+ 'reject' => 'Rejeitar',
+ 'reject_heading' => 'Rejeitar a solicitação de :name?',
+ 'reject_body' => ':name poderá pedir de novo a partir de :date.',
+ 'reject_reason' => 'Motivo da rejeição',
+ 'rejected' => 'Solicitação rejeitada',
+ 'block' => 'Bloquear',
+ 'block_heading' => 'Bloquear :name de solicitar a tag?',
+ 'block_body' => 'Isso bloqueia só o pedido da tag He4rt Delas. Não é banimento nem suspensão e não afeta a conta. A solicitação pendente será rejeitada.',
+ 'block_reason' => 'Motivo do bloqueio',
+ 'block_disabled' => 'Não é possível bloquear moderadoras, líderes, admins ou a si mesma.',
+ 'blocked' => 'Pessoa bloqueada',
+ 'unblock' => 'Desbloquear',
+ 'unblock_heading' => 'Desbloquear :name?',
+ 'unblock_body' => 'A pessoa volta a poder solicitar a tag, respeitando a espera se houver uma decisão recente.',
+ 'unblock_reason' => 'Motivo do desbloqueio',
+ 'unblock_disabled' => 'Só quem fez o bloqueio ou uma líder pode desfazer.',
+ 'unblocked' => 'Bloqueio encerrado',
+ 'grant' => 'Conceder tag',
+ 'grant_heading' => 'Conceder a tag He4rt Delas',
+ 'grant_body' => 'Com solicitação pendente, ela é aprovada; sem solicitação, é criada uma já aprovada. A espera é ignorada. Se a pessoa estiver bloqueada, o motivo é obrigatório e o bloqueio é encerrado.',
+ 'grant_reason' => 'Motivo',
+ 'granted' => 'Tag concedida',
+ 'revoke' => 'Remover tag',
+ 'revoke_heading' => 'Remover a tag He4rt Delas',
+ 'revoke_body' => 'O registro não é apagado. A pessoa poderá solicitar de novo depois da espera.',
+ 'revoke_reason' => 'Motivo da remoção',
+ 'revoked' => 'Tag removida',
+ 'person' => 'Pessoa',
+ 'person_hint' => 'Busque por nome ou @username.',
+ 'add_moderator' => 'Adicionar moderadora',
+ 'add_moderator_heading' => 'Adicionar moderadora He4rt Delas',
+ 'add_moderator_body' => 'A pessoa passa a ver esta página e a decidir pedidos. Líderes são atribuídas por super admins no /admin.',
+ 'moderator_added' => 'Moderadora adicionada',
+ 'remove_moderator' => 'Revogar moderadora',
+ 'remove_moderator_heading' => 'Revogar o papel de :name?',
+ 'remove_moderator_body' => ':name perde o acesso a esta página na próxima requisição. As decisões dela continuam no histórico.',
+ 'moderator_removed' => 'Papel revogado',
+ 'lead_only' => 'Líderes são atribuídas por super admins no /admin.',
+ ],
+ 'stats' => [
+ 'pending' => 'Pendentes agora',
+ 'pending_oldest' => 'mais antiga :when',
+ 'pending_none' => 'fila em dia',
+ 'members' => 'Membras com a tag',
+ 'members_desc' => 'aprovadas e concedidas',
+ 'avg_decision' => 'Tempo médio até a decisão',
+ 'avg_decision_desc' => 'nos últimos 90 dias',
+ 'month' => 'Decisões no mês',
+ 'month_desc' => 'aprovadas / rejeitadas',
+ 'blocks' => 'Bloqueios ativos',
+ 'days' => ':value dias',
+ 'blocks_desc' => 'só impedem novos pedidos',
+ ],
+ ],
+];
diff --git a/app-modules/panel-app/resources/svg/delas.svg b/app-modules/panel-app/resources/svg/delas.svg
new file mode 100644
index 000000000..f27b8914c
--- /dev/null
+++ b/app-modules/panel-app/resources/svg/delas.svg
@@ -0,0 +1,4 @@
+
diff --git a/app-modules/panel-app/resources/views/components/delas/callout.blade.php b/app-modules/panel-app/resources/views/components/delas/callout.blade.php
new file mode 100644
index 000000000..e890f9936
--- /dev/null
+++ b/app-modules/panel-app/resources/views/components/delas/callout.blade.php
@@ -0,0 +1,23 @@
+@props(['tone' => 'gray', 'icon' => 'heroicon-o-information-circle'])
+
+@php
+ $classes = match ($tone) {
+ 'warning' => ['border-amber-300/60 bg-amber-50 dark:border-amber-400/20 dark:bg-amber-400/5', 'text-amber-600 dark:text-amber-400', 'text-amber-900 dark:text-amber-200', 'text-amber-800 dark:text-amber-200/80'],
+ 'success' => ['border-green-300/60 bg-green-50 dark:border-green-400/20 dark:bg-green-400/5', 'text-green-600 dark:text-green-400', 'text-green-900 dark:text-green-200', 'text-green-800 dark:text-green-200/80'],
+ 'info' => ['border-sky-300/60 bg-sky-50 dark:border-sky-400/20 dark:bg-sky-400/5', 'text-sky-600 dark:text-sky-400', 'text-sky-900 dark:text-sky-200', 'text-sky-800 dark:text-sky-200/80'],
+ default => ['border-gray-200 bg-gray-50 dark:border-white/10 dark:bg-white/5', 'text-gray-500 dark:text-gray-400', 'text-gray-900 dark:text-gray-100', 'text-gray-600 dark:text-gray-400'],
+ };
+@endphp
+
+
diff --git a/app-modules/panel-app/resources/views/pages/delas/heading.blade.php b/app-modules/panel-app/resources/views/pages/delas/heading.blade.php
index 68c06e93a..9c4b1b70b 100644
--- a/app-modules/panel-app/resources/views/pages/delas/heading.blade.php
+++ b/app-modules/panel-app/resources/views/pages/delas/heading.blade.php
@@ -1,5 +1,5 @@
-
+
{{ __('panel-app::delas.moderation.heading') }}
diff --git a/app-modules/panel-app/src/PanelAppServiceProvider.php b/app-modules/panel-app/src/PanelAppServiceProvider.php
index fc2339a5e..1ae329671 100644
--- a/app-modules/panel-app/src/PanelAppServiceProvider.php
+++ b/app-modules/panel-app/src/PanelAppServiceProvider.php
@@ -4,7 +4,6 @@
namespace He4rt\PanelApp;
-use BladeUI\Icons\Factory as IconFactory;
use Filament\Support\Assets\Js;
use Filament\Support\Facades\FilamentAsset;
use He4rt\PanelApp\Livewire\Delas\DelasProfileSection;
@@ -22,14 +21,6 @@
class PanelAppServiceProvider extends ServiceProvider
{
- public function register(): void
- {
- // Ícone oficial da He4rt Delas como `he4rt-delas` (cor da marca no próprio SVG).
- $this->callAfterResolving(IconFactory::class, function (IconFactory $factory): void {
- $factory->add('he4rt', ['path' => __DIR__.'/../resources/svg', 'prefix' => 'he4rt']);
- });
- }
-
public function boot(): void
{
$this->loadViewsFrom(__DIR__.'/../resources/views', 'panel-app');
diff --git a/resources/css/filament/admin/theme.css b/resources/css/filament/admin/theme.css
index 40308c886..49567d90c 100644
--- a/resources/css/filament/admin/theme.css
+++ b/resources/css/filament/admin/theme.css
@@ -7,6 +7,21 @@
@source '../../../../app-modules/**/resources/**/*';
@source '../../../../app-modules/**/src/**/*';
+/* Paleta da He4rt Delas (Figma da marca). Usada só nos pontos de marca (tag, logo e ícone) da moderação He4rt Delas no cluster de Moderação. */
+@theme {
+ --color-delas-primary: #f485a2;
+ --color-delas-50: #ffd1ee;
+ --color-delas-100: #ffbbd7;
+ --color-delas-200: #ffa4c1;
+ --color-delas-300: #ff8fab;
+ --color-delas-400: #e77996;
+ --color-delas-500: #cf6481;
+ --color-delas-600: #b84f6d;
+ --color-delas-700: #a03a5a;
+ --color-delas-800: #8a2447;
+ --color-delas-900: #730835;
+}
+
.fi-sidebar {
@apply bg-gray-100 dark:bg-gray-900;
}
From 0fed25498e76fc4a620e8298bebc59732beb4f8d Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 16:08:25 -0300
Subject: [PATCH 18/77] feat(delas): consulta DelasCandidates para os seletores
de pessoa
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Os escopos de conceder (quem não tem a tag), remover (só quem tem) e
adicionar moderadora (fora super admins, moderadoras e líderes) saem da
tela e viram consulta de domínio, com busca por nome ou @username. A
própria pessoa que age nunca aparece.
---
.../src/Team/Queries/DelasCandidates.php | 98 +++++++++++++++++++
.../Feature/Team/DelasCandidatesTest.php | 75 ++++++++++++++
2 files changed, 173 insertions(+)
create mode 100644 app-modules/delas/src/Team/Queries/DelasCandidates.php
create mode 100644 app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
diff --git a/app-modules/delas/src/Team/Queries/DelasCandidates.php b/app-modules/delas/src/Team/Queries/DelasCandidates.php
new file mode 100644
index 000000000..0d7457fe1
--- /dev/null
+++ b/app-modules/delas/src/Team/Queries/DelasCandidates.php
@@ -0,0 +1,98 @@
+
+ */
+ public function forGrant(User $actor): Builder
+ {
+ return $this->others($actor)->whereNotIn('id', $this->members());
+ }
+
+ /**
+ * Só quem tem a tag hoje. A lista é pequena, então o seletor pode
+ * pré-carregar.
+ *
+ * @return Builder
+ */
+ public function forRevoke(User $actor): Builder
+ {
+ return $this->others($actor)->whereIn('id', $this->members());
+ }
+
+ /**
+ * Quem pode virar moderadora: fora da equipe (moderadoras e líderes) e sem
+ * super admin.
+ *
+ * @return Builder
+ */
+ public function forModerator(User $actor): Builder
+ {
+ return $this->others($actor)->withoutRole([
+ UserRole::SuperAdmin->value,
+ UserRole::DelasModerator->value,
+ UserRole::DelasLead->value,
+ ]);
+ }
+
+ /**
+ * Busca por nome ou `@username` dentro de um dos escopos acima.
+ *
+ * @param Builder $candidates
+ * @return Collection
+ */
+ public function search(Builder $candidates, string $search, int $limit = self::SEARCH_LIMIT): Collection
+ {
+ $username = mb_ltrim(mb_trim($search), '@');
+
+ return $candidates
+ ->where(fn (Builder $query): Builder => $query
+ ->whereLike('name', '%'.mb_trim($search).'%')
+ ->orWhereLike('username', '%'.$username.'%'))
+ ->orderBy('name')
+ ->limit($limit)
+ ->get();
+ }
+
+ /**
+ * @return Builder
+ */
+ private function others(User $actor): Builder
+ {
+ return User::query()->whereKeyNot($actor->getKey());
+ }
+
+ /**
+ * Quem tem a tag hoje: a solicitação está `approved`.
+ *
+ * @return Builder
+ */
+ private function members(): Builder
+ {
+ return DelasTagRequest::query()->where('status', DelasRequestStatus::Approved)->select('user_id');
+ }
+}
diff --git a/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php b/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
new file mode 100644
index 000000000..65a4cca90
--- /dev/null
+++ b/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
@@ -0,0 +1,75 @@
+candidates = resolve(DelasCandidates::class);
+ $this->lead = User::factory()->delasLead()->create();
+});
+
+test('conceder: aparece quem não tem a tag, inclusive com pedido pendente ou rejeitado', function (): void {
+ $withoutRequest = User::factory()->create();
+ $pending = DelasTagRequest::factory()->pending()->create()->user;
+ $rejected = DelasTagRequest::factory()->rejected()->create()->user;
+ $member = DelasTagRequest::factory()->approved()->create()->user;
+
+ $ids = $this->candidates->forGrant($this->lead)->pluck('id')->all();
+
+ expect($ids)->toContain($withoutRequest->id, $pending->id, $rejected->id)
+ ->not->toContain($member->id);
+});
+
+test('remover: só aparece quem tem a tag', function (): void {
+ $member = DelasTagRequest::factory()->approved()->create()->user;
+ DelasTagRequest::factory()->revoked()->create();
+ DelasTagRequest::factory()->pending()->create();
+ User::factory()->create();
+
+ expect($this->candidates->forRevoke($this->lead)->pluck('id')->all())->toBe([$member->id]);
+});
+
+test('adicionar moderadora: fora quem é super admin, moderadora ou líder', function (): void {
+ $member = User::factory()->create();
+ $streamer = User::factory()->streamer()->create();
+ $superAdmin = User::factory()->superAdmin()->create();
+ $moderator = User::factory()->delasModerator()->create();
+ $otherLead = User::factory()->delasLead()->create();
+
+ $ids = $this->candidates->forModerator($this->lead)->pluck('id')->all();
+
+ expect($ids)->toContain($member->id, $streamer->id)
+ ->not->toContain($superAdmin->id, $moderator->id, $otherLead->id);
+});
+
+test('a própria pessoa que age nunca aparece', function (): void {
+ DelasTagRequest::factory()->for($this->lead)->approved()->create();
+ $actor = User::factory()->superAdmin()->create();
+
+ expect($this->candidates->forGrant($actor)->pluck('id'))->not->toContain($actor->id)
+ ->and($this->candidates->forRevoke($this->lead)->pluck('id'))->not->toContain($this->lead->id)
+ ->and($this->candidates->forModerator($this->lead)->pluck('id'))->not->toContain($this->lead->id)
+ ->and($this->candidates->forGrant($this->lead)->pluck('id'))->not->toContain($this->lead->id);
+});
+
+test('a busca acha por nome ou @username, dentro do escopo', function (): void {
+ $ana = User::factory()->create(['name' => 'Ana Souza', 'username' => 'anasouza']);
+ $bia = User::factory()->create(['name' => 'Beatriz Lima', 'username' => 'bialima']);
+ $member = User::factory()->create(['name' => 'Ana Membra', 'username' => 'anamembra']);
+ DelasTagRequest::factory()->for($member)->approved()->create();
+
+ $byName = $this->candidates->search($this->candidates->forGrant($this->lead), 'ana')->pluck('id')->all();
+ $byUsername = $this->candidates->search($this->candidates->forGrant($this->lead), '@bialima')->pluck('id')->all();
+
+ expect($byName)->toBe([$ana->id])
+ ->and($byUsername)->toBe([$bia->id]);
+});
+
+test('a busca respeita o limite', function (): void {
+ User::factory()->count(3)->create(['name' => 'Carla']);
+
+ expect($this->candidates->search($this->candidates->forGrant($this->lead), 'carla', limit: 2))->toHaveCount(2);
+});
From 48ec448d38c93e4d1b6e8792e361eca695f715b4 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 16:21:51 -0300
Subject: [PATCH 19/77] fix(delas): candidatas a moderadora sem depender do
withoutRole()
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
O withoutRole() do Spatie quebra com RoleDoesNotExist quando uma das roles
ainda não existe no banco (ex.: nenhum super admin criado). O filtro passa
a ser pelo nome da role direto na relação.
---
app-modules/delas/src/Team/Queries/DelasCandidates.php | 7 ++++---
1 file changed, 4 insertions(+), 3 deletions(-)
diff --git a/app-modules/delas/src/Team/Queries/DelasCandidates.php b/app-modules/delas/src/Team/Queries/DelasCandidates.php
index 0d7457fe1..6d33c344a 100644
--- a/app-modules/delas/src/Team/Queries/DelasCandidates.php
+++ b/app-modules/delas/src/Team/Queries/DelasCandidates.php
@@ -46,17 +46,18 @@ public function forRevoke(User $actor): Builder
/**
* Quem pode virar moderadora: fora da equipe (moderadoras e líderes) e sem
- * super admin.
+ * super admin. Filtra pelo nome da role direto, sem o `withoutRole()` do
+ * Spatie, que quebra quando uma das roles ainda não existe no banco.
*
* @return Builder
*/
public function forModerator(User $actor): Builder
{
- return $this->others($actor)->withoutRole([
+ return $this->others($actor)->whereDoesntHave('roles', fn (Builder $roles): Builder => $roles->whereIn('name', [
UserRole::SuperAdmin->value,
UserRole::DelasModerator->value,
UserRole::DelasLead->value,
- ]);
+ ]));
}
/**
From 8902ab0f053e2bae7a2a9f260c47b96cf231d4c6 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 16:22:05 -0300
Subject: [PATCH 20/77] =?UTF-8?q?feat(panel-admin):=20modera=C3=A7=C3=A3o?=
=?UTF-8?q?=20He4rt=20Delas=20no=20cluster=20de=20Modera=C3=A7=C3=A3o?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Uma página por aba no /admin/mod, no grupo He4rt Delas da subnavegação,
cada uma com o próprio gate e badge:
- Fila (moderate-delas, badge de pendentes): aprovar, rejeitar, bloquear.
- Bloqueios (moderate-delas, badge de ativos): desbloquear.
- Histórico (moderate-delas): completo e com filtro só para a líder.
- Equipe (lead-delas): números, conceder e remover a tag, adicionar e
revogar moderadora. Os seletores de pessoa usam DelasCandidates; o de
remover já vem carregado só com quem tem a tag.
Eager load explícito em cada tabela (user.roles na fila, user/blocker nos
bloqueios, user/actor no histórico), com os testes rodando sem eager load
automático e com lazy loading proibido. Teste de varredura: a moderadora
só acessa o Dashboard e as páginas da He4rt Delas.
---
app-modules/panel-admin/lang/en/delas.php | 118 ++++++
app-modules/panel-admin/lang/pt_BR/delas.php | 118 ++++++
.../views/moderation/delas/heading.blade.php | 6 +
.../Concerns/InteractsWithDelasModeration.php | 121 ++++++
.../Pages/Delas/DelasBlocksPage.php | 112 ++++++
.../Pages/Delas/DelasHistoryPage.php | 95 +++++
.../Moderation/Pages/Delas/DelasQueuePage.php | 137 +++++++
.../Moderation/Pages/Delas/DelasTeamPage.php | 232 ++++++++++++
.../Widgets/Delas/DelasStatsOverview.php | 67 ++++
.../AdminComponentAccessTest.php | 38 ++
.../Delas/DelasModerationPagesTest.php | 349 ++++++++++++++++++
11 files changed, 1393 insertions(+)
create mode 100644 app-modules/panel-admin/lang/en/delas.php
create mode 100644 app-modules/panel-admin/lang/pt_BR/delas.php
create mode 100644 app-modules/panel-admin/resources/views/moderation/delas/heading.blade.php
create mode 100644 app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
create mode 100644 app-modules/panel-admin/src/Moderation/Pages/Delas/DelasBlocksPage.php
create mode 100644 app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
create mode 100644 app-modules/panel-admin/src/Moderation/Pages/Delas/DelasQueuePage.php
create mode 100644 app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
create mode 100644 app-modules/panel-admin/src/Moderation/Widgets/Delas/DelasStatsOverview.php
create mode 100644 app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
diff --git a/app-modules/panel-admin/lang/en/delas.php b/app-modules/panel-admin/lang/en/delas.php
new file mode 100644
index 000000000..d8cf7c4ae
--- /dev/null
+++ b/app-modules/panel-admin/lang/en/delas.php
@@ -0,0 +1,118 @@
+ 'He4rt Delas',
+ 'navigation' => [
+ 'group' => 'He4rt Delas',
+ 'queue' => 'Queue',
+ 'blocks' => 'Blocks',
+ 'history' => 'History',
+ 'history_full' => 'Full history',
+ 'team' => 'Team',
+ ],
+ 'pages' => [
+ 'queue' => [
+ 'title' => 'He4rt Delas queue',
+ 'subtitle' => 'Review He4rt Delas tag requests. Every decision records who decided, when and why.',
+ ],
+ 'blocks' => [
+ 'title' => 'He4rt Delas blocks',
+ 'subtitle' => 'People blocked from requesting the He4rt Delas tag.',
+ ],
+ 'history' => [
+ 'title' => 'He4rt Delas history',
+ 'subtitle' => 'Decisions about the tag, with who did it, when and why.',
+ ],
+ 'team' => [
+ 'title' => 'He4rt Delas team',
+ 'subtitle' => 'He4rt Delas numbers, moderators and direct tag grants.',
+ ],
+ ],
+ 'columns' => [
+ 'requester' => 'Requester',
+ 'person' => 'Person',
+ 'requested_at' => 'Requested at',
+ 'blocked_by' => 'Blocked by',
+ 'blocked_at' => 'Blocked at',
+ 'reason' => 'Reason (internal)',
+ 'date' => 'Date',
+ 'action' => 'Action',
+ 'actor' => 'Done by',
+ 'role' => 'Role',
+ 'decisions' => 'Decisions',
+ ],
+ 'empty' => [
+ 'pending' => 'No pending requests',
+ 'pending_body' => 'When someone requests the He4rt Delas tag, it shows up here.',
+ 'blocks' => 'No active blocks',
+ 'blocks_body' => 'People blocked from requesting the tag show up here.',
+ 'history' => 'Nothing in the history',
+ 'history_body' => 'Decisions about the tag show up here.',
+ 'team' => 'No moderators',
+ 'team_body' => 'Without moderators, only leads and super admins review the queue.',
+ ],
+ 'block_note' => 'A block only prevents new tag requests. It is not a ban or suspension and does not affect the account.',
+ 'reason_hint' => 'Internal: the person does not see this reason.',
+ 'history_hint' => 'Recorded in the history.',
+ 'actions' => [
+ 'approve' => 'Approve',
+ 'approve_heading' => 'Approve :name?',
+ 'approve_body' => "The He4rt Delas tag will show on @:username's profile.",
+ 'approved' => 'Request approved',
+ 'reject' => 'Reject',
+ 'reject_heading' => "Reject :name's request?",
+ 'reject_body' => ':name can request again from :date.',
+ 'reject_reason' => 'Rejection reason',
+ 'rejected' => 'Request rejected',
+ 'block' => 'Block',
+ 'block_heading' => 'Block :name from requesting the tag?',
+ 'block_body' => 'This only blocks requesting the He4rt Delas tag. It is not a ban or suspension and does not affect the account. The pending request will be rejected.',
+ 'block_reason' => 'Block reason',
+ 'block_disabled' => 'Moderators, leads, admins and yourself cannot be blocked.',
+ 'blocked' => 'Person blocked',
+ 'unblock' => 'Unblock',
+ 'unblock_heading' => 'Unblock :name?',
+ 'unblock_body' => 'The person can request the tag again, respecting the cooldown after a recent decision.',
+ 'unblock_reason' => 'Unblock reason',
+ 'unblock_disabled' => 'Only whoever created the block or a lead can lift it.',
+ 'unblocked' => 'Block lifted',
+ 'grant' => 'Grant tag',
+ 'grant_heading' => 'Grant the He4rt Delas tag',
+ 'grant_body' => 'A pending request gets approved; without one, an approved request is created. The cooldown is ignored. If the person is blocked, the reason is required and the block is lifted.',
+ 'grant_reason' => 'Reason',
+ 'granted' => 'Tag granted',
+ 'revoke' => 'Remove tag',
+ 'revoke_heading' => 'Remove the He4rt Delas tag',
+ 'revoke_body' => 'The record is kept. The person can request again after the cooldown.',
+ 'revoke_reason' => 'Removal reason',
+ 'revoked' => 'Tag removed',
+ 'person' => 'Person',
+ 'person_hint' => 'Search by name or @username.',
+ 'member_hint' => 'Only people who have the tag today.',
+ 'add_moderator' => 'Add moderator',
+ 'add_moderator_heading' => 'Add a He4rt Delas moderator',
+ 'add_moderator_body' => 'The person will see the He4rt Delas queue, blocks and history and decide requests. Leads are assigned by super admins in the user form.',
+ 'moderator_added' => 'Moderator added',
+ 'remove_moderator' => 'Revoke moderator',
+ 'remove_moderator_heading' => "Revoke :name's role?",
+ 'remove_moderator_body' => ':name loses access to He4rt Delas moderation on the next request. Their decisions stay in the history.',
+ 'moderator_removed' => 'Role revoked',
+ 'lead_only' => 'Leads are assigned by super admins in the user form.',
+ ],
+ 'stats' => [
+ 'pending' => 'Pending now',
+ 'pending_oldest' => 'oldest :when',
+ 'pending_none' => 'queue up to date',
+ 'members' => 'Members with the tag',
+ 'members_desc' => 'approved and granted',
+ 'avg_decision' => 'Average time to decision',
+ 'avg_decision_desc' => 'in the last 90 days',
+ 'month' => 'Decisions this month',
+ 'month_desc' => 'approved / rejected',
+ 'blocks' => 'Active blocks',
+ 'days' => ':value days',
+ 'blocks_desc' => 'only prevent new requests',
+ ],
+];
diff --git a/app-modules/panel-admin/lang/pt_BR/delas.php b/app-modules/panel-admin/lang/pt_BR/delas.php
new file mode 100644
index 000000000..6ed2a2729
--- /dev/null
+++ b/app-modules/panel-admin/lang/pt_BR/delas.php
@@ -0,0 +1,118 @@
+ 'He4rt Delas',
+ 'navigation' => [
+ 'group' => 'He4rt Delas',
+ 'queue' => 'Fila',
+ 'blocks' => 'Bloqueios',
+ 'history' => 'Histórico',
+ 'history_full' => 'Histórico completo',
+ 'team' => 'Equipe',
+ ],
+ 'pages' => [
+ 'queue' => [
+ 'title' => 'Fila da He4rt Delas',
+ 'subtitle' => 'Analise os pedidos da tag He4rt Delas. Toda decisão fica registrada com quem decidiu, quando e o motivo.',
+ ],
+ 'blocks' => [
+ 'title' => 'Bloqueios da He4rt Delas',
+ 'subtitle' => 'Quem está bloqueada de solicitar a tag He4rt Delas.',
+ ],
+ 'history' => [
+ 'title' => 'Histórico da He4rt Delas',
+ 'subtitle' => 'As decisões sobre a tag, com quem fez, quando e o motivo.',
+ ],
+ 'team' => [
+ 'title' => 'Equipe da He4rt Delas',
+ 'subtitle' => 'Os números da He4rt Delas, as moderadoras e a concessão direta da tag.',
+ ],
+ ],
+ 'columns' => [
+ 'requester' => 'Solicitante',
+ 'person' => 'Pessoa',
+ 'requested_at' => 'Pedido em',
+ 'blocked_by' => 'Bloqueada por',
+ 'blocked_at' => 'Bloqueada em',
+ 'reason' => 'Motivo (interno)',
+ 'date' => 'Data',
+ 'action' => 'Ação',
+ 'actor' => 'Quem fez',
+ 'role' => 'Papel',
+ 'decisions' => 'Decisões',
+ ],
+ 'empty' => [
+ 'pending' => 'Nenhuma solicitação pendente',
+ 'pending_body' => 'Quando alguém pedir a tag He4rt Delas, o pedido aparece aqui.',
+ 'blocks' => 'Nenhum bloqueio ativo',
+ 'blocks_body' => 'Pessoas bloqueadas de solicitar a tag aparecem aqui.',
+ 'history' => 'Nada no histórico',
+ 'history_body' => 'As decisões sobre a tag aparecem aqui.',
+ 'team' => 'Nenhuma moderadora',
+ 'team_body' => 'Sem moderadoras, só líderes e super admins analisam a fila.',
+ ],
+ 'block_note' => 'O bloqueio impede apenas novos pedidos da tag. Não é banimento nem suspensão e não afeta a conta da pessoa.',
+ 'reason_hint' => 'Uso interno: a pessoa não vê este motivo.',
+ 'history_hint' => 'Fica registrado no histórico.',
+ 'actions' => [
+ 'approve' => 'Aprovar',
+ 'approve_heading' => 'Aprovar :name?',
+ 'approve_body' => 'A tag He4rt Delas passa a aparecer no perfil de @:username.',
+ 'approved' => 'Solicitação aprovada',
+ 'reject' => 'Rejeitar',
+ 'reject_heading' => 'Rejeitar a solicitação de :name?',
+ 'reject_body' => ':name poderá pedir de novo a partir de :date.',
+ 'reject_reason' => 'Motivo da rejeição',
+ 'rejected' => 'Solicitação rejeitada',
+ 'block' => 'Bloquear',
+ 'block_heading' => 'Bloquear :name de solicitar a tag?',
+ 'block_body' => 'Isso bloqueia só o pedido da tag He4rt Delas. Não é banimento nem suspensão e não afeta a conta. A solicitação pendente será rejeitada.',
+ 'block_reason' => 'Motivo do bloqueio',
+ 'block_disabled' => 'Não é possível bloquear moderadoras, líderes, admins ou a si mesma.',
+ 'blocked' => 'Pessoa bloqueada',
+ 'unblock' => 'Desbloquear',
+ 'unblock_heading' => 'Desbloquear :name?',
+ 'unblock_body' => 'A pessoa volta a poder solicitar a tag, respeitando a espera se houver uma decisão recente.',
+ 'unblock_reason' => 'Motivo do desbloqueio',
+ 'unblock_disabled' => 'Só quem fez o bloqueio ou uma líder pode desfazer.',
+ 'unblocked' => 'Bloqueio encerrado',
+ 'grant' => 'Conceder tag',
+ 'grant_heading' => 'Conceder a tag He4rt Delas',
+ 'grant_body' => 'Com solicitação pendente, ela é aprovada; sem solicitação, é criada uma já aprovada. A espera é ignorada. Se a pessoa estiver bloqueada, o motivo é obrigatório e o bloqueio é encerrado.',
+ 'grant_reason' => 'Motivo',
+ 'granted' => 'Tag concedida',
+ 'revoke' => 'Remover tag',
+ 'revoke_heading' => 'Remover a tag He4rt Delas',
+ 'revoke_body' => 'O registro não é apagado. A pessoa poderá solicitar de novo depois da espera.',
+ 'revoke_reason' => 'Motivo da remoção',
+ 'revoked' => 'Tag removida',
+ 'person' => 'Pessoa',
+ 'person_hint' => 'Busque por nome ou @username.',
+ 'member_hint' => 'Só aparece quem tem a tag hoje.',
+ 'add_moderator' => 'Adicionar moderadora',
+ 'add_moderator_heading' => 'Adicionar moderadora He4rt Delas',
+ 'add_moderator_body' => 'A pessoa passa a ver a fila, os bloqueios e o histórico da He4rt Delas e a decidir pedidos. Líderes são atribuídas por super admins, no cadastro de usuários.',
+ 'moderator_added' => 'Moderadora adicionada',
+ 'remove_moderator' => 'Revogar moderadora',
+ 'remove_moderator_heading' => 'Revogar o papel de :name?',
+ 'remove_moderator_body' => ':name perde o acesso à moderação He4rt Delas na próxima requisição. As decisões dela continuam no histórico.',
+ 'moderator_removed' => 'Papel revogado',
+ 'lead_only' => 'Líderes são atribuídas por super admins, no cadastro de usuários.',
+ ],
+ 'stats' => [
+ 'pending' => 'Pendentes agora',
+ 'pending_oldest' => 'mais antiga :when',
+ 'pending_none' => 'fila em dia',
+ 'members' => 'Membras com a tag',
+ 'members_desc' => 'aprovadas e concedidas',
+ 'avg_decision' => 'Tempo médio até a decisão',
+ 'avg_decision_desc' => 'nos últimos 90 dias',
+ 'month' => 'Decisões no mês',
+ 'month_desc' => 'aprovadas / rejeitadas',
+ 'blocks' => 'Bloqueios ativos',
+ 'days' => ':value dias',
+ 'blocks_desc' => 'só impedem novos pedidos',
+ ],
+];
diff --git a/app-modules/panel-admin/resources/views/moderation/delas/heading.blade.php b/app-modules/panel-admin/resources/views/moderation/delas/heading.blade.php
new file mode 100644
index 000000000..d86b879be
--- /dev/null
+++ b/app-modules/panel-admin/resources/views/moderation/delas/heading.blade.php
@@ -0,0 +1,6 @@
+
+
+
+ {{ $label }}
+
+
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
new file mode 100644
index 000000000..9e96a36ea
--- /dev/null
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
@@ -0,0 +1,121 @@
+ static::getNavigationLabel(),
+ ])->render());
+ }
+
+ public function content(Schema $schema): Schema
+ {
+ return $schema->components([EmbeddedTable::make()]);
+ }
+
+ protected function isLead(): bool
+ {
+ return $this->actor()->can('lead-delas');
+ }
+
+ protected function personColumn(string $name, string $username, string $label): TextColumn
+ {
+ return TextColumn::make($name)
+ ->label($label)
+ ->weight('medium')
+ ->description(fn (mixed $record): string => '@'.data_get($record, $username))
+ ->searchable([str_contains($name, '.') ? 'name' : $name]);
+ }
+
+ protected function dateColumn(string $name, string $label): TextColumn
+ {
+ return TextColumn::make($name)
+ ->label($label)
+ ->dateTime('d/m/Y H:i')
+ ->timezone(config('app.display_timezone'))
+ ->sortable();
+ }
+
+ protected function reasonField(string $label, bool $required = true, ?string $hint = null): Textarea
+ {
+ return Textarea::make('reason')
+ ->label($label)
+ ->required($required)
+ ->maxLength(Reason::MAX_LENGTH)
+ ->rows(3)
+ ->helperText($hint ?? __('panel-admin::delas.reason_hint'));
+ }
+
+ /**
+ * Roda uma action de domínio e transforma recusas em notificação, sem
+ * derrubar a página.
+ */
+ protected function attempt(Closure $operation, string $successTitle): bool
+ {
+ try {
+ $operation();
+ } catch (DelasException|AuthorizationException $exception) {
+ Notification::make()->danger()->title($exception->getMessage())->send();
+
+ return false;
+ }
+
+ Notification::make()->success()->title($successTitle)->send();
+
+ return true;
+ }
+
+ /**
+ * @param array $data
+ */
+ protected function reasonFrom(array $data): ?string
+ {
+ $reason = $data['reason'] ?? null;
+
+ return is_string($reason) ? $reason : null;
+ }
+
+ protected function text(string $key): string
+ {
+ $text = __($key);
+
+ return is_string($text) ? $text : $key;
+ }
+
+ protected function actor(): User
+ {
+ $user = auth()->user();
+
+ abort_unless($user instanceof User, 403);
+
+ return $user;
+ }
+}
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasBlocksPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasBlocksPage.php
new file mode 100644
index 000000000..bbda8db93
--- /dev/null
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasBlocksPage.php
@@ -0,0 +1,112 @@
+user()?->can('moderate-delas') ?? false;
+ }
+
+ public static function getNavigationLabel(): string
+ {
+ return __('panel-admin::delas.navigation.blocks');
+ }
+
+ public static function getNavigationBadge(): ?string
+ {
+ $active = DelasRequesterBlock::query()->active()->count();
+
+ return $active > 0 ? (string) $active : null;
+ }
+
+ public static function getNavigationBadgeColor(): string
+ {
+ return 'gray';
+ }
+
+ public function getTitle(): string
+ {
+ return __('panel-admin::delas.pages.blocks.title');
+ }
+
+ public function getSubheading(): string
+ {
+ return __('panel-admin::delas.pages.blocks.subtitle');
+ }
+
+ public function table(Table $table): Table
+ {
+ return $table
+ ->query(DelasRequesterBlock::query()->active()->with(['user', 'blocker']))
+ ->defaultSort('blocked_at', 'desc')
+ ->emptyStateHeading(__('panel-admin::delas.empty.blocks'))
+ ->emptyStateDescription(__('panel-admin::delas.empty.blocks_body'))
+ ->emptyStateIcon(Heroicon::OutlinedLockOpen)
+ ->description(__('panel-admin::delas.block_note'))
+ ->columns([
+ $this->personColumn('user.name', 'user.username', __('panel-admin::delas.columns.person')),
+ TextColumn::make('blocker.name')
+ ->label(__('panel-admin::delas.columns.blocked_by'))
+ ->description(fn (DelasRequesterBlock $record): string => $record->blocked_at->timezone(config('app.display_timezone'))->format('d/m/Y H:i')),
+ TextColumn::make('reason')
+ ->label(__('panel-admin::delas.columns.reason'))
+ ->wrap()
+ ->lineClamp(2),
+ ])
+ ->recordActions([
+ Action::make('unblock')
+ ->label(__('panel-admin::delas.actions.unblock'))
+ ->icon(Heroicon::OutlinedLockOpen)
+ ->color('gray')
+ ->button()
+ ->size('sm')
+ ->disabled(fn (DelasRequesterBlock $record): bool => !$this->canUnblock($record))
+ ->tooltip(fn (DelasRequesterBlock $record): ?string => $this->canUnblock($record) ? null : $this->text('panel-admin::delas.actions.unblock_disabled'))
+ ->modalHeading(fn (DelasRequesterBlock $record): string => __('panel-admin::delas.actions.unblock_heading', ['name' => $record->user->name]))
+ ->modalDescription(__('panel-admin::delas.actions.unblock_body'))
+ ->modalSubmitActionLabel(__('panel-admin::delas.actions.unblock'))
+ ->schema([$this->reasonField(__('panel-admin::delas.actions.unblock_reason'), hint: __('panel-admin::delas.history_hint'))])
+ ->action(fn (DelasRequesterBlock $record, array $data): bool => $this->attempt(
+ fn () => resolve(UnblockDelasRequester::class)->handle($record, $this->actor(), $this->reasonFrom($data)),
+ __('panel-admin::delas.actions.unblocked'),
+ )),
+ ]);
+ }
+
+ private function canUnblock(DelasRequesterBlock $block): bool
+ {
+ return $block->blocked_by === $this->actor()->getKey() || $this->isLead();
+ }
+}
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
new file mode 100644
index 000000000..26163c85f
--- /dev/null
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
@@ -0,0 +1,95 @@
+user()?->can('moderate-delas') ?? false;
+ }
+
+ public static function getNavigationLabel(): string
+ {
+ return auth()->user()?->can('lead-delas')
+ ? __('panel-admin::delas.navigation.history_full')
+ : __('panel-admin::delas.navigation.history');
+ }
+
+ public function getTitle(): string
+ {
+ return __('panel-admin::delas.pages.history.title');
+ }
+
+ public function getSubheading(): string
+ {
+ return __('panel-admin::delas.pages.history.subtitle');
+ }
+
+ public function table(Table $table): Table
+ {
+ $query = DelasTransition::query()->with(['user', 'actor']);
+
+ if (!$this->isLead()) {
+ $query->where('action', '!=', DelasAction::Requested);
+ }
+
+ return $table
+ ->query($query)
+ ->defaultSort('created_at', 'desc')
+ ->emptyStateHeading(__('panel-admin::delas.empty.history'))
+ ->emptyStateDescription(__('panel-admin::delas.empty.history_body'))
+ ->emptyStateIcon(Heroicon::OutlinedClock)
+ ->columns([
+ $this->dateColumn('created_at', __('panel-admin::delas.columns.date')),
+ TextColumn::make('action')
+ ->label(__('panel-admin::delas.columns.action'))
+ ->badge(),
+ $this->personColumn('user.name', 'user.username', __('panel-admin::delas.columns.person')),
+ TextColumn::make('actor.name')
+ ->label(__('panel-admin::delas.columns.actor'))
+ ->description(fn (DelasTransition $record): string => $record->triggered_by->getLabel())
+ ->placeholder('—'),
+ TextColumn::make('reason')
+ ->label(__('panel-admin::delas.columns.reason'))
+ ->wrap()
+ ->lineClamp(2)
+ ->placeholder('—'),
+ ])
+ ->filters($this->isLead() ? [
+ SelectFilter::make('action')
+ ->label(__('panel-admin::delas.columns.action'))
+ ->options(DelasAction::class),
+ ] : []);
+ }
+}
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasQueuePage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasQueuePage.php
new file mode 100644
index 000000000..1345ac3d4
--- /dev/null
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasQueuePage.php
@@ -0,0 +1,137 @@
+user()?->can('moderate-delas') ?? false;
+ }
+
+ public static function getNavigationLabel(): string
+ {
+ return __('panel-admin::delas.navigation.queue');
+ }
+
+ public static function getNavigationBadge(): ?string
+ {
+ $pending = DelasTagRequest::query()->pending()->count();
+
+ return $pending > 0 ? (string) $pending : null;
+ }
+
+ public function getTitle(): string
+ {
+ return __('panel-admin::delas.pages.queue.title');
+ }
+
+ public function getSubheading(): string
+ {
+ return __('panel-admin::delas.pages.queue.subtitle');
+ }
+
+ public function table(Table $table): Table
+ {
+ return $table
+ // `user.roles`: o botão de bloquear checa o gate da pessoa em cada linha.
+ ->query(DelasTagRequest::query()->pending()->with('user.roles'))
+ ->defaultSort('requested_at', 'desc')
+ ->emptyStateHeading(__('panel-admin::delas.empty.pending'))
+ ->emptyStateDescription(__('panel-admin::delas.empty.pending_body'))
+ ->emptyStateIcon(Heroicon::OutlinedInboxStack)
+ ->columns([
+ $this->personColumn('user.name', 'user.username', __('panel-admin::delas.columns.requester')),
+ $this->dateColumn('requested_at', __('panel-admin::delas.columns.requested_at')),
+ ])
+ ->recordActions([
+ Action::make('approve')
+ ->label(__('panel-admin::delas.actions.approve'))
+ ->icon(Heroicon::OutlinedCheck)
+ ->color('success')
+ ->button()
+ ->size('sm')
+ ->requiresConfirmation()
+ ->modalHeading(fn (DelasTagRequest $record): string => __('panel-admin::delas.actions.approve_heading', ['name' => $record->user->name]))
+ ->modalDescription(fn (DelasTagRequest $record): string => __('panel-admin::delas.actions.approve_body', ['username' => $record->user->username]))
+ ->action(fn (DelasTagRequest $record): bool => $this->attempt(
+ fn () => resolve(ApproveDelasRequest::class)->handle($record, $this->actor()),
+ __('panel-admin::delas.actions.approved'),
+ )),
+ Action::make('reject')
+ ->label(__('panel-admin::delas.actions.reject'))
+ ->icon(Heroicon::OutlinedXMark)
+ ->color('danger')
+ ->button()
+ ->outlined()
+ ->size('sm')
+ ->modalHeading(fn (DelasTagRequest $record): string => __('panel-admin::delas.actions.reject_heading', ['name' => $record->user->name]))
+ ->modalDescription(fn (DelasTagRequest $record): string => __('panel-admin::delas.actions.reject_body', [
+ 'name' => $record->user->name,
+ 'date' => now()->addDays(config()->integer('delas.request_cooldown_days'))->timezone(config('app.display_timezone'))->format('d/m'),
+ ]))
+ ->modalSubmitActionLabel(__('panel-admin::delas.actions.reject'))
+ ->schema([$this->reasonField(__('panel-admin::delas.actions.reject_reason'))])
+ ->action(fn (DelasTagRequest $record, array $data): bool => $this->attempt(
+ fn () => resolve(RejectDelasRequest::class)->handle($record, $this->actor(), $this->reasonFrom($data)),
+ __('panel-admin::delas.actions.rejected'),
+ )),
+ Action::make('block')
+ ->label(__('panel-admin::delas.actions.block'))
+ ->icon(Heroicon::OutlinedNoSymbol)
+ ->color('warning')
+ ->button()
+ ->outlined()
+ ->size('sm')
+ ->disabled(fn (DelasTagRequest $record): bool => !$this->canBlock($record->user))
+ ->tooltip(fn (DelasTagRequest $record): ?string => $this->canBlock($record->user) ? null : $this->text('panel-admin::delas.actions.block_disabled'))
+ ->modalHeading(fn (DelasTagRequest $record): string => __('panel-admin::delas.actions.block_heading', ['name' => $record->user->name]))
+ ->modalDescription(__('panel-admin::delas.actions.block_body'))
+ ->modalSubmitActionLabel(__('panel-admin::delas.actions.block'))
+ ->modalIcon(Heroicon::OutlinedNoSymbol)
+ ->modalIconColor('danger')
+ ->schema([$this->reasonField(__('panel-admin::delas.actions.block_reason'))])
+ ->action(fn (DelasTagRequest $record, array $data): bool => $this->attempt(
+ fn () => resolve(BlockDelasRequester::class)->handle($record->user, $this->actor(), $this->reasonFrom($data)),
+ __('panel-admin::delas.actions.blocked'),
+ )),
+ ]);
+ }
+
+ private function canBlock(User $target): bool
+ {
+ return !$target->is($this->actor()) && !$target->can('moderate-delas');
+ }
+}
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
new file mode 100644
index 000000000..b1d4c1a7c
--- /dev/null
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
@@ -0,0 +1,232 @@
+user()?->can('lead-delas') ?? false;
+ }
+
+ public static function getNavigationLabel(): string
+ {
+ return __('panel-admin::delas.navigation.team');
+ }
+
+ public function getTitle(): string
+ {
+ return __('panel-admin::delas.pages.team.title');
+ }
+
+ public function getSubheading(): string
+ {
+ return __('panel-admin::delas.pages.team.subtitle');
+ }
+
+ public function table(Table $table): Table
+ {
+ return $table
+ ->query(
+ User::query()
+ ->select('users.*')
+ ->addSelect(['decisions_count' => DelasTransition::query()
+ ->selectRaw('count(*)')
+ ->whereColumn('delas_transitions.actor_id', 'users.id')
+ ->whereIn('action', [DelasAction::Approved, DelasAction::Rejected, DelasAction::Blocked, DelasAction::Unblocked, DelasAction::Granted, DelasAction::Revoked]),
+ ])
+ ->role([UserRole::DelasModerator->value, UserRole::DelasLead->value])
+ ->with('roles'),
+ )
+ ->defaultSort('name')
+ ->emptyStateHeading(__('panel-admin::delas.empty.team'))
+ ->emptyStateDescription(__('panel-admin::delas.empty.team_body'))
+ ->emptyStateIcon(Heroicon::OutlinedUsers)
+ ->headerActions([
+ Action::make('addModerator')
+ ->label(__('panel-admin::delas.actions.add_moderator'))
+ ->icon(Heroicon::OutlinedUserPlus)
+ ->modalHeading(__('panel-admin::delas.actions.add_moderator_heading'))
+ ->modalDescription(__('panel-admin::delas.actions.add_moderator_body'))
+ ->schema([
+ $this->searchablePersonSelect(fn (): Builder => $this->candidates()->forModerator($this->actor())),
+ ])
+ ->action(fn (array $data): bool => $this->attempt(
+ fn () => resolve(AddDelasModerator::class)->handle($this->findUser($data['user_id']), $this->actor()),
+ __('panel-admin::delas.actions.moderator_added'),
+ )),
+ ])
+ ->columns([
+ $this->personColumn('name', 'username', __('panel-admin::delas.columns.person')),
+ TextColumn::make('delas_role')
+ ->label(__('panel-admin::delas.columns.role'))
+ ->state(fn (User $record): UserRole => $record->hasRole(UserRole::DelasLead) ? UserRole::DelasLead : UserRole::DelasModerator)
+ ->badge(),
+ TextColumn::make('decisions_count')
+ ->label(__('panel-admin::delas.columns.decisions'))
+ ->numeric()
+ ->alignEnd(),
+ ])
+ ->recordActions([
+ Action::make('removeModerator')
+ ->label(__('panel-admin::delas.actions.remove_moderator'))
+ ->icon(Heroicon::OutlinedUserMinus)
+ ->color('danger')
+ ->button()
+ ->outlined()
+ ->size('sm')
+ ->disabled(fn (User $record): bool => $record->hasRole(UserRole::DelasLead))
+ ->tooltip(fn (User $record): ?string => $record->hasRole(UserRole::DelasLead) ? $this->text('panel-admin::delas.actions.lead_only') : null)
+ ->requiresConfirmation()
+ ->modalHeading(fn (User $record): string => __('panel-admin::delas.actions.remove_moderator_heading', ['name' => $record->name]))
+ ->modalDescription(fn (User $record): string => __('panel-admin::delas.actions.remove_moderator_body', ['name' => $record->name]))
+ ->action(fn (User $record): bool => $this->attempt(
+ fn () => resolve(RemoveDelasModerator::class)->handle($record, $this->actor()),
+ __('panel-admin::delas.actions.moderator_removed'),
+ )),
+ ]);
+ }
+
+ /**
+ * @return array
+ */
+ protected function getHeaderWidgets(): array
+ {
+ return [DelasStatsOverview::class];
+ }
+
+ /**
+ * @return array
+ */
+ protected function getHeaderActions(): array
+ {
+ return [
+ Action::make('grant')
+ ->label(__('panel-admin::delas.actions.grant'))
+ ->icon(Heroicon::OutlinedPlusCircle)
+ ->modalHeading(__('panel-admin::delas.actions.grant_heading'))
+ ->modalDescription(__('panel-admin::delas.actions.grant_body'))
+ ->schema([
+ $this->searchablePersonSelect(fn (): Builder => $this->candidates()->forGrant($this->actor())),
+ $this->reasonField(__('panel-admin::delas.actions.grant_reason'), required: false),
+ ])
+ ->action(fn (array $data): bool => $this->attempt(
+ fn () => resolve(GrantDelasTag::class)->handle($this->findUser($data['user_id']), $this->actor(), $this->reasonFrom($data)),
+ __('panel-admin::delas.actions.granted'),
+ )),
+ Action::make('revoke')
+ ->label(__('panel-admin::delas.actions.revoke'))
+ ->icon(Heroicon::OutlinedMinusCircle)
+ ->color('danger')
+ ->outlined()
+ ->modalHeading(__('panel-admin::delas.actions.revoke_heading'))
+ ->modalDescription(__('panel-admin::delas.actions.revoke_body'))
+ ->schema([
+ // Quem tem a tag é uma lista pequena: carrega tudo e a pessoa só escolhe.
+ Select::make('user_id')
+ ->label(__('panel-admin::delas.actions.person'))
+ ->helperText(__('panel-admin::delas.actions.member_hint'))
+ ->required()
+ ->options(fn (): array => $this->optionsFor(
+ $this->candidates()->forRevoke($this->actor())->orderBy('name')->get(),
+ ))
+ ->searchable()
+ ->preload(),
+ $this->reasonField(__('panel-admin::delas.actions.revoke_reason')),
+ ])
+ ->action(fn (array $data): bool => $this->attempt(
+ fn () => resolve(RevokeDelasTag::class)->handle($this->findUser($data['user_id']), $this->actor(), $this->reasonFrom($data)),
+ __('panel-admin::delas.actions.revoked'),
+ )),
+ ];
+ }
+
+ /**
+ * Seletor com busca, para listas do tamanho da comunidade. Só aparecem (e só
+ * ganham rótulo) as pessoas do escopo que a consulta de domínio devolve.
+ *
+ * @param Closure(): Builder $candidates
+ */
+ private function searchablePersonSelect(Closure $candidates): Select
+ {
+ return Select::make('user_id')
+ ->label(__('panel-admin::delas.actions.person'))
+ ->helperText(__('panel-admin::delas.actions.person_hint'))
+ ->required()
+ ->searchable()
+ ->getSearchResultsUsing(fn (string $search): array => $this->optionsFor(
+ $this->candidates()->search($candidates(), $search),
+ ))
+ ->getOptionLabelUsing(fn (mixed $value): ?string => ($user = $candidates()->find($value)) instanceof User
+ ? $this->optionLabel($user)
+ : null);
+ }
+
+ /**
+ * @param Collection $users
+ * @return array
+ */
+ private function optionsFor(Collection $users): array
+ {
+ return $users
+ ->mapWithKeys(fn (User $user): array => [$user->id => $this->optionLabel($user)])
+ ->all();
+ }
+
+ private function optionLabel(User $user): string
+ {
+ return $user->name.' (@'.$user->username.')';
+ }
+
+ private function candidates(): DelasCandidates
+ {
+ return resolve(DelasCandidates::class);
+ }
+
+ private function findUser(mixed $id): User
+ {
+ return User::query()->whereKey($id)->firstOrFail();
+ }
+}
diff --git a/app-modules/panel-admin/src/Moderation/Widgets/Delas/DelasStatsOverview.php b/app-modules/panel-admin/src/Moderation/Widgets/Delas/DelasStatsOverview.php
new file mode 100644
index 000000000..ef11eae51
--- /dev/null
+++ b/app-modules/panel-admin/src/Moderation/Widgets/Delas/DelasStatsOverview.php
@@ -0,0 +1,67 @@
+user()?->can('lead-delas') ?? false;
+ }
+
+ /**
+ * @return Stat[]
+ */
+ protected function getStats(): array
+ {
+ $overview = resolve(DelasOverview::class);
+ $oldest = $overview->oldestPendingAt();
+ $hours = $overview->averageDecisionHours();
+ $monthStart = now()->timezone(config('app.display_timezone'))->startOfMonth()->utc();
+ $month = $overview->decisionsSince($monthStart);
+
+ return [
+ Stat::make(__('panel-admin::delas.stats.pending'), $overview->pendingCount())
+ ->description($oldest === null
+ ? __('panel-admin::delas.stats.pending_none')
+ : __('panel-admin::delas.stats.pending_oldest', ['when' => $oldest->diffForHumans()]))
+ ->icon(Heroicon::OutlinedInboxStack),
+ Stat::make(__('panel-admin::delas.stats.members'), $overview->membersCount())
+ ->description(__('panel-admin::delas.stats.members_desc'))
+ ->icon(Heroicon::OutlinedUsers),
+ Stat::make(__('panel-admin::delas.stats.avg_decision'), $this->formatHours($hours))
+ ->description(__('panel-admin::delas.stats.avg_decision_desc'))
+ ->icon(Heroicon::OutlinedClock),
+ Stat::make(__('panel-admin::delas.stats.month'), $month['approved'].' / '.$month['rejected'])
+ ->description(__('panel-admin::delas.stats.month_desc'))
+ ->icon(Heroicon::OutlinedCheckCircle),
+ Stat::make(__('panel-admin::delas.stats.blocks'), $overview->activeBlocksCount())
+ ->description(__('panel-admin::delas.stats.blocks_desc'))
+ ->icon(Heroicon::OutlinedLockClosed),
+ ];
+ }
+
+ private function formatHours(?float $hours): string
+ {
+ return match (true) {
+ $hours === null => '—',
+ $hours < 48 => round($hours).' h',
+ default => __('panel-admin::delas.stats.days', ['value' => number_format($hours / 24, 1, ',', '.')]),
+ };
+ }
+}
diff --git a/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php b/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php
index 69d1212cf..0d7cf891d 100644
--- a/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php
+++ b/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php
@@ -8,6 +8,7 @@
use Filament\Navigation\NavigationItem;
use He4rt\Identity\User\Models\User;
use He4rt\PanelAdmin\Contributions\Widgets\ActivityTimelineWidget;
+use He4rt\PanelAdmin\Moderation\Pages\Delas\DelasTeamPage;
use He4rt\PanelAdmin\Pages\Dashboard;
use function Pest\Laravel\actingAs;
@@ -83,3 +84,40 @@ function adminComponents(): array
expect($labels)->toBe(['Dashboard']);
});
+
+test('no admin, a moderadora da He4rt Delas só acessa o Dashboard e a área da He4rt Delas', function (): void {
+ actingAs(User::factory()->delasModerator()->create());
+
+ $panel = Filament::getPanel('admin');
+
+ collect([...$panel->getResources(), ...$panel->getPages()])
+ ->reject(fn (string $component): bool => is_subclass_of($component, Cluster::class))
+ ->each(function (string $component): void {
+ $isAllowed = $component === Dashboard::class
+ || (str_starts_with($component, 'He4rt\\PanelAdmin\\Moderation\\Pages\\Delas\\') && $component !== DelasTeamPage::class);
+
+ expect($component::canAccess())->toBe($isAllowed, $component);
+ });
+});
+
+test('a líder da He4rt Delas acessa também a Equipe, e nada além da área dela', function (): void {
+ actingAs(User::factory()->delasLead()->create());
+
+ foreach (adminComponents() as $component) {
+ $isAllowed = $component === Dashboard::class
+ || str_starts_with($component, 'He4rt\\PanelAdmin\\Moderation\\Pages\\Delas\\');
+
+ expect($component::canAccess())->toBe($isAllowed, $component);
+ }
+});
+
+test('a sidebar da moderadora mostra só o Dashboard e a Moderação', function (): void {
+ actingAs(User::factory()->delasModerator()->create());
+
+ $labels = collect(Filament::getPanel('admin')->getNavigation())
+ ->flatMap(fn (NavigationGroup $group): array => $group->getItems())
+ ->map(fn (NavigationItem $item): string => $item->getLabel())
+ ->all();
+
+ expect($labels)->toBe(['Dashboard', __('panel-admin::moderation.navigation.cluster')]);
+});
diff --git a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
new file mode 100644
index 000000000..7a31d3fd6
--- /dev/null
+++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
@@ -0,0 +1,349 @@
+instance();
+ $select = $livewire->getSchema($livewire->getMountedActionSchemaName())->getComponent('user_id', withHidden: true);
+
+ expect($select)->toBeInstanceOf(Select::class);
+
+ return $select;
+}
+
+test('membra comum não acessa nenhuma página da He4rt Delas', function (string $page): void {
+ $this->actingAs(User::factory()->create());
+
+ expect($page::canAccess())->toBeFalse();
+
+ $this->get($page::getUrl())->assertForbidden();
+})->with([DelasQueuePage::class, DelasBlocksPage::class, DelasHistoryPage::class, DelasTeamPage::class]);
+
+test('moderadora vê a fila de pendentes, mas não a Equipe', function (): void {
+ $this->actingAs(User::factory()->delasModerator()->create());
+ $pending = DelasTagRequest::factory()->pending()->count(2)->create();
+ $approved = DelasTagRequest::factory()->approved()->create();
+
+ livewire(DelasQueuePage::class)
+ ->assertOk()
+ ->loadTable()
+ ->assertCanSeeTableRecords($pending)
+ ->assertCanNotSeeTableRecords([$approved]);
+
+ expect(DelasTeamPage::canAccess())->toBeFalse();
+ $this->get(DelasTeamPage::getUrl())->assertForbidden();
+});
+
+test('a moderadora abre a página pelo navegador, com o lazy loading vigiado', function (string $page): void {
+ $this->actingAs(User::factory()->delasModerator()->create());
+ DelasTagRequest::factory()->pending()->count(2)->create();
+ DelasRequesterBlock::factory()->count(2)->create();
+ DelasTransition::factory()->count(2)->create(['action' => DelasAction::Approved]);
+
+ $this->get($page::getUrl())->assertOk();
+})->with([DelasQueuePage::class, DelasBlocksPage::class, DelasHistoryPage::class]);
+
+test('ao revogar o papel, a moderadora perde o acesso na hora', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $moderator->removeRole(UserRole::DelasModerator);
+
+ $this->actingAs($moderator->fresh());
+
+ expect(DelasQueuePage::canAccess())->toBeFalse();
+});
+
+test('a moderadora entra no cluster de Moderação e só vê as páginas dela', function (): void {
+ $this->actingAs(User::factory()->delasModerator()->create());
+
+ $this->get(ModerationCluster::getUrl())->assertRedirect(DelasQueuePage::getUrl());
+
+ $items = collect(resolve(ModerationCluster::class)->getSubNavigation())
+ ->sortBy(fn (NavigationItem $item): int => $item->getSort())
+ ->values();
+
+ expect($items->map(fn (NavigationItem $item): ?string => $item->getGroup())->unique()->values()->all())
+ ->toBe([__('panel-admin::delas.navigation.group')])
+ ->and($items->map(fn (NavigationItem $item): string => $item->getLabel())->all())->toBe([
+ __('panel-admin::delas.navigation.queue'),
+ __('panel-admin::delas.navigation.blocks'),
+ __('panel-admin::delas.navigation.history'),
+ ]);
+});
+
+test('os badges da subnavegação contam pendentes e bloqueios ativos', function (): void {
+ expect(DelasQueuePage::getNavigationBadge())->toBeNull()
+ ->and(DelasBlocksPage::getNavigationBadge())->toBeNull();
+
+ DelasTagRequest::factory()->pending()->count(2)->create();
+ DelasTagRequest::factory()->approved()->create();
+ DelasRequesterBlock::factory()->create();
+ DelasRequesterBlock::factory()->lifted()->create();
+
+ expect(DelasQueuePage::getNavigationBadge())->toBe('2')
+ ->and(DelasBlocksPage::getNavigationBadge())->toBe('1');
+});
+
+test('moderadora aprova pela fila', function (): void {
+ $this->actingAs(User::factory()->delasModerator()->create());
+ [$request] = DelasTagRequest::factory()->pending()->count(2)->create();
+
+ livewire(DelasQueuePage::class)
+ ->callAction(TestAction::make('approve')->table($request))
+ ->assertNotified(__('panel-admin::delas.actions.approved'));
+
+ expect($request->fresh()->status)->toBe(DelasRequestStatus::Approved);
+});
+
+test('rejeitar e bloquear pela fila exigem motivo', function (string $action): void {
+ $this->actingAs(User::factory()->delasModerator()->create());
+ [$request] = DelasTagRequest::factory()->pending()->count(2)->create();
+
+ livewire(DelasQueuePage::class)
+ ->callAction(TestAction::make($action)->table($request), data: ['reason' => ''])
+ ->assertHasActionErrors(['reason' => 'required']);
+
+ expect($request->fresh()->status)->toBe(DelasRequestStatus::Pending);
+})->with(['reject', 'block']);
+
+test('bloquear pela fila rejeita a pendente e cria o bloqueio', function (): void {
+ $this->actingAs(User::factory()->delasModerator()->create());
+ [$request] = DelasTagRequest::factory()->pending()->count(2)->create();
+
+ livewire(DelasQueuePage::class)
+ ->callAction(TestAction::make('block')->table($request), data: ['reason' => 'Pedidos repetidos.'])
+ ->assertNotified(__('panel-admin::delas.actions.blocked'));
+
+ expect($request->fresh()->status)->toBe(DelasRequestStatus::Rejected)
+ ->and(DelasRequesterBlock::query()->active()->where('user_id', $request->user_id)->exists())->toBeTrue();
+});
+
+test('o botão de bloquear fica desativado para quem é da equipe', function (): void {
+ $this->actingAs(User::factory()->delasModerator()->create());
+ $fromTeam = DelasTagRequest::factory()->for(User::factory()->delasModerator()->create())->pending()->create();
+ $fromMember = DelasTagRequest::factory()->pending()->create();
+
+ livewire(DelasQueuePage::class)
+ ->loadTable()
+ ->assertActionDisabled(TestAction::make('block')->table($fromTeam))
+ ->assertActionEnabled(TestAction::make('block')->table($fromMember));
+});
+
+/*
+ * O Spatie carrega os papéis com `loadMissing('roles')`, que o
+ * `preventLazyLoading()` não acusa. Então o eager load de `user.roles` da fila
+ * é conferido pelo número de queries: com ele, os papéis de todas as linhas vêm
+ * numa query só, mais a dos papéis de quem está logada.
+ */
+test('a fila carrega os papéis de quem pediu de uma vez, sem uma query por linha', function (): void {
+ $this->actingAs(User::factory()->delasModerator()->create());
+ DelasTagRequest::factory()->pending()->count(3)->create();
+
+ DB::flushQueryLog();
+ DB::enableQueryLog();
+
+ livewire(DelasQueuePage::class)->loadTable();
+
+ $rolesQueries = collect(DB::getQueryLog())
+ ->filter(fn (array $query): bool => str_contains((string) $query['query'], 'model_has_roles'));
+
+ expect($rolesQueries)->toHaveCount(2);
+});
+
+test('a própria solicitação da moderadora não é aprovada por ela', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $this->actingAs($moderator);
+ $request = DelasTagRequest::factory()->for($moderator)->pending()->create();
+ DelasTagRequest::factory()->pending()->create();
+
+ livewire(DelasQueuePage::class)
+ ->callAction(TestAction::make('approve')->table($request))
+ ->assertNotified(__('delas::exceptions.cannot_decide_own'));
+
+ expect($request->fresh()->status)->toBe(DelasRequestStatus::Pending);
+});
+
+test('moderadora desbloqueia os próprios bloqueios, não os de outra', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $this->actingAs($moderator);
+ $own = DelasRequesterBlock::factory()->create(['blocked_by' => $moderator->getKey()]);
+ $others = DelasRequesterBlock::factory()->create();
+
+ livewire(DelasBlocksPage::class)
+ ->loadTable()
+ ->assertCanSeeTableRecords([$own, $others])
+ ->assertActionDisabled(TestAction::make('unblock')->table($others))
+ ->callAction(TestAction::make('unblock')->table($own), data: ['reason' => 'Esclarecido.'])
+ ->assertNotified(__('panel-admin::delas.actions.unblocked'));
+
+ expect($own->fresh()->isActive())->toBeFalse()
+ ->and($others->fresh()->isActive())->toBeTrue();
+});
+
+test('o histórico da moderadora esconde os pedidos; o da líder mostra tudo', function (): void {
+ $requested = DelasTransition::factory()->count(2)->create(['action' => DelasAction::Requested]);
+ $approved = DelasTransition::factory()->count(2)->create(['action' => DelasAction::Approved]);
+
+ $this->actingAs(User::factory()->delasModerator()->create());
+ $moderatorPage = livewire(DelasHistoryPage::class)
+ ->loadTable()
+ ->assertCanSeeTableRecords($approved)
+ ->assertCanNotSeeTableRecords($requested);
+
+ expect($moderatorPage->instance()->getTable()->getFilter('action'))->toBeNull();
+
+ $this->actingAs(User::factory()->delasLead()->create());
+ livewire(DelasHistoryPage::class)
+ ->loadTable()
+ ->assertCanSeeTableRecords([...$approved, ...$requested])
+ ->filterTable('action', DelasAction::Requested->value)
+ ->assertCanSeeTableRecords($requested)
+ ->assertCanNotSeeTableRecords($approved);
+});
+
+test('líder vê a Equipe com os números', function (): void {
+ $this->actingAs(User::factory()->delasLead()->create());
+ $moderators = User::factory()->delasModerator()->count(2)->create();
+
+ livewire(DelasTeamPage::class)
+ ->assertOk()
+ ->assertSeeLivewire(DelasStatsOverview::class)
+ ->loadTable()
+ ->assertCanSeeTableRecords($moderators);
+});
+
+test('líder concede a tag direto pela Equipe', function (): void {
+ $this->actingAs(User::factory()->delasLead()->create());
+ $target = User::factory()->create();
+
+ livewire(DelasTeamPage::class)
+ ->callAction('grant', data: ['user_id' => $target->getKey()])
+ ->assertNotified(__('panel-admin::delas.actions.granted'));
+
+ expect(DelasTagRequest::query()->where('user_id', $target->getKey())->sole()->status)->toBe(DelasRequestStatus::Approved);
+});
+
+test('líder remove a tag com motivo', function (): void {
+ $this->actingAs(User::factory()->delasLead()->create());
+ [$approved] = DelasTagRequest::factory()->approved()->count(2)->create();
+
+ livewire(DelasTeamPage::class)
+ ->callAction('revoke', data: ['user_id' => $approved->user_id, 'reason' => 'Pedido da pessoa.'])
+ ->assertNotified(__('panel-admin::delas.actions.revoked'));
+
+ expect($approved->fresh()->status)->toBe(DelasRequestStatus::Revoked);
+});
+
+test('líder adiciona e revoga moderadora pela Equipe', function (): void {
+ $this->actingAs(User::factory()->delasLead()->create());
+ User::factory()->delasModerator()->create();
+ $target = User::factory()->create();
+
+ livewire(DelasTeamPage::class)
+ ->callAction(TestAction::make('addModerator')->table(), data: ['user_id' => $target->getKey()])
+ ->assertNotified(__('panel-admin::delas.actions.moderator_added'));
+
+ expect($target->fresh()->hasRole(UserRole::DelasModerator))->toBeTrue();
+
+ livewire(DelasTeamPage::class)
+ ->callAction(TestAction::make('removeModerator')->table($target->fresh()))
+ ->assertNotified(__('panel-admin::delas.actions.moderator_removed'));
+
+ expect($target->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse();
+});
+
+test('a revogação de líderes fica desativada na Equipe', function (): void {
+ $this->actingAs(User::factory()->delasLead()->create());
+ $otherLead = User::factory()->delasLead()->create();
+
+ livewire(DelasTeamPage::class)
+ ->loadTable()
+ ->assertActionDisabled(TestAction::make('removeModerator')->table($otherLead));
+});
+
+test('a busca de conceder acha quem não tem a tag e rotula a escolhida', function (): void {
+ $lead = User::factory()->delasLead()->create(['name' => 'Ana Líder', 'username' => 'analider']);
+ $this->actingAs($lead);
+ $ana = User::factory()->create(['name' => 'Ana Souza', 'username' => 'anasouza']);
+ $member = User::factory()->create(['name' => 'Ana Membra', 'username' => 'anamembra']);
+ DelasTagRequest::factory()->for($member)->approved()->create();
+
+ $page = livewire(DelasTeamPage::class)->mountAction('grant');
+ $select = mountedPersonSelect($page);
+
+ expect($select->getSearchResults('ana'))->toBe([$ana->getKey() => 'Ana Souza (@anasouza)']);
+
+ $page->fillForm(['user_id' => $ana->getKey()]);
+ expect(mountedPersonSelect($page)->getOptionLabel())->toBe('Ana Souza (@anasouza)');
+
+ $page->fillForm(['user_id' => $member->getKey()]);
+ expect(mountedPersonSelect($page)->getOptionLabel(withDefault: false))->toBeNull();
+});
+
+test('o seletor de remover lista só quem tem a tag, já carregado', function (): void {
+ $this->actingAs(User::factory()->delasLead()->create());
+ $members = DelasTagRequest::factory()->approved()->count(2)->create()->map->user;
+ DelasTagRequest::factory()->pending()->create();
+ User::factory()->create();
+
+ $select = mountedPersonSelect(livewire(DelasTeamPage::class)->mountAction('revoke'));
+
+ expect($select->isPreloaded())->toBeTrue()
+ ->and(array_keys($select->getOptions()))->toEqualCanonicalizing($members->map->getKey()->all());
+});
+
+test('a busca de adicionar moderadora não acha super admin nem a equipe', function (): void {
+ $this->actingAs(User::factory()->delasLead()->create());
+ $carla = User::factory()->create(['name' => 'Carla Comum', 'username' => 'carlacomum']);
+ User::factory()->superAdmin()->create(['name' => 'Carla Admin', 'username' => 'carlaadmin']);
+ User::factory()->delasModerator()->create(['name' => 'Carla Moderadora', 'username' => 'carlamod']);
+ User::factory()->delasLead()->create(['name' => 'Carla Líder', 'username' => 'carlalider']);
+
+ $select = mountedPersonSelect(livewire(DelasTeamPage::class)->mountAction(TestAction::make('addModerator')->table()));
+
+ expect($select->getSearchResults('carla'))->toBe([$carla->getKey() => 'Carla Comum (@carlacomum)']);
+});
From 44a9853b39e8338d5ae3cddd604d7bd5bda7acc2 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 16:25:20 -0300
Subject: [PATCH 21/77] =?UTF-8?q?refactor(panel-app):=20modera=C3=A7=C3=A3?=
=?UTF-8?q?o=20He4rt=20Delas=20sai=20do=20Hub?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
A DelasModerationPage, o widget de números e as views dela saem do
panel-app e do AppPanelProvider: a moderação mora no cluster de Moderação
do /admin. No /app ficam só o pedido no perfil e a tag no card, com as
strings de perfil; as de moderação foram para o panel-admin.
---
app-modules/panel-app/lang/en/delas.php | 97 ----
app-modules/panel-app/lang/pt_BR/delas.php | 97 ----
.../views/pages/delas/heading.blade.php | 6 -
.../views/pages/delas/moderation.blade.php | 17 -
.../src/Pages/Delas/DelasModerationPage.php | 543 ------------------
.../src/Pages/Delas/DelasStatsOverview.php | 67 ---
.../Feature/Delas/DelasModerationPageTest.php | 196 -------
app/Providers/Filament/AppPanelProvider.php | 2 -
8 files changed, 1025 deletions(-)
delete mode 100644 app-modules/panel-app/resources/views/pages/delas/heading.blade.php
delete mode 100644 app-modules/panel-app/resources/views/pages/delas/moderation.blade.php
delete mode 100644 app-modules/panel-app/src/Pages/Delas/DelasModerationPage.php
delete mode 100644 app-modules/panel-app/src/Pages/Delas/DelasStatsOverview.php
delete mode 100644 app-modules/panel-app/tests/Feature/Delas/DelasModerationPageTest.php
diff --git a/app-modules/panel-app/lang/en/delas.php b/app-modules/panel-app/lang/en/delas.php
index 32290e46c..f7ef47492 100644
--- a/app-modules/panel-app/lang/en/delas.php
+++ b/app-modules/panel-app/lang/en/delas.php
@@ -29,101 +29,4 @@
'sent' => 'Request sent',
'sent_body' => 'We will show the result here on your profile.',
],
- 'moderation' => [
- 'heading' => 'Moderation',
- 'title' => 'He4rt Delas moderation',
- 'navigation' => 'He4rt Delas',
- 'subtitle' => 'Review He4rt Delas tag requests. Every decision records who decided, when and why.',
- 'tabs' => [
- 'pending' => 'Pending',
- 'blocks' => 'Blocks',
- 'history' => 'History',
- 'history_full' => 'Full history',
- 'team' => 'Moderators',
- ],
- 'columns' => [
- 'requester' => 'Requester',
- 'person' => 'Person',
- 'requested_at' => 'Requested at',
- 'blocked_by' => 'Blocked by',
- 'blocked_at' => 'Blocked at',
- 'reason' => 'Reason (internal)',
- 'date' => 'Date',
- 'action' => 'Action',
- 'actor' => 'Done by',
- 'role' => 'Role',
- 'decisions' => 'Decisions',
- ],
- 'empty' => [
- 'pending' => 'No pending requests',
- 'pending_body' => 'When someone requests the He4rt Delas tag, it shows up here.',
- 'blocks' => 'No active blocks',
- 'blocks_body' => 'People blocked from requesting the tag show up here.',
- 'history' => 'Nothing in the history',
- 'history_body' => 'Decisions about the tag show up here.',
- 'team' => 'No moderators',
- 'team_body' => 'Without moderators, only leads and super admins review the queue.',
- ],
- 'block_note' => 'A block only prevents new tag requests. It is not a ban or suspension and does not affect the account.',
- 'reason_hint' => 'Internal: the person does not see this reason.',
- 'history_hint' => 'Recorded in the history.',
- 'actions' => [
- 'approve' => 'Approve',
- 'approve_heading' => 'Approve :name?',
- 'approve_body' => "The He4rt Delas tag will show on @:username's profile.",
- 'approved' => 'Request approved',
- 'reject' => 'Reject',
- 'reject_heading' => "Reject :name's request?",
- 'reject_body' => ':name can request again from :date.',
- 'reject_reason' => 'Rejection reason',
- 'rejected' => 'Request rejected',
- 'block' => 'Block',
- 'block_heading' => 'Block :name from requesting the tag?',
- 'block_body' => 'This only blocks requesting the He4rt Delas tag. It is not a ban or suspension and does not affect the account. The pending request will be rejected.',
- 'block_reason' => 'Block reason',
- 'block_disabled' => 'Moderators, leads, admins and yourself cannot be blocked.',
- 'blocked' => 'Person blocked',
- 'unblock' => 'Unblock',
- 'unblock_heading' => 'Unblock :name?',
- 'unblock_body' => 'The person can request the tag again, respecting the cooldown after a recent decision.',
- 'unblock_reason' => 'Unblock reason',
- 'unblock_disabled' => 'Only whoever created the block or a lead can lift it.',
- 'unblocked' => 'Block lifted',
- 'grant' => 'Grant tag',
- 'grant_heading' => 'Grant the He4rt Delas tag',
- 'grant_body' => 'A pending request gets approved; without one, an approved request is created. The cooldown is ignored. If the person is blocked, the reason is required and the block is lifted.',
- 'grant_reason' => 'Reason',
- 'granted' => 'Tag granted',
- 'revoke' => 'Remove tag',
- 'revoke_heading' => 'Remove the He4rt Delas tag',
- 'revoke_body' => 'The record is kept. The person can request again after the cooldown.',
- 'revoke_reason' => 'Removal reason',
- 'revoked' => 'Tag removed',
- 'person' => 'Person',
- 'person_hint' => 'Search by name or @username.',
- 'add_moderator' => 'Add moderator',
- 'add_moderator_heading' => 'Add a He4rt Delas moderator',
- 'add_moderator_body' => 'The person will see this page and decide requests. Leads are assigned by super admins in /admin.',
- 'moderator_added' => 'Moderator added',
- 'remove_moderator' => 'Revoke moderator',
- 'remove_moderator_heading' => "Revoke :name's role?",
- 'remove_moderator_body' => ':name loses access to this page on the next request. Their decisions stay in the history.',
- 'moderator_removed' => 'Role revoked',
- 'lead_only' => 'Leads are assigned by super admins in /admin.',
- ],
- 'stats' => [
- 'pending' => 'Pending now',
- 'pending_oldest' => 'oldest :when',
- 'pending_none' => 'queue up to date',
- 'members' => 'Members with the tag',
- 'members_desc' => 'approved and granted',
- 'avg_decision' => 'Average time to decision',
- 'avg_decision_desc' => 'in the last 90 days',
- 'month' => 'Decisions this month',
- 'month_desc' => 'approved / rejected',
- 'blocks' => 'Active blocks',
- 'days' => ':value days',
- 'blocks_desc' => 'only prevent new requests',
- ],
- ],
];
diff --git a/app-modules/panel-app/lang/pt_BR/delas.php b/app-modules/panel-app/lang/pt_BR/delas.php
index 85273636a..ae58c00d3 100644
--- a/app-modules/panel-app/lang/pt_BR/delas.php
+++ b/app-modules/panel-app/lang/pt_BR/delas.php
@@ -29,101 +29,4 @@
'sent' => 'Solicitação enviada',
'sent_body' => 'Avisaremos o resultado aqui no seu perfil.',
],
- 'moderation' => [
- 'heading' => 'Moderação',
- 'title' => 'Moderação He4rt Delas',
- 'navigation' => 'He4rt Delas',
- 'subtitle' => 'Analise os pedidos da tag He4rt Delas. Toda decisão fica registrada com quem decidiu, quando e o motivo.',
- 'tabs' => [
- 'pending' => 'Pendentes',
- 'blocks' => 'Bloqueios',
- 'history' => 'Histórico',
- 'history_full' => 'Histórico completo',
- 'team' => 'Moderadoras',
- ],
- 'columns' => [
- 'requester' => 'Solicitante',
- 'person' => 'Pessoa',
- 'requested_at' => 'Pedido em',
- 'blocked_by' => 'Bloqueada por',
- 'blocked_at' => 'Bloqueada em',
- 'reason' => 'Motivo (interno)',
- 'date' => 'Data',
- 'action' => 'Ação',
- 'actor' => 'Quem fez',
- 'role' => 'Papel',
- 'decisions' => 'Decisões',
- ],
- 'empty' => [
- 'pending' => 'Nenhuma solicitação pendente',
- 'pending_body' => 'Quando alguém pedir a tag He4rt Delas, o pedido aparece aqui.',
- 'blocks' => 'Nenhum bloqueio ativo',
- 'blocks_body' => 'Pessoas bloqueadas de solicitar a tag aparecem aqui.',
- 'history' => 'Nada no histórico',
- 'history_body' => 'As decisões sobre a tag aparecem aqui.',
- 'team' => 'Nenhuma moderadora',
- 'team_body' => 'Sem moderadoras, só líderes e super admins analisam a fila.',
- ],
- 'block_note' => 'O bloqueio impede apenas novos pedidos da tag. Não é banimento nem suspensão e não afeta a conta da pessoa.',
- 'reason_hint' => 'Uso interno: a pessoa não vê este motivo.',
- 'history_hint' => 'Fica registrado no histórico.',
- 'actions' => [
- 'approve' => 'Aprovar',
- 'approve_heading' => 'Aprovar :name?',
- 'approve_body' => 'A tag He4rt Delas passa a aparecer no perfil de @:username.',
- 'approved' => 'Solicitação aprovada',
- 'reject' => 'Rejeitar',
- 'reject_heading' => 'Rejeitar a solicitação de :name?',
- 'reject_body' => ':name poderá pedir de novo a partir de :date.',
- 'reject_reason' => 'Motivo da rejeição',
- 'rejected' => 'Solicitação rejeitada',
- 'block' => 'Bloquear',
- 'block_heading' => 'Bloquear :name de solicitar a tag?',
- 'block_body' => 'Isso bloqueia só o pedido da tag He4rt Delas. Não é banimento nem suspensão e não afeta a conta. A solicitação pendente será rejeitada.',
- 'block_reason' => 'Motivo do bloqueio',
- 'block_disabled' => 'Não é possível bloquear moderadoras, líderes, admins ou a si mesma.',
- 'blocked' => 'Pessoa bloqueada',
- 'unblock' => 'Desbloquear',
- 'unblock_heading' => 'Desbloquear :name?',
- 'unblock_body' => 'A pessoa volta a poder solicitar a tag, respeitando a espera se houver uma decisão recente.',
- 'unblock_reason' => 'Motivo do desbloqueio',
- 'unblock_disabled' => 'Só quem fez o bloqueio ou uma líder pode desfazer.',
- 'unblocked' => 'Bloqueio encerrado',
- 'grant' => 'Conceder tag',
- 'grant_heading' => 'Conceder a tag He4rt Delas',
- 'grant_body' => 'Com solicitação pendente, ela é aprovada; sem solicitação, é criada uma já aprovada. A espera é ignorada. Se a pessoa estiver bloqueada, o motivo é obrigatório e o bloqueio é encerrado.',
- 'grant_reason' => 'Motivo',
- 'granted' => 'Tag concedida',
- 'revoke' => 'Remover tag',
- 'revoke_heading' => 'Remover a tag He4rt Delas',
- 'revoke_body' => 'O registro não é apagado. A pessoa poderá solicitar de novo depois da espera.',
- 'revoke_reason' => 'Motivo da remoção',
- 'revoked' => 'Tag removida',
- 'person' => 'Pessoa',
- 'person_hint' => 'Busque por nome ou @username.',
- 'add_moderator' => 'Adicionar moderadora',
- 'add_moderator_heading' => 'Adicionar moderadora He4rt Delas',
- 'add_moderator_body' => 'A pessoa passa a ver esta página e a decidir pedidos. Líderes são atribuídas por super admins no /admin.',
- 'moderator_added' => 'Moderadora adicionada',
- 'remove_moderator' => 'Revogar moderadora',
- 'remove_moderator_heading' => 'Revogar o papel de :name?',
- 'remove_moderator_body' => ':name perde o acesso a esta página na próxima requisição. As decisões dela continuam no histórico.',
- 'moderator_removed' => 'Papel revogado',
- 'lead_only' => 'Líderes são atribuídas por super admins no /admin.',
- ],
- 'stats' => [
- 'pending' => 'Pendentes agora',
- 'pending_oldest' => 'mais antiga :when',
- 'pending_none' => 'fila em dia',
- 'members' => 'Membras com a tag',
- 'members_desc' => 'aprovadas e concedidas',
- 'avg_decision' => 'Tempo médio até a decisão',
- 'avg_decision_desc' => 'nos últimos 90 dias',
- 'month' => 'Decisões no mês',
- 'month_desc' => 'aprovadas / rejeitadas',
- 'blocks' => 'Bloqueios ativos',
- 'days' => ':value dias',
- 'blocks_desc' => 'só impedem novos pedidos',
- ],
- ],
];
diff --git a/app-modules/panel-app/resources/views/pages/delas/heading.blade.php b/app-modules/panel-app/resources/views/pages/delas/heading.blade.php
deleted file mode 100644
index 9c4b1b70b..000000000
--- a/app-modules/panel-app/resources/views/pages/delas/heading.blade.php
+++ /dev/null
@@ -1,6 +0,0 @@
-
-
-
- {{ __('panel-app::delas.moderation.heading') }}
-
-
diff --git a/app-modules/panel-app/resources/views/pages/delas/moderation.blade.php b/app-modules/panel-app/resources/views/pages/delas/moderation.blade.php
deleted file mode 100644
index 8ddfdfbb1..000000000
--- a/app-modules/panel-app/resources/views/pages/delas/moderation.blade.php
+++ /dev/null
@@ -1,17 +0,0 @@
-
-
- @foreach ($this->tabs() as $key => $tab)
-
- {{ $tab['label'] }}
-
- @endforeach
-
-
- {{ $this->table }}
-
diff --git a/app-modules/panel-app/src/Pages/Delas/DelasModerationPage.php b/app-modules/panel-app/src/Pages/Delas/DelasModerationPage.php
deleted file mode 100644
index e012395db..000000000
--- a/app-modules/panel-app/src/Pages/Delas/DelasModerationPage.php
+++ /dev/null
@@ -1,543 +0,0 @@
-user()?->can('moderate-delas') ?? false;
- }
-
- public static function getNavigationLabel(): string
- {
- return __('panel-app::delas.moderation.navigation');
- }
-
- public static function getNavigationBadge(): ?string
- {
- $pending = DelasTagRequest::query()->pending()->count();
-
- return $pending > 0 ? (string) $pending : null;
- }
-
- public function getTitle(): string
- {
- return __('panel-app::delas.moderation.title');
- }
-
- public function getHeading(): Htmlable
- {
- return new HtmlString(view('panel-app::pages.delas.heading')->render());
- }
-
- public function getSubheading(): string
- {
- return __('panel-app::delas.moderation.subtitle');
- }
-
- public function mount(): void
- {
- if (!array_key_exists($this->tab, $this->tabs())) {
- $this->tab = self::TAB_PENDING;
- }
- }
-
- public function updatedTab(): void
- {
- $this->mount();
- $this->resetTable();
- }
-
- public function isLead(): bool
- {
- return $this->actor()->can('lead-delas');
- }
-
- /**
- * @return array
- */
- public function tabs(): array
- {
- $tabs = [
- self::TAB_PENDING => [
- 'label' => __('panel-app::delas.moderation.tabs.pending'),
- 'icon' => Heroicon::OutlinedInboxStack,
- 'badge' => DelasTagRequest::query()->pending()->count(),
- ],
- self::TAB_BLOCKS => [
- 'label' => __('panel-app::delas.moderation.tabs.blocks'),
- 'icon' => Heroicon::OutlinedLockClosed,
- 'badge' => DelasRequesterBlock::query()->active()->count(),
- ],
- self::TAB_HISTORY => [
- 'label' => $this->isLead() ? __('panel-app::delas.moderation.tabs.history_full') : __('panel-app::delas.moderation.tabs.history'),
- 'icon' => Heroicon::OutlinedClock,
- 'badge' => null,
- ],
- ];
-
- if ($this->isLead()) {
- $tabs[self::TAB_TEAM] = [
- 'label' => __('panel-app::delas.moderation.tabs.team'),
- 'icon' => Heroicon::OutlinedUsers,
- 'badge' => User::query()->role([UserRole::DelasModerator->value, UserRole::DelasLead->value])->count(),
- ];
- }
-
- return $tabs;
- }
-
- public function table(Table $table): Table
- {
- return match ($this->tab) {
- self::TAB_BLOCKS => $this->blocksTable($table),
- self::TAB_HISTORY => $this->historyTable($table),
- self::TAB_TEAM => $this->teamTable($table),
- default => $this->pendingTable($table),
- };
- }
-
- /**
- * @return array
- */
- protected function getHeaderWidgets(): array
- {
- return [DelasStatsOverview::class];
- }
-
- /**
- * @return array
- */
- protected function getHeaderActions(): array
- {
- return [
- Action::make('grant')
- ->label(__('panel-app::delas.moderation.actions.grant'))
- ->icon(Heroicon::OutlinedPlusCircle)
- ->visible(fn (): bool => $this->isLead())
- ->modalHeading(__('panel-app::delas.moderation.actions.grant_heading'))
- ->modalDescription(__('panel-app::delas.moderation.actions.grant_body'))
- ->schema([
- $this->personSelect(fn (Builder $query): Builder => $query->whereNotIn('id', $this->membersQuery())),
- $this->reasonField(__('panel-app::delas.moderation.actions.grant_reason'), required: false),
- ])
- ->action(fn (array $data): bool => $this->attempt(
- fn () => resolve(GrantDelasTag::class)->handle($this->findUser($data['user_id']), $this->actor(), $this->reasonFrom($data)),
- __('panel-app::delas.moderation.actions.granted'),
- )),
- Action::make('revoke')
- ->label(__('panel-app::delas.moderation.actions.revoke'))
- ->icon(Heroicon::OutlinedMinusCircle)
- ->color('danger')
- ->outlined()
- ->visible(fn (): bool => $this->isLead())
- ->modalHeading(__('panel-app::delas.moderation.actions.revoke_heading'))
- ->modalDescription(__('panel-app::delas.moderation.actions.revoke_body'))
- ->schema([
- $this->personSelect(fn (Builder $query): Builder => $query->whereIn('id', $this->membersQuery())),
- $this->reasonField(__('panel-app::delas.moderation.actions.revoke_reason')),
- ])
- ->action(fn (array $data): bool => $this->attempt(
- fn () => resolve(RevokeDelasTag::class)->handle($this->findUser($data['user_id']), $this->actor(), $this->reasonFrom($data)),
- __('panel-app::delas.moderation.actions.revoked'),
- )),
- ];
- }
-
- private function pendingTable(Table $table): Table
- {
- return $table
- ->query(DelasTagRequest::query()->pending()->with('user'))
- ->defaultSort('requested_at', 'desc')
- ->emptyStateHeading(__('panel-app::delas.moderation.empty.pending'))
- ->emptyStateDescription(__('panel-app::delas.moderation.empty.pending_body'))
- ->emptyStateIcon(Heroicon::OutlinedInboxStack)
- ->columns([
- $this->personColumn('user.name', 'user.username', __('panel-app::delas.moderation.columns.requester')),
- $this->dateColumn('requested_at', __('panel-app::delas.moderation.columns.requested_at')),
- ])
- ->recordActions([
- Action::make('approve')
- ->label(__('panel-app::delas.moderation.actions.approve'))
- ->icon(Heroicon::OutlinedCheck)
- ->color('success')
- ->button()
- ->size('sm')
- ->requiresConfirmation()
- ->modalHeading(fn (DelasTagRequest $record): string => __('panel-app::delas.moderation.actions.approve_heading', ['name' => $record->user->name]))
- ->modalDescription(fn (DelasTagRequest $record): string => __('panel-app::delas.moderation.actions.approve_body', ['username' => $record->user->username]))
- ->action(fn (DelasTagRequest $record): bool => $this->attempt(
- fn () => resolve(ApproveDelasRequest::class)->handle($record, $this->actor()),
- __('panel-app::delas.moderation.actions.approved'),
- )),
- Action::make('reject')
- ->label(__('panel-app::delas.moderation.actions.reject'))
- ->icon(Heroicon::OutlinedXMark)
- ->color('danger')
- ->button()
- ->outlined()
- ->size('sm')
- ->modalHeading(fn (DelasTagRequest $record): string => __('panel-app::delas.moderation.actions.reject_heading', ['name' => $record->user->name]))
- ->modalDescription(fn (DelasTagRequest $record): string => __('panel-app::delas.moderation.actions.reject_body', [
- 'name' => $record->user->name,
- 'date' => now()->addDays(config()->integer('delas.request_cooldown_days'))->timezone(config('app.display_timezone'))->format('d/m'),
- ]))
- ->modalSubmitActionLabel(__('panel-app::delas.moderation.actions.reject'))
- ->schema([$this->reasonField(__('panel-app::delas.moderation.actions.reject_reason'))])
- ->action(fn (DelasTagRequest $record, array $data): bool => $this->attempt(
- fn () => resolve(RejectDelasRequest::class)->handle($record, $this->actor(), $this->reasonFrom($data)),
- __('panel-app::delas.moderation.actions.rejected'),
- )),
- Action::make('block')
- ->label(__('panel-app::delas.moderation.actions.block'))
- ->icon(Heroicon::OutlinedNoSymbol)
- ->color('warning')
- ->button()
- ->outlined()
- ->size('sm')
- ->disabled(fn (DelasTagRequest $record): bool => !$this->canBlock($record->user))
- ->tooltip(fn (DelasTagRequest $record): ?string => $this->canBlock($record->user) ? null : $this->text('panel-app::delas.moderation.actions.block_disabled'))
- ->modalHeading(fn (DelasTagRequest $record): string => __('panel-app::delas.moderation.actions.block_heading', ['name' => $record->user->name]))
- ->modalDescription(__('panel-app::delas.moderation.actions.block_body'))
- ->modalSubmitActionLabel(__('panel-app::delas.moderation.actions.block'))
- ->modalIcon(Heroicon::OutlinedNoSymbol)
- ->modalIconColor('danger')
- ->schema([$this->reasonField(__('panel-app::delas.moderation.actions.block_reason'))])
- ->action(fn (DelasTagRequest $record, array $data): bool => $this->attempt(
- fn () => resolve(BlockDelasRequester::class)->handle($record->user, $this->actor(), $this->reasonFrom($data)),
- __('panel-app::delas.moderation.actions.blocked'),
- )),
- ]);
- }
-
- private function blocksTable(Table $table): Table
- {
- return $table
- ->query(DelasRequesterBlock::query()->active()->with(['user', 'blocker']))
- ->defaultSort('blocked_at', 'desc')
- ->emptyStateHeading(__('panel-app::delas.moderation.empty.blocks'))
- ->emptyStateDescription(__('panel-app::delas.moderation.empty.blocks_body'))
- ->emptyStateIcon(Heroicon::OutlinedLockOpen)
- ->description(__('panel-app::delas.moderation.block_note'))
- ->columns([
- $this->personColumn('user.name', 'user.username', __('panel-app::delas.moderation.columns.person')),
- TextColumn::make('blocker.name')
- ->label(__('panel-app::delas.moderation.columns.blocked_by'))
- ->description(fn (DelasRequesterBlock $record): string => $record->blocked_at->timezone(config('app.display_timezone'))->format('d/m/Y H:i')),
- TextColumn::make('reason')
- ->label(__('panel-app::delas.moderation.columns.reason'))
- ->wrap()
- ->lineClamp(2),
- ])
- ->recordActions([
- Action::make('unblock')
- ->label(__('panel-app::delas.moderation.actions.unblock'))
- ->icon(Heroicon::OutlinedLockOpen)
- ->color('gray')
- ->button()
- ->size('sm')
- ->disabled(fn (DelasRequesterBlock $record): bool => !$this->canUnblock($record))
- ->tooltip(fn (DelasRequesterBlock $record): ?string => $this->canUnblock($record) ? null : $this->text('panel-app::delas.moderation.actions.unblock_disabled'))
- ->modalHeading(fn (DelasRequesterBlock $record): string => __('panel-app::delas.moderation.actions.unblock_heading', ['name' => $record->user->name]))
- ->modalDescription(__('panel-app::delas.moderation.actions.unblock_body'))
- ->modalSubmitActionLabel(__('panel-app::delas.moderation.actions.unblock'))
- ->schema([$this->reasonField(__('panel-app::delas.moderation.actions.unblock_reason'), hint: __('panel-app::delas.moderation.history_hint'))])
- ->action(fn (DelasRequesterBlock $record, array $data): bool => $this->attempt(
- fn () => resolve(UnblockDelasRequester::class)->handle($record, $this->actor(), $this->reasonFrom($data)),
- __('panel-app::delas.moderation.actions.unblocked'),
- )),
- ]);
- }
-
- private function historyTable(Table $table): Table
- {
- $query = DelasTransition::query()->with(['user', 'actor']);
-
- if (!$this->isLead()) {
- $query->where('action', '!=', DelasAction::Requested);
- }
-
- return $table
- ->query($query)
- ->defaultSort('created_at', 'desc')
- ->emptyStateHeading(__('panel-app::delas.moderation.empty.history'))
- ->emptyStateDescription(__('panel-app::delas.moderation.empty.history_body'))
- ->emptyStateIcon(Heroicon::OutlinedClock)
- ->columns([
- $this->dateColumn('created_at', __('panel-app::delas.moderation.columns.date')),
- TextColumn::make('action')
- ->label(__('panel-app::delas.moderation.columns.action'))
- ->badge(),
- $this->personColumn('user.name', 'user.username', __('panel-app::delas.moderation.columns.person')),
- TextColumn::make('actor.name')
- ->label(__('panel-app::delas.moderation.columns.actor'))
- ->description(fn (DelasTransition $record): string => $record->triggered_by->getLabel())
- ->placeholder('—'),
- TextColumn::make('reason')
- ->label(__('panel-app::delas.moderation.columns.reason'))
- ->wrap()
- ->lineClamp(2)
- ->placeholder('—'),
- ])
- ->filters($this->isLead() ? [
- SelectFilter::make('action')
- ->label(__('panel-app::delas.moderation.columns.action'))
- ->options(DelasAction::class),
- ] : []);
- }
-
- private function teamTable(Table $table): Table
- {
- return $table
- ->query(
- User::query()
- ->select('users.*')
- ->addSelect(['decisions_count' => DelasTransition::query()
- ->selectRaw('count(*)')
- ->whereColumn('delas_transitions.actor_id', 'users.id')
- ->whereIn('action', [DelasAction::Approved, DelasAction::Rejected, DelasAction::Blocked, DelasAction::Unblocked, DelasAction::Granted, DelasAction::Revoked]),
- ])
- ->role([UserRole::DelasModerator->value, UserRole::DelasLead->value])
- ->with('roles'),
- )
- ->defaultSort('name')
- ->emptyStateHeading(__('panel-app::delas.moderation.empty.team'))
- ->emptyStateDescription(__('panel-app::delas.moderation.empty.team_body'))
- ->emptyStateIcon(Heroicon::OutlinedUsers)
- ->headerActions([
- Action::make('addModerator')
- ->label(__('panel-app::delas.moderation.actions.add_moderator'))
- ->icon(Heroicon::OutlinedUserPlus)
- ->modalHeading(__('panel-app::delas.moderation.actions.add_moderator_heading'))
- ->modalDescription(__('panel-app::delas.moderation.actions.add_moderator_body'))
- ->schema([
- $this->personSelect(fn (Builder $query): Builder => $query->withoutRole([
- UserRole::SuperAdmin->value,
- UserRole::DelasModerator->value,
- UserRole::DelasLead->value,
- ])),
- ])
- ->action(fn (array $data): bool => $this->attempt(
- fn () => resolve(AddDelasModerator::class)->handle($this->findUser($data['user_id']), $this->actor()),
- __('panel-app::delas.moderation.actions.moderator_added'),
- )),
- ])
- ->columns([
- $this->personColumn('name', 'username', __('panel-app::delas.moderation.columns.person')),
- TextColumn::make('delas_role')
- ->label(__('panel-app::delas.moderation.columns.role'))
- ->state(fn (User $record): UserRole => $record->hasRole(UserRole::DelasLead) ? UserRole::DelasLead : UserRole::DelasModerator)
- ->badge(),
- TextColumn::make('decisions_count')
- ->label(__('panel-app::delas.moderation.columns.decisions'))
- ->numeric()
- ->alignEnd(),
- ])
- ->recordActions([
- Action::make('removeModerator')
- ->label(__('panel-app::delas.moderation.actions.remove_moderator'))
- ->icon(Heroicon::OutlinedUserMinus)
- ->color('danger')
- ->button()
- ->outlined()
- ->size('sm')
- ->disabled(fn (User $record): bool => $record->hasRole(UserRole::DelasLead))
- ->tooltip(fn (User $record): ?string => $record->hasRole(UserRole::DelasLead) ? $this->text('panel-app::delas.moderation.actions.lead_only') : null)
- ->requiresConfirmation()
- ->modalHeading(fn (User $record): string => __('panel-app::delas.moderation.actions.remove_moderator_heading', ['name' => $record->name]))
- ->modalDescription(fn (User $record): string => __('panel-app::delas.moderation.actions.remove_moderator_body', ['name' => $record->name]))
- ->action(fn (User $record): bool => $this->attempt(
- fn () => resolve(RemoveDelasModerator::class)->handle($record, $this->actor()),
- __('panel-app::delas.moderation.actions.moderator_removed'),
- )),
- ]);
- }
-
- private function personColumn(string $name, string $username, string $label): TextColumn
- {
- return TextColumn::make($name)
- ->label($label)
- ->weight('medium')
- ->description(fn (mixed $record): string => '@'.data_get($record, $username))
- ->searchable([str_contains($name, '.') ? 'name' : $name]);
- }
-
- private function dateColumn(string $name, string $label): TextColumn
- {
- return TextColumn::make($name)
- ->label($label)
- ->dateTime('d/m/Y H:i')
- ->timezone(config('app.display_timezone'))
- ->sortable();
- }
-
- private function reasonField(string $label, bool $required = true, ?string $hint = null): Textarea
- {
- return Textarea::make('reason')
- ->label($label)
- ->required($required)
- ->maxLength(Reason::MAX_LENGTH)
- ->rows(3)
- ->helperText($hint ?? __('panel-app::delas.moderation.reason_hint'));
- }
-
- /**
- * @param Closure(Builder): Builder $scope
- */
- private function personSelect(Closure $scope): Select
- {
- return Select::make('user_id')
- ->label(__('panel-app::delas.moderation.actions.person'))
- ->helperText(__('panel-app::delas.moderation.actions.person_hint'))
- ->required()
- ->searchable()
- ->getSearchResultsUsing(fn (string $search): array => $scope(User::query())
- ->whereKeyNot($this->actor()->getKey())
- ->where(fn (Builder $query): Builder => $query
- ->whereLike('name', '%'.$search.'%')
- ->orWhereLike('username', '%'.mb_ltrim($search, '@').'%'))
- ->orderBy('name')
- ->limit(20)
- ->get()
- ->mapWithKeys(fn (User $user): array => [$user->getKey() => $user->name.' (@'.$user->username.')'])
- ->all())
- ->getOptionLabelUsing(fn (string $value): ?string => ($user = User::query()->find($value)) instanceof User
- ? $user->name.' (@'.$user->username.')'
- : null);
- }
-
- /**
- * Quem tem a tag hoje, para os seletores de conceder e remover.
- *
- * @return Builder
- */
- private function membersQuery(): Builder
- {
- return DelasTagRequest::query()->where('status', DelasRequestStatus::Approved)->select('user_id');
- }
-
- private function canBlock(User $target): bool
- {
- return !$target->is($this->actor()) && !$target->can('moderate-delas');
- }
-
- private function canUnblock(DelasRequesterBlock $block): bool
- {
- return $block->blocked_by === $this->actor()->getKey() || $this->isLead();
- }
-
- /**
- * Roda uma action de domínio e transforma recusas em notificação, sem
- * derrubar a página.
- */
- private function attempt(Closure $operation, string $successTitle): bool
- {
- try {
- $operation();
- } catch (DelasException|AuthorizationException $exception) {
- Notification::make()->danger()->title($exception->getMessage())->send();
-
- return false;
- }
-
- Notification::make()->success()->title($successTitle)->send();
-
- return true;
- }
-
- private function findUser(mixed $id): User
- {
- return User::query()->whereKey($id)->firstOrFail();
- }
-
- /**
- * @param array $data
- */
- private function reasonFrom(array $data): ?string
- {
- $reason = $data['reason'] ?? null;
-
- return is_string($reason) ? $reason : null;
- }
-
- private function text(string $key): string
- {
- $text = __($key);
-
- return is_string($text) ? $text : $key;
- }
-
- private function actor(): User
- {
- $user = auth()->user();
-
- abort_unless($user instanceof User, 403);
-
- return $user;
- }
-}
diff --git a/app-modules/panel-app/src/Pages/Delas/DelasStatsOverview.php b/app-modules/panel-app/src/Pages/Delas/DelasStatsOverview.php
deleted file mode 100644
index 798dbaa88..000000000
--- a/app-modules/panel-app/src/Pages/Delas/DelasStatsOverview.php
+++ /dev/null
@@ -1,67 +0,0 @@
-user()?->can('lead-delas') ?? false;
- }
-
- /**
- * @return Stat[]
- */
- protected function getStats(): array
- {
- $overview = resolve(DelasOverview::class);
- $oldest = $overview->oldestPendingAt();
- $hours = $overview->averageDecisionHours();
- $monthStart = now()->timezone(config('app.display_timezone'))->startOfMonth()->utc();
- $month = $overview->decisionsSince($monthStart);
-
- return [
- Stat::make(__('panel-app::delas.moderation.stats.pending'), $overview->pendingCount())
- ->description($oldest === null
- ? __('panel-app::delas.moderation.stats.pending_none')
- : __('panel-app::delas.moderation.stats.pending_oldest', ['when' => $oldest->diffForHumans()]))
- ->icon(Heroicon::OutlinedInboxStack),
- Stat::make(__('panel-app::delas.moderation.stats.members'), $overview->membersCount())
- ->description(__('panel-app::delas.moderation.stats.members_desc'))
- ->icon(Heroicon::OutlinedUsers),
- Stat::make(__('panel-app::delas.moderation.stats.avg_decision'), $this->formatHours($hours))
- ->description(__('panel-app::delas.moderation.stats.avg_decision_desc'))
- ->icon(Heroicon::OutlinedClock),
- Stat::make(__('panel-app::delas.moderation.stats.month'), $month['approved'].' / '.$month['rejected'])
- ->description(__('panel-app::delas.moderation.stats.month_desc'))
- ->icon(Heroicon::OutlinedCheckCircle),
- Stat::make(__('panel-app::delas.moderation.stats.blocks'), $overview->activeBlocksCount())
- ->description(__('panel-app::delas.moderation.stats.blocks_desc'))
- ->icon(Heroicon::OutlinedLockClosed),
- ];
- }
-
- private function formatHours(?float $hours): string
- {
- return match (true) {
- $hours === null => '—',
- $hours < 48 => round($hours).' h',
- default => __('panel-app::delas.moderation.stats.days', ['value' => number_format($hours / 24, 1, ',', '.')]),
- };
- }
-}
diff --git a/app-modules/panel-app/tests/Feature/Delas/DelasModerationPageTest.php b/app-modules/panel-app/tests/Feature/Delas/DelasModerationPageTest.php
deleted file mode 100644
index 8388668a5..000000000
--- a/app-modules/panel-app/tests/Feature/Delas/DelasModerationPageTest.php
+++ /dev/null
@@ -1,196 +0,0 @@
-actingAs(User::factory()->create());
-
- expect(DelasModerationPage::canAccess())->toBeFalse();
-
- $this->get(DelasModerationPage::getUrl())->assertForbidden();
-});
-
-test('moderadora vê a fila de pendentes, sem as abas e ações de líder', function (): void {
- $this->actingAs(User::factory()->delasModerator()->create());
- $pending = DelasTagRequest::factory()->pending()->create();
- $approved = DelasTagRequest::factory()->approved()->create();
-
- livewire(DelasModerationPage::class)
- ->assertOk()
- ->loadTable()
- ->assertCanSeeTableRecords([$pending])
- ->assertCanNotSeeTableRecords([$approved])
- ->assertActionHidden('grant')
- ->assertActionHidden('revoke')
- ->assertDontSee(__('panel-app::delas.moderation.tabs.team'));
-});
-
-test('ao revogar o papel, a moderadora perde o acesso na hora', function (): void {
- $moderator = User::factory()->delasModerator()->create();
- $moderator->removeRole(UserRole::DelasModerator);
-
- $this->actingAs($moderator->fresh());
-
- expect(DelasModerationPage::canAccess())->toBeFalse();
-});
-
-test('moderadora aprova pela fila', function (): void {
- $this->actingAs(User::factory()->delasModerator()->create());
- $request = DelasTagRequest::factory()->pending()->create();
-
- livewire(DelasModerationPage::class)
- ->callAction(TestAction::make('approve')->table($request))
- ->assertNotified(__('panel-app::delas.moderation.actions.approved'));
-
- expect($request->fresh()->status)->toBe(DelasRequestStatus::Approved);
-});
-
-test('rejeitar e bloquear pela fila exigem motivo', function (string $action): void {
- $this->actingAs(User::factory()->delasModerator()->create());
- $request = DelasTagRequest::factory()->pending()->create();
-
- livewire(DelasModerationPage::class)
- ->callAction(TestAction::make($action)->table($request), data: ['reason' => ''])
- ->assertHasActionErrors(['reason' => 'required']);
-
- expect($request->fresh()->status)->toBe(DelasRequestStatus::Pending);
-})->with(['reject', 'block']);
-
-test('bloquear pela fila rejeita a pendente e cria o bloqueio', function (): void {
- $this->actingAs(User::factory()->delasModerator()->create());
- $request = DelasTagRequest::factory()->pending()->create();
-
- livewire(DelasModerationPage::class)
- ->callAction(TestAction::make('block')->table($request), data: ['reason' => 'Pedidos repetidos.'])
- ->assertNotified(__('panel-app::delas.moderation.actions.blocked'));
-
- expect($request->fresh()->status)->toBe(DelasRequestStatus::Rejected)
- ->and(DelasRequesterBlock::query()->active()->where('user_id', $request->user_id)->exists())->toBeTrue();
-});
-
-test('o botão de bloquear fica desativado para quem é da equipe', function (): void {
- $this->actingAs(User::factory()->delasModerator()->create());
- $request = DelasTagRequest::factory()->for(User::factory()->delasModerator()->create())->pending()->create();
-
- livewire(DelasModerationPage::class)
- ->assertActionDisabled(TestAction::make('block')->table($request));
-});
-
-test('a própria solicitação da moderadora não é aprovada por ela', function (): void {
- $moderator = User::factory()->delasModerator()->create();
- $this->actingAs($moderator);
- $request = DelasTagRequest::factory()->for($moderator)->pending()->create();
-
- livewire(DelasModerationPage::class)
- ->callAction(TestAction::make('approve')->table($request))
- ->assertNotified(__('delas::exceptions.cannot_decide_own'));
-
- expect($request->fresh()->status)->toBe(DelasRequestStatus::Pending);
-});
-
-test('moderadora desbloqueia pela aba de bloqueios com motivo', function (): void {
- $moderator = User::factory()->delasModerator()->create();
- $this->actingAs($moderator);
- $block = DelasRequesterBlock::factory()->create(['blocked_by' => $moderator->getKey()]);
-
- livewire(DelasModerationPage::class)
- ->set('tab', DelasModerationPage::TAB_BLOCKS)
- ->loadTable()
- ->assertCanSeeTableRecords([$block])
- ->callAction(TestAction::make('unblock')->table($block), data: ['reason' => 'Esclarecido.'])
- ->assertNotified(__('panel-app::delas.moderation.actions.unblocked'));
-
- expect($block->fresh()->isActive())->toBeFalse();
-});
-
-test('o histórico da moderadora esconde os pedidos; o da líder mostra tudo', function (): void {
- $requested = DelasTransition::factory()->create(['action' => DelasAction::Requested]);
- $approved = DelasTransition::factory()->create(['action' => DelasAction::Approved]);
-
- $this->actingAs(User::factory()->delasModerator()->create());
- livewire(DelasModerationPage::class)
- ->set('tab', DelasModerationPage::TAB_HISTORY)
- ->loadTable()
- ->assertCanSeeTableRecords([$approved])
- ->assertCanNotSeeTableRecords([$requested]);
-
- $this->actingAs(User::factory()->delasLead()->create());
- livewire(DelasModerationPage::class)
- ->set('tab', DelasModerationPage::TAB_HISTORY)
- ->loadTable()
- ->assertCanSeeTableRecords([$approved, $requested]);
-});
-
-test('moderadora não abre a aba de equipe nem pela URL', function (): void {
- $this->actingAs(User::factory()->delasModerator()->create());
-
- livewire(DelasModerationPage::class, ['tab' => DelasModerationPage::TAB_TEAM])
- ->assertSet('tab', DelasModerationPage::TAB_PENDING);
-});
-
-test('líder concede a tag direto pelo cabeçalho', function (): void {
- $this->actingAs(User::factory()->delasLead()->create());
- $target = User::factory()->create();
-
- livewire(DelasModerationPage::class)
- ->callAction('grant', data: ['user_id' => $target->getKey()])
- ->assertNotified(__('panel-app::delas.moderation.actions.granted'));
-
- expect(DelasTagRequest::query()->where('user_id', $target->getKey())->sole()->status)->toBe(DelasRequestStatus::Approved);
-});
-
-test('líder remove a tag com motivo', function (): void {
- $this->actingAs(User::factory()->delasLead()->create());
- $approved = DelasTagRequest::factory()->approved()->create();
-
- livewire(DelasModerationPage::class)
- ->callAction('revoke', data: ['user_id' => $approved->user_id, 'reason' => 'Pedido da pessoa.'])
- ->assertNotified(__('panel-app::delas.moderation.actions.revoked'));
-
- expect($approved->fresh()->status)->toBe(DelasRequestStatus::Revoked);
-});
-
-test('líder adiciona e revoga moderadora pela aba de equipe', function (): void {
- $this->actingAs(User::factory()->delasLead()->create());
- $target = User::factory()->create();
-
- livewire(DelasModerationPage::class)
- ->set('tab', DelasModerationPage::TAB_TEAM)
- ->callAction(TestAction::make('addModerator')->table(), data: ['user_id' => $target->getKey()])
- ->assertNotified(__('panel-app::delas.moderation.actions.moderator_added'));
-
- expect($target->fresh()->hasRole(UserRole::DelasModerator))->toBeTrue();
-
- livewire(DelasModerationPage::class)
- ->set('tab', DelasModerationPage::TAB_TEAM)
- ->callAction(TestAction::make('removeModerator')->table($target->fresh()))
- ->assertNotified(__('panel-app::delas.moderation.actions.moderator_removed'));
-
- expect($target->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse();
-});
-
-test('a revogação de líderes fica desativada no Hub', function (): void {
- $this->actingAs(User::factory()->delasLead()->create());
- $otherLead = User::factory()->delasLead()->create();
-
- livewire(DelasModerationPage::class)
- ->set('tab', DelasModerationPage::TAB_TEAM)
- ->assertActionDisabled(TestAction::make('removeModerator')->table($otherLead));
-});
diff --git a/app/Providers/Filament/AppPanelProvider.php b/app/Providers/Filament/AppPanelProvider.php
index 19dbb4146..5681e67f2 100644
--- a/app/Providers/Filament/AppPanelProvider.php
+++ b/app/Providers/Filament/AppPanelProvider.php
@@ -20,7 +20,6 @@
use He4rt\PanelApp\Clusters\Streaming\Pages\StreamSessionPage;
use He4rt\PanelApp\Clusters\Streaming\Pages\StreamSessionsPage;
use He4rt\PanelApp\Clusters\Streaming\StreamingCluster;
-use He4rt\PanelApp\Pages\Delas\DelasModerationPage;
use He4rt\PanelApp\Pages\EventPage;
use He4rt\PanelApp\Pages\EventsPage;
use He4rt\PanelApp\Pages\LoginPage;
@@ -63,7 +62,6 @@ public function panel(Panel $panel): Panel
EventPage::class,
ThreadPage::class,
ProfilePage::class,
- DelasModerationPage::class,
StreamingCluster::class,
StreamDashboardPage::class,
StreamOverlaysPage::class,
From ac22e333b7dad363697a89a3a6d1f56ae3085a8c Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 16:27:25 -0300
Subject: [PATCH 22/77] =?UTF-8?q?docs(delas):=20modera=C3=A7=C3=A3o=20no?=
=?UTF-8?q?=20/admin=20na=20ADR,=20na=20spec=20e=20nos=20contextos?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
A ADR-0001 do delas passa a decidir pela moderação no cluster de
Moderação do /admin, com o /app só com o pedido e a tag, apoiada na
ADR-0003 do identity. A spec, o CONTEXT do delas e do panel-admin e o
CONTEXT-MAP acompanham: páginas e gates, DelasCandidates, SuperAdminOnly,
marca no design system e os testes novos.
---
CONTEXT-MAP.md | 2 +-
app-modules/delas/CONTEXT.md | 29 +++--
...01-modulo-proprio-com-papel-e-historico.md | 40 +++++--
app-modules/panel-admin/CONTEXT.md | 20 +++-
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 107 +++++++++++-------
5 files changed, 132 insertions(+), 66 deletions(-)
diff --git a/CONTEXT-MAP.md b/CONTEXT-MAP.md
index 08c3f5f44..ba17710a3 100644
--- a/CONTEXT-MAP.md
+++ b/CONTEXT-MAP.md
@@ -77,4 +77,4 @@ This is a modular monorepo (`internachi/modular`). Each bounded context lives un
- **Squads** depends on Onboarding (reads the `Squads`-completion gate, "APTO") and Identity (users/tenants). It never imports from presentation; the panels depend on it.
- **Marketing** owns short links and their click record. It depends only on **Identity** (`created_by` / `user_id` on a click) and on no other context. It renders no UI and registers no route: `portal` owns the public `/l/{slug}` edge and the "link unavailable" page, and `panel-admin` owns the staff CRUD and dashboards — both depend on `marketing`, never the reverse.
- **Contents** owns the canonical record of externally published content. It never talks HTTP (the `integration-*` modules implement its provider contract) and never awards anything — it emits `ArticlePublished` and `activity` decides. It depends on Identity (authorship resolution, `ExternalIdentityConnected`); `activity` and the panels depend on it, never the reverse.
-- **Delas** owns the He4rt Delas tag (request, decision, cooldown, blocks and their history). It depends only on **Identity** (`User`, the `delas-moderator` case of `UserRole`). It renders no UI: `panel-app` (profile request and moderators' queue) and `panel-admin` (direct grant/removal) depend on it, never the reverse.
+- **Delas** owns the He4rt Delas tag (request, decision, cooldown, blocks and their history). It depends only on **Identity** (`User`, the `delas-moderator` case of `UserRole`). It renders no UI: `panel-app` (profile request and tag) and `panel-admin` (moderation in the Moderation cluster: queue, blocks, history, team) depend on it, never the reverse.
diff --git a/app-modules/delas/CONTEXT.md b/app-modules/delas/CONTEXT.md
index 13251ccf8..c561c908a 100644
--- a/app-modules/delas/CONTEXT.md
+++ b/app-modules/delas/CONTEXT.md
@@ -6,8 +6,12 @@ histórico de cada uma dessas decisões.
É um **módulo de domínio puro**: não tem rota, view nem Filament.
-- O `panel-app` mostra a solicitação no perfil e a fila das moderadoras.
-- O `panel-admin` concede e remove a tag direto.
+- O `panel-app` (`/app`) mostra a solicitação no perfil e a tag no card do perfil.
+- O `panel-admin` (`/admin`) tem a moderação, no grupo He4rt Delas do cluster de Moderação
+ (`/admin/mod`): Fila, Bloqueios, Histórico e Equipe (números, conceder e remover a tag,
+ moderadoras). Moderadoras e líderes entram no `/admin` só para isso
+ ([ADR-0003 do identity](../identity/docs/adr/0003-acesso-ao-admin-por-papel-de-moderacao.md)).
+- A logo, a tag e o ícone da He4rt Delas são do design system (módulo `he4rt`).
Os dois painéis dependem deste módulo, e este módulo só depende do `identity`.
@@ -17,13 +21,14 @@ Os dois painéis dependem deste módulo, e este módulo só depende do `identity
## Glossário
-| Termo | Definição | Não confundir com |
-| -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
-| **Tag He4rt Delas** | Marca no perfil de que a pessoa faz parte da He4rt Delas. Existe quando a solicitação dela está `approved`. | Um Badge do `gamification`: badges vêm de XP ou claim, a tag vem de uma decisão. |
-| **Solicitação** | Uma linha em `delas_tag_requests`: o pedido da tag e a decisão sobre ele (`pending`, `approved`, `rejected`, `revoked`). | O cargo `he4rt_delas` do Discord, concedido pelo `/cargo-delas`. Os dois ainda não são sincronizados. |
-| **Moderadora He4rt Delas** | Quem tem a role `delas-moderator` (`UserRole::DelasModerator`) e passa no gate `moderate-delas`. Decide solicitações e bloqueia solicitantes. | A moderação de conteúdo do módulo `moderation` (Case, Appeal, Moderator). |
-| **Líder He4rt Delas** | Quem tem a role `delas-lead` (`UserRole::DelasLead`) e passa no gate `lead-delas`. Tudo o que a moderadora faz, mais gerenciar moderadoras, conceder e remover a tag e ver o histórico completo, no Hub. | Super admin: a líder não entra no `/admin` nem nomeia outras líderes. |
-| **Bloqueio** | Uma linha em `delas_requester_blocks`: impede a pessoa de solicitar a tag até ser desbloqueada. Sempre tem motivo. | Ban ou suspensão (`UserSituation` do `identity`): o bloqueio não afeta a conta nem o resto do Hub. |
-| **Espera** | Prazo depois de uma solicitação `rejected` ou `revoked` em que a pessoa não pode pedir de novo. Padrão de 15 dias (`delas.request_cooldown_days`). | O bloqueio: a espera acaba sozinha, o bloqueio só acaba quando alguém desbloqueia. |
-| **Concessão direta** | Super admin dá a tag sem solicitação e sem espera (`GrantDelasTag`). Encerra um bloqueio ativo, se houver. | Aprovar uma solicitação: aprovar é decisão sobre um pedido que a pessoa fez. |
-| **Histórico** | `delas_transitions`: uma linha por ação (solicitar, aprovar, rejeitar, conceder, remover, bloquear, desbloquear), com quem fez, quando e motivo. | Logs da aplicação: o histórico é dado de domínio, append-only, gravado pelas próprias actions. |
+| Termo | Definição | Não confundir com |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
+| **Tag He4rt Delas** | Marca no perfil de que a pessoa faz parte da He4rt Delas. Existe quando a solicitação dela está `approved`. | Um Badge do `gamification`: badges vêm de XP ou claim, a tag vem de uma decisão. |
+| **Solicitação** | Uma linha em `delas_tag_requests`: o pedido da tag e a decisão sobre ele (`pending`, `approved`, `rejected`, `revoked`). | O cargo `he4rt_delas` do Discord, concedido pelo `/cargo-delas`. Os dois ainda não são sincronizados. |
+| **Moderadora He4rt Delas** | Quem tem a role `delas-moderator` (`UserRole::DelasModerator`) e passa no gate `moderate-delas`. Decide solicitações e bloqueia solicitantes. | A moderação de conteúdo do módulo `moderation` (Case, Appeal, Moderator). |
+| **Líder He4rt Delas** | Quem tem a role `delas-lead` (`UserRole::DelasLead`) e passa no gate `lead-delas`. Tudo o que a moderadora faz, mais gerenciar moderadoras, conceder e remover a tag e ver o histórico completo (página Equipe). | Super admin: no `/admin` a líder só acessa a área da He4rt Delas e não nomeia outras líderes. |
+| **Bloqueio** | Uma linha em `delas_requester_blocks`: impede a pessoa de solicitar a tag até ser desbloqueada. Sempre tem motivo. | Ban ou suspensão (`UserSituation` do `identity`): o bloqueio não afeta a conta nem o resto do Hub. |
+| **Espera** | Prazo depois de uma solicitação `rejected` ou `revoked` em que a pessoa não pode pedir de novo. Padrão de 15 dias (`delas.request_cooldown_days`). | O bloqueio: a espera acaba sozinha, o bloqueio só acaba quando alguém desbloqueia. |
+| **Concessão direta** | Líder (ou super admin) dá a tag sem solicitação e sem espera (`GrantDelasTag`). Encerra um bloqueio ativo, se houver. | Aprovar uma solicitação: aprovar é decisão sobre um pedido que a pessoa fez. |
+| **Histórico** | `delas_transitions`: uma linha por ação (solicitar, aprovar, rejeitar, conceder, remover, bloquear, desbloquear), com quem fez, quando e motivo. | Logs da aplicação: o histórico é dado de domínio, append-only, gravado pelas próprias actions. |
+| **Candidatas** | Quem pode ser escolhida nos seletores de pessoa da Equipe (`DelasCandidates`): conceder lista quem não tem a tag, remover lista só quem tem, adicionar moderadora exclui super admins e a equipe. Quem age nunca aparece. | A regra de negócio: a consulta só filtra a lista; quem valida a ação são as actions de domínio. |
diff --git a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
index 900a57f8f..30d4ad5f8 100644
--- a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
+++ b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
@@ -8,6 +8,7 @@ deciders:
- damacosta
related:
spec: 2026-10-06-he4rt-delas-tag-e-moderacao
+ adr: identity/0003-acesso-ao-admin-por-papel-de-moderacao
---
# ADR-0001: Módulo próprio, papel do Spatie e histórico de decisões
@@ -36,8 +37,8 @@ precisa morar em algum lugar e ter uma forma de autorizar quem decide.
- **Módulo de domínio `delas`**, dependente só do `identity`. Os painéis dependem dele.
- **Papéis `delas-moderator` e `delas-lead`** como cases de `UserRole` no `identity`, criados por
migration, como a role `streamer`. A líder gerencia moderadoras, concede e remove a tag e vê o
- histórico completo, tudo no Hub. _Vai além da #570_ ("atribuível apenas por admins do Hub"):
- dá autonomia à He4rt Delas sem abrir o `/admin`.
+ histórico completo. _Vai além da #570_ ("atribuível apenas por admins do Hub"): dá autonomia à
+ He4rt Delas sem depender de super admin no dia a dia.
- **Gates nomeados no `DelasServiceProvider`**: `moderate-delas` (moderadora ou líder) e
`lead-delas` (líder). Super admins passam nos dois pelo `Gate::before` do identity.
O código checa o gate, nunca o nome da role.
@@ -50,18 +51,41 @@ precisa morar em algum lugar e ter uma forma de autorizar quem decide.
quem bloqueou ou por super admin.
- **Histórico append-only** em `delas_transitions`, gravado pelas actions, sem trigger (ADR-0003
do `events`).
-- **Tudo no Hub.** Moderadoras, líderes e super admins usam a mesma página He4rt Delas no `/app`,
- que mostra mais partes conforme o papel. No `/admin` fica só a atribuição dos papéis, pela
- seção Papéis do formulário de usuário que já existe.
- - _Alternativas descartadas:_ um cluster He4rt Delas no `/admin` (dois lugares para manter, e
- líderes não entram no `/admin`) e abrir o `/admin` para moderadoras (contradiz a ADR-0002
- do `identity`: "o painel inteiro é super admin ou nada").
+- **Moderação no `/admin`, pedido e tag no `/app`.** Moderação na He4rt mora no `/admin`, no
+ cluster de Moderação (`/admin/mod`). A He4rt Delas entra nele como o grupo "He4rt Delas" da
+ subnavegação, com uma página por parte, cada uma com o próprio gate:
+ - Fila (`moderate-delas`, badge de pendentes): aprovar, rejeitar e bloquear;
+ - Bloqueios (`moderate-delas`, badge de bloqueios ativos): desbloquear;
+ - Histórico (`moderate-delas`): só decisões para a moderadora, completo e com filtro para a
+ líder;
+ - Equipe (`lead-delas`): números, conceder e remover a tag, adicionar e revogar moderadora.
+
+ No `/app` ficam só o pedido no perfil (`DelasProfileSection`) e a tag no card do perfil. A
+ atribuição de `delas-lead` continua pela seção Papéis do `UserForm`, só para super admin.
+ - _Antes:_ tudo ficava numa página He4rt Delas no `/app`, porque a ADR-0002 do `identity`
+ dizia que o `/admin` era "super admin ou nada". A
+ [ADR-0003 do `identity`](../../../identity/docs/adr/0003-acesso-ao-admin-por-papel-de-moderacao.md)
+ substitui essa regra: papéis de moderação entram no `/admin` e cada Resource, Page e Cluster
+ decide no `canAccess()`. Assim, a alternativa "abrir o `/admin` para moderadoras" deixa de
+ ser descartada e vira a decisão.
+ - _Alternativa descartada:_ manter a moderação no `/app`. Criaria um segundo lugar de
+ moderação, fora do cluster que já existe.
+
+- **Seletores de pessoa como consulta de domínio** (`DelasCandidates`): conceder lista quem não tem
+ a tag, remover lista só quem tem, adicionar moderadora exclui super admins, moderadoras e
+ líderes, e a própria pessoa que age nunca aparece. As telas só chamam a consulta.
+- **Marca no design system.** A logo, a tag e o ícone `he4rt-delas` moram no módulo `he4rt`
+ (`x-he4rt::delas.logo`, `x-he4rt::delas.tag`), porque os dois painéis usam. A paleta
+ `--color-delas-*` está no tema dos dois painéis.
## Consequências
- O `identity` ganha um case em `UserRole`, uma migration de role e um state de factory.
- O campo de roles do `UserForm` passa a ser visível só para super admin. Fora de produção o
`/admin` é aberto, e sem isso qualquer pessoa autenticada se daria `delas-moderator`.
+- `delas-moderator` e `delas-lead` entram no `/admin` (`UserRole::grantsAdminAccess()`), mas só
+ acessam o Dashboard (sem widgets) e as páginas da He4rt Delas. Todo o resto do admin tem o
+ trait `SuperAdminOnly`, e um teste de varredura cobra isso.
- Papéis alterados pelas actions do delas entram no histórico. Os alterados direto no `UserForm`
não: essa auditoria é concern do `identity` e vale para todas as roles.
- Sincronizar a tag com o cargo `he4rt_delas` do Discord fica para depois. Os eventos de domínio
diff --git a/app-modules/panel-admin/CONTEXT.md b/app-modules/panel-admin/CONTEXT.md
index 9f8c58a92..45815fd9e 100644
--- a/app-modules/panel-admin/CONTEXT.md
+++ b/app-modules/panel-admin/CONTEXT.md
@@ -23,7 +23,7 @@ The admin panel (`/admin`) is the operational hub for the He4rt Developers commu
Panel Admin is a **view layer** module. It:
-- **Reads from** `activity` (messages, voice), `identity` (external identities), `moderation` (cases, appeals, actions), `community` (retrospectives)
+- **Reads from** `activity` (messages, voice), `identity` (external identities), `moderation` (cases, appeals, actions), `community` (retrospectives), `delas` (tag requests, blocks, history)
- **Writes only editorial state** it is the operator UI for: the retrospective's texts, period and
`deck_config` curation. Everything that computes or freezes data goes through a domain Action
(`PublishRetrospective`), never through the panel
@@ -42,9 +42,12 @@ panel-admin/
│ │ │ └── MeetingShowcasePage.php
│ │ └── Widgets/
│ │ └── DiscordStatsWidget.php
+│ ├── Concerns/
+│ │ └── SuperAdminOnly.php
│ ├── Moderation/
│ │ ├── ModerationCluster.php
│ │ ├── Pages/
+│ │ │ └── Delas/ (He4rt Delas: queue, blocks, history, team)
│ │ ├── Resources/
│ │ ├── Widgets/
│ │ └── Livewire/
@@ -60,6 +63,21 @@ panel-admin/
└── docs/adr/
```
+## Access
+
+Entering `/admin` does not unlock anything by itself
+([identity ADR-0003](../identity/docs/adr/0003-acesso-ao-admin-por-papel-de-moderacao.md)):
+
+- In production, `User::canAccessPanel('admin')` admits super admins and every role whose
+ `UserRole::grantsAdminAccess()` is true (today, the He4rt Delas moderator and lead).
+- Every Resource, Page and Cluster uses the `He4rt\PanelAdmin\Concerns\SuperAdminOnly` trait,
+ except the He4rt Delas pages (gated by `moderate-delas` / `lead-delas`), the shared
+ `ModerationCluster` and the `Dashboard` entry page (whose widgets are super-admin only).
+- `buildNavigation()` adds items through `itemsFor()`, which drops anything the user cannot
+ access (clusters via `canAccessClusteredComponents()`).
+- `tests/Feature/Authorization/AdminComponentAccessTest.php` sweeps every component: a new
+ Resource or Page without the trait breaks it.
+
## Navigation pattern
Each cluster has a dedicated navigation builder method in `PanelAdminServiceProvider`. When the URL path contains the cluster slug (e.g. `marketing/`), the sidebar switches to show a "Back to Admin" link + the cluster's sub-navigation. Default navigation shows all clusters as top-level items.
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index 989787a3e..d9d52b177 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -6,13 +6,14 @@ date: 2026-10-06
author: damacosta
related:
issues: [570, 571]
- modules: [delas, identity, panel-app, panel-admin]
+ modules: [delas, identity, panel-app, panel-admin, he4rt]
+ adr: identity/0003-acesso-ao-admin-por-papel-de-moderacao
---
# He4rt Delas: solicitação da tag e painel de moderação
-Spec cross-module: cria o módulo `delas` e altera `identity`, `panel-app` e `panel-admin`. Por
-isso fica em `docs/specs/` e não dentro de um módulo.
+Spec cross-module: cria o módulo `delas` e altera `identity`, `panel-app`, `panel-admin` e o
+design system (`he4rt`). Por isso fica em `docs/specs/` e não dentro de um módulo.
## Contexto
@@ -35,7 +36,11 @@ Fatos do código atual que moldam o desenho:
`IdentityServiceProvider` libera tudo para `super-admin`. O precedente de papel comum é
`streamer`, verificado por `Gate::define('use-streamer-tools')`.
- **Fora de produção, o `/admin` é aberto a qualquer usuário autenticado**
- (`User::canAccessPanel`).
+ (`User::canAccessPanel`). Em produção, entram super admins e os papéis de moderação
+ ([ADR-0003 do identity](../../app-modules/identity/docs/adr/0003-acesso-ao-admin-por-papel-de-moderacao.md),
+ que substitui o "super admin ou nada" da ADR-0002). Em qualquer ambiente, cada Resource, Page e
+ Cluster do admin decide no `canAccess()`.
+- **Moderação mora no `/admin`**, no cluster de Moderação (`/admin/mod`).
- **Não há perfil público.** "Exibir no perfil" significa a página de perfil do `/app`
(`panel-app/src/Pages/ProfilePage.php`) e o card de preview
(`components/profile-preview-card.blade.php`), visíveis só para a própria pessoa.
@@ -43,7 +48,8 @@ Fatos do código atual que moldam o desenho:
## Objetivos
1. Uma membra solicita a tag He4rt Delas no próprio perfil e acompanha o status.
-2. Moderadoras da He4rt Delas veem a fila de pendentes no Hub e aprovam, rejeitam ou bloqueiam.
+2. Moderadoras da He4rt Delas veem a fila de pendentes no `/admin`, no cluster de Moderação, e
+ aprovam, rejeitam ou bloqueiam.
3. Super admins atribuem o papel de moderadora e podem conceder ou remover a tag diretamente.
4. Toda decisão sobre a tag fica registrada com quem fez, quando e o motivo.
5. Toda regra de acesso é aplicada no domínio, não só ocultando a interface.
@@ -88,12 +94,13 @@ Fatos do código atual que moldam o desenho:
### Liderança (líderes da He4rt Delas)
Papel `delas-lead`, atribuído só por super admins, no `/admin`. A líder trabalha **na mesma
-página do Hub**, sem acesso ao `/admin`, e tem tudo o que a moderadora tem, mais:
+área do `/admin` que as moderadoras** (o grupo He4rt Delas do cluster de Moderação) e tem tudo o
+que a moderadora tem, mais:
-- números da He4rt Delas no topo da página;
-- histórico completo;
-- aba Moderadoras: adiciona e revoga `delas-moderator`. Não cria nem revoga líderes, e não age
- sobre super admins;
+- página Equipe, com os números da He4rt Delas no topo;
+- histórico completo, com filtro por ação;
+- na Equipe, adiciona e revoga `delas-moderator`. Não cria nem revoga líderes, e não age sobre
+ super admins;
- desbloqueia qualquer bloqueio;
- concede e remove a tag direto:
- se houver solicitação `pending`, ela é aprovada (`pending → approved`);
@@ -109,10 +116,10 @@ página do Hub**, sem acesso ao `/admin`, e tem tudo o que a moderadora tem, mai
### Administração (super admins)
-- No `/admin`, a única coisa da He4rt Delas é atribuir e retirar `delas-lead` e `delas-moderator`,
- pela seção Papéis do formulário de usuário (`UserForm`), que já existe. O acesso some na
- próxima requisição, porque `hasRole` lê `model_has_roles` a cada request.
-- No Hub, passam em todos os gates (via `Gate::before`) e veem a página He4rt Delas como uma
+- Atribuem e retiram `delas-lead` e `delas-moderator` pela seção Papéis do formulário de usuário
+ (`UserForm`), que já existe. O acesso some na próxima requisição, porque `hasRole` lê
+ `model_has_roles` a cada request.
+- Passam em todos os gates (via `Gate::before`) e veem as páginas da He4rt Delas como uma
líder.
### Espera de 15 dias
@@ -177,6 +184,12 @@ O case precisa morar em `UserRole` porque enums não são extensíveis por outro
- "Não bloquear moderadora ou admin" é `Gate::forUser($target)->allows('moderate-delas')`.
- O `CheckboxList` de roles do `UserForm` passa a ser visível só para `isSuperAdmin()`. Sem
isso, fora de produção qualquer pessoa autenticada atribuiria `delas-moderator`.
+- Acesso ao `/admin` (ADR-0003 do identity): `UserRole::grantsAdminAccess()` diz se o papel entra
+ (`match` sem `default`), e `User::canAccessPanel('admin')` em produção usa
+ `hasAnyRole(UserRole::withAdminAccess())`. Dentro do painel, todo Resource, Page e Cluster que
+ não é da He4rt Delas tem o trait `SuperAdminOnly`; o Dashboard é a página de entrada, com os
+ widgets só para super admin. A sidebar (`PanelAdminServiceProvider::buildNavigation()`) só
+ mostra o que passa no `canAccess()`.
### Modelo de dados
@@ -289,32 +302,31 @@ dispara também `DelasRequesterUnblocked`. Nenhum listener nesta entrega.
**Hub (`/app`, `panel-app`)**
-- Perfil (`ProfilePage`): seção He4rt Delas com toggle e pop-up de confirmação, estado pendente,
- data da próxima tentativa ou aviso de bloqueio. Tag no card de preview, separada dos badges.
- Textos em `panel-app/lang/{en,pt_BR}/profile.php`.
-- Página He4rt Delas (nova), registrada em `AppPanelProvider->pages([...])`, com
- `canAccess(): auth()->user()?->can('moderate-delas') ?? false`, como as páginas de streaming.
- O conteúdo depende do papel:
-
- | Parte da página | Moderadora | Líder e super admin |
- | -------------------------------------------------------------------------------------------------------------------------- | :---------: | :------------------: |
- | Pendentes: aprovar, rejeitar, bloquear | ✓ | ✓ |
- | Bloqueios: desbloquear | os próprios | todos |
- | Histórico | decisões | completo, com filtro |
- | Números no topo (pendentes, membras com a tag, tempo médio até a decisão, aprovadas e rejeitadas no mês, bloqueios ativos) | | ✓ |
- | Moderadoras: adicionar e revogar `delas-moderator` | | ✓ |
- | Conceder e remover a tag direto | | ✓ |
-
- Base visual: `panel-admin/src/Moderation/Livewire/AppealQueue.php`.
+- Perfil (`ProfilePage`): seção He4rt Delas (`DelasProfileSection`) com toggle e pop-up de
+ confirmação, estado pendente, data da próxima tentativa ou aviso de bloqueio. Tag no card de
+ preview, separada dos badges. Textos em `panel-app/lang/{en,pt_BR}/delas.php`.
+- Nada de moderação no `/app`.
**Admin (`/admin`, `panel-admin`)**
-Sem cluster nem página da He4rt Delas. Só:
-
-- a seção Papéis do `UserForm`, onde super admins atribuem `delas-lead` e `delas-moderator`,
- visível só para super admins (fora de produção o `/admin` é aberto a qualquer pessoa
- autenticada);
-- a tabela de Usuários, que só **mostra** as roles (badges), sem coluna da tag nem ações.
+- Moderação no `ModerationCluster` (`/admin/mod`), no grupo "He4rt Delas" da subnavegação, com
+ uma página por parte. A subnavegação do cluster já filtra por `canAccess()`, então cada pessoa
+ só vê as páginas do próprio papel. Textos em `panel-admin/lang/{en,pt_BR}/delas.php`.
+
+ | Página | `canAccess()` | Badge | Conteúdo |
+ | --------- | ---------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+ | Fila | `moderate-delas` | pendentes | aprovar, rejeitar, bloquear |
+ | Bloqueios | `moderate-delas` | bloqueios ativos | desbloquear (moderadora: os próprios; líder: todos) |
+ | Histórico | `moderate-delas` | | moderadora: decisões; líder: completo, com filtro por ação |
+ | Equipe | `lead-delas` | | números (pendentes, membras com a tag, tempo médio até a decisão, aprovadas e rejeitadas no mês, bloqueios ativos), conceder e remover a tag, adicionar e revogar moderadora |
+
+- Os seletores de pessoa da Equipe usam a consulta de domínio `DelasCandidates`: conceder e
+ adicionar moderadora buscam por nome ou `@username` (a lista é a comunidade inteira); remover
+ já vem carregado só com quem tem a tag. Quem age nunca aparece.
+- Cada tabela declara o eager load (`user.roles` na fila, `user` e `blocker` nos bloqueios,
+ `user` e `actor` no histórico, `roles` na equipe).
+- A seção Papéis do `UserForm`, onde super admins atribuem `delas-lead` e `delas-moderator`,
+ visível só para super admins; a tabela de Usuários só **mostra** as roles (badges).
### Identidade visual
@@ -325,13 +337,13 @@ Sem cluster nem página da He4rt Delas. Só:
menu e o botão principal do pedido ("Enviar solicitação" e o toggle do perfil). Sem degradês e
sem fundos rosados.
- Paleta He4rt Delas (primária `#F485A2`; 50 `#FFD1EE` → 900 `#730835`) como cores `delas-*` no
- `@theme` do tema do Hub (`resources/css/filament/app/theme.css`), que é o CSS que o `/app`
- carrega; o design system de `app-modules/he4rt` não é importado pelo painel.
+ `@theme` dos temas dos dois painéis (`resources/css/filament/{app,admin}/theme.css`).
- A tag usa o rosa claro com texto e ícone no tom 900. Texto branco só do tom 600 para cima
(WCAG AA).
-- Logos oficiais (ícone, vertical e horizontal) no componente `x-panel-app::delas.logo`
- (`currentColor`); o ícone do menu é o set de ícones `he4rt` (`he4rt-delas`), com a cor da
- marca no próprio SVG.
+- Logos oficiais (ícone, vertical e horizontal) no componente `x-he4rt::delas.logo`
+ (`currentColor`) e a tag em `x-he4rt::delas.tag`, no design system (módulo `he4rt`), porque
+ os dois painéis usam. O ícone `he4rt-delas` é registrado pelo `He4rtServiceProvider` como set
+ de ícones `he4rt`, com a cor da marca no próprio SVG.
- Protótipo de referência validado com a Danielle; tokens e assets a confirmar com a Sther.
## Trade-offs e alternativas consideradas
@@ -343,6 +355,7 @@ Sem cluster nem página da He4rt Delas. Só:
| Tipo dentro de `onboarding` | Onboarding é a camada de entrada obrigatória; a tag é opcional e pode vir a qualquer momento |
| Subdomínio em `profile` | Acoplaria o perfil a moderação e papéis; um módulo próprio isola a feature e as regras |
| Permissions granulares (`delas.solicitacoes.decidir` etc.) | A ADR-0002 adota só roles nesta fase; gates nomeados permitem migrar depois sem mudar chamadas |
+| Moderação numa página única no `/app` | Era a primeira versão. Criaria um segundo lugar de moderação, fora do cluster que já existe |
## Testes
@@ -361,8 +374,14 @@ unitários em `delas/tests/Unit`.
- Admin: concede com pendente aberta (aprova), sem solicitação (cria), já aprovada (recusa) e
bloqueada (encerra o bloqueio); remove a tag.
- Papel: perde acesso ao retirar `delas-moderator`; o campo de roles não aparece para quem não é
- super admin.
-- Páginas: seção He4rt Delas do Hub invisível e inacessível sem `moderate-delas`.
+ super admin; papéis de moderação entram no `/admin` em produção, `streamer` não.
+- Candidatas (`DelasCandidates`): um teste por escopo (conceder, remover, adicionar moderadora,
+ quem age nunca aparece) e a busca.
+- Páginas do admin (`panel-admin/tests/Feature/Moderation/Delas`): gate de cada página, badges,
+ ações, busca e rótulo dos seletores, com eager load automático desligado e lazy loading
+ proibido, e pelo menos dois registros por tabela.
+- Varredura: no `/admin`, a moderadora só acessa o Dashboard e as páginas da He4rt Delas; quem
+ não tem papel, só o Dashboard.
- Arch (opcional): `He4rt\Delas` não importa `He4rt\Panel*`.
Validação: `make check`, `make test` e `make test-shards`.
From a37a7bccf6a3270fa0a1b44f24246d6ed5808555 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 16:41:23 -0300
Subject: [PATCH 23/77] =?UTF-8?q?test(panel-admin):=20UserResource=20fecha?=
=?UTF-8?q?do=20para=20quem=20n=C3=A3o=20=C3=A9=20super=20admin?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Com o SuperAdminOnly, quem não é super admin (inclusive líder da He4rt
Delas, que agora entra no /admin) recebe 403 ao abrir o form de usuário,
então os testes de papéis passam a cobrir o 403 em vez do campo oculto.
---
.../tests/Feature/Identity/UserResourceTest.php | 17 +++++++++--------
1 file changed, 9 insertions(+), 8 deletions(-)
diff --git a/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php b/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php
index 332da6559..da32bbb9f 100644
--- a/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php
+++ b/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php
@@ -265,11 +265,12 @@
$this->actingAs($member);
+ // Desde a ADR-0003 do identity, o UserResource é só de super admin: o form nem abre.
livewire(EditUser::class, ['record' => $member->getKey()])
- ->fillForm(['roles' => [$superAdmin->getKey()]])
- ->call('save');
+ ->assertForbidden();
- expect($member->fresh()?->hasRole(UserRole::SuperAdmin))->toBeFalse();
+ expect($member->fresh()?->hasRole(UserRole::SuperAdmin))->toBeFalse()
+ ->and($superAdmin->exists)->toBeTrue();
});
test('a opção de super admin fica livre ao editar outro usuário', function (): void {
@@ -295,12 +296,12 @@
->assertCanNotSeeTableRecords([$regular]);
});
-test('quem não é super admin não vê os papéis no form', function (): void {
+test('quem não é super admin não abre o form de usuário, mesmo com papel que entra no admin', function (): void {
$this->actingAs(User::factory()->delasLead()->create());
$other = User::factory()->create();
livewire(EditUser::class, ['record' => $other->getKey()])
- ->assertFormFieldHidden('roles');
+ ->assertForbidden();
});
test('quem não é super admin não concede papéis nem forçando o estado do form', function (): void {
@@ -309,10 +310,10 @@
$role = Role::findByName(UserRole::DelasModerator->value, UserRole::GUARD);
livewire(EditUser::class, ['record' => $other->getKey()])
- ->set('data.roles', [$role->getKey()])
- ->call('save');
+ ->assertForbidden();
- expect($other->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse();
+ expect($other->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse()
+ ->and($role->exists)->toBeTrue();
});
test('salvar o form concede um papel da He4rt Delas a outro usuário', function (UserRole $role): void {
From 9c2db82b474408482369c8f362142b7b5ac62c82 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 17:06:59 -0300
Subject: [PATCH 24/77] fix(panel-admin): seletores de pessoa abrem com a lista
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Conceder tag e adicionar moderadora mostravam "Nenhuma opção" até a
pessoa digitar. Agora abrem com as primeiras pessoas do escopo e a busca
continua filtrando a comunidade inteira.
---
.../src/Moderation/Pages/Delas/DelasTeamPage.php | 3 +++
.../Feature/Moderation/Delas/DelasModerationPagesTest.php | 7 ++++++-
2 files changed, 9 insertions(+), 1 deletion(-)
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
index b1d4c1a7c..306fa695b 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
@@ -196,6 +196,9 @@ private function searchablePersonSelect(Closure $candidates): Select
->helperText(__('panel-admin::delas.actions.person_hint'))
->required()
->searchable()
+ // Abre já com as primeiras pessoas do escopo; digitar filtra pela comunidade inteira.
+ ->options(fn (): array => $this->optionsFor($this->candidates()->search($candidates(), '')))
+ ->preload()
->getSearchResultsUsing(fn (string $search): array => $this->optionsFor(
$this->candidates()->search($candidates(), $search),
))
diff --git a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
index 7a31d3fd6..2ebf6031f 100644
--- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
+++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
@@ -315,7 +315,12 @@ function mountedPersonSelect(Testable $page): Select
$page = livewire(DelasTeamPage::class)->mountAction('grant');
$select = mountedPersonSelect($page);
- expect($select->getSearchResults('ana'))->toBe([$ana->getKey() => 'Ana Souza (@anasouza)']);
+ expect($select->getSearchResults('ana'))->toBe([$ana->getKey() => 'Ana Souza (@anasouza)'])
+ // Abre já com a lista, sem precisar digitar: quem tem a tag e a própria líder não aparecem.
+ ->and($select->isPreloaded())->toBeTrue()
+ ->and($select->getOptions())->toHaveKey($ana->getKey())
+ ->and($select->getOptions())->not->toHaveKey($member->getKey())
+ ->and($select->getOptions())->not->toHaveKey($lead->getKey());
$page->fillForm(['user_id' => $ana->getKey()]);
expect(mountedPersonSelect($page)->getOptionLabel())->toBe('Ana Souza (@anasouza)');
From 5fbaf0029c47396bda0fb0fbc4e20596f99a2923 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 17:07:32 -0300
Subject: [PATCH 25/77] feat(panel-admin): marca da He4rt Delas no menu do
admin
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
O grupo He4rt Delas da Moderação ganha o ícone da marca, e o menu
principal ganha um atalho para a fila, com o contador de pendentes,
para quem modera.
---
.../src/PanelAdminServiceProvider.php | 52 ++++++++++++++++++-
.../AdminComponentAccessTest.php | 17 +++++-
2 files changed, 66 insertions(+), 3 deletions(-)
diff --git a/app-modules/panel-admin/src/PanelAdminServiceProvider.php b/app-modules/panel-admin/src/PanelAdminServiceProvider.php
index 714f16ce4..8116782a1 100644
--- a/app-modules/panel-admin/src/PanelAdminServiceProvider.php
+++ b/app-modules/panel-admin/src/PanelAdminServiceProvider.php
@@ -31,8 +31,10 @@
use He4rt\PanelAdmin\Moderation\Livewire\ModerationDashboardLivewire;
use He4rt\PanelAdmin\Moderation\Livewire\ModerationQueue;
use He4rt\PanelAdmin\Moderation\ModerationCluster;
+use He4rt\PanelAdmin\Moderation\Pages\Delas\DelasQueuePage;
use He4rt\PanelAdmin\Pages\Dashboard;
use He4rt\PanelAdmin\Twitch\TwitchCluster;
+use Illuminate\Contracts\Support\Arrayable;
use Illuminate\Support\ServiceProvider;
use Livewire\Livewire;
@@ -160,6 +162,7 @@ private function defaultNavigation(NavigationBuilder $builder): NavigationBuilde
->items([
...$this->itemsFor(Dashboard::class),
...$this->itemsFor(ModerationCluster::class),
+ ...$this->delasShortcut(),
...$this->itemsFor(MarketingCluster::class),
...$this->itemsFor(TwitchCluster::class),
...$this->itemsFor(GithubCluster::class),
@@ -212,7 +215,54 @@ private function moderationNavigation(NavigationBuilder $builder): NavigationBui
->icon('heroicon-o-arrow-left')
->url(Dashboard::getUrl()),
- ])->groups(resolve(ModerationCluster::class)->getCachedSubNavigation());
+ ])->groups(array_map(
+ $this->brandDelasGroup(...),
+ resolve(ModerationCluster::class)->getCachedSubNavigation(),
+ ));
+ }
+
+ /**
+ * Atalho para a fila da He4rt Delas no menu principal, com a marca, para quem
+ * modera. A moderação mora no cluster de Moderação; o atalho só encurta o caminho.
+ *
+ * @return array
+ */
+ private function delasShortcut(): array
+ {
+ if (!DelasQueuePage::canAccess()) {
+ return [];
+ }
+
+ return [
+ NavigationItem::make(__('panel-admin::delas.navigation.group'))
+ ->icon('he4rt-delas')
+ ->sort(11)
+ ->badge(DelasQueuePage::getNavigationBadge())
+ ->url(DelasQueuePage::getUrl()),
+ ];
+ }
+
+ /**
+ * O grupo He4rt Delas na subnavegação leva o ícone da marca. O Filament não
+ * aceita ícone no grupo e nos itens ao mesmo tempo, então os itens ficam sem.
+ */
+ private function brandDelasGroup(NavigationGroup $group): NavigationGroup
+ {
+ if ($group->getLabel() !== __('panel-admin::delas.navigation.group')) {
+ return $group;
+ }
+
+ $items = [];
+
+ $groupItems = $group->getItems();
+
+ foreach ($groupItems instanceof Arrayable ? $groupItems->toArray() : $groupItems as $item) {
+ if ($item instanceof NavigationItem) {
+ $items[] = $item->icon(icon: null);
+ }
+ }
+
+ return $group->icon('he4rt-delas')->items($items);
}
private function discordNavigation(NavigationBuilder $builder): NavigationBuilder
diff --git a/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php b/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php
index 0d7cf891d..c462aad37 100644
--- a/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php
+++ b/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php
@@ -111,7 +111,7 @@ function adminComponents(): array
}
});
-test('a sidebar da moderadora mostra só o Dashboard e a Moderação', function (): void {
+test('a sidebar da moderadora mostra só o Dashboard, a Moderação e o atalho da He4rt Delas', function (): void {
actingAs(User::factory()->delasModerator()->create());
$labels = collect(Filament::getPanel('admin')->getNavigation())
@@ -119,5 +119,18 @@ function adminComponents(): array
->map(fn (NavigationItem $item): string => $item->getLabel())
->all();
- expect($labels)->toBe(['Dashboard', __('panel-admin::moderation.navigation.cluster')]);
+ expect($labels)->toBe([
+ 'Dashboard',
+ __('panel-admin::moderation.navigation.cluster'),
+ __('panel-admin::delas.navigation.group'),
+ ]);
+});
+
+test('super admin também vê o atalho da He4rt Delas', function (): void {
+ actingAs(User::factory()->superAdmin()->create());
+ $superAdminLabels = collect(Filament::getPanel('admin')->getNavigation())
+ ->flatMap(fn (NavigationGroup $group): array => $group->getItems())
+ ->map(fn (NavigationItem $item): string => $item->getLabel());
+
+ expect($superAdminLabels)->toContain(__('panel-admin::delas.navigation.group'));
});
From 4920b3ac53d1696571850a9ca19306b954dc1fe8 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 17:20:18 -0300
Subject: [PATCH 26/77] =?UTF-8?q?feat(delas):=20corre=C3=A7=C3=A3o=20de=20?=
=?UTF-8?q?motivo=20sem=20apagar=20o=20original?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Um motivo escrito errado é corrigido com uma linha nova no histórico
(reason_corrected) que aponta para a original, que nunca muda. O motivo
guardado na solicitação ou no bloqueio passa a ser o corrigido. Quem
escreveu corrige em até 24 horas (delas.reason_correction_hours); líderes
e super admins, a qualquer momento.
---
app-modules/delas/config/delas.php | 12 ++
...corrects_id_to_delas_transitions_table.php | 32 ++++++
app-modules/delas/lang/en/enums.php | 1 +
app-modules/delas/lang/en/exceptions.php | 3 +
app-modules/delas/lang/pt_BR/enums.php | 1 +
app-modules/delas/lang/pt_BR/exceptions.php | 3 +
.../delas/src/Exceptions/DelasException.php | 15 +++
.../History/Actions/CorrectDelasReason.php | 107 ++++++++++++++++++
.../History/Actions/RecordDelasTransition.php | 2 +
.../delas/src/History/Enums/DelasAction.php | 15 +++
.../src/History/Models/DelasTransition.php | 40 +++++++
.../History/CorrectDelasReasonTest.php | 103 +++++++++++++++++
12 files changed, 334 insertions(+)
create mode 100644 app-modules/delas/database/migrations/2026_10_07_200828_add_corrects_id_to_delas_transitions_table.php
create mode 100644 app-modules/delas/src/History/Actions/CorrectDelasReason.php
create mode 100644 app-modules/delas/tests/Feature/History/CorrectDelasReasonTest.php
diff --git a/app-modules/delas/config/delas.php b/app-modules/delas/config/delas.php
index 83f7cd150..acef7d476 100644
--- a/app-modules/delas/config/delas.php
+++ b/app-modules/delas/config/delas.php
@@ -14,4 +14,16 @@
*/
'request_cooldown_days' => (int) env('DELAS_REQUEST_COOLDOWN_DAYS', 15),
+
+ /*
+ |--------------------------------------------------------------------------
+ | Prazo para corrigir o próprio motivo
+ |--------------------------------------------------------------------------
+ |
+ | Horas em que quem escreveu um motivo pode corrigi-lo. Líderes e super
+ | admins corrigem a qualquer momento. A correção nunca apaga a original.
+ |
+ */
+
+ 'reason_correction_hours' => (int) env('DELAS_REASON_CORRECTION_HOURS', 24),
];
diff --git a/app-modules/delas/database/migrations/2026_10_07_200828_add_corrects_id_to_delas_transitions_table.php b/app-modules/delas/database/migrations/2026_10_07_200828_add_corrects_id_to_delas_transitions_table.php
new file mode 100644
index 000000000..9a9bbe045
--- /dev/null
+++ b/app-modules/delas/database/migrations/2026_10_07_200828_add_corrects_id_to_delas_transitions_table.php
@@ -0,0 +1,32 @@
+foreignUuid('corrects_id')
+ ->nullable()
+ ->after('block_id')
+ ->comment('Linha do histórico cujo motivo esta linha corrige; a original nunca é alterada.')
+ ->constrained('delas_transitions')
+ ->cascadeOnDelete();
+
+ $table->index(['corrects_id', 'created_at'], 'idx_delas_transitions_corrects');
+ });
+ }
+
+ public function down(): void
+ {
+ Schema::table('delas_transitions', static function (Blueprint $table): void {
+ $table->dropIndex('idx_delas_transitions_corrects');
+ $table->dropConstrainedForeignId('corrects_id');
+ });
+ }
+};
diff --git a/app-modules/delas/lang/en/enums.php b/app-modules/delas/lang/en/enums.php
index 7c4e20d72..b2df4cc15 100644
--- a/app-modules/delas/lang/en/enums.php
+++ b/app-modules/delas/lang/en/enums.php
@@ -30,6 +30,7 @@
'blocked' => ['label' => 'Blocked', 'description' => 'The person was prevented from requesting the tag.'],
'unblocked' => ['label' => 'Unblocked', 'description' => 'The person can request the tag again.'],
'moderator_added' => ['label' => 'Moderator added', 'description' => 'A lead gave the He4rt Delas moderator role.'],
+ 'reason_corrected' => ['label' => 'Reason corrected', 'description' => 'The reason of a decision was corrected; the original stays in the history.'],
'moderator_removed' => ['label' => 'Moderator removed', 'description' => 'A lead removed the He4rt Delas moderator role.'],
],
'triggered_by' => [
diff --git a/app-modules/delas/lang/en/exceptions.php b/app-modules/delas/lang/en/exceptions.php
index 963fe7c60..5fc656b5c 100644
--- a/app-modules/delas/lang/en/exceptions.php
+++ b/app-modules/delas/lang/en/exceptions.php
@@ -18,4 +18,7 @@
'cannot_manage_role' => 'Leads and super admins are managed in /admin.',
'already_moderator' => 'This person is already a He4rt Delas moderator.',
'not_moderator' => 'This person is not a He4rt Delas moderator.',
+ 'reason_not_correctable' => 'This history entry has no reason that can be corrected.',
+ 'cannot_correct_reason' => 'Only whoever wrote the reason can correct it, up to :hours hours later. After that, ask a lead.',
+ 'reason_unchanged' => 'The corrected reason is the same as the current one.',
];
diff --git a/app-modules/delas/lang/pt_BR/enums.php b/app-modules/delas/lang/pt_BR/enums.php
index 154821e7e..c605a5285 100644
--- a/app-modules/delas/lang/pt_BR/enums.php
+++ b/app-modules/delas/lang/pt_BR/enums.php
@@ -30,6 +30,7 @@
'blocked' => ['label' => 'Bloqueou', 'description' => 'A pessoa foi impedida de solicitar a tag.'],
'unblocked' => ['label' => 'Desbloqueou', 'description' => 'A pessoa voltou a poder solicitar a tag.'],
'moderator_added' => ['label' => 'Moderadora adicionada', 'description' => 'Uma líder deu o papel de moderadora He4rt Delas.'],
+ 'reason_corrected' => ['label' => 'Motivo corrigido', 'description' => 'O motivo de uma decisão foi corrigido; a versão original continua no histórico.'],
'moderator_removed' => ['label' => 'Moderadora removida', 'description' => 'Uma líder retirou o papel de moderadora He4rt Delas.'],
],
'triggered_by' => [
diff --git a/app-modules/delas/lang/pt_BR/exceptions.php b/app-modules/delas/lang/pt_BR/exceptions.php
index dd5f7711e..83038de19 100644
--- a/app-modules/delas/lang/pt_BR/exceptions.php
+++ b/app-modules/delas/lang/pt_BR/exceptions.php
@@ -18,4 +18,7 @@
'cannot_manage_role' => 'Líderes e super admins são gerenciados no /admin.',
'already_moderator' => 'Esta pessoa já é moderadora He4rt Delas.',
'not_moderator' => 'Esta pessoa não é moderadora He4rt Delas.',
+ 'reason_not_correctable' => 'Esta linha do histórico não tem um motivo que possa ser corrigido.',
+ 'cannot_correct_reason' => 'Só quem escreveu o motivo pode corrigi-lo, e até :hours horas depois. Depois disso, peça a uma líder.',
+ 'reason_unchanged' => 'O motivo corrigido é igual ao atual.',
];
diff --git a/app-modules/delas/src/Exceptions/DelasException.php b/app-modules/delas/src/Exceptions/DelasException.php
index 72eab2ea6..9eee3d98b 100644
--- a/app-modules/delas/src/Exceptions/DelasException.php
+++ b/app-modules/delas/src/Exceptions/DelasException.php
@@ -93,6 +93,21 @@ public static function alreadyModerator(): self
return new self(__('delas::exceptions.already_moderator'), Response::HTTP_CONFLICT);
}
+ public static function reasonNotCorrectable(): self
+ {
+ return new self(__('delas::exceptions.reason_not_correctable'), Response::HTTP_UNPROCESSABLE_ENTITY);
+ }
+
+ public static function cannotCorrectReason(int $hours): self
+ {
+ return new self(__('delas::exceptions.cannot_correct_reason', ['hours' => $hours]), Response::HTTP_FORBIDDEN);
+ }
+
+ public static function reasonUnchanged(): self
+ {
+ return new self(__('delas::exceptions.reason_unchanged'), Response::HTTP_UNPROCESSABLE_ENTITY);
+ }
+
public static function notModerator(): self
{
return new self(__('delas::exceptions.not_moderator'), Response::HTTP_UNPROCESSABLE_ENTITY);
diff --git a/app-modules/delas/src/History/Actions/CorrectDelasReason.php b/app-modules/delas/src/History/Actions/CorrectDelasReason.php
new file mode 100644
index 000000000..874aaa06e
--- /dev/null
+++ b/app-modules/delas/src/History/Actions/CorrectDelasReason.php
@@ -0,0 +1,107 @@
+authorize('moderate-delas');
+
+ throw_unless($original->hasCorrectableReason(), DelasException::reasonNotCorrectable());
+
+ $reason = Reason::required($reason);
+
+ $this->ensureCanCorrect($original, $actor);
+
+ return DB::transaction(function () use ($original, $actor, $reason): DelasTransition {
+ $locked = DelasTransition::query()->whereKey($original->getKey())->lockForUpdate()->firstOrFail();
+
+ throw_if($locked->currentReason() === $reason, DelasException::reasonUnchanged());
+
+ $correction = $this->recordTransition->handle(
+ action: DelasAction::ReasonCorrected,
+ subject: $locked->user,
+ actor: $actor,
+ request: $locked->request,
+ block: $locked->block,
+ reason: $reason,
+ corrects: $locked,
+ );
+
+ $this->updateCurrentReason($locked, $reason);
+
+ return $correction;
+ });
+ }
+
+ /**
+ * @throws DelasException
+ */
+ private function ensureCanCorrect(DelasTransition $original, User $actor): void
+ {
+ if (Gate::forUser($actor)->allows('lead-delas')) {
+ return;
+ }
+
+ $hours = config()->integer('delas.reason_correction_hours');
+ $isAuthor = $original->actor_id === $actor->getKey();
+ $isWithinWindow = $original->created_at?->greaterThanOrEqualTo(now()->subHours($hours)) ?? false;
+
+ throw_unless($isAuthor && $isWithinWindow, DelasException::cannotCorrectReason($hours));
+ }
+
+ /**
+ * Leva o motivo corrigido para o registro que a tela mostra hoje, só se esse
+ * registro ainda estiver no estado que a decisão criou.
+ */
+ private function updateCurrentReason(DelasTransition $original, string $reason): void
+ {
+ match ($original->action) {
+ DelasAction::Rejected, DelasAction::Revoked, DelasAction::Granted => $this->updateRequest($original, $reason),
+ DelasAction::Blocked => $original->block?->update(['reason' => $reason]),
+ DelasAction::Unblocked => $original->block?->update(['lift_reason' => $reason]),
+ default => null,
+ };
+ }
+
+ private function updateRequest(DelasTransition $original, string $reason): void
+ {
+ $request = $original->request;
+
+ if ($request instanceof DelasTagRequest && $request->status === $original->to_status) {
+ $request->update(['decision_reason' => $reason]);
+ }
+ }
+}
diff --git a/app-modules/delas/src/History/Actions/RecordDelasTransition.php b/app-modules/delas/src/History/Actions/RecordDelasTransition.php
index 61ba8afd6..6c774bf99 100644
--- a/app-modules/delas/src/History/Actions/RecordDelasTransition.php
+++ b/app-modules/delas/src/History/Actions/RecordDelasTransition.php
@@ -27,11 +27,13 @@ public function handle(
?DelasRequestStatus $from = null,
?DelasRequestStatus $to = null,
?string $reason = null,
+ ?DelasTransition $corrects = null,
): DelasTransition {
return DelasTransition::query()->create([
'user_id' => $subject->getKey(),
'request_id' => $request?->getKey(),
'block_id' => $block?->getKey(),
+ 'corrects_id' => $corrects?->getKey(),
'action' => $action,
'from_status' => $from,
'to_status' => $to,
diff --git a/app-modules/delas/src/History/Enums/DelasAction.php b/app-modules/delas/src/History/Enums/DelasAction.php
index 88e348bfd..ae232ddff 100644
--- a/app-modules/delas/src/History/Enums/DelasAction.php
+++ b/app-modules/delas/src/History/Enums/DelasAction.php
@@ -28,6 +28,7 @@ enum DelasAction: string implements HasColor, HasDescription, HasIcon, HasLabel
case Unblocked = 'unblocked';
case ModeratorAdded = 'moderator_added';
case ModeratorRemoved = 'moderator_removed';
+ case ReasonCorrected = 'reason_corrected';
public function getLabel(): string
{
@@ -52,6 +53,7 @@ public function getColor(): array
self::Unblocked => Color::Sky,
self::ModeratorAdded => Color::Indigo,
self::ModeratorRemoved => Color::Slate,
+ self::ReasonCorrected => Color::Yellow,
};
}
@@ -72,6 +74,19 @@ public function getIcon(): Heroicon
self::Unblocked => Heroicon::OutlinedLockOpen,
self::ModeratorAdded => Heroicon::OutlinedUserPlus,
self::ModeratorRemoved => Heroicon::OutlinedUserMinus,
+ self::ReasonCorrected => Heroicon::OutlinedPencilSquare,
+ };
+ }
+
+ /**
+ * Ações cujo motivo pode ser corrigido depois. A correção é uma linha nova
+ * no histórico; a original nunca muda.
+ */
+ public function hasCorrectableReason(): bool
+ {
+ return match ($this) {
+ self::Rejected, self::Revoked, self::Granted, self::Blocked, self::Unblocked => true,
+ self::Requested, self::Approved, self::ModeratorAdded, self::ModeratorRemoved, self::ReasonCorrected => false,
};
}
diff --git a/app-modules/delas/src/History/Models/DelasTransition.php b/app-modules/delas/src/History/Models/DelasTransition.php
index 00a1d6863..092a8fbf8 100644
--- a/app-modules/delas/src/History/Models/DelasTransition.php
+++ b/app-modules/delas/src/History/Models/DelasTransition.php
@@ -18,6 +18,7 @@
use Illuminate\Database\Eloquent\Factories\HasFactory;
use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasOne;
/**
* Uma linha do histórico da He4rt Delas. Append-only: a aplicação nunca edita
@@ -27,6 +28,7 @@
* @property string $user_id
* @property string|null $request_id
* @property string|null $block_id
+ * @property string|null $corrects_id
* @property DelasAction $action
* @property DelasRequestStatus|null $from_status
* @property DelasRequestStatus|null $to_status
@@ -34,6 +36,7 @@
* @property DelasTriggeredBy $triggered_by
* @property string|null $reason
* @property CarbonInterface|null $created_at
+ * @property-read DelasTransition|null $latestCorrection
*/
#[Table(name: 'delas_transitions')]
#[UseFactory(factoryClass: DelasTransitionFactory::class)]
@@ -49,6 +52,7 @@ final class DelasTransition extends Model
'user_id',
'request_id',
'block_id',
+ 'corrects_id',
'action',
'from_status',
'to_status',
@@ -81,6 +85,42 @@ public function block(): BelongsTo
return $this->belongsTo(DelasRequesterBlock::class, 'block_id');
}
+ /**
+ * A linha cujo motivo esta corrige (só em linhas `reason_corrected`).
+ *
+ * @return BelongsTo
+ */
+ public function corrected(): BelongsTo
+ {
+ return $this->belongsTo(self::class, 'corrects_id');
+ }
+
+ /**
+ * A correção mais recente do motivo desta linha, se houver.
+ *
+ * @return HasOne
+ */
+ public function latestCorrection(): HasOne
+ {
+ // Sem latestOfMany(): ele desempata por MAX(id), e o Postgres não calcula MAX de UUID.
+ return $this->hasOne(self::class, 'corrects_id')->latest('created_at');
+ }
+
+ /**
+ * O motivo que vale hoje: o da correção mais recente ou o original.
+ */
+ public function currentReason(): ?string
+ {
+ $correction = $this->latestCorrection;
+
+ return $correction instanceof self ? $correction->reason : $this->reason;
+ }
+
+ public function hasCorrectableReason(): bool
+ {
+ return $this->reason !== null && $this->action->hasCorrectableReason();
+ }
+
/** @return array */
protected function casts(): array
{
diff --git a/app-modules/delas/tests/Feature/History/CorrectDelasReasonTest.php b/app-modules/delas/tests/Feature/History/CorrectDelasReasonTest.php
new file mode 100644
index 000000000..f995f307e
--- /dev/null
+++ b/app-modules/delas/tests/Feature/History/CorrectDelasReasonTest.php
@@ -0,0 +1,103 @@
+handle(DelasTagRequest::factory()->pending()->create(), $moderator, $reason);
+
+ return DelasTransition::query()->where('action', DelasAction::Rejected)->latest('created_at')->firstOrFail();
+}
+
+test('a correção é uma linha nova e a original continua como foi escrita', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $original = rejectionBy($moderator);
+
+ $correction = resolve(CorrectDelasReason::class)->handle($original, $moderator, 'Perfil incompleto.');
+
+ expect($correction->action)->toBe(DelasAction::ReasonCorrected)
+ ->and($correction->corrects_id)->toBe($original->getKey())
+ ->and($correction->actor_id)->toBe($moderator->getKey())
+ ->and($original->fresh()->reason)->toBe('Perfil incompleo.')
+ ->and($original->fresh()->currentReason())->toBe('Perfil incompleto.')
+ ->and($original->request->fresh()->decision_reason)->toBe('Perfil incompleto.');
+});
+
+test('vale sempre a correção mais recente', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $original = rejectionBy($moderator);
+
+ resolve(CorrectDelasReason::class)->handle($original, $moderator, 'Primeira correção.');
+ $this->travel(1)->minutes();
+ resolve(CorrectDelasReason::class)->handle($original->fresh(), $moderator, 'Segunda correção.');
+
+ expect($original->fresh()->currentReason())->toBe('Segunda correção.')
+ ->and(DelasTransition::query()->where('corrects_id', $original->getKey())->count())->toBe(2);
+});
+
+test('corrigir o motivo de um bloqueio atualiza o bloqueio', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $block = resolve(BlockDelasRequester::class)->handle(User::factory()->create(), $moderator, 'Pedidos repetidso.');
+ $original = DelasTransition::query()->where('action', DelasAction::Blocked)->sole();
+
+ resolve(CorrectDelasReason::class)->handle($original, $moderator, 'Pedidos repetidos.');
+
+ expect($block->fresh()->reason)->toBe('Pedidos repetidos.');
+});
+
+test('quem escreveu corrige dentro do prazo, mas não depois', function (): void {
+ config(['delas.reason_correction_hours' => 24]);
+ $moderator = User::factory()->delasModerator()->create();
+ $original = rejectionBy($moderator);
+
+ $this->travel(25)->hours();
+
+ expect(fn () => resolve(CorrectDelasReason::class)->handle($original, $moderator, 'Tarde demais.'))
+ ->toThrow(DelasException::class, __('delas::exceptions.cannot_correct_reason', ['hours' => 24]));
+});
+
+test('outra moderadora não corrige o motivo de quem escreveu', function (): void {
+ $original = rejectionBy(User::factory()->delasModerator()->create());
+
+ expect(fn () => resolve(CorrectDelasReason::class)->handle($original, User::factory()->delasModerator()->create(), 'Outro texto.'))
+ ->toThrow(DelasException::class);
+});
+
+test('a líder corrige qualquer motivo, a qualquer momento', function (): void {
+ $original = rejectionBy(User::factory()->delasModerator()->create());
+ $this->travel(30)->days();
+
+ $correction = resolve(CorrectDelasReason::class)->handle($original, User::factory()->delasLead()->create(), 'Motivo revisado pela liderança.');
+
+ expect($original->fresh()->currentReason())->toBe($correction->reason);
+});
+
+test('recusa motivo vazio, motivo igual e linhas sem motivo', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $original = rejectionBy($moderator, 'Motivo.');
+ $approval = DelasTransition::factory()->create(['action' => DelasAction::Approved, 'actor_id' => $moderator->getKey()]);
+
+ expect(fn () => resolve(CorrectDelasReason::class)->handle($original, $moderator, ' '))
+ ->toThrow(DelasException::class, __('delas::exceptions.reason_required'))
+ ->and(fn () => resolve(CorrectDelasReason::class)->handle($original, $moderator, 'Motivo.'))
+ ->toThrow(DelasException::class, __('delas::exceptions.reason_unchanged'))
+ ->and(fn () => resolve(CorrectDelasReason::class)->handle($approval, $moderator, 'Qualquer coisa.'))
+ ->toThrow(DelasException::class, __('delas::exceptions.reason_not_correctable'));
+});
+
+test('quem não modera não corrige nada', function (): void {
+ $original = rejectionBy(User::factory()->delasModerator()->create());
+
+ expect(fn () => resolve(CorrectDelasReason::class)->handle($original, User::factory()->create(), 'Texto.'))
+ ->toThrow(AuthorizationException::class);
+});
From 58b26a27e381b220c7c087a98eea410373966cb2 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 17:20:46 -0300
Subject: [PATCH 27/77] =?UTF-8?q?feat(panel-admin):=20corrigir=20motivo=20?=
=?UTF-8?q?pelo=20hist=C3=B3rico=20da=20He4rt=20Delas?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Botão Corrigir motivo em cada decisão com motivo, para quem pode. A linha
mostra o motivo atual com "Corrigido em ... por ..." e o original na dica.
A líder vê cada correção como linha própria; a moderadora, só o resultado.
---
app-modules/panel-admin/lang/en/delas.php | 8 ++
app-modules/panel-admin/lang/pt_BR/delas.php | 8 ++
.../Pages/Delas/DelasHistoryPage.php | 75 ++++++++++++++++++-
.../Delas/DelasModerationPagesTest.php | 32 ++++++++
4 files changed, 121 insertions(+), 2 deletions(-)
diff --git a/app-modules/panel-admin/lang/en/delas.php b/app-modules/panel-admin/lang/en/delas.php
index d8cf7c4ae..70883cc3f 100644
--- a/app-modules/panel-admin/lang/en/delas.php
+++ b/app-modules/panel-admin/lang/en/delas.php
@@ -57,6 +57,13 @@
'reason_hint' => 'Internal: the person does not see this reason.',
'history_hint' => 'Recorded in the history.',
'actions' => [
+ 'correct_reason' => 'Correct reason',
+ 'correct_reason_heading' => 'Correct the reason',
+ 'correct_reason_body' => 'The original stays in the history. Readers see the corrected reason, with the date and who corrected it.',
+ 'correct_reason_field' => 'Corrected reason',
+ 'reason_corrected' => 'Reason corrected',
+ 'corrected_note' => 'Corrected on :date by :name',
+ 'original_reason' => 'Original: :reason',
'approve' => 'Approve',
'approve_heading' => 'Approve :name?',
'approve_body' => "The He4rt Delas tag will show on @:username's profile.",
@@ -67,6 +74,7 @@
'reject_reason' => 'Rejection reason',
'rejected' => 'Request rejected',
'block' => 'Block',
+ 'block_tooltip' => 'Block: only prevents new tag requests. It is not a ban and does not affect the account.',
'block_heading' => 'Block :name from requesting the tag?',
'block_body' => 'This only blocks requesting the He4rt Delas tag. It is not a ban or suspension and does not affect the account. The pending request will be rejected.',
'block_reason' => 'Block reason',
diff --git a/app-modules/panel-admin/lang/pt_BR/delas.php b/app-modules/panel-admin/lang/pt_BR/delas.php
index 6ed2a2729..ab80993d7 100644
--- a/app-modules/panel-admin/lang/pt_BR/delas.php
+++ b/app-modules/panel-admin/lang/pt_BR/delas.php
@@ -57,6 +57,13 @@
'reason_hint' => 'Uso interno: a pessoa não vê este motivo.',
'history_hint' => 'Fica registrado no histórico.',
'actions' => [
+ 'correct_reason' => 'Corrigir motivo',
+ 'correct_reason_heading' => 'Corrigir o motivo',
+ 'correct_reason_body' => 'A versão original continua no histórico. Quem lê vê o motivo corrigido, com a data e quem corrigiu.',
+ 'correct_reason_field' => 'Motivo corrigido',
+ 'reason_corrected' => 'Motivo corrigido',
+ 'corrected_note' => 'Corrigido em :date por :name',
+ 'original_reason' => 'Original: :reason',
'approve' => 'Aprovar',
'approve_heading' => 'Aprovar :name?',
'approve_body' => 'A tag He4rt Delas passa a aparecer no perfil de @:username.',
@@ -67,6 +74,7 @@
'reject_reason' => 'Motivo da rejeição',
'rejected' => 'Solicitação rejeitada',
'block' => 'Bloquear',
+ 'block_tooltip' => 'Bloquear: impede só novos pedidos da tag. Não é banimento e não afeta a conta.',
'block_heading' => 'Bloquear :name de solicitar a tag?',
'block_body' => 'Isso bloqueia só o pedido da tag He4rt Delas. Não é banimento nem suspensão e não afeta a conta. A solicitação pendente será rejeitada.',
'block_reason' => 'Motivo do bloqueio',
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
index 26163c85f..63c7edd81 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
@@ -5,6 +5,7 @@
namespace He4rt\PanelAdmin\Moderation\Pages\Delas;
use BackedEnum;
+use Filament\Actions\Action;
use Filament\Pages\Page;
use Filament\Support\Icons\Heroicon;
use Filament\Tables\Columns\TextColumn;
@@ -12,6 +13,7 @@
use Filament\Tables\Contracts\HasTable;
use Filament\Tables\Filters\SelectFilter;
use Filament\Tables\Table;
+use He4rt\Delas\History\Actions\CorrectDelasReason;
use He4rt\Delas\History\Enums\DelasAction;
use He4rt\Delas\History\Models\DelasTransition;
use He4rt\PanelAdmin\Moderation\ModerationCluster;
@@ -58,10 +60,11 @@ public function getSubheading(): string
public function table(Table $table): Table
{
- $query = DelasTransition::query()->with(['user', 'actor']);
+ $query = DelasTransition::query()->with(['user', 'actor', 'latestCorrection.actor']);
+ // A moderadora vê as decisões; a líder vê também os pedidos e cada correção de motivo.
if (!$this->isLead()) {
- $query->where('action', '!=', DelasAction::Requested);
+ $query->whereNotIn('action', [DelasAction::Requested, DelasAction::ReasonCorrected]);
}
return $table
@@ -82,14 +85,82 @@ public function table(Table $table): Table
->placeholder('—'),
TextColumn::make('reason')
->label(__('panel-admin::delas.columns.reason'))
+ ->state(fn (DelasTransition $record): ?string => $record->currentReason())
+ ->description(fn (DelasTransition $record): ?string => $this->correctedNote($record))
+ ->tooltip(fn (DelasTransition $record): ?string => $this->originalNote($record))
->wrap()
->lineClamp(2)
->placeholder('—'),
])
+ ->recordActions([
+ Action::make('correctReason')
+ ->label(__('panel-admin::delas.actions.correct_reason'))
+ ->icon(Heroicon::OutlinedPencilSquare)
+ ->color('gray')
+ ->button()
+ ->size('sm')
+ ->visible(fn (DelasTransition $record): bool => $this->canCorrect($record))
+ ->modalHeading(__('panel-admin::delas.actions.correct_reason_heading'))
+ ->modalDescription(__('panel-admin::delas.actions.correct_reason_body'))
+ ->fillForm(fn (DelasTransition $record): array => ['reason' => $record->currentReason()])
+ ->schema([$this->reasonField(__('panel-admin::delas.actions.correct_reason_field'))])
+ ->action(fn (DelasTransition $record, array $data): bool => $this->attempt(
+ fn () => resolve(CorrectDelasReason::class)->handle($record, $this->actor(), $this->reasonFrom($data)),
+ __('panel-admin::delas.actions.reason_corrected'),
+ )),
+ ])
->filters($this->isLead() ? [
SelectFilter::make('action')
->label(__('panel-admin::delas.columns.action'))
->options(DelasAction::class),
] : []);
}
+
+ /**
+ * Mesma regra da action de domínio, só para mostrar o botão a quem pode:
+ * a líder sempre; quem escreveu, dentro do prazo.
+ */
+ private function canCorrect(DelasTransition $record): bool
+ {
+ if (!$record->hasCorrectableReason()) {
+ return false;
+ }
+
+ if ($this->isLead()) {
+ return true;
+ }
+
+ return $record->actor_id === $this->actor()->getKey()
+ && ($record->created_at?->greaterThanOrEqualTo(now()->subHours(config()->integer('delas.reason_correction_hours'))) ?? false);
+ }
+
+ private function correctedNote(DelasTransition $record): ?string
+ {
+ $correction = $record->latestCorrection;
+
+ if (!$correction instanceof DelasTransition) {
+ return null;
+ }
+
+ $note = __('panel-admin::delas.actions.corrected_note', [
+ 'date' => $correction->created_at?->timezone(config('app.display_timezone'))->format('d/m/y'),
+ 'name' => $correction->actor->name ?? '—',
+ ]);
+
+ return is_string($note) ? $note : null;
+ }
+
+ /**
+ * O texto original fica a um passe de mouse: corrigir nunca esconde o que foi escrito.
+ */
+ private function originalNote(DelasTransition $record): ?string
+ {
+ if (!$record->latestCorrection instanceof DelasTransition) {
+ return null;
+ }
+
+ $note = __('panel-admin::delas.actions.original_reason', ['reason' => $record->reason]);
+
+ return is_string($note) ? $note : null;
+ }
}
diff --git a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
index 2ebf6031f..649a0f967 100644
--- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
+++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
@@ -352,3 +352,35 @@ function mountedPersonSelect(Testable $page): Select
expect($select->getSearchResults('carla'))->toBe([$carla->getKey() => 'Carla Comum (@carlacomum)']);
});
+
+test('a moderadora corrige o próprio motivo pelo histórico, e a original continua lá', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $this->actingAs($moderator);
+ $own = DelasTransition::factory()->create(['action' => DelasAction::Rejected, 'actor_id' => $moderator->getKey(), 'reason' => 'Perfil incompleo.']);
+ $others = DelasTransition::factory()->create(['action' => DelasAction::Rejected, 'actor_id' => User::factory()->delasModerator()->create()->getKey(), 'reason' => 'Outro motivo.']);
+
+ livewire(DelasHistoryPage::class)
+ ->loadTable()
+ ->assertActionVisible(TestAction::make('correctReason')->table($own))
+ ->assertActionHidden(TestAction::make('correctReason')->table($others))
+ ->callAction(TestAction::make('correctReason')->table($own), data: ['reason' => 'Perfil incompleto.'])
+ ->assertNotified(__('panel-admin::delas.actions.reason_corrected'))
+ ->assertSee('Perfil incompleto.');
+
+ expect($own->fresh()->reason)->toBe('Perfil incompleo.')
+ ->and($own->fresh()->currentReason())->toBe('Perfil incompleto.');
+});
+
+test('a líder vê a correção como linha própria no histórico; a moderadora, não', function (): void {
+ $original = DelasTransition::factory()->create(['action' => DelasAction::Blocked, 'reason' => 'Motivo.']);
+ $correction = DelasTransition::factory()->create(['action' => DelasAction::ReasonCorrected, 'corrects_id' => $original->getKey(), 'reason' => 'Motivo corrigido.']);
+
+ $this->actingAs(User::factory()->delasModerator()->create());
+ livewire(DelasHistoryPage::class)->loadTable()
+ ->assertCanSeeTableRecords([$original])
+ ->assertCanNotSeeTableRecords([$correction]);
+
+ $this->actingAs(User::factory()->delasLead()->create());
+ livewire(DelasHistoryPage::class)->loadTable()
+ ->assertCanSeeTableRecords([$original, $correction]);
+});
From a51ee98d96855c47358bb1ac0362b53ebe6681d2 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 17:21:23 -0300
Subject: [PATCH 28/77] =?UTF-8?q?feat(panel-admin):=20bloquear=20vira=20?=
=?UTF-8?q?=C3=ADcone=20de=20cadeado=20com=20dica?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Na fila, o Bloquear é um ícone vermelho; a dica explica que ele só impede
novos pedidos da tag, ou por que não dá para bloquear aquela pessoa.
---
.../src/Moderation/Pages/Delas/DelasQueuePage.php | 12 +++++++-----
1 file changed, 7 insertions(+), 5 deletions(-)
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasQueuePage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasQueuePage.php
index 1345ac3d4..8763ed408 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasQueuePage.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasQueuePage.php
@@ -110,13 +110,15 @@ public function table(Table $table): Table
)),
Action::make('block')
->label(__('panel-admin::delas.actions.block'))
- ->icon(Heroicon::OutlinedNoSymbol)
- ->color('warning')
- ->button()
- ->outlined()
+ // Só o ícone, em vermelho; a dica explica o que bloquear faz (ou por que não dá).
+ ->icon(Heroicon::OutlinedLockClosed)
+ ->iconButton()
+ ->color('danger')
->size('sm')
->disabled(fn (DelasTagRequest $record): bool => !$this->canBlock($record->user))
- ->tooltip(fn (DelasTagRequest $record): ?string => $this->canBlock($record->user) ? null : $this->text('panel-admin::delas.actions.block_disabled'))
+ ->tooltip(fn (DelasTagRequest $record): string => $this->canBlock($record->user)
+ ? $this->text('panel-admin::delas.actions.block_tooltip')
+ : $this->text('panel-admin::delas.actions.block_disabled'))
->modalHeading(fn (DelasTagRequest $record): string => __('panel-admin::delas.actions.block_heading', ['name' => $record->user->name]))
->modalDescription(__('panel-admin::delas.actions.block_body'))
->modalSubmitActionLabel(__('panel-admin::delas.actions.block'))
From 0bc9806a27110959e326fef67ba5c00c91c51d47 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 17:21:47 -0300
Subject: [PATCH 29/77] =?UTF-8?q?test(delas):=20busca=20de=20candidatas=20?=
=?UTF-8?q?sem=20nome=20aleat=C3=B3rio=20que=20casa=20com=20a=20busca?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php | 3 ++-
1 file changed, 2 insertions(+), 1 deletion(-)
diff --git a/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php b/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
index 65a4cca90..6deb4035e 100644
--- a/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
+++ b/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
@@ -59,7 +59,8 @@
$ana = User::factory()->create(['name' => 'Ana Souza', 'username' => 'anasouza']);
$bia = User::factory()->create(['name' => 'Beatriz Lima', 'username' => 'bialima']);
$member = User::factory()->create(['name' => 'Ana Membra', 'username' => 'anamembra']);
- DelasTagRequest::factory()->for($member)->approved()->create();
+ // Decisora fixa: um nome aleatório da factory (ex.: "Mariana") também casaria com "ana".
+ DelasTagRequest::factory()->for($member)->approved()->create(['decided_by' => $this->lead->getKey()]);
$byName = $this->candidates->search($this->candidates->forGrant($this->lead), 'ana')->pluck('id')->all();
$byUsername = $this->candidates->search($this->candidates->forGrant($this->lead), '@bialima')->pluck('id')->all();
From 9c25a80a5ba744c00bd14aaf4002656f04c2b667 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 17:26:23 -0300
Subject: [PATCH 30/77] feat(delas): remover a tag pode bloquear novos pedidos
junto
---
.../src/TagRequest/Actions/RevokeDelasTag.php | 22 ++++++++---
.../TagRequest/GrantAndRevokeDelasTagTest.php | 38 +++++++++++++++++++
2 files changed, 54 insertions(+), 6 deletions(-)
diff --git a/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php b/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
index f279b2769..ff2ab389e 100644
--- a/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
+++ b/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
@@ -4,6 +4,7 @@
namespace He4rt\Delas\TagRequest\Actions;
+use He4rt\Delas\Block\Actions\BlockDelasRequester;
use He4rt\Delas\Exceptions\DelasException;
use He4rt\Delas\History\Actions\RecordDelasTransition;
use He4rt\Delas\History\Enums\DelasAction;
@@ -11,6 +12,7 @@
use He4rt\Delas\TagRequest\Enums\DelasRequestStatus;
use He4rt\Delas\TagRequest\Events\DelasTagRevoked;
use He4rt\Delas\TagRequest\Models\DelasTagRequest;
+use He4rt\Delas\TagRequest\Queries\DelasEligibility;
use He4rt\Identity\User\Models\User;
use Illuminate\Auth\Access\AuthorizationException;
use Illuminate\Support\Facades\DB;
@@ -19,18 +21,22 @@
/**
* Uma líder ou super admin remove a tag. O registro não é apagado: muda para
* `revoked` e abre a espera para um novo pedido.
+ *
+ * Com `$alsoBlock`, a pessoa também é bloqueada de pedir de novo, com o mesmo
+ * motivo e na mesma transação: ou as duas coisas acontecem, ou nenhuma.
*/
final readonly class RevokeDelasTag
{
public function __construct(
private RecordDelasTransition $recordTransition,
+ private BlockDelasRequester $blockRequester,
) {}
/**
* @throws AuthorizationException
* @throws DelasException
*/
- public function handle(User $target, User $actor, ?string $reason): DelasTagRequest
+ public function handle(User $target, User $actor, ?string $reason, bool $alsoBlock = false): DelasTagRequest
{
Gate::forUser($actor)->authorize('lead-delas');
@@ -38,7 +44,7 @@ public function handle(User $target, User $actor, ?string $reason): DelasTagRequ
$reason = Reason::required($reason);
- $revoked = DB::transaction(function () use ($target, $actor, $reason): DelasTagRequest {
+ return DB::transaction(function () use ($target, $actor, $reason, $alsoBlock): DelasTagRequest {
$approved = DelasTagRequest::query()
->where('user_id', $target->getKey())
->where('status', DelasRequestStatus::Approved)
@@ -64,11 +70,15 @@ public function handle(User $target, User $actor, ?string $reason): DelasTagRequ
reason: $reason,
);
- return $approved;
- });
+ // Os eventos são ShouldDispatchAfterCommit: só saem se a transação inteira der certo.
+ event(new DelasTagRevoked($approved->getKey(), $target->getKey(), $actor->getKey()));
- event(new DelasTagRevoked($revoked->getKey(), $target->getKey(), $actor->getKey()));
+ // Quem já está bloqueada continua com o bloqueio que tem.
+ if ($alsoBlock && !resolve(DelasEligibility::class)->isBlocked($target)) {
+ $this->blockRequester->handle($target, $actor, $reason);
+ }
- return $revoked;
+ return $approved;
+ });
}
}
diff --git a/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php b/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php
index 7f3d33482..e3001a459 100644
--- a/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php
+++ b/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php
@@ -115,3 +115,41 @@
expect(fn () => resolve(RevokeDelasTag::class)->handle(User::factory()->create(), $lead, 'motivo'))
->toThrow(DelasException::class, __('delas::exceptions.has_no_tag'));
});
+
+test('remover a tag e bloquear acontecem juntos, com o mesmo motivo', function (): void {
+ $lead = User::factory()->delasLead()->create();
+ $approved = DelasTagRequest::factory()->approved()->create();
+
+ resolve(RevokeDelasTag::class)->handle($approved->user, $lead, 'Conta criada só para conseguir a tag.', alsoBlock: true);
+
+ $block = DelasRequesterBlock::query()->active()->where('user_id', $approved->user_id)->sole();
+
+ expect($approved->fresh()->status)->toBe(DelasRequestStatus::Revoked)
+ ->and($block->reason)->toBe('Conta criada só para conseguir a tag.')
+ ->and($block->blocked_by)->toBe($lead->getKey())
+ ->and(resolve(DelasEligibility::class)->for($approved->user)->state)->toBe(DelasEligibilityState::Blocked)
+ ->and(DelasTransition::query()->pluck('action')->all())
+ ->toEqualCanonicalizing([DelasAction::Revoked, DelasAction::Blocked]);
+});
+
+test('se não der para bloquear, a tag também não é removida', function (): void {
+ $lead = User::factory()->delasLead()->create();
+ $moderatorWithTag = User::factory()->delasModerator()->create();
+ $approved = DelasTagRequest::factory()->for($moderatorWithTag)->approved()->create();
+
+ expect(fn () => resolve(RevokeDelasTag::class)->handle($moderatorWithTag, $lead, 'Motivo.', alsoBlock: true))
+ ->toThrow(DelasException::class, __('delas::exceptions.cannot_block_team'))
+ ->and($approved->fresh()->status)->toBe(DelasRequestStatus::Approved)
+ ->and(DelasTransition::query()->count())->toBe(0);
+});
+
+test('quem já está bloqueada só perde a tag, sem segundo bloqueio', function (): void {
+ $lead = User::factory()->delasLead()->create();
+ $approved = DelasTagRequest::factory()->approved()->create();
+ DelasRequesterBlock::factory()->for($approved->user)->create();
+
+ resolve(RevokeDelasTag::class)->handle($approved->user, $lead, 'Motivo.', alsoBlock: true);
+
+ expect(DelasRequesterBlock::query()->where('user_id', $approved->user_id)->count())->toBe(1)
+ ->and($approved->fresh()->status)->toBe(DelasRequestStatus::Revoked);
+});
From de30a6b3a8f6099019064384aabf4c9f72883a53 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 17:32:34 -0300
Subject: [PATCH 31/77] =?UTF-8?q?feat(panel-admin):=20p=C3=A1gina=20Membra?=
=?UTF-8?q?s=20da=20He4rt=20Delas,=20com=20remover=20tag=20e=20bloquear=20?=
=?UTF-8?q?junto?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
app-modules/panel-admin/lang/en/delas.php | 13 +++
app-modules/panel-admin/lang/pt_BR/delas.php | 13 +++
.../Concerns/InteractsWithDelasModeration.php | 30 +++++
.../Pages/Delas/DelasBlocksPage.php | 2 +-
.../Pages/Delas/DelasHistoryPage.php | 2 +-
.../Pages/Delas/DelasMembersPage.php | 107 ++++++++++++++++++
.../Moderation/Pages/Delas/DelasTeamPage.php | 7 +-
.../Delas/DelasModerationPagesTest.php | 41 ++++++-
8 files changed, 208 insertions(+), 7 deletions(-)
create mode 100644 app-modules/panel-admin/src/Moderation/Pages/Delas/DelasMembersPage.php
diff --git a/app-modules/panel-admin/lang/en/delas.php b/app-modules/panel-admin/lang/en/delas.php
index 70883cc3f..779c95a30 100644
--- a/app-modules/panel-admin/lang/en/delas.php
+++ b/app-modules/panel-admin/lang/en/delas.php
@@ -7,6 +7,7 @@
'navigation' => [
'group' => 'He4rt Delas',
'queue' => 'Queue',
+ 'members' => 'Members',
'blocks' => 'Blocks',
'history' => 'History',
'history_full' => 'Full history',
@@ -17,6 +18,10 @@
'title' => 'He4rt Delas queue',
'subtitle' => 'Review He4rt Delas tag requests. Every decision records who decided, when and why.',
],
+ 'members' => [
+ 'title' => 'He4rt Delas members',
+ 'subtitle' => 'Who has the He4rt Delas tag today.',
+ ],
'blocks' => [
'title' => 'He4rt Delas blocks',
'subtitle' => 'People blocked from requesting the He4rt Delas tag.',
@@ -42,10 +47,14 @@
'actor' => 'Done by',
'role' => 'Role',
'decisions' => 'Decisions',
+ 'member_since' => 'Member since',
+ 'decided_by' => 'Decided by',
],
'empty' => [
'pending' => 'No pending requests',
'pending_body' => 'When someone requests the He4rt Delas tag, it shows up here.',
+ 'members' => 'Nobody has the tag yet',
+ 'members_body' => 'People whose request is approved or who get the tag directly show up here.',
'blocks' => 'No active blocks',
'blocks_body' => 'People blocked from requesting the tag show up here.',
'history' => 'Nothing in the history',
@@ -96,6 +105,10 @@
'revoke_body' => 'The record is kept. The person can request again after the cooldown.',
'revoke_reason' => 'Removal reason',
'revoked' => 'Tag removed',
+ 'revoke_member_heading' => 'Remove the tag from :name?',
+ 'also_block' => 'Also block new requests',
+ 'also_block_hint' => 'Uses the same reason. Only prevents new tag requests: it is not a ban and does not affect the account.',
+ 'revoked_and_blocked' => 'Tag removed and new requests blocked',
'person' => 'Person',
'person_hint' => 'Search by name or @username.',
'member_hint' => 'Only people who have the tag today.',
diff --git a/app-modules/panel-admin/lang/pt_BR/delas.php b/app-modules/panel-admin/lang/pt_BR/delas.php
index ab80993d7..2e05959d7 100644
--- a/app-modules/panel-admin/lang/pt_BR/delas.php
+++ b/app-modules/panel-admin/lang/pt_BR/delas.php
@@ -7,6 +7,7 @@
'navigation' => [
'group' => 'He4rt Delas',
'queue' => 'Fila',
+ 'members' => 'Membras',
'blocks' => 'Bloqueios',
'history' => 'Histórico',
'history_full' => 'Histórico completo',
@@ -17,6 +18,10 @@
'title' => 'Fila da He4rt Delas',
'subtitle' => 'Analise os pedidos da tag He4rt Delas. Toda decisão fica registrada com quem decidiu, quando e o motivo.',
],
+ 'members' => [
+ 'title' => 'Membras da He4rt Delas',
+ 'subtitle' => 'Quem tem a tag He4rt Delas hoje.',
+ ],
'blocks' => [
'title' => 'Bloqueios da He4rt Delas',
'subtitle' => 'Quem está bloqueada de solicitar a tag He4rt Delas.',
@@ -42,10 +47,14 @@
'actor' => 'Quem fez',
'role' => 'Papel',
'decisions' => 'Decisões',
+ 'member_since' => 'Membra desde',
+ 'decided_by' => 'Decidido por',
],
'empty' => [
'pending' => 'Nenhuma solicitação pendente',
'pending_body' => 'Quando alguém pedir a tag He4rt Delas, o pedido aparece aqui.',
+ 'members' => 'Ninguém com a tag ainda',
+ 'members_body' => 'Quem tiver o pedido aprovado ou receber a tag direto aparece aqui.',
'blocks' => 'Nenhum bloqueio ativo',
'blocks_body' => 'Pessoas bloqueadas de solicitar a tag aparecem aqui.',
'history' => 'Nada no histórico',
@@ -96,6 +105,10 @@
'revoke_body' => 'O registro não é apagado. A pessoa poderá solicitar de novo depois da espera.',
'revoke_reason' => 'Motivo da remoção',
'revoked' => 'Tag removida',
+ 'revoke_member_heading' => 'Remover a tag de :name?',
+ 'also_block' => 'Também bloquear novos pedidos',
+ 'also_block_hint' => 'Usa o mesmo motivo. Só impede novos pedidos da tag: não é banimento e não afeta a conta.',
+ 'revoked_and_blocked' => 'Tag removida e novos pedidos bloqueados',
'person' => 'Pessoa',
'person_hint' => 'Busque por nome ou @username.',
'member_hint' => 'Só aparece quem tem a tag hoje.',
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
index 9e96a36ea..bd8f899a6 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
@@ -6,6 +6,7 @@
use Closure;
use Filament\Forms\Components\Textarea;
+use Filament\Forms\Components\Toggle;
use Filament\Notifications\Notification;
use Filament\Schemas\Components\EmbeddedTable;
use Filament\Schemas\Schema;
@@ -74,6 +75,35 @@ protected function reasonField(string $label, bool $required = true, ?string $hi
->helperText($hint ?? __('panel-admin::delas.reason_hint'));
}
+ /**
+ * Ao remover a tag, a líder pode impedir novos pedidos com o mesmo motivo.
+ */
+ protected function alsoBlockToggle(): Toggle
+ {
+ return Toggle::make('also_block')
+ ->label(__('panel-admin::delas.actions.also_block'))
+ ->helperText(__('panel-admin::delas.actions.also_block_hint'))
+ ->default(state: false);
+ }
+
+ /**
+ * @param array $data
+ */
+ protected function alsoBlockFrom(array $data): bool
+ {
+ return ($data['also_block'] ?? false) === true;
+ }
+
+ /**
+ * @param array $data
+ */
+ protected function revokedTitle(array $data): string
+ {
+ return $this->text($this->alsoBlockFrom($data)
+ ? 'panel-admin::delas.actions.revoked_and_blocked'
+ : 'panel-admin::delas.actions.revoked');
+ }
+
/**
* Roda uma action de domínio e transforma recusas em notificação, sem
* derrubar a página.
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasBlocksPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasBlocksPage.php
index bbda8db93..48e8102e6 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasBlocksPage.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasBlocksPage.php
@@ -30,7 +30,7 @@ class DelasBlocksPage extends Page implements HasTable
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedLockClosed;
- protected static ?int $navigationSort = 21;
+ protected static ?int $navigationSort = 22;
protected static ?string $slug = 'delas/blocks';
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
index 63c7edd81..fcaacaa1b 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
@@ -32,7 +32,7 @@ class DelasHistoryPage extends Page implements HasTable
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedClock;
- protected static ?int $navigationSort = 22;
+ protected static ?int $navigationSort = 23;
protected static ?string $slug = 'delas/history';
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasMembersPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasMembersPage.php
new file mode 100644
index 000000000..15714ae05
--- /dev/null
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasMembersPage.php
@@ -0,0 +1,107 @@
+user()?->can('moderate-delas') ?? false;
+ }
+
+ public static function getNavigationLabel(): string
+ {
+ return __('panel-admin::delas.navigation.members');
+ }
+
+ public static function getNavigationBadge(): ?string
+ {
+ $members = DelasTagRequest::query()->where('status', DelasRequestStatus::Approved)->count();
+
+ return $members > 0 ? (string) $members : null;
+ }
+
+ public static function getNavigationBadgeColor(): string
+ {
+ return 'gray';
+ }
+
+ public function getTitle(): string
+ {
+ return __('panel-admin::delas.pages.members.title');
+ }
+
+ public function getSubheading(): string
+ {
+ return __('panel-admin::delas.pages.members.subtitle');
+ }
+
+ public function table(Table $table): Table
+ {
+ return $table
+ ->query(DelasTagRequest::query()->where('status', DelasRequestStatus::Approved)->with(['user', 'decider']))
+ ->defaultSort('decided_at', 'desc')
+ ->emptyStateHeading(__('panel-admin::delas.empty.members'))
+ ->emptyStateDescription(__('panel-admin::delas.empty.members_body'))
+ ->emptyStateIcon(Heroicon::OutlinedUserGroup)
+ ->columns([
+ $this->personColumn('user.name', 'user.username', __('panel-admin::delas.columns.person')),
+ $this->dateColumn('decided_at', __('panel-admin::delas.columns.member_since')),
+ TextColumn::make('decider.name')
+ ->label(__('panel-admin::delas.columns.decided_by'))
+ ->placeholder('—'),
+ ])
+ ->recordActions([
+ Action::make('revoke')
+ ->label(__('panel-admin::delas.actions.revoke'))
+ ->icon(Heroicon::OutlinedMinusCircle)
+ ->color('danger')
+ ->button()
+ ->outlined()
+ ->size('sm')
+ ->visible(fn (): bool => $this->isLead())
+ ->modalHeading(fn (DelasTagRequest $record): string => __('panel-admin::delas.actions.revoke_member_heading', ['name' => $record->user->name]))
+ ->modalDescription(__('panel-admin::delas.actions.revoke_body'))
+ ->modalSubmitActionLabel(__('panel-admin::delas.actions.revoke'))
+ ->schema([
+ $this->reasonField(__('panel-admin::delas.actions.revoke_reason')),
+ $this->alsoBlockToggle(),
+ ])
+ ->action(fn (DelasTagRequest $record, array $data): bool => $this->attempt(
+ fn () => resolve(RevokeDelasTag::class)->handle($record->user, $this->actor(), $this->reasonFrom($data), $this->alsoBlockFrom($data)),
+ $this->revokedTitle($data),
+ )),
+ ]);
+ }
+}
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
index 306fa695b..d39c26d65 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
@@ -42,7 +42,7 @@ class DelasTeamPage extends Page implements HasTable
protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedUsers;
- protected static ?int $navigationSort = 23;
+ protected static ?int $navigationSort = 24;
protected static ?string $slug = 'delas/team';
@@ -175,10 +175,11 @@ protected function getHeaderActions(): array
->searchable()
->preload(),
$this->reasonField(__('panel-admin::delas.actions.revoke_reason')),
+ $this->alsoBlockToggle(),
])
->action(fn (array $data): bool => $this->attempt(
- fn () => resolve(RevokeDelasTag::class)->handle($this->findUser($data['user_id']), $this->actor(), $this->reasonFrom($data)),
- __('panel-admin::delas.actions.revoked'),
+ fn () => resolve(RevokeDelasTag::class)->handle($this->findUser($data['user_id']), $this->actor(), $this->reasonFrom($data), $this->alsoBlockFrom($data)),
+ $this->revokedTitle($data),
)),
];
}
diff --git a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
index 649a0f967..b2d0bb8c7 100644
--- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
+++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
@@ -16,6 +16,7 @@
use He4rt\PanelAdmin\Moderation\ModerationCluster;
use He4rt\PanelAdmin\Moderation\Pages\Delas\DelasBlocksPage;
use He4rt\PanelAdmin\Moderation\Pages\Delas\DelasHistoryPage;
+use He4rt\PanelAdmin\Moderation\Pages\Delas\DelasMembersPage;
use He4rt\PanelAdmin\Moderation\Pages\Delas\DelasQueuePage;
use He4rt\PanelAdmin\Moderation\Pages\Delas\DelasTeamPage;
use He4rt\PanelAdmin\Moderation\Widgets\Delas\DelasStatsOverview;
@@ -62,7 +63,7 @@ function mountedPersonSelect(Testable $page): Select
expect($page::canAccess())->toBeFalse();
$this->get($page::getUrl())->assertForbidden();
-})->with([DelasQueuePage::class, DelasBlocksPage::class, DelasHistoryPage::class, DelasTeamPage::class]);
+})->with([DelasQueuePage::class, DelasMembersPage::class, DelasBlocksPage::class, DelasHistoryPage::class, DelasTeamPage::class]);
test('moderadora vê a fila de pendentes, mas não a Equipe', function (): void {
$this->actingAs(User::factory()->delasModerator()->create());
@@ -83,10 +84,11 @@ function mountedPersonSelect(Testable $page): Select
$this->actingAs(User::factory()->delasModerator()->create());
DelasTagRequest::factory()->pending()->count(2)->create();
DelasRequesterBlock::factory()->count(2)->create();
+ DelasTagRequest::factory()->approved()->count(2)->create();
DelasTransition::factory()->count(2)->create(['action' => DelasAction::Approved]);
$this->get($page::getUrl())->assertOk();
-})->with([DelasQueuePage::class, DelasBlocksPage::class, DelasHistoryPage::class]);
+})->with([DelasQueuePage::class, DelasMembersPage::class, DelasBlocksPage::class, DelasHistoryPage::class]);
test('ao revogar o papel, a moderadora perde o acesso na hora', function (): void {
$moderator = User::factory()->delasModerator()->create();
@@ -110,6 +112,7 @@ function mountedPersonSelect(Testable $page): Select
->toBe([__('panel-admin::delas.navigation.group')])
->and($items->map(fn (NavigationItem $item): string => $item->getLabel())->all())->toBe([
__('panel-admin::delas.navigation.queue'),
+ __('panel-admin::delas.navigation.members'),
__('panel-admin::delas.navigation.blocks'),
__('panel-admin::delas.navigation.history'),
]);
@@ -384,3 +387,37 @@ function mountedPersonSelect(Testable $page): Select
livewire(DelasHistoryPage::class)->loadTable()
->assertCanSeeTableRecords([$original, $correction]);
});
+
+test('a moderadora vê quem tem a tag, mas só a líder remove', function (): void {
+ [$member] = DelasTagRequest::factory()->approved()->count(2)->create();
+ $pending = DelasTagRequest::factory()->pending()->create();
+
+ $this->actingAs(User::factory()->delasModerator()->create());
+ livewire(DelasMembersPage::class)
+ ->loadTable()
+ ->assertCanSeeTableRecords([$member])
+ ->assertCanNotSeeTableRecords([$pending])
+ ->assertActionHidden(TestAction::make('revoke')->table($member));
+
+ expect(DelasMembersPage::getNavigationBadge())->toBe('2');
+});
+
+test('a líder remove a tag pela Membras e bloqueia novos pedidos junto', function (): void {
+ $this->actingAs(User::factory()->delasLead()->create());
+ [$member, $other] = DelasTagRequest::factory()->approved()->count(2)->create();
+
+ livewire(DelasMembersPage::class)
+ ->loadTable()
+ ->callAction(TestAction::make('revoke')->table($member), data: ['reason' => 'Perfil falso.', 'also_block' => true])
+ ->assertNotified(__('panel-admin::delas.actions.revoked_and_blocked'))
+ ->assertCanNotSeeTableRecords([$member])
+ ->callAction(TestAction::make('revoke')->table($other), data: ['reason' => 'Pedido da pessoa.'])
+ ->assertNotified(__('panel-admin::delas.actions.revoked'));
+
+ $block = DelasRequesterBlock::query()->active()->sole();
+
+ expect($member->fresh()->status)->toBe(DelasRequestStatus::Revoked)
+ ->and($block->user_id)->toBe($member->user_id)
+ ->and($block->reason)->toBe('Perfil falso.')
+ ->and($other->fresh()->status)->toBe(DelasRequestStatus::Revoked);
+});
From 3cc3c4b2a6b2c3253a933f0b7bb0beec2ac20343 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 17:33:13 -0300
Subject: [PATCH 32/77] =?UTF-8?q?docs(delas):=20corre=C3=A7=C3=A3o=20de=20?=
=?UTF-8?q?motivo=20e=20p=C3=A1gina=20Membras=20na=20spec,=20ADR=20e=20glo?=
=?UTF-8?q?ss=C3=A1rio?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
app-modules/delas/CONTEXT.md | 2 +
...01-modulo-proprio-com-papel-e-historico.md | 8 +++
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 60 ++++++++++++-------
3 files changed, 48 insertions(+), 22 deletions(-)
diff --git a/app-modules/delas/CONTEXT.md b/app-modules/delas/CONTEXT.md
index c561c908a..f9ea3f707 100644
--- a/app-modules/delas/CONTEXT.md
+++ b/app-modules/delas/CONTEXT.md
@@ -32,3 +32,5 @@ Os dois painéis dependem deste módulo, e este módulo só depende do `identity
| **Concessão direta** | Líder (ou super admin) dá a tag sem solicitação e sem espera (`GrantDelasTag`). Encerra um bloqueio ativo, se houver. | Aprovar uma solicitação: aprovar é decisão sobre um pedido que a pessoa fez. |
| **Histórico** | `delas_transitions`: uma linha por ação (solicitar, aprovar, rejeitar, conceder, remover, bloquear, desbloquear), com quem fez, quando e motivo. | Logs da aplicação: o histórico é dado de domínio, append-only, gravado pelas próprias actions. |
| **Candidatas** | Quem pode ser escolhida nos seletores de pessoa da Equipe (`DelasCandidates`): conceder lista quem não tem a tag, remover lista só quem tem, adicionar moderadora exclui super admins e a equipe. Quem age nunca aparece. | A regra de negócio: a consulta só filtra a lista; quem valida a ação são as actions de domínio. |
+| **Membra** | Quem tem a tag hoje: solicitação `approved`. Aparece na página Membras, onde a líder pode remover a tag e bloquear novos pedidos junto. | Moderadora: membra é quem tem a tag, moderadora é quem decide sobre ela. |
+| **Correção de motivo** | Linha `reason_corrected` no histórico que aponta (`corrects_id`) para a decisão corrigida. A original fica como foi escrita; vale a correção mais recente. | Editar o motivo: nada no histórico é sobrescrito. |
diff --git a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
index 30d4ad5f8..727a8cc0b 100644
--- a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
+++ b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
@@ -51,10 +51,18 @@ precisa morar em algum lugar e ter uma forma de autorizar quem decide.
quem bloqueou ou por super admin.
- **Histórico append-only** em `delas_transitions`, gravado pelas actions, sem trigger (ADR-0003
do `events`).
+- **Corrigir motivo sem apagar.** Um motivo errado se corrige com uma linha nova
+ (`reason_corrected`, `corrects_id` apontando para a original), nunca editando a original. O
+ motivo vigente na solicitação ou no bloqueio passa a ser o corrigido. Quem escreveu corrige até
+ 24 horas depois; a líder, sempre.
+ - _Alternativa descartada:_ editar o campo `reason` direto. Mais simples, mas apagaria o que
+ foi escrito e quebraria o append-only.
- **Moderação no `/admin`, pedido e tag no `/app`.** Moderação na He4rt mora no `/admin`, no
cluster de Moderação (`/admin/mod`). A He4rt Delas entra nele como o grupo "He4rt Delas" da
subnavegação, com uma página por parte, cada uma com o próprio gate:
- Fila (`moderate-delas`, badge de pendentes): aprovar, rejeitar e bloquear;
+ - Membras (`moderate-delas`, badge de quem tem a tag): consulta; a líder remove a tag e pode
+ bloquear novos pedidos no mesmo passo;
- Bloqueios (`moderate-delas`, badge de bloqueios ativos): desbloquear;
- Histórico (`moderate-delas`): só decisões para a moderadora, completo e com filtro para a
líder;
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index d9d52b177..d35359a3a 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -90,6 +90,11 @@ Fatos do código atual que moldam o desenho:
- Não decidem a própria solicitação: ela fica para outra moderadora, uma líder ou um super admin.
- O bloqueio vale **só** para solicitar a tag. Não é ban nem suspensão (`UserSituation`) e não
afeta a conta.
+- Veem a lista de quem tem a tag (página Membras), só para consulta.
+- Corrigem o motivo que escreveram até 24 horas depois (`delas.reason_correction_hours`). A
+ correção é uma linha nova no histórico (`reason_corrected`, com `corrects_id` apontando para a
+ original); a original nunca muda. A tela mostra o motivo corrigido, "corrigido em DD/MM/AA por
+ X" e, ao passar o mouse, o texto original.
### Liderança (líderes da He4rt Delas)
@@ -102,6 +107,7 @@ que a moderadora tem, mais:
- na Equipe, adiciona e revoga `delas-moderator`. Não cria nem revoga líderes, e não age sobre
super admins;
- desbloqueia qualquer bloqueio;
+- corrige qualquer motivo, a qualquer momento;
- concede e remove a tag direto:
- se houver solicitação `pending`, ela é aprovada (`pending → approved`);
- se não houver, é criada uma solicitação já `approved`;
@@ -109,7 +115,9 @@ que a moderadora tem, mais:
- se a pessoa estiver bloqueada, a interface mostra quem bloqueou, quando e o motivo, e exige
um motivo. O bloqueio é encerrado na mesma transação;
- remover (`approved → revoked`) exige motivo. O registro não é apagado, e a pessoa pode
- solicitar de novo após a espera, salvo se também for bloqueada.
+ solicitar de novo após a espera, salvo se também for bloqueada. Pela Membras (ou pela
+ Equipe), a líder pode marcar "Também bloquear novos pedidos": o bloqueio usa o mesmo motivo
+ e entra na mesma transação. Se a pessoa já estiver bloqueada, só perde a tag.
> _Vai além da #570_, que diz que a permissão é "atribuível apenas por admins do Hub". Precisa do
> ok da Sther e de um comentário na issue.
@@ -244,18 +252,19 @@ approved → revoked
Histórico append-only, gravado pelas actions, sem trigger (ADR-0003 do events). Formato mais
próximo de `squad_membership_events` (ação + trilha) do que de `events_enrollment_transitions`.
-| coluna | tipo | nota |
-| --------------------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
-| `id` | uuid | PK |
-| `user_id` | uuid | FK `users`, cascade on delete; a pessoa afetada |
-| `request_id` | uuid null | FK `delas_tag_requests`, cascade on delete |
-| `block_id` | uuid null | FK `delas_requester_blocks`, cascade on delete |
-| `action` | string(20) | `DelasAction`: `requested`, `approved`, `rejected`, `granted`, `revoked`, `blocked`, `unblocked`, `moderator_added`, `moderator_removed` |
-| `from_status` / `to_status` | string(20) null | `DelasRequestStatus`, quando há mudança de status |
-| `actor_id` | uuid null | FK `users`, null on delete |
-| `triggered_by` | string(20) | `DelasTriggeredBy`: `user`, `moderator`, `lead`, `admin`, `system` |
-| `reason` | string(500) null | |
-| `created_at` | timestampTz | `useCurrent()` |
+| coluna | tipo | nota |
+| --------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `id` | uuid | PK |
+| `user_id` | uuid | FK `users`, cascade on delete; a pessoa afetada |
+| `request_id` | uuid null | FK `delas_tag_requests`, cascade on delete |
+| `block_id` | uuid null | FK `delas_requester_blocks`, cascade on delete |
+| `corrects_id` | uuid null | FK `delas_transitions`, cascade on delete; a linha cujo motivo esta corrige |
+| `action` | string(20) | `DelasAction`: `requested`, `approved`, `rejected`, `granted`, `revoked`, `blocked`, `unblocked`, `moderator_added`, `moderator_removed`, `reason_corrected` |
+| `from_status` / `to_status` | string(20) null | `DelasRequestStatus`, quando há mudança de status |
+| `actor_id` | uuid null | FK `users`, null on delete |
+| `triggered_by` | string(20) | `DelasTriggeredBy`: `user`, `moderator`, `lead`, `admin`, `system` |
+| `reason` | string(500) null | |
+| `created_at` | timestampTz | `useCurrent()` |
Sem coluna `metadata`: nenhum fluxo a preenche, e um jsonb sem forma quebraria o
`tests/Arch/NoLooseArrayCastsTest.php` (guideline `domain/06`).
@@ -284,7 +293,8 @@ a linha de histórico.
| `BlockDelasRequester` | `moderate-delas` | cria bloqueio e rejeita a pendente |
| `UnblockDelasRequester` | `moderate-delas` (próprios) / `lead-delas` (todos) | encerra bloqueio |
| `GrantDelasTag` | `lead-delas` | aprova a pendente ou cria `approved`; encerra bloqueio |
-| `RevokeDelasTag` | `lead-delas` | `approved → revoked`, com motivo |
+| `RevokeDelasTag` | `lead-delas` | `approved → revoked`, com motivo; opcionalmente bloqueia junto |
+| `CorrectDelasReason` | `moderate-delas` (próprio, 24h) / `lead-delas` | grava `reason_corrected` e atualiza o motivo vigente |
| `AddDelasModerator` / `RemoveDelasModerator` | `lead-delas` | atribui ou retira `delas-moderator`; recusa líderes e super admins como alvo |
A consulta `DelasEligibility` responde para o perfil: pode solicitar, por que não, e
@@ -313,18 +323,20 @@ dispara também `DelasRequesterUnblocked`. Nenhum listener nesta entrega.
uma página por parte. A subnavegação do cluster já filtra por `canAccess()`, então cada pessoa
só vê as páginas do próprio papel. Textos em `panel-admin/lang/{en,pt_BR}/delas.php`.
- | Página | `canAccess()` | Badge | Conteúdo |
- | --------- | ---------------- | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
- | Fila | `moderate-delas` | pendentes | aprovar, rejeitar, bloquear |
- | Bloqueios | `moderate-delas` | bloqueios ativos | desbloquear (moderadora: os próprios; líder: todos) |
- | Histórico | `moderate-delas` | | moderadora: decisões; líder: completo, com filtro por ação |
- | Equipe | `lead-delas` | | números (pendentes, membras com a tag, tempo médio até a decisão, aprovadas e rejeitadas no mês, bloqueios ativos), conceder e remover a tag, adicionar e revogar moderadora |
+ | Página | `canAccess()` | Badge | Conteúdo |
+ | --------- | ---------------- | ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+ | Fila | `moderate-delas` | pendentes | aprovar, rejeitar, bloquear |
+ | Membras | `moderate-delas` | membras com a tag | quem tem a tag, desde quando e quem decidiu; líder: remover a tag, com a opção de bloquear novos pedidos |
+ | Bloqueios | `moderate-delas` | bloqueios ativos | desbloquear (moderadora: os próprios; líder: todos) |
+ | Histórico | `moderate-delas` | | moderadora: decisões; líder: completo, com filtro por ação; corrigir motivo |
+ | Equipe | `lead-delas` | | números (pendentes, membras com a tag, tempo médio até a decisão, aprovadas e rejeitadas no mês, bloqueios ativos), conceder e remover a tag, adicionar e revogar moderadora |
- Os seletores de pessoa da Equipe usam a consulta de domínio `DelasCandidates`: conceder e
adicionar moderadora buscam por nome ou `@username` (a lista é a comunidade inteira); remover
já vem carregado só com quem tem a tag. Quem age nunca aparece.
- Cada tabela declara o eager load (`user.roles` na fila, `user` e `blocker` nos bloqueios,
- `user` e `actor` no histórico, `roles` na equipe).
+ `user`, `actor` e `latestCorrection.actor` no histórico, `user` e `decider` na Membras, `roles`
+ na equipe).
- A seção Papéis do `UserForm`, onde super admins atribuem `delas-lead` e `delas-moderator`,
visível só para super admins; a tabela de Usuários só **mostra** as roles (badges).
@@ -372,7 +384,11 @@ unitários em `delas/tests/Unit`.
- Bloqueio: motivo obrigatório; recusa bloquear moderadora, super admin ou a si mesma; moderadora
não desbloqueia bloqueio de outra.
- Admin: concede com pendente aberta (aprova), sem solicitação (cria), já aprovada (recusa) e
- bloqueada (encerra o bloqueio); remove a tag.
+ bloqueada (encerra o bloqueio); remove a tag, sozinha ou bloqueando junto (desfaz tudo se o
+ bloqueio for recusado).
+- Correção de motivo: linha nova sem mudar a original, vale a mais recente, atualiza o motivo da
+ solicitação ou do bloqueio, prazo de quem escreveu, líder a qualquer momento, recusa motivo
+ vazio, igual ou de ação sem motivo.
- Papel: perde acesso ao retirar `delas-moderator`; o campo de roles não aparece para quem não é
super admin; papéis de moderação entram no `/admin` em produção, `streamer` não.
- Candidatas (`DelasCandidates`): um teste por escopo (conceder, remover, adicionar moderadora,
From 27d1495b469a0213d18433a6daf17993bd41e192 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 18:46:54 -0300
Subject: [PATCH 33/77] =?UTF-8?q?refactor(panel-admin):=20He4rt=20Delas=20?=
=?UTF-8?q?s=C3=B3=20dentro=20da=20Modera=C3=A7=C3=A3o,=20sem=20atalho=20n?=
=?UTF-8?q?o=20menu=20principal?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../src/PanelAdminServiceProvider.php | 23 -------------------
.../AdminComponentAccessTest.php | 7 +++---
2 files changed, 3 insertions(+), 27 deletions(-)
diff --git a/app-modules/panel-admin/src/PanelAdminServiceProvider.php b/app-modules/panel-admin/src/PanelAdminServiceProvider.php
index 8116782a1..531113186 100644
--- a/app-modules/panel-admin/src/PanelAdminServiceProvider.php
+++ b/app-modules/panel-admin/src/PanelAdminServiceProvider.php
@@ -31,7 +31,6 @@
use He4rt\PanelAdmin\Moderation\Livewire\ModerationDashboardLivewire;
use He4rt\PanelAdmin\Moderation\Livewire\ModerationQueue;
use He4rt\PanelAdmin\Moderation\ModerationCluster;
-use He4rt\PanelAdmin\Moderation\Pages\Delas\DelasQueuePage;
use He4rt\PanelAdmin\Pages\Dashboard;
use He4rt\PanelAdmin\Twitch\TwitchCluster;
use Illuminate\Contracts\Support\Arrayable;
@@ -162,7 +161,6 @@ private function defaultNavigation(NavigationBuilder $builder): NavigationBuilde
->items([
...$this->itemsFor(Dashboard::class),
...$this->itemsFor(ModerationCluster::class),
- ...$this->delasShortcut(),
...$this->itemsFor(MarketingCluster::class),
...$this->itemsFor(TwitchCluster::class),
...$this->itemsFor(GithubCluster::class),
@@ -221,27 +219,6 @@ private function moderationNavigation(NavigationBuilder $builder): NavigationBui
));
}
- /**
- * Atalho para a fila da He4rt Delas no menu principal, com a marca, para quem
- * modera. A moderação mora no cluster de Moderação; o atalho só encurta o caminho.
- *
- * @return array
- */
- private function delasShortcut(): array
- {
- if (!DelasQueuePage::canAccess()) {
- return [];
- }
-
- return [
- NavigationItem::make(__('panel-admin::delas.navigation.group'))
- ->icon('he4rt-delas')
- ->sort(11)
- ->badge(DelasQueuePage::getNavigationBadge())
- ->url(DelasQueuePage::getUrl()),
- ];
- }
-
/**
* O grupo He4rt Delas na subnavegação leva o ícone da marca. O Filament não
* aceita ícone no grupo e nos itens ao mesmo tempo, então os itens ficam sem.
diff --git a/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php b/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php
index c462aad37..969ec6180 100644
--- a/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php
+++ b/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php
@@ -111,7 +111,7 @@ function adminComponents(): array
}
});
-test('a sidebar da moderadora mostra só o Dashboard, a Moderação e o atalho da He4rt Delas', function (): void {
+test('a sidebar da moderadora mostra só o Dashboard e a Moderação', function (): void {
actingAs(User::factory()->delasModerator()->create());
$labels = collect(Filament::getPanel('admin')->getNavigation())
@@ -122,15 +122,14 @@ function adminComponents(): array
expect($labels)->toBe([
'Dashboard',
__('panel-admin::moderation.navigation.cluster'),
- __('panel-admin::delas.navigation.group'),
]);
});
-test('super admin também vê o atalho da He4rt Delas', function (): void {
+test('a He4rt Delas fica só dentro da Moderação, sem item no menu principal', function (): void {
actingAs(User::factory()->superAdmin()->create());
$superAdminLabels = collect(Filament::getPanel('admin')->getNavigation())
->flatMap(fn (NavigationGroup $group): array => $group->getItems())
->map(fn (NavigationItem $item): string => $item->getLabel());
- expect($superAdminLabels)->toContain(__('panel-admin::delas.navigation.group'));
+ expect($superAdminLabels)->not->toContain(__('panel-admin::delas.navigation.group'));
});
From 821f169f953bf8da15e86f28860d1c371da2626a Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 18:49:05 -0300
Subject: [PATCH 34/77] =?UTF-8?q?fix(panel-admin):=20hist=C3=B3rico=20most?=
=?UTF-8?q?ra=20o=20motivo=20original=20=C3=A0=20vista,=20sem=20depender?=
=?UTF-8?q?=20do=20mouse?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../Concerns/InteractsWithDelasModeration.php | 7 ++--
.../Pages/Delas/DelasHistoryPage.php | 35 +++++++------------
.../Delas/DelasModerationPagesTest.php | 3 +-
3 files changed, 20 insertions(+), 25 deletions(-)
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
index bd8f899a6..b63459b34 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
@@ -133,9 +133,12 @@ protected function reasonFrom(array $data): ?string
return is_string($reason) ? $reason : null;
}
- protected function text(string $key): string
+ /**
+ * @param array $replace
+ */
+ protected function text(string $key, array $replace = []): string
{
- $text = __($key);
+ $text = __($key, $replace);
return is_string($text) ? $text : $key;
}
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
index fcaacaa1b..ce5c8fb3b 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
@@ -60,7 +60,7 @@ public function getSubheading(): string
public function table(Table $table): Table
{
- $query = DelasTransition::query()->with(['user', 'actor', 'latestCorrection.actor']);
+ $query = DelasTransition::query()->with(['user', 'actor', 'corrected', 'latestCorrection.actor']);
// A moderadora vê as decisões; a líder vê também os pedidos e cada correção de motivo.
if (!$this->isLead()) {
@@ -86,8 +86,7 @@ public function table(Table $table): Table
TextColumn::make('reason')
->label(__('panel-admin::delas.columns.reason'))
->state(fn (DelasTransition $record): ?string => $record->currentReason())
- ->description(fn (DelasTransition $record): ?string => $this->correctedNote($record))
- ->tooltip(fn (DelasTransition $record): ?string => $this->originalNote($record))
+ ->description(fn (DelasTransition $record): ?string => $this->reasonNote($record))
->wrap()
->lineClamp(2)
->placeholder('—'),
@@ -134,33 +133,25 @@ private function canCorrect(DelasTransition $record): bool
&& ($record->created_at?->greaterThanOrEqualTo(now()->subHours(config()->integer('delas.reason_correction_hours'))) ?? false);
}
- private function correctedNote(DelasTransition $record): ?string
+ /**
+ * Corrigir nunca esconde o que foi escrito: a linha corrigida mostra quando,
+ * quem corrigiu e o texto original; a linha da correção mostra o que ela corrigiu.
+ */
+ private function reasonNote(DelasTransition $record): ?string
{
+ if ($record->corrected instanceof DelasTransition) {
+ return $this->text('panel-admin::delas.actions.original_reason', ['reason' => $record->corrected->reason]);
+ }
+
$correction = $record->latestCorrection;
if (!$correction instanceof DelasTransition) {
return null;
}
- $note = __('panel-admin::delas.actions.corrected_note', [
+ return $this->text('panel-admin::delas.actions.corrected_note', [
'date' => $correction->created_at?->timezone(config('app.display_timezone'))->format('d/m/y'),
'name' => $correction->actor->name ?? '—',
- ]);
-
- return is_string($note) ? $note : null;
- }
-
- /**
- * O texto original fica a um passe de mouse: corrigir nunca esconde o que foi escrito.
- */
- private function originalNote(DelasTransition $record): ?string
- {
- if (!$record->latestCorrection instanceof DelasTransition) {
- return null;
- }
-
- $note = __('panel-admin::delas.actions.original_reason', ['reason' => $record->reason]);
-
- return is_string($note) ? $note : null;
+ ]).' · '.$this->text('panel-admin::delas.actions.original_reason', ['reason' => $record->reason]);
}
}
diff --git a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
index b2d0bb8c7..37f07f5c5 100644
--- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
+++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
@@ -368,7 +368,8 @@ function mountedPersonSelect(Testable $page): Select
->assertActionHidden(TestAction::make('correctReason')->table($others))
->callAction(TestAction::make('correctReason')->table($own), data: ['reason' => 'Perfil incompleto.'])
->assertNotified(__('panel-admin::delas.actions.reason_corrected'))
- ->assertSee('Perfil incompleto.');
+ ->assertSee('Perfil incompleto.')
+ ->assertSee(__('panel-admin::delas.actions.original_reason', ['reason' => 'Perfil incompleo.']));
expect($own->fresh()->reason)->toBe('Perfil incompleo.')
->and($own->fresh()->currentReason())->toBe('Perfil incompleto.');
From 63bae3355f74dbb1ffe520c5de47d008b00b411f Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 18:54:08 -0300
Subject: [PATCH 35/77] =?UTF-8?q?feat(panel-admin):=20motivo=20editado=20c?=
=?UTF-8?q?om=20"ver=20original"=20clic=C3=A1vel=20e=20prazo=20para=20edit?=
=?UTF-8?q?ar?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
app-modules/delas/lang/en/enums.php | 2 +-
app-modules/delas/lang/en/exceptions.php | 6 +-
app-modules/delas/lang/pt_BR/enums.php | 2 +-
app-modules/delas/lang/pt_BR/exceptions.php | 6 +-
app-modules/panel-admin/lang/en/delas.php | 20 +++--
app-modules/panel-admin/lang/pt_BR/delas.php | 20 +++--
.../Pages/Delas/DelasHistoryPage.php | 80 ++++++++++++++++---
.../Delas/DelasModerationPagesTest.php | 20 ++++-
8 files changed, 123 insertions(+), 33 deletions(-)
diff --git a/app-modules/delas/lang/en/enums.php b/app-modules/delas/lang/en/enums.php
index b2df4cc15..9f1bb64f1 100644
--- a/app-modules/delas/lang/en/enums.php
+++ b/app-modules/delas/lang/en/enums.php
@@ -30,7 +30,7 @@
'blocked' => ['label' => 'Blocked', 'description' => 'The person was prevented from requesting the tag.'],
'unblocked' => ['label' => 'Unblocked', 'description' => 'The person can request the tag again.'],
'moderator_added' => ['label' => 'Moderator added', 'description' => 'A lead gave the He4rt Delas moderator role.'],
- 'reason_corrected' => ['label' => 'Reason corrected', 'description' => 'The reason of a decision was corrected; the original stays in the history.'],
+ 'reason_corrected' => ['label' => 'Reason edited', 'description' => 'The reason of a decision was edited; the original stays in the history.'],
'moderator_removed' => ['label' => 'Moderator removed', 'description' => 'A lead removed the He4rt Delas moderator role.'],
],
'triggered_by' => [
diff --git a/app-modules/delas/lang/en/exceptions.php b/app-modules/delas/lang/en/exceptions.php
index 5fc656b5c..4d491b599 100644
--- a/app-modules/delas/lang/en/exceptions.php
+++ b/app-modules/delas/lang/en/exceptions.php
@@ -18,7 +18,7 @@
'cannot_manage_role' => 'Leads and super admins are managed in /admin.',
'already_moderator' => 'This person is already a He4rt Delas moderator.',
'not_moderator' => 'This person is not a He4rt Delas moderator.',
- 'reason_not_correctable' => 'This history entry has no reason that can be corrected.',
- 'cannot_correct_reason' => 'Only whoever wrote the reason can correct it, up to :hours hours later. After that, ask a lead.',
- 'reason_unchanged' => 'The corrected reason is the same as the current one.',
+ 'reason_not_correctable' => 'This history entry has no reason that can be edited.',
+ 'cannot_correct_reason' => 'Only whoever wrote the reason can edit it, up to :hours hours later. After that, ask a lead.',
+ 'reason_unchanged' => 'The edited reason is the same as the current one.',
];
diff --git a/app-modules/delas/lang/pt_BR/enums.php b/app-modules/delas/lang/pt_BR/enums.php
index c605a5285..b8f085343 100644
--- a/app-modules/delas/lang/pt_BR/enums.php
+++ b/app-modules/delas/lang/pt_BR/enums.php
@@ -30,7 +30,7 @@
'blocked' => ['label' => 'Bloqueou', 'description' => 'A pessoa foi impedida de solicitar a tag.'],
'unblocked' => ['label' => 'Desbloqueou', 'description' => 'A pessoa voltou a poder solicitar a tag.'],
'moderator_added' => ['label' => 'Moderadora adicionada', 'description' => 'Uma líder deu o papel de moderadora He4rt Delas.'],
- 'reason_corrected' => ['label' => 'Motivo corrigido', 'description' => 'O motivo de uma decisão foi corrigido; a versão original continua no histórico.'],
+ 'reason_corrected' => ['label' => 'Motivo editado', 'description' => 'O motivo de uma decisão foi editado; a versão original continua no histórico.'],
'moderator_removed' => ['label' => 'Moderadora removida', 'description' => 'Uma líder retirou o papel de moderadora He4rt Delas.'],
],
'triggered_by' => [
diff --git a/app-modules/delas/lang/pt_BR/exceptions.php b/app-modules/delas/lang/pt_BR/exceptions.php
index 83038de19..45dc7f7e4 100644
--- a/app-modules/delas/lang/pt_BR/exceptions.php
+++ b/app-modules/delas/lang/pt_BR/exceptions.php
@@ -18,7 +18,7 @@
'cannot_manage_role' => 'Líderes e super admins são gerenciados no /admin.',
'already_moderator' => 'Esta pessoa já é moderadora He4rt Delas.',
'not_moderator' => 'Esta pessoa não é moderadora He4rt Delas.',
- 'reason_not_correctable' => 'Esta linha do histórico não tem um motivo que possa ser corrigido.',
- 'cannot_correct_reason' => 'Só quem escreveu o motivo pode corrigi-lo, e até :hours horas depois. Depois disso, peça a uma líder.',
- 'reason_unchanged' => 'O motivo corrigido é igual ao atual.',
+ 'reason_not_correctable' => 'Esta linha do histórico não tem um motivo que possa ser editado.',
+ 'cannot_correct_reason' => 'Só quem escreveu o motivo pode editá-lo, e até :hours horas depois. Depois disso, peça a uma líder.',
+ 'reason_unchanged' => 'O motivo editado é igual ao atual.',
];
diff --git a/app-modules/panel-admin/lang/en/delas.php b/app-modules/panel-admin/lang/en/delas.php
index 779c95a30..f7d453816 100644
--- a/app-modules/panel-admin/lang/en/delas.php
+++ b/app-modules/panel-admin/lang/en/delas.php
@@ -66,13 +66,19 @@
'reason_hint' => 'Internal: the person does not see this reason.',
'history_hint' => 'Recorded in the history.',
'actions' => [
- 'correct_reason' => 'Correct reason',
- 'correct_reason_heading' => 'Correct the reason',
- 'correct_reason_body' => 'The original stays in the history. Readers see the corrected reason, with the date and who corrected it.',
- 'correct_reason_field' => 'Corrected reason',
- 'reason_corrected' => 'Reason corrected',
- 'corrected_note' => 'Corrected on :date by :name',
- 'original_reason' => 'Original: :reason',
+ 'correct_reason' => 'Edit reason',
+ 'correct_reason_heading' => 'Edit the reason',
+ 'correct_reason_body' => 'The original stays in the history. Readers see the edited reason, with the date and who edited it.',
+ 'correct_reason_field' => 'Edited reason',
+ 'reason_corrected' => 'Reason edited',
+ 'corrected_note' => 'Edited on :date by :name',
+ 'view_original' => 'view original',
+ 'original_heading' => 'Original reason',
+ 'original_written' => 'Written by :name on :date.',
+ 'close' => 'Close',
+ 'correct_until' => 'You can edit it until :date.',
+ 'correct_anytime' => 'As a lead, you can edit it at any time.',
+ 'message_label' => 'Message:',
'approve' => 'Approve',
'approve_heading' => 'Approve :name?',
'approve_body' => "The He4rt Delas tag will show on @:username's profile.",
diff --git a/app-modules/panel-admin/lang/pt_BR/delas.php b/app-modules/panel-admin/lang/pt_BR/delas.php
index 2e05959d7..f3ba0eb1c 100644
--- a/app-modules/panel-admin/lang/pt_BR/delas.php
+++ b/app-modules/panel-admin/lang/pt_BR/delas.php
@@ -66,13 +66,19 @@
'reason_hint' => 'Uso interno: a pessoa não vê este motivo.',
'history_hint' => 'Fica registrado no histórico.',
'actions' => [
- 'correct_reason' => 'Corrigir motivo',
- 'correct_reason_heading' => 'Corrigir o motivo',
- 'correct_reason_body' => 'A versão original continua no histórico. Quem lê vê o motivo corrigido, com a data e quem corrigiu.',
- 'correct_reason_field' => 'Motivo corrigido',
- 'reason_corrected' => 'Motivo corrigido',
- 'corrected_note' => 'Corrigido em :date por :name',
- 'original_reason' => 'Original: :reason',
+ 'correct_reason' => 'Editar motivo',
+ 'correct_reason_heading' => 'Editar o motivo',
+ 'correct_reason_body' => 'A versão original continua no histórico. Quem lê vê o motivo editado, com a data e quem editou.',
+ 'correct_reason_field' => 'Motivo editado',
+ 'reason_corrected' => 'Motivo editado',
+ 'corrected_note' => 'Editado em :date por :name',
+ 'view_original' => 'ver original',
+ 'original_heading' => 'Motivo original',
+ 'original_written' => 'Escrito por :name em :date.',
+ 'close' => 'Fechar',
+ 'correct_until' => 'Você pode editar até :date.',
+ 'correct_anytime' => 'Como líder, você edita a qualquer momento.',
+ 'message_label' => 'Mensagem:',
'approve' => 'Aprovar',
'approve_heading' => 'Aprovar :name?',
'approve_body' => 'A tag He4rt Delas passa a aparecer no perfil de @:username.',
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
index ce5c8fb3b..b0edd31d4 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
@@ -5,6 +5,7 @@
namespace He4rt\PanelAdmin\Moderation\Pages\Delas;
use BackedEnum;
+use Carbon\CarbonInterface;
use Filament\Actions\Action;
use Filament\Pages\Page;
use Filament\Support\Icons\Heroicon;
@@ -18,6 +19,7 @@
use He4rt\Delas\History\Models\DelasTransition;
use He4rt\PanelAdmin\Moderation\ModerationCluster;
use He4rt\PanelAdmin\Moderation\Pages\Delas\Concerns\InteractsWithDelasModeration;
+use Illuminate\Support\HtmlString;
/**
* Histórico das decisões sobre a tag He4rt Delas. A moderadora vê as decisões;
@@ -60,7 +62,7 @@ public function getSubheading(): string
public function table(Table $table): Table
{
- $query = DelasTransition::query()->with(['user', 'actor', 'corrected', 'latestCorrection.actor']);
+ $query = DelasTransition::query()->with(['user', 'actor', 'corrected.actor', 'latestCorrection.actor']);
// A moderadora vê as decisões; a líder vê também os pedidos e cada correção de motivo.
if (!$this->isLead()) {
@@ -86,7 +88,8 @@ public function table(Table $table): Table
TextColumn::make('reason')
->label(__('panel-admin::delas.columns.reason'))
->state(fn (DelasTransition $record): ?string => $record->currentReason())
- ->description(fn (DelasTransition $record): ?string => $this->reasonNote($record))
+ ->description(fn (DelasTransition $record): ?HtmlString => $this->reasonNote($record))
+ ->action($this->viewOriginalAction())
->wrap()
->lineClamp(2)
->placeholder('—'),
@@ -100,7 +103,8 @@ public function table(Table $table): Table
->size('sm')
->visible(fn (DelasTransition $record): bool => $this->canCorrect($record))
->modalHeading(__('panel-admin::delas.actions.correct_reason_heading'))
- ->modalDescription(__('panel-admin::delas.actions.correct_reason_body'))
+ ->tooltip(fn (DelasTransition $record): string => $this->correctionWindowNote($record))
+ ->modalDescription(fn (DelasTransition $record): string => $this->text('panel-admin::delas.actions.correct_reason_body').' '.$this->correctionWindowNote($record))
->fillForm(fn (DelasTransition $record): array => ['reason' => $record->currentReason()])
->schema([$this->reasonField(__('panel-admin::delas.actions.correct_reason_field'))])
->action(fn (DelasTransition $record, array $data): bool => $this->attempt(
@@ -134,24 +138,80 @@ private function canCorrect(DelasTransition $record): bool
}
/**
- * Corrigir nunca esconde o que foi escrito: a linha corrigida mostra quando,
- * quem corrigiu e o texto original; a linha da correção mostra o que ela corrigiu.
+ * Clicar no motivo corrigido abre o texto original, com quem escreveu e quando.
*/
- private function reasonNote(DelasTransition $record): ?string
+ private function viewOriginalAction(): Action
+ {
+ return Action::make('viewOriginal')
+ ->disabled(fn (DelasTransition $record): bool => !$this->originalOf($record) instanceof DelasTransition)
+ ->modalHeading(__('panel-admin::delas.actions.original_heading'))
+ ->modalDescription(function (DelasTransition $record): ?string {
+ $original = $this->originalOf($record);
+
+ return $original instanceof DelasTransition ? $this->text('panel-admin::delas.actions.original_written', [
+ 'name' => $original->actor->name ?? '—',
+ 'date' => $this->displayDate($original->created_at),
+ ]) : null;
+ })
+ ->modalContent(fn (DelasTransition $record): HtmlString => new HtmlString(
+ '
+ @endforeach
+
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
index b0edd31d4..58af9e703 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php
@@ -19,6 +19,7 @@
use He4rt\Delas\History\Models\DelasTransition;
use He4rt\PanelAdmin\Moderation\ModerationCluster;
use He4rt\PanelAdmin\Moderation\Pages\Delas\Concerns\InteractsWithDelasModeration;
+use Illuminate\Contracts\View\View;
use Illuminate\Support\HtmlString;
/**
@@ -62,11 +63,15 @@ public function getSubheading(): string
public function table(Table $table): Table
{
- $query = DelasTransition::query()->with(['user', 'actor', 'corrected.actor', 'latestCorrection.actor']);
+ // Cada edição de motivo fica guardada como linha própria, mas aparece dentro
+ // da linha que ela edita, não como uma linha a mais.
+ $query = DelasTransition::query()
+ ->with(['user', 'actor', 'corrections.actor'])
+ ->where('action', '!=', DelasAction::ReasonCorrected);
- // A moderadora vê as decisões; a líder vê também os pedidos e cada correção de motivo.
+ // A moderadora vê as decisões; a líder vê também os pedidos.
if (!$this->isLead()) {
- $query->whereNotIn('action', [DelasAction::Requested, DelasAction::ReasonCorrected]);
+ $query->where('action', '!=', DelasAction::Requested);
}
return $table
@@ -89,7 +94,7 @@ public function table(Table $table): Table
->label(__('panel-admin::delas.columns.reason'))
->state(fn (DelasTransition $record): ?string => $record->currentReason())
->description(fn (DelasTransition $record): ?HtmlString => $this->reasonNote($record))
- ->action($this->viewOriginalAction())
+ ->action($this->viewVersionsAction())
->wrap()
->lineClamp(2)
->placeholder('—'),
@@ -115,7 +120,10 @@ public function table(Table $table): Table
->filters($this->isLead() ? [
SelectFilter::make('action')
->label(__('panel-admin::delas.columns.action'))
- ->options(DelasAction::class),
+ ->options(collect(DelasAction::cases())
+ ->reject(fn (DelasAction $action): bool => $action === DelasAction::ReasonCorrected)
+ ->mapWithKeys(fn (DelasAction $action): array => [$action->value => $action->getLabel()])
+ ->all()),
] : []);
}
@@ -138,62 +146,43 @@ private function canCorrect(DelasTransition $record): bool
}
/**
- * Clicar no motivo corrigido abre o texto original, com quem escreveu e quando.
+ * Só a liderança abre as versões do motivo: a original e cada edição. Quem
+ * edita pode ter tirado algo sensível, e isso não volta para a tela de todas.
*/
- private function viewOriginalAction(): Action
+ private function viewVersionsAction(): Action
{
- return Action::make('viewOriginal')
- ->disabled(fn (DelasTransition $record): bool => !$this->originalOf($record) instanceof DelasTransition)
- ->modalHeading(__('panel-admin::delas.actions.original_heading'))
- ->modalDescription(function (DelasTransition $record): ?string {
- $original = $this->originalOf($record);
-
- return $original instanceof DelasTransition ? $this->text('panel-admin::delas.actions.original_written', [
- 'name' => $original->actor->name ?? '—',
- 'date' => $this->displayDate($original->created_at),
- ]) : null;
- })
- ->modalContent(fn (DelasTransition $record): HtmlString => new HtmlString(
- '
',
- ))
+ return Action::make('viewVersions')
+ ->disabled(fn (DelasTransition $record): bool => !$this->isLead() || $record->corrections->isEmpty())
+ ->modalHeading(__('panel-admin::delas.actions.versions_heading'))
+ ->modalContent(fn (DelasTransition $record): View => view('panel-admin::moderation.delas.reason-versions', [
+ 'versions' => $record->corrections->prepend($record)->values(),
+ ]))
->modalSubmitAction(action: false)
->modalCancelActionLabel(__('panel-admin::delas.actions.close'));
}
/**
- * A decisão cujo motivo foi corrigido: a própria linha, se já tem correção,
- * ou a linha que a correção aponta.
- */
- private function originalOf(DelasTransition $record): ?DelasTransition
- {
- if ($record->corrected instanceof DelasTransition) {
- return $record->corrected;
- }
-
- return $record->latestCorrection instanceof DelasTransition ? $record : null;
- }
-
- /**
- * "Corrigido em DD/MM/AA por X · ver original" na linha corrigida; só
- * "ver original" na linha da correção.
+ * "Editado em DD/MM/AA por X" na linha cujo motivo foi editado; a liderança
+ * ganha também o "ver versões".
*/
private function reasonNote(DelasTransition $record): ?HtmlString
{
- if (!$this->originalOf($record) instanceof DelasTransition) {
+ $latest = $record->corrections->last();
+
+ if (!$latest instanceof DelasTransition) {
return null;
}
- $link = ''.e($this->text('panel-admin::delas.actions.view_original')).'';
- $correction = $record->latestCorrection;
+ $note = e($this->text('panel-admin::delas.actions.corrected_note', [
+ 'date' => $latest->created_at?->timezone(config('app.display_timezone'))->format('d/m/y'),
+ 'name' => $latest->actor->name ?? '—',
+ ]));
- if (!$correction instanceof DelasTransition) {
- return new HtmlString($link);
+ if ($this->isLead()) {
+ $note .= ' · '.e($this->text('panel-admin::delas.actions.view_versions')).'';
}
- return new HtmlString(e($this->text('panel-admin::delas.actions.corrected_note', [
- 'date' => $correction->created_at?->timezone(config('app.display_timezone'))->format('d/m/y'),
- 'name' => $correction->actor->name ?? '—',
- ])).' · '.$link);
+ return new HtmlString($note);
}
/**
diff --git a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
index b0600f16b..a28a2ad89 100644
--- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
+++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
@@ -7,6 +7,7 @@
use Filament\Forms\Components\Select;
use Filament\Navigation\NavigationItem;
use He4rt\Delas\Block\Models\DelasRequesterBlock;
+use He4rt\Delas\History\Actions\CorrectDelasReason;
use He4rt\Delas\History\Enums\DelasAction;
use He4rt\Delas\History\Models\DelasTransition;
use He4rt\Delas\TagRequest\Enums\DelasRequestStatus;
@@ -369,27 +370,37 @@ function mountedPersonSelect(Testable $page): Select
->callAction(TestAction::make('correctReason')->table($own), data: ['reason' => 'Perfil incompleto.'])
->assertNotified(__('panel-admin::delas.actions.reason_corrected'))
->assertSee('Perfil incompleto.')
- ->assertSee(__('panel-admin::delas.actions.view_original'))
- ->mountAction(TestAction::make('viewOriginal')->table($own))
- ->assertActionMounted(TestAction::make('viewOriginal')->table($own))
- ->assertMountedActionModalSee('Perfil incompleo.');
+ ->assertDontSee(__('panel-admin::delas.actions.view_versions'))
+ ->assertDontSee('Perfil incompleo.');
expect($own->fresh()->reason)->toBe('Perfil incompleo.')
->and($own->fresh()->currentReason())->toBe('Perfil incompleto.');
});
-test('a líder vê a correção como linha própria no histórico; a moderadora, não', function (): void {
- $original = DelasTransition::factory()->create(['action' => DelasAction::Blocked, 'reason' => 'Motivo.']);
- $correction = DelasTransition::factory()->create(['action' => DelasAction::ReasonCorrected, 'corrects_id' => $original->getKey(), 'reason' => 'Motivo corrigido.']);
+test('cada edição fica guardada, sem linha a mais, e só a líder abre as versões', function (): void {
+ $lead = User::factory()->delasLead()->create();
+ $original = DelasTransition::factory()->create(['action' => DelasAction::Blocked, 'actor_id' => $lead->getKey(), 'reason' => 'Primeiro texto.']);
+ resolve(CorrectDelasReason::class)->handle($original, $lead, 'Segundo texto.');
+ $this->travel(1)->minutes();
+ resolve(CorrectDelasReason::class)->handle($original->fresh(), $lead, 'Terceiro texto.');
+ DelasTransition::factory()->create(['action' => DelasAction::Approved]);
+
+ $this->actingAs($lead);
+ livewire(DelasHistoryPage::class)
+ ->loadTable()
+ ->assertCountTableRecords(2)
+ ->assertSee('Terceiro texto.')
+ ->mountAction(TestAction::make('viewVersions')->table($original))
+ ->assertMountedActionModalSee(['Primeiro texto.', 'Segundo texto.', 'Terceiro texto.']);
$this->actingAs(User::factory()->delasModerator()->create());
- livewire(DelasHistoryPage::class)->loadTable()
- ->assertCanSeeTableRecords([$original])
- ->assertCanNotSeeTableRecords([$correction]);
+ livewire(DelasHistoryPage::class)
+ ->loadTable()
+ ->assertSee('Terceiro texto.')
+ ->assertDontSee(['Primeiro texto.', 'Segundo texto.'])
+ ->assertActionDisabled(TestAction::make('viewVersions')->table($original));
- $this->actingAs(User::factory()->delasLead()->create());
- livewire(DelasHistoryPage::class)->loadTable()
- ->assertCanSeeTableRecords([$original, $correction]);
+ expect(DelasTransition::query()->where('corrects_id', $original->getKey())->count())->toBe(2);
});
test('a moderadora vê quem tem a tag, mas só a líder remove', function (): void {
From 3a45a5b02368a2ce645c128de6f94a36b8bc7f04 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 19:05:11 -0300
Subject: [PATCH 37/77] =?UTF-8?q?docs(delas):=20edi=C3=A7=C3=A3o=20de=20mo?=
=?UTF-8?q?tivo=20e=20quem=20v=C3=AA=20as=20vers=C3=B5es?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
app-modules/delas/CONTEXT.md | 26 +++++++++----------
...01-modulo-proprio-com-papel-e-historico.md | 8 +++---
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 16 +++++++-----
3 files changed, 27 insertions(+), 23 deletions(-)
diff --git a/app-modules/delas/CONTEXT.md b/app-modules/delas/CONTEXT.md
index f9ea3f707..d4c10b166 100644
--- a/app-modules/delas/CONTEXT.md
+++ b/app-modules/delas/CONTEXT.md
@@ -21,16 +21,16 @@ Os dois painéis dependem deste módulo, e este módulo só depende do `identity
## Glossário
-| Termo | Definição | Não confundir com |
-| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------- |
-| **Tag He4rt Delas** | Marca no perfil de que a pessoa faz parte da He4rt Delas. Existe quando a solicitação dela está `approved`. | Um Badge do `gamification`: badges vêm de XP ou claim, a tag vem de uma decisão. |
-| **Solicitação** | Uma linha em `delas_tag_requests`: o pedido da tag e a decisão sobre ele (`pending`, `approved`, `rejected`, `revoked`). | O cargo `he4rt_delas` do Discord, concedido pelo `/cargo-delas`. Os dois ainda não são sincronizados. |
-| **Moderadora He4rt Delas** | Quem tem a role `delas-moderator` (`UserRole::DelasModerator`) e passa no gate `moderate-delas`. Decide solicitações e bloqueia solicitantes. | A moderação de conteúdo do módulo `moderation` (Case, Appeal, Moderator). |
-| **Líder He4rt Delas** | Quem tem a role `delas-lead` (`UserRole::DelasLead`) e passa no gate `lead-delas`. Tudo o que a moderadora faz, mais gerenciar moderadoras, conceder e remover a tag e ver o histórico completo (página Equipe). | Super admin: no `/admin` a líder só acessa a área da He4rt Delas e não nomeia outras líderes. |
-| **Bloqueio** | Uma linha em `delas_requester_blocks`: impede a pessoa de solicitar a tag até ser desbloqueada. Sempre tem motivo. | Ban ou suspensão (`UserSituation` do `identity`): o bloqueio não afeta a conta nem o resto do Hub. |
-| **Espera** | Prazo depois de uma solicitação `rejected` ou `revoked` em que a pessoa não pode pedir de novo. Padrão de 15 dias (`delas.request_cooldown_days`). | O bloqueio: a espera acaba sozinha, o bloqueio só acaba quando alguém desbloqueia. |
-| **Concessão direta** | Líder (ou super admin) dá a tag sem solicitação e sem espera (`GrantDelasTag`). Encerra um bloqueio ativo, se houver. | Aprovar uma solicitação: aprovar é decisão sobre um pedido que a pessoa fez. |
-| **Histórico** | `delas_transitions`: uma linha por ação (solicitar, aprovar, rejeitar, conceder, remover, bloquear, desbloquear), com quem fez, quando e motivo. | Logs da aplicação: o histórico é dado de domínio, append-only, gravado pelas próprias actions. |
-| **Candidatas** | Quem pode ser escolhida nos seletores de pessoa da Equipe (`DelasCandidates`): conceder lista quem não tem a tag, remover lista só quem tem, adicionar moderadora exclui super admins e a equipe. Quem age nunca aparece. | A regra de negócio: a consulta só filtra a lista; quem valida a ação são as actions de domínio. |
-| **Membra** | Quem tem a tag hoje: solicitação `approved`. Aparece na página Membras, onde a líder pode remover a tag e bloquear novos pedidos junto. | Moderadora: membra é quem tem a tag, moderadora é quem decide sobre ela. |
-| **Correção de motivo** | Linha `reason_corrected` no histórico que aponta (`corrects_id`) para a decisão corrigida. A original fica como foi escrita; vale a correção mais recente. | Editar o motivo: nada no histórico é sobrescrito. |
+| Termo | Definição | Não confundir com |
+| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| **Tag He4rt Delas** | Marca no perfil de que a pessoa faz parte da He4rt Delas. Existe quando a solicitação dela está `approved`. | Um Badge do `gamification`: badges vêm de XP ou claim, a tag vem de uma decisão. |
+| **Solicitação** | Uma linha em `delas_tag_requests`: o pedido da tag e a decisão sobre ele (`pending`, `approved`, `rejected`, `revoked`). | O cargo `he4rt_delas` do Discord, concedido pelo `/cargo-delas`. Os dois ainda não são sincronizados. |
+| **Moderadora He4rt Delas** | Quem tem a role `delas-moderator` (`UserRole::DelasModerator`) e passa no gate `moderate-delas`. Decide solicitações e bloqueia solicitantes. | A moderação de conteúdo do módulo `moderation` (Case, Appeal, Moderator). |
+| **Líder He4rt Delas** | Quem tem a role `delas-lead` (`UserRole::DelasLead`) e passa no gate `lead-delas`. Tudo o que a moderadora faz, mais gerenciar moderadoras, conceder e remover a tag e ver o histórico completo (página Equipe). | Super admin: no `/admin` a líder só acessa a área da He4rt Delas e não nomeia outras líderes. |
+| **Bloqueio** | Uma linha em `delas_requester_blocks`: impede a pessoa de solicitar a tag até ser desbloqueada. Sempre tem motivo. | Ban ou suspensão (`UserSituation` do `identity`): o bloqueio não afeta a conta nem o resto do Hub. |
+| **Espera** | Prazo depois de uma solicitação `rejected` ou `revoked` em que a pessoa não pode pedir de novo. Padrão de 15 dias (`delas.request_cooldown_days`). | O bloqueio: a espera acaba sozinha, o bloqueio só acaba quando alguém desbloqueia. |
+| **Concessão direta** | Líder (ou super admin) dá a tag sem solicitação e sem espera (`GrantDelasTag`). Encerra um bloqueio ativo, se houver. | Aprovar uma solicitação: aprovar é decisão sobre um pedido que a pessoa fez. |
+| **Histórico** | `delas_transitions`: uma linha por ação (solicitar, aprovar, rejeitar, conceder, remover, bloquear, desbloquear), com quem fez, quando e motivo. | Logs da aplicação: o histórico é dado de domínio, append-only, gravado pelas próprias actions. |
+| **Candidatas** | Quem pode ser escolhida nos seletores de pessoa da Equipe (`DelasCandidates`): conceder lista quem não tem a tag, remover lista só quem tem, adicionar moderadora exclui super admins e a equipe. Quem age nunca aparece. | A regra de negócio: a consulta só filtra a lista; quem valida a ação são as actions de domínio. |
+| **Membra** | Quem tem a tag hoje: solicitação `approved`. Aparece na página Membras, onde a líder pode remover a tag e bloquear novos pedidos junto. | Moderadora: membra é quem tem a tag, moderadora é quem decide sobre ela. |
+| **Edição de motivo** | Linha `reason_corrected` no histórico que aponta (`corrects_id`) para a decisão editada. A original fica como foi escrita; vale a edição mais recente. Na tela, "Editar motivo" e "Editado em". | Sobrescrever o motivo: nada no histórico é apagado. No código, a action se chama `CorrectDelasReason`. |
diff --git a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
index 727a8cc0b..4e672d022 100644
--- a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
+++ b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
@@ -51,10 +51,10 @@ precisa morar em algum lugar e ter uma forma de autorizar quem decide.
quem bloqueou ou por super admin.
- **Histórico append-only** em `delas_transitions`, gravado pelas actions, sem trigger (ADR-0003
do `events`).
-- **Corrigir motivo sem apagar.** Um motivo errado se corrige com uma linha nova
- (`reason_corrected`, `corrects_id` apontando para a original), nunca editando a original. O
- motivo vigente na solicitação ou no bloqueio passa a ser o corrigido. Quem escreveu corrige até
- 24 horas depois; a líder, sempre.
+- **Editar motivo sem apagar.** Cada edição é uma linha nova (`reason_corrected`, `corrects_id`
+ apontando para a original), nunca uma alteração da original. O motivo vigente na solicitação ou
+ no bloqueio passa a ser o editado. Quem escreveu edita até 24 horas depois; a líder, sempre. Só
+ a liderança vê as versões anteriores na tela: quem edita pode ter tirado algo sensível.
- _Alternativa descartada:_ editar o campo `reason` direto. Mais simples, mas apagaria o que
foi escrito e quebraria o append-only.
- **Moderação no `/admin`, pedido e tag no `/app`.** Moderação na He4rt mora no `/admin`, no
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index d35359a3a..93e1bc8d2 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -91,10 +91,13 @@ Fatos do código atual que moldam o desenho:
- O bloqueio vale **só** para solicitar a tag. Não é ban nem suspensão (`UserSituation`) e não
afeta a conta.
- Veem a lista de quem tem a tag (página Membras), só para consulta.
-- Corrigem o motivo que escreveram até 24 horas depois (`delas.reason_correction_hours`). A
- correção é uma linha nova no histórico (`reason_corrected`, com `corrects_id` apontando para a
- original); a original nunca muda. A tela mostra o motivo corrigido, "corrigido em DD/MM/AA por
- X" e, ao passar o mouse, o texto original.
+- Editam o motivo que escreveram até 24 horas depois (`delas.reason_correction_hours`); o botão
+ "Editar motivo" mostra até quando. Cada edição é uma linha nova no histórico
+ (`reason_corrected`, com `corrects_id` apontando para a original), e a original nunca muda. Na
+ tabela, a edição não vira uma linha a mais: a linha editada mostra o texto que vale hoje e
+ "Editado em DD/MM/AA por X".
+- Não veem as versões anteriores do motivo. Quem edita pode ter tirado algo sensível, e isso não
+ volta para a tela de toda a equipe.
### Liderança (líderes da He4rt Delas)
@@ -107,7 +110,8 @@ que a moderadora tem, mais:
- na Equipe, adiciona e revoga `delas-moderator`. Não cria nem revoga líderes, e não age sobre
super admins;
- desbloqueia qualquer bloqueio;
-- corrige qualquer motivo, a qualquer momento;
+- edita qualquer motivo, a qualquer momento, e abre "ver versões": a original e cada edição,
+ com quem escreveu e quando;
- concede e remove a tag direto:
- se houver solicitação `pending`, ela é aprovada (`pending → approved`);
- se não houver, é criada uma solicitação já `approved`;
@@ -328,7 +332,7 @@ dispara também `DelasRequesterUnblocked`. Nenhum listener nesta entrega.
| Fila | `moderate-delas` | pendentes | aprovar, rejeitar, bloquear |
| Membras | `moderate-delas` | membras com a tag | quem tem a tag, desde quando e quem decidiu; líder: remover a tag, com a opção de bloquear novos pedidos |
| Bloqueios | `moderate-delas` | bloqueios ativos | desbloquear (moderadora: os próprios; líder: todos) |
- | Histórico | `moderate-delas` | | moderadora: decisões; líder: completo, com filtro por ação; corrigir motivo |
+ | Histórico | `moderate-delas` | | moderadora: decisões; líder: completo, com filtro por ação e versões do motivo; editar motivo |
| Equipe | `lead-delas` | | números (pendentes, membras com a tag, tempo médio até a decisão, aprovadas e rejeitadas no mês, bloqueios ativos), conceder e remover a tag, adicionar e revogar moderadora |
- Os seletores de pessoa da Equipe usam a consulta de domínio `DelasCandidates`: conceder e
From 24e3e8302c0846a5d282d40fe54dca1bb56bbf17 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 19:10:08 -0300
Subject: [PATCH 38/77] =?UTF-8?q?feat(delas):=20s=C3=B3=20quem=20tem=20a?=
=?UTF-8?q?=20tag=20vira=20moderadora?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
app-modules/delas/lang/en/exceptions.php | 1 +
app-modules/delas/lang/pt_BR/exceptions.php | 1 +
.../delas/src/Exceptions/DelasException.php | 5 +++++
.../src/Team/Actions/AddDelasModerator.php | 8 ++++++--
.../src/Team/Queries/DelasCandidates.php | 7 ++++---
.../Feature/Team/DelasCandidatesTest.php | 9 +++++++--
.../Team/ManageDelasModeratorsTest.php | 12 ++++++++++-
app-modules/panel-admin/lang/en/delas.php | 1 +
app-modules/panel-admin/lang/pt_BR/delas.php | 1 +
.../Moderation/Pages/Delas/DelasTeamPage.php | 3 ++-
.../Delas/DelasModerationPagesTest.php | 20 +++++++++++++------
11 files changed, 53 insertions(+), 15 deletions(-)
diff --git a/app-modules/delas/lang/en/exceptions.php b/app-modules/delas/lang/en/exceptions.php
index 4d491b599..6a0028925 100644
--- a/app-modules/delas/lang/en/exceptions.php
+++ b/app-modules/delas/lang/en/exceptions.php
@@ -16,6 +16,7 @@
'already_has_tag' => 'This person already has the He4rt Delas tag.',
'has_no_tag' => 'This person does not have the He4rt Delas tag.',
'cannot_manage_role' => 'Leads and super admins are managed in /admin.',
+ 'moderator_needs_tag' => 'Only people with the He4rt Delas tag can be moderators. Grant the tag first.',
'already_moderator' => 'This person is already a He4rt Delas moderator.',
'not_moderator' => 'This person is not a He4rt Delas moderator.',
'reason_not_correctable' => 'This history entry has no reason that can be edited.',
diff --git a/app-modules/delas/lang/pt_BR/exceptions.php b/app-modules/delas/lang/pt_BR/exceptions.php
index 45dc7f7e4..e2c5cf3d1 100644
--- a/app-modules/delas/lang/pt_BR/exceptions.php
+++ b/app-modules/delas/lang/pt_BR/exceptions.php
@@ -16,6 +16,7 @@
'already_has_tag' => 'Esta pessoa já tem a tag He4rt Delas.',
'has_no_tag' => 'Esta pessoa não tem a tag He4rt Delas.',
'cannot_manage_role' => 'Líderes e super admins são gerenciados no /admin.',
+ 'moderator_needs_tag' => 'Só quem tem a tag He4rt Delas pode ser moderadora. Conceda a tag antes.',
'already_moderator' => 'Esta pessoa já é moderadora He4rt Delas.',
'not_moderator' => 'Esta pessoa não é moderadora He4rt Delas.',
'reason_not_correctable' => 'Esta linha do histórico não tem um motivo que possa ser editado.',
diff --git a/app-modules/delas/src/Exceptions/DelasException.php b/app-modules/delas/src/Exceptions/DelasException.php
index 9eee3d98b..a860440a5 100644
--- a/app-modules/delas/src/Exceptions/DelasException.php
+++ b/app-modules/delas/src/Exceptions/DelasException.php
@@ -88,6 +88,11 @@ public static function cannotManageRole(): self
return new self(__('delas::exceptions.cannot_manage_role'), Response::HTTP_FORBIDDEN);
}
+ public static function moderatorNeedsTag(): self
+ {
+ return new self(__('delas::exceptions.moderator_needs_tag'), Response::HTTP_UNPROCESSABLE_ENTITY);
+ }
+
public static function alreadyModerator(): self
{
return new self(__('delas::exceptions.already_moderator'), Response::HTTP_CONFLICT);
diff --git a/app-modules/delas/src/Team/Actions/AddDelasModerator.php b/app-modules/delas/src/Team/Actions/AddDelasModerator.php
index 6b8c48a67..039bd24fc 100644
--- a/app-modules/delas/src/Team/Actions/AddDelasModerator.php
+++ b/app-modules/delas/src/Team/Actions/AddDelasModerator.php
@@ -7,6 +7,7 @@
use He4rt\Delas\Exceptions\DelasException;
use He4rt\Delas\History\Actions\RecordDelasTransition;
use He4rt\Delas\History\Enums\DelasAction;
+use He4rt\Delas\TagRequest\Queries\DelasEligibility;
use He4rt\Identity\Authorization\Enums\UserRole;
use He4rt\Identity\User\Models\User;
use Illuminate\Auth\Access\AuthorizationException;
@@ -14,13 +15,15 @@
use Illuminate\Support\Facades\Gate;
/**
- * Uma líder (ou super admin) dá o papel de moderadora He4rt Delas pelo Hub.
- * Líderes e super admins são gerenciados no /admin, não aqui.
+ * Uma líder (ou super admin) dá o papel de moderadora He4rt Delas. Só quem já
+ * tem a tag pode moderar: quem modera a He4rt Delas faz parte dela. Líderes e
+ * super admins são gerenciados no cadastro de usuários, não aqui.
*/
final readonly class AddDelasModerator
{
public function __construct(
private RecordDelasTransition $recordTransition,
+ private DelasEligibility $eligibility,
) {}
/**
@@ -36,6 +39,7 @@ public function handle(User $target, User $actor): User
DelasException::cannotManageRole(),
);
throw_if($target->hasRole(UserRole::DelasModerator), DelasException::alreadyModerator());
+ throw_unless($this->eligibility->hasTag($target), DelasException::moderatorNeedsTag());
DB::transaction(function () use ($target, $actor): void {
$target->assignRole(UserRole::DelasModerator);
diff --git a/app-modules/delas/src/Team/Queries/DelasCandidates.php b/app-modules/delas/src/Team/Queries/DelasCandidates.php
index 6d33c344a..e17b2566f 100644
--- a/app-modules/delas/src/Team/Queries/DelasCandidates.php
+++ b/app-modules/delas/src/Team/Queries/DelasCandidates.php
@@ -45,15 +45,16 @@ public function forRevoke(User $actor): Builder
}
/**
- * Quem pode virar moderadora: fora da equipe (moderadoras e líderes) e sem
- * super admin. Filtra pelo nome da role direto, sem o `withoutRole()` do
+ * Quem pode virar moderadora: tem a tag, está fora da equipe (moderadoras e
+ * líderes) e não é super admin. A lista é pequena, então o seletor pode
+ * pré-carregar. Filtra pelo nome da role direto, sem o `withoutRole()` do
* Spatie, que quebra quando uma das roles ainda não existe no banco.
*
* @return Builder
*/
public function forModerator(User $actor): Builder
{
- return $this->others($actor)->whereDoesntHave('roles', fn (Builder $roles): Builder => $roles->whereIn('name', [
+ return $this->others($actor)->whereIn('id', $this->members())->whereDoesntHave('roles', fn (Builder $roles): Builder => $roles->whereIn('name', [
UserRole::SuperAdmin->value,
UserRole::DelasModerator->value,
UserRole::DelasLead->value,
diff --git a/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php b/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
index 6deb4035e..1542dc985 100644
--- a/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
+++ b/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
@@ -32,17 +32,22 @@
expect($this->candidates->forRevoke($this->lead)->pluck('id')->all())->toBe([$member->id]);
});
-test('adicionar moderadora: fora quem é super admin, moderadora ou líder', function (): void {
+test('adicionar moderadora: só quem tem a tag, fora super admin, moderadora ou líder', function (): void {
$member = User::factory()->create();
$streamer = User::factory()->streamer()->create();
+ $withoutTag = User::factory()->create();
$superAdmin = User::factory()->superAdmin()->create();
$moderator = User::factory()->delasModerator()->create();
$otherLead = User::factory()->delasLead()->create();
+ foreach ([$member, $streamer, $superAdmin, $moderator, $otherLead] as $user) {
+ DelasTagRequest::factory()->for($user)->approved()->create(['decided_by' => $this->lead->getKey()]);
+ }
+
$ids = $this->candidates->forModerator($this->lead)->pluck('id')->all();
expect($ids)->toContain($member->id, $streamer->id)
- ->not->toContain($superAdmin->id, $moderator->id, $otherLead->id);
+ ->not->toContain($withoutTag->id, $superAdmin->id, $moderator->id, $otherLead->id);
});
test('a própria pessoa que age nunca aparece', function (): void {
diff --git a/app-modules/delas/tests/Feature/Team/ManageDelasModeratorsTest.php b/app-modules/delas/tests/Feature/Team/ManageDelasModeratorsTest.php
index 9d6d1d4e2..a1f3bba55 100644
--- a/app-modules/delas/tests/Feature/Team/ManageDelasModeratorsTest.php
+++ b/app-modules/delas/tests/Feature/Team/ManageDelasModeratorsTest.php
@@ -5,6 +5,7 @@
use He4rt\Delas\Exceptions\DelasException;
use He4rt\Delas\History\Enums\DelasAction;
use He4rt\Delas\History\Models\DelasTransition;
+use He4rt\Delas\TagRequest\Models\DelasTagRequest;
use He4rt\Delas\Team\Actions\AddDelasModerator;
use He4rt\Delas\Team\Actions\RemoveDelasModerator;
use He4rt\Identity\Authorization\Enums\UserRole;
@@ -13,7 +14,7 @@
test('líder adiciona e remove moderadora, e as duas ações vão para o histórico', function (): void {
$lead = User::factory()->delasLead()->create();
- $target = User::factory()->create();
+ $target = DelasTagRequest::factory()->approved()->create(['decided_by' => $lead->getKey()])->user;
resolve(AddDelasModerator::class)->handle($target, $lead);
expect($target->fresh()->can('moderate-delas'))->toBeTrue();
@@ -24,6 +25,15 @@
->toEqualCanonicalizing([DelasAction::ModeratorAdded, DelasAction::ModeratorRemoved]);
});
+test('só quem tem a tag vira moderadora', function (): void {
+ $lead = User::factory()->delasLead()->create();
+ $withoutTag = User::factory()->create();
+
+ expect(fn () => resolve(AddDelasModerator::class)->handle($withoutTag, $lead))
+ ->toThrow(DelasException::class, __('delas::exceptions.moderator_needs_tag'))
+ ->and($withoutTag->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse();
+});
+
test('moderadora não gerencia a equipe', function (): void {
$moderator = User::factory()->delasModerator()->create();
diff --git a/app-modules/panel-admin/lang/en/delas.php b/app-modules/panel-admin/lang/en/delas.php
index ee506c9b8..85e6e843e 100644
--- a/app-modules/panel-admin/lang/en/delas.php
+++ b/app-modules/panel-admin/lang/en/delas.php
@@ -123,6 +123,7 @@
'add_moderator' => 'Add moderator',
'add_moderator_heading' => 'Add a He4rt Delas moderator',
'add_moderator_body' => 'The person will see the He4rt Delas queue, blocks and history and decide requests. Leads are assigned by super admins in the user form.',
+ 'moderator_hint' => 'Only members with the tag show up. To add someone without the tag, use “Grant tag” first.',
'moderator_added' => 'Moderator added',
'remove_moderator' => 'Revoke moderator',
'remove_moderator_heading' => "Revoke :name's role?",
diff --git a/app-modules/panel-admin/lang/pt_BR/delas.php b/app-modules/panel-admin/lang/pt_BR/delas.php
index 73bf87254..0a1ce8ec8 100644
--- a/app-modules/panel-admin/lang/pt_BR/delas.php
+++ b/app-modules/panel-admin/lang/pt_BR/delas.php
@@ -123,6 +123,7 @@
'add_moderator' => 'Adicionar moderadora',
'add_moderator_heading' => 'Adicionar moderadora He4rt Delas',
'add_moderator_body' => 'A pessoa passa a ver a fila, os bloqueios e o histórico da He4rt Delas e a decidir pedidos. Líderes são atribuídas por super admins, no cadastro de usuários.',
+ 'moderator_hint' => 'Só aparecem membras com a tag. Para adicionar alguém sem a tag, use “Conceder tag” antes.',
'moderator_added' => 'Moderadora adicionada',
'remove_moderator' => 'Revogar moderadora',
'remove_moderator_heading' => 'Revogar o papel de :name?',
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
index d39c26d65..2e8abb41d 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
@@ -91,7 +91,8 @@ public function table(Table $table): Table
->modalHeading(__('panel-admin::delas.actions.add_moderator_heading'))
->modalDescription(__('panel-admin::delas.actions.add_moderator_body'))
->schema([
- $this->searchablePersonSelect(fn (): Builder => $this->candidates()->forModerator($this->actor())),
+ $this->searchablePersonSelect(fn (): Builder => $this->candidates()->forModerator($this->actor()))
+ ->helperText(__('panel-admin::delas.actions.moderator_hint')),
])
->action(fn (array $data): bool => $this->attempt(
fn () => resolve(AddDelasModerator::class)->handle($this->findUser($data['user_id']), $this->actor()),
diff --git a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
index a28a2ad89..a287750b5 100644
--- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
+++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
@@ -285,7 +285,7 @@ function mountedPersonSelect(Testable $page): Select
test('líder adiciona e revoga moderadora pela Equipe', function (): void {
$this->actingAs(User::factory()->delasLead()->create());
User::factory()->delasModerator()->create();
- $target = User::factory()->create();
+ $target = DelasTagRequest::factory()->approved()->create()->user;
livewire(DelasTeamPage::class)
->callAction(TestAction::make('addModerator')->table(), data: ['user_id' => $target->getKey()])
@@ -345,12 +345,20 @@ function mountedPersonSelect(Testable $page): Select
->and(array_keys($select->getOptions()))->toEqualCanonicalizing($members->map->getKey()->all());
});
-test('a busca de adicionar moderadora não acha super admin nem a equipe', function (): void {
- $this->actingAs(User::factory()->delasLead()->create());
+test('a busca de adicionar moderadora só acha membras com a tag, fora super admin e a equipe', function (): void {
+ $lead = User::factory()->delasLead()->create();
+ $this->actingAs($lead);
$carla = User::factory()->create(['name' => 'Carla Comum', 'username' => 'carlacomum']);
- User::factory()->superAdmin()->create(['name' => 'Carla Admin', 'username' => 'carlaadmin']);
- User::factory()->delasModerator()->create(['name' => 'Carla Moderadora', 'username' => 'carlamod']);
- User::factory()->delasLead()->create(['name' => 'Carla Líder', 'username' => 'carlalider']);
+ User::factory()->create(['name' => 'Carla Sem Tag', 'username' => 'carlasemtag']);
+ $others = [
+ User::factory()->superAdmin()->create(['name' => 'Carla Admin', 'username' => 'carlaadmin']),
+ User::factory()->delasModerator()->create(['name' => 'Carla Moderadora', 'username' => 'carlamod']),
+ User::factory()->delasLead()->create(['name' => 'Carla Líder', 'username' => 'carlalider']),
+ ];
+
+ foreach ([$carla, ...$others] as $user) {
+ DelasTagRequest::factory()->for($user)->approved()->create(['decided_by' => $lead->getKey()]);
+ }
$select = mountedPersonSelect(livewire(DelasTeamPage::class)->mountAction(TestAction::make('addModerator')->table()));
From 04ab60350d77a6365b1fbbc7fba65c3d8c219101 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 19:10:37 -0300
Subject: [PATCH 39/77] docs(delas): moderadora precisa ter a tag
---
app-modules/delas/CONTEXT.md | 26 +++++++--------
...01-modulo-proprio-com-papel-e-historico.md | 4 +--
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 33 ++++++++++---------
3 files changed, 32 insertions(+), 31 deletions(-)
diff --git a/app-modules/delas/CONTEXT.md b/app-modules/delas/CONTEXT.md
index d4c10b166..178dbd8af 100644
--- a/app-modules/delas/CONTEXT.md
+++ b/app-modules/delas/CONTEXT.md
@@ -21,16 +21,16 @@ Os dois painéis dependem deste módulo, e este módulo só depende do `identity
## Glossário
-| Termo | Definição | Não confundir com |
-| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
-| **Tag He4rt Delas** | Marca no perfil de que a pessoa faz parte da He4rt Delas. Existe quando a solicitação dela está `approved`. | Um Badge do `gamification`: badges vêm de XP ou claim, a tag vem de uma decisão. |
-| **Solicitação** | Uma linha em `delas_tag_requests`: o pedido da tag e a decisão sobre ele (`pending`, `approved`, `rejected`, `revoked`). | O cargo `he4rt_delas` do Discord, concedido pelo `/cargo-delas`. Os dois ainda não são sincronizados. |
-| **Moderadora He4rt Delas** | Quem tem a role `delas-moderator` (`UserRole::DelasModerator`) e passa no gate `moderate-delas`. Decide solicitações e bloqueia solicitantes. | A moderação de conteúdo do módulo `moderation` (Case, Appeal, Moderator). |
-| **Líder He4rt Delas** | Quem tem a role `delas-lead` (`UserRole::DelasLead`) e passa no gate `lead-delas`. Tudo o que a moderadora faz, mais gerenciar moderadoras, conceder e remover a tag e ver o histórico completo (página Equipe). | Super admin: no `/admin` a líder só acessa a área da He4rt Delas e não nomeia outras líderes. |
-| **Bloqueio** | Uma linha em `delas_requester_blocks`: impede a pessoa de solicitar a tag até ser desbloqueada. Sempre tem motivo. | Ban ou suspensão (`UserSituation` do `identity`): o bloqueio não afeta a conta nem o resto do Hub. |
-| **Espera** | Prazo depois de uma solicitação `rejected` ou `revoked` em que a pessoa não pode pedir de novo. Padrão de 15 dias (`delas.request_cooldown_days`). | O bloqueio: a espera acaba sozinha, o bloqueio só acaba quando alguém desbloqueia. |
-| **Concessão direta** | Líder (ou super admin) dá a tag sem solicitação e sem espera (`GrantDelasTag`). Encerra um bloqueio ativo, se houver. | Aprovar uma solicitação: aprovar é decisão sobre um pedido que a pessoa fez. |
-| **Histórico** | `delas_transitions`: uma linha por ação (solicitar, aprovar, rejeitar, conceder, remover, bloquear, desbloquear), com quem fez, quando e motivo. | Logs da aplicação: o histórico é dado de domínio, append-only, gravado pelas próprias actions. |
-| **Candidatas** | Quem pode ser escolhida nos seletores de pessoa da Equipe (`DelasCandidates`): conceder lista quem não tem a tag, remover lista só quem tem, adicionar moderadora exclui super admins e a equipe. Quem age nunca aparece. | A regra de negócio: a consulta só filtra a lista; quem valida a ação são as actions de domínio. |
-| **Membra** | Quem tem a tag hoje: solicitação `approved`. Aparece na página Membras, onde a líder pode remover a tag e bloquear novos pedidos junto. | Moderadora: membra é quem tem a tag, moderadora é quem decide sobre ela. |
-| **Edição de motivo** | Linha `reason_corrected` no histórico que aponta (`corrects_id`) para a decisão editada. A original fica como foi escrita; vale a edição mais recente. Na tela, "Editar motivo" e "Editado em". | Sobrescrever o motivo: nada no histórico é apagado. No código, a action se chama `CorrectDelasReason`. |
+| Termo | Definição | Não confundir com |
+| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| **Tag He4rt Delas** | Marca no perfil de que a pessoa faz parte da He4rt Delas. Existe quando a solicitação dela está `approved`. | Um Badge do `gamification`: badges vêm de XP ou claim, a tag vem de uma decisão. |
+| **Solicitação** | Uma linha em `delas_tag_requests`: o pedido da tag e a decisão sobre ele (`pending`, `approved`, `rejected`, `revoked`). | O cargo `he4rt_delas` do Discord, concedido pelo `/cargo-delas`. Os dois ainda não são sincronizados. |
+| **Moderadora He4rt Delas** | Quem tem a role `delas-moderator` (`UserRole::DelasModerator`) e passa no gate `moderate-delas`. Decide solicitações e bloqueia solicitantes. | A moderação de conteúdo do módulo `moderation` (Case, Appeal, Moderator). |
+| **Líder He4rt Delas** | Quem tem a role `delas-lead` (`UserRole::DelasLead`) e passa no gate `lead-delas`. Tudo o que a moderadora faz, mais gerenciar moderadoras, conceder e remover a tag e ver o histórico completo (página Equipe). | Super admin: no `/admin` a líder só acessa a área da He4rt Delas e não nomeia outras líderes. |
+| **Bloqueio** | Uma linha em `delas_requester_blocks`: impede a pessoa de solicitar a tag até ser desbloqueada. Sempre tem motivo. | Ban ou suspensão (`UserSituation` do `identity`): o bloqueio não afeta a conta nem o resto do Hub. |
+| **Espera** | Prazo depois de uma solicitação `rejected` ou `revoked` em que a pessoa não pode pedir de novo. Padrão de 15 dias (`delas.request_cooldown_days`). | O bloqueio: a espera acaba sozinha, o bloqueio só acaba quando alguém desbloqueia. |
+| **Concessão direta** | Líder (ou super admin) dá a tag sem solicitação e sem espera (`GrantDelasTag`). Encerra um bloqueio ativo, se houver. | Aprovar uma solicitação: aprovar é decisão sobre um pedido que a pessoa fez. |
+| **Histórico** | `delas_transitions`: uma linha por ação (solicitar, aprovar, rejeitar, conceder, remover, bloquear, desbloquear), com quem fez, quando e motivo. | Logs da aplicação: o histórico é dado de domínio, append-only, gravado pelas próprias actions. |
+| **Candidatas** | Quem pode ser escolhida nos seletores de pessoa da Equipe (`DelasCandidates`): conceder lista quem não tem a tag, remover lista só quem tem, adicionar moderadora lista só quem tem a tag, sem super admins e a equipe. Quem age nunca aparece. | A regra de negócio: a consulta só filtra a lista; quem valida a ação são as actions de domínio. |
+| **Membra** | Quem tem a tag hoje: solicitação `approved`. Aparece na página Membras, onde a líder pode remover a tag e bloquear novos pedidos junto. | Moderadora: membra é quem tem a tag, moderadora é quem decide sobre ela. |
+| **Edição de motivo** | Linha `reason_corrected` no histórico que aponta (`corrects_id`) para a decisão editada. A original fica como foi escrita; vale a edição mais recente. Na tela, "Editar motivo" e "Editado em". | Sobrescrever o motivo: nada no histórico é apagado. No código, a action se chama `CorrectDelasReason`. |
diff --git a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
index 4e672d022..76f28bfa1 100644
--- a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
+++ b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
@@ -80,8 +80,8 @@ precisa morar em algum lugar e ter uma forma de autorizar quem decide.
moderação, fora do cluster que já existe.
- **Seletores de pessoa como consulta de domínio** (`DelasCandidates`): conceder lista quem não tem
- a tag, remover lista só quem tem, adicionar moderadora exclui super admins, moderadoras e
- líderes, e a própria pessoa que age nunca aparece. As telas só chamam a consulta.
+ a tag, remover lista só quem tem, adicionar moderadora lista só quem tem a tag, sem super
+ admins, moderadoras e líderes, e a própria pessoa que age nunca aparece. As telas só chamam a consulta.
- **Marca no design system.** A logo, a tag e o ícone `he4rt-delas` moram no módulo `he4rt`
(`x-he4rt::delas.logo`, `x-he4rt::delas.tag`), porque os dois painéis usam. A paleta
`--color-delas-*` está no tema dos dois painéis.
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index 93e1bc8d2..5b4b8d334 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -107,8 +107,9 @@ que a moderadora tem, mais:
- página Equipe, com os números da He4rt Delas no topo;
- histórico completo, com filtro por ação;
-- na Equipe, adiciona e revoga `delas-moderator`. Não cria nem revoga líderes, e não age sobre
- super admins;
+- na Equipe, adiciona e revoga `delas-moderator`. Só quem tem a tag vira moderadora: para
+ promover alguém de fora, a líder concede a tag antes. Não cria nem revoga líderes, e não age
+ sobre super admins;
- desbloqueia qualquer bloqueio;
- edita qualquer motivo, a qualquer momento, e abre "ver versões": a original e cada edição,
com quem escreveu e quando;
@@ -289,17 +290,17 @@ Sem coluna `metadata`: nenhum fluxo a preenche, e um jsonb sem forma quebraria o
`ReviewAppeal`). As que mudam estado rodam em `DB::transaction` com `lockForUpdate()` e gravam
a linha de histórico.
-| Action | Gate do ator | Faz |
-| -------------------------------------------- | -------------------------------------------------- | ---------------------------------------------------------------------------- |
-| `RequestDelasTag` | (própria pessoa) | valida ativa, espera e bloqueio; cria `pending` |
-| `ApproveDelasRequest` | `moderate-delas` | `pending → approved` |
-| `RejectDelasRequest` | `moderate-delas` | `pending → rejected`, com motivo |
-| `BlockDelasRequester` | `moderate-delas` | cria bloqueio e rejeita a pendente |
-| `UnblockDelasRequester` | `moderate-delas` (próprios) / `lead-delas` (todos) | encerra bloqueio |
-| `GrantDelasTag` | `lead-delas` | aprova a pendente ou cria `approved`; encerra bloqueio |
-| `RevokeDelasTag` | `lead-delas` | `approved → revoked`, com motivo; opcionalmente bloqueia junto |
-| `CorrectDelasReason` | `moderate-delas` (próprio, 24h) / `lead-delas` | grava `reason_corrected` e atualiza o motivo vigente |
-| `AddDelasModerator` / `RemoveDelasModerator` | `lead-delas` | atribui ou retira `delas-moderator`; recusa líderes e super admins como alvo |
+| Action | Gate do ator | Faz |
+| -------------------------------------------- | -------------------------------------------------- | -------------------------------------------------------------------------------------- |
+| `RequestDelasTag` | (própria pessoa) | valida ativa, espera e bloqueio; cria `pending` |
+| `ApproveDelasRequest` | `moderate-delas` | `pending → approved` |
+| `RejectDelasRequest` | `moderate-delas` | `pending → rejected`, com motivo |
+| `BlockDelasRequester` | `moderate-delas` | cria bloqueio e rejeita a pendente |
+| `UnblockDelasRequester` | `moderate-delas` (próprios) / `lead-delas` (todos) | encerra bloqueio |
+| `GrantDelasTag` | `lead-delas` | aprova a pendente ou cria `approved`; encerra bloqueio |
+| `RevokeDelasTag` | `lead-delas` | `approved → revoked`, com motivo; opcionalmente bloqueia junto |
+| `CorrectDelasReason` | `moderate-delas` (próprio, 24h) / `lead-delas` | grava `reason_corrected` e atualiza o motivo vigente |
+| `AddDelasModerator` / `RemoveDelasModerator` | `lead-delas` | atribui ou retira `delas-moderator`; recusa líderes, super admins e quem não tem a tag |
A consulta `DelasEligibility` responde para o perfil: pode solicitar, por que não, e
`next_allowed_at`.
@@ -335,9 +336,9 @@ dispara também `DelasRequesterUnblocked`. Nenhum listener nesta entrega.
| Histórico | `moderate-delas` | | moderadora: decisões; líder: completo, com filtro por ação e versões do motivo; editar motivo |
| Equipe | `lead-delas` | | números (pendentes, membras com a tag, tempo médio até a decisão, aprovadas e rejeitadas no mês, bloqueios ativos), conceder e remover a tag, adicionar e revogar moderadora |
-- Os seletores de pessoa da Equipe usam a consulta de domínio `DelasCandidates`: conceder e
- adicionar moderadora buscam por nome ou `@username` (a lista é a comunidade inteira); remover
- já vem carregado só com quem tem a tag. Quem age nunca aparece.
+- Os seletores de pessoa da Equipe usam a consulta de domínio `DelasCandidates`: conceder
+ busca por nome ou `@username` (a lista é a comunidade inteira); remover e adicionar moderadora
+ já vêm carregados só com quem tem a tag. Quem age nunca aparece.
- Cada tabela declara o eager load (`user.roles` na fila, `user` e `blocker` nos bloqueios,
`user`, `actor` e `latestCorrection.actor` no histórico, `user` e `decider` na Membras, `roles`
na equipe).
From ca0144970c9c13ed959ff928c98a217eb065e498 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 19:29:28 -0300
Subject: [PATCH 40/77] fix(panel-admin): remover tag abre com as primeiras
membras e busca o resto
---
.../Moderation/Pages/Delas/DelasTeamPage.php | 13 +++----------
.../Delas/DelasModerationPagesTest.php | 18 +++++++++++++++---
2 files changed, 18 insertions(+), 13 deletions(-)
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
index 2e8abb41d..33508bd23 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
@@ -165,16 +165,9 @@ protected function getHeaderActions(): array
->modalHeading(__('panel-admin::delas.actions.revoke_heading'))
->modalDescription(__('panel-admin::delas.actions.revoke_body'))
->schema([
- // Quem tem a tag é uma lista pequena: carrega tudo e a pessoa só escolhe.
- Select::make('user_id')
- ->label(__('panel-admin::delas.actions.person'))
- ->helperText(__('panel-admin::delas.actions.member_hint'))
- ->required()
- ->options(fn (): array => $this->optionsFor(
- $this->candidates()->forRevoke($this->actor())->orderBy('name')->get(),
- ))
- ->searchable()
- ->preload(),
+ // Abre com as primeiras membras; digitar busca entre todas, sem carregar a lista inteira.
+ $this->searchablePersonSelect(fn (): Builder => $this->candidates()->forRevoke($this->actor()))
+ ->helperText(__('panel-admin::delas.actions.member_hint')),
$this->reasonField(__('panel-admin::delas.actions.revoke_reason')),
$this->alsoBlockToggle(),
])
diff --git a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
index a287750b5..427acb3ac 100644
--- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
+++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
@@ -12,6 +12,7 @@
use He4rt\Delas\History\Models\DelasTransition;
use He4rt\Delas\TagRequest\Enums\DelasRequestStatus;
use He4rt\Delas\TagRequest\Models\DelasTagRequest;
+use He4rt\Delas\Team\Queries\DelasCandidates;
use He4rt\Identity\Authorization\Enums\UserRole;
use He4rt\Identity\User\Models\User;
use He4rt\PanelAdmin\Moderation\ModerationCluster;
@@ -333,16 +334,27 @@ function mountedPersonSelect(Testable $page): Select
expect(mountedPersonSelect($page)->getOptionLabel(withDefault: false))->toBeNull();
});
-test('o seletor de remover lista só quem tem a tag, já carregado', function (): void {
+test('o seletor de remover abre com quem tem a tag, até o limite, e busca o resto', function (): void {
$this->actingAs(User::factory()->delasLead()->create());
$members = DelasTagRequest::factory()->approved()->count(2)->create()->map->user;
DelasTagRequest::factory()->pending()->create();
- User::factory()->create();
+ User::factory()->create(['name' => 'Zuleica Sem Tag']);
$select = mountedPersonSelect(livewire(DelasTeamPage::class)->mountAction('revoke'));
expect($select->isPreloaded())->toBeTrue()
- ->and(array_keys($select->getOptions()))->toEqualCanonicalizing($members->map->getKey()->all());
+ ->and(array_keys($select->getOptions()))->toEqualCanonicalizing($members->map->getKey()->all())
+ ->and(array_keys($select->getSearchResults($members->first()->name)))->toContain($members->first()->getKey())
+ ->and($select->getSearchResults('Zuleica'))->toBeEmpty();
+});
+
+test('o seletor de remover não carrega mais do que o limite', function (): void {
+ $this->actingAs(User::factory()->delasLead()->create());
+ DelasTagRequest::factory()->approved()->count(DelasCandidates::SEARCH_LIMIT + 3)->create();
+
+ $select = mountedPersonSelect(livewire(DelasTeamPage::class)->mountAction('revoke'));
+
+ expect($select->getOptions())->toHaveCount(DelasCandidates::SEARCH_LIMIT);
});
test('a busca de adicionar moderadora só acha membras com a tag, fora super admin e a equipe', function (): void {
From 07f99e4ae3a20ceecd46c4e813808c4b46f0ce22 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Wed, 7 Oct 2026 19:29:59 -0300
Subject: [PATCH 41/77] =?UTF-8?q?docs:=20papel=20de=20l=C3=ADder=20e=20p?=
=?UTF-8?q?=C3=A1gina=20Membras=20no=20mapa=20de=20contextos?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
CONTEXT-MAP.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/CONTEXT-MAP.md b/CONTEXT-MAP.md
index ba17710a3..8b85d7256 100644
--- a/CONTEXT-MAP.md
+++ b/CONTEXT-MAP.md
@@ -77,4 +77,4 @@ This is a modular monorepo (`internachi/modular`). Each bounded context lives un
- **Squads** depends on Onboarding (reads the `Squads`-completion gate, "APTO") and Identity (users/tenants). It never imports from presentation; the panels depend on it.
- **Marketing** owns short links and their click record. It depends only on **Identity** (`created_by` / `user_id` on a click) and on no other context. It renders no UI and registers no route: `portal` owns the public `/l/{slug}` edge and the "link unavailable" page, and `panel-admin` owns the staff CRUD and dashboards — both depend on `marketing`, never the reverse.
- **Contents** owns the canonical record of externally published content. It never talks HTTP (the `integration-*` modules implement its provider contract) and never awards anything — it emits `ArticlePublished` and `activity` decides. It depends on Identity (authorship resolution, `ExternalIdentityConnected`); `activity` and the panels depend on it, never the reverse.
-- **Delas** owns the He4rt Delas tag (request, decision, cooldown, blocks and their history). It depends only on **Identity** (`User`, the `delas-moderator` case of `UserRole`). It renders no UI: `panel-app` (profile request and tag) and `panel-admin` (moderation in the Moderation cluster: queue, blocks, history, team) depend on it, never the reverse.
+- **Delas** owns the He4rt Delas tag (request, decision, cooldown, blocks and their history). It depends only on **Identity** (`User`, the `delas-moderator` and `delas-lead` cases of `UserRole`). It renders no UI: `panel-app` (profile request and tag) and `panel-admin` (moderation in the Moderation cluster: queue, members, blocks, history, team) depend on it, never the reverse.
From a0fd73c5083bd39f9d013b9e28a4440ceb431f6c Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 10:50:27 -0300
Subject: [PATCH 42/77] fix(panel-app): "na He4rt Delas" no aviso de pedido
pendente
---
app-modules/panel-app/lang/pt_BR/delas.php | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/app-modules/panel-app/lang/pt_BR/delas.php b/app-modules/panel-app/lang/pt_BR/delas.php
index ae58c00d3..650d87451 100644
--- a/app-modules/panel-app/lang/pt_BR/delas.php
+++ b/app-modules/panel-app/lang/pt_BR/delas.php
@@ -8,7 +8,7 @@
'intro' => 'A He4rt Delas é a iniciativa da comunidade para mulheres e pessoas que se identificam como mulheres.',
'toggle' => 'Quero fazer parte da He4rt Delas',
'toggle_hint' => 'Ao ativar, explicamos como funciona antes de enviar o pedido. Nada é enviado sem a sua confirmação.',
- 'pending_title' => 'Inclusão no He4rt Delas aguardando aprovação',
+ 'pending_title' => 'Inclusão na He4rt Delas aguardando aprovação',
'pending_body' => 'Pedido enviado em :date. Uma moderadora da He4rt Delas vai analisar. Acompanhe o status por aqui.',
'member_title' => 'Você faz parte da He4rt Delas',
'member_body' => 'A tag já aparece no seu cartão de perfil. Por enquanto, só você e a moderação conseguem vê-la.',
From 874e13e63e662260959b21c8cf0b624a565c14a0 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 11:07:39 -0300
Subject: [PATCH 43/77] =?UTF-8?q?feat(panel-admin):=20quem=20s=C3=B3=20mod?=
=?UTF-8?q?era=20entra=20no=20admin=20direto=20na=20Modera=C3=A7=C3=A3o?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../panel-admin/src/Pages/Dashboard.php | 22 +++++++++++++++++++
.../src/PanelAdminServiceProvider.php | 8 ++++---
.../AdminComponentAccessTest.php | 22 ++++++++++++++-----
3 files changed, 44 insertions(+), 8 deletions(-)
diff --git a/app-modules/panel-admin/src/Pages/Dashboard.php b/app-modules/panel-admin/src/Pages/Dashboard.php
index e10944d78..c01c76d6b 100644
--- a/app-modules/panel-admin/src/Pages/Dashboard.php
+++ b/app-modules/panel-admin/src/Pages/Dashboard.php
@@ -6,10 +6,32 @@
use BackedEnum;
use Filament\Pages\Dashboard as BaseDashboard;
+use He4rt\Identity\User\Models\User;
+use He4rt\PanelAdmin\Moderation\ModerationCluster;
class Dashboard extends BaseDashboard
{
protected static string|null|BackedEnum $navigationIcon = 'heroicon-o-home';
protected static ?string $title = 'Dashboard';
+
+ /**
+ * Quem só modera (não é super admin) não tem nada no Dashboard: os widgets
+ * são de super admin. Para essa pessoa, a casa do admin é a Moderação.
+ */
+ public static function isModerationHome(): bool
+ {
+ $user = auth()->user();
+
+ return $user instanceof User
+ && !$user->isSuperAdmin()
+ && ModerationCluster::canAccessClusteredComponents();
+ }
+
+ public function mount(): void
+ {
+ if (static::isModerationHome()) {
+ $this->redirect(ModerationCluster::getUrl());
+ }
+ }
}
diff --git a/app-modules/panel-admin/src/PanelAdminServiceProvider.php b/app-modules/panel-admin/src/PanelAdminServiceProvider.php
index 531113186..958abded1 100644
--- a/app-modules/panel-admin/src/PanelAdminServiceProvider.php
+++ b/app-modules/panel-admin/src/PanelAdminServiceProvider.php
@@ -159,7 +159,7 @@ private function defaultNavigation(NavigationBuilder $builder): NavigationBuilde
{
return $builder
->items([
- ...$this->itemsFor(Dashboard::class),
+ ...(Dashboard::isModerationHome() ? [] : $this->itemsFor(Dashboard::class)),
...$this->itemsFor(ModerationCluster::class),
...$this->itemsFor(MarketingCluster::class),
...$this->itemsFor(TwitchCluster::class),
@@ -207,13 +207,15 @@ private function itemsFor(string $component): array
private function moderationNavigation(NavigationBuilder $builder): NavigationBuilder
{
- return $builder->items([
+ // Para quem a Moderação é a casa do admin, "voltar ao admin" voltaria para cá.
+ $backToAdmin = Dashboard::isModerationHome() ? [] : [
NavigationItem::make(__('panel-admin::moderation.navigation.back_to_admin'))
->sort(0)
->icon('heroicon-o-arrow-left')
->url(Dashboard::getUrl()),
+ ];
- ])->groups(array_map(
+ return $builder->items($backToAdmin)->groups(array_map(
$this->brandDelasGroup(...),
resolve(ModerationCluster::class)->getCachedSubNavigation(),
));
diff --git a/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php b/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php
index 969ec6180..e2a9db61b 100644
--- a/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php
+++ b/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php
@@ -8,6 +8,7 @@
use Filament\Navigation\NavigationItem;
use He4rt\Identity\User\Models\User;
use He4rt\PanelAdmin\Contributions\Widgets\ActivityTimelineWidget;
+use He4rt\PanelAdmin\Moderation\ModerationCluster;
use He4rt\PanelAdmin\Moderation\Pages\Delas\DelasTeamPage;
use He4rt\PanelAdmin\Pages\Dashboard;
@@ -111,7 +112,7 @@ function adminComponents(): array
}
});
-test('a sidebar da moderadora mostra só o Dashboard e a Moderação', function (): void {
+test('a sidebar da moderadora mostra só a Moderação', function (): void {
actingAs(User::factory()->delasModerator()->create());
$labels = collect(Filament::getPanel('admin')->getNavigation())
@@ -119,12 +120,23 @@ function adminComponents(): array
->map(fn (NavigationItem $item): string => $item->getLabel())
->all();
- expect($labels)->toBe([
- 'Dashboard',
- __('panel-admin::moderation.navigation.cluster'),
- ]);
+ expect($labels)->toBe([__('panel-admin::moderation.navigation.cluster')]);
});
+test('quem só modera entra no admin direto na Moderação; super admin fica no Dashboard', function (string $state, bool $goesToModeration): void {
+ actingAs(User::factory()->{$state}()->create());
+
+ $response = $this->get(Dashboard::getUrl());
+
+ $goesToModeration
+ ? $response->assertRedirect(ModerationCluster::getUrl())
+ : $response->assertOk();
+})->with([
+ 'moderadora' => ['delasModerator', true],
+ 'líder' => ['delasLead', true],
+ 'super admin' => ['superAdmin', false],
+]);
+
test('a He4rt Delas fica só dentro da Moderação, sem item no menu principal', function (): void {
actingAs(User::factory()->superAdmin()->create());
$superAdminLabels = collect(Filament::getPanel('admin')->getNavigation())
From b948e2a46ae318b4189bd0fec4fb853a76007e3d Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 11:31:23 -0300
Subject: [PATCH 44/77] =?UTF-8?q?docs(delas):=20espera=20durante=20o=20blo?=
=?UTF-8?q?queio,=20hist=C3=B3rico=20da=20moderadora=20e=20entrada=20no=20?=
=?UTF-8?q?admin?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 15 +++++++++++----
1 file changed, 11 insertions(+), 4 deletions(-)
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index 5b4b8d334..e73b3c957 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -141,6 +141,12 @@ que a moderadora tem, mais:
comparação é com `now()` em UTC. A data é exibida como DD/MM em
`config('app.display_timezone')`.
+A espera conta sempre da última rejeição ou remoção, e o bloqueio não a pausa nem a reinicia.
+Ao desbloquear, a pessoa pode pedir na hora se a espera já acabou durante o bloqueio, ou espera
+até a data original se ainda não acabou. Como bloquear rejeita o pedido pendente, quem é
+bloqueada com pedido aberto ganha uma espera contada do dia do bloqueio. A concessão direta
+ignora a espera.
+
## Arquitetura
### Módulo `delas`
@@ -200,8 +206,9 @@ O case precisa morar em `UserRole` porque enums não são extensíveis por outro
- Acesso ao `/admin` (ADR-0003 do identity): `UserRole::grantsAdminAccess()` diz se o papel entra
(`match` sem `default`), e `User::canAccessPanel('admin')` em produção usa
`hasAnyRole(UserRole::withAdminAccess())`. Dentro do painel, todo Resource, Page e Cluster que
- não é da He4rt Delas tem o trait `SuperAdminOnly`; o Dashboard é a página de entrada, com os
- widgets só para super admin. A sidebar (`PanelAdminServiceProvider::buildNavigation()`) só
+ não é da He4rt Delas tem o trait `SuperAdminOnly`; o Dashboard é a página de entrada do
+ super admin, com os widgets só para ele. Para quem só modera, o Dashboard some do menu e abrir
+ o `/admin` leva direto à Moderação (e dali à Fila da He4rt Delas). A sidebar (`PanelAdminServiceProvider::buildNavigation()`) só
mostra o que passa no `canAccess()`.
### Modelo de dados
@@ -333,7 +340,7 @@ dispara também `DelasRequesterUnblocked`. Nenhum listener nesta entrega.
| Fila | `moderate-delas` | pendentes | aprovar, rejeitar, bloquear |
| Membras | `moderate-delas` | membras com a tag | quem tem a tag, desde quando e quem decidiu; líder: remover a tag, com a opção de bloquear novos pedidos |
| Bloqueios | `moderate-delas` | bloqueios ativos | desbloquear (moderadora: os próprios; líder: todos) |
- | Histórico | `moderate-delas` | | moderadora: decisões; líder: completo, com filtro por ação e versões do motivo; editar motivo |
+ | Histórico | `moderate-delas` | | moderadora: decisões (os pedidos ela já vê na Fila); líder: completo, com os pedidos, filtro por ação e versões do motivo; editar motivo |
| Equipe | `lead-delas` | | números (pendentes, membras com a tag, tempo médio até a decisão, aprovadas e rejeitadas no mês, bloqueios ativos), conceder e remover a tag, adicionar e revogar moderadora |
- Os seletores de pessoa da Equipe usam a consulta de domínio `DelasCandidates`: conceder
@@ -402,7 +409,7 @@ unitários em `delas/tests/Unit`.
ações, busca e rótulo dos seletores, com eager load automático desligado e lazy loading
proibido, e pelo menos dois registros por tabela.
- Varredura: no `/admin`, a moderadora só acessa o Dashboard e as páginas da He4rt Delas; quem
- não tem papel, só o Dashboard.
+ não tem papel, só o Dashboard. Quem só modera é levada do Dashboard para a Moderação.
- Arch (opcional): `He4rt\Delas` não importa `He4rt\Panel*`.
Validação: `make check`, `make test` e `make test-shards`.
From e80f430aa534ab1da31674e9bbc7df852177b337 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 11:50:21 -0300
Subject: [PATCH 45/77] feat(delas): Discord conectado para pedir a tag e
lembrete do perfil no pop-up
---
app-modules/delas/config/delas.php | 12 ++++++
app-modules/delas/lang/en/enums.php | 1 +
app-modules/delas/lang/en/exceptions.php | 1 +
app-modules/delas/lang/pt_BR/enums.php | 1 +
app-modules/delas/lang/pt_BR/exceptions.php | 1 +
.../delas/src/Exceptions/DelasException.php | 5 +++
.../TagRequest/Actions/RequestDelasTag.php | 1 +
.../Enums/DelasEligibilityState.php | 4 +-
.../TagRequest/Queries/DelasEligibility.php | 17 +++++++++
.../TagRequest/RequestDelasTagTest.php | 37 +++++++++++++++++--
.../database/factories/UserFactory.php | 17 +++++++++
app-modules/panel-app/lang/en/delas.php | 4 ++
app-modules/panel-app/lang/pt_BR/delas.php | 4 ++
.../livewire/delas/profile-section.blade.php | 17 +++++++++
.../livewire/delas/request-modal.blade.php | 2 +
.../Feature/Delas/DelasProfileSectionTest.php | 14 ++++++-
16 files changed, 132 insertions(+), 6 deletions(-)
diff --git a/app-modules/delas/config/delas.php b/app-modules/delas/config/delas.php
index acef7d476..92e97a370 100644
--- a/app-modules/delas/config/delas.php
+++ b/app-modules/delas/config/delas.php
@@ -26,4 +26,16 @@
*/
'reason_correction_hours' => (int) env('DELAS_REASON_CORRECTION_HOURS', 24),
+
+ /*
+ |--------------------------------------------------------------------------
+ | Discord conectado para pedir a tag
+ |--------------------------------------------------------------------------
+ |
+ | A He4rt Delas acontece no Discord: a moderação conhece a pessoa por lá, e
+ | a conta conectada é o que vai ligar a tag ao cargo `he4rt_delas`.
+ |
+ */
+
+ 'require_discord' => (bool) env('DELAS_REQUIRE_DISCORD', default: true),
];
diff --git a/app-modules/delas/lang/en/enums.php b/app-modules/delas/lang/en/enums.php
index 9f1bb64f1..bacaa20dd 100644
--- a/app-modules/delas/lang/en/enums.php
+++ b/app-modules/delas/lang/en/enums.php
@@ -46,5 +46,6 @@
'member' => ['label' => 'Member', 'description' => 'The person has the He4rt Delas tag.'],
'cooldown' => ['label' => 'Cooldown', 'description' => 'A recent rejection or removal prevents a new request for now.'],
'blocked' => ['label' => 'Unavailable', 'description' => 'The person is blocked from requesting the tag.'],
+ 'discord_required' => ['label' => 'Discord missing', 'description' => 'The person needs to connect Discord to request the tag.'],
],
];
diff --git a/app-modules/delas/lang/en/exceptions.php b/app-modules/delas/lang/en/exceptions.php
index 6a0028925..7bfcbac04 100644
--- a/app-modules/delas/lang/en/exceptions.php
+++ b/app-modules/delas/lang/en/exceptions.php
@@ -6,6 +6,7 @@
'already_has_active_request' => 'This person already has a pending or approved request.',
'in_cooldown' => 'You cannot request yet. Try again from :date.',
'blocked' => 'It is not possible to request the He4rt Delas tag right now.',
+ 'discord_required' => 'Connect your Discord account to request the He4rt Delas tag.',
'invalid_transition' => 'A :from request cannot become :to.',
'cannot_decide_own' => 'You cannot decide on your own tag. Someone else on the team has to.',
'reason_required' => 'Provide a reason to continue.',
diff --git a/app-modules/delas/lang/pt_BR/enums.php b/app-modules/delas/lang/pt_BR/enums.php
index b8f085343..1dd0dd0c9 100644
--- a/app-modules/delas/lang/pt_BR/enums.php
+++ b/app-modules/delas/lang/pt_BR/enums.php
@@ -46,5 +46,6 @@
'member' => ['label' => 'Faz parte', 'description' => 'A pessoa tem a tag He4rt Delas.'],
'cooldown' => ['label' => 'Em espera', 'description' => 'Uma rejeição ou remoção recente impede um novo pedido por enquanto.'],
'blocked' => ['label' => 'Indisponível', 'description' => 'A pessoa está bloqueada de solicitar a tag.'],
+ 'discord_required' => ['label' => 'Falta o Discord', 'description' => 'A pessoa precisa conectar o Discord para pedir a tag.'],
],
];
diff --git a/app-modules/delas/lang/pt_BR/exceptions.php b/app-modules/delas/lang/pt_BR/exceptions.php
index e2c5cf3d1..3a29ab64b 100644
--- a/app-modules/delas/lang/pt_BR/exceptions.php
+++ b/app-modules/delas/lang/pt_BR/exceptions.php
@@ -6,6 +6,7 @@
'already_has_active_request' => 'Já existe uma solicitação pendente ou aprovada para esta pessoa.',
'in_cooldown' => 'Ainda não é possível solicitar. Tente de novo a partir de :date.',
'blocked' => 'No momento, não é possível solicitar a tag He4rt Delas.',
+ 'discord_required' => 'Conecte sua conta do Discord para pedir a tag He4rt Delas.',
'invalid_transition' => 'Uma solicitação :from não pode passar para :to.',
'cannot_decide_own' => 'Você não pode decidir sobre a própria tag. Outra pessoa da equipe precisa fazer isso.',
'reason_required' => 'Informe o motivo para continuar.',
diff --git a/app-modules/delas/src/Exceptions/DelasException.php b/app-modules/delas/src/Exceptions/DelasException.php
index a860440a5..c9f9868fe 100644
--- a/app-modules/delas/src/Exceptions/DelasException.php
+++ b/app-modules/delas/src/Exceptions/DelasException.php
@@ -35,6 +35,11 @@ public static function blocked(): self
return new self(__('delas::exceptions.blocked'), Response::HTTP_FORBIDDEN);
}
+ public static function discordRequired(): self
+ {
+ return new self(__('delas::exceptions.discord_required'), Response::HTTP_UNPROCESSABLE_ENTITY);
+ }
+
public static function invalidTransition(DelasRequestStatus $from, DelasRequestStatus $to): self
{
return new self(
diff --git a/app-modules/delas/src/TagRequest/Actions/RequestDelasTag.php b/app-modules/delas/src/TagRequest/Actions/RequestDelasTag.php
index cd08595a9..8707e8d13 100644
--- a/app-modules/delas/src/TagRequest/Actions/RequestDelasTag.php
+++ b/app-modules/delas/src/TagRequest/Actions/RequestDelasTag.php
@@ -37,6 +37,7 @@ public function handle(User $user): DelasTagRequest
DelasEligibilityState::Pending, DelasEligibilityState::Member => throw DelasException::alreadyHasActiveRequest(),
DelasEligibilityState::Blocked => throw DelasException::blocked(),
DelasEligibilityState::Cooldown => throw DelasException::inCooldown($eligibility->nextAllowedAt ?? now()),
+ DelasEligibilityState::DiscordRequired => throw DelasException::discordRequired(),
DelasEligibilityState::CanRequest => null,
};
diff --git a/app-modules/delas/src/TagRequest/Enums/DelasEligibilityState.php b/app-modules/delas/src/TagRequest/Enums/DelasEligibilityState.php
index ea928a621..b533015fc 100644
--- a/app-modules/delas/src/TagRequest/Enums/DelasEligibilityState.php
+++ b/app-modules/delas/src/TagRequest/Enums/DelasEligibilityState.php
@@ -21,6 +21,7 @@ enum DelasEligibilityState: string implements HasColor, HasDescription, HasIcon,
case Member = 'member';
case Cooldown = 'cooldown';
case Blocked = 'blocked';
+ case DiscordRequired = 'discord_required';
public function getLabel(): string
{
@@ -33,7 +34,7 @@ public function getColor(): string
self::CanRequest => 'primary',
self::Pending => 'warning',
self::Member => 'success',
- self::Cooldown, self::Blocked => 'gray',
+ self::Cooldown, self::Blocked, self::DiscordRequired => 'gray',
};
}
@@ -50,6 +51,7 @@ public function getIcon(): Heroicon
self::Member => Heroicon::OutlinedCheckCircle,
self::Cooldown => Heroicon::OutlinedClock,
self::Blocked => Heroicon::OutlinedInformationCircle,
+ self::DiscordRequired => Heroicon::OutlinedLink,
};
}
}
diff --git a/app-modules/delas/src/TagRequest/Queries/DelasEligibility.php b/app-modules/delas/src/TagRequest/Queries/DelasEligibility.php
index f9ab24b03..6bb5cac18 100644
--- a/app-modules/delas/src/TagRequest/Queries/DelasEligibility.php
+++ b/app-modules/delas/src/TagRequest/Queries/DelasEligibility.php
@@ -11,6 +11,7 @@
use He4rt\Delas\TagRequest\Enums\DelasRequestStatus;
use He4rt\Delas\TagRequest\Models\DelasTagRequest;
use He4rt\Delas\TagRequest\ValueObjects\DelasEligibilityResult;
+use He4rt\Identity\ExternalIdentity\Enums\IdentityProvider;
use He4rt\Identity\User\Models\User;
/**
@@ -45,6 +46,10 @@ public function for(User $user): DelasEligibilityResult
return new DelasEligibilityResult(DelasEligibilityState::Cooldown, nextAllowedAt: $nextAllowedAt);
}
+ if (config()->boolean('delas.require_discord') && !$this->hasDiscord($user)) {
+ return new DelasEligibilityResult(DelasEligibilityState::DiscordRequired);
+ }
+
return new DelasEligibilityResult(DelasEligibilityState::CanRequest);
}
@@ -56,6 +61,18 @@ public function hasTag(User $user): bool
->exists();
}
+ /**
+ * Discord conectado de verdade pela pessoa, não um registro criado por
+ * ingestão (ver o escopo `activelyConnected` do identity).
+ */
+ public function hasDiscord(User $user): bool
+ {
+ return $user->providers()
+ ->where('provider', IdentityProvider::Discord)
+ ->activelyConnected()
+ ->exists();
+ }
+
public function isBlocked(User $user): bool
{
return DelasRequesterBlock::query()
diff --git a/app-modules/delas/tests/Feature/TagRequest/RequestDelasTagTest.php b/app-modules/delas/tests/Feature/TagRequest/RequestDelasTagTest.php
index f396b047d..eb3978fc2 100644
--- a/app-modules/delas/tests/Feature/TagRequest/RequestDelasTagTest.php
+++ b/app-modules/delas/tests/Feature/TagRequest/RequestDelasTagTest.php
@@ -18,7 +18,7 @@
test('registra a solicitação como pendente e grava o histórico', function (): void {
Event::fake([DelasTagRequested::class]);
- $user = User::factory()->create();
+ $user = User::factory()->withDiscord()->create();
$request = resolve(RequestDelasTag::class)->handle($user);
@@ -51,7 +51,7 @@
test('respeita a espera de 15 dias depois de uma rejeição ou remoção', function (string $state): void {
$this->travelTo(today());
- $user = User::factory()->create();
+ $user = User::factory()->withDiscord()->create();
DelasTagRequest::factory()->for($user)->{$state}()->create(['decided_at' => now()]);
$this->travelTo(now()->addDays(15)->subMinute());
@@ -63,7 +63,7 @@
test('a espera vem da config', function (): void {
config(['delas.request_cooldown_days' => 3]);
- $user = User::factory()->create();
+ $user = User::factory()->withDiscord()->create();
DelasTagRequest::factory()->for($user)->rejected()->create(['decided_at' => now()->subDays(4)]);
expect(resolve(DelasEligibility::class)->for($user)->canRequest())->toBeTrue();
@@ -76,3 +76,34 @@
expect(resolve(DelasEligibility::class)->for($user)->hasTag())->toBeTrue();
});
+
+test('sem o Discord conectado, não dá para pedir', function (): void {
+ $user = User::factory()->create();
+
+ expect(resolve(DelasEligibility::class)->for($user)->state)->toBe(DelasEligibilityState::DiscordRequired)
+ ->and(fn () => resolve(RequestDelasTag::class)->handle($user))
+ ->toThrow(DelasException::class, __('delas::exceptions.discord_required'));
+});
+
+test('um Discord desconectado não conta', function (): void {
+ $user = User::factory()->withDiscord()->create();
+ $user->providers()->update(['disconnected_at' => now()]);
+
+ expect(resolve(DelasEligibility::class)->for($user)->state)->toBe(DelasEligibilityState::DiscordRequired);
+});
+
+test('a exigência do Discord vem da config', function (): void {
+ config(['delas.require_discord' => false]);
+
+ expect(resolve(DelasEligibility::class)->for(User::factory()->create())->canRequest())->toBeTrue();
+});
+
+test('espera e bloqueio aparecem antes de faltar o Discord', function (): void {
+ $blocked = User::factory()->create();
+ DelasRequesterBlock::factory()->for($blocked)->create();
+ $waiting = User::factory()->create();
+ DelasTagRequest::factory()->for($waiting)->rejected()->create(['decided_at' => now()]);
+
+ expect(resolve(DelasEligibility::class)->for($blocked)->state)->toBe(DelasEligibilityState::Blocked)
+ ->and(resolve(DelasEligibility::class)->for($waiting)->state)->toBe(DelasEligibilityState::Cooldown);
+});
diff --git a/app-modules/identity/database/factories/UserFactory.php b/app-modules/identity/database/factories/UserFactory.php
index 0fd5f6214..2fefa8315 100644
--- a/app-modules/identity/database/factories/UserFactory.php
+++ b/app-modules/identity/database/factories/UserFactory.php
@@ -5,6 +5,8 @@
namespace He4rt\Identity\Database\Factories;
use He4rt\Identity\Authorization\Enums\UserRole;
+use He4rt\Identity\ExternalIdentity\Enums\IdentityProvider;
+use He4rt\Identity\ExternalIdentity\Models\ExternalIdentity;
use He4rt\Identity\User\Models\User;
use Illuminate\Database\Eloquent\Factories\Factory;
use Illuminate\Support\Facades\Hash;
@@ -56,6 +58,21 @@ public function delasModerator(): static
});
}
+ /**
+ * Conta do Discord conectada pela própria pessoa.
+ */
+ public function withDiscord(): static
+ {
+ return $this->afterCreating(function (User $user): void {
+ ExternalIdentity::factory()->create([
+ 'model_type' => $user->getMorphClass(),
+ 'model_id' => $user->getKey(),
+ 'provider' => IdentityProvider::Discord,
+ 'connected_by' => $user->getKey(),
+ ]);
+ });
+ }
+
public function delasLead(): static
{
return $this->afterCreating(function (User $user): void {
diff --git a/app-modules/panel-app/lang/en/delas.php b/app-modules/panel-app/lang/en/delas.php
index f7ef47492..5a186473e 100644
--- a/app-modules/panel-app/lang/en/delas.php
+++ b/app-modules/panel-app/lang/en/delas.php
@@ -15,6 +15,9 @@
'cooldown_title' => 'You cannot request again yet',
'cooldown_body' => 'You can request again on :date.',
'blocked_title' => 'It is not possible to request the He4rt Delas tag right now.',
+ 'discord_title' => 'Connect your Discord to request the tag',
+ 'discord_body' => 'He4rt Delas happens on Discord, and that is where the moderation gets to know you.',
+ 'discord_connect' => 'Connect Discord',
'modal' => [
'heading' => 'Request the He4rt Delas tag',
'what' => 'He4rt Delas is the He4rt community initiative for women and people who identify as women: a space for exchange, support and visibility.',
@@ -23,6 +26,7 @@
'Meanwhile, your profile shows the request as awaiting approval.',
'Once approved, the tag shows on your profile card. For now, only you and the moderators can see it.',
],
+ 'tip' => 'Profiles with a photo and basic information are reviewed faster.',
'submit' => 'Send request',
'cancel' => 'Not now',
],
diff --git a/app-modules/panel-app/lang/pt_BR/delas.php b/app-modules/panel-app/lang/pt_BR/delas.php
index 650d87451..000b710cf 100644
--- a/app-modules/panel-app/lang/pt_BR/delas.php
+++ b/app-modules/panel-app/lang/pt_BR/delas.php
@@ -15,6 +15,9 @@
'cooldown_title' => 'Ainda não é possível pedir de novo',
'cooldown_body' => 'Você poderá solicitar novamente em :date.',
'blocked_title' => 'No momento, não é possível solicitar a tag He4rt Delas.',
+ 'discord_title' => 'Conecte seu Discord para pedir a tag',
+ 'discord_body' => 'A He4rt Delas acontece no Discord, e é por lá que a moderação conhece você.',
+ 'discord_connect' => 'Conectar Discord',
'modal' => [
'heading' => 'Solicitar a tag He4rt Delas',
'what' => 'A He4rt Delas é a iniciativa da comunidade He4rt para mulheres e pessoas que se identificam como mulheres: um espaço de troca, apoio e visibilidade.',
@@ -23,6 +26,7 @@
'Enquanto isso, seu perfil mostra o pedido como aguardando aprovação.',
'Quando aprovado, a tag aparece no seu cartão de perfil. Hoje, só você e a moderação conseguem vê-la.',
],
+ 'tip' => 'Perfis com foto e informações básicas são analisados mais rápido.',
'submit' => 'Enviar solicitação',
'cancel' => 'Agora não',
],
diff --git a/app-modules/panel-app/resources/views/livewire/delas/profile-section.blade.php b/app-modules/panel-app/resources/views/livewire/delas/profile-section.blade.php
index 476d1d744..8f148f889 100644
--- a/app-modules/panel-app/resources/views/livewire/delas/profile-section.blade.php
+++ b/app-modules/panel-app/resources/views/livewire/delas/profile-section.blade.php
@@ -96,6 +96,23 @@
{{ __('panel-app::delas.profile.blocked_title') }}
+ @break
+ @case(DelasEligibilityState::DiscordRequired)
+
+ {{ __('panel-app::delas.profile.discord_title') }}
+ {{ __('panel-app::delas.profile.discord_body') }}
+
diff --git a/app-modules/panel-app/tests/Feature/Delas/DelasProfileSectionTest.php b/app-modules/panel-app/tests/Feature/Delas/DelasProfileSectionTest.php
index 412037738..925b0c688 100644
--- a/app-modules/panel-app/tests/Feature/Delas/DelasProfileSectionTest.php
+++ b/app-modules/panel-app/tests/Feature/Delas/DelasProfileSectionTest.php
@@ -14,7 +14,7 @@
beforeEach(function (): void {
Filament::setCurrentPanel(Filament::getPanel('app'));
- $this->user = User::factory()->create();
+ $this->user = User::factory()->withDiscord()->create();
$this->actingAs($this->user);
});
@@ -28,7 +28,8 @@
test('a solicitação só é registrada depois da confirmação no pop-up', function (): void {
livewire(DelasProfileSection::class)
->mountAction('request')
- ->assertActionMounted('request');
+ ->assertActionMounted('request')
+ ->assertMountedActionModalSee(__('panel-app::delas.profile.modal.tip'));
expect(DelasTagRequest::query()->exists())->toBeFalse();
@@ -67,3 +68,12 @@
->assertDontSee('motivo interno sigiloso')
->assertActionHidden('request');
});
+
+test('sem o Discord, pede para conectar e não deixa solicitar', function (): void {
+ $this->actingAs(User::factory()->create());
+
+ livewire(DelasProfileSection::class)
+ ->assertSee(__('panel-app::delas.profile.discord_title'))
+ ->assertSee(route('oauth.redirect', ['panel' => 'app', 'provider' => 'discord']), escape: false)
+ ->assertActionHidden('request');
+});
From 797b3cbcd384eabf4d5eada2a1b483384627297f Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 11:50:41 -0300
Subject: [PATCH 46/77] docs(delas): Discord conectado como requisito do pedido
---
app-modules/delas/CONTEXT.md | 1 +
docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md | 9 ++++++++-
2 files changed, 9 insertions(+), 1 deletion(-)
diff --git a/app-modules/delas/CONTEXT.md b/app-modules/delas/CONTEXT.md
index 178dbd8af..8e542fd76 100644
--- a/app-modules/delas/CONTEXT.md
+++ b/app-modules/delas/CONTEXT.md
@@ -29,6 +29,7 @@ Os dois painéis dependem deste módulo, e este módulo só depende do `identity
| **Líder He4rt Delas** | Quem tem a role `delas-lead` (`UserRole::DelasLead`) e passa no gate `lead-delas`. Tudo o que a moderadora faz, mais gerenciar moderadoras, conceder e remover a tag e ver o histórico completo (página Equipe). | Super admin: no `/admin` a líder só acessa a área da He4rt Delas e não nomeia outras líderes. |
| **Bloqueio** | Uma linha em `delas_requester_blocks`: impede a pessoa de solicitar a tag até ser desbloqueada. Sempre tem motivo. | Ban ou suspensão (`UserSituation` do `identity`): o bloqueio não afeta a conta nem o resto do Hub. |
| **Espera** | Prazo depois de uma solicitação `rejected` ou `revoked` em que a pessoa não pode pedir de novo. Padrão de 15 dias (`delas.request_cooldown_days`). | O bloqueio: a espera acaba sozinha, o bloqueio só acaba quando alguém desbloqueia. |
+| **Discord conectado** | Requisito para pedir a tag (`delas.require_discord`): uma identidade Discord conectada pela própria pessoa (escopo `activelyConnected` do identity). Fica antes de liberar o pedido, depois da espera e do bloqueio. | Ter o cargo `he4rt_delas` no Discord: o cargo ainda não é sincronizado com a tag. |
| **Concessão direta** | Líder (ou super admin) dá a tag sem solicitação e sem espera (`GrantDelasTag`). Encerra um bloqueio ativo, se houver. | Aprovar uma solicitação: aprovar é decisão sobre um pedido que a pessoa fez. |
| **Histórico** | `delas_transitions`: uma linha por ação (solicitar, aprovar, rejeitar, conceder, remover, bloquear, desbloquear), com quem fez, quando e motivo. | Logs da aplicação: o histórico é dado de domínio, append-only, gravado pelas próprias actions. |
| **Candidatas** | Quem pode ser escolhida nos seletores de pessoa da Equipe (`DelasCandidates`): conceder lista quem não tem a tag, remover lista só quem tem, adicionar moderadora lista só quem tem a tag, sem super admins e a equipe. Quem age nunca aparece. | A regra de negócio: a consulta só filtra a lista; quem valida a ação são as actions de domínio. |
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index e73b3c957..ae0ee4e3a 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -76,7 +76,14 @@ Fatos do código atual que moldam o desenho:
- já existe uma solicitação `pending` ou `approved`;
- a última solicitação foi `rejected` ou `revoked` e ainda não passou a espera
(ver [Espera](#espera-de-15-dias));
- - existe um bloqueio ativo. O perfil informa apenas que não é possível solicitar, sem motivo.
+ - existe um bloqueio ativo. O perfil informa apenas que não é possível solicitar, sem motivo;
+ - a pessoa não tem o Discord conectado (`delas.require_discord`, ligado por padrão). O perfil
+ pede para conectar, com o botão que já existe nas Conexões. A He4rt Delas acontece no
+ Discord, a moderação conhece a pessoa por lá, e a conta conectada é o que vai ligar a tag ao
+ cargo `he4rt_delas` numa próxima issue. Espera e bloqueio aparecem antes de faltar o Discord.
+- O pop-up de confirmação lembra que perfis com foto e informações básicas são analisados mais
+ rápido. É só um lembrete: o perfil completo não é exigido, para não pedir dados pessoais a mais
+ (minimização da LGPD) nem afastar quem está começando.
### Moderação (moderadoras da He4rt Delas)
From 19f6728dfc5f97399a6dfb9de9e3a48c30edf354 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 12:01:06 -0300
Subject: [PATCH 47/77] fix(delas): busca de pessoas ignora acento
---
.../delas/src/Team/Queries/DelasCandidates.php | 12 +++++++++++-
.../delas/tests/Feature/Team/DelasCandidatesTest.php | 7 +++++++
2 files changed, 18 insertions(+), 1 deletion(-)
diff --git a/app-modules/delas/src/Team/Queries/DelasCandidates.php b/app-modules/delas/src/Team/Queries/DelasCandidates.php
index e17b2566f..0082de918 100644
--- a/app-modules/delas/src/Team/Queries/DelasCandidates.php
+++ b/app-modules/delas/src/Team/Queries/DelasCandidates.php
@@ -22,6 +22,10 @@
{
public const int SEARCH_LIMIT = 20;
+ private const string ACCENTED = 'ÁÀÂÃÄáàâãäÉÈÊËéèêëÍÌÎÏíìîïÓÒÔÕÖóòôõöÚÙÛÜúùûüÇçÑñ';
+
+ private const string PLAIN = 'AAAAAaaaaaEEEEeeeeIIIIiiiiOOOOOoooooUUUUuuuuCcNn';
+
/**
* Quem ainda não tem a tag. A lista é a comunidade inteira, então o seletor
* busca em vez de pré-carregar.
@@ -73,13 +77,19 @@ public function search(Builder $candidates, string $search, int $limit = self::S
return $candidates
->where(fn (Builder $query): Builder => $query
- ->whereLike('name', '%'.mb_trim($search).'%')
+ // Sem acento dos dois lados: "thais" acha "Thaís".
+ ->whereRaw('lower(translate(name, ?, ?)) like ?', [self::ACCENTED, self::PLAIN, '%'.$this->plain($search).'%'])
->orWhereLike('username', '%'.$username.'%'))
->orderBy('name')
->limit($limit)
->get();
}
+ private function plain(string $search): string
+ {
+ return mb_strtolower(strtr(mb_trim($search), array_combine(mb_str_split(self::ACCENTED), mb_str_split(self::PLAIN))));
+ }
+
/**
* @return Builder
*/
diff --git a/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php b/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
index 1542dc985..36828f3ce 100644
--- a/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
+++ b/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
@@ -79,3 +79,10 @@
expect($this->candidates->search($this->candidates->forGrant($this->lead), 'carla', limit: 2))->toHaveCount(2);
});
+
+test('a busca ignora acento e maiúscula', function (): void {
+ $thais = User::factory()->create(['name' => 'Thaís Barbosa', 'username' => 'thaisb']);
+
+ expect($this->candidates->search($this->candidates->forGrant($this->lead), 'thais')->pluck('id')->all())->toContain($thais->id)
+ ->and($this->candidates->search($this->candidates->forGrant($this->lead), 'THAÍS')->pluck('id')->all())->toContain($thais->id);
+});
From dcf062ab0f62ec3a20f1fea4070e5c045f7ffbe6 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 12:01:07 -0300
Subject: [PATCH 48/77] =?UTF-8?q?fix(panel-admin):=20conceder=20a=20quem?=
=?UTF-8?q?=20est=C3=A1=20bloqueada=20mostra=20o=20bloqueio=20e=20exige=20?=
=?UTF-8?q?o=20motivo=20no=20formul=C3=A1rio?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
app-modules/panel-admin/lang/en/delas.php | 2 +
app-modules/panel-admin/lang/pt_BR/delas.php | 2 +
.../Concerns/InteractsWithDelasModeration.php | 2 +-
.../Moderation/Pages/Delas/DelasTeamPage.php | 46 ++++++++++++++++++-
.../Delas/DelasModerationPagesTest.php | 14 ++++++
5 files changed, 63 insertions(+), 3 deletions(-)
diff --git a/app-modules/panel-admin/lang/en/delas.php b/app-modules/panel-admin/lang/en/delas.php
index 85e6e843e..115605668 100644
--- a/app-modules/panel-admin/lang/en/delas.php
+++ b/app-modules/panel-admin/lang/en/delas.php
@@ -107,6 +107,8 @@
'grant_heading' => 'Grant the He4rt Delas tag',
'grant_body' => 'A pending request gets approved; without one, an approved request is created. The cooldown is ignored. If the person is blocked, the reason is required and the block is lifted.',
'grant_reason' => 'Reason',
+ 'grant_blocked_heading' => 'This person is blocked',
+ 'grant_blocked_body' => 'Blocked by :name on :date. Reason: :reason. Granting the tag lifts the block, so a reason is required.',
'granted' => 'Tag granted',
'revoke' => 'Remove tag',
'revoke_heading' => 'Remove the He4rt Delas tag',
diff --git a/app-modules/panel-admin/lang/pt_BR/delas.php b/app-modules/panel-admin/lang/pt_BR/delas.php
index 0a1ce8ec8..7662446cf 100644
--- a/app-modules/panel-admin/lang/pt_BR/delas.php
+++ b/app-modules/panel-admin/lang/pt_BR/delas.php
@@ -107,6 +107,8 @@
'grant_heading' => 'Conceder a tag He4rt Delas',
'grant_body' => 'Com solicitação pendente, ela é aprovada; sem solicitação, é criada uma já aprovada. A espera é ignorada. Se a pessoa estiver bloqueada, o motivo é obrigatório e o bloqueio é encerrado.',
'grant_reason' => 'Motivo',
+ 'grant_blocked_heading' => 'Esta pessoa está bloqueada',
+ 'grant_blocked_body' => 'Bloqueada por :name em :date. Motivo: :reason. Conceder a tag encerra o bloqueio, por isso o motivo é obrigatório.',
'granted' => 'Tag concedida',
'revoke' => 'Remover tag',
'revoke_heading' => 'Remover a tag He4rt Delas',
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
index b63459b34..33dbb8fe7 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
@@ -65,7 +65,7 @@ protected function dateColumn(string $name, string $label): TextColumn
->sortable();
}
- protected function reasonField(string $label, bool $required = true, ?string $hint = null): Textarea
+ protected function reasonField(string $label, bool|Closure $required = true, ?string $hint = null): Textarea
{
return Textarea::make('reason')
->label($label)
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
index 33508bd23..a7342c186 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
@@ -9,11 +9,14 @@
use Filament\Actions\Action;
use Filament\Forms\Components\Select;
use Filament\Pages\Page;
+use Filament\Schemas\Components\Callout;
+use Filament\Schemas\Components\Utilities\Get;
use Filament\Support\Icons\Heroicon;
use Filament\Tables\Columns\TextColumn;
use Filament\Tables\Concerns\InteractsWithTable;
use Filament\Tables\Contracts\HasTable;
use Filament\Tables\Table;
+use He4rt\Delas\Block\Models\DelasRequesterBlock;
use He4rt\Delas\History\Enums\DelasAction;
use He4rt\Delas\History\Models\DelasTransition;
use He4rt\Delas\TagRequest\Actions\GrantDelasTag;
@@ -150,8 +153,16 @@ protected function getHeaderActions(): array
->modalHeading(__('panel-admin::delas.actions.grant_heading'))
->modalDescription(__('panel-admin::delas.actions.grant_body'))
->schema([
- $this->searchablePersonSelect(fn (): Builder => $this->candidates()->forGrant($this->actor())),
- $this->reasonField(__('panel-admin::delas.actions.grant_reason'), required: false),
+ $this->searchablePersonSelect(fn (): Builder => $this->candidates()->forGrant($this->actor()))->live(),
+ // Quem está bloqueada: a líder vê quem bloqueou, quando e por quê, e o motivo vira obrigatório.
+ Callout::make(fn (Get $get): ?string => $this->blockedHeading($get('user_id')))
+ ->description(fn (Get $get): ?string => $this->blockedDescription($get('user_id')))
+ ->warning()
+ ->visible(fn (Get $get): bool => $this->activeBlockOf($get('user_id')) instanceof DelasRequesterBlock),
+ $this->reasonField(
+ __('panel-admin::delas.actions.grant_reason'),
+ required: fn (Get $get): bool => $this->activeBlockOf($get('user_id')) instanceof DelasRequesterBlock,
+ ),
])
->action(fn (array $data): bool => $this->attempt(
fn () => resolve(GrantDelasTag::class)->handle($this->findUser($data['user_id']), $this->actor(), $this->reasonFrom($data)),
@@ -223,6 +234,37 @@ private function candidates(): DelasCandidates
return resolve(DelasCandidates::class);
}
+ private function activeBlockOf(mixed $userId): ?DelasRequesterBlock
+ {
+ if (!is_string($userId) || $userId === '') {
+ return null;
+ }
+
+ return DelasRequesterBlock::query()->active()->with('blocker')->where('user_id', $userId)->first();
+ }
+
+ private function blockedHeading(mixed $userId): ?string
+ {
+ return $this->activeBlockOf($userId) instanceof DelasRequesterBlock
+ ? $this->text('panel-admin::delas.actions.grant_blocked_heading')
+ : null;
+ }
+
+ private function blockedDescription(mixed $userId): ?string
+ {
+ $block = $this->activeBlockOf($userId);
+
+ if (!$block instanceof DelasRequesterBlock) {
+ return null;
+ }
+
+ return $this->text('panel-admin::delas.actions.grant_blocked_body', [
+ 'name' => $block->blocker->name ?? '—',
+ 'date' => $block->blocked_at->timezone(config('app.display_timezone'))->format('d/m/Y H:i'),
+ 'reason' => $block->reason,
+ ]);
+ }
+
private function findUser(mixed $id): User
{
return User::query()->whereKey($id)->firstOrFail();
diff --git a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
index 427acb3ac..edb85557a 100644
--- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
+++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
@@ -471,3 +471,17 @@ function mountedPersonSelect(Testable $page): Select
->mountAction(TestAction::make('correctReason')->table($own))
->assertMountedActionModalSee(__('panel-admin::delas.actions.correct_until', ['date' => $deadline]));
});
+
+test('conceder a quem está bloqueada mostra o bloqueio e exige o motivo no formulário', function (): void {
+ $this->actingAs(User::factory()->delasLead()->create());
+ $block = DelasRequesterBlock::factory()->create(['reason' => 'Pedidos repetidos.']);
+
+ livewire(DelasTeamPage::class)
+ ->mountAction('grant')
+ ->fillForm(['user_id' => $block->user_id])
+ ->assertMountedActionModalSee([__('panel-admin::delas.actions.grant_blocked_heading'), 'Pedidos repetidos.'])
+ ->callMountedAction()
+ ->assertHasFormErrors(['reason' => 'required']);
+
+ expect($block->fresh()->isActive())->toBeTrue();
+});
From 086ae7693e8637df0b4be382ea0bbcd6353ac75d Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 12:08:36 -0300
Subject: [PATCH 49/77] fix(panel-admin): aviso de bloqueio sem ponto duplicado
no motivo
---
.../panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
index a7342c186..3be871728 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php
@@ -261,7 +261,7 @@ private function blockedDescription(mixed $userId): ?string
return $this->text('panel-admin::delas.actions.grant_blocked_body', [
'name' => $block->blocker->name ?? '—',
'date' => $block->blocked_at->timezone(config('app.display_timezone'))->format('d/m/Y H:i'),
- 'reason' => $block->reason,
+ 'reason' => mb_rtrim($block->reason, '. '),
]);
}
From c4df35f4f25f29cc55cc2762c2d050ba27dce153 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 12:23:08 -0300
Subject: [PATCH 50/77] =?UTF-8?q?feat(panel-admin):=20"Ver=20perfil"=20na?=
=?UTF-8?q?=20modera=C3=A7=C3=A3o=20da=20He4rt=20Delas,=20s=C3=B3=20leitur?=
=?UTF-8?q?a=20e=20sem=20dados=20pessoais?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
app-modules/panel-admin/lang/en/delas.php | 13 ++++
app-modules/panel-admin/lang/pt_BR/delas.php | 13 ++++
.../moderation/delas/person-profile.blade.php | 78 +++++++++++++++++++
.../Concerns/InteractsWithDelasModeration.php | 38 ++++++++-
.../Delas/DelasModerationPagesTest.php | 25 ++++++
5 files changed, 165 insertions(+), 2 deletions(-)
create mode 100644 app-modules/panel-admin/resources/views/moderation/delas/person-profile.blade.php
diff --git a/app-modules/panel-admin/lang/en/delas.php b/app-modules/panel-admin/lang/en/delas.php
index 115605668..172af4ab8 100644
--- a/app-modules/panel-admin/lang/en/delas.php
+++ b/app-modules/panel-admin/lang/en/delas.php
@@ -72,6 +72,7 @@
'correct_reason_field' => 'Edited reason',
'reason_corrected' => 'Reason edited',
'corrected_note' => 'Edited on :date by :name',
+ 'view_profile' => 'View profile',
'view_versions' => 'view versions',
'versions_heading' => 'Reason versions',
'version_original' => 'Original',
@@ -133,6 +134,18 @@
'moderator_removed' => 'Role revoked',
'lead_only' => 'Leads are assigned by super admins in the user form.',
],
+ 'profile' => [
+ 'heading' => 'Profile',
+ 'headline' => 'Headline',
+ 'seniority' => 'Seniority',
+ 'years' => '{1} :years year of experience|[0,*] :years years of experience',
+ 'about' => 'About',
+ 'discord' => 'Discord',
+ 'discord_none' => 'Not connected',
+ 'since' => 'At He4rt since',
+ 'empty' => 'This person has not filled in their professional profile yet.',
+ 'note' => 'Read only. Email, birthdate and location are not shown here.',
+ ],
'stats' => [
'pending' => 'Pending now',
'pending_oldest' => 'oldest :when',
diff --git a/app-modules/panel-admin/lang/pt_BR/delas.php b/app-modules/panel-admin/lang/pt_BR/delas.php
index 7662446cf..75f168609 100644
--- a/app-modules/panel-admin/lang/pt_BR/delas.php
+++ b/app-modules/panel-admin/lang/pt_BR/delas.php
@@ -72,6 +72,7 @@
'correct_reason_field' => 'Motivo editado',
'reason_corrected' => 'Motivo editado',
'corrected_note' => 'Editado em :date por :name',
+ 'view_profile' => 'Ver perfil',
'view_versions' => 'ver versões',
'versions_heading' => 'Versões do motivo',
'version_original' => 'Original',
@@ -133,6 +134,18 @@
'moderator_removed' => 'Papel revogado',
'lead_only' => 'Líderes são atribuídas por super admins, no cadastro de usuários.',
],
+ 'profile' => [
+ 'heading' => 'Perfil',
+ 'headline' => 'Título profissional',
+ 'seniority' => 'Senioridade',
+ 'years' => '{1} :years ano de experiência|[0,*] :years anos de experiência',
+ 'about' => 'Sobre',
+ 'discord' => 'Discord',
+ 'discord_none' => 'Não conectado',
+ 'since' => 'Na He4rt desde',
+ 'empty' => 'A pessoa ainda não preencheu o perfil profissional.',
+ 'note' => 'Só leitura. E-mail, data de nascimento e localização não aparecem aqui.',
+ ],
'stats' => [
'pending' => 'Pendentes agora',
'pending_oldest' => 'mais antiga :when',
diff --git a/app-modules/panel-admin/resources/views/moderation/delas/person-profile.blade.php b/app-modules/panel-admin/resources/views/moderation/delas/person-profile.blade.php
new file mode 100644
index 000000000..4772ed6cc
--- /dev/null
+++ b/app-modules/panel-admin/resources/views/moderation/delas/person-profile.blade.php
@@ -0,0 +1,78 @@
+@php
+ /** @var \He4rt\Identity\User\Models\User $person */
+ $profile = $person->profile;
+ $discord = $person->providers
+ ->where('provider', \He4rt\Identity\ExternalIdentity\Enums\IdentityProvider::Discord)
+ ->filter->isConnected()
+ ->sortByDesc('connected_at')
+ ->first();
+ $discordName = $discord?->metadata['username'] ?? $discord?->external_account_id;
+ $hasProfile = $profile && ($profile->headline || $profile->seniority_level || $profile->years_experience || $profile->about);
+@endphp
+
+{{-- Resumo só leitura para a moderação decidir: sem e-mail, data de nascimento nem localização. --}}
+
diff --git a/app-modules/panel-admin/resources/views/moderation/delas/reason-versions.blade.php b/app-modules/panel-admin/resources/views/moderation/delas/reason-versions.blade.php
index 13f0d17d3..049845ab6 100644
--- a/app-modules/panel-admin/resources/views/moderation/delas/reason-versions.blade.php
+++ b/app-modules/panel-admin/resources/views/moderation/delas/reason-versions.blade.php
@@ -1,32 +1,47 @@
-{{-- Versões do motivo de uma decisão, numa linha do tempo: a original primeiro, a que vale hoje por último. --}}
+{{--
+ Versões do motivo de uma decisão, numa linha do tempo: a original primeiro,
+ a que vale hoje por último. Cinza = original, azul = edição, verde = vale hoje.
+--}}
From de28cd705616ba3594aafb1f238617db76bf31a5 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 13:18:44 -0300
Subject: [PATCH 60/77] =?UTF-8?q?refactor(panel-admin):=20conceder=20s?=
=?UTF-8?q?=C3=B3=20por=20busca,=20sem=20mixed=20nas=20a=C3=A7=C3=B5es=20d?=
=?UTF-8?q?a=20He4rt=20Delas?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
app-modules/panel-admin/lang/en/delas.php | 1 +
app-modules/panel-admin/lang/pt_BR/delas.php | 1 +
.../Actions/Delas/AddDelasModeratorAction.php | 2 +-
.../Delas/Fields/DelasPersonSelect.php | 37 ++++++++++++++-----
.../Actions/Delas/GrantDelasTagAction.php | 18 +++++----
.../Actions/Delas/RevokeDelasTagAction.php | 2 +-
.../Actions/Delas/ViewDelasProfileAction.php | 16 ++++++++
.../Concerns/InteractsWithDelasModeration.php | 3 +-
8 files changed, 60 insertions(+), 20 deletions(-)
diff --git a/app-modules/panel-admin/lang/en/delas.php b/app-modules/panel-admin/lang/en/delas.php
index 172af4ab8..aee3ded25 100644
--- a/app-modules/panel-admin/lang/en/delas.php
+++ b/app-modules/panel-admin/lang/en/delas.php
@@ -121,6 +121,7 @@
'also_block_hint' => 'Uses the same reason. Only prevents new tag requests: it is not a ban and does not affect the account.',
'revoked_and_blocked' => 'Tag removed and new requests blocked',
'person' => 'Person',
+ 'person_search_prompt' => 'Type a name or @username',
'person_hint' => 'Search by name or @username.',
'member_hint' => 'Only people who have the tag today.',
'add_moderator' => 'Add moderator',
diff --git a/app-modules/panel-admin/lang/pt_BR/delas.php b/app-modules/panel-admin/lang/pt_BR/delas.php
index 75f168609..d0080cf6e 100644
--- a/app-modules/panel-admin/lang/pt_BR/delas.php
+++ b/app-modules/panel-admin/lang/pt_BR/delas.php
@@ -121,6 +121,7 @@
'also_block_hint' => 'Usa o mesmo motivo. Só impede novos pedidos da tag: não é banimento e não afeta a conta.',
'revoked_and_blocked' => 'Tag removida e novos pedidos bloqueados',
'person' => 'Pessoa',
+ 'person_search_prompt' => 'Digite o nome ou @username',
'person_hint' => 'Busque por nome ou @username.',
'member_hint' => 'Só aparece quem tem a tag hoje.',
'add_moderator' => 'Adicionar moderadora',
diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/AddDelasModeratorAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/AddDelasModeratorAction.php
index 43c8dcc58..54816563e 100644
--- a/app-modules/panel-admin/src/Moderation/Actions/Delas/AddDelasModeratorAction.php
+++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/AddDelasModeratorAction.php
@@ -32,7 +32,7 @@ protected function setUp(): void
->helperText(__('panel-admin::delas.actions.moderator_hint')),
])
->action(fn (array $data) => $this->runDomainAction(
- fn () => resolve(AddDelasModerator::class)->handle(DelasPersonSelect::chosen($data['user_id']), $this->actor()),
+ fn () => resolve(AddDelasModerator::class)->handle(DelasPersonSelect::chosen($data), $this->actor()),
$this->text('panel-admin::delas.actions.moderator_added'),
));
}
diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/Fields/DelasPersonSelect.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/Fields/DelasPersonSelect.php
index 3efeb1524..f6145575c 100644
--- a/app-modules/panel-admin/src/Moderation/Actions/Delas/Fields/DelasPersonSelect.php
+++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/Fields/DelasPersonSelect.php
@@ -12,36 +12,53 @@
use Illuminate\Database\Eloquent\Collection;
/**
- * Seletor de pessoa das actions da liderança. Abre já com as primeiras pessoas
- * do escopo e busca o resto digitando; só aparece (e só ganha rótulo) quem a
- * consulta de domínio `DelasCandidates` devolve.
+ * Seletor de pessoa das actions da liderança. Só aparece (e só ganha rótulo)
+ * quem a consulta de domínio `DelasCandidates` devolve.
+ *
+ * Listas pequenas (quem tem a tag) abrem já com as primeiras pessoas; a
+ * comunidade inteira só por busca, para a lista não parecer completa.
*/
final class DelasPersonSelect
{
/**
* @param Closure(DelasCandidates): Builder $scope um dos escopos de `DelasCandidates`
+ * @param bool $opensWithList falso para listas do tamanho da comunidade: aí é só digitar
*/
- public static function make(Closure $scope): Select
+ public static function make(Closure $scope, bool $opensWithList = true): Select
{
$candidates = resolve(DelasCandidates::class);
$people = fn (): Builder => $scope($candidates);
- return Select::make('user_id')
+ $select = Select::make('user_id')
->label(__('panel-admin::delas.actions.person'))
->helperText(__('panel-admin::delas.actions.person_hint'))
+ ->searchPrompt(__('panel-admin::delas.actions.person_search_prompt'))
->required()
->searchable()
- ->preload()
- ->options(fn (): array => self::options($candidates->search($people(), '')))
+ // O projeto pré-carrega todo Select por padrão; aqui a decisão é por lista.
+ ->preload($opensWithList)
->getSearchResultsUsing(fn (string $search): array => self::options($candidates->search($people(), $search)))
- ->getOptionLabelUsing(fn (mixed $value): ?string => ($user = $people()->find($value)) instanceof User
+ ->getOptionLabelUsing(fn (?string $value): ?string => ($user = $people()->find($value)) instanceof User
? self::label($user)
: null);
+
+ if ($opensWithList) {
+ $select->options(fn (): array => self::options($candidates->search($people(), '')));
+ }
+
+ return $select;
}
- public static function chosen(mixed $id): User
+ /**
+ * A pessoa escolhida no formulário da action.
+ *
+ * @param array $data os dados do formulário, como o Filament entrega
+ */
+ public static function chosen(array $data): User
{
- return User::query()->whereKey($id)->firstOrFail();
+ $id = $data['user_id'] ?? null;
+
+ return User::query()->whereKey(is_string($id) ? $id : null)->firstOrFail();
}
/**
diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/GrantDelasTagAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/GrantDelasTagAction.php
index 67261cb4f..b6d76b29d 100644
--- a/app-modules/panel-admin/src/Moderation/Actions/Delas/GrantDelasTagAction.php
+++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/GrantDelasTagAction.php
@@ -33,18 +33,22 @@ protected function setUp(): void
->modalHeading(__('panel-admin::delas.actions.grant_heading'))
->modalDescription(__('panel-admin::delas.actions.grant_body'))
->schema([
- DelasPersonSelect::make(fn (DelasCandidates $candidates) => $candidates->forGrant($this->actor()))->live(),
+ // A comunidade inteira: só por busca, como nos outros seletores grandes do admin.
+ DelasPersonSelect::make(
+ fn (DelasCandidates $candidates) => $candidates->forGrant($this->actor()),
+ opensWithList: false,
+ )->live(),
Callout::make(__('panel-admin::delas.actions.grant_blocked_heading'))
- ->description(fn (Get $get): ?string => $this->blockSummary($this->activeBlockOf($get('user_id'))))
+ ->description(fn (Get $get): ?string => $this->blockSummary($this->activeBlockOf($get->string('user_id', isNullable: true))))
->warning()
- ->visible(fn (Get $get): bool => $this->activeBlockOf($get('user_id')) instanceof DelasRequesterBlock),
+ ->visible(fn (Get $get): bool => $this->activeBlockOf($get->string('user_id', isNullable: true)) instanceof DelasRequesterBlock),
$this->reasonField(
__('panel-admin::delas.actions.grant_reason'),
- required: fn (Get $get): bool => $this->activeBlockOf($get('user_id')) instanceof DelasRequesterBlock,
+ required: fn (Get $get): bool => $this->activeBlockOf($get->string('user_id', isNullable: true)) instanceof DelasRequesterBlock,
),
])
->action(fn (array $data) => $this->runDomainAction(
- fn () => resolve(GrantDelasTag::class)->handle(DelasPersonSelect::chosen($data['user_id']), $this->actor(), $this->reasonFrom($data)),
+ fn () => resolve(GrantDelasTag::class)->handle(DelasPersonSelect::chosen($data), $this->actor(), $this->reasonFrom($data)),
$this->text('panel-admin::delas.actions.granted'),
));
}
@@ -54,9 +58,9 @@ public static function getDefaultName(): string
return 'grant';
}
- private function activeBlockOf(mixed $userId): ?DelasRequesterBlock
+ private function activeBlockOf(?string $userId): ?DelasRequesterBlock
{
- if (!is_string($userId) || $userId === '') {
+ if ($userId === null || $userId === '') {
return null;
}
diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php
index decb770c6..8435bd8a3 100644
--- a/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php
+++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php
@@ -51,7 +51,7 @@ protected function setUp(): void
$this->runDomainAction(
fn () => resolve(RevokeDelasTag::class)->handle(
- target: $record instanceof DelasTagRequest ? $record->user : DelasPersonSelect::chosen($data['user_id'] ?? null),
+ target: $record instanceof DelasTagRequest ? $record->user : DelasPersonSelect::chosen($data),
actor: $this->actor(),
reason: $this->reasonFrom($data),
alsoBlock: $alsoBlock,
diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/ViewDelasProfileAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/ViewDelasProfileAction.php
index 579b092d8..95c9e7804 100644
--- a/app-modules/panel-admin/src/Moderation/Actions/Delas/ViewDelasProfileAction.php
+++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/ViewDelasProfileAction.php
@@ -7,6 +7,8 @@
use Filament\Actions\Action;
use Filament\Support\Enums\Width;
use He4rt\Delas\TagRequest\Queries\DelasEligibility;
+use He4rt\Identity\ExternalIdentity\Enums\IdentityProvider;
+use He4rt\Identity\ExternalIdentity\Models\ExternalIdentity;
use He4rt\Identity\User\Models\User;
use Illuminate\Contracts\View\View;
use Illuminate\Database\Eloquent\Model;
@@ -36,6 +38,7 @@ protected function setUp(): void
return view('panel-admin::moderation.delas.person-profile', [
'person' => $person,
'eligibility' => resolve(DelasEligibility::class)->for($person),
+ 'discord' => $this->connectedDiscord($person),
]);
})
->modalSubmitAction(action: false)
@@ -54,6 +57,19 @@ public function personRelation(?string $relation): static
return $this;
}
+ /**
+ * O Discord que a pessoa conectou e ainda está conectado, o mais recente.
+ * As conexões já vêm carregadas com a pessoa.
+ */
+ private function connectedDiscord(User $person): ?ExternalIdentity
+ {
+ return $person->providers
+ ->where('provider', IdentityProvider::Discord)
+ ->filter(fn (ExternalIdentity $identity): bool => $identity->isConnected())
+ ->sortByDesc('connected_at')
+ ->first();
+ }
+
/**
* A pessoa é carregada sozinha, com o perfil e as conexões, só quando o
* resumo abre: a tabela não paga por isso em cada linha.
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
index eb3668fdf..c68c6d95d 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/Concerns/InteractsWithDelasModeration.php
@@ -10,6 +10,7 @@
use He4rt\Identity\User\Models\User;
use He4rt\PanelAdmin\Moderation\Actions\Delas\ViewDelasProfileAction;
use Illuminate\Contracts\Support\Htmlable;
+use Illuminate\Database\Eloquent\Model;
use Illuminate\Support\HtmlString;
use Illuminate\Support\Str;
@@ -64,7 +65,7 @@ protected function personColumn(string $name, string $username, string $label):
return TextColumn::make($name)
->label($label)
->weight('medium')
- ->description(fn (mixed $record): HtmlString => new HtmlString(
+ ->description(fn (Model $record): HtmlString => new HtmlString(
e('@'.data_get($record, $username)).' · '.$this->clickableHint('panel-admin::delas.actions.view_profile'),
))
->action(ViewDelasProfileAction::make()->personRelation($relation))
From ccdf78ca755667ea8a983138003d27adad902f36 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 13:21:57 -0300
Subject: [PATCH 61/77] =?UTF-8?q?refactor(panel-admin):=20seletores=20da?=
=?UTF-8?q?=20He4rt=20Delas=20seguem=20o=20padr=C3=A3o=20de=20Select=20do?=
=?UTF-8?q?=20projeto?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
app-modules/panel-admin/lang/en/delas.php | 1 -
app-modules/panel-admin/lang/pt_BR/delas.php | 1 -
.../Delas/Fields/DelasPersonSelect.php | 23 +++++--------------
.../Actions/Delas/GrantDelasTagAction.php | 6 +----
.../Delas/DelasModerationPagesTest.php | 9 ++++----
5 files changed, 12 insertions(+), 28 deletions(-)
diff --git a/app-modules/panel-admin/lang/en/delas.php b/app-modules/panel-admin/lang/en/delas.php
index aee3ded25..172af4ab8 100644
--- a/app-modules/panel-admin/lang/en/delas.php
+++ b/app-modules/panel-admin/lang/en/delas.php
@@ -121,7 +121,6 @@
'also_block_hint' => 'Uses the same reason. Only prevents new tag requests: it is not a ban and does not affect the account.',
'revoked_and_blocked' => 'Tag removed and new requests blocked',
'person' => 'Person',
- 'person_search_prompt' => 'Type a name or @username',
'person_hint' => 'Search by name or @username.',
'member_hint' => 'Only people who have the tag today.',
'add_moderator' => 'Add moderator',
diff --git a/app-modules/panel-admin/lang/pt_BR/delas.php b/app-modules/panel-admin/lang/pt_BR/delas.php
index d0080cf6e..75f168609 100644
--- a/app-modules/panel-admin/lang/pt_BR/delas.php
+++ b/app-modules/panel-admin/lang/pt_BR/delas.php
@@ -121,7 +121,6 @@
'also_block_hint' => 'Usa o mesmo motivo. Só impede novos pedidos da tag: não é banimento e não afeta a conta.',
'revoked_and_blocked' => 'Tag removida e novos pedidos bloqueados',
'person' => 'Pessoa',
- 'person_search_prompt' => 'Digite o nome ou @username',
'person_hint' => 'Busque por nome ou @username.',
'member_hint' => 'Só aparece quem tem a tag hoje.',
'add_moderator' => 'Adicionar moderadora',
diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/Fields/DelasPersonSelect.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/Fields/DelasPersonSelect.php
index f6145575c..f2c50b8a7 100644
--- a/app-modules/panel-admin/src/Moderation/Actions/Delas/Fields/DelasPersonSelect.php
+++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/Fields/DelasPersonSelect.php
@@ -12,41 +12,30 @@
use Illuminate\Database\Eloquent\Collection;
/**
- * Seletor de pessoa das actions da liderança. Só aparece (e só ganha rótulo)
- * quem a consulta de domínio `DelasCandidates` devolve.
- *
- * Listas pequenas (quem tem a tag) abrem já com as primeiras pessoas; a
- * comunidade inteira só por busca, para a lista não parecer completa.
+ * Seletor de pessoa das actions da liderança. Abre com as primeiras pessoas do
+ * escopo (o padrão de Select do projeto) e busca o resto digitando. Só aparece
+ * (e só ganha rótulo) quem a consulta de domínio `DelasCandidates` devolve.
*/
final class DelasPersonSelect
{
/**
* @param Closure(DelasCandidates): Builder $scope um dos escopos de `DelasCandidates`
- * @param bool $opensWithList falso para listas do tamanho da comunidade: aí é só digitar
*/
- public static function make(Closure $scope, bool $opensWithList = true): Select
+ public static function make(Closure $scope): Select
{
$candidates = resolve(DelasCandidates::class);
$people = fn (): Builder => $scope($candidates);
- $select = Select::make('user_id')
+ return Select::make('user_id')
->label(__('panel-admin::delas.actions.person'))
->helperText(__('panel-admin::delas.actions.person_hint'))
- ->searchPrompt(__('panel-admin::delas.actions.person_search_prompt'))
->required()
->searchable()
- // O projeto pré-carrega todo Select por padrão; aqui a decisão é por lista.
- ->preload($opensWithList)
+ ->options(fn (): array => self::options($candidates->search($people(), '')))
->getSearchResultsUsing(fn (string $search): array => self::options($candidates->search($people(), $search)))
->getOptionLabelUsing(fn (?string $value): ?string => ($user = $people()->find($value)) instanceof User
? self::label($user)
: null);
-
- if ($opensWithList) {
- $select->options(fn (): array => self::options($candidates->search($people(), '')));
- }
-
- return $select;
}
/**
diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/GrantDelasTagAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/GrantDelasTagAction.php
index b6d76b29d..4a9bd1a42 100644
--- a/app-modules/panel-admin/src/Moderation/Actions/Delas/GrantDelasTagAction.php
+++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/GrantDelasTagAction.php
@@ -33,11 +33,7 @@ protected function setUp(): void
->modalHeading(__('panel-admin::delas.actions.grant_heading'))
->modalDescription(__('panel-admin::delas.actions.grant_body'))
->schema([
- // A comunidade inteira: só por busca, como nos outros seletores grandes do admin.
- DelasPersonSelect::make(
- fn (DelasCandidates $candidates) => $candidates->forGrant($this->actor()),
- opensWithList: false,
- )->live(),
+ DelasPersonSelect::make(fn (DelasCandidates $candidates) => $candidates->forGrant($this->actor()))->live(),
Callout::make(__('panel-admin::delas.actions.grant_blocked_heading'))
->description(fn (Get $get): ?string => $this->blockSummary($this->activeBlockOf($get->string('user_id', isNullable: true))))
->warning()
diff --git a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
index ee2bfcf74..ee8769175 100644
--- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
+++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
@@ -587,12 +587,13 @@ function delasHistoryEntry(DelasAction $action, string $reason, ?User $actor = n
expect($results)->toBe([$this->ana->getKey() => 'Ana Souza (@anasouza)']);
});
- test('abre vazio e pede para digitar, porque a lista é a comunidade inteira', function (): void {
+ test('abre já com a lista, sem quem tem a tag nem a própria líder', function (): void {
$select = mountedPersonSelect($this->page);
- expect($select->isPreloaded())->toBeFalse();
- expect($select->getOptions())->toBeEmpty();
- expect($select->getSearchPrompt())->toBe(__('panel-admin::delas.actions.person_search_prompt'));
+ expect($select->isPreloaded())->toBeTrue();
+ expect($select->getOptions())->toHaveKey($this->ana->getKey());
+ expect($select->getOptions())->not->toHaveKey($this->member->getKey());
+ expect($select->getOptions())->not->toHaveKey($this->lead->getKey());
});
test('a busca não acha quem tem a tag nem a própria líder', function (): void {
From 3fb9036c1f7078bbbee5de2dd5aca0fc3b7758b9 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 13:24:07 -0300
Subject: [PATCH 62/77] =?UTF-8?q?docs(delas):=20bloquear=20n=C3=A3o=20tira?=
=?UTF-8?q?=20a=20tag,=20e=20por=20qu=C3=AA?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
app-modules/delas/CONTEXT.md | 2 +-
docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md | 8 ++++++++
2 files changed, 9 insertions(+), 1 deletion(-)
diff --git a/app-modules/delas/CONTEXT.md b/app-modules/delas/CONTEXT.md
index 8e542fd76..ccd582a7a 100644
--- a/app-modules/delas/CONTEXT.md
+++ b/app-modules/delas/CONTEXT.md
@@ -27,7 +27,7 @@ Os dois painéis dependem deste módulo, e este módulo só depende do `identity
| **Solicitação** | Uma linha em `delas_tag_requests`: o pedido da tag e a decisão sobre ele (`pending`, `approved`, `rejected`, `revoked`). | O cargo `he4rt_delas` do Discord, concedido pelo `/cargo-delas`. Os dois ainda não são sincronizados. |
| **Moderadora He4rt Delas** | Quem tem a role `delas-moderator` (`UserRole::DelasModerator`) e passa no gate `moderate-delas`. Decide solicitações e bloqueia solicitantes. | A moderação de conteúdo do módulo `moderation` (Case, Appeal, Moderator). |
| **Líder He4rt Delas** | Quem tem a role `delas-lead` (`UserRole::DelasLead`) e passa no gate `lead-delas`. Tudo o que a moderadora faz, mais gerenciar moderadoras, conceder e remover a tag e ver o histórico completo (página Equipe). | Super admin: no `/admin` a líder só acessa a área da He4rt Delas e não nomeia outras líderes. |
-| **Bloqueio** | Uma linha em `delas_requester_blocks`: impede a pessoa de solicitar a tag até ser desbloqueada. Sempre tem motivo. | Ban ou suspensão (`UserSituation` do `identity`): o bloqueio não afeta a conta nem o resto do Hub. |
+| **Bloqueio** | Uma linha em `delas_requester_blocks`: impede a pessoa de solicitar a tag até ser desbloqueada. Sempre tem motivo. Não tira a tag de quem já tem. | Ban ou suspensão (`UserSituation` do `identity`): o bloqueio não afeta a conta nem o resto do Hub. |
| **Espera** | Prazo depois de uma solicitação `rejected` ou `revoked` em que a pessoa não pode pedir de novo. Padrão de 15 dias (`delas.request_cooldown_days`). | O bloqueio: a espera acaba sozinha, o bloqueio só acaba quando alguém desbloqueia. |
| **Discord conectado** | Requisito para pedir a tag (`delas.require_discord`): uma identidade Discord conectada pela própria pessoa (escopo `activelyConnected` do identity). Fica antes de liberar o pedido, depois da espera e do bloqueio. | Ter o cargo `he4rt_delas` no Discord: o cargo ainda não é sincronizado com a tag. |
| **Concessão direta** | Líder (ou super admin) dá a tag sem solicitação e sem espera (`GrantDelasTag`). Encerra um bloqueio ativo, se houver. | Aprovar uma solicitação: aprovar é decisão sobre um pedido que a pessoa fez. |
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index ae0ee4e3a..20bc83da0 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -97,6 +97,14 @@ Fatos do código atual que moldam o desenho:
- Não decidem a própria solicitação: ela fica para outra moderadora, uma líder ou um super admin.
- O bloqueio vale **só** para solicitar a tag. Não é ban nem suspensão (`UserSituation`) e não
afeta a conta.
+- **Bloquear não tira a tag.** Quem já tem a tag continua com ela mesmo bloqueada; o bloqueio só
+ passaria a valer se ela perdesse a tag e tentasse pedir de novo. Por isso o cadeado de bloquear
+ aparece só na Fila, para quem está pedindo.
+ - _Por quê:_ bloquear é da moderadora e serve para pedidos insistentes ou falsos. Tirar a tag
+ de quem já faz parte é mais sério e fica só com a líder, com motivo próprio. Se o bloqueio
+ tirasse a tag, a moderadora teria um caminho indireto para remover membras.
+ - Para tirar a tag **e** impedir novos pedidos, a líder usa "Remover tag" com "Também bloquear
+ novos pedidos" (Membras ou Equipe): as duas coisas na mesma transação, ou nenhuma.
- Veem a lista de quem tem a tag (página Membras), só para consulta.
- Editam o motivo que escreveram até 24 horas depois (`delas.reason_correction_hours`); o botão
"Editar motivo" mostra até quando. Cada edição é uma linha nova no histórico
From 8e275008a66fcd4d50be3f3aa1be08f8d83ca361 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 13:25:09 -0300
Subject: [PATCH 63/77] =?UTF-8?q?docs(delas):=20exemplo=20da=20espera=20co?=
=?UTF-8?q?m=20bloqueio=20e=20a=20ordem=20das=20verifica=C3=A7=C3=B5es?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 31 +++++++++++++++++++
1 file changed, 31 insertions(+)
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index 20bc83da0..92a6c154e 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -162,6 +162,37 @@ até a data original se ainda não acabou. Como bloquear rejeita o pedido penden
bloqueada com pedido aberto ganha uma espera contada do dia do bloqueio. A concessão direta
ignora a espera.
+- _Por quê:_ o bloqueio já teve motivo próprio. Reiniciar a espera ao desbloquear puniria a pessoa
+ duas vezes pelo mesmo episódio.
+
+Exemplo: pedido no dia 1, bloqueada no dia 3 (o pedido é rejeitado nesse dia, então a espera vai
+até o dia 18).
+
+| Desbloqueada no dia | Pode pedir |
+| ------------------- | -------------------------------------------- |
+| 10 | a partir do dia 18 (a espera ainda corre) |
+| 20 | na hora (a espera acabou durante o bloqueio) |
+
+Se, em vez de desbloquear, a líder conceder a tag no dia 10, a pessoa ganha a tag na hora: a
+concessão direta ignora a espera e encerra o bloqueio.
+
+### Ordem das verificações
+
+`DelasEligibility` decide a situação da pessoa nesta ordem, e a primeira que vale é a que o
+perfil mostra:
+
+1. **Pedido aberto** (`pending` ou `approved`): aguardando aprovação ou membra.
+2. **Bloqueio ativo:** "não é possível solicitar", sem motivo e sem data.
+3. **Espera:** a data a partir da qual pode pedir de novo.
+4. **Sem Discord conectado:** pede para conectar.
+5. **Pode pedir.**
+
+- _Por quê o bloqueio vem antes da espera:_ quem está bloqueada não deve ver uma data, que daria a
+ entender que vai poder pedir sozinha quando ela chegar. O bloqueio só acaba quando alguém
+ desbloqueia.
+- _Por quê o Discord vem por último:_ não adianta pedir para conectar o Discord a quem não poderia
+ pedir de qualquer jeito.
+
## Arquitetura
### Módulo `delas`
From 8c5066e3bf72bde8db719ba4a5dee29dd76461dd Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 13:28:45 -0300
Subject: [PATCH 64/77] =?UTF-8?q?docs(delas):=20ordem=20das=20verifica?=
=?UTF-8?q?=C3=A7=C3=B5es=20explicada=20e=20pontos=20em=20aberto=20atualiz?=
=?UTF-8?q?ados?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 62 ++++++++++++-------
1 file changed, 41 insertions(+), 21 deletions(-)
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index 92a6c154e..5990393a1 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -178,20 +178,23 @@ concessão direta ignora a espera e encerra o bloqueio.
### Ordem das verificações
-`DelasEligibility` decide a situação da pessoa nesta ordem, e a primeira que vale é a que o
-perfil mostra:
+Uma pessoa pode estar em mais de uma situação ao mesmo tempo (por exemplo, em espera **e**
+bloqueada), mas o perfil mostra um aviso só. `DelasEligibility` resolve isso como uma fila de
+perguntas: pergunta uma de cada vez e para na primeira resposta "sim".
-1. **Pedido aberto** (`pending` ou `approved`): aguardando aprovação ou membra.
-2. **Bloqueio ativo:** "não é possível solicitar", sem motivo e sem data.
-3. **Espera:** a data a partir da qual pode pedir de novo.
-4. **Sem Discord conectado:** pede para conectar.
-5. **Pode pedir.**
+1. Já tem um pedido aberto ou a tag? → "aguardando aprovação" ou "você faz parte".
+2. Está bloqueada? → "não é possível solicitar", sem motivo e sem data.
+3. Está em espera? → "você poderá pedir a partir de DD/MM".
+4. Falta conectar o Discord? → "conecte seu Discord".
+5. Nada disso → pode pedir.
-- _Por quê o bloqueio vem antes da espera:_ quem está bloqueada não deve ver uma data, que daria a
- entender que vai poder pedir sozinha quando ela chegar. O bloqueio só acaba quando alguém
- desbloqueia.
-- _Por quê o Discord vem por último:_ não adianta pedir para conectar o Discord a quem não poderia
- pedir de qualquer jeito.
+Exemplo: a Bia foi rejeitada (está em espera) e também foi bloqueada. A pergunta 2 já responde
+"sim", então ela vê "não é possível solicitar" e nunca chega na pergunta 3.
+
+- _Por quê o bloqueio vem antes da espera:_ se a Bia visse "você poderá pedir a partir do dia
+ 18", acharia que no dia 18 está liberada. Mas o bloqueio só acaba quando alguém desbloqueia.
+- _Por quê o Discord vem por último:_ sem isso, a Bia seria mandada conectar o Discord para só
+ então descobrir que não pode pedir.
## Arquitetura
@@ -470,13 +473,30 @@ Validação: `make check`, `make test` e `make test-shards`.
## Pontos em aberto
-1. **Papel `delas-lead`**: líder atribuindo `delas-moderator` vai além da #570. Precisa do ok da
- Sther e de comentário na issue.
+Dependem de outras pessoas e ficam fora deste PR.
+
+**Alinhar com a Alícia e a Sther** (vão além do texto das issues):
+
+1. **Regras além das issues**: espera de 15 dias, bloqueio, concessão e remoção direta, edição
+ de motivo, moderadora precisa ter a tag e Discord obrigatório para pedir. As que forem
+ recusadas saem do PR; a espera e o Discord são configuráveis
+ (`delas.request_cooldown_days`, `delas.require_discord`).
+2. **Papel `delas-lead`**: a líder gerencia moderadoras. A #570 diz que a permissão é
+ "atribuível apenas por admins do Hub".
+3. **Rejeição**: a solicitante deve ver o motivo? Hoje, não: o motivo é interno.
+
+**Próximas issues** (rascunhos locais, abrir depois do ok):
+
+4. **Tag pública por escolha da pessoa**: a tag revela identidade de gênero, dado sensível pela
+ LGPD. Hoje só a própria pessoa e quem modera a veem. A proposta é um interruptor "Mostrar a
+ tag no meu perfil público", desligado por padrão.
+5. **Integração com o `/cargo-delas` do Discord**: dar e tirar o cargo `he4rt_delas` quando a tag
+ é concedida ou removida. Os eventos de domínio e a conta do Discord conectada (agora
+ obrigatória para pedir) já deixam o gancho pronto.
+
+**Padrões do projeto** (mudar é decisão do time, não deste PR):
-2. **Regras além das issues** (espera de 15 dias, bloqueio, concessão e remoção direta): alinhar
- com a Alícia e a Sther nas issues.
-3. **Nome do papel**: `delas-moderator` cobre líder e moderadora, como na issue. Confirmar com a
- Sther.
-4. **LGPD**: a tag revela identidade de gênero, dado sensível. Hoje só a própria pessoa e quem
- modera a veem. Qualquer exibição pública futura precisa de decisão própria.
-5. **Rejeição**: a solicitante deve ver o motivo? Hoje, não.
+6. **Seletores de pessoa**: o projeto pré-carrega todo Select
+ (`FilamentServiceProvider::configureSelect()`). Na revisão, o Daniel sugeriu "Conceder tag" só
+ por busca, porque a lista é a comunidade inteira. Seguimos o padrão do projeto; se fizer
+ sentido mudar, é uma conversa com o time.
From 3c7be4c369ddbe2262cbcfcecbfe3a0b8223caa4 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 13:29:57 -0300
Subject: [PATCH 65/77] =?UTF-8?q?docs(delas):=20Ver=20perfil,=20Discord=20?=
=?UTF-8?q?obrigat=C3=B3rio=20e=20moderadora=20com=20tag=20na=20spec=20e?=
=?UTF-8?q?=20na=20ADR?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
...01-modulo-proprio-com-papel-e-historico.md | 15 ++++++++++
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 28 ++++++++++++++-----
2 files changed, 36 insertions(+), 7 deletions(-)
diff --git a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
index 76f28bfa1..de82d9928 100644
--- a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
+++ b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
@@ -82,6 +82,21 @@ precisa morar em algum lugar e ter uma forma de autorizar quem decide.
- **Seletores de pessoa como consulta de domínio** (`DelasCandidates`): conceder lista quem não tem
a tag, remover lista só quem tem, adicionar moderadora lista só quem tem a tag, sem super
admins, moderadoras e líderes, e a própria pessoa que age nunca aparece. As telas só chamam a consulta.
+- **Discord conectado para pedir a tag** (`delas.require_discord`, ligado por padrão). A He4rt
+ Delas acontece no Discord: a moderação conhece a pessoa por lá, e a conta conectada é o que vai
+ ligar a tag ao cargo `he4rt_delas`. Fica depois da espera e do bloqueio na ordem das
+ verificações, para ninguém ser mandada conectar o Discord sem poder pedir.
+ - _Alternativa descartada:_ exigir o perfil completo. Não prova nada sobre a pessoa, pede
+ dados pessoais a mais (minimização da LGPD) e afasta quem está começando. Ficou só um
+ lembrete no pop-up.
+- **Moderadora precisa ter a tag.** Quem modera a He4rt Delas faz parte dela; para promover
+ alguém de fora, a líder concede a tag antes.
+- **Bloquear não tira a tag.** Tirar a tag é da líder, com motivo próprio ("Remover tag", com a
+ opção de bloquear junto). Se o bloqueio tirasse a tag, a moderadora teria um caminho indireto
+ para remover membras.
+- **"Ver perfil" só leitura, com o mínimo.** A moderação vê o que ajuda a decidir (foto, título,
+ senioridade, "Sobre", Discord), nunca e-mail, data de nascimento ou localização. Não abre a área
+ de Perfis do admin para moderadoras: daria acesso ao perfil de todo mundo.
- **Marca no design system.** A logo, a tag e o ícone `he4rt-delas` moram no módulo `he4rt`
(`x-he4rt::delas.logo`, `x-he4rt::delas.tag`), porque os dois painéis usam. A paleta
`--color-delas-*` está no tema dos dois painéis.
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index 5990393a1..df02ecfdc 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -392,12 +392,18 @@ dispara também `DelasRequesterUnblocked`. Nenhum listener nesta entrega.
| Histórico | `moderate-delas` | | moderadora: decisões (os pedidos ela já vê na Fila); líder: completo, com os pedidos, filtro por ação e versões do motivo; editar motivo |
| Equipe | `lead-delas` | | números (pendentes, membras com a tag, tempo médio até a decisão, aprovadas e rejeitadas no mês, bloqueios ativos), conceder e remover a tag, adicionar e revogar moderadora |
-- Os seletores de pessoa da Equipe usam a consulta de domínio `DelasCandidates`: conceder
- busca por nome ou `@username` (a lista é a comunidade inteira); remover e adicionar moderadora
- já vêm carregados só com quem tem a tag. Quem age nunca aparece.
+- Os seletores de pessoa da Equipe usam a consulta de domínio `DelasCandidates` e seguem o
+ padrão de Select do projeto: abrem com as primeiras pessoas do escopo e buscam o resto por nome
+ ou `@username`, sem diferenciar acento nem maiúscula. Quem age nunca aparece.
+- **"Ver perfil"**: em todas as páginas, embaixo do nome, abre na lateral um resumo só leitura
+ com foto, título, senioridade, "Sobre", Discord conectado, "Na He4rt desde" e a situação da
+ pessoa na He4rt Delas. Ficam de fora e-mail, data de nascimento e localização (minimização da
+ LGPD); a pessoa e as conexões só são carregadas quando o resumo abre.
+- Cada ação é uma classe em `panel-admin/src/Moderation/Actions/Delas` (padrão do admin, como
+ `HideInteractionAction`); as páginas só listam as ações e declaram a consulta e as colunas.
- Cada tabela declara o eager load (`user.roles` na fila, `user` e `blocker` nos bloqueios,
- `user`, `actor` e `latestCorrection.actor` no histórico, `user` e `decider` na Membras, `roles`
- na equipe).
+ `user`, `actor` e `corrections.actor` no histórico, `user` e `decider` na Membras, `roles` na
+ equipe).
- A seção Papéis do `UserForm`, onde super admins atribuem `delas-lead` e `delas-moderator`,
visível só para super admins; a tabela de Usuários só **mostra** as roles (badges).
@@ -455,8 +461,16 @@ unitários em `delas/tests/Unit`.
- Candidatas (`DelasCandidates`): um teste por escopo (conceder, remover, adicionar moderadora,
quem age nunca aparece) e a busca.
- Páginas do admin (`panel-admin/tests/Feature/Moderation/Delas`): gate de cada página, badges,
- ações, busca e rótulo dos seletores, com eager load automático desligado e lazy loading
- proibido, e pelo menos dois registros por tabela.
+ ações, busca e rótulo dos seletores, "Ver perfil" sem dados pessoais e versões do motivo só
+ para a liderança, com eager load automático desligado e lazy loading proibido, e pelo menos
+ dois registros por tabela.
+- Perfil (`panel-app/tests/Feature/Delas`): pop-up antes de registrar, estados pendente, membra,
+ espera, bloqueada (sem o motivo) e sem Discord.
+- Testes escritos para leitura: um comportamento por teste, arrumar / agir / conferir separados,
+ um `expect` por linha.
+- Testes manuais com as contas do `DelasDemoSeeder`
+ (`php artisan db:seed --class="He4rt\Delas\Database\Seeders\DelasDemoSeeder"`): uma conta por
+ papel e por situação.
- Varredura: no `/admin`, a moderadora só acessa o Dashboard e as páginas da He4rt Delas; quem
não tem papel, só o Dashboard. Quem só modera é levada do Dashboard para a Moderação.
- Arch (opcional): `He4rt\Delas` não importa `He4rt\Panel*`.
From baeb3d2fd1c0c6958b14d260e92733d458efa9ac Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 15:33:03 -0300
Subject: [PATCH 66/77] =?UTF-8?q?fix(delas):=20quem=20=C3=A9=20da=20equipe?=
=?UTF-8?q?=20n=C3=A3o=20perde=20a=20tag;=20sai=20da=20modera=C3=A7=C3=A3o?=
=?UTF-8?q?=20antes?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
app-modules/delas/lang/en/exceptions.php | 1 +
app-modules/delas/lang/pt_BR/exceptions.php | 1 +
.../delas/src/Exceptions/DelasException.php | 5 +++
.../src/TagRequest/Actions/RevokeDelasTag.php | 9 ++++++
.../src/Team/Queries/DelasCandidates.php | 10 ++++--
.../TagRequest/GrantAndRevokeDelasTagTest.php | 32 +++++++++++++++++--
.../Feature/Team/DelasCandidatesTest.php | 13 ++++++++
7 files changed, 65 insertions(+), 6 deletions(-)
diff --git a/app-modules/delas/lang/en/exceptions.php b/app-modules/delas/lang/en/exceptions.php
index 7bfcbac04..988f66eb1 100644
--- a/app-modules/delas/lang/en/exceptions.php
+++ b/app-modules/delas/lang/en/exceptions.php
@@ -17,6 +17,7 @@
'already_has_tag' => 'This person already has the He4rt Delas tag.',
'has_no_tag' => 'This person does not have the He4rt Delas tag.',
'cannot_manage_role' => 'Leads and super admins are managed in /admin.',
+ 'team_member_keeps_tag' => 'He4rt Delas team members keep the tag. Remove the person from moderation before removing the tag.',
'moderator_needs_tag' => 'Only people with the He4rt Delas tag can be moderators. Grant the tag first.',
'already_moderator' => 'This person is already a He4rt Delas moderator.',
'not_moderator' => 'This person is not a He4rt Delas moderator.',
diff --git a/app-modules/delas/lang/pt_BR/exceptions.php b/app-modules/delas/lang/pt_BR/exceptions.php
index 3a29ab64b..d32970978 100644
--- a/app-modules/delas/lang/pt_BR/exceptions.php
+++ b/app-modules/delas/lang/pt_BR/exceptions.php
@@ -17,6 +17,7 @@
'already_has_tag' => 'Esta pessoa já tem a tag He4rt Delas.',
'has_no_tag' => 'Esta pessoa não tem a tag He4rt Delas.',
'cannot_manage_role' => 'Líderes e super admins são gerenciados no /admin.',
+ 'team_member_keeps_tag' => 'Quem é da equipe da He4rt Delas não perde a tag. Tire a pessoa da moderação antes de remover a tag.',
'moderator_needs_tag' => 'Só quem tem a tag He4rt Delas pode ser moderadora. Conceda a tag antes.',
'already_moderator' => 'Esta pessoa já é moderadora He4rt Delas.',
'not_moderator' => 'Esta pessoa não é moderadora He4rt Delas.',
diff --git a/app-modules/delas/src/Exceptions/DelasException.php b/app-modules/delas/src/Exceptions/DelasException.php
index c9f9868fe..046286964 100644
--- a/app-modules/delas/src/Exceptions/DelasException.php
+++ b/app-modules/delas/src/Exceptions/DelasException.php
@@ -93,6 +93,11 @@ public static function cannotManageRole(): self
return new self(__('delas::exceptions.cannot_manage_role'), Response::HTTP_FORBIDDEN);
}
+ public static function teamMemberKeepsTag(): self
+ {
+ return new self(__('delas::exceptions.team_member_keeps_tag'), Response::HTTP_UNPROCESSABLE_ENTITY);
+ }
+
public static function moderatorNeedsTag(): self
{
return new self(__('delas::exceptions.moderator_needs_tag'), Response::HTTP_UNPROCESSABLE_ENTITY);
diff --git a/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php b/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
index ff2ab389e..441a50aa1 100644
--- a/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
+++ b/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
@@ -13,6 +13,7 @@
use He4rt\Delas\TagRequest\Events\DelasTagRevoked;
use He4rt\Delas\TagRequest\Models\DelasTagRequest;
use He4rt\Delas\TagRequest\Queries\DelasEligibility;
+use He4rt\Identity\Authorization\Enums\UserRole;
use He4rt\Identity\User\Models\User;
use Illuminate\Auth\Access\AuthorizationException;
use Illuminate\Support\Facades\DB;
@@ -22,6 +23,10 @@
* Uma líder ou super admin remove a tag. O registro não é apagado: muda para
* `revoked` e abre a espera para um novo pedido.
*
+ * Quem é da equipe (moderadora ou líder) não perde a tag por aqui: moderadora
+ * precisa ter a tag (`AddDelasModerator`), então primeiro a pessoa sai da
+ * equipe e só depois pode perder a tag. Assim ninguém modera sem ter a tag.
+ *
* Com `$alsoBlock`, a pessoa também é bloqueada de pedir de novo, com o mesmo
* motivo e na mesma transação: ou as duas coisas acontecem, ou nenhuma.
*/
@@ -41,6 +46,10 @@ public function handle(User $target, User $actor, ?string $reason, bool $alsoBlo
Gate::forUser($actor)->authorize('lead-delas');
throw_if($target->is($actor), DelasException::cannotDecideOwn());
+ throw_if(
+ $target->hasAnyRole([UserRole::DelasModerator, UserRole::DelasLead]),
+ DelasException::teamMemberKeepsTag(),
+ );
$reason = Reason::required($reason);
diff --git a/app-modules/delas/src/Team/Queries/DelasCandidates.php b/app-modules/delas/src/Team/Queries/DelasCandidates.php
index 12ae06725..55b742f0c 100644
--- a/app-modules/delas/src/Team/Queries/DelasCandidates.php
+++ b/app-modules/delas/src/Team/Queries/DelasCandidates.php
@@ -38,14 +38,18 @@ public function forGrant(User $actor): Builder
}
/**
- * Só quem tem a tag hoje. A lista é pequena, então o seletor pode
- * pré-carregar.
+ * Quem tem a tag hoje e não é da equipe: moderadoras e líderes saem da
+ * equipe antes de perder a tag (`RevokeDelasTag`).
*
* @return Builder
*/
public function forRevoke(User $actor): Builder
{
- return $this->others($actor)->whereIn('id', $this->members());
+ $team = [UserRole::DelasModerator->value, UserRole::DelasLead->value];
+
+ return $this->others($actor)
+ ->whereIn('id', $this->members())
+ ->whereDoesntHave('roles', fn (Builder $roles): Builder => $roles->whereIn('name', $team));
}
/**
diff --git a/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php b/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php
index 64f99bd6d..52d3c3f24 100644
--- a/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php
+++ b/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php
@@ -16,6 +16,7 @@
use He4rt\Delas\TagRequest\Events\DelasTagRevoked;
use He4rt\Delas\TagRequest\Models\DelasTagRequest;
use He4rt\Delas\TagRequest\Queries\DelasEligibility;
+use He4rt\Delas\Team\Actions\RemoveDelasModerator;
use He4rt\Identity\User\Models\User;
use Illuminate\Auth\Access\AuthorizationException;
use Illuminate\Support\Facades\Event;
@@ -168,10 +169,11 @@
test('se não der para bloquear, a tag também não é removida', function (): void {
$lead = User::factory()->delasLead()->create();
- $moderatorWithTag = User::factory()->delasModerator()->create();
- $approved = DelasTagRequest::factory()->for($moderatorWithTag)->approved()->create();
+ // Super admin passa no `moderate-delas` pelo Gate::before, então nunca pode ser bloqueado.
+ $superAdminWithTag = User::factory()->superAdmin()->create();
+ $approved = DelasTagRequest::factory()->for($superAdminWithTag)->approved()->create();
- expect(fn () => $this->revoke->handle($moderatorWithTag, $lead, 'Motivo.', alsoBlock: true))
+ expect(fn () => $this->revoke->handle($superAdminWithTag, $lead, 'Motivo.', alsoBlock: true))
->toThrow(DelasException::class, __('delas::exceptions.cannot_block_team'));
expect($approved->fresh()->status)->toBe(DelasRequestStatus::Approved);
@@ -188,3 +190,27 @@
expect(DelasRequesterBlock::query()->where('user_id', $approved->user_id)->count())->toBe(1);
expect($approved->fresh()->status)->toBe(DelasRequestStatus::Revoked);
});
+
+// Quem é da equipe não perde a tag
+
+test('não remove a tag de quem é da equipe', function (string $role): void {
+ $lead = User::factory()->delasLead()->create();
+ $teamMember = User::factory()->{$role}()->create();
+ $approved = DelasTagRequest::factory()->for($teamMember)->approved()->create();
+
+ expect(fn () => $this->revoke->handle($teamMember, $lead, 'Motivo.'))
+ ->toThrow(DelasException::class, __('delas::exceptions.team_member_keeps_tag'));
+
+ expect($approved->fresh()->status)->toBe(DelasRequestStatus::Approved);
+})->with(['moderadora' => 'delasModerator', 'líder' => 'delasLead']);
+
+test('depois de sair da moderação, a pessoa pode perder a tag', function (): void {
+ $lead = User::factory()->delasLead()->create();
+ $moderator = User::factory()->delasModerator()->create();
+ $approved = DelasTagRequest::factory()->for($moderator)->approved()->create();
+
+ resolve(RemoveDelasModerator::class)->handle($moderator, $lead);
+ $this->revoke->handle($moderator->fresh(), $lead, 'Saiu da He4rt Delas.');
+
+ expect($approved->fresh()->status)->toBe(DelasRequestStatus::Revoked);
+});
diff --git a/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php b/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
index e2c205548..3c7c738ad 100644
--- a/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
+++ b/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
@@ -115,3 +115,16 @@ function delasGrantSearchIds(DelasCandidates $candidates, User $lead, string $te
expect($ids)->toContain($thais->id);
})->with(['thais', 'THAÍS']);
+
+test('remover: quem é da equipe não aparece, mesmo com a tag', function (): void {
+ $member = DelasTagRequest::factory()->approved()->create(['decided_by' => $this->lead->getKey()])->user;
+ $moderator = User::factory()->delasModerator()->create();
+ $otherLead = User::factory()->delasLead()->create();
+ foreach ([$moderator, $otherLead] as $teamMember) {
+ DelasTagRequest::factory()->for($teamMember)->approved()->create(['decided_by' => $this->lead->getKey()]);
+ }
+
+ $ids = $this->candidates->forRevoke($this->lead)->pluck('id')->all();
+
+ expect($ids)->toContain($member->id)->not->toContain($moderator->id, $otherLead->id);
+});
From d211d05c43065d22edd133450807faa7493a59a2 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 15:33:26 -0300
Subject: [PATCH 67/77] =?UTF-8?q?fix(panel-admin):=20Remover=20tag=20n?=
=?UTF-8?q?=C3=A3o=20aparece=20para=20quem=20=C3=A9=20da=20equipe?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../Actions/Delas/RevokeDelasTagAction.php | 10 +++++++++-
.../src/Moderation/Pages/Delas/DelasMembersPage.php | 2 +-
.../Moderation/Delas/DelasModerationPagesTest.php | 12 ++++++++++++
3 files changed, 22 insertions(+), 2 deletions(-)
diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php
index 8435bd8a3..aae82dee2 100644
--- a/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php
+++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php
@@ -11,6 +11,8 @@
use He4rt\Delas\TagRequest\Actions\RevokeDelasTag;
use He4rt\Delas\TagRequest\Models\DelasTagRequest;
use He4rt\Delas\Team\Queries\DelasCandidates;
+use He4rt\Identity\Authorization\Enums\UserRole;
+use He4rt\Identity\User\Models\User;
use He4rt\PanelAdmin\Moderation\Actions\Delas\Concerns\InteractsWithDelasActions;
use He4rt\PanelAdmin\Moderation\Actions\Delas\Fields\DelasPersonSelect;
@@ -32,7 +34,8 @@ protected function setUp(): void
->icon(Heroicon::OutlinedMinusCircle)
->color('danger')
->outlined()
- ->visible(fn (): bool => $this->isLead())
+ // Na linha de Membras, quem é da equipe não tem o botão: sai da equipe antes.
+ ->visible(fn (?DelasTagRequest $record): bool => $this->isLead() && !$this->isTeamMember($record?->user))
->modalHeading(fn (?DelasTagRequest $record): string => $record instanceof DelasTagRequest
? $this->text('panel-admin::delas.actions.revoke_member_heading', ['name' => $record->user->name])
: $this->text('panel-admin::delas.actions.revoke_heading'))
@@ -66,6 +69,11 @@ public static function getDefaultName(): string
return 'revoke';
}
+ private function isTeamMember(?User $person): bool
+ {
+ return $person?->hasAnyRole([UserRole::DelasModerator, UserRole::DelasLead]) ?? false;
+ }
+
private function memberSelect(): Select
{
return DelasPersonSelect::make(fn (DelasCandidates $candidates) => $candidates->forRevoke($this->actor()))
diff --git a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasMembersPage.php b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasMembersPage.php
index 535089d12..6532cb57c 100644
--- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasMembersPage.php
+++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasMembersPage.php
@@ -69,7 +69,7 @@ public function getSubheading(): string
public function table(Table $table): Table
{
return $table
- ->query(DelasTagRequest::query()->where('status', DelasRequestStatus::Approved)->with(['user', 'decider']))
+ ->query(DelasTagRequest::query()->where('status', DelasRequestStatus::Approved)->with(['user.roles', 'decider']))
->defaultSort('decided_at', 'desc')
->emptyStateHeading(__('panel-admin::delas.empty.members'))
->emptyStateDescription(__('panel-admin::delas.empty.members_body'))
diff --git a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
index ee8769175..2976febf0 100644
--- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
+++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
@@ -705,3 +705,15 @@ function delasHistoryEntry(DelasAction $action, string $reason, ?User $actor = n
->mountAction(TestAction::make('viewProfile')->table($moderator))
->assertMountedActionModalSee([$moderator->name, __('panel-admin::delas.profile.empty')]);
});
+
+test('em Membras, a linha de quem é da equipe não tem "Remover tag"', function (): void {
+ $lead = actingAsDelasLead();
+ $moderator = User::factory()->delasModerator()->create();
+ $moderatorRequest = DelasTagRequest::factory()->for($moderator)->approved()->create(['decided_by' => $lead->getKey()]);
+ $memberRequest = DelasTagRequest::factory()->approved()->create(['decided_by' => $lead->getKey()]);
+
+ livewire(DelasMembersPage::class)
+ ->loadTable()
+ ->assertActionHidden(TestAction::make('revoke')->table($moderatorRequest))
+ ->assertActionVisible(TestAction::make('revoke')->table($memberRequest));
+});
From ea4172436b63f7cf836a44f5e111f85903068ec0 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 15:33:48 -0300
Subject: [PATCH 68/77] =?UTF-8?q?docs(delas):=20quem=20=C3=A9=20da=20equip?=
=?UTF-8?q?e=20n=C3=A3o=20perde=20a=20tag?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
app-modules/delas/CONTEXT.md | 28 +++++++++----------
...01-modulo-proprio-com-papel-e-historico.md | 9 ++++--
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 8 ++++++
3 files changed, 28 insertions(+), 17 deletions(-)
diff --git a/app-modules/delas/CONTEXT.md b/app-modules/delas/CONTEXT.md
index ccd582a7a..9a6821d08 100644
--- a/app-modules/delas/CONTEXT.md
+++ b/app-modules/delas/CONTEXT.md
@@ -21,17 +21,17 @@ Os dois painéis dependem deste módulo, e este módulo só depende do `identity
## Glossário
-| Termo | Definição | Não confundir com |
-| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
-| **Tag He4rt Delas** | Marca no perfil de que a pessoa faz parte da He4rt Delas. Existe quando a solicitação dela está `approved`. | Um Badge do `gamification`: badges vêm de XP ou claim, a tag vem de uma decisão. |
-| **Solicitação** | Uma linha em `delas_tag_requests`: o pedido da tag e a decisão sobre ele (`pending`, `approved`, `rejected`, `revoked`). | O cargo `he4rt_delas` do Discord, concedido pelo `/cargo-delas`. Os dois ainda não são sincronizados. |
-| **Moderadora He4rt Delas** | Quem tem a role `delas-moderator` (`UserRole::DelasModerator`) e passa no gate `moderate-delas`. Decide solicitações e bloqueia solicitantes. | A moderação de conteúdo do módulo `moderation` (Case, Appeal, Moderator). |
-| **Líder He4rt Delas** | Quem tem a role `delas-lead` (`UserRole::DelasLead`) e passa no gate `lead-delas`. Tudo o que a moderadora faz, mais gerenciar moderadoras, conceder e remover a tag e ver o histórico completo (página Equipe). | Super admin: no `/admin` a líder só acessa a área da He4rt Delas e não nomeia outras líderes. |
-| **Bloqueio** | Uma linha em `delas_requester_blocks`: impede a pessoa de solicitar a tag até ser desbloqueada. Sempre tem motivo. Não tira a tag de quem já tem. | Ban ou suspensão (`UserSituation` do `identity`): o bloqueio não afeta a conta nem o resto do Hub. |
-| **Espera** | Prazo depois de uma solicitação `rejected` ou `revoked` em que a pessoa não pode pedir de novo. Padrão de 15 dias (`delas.request_cooldown_days`). | O bloqueio: a espera acaba sozinha, o bloqueio só acaba quando alguém desbloqueia. |
-| **Discord conectado** | Requisito para pedir a tag (`delas.require_discord`): uma identidade Discord conectada pela própria pessoa (escopo `activelyConnected` do identity). Fica antes de liberar o pedido, depois da espera e do bloqueio. | Ter o cargo `he4rt_delas` no Discord: o cargo ainda não é sincronizado com a tag. |
-| **Concessão direta** | Líder (ou super admin) dá a tag sem solicitação e sem espera (`GrantDelasTag`). Encerra um bloqueio ativo, se houver. | Aprovar uma solicitação: aprovar é decisão sobre um pedido que a pessoa fez. |
-| **Histórico** | `delas_transitions`: uma linha por ação (solicitar, aprovar, rejeitar, conceder, remover, bloquear, desbloquear), com quem fez, quando e motivo. | Logs da aplicação: o histórico é dado de domínio, append-only, gravado pelas próprias actions. |
-| **Candidatas** | Quem pode ser escolhida nos seletores de pessoa da Equipe (`DelasCandidates`): conceder lista quem não tem a tag, remover lista só quem tem, adicionar moderadora lista só quem tem a tag, sem super admins e a equipe. Quem age nunca aparece. | A regra de negócio: a consulta só filtra a lista; quem valida a ação são as actions de domínio. |
-| **Membra** | Quem tem a tag hoje: solicitação `approved`. Aparece na página Membras, onde a líder pode remover a tag e bloquear novos pedidos junto. | Moderadora: membra é quem tem a tag, moderadora é quem decide sobre ela. |
-| **Edição de motivo** | Linha `reason_corrected` no histórico que aponta (`corrects_id`) para a decisão editada. A original fica como foi escrita; vale a edição mais recente. Na tela, "Editar motivo" e "Editado em". | Sobrescrever o motivo: nada no histórico é apagado. No código, a action se chama `CorrectDelasReason`. |
+| Termo | Definição | Não confundir com |
+| -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ |
+| **Tag He4rt Delas** | Marca no perfil de que a pessoa faz parte da He4rt Delas. Existe quando a solicitação dela está `approved`. | Um Badge do `gamification`: badges vêm de XP ou claim, a tag vem de uma decisão. |
+| **Solicitação** | Uma linha em `delas_tag_requests`: o pedido da tag e a decisão sobre ele (`pending`, `approved`, `rejected`, `revoked`). | O cargo `he4rt_delas` do Discord, concedido pelo `/cargo-delas`. Os dois ainda não são sincronizados. |
+| **Moderadora He4rt Delas** | Quem tem a role `delas-moderator` (`UserRole::DelasModerator`) e passa no gate `moderate-delas`. Decide solicitações e bloqueia solicitantes. | A moderação de conteúdo do módulo `moderation` (Case, Appeal, Moderator). |
+| **Líder He4rt Delas** | Quem tem a role `delas-lead` (`UserRole::DelasLead`) e passa no gate `lead-delas`. Tudo o que a moderadora faz, mais gerenciar moderadoras, conceder e remover a tag e ver o histórico completo (página Equipe). | Super admin: no `/admin` a líder só acessa a área da He4rt Delas e não nomeia outras líderes. |
+| **Bloqueio** | Uma linha em `delas_requester_blocks`: impede a pessoa de solicitar a tag até ser desbloqueada. Sempre tem motivo. Não tira a tag de quem já tem. | Ban ou suspensão (`UserSituation` do `identity`): o bloqueio não afeta a conta nem o resto do Hub. |
+| **Espera** | Prazo depois de uma solicitação `rejected` ou `revoked` em que a pessoa não pode pedir de novo. Padrão de 15 dias (`delas.request_cooldown_days`). | O bloqueio: a espera acaba sozinha, o bloqueio só acaba quando alguém desbloqueia. |
+| **Discord conectado** | Requisito para pedir a tag (`delas.require_discord`): uma identidade Discord conectada pela própria pessoa (escopo `activelyConnected` do identity). Fica antes de liberar o pedido, depois da espera e do bloqueio. | Ter o cargo `he4rt_delas` no Discord: o cargo ainda não é sincronizado com a tag. |
+| **Concessão direta** | Líder (ou super admin) dá a tag sem solicitação e sem espera (`GrantDelasTag`). Encerra um bloqueio ativo, se houver. | Aprovar uma solicitação: aprovar é decisão sobre um pedido que a pessoa fez. |
+| **Histórico** | `delas_transitions`: uma linha por ação (solicitar, aprovar, rejeitar, conceder, remover, bloquear, desbloquear), com quem fez, quando e motivo. | Logs da aplicação: o histórico é dado de domínio, append-only, gravado pelas próprias actions. |
+| **Candidatas** | Quem pode ser escolhida nos seletores de pessoa da Equipe (`DelasCandidates`): conceder lista quem não tem a tag, remover lista só quem tem e não é da equipe, adicionar moderadora lista só quem tem a tag, sem super admins e a equipe. Quem age nunca aparece. | A regra de negócio: a consulta só filtra a lista; quem valida a ação são as actions de domínio. |
+| **Membra** | Quem tem a tag hoje: solicitação `approved`. Aparece na página Membras, onde a líder pode remover a tag e bloquear novos pedidos junto. | Moderadora: membra é quem tem a tag, moderadora é quem decide sobre ela. |
+| **Edição de motivo** | Linha `reason_corrected` no histórico que aponta (`corrects_id`) para a decisão editada. A original fica como foi escrita; vale a edição mais recente. Na tela, "Editar motivo" e "Editado em". | Sobrescrever o motivo: nada no histórico é apagado. No código, a action se chama `CorrectDelasReason`. |
diff --git a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
index de82d9928..ba3961294 100644
--- a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
+++ b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
@@ -80,7 +80,7 @@ precisa morar em algum lugar e ter uma forma de autorizar quem decide.
moderação, fora do cluster que já existe.
- **Seletores de pessoa como consulta de domínio** (`DelasCandidates`): conceder lista quem não tem
- a tag, remover lista só quem tem, adicionar moderadora lista só quem tem a tag, sem super
+ a tag, remover lista só quem tem e não é da equipe, adicionar moderadora lista só quem tem a tag, sem super
admins, moderadoras e líderes, e a própria pessoa que age nunca aparece. As telas só chamam a consulta.
- **Discord conectado para pedir a tag** (`delas.require_discord`, ligado por padrão). A He4rt
Delas acontece no Discord: a moderação conhece a pessoa por lá, e a conta conectada é o que vai
@@ -89,8 +89,11 @@ precisa morar em algum lugar e ter uma forma de autorizar quem decide.
- _Alternativa descartada:_ exigir o perfil completo. Não prova nada sobre a pessoa, pede
dados pessoais a mais (minimização da LGPD) e afasta quem está começando. Ficou só um
lembrete no pop-up.
-- **Moderadora precisa ter a tag.** Quem modera a He4rt Delas faz parte dela; para promover
- alguém de fora, a líder concede a tag antes.
+- **Moderadora precisa ter a tag, e quem é da equipe não perde a tag.** Quem modera a He4rt
+ Delas faz parte dela: para promover alguém de fora, a líder concede a tag antes; para tirar a
+ tag de uma moderadora, revoga o papel antes. `RevokeDelasTag` recusa moderadoras e líderes.
+ - _Alternativa descartada:_ tirar da moderação junto ao remover a tag. Ficaria num passo só,
+ mas uma ação de tag passaria a mexer na equipe por um caminho indireto.
- **Bloquear não tira a tag.** Tirar a tag é da líder, com motivo próprio ("Remover tag", com a
opção de bloquear junto). Se o bloqueio tirasse a tag, a moderadora teria um caminho indireto
para remover membras.
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index df02ecfdc..db8627f55 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -125,6 +125,14 @@ que a moderadora tem, mais:
- na Equipe, adiciona e revoga `delas-moderator`. Só quem tem a tag vira moderadora: para
promover alguém de fora, a líder concede a tag antes. Não cria nem revoga líderes, e não age
sobre super admins;
+- **quem é da equipe não perde a tag.** Para tirar a tag de uma moderadora, a líder primeiro
+ revoga o papel (Equipe → "Revogar moderadora") e só depois remove a tag. Líderes saem da
+ equipe pelo super admin, no cadastro de usuários. Por isso o "Remover tag" não aparece na
+ linha de quem é da equipe em Membras, e moderadoras e líderes não aparecem no seletor da
+ Equipe. A regra também vale no domínio (`RevokeDelasTag` recusa).
+ - _Por quê:_ é o espelho de "moderadora precisa ter a tag". Sem isso, uma moderadora sem a tag
+ continuaria moderando. E, como quem é da equipe nunca pode ser bloqueada, o "Também
+ bloquear" nunca aparece para quem falharia;
- desbloqueia qualquer bloqueio;
- edita qualquer motivo, a qualquer momento, e abre "ver versões": a original e cada edição,
com quem escreveu e quando;
From 4f971021480733cfca04a96259224af9b425a1fa Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 8 Oct 2026 15:39:33 -0300
Subject: [PATCH 69/77] test(panel-admin): moderadora revogada perde o acesso
ao admin na hora
---
.../tests/Feature/AdminPanelAccessTest.php | 12 ++++++++++++
.../Moderation/Delas/DelasModerationPagesTest.php | 9 ++++++---
2 files changed, 18 insertions(+), 3 deletions(-)
diff --git a/app-modules/panel-admin/tests/Feature/AdminPanelAccessTest.php b/app-modules/panel-admin/tests/Feature/AdminPanelAccessTest.php
index bde51a03b..ba39423c9 100644
--- a/app-modules/panel-admin/tests/Feature/AdminPanelAccessTest.php
+++ b/app-modules/panel-admin/tests/Feature/AdminPanelAccessTest.php
@@ -3,6 +3,7 @@
declare(strict_types=1);
use Filament\Facades\Filament;
+use He4rt\Delas\Team\Actions\RemoveDelasModerator;
use He4rt\Identity\User\Models\User;
test('unauthenticated user is redirected to login', function (): void {
@@ -69,3 +70,14 @@
expect($user->canAccessPanel($panel))->toBeTrue();
});
+
+test('moderadora revogada pela líder perde a entrada no admin em produção', function (): void {
+ $lead = User::factory()->delasLead()->create();
+ $moderator = User::factory()->delasModerator()->create();
+
+ resolve(RemoveDelasModerator::class)->handle($moderator, $lead);
+
+ app()->detectEnvironment(fn () => 'production');
+
+ expect($moderator->fresh()->canAccessPanel(Filament::getPanel('admin')))->toBeFalse();
+});
diff --git a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
index 2976febf0..bb816e0ce 100644
--- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
+++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
@@ -12,6 +12,7 @@
use He4rt\Delas\History\Models\DelasTransition;
use He4rt\Delas\TagRequest\Enums\DelasRequestStatus;
use He4rt\Delas\TagRequest\Models\DelasTagRequest;
+use He4rt\Delas\Team\Actions\RemoveDelasModerator;
use He4rt\Delas\Team\Queries\DelasCandidates;
use He4rt\Identity\Authorization\Enums\UserRole;
use He4rt\Identity\User\Models\User;
@@ -130,13 +131,15 @@ function delasHistoryEntry(DelasAction $action, string $reason, ?User $actor = n
$response->assertOk();
})->with([DelasQueuePage::class, DelasMembersPage::class, DelasBlocksPage::class, DelasHistoryPage::class]);
-test('ao revogar o papel, a moderadora perde o acesso na hora', function (): void {
+test('ao ser revogada pela líder, a moderadora perde o acesso na hora', function (): void {
+ $lead = User::factory()->delasLead()->create();
$moderator = User::factory()->delasModerator()->create();
+ $this->actingAs($moderator);
- $moderator->removeRole(UserRole::DelasModerator);
- $this->actingAs($moderator->fresh());
+ resolve(RemoveDelasModerator::class)->handle($moderator, $lead);
expect(DelasQueuePage::canAccess())->toBeFalse();
+ $this->get(DelasQueuePage::getUrl())->assertForbidden();
});
test('o cluster de Moderação leva a moderadora direto para a fila', function (): void {
From c79eb1f1293b71ab670412d069813ebec3f640f5 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Fri, 9 Oct 2026 10:06:57 -0300
Subject: [PATCH 70/77] =?UTF-8?q?fix(delas):=20super=20admin=20tamb=C3=A9m?=
=?UTF-8?q?=20=C3=A9=20da=20equipe=20e=20n=C3=A3o=20perde=20a=20tag?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
A equipe passa a ser quem passa no gate moderate-delas (moderadora, líder
ou super admin), a mesma definição do BlockDelasRequester.
---
app-modules/delas/lang/en/exceptions.php | 2 +-
app-modules/delas/lang/pt_BR/exceptions.php | 2 +-
.../src/TagRequest/Actions/RevokeDelasTag.php | 14 ++++++--------
.../delas/src/Team/Queries/DelasCandidates.php | 6 +++---
.../TagRequest/GrantAndRevokeDelasTagTest.php | 15 +--------------
.../tests/Feature/Team/DelasCandidatesTest.php | 5 +++--
6 files changed, 15 insertions(+), 29 deletions(-)
diff --git a/app-modules/delas/lang/en/exceptions.php b/app-modules/delas/lang/en/exceptions.php
index 988f66eb1..8107e6efd 100644
--- a/app-modules/delas/lang/en/exceptions.php
+++ b/app-modules/delas/lang/en/exceptions.php
@@ -17,7 +17,7 @@
'already_has_tag' => 'This person already has the He4rt Delas tag.',
'has_no_tag' => 'This person does not have the He4rt Delas tag.',
'cannot_manage_role' => 'Leads and super admins are managed in /admin.',
- 'team_member_keeps_tag' => 'He4rt Delas team members keep the tag. Remove the person from moderation before removing the tag.',
+ 'team_member_keeps_tag' => 'He4rt Delas team members (moderators, leads and super admins) keep the tag. Remove the person from the team before removing the tag.',
'moderator_needs_tag' => 'Only people with the He4rt Delas tag can be moderators. Grant the tag first.',
'already_moderator' => 'This person is already a He4rt Delas moderator.',
'not_moderator' => 'This person is not a He4rt Delas moderator.',
diff --git a/app-modules/delas/lang/pt_BR/exceptions.php b/app-modules/delas/lang/pt_BR/exceptions.php
index d32970978..41ab5b0de 100644
--- a/app-modules/delas/lang/pt_BR/exceptions.php
+++ b/app-modules/delas/lang/pt_BR/exceptions.php
@@ -17,7 +17,7 @@
'already_has_tag' => 'Esta pessoa já tem a tag He4rt Delas.',
'has_no_tag' => 'Esta pessoa não tem a tag He4rt Delas.',
'cannot_manage_role' => 'Líderes e super admins são gerenciados no /admin.',
- 'team_member_keeps_tag' => 'Quem é da equipe da He4rt Delas não perde a tag. Tire a pessoa da moderação antes de remover a tag.',
+ 'team_member_keeps_tag' => 'Quem é da equipe da He4rt Delas (moderadora, líder ou super admin) não perde a tag. Tire a pessoa da equipe antes de remover a tag.',
'moderator_needs_tag' => 'Só quem tem a tag He4rt Delas pode ser moderadora. Conceda a tag antes.',
'already_moderator' => 'Esta pessoa já é moderadora He4rt Delas.',
'not_moderator' => 'Esta pessoa não é moderadora He4rt Delas.',
diff --git a/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php b/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
index 441a50aa1..b38fd40f9 100644
--- a/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
+++ b/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
@@ -13,7 +13,6 @@
use He4rt\Delas\TagRequest\Events\DelasTagRevoked;
use He4rt\Delas\TagRequest\Models\DelasTagRequest;
use He4rt\Delas\TagRequest\Queries\DelasEligibility;
-use He4rt\Identity\Authorization\Enums\UserRole;
use He4rt\Identity\User\Models\User;
use Illuminate\Auth\Access\AuthorizationException;
use Illuminate\Support\Facades\DB;
@@ -23,9 +22,10 @@
* Uma líder ou super admin remove a tag. O registro não é apagado: muda para
* `revoked` e abre a espera para um novo pedido.
*
- * Quem é da equipe (moderadora ou líder) não perde a tag por aqui: moderadora
- * precisa ter a tag (`AddDelasModerator`), então primeiro a pessoa sai da
- * equipe e só depois pode perder a tag. Assim ninguém modera sem ter a tag.
+ * Quem é da equipe (moderadora, líder ou super admin) não perde a tag por
+ * aqui: moderadora precisa ter a tag (`AddDelasModerator`), então primeiro a
+ * pessoa sai da equipe e só depois pode perder a tag. Assim ninguém modera sem
+ * ter a tag, e o "também bloquear" nunca tenta bloquear quem modera.
*
* Com `$alsoBlock`, a pessoa também é bloqueada de pedir de novo, com o mesmo
* motivo e na mesma transação: ou as duas coisas acontecem, ou nenhuma.
@@ -46,10 +46,8 @@ public function handle(User $target, User $actor, ?string $reason, bool $alsoBlo
Gate::forUser($actor)->authorize('lead-delas');
throw_if($target->is($actor), DelasException::cannotDecideOwn());
- throw_if(
- $target->hasAnyRole([UserRole::DelasModerator, UserRole::DelasLead]),
- DelasException::teamMemberKeepsTag(),
- );
+ // Equipe é quem passa no `moderate-delas`: moderadora, líder ou super admin.
+ throw_if(Gate::forUser($target)->allows('moderate-delas'), DelasException::teamMemberKeepsTag());
$reason = Reason::required($reason);
diff --git a/app-modules/delas/src/Team/Queries/DelasCandidates.php b/app-modules/delas/src/Team/Queries/DelasCandidates.php
index 55b742f0c..c46ba59df 100644
--- a/app-modules/delas/src/Team/Queries/DelasCandidates.php
+++ b/app-modules/delas/src/Team/Queries/DelasCandidates.php
@@ -38,14 +38,14 @@ public function forGrant(User $actor): Builder
}
/**
- * Quem tem a tag hoje e não é da equipe: moderadoras e líderes saem da
- * equipe antes de perder a tag (`RevokeDelasTag`).
+ * Quem tem a tag hoje e não é da equipe: moderadoras, líderes e super
+ * admins saem da equipe antes de perder a tag (`RevokeDelasTag`).
*
* @return Builder
*/
public function forRevoke(User $actor): Builder
{
- $team = [UserRole::DelasModerator->value, UserRole::DelasLead->value];
+ $team = [UserRole::SuperAdmin->value, UserRole::DelasModerator->value, UserRole::DelasLead->value];
return $this->others($actor)
->whereIn('id', $this->members())
diff --git a/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php b/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php
index 52d3c3f24..8cd9d0e2f 100644
--- a/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php
+++ b/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php
@@ -167,19 +167,6 @@
->toEqualCanonicalizing([DelasAction::Revoked, DelasAction::Blocked]);
});
-test('se não der para bloquear, a tag também não é removida', function (): void {
- $lead = User::factory()->delasLead()->create();
- // Super admin passa no `moderate-delas` pelo Gate::before, então nunca pode ser bloqueado.
- $superAdminWithTag = User::factory()->superAdmin()->create();
- $approved = DelasTagRequest::factory()->for($superAdminWithTag)->approved()->create();
-
- expect(fn () => $this->revoke->handle($superAdminWithTag, $lead, 'Motivo.', alsoBlock: true))
- ->toThrow(DelasException::class, __('delas::exceptions.cannot_block_team'));
-
- expect($approved->fresh()->status)->toBe(DelasRequestStatus::Approved);
- expect(DelasTransition::query()->count())->toBe(0);
-});
-
test('quem já está bloqueada só perde a tag, sem segundo bloqueio', function (): void {
$lead = User::factory()->delasLead()->create();
$approved = DelasTagRequest::factory()->approved()->create();
@@ -202,7 +189,7 @@
->toThrow(DelasException::class, __('delas::exceptions.team_member_keeps_tag'));
expect($approved->fresh()->status)->toBe(DelasRequestStatus::Approved);
-})->with(['moderadora' => 'delasModerator', 'líder' => 'delasLead']);
+})->with(['moderadora' => 'delasModerator', 'líder' => 'delasLead', 'super admin' => 'superAdmin']);
test('depois de sair da moderação, a pessoa pode perder a tag', function (): void {
$lead = User::factory()->delasLead()->create();
diff --git a/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php b/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
index 3c7c738ad..4101cb092 100644
--- a/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
+++ b/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php
@@ -120,11 +120,12 @@ function delasGrantSearchIds(DelasCandidates $candidates, User $lead, string $te
$member = DelasTagRequest::factory()->approved()->create(['decided_by' => $this->lead->getKey()])->user;
$moderator = User::factory()->delasModerator()->create();
$otherLead = User::factory()->delasLead()->create();
- foreach ([$moderator, $otherLead] as $teamMember) {
+ $superAdmin = User::factory()->superAdmin()->create();
+ foreach ([$moderator, $otherLead, $superAdmin] as $teamMember) {
DelasTagRequest::factory()->for($teamMember)->approved()->create(['decided_by' => $this->lead->getKey()]);
}
$ids = $this->candidates->forRevoke($this->lead)->pluck('id')->all();
- expect($ids)->toContain($member->id)->not->toContain($moderator->id, $otherLead->id);
+ expect($ids)->toContain($member->id)->not->toContain($moderator->id, $otherLead->id, $superAdmin->id);
});
From cf0665a475851fbddd96d92a1b4061984f7e06fe Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Fri, 9 Oct 2026 10:08:05 -0300
Subject: [PATCH 71/77] =?UTF-8?q?fix(panel-admin):=20Remover=20tag=20desab?=
=?UTF-8?q?ilitado=20com=20dica=20para=20quem=20=C3=A9=20da=20equipe?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Em Membras o botão continua na linha, desabilitado, com a dica de tirar a
pessoa da equipe antes. Equipe usa a mesma definição do domínio: quem passa
no moderate-delas.
---
app-modules/panel-admin/lang/en/delas.php | 1 +
app-modules/panel-admin/lang/pt_BR/delas.php | 1 +
.../Actions/Delas/RevokeDelasTagAction.php | 12 ++++++++----
.../Moderation/Delas/DelasModerationPagesTest.php | 7 ++++---
4 files changed, 14 insertions(+), 7 deletions(-)
diff --git a/app-modules/panel-admin/lang/en/delas.php b/app-modules/panel-admin/lang/en/delas.php
index 172af4ab8..5d126e1b7 100644
--- a/app-modules/panel-admin/lang/en/delas.php
+++ b/app-modules/panel-admin/lang/en/delas.php
@@ -116,6 +116,7 @@
'revoke_body' => 'The record is kept. The person can request again after the cooldown.',
'revoke_reason' => 'Removal reason',
'revoked' => 'Tag removed',
+ 'revoke_team_disabled' => 'Team members keep the tag. Remove them from moderation first (Team → Revoke moderator).',
'revoke_member_heading' => 'Remove the tag from :name?',
'also_block' => 'Also block new requests',
'also_block_hint' => 'Uses the same reason. Only prevents new tag requests: it is not a ban and does not affect the account.',
diff --git a/app-modules/panel-admin/lang/pt_BR/delas.php b/app-modules/panel-admin/lang/pt_BR/delas.php
index 75f168609..45d050b06 100644
--- a/app-modules/panel-admin/lang/pt_BR/delas.php
+++ b/app-modules/panel-admin/lang/pt_BR/delas.php
@@ -116,6 +116,7 @@
'revoke_body' => 'O registro não é apagado. A pessoa poderá solicitar de novo depois da espera.',
'revoke_reason' => 'Motivo da remoção',
'revoked' => 'Tag removida',
+ 'revoke_team_disabled' => 'Quem é da equipe não perde a tag. Tire da moderação antes (Equipe → Revogar moderadora).',
'revoke_member_heading' => 'Remover a tag de :name?',
'also_block' => 'Também bloquear novos pedidos',
'also_block_hint' => 'Usa o mesmo motivo. Só impede novos pedidos da tag: não é banimento e não afeta a conta.',
diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php
index aae82dee2..fce2864b0 100644
--- a/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php
+++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php
@@ -11,7 +11,6 @@
use He4rt\Delas\TagRequest\Actions\RevokeDelasTag;
use He4rt\Delas\TagRequest\Models\DelasTagRequest;
use He4rt\Delas\Team\Queries\DelasCandidates;
-use He4rt\Identity\Authorization\Enums\UserRole;
use He4rt\Identity\User\Models\User;
use He4rt\PanelAdmin\Moderation\Actions\Delas\Concerns\InteractsWithDelasActions;
use He4rt\PanelAdmin\Moderation\Actions\Delas\Fields\DelasPersonSelect;
@@ -34,8 +33,12 @@ protected function setUp(): void
->icon(Heroicon::OutlinedMinusCircle)
->color('danger')
->outlined()
- // Na linha de Membras, quem é da equipe não tem o botão: sai da equipe antes.
- ->visible(fn (?DelasTagRequest $record): bool => $this->isLead() && !$this->isTeamMember($record?->user))
+ ->visible(fn (): bool => $this->isLead())
+ // Na linha de Membras, quem é da equipe tem o botão desabilitado: sai da equipe antes.
+ ->disabled(fn (?DelasTagRequest $record): bool => $this->isTeamMember($record?->user))
+ ->tooltip(fn (?DelasTagRequest $record): ?string => $this->isTeamMember($record?->user)
+ ? $this->text('panel-admin::delas.actions.revoke_team_disabled')
+ : null)
->modalHeading(fn (?DelasTagRequest $record): string => $record instanceof DelasTagRequest
? $this->text('panel-admin::delas.actions.revoke_member_heading', ['name' => $record->user->name])
: $this->text('panel-admin::delas.actions.revoke_heading'))
@@ -71,7 +74,8 @@ public static function getDefaultName(): string
private function isTeamMember(?User $person): bool
{
- return $person?->hasAnyRole([UserRole::DelasModerator, UserRole::DelasLead]) ?? false;
+ // Mesma definição da action de domínio: equipe é quem passa no `moderate-delas`.
+ return $person instanceof User && $person->can('moderate-delas');
}
private function memberSelect(): Select
diff --git a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
index bb816e0ce..608aa6e56 100644
--- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
+++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
@@ -709,7 +709,7 @@ function delasHistoryEntry(DelasAction $action, string $reason, ?User $actor = n
->assertMountedActionModalSee([$moderator->name, __('panel-admin::delas.profile.empty')]);
});
-test('em Membras, a linha de quem é da equipe não tem "Remover tag"', function (): void {
+test('em Membras, a linha de quem é da equipe tem "Remover tag" desabilitado, com a dica', function (): void {
$lead = actingAsDelasLead();
$moderator = User::factory()->delasModerator()->create();
$moderatorRequest = DelasTagRequest::factory()->for($moderator)->approved()->create(['decided_by' => $lead->getKey()]);
@@ -717,6 +717,7 @@ function delasHistoryEntry(DelasAction $action, string $reason, ?User $actor = n
livewire(DelasMembersPage::class)
->loadTable()
- ->assertActionHidden(TestAction::make('revoke')->table($moderatorRequest))
- ->assertActionVisible(TestAction::make('revoke')->table($memberRequest));
+ ->assertActionDisabled(TestAction::make('revoke')->table($moderatorRequest))
+ ->assertSee(__('panel-admin::delas.actions.revoke_team_disabled'))
+ ->assertActionEnabled(TestAction::make('revoke')->table($memberRequest));
});
From 62b3783510415c7e470e625e6b8705ff0655a92c Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Fri, 9 Oct 2026 10:08:13 -0300
Subject: [PATCH 72/77] docs(delas): super admin na equipe e Remover tag
desabilitado em Membras
---
.../adr/0001-modulo-proprio-com-papel-e-historico.md | 3 ++-
docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md | 12 +++++++-----
2 files changed, 9 insertions(+), 6 deletions(-)
diff --git a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
index ba3961294..ce2bdcda5 100644
--- a/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
+++ b/app-modules/delas/docs/adr/0001-modulo-proprio-com-papel-e-historico.md
@@ -91,7 +91,8 @@ precisa morar em algum lugar e ter uma forma de autorizar quem decide.
lembrete no pop-up.
- **Moderadora precisa ter a tag, e quem é da equipe não perde a tag.** Quem modera a He4rt
Delas faz parte dela: para promover alguém de fora, a líder concede a tag antes; para tirar a
- tag de uma moderadora, revoga o papel antes. `RevokeDelasTag` recusa moderadoras e líderes.
+ tag de uma moderadora, revoga o papel antes. `RevokeDelasTag` recusa quem passa no
+ `moderate-delas`: moderadoras, líderes e super admins.
- _Alternativa descartada:_ tirar da moderação junto ao remover a tag. Ficaria num passo só,
mas uma ação de tag passaria a mexer na equipe por um caminho indireto.
- **Bloquear não tira a tag.** Tirar a tag é da líder, com motivo próprio ("Remover tag", com a
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index db8627f55..475254ebc 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -125,11 +125,13 @@ que a moderadora tem, mais:
- na Equipe, adiciona e revoga `delas-moderator`. Só quem tem a tag vira moderadora: para
promover alguém de fora, a líder concede a tag antes. Não cria nem revoga líderes, e não age
sobre super admins;
-- **quem é da equipe não perde a tag.** Para tirar a tag de uma moderadora, a líder primeiro
- revoga o papel (Equipe → "Revogar moderadora") e só depois remove a tag. Líderes saem da
- equipe pelo super admin, no cadastro de usuários. Por isso o "Remover tag" não aparece na
- linha de quem é da equipe em Membras, e moderadoras e líderes não aparecem no seletor da
- Equipe. A regra também vale no domínio (`RevokeDelasTag` recusa).
+- **quem é da equipe não perde a tag.** Equipe é quem passa no `moderate-delas`: moderadora,
+ líder ou super admin. Para tirar a tag de uma moderadora, a líder primeiro revoga o papel
+ (Equipe → "Revogar moderadora") e só depois remove a tag. Líderes e super admins saem da
+ equipe pelo super admin, no cadastro de usuários. Por isso, em Membras, o "Remover tag" fica
+ desabilitado na linha de quem é da equipe, com a dica de como tirar da equipe antes; e quem é
+ da equipe não aparece no seletor da Equipe. A regra também vale no domínio (`RevokeDelasTag`
+ recusa).
- _Por quê:_ é o espelho de "moderadora precisa ter a tag". Sem isso, uma moderadora sem a tag
continuaria moderando. E, como quem é da equipe nunca pode ser bloqueada, o "Também
bloquear" nunca aparece para quem falharia;
From eb78c5c45e1c6b014f5ada3c60e14cdf80e99cfc Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Fri, 9 Oct 2026 10:08:36 -0300
Subject: [PATCH 73/77] =?UTF-8?q?feat(panel-admin):=20tempo=20m=C3=A9dio?=
=?UTF-8?q?=20at=C3=A9=20a=20decis=C3=A3o=20em=20minutos=20abaixo=20de=201?=
=?UTF-8?q?=20hora?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
"0 h" dava a impressão de que nenhuma decisão tinha sido tomada.
---
app-modules/panel-admin/lang/en/delas.php | 1 +
app-modules/panel-admin/lang/pt_BR/delas.php | 1 +
.../Moderation/Widgets/Delas/DelasStatsOverview.php | 2 ++
.../Moderation/Delas/DelasModerationPagesTest.php | 13 +++++++++++++
4 files changed, 17 insertions(+)
diff --git a/app-modules/panel-admin/lang/en/delas.php b/app-modules/panel-admin/lang/en/delas.php
index 5d126e1b7..2baf62771 100644
--- a/app-modules/panel-admin/lang/en/delas.php
+++ b/app-modules/panel-admin/lang/en/delas.php
@@ -158,6 +158,7 @@
'month' => 'Decisions this month',
'month_desc' => 'approved / rejected',
'blocks' => 'Active blocks',
+ 'minutes' => ':value min',
'days' => ':value days',
'blocks_desc' => 'only prevent new requests',
],
diff --git a/app-modules/panel-admin/lang/pt_BR/delas.php b/app-modules/panel-admin/lang/pt_BR/delas.php
index 45d050b06..e3e62665f 100644
--- a/app-modules/panel-admin/lang/pt_BR/delas.php
+++ b/app-modules/panel-admin/lang/pt_BR/delas.php
@@ -158,6 +158,7 @@
'month' => 'Decisões no mês',
'month_desc' => 'aprovadas / rejeitadas',
'blocks' => 'Bloqueios ativos',
+ 'minutes' => ':value min',
'days' => ':value dias',
'blocks_desc' => 'só impedem novos pedidos',
],
diff --git a/app-modules/panel-admin/src/Moderation/Widgets/Delas/DelasStatsOverview.php b/app-modules/panel-admin/src/Moderation/Widgets/Delas/DelasStatsOverview.php
index ef11eae51..10e4096e8 100644
--- a/app-modules/panel-admin/src/Moderation/Widgets/Delas/DelasStatsOverview.php
+++ b/app-modules/panel-admin/src/Moderation/Widgets/Delas/DelasStatsOverview.php
@@ -60,6 +60,8 @@ private function formatHours(?float $hours): string
{
return match (true) {
$hours === null => '—',
+ // Abaixo de 1 hora, em minutos: "0 h" parece que não houve decisão.
+ $hours < 1 => __('panel-admin::delas.stats.minutes', ['value' => round($hours * 60)]),
$hours < 48 => round($hours).' h',
default => __('panel-admin::delas.stats.days', ['value' => number_format($hours / 24, 1, ',', '.')]),
};
diff --git a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
index 608aa6e56..da48b225c 100644
--- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
+++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php
@@ -498,6 +498,19 @@ function delasHistoryEntry(DelasAction $action, string $reason, ?User $actor = n
->assertCanSeeTableRecords($moderators);
});
+test('o tempo médio abaixo de 1 hora aparece em minutos', function (): void {
+ actingAsDelasLead();
+ $request = DelasTagRequest::factory()->approved()->create(['requested_at' => now()->subMinutes(20)]);
+ DelasTransition::factory()->for($request->user)->create([
+ 'request_id' => $request->getKey(),
+ 'action' => DelasAction::Approved,
+ ]);
+
+ livewire(DelasStatsOverview::class)
+ ->assertSee(__('panel-admin::delas.stats.minutes', ['value' => 20]))
+ ->assertDontSee('0 h');
+});
+
test('líder concede a tag direto pela Equipe', function (): void {
actingAsDelasLead();
$target = User::factory()->create();
From ebb60d0f1703d97f4f92345b5211d0821ff33639 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 15 Oct 2026 16:57:07 -0300
Subject: [PATCH 74/77] =?UTF-8?q?fix(delas):=20decis=C3=B5es=20sobre=20a?=
=?UTF-8?q?=20mesma=20pessoa=20esperam=20a=20vez?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Toda action que muda a situação de alguém trava a pessoa no início da
transação (PersonLock) e só depois verifica a situação dela. Fecha as
corridas apontadas na revisão: conceder enquanto alguém bloqueia, bloquear
enquanto alguém aprova, e pedir e conceder ao mesmo tempo (antes, erro 500).
Fecha também tirar a tag enquanto a pessoa vira moderadora, pedir enquanto
é bloqueada e revogar a mesma moderadora duas vezes.
---
.../src/Block/Actions/BlockDelasRequester.php | 23 +++++++++-----
app-modules/delas/src/Support/PersonLock.php | 26 ++++++++++++++++
.../src/TagRequest/Actions/GrantDelasTag.php | 13 ++++++--
.../TagRequest/Actions/RequestDelasTag.php | 31 +++++++++++++------
.../src/TagRequest/Actions/RevokeDelasTag.php | 8 +++--
.../src/Team/Actions/AddDelasModerator.php | 17 +++++-----
.../src/Team/Actions/RemoveDelasModerator.php | 15 +++++----
7 files changed, 98 insertions(+), 35 deletions(-)
create mode 100644 app-modules/delas/src/Support/PersonLock.php
diff --git a/app-modules/delas/src/Block/Actions/BlockDelasRequester.php b/app-modules/delas/src/Block/Actions/BlockDelasRequester.php
index 4c5494d77..ea4053541 100644
--- a/app-modules/delas/src/Block/Actions/BlockDelasRequester.php
+++ b/app-modules/delas/src/Block/Actions/BlockDelasRequester.php
@@ -9,6 +9,7 @@
use He4rt\Delas\Exceptions\DelasException;
use He4rt\Delas\History\Actions\RecordDelasTransition;
use He4rt\Delas\History\Enums\DelasAction;
+use He4rt\Delas\Support\PersonLock;
use He4rt\Delas\Support\Reason;
use He4rt\Delas\TagRequest\Actions\RejectDelasRequest;
use He4rt\Delas\TagRequest\Events\DelasTagRejected;
@@ -40,15 +41,23 @@ public function handle(User $target, User $actor, ?string $reason): DelasRequest
$reason = Reason::required($reason);
- // Ninguém da equipe (nem super admin) é bloqueado, nem a si mesma.
- throw_if(
- $target->is($actor) || Gate::forUser($target)->allows('moderate-delas'),
- DelasException::cannotBlockTeam(),
- );
-
try {
[$block, $rejected] = DB::transaction(function () use ($target, $actor, $reason): array {
- $pending = DelasTagRequest::query()->where('user_id', $target->getKey())->pending()->first();
+ PersonLock::acquire($target);
+
+ // Ninguém da equipe (nem super admin) é bloqueado, nem a si mesma.
+ throw_if(
+ $target->is($actor) || Gate::forUser($target)->allows('moderate-delas'),
+ DelasException::cannotBlockTeam(),
+ );
+
+ // Travado: se o pedido for aprovado ao mesmo tempo, o Postgres espera e
+ // relê a linha. Já aprovado, ele não volta, e o bloqueio segue sem rejeitar nada.
+ $pending = DelasTagRequest::query()
+ ->where('user_id', $target->getKey())
+ ->pending()
+ ->lockForUpdate()
+ ->first();
$rejected = $pending instanceof DelasTagRequest
? $this->rejectRequest->rejectInTransaction($pending, $actor, $reason)
: null;
diff --git a/app-modules/delas/src/Support/PersonLock.php b/app-modules/delas/src/Support/PersonLock.php
new file mode 100644
index 000000000..32fda028e
--- /dev/null
+++ b/app-modules/delas/src/Support/PersonLock.php
@@ -0,0 +1,26 @@
+whereKey($person->getKey())->lockForUpdate()->first();
+
+ // Os papéis carregados antes da trava podem estar velhos.
+ $person->unsetRelation('roles');
+ }
+}
diff --git a/app-modules/delas/src/TagRequest/Actions/GrantDelasTag.php b/app-modules/delas/src/TagRequest/Actions/GrantDelasTag.php
index 09f97bab2..3e0d546f3 100644
--- a/app-modules/delas/src/TagRequest/Actions/GrantDelasTag.php
+++ b/app-modules/delas/src/TagRequest/Actions/GrantDelasTag.php
@@ -10,6 +10,7 @@
use He4rt\Delas\Exceptions\DelasException;
use He4rt\Delas\History\Actions\RecordDelasTransition;
use He4rt\Delas\History\Enums\DelasAction;
+use He4rt\Delas\Support\PersonLock;
use He4rt\Delas\Support\Reason;
use He4rt\Delas\TagRequest\Enums\DelasRequestStatus;
use He4rt\Delas\TagRequest\Events\DelasTagGranted;
@@ -43,10 +44,16 @@ public function handle(User $target, User $actor, ?string $reason = null): Delas
throw_if($target->is($actor), DelasException::cannotDecideOwn());
- $activeBlock = DelasRequesterBlock::query()->where('user_id', $target->getKey())->active()->first();
- $reason = $activeBlock instanceof DelasRequesterBlock ? Reason::required($reason) : Reason::optional($reason);
+ [$request, $liftedBlock] = DB::transaction(function () use ($target, $actor, $reason): array {
+ PersonLock::acquire($target);
+
+ $activeBlock = DelasRequesterBlock::query()
+ ->where('user_id', $target->getKey())
+ ->active()
+ ->lockForUpdate()
+ ->first();
+ $reason = $activeBlock instanceof DelasRequesterBlock ? Reason::required($reason) : Reason::optional($reason);
- [$request, $liftedBlock] = DB::transaction(function () use ($target, $actor, $reason, $activeBlock): array {
$current = DelasTagRequest::query()
->where('user_id', $target->getKey())
->active()
diff --git a/app-modules/delas/src/TagRequest/Actions/RequestDelasTag.php b/app-modules/delas/src/TagRequest/Actions/RequestDelasTag.php
index 8707e8d13..d93908588 100644
--- a/app-modules/delas/src/TagRequest/Actions/RequestDelasTag.php
+++ b/app-modules/delas/src/TagRequest/Actions/RequestDelasTag.php
@@ -7,6 +7,7 @@
use He4rt\Delas\Exceptions\DelasException;
use He4rt\Delas\History\Actions\RecordDelasTransition;
use He4rt\Delas\History\Enums\DelasAction;
+use He4rt\Delas\Support\PersonLock;
use He4rt\Delas\TagRequest\Enums\DelasEligibilityState;
use He4rt\Delas\TagRequest\Enums\DelasRequestStatus;
use He4rt\Delas\TagRequest\Events\DelasTagRequested;
@@ -31,18 +32,12 @@ public function __construct(
*/
public function handle(User $user): DelasTagRequest
{
- $eligibility = $this->eligibility->for($user);
-
- match ($eligibility->state) {
- DelasEligibilityState::Pending, DelasEligibilityState::Member => throw DelasException::alreadyHasActiveRequest(),
- DelasEligibilityState::Blocked => throw DelasException::blocked(),
- DelasEligibilityState::Cooldown => throw DelasException::inCooldown($eligibility->nextAllowedAt ?? now()),
- DelasEligibilityState::DiscordRequired => throw DelasException::discordRequired(),
- DelasEligibilityState::CanRequest => null,
- };
-
try {
$request = DB::transaction(function () use ($user): DelasTagRequest {
+ PersonLock::acquire($user);
+
+ $this->ensureCanRequest($user);
+
$request = DelasTagRequest::query()->create([
'user_id' => $user->getKey(),
'status' => DelasRequestStatus::Pending,
@@ -68,4 +63,20 @@ public function handle(User $user): DelasTagRequest
return $request;
}
+
+ /**
+ * @throws DelasException
+ */
+ private function ensureCanRequest(User $user): void
+ {
+ $eligibility = $this->eligibility->for($user);
+
+ match ($eligibility->state) {
+ DelasEligibilityState::Pending, DelasEligibilityState::Member => throw DelasException::alreadyHasActiveRequest(),
+ DelasEligibilityState::Blocked => throw DelasException::blocked(),
+ DelasEligibilityState::Cooldown => throw DelasException::inCooldown($eligibility->nextAllowedAt ?? now()),
+ DelasEligibilityState::DiscordRequired => throw DelasException::discordRequired(),
+ DelasEligibilityState::CanRequest => null,
+ };
+ }
}
diff --git a/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php b/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
index b38fd40f9..b2304fda8 100644
--- a/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
+++ b/app-modules/delas/src/TagRequest/Actions/RevokeDelasTag.php
@@ -8,6 +8,7 @@
use He4rt\Delas\Exceptions\DelasException;
use He4rt\Delas\History\Actions\RecordDelasTransition;
use He4rt\Delas\History\Enums\DelasAction;
+use He4rt\Delas\Support\PersonLock;
use He4rt\Delas\Support\Reason;
use He4rt\Delas\TagRequest\Enums\DelasRequestStatus;
use He4rt\Delas\TagRequest\Events\DelasTagRevoked;
@@ -46,12 +47,15 @@ public function handle(User $target, User $actor, ?string $reason, bool $alsoBlo
Gate::forUser($actor)->authorize('lead-delas');
throw_if($target->is($actor), DelasException::cannotDecideOwn());
- // Equipe é quem passa no `moderate-delas`: moderadora, líder ou super admin.
- throw_if(Gate::forUser($target)->allows('moderate-delas'), DelasException::teamMemberKeepsTag());
$reason = Reason::required($reason);
return DB::transaction(function () use ($target, $actor, $reason, $alsoBlock): DelasTagRequest {
+ PersonLock::acquire($target);
+
+ // Equipe é quem passa no `moderate-delas`: moderadora, líder ou super admin.
+ throw_if(Gate::forUser($target)->allows('moderate-delas'), DelasException::teamMemberKeepsTag());
+
$approved = DelasTagRequest::query()
->where('user_id', $target->getKey())
->where('status', DelasRequestStatus::Approved)
diff --git a/app-modules/delas/src/Team/Actions/AddDelasModerator.php b/app-modules/delas/src/Team/Actions/AddDelasModerator.php
index 039bd24fc..df20b551c 100644
--- a/app-modules/delas/src/Team/Actions/AddDelasModerator.php
+++ b/app-modules/delas/src/Team/Actions/AddDelasModerator.php
@@ -7,6 +7,7 @@
use He4rt\Delas\Exceptions\DelasException;
use He4rt\Delas\History\Actions\RecordDelasTransition;
use He4rt\Delas\History\Enums\DelasAction;
+use He4rt\Delas\Support\PersonLock;
use He4rt\Delas\TagRequest\Queries\DelasEligibility;
use He4rt\Identity\Authorization\Enums\UserRole;
use He4rt\Identity\User\Models\User;
@@ -34,14 +35,16 @@ public function handle(User $target, User $actor): User
{
Gate::forUser($actor)->authorize('lead-delas');
- throw_if(
- $target->isSuperAdmin() || $target->hasRole(UserRole::DelasLead),
- DelasException::cannotManageRole(),
- );
- throw_if($target->hasRole(UserRole::DelasModerator), DelasException::alreadyModerator());
- throw_unless($this->eligibility->hasTag($target), DelasException::moderatorNeedsTag());
-
DB::transaction(function () use ($target, $actor): void {
+ PersonLock::acquire($target);
+
+ throw_if(
+ $target->isSuperAdmin() || $target->hasRole(UserRole::DelasLead),
+ DelasException::cannotManageRole(),
+ );
+ throw_if($target->hasRole(UserRole::DelasModerator), DelasException::alreadyModerator());
+ throw_unless($this->eligibility->hasTag($target), DelasException::moderatorNeedsTag());
+
$target->assignRole(UserRole::DelasModerator);
$this->recordTransition->handle(
diff --git a/app-modules/delas/src/Team/Actions/RemoveDelasModerator.php b/app-modules/delas/src/Team/Actions/RemoveDelasModerator.php
index 61039a8e9..67a00f164 100644
--- a/app-modules/delas/src/Team/Actions/RemoveDelasModerator.php
+++ b/app-modules/delas/src/Team/Actions/RemoveDelasModerator.php
@@ -7,6 +7,7 @@
use He4rt\Delas\Exceptions\DelasException;
use He4rt\Delas\History\Actions\RecordDelasTransition;
use He4rt\Delas\History\Enums\DelasAction;
+use He4rt\Delas\Support\PersonLock;
use He4rt\Identity\Authorization\Enums\UserRole;
use He4rt\Identity\User\Models\User;
use Illuminate\Auth\Access\AuthorizationException;
@@ -31,13 +32,15 @@ public function handle(User $target, User $actor): User
{
Gate::forUser($actor)->authorize('lead-delas');
- throw_if(
- $target->isSuperAdmin() || $target->hasRole(UserRole::DelasLead),
- DelasException::cannotManageRole(),
- );
- throw_unless($target->hasRole(UserRole::DelasModerator), DelasException::notModerator());
-
DB::transaction(function () use ($target, $actor): void {
+ PersonLock::acquire($target);
+
+ throw_if(
+ $target->isSuperAdmin() || $target->hasRole(UserRole::DelasLead),
+ DelasException::cannotManageRole(),
+ );
+ throw_unless($target->hasRole(UserRole::DelasModerator), DelasException::notModerator());
+
$target->removeRole(UserRole::DelasModerator);
$this->recordTransition->handle(
From ec966f1c4c3a8c49a3382d7366c5b1a38d0165b7 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Thu, 15 Oct 2026 16:57:37 -0300
Subject: [PATCH 75/77] =?UTF-8?q?docs(delas):=20trava=20da=20pessoa=20nas?=
=?UTF-8?q?=20decis=C3=B5es,=20na=20spec?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md | 6 ++++++
1 file changed, 6 insertions(+)
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index 475254ebc..4c9b7dddd 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -356,6 +356,12 @@ Sem coluna `metadata`: nenhum fluxo a preenche, e um jsonb sem forma quebraria o
`ReviewAppeal`). As que mudam estado rodam em `DB::transaction` com `lockForUpdate()` e gravam
a linha de histórico.
+As que mudam a situação de uma pessoa (pedir, conceder, bloquear, remover a tag, adicionar e
+revogar moderadora) começam a transação travando a pessoa (`PersonLock`) e só depois
+verificam a situação dela. Assim, duas decisões sobre a mesma pessoa esperam a vez uma da
+outra, e nenhuma decide com uma leitura velha: por exemplo, conceder a tag enquanto alguém
+bloqueia, ou tirar a tag enquanto alguém adiciona a pessoa como moderadora.
+
| Action | Gate do ator | Faz |
| -------------------------------------------- | -------------------------------------------------- | -------------------------------------------------------------------------------------- |
| `RequestDelasTag` | (própria pessoa) | valida ativa, espera e bloqueio; cria `pending` |
From b130c1b7b3c3395330264b638274759d7b617042 Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Tue, 20 Oct 2026 14:16:15 -0300
Subject: [PATCH 76/77] =?UTF-8?q?fix(panel-admin):=20moderadora=20He4rt=20?=
=?UTF-8?q?Delas=20s=C3=B3=20pela=20Equipe,=20n=C3=A3o=20pelo=20cadastro?=
=?UTF-8?q?=20de=20usu=C3=A1rios?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
No formulário de usuário, a opção fica desabilitada com a dica de gerenciar
pela Equipe, e o papel fica como está ao salvar. Antes, dava para tornar
moderadora alguém sem a tag, sem passar pela AddDelasModerator e sem
registro no histórico. Promover a líder continua possível.
---
.../Resources/Users/Schemas/UserForm.php | 43 +++++++++++++++++-
.../Feature/Identity/UserResourceTest.php | 44 ++++++++++++++-----
2 files changed, 75 insertions(+), 12 deletions(-)
diff --git a/app-modules/panel-admin/src/Filament/Resources/Users/Schemas/UserForm.php b/app-modules/panel-admin/src/Filament/Resources/Users/Schemas/UserForm.php
index a7c6fb05d..397c3a2f0 100644
--- a/app-modules/panel-admin/src/Filament/Resources/Users/Schemas/UserForm.php
+++ b/app-modules/panel-admin/src/Filament/Resources/Users/Schemas/UserForm.php
@@ -64,7 +64,7 @@ public static function configure(Schema $schema): Schema
->relationship('roles', 'name')
->getOptionLabelFromRecordUsing(fn (Role $record): string => UserRole::from($record->name)->getLabel())
->descriptions(self::roleDescriptions(...))
- ->disableOptionWhen(self::isOwnSuperAdminOption(...))
+ ->disableOptionWhen(fn (int|string $value, ?User $record): bool => self::isOwnSuperAdminOption($value, $record) || self::isModeratorOption($value))
->in(fn (CheckboxList $component): array => array_keys($component->getOptions()))
->live()
->afterStateUpdated(fn (mixed $state, mixed $old, Set $set) => $set('roles', self::keepOneDelasRole($state, $old)))
@@ -73,6 +73,8 @@ public static function configure(Schema $schema): Schema
$component->state(self::keepOwnSuperAdmin($component->getState(), $record));
}
+ $component->state(self::keepModeratorAsIs($component->getState(), $record));
+
$roleIds = array_map(intval(...), self::keepOneDelasRole($component->getState(), old: null));
DB::transaction(fn (): ?User => $record?->syncRoles($roleIds));
@@ -114,6 +116,41 @@ private static function keepOwnSuperAdmin(mixed $state, User $record): array
return [...$otherRoleKeys, $superAdminKey];
}
+ /**
+ * Moderadora He4rt Delas só se ganha e se perde pela Equipe da He4rt Delas
+ * (`AddDelasModerator` e `RemoveDelasModerator`), que conferem a tag e gravam o
+ * histórico. Aqui a opção fica desabilitada e só aparece.
+ */
+ private static function isModeratorOption(int|string $value): bool
+ {
+ return (string) $value === self::roleKey(UserRole::DelasModerator);
+ }
+
+ /**
+ * O form não dá nem tira o papel de moderadora: ele fica como está no banco.
+ * Promover a líder continua possível, porque `keepOneDelasRole()` troca o papel.
+ *
+ * @return array
+ */
+ private static function keepModeratorAsIs(mixed $state, ?User $record): array
+ {
+ $moderatorKey = self::roleKey(UserRole::DelasModerator);
+
+ /** @var array $submittedKeys */
+ $submittedKeys = is_array($state) ? $state : [];
+
+ $otherRoleKeys = array_values(array_filter(
+ array_map(strval(...), $submittedKeys),
+ fn (string $key): bool => $key !== $moderatorKey,
+ ));
+
+ if ($moderatorKey === null || !$record?->hasRole(UserRole::DelasModerator)) {
+ return $otherRoleKeys;
+ }
+
+ return [...$otherRoleKeys, $moderatorKey];
+ }
+
private static function superAdminRoleKey(): ?string
{
$key = Role::query()
@@ -132,7 +169,9 @@ private static function roleDescriptions(): array
return Role::query()
->where('guard_name', UserRole::GUARD)
->get()
- ->mapWithKeys(fn (Role $role): array => [(int) $role->getKey() => UserRole::from($role->name)->getDescription()])
+ ->mapWithKeys(fn (Role $role): array => [(int) $role->getKey() => $role->name === UserRole::DelasModerator->value
+ ? 'Gerencie pela Equipe da He4rt Delas.'
+ : UserRole::from($role->name)->getDescription()])
->all();
}
diff --git a/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php b/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php
index da32bbb9f..379e7731c 100644
--- a/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php
+++ b/app-modules/panel-admin/tests/Feature/Identity/UserResourceTest.php
@@ -316,26 +316,50 @@
->and($role->exists)->toBeTrue();
});
-test('salvar o form concede um papel da He4rt Delas a outro usuário', function (UserRole $role): void {
+test('salvar o form concede líder da He4rt Delas a outro usuário', function (): void {
$other = User::factory()->create();
livewire(EditUser::class, ['record' => $other->getKey()])
- ->fillForm(['roles' => [Role::findByName($role->value, UserRole::GUARD)->getKey()]])
+ ->fillForm(['roles' => [Role::findByName(UserRole::DelasLead->value, UserRole::GUARD)->getKey()]])
->call('save')
->assertHasNoFormErrors();
- expect($other->fresh()->hasRole($role))->toBeTrue();
-})->with([UserRole::DelasModerator, UserRole::DelasLead]);
+ expect($other->fresh()->hasRole(UserRole::DelasLead))->toBeTrue();
+});
-test('marcar moderadora desmarca líder da He4rt Delas', function (): void {
+test('moderadora fica desabilitada no form, com a dica de gerenciar pela Equipe', function (): void {
+ $other = User::factory()->create();
+ $moderator = Role::findByName(UserRole::DelasModerator->value, UserRole::GUARD);
+
+ livewire(EditUser::class, ['record' => $other->getKey()])
+ ->assertSchemaComponentExists('roles', checkComponentUsing: fn (CheckboxList $field): bool => $field->isOptionDisabled((string) $moderator->getKey(), $moderator->name))
+ ->assertSee('Gerencie pela Equipe da He4rt Delas.');
+});
+
+test('o form não concede moderadora, nem forçando o estado', function (): void {
+ // Sem a tag: pela Equipe, a `AddDelasModerator` recusaria.
$other = User::factory()->create();
- $lead = (string) Role::findByName(UserRole::DelasLead->value, UserRole::GUARD)->getKey();
- $moderator = (string) Role::findByName(UserRole::DelasModerator->value, UserRole::GUARD)->getKey();
livewire(EditUser::class, ['record' => $other->getKey()])
- ->fillForm(['roles' => [$lead]])
- ->fillForm(['roles' => [$lead, $moderator]])
- ->assertSchemaStateSet(['roles' => [$moderator]]);
+ ->set('data.roles', [Role::findByName(UserRole::DelasModerator->value, UserRole::GUARD)->getKey()])
+ ->call('save')
+ ->assertHasNoFormErrors();
+
+ expect($other->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse();
+});
+
+test('salvar o form não tira o papel de quem já é moderadora', function (): void {
+ $moderator = User::factory()->delasModerator()->create();
+ $streamer = Role::findByName(UserRole::Streamer->value, UserRole::GUARD);
+
+ livewire(EditUser::class, ['record' => $moderator->getKey()])
+ ->set('data.roles', [$streamer->getKey()])
+ ->call('save')
+ ->assertHasNoFormErrors();
+
+ expect($moderator->fresh())
+ ->hasRole(UserRole::DelasModerator)->toBeTrue()
+ ->hasRole(UserRole::Streamer)->toBeTrue();
});
test('marcar líder desmarca moderadora da He4rt Delas', function (): void {
From 724400979ccd9f24c4807dd83d4f17b6c37c66df Mon Sep 17 00:00:00 2001
From: Danielle Costa
Date: Tue, 20 Oct 2026 14:16:32 -0300
Subject: [PATCH 77/77] =?UTF-8?q?docs(delas):=20moderadora=20gerenciada=20?=
=?UTF-8?q?s=C3=B3=20pela=20Equipe,=20na=20spec?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
---
.../2026-10-06-he4rt-delas-tag-e-moderacao.md | 18 +++++++++++++-----
1 file changed, 13 insertions(+), 5 deletions(-)
diff --git a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
index 4c9b7dddd..46e17d970 100644
--- a/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
+++ b/docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md
@@ -154,9 +154,16 @@ que a moderadora tem, mais:
### Administração (super admins)
-- Atribuem e retiram `delas-lead` e `delas-moderator` pela seção Papéis do formulário de usuário
- (`UserForm`), que já existe. O acesso some na próxima requisição, porque `hasRole` lê
- `model_has_roles` a cada request.
+- Atribuem e retiram `delas-lead` pela seção Papéis do formulário de usuário (`UserForm`), que
+ já existe. O acesso some na próxima requisição, porque `hasRole` lê `model_has_roles` a cada
+ request.
+- `delas-moderator` só se ganha e se perde pela Equipe da He4rt Delas (`AddDelasModerator` e
+ `RemoveDelasModerator`), que conferem a tag e gravam o histórico. No `UserForm`, a opção
+ aparece desabilitada, com a dica "Gerencie pela Equipe da He4rt Delas", e o papel fica como
+ está ao salvar. Promover uma moderadora a líder pelo `UserForm` continua possível: líder e
+ moderadora são exclusivas, e marcar líder troca o papel.
+ - _Por quê:_ pelo `UserForm`, alguém sem a tag virava moderadora sem passar pela regra da
+ Equipe e sem registro no histórico.
- Passam em todos os gates (via `Gate::before`) e veem as páginas da He4rt Delas como uma
líder.
@@ -420,8 +427,9 @@ dispara também `DelasRequesterUnblocked`. Nenhum listener nesta entrega.
- Cada tabela declara o eager load (`user.roles` na fila, `user` e `blocker` nos bloqueios,
`user`, `actor` e `corrections.actor` no histórico, `user` e `decider` na Membras, `roles` na
equipe).
-- A seção Papéis do `UserForm`, onde super admins atribuem `delas-lead` e `delas-moderator`,
- visível só para super admins; a tabela de Usuários só **mostra** as roles (badges).
+- A seção Papéis do `UserForm`, onde super admins atribuem `delas-lead` (`delas-moderator`
+ aparece desabilitada: é gerenciada pela Equipe), visível só para super admins; a tabela de
+ Usuários só **mostra** as roles (badges).
### Identidade visual