25 KiB
Impl: Card "Time de você": ajuste lateral da foto sem limite artificial
Status: aprovado Atualizado em: 2026-09-19 Issue: #1216 Intenção: docs/plans/cards-time-de-voce-ajuste-lateral.md Appetite restante: herdado — ~0,5–1 dia eng; sem migration; 3 fases somam ≤1 dia (tracer puro ~0,4 + threading ~0,3–0,4 + gates ~0,2)
Leitura da intenção
- Outcome: o visitante empurra a própria foto lateralmente até o rosto medido (caixa do detector) tocar as bordas da área livre da arte (janela
{x:286,y:439,w:592,h:577}); por construção o curso X vira592 − largura do rosto desenhado(≈489px com a referência 103 → ≈±244px a partir do centro inicial, ~2× os ~248px de hoje). Sem controle novo; sem rosto medido a âncora é a silhueta e o alcance nunca fica pior que o de hoje; enquadramento automático S18, banners, harmonização, os 3 modelos anteriores e o download ficam intocados; tudo no aparelho. - O que NÃO negociar:
- O enquadramento inicial continua o de hoje, centrado, com o clamp de hoje — o alcance maior é só do ajuste do visitante (a S18 e o e2e do slider não podem mudar).
- Os 3 modelos S13/S14 (minZoom default 1, clamp cover/contain) e
renderPhotoCardficam intocados;frameCardPhotoOnBboxtem assinatura/comportamento pinados;frameCardPhotoOnFaceé o caminho do time e pode evoluir. - Sem rosto: âncora pela silhueta (alpha bbox), alcance NUNCA pior que o de hoje, sem aviso/erro novo.
- Sem controle/copy novos, sem migration/Consent/access, sem telemetria/persistência; a caixa do rosto é a do momento do recorte (nunca re-detecta em pan/zoom).
- Ajuste LATERAL (X); Y do time não regride.
- O que reavaliar (hipóteses da intenção):
- "O clamp é local a
cardPhotoTransform.ts": o clamp precisa chegar também acardRender.renderTeamCard— o render re-limita e devolve (cardRender.ts:240-271), e o composer grava de volta (CardComposer.tsx:276-278); se divergirem, o alcance é desfeito no paint seguinte. - "O state
readyjá tem o que precisa": hojeuseCardCutoutdescartabbox/face(useCardCutout.ts:88-95) — sem eles não há âncora no momento do pan/zoom. - "±244px é simétrico": é a viagem a partir do centro inicial, com o rosto desenhado no tamanho da referência; o invariante real é o curso total = janela − largura da caixa-âncora desenhada (muda com o zoom; a âncora é a caixa inteira dentro da janela — é por isso 244 e não 296).
- "A janela garante não cobrir rostos dos candidatos": não garante sozinha (c2/Solla/c4 invadem a janela — achado 9 da exploração). A barreira aprovada no gate é o limite da janela; colisão por caixa vira limite registrado, não código (ver D2/D4 e Riscos).
- "O clamp é local a
Abordagem recomendada
flowchart LR
CUT["cardCutout — canvas + bbox + face"] --> HOOK["useCardCutout — ready guarda bbox + face"]
HOOK --> RES["resolveCardPhotoAnchor — face usável ? face : bbox"]
RES --> CLAMP["clampCardPhotoTransform — contexto { minZoom, anchorBox }"]
CLAMP -->|"X: união (alcance de hoje ∪ âncora)"| PAN["pan/zoom — arrasto, setas, teclado"]
CLAMP -->|"Y: clamp de hoje"| PAN
PAN --> REN["renderTeamCard — mesmo contexto no desenho e no retorno"]
REN --> WB["write-back idempotente — sem snap-back"]
REN --> DL["PNG do canvas já pintado (sem re-render)"]
TODAY["sem anchorBox — 3 modelos S13/S14"] -.-> CLAMP
INIT["frameCardPhotoOnFace — enquadramento inicial de hoje"] -.->|"só minZoom"| CLAMP
Opções consideradas: A) régua pura parametrizada por uma caixa-âncora (rosto ou silhueta) + contexto de clamp opcional threaded até o render, com X = união do alcance de hoje | B) liberar o pan do time só no composer e parar de re-limitar no render | C) clamp com colisão contra as caixas dos rostos dos candidatos | D) mexer no enquadramento inicial ou no clamp global dos 3 modelos.
Recomendação: A — concentra a política no dono (src/lib/cardPhotoTransform.ts), preserva os 3 modelos e o renderPhotoCard pelo default omitido, e cobre o aceite por construção: a união nunca remove um transform válido de hoje, então o enquadramento inicial da S18 (clampado pela regra de hoje) nunca é reescrito no write-back e o e2e do slider permanece verde.
Rejeitadas: B porque o render é auto-suficiente por contrato (desenha e devolve o transform para o write-back) e um pan não re-clampado seria desfeito no paint seguinte; C porque a análise mostra que seria um novo limite artificial (evitar Solla x336-485 cortaria ~200px do alcance à esquerda com o rosto na referência 103; evitar c4 x762-865 cortaria ~115px à direita) e ainda não protegeria o corpo, além de contrariar a regra aprovada ("rosto em qualquer ponto da área livre"); D porque reabre a S18, muda o e2e do slider e o claim dos 3 modelos sem evidência.
Decisões de engenharia
-
Onde vive a regra e a forma do contexto:
CardPhotoClampopcional no dono. Opções: A) contexto opcionalCardPhotoClamp = { minZoom?: number; anchorBox?: CardAlphaBbox | null }como último parâmetro declampCardPhotoTransform,cardPhotoDrawRectepanCardPhotoTransform(substituindo ominZoomposicional), e campoanchorBox?nas options já existentes dezoomCardPhotoTransform; omitido = comportamento de hoje | B)anchorBoxposicional depois deminZoom| C) funções gêmeas do time (clampTeamCardPhotoTransform/cardTeamPhotoDrawRect) | D) clamp calculado no composer e transform já clampado entregue ao render. Recomendação: A — uma única política no dono, semundefined/nullposicional no slot do meio (a limpeza que a S18 fez nozoom); o default omitido preserva literalmente os 3 modelos,renderPhotoCard,frameCardPhotoOnBboxe o inicial; a âncora é umaCardAlphaBbox(oCardFaceBoxtem a mesma forma{x,y,width,height}— sem tipo novo). Nome:anchorBoxpara a âncora de enquadramento;anchorcontinua sendo o pivô do zoom (colisão evitada e comentada). Rejeitadas: B —panchegaria a 7 posicionais e o call site compartilhado dos 3 modelos passariaundefinedno meio; C — gêmea rasa que duplicaria a regra de Y e criaria superfície nova no knip; D — o render é a fonte do PNG e do retorno do write-back; tem de re-clampar com a MESMA política. -
Regra do X: união do alcance de hoje com o alcance da âncora. Opções: A)
newX = união(todayX, anchorX)quandoanchorXexiste, senãotodayX| B) X = sóanchorX| C) X = hoje (mexer só no inicial) | D) âncora + colisão por caixa de candidato. Recomendação: A — cobre o aceite e garante "nunca pior que hoje" por construção. Fórmula (por eixo X;start=window.x,size=window.width,a=coverScale(source,window)·zoom):drawnW = source.width · a todayX = [start + size − drawnW, start] se drawnW ≥ size (cover, S13) [start, start + size − drawnW] se drawnW < size (contain, S18) anchorX = [start − box.x·a, start + size − (box.x + box.width)·a] quando box.width·a ≤ size; senão não existe (caixa mais larga que a janela) newX = união(todayX, anchorX) quando anchorX existe todayX caso contrárioPropriedades que o unit pina: (i)
anchorXsempre intersectatodayXquando existe (A.min ≤ T.maxeA.max ≥ T.minvalem nos dois regimes, porque0 ≤ box.xebox.x + box.width ≤ source.width), então a união é um intervalo único (sem buraco); (ii)anchorX ⊇ todayXno regime contain, logo o curso nunca encolhe; (iii) com o rosto na referência (103), curso= 592 − 103 = 489e viagem a partir do centro inicial≈±244,5; (iv) a caixa inteira fica dentro da janela quando o visitante está dentro deanchorX— o que toca a borda é a caixa, não o centro. Nota: no regime cover (zoom alto) a união pode manter alcance de hoje além deanchorXem um dos lados — é o "nunca pior" e o comportamento aceito da S13, não uma liberdade nova. Rejeitadas: B — em zoom ≥ 1 (cover) um rosto fora do centro teria a âncora cortando alcance de hoje (ex.: rosto centrado a 900px de uma fonte 1200px em zoom 2: hoje o X vai até 286; só a âncora pararia em 174) e poderia invalidar o próprio transform inicial → write-back e regressão da S18; C — não resolve o relato (o visitante quer empurrar depois do automático) e mexer no inicial contraria o aceite; D — os números acima (~200px/~115px) mostram que a colisão destruiria o ganho; a barreira aprovada é a janela. -
Sem rosto: âncora = bbox da silhueta com a MESMA regra; piso de hoje preservado pela união. Opções: A)
anchorBox = face usável ? face : bbox, mesma regra X da decisão 2 | B) sem rosto = clamp de hoje literal (sem âncora) | C) âncora sempre a bbox (ignorar o rosto) | D) sem rosto = "âncora no desenho inteiro" (o contain de hoje). Recomendação: A — uma régua só, sem caminho especial: no enquadramento S15 a bbox cobre a janela (âncora mais larga que a janela →anchorXinexistente → clamp de hoje literal); quando o visitante afasta o zoom e a silhueta cabe na janela, o intervalo da âncora é superconjunto do contain de hoje (propriedade ii). "Nunca pior" é propriedade de construção, não caso de teste solto. Rejeitadas: B — duplicaria a política de clamp e não daria âncora nenhuma à silhueta quando ela cabe na janela (quem não tem rosto medido também quer posicionar a pessoa); C — perde a âncora do caso principal (o relato é sobre o rosto); D — é exatamente o limite de hoje (nada muda). -
Y permanece o de hoje — decisão explícita. Opções: A) Y =
clampPhotoOffsetatual (cover/contain por eixo,minZoomdo time) | B) Y também ancorado pela caixa | C) Y livre até as bordas do card | D) congelar o pan vertical. Recomendação: A — a intenção é lateral; a Cena 3 fala "posição horizontal"; o clamp de Y protege a composição vertical (topo do recorte abaixo do banner, base dentro da arte) e o "nunca pior" fica literal também no eixo Y; nenhuma evidência de produto para mexer. Registrado como decisão (não silenciosa): só X ganha âncora. Rejeitadas: B — permitiria o recorte flutuar/sair da janela verticalmente sem pedido e com risco visual novo (céu aparecendo sob o busto); C — descobre a arte sem caso de uso e contraria a barreira; D — removeria um controle que existe hoje (regressão de capacidade). -
Threading até o render/write-back: mesmo contexto no pan, no zoom e no
renderTeamCard. Opções: A)TeamCardRenderArgsganhaanchorBox?;renderTeamCardusa o contexto emcardPhotoDrawRect(:240-245) e no retorno (:266-271); o composer passa o mesmo contexto no arrasto (:387-389), nas setas (:396-400), no teclado e no zoom (:402-406) | B) o render recebe um transform já clampado e não re-clampa | C) wrapper de render só do time. Recomendação: A — clamp de intervalo é idempotente (clamp(clamp(t)) = clamp(t)), então ocardPhotoTransformsEqualdo composer (:276-278) nunca dispara write-back espúrio; o download não re-renderiza (handleDownloadfaztoBlobdo canvas já pintado), logo preview e PNG ficam idênticos por construção;renderPhotoCardintocado. Rejeitadas: B — o render deixaria de ser auto-suficiente (o retorno é o contrato do write-back) e um futuro chamador desenharia diferente do que devolve; C — superfície nova sem necessidade (orenderTeamCardjá é o caminho do time). -
State
ready: guardarbbox+facecrus; a âncora é derivada numa função pura. Opções: A)CardCutoutState.readyganhabbox: CardAlphaBboxeface: CardFaceBox | null(espelho fiel doCardCutoutResult); o composer resolveresolveCardPhotoAnchor(bbox, face)(face usável ? face : bbox) comuseMemopor recorte; um predicado privadoisUsableCardFaceé extraído e reusado porframeCardPhotoOnFace| B)readyguarda a âncora já resolvida | C) guardar bbox + face + âncora. Recomendação: A — o hook continua espelho do resultado (não vira dono da política de clamp); a regra de escolha da âncora vive uma vez na lib pura (mesma validação do inicial); o composer já é o dono do contexto. A caixa é usada como veio do detector/segmentador (coords da fonte), sem reescala nem re-detecção. Rejeitadas: B — esconde a regra no hook e duplica conhecimento comframeCardPhotoOnFace; C — campo derivado redundante. -
e2e: nenhum teste novo ou alterado. Opções: A) manter o describe S18 como está (o
ok/nofacejá atravessa os dois ramos de âncora pelo composer + render) | B) estender com um arrasto e asserção de posição no canvas | C) novo describe S20 com stub dedicado. Recomendação: A — o e2e não mede alcance em pixels de card sem um seam novo (frágil, mediria a geometria do stub, não a regra); o que importa no e2e é que o inicial e o write-back não regridem, e é exatamente o que os asserts do slider (noface=1,ok<0.5) e da amostra harmonizada em(582,550)já pinam; a régua fica pinada em unit (grid de fontes/zooms/âncoras). O e2e da superfície roda de qualquer forma pelo mappingsrc/components/cards+src/lib/card→frontend(scripts/lib/e2e-affected-manifest.mjs:92-98). Rejeitadas: B/C — custo de CI e superfície de seam para uma propriedade já coberta em unit.
Componentes / mudanças
CardPhotoClamp+resolveCardPhotoAnchor+isUsableCardFace(src/lib/cardPhotoTransform.ts): o contexto de clamp ({ minZoom?: number; anchorBox?: CardAlphaBbox | null }), a resolução canônica da âncora (face usável ? face : bbox; a âncora reusaCardAlphaBbox, sem tipo novo) e o predicado de rosto usável extraído deframeCardPhotoOnFacee reusado por ambos. ReusaCardAlphaBbox/CardFaceBox,coverScale.clampCardPhotoTransform,cardPhotoDrawRect,panCardPhotoTransform,zoomCardPhotoTransform(src/lib/cardPhotoTransform.ts): ganham o contexto opcional; X = união (fórmula da D2), Y =clampPhotoOffsetde hoje;minZoomdefaultCARD_PHOTO_MIN_ZOOMpreservado.frameCardPhotoOnBboxintocado;frameCardPhotoOnFacesó troca a chamada interna para{ minZoom: CARD_TEAM_PHOTO_MIN_ZOOM }(inicial sem âncora).CardCutoutState.ready(src/components/cards/useCardCutout.ts:13-26): ganhabbox/face; a chamada de enquadramento (:69-77), run id/retry/progresso e oerror: 'empty'continuam iguais.CardComposer(src/components/cards/CardComposer.tsx):photoAnchorBoxmemoizado deteamReady; o contexto{ minZoom: photoMinZoom, anchorBox: photoAnchorBox }(âncoranullnos modelos de foto = default) entra emwithTransform/arrasto/setas/teclado/zoom; a chamada derenderTeamCard(:263-274) ganhaanchorBox. Nenhuma mudança de UI, controle, copy ou estado de erro.renderTeamCard/TeamCardRenderArgs(src/lib/cardRender.ts): campoanchorBox?; desenho (:240-245) e retorno (:266-271) com o mesmo contexto.renderPhotoCard(:198-207) intocado.- Testes (editar/novo):
tests/unit/cardPhotoTransform.unit.spec.ts(forma das chamadas que passamminZoom+ describe novo da âncora: união/curso ±244,5, superconjunto, âncora mais larga → hoje, Y intocado, idempotência);tests/unit/cardRender.unit.spec.ts(novo:renderTeamCardcomanchorBoxpreserva o X fora do alcance antigo e semanchorBoxclampa como hoje).cardModels.unit.spec.ts,cardFaceDetection.unit.spec.tse o e2e ficam como estão. docs/changelog/2026-09-19-s20.md(novo).- Migration: sem migration — nenhuma collection/global/field;
push:falseintocado (100% client-side). - Access / Consent: não se aplica — nenhuma superfície Payload; a âncora é geometria efêmera no aparelho; sem chave de Consent.
- UI: Impeccable C — comportamento, sem controle novo. O artefato
docs/plans/cards-time-de-voce-ajuste-lateral-ui-design.html(Cenas 3/4) é a referência de gate; craft no browser com fotos reais (com/sem rosto, arrasto até as bordas, zoom antes/depois) como na S18. Sem shape novo.
Dados → forma (se aplicável)
Não se aplica — nenhum KPI, mapa ou série; nenhum dado apresentado/coletado/enviado. A única "forma" é geometria do card (literais medidos) e a posição efêmera no aparelho, exatamente como a intenção fixou.
Fases verificáveis
- Tracer — régua pura do clamp — quota ~0,4 dia.
CardPhotoClamp,resolveCardPhotoAnchor/isUsableCardFace; X = união e Y = hoje emclampCardPhotoTransform/cardPhotoDrawRect/panCardPhotoTransform/zoomCardPhotoTransform; units novos. Prova:pnpm gate:fastverde; asserts existentes seguem valendo (só muda a forma das chamadas que passamminZoom); unit pina: com rosto na referência 103 o intervalo X tem largura 489 e a viagem a partir do centro é ≈±244,5; o alcance de hoje é subconjunto do novo num grid de fontes/zooms/âncoras; âncora mais larga que a janela → byte a byte o clamp de hoje; Y idêntico;clamp(clamp(t)) = clamp(t). - Threading — hook → composer → render — quota ~0,3–0,4 dia.
readycombbox/face; memo da âncora no composer; contexto no arrasto/setas/teclado/zoom;TeamCardRenderArgs.anchorBox; testes de render com/sem âncora. Prova:pnpm gate:fastverde; unit do render; no browser (engine real + stub): com rosto, arrastar até a caixa do rosto tocar a borda da janela, sem snap do write-back e com zoom/harmonização/CTA intactos; sem rosto, o alcance é ao menos o de hoje; modelos quadrado/retangular com pan/zoom/slider como antes. - Gates + changelog — quota ~0,2 dia. e2e frontend local (
pnpm test:e2e --no-deps -- tests/e2e/frontend.e2e.spec.ts), changelog,pnpm gate:fast,pnpm push. Prova: S14/S15/S17/S18 verdes sem edição (slidernoface=1,ok<0.5e amostra harmonizada intactos); fixture de console/5xx intacta; card baixável.
Rabbit holes / Não escopo (engenharia)
- Colisão geométrica contra as caixas dos rostos dos candidatos / margens para "não chegar perto" — rejeitada na D2 com números; a barreira do gate é a janela.
- Clipar o corpo do visitante na janela — contraria a Cena 3 (o corpo pode avançar sobre ombros).
- Ancorar o eixo Y, "centralizar" por controle novo, ou qualquer mudança de gesto/controle.
- Re-detectar/rastrear o rosto durante o pan/zoom (já rabbit hole da intenção/S18); persistir a âncora; telemetria.
- Mudar o enquadramento inicial,
frameCardPhotoOnBbox,renderPhotoCard, o slider (piso 0.2/teto 4), a arte-mestre, os banners, a janela{286,439,592,577}ou a referência 103. - Generalizar a âncora para os 3 modelos de foto (não têm recorte/rosto) e criar tipo
CardPhotoAnchorsó por pureza. - Novo modo de stub ou e2e novo (D7); resolver o débito adiado do "piso duplicado em composer/render" (S18) sem gatilho.
- Migration/Consent/access/int; copy nova; estado de erro novo.
Riscos e mitigação
- Write-back desfaz o alcance / enquadramento inicial mexido → inicial usa o clamp de hoje sem âncora; pan/zoom/render usam o mesmo contexto; união nunca remove transform de hoje; units de idempotência e de superconjunto; e2e do slider como guarda de integração.
- Corpo saindo da janela (gap de arte atrás) → a base
team-card-base.pngé 100% opaca e a referênciateam-card-example.jpgjá tem sobreposição leve; o gap lê como céu/arte (mesmo look do proporcional S18). Craft nos dois extremos; gatilho de revisão: se o craft reprovar a estética da borda, aplicar uma margem pequena medida na âncora (decisão de produto no gate, não silenciosa). - Rosto de candidato coberto no extremo → limite registrado: a barreira aprovada é a janela, não colisão por caixa (D2). Gatilho: UAT com fotos reais; se um rosto de candidato sumir de forma inaceitável, item sucessor com margem/exclusões de candidato.
- Sem rosto com alcance pior → propriedade de superconjunto unit-testada num grid; quando a silhueta é maior que a janela,
anchorXnão existe e o clamp de hoje roda literal. - Render e pan divergirem → uma função, um contexto;
cardPhotoDrawRecte o retorno do render com o mesmoanchorBox; unit de render com/sem âncora; e2e S18 cobre o caminho real com os dois ramos. - Zoom: em zoom alto o rosto pode não caber na janela →
anchorXvazio → hoje; em zoom baixo a âncora abre ainda mais o alcance; limites do slider intocados. Craft de pan → zoom → pan. - Colisão de nome (
anchorpivô × âncora de enquadramento) →anchorBox; comentário no tipo e nos call sites. - Regressão dos 3 modelos / knip → contexto omitido = default exato;
renderPhotoCardintocado; S13/S15 unit e e2e sem edição; exports novos todos consumidos. - E2E/hermeticidade → nenhum fetch/log/async novo; stub intocado; guard de console intacto.
- Performance → aritmética por pointermove; âncora resolvida uma vez por recorte (memo); sem custo perceptível.
Triagem de débitos (simplify — 2 revisores paralelos)
| ID | Resumo | Origem | Score | Tipo | Destino |
|---|---|---|---|---|---|
| S1 | Rosto do MediaPipe pode vir fora da fonte → hull podia abrir gap | simplify/estrut. | 3 | cheap_polish | já_resolvido |
| S2 | x/y NaN na face viraria offset NaN |
simplify/qual. | 3 | cheap_polish | já_resolvido |
| S3 | anchorOffsetRange sem dizer que é o eixo X |
simplify/qual. | 1 | cheap_polish | já_resolvido |
| S4 | 244.5 mágico e grid "nunca pior" prometido viravam 2 casos |
simplify/qual. | 2 | cheap_polish | já_resolvido |
| S5 | Asserção tautológica desenho == retorno no teste do render | simplify/qual. | 1 | cheap_polish | já_resolvido |
| S6 | Piso do time duplicado composer/render (débito S18) | simplify/ambos | 2 | defer_trigger | descartar |
| S7 | useMemo do photoClamp dispensável |
simplify/qual. | 1 | cheap_polish | descartar |
| S8 | e2e não mede o curso em pixels (seam novo) | simplify/estrut. | 1 | cheap_polish | descartar |
- Já resolvido no simplify (não reabrir): S1 (guarda de ranges disjuntos em
clampPhotoOffset+ teste), S2 (isUsableCardFaceexigex/y/width/heightfinitos), S3 (anchorXOffsetRange+ doc), S4 (curso derivado de(TEAM_WINDOW.width − REFERENCE) / 2+ grid de zooms/âncoras/offsets), S5 (asserções cross-contexto). - Explicitamente fora: S6 — já é débito registrado na S18 (
docs/plans/cards-time-de-voce-escala-cabeca-impl.md, gatilho "piso duplicado em composer e render"); o render segue dono do piso do time nesta entrega. S7 — memo barato que estabiliza as deps do efeito. S8 — decidido na D7 (unit pina a régua; e2e pina a integração sem seam novo). - Defer com gatilho:
readLargestFaceBoxcopiaoriginX/originYcrus do detector; o clamp novo torna a exposição inofensiva (fallback), mas o enquadramento S18 ainda usa a caixa crua. Gatilho: um UAT/craft com rosto cortado na borda mostrando enquadramento ruim, ou o próximo item que tocarreadLargestFaceBox— aí clampar à fonte antes de enquadrar.
Aceite de engenharia
- Aceite de produto da intenção ainda coberto: a caixa do rosto alcança as bordas da janela (curso ≈489px, ≈±244px do centro inicial); sem controle novo; inicial centrado e S18 intocados; 3 modelos, banners, harmonização, troca de foto e download intocados; sem rosto nunca pior que hoje; 100% no aparelho.
- Invariantes AGENTS/engineering-standards: math pura/client-safe em
src/lib(sem DOM); identificadores em inglês, copy pt-BR; sem migration/Consent/access/int; knip/cycles verdes; arte-mestre intocada;pnpm gate:fast+ e2e da superfície +pnpm push. - Testes de domínio previstos: unit do clamp com âncora (união, superconjunto, curso ±244,5, Y, idempotência) e do
renderTeamCardcom/semanchorBox; e2e existente reusaok/noface; int não se aplica (client-side, sem DB/access/escrita multi-collection).
Self-score decision-quality: 5/5
- Decisões caras com rejeitadas: API do contexto (A–D), regra do X (A–D), fallback da silhueta (A–D), Y (A–D), threading/write-back (A–C), state/âncora (A–C) e e2e (A–C) — todas com Opções/Recomendação/Rejeitadas; o barato (nome do campo, literais) fica como fill-in.
- Cabe no appetite: ≤1 dia em 3 fases, sem migration/infra; a régua pura vem primeiro (tracer) e o threading depois, com o fallback preservado por construção.
- Rabbit holes nomeados: colisão por caixa, clip do corpo, âncora em Y, re-detecção, e2e/seam novo, generalização para os 3 modelos.
- Depth check: reusa
clampPhotoOffset/coverScale/CardAlphaBbox, oCardCutoutResult/hook, o contexto deminZoomjá existente e o padrão de options dozoomCardPhotoTransform; nada de abstração nova além da função pura de âncora e sem tipo redundante. - Intenção preservada: outcome e aceite intactos (curso ≈2×, sem controle novo, inicial/S18 intocados, fallback nunca pior, privacidade); a engenharia só resolveu o que a intenção deixou em aberto (fórmula, fallback, Y, API) e registrou o limite da barreira dos candidatos.