Documento de Requisitos — Criar tabela para armazenar histórico

Tarefa: #196018 Contexto: Sequência de implementação #1

---

Visão Geral

Criar a tabela CartRecommendationsHistory no banco DbCoreOrg para servir como repositório central do histórico de eventos de upsell, correlacionados por RecommendationsId.

Papéis Envolvidos

Papel	Responsabilidade
Desenvolvedor Back-end	Criar Model, Mapping, Migration e schema da tabela

Requisitos Funcionais

RF-01 — Estrutura da tabela CartRecommendationsHistory

História de Usuário: Como desenvolvedor, quero uma tabela para persistir os eventos do fluxo de upsell para que possam ser consultados e correlacionados posteriormente.

Critérios de Aceitação:

1. WHEN a migration for aplicada THEN o sistema SHALL criar a tabela CartRecommendationsHistory no DbCoreOrg
2. WHEN a migration for revertida (down) THEN o sistema SHALL remover a tabela
3. WHEN um registro for inserido THEN o sistema SHALL persistir todas as colunas do schema

Model e Mapping:

• Localização: Core.OrgDB/Entities/CartRecommendationsHistoryModel.cs e Core.OrgDB/Data/Mappings/CartRecommendationsHistoryMapping.cs
• Deve herdar de BaseEntity e implementar IAggregateRoot

Schema:

Coluna	Tipo	Null	Descrição
Id	int PK IDENTITY	NOT NULL	Herdado de BaseEntity
DateCreated	DateTime	NOT NULL	Herdado de BaseEntity
DateDeleted	DateTime?	NULL	Herdado de BaseEntity
DateUpdated	DateTime?	NULL	Herdado de BaseEntity
RecommendationsId	uniqueidentifier	NOT NULL	UUID gerado pelo BFF; correlaciona todos os eventos de uma mesma venda
EventType	nvarchar(100)	NOT NULL	Tipo de evento que gerou o registro
CartId	int	NULL	Id do carrinho/zzlink. Nulo no evento RecommendationRequested
CustomerId	int	NOT NULL	Id do cliente
CodeStore	string	NOT NULL	Código da loja
Url	string	NULL	Endpoint da integração externa chamada, se houver
Request	json	NULL	Payload usado na integração
Response	json	NULL	Payload retornado pela integração
StatusCode	int?	NULL	HTTP Status Code retornado pela integração externa
DurationMs	long?	NULL	Tempo total do request em milissegundos
Message	string	NULL	Observação opcional

Eventos (escopo desta entrega):

Evento	Descrição
RecommendationRequested	Requisição de recomendação recebida pelo BFF
RecommendationCartCreated	Carrinho criado a partir de recomendação
RecommendationProductAddedToOrder	Produto recomendado adicionado ao pedido
RecommendationProductRemovedToOrder	Produto recomendado removido do pedido

Casos de Borda:

• CartId é nulo apenas para RecommendationRequested — o cart ainda não foi criado neste momento
• StatusCode, Url e DurationMs são nulos para eventos sem chamada a integração externa
• Colunas de BaseEntity mantidas no schema por padrão; DateDeleted e DateUpdated não são populadas por se tratar de tabela append-only

RF-02 — Indexação

Critérios de Aceitação:

1. WHEN a migration for aplicada THEN o sistema SHALL criar índice em RecommendationsId
2. WHEN a migration for aplicada THEN o sistema SHALL criar índice em CartId

RF-03 — Criação do Model e Mapping

Critérios de Aceitação:

1. WHEN o Model for criado THEN o sistema SHALL herdar de BaseEntity com construtor vazio para EF
2. WHEN o Model for criado THEN o sistema SHALL implementar IAggregateRoot
3. WHEN o Mapping for criado THEN o sistema SHALL registrar a tabela como CartRecommendationsHistory

Fora de Escopo

• Indexação em CustomerId, EventType, DateCreated ou outros campos
• Limpeza/expurgo de dados antigos
• Constraints de FK para CartId
• Evento RecommendationPDPViewed (será tratado em entrega futura)

Dependências

Dependência	Descrição	Status
DbCoreOrg	Banco de dados existente	Disponível
Coezzion.Common NuGet	BaseEntity, IAggregateRoot	Disponível