195746 - User Story
Metadados
| Campo | Valor |
|---|---|
| Tipo | User Story |
| Título | zzlink - Registro de eventos/indicadores do Upsell |
| Estado | New |
| Iteração | ZZAPPS\Vendas\VENDAS SPRINT 12 2026 |
| Área | ZZAPPS\Vendas |
| Atribuído a | Weslei Dornelles Morais |
| Prioridade | 2 |
| Criado em | 09/06/2026 |
| Última alteração | 11/06/2026 19:38 (Altamir Benkenstein) |
| Revisões | 19 |
Descrição
Problema: Não há visibilidade sobre o comportamento dos usuários no fluxo de upsell, dificultando a mensuração da efetividade da funcionalidade e a identificação de pontos de abandono.
Contexto as-is: O fluxo de upsell está implementado no zzapp/zzportal (carrinho) e no zzlink (pedido), mas não há registro estruturado de eventos e indicadores que permitam acompanhar:
Carrinho (zzapp/zzportal):
- QTD de requisições, timeout e sucesso
- QTD de carrinhos que iniciaram o fluxo com upsell mas não geraram o pedido com ele
Pedido (zzlink):
- Adicionou o produto no carrinho
- Removeu item recomendado do carrinho
- Acessou a PDP (v2)
Objetivo: Implementar o registro de eventos e indicadores para o fluxo de upsell, permitindo a mensuração e análise da efetividade da funcionalidade em todas as etapas do funil.
Pré-refinamento: context/pre-refinamento.md
Dependências e Observações
- Cobertura de endpoints: todos os endpoints envolvidos com upsell devem receber o
RecommendationsIdna requisição. - Frentes impactadas: App e Portal — ambos devem repassar o
RecommendationsIdrecebido do BFF ao criar o carrinho. - Sequência sugerida de implementação:
- Criar tabela
CartRecommendationsHistory(DbCoreOrg) - Criar fila SQS FIFO (Message BUS)
- Criar serviço de histórico (API Cart)
- Alterar
POST api/cartpara receberRecommendationsId(API Cart) - Alterar endpoint de recomendação no BFF (gerar
RecommendationsId, publicar na fila) - Ajustar Front App e Portal para trafegar o
RecommendationsId
- Criar tabela
Critérios de Aceite
Escopo:
- zzlink (pedido)
Critérios de implementação (nível macro):
- Registrar eventos de adição, remoção e visualização PDP no fluxo de upsell do zzlink
- Expor indicadores de requisição, timeout e sucesso no carrinho
Tarefas Filhas
| # | ID | Título | Atribuído a | Tipo | Estado |
|---|---|---|---|---|---|
| 01 | 196018 | [Back][DbCoreOrg] Criar tabela para armazenar histórico | — | Task | New |
| 02 | 196020 | [Back][Message Bus] Criar fila para centralizar a gravação do histórico | — | Task | New |
| 03 | 196021 | [Back][API Cart] Serviço de Registro de Histórico | — | Task | New |
| 04 | 196022 | [Back][API Cart] Alterar POST api/cart | — | Task | New |
| 05 | 196023 | [Back][API BFF] Consulta de Produtos Recomendados | — | Task | New |
| 06 | 196024 | [Front][App] Passar a receber o RecommendationsId | — | Task | New |
| 07 | 196025 | [Front][Portal] Passar a receber o RecommendationsId | — | Task | New |
Code Reviews
| Review | Escopo | Data | Status |
|---|---|---|---|
| — | — | — | — |