Skip to content

B34: tarefas — quadro kanban da organização - #144

Merged
tecrodrigocastro merged 4 commits into
mainfrom
feat/b34-tarefas
Nov 19, 2026
Merged

tecrodrigocastro merged 4 commits into
mainfrom
feat/b34-tarefas

Conversation

@tecrodrigocastro

Copy link
Copy Markdown
Member

Closes #36

Quadro kanban da organização em /editions/{id}/tasks. Fecha o backend do Marco 2.

O que tem

  • Quem faz o quê:
    • Toda a equipe da edição vê o quadro (GET /board, filtros mine e overdue, contagem por coluna).
    • Quem tem tasks.manage, permissão nova só do organizador como o menu já previa, cria, edita, remove e mexe nas colunas.
    • O responsável move a própria tarefa; mover a de outra pessoa dá 403.
  • Colunas (task_columns):
    • A fazer, Fazendo, Aguardando e Feito nascem na primeira leitura.
    • Dá para criar, renomear, reordenar e remover, só coluna vazia.
    • A coluna marcada como concluídas (is_done) dá completed_at à tarefa que entra nela. O quadro nunca fica sem uma coluna assim.
  • Tarefa (tasks): título, descrição, responsável (precisa ser da equipe), prazo, coluna, posição e vínculo.
  • Atrasada: prazo antes de hoje e fora da coluna de concluídas. Aparece no card (overdue), no filtro e como pendência na Visão geral para quem organiza.
  • Vínculo a fornecedor ou patrocinador: é um ponto de extensão novo, Tasks\Contracts\TaskLinkProvider, registrado por tag.
    • Suppliers registra supplier e Sponsors registra sponsorship. Quando o Program existir, ele registra a sessão sem mexer no Tasks.
    • GET /link-options lista o que dá para ligar, e vínculo de outra edição é recusado.
  • Próxima edição: TasksCloner leva colunas e tarefas como checklist, sem responsável, prazo nem vínculo.

Critérios de aceite

  • Reordenar em paralelo não duplica nem perde posição.
    • MoveTask trava as colunas de origem e destino, sempre na ordem do id, e renumera as duas de 0 a n−1 na mesma transação.
    • Se a tarefa mudou de coluna entre a leitura e a trava, tenta de novo (até 3 vezes).
    • TaskReorderConcurrencyTest roda 12 processos PHP ao mesmo tempo, cada um movendo uma tarefa para coluna e posição aleatórias, com 3 sementes. No fim, cada coluna tem posições exatamente 0..n−1, nenhuma tarefa sumiu e cada uma está na coluna para onde foi movida.
  • Notificação só para quem é responsável.
    • task_assigned sai ao virar responsável, menos quando a pessoa se atribui.
    • task_due_soon sai pelo tasks:due-reminders, diário às 08:00 de Brasília, para tarefa que vence até amanhã: uma vez por prazo, e mudar o prazo libera outro lembrete.
    • Os dois só saem para o responsável, se ele ainda é da equipe e se não desligou "Tarefas atribuídas a mim". A preferência é lida pelo método novo UserAccounts::wantsNotification.
    • O teste confere que tarefa sem responsável, tarefa concluída e prazo longe não geram e-mail, e que o lembrete não repete.

Mudanças fora do módulo

  • EditionPermission::ManageTasks, nos testes da matriz de permissões e da lista de itens copiáveis para a próxima edição.
  • UserAccounts::wantsNotification, no Identity.
  • Dois modelos de e-mail novos, task_assigned e task_due_soon, editáveis pela edição como os outros. O teste da lista de modelos foi para 13.
  • SupplierTaskLinks no Suppliers e SponsorshipTaskLinks no Sponsors.
  • Documento de arquitetura atualizado neste PR, como combinado no Documento de arquitetura da plataforma #143: Tasks deixa de ser casca, 67 tabelas, 257 rotas, 25 contratos, 13 permissões, 9 rotinas, o ponto de extensão novo e o Marco 2 com backend concluído.

Test plan

  • composer check passa: Pint, PHPStan nível 8, Rector e Pest com 1060 testes (2 pulados, de sandbox). São 13 testes novos, 3 deles de concorrência.
  • Migration up, down, up em SQLite.
  • Scramble (com 1 GB): as 10 operações aparecem sob "Tasks".
  • As páginas do documento que mudaram foram conferidas no PNG.
  • Concorrência no MySQL 8: o teste roda em SQLite, que serializa as escritas (transaction_mode = IMMEDIATE no script filho, como nos testes de estoque). No MySQL quem garante é o lockForUpdate das colunas; vale rodar com o infra/dev.sh.

A tela (A22, #70) não está neste PR.

Colunas configuráveis, mover com as colunas travadas e renumeradas na
mesma transação, atrasada e lembrete de prazo só para o responsável,
e vínculo a fornecedor ou patrocinador pelo TaskLinkProvider.
@tecrodrigocastro tecrodrigocastro self-assigned this Nov 19, 2026
@tecrodrigocastro
tecrodrigocastro merged commit d04da4c into main Nov 19, 2026
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

B34 · Tasks: kanban de organização

1 participant