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 + +
class(['flex items-start gap-3 rounded-lg border p-4', $classes[0]]) }}> + +
+ @isset($title) +

{{ $title }}

+ @endisset + + @if (trim($slot) !== '') +
{{ $slot }}
+ @endif +
+
diff --git a/app-modules/panel-app/resources/views/components/delas/logo.blade.php b/app-modules/panel-app/resources/views/components/delas/logo.blade.php new file mode 100644 index 000000000..1c7007760 --- /dev/null +++ b/app-modules/panel-app/resources/views/components/delas/logo.blade.php @@ -0,0 +1,33 @@ +@props(['variant' => 'icon', 'label' => null]) + +{{-- Logo oficial da He4rt Delas. A cor vem de `currentColor`: use `text-delas-500` (ou branco sobre fundo rosa). --}} +@php + $viewBox = match ($variant) { + 'horizontal' => '0 0 249 63', + 'vertical' => '0 0 181 63', + default => '0 0 66 58', + }; +@endphp + +class(['shrink-0']) }} + viewBox="{{ $viewBox }}" + fill="none" + xmlns="http://www.w3.org/2000/svg" + @if ($label) role="img" aria-label="{{ $label }}" @else aria-hidden="true" focusable="false" @endif +> + @if ($variant === 'horizontal') + + + + + @elseif ($variant === 'vertical') + + + + + @else + + + @endif + diff --git a/app-modules/panel-app/resources/views/components/delas/tag.blade.php b/app-modules/panel-app/resources/views/components/delas/tag.blade.php new file mode 100644 index 000000000..efb5d6b13 --- /dev/null +++ b/app-modules/panel-app/resources/views/components/delas/tag.blade.php @@ -0,0 +1,15 @@ +@props(['size' => 'sm']) + +{{-- Tag He4rt Delas: rosa claro com texto e ícone no tom 900 (contraste 4,81:1). --}} +class([ + 'bg-delas-primary text-delas-900 inline-flex items-center gap-1 rounded-full font-bold shadow-sm', + 'px-3 py-1 text-sm' => $size === 'lg', + 'px-2.5 py-0.5 text-xs' => $size !== 'lg', + ]) + }} +> + $size === 'lg', 'h-3' => $size !== 'lg']) /> + He4rt Delas + diff --git a/app-modules/panel-app/resources/views/components/profile-preview-card.blade.php b/app-modules/panel-app/resources/views/components/profile-preview-card.blade.php index d6fbca06f..01aec310b 100644 --- a/app-modules/panel-app/resources/views/components/profile-preview-card.blade.php +++ b/app-modules/panel-app/resources/views/components/profile-preview-card.blade.php @@ -7,7 +7,8 @@ 'coverPreviewUrl' => null, 'coverAspectRatio', 'coverFocalY' => 50, - 'avatarFocalY' => 50 + 'avatarFocalY' => 50, + 'hasDelasTag' => false ]) @php @@ -146,6 +147,9 @@ class="inline-flex items-center gap-1 rounded-full bg-green-50 px-2 py-0.5 text- {{ $location }}

@endif + @if ($hasDelasTag) +
+ @endif {{-- Headline --}} 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 new file mode 100644 index 000000000..2d2127fa6 --- /dev/null +++ b/app-modules/panel-app/resources/views/livewire/delas/profile-section.blade.php @@ -0,0 +1,105 @@ +@php + use He4rt\Delas\TagRequest\Enums\DelasEligibilityState; + + $eligibility = $this->eligibility; + $state = $eligibility->state; + $displayTimezone = config('app.display_timezone'); + $switchOn = in_array($state, [DelasEligibilityState::Pending, DelasEligibilityState::Member], true); +@endphp + +
+ + + + + {{ __('panel-app::delas.name') }} + + + {{ __('panel-app::delas.profile.intro') }} + +
+ @if ($state !== DelasEligibilityState::Member) +
+ +
+ + @if ($state === DelasEligibilityState::CanRequest) +

+ {{ __('panel-app::delas.profile.toggle_hint') }} +

+ @endif +
+
+ @endif + + @switch($state) + @case(DelasEligibilityState::Pending) + + {{ __('panel-app::delas.profile.pending_title') }} + {{ + __('panel-app::delas.profile.pending_body', [ + 'date' => $eligibility->request?->requested_at->timezone($displayTimezone)->format('d/m/Y H:i'), + ]) + }} + + + @break + @case(DelasEligibilityState::Member) + + {{ __('panel-app::delas.profile.member_title') }} + {{ __('panel-app::delas.profile.member_body') }} +
+
+ + @break + @case(DelasEligibilityState::Cooldown) + + {{ __('panel-app::delas.profile.cooldown_title') }} + {{ + __('panel-app::delas.profile.cooldown_body', [ + 'date' => $eligibility->nextAllowedAt?->timezone($displayTimezone)->format('d/m'), + ]) + }} + + + @break + @case(DelasEligibilityState::Blocked) + + {{ __('panel-app::delas.profile.blocked_title') }} + + + @break + @endswitch +
+
+ + +
diff --git a/app-modules/panel-app/resources/views/livewire/delas/request-modal.blade.php b/app-modules/panel-app/resources/views/livewire/delas/request-modal.blade.php new file mode 100644 index 000000000..e7c6704cc --- /dev/null +++ b/app-modules/panel-app/resources/views/livewire/delas/request-modal.blade.php @@ -0,0 +1,13 @@ +
+
+ +
+ +

{{ __('panel-app::delas.profile.modal.what') }}

+ +
    + @foreach (__('panel-app::delas.profile.modal.steps') as $step) +
  • {{ $step }}
  • + @endforeach +
