mirror of https://github.com/fsolla/teqo.git synced 2026-11-15 02:23:07 +00:00

Francisco Solla 51fb715ec7 feat(C101): agenda mobile com cara de app nativo — contexto no header, swipe, filtro sticky, dia na hora atual

- toolbar do FullCalendar some no mobile; título do header mostra o período
  ("9 Agosto", "3–9 Agosto", "Agosto", "Agenda") e tap volta ao hoje
- navegação por arrasto horizontal (useAgendaSwipeNavigation): limiar 48px,
  claim 12px com preventDefault, touchcancel sintético contra o long-press
  do FC, dateClick do dia suprimido (C91/C15 intactos)
- filtro vira strip edge-to-edge sem rótulo, sticky sob a barra do app
  (containing block via :has no padding do scroll container)
- visão de dia com scroll interno (height fixa), 08:00 na abertura,
  cabeçalho do dia fixo, scroll preservado ao trocar de dia
- desktop inalterado; impl plan + plano pós-critique (C101-ux)

2026-08-09 22:09:47 -03:00

3.1 KiB

Raw Permalink Blame History

Impl: Agenda mobile — affordance do "voltar ao hoje" + navegação por teclado (pós-C101)

Status: rascunho Atualizado em: 2026-08-09 Issue: #C101-ux Intenção: docs/plans/c101-agenda-mobile-calendario-nativo.md Appetite: ~0,5 dia eng (fill-in pós-entrega)

Leitura do lote

Outcome: no mobile da agenda, (1) usuários de teclado/AT conseguem navegar entre períodos mesmo com a toolbar do FullCalendar escondida (C101), e (2) o tap no título do header ("voltar ao hoje") tem uma pista visual — hoje só existe title (hover), invisível no toque.
O que NÃO negociar: desktop intacto (toolbar continua mandando lá); swipe continua sendo o gesto primário; C91 (tap cria inline) e C15 (arrasto de remanejo) intactos; nada de segunda barra de controles.
O que reavaliar: se o FullCalendar já entrega navegação por setas no grid focado (FC tem seleção por teclado interna) — talvez baste expor/focar o grid, sem handler próprio.

Fases verificáveis

a11y (primeiro): teclado no mobile — ArrowLeft/ArrowRight navegam dia/semana/mês conforme a vista. Investigar o teclado interno do FC antes de criar handler próprio; se FC já navega com o grid focado, garantir que o foco chegue lá (o container tem tabIndex?). Teste unitário + e2e com page.keyboard.
UX: pista visual do tap-no-título — opções: chip "Hoje" discreto ao lado do título no top bar (só na agenda mobile) | ícone de calendário | nada além do affordance de botão. Validar no gate (Impeccable B/C).
Gates: pnpm gate:fast na iteração; pnpm push na entrega.

Rabbit holes / Não escopo

Redesenhar a top bar; mudar o swipe; segunda barra; desktop; outras listas.

Riscos e mitigação

Handler próprio de teclado pode conflitar com o teclado interno do FC (seleção de célula) — verificar primeiro; se conflitar, restringir o handler a quando o foco está fora do grid.
Chip "Hoje" no top bar disputa espaço com [Semana ▾][sino] — medir no browser antes.

Já resolvido no simplify (não reabrir)

Contrato onTitleClick: { action, hint } no chrome compartilhado (copy da agenda não vaza para o componente genérico).
Helper compartilhado de rótulos de período (tests/e2e/helpers/agendaPeriodLabels.ts).
Sticky real do strip; suppress do dateClick no claim; guarda de resize; anchor civil do mês (incl. bug de parse UTC).
Robustez do e2e (poll, tolerâncias, scroller ancorado, stubMatchMedia).

Explicitamente fora (descartes + defers com gatilho deste triage)

Defer: validação do interplay pan-y × pointercancel em device real — gatilho: antes de qualquer evolução do gesto de swipe (o e2e CDP cobre o caminho Chromium, não o Safari/WebKit).
Descartados: variável CSS do budget de altura (P3); flash de hidratação do título (padrão B167 existente); nota de meia-noite nos e2e (documentada); side-effect do harness de teste (P3).

Aceite de engenharia

Teclado navega períodos no mobile sem conflitar com a seleção interna do FC
Tap no título comunica a ação sem depender de hover
Desktop, swipe, C91 e C15 intactos; gates verdes

3.1 KiB Raw Permalink Blame History Unescape Escape