teqo-backup/docs/plans/agenda-remover-aviso-vazio-impl.md
Francisco Solla d5d1d0c30e chore(B181): remove o aviso de janela vazia da agenda
Sem bloco 'Nenhum compromisso nesta janela e neste filtro' nem botão
'Criar atividade' acima do calendário: a criação segue pelo slot click
(C91), botão dos filtros e FAB. buildActivityCreateHref permanece com
2 consumidores. Teste unitário de regressão + impl plan + changelog.
2026-08-09 09:34:25 -03:00

83 lines
4.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Impl: B181 — Agenda: remover o aviso "Nenhum compromisso nesta janela e neste filtro"
Status: aprovado
Atualizado em: 2026-08-09
Issue: #480
Intenção: docs/plans/agenda-remover-aviso-vazio.md
Appetite restante: herdado (~0,5 dia eng; item de ~20 min de diff)
## Leitura da intenção
- **Outcome:** janela sem compromissos na `/campanha/agenda` não exibe mais o bloco
"Nenhum compromisso nesta janela e neste filtro" + botão "Criar atividade", em nenhuma
largura de tela; o calendário começa no topo da área; nada novo entra na tela.
- **O que NÃO negociar:** não substituir o aviso por outro empty-state; não mudar affordances
de criação (slot click C91, FAB C94, botão dos filtros); loading e erro permanecem; texto
interno do FullCalendar (`noEventsText`, vista "Lista") fica (questão em aberto A).
- **O que reavaliar:** a intenção previa que `buildActivityCreateHref` pudesse ficar órfão —
**não fica**: `ActivityInlineCreate.tsx:111` ("Mais detalhes") e `ActivityAgendaFilters.tsx:144`
(botão "Nova atividade" desktop) seguem usando. Só o uso local em `ActivityAgenda` sai.
## Abordagem recomendada
Remoção cirúrgica de um bloco JSX + seus órfãos locais no único componente que o renderiza.
Sem mudança em `activityUi.ts`, sem migration, sem mudança de acesso.
**Opções consideradas:** A | B
**Recomendação:** A — remover só o bloco no `ActivityAgenda.tsx` e os imports locais que
ficam órfãos. É o menor diff que mantém o aceite; os caminhos de criação permanecem todos.
**Rejeitadas:** B — remover também `noEventsText` do FullCalendar (vista "Lista"). A intenção
recomenda manter (opção A da questão em aberto): é contexto in-loco da lista vazia, não um
header que rouba espaço no mobile, e sair dela expandiria o escopo deste chore sem pedido.
### Componentes / mudanças
- **`ActivityAgenda`** (`src/components/campaign/activity/ActivityAgenda.tsx`):
- remover o bloco `!isLoading && !loadError && events.length === 0` (linhas 306–313);
- remover `const emptyHref = buildActivityCreateHref(state)` (linha 277) — órfão;
- remover `import Link from 'next/link'` (linha 21) — único uso era o `<Link>` do bloco;
- remover `buildActivityCreateHref` do import de `@/utilities/activityUi` (linha 42);
- manter `Button` (usado no bloco de erro, linha 295), `activity-agenda-notice` CSS
(loading 287 + erro 293) e `noEventsText="Nenhum compromisso nesta janela"` (343).
- **`activityUi.ts`** (`src/utilities/activityUi.ts`): **sem mudança** —
`buildActivityCreateHref` continua com 2 consumidores.
- **`ActivityAgendaFilters.tsx` / `ActivityInlineCreate.tsx`**: sem mudança — os botões de
criação que o aceite exige manter.
- **Migration:** sem migration (nenhuma coleção/global/campo tocado).
- **Access / Consent:** sem mudança.
- **UI:** Impeccable A — remoção de elemento; nenhum shape/craft necessário. A classe
`.activity-agenda-notice` permanece no CSS porque loading/erro continuam usando-a.
## Fases verificáveis
1. **Diff** — edição do `ActivityAgenda.tsx` (remoção do bloco + 3 órfãos de import).
2. **Teste de regressão** — novo `it` em `tests/unit/activityAgendaInteractions.unit.spec.tsx`:
janela vazia (`loadEvents` → `[]`) não renderiza mais "Nenhum compromisso nesta janela e
neste filtro" nem botão "Criar atividade", e o slot-click (C91) segue abrindo o inline
create. Os testes existentes já renderizam com `[]`, então nenhum outro muda.
3. **Gates** — `pnpm gate:fast` (inclui tsc, lint, knip, ciclos, testes unit+int);
`pnpm push` para fechar (inclui gates completos; knip valida que não sobrou órfão).
## Rabbit holes / Não escopo (engenharia)
- Não mexer no `noEventsText` (vista "Lista") — fora de escopo, questão em aberto A.
- Não "melhorar" o topo da agenda nem o empty-state da grade (`dayGrid`/`timeGrid` vazios
mostram a grade vazia do FullCalendar — comportamento desejado, é o "calendário no topo").
- Não tocar em outros empty-states do `/campanha`.
- Não extrair nada para helper novo — remover é o oposto de abstrair.
## Riscos e mitigação
- **Órfãos de import/knip:** removidos no mesmo edit (`Link`, `buildActivityCreateHref`);
`pnpm gate:fast`/knip confirma.
- **Regressão de affordance de criação:** nenhum botão de criação é removido — só o do
aviso, que some junto com ele; filtros (desktop) e inline create (C91) intactos, ambos
cobertos por testes existentes (unit + e2e).
- **Estado "janela vazia" no teste unitário:** o mock do FullCalendar já exercita `[]`;
o novo `it` usa o mesmo mock sem mudança.
## Aceite de engenharia
- [ ] Aceite de produto da intenção ainda coberto (janela vazia sem aviso; nada novo na tela)
- [ ] Invariantes AGENTS/engineering-standards (nenhum access/Consent/transação tocado)
- [ ] Testes de domínio previstos (unit) onde o comportamento visual muda