+
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 new file mode 100644 index 000000000..68c06e93a --- /dev/null +++ b/app-modules/panel-app/resources/views/pages/delas/heading.blade.php @@ -0,0 +1,6 @@ + + + + {{ __('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 new file mode 100644 index 000000000..8ddfdfbb1 --- /dev/null +++ b/app-modules/panel-app/resources/views/pages/delas/moderation.blade.php @@ -0,0 +1,17 @@ + + + @foreach ($this->tabs() as $key => $tab) + + {{ $tab['label'] }} + + @endforeach + + + {{ $this->table }} + diff --git a/app-modules/panel-app/resources/views/pages/profile.blade.php b/app-modules/panel-app/resources/views/pages/profile.blade.php index a9fbe8c6a..d1aed4f7c 100644 --- a/app-modules/panel-app/resources/views/pages/profile.blade.php +++ b/app-modules/panel-app/resources/views/pages/profile.blade.php @@ -19,6 +19,8 @@ 'birthdateForm' => $this->birthdateForm, ]) + + {{ $this->form }} @@ -34,7 +36,8 @@ 'coverPreviewUrl' => $this->coverPreviewUrl, 'coverAspectRatio' => $this->coverAspectRatio, 'coverFocalY' => $this->coverFocalY, - 'avatarFocalY' => $this->avatarFocalY + 'avatarFocalY' => $this->avatarFocalY, + 'hasDelasTag' => $this->hasDelasTag ])
diff --git a/app-modules/panel-app/src/Livewire/Delas/DelasProfileSection.php b/app-modules/panel-app/src/Livewire/Delas/DelasProfileSection.php new file mode 100644 index 000000000..80b1de9e0 --- /dev/null +++ b/app-modules/panel-app/src/Livewire/Delas/DelasProfileSection.php @@ -0,0 +1,88 @@ +for($this->user()); + } + + public function requestAction(): Action + { + return Action::make('request') + ->label(__('panel-app::delas.profile.toggle')) + ->modalHeading(__('panel-app::delas.profile.modal.heading')) + ->modalContent(view('panel-app::livewire.delas.request-modal')) + ->modalSubmitActionLabel(__('panel-app::delas.profile.modal.submit')) + // Rosa claro com texto 900 (4,81:1): o Filament escolheria texto branco num tom mais escuro. + ->modalSubmitAction(fn (Action $action): Action => $action->extraAttributes([ + 'class' => 'bg-delas-primary! text-delas-900! hover:bg-delas-300! [&_*]:text-delas-900!', + ])) + ->modalCancelActionLabel(__('panel-app::delas.profile.modal.cancel')) + ->modalWidth(Width::Large) + ->visible(fn (): bool => $this->eligibility->canRequest()) + ->action(function (): void { + try { + resolve(RequestDelasTag::class)->handle($this->user()); + } catch (DelasException $delasException) { + Notification::make()->danger()->title($delasException->getMessage())->send(); + + return; + } finally { + unset($this->eligibility); + } + + Notification::make() + ->success() + ->title(__('panel-app::delas.profile.sent')) + ->body(__('panel-app::delas.profile.sent_body')) + ->send(); + + $this->dispatch('delas-tag-updated'); + }); + } + + public function render(): View + { + return view('panel-app::livewire.delas.profile-section'); + } + + private function user(): User + { + $user = auth()->user(); + + abort_unless($user instanceof User, 403); + + return $user; + } +} diff --git a/app-modules/panel-app/src/Pages/Delas/DelasModerationPage.php b/app-modules/panel-app/src/Pages/Delas/DelasModerationPage.php new file mode 100644 index 000000000..e012395db --- /dev/null +++ b/app-modules/panel-app/src/Pages/Delas/DelasModerationPage.php @@ -0,0 +1,543 @@ +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 new file mode 100644 index 000000000..798dbaa88 --- /dev/null +++ b/app-modules/panel-app/src/Pages/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-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/src/Pages/ProfilePage.php b/app-modules/panel-app/src/Pages/ProfilePage.php index 9d0018ba7..1db368cf3 100644 --- a/app-modules/panel-app/src/Pages/ProfilePage.php +++ b/app-modules/panel-app/src/Pages/ProfilePage.php @@ -27,6 +27,7 @@ use Filament\Schemas\JsContent; use Filament\Schemas\Schema; use Filament\Support\Enums\Width; +use He4rt\Delas\TagRequest\Queries\DelasEligibility; use He4rt\Gamification\Character\Models\Character; use He4rt\Identity\User\Enums\ProfileImage; use He4rt\Identity\User\Models\User; @@ -46,6 +47,7 @@ use Illuminate\Http\UploadedFile; use Illuminate\Support\Str; use Livewire\Attributes\Computed; +use Livewire\Attributes\On; use Livewire\Features\SupportFileUploads\TemporaryUploadedFile; use Livewire\WithFileUploads; @@ -57,6 +59,7 @@ * @property-read string|null $coverPreviewUrl * @property-read int $avatarFocalY * @property-read int $coverFocalY + * @property-read bool $hasDelasTag */ class ProfilePage extends Page { @@ -525,6 +528,20 @@ public function character(): ?Character ->first(); } + #[Computed] + public function hasDelasTag(): bool + { + $user = auth()->user(); + + return $user instanceof User && resolve(DelasEligibility::class)->hasTag($user); + } + + #[On(event: 'delas-tag-updated')] + public function refreshDelasTag(): void + { + unset($this->hasDelasTag); + } + #[Computed] public function initials(): string { diff --git a/app-modules/panel-app/src/PanelAppServiceProvider.php b/app-modules/panel-app/src/PanelAppServiceProvider.php index 787975310..fc2339a5e 100644 --- a/app-modules/panel-app/src/PanelAppServiceProvider.php +++ b/app-modules/panel-app/src/PanelAppServiceProvider.php @@ -4,8 +4,10 @@ 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; use He4rt\PanelApp\Livewire\Events\EventDetail; use He4rt\PanelApp\Livewire\Events\EventsList; use He4rt\PanelApp\Livewire\Events\MyEventsList; @@ -20,7 +22,13 @@ class PanelAppServiceProvider extends ServiceProvider { - public function register(): void {} + 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 { @@ -41,5 +49,7 @@ public function boot(): void Livewire::component('timeline-post-show', PostShow::class); Livewire::component('timeline-reply-composer', ReplyComposer::class); Livewire::component('timeline-thread-replies', ThreadReplies::class); + + Livewire::component('delas-profile-section', DelasProfileSection::class); } } diff --git a/app-modules/panel-app/tests/Feature/Delas/DelasModerationPageTest.php b/app-modules/panel-app/tests/Feature/Delas/DelasModerationPageTest.php new file mode 100644 index 000000000..8388668a5 --- /dev/null +++ b/app-modules/panel-app/tests/Feature/Delas/DelasModerationPageTest.php @@ -0,0 +1,196 @@ +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-modules/panel-app/tests/Feature/Delas/DelasProfileSectionTest.php b/app-modules/panel-app/tests/Feature/Delas/DelasProfileSectionTest.php new file mode 100644 index 000000000..412037738 --- /dev/null +++ b/app-modules/panel-app/tests/Feature/Delas/DelasProfileSectionTest.php @@ -0,0 +1,69 @@ +user = User::factory()->create(); + $this->actingAs($this->user); +}); + +test('a opção de solicitar aparece para quem pode pedir', function (): void { + livewire(DelasProfileSection::class) + ->assertOk() + ->assertSee(__('panel-app::delas.profile.toggle')) + ->assertActionVisible('request'); +}); + +test('a solicitação só é registrada depois da confirmação no pop-up', function (): void { + livewire(DelasProfileSection::class) + ->mountAction('request') + ->assertActionMounted('request'); + + expect(DelasTagRequest::query()->exists())->toBeFalse(); + + livewire(DelasProfileSection::class) + ->callAction('request') + ->assertNotified(__('panel-app::delas.profile.sent')) + ->assertSee(__('panel-app::delas.profile.pending_title')) + ->assertActionHidden('request'); + + expect(DelasTagRequest::query()->sole()->status)->toBe(DelasRequestStatus::Pending); +}); + +test('com a tag aprovada, o perfil mostra que a pessoa faz parte', function (): void { + DelasTagRequest::factory()->for($this->user)->approved()->create(); + + livewire(DelasProfileSection::class) + ->assertSee(__('panel-app::delas.profile.member_title')) + ->assertActionHidden('request'); +}); + +test('em espera, mostra a data da próxima tentativa', function (): void { + config(['app.display_timezone' => 'America/Sao_Paulo']); + $this->travelTo('2026-10-06 15:00:00'); + DelasTagRequest::factory()->for($this->user)->rejected()->create(['decided_at' => now()]); + + livewire(DelasProfileSection::class) + ->assertSee(__('panel-app::delas.profile.cooldown_body', ['date' => '21/10'])) + ->assertActionHidden('request'); +}); + +test('bloqueada, mostra só que não é possível solicitar, sem o motivo', function (): void { + DelasRequesterBlock::factory()->for($this->user)->create(['reason' => 'motivo interno sigiloso']); + + livewire(DelasProfileSection::class) + ->assertSee(__('panel-app::delas.profile.blocked_title')) + ->assertDontSee('motivo interno sigiloso') + ->assertActionHidden('request'); +}); diff --git a/app/Providers/Filament/AppPanelProvider.php b/app/Providers/Filament/AppPanelProvider.php index d9030b358..19dbb4146 100644 --- a/app/Providers/Filament/AppPanelProvider.php +++ b/app/Providers/Filament/AppPanelProvider.php @@ -20,6 +20,7 @@ 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; @@ -48,6 +49,7 @@ public function panel(Panel $panel): Panel ->colors([ 'primary' => Color::Purple, 'gray' => Color::Zinc, + 'delas' => Color::hex('#F485A2'), ]) ->viteTheme('resources/css/filament/app/theme.css') ->sidebarCollapsibleOnDesktop() @@ -61,6 +63,7 @@ public function panel(Panel $panel): Panel EventPage::class, ThreadPage::class, ProfilePage::class, + DelasModerationPage::class, StreamingCluster::class, StreamDashboardPage::class, StreamOverlaysPage::class, diff --git a/resources/css/filament/app/theme.css b/resources/css/filament/app/theme.css index f44a6709a..5488b2e59 100644 --- a/resources/css/filament/app/theme.css +++ b/resources/css/filament/app/theme.css @@ -7,6 +7,21 @@ @source '../../../../app-modules/**/panel-app/**/*'; @source '../../../../app-modules/**/resources/views/**/*'; +/* Paleta da He4rt Delas (Figma da marca). Usada só nos pontos de marca: tag, logo, ícone e CTA do pedido. */ +@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; +} + /* Login split layout — strip Filament's card wrapper */ .fi-simple-layout:has(.fi-login-split) { .fi-simple-main-ctn { From 4067cf8e93810f10890d4c655dd84b4d00be5763 Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Tue, 6 Oct 2026 22:55:11 -0300 Subject: [PATCH 12/77] =?UTF-8?q?docs(delas):=20spec=20e=20contexto=20alin?= =?UTF-8?q?hados=20=C3=A0=20implementa=C3=A7=C3=A3o?= 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 | 10 ++++++---- 2 files changed, 7 insertions(+), 5 deletions(-) diff --git a/app-modules/delas/CONTEXT.md b/app-modules/delas/CONTEXT.md index 874e1dba7..13251ccf8 100644 --- a/app-modules/delas/CONTEXT.md +++ b/app-modules/delas/CONTEXT.md @@ -11,7 +11,7 @@ histórico de cada uma dessas decisões. Os dois painéis dependem deste módulo, e este módulo só depende do `identity`. -> **Status:** em implementação. O design está na +> **Status:** implementado (aguardando PR). 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). 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 76651ecc0..989787a3e 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 @@ -324,12 +324,14 @@ Sem cluster nem página da He4rt Delas. Só: - 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`. +- 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. - 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. +- 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. - Protótipo de referência validado com a Danielle; tokens e assets a confirmar com a Sther. ## Trade-offs e alternativas consideradas From 6ccd678ebd31fcd8dcf4cdfc93801069f15bee71 Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Wed, 7 Oct 2026 15:51:24 -0300 Subject: [PATCH 13/77] =?UTF-8?q?docs(identity):=20ADR-0003=20acesso=20ao?= =?UTF-8?q?=20/admin=20por=20papel=20de=20modera=C3=A7=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Substitui a regra "super admin ou nada" da ADR-0002: cada papel diz se entra no /admin (UserRole::grantsAdminAccess) e cada Resource, Page e Cluster decide no canAccess(), com SuperAdminOnly como padrão. --- ...-acesso-ao-admin-por-papel-de-moderacao.md | 70 +++++++++++++++++++ 1 file changed, 70 insertions(+) create mode 100644 app-modules/identity/docs/adr/0003-acesso-ao-admin-por-papel-de-moderacao.md diff --git a/app-modules/identity/docs/adr/0003-acesso-ao-admin-por-papel-de-moderacao.md b/app-modules/identity/docs/adr/0003-acesso-ao-admin-por-papel-de-moderacao.md new file mode 100644 index 000000000..e705313bd --- /dev/null +++ b/app-modules/identity/docs/adr/0003-acesso-ao-admin-por-papel-de-moderacao.md @@ -0,0 +1,70 @@ +--- +type: adr +title: 'Acesso ao /admin por papel de moderação' +module: identity +status: accepted +date: 2026-10-07 +author: damacosta +related: + adr: identity/0002-super-admin-via-spatie-permission +--- + +# ADR-0003: Acesso ao /admin por papel de moderação + +Substitui a regra "o painel inteiro é super admin ou nada" da +[ADR-0002](0002-super-admin-via-spatie-permission.md). O resto da ADR-0002 continua valendo. + +## Contexto + +A ADR-0002 foi escrita na fase 1, quando o único papel era `super-admin`. Por isso ela diz que o +`/admin` é "super admin ou nada". + +Com a He4rt Delas surgiram papéis que moderam alguma coisa (`delas-moderator` e `delas-lead`). +Moderação na He4rt mora no `/admin`, no cluster de Moderação (`/admin/mod`). Manter a moderação +da He4rt Delas no `/app` só para não abrir o `/admin` criaria dois lugares de moderação. + +Abrir a porta do `/admin` tem duas armadilhas: + +- no Filament, um Resource sem policy e uma Page sem `canAccess()` liberam acesso para qualquer + pessoa que entrou no painel. Nenhum Resource, Page ou Cluster do `panel-admin` tinha + `canAccess()`; +- o `PanelAdminServiceProvider::buildNavigation()` monta a sidebar com `getNavigationItems()`, + que não checa `canAccess()`. O item aparecia na sidebar e dava 403 no clique. + +## Decisão + +- **Cada papel diz se entra no `/admin`**, em `UserRole::grantsAdminAccess()`, com `match` sem + `default`: um papel novo sem essa decisão quebra no PHPStan antes de quebrar em produção. + `UserRole::withAdminAccess()` lista os papéis que entram. + - `super-admin`, `delas-moderator` e `delas-lead`: entram. + - `streamer`: não entra. +- **`User::canAccessPanel('admin')`** em produção passa a ser + `$this->hasAnyRole(UserRole::withAdminAccess())`. Fora de produção a porta continua aberta, + como na ADR-0002. +- **Entrar no painel não dá acesso a nada por si só.** Cada Resource, Page e Cluster decide no + `canAccess()`, e isso vale em **todo ambiente**: + - o trait `He4rt\PanelAdmin\Concerns\SuperAdminOnly` vai em todo Resource, Page e Cluster + do `panel-admin` que não é de um papel de moderação; + - as páginas de moderação de um papel checam o gate do módulo dono (ex.: `moderate-delas` e + `lead-delas`, definidos no `delas`); + - o `ModerationCluster` fica sem o trait, porque é dividido entre papéis. A subnavegação do + cluster já filtra por `canAccess()`; + - o Dashboard continua acessível como página de entrada, mas os widgets dele são só para + super admin (`canView()`). +- **A sidebar respeita o `canAccess()`.** O `buildNavigation()` monta os itens com um helper + `itemsFor()`, que só devolve os itens de quem passa no `canAccess()` (clusters, no + `canAccessClusteredComponents()`). +- **Um teste de varredura** garante que uma moderadora da He4rt Delas só acessa o Dashboard e as + páginas da He4rt Delas. Resource ou Page novo sem o trait quebra esse teste. + +## Consequências + +- Papel novo em `UserRole` precisa decidir se entra no `/admin`, ou o PHPStan acusa o `match`. +- Todo Resource, Page ou Cluster novo no `panel-admin` precisa do `SuperAdminOnly` ou de um + `canAccess()` próprio. O teste de varredura cobra isso. +- Fora de produção, quem não é super admin entra no `/admin` mas só vê o Dashboard (sem + widgets). Para ver o resto localmente: `php artisan identity:grant-super-admin {username}`. +- A seção Papéis do `UserForm` continua visível só para super admin, por causa da porta aberta + fora de produção. +- `Gate::before` continua liberando tudo para super admin, então as páginas de um papel de + moderação também abrem para super admin. From cba403e913a284953eb4270af55511c45974cfcd Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Wed, 7 Oct 2026 15:54:02 -0300 Subject: [PATCH 14/77] =?UTF-8?q?feat(identity):=20pap=C3=A9is=20de=20mode?= =?UTF-8?q?ra=C3=A7=C3=A3o=20entram=20no=20/admin?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit UserRole::grantsAdminAccess() (match sem default) e withAdminAccess(); em produção, User::canAccessPanel('admin') aceita qualquer papel que modera alguma coisa, não só super admin (ADR-0003). --- .../src/Authorization/Enums/UserRole.php | 25 ++++++++++++++++++- app-modules/identity/src/User/Models/User.php | 2 +- .../tests/Unit/Authorization/UserRoleTest.php | 5 ++++ .../tests/Feature/AdminPanelAccessTest.php | 16 ++++++++++++ 4 files changed, 46 insertions(+), 2 deletions(-) diff --git a/app-modules/identity/src/Authorization/Enums/UserRole.php b/app-modules/identity/src/Authorization/Enums/UserRole.php index c4c17d7dc..6f8d86988 100644 --- a/app-modules/identity/src/Authorization/Enums/UserRole.php +++ b/app-modules/identity/src/Authorization/Enums/UserRole.php @@ -30,6 +30,29 @@ enum UserRole: string implements HasColor, HasDescription, HasIcon, HasLabel public const string GUARD = 'web'; + /** + * @return list + */ + public static function withAdminAccess(): array + { + return array_values(array_filter(self::cases(), fn (self $role): bool => $role->grantsAdminAccess())); + } + + /** + * Papéis que entram no `/admin` (ADR-0003). Entrar não libera nada por si só: + * cada Resource, Page e Cluster decide no próprio `canAccess()`. + * + * O `match` não tem `default` de propósito: papel novo sem essa decisão + * quebra no PHPStan antes de quebrar em produção. + */ + public function grantsAdminAccess(): bool + { + return match ($this) { + self::SuperAdmin, self::DelasModerator, self::DelasLead => true, + self::Streamer => false, + }; + } + public function getLabel(): string { return match ($this) { @@ -58,7 +81,7 @@ 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::DelasModerator => 'Aprova, rejeita e bloqueia solicitações da tag He4rt Delas na moderação do /admin.', self::DelasLead => 'Tudo da moderadora, mais gerenciar moderadoras e conceder ou remover a tag He4rt Delas.', }; } diff --git a/app-modules/identity/src/User/Models/User.php b/app-modules/identity/src/User/Models/User.php index 6a711334e..3a82cb2ab 100644 --- a/app-modules/identity/src/User/Models/User.php +++ b/app-modules/identity/src/User/Models/User.php @@ -125,7 +125,7 @@ public function registerMediaCollections(): void public function canAccessPanel(Panel $panel): bool { return match ($panel->getId()) { - 'admin' => app()->isProduction() ? $this->isSuperAdmin() : true, + 'admin' => app()->isProduction() ? $this->hasAnyRole(UserRole::withAdminAccess()) : true, default => true }; } diff --git a/app-modules/identity/tests/Unit/Authorization/UserRoleTest.php b/app-modules/identity/tests/Unit/Authorization/UserRoleTest.php index a2d7cedfa..7bdc72bec 100644 --- a/app-modules/identity/tests/Unit/Authorization/UserRoleTest.php +++ b/app-modules/identity/tests/Unit/Authorization/UserRoleTest.php @@ -16,3 +16,8 @@ expect(UserRole::SuperAdmin->value)->toBe('super-admin') ->and(UserRole::GUARD)->toBe('web'); }); + +test('only super admin and moderation roles grant admin access', function (): void { + expect(UserRole::withAdminAccess())->toBe([UserRole::SuperAdmin, UserRole::DelasModerator, UserRole::DelasLead]) + ->and(UserRole::Streamer->grantsAdminAccess())->toBeFalse(); +}); diff --git a/app-modules/panel-admin/tests/Feature/AdminPanelAccessTest.php b/app-modules/panel-admin/tests/Feature/AdminPanelAccessTest.php index 980140679..bde51a03b 100644 --- a/app-modules/panel-admin/tests/Feature/AdminPanelAccessTest.php +++ b/app-modules/panel-admin/tests/Feature/AdminPanelAccessTest.php @@ -36,6 +36,22 @@ expect($user->canAccessPanel($panel))->toBeTrue(); }); +test('roles that moderate something can access the admin panel in production', function (string $state): void { + $user = User::factory()->{$state}()->create(); + + app()->detectEnvironment(fn () => 'production'); + + expect($user->canAccessPanel(Filament::getPanel('admin')))->toBeTrue(); +})->with(['delasModerator', 'delasLead']); + +test('streamer cannot access admin panel in production', function (): void { + $user = User::factory()->streamer()->create(); + + app()->detectEnvironment(fn () => 'production'); + + expect($user->canAccessPanel(Filament::getPanel('admin')))->toBeFalse(); +}); + test('user without role cannot access admin panel in production', function (): void { $user = User::factory()->create(); From d5ae348c55b771eace16f8b0b2e1d3e8119702eb Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Wed, 7 Oct 2026 15:59:11 -0300 Subject: [PATCH 15/77] feat(panel-admin): SuperAdminOnly em todo Resource, Page e Cluster MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Entrar no /admin deixa de liberar tudo: cada Resource, Page e Cluster que já existe (inclusive casos, apelações, regras e auditoria da moderação) fica só para super admin. O ModerationCluster fica de fora, porque passa a ser dividido entre papéis, e o Dashboard segue como página de entrada, com os widgets só para super admin. --- .../src/Concerns/SuperAdminOnly.php | 23 ++++++ .../Widgets/ActivityTimelineWidget.php | 12 ++++ .../src/Discord/DiscordCluster.php | 3 + .../src/Discord/Pages/DiscordDashboard.php | 3 + .../DiscordChannelResource.php | 3 + .../DiscordEventLogResource.php | 3 + .../DiscordGuilds/DiscordGuildResource.php | 3 + .../DiscordMembers/DiscordMemberResource.php | 3 + .../DiscordRoles/DiscordRoleResource.php | 3 + .../Resources/Albums/AlbumResource.php | 3 + .../ContentEntries/ContentEntryResource.php | 3 + .../Resources/Events/EventResource.php | 3 + .../ExternalIdentityResource.php | 3 + .../Interactions/InteractionResource.php | 3 + .../Resources/Profiles/ProfileResource.php | 3 + .../Retrospectives/RetrospectiveResource.php | 3 + .../Resources/Skills/SkillResource.php | 3 + .../Filament/Resources/Users/UserResource.php | 3 + .../panel-admin/src/Github/GithubCluster.php | 3 + .../Resources/GithubRepositoryResource.php | 3 + .../src/Marketing/MarketingCluster.php | 3 + .../Discord/Dashboard/DiscordDashboard.php | 3 + .../Pages/Location/LocationDashboard.php | 3 + .../Marketing/Pages/MeetingShowcasePage.php | 3 + .../ShortLinks/ShortLinkResource.php | 3 + .../src/Moderation/Pages/AppealQueuePage.php | 3 + .../src/Moderation/Pages/AuditLogPage.php | 2 + .../Moderation/Pages/ModerationDashboard.php | 3 + .../Moderation/Pages/ModerationQueuePage.php | 3 + .../Resources/ModerationAppealResource.php | 3 + .../Resources/ModerationCaseResource.php | 3 + .../Resources/ModerationRuleResource.php | 3 + .../src/Twitch/Pages/TwitchDashboard.php | 3 + .../Resources/TwitchEventLogResource.php | 3 + .../Resources/TwitchSubscriptionResource.php | 3 + .../panel-admin/src/Twitch/TwitchCluster.php | 3 + .../AdminComponentAccessTest.php | 72 +++++++++++++++++++ .../Marketing/LocationDashboardTest.php | 2 +- .../Marketing/MeetingShowcasePageTest.php | 2 +- 39 files changed, 210 insertions(+), 2 deletions(-) create mode 100644 app-modules/panel-admin/src/Concerns/SuperAdminOnly.php create mode 100644 app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php diff --git a/app-modules/panel-admin/src/Concerns/SuperAdminOnly.php b/app-modules/panel-admin/src/Concerns/SuperAdminOnly.php new file mode 100644 index 000000000..5c6026e93 --- /dev/null +++ b/app-modules/panel-admin/src/Concerns/SuperAdminOnly.php @@ -0,0 +1,23 @@ +user(); + + return $user instanceof User && $user->isSuperAdmin(); + } +} diff --git a/app-modules/panel-admin/src/Contributions/Widgets/ActivityTimelineWidget.php b/app-modules/panel-admin/src/Contributions/Widgets/ActivityTimelineWidget.php index 16cafaffb..02a9941d9 100644 --- a/app-modules/panel-admin/src/Contributions/Widgets/ActivityTimelineWidget.php +++ b/app-modules/panel-admin/src/Contributions/Widgets/ActivityTimelineWidget.php @@ -5,6 +5,7 @@ namespace He4rt\PanelAdmin\Contributions\Widgets; use Filament\Widgets\Widget; +use He4rt\Identity\User\Models\User; use He4rt\PanelAdmin\Contributions\Timeline\DailyActivitySeries; /** @@ -25,6 +26,17 @@ class ActivityTimelineWidget extends Widget protected DailyActivitySeries $series; + /** + * O Dashboard é a página de entrada de todo papel que entra no `/admin` + * (ADR-0003 do identity), mas os números da comunidade são só de super admin. + */ + public static function canView(): bool + { + $user = auth()->user(); + + return $user instanceof User && $user->isSuperAdmin(); + } + /** * Livewire resolve o boot a cada request, então a dependência entra por injeção * e não vira estado serializado do componente. diff --git a/app-modules/panel-admin/src/Discord/DiscordCluster.php b/app-modules/panel-admin/src/Discord/DiscordCluster.php index 9533cce38..6359d4f04 100644 --- a/app-modules/panel-admin/src/Discord/DiscordCluster.php +++ b/app-modules/panel-admin/src/Discord/DiscordCluster.php @@ -7,9 +7,12 @@ use BackedEnum; use Filament\Clusters\Cluster; use Filament\Support\Icons\Heroicon; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; class DiscordCluster extends Cluster { + use SuperAdminOnly; + protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedChatBubbleLeftRight; protected static ?int $navigationSort = 40; diff --git a/app-modules/panel-admin/src/Discord/Pages/DiscordDashboard.php b/app-modules/panel-admin/src/Discord/Pages/DiscordDashboard.php index 5b49f3d54..33b2b4b97 100644 --- a/app-modules/panel-admin/src/Discord/Pages/DiscordDashboard.php +++ b/app-modules/panel-admin/src/Discord/Pages/DiscordDashboard.php @@ -8,6 +8,7 @@ use Filament\Pages\Page; use Filament\Support\Enums\Width; use Filament\Support\Icons\Heroicon; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Discord\DiscordCluster; use He4rt\PanelAdmin\Discord\Widgets\DiscordStatsWidget; use He4rt\PanelAdmin\Discord\Widgets\EventsPerDayChartWidget; @@ -16,6 +17,8 @@ class DiscordDashboard extends Page { + use SuperAdminOnly; + protected static ?string $cluster = DiscordCluster::class; protected Width|string|null $maxContentWidth = Width::Full; diff --git a/app-modules/panel-admin/src/Discord/Resources/DiscordChannels/DiscordChannelResource.php b/app-modules/panel-admin/src/Discord/Resources/DiscordChannels/DiscordChannelResource.php index 6b5b529ff..4e5d8e1db 100644 --- a/app-modules/panel-admin/src/Discord/Resources/DiscordChannels/DiscordChannelResource.php +++ b/app-modules/panel-admin/src/Discord/Resources/DiscordChannels/DiscordChannelResource.php @@ -11,6 +11,7 @@ use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; use He4rt\IntegrationDiscord\Models\DiscordChannel; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Discord\DiscordCluster; use He4rt\PanelAdmin\Discord\Resources\DiscordChannels\Pages\ListDiscordChannels; use He4rt\PanelAdmin\Discord\Resources\DiscordChannels\Pages\ViewDiscordChannel; @@ -21,6 +22,8 @@ class DiscordChannelResource extends Resource { + use SuperAdminOnly; + protected static ?string $model = DiscordChannel::class; protected static ?string $cluster = DiscordCluster::class; diff --git a/app-modules/panel-admin/src/Discord/Resources/DiscordEventLogs/DiscordEventLogResource.php b/app-modules/panel-admin/src/Discord/Resources/DiscordEventLogs/DiscordEventLogResource.php index eb760befd..395930463 100644 --- a/app-modules/panel-admin/src/Discord/Resources/DiscordEventLogs/DiscordEventLogResource.php +++ b/app-modules/panel-admin/src/Discord/Resources/DiscordEventLogs/DiscordEventLogResource.php @@ -11,6 +11,7 @@ use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; use He4rt\IntegrationDiscord\Models\DiscordEventLog; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Discord\DiscordCluster; use He4rt\PanelAdmin\Discord\Resources\DiscordEventLogs\Pages\ListDiscordEventLogs; use He4rt\PanelAdmin\Discord\Resources\DiscordEventLogs\Pages\ViewDiscordEventLog; @@ -19,6 +20,8 @@ class DiscordEventLogResource extends Resource { + use SuperAdminOnly; + protected static ?string $cluster = DiscordCluster::class; protected static ?string $model = DiscordEventLog::class; diff --git a/app-modules/panel-admin/src/Discord/Resources/DiscordGuilds/DiscordGuildResource.php b/app-modules/panel-admin/src/Discord/Resources/DiscordGuilds/DiscordGuildResource.php index dd3969abd..502bc69c1 100644 --- a/app-modules/panel-admin/src/Discord/Resources/DiscordGuilds/DiscordGuildResource.php +++ b/app-modules/panel-admin/src/Discord/Resources/DiscordGuilds/DiscordGuildResource.php @@ -11,6 +11,7 @@ use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; use He4rt\IntegrationDiscord\Models\DiscordGuild; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Discord\DiscordCluster; use He4rt\PanelAdmin\Discord\Resources\DiscordGuilds\Pages\ListDiscordGuilds; use He4rt\PanelAdmin\Discord\Resources\DiscordGuilds\Pages\ViewDiscordGuild; @@ -22,6 +23,8 @@ class DiscordGuildResource extends Resource { + use SuperAdminOnly; + protected static ?string $cluster = DiscordCluster::class; protected static ?string $model = DiscordGuild::class; diff --git a/app-modules/panel-admin/src/Discord/Resources/DiscordMembers/DiscordMemberResource.php b/app-modules/panel-admin/src/Discord/Resources/DiscordMembers/DiscordMemberResource.php index d233b4175..ddc013595 100644 --- a/app-modules/panel-admin/src/Discord/Resources/DiscordMembers/DiscordMemberResource.php +++ b/app-modules/panel-admin/src/Discord/Resources/DiscordMembers/DiscordMemberResource.php @@ -11,6 +11,7 @@ use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; use He4rt\IntegrationDiscord\Models\DiscordMember; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Discord\DiscordCluster; use He4rt\PanelAdmin\Discord\Resources\DiscordMembers\Pages\ListDiscordMembers; use He4rt\PanelAdmin\Discord\Resources\DiscordMembers\Pages\ViewDiscordMember; @@ -20,6 +21,8 @@ class DiscordMemberResource extends Resource { + use SuperAdminOnly; + protected static ?string $cluster = DiscordCluster::class; protected static ?string $model = DiscordMember::class; diff --git a/app-modules/panel-admin/src/Discord/Resources/DiscordRoles/DiscordRoleResource.php b/app-modules/panel-admin/src/Discord/Resources/DiscordRoles/DiscordRoleResource.php index 1afc5d376..45637fa78 100644 --- a/app-modules/panel-admin/src/Discord/Resources/DiscordRoles/DiscordRoleResource.php +++ b/app-modules/panel-admin/src/Discord/Resources/DiscordRoles/DiscordRoleResource.php @@ -11,6 +11,7 @@ use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; use He4rt\IntegrationDiscord\Models\DiscordRole; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Discord\DiscordCluster; use He4rt\PanelAdmin\Discord\Resources\DiscordRoles\Pages\ListDiscordRoles; use He4rt\PanelAdmin\Discord\Resources\DiscordRoles\Pages\ViewDiscordRole; @@ -21,6 +22,8 @@ class DiscordRoleResource extends Resource { + use SuperAdminOnly; + protected static ?string $cluster = DiscordCluster::class; protected static ?string $model = DiscordRole::class; diff --git a/app-modules/panel-admin/src/Filament/Resources/Albums/AlbumResource.php b/app-modules/panel-admin/src/Filament/Resources/Albums/AlbumResource.php index 7f38fb678..e88f2cacd 100644 --- a/app-modules/panel-admin/src/Filament/Resources/Albums/AlbumResource.php +++ b/app-modules/panel-admin/src/Filament/Resources/Albums/AlbumResource.php @@ -11,6 +11,7 @@ use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; use He4rt\Events\Gallery\Models\Album; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Filament\Resources\Albums\Pages\CreateAlbum; use He4rt\PanelAdmin\Filament\Resources\Albums\Pages\EditAlbum; use He4rt\PanelAdmin\Filament\Resources\Albums\Pages\ListAlbums; @@ -20,6 +21,8 @@ final class AlbumResource extends Resource { + use SuperAdminOnly; + protected static ?string $model = Album::class; protected static ?string $slug = 'albums'; diff --git a/app-modules/panel-admin/src/Filament/Resources/ContentEntries/ContentEntryResource.php b/app-modules/panel-admin/src/Filament/Resources/ContentEntries/ContentEntryResource.php index b37215a25..beff20021 100644 --- a/app-modules/panel-admin/src/Filament/Resources/ContentEntries/ContentEntryResource.php +++ b/app-modules/panel-admin/src/Filament/Resources/ContentEntries/ContentEntryResource.php @@ -11,6 +11,7 @@ use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; use He4rt\Contents\Models\ContentEntry; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Filament\Resources\ContentEntries\Pages\EditContentEntry; use He4rt\PanelAdmin\Filament\Resources\ContentEntries\Pages\ListContentEntries; use He4rt\PanelAdmin\Filament\Resources\ContentEntries\Pages\ViewContentEntry; @@ -23,6 +24,8 @@ class ContentEntryResource extends Resource { + use SuperAdminOnly; + protected static ?string $model = ContentEntry::class; protected static ?string $slug = 'articles'; diff --git a/app-modules/panel-admin/src/Filament/Resources/Events/EventResource.php b/app-modules/panel-admin/src/Filament/Resources/Events/EventResource.php index 169a573e1..feffdc33f 100644 --- a/app-modules/panel-admin/src/Filament/Resources/Events/EventResource.php +++ b/app-modules/panel-admin/src/Filament/Resources/Events/EventResource.php @@ -11,6 +11,7 @@ use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; use He4rt\Events\Event\Models\Event; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Filament\Resources\Events\Pages\CreateEvent; use He4rt\PanelAdmin\Filament\Resources\Events\Pages\EditEvent; use He4rt\PanelAdmin\Filament\Resources\Events\Pages\ListEvents; @@ -22,6 +23,8 @@ final class EventResource extends Resource { + use SuperAdminOnly; + protected static ?string $model = Event::class; protected static ?string $slug = 'events'; diff --git a/app-modules/panel-admin/src/Filament/Resources/ExternalIdentities/ExternalIdentityResource.php b/app-modules/panel-admin/src/Filament/Resources/ExternalIdentities/ExternalIdentityResource.php index fb27c87c0..db85beecb 100644 --- a/app-modules/panel-admin/src/Filament/Resources/ExternalIdentities/ExternalIdentityResource.php +++ b/app-modules/panel-admin/src/Filament/Resources/ExternalIdentities/ExternalIdentityResource.php @@ -11,6 +11,7 @@ use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; use He4rt\Identity\ExternalIdentity\Models\ExternalIdentity; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Filament\Resources\ExternalIdentities\Pages\CreateExternalIdentity; use He4rt\PanelAdmin\Filament\Resources\ExternalIdentities\Pages\EditExternalIdentity; use He4rt\PanelAdmin\Filament\Resources\ExternalIdentities\Pages\ListExternalIdentities; @@ -24,6 +25,8 @@ class ExternalIdentityResource extends Resource { + use SuperAdminOnly; + protected static ?string $model = ExternalIdentity::class; protected static ?string $slug = 'external-identities'; diff --git a/app-modules/panel-admin/src/Filament/Resources/Interactions/InteractionResource.php b/app-modules/panel-admin/src/Filament/Resources/Interactions/InteractionResource.php index 4308802e5..26bdea40e 100644 --- a/app-modules/panel-admin/src/Filament/Resources/Interactions/InteractionResource.php +++ b/app-modules/panel-admin/src/Filament/Resources/Interactions/InteractionResource.php @@ -10,6 +10,7 @@ use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; use He4rt\Activity\Tracking\Models\Interaction; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Filament\Resources\Interactions\Pages\ListInteractions; use He4rt\PanelAdmin\Filament\Resources\Interactions\Tables\InteractionsTable; use Illuminate\Database\Eloquent\Builder; @@ -17,6 +18,8 @@ class InteractionResource extends Resource { + use SuperAdminOnly; + protected static ?string $model = Interaction::class; protected static ?string $slug = 'contributions'; diff --git a/app-modules/panel-admin/src/Filament/Resources/Profiles/ProfileResource.php b/app-modules/panel-admin/src/Filament/Resources/Profiles/ProfileResource.php index 910fb404e..d17d10e2a 100644 --- a/app-modules/panel-admin/src/Filament/Resources/Profiles/ProfileResource.php +++ b/app-modules/panel-admin/src/Filament/Resources/Profiles/ProfileResource.php @@ -10,6 +10,7 @@ use Filament\Schemas\Schema; use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Filament\Resources\Profiles\Pages\EditProfile; use He4rt\PanelAdmin\Filament\Resources\Profiles\Pages\ListProfiles; use He4rt\PanelAdmin\Filament\Resources\Profiles\Pages\ViewProfile; @@ -24,6 +25,8 @@ class ProfileResource extends Resource { + use SuperAdminOnly; + protected static ?string $model = Profile::class; protected static ?string $slug = 'profiles'; diff --git a/app-modules/panel-admin/src/Filament/Resources/Retrospectives/RetrospectiveResource.php b/app-modules/panel-admin/src/Filament/Resources/Retrospectives/RetrospectiveResource.php index 9b1743e3f..09d8b6a09 100644 --- a/app-modules/panel-admin/src/Filament/Resources/Retrospectives/RetrospectiveResource.php +++ b/app-modules/panel-admin/src/Filament/Resources/Retrospectives/RetrospectiveResource.php @@ -11,6 +11,7 @@ use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; use He4rt\Community\Retrospective\Models\Retrospective; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Filament\Resources\Retrospectives\Pages\BuildDeck; use He4rt\PanelAdmin\Filament\Resources\Retrospectives\Pages\CreateRetrospective; use He4rt\PanelAdmin\Filament\Resources\Retrospectives\Pages\ListRetrospectives; @@ -19,6 +20,8 @@ class RetrospectiveResource extends Resource { + use SuperAdminOnly; + protected static ?string $model = Retrospective::class; protected static ?string $slug = 'retrospectives'; diff --git a/app-modules/panel-admin/src/Filament/Resources/Skills/SkillResource.php b/app-modules/panel-admin/src/Filament/Resources/Skills/SkillResource.php index 8a778aab1..09bbae563 100644 --- a/app-modules/panel-admin/src/Filament/Resources/Skills/SkillResource.php +++ b/app-modules/panel-admin/src/Filament/Resources/Skills/SkillResource.php @@ -10,6 +10,7 @@ use Filament\Schemas\Schema; use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Filament\Resources\Skills\Pages\CreateSkill; use He4rt\PanelAdmin\Filament\Resources\Skills\Pages\EditSkill; use He4rt\PanelAdmin\Filament\Resources\Skills\Pages\ListSkills; @@ -20,6 +21,8 @@ class SkillResource extends Resource { + use SuperAdminOnly; + protected static ?string $model = Skill::class; protected static ?string $slug = 'skills'; diff --git a/app-modules/panel-admin/src/Filament/Resources/Users/UserResource.php b/app-modules/panel-admin/src/Filament/Resources/Users/UserResource.php index 4a0bc7687..274222831 100644 --- a/app-modules/panel-admin/src/Filament/Resources/Users/UserResource.php +++ b/app-modules/panel-admin/src/Filament/Resources/Users/UserResource.php @@ -11,6 +11,7 @@ use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; use He4rt\Identity\User\Models\User; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Filament\Resources\Users\Pages\EditUser; use He4rt\PanelAdmin\Filament\Resources\Users\Pages\ListUsers; use He4rt\PanelAdmin\Filament\Resources\Users\Pages\ViewUser; @@ -23,6 +24,8 @@ class UserResource extends Resource { + use SuperAdminOnly; + protected static ?string $model = User::class; protected static ?string $slug = 'users'; diff --git a/app-modules/panel-admin/src/Github/GithubCluster.php b/app-modules/panel-admin/src/Github/GithubCluster.php index d18638944..bdbb3c7d8 100644 --- a/app-modules/panel-admin/src/Github/GithubCluster.php +++ b/app-modules/panel-admin/src/Github/GithubCluster.php @@ -7,9 +7,12 @@ use BackedEnum; use Filament\Clusters\Cluster; use Filament\Support\Icons\Heroicon; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; class GithubCluster extends Cluster { + use SuperAdminOnly; + protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedCodeBracket; protected static ?int $navigationSort = 40; diff --git a/app-modules/panel-admin/src/Github/Resources/GithubRepositoryResource.php b/app-modules/panel-admin/src/Github/Resources/GithubRepositoryResource.php index 014bec089..447767de3 100644 --- a/app-modules/panel-admin/src/Github/Resources/GithubRepositoryResource.php +++ b/app-modules/panel-admin/src/Github/Resources/GithubRepositoryResource.php @@ -19,6 +19,7 @@ use Filament\Tables\Table; use He4rt\IntegrationGithub\Backfill\Jobs\BackfillGithubRepository; use He4rt\IntegrationGithub\Models\GithubRepository; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Github\GithubCluster; use He4rt\PanelAdmin\Github\Resources\GithubRepositoryResource\Pages\CreateGithubRepository; use He4rt\PanelAdmin\Github\Resources\GithubRepositoryResource\Pages\EditGithubRepository; @@ -26,6 +27,8 @@ class GithubRepositoryResource extends Resource { + use SuperAdminOnly; + protected static ?string $cluster = GithubCluster::class; protected static ?string $model = GithubRepository::class; diff --git a/app-modules/panel-admin/src/Marketing/MarketingCluster.php b/app-modules/panel-admin/src/Marketing/MarketingCluster.php index 782706a21..5db9ea430 100644 --- a/app-modules/panel-admin/src/Marketing/MarketingCluster.php +++ b/app-modules/panel-admin/src/Marketing/MarketingCluster.php @@ -7,9 +7,12 @@ use BackedEnum; use Filament\Clusters\Cluster; use Filament\Support\Icons\Heroicon; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; class MarketingCluster extends Cluster { + use SuperAdminOnly; + protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedMegaphone; protected static ?int $navigationSort = 20; diff --git a/app-modules/panel-admin/src/Marketing/Pages/Discord/Dashboard/DiscordDashboard.php b/app-modules/panel-admin/src/Marketing/Pages/Discord/Dashboard/DiscordDashboard.php index e76b3599f..fb550361f 100644 --- a/app-modules/panel-admin/src/Marketing/Pages/Discord/Dashboard/DiscordDashboard.php +++ b/app-modules/panel-admin/src/Marketing/Pages/Discord/Dashboard/DiscordDashboard.php @@ -8,6 +8,7 @@ use Filament\Pages\Page; use Filament\Support\Enums\Width; use Filament\Support\Icons\Heroicon; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Marketing\MarketingCluster; use He4rt\PanelAdmin\Marketing\Pages\Discord\Dashboard\Queries\ActivityPerDay; use He4rt\PanelAdmin\Marketing\Pages\Discord\Dashboard\Queries\MessageHeatmap; @@ -20,6 +21,8 @@ class DiscordDashboard extends Page { + use SuperAdminOnly; + public int $rangeDays = 14; /** @var array */ diff --git a/app-modules/panel-admin/src/Marketing/Pages/Location/LocationDashboard.php b/app-modules/panel-admin/src/Marketing/Pages/Location/LocationDashboard.php index b64afee90..ecaed8990 100644 --- a/app-modules/panel-admin/src/Marketing/Pages/Location/LocationDashboard.php +++ b/app-modules/panel-admin/src/Marketing/Pages/Location/LocationDashboard.php @@ -8,6 +8,7 @@ use Filament\Pages\Page; use Filament\Support\Enums\Width; use Filament\Support\Icons\Heroicon; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Marketing\MarketingCluster; use He4rt\PanelAdmin\Marketing\Widgets\LocationMapWidget; use He4rt\PanelAdmin\Marketing\Widgets\LocationStatsWidget; @@ -15,6 +16,8 @@ class LocationDashboard extends Page { + use SuperAdminOnly; + protected static ?string $cluster = MarketingCluster::class; protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedMapPin; diff --git a/app-modules/panel-admin/src/Marketing/Pages/MeetingShowcasePage.php b/app-modules/panel-admin/src/Marketing/Pages/MeetingShowcasePage.php index 7fb1f40a0..f6b3ad65b 100644 --- a/app-modules/panel-admin/src/Marketing/Pages/MeetingShowcasePage.php +++ b/app-modules/panel-admin/src/Marketing/Pages/MeetingShowcasePage.php @@ -11,6 +11,7 @@ use He4rt\Activity\Message\Models\Message; use He4rt\Identity\ExternalIdentity\Enums\IdentityProvider; use He4rt\Identity\ExternalIdentity\Models\ExternalIdentity; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Marketing\MarketingCluster; use Illuminate\Support\Collection; use Illuminate\Support\Facades\Date; @@ -18,6 +19,8 @@ class MeetingShowcasePage extends Page { + use SuperAdminOnly; + public string $channelId = ''; public string $startDate = ''; diff --git a/app-modules/panel-admin/src/Marketing/Resources/ShortLinks/ShortLinkResource.php b/app-modules/panel-admin/src/Marketing/Resources/ShortLinks/ShortLinkResource.php index 686f703d1..c40f0d0df 100644 --- a/app-modules/panel-admin/src/Marketing/Resources/ShortLinks/ShortLinkResource.php +++ b/app-modules/panel-admin/src/Marketing/Resources/ShortLinks/ShortLinkResource.php @@ -11,6 +11,7 @@ use Filament\Support\Icons\Heroicon; use Filament\Tables\Table; use He4rt\Marketing\ShortLink\Models\ShortLink; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Marketing\MarketingCluster; use He4rt\PanelAdmin\Marketing\Resources\ShortLinks\Pages\CreateShortLink; use He4rt\PanelAdmin\Marketing\Resources\ShortLinks\Pages\EditShortLink; @@ -24,6 +25,8 @@ class ShortLinkResource extends Resource { + use SuperAdminOnly; + protected static ?string $model = ShortLink::class; protected static ?string $cluster = MarketingCluster::class; diff --git a/app-modules/panel-admin/src/Moderation/Pages/AppealQueuePage.php b/app-modules/panel-admin/src/Moderation/Pages/AppealQueuePage.php index 4a551be8e..5d15bd5a7 100644 --- a/app-modules/panel-admin/src/Moderation/Pages/AppealQueuePage.php +++ b/app-modules/panel-admin/src/Moderation/Pages/AppealQueuePage.php @@ -8,10 +8,13 @@ use Filament\Pages\Page; use Filament\Support\Enums\Width; use Filament\Support\Icons\Heroicon; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Moderation\ModerationCluster; class AppealQueuePage extends Page { + use SuperAdminOnly; + protected static ?string $cluster = ModerationCluster::class; protected Width|string|null $maxContentWidth = Width::Full; diff --git a/app-modules/panel-admin/src/Moderation/Pages/AuditLogPage.php b/app-modules/panel-admin/src/Moderation/Pages/AuditLogPage.php index 5cae9877f..a0b9c86e4 100644 --- a/app-modules/panel-admin/src/Moderation/Pages/AuditLogPage.php +++ b/app-modules/panel-admin/src/Moderation/Pages/AuditLogPage.php @@ -12,11 +12,13 @@ use Filament\Tables\Contracts\HasTable; use Filament\Tables\Table; use He4rt\Moderation\Audit\ModerationAuditLog; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Moderation\ModerationCluster; class AuditLogPage extends Page implements HasTable { use InteractsWithTable; + use SuperAdminOnly; protected static ?string $cluster = ModerationCluster::class; diff --git a/app-modules/panel-admin/src/Moderation/Pages/ModerationDashboard.php b/app-modules/panel-admin/src/Moderation/Pages/ModerationDashboard.php index b2b508c05..cca6b2dd8 100644 --- a/app-modules/panel-admin/src/Moderation/Pages/ModerationDashboard.php +++ b/app-modules/panel-admin/src/Moderation/Pages/ModerationDashboard.php @@ -8,10 +8,13 @@ use Filament\Pages\Page; use Filament\Support\Enums\Width; use Filament\Support\Icons\Heroicon; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Moderation\ModerationCluster; class ModerationDashboard extends Page { + use SuperAdminOnly; + protected static ?string $cluster = ModerationCluster::class; protected Width|string|null $maxContentWidth = Width::Full; diff --git a/app-modules/panel-admin/src/Moderation/Pages/ModerationQueuePage.php b/app-modules/panel-admin/src/Moderation/Pages/ModerationQueuePage.php index f384474e2..2d9f7ab84 100644 --- a/app-modules/panel-admin/src/Moderation/Pages/ModerationQueuePage.php +++ b/app-modules/panel-admin/src/Moderation/Pages/ModerationQueuePage.php @@ -8,10 +8,13 @@ use Filament\Pages\Page; use Filament\Support\Enums\Width; use Filament\Support\Icons\Heroicon; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Moderation\ModerationCluster; class ModerationQueuePage extends Page { + use SuperAdminOnly; + protected static ?string $cluster = ModerationCluster::class; protected Width|string|null $maxContentWidth = Width::Full; diff --git a/app-modules/panel-admin/src/Moderation/Resources/ModerationAppealResource.php b/app-modules/panel-admin/src/Moderation/Resources/ModerationAppealResource.php index d3e8a75dd..8ea865546 100644 --- a/app-modules/panel-admin/src/Moderation/Resources/ModerationAppealResource.php +++ b/app-modules/panel-admin/src/Moderation/Resources/ModerationAppealResource.php @@ -14,12 +14,15 @@ use Filament\Tables\Table; use He4rt\Moderation\Appeals\ModerationAppeal; use He4rt\Moderation\Enums\AppealStatus; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Moderation\ModerationCluster; use He4rt\PanelAdmin\Moderation\Resources\ModerationAppealResource\Pages\ListModerationAppeals; use He4rt\PanelAdmin\Moderation\Resources\ModerationAppealResource\Pages\ViewModerationAppeal; class ModerationAppealResource extends Resource { + use SuperAdminOnly; + protected static ?string $cluster = ModerationCluster::class; protected static ?string $model = ModerationAppeal::class; diff --git a/app-modules/panel-admin/src/Moderation/Resources/ModerationCaseResource.php b/app-modules/panel-admin/src/Moderation/Resources/ModerationCaseResource.php index 00a358deb..1ee8c4efa 100644 --- a/app-modules/panel-admin/src/Moderation/Resources/ModerationCaseResource.php +++ b/app-modules/panel-admin/src/Moderation/Resources/ModerationCaseResource.php @@ -16,12 +16,15 @@ use He4rt\Moderation\Enums\Platform; use He4rt\Moderation\Enums\Severity; use He4rt\Moderation\Enums\ViolationType; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Moderation\ModerationCluster; use He4rt\PanelAdmin\Moderation\Resources\ModerationCaseResource\Pages\ListModerationCases; use He4rt\PanelAdmin\Moderation\Resources\ModerationCaseResource\Pages\ViewModerationCase; class ModerationCaseResource extends Resource { + use SuperAdminOnly; + protected static ?string $cluster = ModerationCluster::class; protected static ?string $model = ModerationCase::class; diff --git a/app-modules/panel-admin/src/Moderation/Resources/ModerationRuleResource.php b/app-modules/panel-admin/src/Moderation/Resources/ModerationRuleResource.php index 41e618c2b..1bb0a84e2 100644 --- a/app-modules/panel-admin/src/Moderation/Resources/ModerationRuleResource.php +++ b/app-modules/panel-admin/src/Moderation/Resources/ModerationRuleResource.php @@ -24,6 +24,7 @@ use He4rt\Moderation\Enums\Severity; use He4rt\Moderation\Enums\ViolationType; use He4rt\Moderation\Rules\ModerationRule; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Moderation\ModerationCluster; use He4rt\PanelAdmin\Moderation\Resources\ModerationRuleResource\Pages\CreateModerationRule; use He4rt\PanelAdmin\Moderation\Resources\ModerationRuleResource\Pages\EditModerationRule; @@ -31,6 +32,8 @@ class ModerationRuleResource extends Resource { + use SuperAdminOnly; + protected static ?string $cluster = ModerationCluster::class; protected static ?string $model = ModerationRule::class; diff --git a/app-modules/panel-admin/src/Twitch/Pages/TwitchDashboard.php b/app-modules/panel-admin/src/Twitch/Pages/TwitchDashboard.php index 2c723bb5f..06ceb200e 100644 --- a/app-modules/panel-admin/src/Twitch/Pages/TwitchDashboard.php +++ b/app-modules/panel-admin/src/Twitch/Pages/TwitchDashboard.php @@ -8,6 +8,7 @@ use Filament\Pages\Page; use Filament\Support\Enums\Width; use Filament\Support\Icons\Heroicon; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Twitch\TwitchCluster; use He4rt\PanelAdmin\Twitch\Widgets\EventsByTypeChartWidget; use He4rt\PanelAdmin\Twitch\Widgets\EventsPerDayChartWidget; @@ -15,6 +16,8 @@ class TwitchDashboard extends Page { + use SuperAdminOnly; + protected static ?string $cluster = TwitchCluster::class; protected Width|string|null $maxContentWidth = Width::Full; diff --git a/app-modules/panel-admin/src/Twitch/Resources/TwitchEventLogResource.php b/app-modules/panel-admin/src/Twitch/Resources/TwitchEventLogResource.php index d8ccd6e8d..e45141343 100644 --- a/app-modules/panel-admin/src/Twitch/Resources/TwitchEventLogResource.php +++ b/app-modules/panel-admin/src/Twitch/Resources/TwitchEventLogResource.php @@ -17,12 +17,15 @@ use Filament\Tables\Table; use He4rt\IntegrationTwitch\Enums\TwitchEventSubType; use He4rt\IntegrationTwitch\Models\TwitchEventLog; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Twitch\Resources\TwitchEventLogResource\Pages\ListTwitchEventLogs; use He4rt\PanelAdmin\Twitch\Resources\TwitchEventLogResource\Pages\ViewTwitchEventLog; use He4rt\PanelAdmin\Twitch\TwitchCluster; class TwitchEventLogResource extends Resource { + use SuperAdminOnly; + protected static ?string $cluster = TwitchCluster::class; protected static ?string $model = TwitchEventLog::class; diff --git a/app-modules/panel-admin/src/Twitch/Resources/TwitchSubscriptionResource.php b/app-modules/panel-admin/src/Twitch/Resources/TwitchSubscriptionResource.php index bd34aaf81..b222b73f5 100644 --- a/app-modules/panel-admin/src/Twitch/Resources/TwitchSubscriptionResource.php +++ b/app-modules/panel-admin/src/Twitch/Resources/TwitchSubscriptionResource.php @@ -17,12 +17,15 @@ use He4rt\IntegrationTwitch\Models\TwitchSubscription; use He4rt\IntegrationTwitch\Transport\Requests\EventSub\DeleteSubscription; use He4rt\IntegrationTwitch\Transport\TwitchHelixConnector; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; use He4rt\PanelAdmin\Twitch\Resources\TwitchSubscriptionResource\Pages\ListTwitchSubscriptions; use He4rt\PanelAdmin\Twitch\TwitchCluster; use Saloon\Exceptions\Request\RequestException; class TwitchSubscriptionResource extends Resource { + use SuperAdminOnly; + protected static ?string $cluster = TwitchCluster::class; protected static ?string $model = TwitchSubscription::class; diff --git a/app-modules/panel-admin/src/Twitch/TwitchCluster.php b/app-modules/panel-admin/src/Twitch/TwitchCluster.php index 0c491ae96..428334bd8 100644 --- a/app-modules/panel-admin/src/Twitch/TwitchCluster.php +++ b/app-modules/panel-admin/src/Twitch/TwitchCluster.php @@ -7,9 +7,12 @@ use BackedEnum; use Filament\Clusters\Cluster; use Filament\Support\Icons\Heroicon; +use He4rt\PanelAdmin\Concerns\SuperAdminOnly; class TwitchCluster extends Cluster { + use SuperAdminOnly; + protected static string|BackedEnum|null $navigationIcon = Heroicon::OutlinedTv; protected static ?int $navigationSort = 30; diff --git a/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php b/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php new file mode 100644 index 000000000..744f3b152 --- /dev/null +++ b/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php @@ -0,0 +1,72 @@ + + */ +function adminComponents(): array +{ + $panel = Filament::getPanel('admin'); + + return collect([...$panel->getResources(), ...$panel->getPages()]) + ->reject(fn (string $component): bool => is_subclass_of($component, Cluster::class)) + ->values() + ->all(); +} + +test('super admin acessa todo Resource e Page do admin', function (): void { + actingAs(User::factory()->superAdmin()->create()); + + foreach (adminComponents() as $component) { + expect($component::canAccess())->toBeTrue($component); + } +}); + +test('fora de produção, quem entra no admin sem papel só acessa o Dashboard', function (): void { + actingAs(User::factory()->create()); + + foreach (adminComponents() as $component) { + expect($component::canAccess())->toBe($component === Dashboard::class, $component); + } +}); + +test('os clusters somem da navegação de quem não é super admin', function (): void { + actingAs(User::factory()->create()); + + foreach (Filament::getPanel('admin')->getPages() as $component) { + if (is_subclass_of($component, Cluster::class)) { + expect($component::canAccessClusteredComponents())->toBeFalse($component); + } + } +}); + +test('os widgets do Dashboard são só de super admin', function (): void { + actingAs(User::factory()->create()); + expect(ActivityTimelineWidget::canView())->toBeFalse(); + + actingAs(User::factory()->superAdmin()->create()); + expect(ActivityTimelineWidget::canView())->toBeTrue(); +}); + +test('quem não é super admin recebe 403 ao abrir uma tela restrita', function (): void { + actingAs(User::factory()->create()); + + $this->get(Dashboard::getUrl())->assertOk(); + $this->get('/admin/users')->assertForbidden(); +}); diff --git a/app-modules/panel-admin/tests/Feature/Marketing/LocationDashboardTest.php b/app-modules/panel-admin/tests/Feature/Marketing/LocationDashboardTest.php index ee8c03bc0..d3af3e7b1 100644 --- a/app-modules/panel-admin/tests/Feature/Marketing/LocationDashboardTest.php +++ b/app-modules/panel-admin/tests/Feature/Marketing/LocationDashboardTest.php @@ -22,7 +22,7 @@ ]), ]); - $admin = User::factory()->create(); + $admin = User::factory()->superAdmin()->create(); $this->actingAs($admin); Filament::setCurrentPanel(Filament::getPanel('admin')); diff --git a/app-modules/panel-admin/tests/Feature/Marketing/MeetingShowcasePageTest.php b/app-modules/panel-admin/tests/Feature/Marketing/MeetingShowcasePageTest.php index 3301a131d..0249b8c55 100644 --- a/app-modules/panel-admin/tests/Feature/Marketing/MeetingShowcasePageTest.php +++ b/app-modules/panel-admin/tests/Feature/Marketing/MeetingShowcasePageTest.php @@ -15,7 +15,7 @@ beforeEach(function (): void { config(['app.display_timezone' => 'America/Sao_Paulo']); - $admin = User::factory()->create(); + $admin = User::factory()->superAdmin()->create(); $this->actingAs($admin); Filament::setCurrentPanel(Filament::getPanel('admin')); From ffde992e4e36a9d8af61fd4f71a52de98159d5fe Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Wed, 7 Oct 2026 16:02:17 -0300 Subject: [PATCH 16/77] feat(panel-admin): sidebar do admin respeita o canAccess() MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit O buildNavigation() montava os itens com getNavigationItems(), que não checa o canAccess(): o item aparecia e dava 403 no clique. O helper itemsFor() só devolve os itens de quem pode acessar (clusters pelo canAccessClusteredComponents()). --- .../src/PanelAdminServiceProvider.php | 51 +++++++++++++------ .../AdminComponentAccessTest.php | 13 +++++ 2 files changed, 49 insertions(+), 15 deletions(-) diff --git a/app-modules/panel-admin/src/PanelAdminServiceProvider.php b/app-modules/panel-admin/src/PanelAdminServiceProvider.php index 629479e9c..714f16ce4 100644 --- a/app-modules/panel-admin/src/PanelAdminServiceProvider.php +++ b/app-modules/panel-admin/src/PanelAdminServiceProvider.php @@ -4,10 +4,13 @@ namespace He4rt\PanelAdmin; +use Filament\Clusters\Cluster; use Filament\Navigation\NavigationBuilder; use Filament\Navigation\NavigationGroup; use Filament\Navigation\NavigationItem; +use Filament\Pages\Page; use Filament\Panel; +use Filament\Resources\Resource as FilamentResource; use Filament\Support\Assets\AlpineComponent; use Filament\Support\Facades\FilamentAsset; use He4rt\PanelAdmin\Contributions\Widgets\ActivityTimelineWidget; @@ -155,34 +158,52 @@ private function defaultNavigation(NavigationBuilder $builder): NavigationBuilde { return $builder ->items([ - ...Dashboard::getNavigationItems(), - ...ModerationCluster::getNavigationItems(), - ...MarketingCluster::getNavigationItems(), - ...TwitchCluster::getNavigationItems(), - ...GithubCluster::getNavigationItems(), - ...DiscordCluster::getNavigationItems(), - ...EventResource::getNavigationItems(), + ...$this->itemsFor(Dashboard::class), + ...$this->itemsFor(ModerationCluster::class), + ...$this->itemsFor(MarketingCluster::class), + ...$this->itemsFor(TwitchCluster::class), + ...$this->itemsFor(GithubCluster::class), + ...$this->itemsFor(DiscordCluster::class), + ...$this->itemsFor(EventResource::class), ]) ->groups([ NavigationGroup::make(NavGroup::People->getLabel()) ->icon(NavGroup::People->getIcon()) ->items([ - ...UserResource::getNavigationItems(), - ...ExternalIdentityResource::getNavigationItems(), - ...ProfileResource::getNavigationItems(), - ...SkillResource::getNavigationItems(), + ...$this->itemsFor(UserResource::class), + ...$this->itemsFor(ExternalIdentityResource::class), + ...$this->itemsFor(ProfileResource::class), + ...$this->itemsFor(SkillResource::class), ]), NavigationGroup::make(NavGroup::Content->getLabel()) ->icon(NavGroup::Content->getIcon()) ->items([ - ...ContentEntryResource::getNavigationItems(), - ...InteractionResource::getNavigationItems(), - ...RetrospectiveResource::getNavigationItems(), - ...AlbumResource::getNavigationItems(), + ...$this->itemsFor(ContentEntryResource::class), + ...$this->itemsFor(InteractionResource::class), + ...$this->itemsFor(RetrospectiveResource::class), + ...$this->itemsFor(AlbumResource::class), ]), ]); } + /** + * Itens de navegação de um Resource, Page ou Cluster, só se a pessoa pode + * acessá-lo. O `getNavigationItems()` não checa o `canAccess()` (quem checa é + * o `registerNavigationItems()`, que a navegação montada na mão não usa), e + * sem isso o item aparece na sidebar e dá 403 no clique (ADR-0003 do identity). + * + * @param class-string|class-string $component + * @return array + */ + private function itemsFor(string $component): array + { + $isAccessible = is_subclass_of($component, Cluster::class) + ? $component::canAccessClusteredComponents() + : $component::canAccess(); + + return $isAccessible ? $component::getNavigationItems() : []; + } + private function moderationNavigation(NavigationBuilder $builder): NavigationBuilder { return $builder->items([ diff --git a/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php b/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php index 744f3b152..69d1212cf 100644 --- a/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php +++ b/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php @@ -4,6 +4,8 @@ use Filament\Clusters\Cluster; use Filament\Facades\Filament; +use Filament\Navigation\NavigationGroup; +use Filament\Navigation\NavigationItem; use He4rt\Identity\User\Models\User; use He4rt\PanelAdmin\Contributions\Widgets\ActivityTimelineWidget; use He4rt\PanelAdmin\Pages\Dashboard; @@ -70,3 +72,14 @@ function adminComponents(): array $this->get(Dashboard::getUrl())->assertOk(); $this->get('/admin/users')->assertForbidden(); }); + +test('a sidebar só mostra o que a pessoa pode acessar', function (): void { + actingAs(User::factory()->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']); +}); From a17fab27d132dfa6078139b169f7382592e89bf7 Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Wed, 7 Oct 2026 16:06:06 -0300 Subject: [PATCH 17/77] refactor(he4rt): marca He4rt Delas no design system MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit A logo, a tag e o ícone `he4rt-delas` saem do panel-app e vão para o módulo he4rt (x-he4rt::delas.logo, x-he4rt::delas.tag e o set de ícones registrado no He4rtServiceProvider), para os dois painéis usarem sem um depender das views do outro. A paleta --color-delas-* entra também no tema do /admin. --- .../{panel-app => he4rt}/resources/svg/delas.svg | 0 .../views/components/delas/logo.blade.php | 0 .../views/components/delas/tag.blade.php | 2 +- app-modules/he4rt/src/He4rtServiceProvider.php | 9 ++++++++- .../components/profile-preview-card.blade.php | 2 +- .../livewire/delas/profile-section.blade.php | 4 ++-- .../views/livewire/delas/request-modal.blade.php | 2 +- .../resources/views/pages/delas/heading.blade.php | 2 +- .../panel-app/src/PanelAppServiceProvider.php | 9 --------- resources/css/filament/admin/theme.css | 15 +++++++++++++++ 10 files changed, 29 insertions(+), 16 deletions(-) rename app-modules/{panel-app => he4rt}/resources/svg/delas.svg (100%) rename app-modules/{panel-app => he4rt}/resources/views/components/delas/logo.blade.php (100%) rename app-modules/{panel-app => he4rt}/resources/views/components/delas/tag.blade.php (80%) diff --git a/app-modules/panel-app/resources/svg/delas.svg b/app-modules/he4rt/resources/svg/delas.svg similarity index 100% rename from app-modules/panel-app/resources/svg/delas.svg rename to app-modules/he4rt/resources/svg/delas.svg diff --git a/app-modules/panel-app/resources/views/components/delas/logo.blade.php b/app-modules/he4rt/resources/views/components/delas/logo.blade.php similarity index 100% rename from app-modules/panel-app/resources/views/components/delas/logo.blade.php rename to app-modules/he4rt/resources/views/components/delas/logo.blade.php diff --git a/app-modules/panel-app/resources/views/components/delas/tag.blade.php b/app-modules/he4rt/resources/views/components/delas/tag.blade.php similarity index 80% rename from app-modules/panel-app/resources/views/components/delas/tag.blade.php rename to app-modules/he4rt/resources/views/components/delas/tag.blade.php index efb5d6b13..2b82071b3 100644 --- a/app-modules/panel-app/resources/views/components/delas/tag.blade.php +++ b/app-modules/he4rt/resources/views/components/delas/tag.blade.php @@ -10,6 +10,6 @@ ]) }} > - $size === 'lg', 'h-3' => $size !== 'lg']) /> + $size === 'lg', 'h-3' => $size !== 'lg']) /> He4rt Delas diff --git a/app-modules/he4rt/src/He4rtServiceProvider.php b/app-modules/he4rt/src/He4rtServiceProvider.php index c44e2fb0e..04b23a423 100644 --- a/app-modules/he4rt/src/He4rtServiceProvider.php +++ b/app-modules/he4rt/src/He4rtServiceProvider.php @@ -4,11 +4,18 @@ namespace He4rt\Core; +use BladeUI\Icons\Factory as IconFactory; use Illuminate\Support\ServiceProvider; class He4rtServiceProvider extends ServiceProvider { - public function register(): void {} + public function register(): void + { + // Ícones de marca como set `he4rt` (ex.: `he4rt-delas`, com a 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 { diff --git a/app-modules/panel-app/resources/views/components/profile-preview-card.blade.php b/app-modules/panel-app/resources/views/components/profile-preview-card.blade.php index 01aec310b..a7fb3f96d 100644 --- a/app-modules/panel-app/resources/views/components/profile-preview-card.blade.php +++ b/app-modules/panel-app/resources/views/components/profile-preview-card.blade.php @@ -148,7 +148,7 @@ class="inline-flex items-center gap-1 rounded-full bg-green-50 px-2 py-0.5 text-

@endif @if ($hasDelasTag) -
+
@endif
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 2d2127fa6..476d1d744 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 @@ -11,7 +11,7 @@ - + {{ __('panel-app::delas.name') }} @@ -76,7 +76,7 @@ {{ __('panel-app::delas.profile.member_title') }} {{ __('panel-app::delas.profile.member_body') }} -
+
@break diff --git a/app-modules/panel-app/resources/views/livewire/delas/request-modal.blade.php b/app-modules/panel-app/resources/views/livewire/delas/request-modal.blade.php index e7c6704cc..b42105bbc 100644 --- a/app-modules/panel-app/resources/views/livewire/delas/request-modal.blade.php +++ b/app-modules/panel-app/resources/views/livewire/delas/request-modal.blade.php @@ -1,6 +1,6 @@
- +

{{ __('panel-app::delas.profile.modal.what') }}

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( + '

'.e($this->text('panel-admin::delas.actions.message_label')).' '.e($this->originalOf($record)?->reason).'

', + )) + ->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 $this->text('panel-admin::delas.actions.original_reason', ['reason' => $record->corrected->reason]); + 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. + */ + private function reasonNote(DelasTransition $record): ?HtmlString + { + if (!$this->originalOf($record) instanceof DelasTransition) { + return null; } + $link = ''.e($this->text('panel-admin::delas.actions.view_original')).''; $correction = $record->latestCorrection; if (!$correction instanceof DelasTransition) { - return null; + return new HtmlString($link); } - return $this->text('panel-admin::delas.actions.corrected_note', [ + 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 ?? '—', - ]).' · '.$this->text('panel-admin::delas.actions.original_reason', ['reason' => $record->reason]); + ])).' · '.$link); + } + + /** + * Até quando quem escreveu pode corrigir; a líder corrige sempre. + */ + private function correctionWindowNote(DelasTransition $record): string + { + if ($this->isLead()) { + return $this->text('panel-admin::delas.actions.correct_anytime'); + } + + return $this->text('panel-admin::delas.actions.correct_until', [ + 'date' => $this->displayDate($record->created_at?->copy()->addHours(config()->integer('delas.reason_correction_hours'))), + ]); + } + + private function displayDate(?CarbonInterface $date): string + { + return $date?->timezone(config('app.display_timezone'))->format('d/m/Y H:i') ?? '—'; } } 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 37f07f5c5..b0600f16b 100644 --- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php +++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php @@ -369,7 +369,10 @@ 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.original_reason', ['reason' => 'Perfil incompleo.'])); + ->assertSee(__('panel-admin::delas.actions.view_original')) + ->mountAction(TestAction::make('viewOriginal')->table($own)) + ->assertActionMounted(TestAction::make('viewOriginal')->table($own)) + ->assertMountedActionModalSee('Perfil incompleo.'); expect($own->fresh()->reason)->toBe('Perfil incompleo.') ->and($own->fresh()->currentReason())->toBe('Perfil incompleto.'); @@ -422,3 +425,18 @@ function mountedPersonSelect(Testable $page): Select ->and($block->reason)->toBe('Perfil falso.') ->and($other->fresh()->status)->toBe(DelasRequestStatus::Revoked); }); + +test('o botão de corrigir avisa até quando a moderadora pode corrigir', function (): void { + $this->freezeTime(); + $moderator = User::factory()->delasModerator()->create(); + $this->actingAs($moderator); + $own = DelasTransition::factory()->create(['action' => DelasAction::Rejected, 'actor_id' => $moderator->getKey(), 'reason' => 'Motivo.']); + DelasTransition::factory()->create(['action' => DelasAction::Rejected, 'reason' => 'Outro.']); + + $deadline = now()->addHours(config()->integer('delas.reason_correction_hours'))->timezone(config('app.display_timezone'))->format('d/m/Y H:i'); + + livewire(DelasHistoryPage::class) + ->loadTable() + ->mountAction(TestAction::make('correctReason')->table($own)) + ->assertMountedActionModalSee(__('panel-admin::delas.actions.correct_until', ['date' => $deadline])); +}); From 59774bb5c140dd36194f5a65ab5166103361eabd Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Wed, 7 Oct 2026 19:04:41 -0300 Subject: [PATCH 36/77] =?UTF-8?q?feat(panel-admin):=20vers=C3=B5es=20do=20?= =?UTF-8?q?motivo=20numa=20linha=20do=20tempo,=20s=C3=B3=20para=20a=20lide?= =?UTF-8?q?ran=C3=A7a?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../src/History/Models/DelasTransition.php | 15 +++- app-modules/panel-admin/lang/en/delas.php | 8 +- app-modules/panel-admin/lang/pt_BR/delas.php | 8 +- .../delas/reason-versions.blade.php | 33 ++++++++ .../Pages/Delas/DelasHistoryPage.php | 79 ++++++++----------- .../Delas/DelasModerationPagesTest.php | 37 ++++++--- 6 files changed, 115 insertions(+), 65 deletions(-) create mode 100644 app-modules/panel-admin/resources/views/moderation/delas/reason-versions.blade.php diff --git a/app-modules/delas/src/History/Models/DelasTransition.php b/app-modules/delas/src/History/Models/DelasTransition.php index 092a8fbf8..8c17f54d1 100644 --- a/app-modules/delas/src/History/Models/DelasTransition.php +++ b/app-modules/delas/src/History/Models/DelasTransition.php @@ -14,10 +14,12 @@ use He4rt\Identity\User\Models\User; use Illuminate\Database\Eloquent\Attributes\Table; use Illuminate\Database\Eloquent\Attributes\UseFactory; +use Illuminate\Database\Eloquent\Collection; use Illuminate\Database\Eloquent\Concerns\HasUuids; use Illuminate\Database\Eloquent\Factories\HasFactory; use Illuminate\Database\Eloquent\Model; use Illuminate\Database\Eloquent\Relations\BelongsTo; +use Illuminate\Database\Eloquent\Relations\HasMany; use Illuminate\Database\Eloquent\Relations\HasOne; /** @@ -37,6 +39,7 @@ * @property string|null $reason * @property CarbonInterface|null $created_at * @property-read DelasTransition|null $latestCorrection + * @property-read Collection $corrections */ #[Table(name: 'delas_transitions')] #[UseFactory(factoryClass: DelasTransitionFactory::class)] @@ -95,6 +98,16 @@ public function corrected(): BelongsTo return $this->belongsTo(self::class, 'corrects_id'); } + /** + * Todas as edições do motivo desta linha, da mais antiga para a mais recente. + * + * @return HasMany + */ + public function corrections(): HasMany + { + return $this->hasMany(self::class, 'corrects_id')->oldest('created_at'); + } + /** * A correção mais recente do motivo desta linha, se houver. * @@ -111,7 +124,7 @@ public function latestCorrection(): HasOne */ public function currentReason(): ?string { - $correction = $this->latestCorrection; + $correction = $this->relationLoaded('corrections') ? $this->corrections->last() : $this->latestCorrection; return $correction instanceof self ? $correction->reason : $this->reason; } diff --git a/app-modules/panel-admin/lang/en/delas.php b/app-modules/panel-admin/lang/en/delas.php index f7d453816..ee506c9b8 100644 --- a/app-modules/panel-admin/lang/en/delas.php +++ b/app-modules/panel-admin/lang/en/delas.php @@ -72,9 +72,11 @@ '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.', + 'view_versions' => 'view versions', + 'versions_heading' => 'Reason versions', + 'version_original' => 'Original', + 'version_edit' => 'Edit #:number', + 'version_current' => 'current', 'close' => 'Close', 'correct_until' => 'You can edit it until :date.', 'correct_anytime' => 'As a lead, you can edit it at any time.', diff --git a/app-modules/panel-admin/lang/pt_BR/delas.php b/app-modules/panel-admin/lang/pt_BR/delas.php index f3ba0eb1c..73bf87254 100644 --- a/app-modules/panel-admin/lang/pt_BR/delas.php +++ b/app-modules/panel-admin/lang/pt_BR/delas.php @@ -72,9 +72,11 @@ '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.', + 'view_versions' => 'ver versões', + 'versions_heading' => 'Versões do motivo', + 'version_original' => 'Original', + 'version_edit' => ':numberª edição', + 'version_current' => 'vale hoje', 'close' => 'Fechar', 'correct_until' => 'Você pode editar até :date.', 'correct_anytime' => 'Como líder, você edita a qualquer momento.', 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 new file mode 100644 index 000000000..13f0d17d3 --- /dev/null +++ b/app-modules/panel-admin/resources/views/moderation/delas/reason-versions.blade.php @@ -0,0 +1,33 @@ +{{-- Versões do motivo de uma decisão, numa linha do tempo: a original primeiro, a que vale hoje por último. --}} +
    + @foreach ($versions as $version) +
  1. + $loop->first && ! $loop->last, + 'bg-info-500' => ! $loop->first && ! $loop->last, + 'bg-success-500' => $loop->last, + ])> + +
    + + {{ $loop->first ? __('panel-admin::delas.actions.version_original') : __('panel-admin::delas.actions.version_edit', ['number' => $loop->index]) }} + + + @if ($loop->last) + + {{ __('panel-admin::delas.actions.version_current') }} + + @endif + + + {{ $version->actor->name ?? '—' }} · {{ $version->created_at?->timezone(config('app.display_timezone'))->format('d/m/Y H:i') }} + +
    + +

    + {{ __('panel-admin::delas.actions.message_label') }} {{ $version->reason }} +

    +
  2. + @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( - '

'.e($this->text('panel-admin::delas.actions.message_label')).' '.e($this->originalOf($record)?->reason).'

', - )) + 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') }} +
+ + {{ __('panel-app::delas.profile.discord_connect') }} + +
+
+ @break @endswitch
diff --git a/app-modules/panel-app/resources/views/livewire/delas/request-modal.blade.php b/app-modules/panel-app/resources/views/livewire/delas/request-modal.blade.php index b42105bbc..ebc3769ce 100644 --- a/app-modules/panel-app/resources/views/livewire/delas/request-modal.blade.php +++ b/app-modules/panel-app/resources/views/livewire/delas/request-modal.blade.php @@ -10,4 +10,6 @@
  • {{ $step }}
  • @endforeach + +

    {{ __('panel-app::delas.profile.modal.tip') }}

    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. --}} +
    +
    + +
    +

    {{ $person->name }}

    +

    {{ '@'.$person->username }}

    +
    +
    + +
    + @if ($profile?->headline) +
    +
    {{ __('panel-admin::delas.profile.headline') }}
    +
    {{ $profile->headline }}
    +
    + @endif + + @if ($profile?->seniority_level || $profile?->years_experience) +
    +
    {{ __('panel-admin::delas.profile.seniority') }}
    +
    + {{ collect([$profile->seniority_level?->getLabel(), $profile->years_experience !== null ? trans_choice('panel-admin::delas.profile.years', $profile->years_experience, ['years' => $profile->years_experience]) : null])->filter()->implode(' · ') }} +
    +
    + @endif + + @if ($profile?->about) +
    +
    {{ __('panel-admin::delas.profile.about') }}
    +
    {{ $profile->about }}
    +
    + @endif + + @unless ($hasProfile) +

    {{ __('panel-admin::delas.profile.empty') }}

    + @endunless + +
    +
    {{ __('panel-admin::delas.profile.discord') }}
    +
    + @if ($discord && $discord->external_account_id) + + {{ $discordName }} + + @else + {{ __('panel-admin::delas.profile.discord_none') }} + @endif +
    +
    + +
    +
    {{ __('panel-admin::delas.profile.since') }}
    +
    + {{ $person->created_at?->timezone(config('app.display_timezone'))->format('d/m/Y') }} +
    +
    +
    + +

    {{ __('panel-admin::delas.profile.note') }}

    +
    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 33dbb8fe7..29ce5a286 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 @@ -5,18 +5,23 @@ namespace He4rt\PanelAdmin\Moderation\Pages\Delas\Concerns; use Closure; +use Filament\Actions\Action; use Filament\Forms\Components\Textarea; use Filament\Forms\Components\Toggle; use Filament\Notifications\Notification; use Filament\Schemas\Components\EmbeddedTable; use Filament\Schemas\Schema; +use Filament\Support\Enums\Width; use Filament\Tables\Columns\TextColumn; use He4rt\Delas\Exceptions\DelasException; use He4rt\Delas\Support\Reason; use He4rt\Identity\User\Models\User; use Illuminate\Auth\Access\AuthorizationException; use Illuminate\Contracts\Support\Htmlable; +use Illuminate\Contracts\View\View; +use Illuminate\Database\Eloquent\Model; use Illuminate\Support\HtmlString; +use Illuminate\Support\Str; /** * O que as páginas da He4rt Delas no cluster de Moderação têm em comum: o grupo @@ -47,13 +52,42 @@ protected function isLead(): bool return $this->actor()->can('lead-delas'); } + /** + * Nome, @username e "Ver perfil": clicar abre um resumo só leitura do perfil, + * sem sair da página. + */ protected function personColumn(string $name, string $username, string $label): TextColumn { + $relation = str_contains($name, '.') ? Str::before($name, '.') : null; + return TextColumn::make($name) ->label($label) ->weight('medium') - ->description(fn (mixed $record): string => '@'.data_get($record, $username)) - ->searchable([str_contains($name, '.') ? 'name' : $name]); + ->description(fn (mixed $record): HtmlString => new HtmlString( + e('@'.data_get($record, $username)).' · '.e($this->text('panel-admin::delas.actions.view_profile')).'', + )) + ->action($this->viewProfileAction($relation)) + ->searchable([$relation === null ? $name : 'name']); + } + + /** + * O que a moderação precisa para decidir, e nada além: sem e-mail, data de + * nascimento nem localização. A pessoa é carregada sozinha, com o perfil e + * as conexões, só quando o resumo abre. + */ + protected function viewProfileAction(?string $relation): Action + { + return Action::make('viewProfile') + ->modalHeading(__('panel-admin::delas.profile.heading')) + ->slideOver() + ->modalWidth(Width::Medium) + ->modalContent(fn (Model $record): View => view('panel-admin::moderation.delas.person-profile', [ + 'person' => User::query() + ->with(['profile', 'providers']) + ->findOrFail($relation === null ? $record->getKey() : $record->getAttribute($relation.'_id')), + ])) + ->modalSubmitAction(action: false) + ->modalCancelActionLabel(__('panel-admin::delas.actions.close')); } protected function dateColumn(string $name, string $label): TextColumn 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 edb85557a..cacd7fdcc 100644 --- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php +++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php @@ -485,3 +485,28 @@ function mountedPersonSelect(Testable $page): Select expect($block->fresh()->isActive())->toBeTrue(); }); + +test('"Ver perfil" abre um resumo só leitura, sem dados pessoais', function (): void { + $this->actingAs(User::factory()->delasModerator()->create()); + $person = User::factory()->withDiscord()->create(['email' => 'pessoa@exemplo.test']); + $person->profile->update(['headline' => 'Dev Back-end', 'about' => 'Gosto de PHP.', 'birthdate' => '1990-05-20']); + [$request] = [DelasTagRequest::factory()->for($person)->pending()->create(), DelasTagRequest::factory()->pending()->create()]; + + livewire(DelasQueuePage::class) + ->loadTable() + ->assertSee(__('panel-admin::delas.actions.view_profile')) + ->mountAction(TestAction::make('viewProfile')->table($request)) + ->assertMountedActionModalSee(['Dev Back-end', 'Gosto de PHP.', __('panel-admin::delas.profile.discord')]) + ->assertMountedActionModalDontSee(['pessoa@exemplo.test', '20/05/1990']); +}); + +test('"Ver perfil" funciona também na Equipe, onde a linha já é a pessoa', function (): void { + $this->actingAs(User::factory()->delasLead()->create()); + $moderator = User::factory()->delasModerator()->create(); + User::factory()->delasModerator()->create(); + + livewire(DelasTeamPage::class) + ->loadTable() + ->mountAction(TestAction::make('viewProfile')->table($moderator)) + ->assertMountedActionModalSee([$moderator->name, __('panel-admin::delas.profile.empty')]); +}); From dfd5c9dacef7df5edf912bf230f5be4a0fd5e889 Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Thu, 8 Oct 2026 12:25:36 -0300 Subject: [PATCH 51/77] =?UTF-8?q?fix(panel-admin):=20"Ver=20perfil"=20most?= =?UTF-8?q?ra=20as=20iniciais=20quando=20a=20foto=20n=C3=A3o=20carrega?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../views/moderation/delas/person-profile.blade.php | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) 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 index 4772ed6cc..eca230ab0 100644 --- 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 @@ -13,7 +13,13 @@ {{-- Resumo só leitura para a moderação decidir: sem e-mail, data de nascimento nem localização. --}}
    - + {{-- Sem foto, ou com um link de foto que não carrega mais, ficam as iniciais. --}} +
    + {{ collect(explode(' ', $person->name))->filter()->take(2)->map(fn (string $part): string => mb_strtoupper(mb_substr($part, 0, 1)))->implode('') }} + @if ($avatarUrl = $person->getFilamentAvatarUrl()) + + @endif +

    {{ $person->name }}

    {{ '@'.$person->username }}

    From 1aff56a7afd4944d5288fc1d043387927ad62689 Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Thu, 8 Oct 2026 12:30:18 -0300 Subject: [PATCH 52/77] =?UTF-8?q?feat(panel-admin):=20"Ver=20perfil"=20com?= =?UTF-8?q?o=20cart=C3=A3o,=20com=20a=20situa=C3=A7=C3=A3o=20na=20He4rt=20?= =?UTF-8?q?Delas?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../moderation/delas/person-profile.blade.php | 172 ++++++++++++------ .../Concerns/InteractsWithDelasModeration.php | 15 +- 2 files changed, 125 insertions(+), 62 deletions(-) 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 index eca230ab0..a78bc1da2 100644 --- 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 @@ -1,84 +1,140 @@ @php - /** @var \He4rt\Identity\User\Models\User $person */ + use He4rt\Identity\ExternalIdentity\Enums\IdentityProvider; + + /** + * @var \He4rt\Identity\User\Models\User $person + * @var \He4rt\Delas\TagRequest\ValueObjects\DelasEligibilityResult $eligibility + */ $profile = $person->profile; $discord = $person->providers - ->where('provider', \He4rt\Identity\ExternalIdentity\Enums\IdentityProvider::Discord) + ->where('provider', 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); + $initials = collect(explode(' ', $person->name)) + ->filter() + ->take(2) + ->map(fn (string $part): string => mb_strtoupper(mb_substr($part, 0, 1))) + ->implode(''); + $avatarUrl = $person->getFilamentAvatarUrl(); + $seniority = collect([ + $profile?->seniority_level?->getLabel(), + $profile?->years_experience !== null + ? trans_choice('panel-admin::delas.profile.years', $profile->years_experience, ['years' => $profile->years_experience]) + : null, + ])->filter()->implode(' · '); + $hasProfile = $profile?->headline || $seniority !== '' || $profile?->about; + $state = $eligibility->state; @endphp {{-- Resumo só leitura para a moderação decidir: sem e-mail, data de nascimento nem localização. --}} -
    -
    - {{-- Sem foto, ou com um link de foto que não carrega mais, ficam as iniciais. --}} -
    - {{ collect(explode(' ', $person->name))->filter()->take(2)->map(fn (string $part): string => mb_strtoupper(mb_substr($part, 0, 1)))->implode('') }} - @if ($avatarUrl = $person->getFilamentAvatarUrl()) - - @endif -
    -
    -

    {{ $person->name }}

    -

    {{ '@'.$person->username }}

    -
    -
    +
    + {{-- Cartão: faixa do Hub, foto (ou iniciais), nome e a situação na He4rt Delas. --}} +
    +
    -
    - @if ($profile?->headline) -
    -
    {{ __('panel-admin::delas.profile.headline') }}
    -
    {{ $profile->headline }}
    +
    +
    + {{ $initials }} + @if ($avatarUrl) + + @endif
    - @endif - @if ($profile?->seniority_level || $profile?->years_experience)
    -
    {{ __('panel-admin::delas.profile.seniority') }}
    -
    - {{ collect([$profile->seniority_level?->getLabel(), $profile->years_experience !== null ? trans_choice('panel-admin::delas.profile.years', $profile->years_experience, ['years' => $profile->years_experience]) : null])->filter()->implode(' · ') }} -
    +

    {{ $person->name }}

    +

    {{ '@'.$person->username }}

    - @endif - @if ($profile?->about) -
    -
    {{ __('panel-admin::delas.profile.about') }}
    -
    {{ $profile->about }}
    +
    + + {{ $state->getLabel() }} + + + @if ($state === \He4rt\Delas\TagRequest\Enums\DelasEligibilityState::Member) + + @endif
    - @endif +
    +
    - @unless ($hasProfile) + {{-- Perfil profissional --}} + @if ($hasProfile) +
    + @if ($profile?->headline) +
    + +
    +
    {{ __('panel-admin::delas.profile.headline') }}
    +
    {{ $profile->headline }}
    +
    +
    + @endif + + @if ($seniority !== '') +
    + +
    +
    {{ __('panel-admin::delas.profile.seniority') }}
    +
    {{ $seniority }}
    +
    +
    + @endif + + @if ($profile?->about) +
    +
    {{ __('panel-admin::delas.profile.about') }}
    +
    {{ $profile->about }}
    +
    + @endif +
    + @else +
    +

    {{ __('panel-admin::delas.profile.empty') }}

    - @endunless +
    + @endif -
    -
    {{ __('panel-admin::delas.profile.discord') }}
    -
    - @if ($discord && $discord->external_account_id) - - {{ $discordName }} - - @else - {{ __('panel-admin::delas.profile.discord_none') }} - @endif -
    + {{-- Comunidade --}} +
    +
    + +
    +
    {{ __('panel-admin::delas.profile.discord') }}
    +
    + @if ($discord && $discord->external_account_id) + + {{ $discordName }} + + + @else + {{ __('panel-admin::delas.profile.discord_none') }} + @endif +
    +
    -
    -
    {{ __('panel-admin::delas.profile.since') }}
    -
    - {{ $person->created_at?->timezone(config('app.display_timezone'))->format('d/m/Y') }} -
    +
    + +
    +
    {{ __('panel-admin::delas.profile.since') }}
    +
    + {{ $person->created_at?->timezone(config('app.display_timezone'))->format('d/m/Y') }} +
    +
    -

    {{ __('panel-admin::delas.profile.note') }}

    +

    + + {{ __('panel-admin::delas.profile.note') }} +

    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 29ce5a286..00a3e8e35 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 @@ -15,6 +15,7 @@ use Filament\Tables\Columns\TextColumn; use He4rt\Delas\Exceptions\DelasException; use He4rt\Delas\Support\Reason; +use He4rt\Delas\TagRequest\Queries\DelasEligibility; use He4rt\Identity\User\Models\User; use Illuminate\Auth\Access\AuthorizationException; use Illuminate\Contracts\Support\Htmlable; @@ -81,11 +82,17 @@ protected function viewProfileAction(?string $relation): Action ->modalHeading(__('panel-admin::delas.profile.heading')) ->slideOver() ->modalWidth(Width::Medium) - ->modalContent(fn (Model $record): View => view('panel-admin::moderation.delas.person-profile', [ - 'person' => User::query() + ->modalContent(function (Model $record) use ($relation): View { + $person = User::query() ->with(['profile', 'providers']) - ->findOrFail($relation === null ? $record->getKey() : $record->getAttribute($relation.'_id')), - ])) + ->whereKey($relation === null ? $record->getKey() : $record->getAttribute($relation.'_id')) + ->firstOrFail(); + + return view('panel-admin::moderation.delas.person-profile', [ + 'person' => $person, + 'eligibility' => resolve(DelasEligibility::class)->for($person), + ]); + }) ->modalSubmitAction(action: false) ->modalCancelActionLabel(__('panel-admin::delas.actions.close')); } From 2b2f14745a8b90606b7708cf39e43352568f44ec Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Thu, 8 Oct 2026 12:31:24 -0300 Subject: [PATCH 53/77] =?UTF-8?q?feat(panel-app):=20logo=20do=20Discord=20?= =?UTF-8?q?no=20bot=C3=A3o=20de=20conectar?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../resources/views/livewire/delas/profile-section.blade.php | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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 8f148f889..2df2ad2bf 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 @@ -105,7 +105,7 @@ {{ __('panel-app::delas.profile.discord_connect') }} From 3f4f73e11eb315ac7e55f9385d6db18c2fccbae9 Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Thu, 8 Oct 2026 12:40:59 -0300 Subject: [PATCH 54/77] =?UTF-8?q?feat(delas):=20contas=20de=20demonstra?= =?UTF-8?q?=C3=A7=C3=A3o=20para=20testar=20a=20He4rt=20Delas=20na=20m?= =?UTF-8?q?=C3=A3o?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- app-modules/delas/database/seeders/.gitkeep | 0 .../database/seeders/DelasDemoSeeder.php | 197 ++++++++++++++++++ 2 files changed, 197 insertions(+) delete mode 100644 app-modules/delas/database/seeders/.gitkeep create mode 100644 app-modules/delas/database/seeders/DelasDemoSeeder.php diff --git a/app-modules/delas/database/seeders/.gitkeep b/app-modules/delas/database/seeders/.gitkeep deleted file mode 100644 index e69de29bb..000000000 diff --git a/app-modules/delas/database/seeders/DelasDemoSeeder.php b/app-modules/delas/database/seeders/DelasDemoSeeder.php new file mode 100644 index 000000000..6b96653c6 --- /dev/null +++ b/app-modules/delas/database/seeders/DelasDemoSeeder.php @@ -0,0 +1,197 @@ + + */ + private const array PEOPLE = [ + 'lider' => ['name' => 'Lia Líder', 'email' => 'lider@delas.test', 'note' => 'líder: tudo, mais Equipe, histórico completo e versões do motivo'], + 'moderadora' => ['name' => 'Mia Moderadora', 'email' => 'moderadora@delas.test', 'note' => 'moderadora: fez os bloqueios e as rejeições abaixo'], + 'moderadora2' => ['name' => 'Nina Moderadora', 'email' => 'moderadora2@delas.test', 'note' => 'outra moderadora: para testar "só os próprios"'], + 'membra' => ['name' => 'Ana Membra', 'email' => 'membra@delas.test', 'note' => 'tem a tag'], + 'pendente' => ['name' => 'Paula Pendente', 'email' => 'pendente@delas.test', 'note' => 'pedido pendente na Fila'], + 'pedido2' => ['name' => 'Bruna Pedido', 'email' => 'pedido2@delas.test', 'note' => 'pedido pendente na Fila'], + 'pedido3' => ['name' => 'Carla Pedido', 'email' => 'pedido3@delas.test', 'note' => 'pedido pendente na Fila'], + 'recente' => ['name' => 'Rita Recente', 'email' => 'recente@delas.test', 'note' => 'rejeitada pela Mia há 1 hora: a Mia ainda edita o motivo'], + 'espera' => ['name' => 'Eva Espera', 'email' => 'espera@delas.test', 'note' => 'rejeitada pela Mia há 3 dias: em espera, a Mia já não edita'], + 'bloqueada' => ['name' => 'Bia Bloqueada', 'email' => 'bloqueada@delas.test', 'note' => 'bloqueada pela Mia'], + 'bloqueada2' => ['name' => 'Gabi Bloqueada', 'email' => 'bloqueada2@delas.test', 'note' => 'bloqueada pela Nina'], + 'nova' => ['name' => 'Nara Nova', 'email' => 'nova@delas.test', 'note' => 'nunca pediu: pode pedir a tag'], + 'semdiscord' => ['name' => 'Sofia Sem Discord', 'email' => 'semdiscord@delas.test', 'note' => 'sem Discord conectado: precisa conectar antes de pedir'], + ]; + + public function run(): void + { + $admin = User::query()->where('email', 'admin@admin.com')->first(); + + if (!$admin instanceof User || !$admin->isSuperAdmin()) { + $this->command->error('Rode o BaseSeeder antes: falta o super admin admin@admin.com.'); + + return; + } + + $people = collect(self::PEOPLE)->map(fn (array $person, string $key): User => $this->person($key, $person)); + + $this->resetDelasState($people->all()); + + $lead = $people['lider']; + $mia = $people['moderadora']; + $nina = $people['moderadora2']; + + $this->at(now()->subDays(10), function () use ($admin, $lead, $mia, $nina): void { + $lead->assignRole(UserRole::DelasLead); + resolve(GrantDelasTag::class)->handle($lead, $admin, 'Liderança da He4rt Delas.'); + resolve(GrantDelasTag::class)->handle($mia, $lead, 'Convidada para moderar.'); + resolve(GrantDelasTag::class)->handle($nina, $lead, 'Convidada para moderar.'); + resolve(AddDelasModerator::class)->handle($mia->fresh(), $lead); + resolve(AddDelasModerator::class)->handle($nina->fresh(), $lead); + }); + + $mia = $mia->fresh(); + $nina = $nina->fresh(); + + $this->at(now()->subDays(6), fn () => resolve(ApproveDelasRequest::class)->handle( + resolve(RequestDelasTag::class)->handle($people['membra']), + $mia, + )); + + $this->at(now()->subDays(3), function () use ($people, $mia): void { + resolve(RejectDelasRequest::class)->handle( + resolve(RequestDelasTag::class)->handle($people['espera']), + $mia, + 'Perfil sem informações suficientes.', + ); + resolve(BlockDelasRequester::class)->handle($people['bloqueada'], $mia, 'Pedidos repetidos para tumultuar a fila.'); + }); + + $this->at(now()->subDays(2), fn () => resolve(BlockDelasRequester::class)->handle( + $people['bloqueada2'], + $nina, + 'Mensagens ofensivas no pedido.', + )); + + $this->at(now()->subHour(), fn () => resolve(RejectDelasRequest::class)->handle( + resolve(RequestDelasTag::class)->handle($people['recente']), + $mia, + 'Perfil sem informaçoes suficientes.', + )); + + foreach (['pendente' => 30, 'pedido2' => 20, 'pedido3' => 10] as $key => $minutesAgo) { + $this->at(now()->subMinutes($minutesAgo), fn () => resolve(RequestDelasTag::class)->handle($people[$key])); + } + + $this->guide(); + } + + /** + * @param array{name: string, email: string, note: string} $person + */ + private function person(string $key, array $person): User + { + $user = User::query()->where('email', $person['email'])->first() + ?? User::factory()->create([ + 'name' => $person['name'], + 'username' => 'delas.'.$key, + 'email' => $person['email'], + 'password' => Hash::make(self::PASSWORD), + ]); + + // Todas têm o Discord conectado, menos a Sofia, que serve para testar essa exigência. + if ($key !== 'semdiscord' && !resolve(DelasEligibility::class)->hasDiscord($user)) { + ExternalIdentity::factory()->create([ + 'model_type' => $user->getMorphClass(), + 'model_id' => $user->getKey(), + 'provider' => IdentityProvider::Discord, + 'connected_by' => $user->getKey(), + ]); + } + + $user->removeRole(UserRole::DelasModerator); + $user->removeRole(UserRole::DelasLead); + + return $user->fresh() ?? $user; + } + + /** + * Apaga o que a He4rt Delas sabe sobre as contas de demonstração, para o + * estado voltar ao começo a cada execução. + * + * @param array $people + */ + private function resetDelasState(array $people): void + { + $ids = collect($people)->map(fn (User $user): string => $user->getKey())->values()->all(); + + DelasTransition::query()->whereIn('user_id', $ids)->orWhereIn('actor_id', $ids)->delete(); + DelasRequesterBlock::query()->whereIn('user_id', $ids)->delete(); + DelasTagRequest::query()->whereIn('user_id', $ids)->delete(); + } + + /** + * Roda um passo como se fosse aquele momento, para o histórico e a espera + * terem datas de verdade. + */ + private function at(CarbonInterface $moment, callable $step): void + { + Date::setTestNow($moment); + + try { + $step(); + } finally { + Date::setTestNow(); + } + } + + private function guide(): void + { + $output = $this->command->getOutput(); + + $output->writeln(''); + $output->writeln('Demonstração da He4rt Delas · /app (perfil) e /admin/mod/delas'); + $output->writeln(''); + + foreach (self::PEOPLE as $person) { + $output->writeln(sprintf('%s %s', mb_str_pad($person['email'], 24), $person['note'])); + } + + $output->writeln(''); + $output->writeln(sprintf('Senha de todas: %s · super admin: admin@admin.com / admin', self::PASSWORD)); + $output->writeln(''); + } +} From 30bc003b49777020bb2f72259bc74f337c1d5b0f Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Thu, 8 Oct 2026 12:46:45 -0300 Subject: [PATCH 55/77] =?UTF-8?q?refactor(delas):=20seeder=20de=20demonstr?= =?UTF-8?q?a=C3=A7=C3=A3o=20e=20telas=20mais=20f=C3=A1ceis=20de=20ler?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../database/seeders/DelasDemoSeeder.php | 284 ++++++++++++------ .../delas/src/History/Enums/DelasAction.php | 18 +- .../Concerns/InteractsWithDelasModeration.php | 11 +- .../Pages/Delas/DelasHistoryPage.php | 22 +- .../Moderation/Pages/Delas/DelasTeamPage.php | 9 +- .../livewire/delas/profile-section.blade.php | 11 +- 6 files changed, 252 insertions(+), 103 deletions(-) diff --git a/app-modules/delas/database/seeders/DelasDemoSeeder.php b/app-modules/delas/database/seeders/DelasDemoSeeder.php index 6b96653c6..3c166356e 100644 --- a/app-modules/delas/database/seeders/DelasDemoSeeder.php +++ b/app-modules/delas/database/seeders/DelasDemoSeeder.php @@ -28,8 +28,8 @@ * situação (pendente, em espera, bloqueada...). O histórico sai das próprias * actions de domínio, então as telas mostram o comportamento real. * - * Roda de novo quando quiser: as contas são as mesmas e o estado delas volta - * ao começo. + * Pode rodar de novo quando quiser: as contas são as mesmas e o estado delas + * volta ao começo. * * php artisan db:seed --class="He4rt\Delas\Database\Seeders\DelasDemoSeeder" */ @@ -38,24 +38,86 @@ final class DelasDemoSeeder extends Seeder public const string PASSWORD = 'password'; /** + * Uma conta por situação. A chave vira o username (`delas.`). + * * @var array */ private const array PEOPLE = [ - 'lider' => ['name' => 'Lia Líder', 'email' => 'lider@delas.test', 'note' => 'líder: tudo, mais Equipe, histórico completo e versões do motivo'], - 'moderadora' => ['name' => 'Mia Moderadora', 'email' => 'moderadora@delas.test', 'note' => 'moderadora: fez os bloqueios e as rejeições abaixo'], - 'moderadora2' => ['name' => 'Nina Moderadora', 'email' => 'moderadora2@delas.test', 'note' => 'outra moderadora: para testar "só os próprios"'], - 'membra' => ['name' => 'Ana Membra', 'email' => 'membra@delas.test', 'note' => 'tem a tag'], - 'pendente' => ['name' => 'Paula Pendente', 'email' => 'pendente@delas.test', 'note' => 'pedido pendente na Fila'], - 'pedido2' => ['name' => 'Bruna Pedido', 'email' => 'pedido2@delas.test', 'note' => 'pedido pendente na Fila'], - 'pedido3' => ['name' => 'Carla Pedido', 'email' => 'pedido3@delas.test', 'note' => 'pedido pendente na Fila'], - 'recente' => ['name' => 'Rita Recente', 'email' => 'recente@delas.test', 'note' => 'rejeitada pela Mia há 1 hora: a Mia ainda edita o motivo'], - 'espera' => ['name' => 'Eva Espera', 'email' => 'espera@delas.test', 'note' => 'rejeitada pela Mia há 3 dias: em espera, a Mia já não edita'], - 'bloqueada' => ['name' => 'Bia Bloqueada', 'email' => 'bloqueada@delas.test', 'note' => 'bloqueada pela Mia'], - 'bloqueada2' => ['name' => 'Gabi Bloqueada', 'email' => 'bloqueada2@delas.test', 'note' => 'bloqueada pela Nina'], - 'nova' => ['name' => 'Nara Nova', 'email' => 'nova@delas.test', 'note' => 'nunca pediu: pode pedir a tag'], - 'semdiscord' => ['name' => 'Sofia Sem Discord', 'email' => 'semdiscord@delas.test', 'note' => 'sem Discord conectado: precisa conectar antes de pedir'], + 'lider' => [ + 'name' => 'Lia Líder', + 'email' => 'lider@delas.test', + 'note' => 'líder: tudo, mais Equipe, histórico completo e versões do motivo', + ], + 'moderadora' => [ + 'name' => 'Mia Moderadora', + 'email' => 'moderadora@delas.test', + 'note' => 'moderadora: fez os bloqueios e as rejeições abaixo', + ], + 'moderadora2' => [ + 'name' => 'Nina Moderadora', + 'email' => 'moderadora2@delas.test', + 'note' => 'outra moderadora: para testar "só os próprios"', + ], + 'membra' => [ + 'name' => 'Ana Membra', + 'email' => 'membra@delas.test', + 'note' => 'tem a tag', + ], + 'pendente' => [ + 'name' => 'Paula Pendente', + 'email' => 'pendente@delas.test', + 'note' => 'pedido pendente na Fila', + ], + 'pedido2' => [ + 'name' => 'Bruna Pedido', + 'email' => 'pedido2@delas.test', + 'note' => 'pedido pendente na Fila', + ], + 'pedido3' => [ + 'name' => 'Carla Pedido', + 'email' => 'pedido3@delas.test', + 'note' => 'pedido pendente na Fila', + ], + 'recente' => [ + 'name' => 'Rita Recente', + 'email' => 'recente@delas.test', + 'note' => 'rejeitada pela Mia há 1 hora: a Mia ainda edita o motivo', + ], + 'espera' => [ + 'name' => 'Eva Espera', + 'email' => 'espera@delas.test', + 'note' => 'rejeitada pela Mia há 3 dias: em espera, a Mia já não edita', + ], + 'bloqueada' => [ + 'name' => 'Bia Bloqueada', + 'email' => 'bloqueada@delas.test', + 'note' => 'bloqueada pela Mia', + ], + 'bloqueada2' => [ + 'name' => 'Gabi Bloqueada', + 'email' => 'bloqueada2@delas.test', + 'note' => 'bloqueada pela Nina', + ], + 'nova' => [ + 'name' => 'Nara Nova', + 'email' => 'nova@delas.test', + 'note' => 'nunca pediu: pode pedir a tag', + ], + 'semdiscord' => [ + 'name' => 'Sofia Sem Discord', + 'email' => 'semdiscord@delas.test', + 'note' => 'sem Discord conectado: precisa conectar antes de pedir', + ], ]; + /** + * Conta sem Discord conectado, para testar essa exigência do pedido. + */ + private const string WITHOUT_DISCORD = 'semdiscord'; + + /** @var array */ + private array $people = []; + public function run(): void { $admin = User::query()->where('email', 'admin@admin.com')->first(); @@ -66,103 +128,151 @@ public function run(): void return; } - $people = collect(self::PEOPLE)->map(fn (array $person, string $key): User => $this->person($key, $person)); - - $this->resetDelasState($people->all()); - - $lead = $people['lider']; - $mia = $people['moderadora']; - $nina = $people['moderadora2']; - - $this->at(now()->subDays(10), function () use ($admin, $lead, $mia, $nina): void { - $lead->assignRole(UserRole::DelasLead); - resolve(GrantDelasTag::class)->handle($lead, $admin, 'Liderança da He4rt Delas.'); - resolve(GrantDelasTag::class)->handle($mia, $lead, 'Convidada para moderar.'); - resolve(GrantDelasTag::class)->handle($nina, $lead, 'Convidada para moderar.'); - resolve(AddDelasModerator::class)->handle($mia->fresh(), $lead); - resolve(AddDelasModerator::class)->handle($nina->fresh(), $lead); - }); - - $mia = $mia->fresh(); - $nina = $nina->fresh(); - - $this->at(now()->subDays(6), fn () => resolve(ApproveDelasRequest::class)->handle( - resolve(RequestDelasTag::class)->handle($people['membra']), - $mia, - )); - - $this->at(now()->subDays(3), function () use ($people, $mia): void { - resolve(RejectDelasRequest::class)->handle( - resolve(RequestDelasTag::class)->handle($people['espera']), - $mia, - 'Perfil sem informações suficientes.', - ); - resolve(BlockDelasRequester::class)->handle($people['bloqueada'], $mia, 'Pedidos repetidos para tumultuar a fila.'); - }); - - $this->at(now()->subDays(2), fn () => resolve(BlockDelasRequester::class)->handle( - $people['bloqueada2'], - $nina, - 'Mensagens ofensivas no pedido.', - )); + $this->createPeople(); + $this->resetDelasState(); - $this->at(now()->subHour(), fn () => resolve(RejectDelasRequest::class)->handle( - resolve(RequestDelasTag::class)->handle($people['recente']), - $mia, - 'Perfil sem informaçoes suficientes.', - )); + $this->at(now()->subDays(10), fn () => $this->formTeam($admin)); + $this->at(now()->subDays(6), fn () => $this->approveMember()); + $this->at(now()->subDays(3), fn () => $this->rejectAndBlockByMia()); + $this->at(now()->subDays(2), fn () => $this->blockByNina()); + $this->at(now()->subHour(), fn () => $this->rejectRecentlyByMia()); + $this->openPendingRequests(); - foreach (['pendente' => 30, 'pedido2' => 20, 'pedido3' => 10] as $key => $minutesAgo) { - $this->at(now()->subMinutes($minutesAgo), fn () => resolve(RequestDelasTag::class)->handle($people[$key])); + $this->guide(); + } + + /** + * A líder recebe o papel do super admin e dá a tag e o papel às duas + * moderadoras. Moderadora precisa ter a tag. + */ + private function formTeam(User $admin): void + { + $lead = $this->person('lider'); + $lead->assignRole(UserRole::DelasLead); + + resolve(GrantDelasTag::class)->handle($lead, $admin, 'Liderança da He4rt Delas.'); + + foreach (['moderadora', 'moderadora2'] as $key) { + resolve(GrantDelasTag::class)->handle($this->person($key), $lead, 'Convidada para moderar.'); + resolve(AddDelasModerator::class)->handle($this->person($key), $lead); } + } - $this->guide(); + private function approveMember(): void + { + $request = resolve(RequestDelasTag::class)->handle($this->person('membra')); + + resolve(ApproveDelasRequest::class)->handle($request, $this->person('moderadora')); + } + + /** + * Há 3 dias: já passou o prazo de 24 horas para a Mia editar o motivo. + */ + private function rejectAndBlockByMia(): void + { + $mia = $this->person('moderadora'); + + $request = resolve(RequestDelasTag::class)->handle($this->person('espera')); + resolve(RejectDelasRequest::class)->handle($request, $mia, 'Perfil sem informações suficientes.'); + + resolve(BlockDelasRequester::class)->handle($this->person('bloqueada'), $mia, 'Pedidos repetidos para tumultuar a fila.'); } /** - * @param array{name: string, email: string, note: string} $person + * Bloqueio de outra moderadora: a Mia não consegue desfazer. */ - private function person(string $key, array $person): User + private function blockByNina(): void { - $user = User::query()->where('email', $person['email'])->first() - ?? User::factory()->create([ - 'name' => $person['name'], - 'username' => 'delas.'.$key, - 'email' => $person['email'], - 'password' => Hash::make(self::PASSWORD), - ]); - - // Todas têm o Discord conectado, menos a Sofia, que serve para testar essa exigência. - if ($key !== 'semdiscord' && !resolve(DelasEligibility::class)->hasDiscord($user)) { - ExternalIdentity::factory()->create([ - 'model_type' => $user->getMorphClass(), - 'model_id' => $user->getKey(), - 'provider' => IdentityProvider::Discord, - 'connected_by' => $user->getKey(), - ]); + resolve(BlockDelasRequester::class)->handle( + $this->person('bloqueada2'), + $this->person('moderadora2'), + 'Mensagens ofensivas no pedido.', + ); + } + + /** + * Há 1 hora, com um erro de digitação de propósito: a Mia ainda pode editar. + */ + private function rejectRecentlyByMia(): void + { + $request = resolve(RequestDelasTag::class)->handle($this->person('recente')); + + resolve(RejectDelasRequest::class)->handle($request, $this->person('moderadora'), 'Perfil sem informaçoes suficientes.'); + } + + /** + * Três pedidos na Fila, com 10 minutos entre eles. + */ + private function openPendingRequests(): void + { + $minutesAgo = ['pendente' => 30, 'pedido2' => 20, 'pedido3' => 10]; + + foreach ($minutesAgo as $key => $minutes) { + $this->at(now()->subMinutes($minutes), fn () => resolve(RequestDelasTag::class)->handle($this->person($key))); + } + } + + /** + * Cria as contas que ainda não existem, conecta o Discord e tira os papéis + * da He4rt Delas, que os passos seguintes dão de novo. + */ + private function createPeople(): void + { + foreach (self::PEOPLE as $key => $person) { + $user = User::query()->where('email', $person['email'])->first() + ?? User::factory()->create([ + 'name' => $person['name'], + 'username' => 'delas.'.$key, + 'email' => $person['email'], + 'password' => Hash::make(self::PASSWORD), + ]); + + if ($key !== self::WITHOUT_DISCORD) { + $this->connectDiscord($user); + } + + $user->removeRole(UserRole::DelasModerator); + $user->removeRole(UserRole::DelasLead); + + $this->people[$key] = $user; } + } - $user->removeRole(UserRole::DelasModerator); - $user->removeRole(UserRole::DelasLead); + private function connectDiscord(User $user): void + { + if (resolve(DelasEligibility::class)->hasDiscord($user)) { + return; + } - return $user->fresh() ?? $user; + ExternalIdentity::factory()->create([ + 'model_type' => $user->getMorphClass(), + 'model_id' => $user->getKey(), + 'provider' => IdentityProvider::Discord, + 'connected_by' => $user->getKey(), + ]); } /** * Apaga o que a He4rt Delas sabe sobre as contas de demonstração, para o * estado voltar ao começo a cada execução. - * - * @param array $people */ - private function resetDelasState(array $people): void + private function resetDelasState(): void { - $ids = collect($people)->map(fn (User $user): string => $user->getKey())->values()->all(); + $ids = array_map(fn (User $user): string => $user->getKey(), array_values($this->people)); DelasTransition::query()->whereIn('user_id', $ids)->orWhereIn('actor_id', $ids)->delete(); DelasRequesterBlock::query()->whereIn('user_id', $ids)->delete(); DelasTagRequest::query()->whereIn('user_id', $ids)->delete(); } + /** + * Sempre a versão atual da conta: os papéis mudam entre um passo e outro. + */ + private function person(string $key): User + { + return $this->people[$key]->fresh() ?? $this->people[$key]; + } + /** * Roda um passo como se fosse aquele momento, para o histórico e a espera * terem datas de verdade. diff --git a/app-modules/delas/src/History/Enums/DelasAction.php b/app-modules/delas/src/History/Enums/DelasAction.php index ae232ddff..21b20ccfd 100644 --- a/app-modules/delas/src/History/Enums/DelasAction.php +++ b/app-modules/delas/src/History/Enums/DelasAction.php @@ -30,6 +30,14 @@ enum DelasAction: string implements HasColor, HasDescription, HasIcon, HasLabel case ModeratorRemoved = 'moderator_removed'; case ReasonCorrected = 'reason_corrected'; + /** + * @return list + */ + public static function moderationDecisions(): array + { + return array_values(array_filter(self::cases(), fn (self $action): bool => $action->isModerationDecision())); + } + public function getLabel(): string { return __('delas::enums.action.'.$this->value.'.label'); @@ -91,10 +99,14 @@ public function hasCorrectableReason(): bool } /** - * Ações que a moderação vê no histórico resumido (sem os pedidos em si). + * Decisão de moderação sobre uma pessoa: o que conta em "Decisões" na Equipe. + * Pedir a tag, mexer na equipe e editar um motivo não contam. */ - public function isDecision(): bool + public function isModerationDecision(): bool { - return $this !== self::Requested; + return match ($this) { + self::Approved, self::Rejected, self::Granted, self::Revoked, self::Blocked, self::Unblocked => true, + self::Requested, self::ModeratorAdded, self::ModeratorRemoved, self::ReasonCorrected => false, + }; } } 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 00a3e8e35..1fb648bf1 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 personColumn(string $name, string $username, string $label): ->label($label) ->weight('medium') ->description(fn (mixed $record): HtmlString => new HtmlString( - e('@'.data_get($record, $username)).' · '.e($this->text('panel-admin::delas.actions.view_profile')).'', + e('@'.data_get($record, $username)).' · '.$this->clickableHint('panel-admin::delas.actions.view_profile'), )) ->action($this->viewProfileAction($relation)) ->searchable([$relation === null ? $name : 'name']); @@ -97,6 +97,15 @@ protected function viewProfileAction(?string $relation): Action ->modalCancelActionLabel(__('panel-admin::delas.actions.close')); } + /** + * Texto sublinhado dentro da descrição de uma coluna, avisando que clicar na + * célula abre algo. O clique em si é a action da coluna. + */ + protected function clickableHint(string $key): string + { + return ''.e($this->text($key)).''; + } + protected function dateColumn(string $name, string $label): TextColumn { return TextColumn::make($name) 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 58af9e703..b45d9ed47 100644 --- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php +++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php @@ -109,7 +109,10 @@ public function table(Table $table): Table ->visible(fn (DelasTransition $record): bool => $this->canCorrect($record)) ->modalHeading(__('panel-admin::delas.actions.correct_reason_heading')) ->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)) + ->modalDescription(fn (DelasTransition $record): string => implode(' ', [ + $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( @@ -141,8 +144,17 @@ private function canCorrect(DelasTransition $record): bool return true; } - return $record->actor_id === $this->actor()->getKey() - && ($record->created_at?->greaterThanOrEqualTo(now()->subHours(config()->integer('delas.reason_correction_hours'))) ?? false); + $isAuthor = $record->actor_id === $this->actor()->getKey(); + + return $isAuthor && ($this->correctionDeadline($record)?->isFuture() ?? false); + } + + /** + * Até quando quem escreveu o motivo pode editá-lo. + */ + private function correctionDeadline(DelasTransition $record): ?CarbonInterface + { + return $record->created_at?->copy()->addHours(config()->integer('delas.reason_correction_hours')); } /** @@ -179,7 +191,7 @@ private function reasonNote(DelasTransition $record): ?HtmlString ])); if ($this->isLead()) { - $note .= ' · '.e($this->text('panel-admin::delas.actions.view_versions')).''; + $note .= ' · '.$this->clickableHint('panel-admin::delas.actions.view_versions'); } return new HtmlString($note); @@ -195,7 +207,7 @@ private function correctionWindowNote(DelasTransition $record): string } return $this->text('panel-admin::delas.actions.correct_until', [ - 'date' => $this->displayDate($record->created_at?->copy()->addHours(config()->integer('delas.reason_correction_hours'))), + 'date' => $this->displayDate($this->correctionDeadline($record)), ]); } 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 3be871728..5e989ab5b 100644 --- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php +++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php @@ -78,7 +78,7 @@ public function table(Table $table): Table ->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]), + ->whereIn('action', DelasAction::moderationDecisions()), ]) ->role([UserRole::DelasModerator->value, UserRole::DelasLead->value]) ->with('roles'), @@ -183,7 +183,12 @@ protected function getHeaderActions(): array $this->alsoBlockToggle(), ]) ->action(fn (array $data): bool => $this->attempt( - fn () => resolve(RevokeDelasTag::class)->handle($this->findUser($data['user_id']), $this->actor(), $this->reasonFrom($data), $this->alsoBlockFrom($data)), + fn () => resolve(RevokeDelasTag::class)->handle( + target: $this->findUser($data['user_id']), + actor: $this->actor(), + reason: $this->reasonFrom($data), + alsoBlock: $this->alsoBlockFrom($data), + ), $this->revokedTitle($data), )), ]; 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 2df2ad2bf..6c16af7e1 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 @@ -4,6 +4,7 @@ $eligibility = $this->eligibility; $state = $eligibility->state; $displayTimezone = config('app.display_timezone'); + $canRequest = $state === DelasEligibilityState::CanRequest; $switchOn = in_array($state, [DelasEligibilityState::Pending, DelasEligibilityState::Member], true); @endphp @@ -25,8 +26,8 @@ role="switch" id="delas-request-switch" aria-checked="{{ $switchOn ? 'true' : 'false' }}" - @if ($state === DelasEligibilityState::CanRequest) aria-describedby="delas-request-switch-hint" @endif - @if ($state === DelasEligibilityState::CanRequest) + @if ($canRequest) aria-describedby="delas-request-switch-hint" @endif + @if ($canRequest) wire:click="mountAction('request')" @else disabled @@ -35,8 +36,8 @@ 'relative mt-0.5 inline-flex h-6 w-11 shrink-0 rounded-full border-2 border-transparent transition-colors focus-visible:outline-2 focus-visible:outline-offset-2 focus-visible:outline-primary-600', 'bg-delas-600' => $switchOn, 'bg-gray-200 dark:bg-gray-700' => !$switchOn, - 'cursor-pointer' => $state === DelasEligibilityState::CanRequest, - 'cursor-not-allowed opacity-60' => $state !== DelasEligibilityState::CanRequest, + 'cursor-pointer' => $canRequest, + 'cursor-not-allowed opacity-60' => !$canRequest, ]) > {{ __('panel-app::delas.profile.toggle') }} - @if ($state === DelasEligibilityState::CanRequest) + @if ($canRequest)

    {{ __('panel-app::delas.profile.toggle_hint') }}

    From 95391ed85443e53bdc1f2321356e2bf7e9f15e25 Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Thu, 8 Oct 2026 12:54:13 -0300 Subject: [PATCH 56/77] =?UTF-8?q?refactor(panel-admin):=20cada=20a=C3=A7?= =?UTF-8?q?=C3=A3o=20da=20He4rt=20Delas=20na=20pr=C3=B3pria=20classe,=20co?= =?UTF-8?q?mo=20o=20resto=20do=20admin?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../History/Actions/CorrectDelasReason.php | 5 +- .../src/History/Models/DelasTransition.php | 9 + .../Actions/Delas/AddDelasModeratorAction.php | 44 ++++ .../Delas/ApproveDelasRequestAction.php | 47 +++++ .../Delas/BlockDelasRequesterAction.php | 63 ++++++ .../Concerns/InteractsWithDelasActions.php | 81 ++++++++ .../Actions/Delas/EditDelasReasonAction.php | 85 ++++++++ .../Delas/Fields/DelasPersonSelect.php | 60 ++++++ .../Actions/Delas/GrantDelasTagAction.php | 78 +++++++ .../Delas/RejectDelasRequestAction.php | 62 ++++++ .../Delas/RemoveDelasModeratorAction.php | 50 +++++ .../Actions/Delas/RevokeDelasTagAction.php | 74 +++++++ .../Delas/UnblockDelasRequesterAction.php | 58 ++++++ .../Actions/Delas/ViewDelasProfileAction.php | 69 +++++++ .../Delas/ViewDelasReasonVersionsAction.php | 39 ++++ .../Concerns/InteractsWithDelasModeration.php | 145 ++----------- .../Pages/Delas/DelasBlocksPage.php | 29 +-- .../Pages/Delas/DelasHistoryPage.php | 126 +++--------- .../Pages/Delas/DelasMembersPage.php | 23 +-- .../Moderation/Pages/Delas/DelasQueuePage.php | 70 +------ .../Moderation/Pages/Delas/DelasTeamPage.php | 192 ++---------------- 21 files changed, 905 insertions(+), 504 deletions(-) create mode 100644 app-modules/panel-admin/src/Moderation/Actions/Delas/AddDelasModeratorAction.php create mode 100644 app-modules/panel-admin/src/Moderation/Actions/Delas/ApproveDelasRequestAction.php create mode 100644 app-modules/panel-admin/src/Moderation/Actions/Delas/BlockDelasRequesterAction.php create mode 100644 app-modules/panel-admin/src/Moderation/Actions/Delas/Concerns/InteractsWithDelasActions.php create mode 100644 app-modules/panel-admin/src/Moderation/Actions/Delas/EditDelasReasonAction.php create mode 100644 app-modules/panel-admin/src/Moderation/Actions/Delas/Fields/DelasPersonSelect.php create mode 100644 app-modules/panel-admin/src/Moderation/Actions/Delas/GrantDelasTagAction.php create mode 100644 app-modules/panel-admin/src/Moderation/Actions/Delas/RejectDelasRequestAction.php create mode 100644 app-modules/panel-admin/src/Moderation/Actions/Delas/RemoveDelasModeratorAction.php create mode 100644 app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php create mode 100644 app-modules/panel-admin/src/Moderation/Actions/Delas/UnblockDelasRequesterAction.php create mode 100644 app-modules/panel-admin/src/Moderation/Actions/Delas/ViewDelasProfileAction.php create mode 100644 app-modules/panel-admin/src/Moderation/Actions/Delas/ViewDelasReasonVersionsAction.php diff --git a/app-modules/delas/src/History/Actions/CorrectDelasReason.php b/app-modules/delas/src/History/Actions/CorrectDelasReason.php index 874aaa06e..2b93ba663 100644 --- a/app-modules/delas/src/History/Actions/CorrectDelasReason.php +++ b/app-modules/delas/src/History/Actions/CorrectDelasReason.php @@ -75,11 +75,10 @@ private function ensureCanCorrect(DelasTransition $original, User $actor): void return; } - $hours = config()->integer('delas.reason_correction_hours'); $isAuthor = $original->actor_id === $actor->getKey(); - $isWithinWindow = $original->created_at?->greaterThanOrEqualTo(now()->subHours($hours)) ?? false; + $isWithinWindow = $original->reasonCorrectionDeadline()?->isFuture() ?? false; - throw_unless($isAuthor && $isWithinWindow, DelasException::cannotCorrectReason($hours)); + throw_unless($isAuthor && $isWithinWindow, DelasException::cannotCorrectReason(config()->integer('delas.reason_correction_hours'))); } /** diff --git a/app-modules/delas/src/History/Models/DelasTransition.php b/app-modules/delas/src/History/Models/DelasTransition.php index 8c17f54d1..99803045e 100644 --- a/app-modules/delas/src/History/Models/DelasTransition.php +++ b/app-modules/delas/src/History/Models/DelasTransition.php @@ -134,6 +134,15 @@ public function hasCorrectableReason(): bool return $this->reason !== null && $this->action->hasCorrectableReason(); } + /** + * Até quando quem escreveu o motivo pode editá-lo (`delas.reason_correction_hours`). + * Líderes editam a qualquer momento. + */ + public function reasonCorrectionDeadline(): ?CarbonInterface + { + return $this->created_at?->copy()->addHours(config()->integer('delas.reason_correction_hours')); + } + /** @return array */ protected function casts(): array { diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/AddDelasModeratorAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/AddDelasModeratorAction.php new file mode 100644 index 000000000..43c8dcc58 --- /dev/null +++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/AddDelasModeratorAction.php @@ -0,0 +1,44 @@ +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([ + DelasPersonSelect::make(fn (DelasCandidates $candidates) => $candidates->forModerator($this->actor())) + ->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()), + $this->text('panel-admin::delas.actions.moderator_added'), + )); + } + + public static function getDefaultName(): string + { + return 'addModerator'; + } +} diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/ApproveDelasRequestAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/ApproveDelasRequestAction.php new file mode 100644 index 000000000..5f7d6c9e2 --- /dev/null +++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/ApproveDelasRequestAction.php @@ -0,0 +1,47 @@ +label(__('panel-admin::delas.actions.approve')) + ->icon(Heroicon::OutlinedCheck) + ->color('success') + ->button() + ->size('sm') + ->requiresConfirmation() + ->modalHeading(fn (DelasTagRequest $record): string => $this->text('panel-admin::delas.actions.approve_heading', [ + 'name' => $record->user->name, + ])) + ->modalDescription(fn (DelasTagRequest $record): string => $this->text('panel-admin::delas.actions.approve_body', [ + 'username' => $record->user->username, + ])) + ->action(fn (DelasTagRequest $record) => $this->runDomainAction( + fn () => resolve(ApproveDelasRequest::class)->handle($record, $this->actor()), + $this->text('panel-admin::delas.actions.approved'), + )); + } + + public static function getDefaultName(): string + { + return 'approve'; + } +} diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/BlockDelasRequesterAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/BlockDelasRequesterAction.php new file mode 100644 index 000000000..37a56097b --- /dev/null +++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/BlockDelasRequesterAction.php @@ -0,0 +1,63 @@ +label(__('panel-admin::delas.actions.block')) + ->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) + ? $this->text('panel-admin::delas.actions.block_tooltip') + : $this->text('panel-admin::delas.actions.block_disabled')) + ->modalHeading(fn (DelasTagRequest $record): string => $this->text('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) => $this->runDomainAction( + fn () => resolve(BlockDelasRequester::class)->handle($record->user, $this->actor(), $this->reasonFrom($data)), + $this->text('panel-admin::delas.actions.blocked'), + )); + } + + public static function getDefaultName(): string + { + return 'block'; + } + + /** + * Mesma regra da action de domínio, só para desabilitar o botão: ninguém + * bloqueia a si mesma nem quem modera. + */ + private function canBlock(User $target): bool + { + return !$target->is($this->actor()) && !$target->can('moderate-delas'); + } +} diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/Concerns/InteractsWithDelasActions.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/Concerns/InteractsWithDelasActions.php new file mode 100644 index 000000000..17ddfcf35 --- /dev/null +++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/Concerns/InteractsWithDelasActions.php @@ -0,0 +1,81 @@ +user(); + + abort_unless($user instanceof User, 403); + + return $user; + } + + protected function isLead(): bool + { + return $this->actor()->can('lead-delas'); + } + + protected function reasonField(string $label, bool|Closure $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')); + } + + /** + * @param array $data + */ + protected function reasonFrom(array $data): ?string + { + $reason = $data['reason'] ?? null; + + return is_string($reason) ? $reason : null; + } + + /** + * Roda a action de domínio e transforma uma recusa (regra de negócio ou + * permissão) em notificação, sem derrubar a página. + */ + protected function runDomainAction(Closure $operation, string $successTitle): void + { + try { + $operation(); + } catch (DelasException|AuthorizationException $exception) { + Notification::make()->danger()->title($exception->getMessage())->send(); + + return; + } + + Notification::make()->success()->title($successTitle)->send(); + } + + /** + * @param array $replace + */ + protected function text(string $key, array $replace = []): string + { + $text = __($key, $replace); + + return is_string($text) ? $text : $key; + } +} diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/EditDelasReasonAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/EditDelasReasonAction.php new file mode 100644 index 000000000..6656fa49d --- /dev/null +++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/EditDelasReasonAction.php @@ -0,0 +1,85 @@ +label(__('panel-admin::delas.actions.correct_reason')) + ->icon(Heroicon::OutlinedPencilSquare) + ->color('gray') + ->button() + ->size('sm') + ->visible(fn (DelasTransition $record): bool => $this->canEdit($record)) + ->tooltip(fn (DelasTransition $record): string => $this->deadlineNote($record)) + ->modalHeading(__('panel-admin::delas.actions.correct_reason_heading')) + ->modalDescription(fn (DelasTransition $record): string => implode(' ', [ + $this->text('panel-admin::delas.actions.correct_reason_body'), + $this->deadlineNote($record), + ])) + ->fillForm(fn (DelasTransition $record): array => ['reason' => $record->currentReason()]) + ->schema([ + $this->reasonField(__('panel-admin::delas.actions.correct_reason_field')) + ->extraInputAttributes(['x-init' => '$nextTick(() => { $el.focus(); $el.select() })']), + ]) + ->action(fn (DelasTransition $record, array $data) => $this->runDomainAction( + fn () => resolve(CorrectDelasReason::class)->handle($record, $this->actor(), $this->reasonFrom($data)), + $this->text('panel-admin::delas.actions.reason_corrected'), + )); + } + + public static function getDefaultName(): string + { + return 'correctReason'; + } + + /** + * Mesma regra da action de domínio, só para mostrar o botão a quem pode. + */ + private function canEdit(DelasTransition $record): bool + { + if (!$record->hasCorrectableReason()) { + return false; + } + + if ($this->isLead()) { + return true; + } + + $isAuthor = $record->actor_id === $this->actor()->getKey(); + + return $isAuthor && ($record->reasonCorrectionDeadline()?->isFuture() ?? false); + } + + private function deadlineNote(DelasTransition $record): string + { + if ($this->isLead()) { + return $this->text('panel-admin::delas.actions.correct_anytime'); + } + + $deadline = $record->reasonCorrectionDeadline(); + + return $this->text('panel-admin::delas.actions.correct_until', [ + 'date' => $deadline?->timezone(config('app.display_timezone'))->format('d/m/Y H:i') ?? '—', + ]); + } +} 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 new file mode 100644 index 000000000..3efeb1524 --- /dev/null +++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/Fields/DelasPersonSelect.php @@ -0,0 +1,60 @@ + $scope um dos escopos de `DelasCandidates` + */ + public static function make(Closure $scope): Select + { + $candidates = resolve(DelasCandidates::class); + $people = fn (): Builder => $scope($candidates); + + return Select::make('user_id') + ->label(__('panel-admin::delas.actions.person')) + ->helperText(__('panel-admin::delas.actions.person_hint')) + ->required() + ->searchable() + ->preload() + ->options(fn (): array => self::options($candidates->search($people(), ''))) + ->getSearchResultsUsing(fn (string $search): array => self::options($candidates->search($people(), $search))) + ->getOptionLabelUsing(fn (mixed $value): ?string => ($user = $people()->find($value)) instanceof User + ? self::label($user) + : null); + } + + public static function chosen(mixed $id): User + { + return User::query()->whereKey($id)->firstOrFail(); + } + + /** + * @param Collection $users + * @return array + */ + private static function options(Collection $users): array + { + return $users->mapWithKeys(fn (User $user): array => [$user->id => self::label($user)])->all(); + } + + private static function label(User $user): string + { + return $user->name.' (@'.$user->username.')'; + } +} diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/GrantDelasTagAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/GrantDelasTagAction.php new file mode 100644 index 000000000..67261cb4f --- /dev/null +++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/GrantDelasTagAction.php @@ -0,0 +1,78 @@ +label(__('panel-admin::delas.actions.grant')) + ->icon(Heroicon::OutlinedPlusCircle) + ->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(), + Callout::make(__('panel-admin::delas.actions.grant_blocked_heading')) + ->description(fn (Get $get): ?string => $this->blockSummary($this->activeBlockOf($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) => $this->runDomainAction( + fn () => resolve(GrantDelasTag::class)->handle(DelasPersonSelect::chosen($data['user_id']), $this->actor(), $this->reasonFrom($data)), + $this->text('panel-admin::delas.actions.granted'), + )); + } + + public static function getDefaultName(): string + { + return 'grant'; + } + + 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 blockSummary(?DelasRequesterBlock $block): ?string + { + 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' => mb_rtrim($block->reason, '. '), + ]); + } +} diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/RejectDelasRequestAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/RejectDelasRequestAction.php new file mode 100644 index 000000000..f56309f67 --- /dev/null +++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/RejectDelasRequestAction.php @@ -0,0 +1,62 @@ +label(__('panel-admin::delas.actions.reject')) + ->icon(Heroicon::OutlinedXMark) + ->color('danger') + ->button() + ->outlined() + ->size('sm') + ->modalHeading(fn (DelasTagRequest $record): string => $this->text('panel-admin::delas.actions.reject_heading', [ + 'name' => $record->user->name, + ])) + ->modalDescription(fn (DelasTagRequest $record): string => $this->text('panel-admin::delas.actions.reject_body', [ + 'name' => $record->user->name, + 'date' => $this->nextRequestDate(), + ])) + ->modalSubmitActionLabel(__('panel-admin::delas.actions.reject')) + ->schema([$this->reasonField(__('panel-admin::delas.actions.reject_reason'))]) + ->action(fn (DelasTagRequest $record, array $data) => $this->runDomainAction( + fn () => resolve(RejectDelasRequest::class)->handle($record, $this->actor(), $this->reasonFrom($data)), + $this->text('panel-admin::delas.actions.rejected'), + )); + } + + public static function getDefaultName(): string + { + return 'reject'; + } + + /** + * Rejeitando hoje, a partir de quando a pessoa pode pedir de novo. + */ + private function nextRequestDate(): string + { + return now() + ->addDays(config()->integer('delas.request_cooldown_days')) + ->timezone(config('app.display_timezone')) + ->format('d/m'); + } +} diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/RemoveDelasModeratorAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/RemoveDelasModeratorAction.php new file mode 100644 index 000000000..12816b6db --- /dev/null +++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/RemoveDelasModeratorAction.php @@ -0,0 +1,50 @@ +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 => $this->text('panel-admin::delas.actions.remove_moderator_heading', ['name' => $record->name])) + ->modalDescription(fn (User $record): string => $this->text('panel-admin::delas.actions.remove_moderator_body', ['name' => $record->name])) + ->action(fn (User $record) => $this->runDomainAction( + fn () => resolve(RemoveDelasModerator::class)->handle($record, $this->actor()), + $this->text('panel-admin::delas.actions.moderator_removed'), + )); + } + + public static function getDefaultName(): string + { + return 'removeModerator'; + } +} diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php new file mode 100644 index 000000000..decb770c6 --- /dev/null +++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/RevokeDelasTagAction.php @@ -0,0 +1,74 @@ +label(__('panel-admin::delas.actions.revoke')) + ->icon(Heroicon::OutlinedMinusCircle) + ->color('danger') + ->outlined() + ->visible(fn (): bool => $this->isLead()) + ->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')) + ->modalDescription(__('panel-admin::delas.actions.revoke_body')) + ->modalSubmitActionLabel(__('panel-admin::delas.actions.revoke')) + ->schema(fn (?DelasTagRequest $record): array => [ + ...($record instanceof DelasTagRequest ? [] : [$this->memberSelect()]), + $this->reasonField(__('panel-admin::delas.actions.revoke_reason')), + Toggle::make('also_block') + ->label(__('panel-admin::delas.actions.also_block')) + ->helperText(__('panel-admin::delas.actions.also_block_hint')) + ->default(state: false), + ]) + ->action(function (?DelasTagRequest $record, array $data): void { + $alsoBlock = ($data['also_block'] ?? false) === true; + + $this->runDomainAction( + fn () => resolve(RevokeDelasTag::class)->handle( + target: $record instanceof DelasTagRequest ? $record->user : DelasPersonSelect::chosen($data['user_id'] ?? null), + actor: $this->actor(), + reason: $this->reasonFrom($data), + alsoBlock: $alsoBlock, + ), + $this->text($alsoBlock ? 'panel-admin::delas.actions.revoked_and_blocked' : 'panel-admin::delas.actions.revoked'), + ); + }); + } + + public static function getDefaultName(): string + { + return 'revoke'; + } + + private function memberSelect(): Select + { + return DelasPersonSelect::make(fn (DelasCandidates $candidates) => $candidates->forRevoke($this->actor())) + ->helperText(__('panel-admin::delas.actions.member_hint')); + } +} diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/UnblockDelasRequesterAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/UnblockDelasRequesterAction.php new file mode 100644 index 000000000..fa4eea974 --- /dev/null +++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/UnblockDelasRequesterAction.php @@ -0,0 +1,58 @@ +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 => $this->text('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) => $this->runDomainAction( + fn () => resolve(UnblockDelasRequester::class)->handle($record, $this->actor(), $this->reasonFrom($data)), + $this->text('panel-admin::delas.actions.unblocked'), + )); + } + + public static function getDefaultName(): string + { + return 'unblock'; + } + + private function canUnblock(DelasRequesterBlock $block): bool + { + return $block->blocked_by === $this->actor()->getKey() || $this->isLead(); + } +} diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/ViewDelasProfileAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/ViewDelasProfileAction.php new file mode 100644 index 000000000..579b092d8 --- /dev/null +++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/ViewDelasProfileAction.php @@ -0,0 +1,69 @@ +modalHeading(__('panel-admin::delas.profile.heading')) + ->slideOver() + ->modalWidth(Width::Medium) + ->modalContent(function (Model $record): View { + $person = $this->personOf($record); + + return view('panel-admin::moderation.delas.person-profile', [ + 'person' => $person, + 'eligibility' => resolve(DelasEligibility::class)->for($person), + ]); + }) + ->modalSubmitAction(action: false) + ->modalCancelActionLabel(__('panel-admin::delas.actions.close')); + } + + public static function getDefaultName(): string + { + return 'viewProfile'; + } + + public function personRelation(?string $relation): static + { + $this->personRelation = $relation; + + return $this; + } + + /** + * 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. + */ + private function personOf(Model $record): User + { + $id = $this->personRelation === null + ? $record->getKey() + : $record->getAttribute($this->personRelation.'_id'); + + return User::query()->with(['profile', 'providers'])->whereKey($id)->firstOrFail(); + } +} diff --git a/app-modules/panel-admin/src/Moderation/Actions/Delas/ViewDelasReasonVersionsAction.php b/app-modules/panel-admin/src/Moderation/Actions/Delas/ViewDelasReasonVersionsAction.php new file mode 100644 index 000000000..b7857811e --- /dev/null +++ b/app-modules/panel-admin/src/Moderation/Actions/Delas/ViewDelasReasonVersionsAction.php @@ -0,0 +1,39 @@ +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')); + } + + public static function getDefaultName(): string + { + return 'viewVersions'; + } +} 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 1fb648bf1..eb3668fdf 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 @@ -4,30 +4,20 @@ namespace He4rt\PanelAdmin\Moderation\Pages\Delas\Concerns; -use Closure; -use Filament\Actions\Action; -use Filament\Forms\Components\Textarea; -use Filament\Forms\Components\Toggle; -use Filament\Notifications\Notification; use Filament\Schemas\Components\EmbeddedTable; use Filament\Schemas\Schema; -use Filament\Support\Enums\Width; use Filament\Tables\Columns\TextColumn; -use He4rt\Delas\Exceptions\DelasException; -use He4rt\Delas\Support\Reason; -use He4rt\Delas\TagRequest\Queries\DelasEligibility; use He4rt\Identity\User\Models\User; -use Illuminate\Auth\Access\AuthorizationException; +use He4rt\PanelAdmin\Moderation\Actions\Delas\ViewDelasProfileAction; use Illuminate\Contracts\Support\Htmlable; -use Illuminate\Contracts\View\View; -use Illuminate\Database\Eloquent\Model; use Illuminate\Support\HtmlString; use Illuminate\Support\Str; /** * O que as páginas da He4rt Delas no cluster de Moderação têm em comum: o grupo - * na subnavegação, o cabeçalho com a logo, a tabela única e os campos e colunas - * repetidos. Cada página decide o próprio acesso no `canAccess()`. + * na subnavegação, o cabeçalho com a logo, a tabela única e as colunas + * repetidas. Cada página decide o próprio acesso no `canAccess()`, e as ações + * moram em `Moderation\Actions\Delas`. */ trait InteractsWithDelasModeration { @@ -53,9 +43,19 @@ protected function isLead(): bool return $this->actor()->can('lead-delas'); } + protected function actor(): User + { + $user = auth()->user(); + + abort_unless($user instanceof User, 403); + + return $user; + } + /** - * Nome, @username e "Ver perfil": clicar abre um resumo só leitura do perfil, - * sem sair da página. + * Nome, @username e "Ver perfil". Clicar na célula abre o resumo do perfil. + * + * @param string $name `name` quando a linha é a pessoa; `user.name` quando ela vem pela relação `user` */ protected function personColumn(string $name, string $username, string $label): TextColumn { @@ -67,45 +67,10 @@ protected function personColumn(string $name, string $username, string $label): ->description(fn (mixed $record): HtmlString => new HtmlString( e('@'.data_get($record, $username)).' · '.$this->clickableHint('panel-admin::delas.actions.view_profile'), )) - ->action($this->viewProfileAction($relation)) + ->action(ViewDelasProfileAction::make()->personRelation($relation)) ->searchable([$relation === null ? $name : 'name']); } - /** - * O que a moderação precisa para decidir, e nada além: sem e-mail, data de - * nascimento nem localização. A pessoa é carregada sozinha, com o perfil e - * as conexões, só quando o resumo abre. - */ - protected function viewProfileAction(?string $relation): Action - { - return Action::make('viewProfile') - ->modalHeading(__('panel-admin::delas.profile.heading')) - ->slideOver() - ->modalWidth(Width::Medium) - ->modalContent(function (Model $record) use ($relation): View { - $person = User::query() - ->with(['profile', 'providers']) - ->whereKey($relation === null ? $record->getKey() : $record->getAttribute($relation.'_id')) - ->firstOrFail(); - - return view('panel-admin::moderation.delas.person-profile', [ - 'person' => $person, - 'eligibility' => resolve(DelasEligibility::class)->for($person), - ]); - }) - ->modalSubmitAction(action: false) - ->modalCancelActionLabel(__('panel-admin::delas.actions.close')); - } - - /** - * Texto sublinhado dentro da descrição de uma coluna, avisando que clicar na - * célula abre algo. O clique em si é a action da coluna. - */ - protected function clickableHint(string $key): string - { - return ''.e($this->text($key)).''; - } - protected function dateColumn(string $name, string $label): TextColumn { return TextColumn::make($name) @@ -115,72 +80,13 @@ protected function dateColumn(string $name, string $label): TextColumn ->sortable(); } - protected function reasonField(string $label, bool|Closure $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')); - } - - /** - * 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 + * Texto sublinhado na descrição de uma coluna, avisando que clicar na célula + * abre algo. O clique em si é a action da coluna. */ - 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. - */ - 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 + protected function clickableHint(string $key): string { - $reason = $data['reason'] ?? null; - - return is_string($reason) ? $reason : null; + return ''.e($this->text($key)).''; } /** @@ -192,13 +98,4 @@ protected function text(string $key, array $replace = []): string 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 index 48e8102e6..ab0ee5a36 100644 --- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasBlocksPage.php +++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasBlocksPage.php @@ -5,15 +5,14 @@ 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; use Filament\Tables\Concerns\InteractsWithTable; use Filament\Tables\Contracts\HasTable; use Filament\Tables\Table; -use He4rt\Delas\Block\Actions\UnblockDelasRequester; use He4rt\Delas\Block\Models\DelasRequesterBlock; +use He4rt\PanelAdmin\Moderation\Actions\Delas\UnblockDelasRequesterAction; use He4rt\PanelAdmin\Moderation\ModerationCluster; use He4rt\PanelAdmin\Moderation\Pages\Delas\Concerns\InteractsWithDelasModeration; @@ -79,34 +78,16 @@ public function table(Table $table): Table $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')), + ->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'), - )), + UnblockDelasRequesterAction::make(), ]); } - - 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 index b45d9ed47..154aab632 100644 --- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php +++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasHistoryPage.php @@ -5,8 +5,6 @@ namespace He4rt\PanelAdmin\Moderation\Pages\Delas; use BackedEnum; -use Carbon\CarbonInterface; -use Filament\Actions\Action; use Filament\Pages\Page; use Filament\Support\Icons\Heroicon; use Filament\Tables\Columns\TextColumn; @@ -14,12 +12,13 @@ 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\Actions\Delas\EditDelasReasonAction; +use He4rt\PanelAdmin\Moderation\Actions\Delas\ViewDelasReasonVersionsAction; use He4rt\PanelAdmin\Moderation\ModerationCluster; use He4rt\PanelAdmin\Moderation\Pages\Delas\Concerns\InteractsWithDelasModeration; -use Illuminate\Contracts\View\View; +use Illuminate\Database\Eloquent\Builder; use Illuminate\Support\HtmlString; /** @@ -63,19 +62,8 @@ public function getSubheading(): string public function table(Table $table): Table { - // 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. - if (!$this->isLead()) { - $query->where('action', '!=', DelasAction::Requested); - } - return $table - ->query($query) + ->query($this->visibleHistory()) ->defaultSort('created_at', 'desc') ->emptyStateHeading(__('panel-admin::delas.empty.history')) ->emptyStateDescription(__('panel-admin::delas.empty.history_body')) @@ -93,91 +81,50 @@ 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): ?HtmlString => $this->reasonNote($record)) - ->action($this->viewVersionsAction()) + ->description(fn (DelasTransition $record): ?HtmlString => $this->editedNote($record)) + ->action(ViewDelasReasonVersionsAction::make()) ->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')) - ->tooltip(fn (DelasTransition $record): string => $this->correctionWindowNote($record)) - ->modalDescription(fn (DelasTransition $record): string => implode(' ', [ - $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( - fn () => resolve(CorrectDelasReason::class)->handle($record, $this->actor(), $this->reasonFrom($data)), - __('panel-admin::delas.actions.reason_corrected'), - )), + EditDelasReasonAction::make(), ]) - ->filters($this->isLead() ? [ - SelectFilter::make('action') - ->label(__('panel-admin::delas.columns.action')) - ->options(collect(DelasAction::cases()) - ->reject(fn (DelasAction $action): bool => $action === DelasAction::ReasonCorrected) - ->mapWithKeys(fn (DelasAction $action): array => [$action->value => $action->getLabel()]) - ->all()), - ] : []); + ->filters($this->isLead() ? [$this->actionFilter()] : []); } /** - * 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. + * Cada edição de motivo fica guardada como linha própria, mas aparece dentro + * da linha que ela edita. A moderadora vê as decisões; a líder vê também os + * pedidos (os pedidos em aberto a moderadora já vê na Fila). + * + * @return Builder */ - private function canCorrect(DelasTransition $record): bool + private function visibleHistory(): Builder { - if (!$record->hasCorrectableReason()) { - return false; - } - - if ($this->isLead()) { - return true; - } + $hidden = $this->isLead() + ? [DelasAction::ReasonCorrected] + : [DelasAction::ReasonCorrected, DelasAction::Requested]; - $isAuthor = $record->actor_id === $this->actor()->getKey(); - - return $isAuthor && ($this->correctionDeadline($record)?->isFuture() ?? false); + return DelasTransition::query() + ->with(['user', 'actor', 'corrections.actor']) + ->whereNotIn('action', $hidden); } - /** - * Até quando quem escreveu o motivo pode editá-lo. - */ - private function correctionDeadline(DelasTransition $record): ?CarbonInterface + private function actionFilter(): SelectFilter { - return $record->created_at?->copy()->addHours(config()->integer('delas.reason_correction_hours')); - } + $actions = array_filter(DelasAction::cases(), fn (DelasAction $action): bool => $action !== DelasAction::ReasonCorrected); - /** - * 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 viewVersionsAction(): Action - { - 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')); + return SelectFilter::make('action') + ->label(__('panel-admin::delas.columns.action')) + ->options(collect($actions)->mapWithKeys(fn (DelasAction $action): array => [$action->value => $action->getLabel()])->all()); } /** * "Editado em DD/MM/AA por X" na linha cujo motivo foi editado; a liderança - * ganha também o "ver versões". + * ganha também o "ver versões", que abre ao clicar no motivo. */ - private function reasonNote(DelasTransition $record): ?HtmlString + private function editedNote(DelasTransition $record): ?HtmlString { $latest = $record->corrections->last(); @@ -196,23 +143,4 @@ private function reasonNote(DelasTransition $record): ?HtmlString return new HtmlString($note); } - - /** - * Até quando quem escreveu pode corrigir; a líder corrige sempre. - */ - private function correctionWindowNote(DelasTransition $record): string - { - if ($this->isLead()) { - return $this->text('panel-admin::delas.actions.correct_anytime'); - } - - return $this->text('panel-admin::delas.actions.correct_until', [ - 'date' => $this->displayDate($this->correctionDeadline($record)), - ]); - } - - private function displayDate(?CarbonInterface $date): string - { - return $date?->timezone(config('app.display_timezone'))->format('d/m/Y H:i') ?? '—'; - } } 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 15714ae05..535089d12 100644 --- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasMembersPage.php +++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasMembersPage.php @@ -5,16 +5,15 @@ 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; use Filament\Tables\Concerns\InteractsWithTable; use Filament\Tables\Contracts\HasTable; use Filament\Tables\Table; -use He4rt\Delas\TagRequest\Actions\RevokeDelasTag; use He4rt\Delas\TagRequest\Enums\DelasRequestStatus; use He4rt\Delas\TagRequest\Models\DelasTagRequest; +use He4rt\PanelAdmin\Moderation\Actions\Delas\RevokeDelasTagAction; use He4rt\PanelAdmin\Moderation\ModerationCluster; use He4rt\PanelAdmin\Moderation\Pages\Delas\Concerns\InteractsWithDelasModeration; @@ -83,25 +82,7 @@ public function table(Table $table): Table ->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), - )), + RevokeDelasTagAction::make()->button()->size('sm'), ]); } } 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 8763ed408..39518eec3 100644 --- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasQueuePage.php +++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasQueuePage.php @@ -5,17 +5,15 @@ namespace He4rt\PanelAdmin\Moderation\Pages\Delas; use BackedEnum; -use Filament\Actions\Action; use Filament\Pages\Page; use Filament\Support\Icons\Heroicon; use Filament\Tables\Concerns\InteractsWithTable; use Filament\Tables\Contracts\HasTable; use Filament\Tables\Table; -use He4rt\Delas\Block\Actions\BlockDelasRequester; -use He4rt\Delas\TagRequest\Actions\ApproveDelasRequest; -use He4rt\Delas\TagRequest\Actions\RejectDelasRequest; use He4rt\Delas\TagRequest\Models\DelasTagRequest; -use He4rt\Identity\User\Models\User; +use He4rt\PanelAdmin\Moderation\Actions\Delas\ApproveDelasRequestAction; +use He4rt\PanelAdmin\Moderation\Actions\Delas\BlockDelasRequesterAction; +use He4rt\PanelAdmin\Moderation\Actions\Delas\RejectDelasRequestAction; use He4rt\PanelAdmin\Moderation\ModerationCluster; use He4rt\PanelAdmin\Moderation\Pages\Delas\Concerns\InteractsWithDelasModeration; @@ -66,7 +64,7 @@ public function getSubheading(): string public function table(Table $table): Table { return $table - // `user.roles`: o botão de bloquear checa o gate da pessoa em cada linha. + // `user.roles`: o cadeado 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')) @@ -77,63 +75,9 @@ public function table(Table $table): Table $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')) - // 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) - ? $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')) - ->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'), - )), + ApproveDelasRequestAction::make(), + RejectDelasRequestAction::make(), + BlockDelasRequesterAction::make(), ]); } - - 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 index 5e989ab5b..19c05a94b 100644 --- a/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php +++ b/app-modules/panel-admin/src/Moderation/Pages/Delas/DelasTeamPage.php @@ -5,32 +5,25 @@ namespace He4rt\PanelAdmin\Moderation\Pages\Delas; use BackedEnum; -use Closure; 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; -use He4rt\Delas\TagRequest\Actions\RevokeDelasTag; -use He4rt\Delas\Team\Actions\AddDelasModerator; -use He4rt\Delas\Team\Actions\RemoveDelasModerator; -use He4rt\Delas\Team\Queries\DelasCandidates; use He4rt\Identity\Authorization\Enums\UserRole; use He4rt\Identity\User\Models\User; +use He4rt\PanelAdmin\Moderation\Actions\Delas\AddDelasModeratorAction; +use He4rt\PanelAdmin\Moderation\Actions\Delas\GrantDelasTagAction; +use He4rt\PanelAdmin\Moderation\Actions\Delas\RemoveDelasModeratorAction; +use He4rt\PanelAdmin\Moderation\Actions\Delas\RevokeDelasTagAction; use He4rt\PanelAdmin\Moderation\ModerationCluster; use He4rt\PanelAdmin\Moderation\Pages\Delas\Concerns\InteractsWithDelasModeration; use He4rt\PanelAdmin\Moderation\Widgets\Delas\DelasStatsOverview; use Illuminate\Database\Eloquent\Builder; -use Illuminate\Database\Eloquent\Collection; /** * A equipe da He4rt Delas, só para líderes e super admins: os números, as @@ -72,35 +65,13 @@ public function getSubheading(): string 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::moderationDecisions()), - ]) - ->role([UserRole::DelasModerator->value, UserRole::DelasLead->value]) - ->with('roles'), - ) + ->query($this->team()) ->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())) - ->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()), - __('panel-admin::delas.actions.moderator_added'), - )), + AddDelasModeratorAction::make(), ]) ->columns([ $this->personColumn('name', 'username', __('panel-admin::delas.columns.person')), @@ -114,22 +85,7 @@ public function table(Table $table): Table ->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'), - )), + RemoveDelasModeratorAction::make(), ]); } @@ -147,131 +103,27 @@ protected function getHeaderWidgets(): 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()))->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)), - __('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([ - // 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(), - ]) - ->action(fn (array $data): bool => $this->attempt( - fn () => resolve(RevokeDelasTag::class)->handle( - target: $this->findUser($data['user_id']), - actor: $this->actor(), - reason: $this->reasonFrom($data), - alsoBlock: $this->alsoBlockFrom($data), - ), - $this->revokedTitle($data), - )), + GrantDelasTagAction::make(), + RevokeDelasTagAction::make(), ]; } /** - * 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. + * Moderadoras e líderes, cada uma com quantas decisões de moderação já tomou. * - * @param Closure(): Builder $candidates + * @return Builder */ - private function searchablePersonSelect(Closure $candidates): Select + private function team(): Builder { - return Select::make('user_id') - ->label(__('panel-admin::delas.actions.person')) - ->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), - )) - ->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 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' => mb_rtrim($block->reason, '. '), - ]); - } - - private function findUser(mixed $id): User - { - return User::query()->whereKey($id)->firstOrFail(); + $decisionsCount = DelasTransition::query() + ->selectRaw('count(*)') + ->whereColumn('delas_transitions.actor_id', 'users.id') + ->whereIn('action', DelasAction::moderationDecisions()); + + return User::query() + ->select('users.*') + ->addSelect(['decisions_count' => $decisionsCount]) + ->role([UserRole::DelasModerator->value, UserRole::DelasLead->value]) + ->with('roles'); } } From f0f019f98c7de2aa47aa1eeec97ee8193664610d Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Thu, 8 Oct 2026 13:17:49 -0300 Subject: [PATCH 57/77] =?UTF-8?q?test(delas):=20testes=20mais=20f=C3=A1cei?= =?UTF-8?q?s=20de=20ler,=20um=20comportamento=20por=20teste?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../Feature/Authorization/DelasGatesTest.php | 4 +- .../Feature/Block/BlockDelasRequesterTest.php | 86 ++- .../History/CorrectDelasReasonTest.php | 80 ++- .../tests/Feature/Schema/DelasSchemaTest.php | 33 +- .../TagRequest/DecideDelasRequestTest.php | 135 ++-- .../TagRequest/GrantAndRevokeDelasTagTest.php | 133 ++-- .../TagRequest/RequestDelasTagTest.php | 89 ++- .../Feature/Team/DelasCandidatesTest.php | 85 ++- .../Team/ManageDelasModeratorsTest.php | 76 ++- .../AdminComponentAccessTest.php | 68 +- .../Delas/DelasModerationPagesTest.php | 628 ++++++++++++------ .../Feature/Delas/DelasProfileSectionTest.php | 4 +- 12 files changed, 945 insertions(+), 476 deletions(-) diff --git a/app-modules/delas/tests/Feature/Authorization/DelasGatesTest.php b/app-modules/delas/tests/Feature/Authorization/DelasGatesTest.php index 852ebdc68..c0bf95b7a 100644 --- a/app-modules/delas/tests/Feature/Authorization/DelasGatesTest.php +++ b/app-modules/delas/tests/Feature/Authorization/DelasGatesTest.php @@ -14,8 +14,8 @@ $factory = User::factory(); $user = ($state === null ? $factory : $factory->{$state}())->create(); - expect($user->can('moderate-delas'))->toBe($moderate) - ->and($user->can('lead-delas'))->toBe($lead); + expect($user->can('moderate-delas'))->toBe($moderate); + expect($user->can('lead-delas'))->toBe($lead); })->with([ 'membra comum' => [null, false, false], 'moderadora' => ['delasModerator', true, false], diff --git a/app-modules/delas/tests/Feature/Block/BlockDelasRequesterTest.php b/app-modules/delas/tests/Feature/Block/BlockDelasRequesterTest.php index 8def42620..60ba12688 100644 --- a/app-modules/delas/tests/Feature/Block/BlockDelasRequesterTest.php +++ b/app-modules/delas/tests/Feature/Block/BlockDelasRequesterTest.php @@ -15,74 +15,110 @@ use He4rt\Identity\User\Models\User; use Illuminate\Auth\Access\AuthorizationException; +beforeEach(function (): void { + $this->block = resolve(BlockDelasRequester::class); + $this->unblock = resolve(UnblockDelasRequester::class); +}); + +// Bloquear + +test('bloquear deixa a pessoa bloqueada por quem bloqueou', function (): void { + $moderator = User::factory()->delasModerator()->create(); + $target = User::factory()->create(); + + $block = $this->block->handle($target, $moderator, 'Pedidos repetidos.'); + + expect($block->isActive())->toBeTrue(); + expect($block->blocked_by)->toBe($moderator->getKey()); + expect(resolve(DelasEligibility::class)->for($target)->state)->toBe(DelasEligibilityState::Blocked); +}); + test('bloquear rejeita a solicitação pendente e registra as duas ações', function (): void { $moderator = User::factory()->delasModerator()->create(); $target = User::factory()->create(); $request = DelasTagRequest::factory()->for($target)->pending()->create(); - $block = resolve(BlockDelasRequester::class)->handle($target, $moderator, 'Pedidos repetidos.'); + $this->block->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()) + expect($request->fresh()->status)->toBe(DelasRequestStatus::Rejected); + expect(DelasTransition::query()->oldest()->pluck('action')->all()) ->toEqualCanonicalizing([DelasAction::Rejected, DelasAction::Blocked]); }); test('bloquear exige motivo', function (): void { $moderator = User::factory()->delasModerator()->create(); + $target = User::factory()->create(); - expect(fn () => resolve(BlockDelasRequester::class)->handle(User::factory()->create(), $moderator, ' ')) + expect(fn () => $this->block->handle($target, $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 { +test('não bloqueia quem é da equipe 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')) + expect(fn () => $this->block->handle($target, $moderator, 'motivo')) ->toThrow(DelasException::class, __('delas::exceptions.cannot_block_team')); -})->with(['delasModerator', 'delasLead', 'superAdmin', 'self']); +})->with([ + 'moderadora' => 'delasModerator', + 'líder' => 'delasLead', + 'super admin' => 'superAdmin', + 'a si mesma' => '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'); + $this->block->handle($target, $moderator, 'primeiro'); - expect(fn () => resolve(BlockDelasRequester::class)->handle($target, $moderator, 'segundo')) + expect(fn () => $this->block->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')) + $member = User::factory()->create(); + $target = User::factory()->create(); + + expect(fn () => $this->block->handle($target, $member, 'motivo')) ->toThrow(AuthorizationException::class); }); -test('moderadora desbloqueia o próprio bloqueio, com motivo obrigatório', function (): void { +// Desbloquear + +test('desbloquear exige motivo', function (): void { $moderator = User::factory()->delasModerator()->create(); $block = DelasRequesterBlock::factory()->create(['blocked_by' => $moderator->getKey()]); - expect(fn () => resolve(UnblockDelasRequester::class)->handle($block, $moderator, '')) + expect(fn () => $this->unblock->handle($block, $moderator, '')) ->toThrow(DelasException::class, __('delas::exceptions.reason_required')); +}); - resolve(UnblockDelasRequester::class)->handle($block, $moderator, 'Situação esclarecida.'); +test('moderadora desbloqueia o próprio bloqueio e o histórico registra', function (): void { + $moderator = User::factory()->delasModerator()->create(); + $block = DelasRequesterBlock::factory()->create(['blocked_by' => $moderator->getKey()]); - $block->refresh(); + $this->unblock->handle($block, $moderator, 'Situação esclarecida.'); - 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); + $block->refresh(); + expect($block->isActive())->toBeFalse(); + expect($block->lifted_by)->toBe($moderator->getKey()); + expect($block->lift_reason)->toBe('Situação esclarecida.'); + expect(DelasTransition::query()->sole()->action)->toBe(DelasAction::Unblocked); }); -test('moderadora não desbloqueia o bloqueio de outra; líder desbloqueia qualquer um', function (): void { +test('moderadora não desbloqueia o bloqueio de outra', function (): void { $block = DelasRequesterBlock::factory()->create(); + $otherModerator = User::factory()->delasModerator()->create(); - expect(fn () => resolve(UnblockDelasRequester::class)->handle($block, User::factory()->delasModerator()->create(), 'motivo')) + expect(fn () => $this->unblock->handle($block, $otherModerator, 'motivo')) ->toThrow(DelasException::class, __('delas::exceptions.cannot_unblock_others')); +}); + +test('líder desbloqueia qualquer bloqueio', function (): void { + $block = DelasRequesterBlock::factory()->create(); + $lead = User::factory()->delasLead()->create(); - resolve(UnblockDelasRequester::class)->handle($block, User::factory()->delasLead()->create(), 'motivo'); + $this->unblock->handle($block, $lead, 'motivo'); expect($block->fresh()->isActive())->toBeFalse(); }); @@ -91,6 +127,6 @@ $lead = User::factory()->delasLead()->create(); $block = DelasRequesterBlock::factory()->lifted()->create(); - expect(fn () => resolve(UnblockDelasRequester::class)->handle($block, $lead, 'de novo')) + expect(fn () => $this->unblock->handle($block, $lead, 'de novo')) ->toThrow(DelasException::class, __('delas::exceptions.block_already_lifted')); }); diff --git a/app-modules/delas/tests/Feature/History/CorrectDelasReasonTest.php b/app-modules/delas/tests/Feature/History/CorrectDelasReasonTest.php index f995f307e..eb275f750 100644 --- a/app-modules/delas/tests/Feature/History/CorrectDelasReasonTest.php +++ b/app-modules/delas/tests/Feature/History/CorrectDelasReasonTest.php @@ -19,30 +19,43 @@ function rejectionBy(User $moderator, string $reason = 'Perfil incompleo.'): Del 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 { +beforeEach(function (): void { + $this->correct = resolve(CorrectDelasReason::class); +}); + +test('a correção é uma linha nova, de quem corrigiu, ligada à original', function (): void { $moderator = User::factory()->delasModerator()->create(); $original = rejectionBy($moderator); - $correction = resolve(CorrectDelasReason::class)->handle($original, $moderator, 'Perfil incompleto.'); + $correction = $this->correct->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.'); + expect($correction->action)->toBe(DelasAction::ReasonCorrected); + expect($correction->corrects_id)->toBe($original->getKey()); + expect($correction->actor_id)->toBe($moderator->getKey()); +}); + +test('depois da correção, a original continua como foi escrita, mas vale o texto novo', function (): void { + $moderator = User::factory()->delasModerator()->create(); + $original = rejectionBy($moderator); + + $this->correct->handle($original, $moderator, 'Perfil incompleto.'); + + $original->refresh(); + expect($original->reason)->toBe('Perfil incompleo.'); + expect($original->currentReason())->toBe('Perfil incompleto.'); + expect($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->correct->handle($original, $moderator, 'Primeira correção.'); $this->travel(1)->minutes(); - resolve(CorrectDelasReason::class)->handle($original->fresh(), $moderator, 'Segunda correção.'); + $this->correct->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); + expect($original->fresh()->currentReason())->toBe('Segunda correção.'); + expect(DelasTransition::query()->where('corrects_id', $original->getKey())->count())->toBe(2); }); test('corrigir o motivo de um bloqueio atualiza o bloqueio', function (): void { @@ -50,54 +63,71 @@ function rejectionBy(User $moderator, string $reason = 'Perfil incompleo.'): Del $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.'); + $this->correct->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 { +test('quem escreveu não corrige depois do prazo', 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.')) + expect(fn () => $this->correct->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()); + $otherModerator = User::factory()->delasModerator()->create(); - expect(fn () => resolve(CorrectDelasReason::class)->handle($original, User::factory()->delasModerator()->create(), 'Outro texto.')) + expect(fn () => $this->correct->handle($original, $otherModerator, 'Outro texto.')) ->toThrow(DelasException::class); }); test('a líder corrige qualquer motivo, a qualquer momento', function (): void { $original = rejectionBy(User::factory()->delasModerator()->create()); + $lead = User::factory()->delasLead()->create(); $this->travel(30)->days(); - $correction = resolve(CorrectDelasReason::class)->handle($original, User::factory()->delasLead()->create(), 'Motivo revisado pela liderança.'); + $correction = $this->correct->handle($original, $lead, 'Motivo revisado pela liderança.'); expect($original->fresh()->currentReason())->toBe($correction->reason); }); -test('recusa motivo vazio, motivo igual e linhas sem motivo', function (): void { +test('recusa motivo vazio', 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.')) + expect(fn () => $this->correct->handle($original, $moderator, ' ')) + ->toThrow(DelasException::class, __('delas::exceptions.reason_required')); +}); + +test('recusa motivo igual ao atual', function (): void { + $moderator = User::factory()->delasModerator()->create(); + $original = rejectionBy($moderator, 'Motivo.'); + + expect(fn () => $this->correct->handle($original, $moderator, 'Motivo.')) + ->toThrow(DelasException::class, __('delas::exceptions.reason_unchanged')); +}); + +test('recusa corrigir linhas sem motivo', function (): void { + $moderator = User::factory()->delasModerator()->create(); + $approval = DelasTransition::factory()->create([ + 'action' => DelasAction::Approved, + 'actor_id' => $moderator->getKey(), + ]); + + expect(fn () => $this->correct->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()); + $member = User::factory()->create(); - expect(fn () => resolve(CorrectDelasReason::class)->handle($original, User::factory()->create(), 'Texto.')) + expect(fn () => $this->correct->handle($original, $member, 'Texto.')) ->toThrow(AuthorizationException::class); }); diff --git a/app-modules/delas/tests/Feature/Schema/DelasSchemaTest.php b/app-modules/delas/tests/Feature/Schema/DelasSchemaTest.php index 8b3c2978c..dd4ebf8d2 100644 --- a/app-modules/delas/tests/Feature/Schema/DelasSchemaTest.php +++ b/app-modules/delas/tests/Feature/Schema/DelasSchemaTest.php @@ -12,7 +12,6 @@ test('o banco recusa duas solicitações ativas da mesma pessoa', function (string $first, string $second): void { $user = User::factory()->create(); - DelasTagRequest::factory()->for($user)->{$first}()->create(); expect(fn () => DelasTagRequest::factory()->for($user)->{$second}()->create()) @@ -24,22 +23,30 @@ 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(); + $active = DelasTagRequest::query()->where('user_id', $user->getKey())->active()->sole(); + expect($active->is($pending))->toBeTrue(); }); -test('o banco recusa dois bloqueios ativos da mesma pessoa, mas guarda os encerrados', function (): void { +test('o banco guarda bloqueios encerrados ao lado do ativo', 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()) + expect(DelasRequesterBlock::query()->where('user_id', $user->getKey())->count())->toBe(2); +}); + +test('o banco recusa dois bloqueios ativos da mesma pessoa', function (): void { + $user = User::factory()->create(); + DelasRequesterBlock::factory()->for($user)->lifted()->create(); + DelasRequesterBlock::factory()->for($user)->create(); + + expect(fn () => DelasRequesterBlock::factory()->for($user)->create()) ->toThrow(UniqueConstraintViolationException::class); }); @@ -48,11 +55,13 @@ 'action' => DelasAction::Approved, 'from_status' => DelasRequestStatus::Pending, 'to_status' => DelasRequestStatus::Approved, - ])->fresh(); + ]); + + $stored = $transition->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'); + expect($stored->action)->toBe(DelasAction::Approved); + expect($stored->from_status)->toBe(DelasRequestStatus::Pending); + expect($stored->to_status)->toBe(DelasRequestStatus::Approved); + expect($stored->created_at)->not->toBeNull(); + expect($stored->getAttributes())->not->toHaveKey('updated_at'); }); diff --git a/app-modules/delas/tests/Feature/TagRequest/DecideDelasRequestTest.php b/app-modules/delas/tests/Feature/TagRequest/DecideDelasRequestTest.php index b49f489b2..15dfd470f 100644 --- a/app-modules/delas/tests/Feature/TagRequest/DecideDelasRequestTest.php +++ b/app-modules/delas/tests/Feature/TagRequest/DecideDelasRequestTest.php @@ -17,92 +17,141 @@ use Illuminate\Auth\Access\AuthorizationException; use Illuminate\Support\Facades\Event; -test('moderadora aprova: a tag aparece e o histórico guarda quem e quando', function (): void { +beforeEach(function (): void { + $this->approve = resolve(ApproveDelasRequest::class); + $this->reject = resolve(RejectDelasRequest::class); + $this->eligibility = resolve(DelasEligibility::class); +}); + +// Aprovar + +test('moderadora aprova: a solicitação guarda quem decidiu e quando', function (): void { Event::fake([DelasTagApproved::class]); $moderator = User::factory()->delasModerator()->create(); $request = DelasTagRequest::factory()->pending()->create(); - $this->freezeSecond(); - resolve(ApproveDelasRequest::class)->handle($request, $moderator); + + $this->approve->handle($request, $moderator); $request->refresh(); + expect($request->status)->toBe(DelasRequestStatus::Approved); + expect($request->decided_by)->toBe($moderator->getKey()); + expect($request->decided_at->toDateTimeString())->toBe(now()->toDateTimeString()); + Event::assertDispatched(DelasTagApproved::class); +}); + +test('aprovada, a pessoa passa a ter a tag', function (): void { + $moderator = User::factory()->delasModerator()->create(); + $request = DelasTagRequest::factory()->pending()->create(); + + $this->approve->handle($request, $moderator); + + expect($this->eligibility->hasTag($request->user))->toBeTrue(); +}); + +test('aprovar registra no histórico a moderadora e a mudança de situação', function (): void { + $moderator = User::factory()->delasModerator()->create(); + $request = DelasTagRequest::factory()->pending()->create(); + + $this->approve->handle($request, $moderator); + $transition = DelasTransition::query()->sole(); + expect($transition->action)->toBe(DelasAction::Approved); + expect($transition->triggered_by)->toBe(DelasTriggeredBy::Moderator); + expect($transition->from_status)->toBe(DelasRequestStatus::Pending); + expect($transition->to_status)->toBe(DelasRequestStatus::Approved); +}); - 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); +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(); - Event::assertDispatched(DelasTagApproved::class); + $this->approve->handle($request, $admin); + + expect(DelasTransition::query()->sole()->triggered_by)->toBe(DelasTriggeredBy::Admin); }); -test('moderadora rejeita com motivo: a tag não aparece e a solicitação sai das pendentes', function (): void { +// Rejeitar + +test('moderadora rejeita com motivo: a solicitação sai das pendentes e guarda o motivo limpo', 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. '); + $this->reject->handle($request, $moderator, ' Perfil sem informações. '); $request->refresh(); + expect($request->status)->toBe(DelasRequestStatus::Rejected); + expect($request->decision_reason)->toBe('Perfil sem informações.'); + expect(DelasTagRequest::query()->pending()->exists())->toBeFalse(); + expect(DelasTransition::query()->sole()->reason)->toBe('Perfil sem informações.'); + Event::assertDispatched(DelasTagRejected::class); +}); - 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.'); +test('rejeitada, a pessoa não tem a tag', function (): void { + $moderator = User::factory()->delasModerator()->create(); + $request = DelasTagRequest::factory()->pending()->create(); - Event::assertDispatched(DelasTagRejected::class); + $this->reject->handle($request, $moderator, 'Perfil sem informações.'); + + expect($this->eligibility->hasTag($request->user))->toBeFalse(); }); 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)) + expect(fn () => $this->reject->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 { +// Quem pode decidir + +test('quem não é da equipe não aprova', function (): void { + $member = User::factory()->create(); + $request = DelasTagRequest::factory()->pending()->create(); + + expect(fn () => $this->approve->handle($request, $member)) + ->toThrow(AuthorizationException::class); + + expect($request->fresh()->status)->toBe(DelasRequestStatus::Pending); +}); + +test('quem não é da equipe não 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); + expect(fn () => $this->reject->handle($request, $member, 'motivo')) + ->toThrow(AuthorizationException::class); + + expect($request->fresh()->status)->toBe(DelasRequestStatus::Pending); }); -test('moderadora não decide a própria solicitação', function (): void { +test('moderadora não aprova a própria solicitação', function (): void { $moderator = User::factory()->delasModerator()->create(); - $request = DelasTagRequest::factory()->for($moderator)->pending()->create(); + $ownRequest = 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')) + expect(fn () => $this->approve->handle($ownRequest, $moderator)) ->toThrow(DelasException::class, __('delas::exceptions.cannot_decide_own')); }); -test('uma solicitação já decidida não é decidida de novo', function (): void { +test('moderadora não rejeita a própria solicitação', function (): void { $moderator = User::factory()->delasModerator()->create(); - $other = User::factory()->delasModerator()->create(); - $request = DelasTagRequest::factory()->pending()->create(); - - resolve(ApproveDelasRequest::class)->handle($request, $moderator); + $ownRequest = DelasTagRequest::factory()->for($moderator)->pending()->create(); - 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); + expect(fn () => $this->reject->handle($ownRequest, $moderator, 'motivo')) + ->toThrow(DelasException::class, __('delas::exceptions.cannot_decide_own')); }); -test('super admin decide sem papel da He4rt Delas e fica registrado como admin', function (): void { - $admin = User::factory()->superAdmin()->create(); +test('uma solicitação já decidida não é decidida de novo', function (): void { + $moderator = User::factory()->delasModerator()->create(); + $otherModerator = User::factory()->delasModerator()->create(); $request = DelasTagRequest::factory()->pending()->create(); + $this->approve->handle($request, $moderator); - resolve(ApproveDelasRequest::class)->handle($request, $admin); + expect(fn () => $this->reject->handle($request, $otherModerator, 'atrasada')) + ->toThrow(DelasException::class); - expect(DelasTransition::query()->sole()->triggered_by)->toBe(DelasTriggeredBy::Admin); + expect($request->fresh()->status)->toBe(DelasRequestStatus::Approved); + expect(DelasTransition::query()->count())->toBe(1); }); diff --git a/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php b/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php index e3001a459..64f99bd6d 100644 --- a/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php +++ b/app-modules/delas/tests/Feature/TagRequest/GrantAndRevokeDelasTagTest.php @@ -20,18 +20,26 @@ use Illuminate\Auth\Access\AuthorizationException; use Illuminate\Support\Facades\Event; +beforeEach(function (): void { + $this->grant = resolve(GrantDelasTag::class); + $this->revoke = resolve(RevokeDelasTag::class); + $this->eligibility = resolve(DelasEligibility::class); +}); + +// Conceder + test('líder concede a quem não tem solicitação: cria uma já aprovada', function (): void { Event::fake([DelasTagGranted::class]); $lead = User::factory()->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); + $request = $this->grant->handle($target, $lead); + $transition = DelasTransition::query()->sole(); + expect($request->status)->toBe(DelasRequestStatus::Approved); + expect(DelasTagRequest::query()->count())->toBe(1); + expect($transition->action)->toBe(DelasAction::Granted); + expect($transition->triggered_by)->toBe(DelasTriggeredBy::Lead); Event::assertDispatched(DelasTagGranted::class); }); @@ -39,96 +47,122 @@ $lead = User::factory()->delasLead()->create(); $pending = DelasTagRequest::factory()->pending()->create(); - $request = resolve(GrantDelasTag::class)->handle($pending->user, $lead); + $request = $this->grant->handle($pending->user, $lead); - expect($request->is($pending))->toBeTrue() - ->and($pending->fresh()->status)->toBe(DelasRequestStatus::Approved) - ->and(DelasTagRequest::query()->count())->toBe(1); + expect($request->is($pending))->toBeTrue(); + expect($pending->fresh()->status)->toBe(DelasRequestStatus::Approved); + expect(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); + $this->grant->handle($rejected->user, $lead); - expect(resolve(DelasEligibility::class)->hasTag($rejected->user))->toBeTrue(); + expect($this->eligibility->hasTag($rejected->user))->toBeTrue(); }); -test('conceder a quem está bloqueada exige motivo e encerra o bloqueio', function (): void { - Event::fake([DelasTagGranted::class, DelasRequesterUnblocked::class]); +test('conceder a quem está bloqueada exige motivo', function (): void { $lead = User::factory()->delasLead()->create(); $block = DelasRequesterBlock::factory()->create(); - expect(fn () => resolve(GrantDelasTag::class)->handle($block->user, $lead)) + expect(fn () => $this->grant->handle($block->user, $lead)) ->toThrow(DelasException::class, __('delas::exceptions.reason_required')); +}); - resolve(GrantDelasTag::class)->handle($block->user, $lead, 'Esclarecido com o comitê.'); +test('conceder a quem está bloqueada, com motivo, encerra o bloqueio', function (): void { + Event::fake([DelasTagGranted::class, DelasRequesterUnblocked::class]); + $lead = User::factory()->delasLead()->create(); + $block = DelasRequesterBlock::factory()->create(); - 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]); + $this->grant->handle($block->user, $lead, 'Esclarecido com o comitê.'); + $block->refresh(); + expect($block->isActive())->toBeFalse(); + expect($block->lift_reason)->toBe('Esclarecido com o comitê.'); + expect(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 { +test('não concede a quem já tem a tag', 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)) + expect(fn () => $this->grant->handle($approved->user, $lead)) + ->toThrow(DelasException::class, __('delas::exceptions.already_has_tag')); +}); + +test('líder não concede a tag a si mesma', function (): void { + $lead = User::factory()->delasLead()->create(); + + expect(fn () => $this->grant->handle($lead, $lead)) ->toThrow(DelasException::class, __('delas::exceptions.cannot_decide_own')); }); -test('moderadora não concede nem remove a tag direto', function (): void { +test('moderadora não concede a tag direto', function (): void { + $moderator = User::factory()->delasModerator()->create(); + $target = User::factory()->create(); + + expect(fn () => $this->grant->handle($target, $moderator)) + ->toThrow(AuthorizationException::class); +}); + +// Remover + +test('moderadora não 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); + expect(fn () => $this->revoke->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]); +test('remover a tag exige motivo', function (): void { $admin = User::factory()->superAdmin()->create(); $approved = DelasTagRequest::factory()->approved()->create(); - expect(fn () => resolve(RevokeDelasTag::class)->handle($approved->user, $admin, reason: null)) + expect(fn () => $this->revoke->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.'); +test('remover a tag 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($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); + $this->revoke->handle($approved->user, $admin, 'A pessoa pediu a remoção.'); + expect($approved->fresh()->status)->toBe(DelasRequestStatus::Revoked); + expect($this->eligibility->for($approved->user)->state)->toBe(DelasEligibilityState::Cooldown); + expect(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(); + $withoutTag = User::factory()->create(); - expect(fn () => resolve(RevokeDelasTag::class)->handle(User::factory()->create(), $lead, 'motivo')) + expect(fn () => $this->revoke->handle($withoutTag, $lead, 'motivo')) ->toThrow(DelasException::class, __('delas::exceptions.has_no_tag')); }); +// Remover e bloquear + 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); + $this->revoke->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()) + expect($approved->fresh()->status)->toBe(DelasRequestStatus::Revoked); + expect($block->reason)->toBe('Conta criada só para conseguir a tag.'); + expect($block->blocked_by)->toBe($lead->getKey()); + expect($this->eligibility->for($approved->user)->state)->toBe(DelasEligibilityState::Blocked); + expect(DelasTransition::query()->pluck('action')->all()) ->toEqualCanonicalizing([DelasAction::Revoked, DelasAction::Blocked]); }); @@ -137,10 +171,11 @@ $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); + expect(fn () => $this->revoke->handle($moderatorWithTag, $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 { @@ -148,8 +183,8 @@ $approved = DelasTagRequest::factory()->approved()->create(); DelasRequesterBlock::factory()->for($approved->user)->create(); - resolve(RevokeDelasTag::class)->handle($approved->user, $lead, 'Motivo.', alsoBlock: true); + $this->revoke->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); + expect(DelasRequesterBlock::query()->where('user_id', $approved->user_id)->count())->toBe(1); + expect($approved->fresh()->status)->toBe(DelasRequestStatus::Revoked); }); diff --git a/app-modules/delas/tests/Feature/TagRequest/RequestDelasTagTest.php b/app-modules/delas/tests/Feature/TagRequest/RequestDelasTagTest.php index eb3978fc2..decf7068e 100644 --- a/app-modules/delas/tests/Feature/TagRequest/RequestDelasTagTest.php +++ b/app-modules/delas/tests/Feature/TagRequest/RequestDelasTagTest.php @@ -16,28 +16,40 @@ use He4rt\Identity\User\Models\User; use Illuminate\Support\Facades\Event; -test('registra a solicitação como pendente e grava o histórico', function (): void { +beforeEach(function (): void { + $this->requestTag = resolve(RequestDelasTag::class); + $this->eligibility = resolve(DelasEligibility::class); +}); + +// Pedir + +test('registra a solicitação como pendente e avisa', function (): void { Event::fake([DelasTagRequested::class]); $user = User::factory()->withDiscord()->create(); - $request = resolve(RequestDelasTag::class)->handle($user); + $request = $this->requestTag->handle($user); - $transition = DelasTransition::query()->sole(); + expect($request->status)->toBe(DelasRequestStatus::Pending); + expect($this->eligibility->for($user)->state)->toBe(DelasEligibilityState::Pending); + Event::assertDispatched(fn (DelasTagRequested $event): bool => $event->requestId === $request->getKey()); +}); + +test('o pedido fica no histórico como ação da própria pessoa', function (): void { + $user = User::factory()->withDiscord()->create(); - 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); + $this->requestTag->handle($user); - Event::assertDispatched(fn (DelasTagRequested $event): bool => $event->requestId === $request->getKey()); + $transition = DelasTransition::query()->sole(); + expect($transition->action)->toBe(DelasAction::Requested); + expect($transition->triggered_by)->toBe(DelasTriggeredBy::User); + expect($transition->actor_id)->toBe($user->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)) + expect(fn () => $this->requestTag->handle($user)) ->toThrow(DelasException::class, __('delas::exceptions.already_has_active_request')); })->with(['pending', 'approved']); @@ -45,20 +57,38 @@ $user = User::factory()->create(); DelasRequesterBlock::factory()->for($user)->create(); - expect(fn () => resolve(RequestDelasTag::class)->handle($user)) + expect(fn () => $this->requestTag->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 { +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($this->eligibility->for($user)->hasTag())->toBeTrue(); +}); + +// Espera depois de rejeição ou remoção + +test('recusa o pedido antes de completar 15 dias da rejeição ou remoção', function (string $state): void { $this->travelTo(today()); $user = User::factory()->withDiscord()->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); + expect(fn () => $this->requestTag->handle($user))->toThrow(DelasException::class); +})->with(['rejected', 'revoked']); + +test('aceita o pedido passados 15 dias da rejeição ou remoção', function (string $state): void { + $this->travelTo(today()); + $user = User::factory()->withDiscord()->create(); + DelasTagRequest::factory()->for($user)->{$state}()->create(['decided_at' => now()]); + + $this->travelTo(now()->addDays(15)->addMinute()); + + expect($this->requestTag->handle($user)->status)->toBe(DelasRequestStatus::Pending); })->with(['rejected', 'revoked']); test('a espera vem da config', function (): void { @@ -66,44 +96,49 @@ $user = User::factory()->withDiscord()->create(); DelasTagRequest::factory()->for($user)->rejected()->create(['decided_at' => now()->subDays(4)]); - expect(resolve(DelasEligibility::class)->for($user)->canRequest())->toBeTrue(); + expect($this->eligibility->for($user)->canRequest())->toBeTrue(); }); -test('quem tem a tag continua com ela mesmo bloqueada', function (): void { +// Discord + +test('sem o Discord conectado, a pessoa aparece como precisando conectar', 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(); + expect($this->eligibility->for($user)->state)->toBe(DelasEligibilityState::DiscordRequired); }); 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)) + expect(fn () => $this->requestTag->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); + expect($this->eligibility->for($user)->state)->toBe(DelasEligibilityState::DiscordRequired); }); test('a exigência do Discord vem da config', function (): void { config(['delas.require_discord' => false]); + $userWithoutDiscord = User::factory()->create(); - expect(resolve(DelasEligibility::class)->for(User::factory()->create())->canRequest())->toBeTrue(); + expect($this->eligibility->for($userWithoutDiscord)->canRequest())->toBeTrue(); }); -test('espera e bloqueio aparecem antes de faltar o Discord', function (): void { +test('o bloqueio aparece antes de faltar o Discord', function (): void { $blocked = User::factory()->create(); DelasRequesterBlock::factory()->for($blocked)->create(); + + expect($this->eligibility->for($blocked)->state)->toBe(DelasEligibilityState::Blocked); +}); + +test('a espera aparece antes de faltar o Discord', function (): void { $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); + expect($this->eligibility->for($waiting)->state)->toBe(DelasEligibilityState::Cooldown); }); diff --git a/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php b/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php index 36828f3ce..e2c205548 100644 --- a/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php +++ b/app-modules/delas/tests/Feature/Team/DelasCandidatesTest.php @@ -11,6 +11,18 @@ $this->lead = User::factory()->delasLead()->create(); }); +/** + * Ids que a busca do seletor de conceder devolve para a líder. + * + * @return list + */ +function delasGrantSearchIds(DelasCandidates $candidates, User $lead, string $term): array +{ + return $candidates->search($candidates->forGrant($lead), $term)->pluck('id')->all(); +} + +// Escopo de cada seletor + 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; @@ -19,8 +31,7 @@ $ids = $this->candidates->forGrant($this->lead)->pluck('id')->all(); - expect($ids)->toContain($withoutRequest->id, $pending->id, $rejected->id) - ->not->toContain($member->id); + expect($ids)->toContain($withoutRequest->id, $pending->id, $rejected->id)->not->toContain($member->id); }); test('remover: só aparece quem tem a tag', function (): void { @@ -29,7 +40,9 @@ DelasTagRequest::factory()->pending()->create(); User::factory()->create(); - expect($this->candidates->forRevoke($this->lead)->pluck('id')->all())->toBe([$member->id]); + $ids = $this->candidates->forRevoke($this->lead)->pluck('id')->all(); + + expect($ids)->toBe([$member->id]); }); test('adicionar moderadora: só quem tem a tag, fora super admin, moderadora ou líder', function (): void { @@ -39,50 +52,66 @@ $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($withoutTag->id, $superAdmin->id, $moderator->id, $otherLead->id); + expect($ids)->toContain($member->id, $streamer->id)->not->toContain($withoutTag->id, $superAdmin->id, $moderator->id, $otherLead->id); }); -test('a própria pessoa que age nunca aparece', function (): void { +test('quem age nunca aparece no próprio seletor', function (string $scope, string $actorKind): void { + // A líder tem a tag, então só não aparece em remover/adicionar por ser quem age. DelasTagRequest::factory()->for($this->lead)->approved()->create(); - $actor = User::factory()->superAdmin()->create(); + $actor = $actorKind === 'superAdmin' ? User::factory()->superAdmin()->create() : $this->lead; - 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); -}); + $people = $this->candidates->{$scope}($actor)->pluck('id'); + + expect($people)->not->toContain($actor->id); +})->with([ + 'conceder, como super admin' => ['forGrant', 'superAdmin'], + 'conceder, como líder' => ['forGrant', 'lead'], + 'remover, como líder' => ['forRevoke', 'lead'], + 'adicionar moderadora, como líder' => ['forModerator', 'lead'], +]); + +// Busca -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']); - // 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()]); +describe('busca por nome ou @username, dentro do escopo', function (): void { + beforeEach(function (): void { + $this->ana = User::factory()->create(['name' => 'Ana Souza', 'username' => 'anasouza']); + $this->bia = User::factory()->create(['name' => 'Beatriz Lima', 'username' => 'bialima']); + $member = User::factory()->create(['name' => 'Ana Membra', 'username' => 'anamembra']); + // 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(); + test('acha pelo nome, sem quem já tem a tag', function (): void { + $ids = delasGrantSearchIds($this->candidates, $this->lead, 'ana'); - expect($byName)->toBe([$ana->id]) - ->and($byUsername)->toBe([$bia->id]); + expect($ids)->toBe([$this->ana->id]); + }); + + test('acha pelo @username', function (): void { + $ids = delasGrantSearchIds($this->candidates, $this->lead, '@bialima'); + + expect($ids)->toBe([$this->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); + $results = $this->candidates->search($this->candidates->forGrant($this->lead), 'carla', limit: 2); + + expect($results)->toHaveCount(2); }); -test('a busca ignora acento e maiúscula', function (): void { +test('a busca ignora acento e maiúscula', function (string $term): 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); -}); + $ids = delasGrantSearchIds($this->candidates, $this->lead, $term); + + expect($ids)->toContain($thais->id); +})->with(['thais', 'THAÍS']); diff --git a/app-modules/delas/tests/Feature/Team/ManageDelasModeratorsTest.php b/app-modules/delas/tests/Feature/Team/ManageDelasModeratorsTest.php index a1f3bba55..055ca66da 100644 --- a/app-modules/delas/tests/Feature/Team/ManageDelasModeratorsTest.php +++ b/app-modules/delas/tests/Feature/Team/ManageDelasModeratorsTest.php @@ -12,60 +12,92 @@ use He4rt\Identity\User\Models\User; use Illuminate\Auth\Access\AuthorizationException; -test('líder adiciona e remove moderadora, e as duas ações vão para o histórico', function (): void { +beforeEach(function (): void { + $this->addModerator = resolve(AddDelasModerator::class); + $this->removeModerator = resolve(RemoveDelasModerator::class); +}); + +// Adicionar + +test('líder adiciona moderadora e a ação vai para o histórico', function (): void { $lead = User::factory()->delasLead()->create(); $target = DelasTagRequest::factory()->approved()->create(['decided_by' => $lead->getKey()])->user; - resolve(AddDelasModerator::class)->handle($target, $lead); - expect($target->fresh()->can('moderate-delas'))->toBeTrue(); + $this->addModerator->handle($target, $lead); - 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]); + expect($target->fresh()->can('moderate-delas'))->toBeTrue(); + expect(DelasTransition::query()->pluck('action')->all())->toBe([DelasAction::ModeratorAdded]); }); 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(); + expect(fn () => $this->addModerator->handle($withoutTag, $lead)) + ->toThrow(DelasException::class, __('delas::exceptions.moderator_needs_tag')); + + expect($withoutTag->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse(); +}); + +test('não adiciona quem já é moderadora', function (): void { + $lead = User::factory()->delasLead()->create(); + $moderator = User::factory()->delasModerator()->create(); + + expect(fn () => $this->addModerator->handle($moderator, $lead)) + ->toThrow(DelasException::class, __('delas::exceptions.already_moderator')); }); test('moderadora não gerencia a equipe', function (): void { $moderator = User::factory()->delasModerator()->create(); + $target = User::factory()->create(); - expect(fn () => resolve(AddDelasModerator::class)->handle(User::factory()->create(), $moderator)) + expect(fn () => $this->addModerator->handle($target, $moderator)) ->toThrow(AuthorizationException::class); }); -test('líder não mexe em líderes nem em super admins', function (string $state): void { +test('líder não transforma líder nem super admin em moderadora', 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)) + expect(fn () => $this->addModerator->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 { +// Remover + +test('líder remove moderadora e a ação vai para o histórico', function (): void { $lead = User::factory()->delasLead()->create(); + $moderator = User::factory()->delasModerator()->create(); + DelasTagRequest::factory()->for($moderator)->approved()->create(['decided_by' => $lead->getKey()]); + + $this->removeModerator->handle($moderator, $lead); + + expect($moderator->fresh()->can('moderate-delas'))->toBeFalse(); + expect(DelasTransition::query()->pluck('action')->all())->toBe([DelasAction::ModeratorRemoved]); +}); + +test('não remove quem não é moderadora', function (): void { + $lead = User::factory()->delasLead()->create(); + $member = User::factory()->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)) + expect(fn () => $this->removeModerator->handle($member, $lead)) ->toThrow(DelasException::class, __('delas::exceptions.not_moderator')); }); +test('líder não remove líder nem super admin', function (string $state): void { + $lead = User::factory()->delasLead()->create(); + $target = User::factory()->{$state}()->create(); + + expect(fn () => $this->removeModerator->handle($target, $lead)) + ->toThrow(DelasException::class, __('delas::exceptions.cannot_manage_role')); +})->with(['delasLead', 'superAdmin']); + 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); + $this->removeModerator->handle($moderator, $lead); - expect($moderator->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse() - ->and(DelasTransition::query()->where('user_id', $moderator->getKey())->exists())->toBeTrue(); + expect($moderator->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse(); + expect(DelasTransition::query()->where('user_id', $moderator->getKey())->exists())->toBeTrue(); }); diff --git a/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php b/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php index e2a9db61b..0b9630267 100644 --- a/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php +++ b/app-modules/panel-admin/tests/Feature/Authorization/AdminComponentAccessTest.php @@ -86,27 +86,44 @@ function adminComponents(): array expect($labels)->toBe(['Dashboard']); }); +/** + * Uma das páginas da área da He4rt Delas dentro da Moderação. + */ +function isDelasAdminPage(string $component): bool +{ + return str_starts_with($component, 'He4rt\\PanelAdmin\\Moderation\\Pages\\Delas\\'); +} + +/** + * Os rótulos dos itens da sidebar do admin, para quem está logada. + * + * @return list + */ +function adminSidebarLabels(): array +{ + return collect(Filament::getPanel('admin')->getNavigation()) + ->flatMap(fn (NavigationGroup $group): array => $group->getItems()) + ->map(fn (NavigationItem $item): string => $item->getLabel()) + ->values() + ->all(); +} + 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); + foreach (adminComponents() as $component) { + $isAllowed = $component === Dashboard::class + || (isDelasAdminPage($component) && $component !== DelasTeamPage::class); - expect($component::canAccess())->toBe($isAllowed, $component); - }); + 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\\'); + $isAllowed = $component === Dashboard::class || isDelasAdminPage($component); expect($component::canAccess())->toBe($isAllowed, $component); } @@ -115,33 +132,34 @@ function adminComponents(): array test('a sidebar da moderadora mostra só 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(); + $labels = adminSidebarLabels(); 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 { +test('quem só modera entra no admin direto na Moderação', function (string $state): void { actingAs(User::factory()->{$state}()->create()); $response = $this->get(Dashboard::getUrl()); - $goesToModeration - ? $response->assertRedirect(ModerationCluster::getUrl()) - : $response->assertOk(); + $response->assertRedirect(ModerationCluster::getUrl()); })->with([ - 'moderadora' => ['delasModerator', true], - 'líder' => ['delasLead', true], - 'super admin' => ['superAdmin', false], + 'moderadora' => 'delasModerator', + 'líder' => 'delasLead', ]); +test('super admin entra no admin pelo Dashboard', function (): void { + actingAs(User::factory()->superAdmin()->create()); + + $response = $this->get(Dashboard::getUrl()); + + $response->assertOk(); +}); + 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()); + + $superAdminLabels = adminSidebarLabels(); expect($superAdminLabels)->not->toContain(__('panel-admin::delas.navigation.group')); }); 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 cacd7fdcc..ee2bfcf74 100644 --- a/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php +++ b/app-modules/panel-admin/tests/Feature/Moderation/Delas/DelasModerationPagesTest.php @@ -32,7 +32,8 @@ * Com o eager load automático desligado e o lazy loading proibido, qualquer * relação que uma tela usa sem `with()` estoura `LazyLoadingViolationException`. * O Laravel só acusa quando a query trouxe mais de um model, então cada tabela - * testada aqui tem pelo menos dois registros. + * testada aqui tem pelo menos dois registros — por isso vários testes criam um + * registro "a mais" que não aparece nas asserções. */ beforeEach(function (): void { Filament::setCurrentPanel(Filament::getPanel('admin')); @@ -59,83 +60,147 @@ function mountedPersonSelect(Testable $page): Select return $select; } +/** + * Entra no painel como moderadora da He4rt Delas. + */ +function actingAsDelasModerator(): User +{ + $moderator = User::factory()->delasModerator()->create(); + test()->actingAs($moderator); + + return $moderator; +} + +/** + * Entra no painel como líder da He4rt Delas. + */ +function actingAsDelasLead(): User +{ + $lead = User::factory()->delasLead()->create(); + test()->actingAs($lead); + + return $lead; +} + +/** + * Uma linha do histórico com motivo, escrita por `$actor` (ou por alguém qualquer). + */ +function delasHistoryEntry(DelasAction $action, string $reason, ?User $actor = null): DelasTransition +{ + $attributes = ['action' => $action, 'reason' => $reason]; + + if ($actor instanceof User) { + $attributes['actor_id'] = $actor->getKey(); + } + + return DelasTransition::factory()->create($attributes); +} + +// Acesso e navegação + 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, 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()); - $pending = DelasTagRequest::factory()->pending()->count(2)->create(); - $approved = DelasTagRequest::factory()->approved()->create(); +})->with([ + DelasQueuePage::class, + DelasMembersPage::class, + DelasBlocksPage::class, + DelasHistoryPage::class, + DelasTeamPage::class, +]); - livewire(DelasQueuePage::class) - ->assertOk() - ->loadTable() - ->assertCanSeeTableRecords($pending) - ->assertCanNotSeeTableRecords([$approved]); +test('moderadora não acessa a Equipe', function (): void { + actingAsDelasModerator(); 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()); + actingAsDelasModerator(); 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(); + $response = $this->get($page::getUrl()); + + $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 { $moderator = User::factory()->delasModerator()->create(); - $moderator->removeRole(UserRole::DelasModerator); + $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()); +test('o cluster de Moderação leva a moderadora direto para a fila', function (): void { + actingAsDelasModerator(); + + $response = $this->get(ModerationCluster::getUrl()); + + $response->assertRedirect(DelasQueuePage::getUrl()); +}); - $this->get(ModerationCluster::getUrl())->assertRedirect(DelasQueuePage::getUrl()); +test('na subnavegação do cluster a moderadora só vê as páginas da He4rt Delas', function (): void { + actingAsDelasModerator(); $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.members'), - __('panel-admin::delas.navigation.blocks'), - __('panel-admin::delas.navigation.history'), - ]); + $groups = $items->map(fn (NavigationItem $item): ?string => $item->getGroup())->unique()->values()->all(); + $labels = $items->map(fn (NavigationItem $item): string => $item->getLabel())->all(); + expect($groups)->toBe([__('panel-admin::delas.navigation.group')]); + expect($labels)->toBe([ + __('panel-admin::delas.navigation.queue'), + __('panel-admin::delas.navigation.members'), + __('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(); +test('sem registros, o badge da subnavegação fica vazio', function (string $page): void { + expect($page::getNavigationBadge())->toBeNull(); +})->with([DelasQueuePage::class, DelasBlocksPage::class]); +test('o badge da fila conta só as pendentes', function (): void { DelasTagRequest::factory()->pending()->count(2)->create(); DelasTagRequest::factory()->approved()->create(); + + expect(DelasQueuePage::getNavigationBadge())->toBe('2'); +}); + +test('o badge de bloqueios conta só os ativos', function (): void { DelasRequesterBlock::factory()->create(); DelasRequesterBlock::factory()->lifted()->create(); - expect(DelasQueuePage::getNavigationBadge())->toBe('2') - ->and(DelasBlocksPage::getNavigationBadge())->toBe('1'); + expect(DelasBlocksPage::getNavigationBadge())->toBe('1'); +}); + +// Fila + +test('moderadora vê só as pendentes na fila', function (): void { + actingAsDelasModerator(); + $pending = DelasTagRequest::factory()->pending()->count(2)->create(); + $approved = DelasTagRequest::factory()->approved()->create(); + + livewire(DelasQueuePage::class) + ->assertOk() + ->loadTable() + ->assertCanSeeTableRecords($pending) + ->assertCanNotSeeTableRecords([$approved]); }); test('moderadora aprova pela fila', function (): void { - $this->actingAs(User::factory()->delasModerator()->create()); - [$request] = DelasTagRequest::factory()->pending()->count(2)->create(); + actingAsDelasModerator(); + $request = DelasTagRequest::factory()->pending()->create(); + DelasTagRequest::factory()->pending()->create(); // segunda linha, para o lazy loading ser acusado livewire(DelasQueuePage::class) ->callAction(TestAction::make('approve')->table($request)) @@ -145,8 +210,9 @@ function mountedPersonSelect(Testable $page): Select }); 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(); + actingAsDelasModerator(); + $request = DelasTagRequest::factory()->pending()->create(); + DelasTagRequest::factory()->pending()->create(); // segunda linha, para o lazy loading ser acusado livewire(DelasQueuePage::class) ->callAction(TestAction::make($action)->table($request), data: ['reason' => '']) @@ -156,20 +222,23 @@ function mountedPersonSelect(Testable $page): Select })->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(); + actingAsDelasModerator(); + $request = DelasTagRequest::factory()->pending()->create(); + DelasTagRequest::factory()->pending()->create(); // segunda linha, para o lazy loading ser acusado 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(); + $hasActiveBlock = DelasRequesterBlock::query()->active()->where('user_id', $request->user_id)->exists(); + expect($request->fresh()->status)->toBe(DelasRequestStatus::Rejected); + expect($hasActiveBlock)->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(); + actingAsDelasModerator(); + $teamMember = User::factory()->delasModerator()->create(); + $fromTeam = DelasTagRequest::factory()->for($teamMember)->pending()->create(); $fromMember = DelasTagRequest::factory()->pending()->create(); livewire(DelasQueuePage::class) @@ -185,9 +254,8 @@ function mountedPersonSelect(Testable $page): Select * 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()); + actingAsDelasModerator(); DelasTagRequest::factory()->pending()->count(3)->create(); - DB::flushQueryLog(); DB::enableQueryLog(); @@ -195,53 +263,70 @@ function mountedPersonSelect(Testable $page): Select $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(); + $moderator = actingAsDelasModerator(); + $ownRequest = DelasTagRequest::factory()->for($moderator)->pending()->create(); + DelasTagRequest::factory()->pending()->create(); // segunda linha, para o lazy loading ser acusado livewire(DelasQueuePage::class) - ->callAction(TestAction::make('approve')->table($request)) + ->callAction(TestAction::make('approve')->table($ownRequest)) ->assertNotified(__('delas::exceptions.cannot_decide_own')); - expect($request->fresh()->status)->toBe(DelasRequestStatus::Pending); + expect($ownRequest->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); +// Bloqueios + +test('moderadora vê todos os bloqueios, mas não desbloqueia o de outra', function (): void { + $moderator = actingAsDelasModerator(); $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)) + ->assertActionDisabled(TestAction::make('unblock')->table($others)); + + expect($others->fresh()->isActive())->toBeTrue(); +}); + +test('moderadora desbloqueia o próprio bloqueio', function (): void { + $moderator = actingAsDelasModerator(); + $own = DelasRequesterBlock::factory()->create(['blocked_by' => $moderator->getKey()]); + $others = DelasRequesterBlock::factory()->create(); + + livewire(DelasBlocksPage::class) + ->loadTable() ->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(); + expect($own->fresh()->isActive())->toBeFalse(); + expect($others->fresh()->isActive())->toBeTrue(); }); -test('o histórico da moderadora esconde os pedidos; o da líder mostra tudo', function (): void { +// Histórico + +test('o histórico da moderadora esconde os pedidos e não tem filtro por ação', function (): void { $requested = DelasTransition::factory()->count(2)->create(['action' => DelasAction::Requested]); $approved = DelasTransition::factory()->count(2)->create(['action' => DelasAction::Approved]); + actingAsDelasModerator(); - $this->actingAs(User::factory()->delasModerator()->create()); - $moderatorPage = livewire(DelasHistoryPage::class) + $page = livewire(DelasHistoryPage::class) ->loadTable() ->assertCanSeeTableRecords($approved) ->assertCanNotSeeTableRecords($requested); - expect($moderatorPage->instance()->getTable()->getFilter('action'))->toBeNull(); + expect($page->instance()->getTable()->getFilter('action'))->toBeNull(); +}); + +test('o histórico da líder mostra tudo e filtra por ação', function (): void { + $requested = DelasTransition::factory()->count(2)->create(['action' => DelasAction::Requested]); + $approved = DelasTransition::factory()->count(2)->create(['action' => DelasAction::Approved]); + actingAsDelasLead(); - $this->actingAs(User::factory()->delasLead()->create()); livewire(DelasHistoryPage::class) ->loadTable() ->assertCanSeeTableRecords([...$approved, ...$requested]) @@ -250,8 +335,157 @@ function mountedPersonSelect(Testable $page): Select ->assertCanNotSeeTableRecords($approved); }); +test('pelo histórico, a moderadora só pode corrigir o próprio motivo', function (): void { + $moderator = actingAsDelasModerator(); + $own = delasHistoryEntry(DelasAction::Rejected, 'Perfil incompleo.', $moderator); + $others = delasHistoryEntry(DelasAction::Rejected, 'Outro motivo.', User::factory()->delasModerator()->create()); + + livewire(DelasHistoryPage::class) + ->loadTable() + ->assertActionVisible(TestAction::make('correctReason')->table($own)) + ->assertActionHidden(TestAction::make('correctReason')->table($others)); +}); + +test('a moderadora corrige o próprio motivo pelo histórico, e a original continua lá', function (): void { + $moderator = actingAsDelasModerator(); + $own = delasHistoryEntry(DelasAction::Rejected, 'Perfil incompleo.', $moderator); + delasHistoryEntry(DelasAction::Rejected, 'Outro motivo.', User::factory()->delasModerator()->create()); + + livewire(DelasHistoryPage::class) + ->loadTable() + ->callAction(TestAction::make('correctReason')->table($own), data: ['reason' => 'Perfil incompleto.']) + ->assertNotified(__('panel-admin::delas.actions.reason_corrected')) + ->assertSee('Perfil incompleto.') + ->assertDontSee(__('panel-admin::delas.actions.view_versions')) + ->assertDontSee('Perfil incompleo.'); + + $own->refresh(); + expect($own->reason)->toBe('Perfil incompleo.'); + expect($own->currentReason())->toBe('Perfil incompleto.'); +}); + +test('o botão de corrigir avisa até quando a moderadora pode corrigir', function (): void { + $this->freezeTime(); + $moderator = actingAsDelasModerator(); + $own = delasHistoryEntry(DelasAction::Rejected, 'Motivo.', $moderator); + delasHistoryEntry(DelasAction::Rejected, 'Outro.'); + + $deadline = now() + ->addHours(config()->integer('delas.reason_correction_hours')) + ->timezone(config('app.display_timezone')) + ->format('d/m/Y H:i'); + + livewire(DelasHistoryPage::class) + ->loadTable() + ->mountAction(TestAction::make('correctReason')->table($own)) + ->assertMountedActionModalSee(__('panel-admin::delas.actions.correct_until', ['date' => $deadline])); +}); + +/* + * Os três testes abaixo partem do mesmo cenário: um bloqueio cujo motivo a + * líder corrigiu duas vezes, mais uma aprovação qualquer no histórico. + */ +describe('motivo corrigido duas vezes', function (): void { + beforeEach(function (): void { + $this->lead = User::factory()->delasLead()->create(); + $this->original = delasHistoryEntry(DelasAction::Blocked, 'Primeiro texto.', $this->lead); + + resolve(CorrectDelasReason::class)->handle($this->original, $this->lead, 'Segundo texto.'); + $this->travel(1)->minutes(); + resolve(CorrectDelasReason::class)->handle($this->original->fresh(), $this->lead, 'Terceiro texto.'); + + DelasTransition::factory()->create(['action' => DelasAction::Approved]); + }); + + test('cada edição fica guardada como uma correção da original', function (): void { + $corrections = DelasTransition::query()->where('corrects_id', $this->original->getKey())->count(); + + expect($corrections)->toBe(2); + }); + + test('a líder vê uma linha só, com o texto atual, e abre todas as versões', function (): void { + $this->actingAs($this->lead); + + livewire(DelasHistoryPage::class) + ->loadTable() + ->assertCountTableRecords(2) + ->assertSee('Terceiro texto.') + ->mountAction(TestAction::make('viewVersions')->table($this->original)) + ->assertMountedActionModalSee(['Primeiro texto.', 'Segundo texto.', 'Terceiro texto.']); + }); + + test('a moderadora vê só o texto atual e não abre as versões', function (): void { + actingAsDelasModerator(); + + livewire(DelasHistoryPage::class) + ->loadTable() + ->assertSee('Terceiro texto.') + ->assertDontSee(['Primeiro texto.', 'Segundo texto.']) + ->assertActionDisabled(TestAction::make('viewVersions')->table($this->original)); + }); +}); + +// Membras + +test('a moderadora vê quem tem a tag, mas só a líder remove', function (): void { + $member = DelasTagRequest::factory()->approved()->create(); + DelasTagRequest::factory()->approved()->create(); // segunda linha, para o lazy loading ser acusado + $pending = DelasTagRequest::factory()->pending()->create(); + actingAsDelasModerator(); + + livewire(DelasMembersPage::class) + ->loadTable() + ->assertCanSeeTableRecords([$member]) + ->assertCanNotSeeTableRecords([$pending]) + ->assertActionHidden(TestAction::make('revoke')->table($member)); +}); + +test('o badge de Membras conta só quem tem a tag', function (): void { + DelasTagRequest::factory()->approved()->count(2)->create(); + DelasTagRequest::factory()->pending()->create(); + actingAsDelasModerator(); + + expect(DelasMembersPage::getNavigationBadge())->toBe('2'); +}); + +test('a líder remove a tag pela Membras e bloqueia novos pedidos junto', function (): void { + actingAsDelasLead(); + $member = DelasTagRequest::factory()->approved()->create(); + DelasTagRequest::factory()->approved()->create(); // segunda linha, para o lazy loading ser acusado + + 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]); + + $block = DelasRequesterBlock::query()->active()->sole(); + expect($member->fresh()->status)->toBe(DelasRequestStatus::Revoked); + expect($block->user_id)->toBe($member->user_id); + expect($block->reason)->toBe('Perfil falso.'); +}); + +test('a líder remove a tag pela Membras sem bloquear', function (): void { + actingAsDelasLead(); + $member = DelasTagRequest::factory()->approved()->create(); + DelasTagRequest::factory()->approved()->create(); // segunda linha, para o lazy loading ser acusado + + livewire(DelasMembersPage::class) + ->loadTable() + ->callAction(TestAction::make('revoke')->table($member), data: ['reason' => 'Pedido da pessoa.']) + ->assertNotified(__('panel-admin::delas.actions.revoked')); + + expect($member->fresh()->status)->toBe(DelasRequestStatus::Revoked); + expect(DelasRequesterBlock::query()->active()->exists())->toBeFalse(); +}); + +// Equipe + test('líder vê a Equipe com os números', function (): void { - $this->actingAs(User::factory()->delasLead()->create()); + actingAsDelasLead(); $moderators = User::factory()->delasModerator()->count(2)->create(); livewire(DelasTeamPage::class) @@ -262,19 +496,35 @@ function mountedPersonSelect(Testable $page): Select }); test('líder concede a tag direto pela Equipe', function (): void { - $this->actingAs(User::factory()->delasLead()->create()); + actingAsDelasLead(); $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); + $request = DelasTagRequest::query()->where('user_id', $target->getKey())->sole(); + expect($request->status)->toBe(DelasRequestStatus::Approved); +}); + +test('conceder a quem está bloqueada mostra o bloqueio e exige o motivo no formulário', function (): void { + actingAsDelasLead(); + $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(); }); test('líder remove a tag com motivo', function (): void { - $this->actingAs(User::factory()->delasLead()->create()); - [$approved] = DelasTagRequest::factory()->approved()->count(2)->create(); + actingAsDelasLead(); + $approved = DelasTagRequest::factory()->approved()->create(); + DelasTagRequest::factory()->approved()->create(); // segunda membra, para o lazy loading ser acusado livewire(DelasTeamPage::class) ->callAction('revoke', data: ['user_id' => $approved->user_id, 'reason' => 'Pedido da pessoa.']) @@ -283,9 +533,9 @@ function mountedPersonSelect(Testable $page): Select 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(); +test('líder adiciona moderadora pela Equipe', function (): void { + actingAsDelasLead(); + User::factory()->delasModerator()->create(); // segunda linha na tabela, para o lazy loading ser acusado $target = DelasTagRequest::factory()->approved()->create()->user; livewire(DelasTeamPage::class) @@ -293,16 +543,23 @@ function mountedPersonSelect(Testable $page): Select ->assertNotified(__('panel-admin::delas.actions.moderator_added')); expect($target->fresh()->hasRole(UserRole::DelasModerator))->toBeTrue(); +}); + +test('líder revoga moderadora pela Equipe', function (): void { + actingAsDelasLead(); + User::factory()->delasModerator()->create(); // segunda linha na tabela, para o lazy loading ser acusado + $moderator = User::factory()->delasModerator()->create(); + DelasTagRequest::factory()->for($moderator)->approved()->create(); livewire(DelasTeamPage::class) - ->callAction(TestAction::make('removeModerator')->table($target->fresh())) + ->callAction(TestAction::make('removeModerator')->table($moderator)) ->assertNotified(__('panel-admin::delas.actions.moderator_removed')); - expect($target->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse(); + expect($moderator->fresh()->hasRole(UserRole::DelasModerator))->toBeFalse(); }); test('a revogação de líderes fica desativada na Equipe', function (): void { - $this->actingAs(User::factory()->delasLead()->create()); + actingAsDelasLead(); $otherLead = User::factory()->delasLead()->create(); livewire(DelasTeamPage::class) @@ -310,46 +567,79 @@ function mountedPersonSelect(Testable $page): Select ->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(); +// Seletores de pessoa da Equipe + +describe('seletor de conceder', function (): void { + beforeEach(function (): void { + $this->lead = User::factory()->delasLead()->create(['name' => 'Ana Líder', 'username' => 'analider']); + $this->actingAs($this->lead); + $this->ana = User::factory()->create(['name' => 'Ana Souza', 'username' => 'anasouza']); + $this->member = User::factory()->create(['name' => 'Ana Membra', 'username' => 'anamembra']); + // `decided_by` fixo: a fábrica criaria uma pessoa aleatória, que às vezes também se chama "Ana…". + DelasTagRequest::factory()->for($this->member)->approved()->create(['decided_by' => $this->lead->getKey()]); + + $this->page = livewire(DelasTeamPage::class)->mountAction('grant'); + }); - $page = livewire(DelasTeamPage::class)->mountAction('grant'); - $select = mountedPersonSelect($page); + test('a busca acha só quem não tem a tag', function (): void { + $results = mountedPersonSelect($this->page)->getSearchResults('ana'); - 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()); + expect($results)->toBe([$this->ana->getKey() => 'Ana Souza (@anasouza)']); + }); - $page->fillForm(['user_id' => $ana->getKey()]); - expect(mountedPersonSelect($page)->getOptionLabel())->toBe('Ana Souza (@anasouza)'); + test('abre vazio e pede para digitar, porque a lista é a comunidade inteira', function (): void { + $select = mountedPersonSelect($this->page); - $page->fillForm(['user_id' => $member->getKey()]); - expect(mountedPersonSelect($page)->getOptionLabel(withDefault: false))->toBeNull(); + expect($select->isPreloaded())->toBeFalse(); + expect($select->getOptions())->toBeEmpty(); + expect($select->getSearchPrompt())->toBe(__('panel-admin::delas.actions.person_search_prompt')); + }); + + test('a busca não acha quem tem a tag nem a própria líder', function (): void { + $results = array_keys(mountedPersonSelect($this->page)->getSearchResults('ana')); + + expect($results)->not->toContain($this->member->getKey())->not->toContain($this->lead->getKey()); + }); + + test('rotula quem foi escolhida', function (): void { + $this->page->fillForm(['user_id' => $this->ana->getKey()]); + + expect(mountedPersonSelect($this->page)->getOptionLabel())->toBe('Ana Souza (@anasouza)'); + }); + + test('não rotula quem já tem a tag', function (): void { + $this->page->fillForm(['user_id' => $this->member->getKey()]); + + expect(mountedPersonSelect($this->page)->getOptionLabel(withDefault: false))->toBeNull(); + }); }); -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(['name' => 'Zuleica Sem Tag']); +describe('seletor de remover', function (): void { + beforeEach(function (): void { + actingAsDelasLead(); + $this->members = DelasTagRequest::factory()->approved()->count(2)->create()->map->user; + DelasTagRequest::factory()->pending()->create(); + User::factory()->create(['name' => 'Zuleica Sem Tag']); - $select = mountedPersonSelect(livewire(DelasTeamPage::class)->mountAction('revoke')); + $this->select = mountedPersonSelect(livewire(DelasTeamPage::class)->mountAction('revoke')); + }); + + test('abre já com quem tem a tag', function (): void { + expect($this->select->isPreloaded())->toBeTrue(); + expect(array_keys($this->select->getOptions())) + ->toEqualCanonicalizing($this->members->map->getKey()->all()); + }); - expect($select->isPreloaded())->toBeTrue() - ->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('a busca acha quem tem a tag e ignora quem não tem', function (): void { + $firstMember = $this->members->first(); + + expect(array_keys($this->select->getSearchResults($firstMember->name)))->toContain($firstMember->getKey()); + expect($this->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()); + actingAsDelasLead(); DelasTagRequest::factory()->approved()->count(DelasCandidates::SEARCH_LIMIT + 3)->create(); $select = mountedPersonSelect(livewire(DelasTeamPage::class)->mountAction('revoke')); @@ -358,139 +648,43 @@ function mountedPersonSelect(Testable $page): Select }); 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); + $lead = actingAsDelasLead(); $carla = User::factory()->create(['name' => 'Carla Comum', 'username' => 'carlacomum']); User::factory()->create(['name' => 'Carla Sem Tag', 'username' => 'carlasemtag']); - $others = [ + $notEligible = [ 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) { + foreach ([$carla, ...$notEligible] as $user) { DelasTagRequest::factory()->for($user)->approved()->create(['decided_by' => $lead->getKey()]); } - $select = mountedPersonSelect(livewire(DelasTeamPage::class)->mountAction(TestAction::make('addModerator')->table())); + $page = livewire(DelasTeamPage::class)->mountAction(TestAction::make('addModerator')->table()); - expect($select->getSearchResults('carla'))->toBe([$carla->getKey() => 'Carla Comum (@carlacomum)']); + expect(mountedPersonSelect($page)->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.']); +test('o seletor de adicionar moderadora abre já com a lista, porque só tem quem tem a tag', function (): void { + $lead = actingAsDelasLead(); + $member = DelasTagRequest::factory()->approved()->create(['decided_by' => $lead->getKey()])->user; - 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.') - ->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('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() - ->assertSee('Terceiro texto.') - ->assertDontSee(['Primeiro texto.', 'Segundo texto.']) - ->assertActionDisabled(TestAction::make('viewVersions')->table($original)); - - 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 { - [$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(); + $select = mountedPersonSelect(livewire(DelasTeamPage::class)->mountAction(TestAction::make('addModerator')->table())); - 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); + expect($select->isPreloaded())->toBeTrue(); + expect($select->getOptions())->toHaveKey($member->getKey()); }); -test('o botão de corrigir avisa até quando a moderadora pode corrigir', function (): void { - $this->freezeTime(); - $moderator = User::factory()->delasModerator()->create(); - $this->actingAs($moderator); - $own = DelasTransition::factory()->create(['action' => DelasAction::Rejected, 'actor_id' => $moderator->getKey(), 'reason' => 'Motivo.']); - DelasTransition::factory()->create(['action' => DelasAction::Rejected, 'reason' => 'Outro.']); - - $deadline = now()->addHours(config()->integer('delas.reason_correction_hours'))->timezone(config('app.display_timezone'))->format('d/m/Y H:i'); - - livewire(DelasHistoryPage::class) - ->loadTable() - ->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(); -}); +// Ver perfil test('"Ver perfil" abre um resumo só leitura, sem dados pessoais', function (): void { - $this->actingAs(User::factory()->delasModerator()->create()); + actingAsDelasModerator(); $person = User::factory()->withDiscord()->create(['email' => 'pessoa@exemplo.test']); $person->profile->update(['headline' => 'Dev Back-end', 'about' => 'Gosto de PHP.', 'birthdate' => '1990-05-20']); - [$request] = [DelasTagRequest::factory()->for($person)->pending()->create(), DelasTagRequest::factory()->pending()->create()]; + + $request = DelasTagRequest::factory()->for($person)->pending()->create(); + DelasTagRequest::factory()->pending()->create(); // segunda linha, para o lazy loading ser acusado livewire(DelasQueuePage::class) ->loadTable() @@ -501,9 +695,9 @@ function mountedPersonSelect(Testable $page): Select }); test('"Ver perfil" funciona também na Equipe, onde a linha já é a pessoa', function (): void { - $this->actingAs(User::factory()->delasLead()->create()); + actingAsDelasLead(); $moderator = User::factory()->delasModerator()->create(); - User::factory()->delasModerator()->create(); + User::factory()->delasModerator()->create(); // segunda linha, para o lazy loading ser acusado livewire(DelasTeamPage::class) ->loadTable() diff --git a/app-modules/panel-app/tests/Feature/Delas/DelasProfileSectionTest.php b/app-modules/panel-app/tests/Feature/Delas/DelasProfileSectionTest.php index 925b0c688..a64c56cc4 100644 --- a/app-modules/panel-app/tests/Feature/Delas/DelasProfileSectionTest.php +++ b/app-modules/panel-app/tests/Feature/Delas/DelasProfileSectionTest.php @@ -25,14 +25,16 @@ ->assertActionVisible('request'); }); -test('a solicitação só é registrada depois da confirmação no pop-up', function (): void { +test('abrir o pop-up de solicitar ainda não registra nada', function (): void { livewire(DelasProfileSection::class) ->mountAction('request') ->assertActionMounted('request') ->assertMountedActionModalSee(__('panel-app::delas.profile.modal.tip')); expect(DelasTagRequest::query()->exists())->toBeFalse(); +}); +test('confirmar no pop-up registra a solicitação como pendente', function (): void { livewire(DelasProfileSection::class) ->callAction('request') ->assertNotified(__('panel-app::delas.profile.sent')) From f41de65d1c78b513390b3e9dfe950072a001c595 Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Thu, 8 Oct 2026 13:18:15 -0300 Subject: [PATCH 58/77] =?UTF-8?q?refactor(delas):=20consultas=20e=20migrat?= =?UTF-8?q?ion=20mais=20f=C3=A1ceis=20de=20ler?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...0_07_012012_create_delas_requester_blocks_table.php | 10 ++++++++-- .../delas/src/TagRequest/Queries/DelasEligibility.php | 9 +++++---- app-modules/delas/src/Team/Queries/DelasCandidates.php | 8 ++++++-- 3 files changed, 19 insertions(+), 8 deletions(-) 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 index 425d99ecd..c0d054a7b 100644 --- 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 @@ -19,14 +19,20 @@ public function up(): void $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->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'); + DB::statement(<<<'SQL' + CREATE UNIQUE INDEX uq_delas_requester_blocks_active_user + ON delas_requester_blocks (user_id) + WHERE lifted_at IS NULL + SQL); } public function down(): void diff --git a/app-modules/delas/src/TagRequest/Queries/DelasEligibility.php b/app-modules/delas/src/TagRequest/Queries/DelasEligibility.php index 6bb5cac18..fab36ae3c 100644 --- a/app-modules/delas/src/TagRequest/Queries/DelasEligibility.php +++ b/app-modules/delas/src/TagRequest/Queries/DelasEligibility.php @@ -30,10 +30,11 @@ public function for(User $user): DelasEligibilityResult ->first(); if ($active instanceof DelasTagRequest) { - return new DelasEligibilityResult( - state: $active->status === DelasRequestStatus::Approved ? DelasEligibilityState::Member : DelasEligibilityState::Pending, - request: $active, - ); + $state = $active->status === DelasRequestStatus::Approved + ? DelasEligibilityState::Member + : DelasEligibilityState::Pending; + + return new DelasEligibilityResult(state: $state, request: $active); } if ($this->isBlocked($user)) { diff --git a/app-modules/delas/src/Team/Queries/DelasCandidates.php b/app-modules/delas/src/Team/Queries/DelasCandidates.php index 0082de918..12ae06725 100644 --- a/app-modules/delas/src/Team/Queries/DelasCandidates.php +++ b/app-modules/delas/src/Team/Queries/DelasCandidates.php @@ -58,11 +58,15 @@ public function forRevoke(User $actor): Builder */ public function forModerator(User $actor): Builder { - return $this->others($actor)->whereIn('id', $this->members())->whereDoesntHave('roles', fn (Builder $roles): Builder => $roles->whereIn('name', [ + $teamAndAdmins = [ UserRole::SuperAdmin->value, UserRole::DelasModerator->value, UserRole::DelasLead->value, - ])); + ]; + + return $this->others($actor) + ->whereIn('id', $this->members()) + ->whereDoesntHave('roles', fn (Builder $roles): Builder => $roles->whereIn('name', $teamAndAdmins)); } /** From 8d6f10a780b0bd3bd761aa1cd7bf3a4759cc4652 Mon Sep 17 00:00:00 2001 From: Danielle Costa Date: Thu, 8 Oct 2026 13:18:31 -0300 Subject: [PATCH 59/77] =?UTF-8?q?refactor(panel-admin):=20views=20da=20He4?= =?UTF-8?q?rt=20Delas=20com=20a=20l=C3=B3gica=20no=20topo=20e=20componente?= =?UTF-8?q?=20de=20linha=20do=20perfil?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../components/delas/profile-row.blade.php | 11 ++ .../views/moderation/delas/heading.blade.php | 6 +- .../moderation/delas/person-profile.blade.php | 114 ++++++++---------- .../delas/reason-versions.blade.php | 41 +++++-- .../views/components/delas/callout.blade.php | 40 ++++-- 5 files changed, 122 insertions(+), 90 deletions(-) create mode 100644 app-modules/panel-admin/resources/views/components/delas/profile-row.blade.php diff --git a/app-modules/panel-admin/resources/views/components/delas/profile-row.blade.php b/app-modules/panel-admin/resources/views/components/delas/profile-row.blade.php new file mode 100644 index 000000000..3cee8b1a1 --- /dev/null +++ b/app-modules/panel-admin/resources/views/components/delas/profile-row.blade.php @@ -0,0 +1,11 @@ +@props(['icon', 'label', 'iconClass' => 'text-gray-400']) + +{{-- Uma linha do "Ver perfil": ícone, rótulo pequeno e o valor embaixo. --}} +
    + + +
    +
    {{ $label }}
    +
    {{ $slot }}
    +
    +
    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 index d86b879be..6717309bd 100644 --- a/app-modules/panel-admin/resources/views/moderation/delas/heading.blade.php +++ b/app-modules/panel-admin/resources/views/moderation/delas/heading.blade.php @@ -1,6 +1,10 @@ +{{-- Cabeçalho das páginas da He4rt Delas: a logo e o nome da página. --}} - + + {{ $label }} 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 index a78bc1da2..5bbf7e65f 100644 --- 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 @@ -1,34 +1,32 @@ +{{-- + "Ver perfil": resumo só leitura para a moderação decidir. Fica de fora o que + não ajuda a decidir: e-mail, data de nascimento e localização. + + @var \He4rt\Identity\User\Models\User $person + @var \He4rt\Delas\TagRequest\ValueObjects\DelasEligibilityResult $eligibility + @var \He4rt\Identity\ExternalIdentity\Models\ExternalIdentity|null $discord +--}} @php - use He4rt\Identity\ExternalIdentity\Enums\IdentityProvider; + use He4rt\Delas\TagRequest\Enums\DelasEligibilityState; - /** - * @var \He4rt\Identity\User\Models\User $person - * @var \He4rt\Delas\TagRequest\ValueObjects\DelasEligibilityResult $eligibility - */ $profile = $person->profile; - $discord = $person->providers - ->where('provider', IdentityProvider::Discord) - ->filter->isConnected() - ->sortByDesc('connected_at') - ->first(); - $discordName = $discord?->metadata['username'] ?? $discord?->external_account_id; + $state = $eligibility->state; + $avatarUrl = $person->getFilamentAvatarUrl(); + $initials = collect(explode(' ', $person->name)) ->filter() ->take(2) ->map(fn (string $part): string => mb_strtoupper(mb_substr($part, 0, 1))) ->implode(''); - $avatarUrl = $person->getFilamentAvatarUrl(); - $seniority = collect([ - $profile?->seniority_level?->getLabel(), - $profile?->years_experience !== null - ? trans_choice('panel-admin::delas.profile.years', $profile->years_experience, ['years' => $profile->years_experience]) - : null, - ])->filter()->implode(' · '); - $hasProfile = $profile?->headline || $seniority !== '' || $profile?->about; - $state = $eligibility->state; + + $experience = $profile?->years_experience !== null + ? trans_choice('panel-admin::delas.profile.years', $profile->years_experience, ['years' => $profile->years_experience]) + : null; + $seniority = collect([$profile?->seniority_level?->getLabel(), $experience])->filter()->implode(' · '); + + $hasProfessionalInfo = $profile?->headline || $seniority !== '' || $profile?->about; @endphp -{{-- Resumo só leitura para a moderação decidir: sem e-mail, data de nascimento nem localização. --}}
    {{-- Cartão: faixa do Hub, foto (ou iniciais), nome e a situação na He4rt Delas. --}}
    @@ -39,6 +37,8 @@ class="relative -mt-8 flex size-16 items-center justify-center overflow-hidden rounded-full bg-purple-100 text-lg font-semibold text-purple-700 ring-4 ring-white dark:bg-purple-500/20 dark:text-purple-200 dark:ring-gray-900" > {{ $initials }} + + {{-- Se a foto não carregar (link antigo do Discord, por exemplo), ficam as iniciais. --}} @if ($avatarUrl) @endif @@ -54,7 +54,7 @@ class="relative -mt-8 flex size-16 items-center justify-center overflow-hidden r {{ $state->getLabel() }} - @if ($state === \He4rt\Delas\TagRequest\Enums\DelasEligibilityState::Member) + @if ($state === DelasEligibilityState::Member) @endif
    @@ -62,26 +62,18 @@ class="relative -mt-8 flex size-16 items-center justify-center overflow-hidden r
    {{-- Perfil profissional --}} - @if ($hasProfile) + @if ($hasProfessionalInfo)
    @if ($profile?->headline) -
    - -
    -
    {{ __('panel-admin::delas.profile.headline') }}
    -
    {{ $profile->headline }}
    -
    -
    + + {{ $profile->headline }} + @endif @if ($seniority !== '') -
    - -
    -
    {{ __('panel-admin::delas.profile.seniority') }}
    -
    {{ $seniority }}
    -
    -
    + + {{ $seniority }} + @endif @if ($profile?->about) @@ -100,37 +92,25 @@ class="relative -mt-8 flex size-16 items-center justify-center overflow-hidden r {{-- Comunidade --}}
    -
    - -
    -
    {{ __('panel-admin::delas.profile.discord') }}
    -
    - @if ($discord && $discord->external_account_id) - - {{ $discordName }} - - - @else - {{ __('panel-admin::delas.profile.discord_none') }} - @endif -
    -
    -
    + + @if ($discord?->external_account_id) + + {{ $discord->metadata['username'] ?? $discord->external_account_id }} + + + @else + {{ __('panel-admin::delas.profile.discord_none') }} + @endif + -
    - -
    -
    {{ __('panel-admin::delas.profile.since') }}
    -
    - {{ $person->created_at?->timezone(config('app.display_timezone'))->format('d/m/Y') }} -
    -
    -
    + + {{ $person->created_at?->timezone(config('app.display_timezone'))->format('d/m/Y') }} +

    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. +--}}

      @foreach ($versions as $version) + @php + $isOriginal = $loop->first; + $isCurrent = $loop->last; + $label = $isOriginal + ? __('panel-admin::delas.actions.version_original') + : __('panel-admin::delas.actions.version_edit', ['number' => $loop->index]); + $writtenAt = $version->created_at?->timezone(config('app.display_timezone'))->format('d/m/Y H:i'); + @endphp +
    1. - $loop->first && ! $loop->last, - 'bg-info-500' => ! $loop->first && ! $loop->last, - 'bg-success-500' => $loop->last, - ])> + $isCurrent, + 'bg-gray-400' => $isOriginal && ! $isCurrent, + 'bg-info-500' => ! $isOriginal && ! $isCurrent, + ]) + >
      - - {{ $loop->first ? __('panel-admin::delas.actions.version_original') : __('panel-admin::delas.actions.version_edit', ['number' => $loop->index]) }} - + {{ $label }} - @if ($loop->last) + @if ($isCurrent) {{ __('panel-admin::delas.actions.version_current') }} @endif - {{ $version->actor->name ?? '—' }} · {{ $version->created_at?->timezone(config('app.display_timezone'))->format('d/m/Y H:i') }} + {{ $version->actor->name ?? '—' }} · {{ $writtenAt }}

      - {{ __('panel-admin::delas.actions.message_label') }} {{ $version->reason }} + + {{ __('panel-admin::delas.actions.message_label') }} + + {{ $version->reason }}

    2. @endforeach 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 index e890f9936..4f36f6874 100644 --- a/app-modules/panel-app/resources/views/components/delas/callout.blade.php +++ b/app-modules/panel-app/resources/views/components/delas/callout.blade.php @@ -1,23 +1,45 @@ @props(['tone' => 'gray', 'icon' => 'heroicon-o-information-circle']) +{{-- Aviso da seção He4rt Delas do perfil: um ícone, um título opcional e o texto. --}} @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'], + $colors = match ($tone) { + 'warning' => [ + 'box' => 'border-amber-300/60 bg-amber-50 dark:border-amber-400/20 dark:bg-amber-400/5', + 'icon' => 'text-amber-600 dark:text-amber-400', + 'title' => 'text-amber-900 dark:text-amber-200', + 'body' => 'text-amber-800 dark:text-amber-200/80', + ], + 'success' => [ + 'box' => 'border-green-300/60 bg-green-50 dark:border-green-400/20 dark:bg-green-400/5', + 'icon' => 'text-green-600 dark:text-green-400', + 'title' => 'text-green-900 dark:text-green-200', + 'body' => 'text-green-800 dark:text-green-200/80', + ], + 'info' => [ + 'box' => 'border-sky-300/60 bg-sky-50 dark:border-sky-400/20 dark:bg-sky-400/5', + 'icon' => 'text-sky-600 dark:text-sky-400', + 'title' => 'text-sky-900 dark:text-sky-200', + 'body' => 'text-sky-800 dark:text-sky-200/80', + ], + default => [ + 'box' => 'border-gray-200 bg-gray-50 dark:border-white/10 dark:bg-white/5', + 'icon' => 'text-gray-500 dark:text-gray-400', + 'title' => 'text-gray-900 dark:text-gray-100', + 'body' => 'text-gray-600 dark:text-gray-400', + ], }; @endphp -
      class(['flex items-start gap-3 rounded-lg border p-4', $classes[0]]) }}> - +
      class(['flex items-start gap-3 rounded-lg border p-4', $colors['box']]) }}> + +
      @isset($title) -

      {{ $title }}

      +

      {{ $title }}

      @endisset @if (trim($slot) !== '') -
      {{ $slot }}
      +
      {{ $slot }}
      @endif
      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