Versionar ofertas e gerar Offer Passport

Problema / Contexto

A oferta precisa ser uma verdade versionada (Offer + OfferVersion). O Offer Passport é a página única que resume essa verdade para uso no fit.

História de usuário

Como dono da oferta, quero manter versões da oferta e um passaporte de uma página, para que o fit use sempre uma verdade atual e rastreável.

Comportamento esperado

  1. Criar Offer e OfferVersion com promessa genérica, necessidade e resultado pretendidos.
  2. Registrar capacidades, evidências, pré-requisitos do cliente, restrições do vendedor, exclusões e anti-fit.
  3. Gerar o Offer Passport a partir da versão.
  4. Aprovar a versão antes do uso em E3.

Papel da IA

  • IA sugere: estruturar o passaporte e apontar lacunas e conflitos.
  • Humano valida: dono da oferta aprova a versão.

Regras de negócio

  • RN1: OfferVersion aprovada não é editada; mudanças geram nova versão.
  • RN2: Versão usada em caso histórico permanece consultável.
  • RN3: Passaporte é projeção, não fonte canônica.

Dados envolvidos

  • offer_version — versão — sim — decisão humana
  • anti_fit — lista — não — decisão humana
  • passport_snapshot — projeção — sim — fato

Critérios de aceite

  • Dado OfferVersion aprovada, quando alguém altera a promessa, então uma nova versão é criada e a antiga é preservada.
  • Dado oferta sem aprovação, quando o E3 busca candidatas, então a oferta não aparece como elegível.

Exceções e erros

  • Conflito entre campos gera OfferConflict e revisão.

Fora de escopo

  • CPQ completo.
  • Catálogo público.

Dúvidas em aberto

  • Definir se OfferValueArchitecture é entidade própria ou parte da versão (ADR).

Histórico

DataO que mudouQuemReferência
2026-09-16Criado a partir da análise v0.3 × requisitosJulioAnálise v0.3 × Requisitos
2026-09-16Revisado pelas sócias após adoção do v0.3; status → aprovadoJulioDEC-007 Adoção do Sales Intelligence v0.3