Resposta de smart investmentSmart investment answerRespuesta de smart investment

Resposta de smart investment é uma transação de saída disparada pelo fluxo de encerramento de visita (VisitEndNotifier). O builder é minimalista: um único objeto JSON com quatro identificadores planos e um array answer derivado dos KPIs de smart investment da própria visita. Não há variantes nem prefixo Promo_. Smart investment answer is an outbound transaction fired by the visit-closing flow (VisitEndNotifier). The builder is minimal: a single JSON object with four flat identifiers and an answer array derived from the visit's own smart investment KPIs. There are no variants and no Promo_ prefix. Respuesta de smart investment es una transacción de salida disparada por el flujo de cierre de visita (VisitEndNotifier). El builder es minimalista: un único objeto JSON con cuatro identificadores planos y un array answer derivado de los KPIs de smart investment de la propia visita. No hay variantes ni prefijo Promo_.

DispatcherConectaRep.proto · proto3 · package mn.bat.conectarep.dispatcher. O serviço expõe um único RPC genérico — não existe mensagem por transação. TODA transação de escrita do app usa este mesmo sendTransaction; o que muda é o serviceName (discriminador) e o JSON dentro de message.The service exposes a single generic RPC — there's no per-transaction message. EVERY write transaction in the app uses this same sendTransaction; what changes is the serviceName (discriminator) and the JSON inside message.El servicio expone un único RPC genérico — no existe mensaje por transacción. TODA transacción de escritura de la app usa este mismo sendTransaction; lo que cambia es el serviceName (discriminador) y el JSON dentro de message.

Para esta transação, resendMayDuplicate == true: ela não está no conjunto lightweight (notificationRead, answerTask, priceCheck), então um reenvío (ex.: recuperação de fila offline) pode duplicar a resposta no backend; a idempotência via tid é o que mitiga isso.For this transaction, resendMayDuplicate == true: it is not in the lightweight set (notificationRead, answerTask, priceCheck), so a resend (e.g. offline-queue recovery) may duplicate the answer on the backend; idempotency via tid is what mitigates it.Para esta transacción, resendMayDuplicate == true: no está en el conjunto lightweight (notificationRead, answerTask, priceCheck), por lo que un reenvío (p. ej. recuperación de cola offline) puede duplicar la respuesta en el backend; la idempotencia vía tid es lo que lo mitiga.

A transação é orquestrada pelo VisitEndNotifier.finishVisit(). O notifier apenas reúne entities cruas e o relógio; o builder é o dono único da derivação do resourceSfid, da formatação da data e da montagem do array answer. A resposta é enviada antes da atualização de status da visita (visitContextProvider.endVisit()), e uma falha no envio não bloqueia o encerramento. A cascata:The transaction is orchestrated by VisitEndNotifier.finishVisit(). The notifier only gathers raw entities and the clock; the builder is the sole owner of deriving resourceSfid, formatting the date and assembling the answer array. The answer is sent before the visit status update (visitContextProvider.endVisit()), and a send failure doesn't block the closing. The cascade:La transacción se orquesta por VisitEndNotifier.finishVisit(). El notifier solo reúne entities crudas y el reloj; el builder es el dueño único de la derivación del resourceSfid, del formateo de la fecha y del armado del array answer. La respuesta se envía antes de la actualización de estado de la visita (visitContextProvider.endVisit()), y una falla en el envío no bloquea el cierre. La cascada:

• VisitEndNotifierfinishVisit()
  • reúne entities cruas + relógiogathers raw entities + clockreúne entities crudas + relojSmartInvestmentAnswerDispatcherPayloadInput
    • build()BuildSmartInvestmentAnswerDispatcherPayloadUseCasemonta o wireassembles the wirearma el wire
      • devolvereturnsdevuelveDispatcherEnvelope
        • SubmitSmartInvestmentAnswerUseCaseDispatcherOrchestrator
          • serializa + authserialize + authserializa + authDispatcherGateway
            • sendTransactionBackendgRPC

O input (entities cruas)The input (raw entities)El input (entities crudas)

SmartInvestmentAnswerDispatcherPayloadInput (Freezed). Carrega o dado como existe no domínio; nada de formato wire. O relógio chega como submittedAt (via DateTimeUtils.now()); o rep marca as conclusões em completedKpiIds.SmartInvestmentAnswerDispatcherPayloadInput (Freezed). Carries data as it exists in the domain; no wire shaping. The clock arrives as submittedAt (via DateTimeUtils.now()); the rep marks completions in completedKpiIds.SmartInvestmentAnswerDispatcherPayloadInput (Freezed). Lleva el dato como existe en el dominio; nada de formato wire. El reloj llega como submittedAt (vía DateTimeUtils.now()); el rep marca las conclusiones en completedKpiIds.

