diff --git a/backend/CLAUDE.md b/backend/CLAUDE.md index 9c9190d..9d69299 100644 --- a/backend/CLAUDE.md +++ b/backend/CLAUDE.md @@ -5,7 +5,7 @@ API Laravel 13 / PHP 8.4 da PHPeste Platform. Módulos de domínio vivem em `app ## Módulos MVP: `identity`, `community`, `branding`, `cfp`, `program`, `ticketing`, `payments`, `check-in`, `notifications`, `audit`. -Fase 2/3: `sponsors`, `suppliers` e `finance` (já implementados); scaffold vazio, sem lógica ainda: `tasks`, `engagement`. +Fase 2/3: `sponsors`, `suppliers`, `finance` e `tasks` (já implementados); scaffold vazio, sem lógica ainda: `engagement`. Ver `docs/produto.md` na raiz do monorepo para a responsabilidade de cada um. Com implementação real até agora: @@ -20,6 +20,7 @@ Com implementação real até agora: - `sponsors`: patrocínio por edição, tudo sob a permissão `sponsors.manage` (só organizador), em `/editions/{id}/sponsors`. Cotas (`sponsor_tiers`: valor, vagas, nulo = sem limite, e contrapartidas em texto), empresas (`sponsors`, com contato e observações), acordos (`sponsorships`, o card do funil: empresa, cota, valor, que por padrão é o preço da cota, e responsável da equipe) e meta da edição (`sponsor_settings.goal_cents`). Funil `SponsorshipStage`: prospecção, negociando, fechado, pago e perdido (com motivo). Fechado e pago ocupam vaga da cota: `EnsureTierSlot` trava a cota e conta os acordos fechados; sem vaga, mover, criar já fechado ou trocar a cota de um acordo fechado só passa com `confirm=true`, e o evento `SponsorshipStageChanged` (auditado como `sponsors.stage_changed`) registra `over_slots`. A primeira vez que o acordo fecha cria uma entrega (`sponsor_deliverables`: responsável da equipe, prazo, status) para cada contrapartida da cota. Pagamentos são registrados à mão (`sponsorship_payments`, ADR 0009) e nunca passam do valor do acordo; quando cobrem o valor, o acordo vai sozinho para pago, e remover um pagamento que deixa faltar dinheiro volta para fechado (auditado como `sponsors.payment_recorded`/`payment_removed`). Histórico de contatos em `sponsor_contacts`. Anexos (`sponsor_attachments`: contrato, logo vetorial, outro) ficam no disco privado `SPONSORS_ATTACHMENTS_DISK` (SVG sanitizado) e nunca têm link direto: `GET .../attachments/{id}/url` devolve uma URL assinada que expira em `SPONSORS_ATTACHMENTS_URL_MINUTES`, e o download (`/api/v1/sponsors/attachments/{id}/download`, middleware `signed`, sem login) sai sempre como anexo, com `nosniff` e CSP `sandbox`. `SponsorTotals` dá meta, fechado, recebido, em negociação e contagem e valor por etapa para o funil (`GET .../board`) e para a Visão geral (`indicators.sponsors`, mais a pendência de entregas atrasadas). `SponsorTiersCloner` leva cotas e meta para a próxima edição; empresas, acordos e contatos não vão. Nome de responsável e autor vem do contrato `UserAccounts` (`Http/People`). - `suppliers`: fornecedores, sob a permissão `suppliers.manage` (só organizador), em `/editions/{id}/suppliers`. O cadastro (`suppliers`, com contatos em `supplier_contacts`) é global **da comunidade**, não da plataforma: toda consulta passa por `Access\SupplierAccess`, que filtra pelo `community_id` da edição (lido do contrato `EditionDirectory::communityId`), então outra comunidade recebe 404. Nome (comparado por `name_key`, sem acento e caixa) e CNPJ/CPF não se repetem na comunidade. O contato e o documento só aparecem para quem é da equipe de alguma edição em que o fornecedor está (`canSeeContacts`); para os outros, vem `contacts: null` e `contacts_visible: false`. Na edição, o vínculo (`edition_suppliers`) tem status `SupplierStatus` (a contatar, em orçamento, contratado, recusado), responsável da equipe e valor contratado. O primeiro orçamento (`supplier_quotes`) passa para "em orçamento"; contratar exige um orçamento (que vira aceito) ou um valor, recusar exige motivo, e a mudança é auditada como `suppliers.status_changed`. O "orçado" de cada fornecedor é o menor orçamento recebido ou aceito. A lista (`GET /suppliers`, sem paginação) devolve os totais de orçado (sem os recusados) e contratado calculados sobre a mesma lista filtrada (`SupplierTotals`), que também vão para a Visão geral (`indicators.suppliers`). Histórico em `supplier_activities`: anotações da equipe com canal e registros automáticos de status, orçamento e anexo. Anexos (`supplier_attachments`: orçamento, contrato, nota fiscal) seguem o mesmo esquema dos patrocinadores: disco privado `SUPPLIERS_ATTACHMENTS_DISK` e download só por URL assinada que expira (`/api/v1/suppliers/attachments/{id}/download`). Reaproveitar fornecedor: `GET /suppliers/directory?q=` busca no cadastro da comunidade e mostra em que edições ele esteve e com que status; `POST /suppliers/directory/{supplier}` traz para esta edição como "a contatar". `SuppliersCloner` leva os contratados para a próxima edição como "a contatar", sem valores nem orçamentos. - `finance`: finanças da edição, sem nota fiscal, sob a permissão `finance.manage` (organizador e financeiro), em `/editions/{id}/finance`. A receita não é guardada: `Reports\FinanceReport` calcula na hora a partir dos contratos `Ticketing\Contracts\TicketRevenue` (pedidos pagos ou reembolsados com valor, por conta de recebimento: vendido, reembolsos, taxa do gateway real em `orders.gateway_fee_cents` ou estimada pelo percentual da edição, e líquido) e `Sponsors\Contracts\SponsorRevenue` (patrocínio recebido e a receber), com o titular de cada conta (CPF ou CNPJ, documento mascarado, inclusive contas trocadas) vindo de `PaymentAccounts::all`. Pedido gratuito e importado ficam de fora. Saldo = receita líquida recebida − despesas pagas; previsão = saldo + patrocínio a receber − despesas a pagar. Despesas (`expenses`) com categoria, fornecedor opcional da edição (contrato `Suppliers\Contracts\EditionSuppliers`), valor, vencimento, status (a pagar, paga, que exige data, ou cancelada) e comprovante no disco privado `FINANCE_RECEIPTS_DISK`, baixado só por URL assinada que expira; criar, mudar e remover são auditados (`finance.expense_*`). Categorias (`finance_categories`) com orçamento: a edição ganha as padrão (`FinanceCategory::DEFAULTS`) na primeira leitura, e o resumo compara orçado, comprometido (a pagar e paga) e pago por categoria. `GET .../export` gera XLSX com as abas Resumo, Receita por conta, Orçamento e Despesas (`Export\XlsxWriter`, sem biblioteca, com `ZipArchive`; valores como número), e `?format=csv` gera só as despesas, com ponto e vírgula e BOM. Texto que começa com `=`, `+`, `-` ou `@` ganha apóstrofo para não virar fórmula. A Visão geral recebe a pendência de despesas vencidas (só para quem tem `finance.manage`), e `FinanceCloner` leva categorias e orçamento para a próxima edição. +- `tasks`: quadro kanban da organização, em `/editions/{id}/tasks`. Toda a equipe da edição vê o quadro (`GET /board?filter=mine|overdue`); `tasks.manage` (só organizador) cria, edita, remove e mexe nas colunas, e o responsável move a própria tarefa. Colunas (`task_columns`, as quatro de `TaskColumn::DEFAULTS` nascem na primeira leitura) com `is_done`: tarefa que entra nela ganha `completed_at` e deixa de ficar atrasada; o quadro nunca fica sem coluna de concluídas e só remove coluna vazia. Mover (`MoveTask`): trava as colunas de origem e destino pelo id, em ordem, e renumera as duas de 0 a n−1 na mesma transação; se a tarefa mudou de coluna enquanto isso, tenta de novo. `TaskReorderConcurrencyTest` prova com 12 processos PHP simultâneos que não duplica nem perde posição. Atrasada = prazo antes de hoje e não concluída (pendência na Visão geral). E-mail só para o responsável, se ainda é da equipe e se não desligou `assigned_tasks` (`UserAccounts::wantsNotification`): `task_assigned` ao virar responsável (menos quando a pessoa se atribui) e `task_due_soon` pelo `tasks:due-reminders` (08:00 de Brasília), uma vez por prazo; mudar o prazo libera outro lembrete. Vínculo da tarefa (`link_type`, `link_id`) por ponto de extensão: o módulo dono implementa `Tasks\Contracts\TaskLinkProvider` e registra com `$app->tag([...], TaskLinkProvider::TAG)` (hoje `supplier`, do Suppliers, e `sponsorship`, do Sponsors; a sessão entra com o Program). `TasksCloner` leva colunas e tarefas para a próxima edição como checklist, sem responsável, prazo nem vínculo. - `notifications`: e-mail transacional por edição. Outro módulo envia pelo contrato `EditionMailer::send(editionId, EmailTemplate, email, nome, variáveis, url)`, que registra o envio em `email_deliveries` e enfileira `SendEmailDelivery` (5 tentativas, backoff 30s → 30min). Os tipos de e-mail ficam em `EmailTemplate` (assunto/corpo padrão, variáveis permitidas, transacional ou não), e a edição só sobrescreve assunto e corpo (`email_templates`). O corpo é texto com `{variavel}`, substituído sem Blade e com todo HTML escapado. O layout usa o tema publicado (Branding). Não transacional leva link assinado e `List-Unsubscribe` (one-click), e quem se descadastra fica em `email_unsubscribes`. Produção usa Resend (`MAIL_MAILER=resend`, `RESEND_API_KEY`) e dev usa o Mailpit. ## Estrutura de cada módulo (`app-modules//src/`) diff --git a/backend/app-modules/community/src/Enums/EditionPermission.php b/backend/app-modules/community/src/Enums/EditionPermission.php index 8777b5a..8fe10ae 100644 --- a/backend/app-modules/community/src/Enums/EditionPermission.php +++ b/backend/app-modules/community/src/Enums/EditionPermission.php @@ -18,6 +18,7 @@ enum EditionPermission: string case ManageSponsors = 'sponsors.manage'; case ManageSuppliers = 'suppliers.manage'; case ManageFinance = 'finance.manage'; + case ManageTasks = 'tasks.manage'; public function label(): string { @@ -34,6 +35,7 @@ public function label(): string self::ManageSponsors => 'Gerenciar patrocinadores', self::ManageSuppliers => 'Gerenciar fornecedores', self::ManageFinance => 'Ver e editar finanças', + self::ManageTasks => 'Gerenciar tarefas da organização', }; } } diff --git a/backend/app-modules/community/tests/Feature/CloneEditionTest.php b/backend/app-modules/community/tests/Feature/CloneEditionTest.php index 1794e9d..b2ce9e0 100644 --- a/backend/app-modules/community/tests/Feature/CloneEditionTest.php +++ b/backend/app-modules/community/tests/Feature/CloneEditionTest.php @@ -51,7 +51,7 @@ function cloneEdition(object $test, array $parts, string $slug = '2028'): TestRe it('lista o que pode ser copiado e o que nunca é', function (): void { $this->getJson("{$this->base}/clone-options") ->assertOk() - ->assertJsonPath('data.parts', fn (array $parts): bool => collect($parts)->pluck('id')->sort()->values()->all() === ['cfp', 'emails', 'finance', 'identity', 'sponsor_tiers', 'suppliers', 'team', 'ticketing']) + ->assertJsonPath('data.parts', fn (array $parts): bool => collect($parts)->pluck('id')->sort()->values()->all() === ['cfp', 'emails', 'finance', 'identity', 'sponsor_tiers', 'suppliers', 'tasks', 'team', 'ticketing']) ->assertJsonPath('data.never_copied', fn (array $items): bool => in_array('Propostas', $items, true) && in_array('Participantes', $items, true)); }); diff --git a/backend/app-modules/community/tests/Unit/EditionRoleTest.php b/backend/app-modules/community/tests/Unit/EditionRoleTest.php index 372ee69..ce46c72 100644 --- a/backend/app-modules/community/tests/Unit/EditionRoleTest.php +++ b/backend/app-modules/community/tests/Unit/EditionRoleTest.php @@ -20,6 +20,7 @@ EditionPermission::ManageSponsors->value => [EditionRole::Organizer], EditionPermission::ManageSuppliers->value => [EditionRole::Organizer], EditionPermission::ManageFinance->value => [EditionRole::Organizer, EditionRole::Finance], + EditionPermission::ManageTasks->value => [EditionRole::Organizer], ]; $cases = []; diff --git a/backend/app-modules/identity/src/Actions/EloquentUserAccounts.php b/backend/app-modules/identity/src/Actions/EloquentUserAccounts.php index 0b00bf7..8976c2d 100644 --- a/backend/app-modules/identity/src/Actions/EloquentUserAccounts.php +++ b/backend/app-modules/identity/src/Actions/EloquentUserAccounts.php @@ -8,6 +8,7 @@ use Laravel\Sanctum\NewAccessToken; use Laravel\Sanctum\PersonalAccessToken; use PHPeste\Identity\Contracts\UserAccounts; +use PHPeste\Identity\Enums\NotificationTopic; use PHPeste\Identity\Models\User; class EloquentUserAccounts implements UserAccounts @@ -90,6 +91,11 @@ public function checkPassword(string $userId, string $password): bool return $hash !== null && Hash::check($password, $hash); } + public function wantsNotification(string $userId, NotificationTopic $topic): bool + { + return User::query()->find($userId)?->wantsNotification($topic) ?? false; + } + public function issueToken(string $userId, string $deviceName): NewAccessToken { return User::query()->findOrFail($userId)->createToken($deviceName); diff --git a/backend/app-modules/identity/src/Contracts/UserAccounts.php b/backend/app-modules/identity/src/Contracts/UserAccounts.php index 059d022..f9398a4 100644 --- a/backend/app-modules/identity/src/Contracts/UserAccounts.php +++ b/backend/app-modules/identity/src/Contracts/UserAccounts.php @@ -5,6 +5,7 @@ namespace PHPeste\Identity\Contracts; use Laravel\Sanctum\NewAccessToken; +use PHPeste\Identity\Enums\NotificationTopic; interface UserAccounts { @@ -31,5 +32,10 @@ public function findOrCreateInvited(string $name, string $email): array; public function checkPassword(string $userId, string $password): bool; + /** + * Se a pessoa quer receber e-mail deste assunto (preferência em /me). + */ + public function wantsNotification(string $userId, NotificationTopic $topic): bool; + public function issueToken(string $userId, string $deviceName): NewAccessToken; } diff --git a/backend/app-modules/notifications/src/Enums/EmailTemplate.php b/backend/app-modules/notifications/src/Enums/EmailTemplate.php index 3222101..cff90df 100644 --- a/backend/app-modules/notifications/src/Enums/EmailTemplate.php +++ b/backend/app-modules/notifications/src/Enums/EmailTemplate.php @@ -17,6 +17,8 @@ enum EmailTemplate: string case ProposalReceived = 'proposal_received'; case SpeakerConfirmationReminder = 'speaker_confirmation_reminder'; case SpeakerInvited = 'speaker_invited'; + case TaskAssigned = 'task_assigned'; + case TaskDueSoon = 'task_due_soon'; public function label(): string { @@ -32,6 +34,8 @@ public function label(): string self::ProposalReceived => 'Proposta recebida', self::SpeakerConfirmationReminder => 'Lembrete de confirmação do palestrante', self::SpeakerInvited => 'Convite para palestrar', + self::TaskAssigned => 'Tarefa atribuída', + self::TaskDueSoon => 'Prazo de tarefa chegando', }; } @@ -48,6 +52,8 @@ public function trigger(): string self::ProposalReceived => 'Ao enviar uma proposta', self::SpeakerConfirmationReminder => '2 dias antes do prazo de confirmação', self::SpeakerInvited => 'Ao convidar alguém direto para palestrar', + self::TaskAssigned => 'Ao virar responsável por uma tarefa', + self::TaskDueSoon => '1 dia antes do prazo da tarefa', }; } @@ -70,6 +76,7 @@ public function variables(): array self::TeamInvite => ['nome', 'edicao', 'papel'], self::ProposalReceived => ['nome', 'edicao', 'proposta', 'data'], self::SpeakerConfirmationReminder, self::SpeakerInvited => ['nome', 'edicao', 'proposta', 'prazo'], + self::TaskAssigned, self::TaskDueSoon => ['nome', 'edicao', 'tarefa', 'prazo'], }; } @@ -87,6 +94,8 @@ public function defaultSubject(): string self::ProposalReceived => 'Recebemos sua proposta para o {edicao}', self::SpeakerConfirmationReminder => 'Confirme sua palestra no {edicao} até {prazo}', self::SpeakerInvited => 'Convite para palestrar no {edicao}', + self::TaskAssigned => 'Nova tarefa para você no {edicao}: {tarefa}', + self::TaskDueSoon => 'O prazo de "{tarefa}" é {prazo}', }; } @@ -104,6 +113,8 @@ public function defaultBody(): string self::ProposalReceived => "Oi, {nome}!\n\nRecebemos a proposta \"{proposta}\" para o {edicao}. Você pode editar ou retirar a proposta até o fechamento do CFP.", self::SpeakerConfirmationReminder => "Oi, {nome}!\n\nAinda não recebemos sua confirmação para a palestra \"{proposta}\" no {edicao}. O prazo vai até {prazo}; depois disso a vaga pode ir para a lista de espera.", self::SpeakerInvited => "Oi, {nome}!\n\nA organização do {edicao} convidou você para apresentar \"{proposta}\". Confirme sua participação pelo link abaixo até {prazo}.\n\nPara entrar, use este e-mail: se ainda não tem senha na plataforma, entre pelo GitHub ou peça uma senha em \"Esqueci minha senha\".", + self::TaskAssigned => "Oi, {nome}!\n\nVocê é responsável pela tarefa \"{tarefa}\" no {edicao}. Prazo: {prazo}.", + self::TaskDueSoon => "Oi, {nome}!\n\nA tarefa \"{tarefa}\" do {edicao}, que está com você, vence {prazo}. Se já terminou, mova para a coluna de concluídas no painel." }; } @@ -120,6 +131,7 @@ public function actionLabel(): string self::TeamInvite => 'Aceitar convite', self::ProposalReceived => 'Ver minha proposta', self::SpeakerConfirmationReminder, self::SpeakerInvited => 'Confirmar participação', + self::TaskAssigned, self::TaskDueSoon => 'Ver tarefa', }; } @@ -138,6 +150,7 @@ public function sampleVariables(): array 'proposta' => 'Laravel no sertão: filas sem drama', 'papel' => 'organizador', 'prazo' => '20 de maio', + 'tarefa' => 'Fechar o buffet do coffee break', ]; } } diff --git a/backend/app-modules/notifications/tests/Feature/EmailTemplatesTest.php b/backend/app-modules/notifications/tests/Feature/EmailTemplatesTest.php index 3b1119e..d5a750b 100644 --- a/backend/app-modules/notifications/tests/Feature/EmailTemplatesTest.php +++ b/backend/app-modules/notifications/tests/Feature/EmailTemplatesTest.php @@ -20,7 +20,7 @@ it('lista os modelos da edição com o padrão de cada um', function (): void { $this->getJson($this->url) ->assertOk() - ->assertJsonCount(11, 'data') + ->assertJsonCount(13, 'data') ->assertJsonPath('data.0.id', 'order_confirmed') ->assertJsonPath('data.0.label', 'Confirmação de compra') ->assertJsonPath('data.0.trigger', 'Ao pagar o pedido') @@ -30,7 +30,9 @@ ->assertJsonPath('data.0.last_sent_at', null) ->assertJsonPath('data.6.transactional', false) ->assertJsonPath('data.10.id', 'speaker_invited') - ->assertJsonPath('data.10.subject', 'Convite para palestrar no {edicao}'); + ->assertJsonPath('data.10.subject', 'Convite para palestrar no {edicao}') + ->assertJsonPath('data.12.id', 'task_due_soon') + ->assertJsonPath('data.12.variables', ['nome', 'edicao', 'tarefa', 'prazo']); }); it('salva um modelo personalizado e restaura o padrão', function (): void { diff --git a/backend/app-modules/sponsors/src/Overview/SponsorshipTaskLinks.php b/backend/app-modules/sponsors/src/Overview/SponsorshipTaskLinks.php new file mode 100644 index 0000000..96d02a9 --- /dev/null +++ b/backend/app-modules/sponsors/src/Overview/SponsorshipTaskLinks.php @@ -0,0 +1,42 @@ +forEdition($editionId)->with(['sponsor:id,name', 'tier:id,name'])->whereKey($ids)->get() + ->mapWithKeys(fn (Sponsorship $deal): array => [$deal->id => $this->name($deal)])->all(); + } + + public function options(string $editionId): array + { + return array_values(Sponsorship::query()->forEdition($editionId)->with(['sponsor:id,name', 'tier:id,name'])->get() + ->map(fn (Sponsorship $deal): array => ['id' => $deal->id, 'name' => $this->name($deal)]) + ->sortBy('name')->all()); + } + + private function name(Sponsorship $deal): string + { + return $deal->tier === null ? $deal->sponsor->name : sprintf('%s (%s)', $deal->sponsor->name, $deal->tier->name); + } +} diff --git a/backend/app-modules/sponsors/src/Providers/SponsorsServiceProvider.php b/backend/app-modules/sponsors/src/Providers/SponsorsServiceProvider.php index 9534691..6758893 100644 --- a/backend/app-modules/sponsors/src/Providers/SponsorsServiceProvider.php +++ b/backend/app-modules/sponsors/src/Providers/SponsorsServiceProvider.php @@ -11,7 +11,9 @@ use PHPeste\Sponsors\Contracts\SponsorRevenue; use PHPeste\Sponsors\Http\People; use PHPeste\Sponsors\Overview\SponsorRevenueReport; +use PHPeste\Sponsors\Overview\SponsorshipTaskLinks; use PHPeste\Sponsors\Overview\SponsorsOverviewContributor; +use PHPeste\Tasks\Contracts\TaskLinkProvider; class SponsorsServiceProvider extends ServiceProvider { @@ -22,6 +24,7 @@ public function register(): void $this->app->bind(SponsorRevenue::class, SponsorRevenueReport::class); $this->app->tag([SponsorsOverviewContributor::class], EditionOverviewContributor::TAG); $this->app->tag([SponsorTiersCloner::class], EditionCloner::TAG); + $this->app->tag([SponsorshipTaskLinks::class], TaskLinkProvider::TAG); } public function boot(): void {} diff --git a/backend/app-modules/suppliers/src/Access/SupplierTaskLinks.php b/backend/app-modules/suppliers/src/Access/SupplierTaskLinks.php new file mode 100644 index 0000000..796ce70 --- /dev/null +++ b/backend/app-modules/suppliers/src/Access/SupplierTaskLinks.php @@ -0,0 +1,37 @@ +forEdition($editionId)->with('supplier:id,name')->whereKey($ids)->get() + ->mapWithKeys(fn (EditionSupplier $link): array => [$link->id => $link->supplier->name])->all(); + } + + public function options(string $editionId): array + { + return array_values(EditionSupplier::query()->forEdition($editionId)->with('supplier:id,name')->get() + ->map(fn (EditionSupplier $link): array => ['id' => $link->id, 'name' => $link->supplier->name]) + ->sortBy('name')->all()); + } +} diff --git a/backend/app-modules/suppliers/src/Providers/SuppliersServiceProvider.php b/backend/app-modules/suppliers/src/Providers/SuppliersServiceProvider.php index 03ad968..1341e26 100644 --- a/backend/app-modules/suppliers/src/Providers/SuppliersServiceProvider.php +++ b/backend/app-modules/suppliers/src/Providers/SuppliersServiceProvider.php @@ -8,10 +8,12 @@ use PHPeste\Community\Contracts\EditionCloner; use PHPeste\Community\Contracts\EditionOverviewContributor; use PHPeste\Suppliers\Access\EloquentEditionSuppliers; +use PHPeste\Suppliers\Access\SupplierTaskLinks; use PHPeste\Suppliers\Cloning\SuppliersCloner; use PHPeste\Suppliers\Contracts\EditionSuppliers; use PHPeste\Suppliers\Http\People; use PHPeste\Suppliers\Overview\SuppliersOverviewContributor; +use PHPeste\Tasks\Contracts\TaskLinkProvider; class SuppliersServiceProvider extends ServiceProvider { @@ -22,6 +24,7 @@ public function register(): void $this->app->bind(EditionSuppliers::class, EloquentEditionSuppliers::class); $this->app->tag([SuppliersOverviewContributor::class], EditionOverviewContributor::TAG); $this->app->tag([SuppliersCloner::class], EditionCloner::TAG); + $this->app->tag([SupplierTaskLinks::class], TaskLinkProvider::TAG); } public function boot(): void {} diff --git a/backend/app-modules/tasks/database/migrations/.gitkeep b/backend/app-modules/tasks/database/migrations/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/backend/app-modules/tasks/database/migrations/2026_12_02_100000_create_tasks_tables.php b/backend/app-modules/tasks/database/migrations/2026_12_02_100000_create_tasks_tables.php new file mode 100644 index 0000000..2ee2b62 --- /dev/null +++ b/backend/app-modules/tasks/database/migrations/2026_12_02_100000_create_tasks_tables.php @@ -0,0 +1,52 @@ +uuid('id')->primary(); + $table->foreignUuid('edition_id')->constrained('editions')->cascadeOnDelete(); + $table->string('name', 60); + $table->unsignedSmallInteger('position'); + $table->boolean('is_done')->default(false); + $table->timestamps(); + + $table->index(['edition_id', 'position']); + }); + + Schema::create('tasks', function (Blueprint $table): void { + $table->uuid('id')->primary(); + $table->foreignUuid('edition_id')->constrained('editions')->cascadeOnDelete(); + $table->foreignUuid('task_column_id')->constrained('task_columns')->restrictOnDelete(); + $table->unsignedInteger('position'); + $table->string('title', 200); + $table->text('description')->nullable(); + $table->uuid('assignee_id')->nullable(); + $table->date('due_on')->nullable(); + $table->string('link_type', 24)->nullable(); + $table->uuid('link_id')->nullable(); + $table->timestamp('completed_at')->nullable(); + $table->timestamp('due_reminded_at')->nullable(); + $table->uuid('created_by')->nullable(); + $table->timestamps(); + + $table->index(['edition_id', 'task_column_id', 'position']); + $table->index(['edition_id', 'assignee_id']); + $table->index(['edition_id', 'due_on']); + $table->index(['edition_id', 'link_type', 'link_id']); + }); + } + + public function down(): void + { + Schema::dropIfExists('tasks'); + Schema::dropIfExists('task_columns'); + } +}; diff --git a/backend/app-modules/tasks/routes/tasks-routes.php b/backend/app-modules/tasks/routes/tasks-routes.php index 174d7fd..e36e658 100644 --- a/backend/app-modules/tasks/routes/tasks-routes.php +++ b/backend/app-modules/tasks/routes/tasks-routes.php @@ -1,3 +1,19 @@ group(function (): void { + Route::get('/board', [TaskBoardController::class, 'board'])->name('tasks.board'); + Route::get('/link-options', [TaskBoardController::class, 'linkOptions'])->name('tasks.link-options'); + Route::post('/', [TaskBoardController::class, 'store'])->name('tasks.store'); + Route::patch('/{task}', [TaskBoardController::class, 'update'])->whereUuid('task')->name('tasks.update'); + Route::post('/{task}/move', [TaskBoardController::class, 'move'])->whereUuid('task')->name('tasks.move'); + Route::delete('/{task}', [TaskBoardController::class, 'destroy'])->whereUuid('task')->name('tasks.destroy'); + Route::post('/columns', [TaskBoardController::class, 'storeColumn'])->name('tasks.columns.store'); + Route::post('/columns/reorder', [TaskBoardController::class, 'reorderColumns'])->name('tasks.columns.reorder'); + Route::patch('/columns/{column}', [TaskBoardController::class, 'updateColumn'])->whereUuid('column')->name('tasks.columns.update'); + Route::delete('/columns/{column}', [TaskBoardController::class, 'destroyColumn'])->whereUuid('column')->name('tasks.columns.destroy'); +}); diff --git a/backend/app-modules/tasks/src/Actions/.gitkeep b/backend/app-modules/tasks/src/Actions/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/backend/app-modules/tasks/src/Actions/Columns.php b/backend/app-modules/tasks/src/Actions/Columns.php new file mode 100644 index 0000000..3e4028c --- /dev/null +++ b/backend/app-modules/tasks/src/Actions/Columns.php @@ -0,0 +1,124 @@ + + */ + public function forEdition(string $editionId): Collection + { + if (!TaskColumn::query()->forEdition($editionId)->exists()) { + DB::transaction(function () use ($editionId): void { + if (TaskColumn::query()->forEdition($editionId)->lockForUpdate()->exists()) { + return; + } + + foreach (TaskColumn::DEFAULTS as $position => $column) { + TaskColumn::create(['edition_id' => $editionId, 'position' => $position, ...$column]); + } + }); + } + + return TaskColumn::query()->forEdition($editionId)->orderBy('position')->orderBy('id')->get(); + } + + /** + * @param array{name?: string, is_done?: bool} $attributes + */ + public function save(string $editionId, ?TaskColumn $column, array $attributes): TaskColumn + { + $this->forEdition($editionId); + + if ($column instanceof TaskColumn && ($attributes['is_done'] ?? true) === false && $column->is_done && $this->doneCount($editionId) === 1) { + throw ValidationException::withMessages(['is_done' => 'O quadro precisa de pelo menos uma coluna de concluídas.']); + } + + /** @var TaskColumn */ + return DB::transaction(function () use ($editionId, $column, $attributes): TaskColumn { + if (!$column instanceof TaskColumn) { + return TaskColumn::create([ + 'edition_id' => $editionId, + 'position' => (int) TaskColumn::query()->forEdition($editionId)->max('position') + 1, + 'is_done' => false, + ...$attributes, + ]); + } + + $column->update($attributes); + + if (array_key_exists('is_done', $attributes)) { + Task::query()->forEdition($editionId)->where('task_column_id', $column->id) + ->update(['completed_at' => $column->is_done ? now() : null, 'updated_at' => now()]); + } + + return $column; + }); + } + + public function delete(TaskColumn $column): void + { + if (Task::query()->forEdition($column->edition_id)->where('task_column_id', $column->id)->exists()) { + throw ValidationException::withMessages(['column' => 'A coluna tem tarefas. Mova as tarefas antes de remover.']); + } + + if ($column->is_done && $this->doneCount($column->edition_id) === 1) { + throw ValidationException::withMessages(['column' => 'O quadro precisa de pelo menos uma coluna de concluídas.']); + } + + DB::transaction(function () use ($column): void { + $column->delete(); + $this->resequence($column->edition_id, TaskColumn::query()->forEdition($column->edition_id)->orderBy('position')->orderBy('id')->pluck('id')->all()); + }); + } + + /** + * @param list $ids todas as colunas, na ordem nova + */ + public function reorder(string $editionId, array $ids): void + { + DB::transaction(function () use ($editionId, $ids): void { + $current = TaskColumn::query()->forEdition($editionId)->lockForUpdate()->pluck('id')->all(); + sort($current); + $given = $ids; + sort($given); + + if ($current !== $given) { + throw ValidationException::withMessages(['ids' => 'Mande todas as colunas do quadro, cada uma uma vez.']); + } + + $this->resequence($editionId, $ids); + }); + } + + /** + * @param array $ids vindos de um `pluck('id')`, já na ordem nova + */ + private function resequence(string $editionId, array $ids): void + { + $ids = array_values(array_filter($ids, is_string(...))); + + foreach ($ids as $position => $id) { + TaskColumn::query()->forEdition($editionId)->whereKey($id)->update(['position' => $position]); + } + } + + private function doneCount(string $editionId): int + { + return TaskColumn::query()->forEdition($editionId)->where('is_done', true)->count(); + } +} diff --git a/backend/app-modules/tasks/src/Actions/MoveTask.php b/backend/app-modules/tasks/src/Actions/MoveTask.php new file mode 100644 index 0000000..29cecf4 --- /dev/null +++ b/backend/app-modules/tasks/src/Actions/MoveTask.php @@ -0,0 +1,111 @@ +edition_id; + + for ($attempt = 1; ; $attempt++) { + $moved = DB::transaction(fn (): bool => $this->move($task, $editionId, $columnId, $position)); + + if ($moved) { + return $task->refresh(); + } + + // Outra transação mudou a tarefa de coluna enquanto travávamos as + // colunas: tenta de novo com a coluna atual. + if ($attempt === 3) { + throw ValidationException::withMessages(['task' => 'A tarefa mudou enquanto isso. Atualize o quadro e tente de novo.']); + } + } + } + + /** + * Remove a tarefa e fecha o buraco na coluna. + */ + public function delete(Task $task): void + { + DB::transaction(function () use ($task): void { + TaskColumn::query()->forEdition($task->edition_id)->whereKey($task->task_column_id)->lockForUpdate()->first(); + $task->delete(); + $this->resequence($task->edition_id, Task::query()->forEdition($task->edition_id)->where('task_column_id', $task->task_column_id) + ->orderBy('position')->orderBy('id')->pluck('id')->all()); + }); + } + + private function move(Task $task, string $editionId, string $columnId, int $position): bool + { + $from = Task::query()->forEdition($editionId)->whereKey($task->id)->value('task_column_id'); + + if (!is_string($from)) { + throw ValidationException::withMessages(['task' => 'A tarefa foi removida.']); + } + + $locked = TaskColumn::query()->forEdition($editionId)->whereKey(array_unique([$from, $columnId]))->orderBy('id')->lockForUpdate()->get()->keyBy('id'); + $fresh = Task::query()->forEdition($editionId)->whereKey($task->id)->first(); + + if (!$fresh instanceof Task) { + throw ValidationException::withMessages(['task' => 'A tarefa foi removida.']); + } + + if ($fresh->task_column_id !== $from) { + return false; + } + + $target = $locked->get($columnId); + + if (!$target instanceof TaskColumn) { + throw ValidationException::withMessages(['task_column_id' => 'Esta coluna não é desta edição.']); + } + + $others = Task::query()->forEdition($editionId)->where('task_column_id', $columnId)->whereKeyNot($fresh->id) + ->orderBy('position')->orderBy('id')->pluck('id')->all(); + $index = max(0, min($position, count($others))); + array_splice($others, $index, 0, [$fresh->id]); + + Task::query()->forEdition($editionId)->whereKey($fresh->id)->update([ + 'task_column_id' => $columnId, + 'completed_at' => $target->is_done ? ($fresh->completed_at ?? now()) : null, + 'updated_at' => now(), + ]); + + $this->resequence($editionId, $others); + + if ($from !== $columnId) { + $this->resequence($editionId, Task::query()->forEdition($editionId)->where('task_column_id', $from) + ->orderBy('position')->orderBy('id')->pluck('id')->all()); + } + + return true; + } + + /** + * @param array $ids vindos de um `pluck('id')`, já na ordem nova + */ + private function resequence(string $editionId, array $ids): void + { + $ids = array_values(array_filter($ids, is_string(...))); + + foreach ($ids as $position => $id) { + Task::query()->forEdition($editionId)->whereKey($id)->where('position', '!=', $position)->update(['position' => $position]); + } + } +} diff --git a/backend/app-modules/tasks/src/Actions/SaveTask.php b/backend/app-modules/tasks/src/Actions/SaveTask.php new file mode 100644 index 0000000..0eb62fc --- /dev/null +++ b/backend/app-modules/tasks/src/Actions/SaveTask.php @@ -0,0 +1,85 @@ +memberships->roleIn($editionId, (string) $attributes['assignee_id']) instanceof EditionRole) { + throw ValidationException::withMessages(['assignee_id' => 'O responsável precisa ser da equipe desta edição.']); + } + + if (array_key_exists('link_type', $attributes) || array_key_exists('link_id', $attributes)) { + $this->links->ensure($editionId, $attributes['link_type'] ?? null, $attributes['link_id'] ?? null); + } + + $previousAssignee = $task?->assignee_id; + + /** @var Task $saved */ + $saved = DB::transaction(function () use ($editionId, $task, $attributes, $actorId): Task { + if (!$task instanceof Task) { + $columns = $this->columns->forEdition($editionId); + $columnId = $attributes['task_column_id'] ?? $columns->first()?->id; + $column = TaskColumn::query()->forEdition($editionId)->whereKey($columnId)->lockForUpdate()->first(); + + if (!$column instanceof TaskColumn) { + throw ValidationException::withMessages(['task_column_id' => 'Esta coluna não é desta edição.']); + } + + return Task::create([ + ...$attributes, + 'edition_id' => $editionId, + 'task_column_id' => $column->id, + 'position' => Task::query()->forEdition($editionId)->where('task_column_id', $column->id)->count(), + 'completed_at' => $column->is_done ? now() : null, + 'created_by' => $actorId, + ]); + } + + unset($attributes['task_column_id']); + + if (array_key_exists('due_on', $attributes) && $attributes['due_on']?->toDateString() !== $task->due_on?->toDateString()) { + $attributes['due_reminded_at'] = null; + } + + $task->update($attributes); + + return $task; + }); + + if (!in_array($saved->assignee_id, [null, $previousAssignee, $actorId], true)) { + $this->notifier->send($saved, EmailTemplate::TaskAssigned); + } + + return $saved; + } +} diff --git a/backend/app-modules/tasks/src/Actions/TaskNotifier.php b/backend/app-modules/tasks/src/Actions/TaskNotifier.php new file mode 100644 index 0000000..0b3fc09 --- /dev/null +++ b/backend/app-modules/tasks/src/Actions/TaskNotifier.php @@ -0,0 +1,57 @@ +assignee_id; + + if ($userId === null || !$this->memberships->roleIn($task->edition_id, $userId) instanceof EditionRole || !$this->accounts->wantsNotification($userId, NotificationTopic::AssignedTasks)) { + return false; + } + + $profile = $this->accounts->profiles([$userId])[$userId] ?? null; + + if ($profile === null) { + return false; + } + + $this->mailer->send($task->edition_id, $template, $profile['email'], $profile['name'], [ + 'nome' => $profile['name'], + 'tarefa' => $task->title, + 'prazo' => $task->due_on === null ? 'sem prazo' : $this->date($task->due_on->toDateString()), + ], mb_rtrim((string) config('app.admin_url'), '/').'/tarefas?tarefa='.$task->id); + + return true; + } + + private function date(string $date): string + { + $months = ['janeiro', 'fevereiro', 'março', 'abril', 'maio', 'junho', 'julho', 'agosto', 'setembro', 'outubro', 'novembro', 'dezembro']; + [$year, $month, $day] = array_map(intval(...), explode('-', $date)); + + return sprintf('%d de %s de %d', $day, $months[$month - 1], $year); + } +} diff --git a/backend/app-modules/tasks/src/Board/TaskLinks.php b/backend/app-modules/tasks/src/Board/TaskLinks.php new file mode 100644 index 0000000..e856f1e --- /dev/null +++ b/backend/app-modules/tasks/src/Board/TaskLinks.php @@ -0,0 +1,93 @@ +|null + */ + private ?array $providers = null; + + public function __construct(private readonly Application $app) {} + + /** + * @return array + */ + public function providers(): array + { + if ($this->providers === null) { + $this->providers = []; + + foreach ($this->app->tagged(TaskLinkProvider::TAG) as $provider) { + if ($provider instanceof TaskLinkProvider) { + $this->providers[$provider->key()] = $provider; + } + } + } + + return $this->providers; + } + + public function ensure(string $editionId, ?string $type, ?string $id): void + { + if ($type === null && $id === null) { + return; + } + + $provider = $type === null ? null : ($this->providers()[$type] ?? null); + + if (!$provider instanceof TaskLinkProvider || $id === null) { + throw ValidationException::withMessages(['link_type' => 'Escolha a que a tarefa se liga: '.implode(', ', array_map(fn (TaskLinkProvider $p): string => mb_strtolower($p->label()), $this->providers())).'.']); + } + + if ($provider->names($editionId, [$id]) === []) { + throw ValidationException::withMessages(['link_id' => sprintf('Este %s não é desta edição.', mb_strtolower($provider->label()))]); + } + } + + /** + * @param iterable $tasks + * @return array por id da tarefa + */ + public function describe(string $editionId, iterable $tasks): array + { + $byType = []; + + foreach ($tasks as $task) { + if ($task->link_type !== null && $task->link_id !== null) { + $byType[$task->link_type][] = $task; + } + } + + $out = []; + + foreach ($byType as $type => $group) { + $provider = $this->providers()[$type] ?? null; + + if (!$provider instanceof TaskLinkProvider) { + continue; + } + + $names = $provider->names($editionId, array_values(array_unique(array_map(fn (Task $task): string => (string) $task->link_id, $group)))); + + foreach ($group as $task) { + if (isset($names[(string) $task->link_id])) { + $out[$task->id] = ['type' => $type, 'type_label' => $provider->label(), 'id' => (string) $task->link_id, 'name' => $names[(string) $task->link_id]]; + } + } + } + + return $out; + } +} diff --git a/backend/app-modules/tasks/src/Board/TaskPresenter.php b/backend/app-modules/tasks/src/Board/TaskPresenter.php new file mode 100644 index 0000000..6be019c --- /dev/null +++ b/backend/app-modules/tasks/src/Board/TaskPresenter.php @@ -0,0 +1,67 @@ + + */ + private array $people = []; + + /** + * @var array + */ + private array $links = []; + + public function __construct( + private readonly UserAccounts $accounts, + private readonly TaskLinks $taskLinks, + ) {} + + /** + * @param iterable $tasks + */ + public function load(string $editionId, iterable $tasks): self + { + $list = is_array($tasks) ? $tasks : iterator_to_array($tasks, false); + $ids = array_values(array_unique(array_filter(array_map(fn (Task $task): ?string => $task->assignee_id, $list)))); + + foreach ($this->accounts->profiles($ids) as $id => $profile) { + $this->people[$id] = ['id' => $profile['id'], 'name' => $profile['name']]; + } + + $this->links = [...$this->links, ...$this->taskLinks->describe($editionId, $list)]; + + return $this; + } + + /** + * @return array + */ + public function task(Task $task): array + { + return [ + 'id' => $task->id, + 'column_id' => $task->task_column_id, + 'position' => $task->position, + 'title' => $task->title, + 'description' => $task->description, + 'assignee' => $task->assignee_id === null ? null : ($this->people[$task->assignee_id] ?? ['id' => $task->assignee_id, 'name' => null]), + 'due_on' => $task->due_on?->toDateString(), + 'overdue' => $task->overdue(), + 'done' => $task->completed_at !== null, + 'link' => $this->links[$task->id] ?? null, + 'updated_at' => $task->updated_at->clone()->utc()->toIso8601ZuluString(), + ]; + } +} diff --git a/backend/app-modules/tasks/src/Cloning/TasksCloner.php b/backend/app-modules/tasks/src/Cloning/TasksCloner.php new file mode 100644 index 0000000..044cbf1 --- /dev/null +++ b/backend/app-modules/tasks/src/Cloning/TasksCloner.php @@ -0,0 +1,49 @@ +forEdition($sourceEditionId)->orderBy('position')->get(); + $first = null; + + foreach ($columns as $column) { + $copy = TaskColumn::create(['edition_id' => $targetEditionId, 'name' => $column->name, 'position' => $column->position, 'is_done' => $column->is_done]); + $first ??= $copy->is_done ? null : $copy; + } + + if ($first === null) { + return; + } + + $tasks = Task::query()->forEdition($sourceEditionId)->join('task_columns', 'task_columns.id', '=', 'tasks.task_column_id') + ->orderBy('task_columns.position')->orderBy('tasks.position')->get(['tasks.title', 'tasks.description']); + + foreach ($tasks->values() as $position => $task) { + Task::create(['edition_id' => $targetEditionId, 'task_column_id' => $first->id, 'position' => $position, 'title' => $task->title, 'description' => $task->description]); + } + } +} diff --git a/backend/app-modules/tasks/src/Console/SendDueReminders.php b/backend/app-modules/tasks/src/Console/SendDueReminders.php new file mode 100644 index 0000000..e5f21a8 --- /dev/null +++ b/backend/app-modules/tasks/src/Console/SendDueReminders.php @@ -0,0 +1,55 @@ +withoutGlobalScopes() + ->whereNull('completed_at') + ->whereNull('due_reminded_at') + ->whereNotNull('assignee_id') + ->whereDate('due_on', '>=', today()->toDateString()) + ->whereDate('due_on', '<=', today()->addDay()->toDateString()) + ->get(['id', 'edition_id']); + + $sent = 0; + + foreach ($due as $row) { + $currentEdition->run($row->edition_id, function () use ($row, $notifier, &$sent): void { + $task = Task::query()->find($row->id); + + if (!$task instanceof Task) { + return; + } + + $updated = Task::query()->whereKey($task->id)->whereNull('due_reminded_at')->update(['due_reminded_at' => now()]); + + if ($updated > 0 && $notifier->send($task, EmailTemplate::TaskDueSoon)) { + $sent++; + } + }); + } + + $this->info(sprintf('%d lembrete(s) de prazo enviado(s).', $sent)); + + return self::SUCCESS; + } +} diff --git a/backend/app-modules/tasks/src/Contracts/.gitkeep b/backend/app-modules/tasks/src/Contracts/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/backend/app-modules/tasks/src/Contracts/TaskLinkProvider.php b/backend/app-modules/tasks/src/Contracts/TaskLinkProvider.php new file mode 100644 index 0000000..b982b72 --- /dev/null +++ b/backend/app-modules/tasks/src/Contracts/TaskLinkProvider.php @@ -0,0 +1,34 @@ +tag([...], TaskLinkProvider::TAG)`; o Tasks só guarda o tipo e o id + * e pergunta o nome na hora de mostrar. + */ +interface TaskLinkProvider +{ + public const string TAG = 'tasks.link-providers'; + + /** + * Identificador guardado em `tasks.link_type` (ex.: `supplier`). + */ + public function key(): string; + + public function label(): string; + + /** + * @param list $ids + * @return array id => nome, só dos que existem nesta edição + */ + public function names(string $editionId, array $ids): array; + + /** + * @return list + */ + public function options(string $editionId): array; +} diff --git a/backend/app-modules/tasks/src/Data/.gitkeep b/backend/app-modules/tasks/src/Data/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/backend/app-modules/tasks/src/Events/.gitkeep b/backend/app-modules/tasks/src/Events/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/backend/app-modules/tasks/src/Http/.gitkeep b/backend/app-modules/tasks/src/Http/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/backend/app-modules/tasks/src/Http/Controllers/TaskBoardController.php b/backend/app-modules/tasks/src/Http/Controllers/TaskBoardController.php new file mode 100644 index 0000000..57b6b69 --- /dev/null +++ b/backend/app-modules/tasks/src/Http/Controllers/TaskBoardController.php @@ -0,0 +1,198 @@ +id(); + $filter = (string) $request->query('filter', 'all'); + $me = $this->actor($request); + + $cols = $columns->forEdition($editionId); + $tasks = Task::query() + ->when($filter === 'mine', fn ($query) => $query->where('assignee_id', $me)) + ->when($filter === 'overdue', fn ($query) => $query->whereNull('completed_at')->whereDate('due_on', '<', today()->toDateString())) + ->orderBy('position')->orderBy('id') + ->get(); + $presenter->load($editionId, $tasks); + + return response()->json(['data' => [ + 'filter' => in_array($filter, ['mine', 'overdue'], true) ? $filter : 'all', + 'can_manage' => Gate::allows(EditionPermission::ManageTasks->value), + 'columns' => $cols->map(fn (TaskColumn $column): array => [ + 'id' => $column->id, + 'name' => $column->name, + 'position' => $column->position, + 'is_done' => $column->is_done, + 'count' => $tasks->where('task_column_id', $column->id)->count(), + 'tasks' => $tasks->where('task_column_id', $column->id)->values()->map(fn (Task $task): array => $presenter->task($task))->all(), + ])->all(), + 'totals' => [ + 'tasks' => $tasks->count(), + 'overdue' => $tasks->filter(fn (Task $task): bool => $task->overdue())->count(), + ], + ]]); + } + + /** + * O que dá para ligar a uma tarefa, por tipo (fornecedores, patrocinadores...). + */ + public function linkOptions(CurrentEdition $edition, TaskLinks $links): JsonResponse + { + Gate::authorize(EditionPermission::ManageTasks->value); + + $editionId = (string) $edition->id(); + + return response()->json(['data' => array_values(array_map(fn (TaskLinkProvider $provider): array => [ + 'type' => $provider->key(), + 'label' => $provider->label(), + 'options' => $provider->options($editionId), + ], $links->providers()))]); + } + + public function store(SaveTaskRequest $request, CurrentEdition $edition, SaveTask $save, TaskPresenter $presenter): JsonResponse + { + Gate::authorize(EditionPermission::ManageTasks->value); + + $task = $save->handle((string) $edition->id(), null, $request->task(), $this->actor($request)); + + return response()->json(['data' => $presenter->load($task->edition_id, [$task])->task($task)], 201); + } + + public function update(SaveTaskRequest $request, CurrentEdition $edition, SaveTask $save, TaskPresenter $presenter): JsonResponse + { + Gate::authorize(EditionPermission::ManageTasks->value); + + $task = $save->handle((string) $edition->id(), $this->find($request, 'task', Task::class), $request->task(), $this->actor($request)); + + return response()->json(['data' => $presenter->load($task->edition_id, [$task])->task($task)]); + } + + /** + * Devolve a coluna de destino (e a de origem) já renumeradas, para o + * painel confirmar o movimento otimista ou desfazer. + */ + public function move(MoveTaskRequest $request, MoveTask $move, TaskPresenter $presenter): JsonResponse + { + $task = $this->find($request, 'task', Task::class); + + abort_if(!Gate::allows(EditionPermission::ManageTasks->value) && $task->assignee_id !== $this->actor($request), 403, 'Só quem organiza ou o responsável pela tarefa pode mover.'); + + $from = $task->task_column_id; + $moved = $move->handle($task, $request->string('task_column_id')->toString(), $request->integer('position')); + $affected = Task::query()->whereIn('task_column_id', array_unique([$from, $moved->task_column_id]))->orderBy('position')->orderBy('id')->get(); + $presenter->load($moved->edition_id, $affected); + + return response()->json(['data' => [ + 'task' => $presenter->task($moved), + 'columns' => $affected->groupBy('task_column_id')->map(fn ($group, $columnId): array => [ + 'id' => $columnId, + 'task_ids' => $group->pluck('id')->values()->all(), + ])->values()->all(), + ]]); + } + + public function destroy(Request $request, MoveTask $move): Response + { + Gate::authorize(EditionPermission::ManageTasks->value); + + $move->delete($this->find($request, 'task', Task::class)); + + return response()->noContent(); + } + + public function storeColumn(SaveColumnRequest $request, CurrentEdition $edition, Columns $columns): JsonResponse + { + Gate::authorize(EditionPermission::ManageTasks->value); + + return response()->json(['data' => $this->column($columns->save((string) $edition->id(), null, $request->column()))], 201); + } + + public function updateColumn(SaveColumnRequest $request, CurrentEdition $edition, Columns $columns): JsonResponse + { + Gate::authorize(EditionPermission::ManageTasks->value); + + return response()->json(['data' => $this->column($columns->save((string) $edition->id(), $this->find($request, 'column', TaskColumn::class), $request->column()))]); + } + + public function destroyColumn(Request $request, Columns $columns): Response + { + Gate::authorize(EditionPermission::ManageTasks->value); + + $columns->delete($this->find($request, 'column', TaskColumn::class)); + + return response()->noContent(); + } + + public function reorderColumns(ReorderColumnsRequest $request, CurrentEdition $edition, Columns $columns): JsonResponse + { + Gate::authorize(EditionPermission::ManageTasks->value); + + $editionId = (string) $edition->id(); + $columns->reorder($editionId, $request->ids()); + + return response()->json(['data' => $columns->forEdition($editionId)->map(fn (TaskColumn $column): array => $this->column($column))->all()]); + } + + /** + * @return array + */ + private function column(TaskColumn $column): array + { + return ['id' => $column->id, 'name' => $column->name, 'position' => $column->position, 'is_done' => $column->is_done]; + } + + private function actor(Request $request): ?string + { + $id = $request->user()?->getAuthIdentifier(); + + return is_string($id) ? $id : null; + } + + /** + * @template TModel of Model + * + * @param class-string $model + * @return TModel + */ + private function find(Request $request, string $parameter, string $model): Model + { + $id = $request->route($parameter); + abort_unless(is_string($id), 404); + + return $model::query()->whereKey($id)->firstOrFail(); + } +} diff --git a/backend/app-modules/tasks/src/Http/Requests/MoveTaskRequest.php b/backend/app-modules/tasks/src/Http/Requests/MoveTaskRequest.php new file mode 100644 index 0000000..7e5ec76 --- /dev/null +++ b/backend/app-modules/tasks/src/Http/Requests/MoveTaskRequest.php @@ -0,0 +1,21 @@ +> + */ + public function rules(): array + { + return [ + 'task_column_id' => ['required', 'uuid'], + 'position' => ['required', 'integer', 'min:0', 'max:100000'], + ]; + } +} diff --git a/backend/app-modules/tasks/src/Http/Requests/ReorderColumnsRequest.php b/backend/app-modules/tasks/src/Http/Requests/ReorderColumnsRequest.php new file mode 100644 index 0000000..69ddd18 --- /dev/null +++ b/backend/app-modules/tasks/src/Http/Requests/ReorderColumnsRequest.php @@ -0,0 +1,29 @@ +> + */ + public function rules(): array + { + return [ + 'ids' => ['required', 'array', 'min:1', 'max:30'], + 'ids.*' => ['uuid', 'distinct'], + ]; + } + + /** + * @return list + */ + public function ids(): array + { + return array_values(array_filter((array) $this->input('ids'), is_string(...))); + } +} diff --git a/backend/app-modules/tasks/src/Http/Requests/SaveColumnRequest.php b/backend/app-modules/tasks/src/Http/Requests/SaveColumnRequest.php new file mode 100644 index 0000000..e68995a --- /dev/null +++ b/backend/app-modules/tasks/src/Http/Requests/SaveColumnRequest.php @@ -0,0 +1,39 @@ +> + */ + public function rules(): array + { + return [ + 'name' => [$this->isMethod('POST') ? 'required' : 'sometimes', 'string', 'min:1', 'max:60'], + 'is_done' => ['sometimes', 'boolean'], + ]; + } + + /** + * @return array{name?: string, is_done?: bool} + */ + public function column(): array + { + $data = []; + + if ($this->filled('name')) { + $data['name'] = $this->string('name')->trim()->toString(); + } + + if ($this->has('is_done')) { + $data['is_done'] = $this->boolean('is_done'); + } + + return $data; + } +} diff --git a/backend/app-modules/tasks/src/Http/Requests/SaveTaskRequest.php b/backend/app-modules/tasks/src/Http/Requests/SaveTaskRequest.php new file mode 100644 index 0000000..6343606 --- /dev/null +++ b/backend/app-modules/tasks/src/Http/Requests/SaveTaskRequest.php @@ -0,0 +1,64 @@ +> + */ + public function rules(): array + { + return [ + 'title' => [$this->isMethod('POST') ? 'required' : 'sometimes', 'string', 'min:1', 'max:200'], + 'description' => ['sometimes', 'nullable', 'string', 'max:5000'], + 'assignee_id' => ['sometimes', 'nullable', 'uuid'], + 'due_on' => ['sometimes', 'nullable', 'date_format:Y-m-d'], + 'link_type' => ['sometimes', 'nullable', 'string', 'max:24', 'required_with:link_id'], + 'link_id' => ['sometimes', 'nullable', 'uuid', 'required_with:link_type'], + 'task_column_id' => [$this->isMethod('POST') ? 'sometimes' : 'prohibited', 'uuid'], + ]; + } + + /** + * @return array + */ + public function messages(): array + { + return ['task_column_id.prohibited' => 'Para mudar de coluna, mova a tarefa.']; + } + + /** + * @return array{title?: string, description?: string|null, assignee_id?: string|null, due_on?: Carbon|null, link_type?: string|null, link_id?: string|null, task_column_id?: string} + */ + public function task(): array + { + $data = []; + + if ($this->filled('title')) { + $data['title'] = $this->string('title')->trim()->toString(); + } + + foreach (['description', 'assignee_id', 'link_type', 'link_id'] as $key) { + if ($this->has($key)) { + $data[$key] = $this->filled($key) ? $this->string($key)->trim()->toString() : null; + } + } + + if ($this->has('due_on')) { + $data['due_on'] = $this->filled('due_on') ? Date::createFromFormat('Y-m-d', $this->string('due_on')->toString())?->startOfDay() : null; + } + + if ($this->filled('task_column_id')) { + $data['task_column_id'] = $this->string('task_column_id')->toString(); + } + + return $data; + } +} diff --git a/backend/app-modules/tasks/src/Listeners/.gitkeep b/backend/app-modules/tasks/src/Listeners/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/backend/app-modules/tasks/src/Models/.gitkeep b/backend/app-modules/tasks/src/Models/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/backend/app-modules/tasks/src/Models/Task.php b/backend/app-modules/tasks/src/Models/Task.php new file mode 100644 index 0000000..8fc0f73 --- /dev/null +++ b/backend/app-modules/tasks/src/Models/Task.php @@ -0,0 +1,68 @@ + + */ + public function column(): BelongsTo + { + return $this->belongsTo(TaskColumn::class, 'task_column_id'); + } + + /** + * Atrasada: prazo antes de hoje e fora da coluna de concluídas. + */ + public function overdue(): bool + { + return $this->completed_at === null && $this->due_on !== null && $this->due_on->lt(today()); + } + + /** + * @return array + */ + protected function casts(): array + { + return [ + 'position' => 'integer', + 'due_on' => 'date', + 'completed_at' => 'datetime', + 'due_reminded_at' => 'datetime', + ]; + } +} diff --git a/backend/app-modules/tasks/src/Models/TaskColumn.php b/backend/app-modules/tasks/src/Models/TaskColumn.php new file mode 100644 index 0000000..f9e9f69 --- /dev/null +++ b/backend/app-modules/tasks/src/Models/TaskColumn.php @@ -0,0 +1,56 @@ + + */ + public const array DEFAULTS = [ + ['name' => 'A fazer', 'is_done' => false], + ['name' => 'Fazendo', 'is_done' => false], + ['name' => 'Aguardando', 'is_done' => false], + ['name' => 'Feito', 'is_done' => true], + ]; + + /** + * @return HasMany + */ + public function tasks(): HasMany + { + return $this->hasMany(Task::class)->orderBy('position')->orderBy('id'); + } + + /** + * @return array + */ + protected function casts(): array + { + return ['position' => 'integer', 'is_done' => 'boolean']; + } +} diff --git a/backend/app-modules/tasks/src/Overview/TasksOverviewContributor.php b/backend/app-modules/tasks/src/Overview/TasksOverviewContributor.php new file mode 100644 index 0000000..a4b462d --- /dev/null +++ b/backend/app-modules/tasks/src/Overview/TasksOverviewContributor.php @@ -0,0 +1,29 @@ +forEdition($editionId)->whereNull('completed_at')->whereDate('due_on', '<', today()->toDateString())->count(); + + return new OverviewContribution(pending: $overdue === 0 ? [] : [[ + 'key' => 'tasks_overdue', + 'title' => sprintf('%d %s atrasada%s', $overdue, $overdue === 1 ? 'tarefa' : 'tarefas', $overdue === 1 ? '' : 's'), + 'tone' => 'info', + 'tag' => 'Organização', + 'action_label' => 'Abrir quadro', + 'action_path' => '/tarefas?filtro=atrasadas', + 'priority' => 3, + 'permission' => EditionPermission::ManageTasks, + ]]); + } +} diff --git a/backend/app-modules/tasks/src/Providers/TasksServiceProvider.php b/backend/app-modules/tasks/src/Providers/TasksServiceProvider.php index ca7713c..3b0d8dc 100644 --- a/backend/app-modules/tasks/src/Providers/TasksServiceProvider.php +++ b/backend/app-modules/tasks/src/Providers/TasksServiceProvider.php @@ -4,11 +4,32 @@ namespace PHPeste\Tasks\Providers; +use Illuminate\Console\Scheduling\Schedule; use Illuminate\Support\ServiceProvider; +use PHPeste\Community\Contracts\EditionCloner; +use PHPeste\Community\Contracts\EditionOverviewContributor; +use PHPeste\Tasks\Board\TaskLinks; +use PHPeste\Tasks\Cloning\TasksCloner; +use PHPeste\Tasks\Console\SendDueReminders; +use PHPeste\Tasks\Overview\TasksOverviewContributor; class TasksServiceProvider extends ServiceProvider { - public function register(): void {} + public function register(): void + { + $this->app->singleton(TaskLinks::class); + $this->app->tag([TasksOverviewContributor::class], EditionOverviewContributor::TAG); + $this->app->tag([TasksCloner::class], EditionCloner::TAG); + } - public function boot(): void {} + public function boot(): void + { + if ($this->app->runningInConsole()) { + $this->commands([SendDueReminders::class]); + } + + $this->callAfterResolving(Schedule::class, function (Schedule $schedule): void { + $schedule->command('tasks:due-reminders')->dailyAt('08:00')->timezone('America/Sao_Paulo')->withoutOverlapping(); + }); + } } diff --git a/backend/app-modules/tasks/tests/.gitkeep b/backend/app-modules/tasks/tests/.gitkeep deleted file mode 100644 index e69de29..0000000 diff --git a/backend/app-modules/tasks/tests/Feature/TaskReorderConcurrencyTest.php b/backend/app-modules/tasks/tests/Feature/TaskReorderConcurrencyTest.php new file mode 100644 index 0000000..3e3fd78 --- /dev/null +++ b/backend/app-modules/tasks/tests/Feature/TaskReorderConcurrencyTest.php @@ -0,0 +1,56 @@ + $file]); + DB::purge('sqlite'); + Artisan::call('migrate', ['--force' => true]); + + $edition = Edition::factory()->create(); + $columns = collect(['A fazer', 'Fazendo', 'Feito'])->map(fn (string $name, int $i): TaskColumn => TaskColumn::create(['edition_id' => $edition->id, 'name' => $name, 'position' => $i, 'is_done' => $i === 2])); + $tasks = collect(range(0, 14))->map(fn (int $i): Task => Task::create(['edition_id' => $edition->id, 'task_column_id' => $columns[$i % 2]->id, 'position' => intdiv($i, 2), 'title' => "Tarefa {$i}"])); + + $moves = $tasks->shuffle()->take(12)->map(fn (Task $task): array => [$task->id, $columns[mt_rand(0, 2)]->id, mt_rand(0, 8)])->values(); + $script = __DIR__.'/../Fixtures/move.php'; + + $results = Process::pool(function ($pool) use ($script, $edition, $file, $moves): void { + foreach ($moves as $index => [$taskId, $columnId, $position]) { + $pool->as((string) $index)->env(['DB_CONNECTION' => 'sqlite', 'DB_DATABASE' => $file, 'APP_ENV' => 'testing'])->command([PHP_BINARY, $script, $edition->id, $taskId, $columnId, (string) $position]); + } + })->start()->wait(); + + expect(collect($results)->filter(fn ($result): bool => mb_trim($result->output()) === 'ok')->count())->toBe($moves->count()); + + $after = Task::query()->forEdition($edition->id)->get(); + + expect($after)->toHaveCount(15) + ->and($after->pluck('id')->sort()->values()->all())->toBe($tasks->pluck('id')->sort()->values()->all()); + + foreach ($columns as $column) { + $positions = $after->where('task_column_id', $column->id)->pluck('position')->sort()->values()->all(); + + expect($positions)->toBe($positions === [] ? [] : range(0, count($positions) - 1), "coluna {$column->name}, semente {$seed}"); + } + + foreach ($moves as [$taskId, $columnId]) { + // Cada tarefa terminou na coluna do último movimento que a levou. + $last = $moves->filter(fn (array $move): bool => $move[0] === $taskId)->last(); + expect($after->firstWhere('id', $taskId)->task_column_id)->toBe($last[1]); + } + + expect($after->where('task_column_id', $columns[2]->id)->every(fn (Task $task): bool => $task->completed_at !== null))->toBeTrue(); + + File::delete($file); +})->with([1, 2, 3]); diff --git a/backend/app-modules/tasks/tests/Feature/TasksTest.php b/backend/app-modules/tasks/tests/Feature/TasksTest.php new file mode 100644 index 0000000..16b1aa3 --- /dev/null +++ b/backend/app-modules/tasks/tests/Feature/TasksTest.php @@ -0,0 +1,234 @@ +travelTo('2027-06-10 09:00:00'); + $this->edition = Edition::factory()->create(['name' => 'PHPeste 2027']); + $this->organizer = User::factory()->create(['name' => 'Rita Organiza']); + $this->volunteer = User::factory()->create(['name' => 'Vini Voluntário', 'email' => 'vini@exemplo.com']); + EditionMember::factory()->for($this->edition)->create(['user_id' => $this->organizer->id, 'role' => EditionRole::Organizer]); + EditionMember::factory()->for($this->edition)->create(['user_id' => $this->volunteer->id, 'role' => EditionRole::Volunteer]); + $this->api = "/api/v1/editions/{$this->edition->id}/tasks"; + Sanctum::actingAs($this->organizer); +}); + +function board(object $test, string $filter = 'all'): array +{ + return $test->getJson("{$test->api}/board?filter={$filter}")->assertOk()->json('data'); +} + +function newTask(object $test, array $attributes = []): array +{ + return $test->postJson($test->api, ['title' => 'Fechar o buffet', ...$attributes])->assertCreated()->json('data'); +} + +function titles(array $board, int $column): array +{ + return array_column($board['columns'][$column]['tasks'], 'title'); +} + +it('o quadro nasce com quatro colunas e a tarefa entra no fim da primeira', function (): void { + $empty = board($this); + + expect(array_column($empty['columns'], 'name'))->toBe(['A fazer', 'Fazendo', 'Aguardando', 'Feito']) + ->and(array_column($empty['columns'], 'is_done'))->toBe([false, false, false, true]) + ->and($empty['can_manage'])->toBeTrue(); + + newTask($this, ['title' => 'Primeira']); + $second = newTask($this, ['title' => 'Segunda', 'description' => 'Detalhes', 'due_on' => '2027-06-20', 'assignee_id' => $this->volunteer->id]); + + expect($second)->toMatchArray(['position' => 1, 'due_on' => '2027-06-20', 'overdue' => false, 'done' => false]) + ->and($second['assignee'])->toBe(['id' => $this->volunteer->id, 'name' => 'Vini Voluntário']); + + $full = board($this); + expect(titles($full, 0))->toBe(['Primeira', 'Segunda'])->and($full['columns'][0]['count'])->toBe(2); +}); + +it('move entre colunas e dentro da coluna, sempre renumerando de 0 a n−1', function (): void { + $cols = array_column(board($this)['columns'], 'id'); + $a = newTask($this, ['title' => 'A']); + newTask($this, ['title' => 'B']); + $c = newTask($this, ['title' => 'C']); + + $this->postJson("{$this->api}/{$c['id']}/move", ['task_column_id' => $cols[0], 'position' => 0])->assertOk(); + expect(titles(board($this), 0))->toBe(['C', 'A', 'B']); + + $moved = $this->postJson("{$this->api}/{$a['id']}/move", ['task_column_id' => $cols[3], 'position' => 99])->assertOk()->json('data'); + + expect($moved['task'])->toMatchArray(['column_id' => $cols[3], 'position' => 0, 'done' => true]) + ->and(collect($moved['columns'])->firstWhere('id', $cols[0])['task_ids'])->toHaveCount(2); + + $after = board($this); + expect(titles($after, 0))->toBe(['C', 'B']) + ->and(array_column($after['columns'][0]['tasks'], 'position'))->toBe([0, 1]) + ->and(titles($after, 3))->toBe(['A']); + + $this->postJson("{$this->api}/{$a['id']}/move", ['task_column_id' => $cols[1], 'position' => 0])->assertOk()->assertJsonPath('data.task.done', false); + + $this->deleteJson("{$this->api}/{$c['id']}")->assertNoContent(); + expect(array_column(board($this)['columns'][0]['tasks'], 'position'))->toBe([0]); +}); + +it('tarefa com prazo vencido fica marcada como atrasada, até ir para a coluna de concluídas', function (): void { + $cols = array_column(board($this)['columns'], 'id'); + $late = newTask($this, ['title' => 'Atrasada', 'due_on' => '2027-06-01', 'assignee_id' => $this->volunteer->id]); + newTask($this, ['title' => 'No prazo', 'due_on' => '2027-07-01']); + newTask($this, ['title' => 'Sem prazo']); + + expect($late['overdue'])->toBeTrue(); + + $overdue = board($this, 'overdue'); + expect($overdue['totals'])->toBe(['tasks' => 1, 'overdue' => 1])->and(titles($overdue, 0))->toBe(['Atrasada']); + + $pending = collect($this->getJson("/api/v1/editions/{$this->edition->id}/overview")->json('data.pending'))->firstWhere('key', 'tasks_overdue'); + expect($pending['title'])->toBe('1 tarefa atrasada'); + + $this->postJson("{$this->api}/{$late['id']}/move", ['task_column_id' => $cols[3], 'position' => 0])->assertOk()->assertJsonPath('data.task.overdue', false); + expect(board($this, 'overdue')['totals']['overdue'])->toBe(0); +}); + +it('filtro "minhas" mostra só as tarefas da pessoa', function (): void { + newTask($this, ['title' => 'Minha', 'assignee_id' => $this->organizer->id]); + newTask($this, ['title' => 'Do Vini', 'assignee_id' => $this->volunteer->id]); + + expect(titles(board($this, 'mine'), 0))->toBe(['Minha']); + + Sanctum::actingAs($this->volunteer); + expect(titles(board($this, 'mine'), 0))->toBe(['Do Vini']); +}); + +it('a equipe vê o quadro; o responsável move só a própria tarefa; o resto é de quem organiza', function (): void { + $cols = array_column(board($this)['columns'], 'id'); + $mine = newTask($this, ['title' => 'Do Vini', 'assignee_id' => $this->volunteer->id]); + $other = newTask($this, ['title' => 'Da Rita', 'assignee_id' => $this->organizer->id]); + Sanctum::actingAs($this->volunteer); + + expect(board($this)['can_manage'])->toBeFalse(); + + $this->postJson("{$this->api}/{$mine['id']}/move", ['task_column_id' => $cols[1], 'position' => 0])->assertOk(); + $this->postJson("{$this->api}/{$other['id']}/move", ['task_column_id' => $cols[1], 'position' => 0])->assertForbidden(); + $this->postJson($this->api, ['title' => 'Nova'])->assertForbidden(); + $this->patchJson("{$this->api}/{$mine['id']}", ['title' => 'Outro nome'])->assertForbidden(); + $this->deleteJson("{$this->api}/{$mine['id']}")->assertForbidden(); + $this->postJson("{$this->api}/columns", ['name' => 'X'])->assertForbidden(); + + Sanctum::actingAs(User::factory()->create()); + $this->getJson("{$this->api}/board")->assertForbidden(); +}); + +it('responsável precisa ser da equipe e recebe e-mail ao ser atribuído, se não desligou', function (): void { + $this->postJson($this->api, ['title' => 'X', 'assignee_id' => User::factory()->create()->id]) + ->assertUnprocessable()->assertJsonPath('errors.assignee_id.0', 'O responsável precisa ser da equipe desta edição.'); + + $task = newTask($this, ['title' => 'Fechar o buffet', 'due_on' => '2027-06-20', 'assignee_id' => $this->volunteer->id]); + + $mail = EmailDelivery::query()->forEdition($this->edition->id)->where('template', EmailTemplate::TaskAssigned->value)->sole(); + expect($mail->to_email)->toBe('vini@exemplo.com') + ->and($mail->action_url)->toEndWith('/tarefas?tarefa='.$task['id']); + + newTask($this, ['title' => 'Eu mesma', 'assignee_id' => $this->organizer->id]); + $this->volunteer->update(['notification_preferences' => ['assigned_tasks' => false]]); + newTask($this, ['title' => 'Outra para o Vini', 'assignee_id' => $this->volunteer->id]); + + expect(EmailDelivery::query()->forEdition($this->edition->id)->where('template', EmailTemplate::TaskAssigned->value)->count())->toBe(1); +}); + +it('avisa o responsável um dia antes do prazo, uma vez só, e só ele', function (): void { + $cols = array_column(board($this)['columns'], 'id'); + $tomorrow = newTask($this, ['title' => 'Vence amanhã', 'due_on' => '2027-06-11', 'assignee_id' => $this->volunteer->id]); + newTask($this, ['title' => 'Sem responsável', 'due_on' => '2027-06-11']); + newTask($this, ['title' => 'Daqui a uma semana', 'due_on' => '2027-06-17', 'assignee_id' => $this->volunteer->id]); + $done = newTask($this, ['title' => 'Já feita', 'due_on' => '2027-06-11', 'assignee_id' => $this->organizer->id]); + $this->postJson("{$this->api}/{$done['id']}/move", ['task_column_id' => $cols[3], 'position' => 0])->assertOk(); + EmailDelivery::query()->forEdition($this->edition->id)->delete(); + + $this->artisan('tasks:due-reminders')->assertSuccessful(); + $this->artisan('tasks:due-reminders')->assertSuccessful(); + + $reminders = EmailDelivery::query()->forEdition($this->edition->id)->where('template', EmailTemplate::TaskDueSoon->value)->get(); + expect($reminders)->toHaveCount(1) + ->and($reminders->first()->to_email)->toBe('vini@exemplo.com') + ->and($reminders->first()->variables)->toMatchArray(['tarefa' => 'Vence amanhã', 'prazo' => '11 de junho de 2027']); + + $this->patchJson("{$this->api}/{$tomorrow['id']}", ['due_on' => '2027-06-10'])->assertOk(); + $this->artisan('tasks:due-reminders')->assertSuccessful(); + + expect(EmailDelivery::query()->forEdition($this->edition->id)->where('template', EmailTemplate::TaskDueSoon->value)->count())->toBe(2); +}); + +it('liga a tarefa a um fornecedor ou patrocinador da edição', function (): void { + $supplier = Supplier::create(['community_id' => $this->edition->community_id, 'name' => 'Buffet Sertão', 'name_key' => 'buffet sertao', 'service' => 'catering']); + $link = EditionSupplier::create(['edition_id' => $this->edition->id, 'supplier_id' => $supplier->id, 'status' => 'quoting']); + $sponsor = Sponsor::create(['edition_id' => $this->edition->id, 'name' => 'Acme']); + $tier = SponsorTier::create(['edition_id' => $this->edition->id, 'name' => 'Ouro', 'price_cents' => 1, 'benefits' => []]); + $deal = Sponsorship::create(['edition_id' => $this->edition->id, 'sponsor_id' => $sponsor->id, 'sponsor_tier_id' => $tier->id, 'stage' => 'closed', 'value_cents' => 1]); + + $options = collect($this->getJson("{$this->api}/link-options")->assertOk()->json('data'))->keyBy('type'); + expect($options['supplier']['options'])->toBe([['id' => $link->id, 'name' => 'Buffet Sertão']]) + ->and($options['sponsorship']['options'])->toBe([['id' => $deal->id, 'name' => 'Acme (Ouro)']]); + + $task = newTask($this, ['title' => 'Pedir orçamento final', 'link_type' => 'supplier', 'link_id' => $link->id]); + expect($task['link'])->toBe(['type' => 'supplier', 'type_label' => 'Fornecedor', 'id' => $link->id, 'name' => 'Buffet Sertão']); + + $this->patchJson("{$this->api}/{$task['id']}", ['link_type' => 'sponsorship', 'link_id' => $deal->id])->assertOk()->assertJsonPath('data.link.name', 'Acme (Ouro)'); + + $other = Edition::factory()->create(); + $foreign = Sponsorship::create(['edition_id' => $other->id, 'sponsor_id' => Sponsor::create(['edition_id' => $other->id, 'name' => 'Beta'])->id, 'stage' => 'closed', 'value_cents' => 1]); + $this->postJson($this->api, ['title' => 'X', 'link_type' => 'sponsorship', 'link_id' => $foreign->id])->assertUnprocessable()->assertJsonValidationErrors(['link_id']); + $this->postJson($this->api, ['title' => 'X', 'link_type' => 'sessao', 'link_id' => $deal->id])->assertUnprocessable()->assertJsonValidationErrors(['link_type']); +}); + +it('colunas: cria, renomeia, reordena e só remove vazia, sem ficar sem coluna de concluídas', function (): void { + $cols = board($this)['columns']; + $new = $this->postJson("{$this->api}/columns", ['name' => 'Bloqueado'])->assertCreated()->json('data'); + + expect($new['position'])->toBe(4); + + $order = [$cols[3]['id'], $new['id'], $cols[0]['id'], $cols[1]['id'], $cols[2]['id']]; + $this->postJson("{$this->api}/columns/reorder", ['ids' => $order])->assertOk()->assertJsonPath('data.0.name', 'Feito'); + $this->postJson("{$this->api}/columns/reorder", ['ids' => array_slice($order, 1)])->assertUnprocessable(); + + $this->patchJson("{$this->api}/columns/{$cols[3]['id']}", ['is_done' => false])->assertUnprocessable()->assertJsonValidationErrors(['is_done']); + $this->deleteJson("{$this->api}/columns/{$cols[3]['id']}")->assertUnprocessable(); + $this->patchJson("{$this->api}/columns/{$cols[0]['id']}", ['name' => 'Backlog'])->assertOk()->assertJsonPath('data.name', 'Backlog'); + + newTask($this, ['task_column_id' => $new['id']]); + $this->deleteJson("{$this->api}/columns/{$new['id']}")->assertUnprocessable()->assertJsonValidationErrors(['column']); + $this->deleteJson("{$this->api}/columns/{$cols[2]['id']}")->assertNoContent(); + + expect(array_column(board($this)['columns'], 'position'))->toBe([0, 1, 2, 3]); +}); + +it('a próxima edição recebe o quadro como checklist, sem responsáveis nem prazos', function (): void { + $cols = array_column(board($this)['columns'], 'id'); + newTask($this, ['title' => 'Reservar auditório', 'assignee_id' => $this->volunteer->id, 'due_on' => '2027-03-01']); + $done = newTask($this, ['title' => 'Abrir o CFP']); + $this->postJson("{$this->api}/{$done['id']}/move", ['task_column_id' => $cols[3], 'position' => 0])->assertOk(); + $next = Edition::factory()->create(); + + resolve(TasksCloner::class)->clone($this->edition->id, $next->id); + + $first = TaskColumn::query()->forEdition($next->id)->orderBy('position')->first(); + $copied = Task::query()->forEdition($next->id)->orderBy('position')->get(); + + expect(TaskColumn::query()->forEdition($next->id)->count())->toBe(4) + ->and($copied->pluck('title')->all())->toBe(['Reservar auditório', 'Abrir o CFP']) + ->and($copied->every(fn (Task $task): bool => $task->task_column_id === $first->id && $task->assignee_id === null && $task->due_on === null && $task->completed_at === null))->toBeTrue(); +}); diff --git a/backend/app-modules/tasks/tests/Fixtures/move.php b/backend/app-modules/tasks/tests/Fixtures/move.php new file mode 100644 index 0000000..c818a6a --- /dev/null +++ b/backend/app-modules/tasks/tests/Fixtures/move.php @@ -0,0 +1,25 @@ +make(Kernel::class)->bootstrap(); + +// SQLite: IMMEDIATE faz a transação pegar o lock de escrita no começo, +// como o lockForUpdate faz no MySQL. +config(['database.connections.sqlite.busy_timeout' => 15_000, 'database.connections.sqlite.transaction_mode' => 'IMMEDIATE']); + +[, $editionId, $taskId, $columnId, $position] = $argv; + +resolve(CurrentEdition::class)->run($editionId, function () use ($taskId, $columnId, $position): void { + resolve(MoveTask::class)->handle(Task::query()->findOrFail($taskId), $columnId, (int) $position); +}); + +fwrite(STDOUT, 'ok'); diff --git a/docs/arquitetura/PHPeste_Arquitetura.pdf b/docs/arquitetura/PHPeste_Arquitetura.pdf index 46881c6..bc32369 100644 Binary files a/docs/arquitetura/PHPeste_Arquitetura.pdf and b/docs/arquitetura/PHPeste_Arquitetura.pdf differ diff --git a/docs/arquitetura/README.md b/docs/arquitetura/README.md index 4b19be8..94db2ec 100644 --- a/docs/arquitetura/README.md +++ b/docs/arquitetura/README.md @@ -11,7 +11,7 @@ | 5 | Ciclo de vida da edição, transições, clonagem e Visão geral | | 6 | Os 15 módulos do backend | | 7 | Como os módulos conversam: contratos e pontos de extensão | -| 8 | Banco de dados por domínio (65 tabelas) | +| 8 | Banco de dados por domínio (67 tabelas) | | 9 | Papéis e permissões | | 10 | Ingresso: da compra ao QR | | 11 | CFP: da proposta à grade | @@ -23,7 +23,7 @@ | 17 | Telas: o painel em uso (capturas do front-admin) | | 18 | Onde estamos e o que falta | -Retrato de 19/11/2026, main em `b4293b3`. +Retrato de 19/11/2026, com a B34 (tarefas). ## Como atualizar diff --git a/docs/arquitetura/fonte/arquitetura.html b/docs/arquitetura/fonte/arquitetura.html index 565f9b0..6e54207 100644 --- a/docs/arquitetura/fonte/arquitetura.html +++ b/docs/arquitetura/fonte/arquitetura.html @@ -76,7 +76,7 @@

