mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-17 12:43:05 +00:00
- 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)
46 lines
3.1 KiB
Markdown
46 lines
3.1 KiB
Markdown
# 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
|
||
|
||
1. **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`.
|
||
2. **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).
|
||
3. **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
|