Repository navigation
Conversation
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.
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 he4rt#570. A tabela de Usuários só exibe as roles. Registra a paleta e as logos da He4rt Delas.
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.
- 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.
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.
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.
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).
- 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.
- 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.
- 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.
4e4f861 to
4067cf8
Compare
danielhe4rt
left a comment
There was a problem hiding this comment.
Fala @damacosta! Li o PR inteiro (spec, ADR, domínio, telas e testes) e já começo pelo mais importante: as regras tão certas e funcionam. Espera de 15 dias, bloqueio com motivo, autodecisão travada, concessão direta pela liderança... tudo fecha com o que a gente quer.
E o domínio ficou muito bem amarrado: action checando gate, transação com lock, histórico append-only e evento ShouldDispatchAfterCommit deixando o gancho do Discord pronto. Bacana demais.
O que falta é onde isso mora, mais uns bugs de formulário. Bora lá.
1. Moderação mora no /admin
Se liga: a aba He4rt Delas é moderação. E moderação na He4rt fica no admin, junto do cluster de Moderação que já existe. No /app sobra só o lado de quem pede:
/app (Hub) /admin
┌───────────────────────────────┐ ┌──────────────────────────────────────┐
│ Perfil │ │ Moderação (cluster, /admin/mod) │
│ - pedir a tag (pop-up) │ │ └─ He4rt Delas │
│ - pendente / espera / bloq. │ pedido │ ├─ Fila moderate-delas │
│ - "você faz parte" + tag │ ───────► │ ├─ Bloqueios moderate-delas │
│ │ │ ├─ Histórico moderate-delas │
│ Card do perfil com a tag │ ◄─────── │ └─ Equipe lead-delas │
│ │ decisão │ (+ números, conceder, remover) │
└───────────────────────────────┘ └──────────────────────────────────────┘
Mas Daniel, a ADR-0002 do identity diz que "o painel inteiro é super admin ou nada"!
Diz. E quem escreveu essa linha fui eu kkkk. Ela era da fase 1, quando o único papel era super admin. Você seguiu a ADR direitinho, então essa volta é por minha conta. Por isso ela entra como ADR nova no identity (comentei na linha da ADR do delas).
2. Quem entra no /admin
A regra nova:
- super admin: tudo, como hoje.
- qualquer papel que modera alguma coisa (
delas-moderator,delas-leade os que vierem): entra no/admine só vê a área que modera. - resto: fora.
Por enquanto, só a He4rt Delas abre pra quem não é super admin. Todo o resto do admin continua só pra super admin.
canAccessPanel('admin')
│
├─ super admin ─────────────────────► entra e vê tudo
├─ papel com grantsAdminAccess() ───► entra
│ └─ cada Resource/Page decide no canAccess()
│ ├─ SuperAdminOnly ───────► 403 e some da sidebar
│ ├─ gate moderate-delas ──► Fila, Bloqueios, Histórico
│ └─ gate lead-delas ──────► Equipe, números, conceder/remover
└─ resto ───────────────────────────► 403 (em produção)
No UserRole, cada papel diz se entra no admin. O match sem 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,
};
}
/** @return list<self> */
public static function withAdminAccess(): array
{
return array_values(array_filter(self::cases(), fn (self $role): bool => $role->grantsAdminAccess()));
}E no User::canAccessPanel():
// antes
'admin' => app()->isProduction() ? $this->isSuperAdmin() : true,
// depois
'admin' => app()->isProduction() ? $this->hasAnyRole(UserRole::withAdminAccess()) : true,Fora de produção a porta do /admin continua aberta, como hoje. MAS os canAccess() da próxima seção valem em TODO ambiente. Local, pra ver o resto do admin, é php artisan identity:grant-super-admin {username}. O ->visible() que você pôs na seção Papéis do UserForm continua fazendo sentido justamente por causa dessa porta aberta.
3. As duas armadilhas do admin
Abrir a porta é fácil. O b.o é o que tem do lado de dentro.
Armadilha 1: nada no admin tem canAccess(). São 21 resources mais as páginas e os clusters, nenhum com policy ou canAccess(). No Filament, resource sem policy e page sem canAccess() liberam pra qualquer pessoa que entrou no painel. Se uma moderadora entrar hoje, ela abre /admin/users de boa.
Um trait resolve:
namespace He4rt\PanelAdmin\Concerns;
trait SuperAdminOnly
{
public static function canAccess(): bool
{
return auth()->user()?->isSuperAdmin() ?? false;
}
}Ele vai em todo Resource, Page e Cluster que já existe no panel-admin, inclusive nas páginas e resources de moderação que já estão lá (casos, apelações, regras, auditoria). O ModerationCluster em si fica sem o trait, porque agora ele é dividido. O Dashboard pode continuar acessível como página de entrada, mas os widgets dele ganham canView() só pra super admin.
Armadilha 2: a sidebar não respeita canAccess(). O PanelAdminServiceProvider::buildNavigation() monta a navegação na mão chamando getNavigationItems(). Esse método NÃO checa canAccess(). Quem checa é o registerNavigationItems(), que a gente não usa. Resultado: mesmo com o trait, o item aparece na sidebar e dá 403 no clique.
// antes
...UserResource::getNavigationItems(),
// depois
...$this->itemsFor(UserResource::class),private function itemsFor(string $component): array
{
$isAccessible = is_subclass_of($component, Cluster::class)
? $component::canAccessClusteredComponents()
: $component::canAccess();
return $isAccessible ? $component::getNavigationItems() : [];
}Dentro do /admin/mod não precisa disso: a subnavegação do cluster (getCachedSubNavigation()) já filtra por canAccess() sozinha.
Pra ninguém esquecer o trait no próximo resource, um teste de varredura:
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\\');
expect($component::canAccess())->toBe($isAllowed, $component);
});
});O namespace é sugestão, ajusta pro que você criar. A ideia: tudo que não é Delas (nem o Dashboard) tem que dar false, e resource novo sem o trait quebra esse teste na hora.
4. Formulários, selects e lazy loading
Alguns selects não tão funcionando, e tem coisa pra validar nos formulários. Deixei os detalhes nas linhas, mas o resumo:
- O seletor de pessoa (conceder, remover, adicionar moderadora) não passa por teste nenhum: os testes mandam o
user_iddireto. Precisa validar no navegador e cobrir a busca. - Tem relação sendo carregada sob demanda nas actions da fila (
rolesde cada pessoa). Hoje quem segura é oautomaticallyEagerLoadRelationships()global. Deixa o eager load explícito e coloca a verificação de lazy loading nos testes das telas (snippet no comentário da linha).
5. O que fica no /app
DelasProfileSection+ pop-up do pedido.- A tag no card do perfil (
hasDelasTag). - As strings de perfil em
panel-app/lang/*/delas.php. As de moderação vão propanel-admin.
A logo e a tag passam a ser usadas pelos dois painéis. Em vez do admin depender de view do panel-app, leva os componentes de marca (logo, tag e o SVG) pro módulo he4rt, que é o nosso design system. E a paleta --color-delas-* precisa estar também no resources/css/filament/admin/theme.css.
Checklist pra fechar
- ADR-0003 no
identity: acesso ao/adminpor papel de moderação (substitui o "super admin ou nada" da 0002) - Atualizar a ADR-0001 do
delas, a spec e a descrição do PR -
UserRole::grantsAdminAccess()+User::canAccessPanel() -
SuperAdminOnlyem todo Resource, Page e Cluster que já existe nopanel-admin, ecanView()nos widgets do Dashboard -
itemsFor()nobuildNavigation() - Moderação da He4rt Delas dentro do
ModerationCluster, uma página por aba, cada uma com seu gate - Tirar a
DelasModerationPagedoAppPanelProvider - Mover o
DelasModerationPageTestpropanel-admin+ teste de varredura - Selects validados no navegador e com a busca coberta em teste
- Eager load explícito + verificação de lazy loading nos testes das telas
-
make checkemake test(tão desmarcados no plano de testes)
Tá muito perto, sério. O domínio quase não muda: as actions já checam o gate, então é a tela trocando de casa e o admin aprendendo a receber quem não é super admin. Qualquer dúvida me chama no Discord.
Da comunidade para a comunidade.
| - **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"). |
There was a problem hiding this comment.
Essa é a decisão que vira. Você seguiu a ADR-0002 do identity certinho ("o painel inteiro é super admin ou nada"), mas aquela regra era da fase 1, quando só existia super admin. Quem tá mudando agora sou eu.
Então:
- atualiza essa seção: moderação no
/admin, dentro do cluster de Moderação, e o/appfica só com o pedido e a tag; - a alternativa "abrir o
/adminpara moderadoras" deixa de ser descartada e vira a decisão; - escreve a ADR-0003 do
identity(acesso ao/adminpor papel de moderação), dizendo que ela substitui o "super admin ou nada" da 0002.
A spec em docs/specs/ acompanha.
There was a problem hiding this comment.
Feito. A seção agora diz moderação no /admin, no cluster de Moderação, e o /app ficou só com o pedido e a tag. A alternativa "abrir o /admin para moderadoras" virou a decisão, e a ADR-0003 do identity substitui o "super admin ou nada" da 0002. A spec acompanha.
| * admins veem também os números, o histórico completo, a equipe e as ações | ||
| * de conceder e remover a tag. | ||
| */ | ||
| class DelasModerationPage extends Page implements HasTable |
There was a problem hiding this comment.
Essa página muda de casa: sai do panel-app e vai pro panel-admin, dentro do ModerationCluster (/admin/mod).
Já que vai mudar, aproveita e quebra as abas em páginas do cluster:
ModerationCluster (/admin/mod)
└── He4rt Delas (grupo na subnavegação)
├── Fila canAccess: moderate-delas badge: pendentes
├── Bloqueios canAccess: moderate-delas badge: bloqueios ativos
├── Histórico canAccess: moderate-delas (completo + filtro só pra lead)
└── Equipe canAccess: lead-delas (+ números, conceder, remover)
O que a gente ganha:
- some o
#[Url] $tab+updatedTab()+resetTable()+matchnotable(). Cada página tem UMA tabela; - a subnavegação do cluster já filtra por
canAccess(), então a moderadora nem vê a Equipe, semif ($this->isLead())espalhado; - o
tabs(), que roda 3 ou 4count()a cada render da página, vira ogetNavigationBadge()de cada página.
As actions do domínio não mudam, elas já checam o gate. É só a tela trocando de lugar.
There was a problem hiding this comment.
Feito. A página saiu do panel-app e virou 5 páginas no ModerationCluster (/admin/mod/delas/...): Fila, Membras, Bloqueios, Histórico e Equipe, cada uma com o próprio canAccess() e badge. Sumiram o #[Url] $tab, o updatedTab() e o match no table(): cada página tem uma tabela. As ações viraram classes em panel-admin/src/Moderation/Actions/Delas, no mesmo padrão do HideInteractionAction.
| ->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')) |
There was a problem hiding this comment.
Lazy loading escondido aqui. O canBlock() chama $target->can('moderate-delas'), que passa pelo Gate::before (isSuperAdmin()) e pelo hasAnyRole(). Os dois leem $target->roles, e a query da tabela só carrega user (linha 215). E o canBlock() roda duas vezes por linha (disabled + tooltip).
Hoje quem segura é o automaticallyEagerLoadRelationships() do AppServiceProvider. Funciona, mas é mágica global: a tela não diz o que precisa, e no dia que isso mudar vira N+1 silencioso numa tela de moderação. Deixa explícito:
// antes
->query(DelasTagRequest::query()->pending()->with('user'))
// depois
->query(DelasTagRequest::query()->pending()->with('user.roles'))E pra verificar de verdade, nos testes dessas telas (já no panel-admin):
beforeEach(function (): void {
Model::automaticallyEagerLoadRelationships(false);
Model::preventLazyLoading();
});
afterEach(fn () => Model::preventLazyLoading(false));Com o autoload desligado só no teste, qualquer relação que a tela usa sem with() estoura LazyLoadingViolationException na hora. Só um detalhe: o Laravel só acusa quando a query trouxe mais de um model, então o teste precisa de pelo menos 2 registros na tabela.
Passa o mesmo pente nas tabelas de bloqueios (user, blocker) e histórico (user, actor).
There was a problem hiding this comment.
Feito. A fila carrega with('user.roles'), e as outras tabelas declaram o eager load (user e blocker nos bloqueios, user, actor e corrections.actor no histórico, user e decider em Membras, roles na equipe). Os testes das telas desligam o automaticallyEagerLoadRelationships() e ligam o preventLazyLoading(), com pelo menos dois registros por tabela.
Um detalhe: o Spatie carrega os papéis com loadMissing('roles'), que o preventLazyLoading() não acusa. Por isso tem também um teste que conta as queries de model_has_roles na fila: elas não crescem com o número de linhas.
| 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); |
There was a problem hiding this comment.
Esse é o select que eu mais desconfio quando falo que alguns selects não funcionam. O que validar no navegador:
- Ele é
searchable()só comgetSearchResultsUsing(), semoptions()nempreload(). Abre vazio e só mostra gente depois de digitar. No Remover tag a lista é só de quem tem a tag, então ali dá pra usaroptions()+preload(), e a pessoa só escolhe. Conceder e Adicionar moderadora continuam com busca, porque a lista é a comunidade inteira. - Os testes nunca passam por aqui. O
DelasModerationPageTestmandadata: ['user_id' => ...]direto, então nem ogetSearchResultsUsing()nem ogetOptionLabelUsing()rodam na suíte. Pode quebrar e a suíte continua verde.
Sugestão: tira essas três consultas (conceder, remover, adicionar moderadora) da página e leva pra uma query no domínio, tipo He4rt\Delas\Team\Queries\DelasCandidates, com teste de cada escopo: quem já tem a tag não aparece no conceder, super admin e equipe não aparecem no adicionar, a própria pessoa nunca aparece. A página no admin só chama a query, e a mudança de painel fica mais leve.
There was a problem hiding this comment.
Feito. As três consultas (conceder, remover e adicionar moderadora) foram para He4rt\Delas\Team\Queries\DelasCandidates, com um teste por escopo: quem já tem a tag não aparece no conceder, super admin e equipe não aparecem no adicionar, e quem age nunca aparece. Os testes agora passam pelo getSearchResultsUsing() e pelo getOptionLabelUsing() de verdade, e validei os três no navegador.
Sobre o "Conceder só por busca": o projeto pré-carrega todo Select por padrão (FilamentServiceProvider::configureSelect()), então mantive o padrão: os três abrem com as primeiras 20 pessoas do escopo e buscam o resto (sem diferenciar acento). Se fizer sentido mudar o padrão, prefiro levar para o time do que contornar só aqui. Com a regra nova de que moderadora precisa ter a tag, "Adicionar moderadora" também ficou com uma lista pequena, como a de remover.
| EventPage::class, | ||
| ThreadPage::class, | ||
| ProfilePage::class, | ||
| DelasModerationPage::class, |
There was a problem hiding this comment.
Essa linha sai. No /app fica só o pedido no perfil e a tag no card. A página vai pro panel-admin (detalhes no comentário geral).
There was a problem hiding this comment.
Feito. A linha saiu: no /app ficaram só o pedido no perfil (DelasProfileSection) e a tag no card. A moderação inteira está no panel-admin.
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.
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).
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.
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()).
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
|
Valeu demais pela revisão, @danielhe4rt! Ficou bem mais claro onde cada coisa mora. Respondi cada comentário na própria conversa. O resumo do checklist:
Dois pontos em que fui um pouco diferente do que você sugeriu, e por quê:
Também segui o padrão do admin para as ações: cada uma virou uma classe em Testando no navegador, entraram algumas coisas a mais (estão na descrição, em "Regras além das issues"):
Para testar na mão, o Se alguma dessas fugir do escopo, separo em outro PR. |
sirelves
left a comment
There was a problem hiding this comment.
Deixei um ponto na RevokeDelasTag: tirar a tag de uma moderadora não tira ela da moderação.
| $approved->update([ | ||
| 'status' => DelasRequestStatus::Revoked, | ||
| 'decided_by' => $actor->getKey(), | ||
| 'decided_at' => now(), | ||
| 'decision_reason' => $reason, | ||
| ]); |
There was a problem hiding this comment.
Aqui tem um furo na regra que a AddDelasModerator garante. Lá você exige a tag pra alguém virar moderadora (moderatorNeedsTag), o que faz todo sentido: quem modera a He4rt Delas faz parte dela. Só que o caminho de volta não fecha. Quando a líder remove a tag de uma moderadora, o pedido vira revoked, mas o papel delas-moderator continua lá.
Na prática:
- a página Membras lista todo mundo com a tag, inclusive as moderadoras, e o "Remover tag" aparece na linha delas;
- depois de remover, a pessoa continua passando no gate
moderate-delas. Ela ainda aprova, rejeita e bloqueia na Fila, e aparece na Equipe sem ter a tag; - o histórico registra só o
Revoked, sem nenhumModeratorRemoved. Quem olhar depois não sabe que ela continuou moderando.
Então:
- dentro da mesma transação, depois do
update, tira o papel e registra no histórico, do mesmo jeito que aRemoveDelasModeratorjá faz:
$approved->update([...]);
// Sem a tag a pessoa deixa de fazer parte da He4rt Delas, então sai da moderação junto.
if ($target->hasRole(UserRole::DelasModerator)) {
$target->removeRole(UserRole::DelasModerator);
$this->recordTransition->handle(
action: DelasAction::ModeratorRemoved,
subject: $target,
actor: $actor,
);
}- adiciona um teste em
GrantAndRevokeDelasTagTest: remover a tag de uma moderadora faz ela perder odelas-moderator, passar a falhar nomoderate-delase ganhar umModeratorRemovedno histórico.
Se a ideia for o contrário (não deixar tirar a tag de quem ainda está na equipe sem antes remover da moderação), também resolve. Mas aí a regra precisa morar na action, com uma DelasException, e não só na tela, pra valer em qualquer caminho.
There was a problem hiding this comment.
Valeu, @sirelves! Fui pelo caminho do contrário: 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. Assim ninguém modera sem a tag, que é o espelho do moderatorNeedsTag.
A regra mora na action, com DelasException::teamMemberKeepsTag(), então vale em qualquer caminho. E "equipe" ficou com a mesma definição do BlockDelasRequester: quem passa no moderate-delas. Com isso, o super admin também entra na regra.
baeb3d2fec79eb1f1: a regra naRevokeDelasTag- testes: remover a tag de moderadora, líder ou super admin é recusado; depois de sair da moderação, a pessoa pode perder a tag; e a moderadora revogada perde o acesso ao admin na hora (
4f971021) - spec e ADR-0001 atualizadas
sirelves
left a comment
There was a problem hiding this comment.
Mais um ponto, agora na tela: o "Também bloquear" do Remover tag aparece pra quem é da equipe, onde ele nunca funciona.
| Toggle::make('also_block') | ||
| ->label(__('panel-admin::delas.actions.also_block')) | ||
| ->helperText(__('panel-admin::delas.actions.also_block_hint')) | ||
| ->default(state: false), |
There was a problem hiding this comment.
Testei esse toggle na Membras com uma moderadora: remover marcando "Também bloquear" nunca funciona pra quem é da equipe. A BlockDelasRequester recusa com cannotBlockTeam, a transação desfaz a remoção junto, e a líder vê "Não é possível bloquear moderadoras, líderes, admins ou a si mesma." depois de já ter preenchido o motivo.
O domínio está certo: você deixou isso explícito na docblock ("ou as duas coisas acontecem, ou nenhuma") e no teste se não der para bloquear, a tag também não é removida. O que falta é a tela não oferecer uma opção que já sabemos que vai falhar.
Então:
- na linha da Membras, a pessoa já é conhecida. Desabilita o toggle quando ela passa em
moderate-delase explica o motivo nohelperText, no mesmo padrão que você usou no Desbloquear (botão desabilitado com a dica); - no "Remover tag" do topo da Equipe, a pessoa vem do select, então o toggle precisa reagir à escolha (
live()no select).
Um ponto que conversa com o meu outro comentário, na RevokeDelasTag: se a moderadora perder o papel na remoção e isso acontecer antes do bloqueio, o cannotBlockTeam pode deixar de disparar pra ela, e aí o teste acima muda de sentido. Vale decidir a ordem de propósito (tirar da equipe e bloquear, ou recusar o bloqueio) e deixar um teste pra cada caso.
There was a problem hiding this comment.
Com a escolha do outro comentário, quem é da equipe nunca chega ao bloqueio: a RevokeDelasTag recusa antes de abrir a transação. Então o "Também bloquear" deixou de aparecer para quem falharia:
- em Membras, o "Remover tag" fica desabilitado na linha de quem é da equipe, com a dica de tirar a pessoa da equipe antes (o mesmo padrão do Desbloquear);
- no topo da Equipe, o seletor (
DelasCandidates::forRevoke) não lista quem é da equipe.
Sobre a ordem, escolhi recusar. O teste "se não der para bloquear, a tag também não é removida" saiu, porque o caso ficou impossível de alcançar. Quem cobre agora é "não remove a tag de quem é da equipe", com moderadora, líder e super admin.
Commits: d211d05c e cf0665a4.
A equipe passa a ser quem passa no gate moderate-delas (moderadora, líder ou super admin), a mesma definição do BlockDelasRequester.
…uipe 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.
"0 h" dava a impressão de que nenhuma decisão tinha sido tomada.
|
@danielhe4rt achei um furo: pelo cadastro de usuários ( Já corrigi ( |
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.
…astro de usuários 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.
Contexto
A He4rt Delas existe no Discord como cargo (
/cargo-delas), mas não no Hub. As issues #570 e #571 pedem que uma pessoa solicite a tag He4rt Delas no perfil e que líderes e moderadoras da He4rt Delas decidam os pedidos, com registro de quem decidiu e quando.Este PR entrega as duas issues juntas: elas compartilham o mesmo modelo de dados e a mesma permissão. O design está na spec
docs/specs/2026-10-06-he4rt-delas-tag-e-moderacao.md. As decisões estão na ADR-0001 do delas e na ADR-0003 do identity.Depois da revisão do @danielhe4rt, a moderação saiu do
/appe foi para o cluster de Moderação do/admin. No/appficaram só o pedido e a tag.Como testar
php artisan db:seed --class="He4rt\Delas\Database\Seeders\DelasDemoSeeder"Cria uma conta por papel e por situação (líder, duas moderadoras, membra, pedidos pendentes, em espera, bloqueadas, sem Discord), com o histórico gerado pelas próprias actions. No fim, imprime as contas e a senha. Rodar de novo volta tudo ao começo.
Alterações
Módulo novo
delas(domínio puro, depende só deidentity)delas_tag_requests,delas_requester_blocksedelas_transitions. Índices únicos parciais garantem uma solicitação ativa e um bloqueio ativo por pessoa.RequestDelasTag,ApproveDelasRequest,RejectDelasRequest,GrantDelasTageRevokeDelasTag(esta pode bloquear novos pedidos no mesmo passo);BlockDelasRequestereUnblockDelasRequester;AddDelasModeratoreRemoveDelasModerator;CorrectDelasReason, para editar um motivo sem apagar o original.DelasEligibility(pode pedir? por que não?, numa ordem fixa de verificações) eDelasCandidates(quem aparece em cada seletor de pessoa, com busca que ignora acento).ShouldDispatchAfterCommit) para integrações futuras, como sincronizar o cargohe4rt_delasno Discord.CONTEXT.mdcom glossário, ADR-0001, entrada noCONTEXT-MAP.mde labelmod:delasna tabela de triagem.DelasDemoSeeder: contas de demonstração para testar na mão.Identity: quem entra no
/admin(ADR-0003, substitui o "super admin ou nada" da ADR-0002)delas-moderatoredelas-leademUserRole, criados por migration.UserRole::grantsAdminAccess()(matchsemdefault) eUser::canAccessPanel()comUserRole::withAdminAccess().moderate-delaselead-delas. Super admins passam nos dois peloGate::before.Admin (
/admin)Trait
SuperAdminOnlyem todo Resource, Page e Cluster que já existia, ecanView()nos widgets do Dashboard.itemsFor()na navegação, que só mostra o que a pessoa pode abrir.Quem só modera não vê o Dashboard (que ficaria vazio): entra no
/admindireto na Moderação.Teste de varredura: a moderadora só acessa o Dashboard e as páginas da He4rt Delas. Um resource novo sem o trait quebra o teste.
He4rt Delas como grupo do cluster de Moderação (
/admin/mod/delas/...), uma página por parte:moderate-delasmoderate-delasmoderate-delasmoderate-delaslead-delasCada ação é uma classe em
panel-admin/src/Moderation/Actions/Delas(mesmo padrão doHideInteractionAction). As páginas só declaram a consulta, as colunas e a lista de ações."Ver perfil" embaixo do nome, em todas as páginas: resumo só leitura na lateral, com foto, título, senioridade, "Sobre", Discord e a situação na He4rt Delas. Sem e-mail, data de nascimento ou localização.
Seletores de pessoa seguem o padrão de Select do projeto (abrem com as primeiras pessoas do escopo) e buscam por nome ou
@username.Cada tabela declara o eager load. Os testes das telas desligam o eager load automático e proíbem lazy loading.
Hub (
/app)Marca
he4rt-delasno módulohe4rt(design system), usados pelos dois painéis. A paleta--color-delas-*está no tema dos dois.Além das issues
Regras (precisam do ok da Sther e da Alícia)
he4rt_delas(integração com o/cargo-delasem outra issue). Configurável emdelas.require_discord.Melhorias (fora das issues e das revisões)
PersonLock): decisões sobre a mesma pessoa esperam a vez. Além das corridas apontadas pelo @hefeus, fecha: tirar a tag enquanto a pessoa vira moderadora, pedir enquanto ela é bloqueada e revogar a mesma moderadora duas vezes.mixednas ações.Plano de Testes
make check: Rector e PHPStan passam. O Pint, rodado no Windows, acusa só fim de linha (CRLF) em arquivos fora deste PR, por causa docore.autocrlf.make test: 2425 de 2434 passam. As 9 falhas ficam fora deste PR (BuildDeckTest,SlideViewTesteMergeDuplicateDiscordProfilesTest) e só acontecem no Windows, por causa do separador de caminho (\no lugar de/).app-modules/delas/tests(domínio),app-modules/panel-admin/tests/Feature/Moderation/Delas(telas, seletores, "Ver perfil", lazy loading),app-modules/panel-admin/tests/Feature/Authorization(varredura do admin),app-modules/panel-app/tests/Feature/Delas(perfil) e os casos de papéis emUserResourceTest. Um comportamento por teste.DelasDemoSeeder. Lista completa abaixo.Testes manuais (40 casos)
A. Perfil (
/app)B. Quem entra no
/admin/admin/usersC. Fila
D. Membras
E. Bloqueios
F. Histórico e edição de motivo
G. Equipe
H. Regras de borda
Evidências
Antes
O Hub não tinha nada da He4rt Delas.
Depois
Prints do perfil (
/app)Prints da moderação (
/admin/mod/delas)Issues Relacionadas
Closes #570
Closes #571