Resumo em cinco pontos

  1. Monorepo com três partes. backend/ (Laravel 13, API), front-admin/ (Nuxt SPA da organização) e front-public/ (Nuxt SSR do site da edição, resolvido pelo domínio).
  2. A edição é o tenant (ADR 0007). Um banco só; escopo global por edition_id e a edição no contexto só durante a requisição ou o job.
  3. -
  4. 15 módulos (internachi/modular) que só conversam por contratos e eventos. 12 já têm lógica; Program, CheckIn, Tasks e Engagement ainda são casca.
  5. +
  6. 15 módulos (internachi/modular) que só conversam por contratos e eventos. 13 já têm lógica; Program, CheckIn e Engagement ainda são casca.
  7. A plataforma não toca no dinheiro (ADR 0009). Cada edição usa a conta do próprio gateway (Asaas ou Mercado Pago); a receita é calculada dos pedidos, nunca guardada.
  8. Toda ação sensível vira trilha de auditoria por evento, com segredo removido e dado pessoal mascarado.
@@ -106,7 +106,7 @@

Conteúdo

chamada ou dependência assíncrono (evento, fila, webhook) -
Fonte: código da main, backend/CLAUDE.md, docs/produto.md e ADRs 0001–0009.19/11/2026 · main em b4293b3 · página 1
+
Fonte: código da main, backend/CLAUDE.md, docs/produto.md e ADRs 0001–0009.19/11/2026 · B34 (tarefas) · página 1
@@ -158,8 +158,8 @@

