Status: Approved · v2.1 · SPEC-UX-NOTIFICATIONS-001
depends_on: SPEC-DOMAIN-NOTIFICATION-001
used_by: IS-MVP-11.4, IS-POST-12.1
Central de notificações e pendências
Central separa vida pessoal de gestão e transforma pendências em ações contextuais seguras.
Objetivo
Central separa vida pessoal de gestão e transforma pendências em ações contextuais seguras.
Pontos de entrada
- Aba Notificações.
- Badge.
- Push/deep link futuro.
Hierarquia da tela
- Tabs Pessoal e Gestão.
- Filtros não lidas/todas/arquivadas.
- Gestão agrupada por entidade.
- Cards com categoria, prioridade, contexto, prazo e CTA.
- Settings acessíveis no header.
Componentes e comportamento
Notification Card
Título, resumo, tempo, entidade, status e CTA; finanças usam texto neutro.
Management Group
Header de entidade e contadores.
Pending Action
CTA executa endpoint do domínio e lida com already resolved/expired.
Sugestão celebrativa pós-MVP
A notificação exibe entidade/evento e abre um detalhe com preview completo do card. Aprovar publicação é uma confirmação explícita e separada de abrir/marcar como lida; Rejeitar resolve sem publicar e Arquivar apenas retira da lista padrão. A sugestão não possui expiração temporal automática e permanece acessível até uma dessas decisões, com revalidação no momento da ação.
Settings
Categorias e canais; push ainda simulado.
Ações do usuário
| Ação | Pré-condição | Resultado | Falha/alternativa |
|---|---|---|---|
| Abrir | — | Target route | Unavailable |
| Marcar lida | Own | Read | Idempotente |
| Arquivar | Own | Archived | — |
| Executar CTA | Permission/state | Ação do domínio | Expired/conflict |
| Abrir sugestão celebrativa | Destinatário atual | Preview do card sem publicar | Permission lost/target unavailable |
| Aprovar publicação sugerida | Preview e confirmação | Cria post no feed e resolve notificação | Revalidar privacy/snapshot/permission |
| Ler todas | Scope | Read | — |
Estados obrigatórios
| Estado | Representação | Ação disponível |
|---|---|---|
| Empty personal | Mensagem neutra | — |
| Empty management | Sem pendências | — |
| Expired action | Card histórico sem CTA | Abrir contexto |
| Permission lost | Conteúdo limitado | Voltar |
| Loading/error | Skeleton/retry | Retry |
Autenticação e permissões
- Gestão por permission atual.
- Conteúdo sensível pode ser ocultado após revogação.
Responsividade
- Mobile grupos em accordion/lista.
- Desktop pode usar lista e painel de detalhe.
Acessibilidade
- Prioridade textual.
- Badges anunciados.
- CTA com contexto.
Eventos de produto e observabilidade
- notifications_viewed
- notification_opened
- notification_read
- pending_action_executed
- notification_settings_changed
Dados e endpoints
- Notifications e settings.
- Endpoints de domínio para actions.
Critérios de aceite
- Pessoal/gestão separados.
- Agrupamento por entidade.
- Ações revalidadas.
- Expired e permission lost tratados.
Pós-MVP
- Push real, e-mail e digest.
Decisões registradas
- Pendência é notification acionável.
- Sugestão celebrativa usa o modelo de central persistente popularizado por redes sociais: badge de não lida, histórico após leitura, ação contextual e arquivamento; não depende de push nem de TTL curto.
Machine summary
spec: SPEC-UX-NOTIFICATIONS-001
screen_or_flow: Central de notificações e pendências
required_states:
- loading
- success
- empty
- error
must_use:
- contracts
- service
- hook
- design_tokens
must_not:
- direct_fetch
- direct_fixture_import
- hardcoded_brand_colors