mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-20 18:24:45 +00:00
createCalendarFeedLinkRecord failed with `overrideAccess:false` + `user: campaignUser` because Payload stripped the required `secretSlug`/`createdBy` fields (create access was admin-only) -> 400 behind the generic message; revokeCalendarFeedRecord silently no-opped (revokedAt update access also admin-only). - canCreateCalendarFeed now enforces advisor filterMunicipality scope on data (canCreateSupporter precedent) + canSetCalendarFeedSecret / canSetCalendarFeedRevocation permit staff to mint the secret on create and mark a feed revoked; secret read stays `() => false` and update admin-only. - CalendarFeed stamps createdBy via stampCampaignCreatedBy; secret create + revokedAt update use the new staff field accesses. - Action refactored to `*Record` (payload, actor) cores + thin wrappers; assertFilterMunicipalityInScope (tour precedent); console.error keeps the real error on the server while the friendly message stays. - 10 int tests for create/scope/revoke/leader/secret; fixture tracks calendarFeed cleanup. Closes #436
8.9 KiB
8.9 KiB
Impl: C92 — Link de import da agenda: corrigir criação do feed
Status: em execução Atualizado em: 2026-08-08 Issue: #436 Intenção: docs/plans/c92-corrigir-criacao-link-import-agenda.md Appetite restante: ~0,5–1 dia eng (herdado; entrega menor que o appetite)
Leitura da intenção
- Outcome: staff (coordenador, assessor, candidato) gera o link de import nomeando o feed, sem erro; o link responde; revogar e listar continuam; erro real não é engolido; não vaza município fora do escopo do criador.
- O que NÃO negociar: leader lockdown; fail-closed no read do feed (o segredo não vaza); credencial revogável; sem sync bidirecional; invariante C16 de escopo do criador.
- O que reavaliar: a "forma do create" — a hipótese da intenção (ajuste de acesso vs forma) foi respondida por repro: o padrão que já funciona no repo é hook-stamp do
createdBy+ acesso de campo relaxado onde o servidor minta o valor, exatamente comoOrganization/Leadership/StateDeputy(que criam comoverrideAccess:false).
Causa raiz (reproduzida localmente com actor real campaignUser)
createCalendarFeedLinkRecord cria com overrideAccess: false + user: campaignUser, data inclui secretSlug e createdBy — ambos required com access.create: canSetCalendarFeedSystemField (só Payload admin). Payload strip os campos negados → ValidationError (400) → catch engole numa mensagem genérica.
Prova (repro em tests/int, DB local teqo_wt92):
payload.create(calendarFeed, { secretSlug, createdBy }, user: coordinator, overrideAccess:false)→ValidationError: ... Secret Slug, Criado por(o bug).- Mesmo create com
beforeChangehook que gravacreatedBy = req.user.id(e sem passarcreatedBydo lado da action) → OK,createdBygravado = id do actor. ← o fix (padrãostampCampaignCreatedBy). - Bug nº 2 (mesma raiz, silencioso):
revokeCalendarFeedRecordfazpayload.update({ revokedAt })comoverrideAccess:false;revokedAt.access.updateé admin-only →revokedAté stripado → update retorna ok mas nunca revoga. Aceite C16 "revogar continua funcionando" está quebrado. Prova:revokedAt set? falsecom updateoverrideAccess:false. - Leader create → bloqueado (acesso de collection já OK). Confirmado.
Componentes / mudanças
1. src/utilities/access/calendarFeeds.ts
- Manter
canSetCalendarFeedSystemField(admin-only) — continua parasecretSlug.update,revokedAt.createecreatedBy. canCreateCalendarFeedagora recebedatae verificafilterMunicipalityno escopo do assessor (precedentecanCreateSupporteremsupporters.ts), fail-closed — fecha o bypass por REST/payload.createcru, não só pela action.- Novo
canSetCalendarFeedSecret: FieldAccess—isPayloadAdmin || isCampaignStaff(getFreshCampaignUser); usado só emsecretSlug.access.create(staff minta o segredo no create;read: () => falseeupdateadmin-only inalterados → segredo nunca re-lido, nunca rotacionado). - Novo
canSetCalendarFeedRevocation: FieldAccess—isPayloadAdmin || isCampaignStaff(getFreshCampaignUser); usado só emrevokedAt.access.update(staff marca revogado;canUpdateCalendarFeedjá escopa advisor acreatedBypróprio → staff só revoga feed próprio).
2. src/collections/CalendarFeed.ts
secretSlug.access.create→canSetCalendarFeedSecret(readeupdateinalterados).revokedAt.access.update→canSetCalendarFeedRevocation(createadmin-only inalterado).- Adicionar
hooks.beforeChange: [stampCampaignCreatedBy](mesmo hook de Organization/Leadership/StateDeputy —campaignAuditFields.ts). - Sem migration — mudança de config, não de schema.
3. src/app/(campaign)/campanha/actions/calendarFeed.ts
- Núcleo testável
createCalendarFeedLinkRecord(payload, actor, input)+ wrapperscreateCalendarFeedLink/revokeCalendarFeed/listCalendarFeeds(padrão*Recorddo repo —createActivity/createSupporter;/simplifycorrigiu a inversãoWith). - Parar de passar
createdByno create →hookFilledCreateData<'calendarFeed'>(tipos: camporequiredpreenchido pelo hook; mesmo cast de Organization). - Escopo de assessor no create (fechar furo do filtro): validar fail-closed que
filterMunicipalityestá no escopo — espelhando o precedente de tour (activity.ts:166-185):payload.findscoped (user,overrideAccess:false) e conferirdocs.length === 1; senão retorna erro amigável. A defesa principal hoje está no acesso de collection (item 1); esta checagem dá a mensagem específica e cobre o caminho da action. - Não engolir o erro real: catch do create/revoke passa a
console.errorno servidor (rastro: quebra de acesso/configuração) mantendo a mensagem amigável para o usuário (contrato de UX inalterado; a mensagem de fora-de-escopo é preservada viaerror.message).
Access / Consent
- Sem
Consentnovo (nenhuma PII nova; leitura de dados com acesso já controlado). secretSlug: create=staff, read=fail-closed (() => false), update=admin (credencial só nasce no create).createdBy: hook grava dereq.user.id(inauthenticável por client); admin de /admin ainda seta manualmente viacanSetCalendarFeedSystemField.
Decisões de engenharia
- Opções: A) relaxar
createdosecretSlug+updatedorevokedAtpara staff e hook-stampcreatedBy; B)overrideAccess:trueno create (comoSupporter); C) hook que gera o segredo e action relê com override. - Recomendação: A — porque mantém
overrideAccess:false(invariante: Local API com user → sem override),readdo segredo continuamente fechado, autor atomizado por hook (sem spoof), e revoga de novo funcionando. Alinha com Organization/Leadership/StateDeputy, os irmãos do mesmo padrãosystemStampedActorField. - Rejeitadas: B porque
overrideAccess:truedesliga TODO o access control do doc (inclui create de leader se a action falhar em checar; e esconde que o write depende de RBAC); C porque o create response stripsecretSlug(prova:hasSecret:falseno retorno comread:false) — a action não consegue ler o segredo que o hook gerou sem override, então o servidor deve fornecê-lo (como hoje,randomUUID()).
Fases verificáveis
- Schema/server — access novo (incl.
canCreateCalendarFeedcomdatascope) + collection hooks + action (núcleo*Record, dropcreatedBy, scope-check advisor,console.errorno catch). - Testes (int) —
tests/int/calendarFeed.int.spec.tsnovo (10 testes), estilocampaignSupporter.int.spec.tscominstallCampaignFixtures:- coordinator cria → ok,
createdBy= actor, URL com secret; - candidate cria;
createdByforjado (create cru comcreatedByde outro) sobrescrito pelo hook;- revoke →
revokedAtsetado (update staff OK); - advisor with
filterMunicipalityno escopo → ok; - advisor fora do escopo → erro (pela action) e
payload.createcru negado (acesso de collection); - leader → negado;
- advisor não revoga feed de outro;
- secret nunca retornado em leitura não-admin.
- fixture:
calendarFeedadicionado aCampaignCollection/emptyOwnedIDs/cleanup loop/purgeMunicipalityResidue.
- coordinator cria → ok,
- Gates —
pnpm gate:fast(lint/types/unit),pnpm test(unit+int),pnpm buildlocal.
Rabbit holes / Não escopo (engenharia)
- Refactor de todos os
canSet*SystemFielddo repo — corte: mudança local emcalendarFeed(a intenção manda). - Fechar o furo de
filterMunicipalitytambém no read (buildFeedWhereinterseptar escopo no GET) — registrado como Issue #455 (C96) via capture-review-debts (gate humano aprovado): defesa em profundidade,depends: [436], destrava sozinha quando o C92 flipardone. - Create via
/adminUI —secretSlughidden+required ecreatedByreadOnly+required:stampCampaignCreatedBysó gravacampaignUser, então admin pelos forms do painel não preenche esses campos. Pré-existente ao C92 (não regressão), fora do escopo (staff cria pelo diálogo da agenda, não pelo painel). Anotado como nota, sem Issue. - UI (diálogo/lista) — C94.
Riscos e mitigação
- Regressão no read do feed: nenhum toque em
calendarFeed.ts/route iCal — read intacto. - Field access relaxado abre escape de
createdBy? Não:createdBypermanece comsetAccessadmin-only; o hook grava dereq.user(prova local); client não atinge o valor. - CampaignUser admin (Users) cria por /admin: ok — admin tem
canSetCalendarFeedSystemField.
Aceite de engenharia
- Aceite de produto da intenção ainda coberto (create staff ok, URL responde, revogar ok, erro não engolido, sem leak de escopo)
- Invariantes AGENTS/engineering-standards (
overrideAccess:falsecom user, copy pt-BR, identificadores EN) - Testes int de access/write (staff cria; leader não; revoke grava; advisor escopo fail-closed; secret não lido)
pnpm gate:fast+pnpm test+pnpm buildverdes