Visão geral do sistema

15 módulos (app-modules/) Identity · Community · Branding · Cfp · Ticketing Payments · Notifications · Audit · Sponsors -Suppliers · Finance -casca: Program · CheckIn · Tasks · Engagement +Suppliers · Finance · Tasks +casca: Program · CheckIn · Engagement Horizon (fila) e-mail, webhooks, @@ -171,8 +171,8 @@

Visão geral do sistema

cfp:sync-status ticketing:expire-orders ticketing:reconcile -payments:retry-webhooks -…8 rotinas +tasks:due-reminders +…9 rotinas Regras que valem para todo módulo Tenancy por edição (BelongsToEdition) @@ -183,7 +183,7 @@

Visão geral do sistema

MySQL 8 -um banco · 65 tabelas +um banco · 67 tabelas UUID em toda tabela Redis @@ -213,7 +213,7 @@

Visão geral do sistema

  • Painel e site são projetos separados (decisão: front-admin SPA, front-public SSR). O token é Bearer do Sanctum nos dois (ADR 0005).
  • Fila e agendador rodam a mesma imagem do backend (horizon e scheduler no infra/docker-compose.yml).
-
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 2
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 2
@@ -273,7 +273,7 @@

Tenancy: comunidade, edição e o que é global

Organização sponsors · sponsorships · sponsor_tiers edition_suppliers · supplier_quotes -expenses +expenses · task_columns · tasks Comunicação e operação email_deliveries · email_unsubscribes @@ -288,7 +288,7 @@

