teqo-backup/docs/changelog/2026-09-24-s38.md

3.7 KiB

S38 — Cards personalizáveis como itens do catálogo (2026-09-24): os seis modelos de card (CARD_MODELS) deixam de aparecer como um convite único e viram itens sintéticos do board de /conteudos, misturados às peças, sem seção/cabeçalho próprio: CardCatalogItem (união discriminada ContentCatalogItem = ContentPiecePublicItem | CardCatalogItem, guard isCardCatalogItem) com art (previewSrc ?? assetSrc; placeholder neutro tracejado nos modelos de foto, cuja master é só a moldura com janela transparente), href para o estúdio com o modelo escolhido (/cards?model=<id>, deep link já validado em /cards) e searchText = nome + apelidos + mini-descrição. A copy/apelidos nascem no dono (CardModel.description/aliases obrigatórios: "santinho" → time-de-voce + minha-colinha; "foto de perfil" → perfil-quadrado + perfil-retangular; "colinha" → minha-colinha; "estadual" → time-do-estadual) e o publishedCount continua contando peças: contentCatalogItems() só anexa os cards quando a Central tem peça publicada (estado vazio honesto intacto, sem board de cards). O pipeline único do S28 (facetas/filtro/busca) passou a ver a união: ?tipo=card rende o chip "Tipo · Card" e traz os seis (peça publicada de tipo card segue peça comum); Cidade/Região/Tema/Instituição excluem os cards (não são territoriais) e a busca por apelido funciona sem JS, por querystring. O board ganhou ContentCatalogCardItem (link único — alvo grande no celular —, arte object-cover object-top, tag "Card" — "Card · NOVO" no celular do modelo com selo, com o pill NOVO sobre a arte só no desktop —, chips de apelido, CTA "Escolher este modelo →" no desktop / "Escolher →" no mobile) e a sequência do grid alterna peças e modelos (interleaveCatalogItems, peça → card → peça, sem bloco/seção de cards; o bucket compacto de foto/texto segue como no S27); o tile ContentPieceCardInvite/showCardInvite foi deletado. O clique alimenta o mecanismo anônimo do C213/S32 como abertura de card ({ type:'abertura', subjectType:'card', cardModelId }, 3ª variante estrita da rota, sem picker; sendCardOpeningEvent fail-soft no mesmo transporte sendBeacon → fetch keepalive), nunca como peça, e os contadores de download não são inflados; sem migration (o select de contentEvent já aceitava abertura/card) e o label admin "Abertura da peça" virou "Abertura" (o subjectType desambigua). Sem collection, migration, PII, Consent novo, rota nova ou mudança no estúdio (foto 100% no aparelho); o manifest de e2e do catálogo passou a acordar com cardModels/schemas/contentEvent. Verificação: unit (contentPieceCatalog com builder/busca por apelido/faceta/geo/arte/guarda de Central vazia/alternância, cardModels com os literais de copy, contentEvents com o beacon de abertura), int (contentPiece: cards anexados com publishedCount de peças, busca "santinho", geo exclui, tipo=card; contentEvents: abertura grava sem variant, modelo inventado e stateDeputySlug na abertura recusam sem gravar), e2e (frontendConteudos: board misto sem tile, buscas por apelido, tipo=card, geo, clique → /cards?model=minha-colinha com o beacon de abertura e o diálogo do estúdio, kill switch sem cards), pnpm gate:fast, pnpm test:int, knip/cycles e os e2e afetados locais (conjunto curado em modo prod, espelho do CI). Crítica final do designer (trigger c): reprovou a primeira passada (bloco contínuo de cards lido como seção; print mobile de build pré-fix) e certificou após os ajustes — a alternância peça → card → peça, o selo responsivo e as capturas de "foto de perfil"/peças compactas — em tier primário (Design tier: gpt-5.6-sol).