O JSON serializado no campo message do request. A tabela tem 4 colunas — Campo JSON · Tipo · Origem do Dado · Regra — e lista toda chave que o build() emite (5 no raiz + 2 por item de answer). Campo, Tipo e Origem são código cru; só a Regra é prosa. Um exemplo completo (BR) está em transaction_example.json, ao lado deste doc.The JSON serialized into the request's message field. The table has 4 columns — JSON field · Type · Data source · Rule — and lists every key that build() emits (5 at the root + 2 per answer item). Field, Type and Source are raw code; only Rule is prose. A full example (BR) sits in transaction_example.json, next to this doc.El JSON serializado en el campo message del request. La tabla tiene 4 columnas — Campo JSON · Tipo · Origen del Dato · Regla — y lista toda clave que build() emite (5 en la raíz + 2 por ítem de answer). Campo, Tipo y Origen son código crudo; solo la Regla es prosa. Un ejemplo completo (BR) está en transaction_example.json, junto a este doc.

Raiz do payloadPayload rootRaíz del payload

• answer[] um objeto por KPIone object per KPIun objeto por KPI 2 camposfieldscampos

  Campo JSON	TipoTypeTipo	Origem do DadoData sourceOrigen del Dato	RegraRuleRegla
  kpi	string	kpi.kpiName	nome de exibição do KPI (rótulo do backend) — não o idthe KPI's display name (backend label) — not the idel nombre de visualización del KPI (etiqueta del backend) — no el id
  isCompleted	bool	input.completedKpiIds.contains(kpi.id)	true se o rep marcou o KPI (por id) como concluído; senão falsetrue if the rep marked the KPI (by id) as completed; else falsetrue si el rep marcó el KPI (por id) como concluido; si no false

serviceName

Sempre SmartInvestmentAnswer — type.resolveServiceName(hasPromotion: false) é chamado com false fixo, então nunca há prefixo Promo_.Always SmartInvestmentAnswer — type.resolveServiceName(hasPromotion: false) is called with a hardcoded false, so there's never a Promo_ prefix.Siempre SmartInvestmentAnswer — type.resolveServiceName(hasPromotion: false) se llama con false fijo, así que nunca hay prefijo Promo_.

resourceSfid

Derivado no builder: primaryResourceSfid quando resource.isPrimaryResource, senão secondaryResourceSfid — identifica quem fez o registro (§25/§36).Derived in the builder: primaryResourceSfid when resource.isPrimaryResource, else secondaryResourceSfid — identifies who made the record (§25/§36).Derivado en el builder: primaryResourceSfid cuando resource.isPrimaryResource, si no secondaryResourceSfid — identifica quién hizo el registro (§25/§36).

answer

O array espelha todos os KPIs do painel de smart investment da visita — inclusive os não concluídos (isCompleted: false). Se a visita não tem painel, o array é [].The array mirrors all KPIs of the visit's smart investment dashboard — including the incomplete ones (isCompleted: false). If the visit has no dashboard, the array is [].El array refleja todos los KPIs del panel de smart investment de la visita — incluidos los no concluidos (isCompleted: false). Si la visita no tiene panel, el array es [].

Gate de disparoFire gateGate de disparo

No VisitEndNotifier, o envio só ocorre quando completedKpiIds != null (o rep interagiu com a lista). Se o rep nunca abre a lista, _sendSmartInvestmentAnswer retorna sem despachar.In VisitEndNotifier, the send only happens when completedKpiIds != null (the rep interacted with the list). If the rep never opens the list, _sendSmartInvestmentAnswer returns without dispatching.En VisitEndNotifier, el envío solo ocurre cuando completedKpiIds != null (el rep interactuó con la lista). Si el rep nunca abre la lista, _sendSmartInvestmentAnswer retorna sin despachar.

Falha não bloqueiaFailure doesn't blockFalla no bloquea

A resposta é enviada antes de endVisit(). Se falhar, o Failure é guardado no state (smartInvestmentFailure) mas o encerramento da visita segue mesmo assim.The answer is sent before endVisit(). On failure, the Failure is stored in state (smartInvestmentFailure) but the visit closing proceeds anyway.La respuesta se envía antes de endVisit(). Si falla, el Failure se guarda en el state (smartInvestmentFailure) pero el cierre de la visita continúa igual.

O que fica de fora ou merece atenção, documentado fiel ao estado atual do código (nunca descrito como se já existisse):What's left out or worth noting, documented faithfully to the current code state (never described as already existing):Lo que queda afuera o merece atención, documentado fiel al estado actual del código (nunca descrito como si ya existiera):