Tenancy: comunidade, edição e o que é global

community_id
  • Por que não um banco por comunidade: a mesma pessoa palestra no PHPeste de um ano e compra ingresso no outro, e o perfil dela é um só.
  • Dado de edição que vai para a próxima ("criar edição a partir da anterior") é copiado por um EditionCloner de cada módulo, nunca dado de pessoa.
-
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 3
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 3
@@ -356,7 +356,7 @@

Como uma requisição encontra a edição

O site chama /public/resolve com o host da requisição, recebe edition_id e o domínio principal e redireciona se for preciso (ADR 0008). O host é normalizado (minúsculas, sem porta, IDN em punycode) e nunca é usado para montar URL sem passar pela tabela edition_domains. -
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 4
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 4
@@ -422,13 +422,13 @@

Ciclo de vida da edição

palestrantes, patrocínio, fornecedores), pendências com caminho e filtro (propostas sem revisor, divergência na conciliação, entregas e despesas vencidas) e marcos. O Community filtra cada pendência pela permissão de quem vê: o voluntário não vê pendência de finanças. -
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 5
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 5
06 · Backend

Os 15 módulos do backend

-

Cada módulo é um pacote Composer real em backend/app-modules/<nome> (ADR 0002), com namespace PHPeste\<Nome>: Models, Actions, Contracts, Events, Http, Jobs. 247 rotas na API.

