teqo-backup/docs/changelog/2026-08-19-c143.md
Francisco Solla 2cc8f2c14d feat(C143): demandas visíveis apenas para responsáveis explícitos + candidato/coordenador
- campaignDemand.responsibles (hasMany → campaignUser, staff elegível) com
  hook beforeValidate que descarta ids não-staff (fail-closed)
- canRead/UpdateCampaignDemand por membership: assessor só vê demandas onde
  é responsável; unrestricted/admin sempre; leader nunca (fim do escopo
  municipal de demandas)
- criador entra automaticamente como responsável no hook de criação (form,
  wizard, rascunhos C90); migration com backfill created_by_id → responsável
- UI: picker multi-select na criação (nova + wizard) e card de gestão no
  detalhe com save full-replace + advisory lock; sugestões = assessores do
  município; rótulo 'Visível para: Responsáveis · Candidato · Coordenador'
- int tests reescritos para a regra nova + 5 casos novos; e2e novo de
  visibilidade (lista/URL/gestão); fixture e2e com createCampaignDemand
- impl plan + changelog; importMap regenerado com S3_* dummy (OPS69)
2026-08-19 23:55:07 -03:00

2.4 KiB

C143 — demandas visíveis apenas para responsáveis explícitos + candidato/coordenador. Novo campo campaignDemand.responsibles (hasMany → campaignUser, staff elegível via eligibleCampaignStaffWhere com hook beforeValidate que descarta ids não-staff, fail-closed) e regra de leitura/atualização por membership: assessor só vê demandas onde é responsável ({ responsibles: { contains } }), candidato/coordenador/admin sempre, leader nunca — a regra substitui o escopo municipal de demandas em src/utilities/access/demands.ts e todas as superfícies (lista, URL, busca global, demandas de atividade, C90) herdam via overrideAccess: false; criação sem responsáveis fica visível só a unrestricted (fail-closed). Criador entra automaticamente como responsável no hook enforceDemandWorkflow (cobre form, wizard e rascunhos C90); migration 20260819_233503_add_campaign_demand_responsibles adiciona campaign_user_id a campaign_demand_rels (FK cascade) e faz backfill de created_by_id → responsável para demandas pré-C143. UI: picker multi-select DemandResponsibleMultiSelect (chips com avatar, chip do criador rotulado "(criador)" e travado na criação, sugestões = assessores do município) na criação (/demandas/nova em 2 colunas + wizard "Registrar pedido" empilhado) e card de gestão DemandResponsiblesCard no detalhe (add/remove com save full-replace + advisory lock, rótulo "Visível para: Responsáveis · Candidato · Coordenador"); busca por searchDemandResponsibleOptions (query curta → assessores do município; senão → staff por nome). Testes: int reescritos para a regra nova (workflow/homeSearch) + 4 casos novos (membership, fail-closed sem responsáveis, gestão add/remove/self-removal, responsável fora da carteira, descarte de id não-staff); e2e novo campaignDemandVisibility.e2e.spec.ts (assessor do mesmo município não vê lista/URL; hand-off de acesso add/revoke pela UI); fixture e2e ganhou createCampaignDemand. Verificação: unit 2444 + int 795 verdes, e2e 5/5 local (visibility + wizard + demanda do municipalidades), lint/format/knip/cycles/tsc/build limpos; importMap regenerado com S3_* dummy (OPS69). Nota de deploy: conferir na primeira aplicação em prod SELECT count(*) FROM campaign_demand_rels WHERE path='responsibles' = nº de demandas com created_by_id. Plano de implementação: docs/plans/demandas-responsaveis-impl.md.