+

Cada módulo é um pacote Composer real em backend/app-modules/<nome> (ADR 0002), com namespace PHPeste\<Nome>: Models, Actions, Contracts, Events, Http, Jobs. 257 rotas na API.

Identity @@ -508,24 +508,26 @@

Os 15 módulos do backend

leitura de QR, entrada, modo offline (B38–B39) casca - + Tasks -kanban da organização (B34) - -casca +quadro kanban com colunas configuráveis, +movimento seguro em paralelo, prazo, lembrete, +vínculo a fornecedor e patrocinador + +10 rotas Engagement feedback, certificados, sorteio (B42) casca
-
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 6
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 6
07 · Backend

Como os módulos conversam

-

Módulo nunca usa model de outro: ou chama um contrato (interface em Contracts/, ligada no service provider) ou escuta um evento. 24 contratos hoje. O arch test barra dependência de App\.

+

Módulo nunca usa model de outro: ou chama um contrato (interface em Contracts/, ligada no service provider) ou escuta um evento. 25 contratos hoje. O arch test barra dependência de App\.

Community @@ -584,16 +586,16 @@

Como os módulos conversam

pelo listener genérico RecordAuditableEvent EditionMailer::send(...): todo e-mail passa por aqui, com tema da edição
-
  • Ponto de extensão é registrado com $app->tag([...], Contrato::TAG): o Community não conhece os módulos, só a tag. Módulo novo aparece na Visão geral e na clonagem sem mexer no Community.
-
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 7
+
  • Ponto de extensão é registrado com $app->tag([...], Contrato::TAG): o Community não conhece os módulos, só a tag. Módulo novo aparece na Visão geral e na clonagem sem mexer no Community. O mesmo vale para TaskLinkProvider (Tasks): Suppliers e Sponsors registram o que uma tarefa pode apontar, e o Program vai registrar a sessão.
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 7
08 · Dados

Banco de dados por domínio

-

MySQL 8, 65 tabelas, todas com UUID como chave. Verde é da edição (tem edition_id); azul é global. ● em Suppliers: global da comunidade (community_id).

+

MySQL 8, 67 tabelas, todas com UUID como chave. Verde é da edição (tem edition_id); azul é global. ● em Suppliers: global da comunidade (community_id).

-
+
Identity · 5 users social_accounts @@ -673,23 +675,27 @@

Banco de dados por domínio

Finance · 2 finance_categories expenses - -Laravel · 7 -personal_access_tokens -jobs · job_batches -failed_jobs -cache · cache_locks -sessions
+ +Tasks · 2 +task_columns +tasks + +Laravel · 7 +personal_access_tokens +jobs · job_batches +failed_jobs +cache · cache_locks +sessions
  • Dinheiro sempre em centavos (inteiro). Dado sensível cifrado no banco: CPF de quem compra, credenciais do gateway, acessibilidade, corpo de webhook, linhas de importação. APP_PREVIOUS_KEYS + comandos *:reencrypt-* para trocar a chave.
  • Estoque e cupom nunca são lidos e depois gravados: UPDATE … WHERE allocated + q <= quantity. Testes com 12 processos simultâneos provam que não vende além do lote.
-
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 8
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 8
09 · Acesso

Papéis e permissões

-

Cinco papéis por edição e doze permissões. O organizador tem todas.

+

Cinco papéis por edição e treze permissões. O organizador tem todas.

-
PermissãoO que liberaOrganizadorFinanceiroAvaliadorCheck-inVoluntário
edition.manageConfigurar edição e identidade●
edition.teamGerenciar equipe e convites●
cfp.reviewAvaliar propostas●●
program.manageGerenciar palestrantes e grade●
speakers.privateVer acessibilidade e alimentação●
orders.viewVer pedidos e pagamentos●●
orders.refundReembolsar pedidos●●
payments.gatewayEditar chaves do gateway●
checkin.scanFazer check-in●●
sponsors.manageGerenciar patrocinadores●
suppliers.manageGerenciar fornecedores●
finance.manageVer e editar finanças●●
+
PermissãoO que liberaOrganizadorFinanceiroAvaliadorCheck-inVoluntário
edition.manageConfigurar edição e identidade●
edition.teamGerenciar equipe e convites●
cfp.reviewAvaliar propostas●●
program.manageGerenciar palestrantes e grade●
speakers.privateVer acessibilidade e alimentação●
orders.viewVer pedidos e pagamentos●●
orders.refundReembolsar pedidos●●
payments.gatewayEditar chaves do gateway●
checkin.scanFazer check-in●●
sponsors.manageGerenciar patrocinadores●
suppliers.manageGerenciar fornecedores●
finance.manageVer e editar finanças●●
tasks.manageGerenciar tarefas (a equipe vê o quadro e move as próprias)●

Como funciona

    @@ -702,7 +708,7 @@

    Como funciona

  • Palestrante e participante não têm papel: entram pelas rotas de edição publicada.
-
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 9
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 9
@@ -776,7 +782,7 @@

Ingresso: da compra ao QR

ticketing:expire-orders (1/min) devolve estoque de reserva vencida · ticketing:rotate-batches abre o próximo lote payments:retry-webhooks (1, 5, 15, 60 min) · ticketing:reconcile (diário) grava divergência com o gateway
  • Reembolso: PaymentLedger::refund reserva o valor antes de chamar o gateway (dois reembolsos ao mesmo tempo nunca passam do pago). Pedido importado de outra plataforma entra pago, sem cobrança, e não passa por reembolso nem conciliação.
-
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 10
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 10
@@ -852,7 +858,7 @@

CFP: da proposta à grade

Configurar CFP (A10) · Avaliar propostas com teclado (A11) · Palestrantes: lista, cobertura e detalhe (A12) · no site público: formulário de proposta e área do palestrante com entrar pelo GitHub (P03, P11). -
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 11
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 11
@@ -905,7 +911,7 @@

Dinheiro: patrocínio, fornecedores e finanças

ADR 0009: a plataforma não recebe nem repassa dinheiro Cada edição cadastra a conta do próprio gateway; a API valida as chaves e um webhook assinado antes de abrir vendas. Credenciais cifradas; a API só mostra os 4 últimos caracteres. -
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 12
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 12
@@ -913,7 +919,7 @@

Dinheiro: patrocínio, fornecedores e finanças

Fila, rotinas agendadas, e-mail e auditoria

O que roda sem ninguém clicar. Todas as rotinas usam withoutOverlapping() e são idempotentes: rodar duas vezes não muda o resultado.

-
QuandoComandoPara quê
* * * * *cfp:sync-statusabre e fecha o CFP pela janela
0 * * * *cfp:confirmation-deadlineslembra 48 h antes e marca sem resposta
* * * * *ticketing:expire-ordersexpira reserva vencida e devolve estoque
* * * * *ticketing:rotate-batchesencerra lote esgotado e abre o próximo
*/5 * * * *ticketing:resume-importsretoma importação parada
04:00 BRTticketing:reconcileconfere pedidos com o gateway
* * * * *payments:retry-webhooksreenfileira webhook com erro (1, 5, 15, 60 min)
03:30audit:pruneapaga trilha além de AUDIT_RETENTION_DAYS
+
QuandoComandoPara quê
* * * * *cfp:sync-statusabre e fecha o CFP pela janela
0 * * * *cfp:confirmation-deadlineslembra 48 h antes e marca sem resposta
* * * * *ticketing:expire-ordersexpira reserva vencida e devolve estoque
* * * * *ticketing:rotate-batchesencerra lote esgotado e abre o próximo
*/5 * * * *ticketing:resume-importsretoma importação parada
04:00 BRTticketing:reconcileconfere pedidos com o gateway
* * * * *payments:retry-webhooksreenfileira webhook com erro (1, 5, 15, 60 min)
08:00 BRTtasks:due-remindersavisa o responsável da tarefa que vence até amanhã
03:30audit:pruneapaga trilha além de AUDIT_RETENTION_DAYS

Fila (Redis + Horizon)

    @@ -933,7 +939,7 @@

    Auditoria

  • Segredo removido, dado pessoal mascarado; o model recusa update e delete.
-
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 13
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 13
@@ -943,7 +949,7 @@

Segurança

TemaComo está
AutenticaçãoSanctum Bearer, um token por dispositivo com expiração (SANCTUM_EXPIRATION_MINUTES); revogar é imediato. Senha mínima de 10 e checagem de vazamento.
IsolamentoEscopo global por edição; outra comunidade recebe 404; arch test impede módulo de depender de App\ e controller de usar $request->all().
Rate limitLimiters nomeados: login, password-reset, checkout, webhooks, configuráveis por .env.
Headers e CORSCSP, HSTS, nosniff, Referrer-Policy, Permissions-Policy. CORS por ambiente e, em /public/*, só a origem do site próprio da edição.
Dados sensíveisCifrados no banco (CPF, credenciais, acessibilidade, webhooks). Logs JSON com password, token, secret e cartão redigidos automaticamente.
ArquivosDisco privado; download só por URL assinada que expira (10 min), sempre como anexo, com nosniff e CSP sandbox. SVG sanitizado.
PagamentoSem dado de cartão na API; webhook com assinatura do driver e reconsulta ao gateway; idempotência no banco (unique(edition_id, idempotency_key)).
SegredosADR 0006: nada de segredo no repositório; APP_PREVIOUS_KEYS para trocar a chave sem perder o que já foi cifrado.
LGPDEncarregado e política por edição, anonimização após o evento (B43 em aberto). Decisão em aberto: comunidade controladora, PHPeste operador.
-
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 14
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 14
@@ -1018,7 +1024,7 @@

Desenvolvimento, CI e deploy

Em aberto para o evento teste de carga, backups, runbook do dia do evento (B45) · dados de demonstração e documentação publicada (B46) -
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 15
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 15
@@ -1031,7 +1037,7 @@

Telas: o design do painel

Tokens do tema Sertão
Design: tokens do tema Sertão
-
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 16
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 16
@@ -1045,7 +1051,7 @@

Telas: o painel em uso

Login
Entrar com e-mail e senha ou GitHub
-
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 17
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 17
@@ -1053,8 +1059,8 @@

Telas: o painel em uso

Onde estamos e o que falta

Os milestones do GitHub e o board PHPeste Platform são a fonte da verdade do andamento; esta página é o retrato no dia da geração.

-
MarcoSituaçãoO que tem
Marco 0 · FundaçãoConcluídoesqueleto Laravel 13, módulos, Docker, convenções de API, segurança base, painel e componentes
Marco 1 · Núcleo e CFPBackend concluídoIdentity, Community, Branding, Notifications, CFP inteiro, Audit; telas A05–A12, A24, A25; site P01, P03
Marco 2 · IngressosBackend quase concluídoingressos, cupons, pedidos, Asaas, Mercado Pago, webhooks, reembolso, conciliação, QR, importação, patrocínio, fornecedores, finanças; falta B34 (tarefas) e as telas A14–A23, P04–P06
Marco 3 · Evento prontoA fazergrade e programação (B35–B37), check-in com modo offline (B38–B39), push (B40), API pública e checkout embutível (B41), site da edição (P02, P07–P09)
Marco 4 · OperaçãoA fazerengajamento (B42), LGPD (B43), relatórios (B44), carga, backups e runbook (B45), dados de demonstração (B46), acessibilidade e e2e (A26, A27)
+
MarcoSituaçãoO que tem
Marco 0 · FundaçãoConcluídoesqueleto Laravel 13, módulos, Docker, convenções de API, segurança base, painel e componentes
Marco 1 · Núcleo e CFPBackend concluídoIdentity, Community, Branding, Notifications, CFP inteiro, Audit; telas A05–A12, A24, A25; site P01, P03
Marco 2 · IngressosBackend concluídoingressos, cupons, pedidos, Asaas, Mercado Pago, webhooks, reembolso, conciliação, QR, importação, patrocínio, fornecedores, finanças, tarefas; faltam as telas A14–A23 e P04–P06
Marco 3 · Evento prontoA fazergrade e programação (B35–B37), check-in com modo offline (B38–B39), push (B40), API pública e checkout embutível (B41), site da edição (P02, P07–P09)
Marco 4 · OperaçãoA fazerengajamento (B42), LGPD (B43), relatórios (B44), carga, backups e runbook (B45), dados de demonstração (B46), acessibilidade e e2e (A26, A27)
-
PHPeste Platform · Arquitetura19/11/2026 · main em b4293b3 · página 18
+
PHPeste Platform · Arquitetura19/11/2026 · B34 (tarefas) · página 18
diff --git a/docs/arquitetura/fonte/gerar.py b/docs/arquitetura/fonte/gerar.py index 4f665b2..7ce223d 100644 --- a/docs/arquitetura/fonte/gerar.py +++ b/docs/arquitetura/fonte/gerar.py @@ -13,7 +13,7 @@ from pathlib import Path OUT = Path(__file__).with_name("arquitetura.html") -RETRATO = "19/11/2026 · main em b4293b3" +RETRATO = "19/11/2026 · B34 (tarefas)" # ---------------------------------------------------------------- estilo --- # Cores do tema Sertão (front-admin) para o que é da plataforma, e neutras @@ -151,7 +151,7 @@ def legend():
  1. Monorepo com três partes. backend/ (Laravel 13, API), front-admin/ (Nuxt SPA da organização) e front-public/ (Nuxt SSR do site da edição, resolvido pelo domínio).
  2. A edição é o tenant (ADR 0007). Um banco só; escopo global por edition_id e a edição no contexto só durante a requisição ou o job.
  3. -
  4. 15 módulos (internachi/modular) que só conversam por contratos e eventos. 12 já têm lógica; Program, CheckIn, Tasks e Engagement ainda são casca.
  5. +
  6. 15 módulos (internachi/modular) que só conversam por contratos e eventos. 13 já têm lógica; Program, CheckIn e Engagement ainda são casca.
  7. A plataforma não toca no dinheiro (ADR 0009). Cada edição usa a conta do próprio gateway (Asaas ou Mercado Pago); a receita é calculada dos pedidos, nunca guardada.
  8. Toda ação sensível vira trilha de auditoria por evento, com segredo removido e dado pessoal mascarado.
@@ -180,13 +180,13 @@ def legend(): b.append(group(430, 30, 380, 500, "API · Laravel 13 · PHP 8.4 · /api/v1", "backend", dashed=False)) b.append(box(445, 62, 350, 86, "Rotas por tipo", ["/editions/{id}/… painel (Sanctum + papel na edição)", "/speaker, /attendee, /checkout/editions/{id}/… publicada", "/public/… site, tema, ingressos (cache + ETag)", "/webhooks/payments/{token} assinado"], "backend", mono=False, size=9.5)) -b.append(box(445, 160, 350, 98, "15 módulos (app-modules/)", ["Identity · Community · Branding · Cfp · Ticketing", "Payments · Notifications · Audit · Sponsors", "Suppliers · Finance", "casca: Program · CheckIn · Tasks · Engagement"], "backend", size=9.5)) +b.append(box(445, 160, 350, 98, "15 módulos (app-modules/)", ["Identity · Community · Branding · Cfp · Ticketing", "Payments · Notifications · Audit · Sponsors", "Suppliers · Finance · Tasks", "casca: Program · CheckIn · Engagement"], "backend", size=9.5)) b.append(box(445, 270, 170, 112, "Horizon (fila)", ["e-mail, webhooks,", "importação, clonagem", "de edição, emissão", "de ingressos"], "backend")) -b.append(box(625, 270, 170, 112, "Scheduler", ["cfp:sync-status", "ticketing:expire-orders", "ticketing:reconcile", "payments:retry-webhooks", "…8 rotinas"], "backend", size=9.5)) +b.append(box(625, 270, 170, 112, "Scheduler", ["cfp:sync-status", "ticketing:expire-orders", "ticketing:reconcile", "tasks:due-reminders", "…9 rotinas"], "backend", size=9.5)) b.append(box(445, 394, 350, 122, "Regras que valem para todo módulo", ["Tenancy por edição (BelongsToEdition)", "Mutação só em Action · validação em FormRequest", "Módulo não usa model de outro (arch test)", "Ação sensível → evento Auditable", "Logs JSON com segredo redigido · Sentry opcional"], "backend", size=9.5)) b.append(arrow([(395, 275), (430, 275)], "infra")) -b.append(box(845, 40, 245, 70, "MySQL 8", ["um banco · 65 tabelas", "UUID em toda tabela"], "data")) +b.append(box(845, 40, 245, 70, "MySQL 8", ["um banco · 67 tabelas", "UUID em toda tabela"], "data")) b.append(box(845, 122, 245, 70, "Redis", ["cache, filas, locks,", "rate limit"], "data")) b.append(box(845, 204, 245, 70, "Disco privado", ["CSV de importação, anexos,", "comprovantes (URL assinada)"], "data")) b.append(box(845, 292, 245, 56, "Asaas · Mercado Pago", ["conta de cada edição (ADR 0009)"], "external")) @@ -217,7 +217,7 @@ def legend(): b.append(box(640, 52, 435, 120, "Equipe e configuração", ["edition_members (papel na edição) · edition_invitations", "edition_settings (tema) · edition_domains", "cfp_settings · ticketing_settings · sponsor_settings", "email_templates · finance_categories"], "edition", size=9.8)) b.append(box(395, 186, 335, 110, "Conteúdo", ["cfp_tracks · cfp_criteria · proposals", "proposal_speakers · review_assignments", "reviews · speaker_confirmations · speaker_logistics"], "edition", size=9.8)) b.append(box(745, 186, 330, 110, "Vendas", ["ticket_types · ticket_batches · coupons", "orders · order_items · tickets", "payment_accounts · payment_charges", "webhook_events · payment_refunds"], "edition", size=9.8)) -b.append(box(395, 310, 335, 96, "Organização", ["sponsors · sponsorships · sponsor_tiers", "edition_suppliers · supplier_quotes", "expenses"], "edition", size=9.8)) +b.append(box(395, 310, 335, 96, "Organização", ["sponsors · sponsorships · sponsor_tiers", "edition_suppliers · supplier_quotes", "expenses · task_columns · tasks"], "edition", size=9.8)) b.append(box(745, 310, 330, 96, "Comunicação e operação", ["email_deliveries · email_unsubscribes", "ticket_imports · reconciliation_issues", "edition_clones"], "edition", size=9.8)) b.append(box(395, 420, 680, 108, "Como o isolamento é garantido", ["Model de edição usa o trait BelongsToEdition: liga o EditionScope e preenche edition_id ao criar.", "Sem edição no contexto, a consulta não devolve nada e criar sem edition_id lança LogicException.", "Ler outra edição de propósito exige ->forEdition($id) explícito (clonagem, rotinas agendadas).", "Comunidade A nunca vê edição, fornecedor ou dado da comunidade B."], "edition", size=9.8)) b.append(arrow([(335, 278), (365, 278), (365, 112), (395, 112)], "global")) @@ -290,7 +290,7 @@ def legend(): ("Finance", "despesas, orçamento por categoria, receita calculada, saldo, planilha", 14, "backend"), ("Program", "salas, sessões e grade (B35–B37)", 0, "todo"), ("CheckIn", "leitura de QR, entrada, modo offline (B38–B39)", 0, "todo"), - ("Tasks", "kanban da organização (B34)", 0, "todo"), + ("Tasks", "quadro kanban com colunas configuráveis, movimento seguro em paralelo, prazo, lembrete, vínculo a fornecedor e patrocinador", 10, "backend"), ("Engagement", "feedback, certificados, sorteio (B42)", 0, "todo"), ] b = [] @@ -307,7 +307,7 @@ def legend(): lines.append(cur) b.append(box(x, y, 350, 94, name, lines[:3], kind, dashed=kind == "todo", badge=(f"{routes} rotas", "backend") if routes else ("casca", "todo"), size=9.8)) pages.append(page(6, "Backend", "Os 15 módulos do backend", - "Cada módulo é um pacote Composer real em backend/app-modules/<nome> (ADR 0002), com namespace PHPeste\\<Nome>: Models, Actions, Contracts, Events, Http, Jobs. 247 rotas na API.", + "Cada módulo é um pacote Composer real em backend/app-modules/<nome> (ADR 0002), com namespace PHPeste\\<Nome>: Models, Actions, Contracts, Events, Http, Jobs. 257 rotas na API.", svg("\n".join(b), h=545))) # ================================================= 7 como conversam @@ -329,9 +329,9 @@ def legend(): for x, y, title, lines in pairs: b.append(box(x, y, 340, 130, title, lines, "backend", size=9.8)) pages.append(page(7, "Backend", "Como os módulos conversam", - "Módulo nunca usa model de outro: ou chama um contrato (interface em Contracts/, ligada no service provider) ou escuta um evento. 24 contratos hoje. O arch test barra dependência de App\\.", + "Módulo nunca usa model de outro: ou chama um contrato (interface em Contracts/, ligada no service provider) ou escuta um evento. 25 contratos hoje. O arch test barra dependência de App\\.", svg("\n".join(b), h=540), - ["Ponto de extensão é registrado com $app->tag([...], Contrato::TAG): o Community não conhece os módulos, só a tag. Módulo novo aparece na Visão geral e na clonagem sem mexer no Community."])) + ["Ponto de extensão é registrado com $app->tag([...], Contrato::TAG): o Community não conhece os módulos, só a tag. Módulo novo aparece na Visão geral e na clonagem sem mexer no Community. O mesmo vale para TaskLinkProvider (Tasks): Suppliers e Sponsors registram o que uma tarefa pode apontar, e o Program vai registrar a sessão."])) # ====================================================== 8 banco dom = [ @@ -346,6 +346,7 @@ def legend(): ("Sponsors", ["sponsor_settings", "sponsor_tiers", "sponsors", "sponsorships", "sponsorship_payments", "sponsor_deliverables", "sponsor_contacts", "sponsor_attachments"], "edition"), ("Suppliers", ["suppliers ●", "supplier_contacts ●", "edition_suppliers", "supplier_quotes", "supplier_attachments", "supplier_activities"], "edition"), ("Finance", ["finance_categories", "expenses"], "edition"), + ("Tasks", ["task_columns", "tasks"], "edition"), ("Laravel", ["personal_access_tokens", "jobs · job_batches", "failed_jobs", "cache · cache_locks", "sessions"], "infra"), ] b = [] @@ -358,7 +359,7 @@ def legend(): b.append(box(cols[col], 12 + heights[col], 260, h, f"{name} · {count}", tables, kind, mono=True, size=9.5, line_h=14)) heights[col] += h + 12 pages.append(page(8, "Dados", "Banco de dados por domínio", - "MySQL 8, 65 tabelas, todas com UUID como chave. Verde é da edição (tem edition_id); azul é global. ● em Suppliers: global da comunidade (community_id).", + "MySQL 8, 67 tabelas, todas com UUID como chave. Verde é da edição (tem edition_id); azul é global. ● em Suppliers: global da comunidade (community_id).", svg("\n".join(b), h=max(heights) + 20), ["Dinheiro sempre em centavos (inteiro). Dado sensível cifrado no banco: CPF de quem compra, credenciais do gateway, acessibilidade, corpo de webhook, linhas de importação. APP_PREVIOUS_KEYS + comandos *:reencrypt-* para trocar a chave.", "Estoque e cupom nunca são lidos e depois gravados: UPDATE … WHERE allocated + q <= quantity. Testes com 12 processos simultâneos provam que não vende além do lote."])) @@ -377,6 +378,7 @@ def legend(): ("sponsors.manage", "Gerenciar patrocinadores", "●", "", "", "", ""), ("suppliers.manage", "Gerenciar fornecedores", "●", "", "", "", ""), ("finance.manage", "Ver e editar finanças", "●", "●", "", "", ""), + ("tasks.manage", "Gerenciar tarefas (a equipe vê o quadro e move as próprias)", "●", "", "", "", ""), ] content = '
' + table(["Permissão", "O que libera", "Organizador", "Financeiro", "Avaliador", "Check-in", "Voluntário"], [(f"{p}", d, *r) for p, d, *r in perms], "cmp perms") + """
@@ -390,7 +392,7 @@ def legend():
  • O painel lê a tabela em GET /roles e monta o menu por papel.
  • Palestrante e participante não têm papel: entram pelas rotas de edição publicada.
  • """ -pages.append(page(9, "Acesso", "Papéis e permissões", "Cinco papéis por edição e doze permissões. O organizador tem todas.", content)) +pages.append(page(9, "Acesso", "Papéis e permissões", "Cinco papéis por edição e treze permissões. O organizador tem todas.", content)) # ============================================= 10 ingresso: compra ao QR b = [] @@ -475,6 +477,7 @@ def legend(): ("*/5 * * * *", "ticketing:resume-imports", "retoma importação parada"), ("04:00 BRT", "ticketing:reconcile", "confere pedidos com o gateway"), ("* * * * *", "payments:retry-webhooks", "reenfileira webhook com erro (1, 5, 15, 60 min)"), + ("08:00 BRT", "tasks:due-reminders", "avisa o responsável da tarefa que vence até amanhã"), ("03:30", "audit:prune", "apaga trilha além de AUDIT_RETENTION_DAYS"), ] content = '
    ' + table(["Quando", "Comando", "Para quê"], [(f"{a}", f"{c}", d) for a, c, d in sched], "cmp sched") + """ @@ -557,7 +560,7 @@ def legend(): status = [ ("Marco 0 · Fundação", "Concluído", "esqueleto Laravel 13, módulos, Docker, convenções de API, segurança base, painel e componentes"), ("Marco 1 · Núcleo e CFP", "Backend concluído", "Identity, Community, Branding, Notifications, CFP inteiro, Audit; telas A05–A12, A24, A25; site P01, P03"), - ("Marco 2 · Ingressos", "Backend quase concluído", "ingressos, cupons, pedidos, Asaas, Mercado Pago, webhooks, reembolso, conciliação, QR, importação, patrocínio, fornecedores, finanças; falta B34 (tarefas) e as telas A14–A23, P04–P06"), + ("Marco 2 · Ingressos", "Backend concluído", "ingressos, cupons, pedidos, Asaas, Mercado Pago, webhooks, reembolso, conciliação, QR, importação, patrocínio, fornecedores, finanças, tarefas; faltam as telas A14–A23 e P04–P06"), ("Marco 3 · Evento pronto", "A fazer", "grade e programação (B35–B37), check-in com modo offline (B38–B39), push (B40), API pública e checkout embutível (B41), site da edição (P02, P07–P09)"), ("Marco 4 · Operação", "A fazer", "engajamento (B42), LGPD (B43), relatórios (B44), carga, backups e runbook (B45), dados de demonstração (B46), acessibilidade e e2e (A26, A27)"), ]