Envio de resultado de pesquisaSurvey result uploadEnvío de resultado de encuesta

Envio de resultado de pesquisa é a transação de saída que persiste no backend as respostas de uma pesquisa. É disparada pelo SurveyAnswerNotifier quando o representante de vendas finaliza o fluxo de resposta. A leitura das pesquisas é cache-only (proto getSurveys); a escrita não usa esse proto — o resultado vai como JSON pelo Dispatcher. As respostas do rep vivem num sealed class escrito à mão (SurveyAnswerValue) e são convertidas direto em JSON no builder. Survey result upload is the outbound transaction that persists a survey's answers in the backend. It's fired by SurveyAnswerNotifier when the sales rep finishes the answering flow. Reading surveys is cache-only (proto getSurveys); the write does not use that proto — the result goes as JSON through the Dispatcher. The rep's answers live in a hand-written sealed class (SurveyAnswerValue) and are converted straight to JSON in the builder. Envío de resultado de encuesta es la transacción de salida que persiste en el backend las respuestas de una encuesta. La dispara SurveyAnswerNotifier cuando el representante de ventas finaliza el flujo de respuesta. La lectura de encuestas es cache-only (proto getSurveys); la escritura no usa ese proto — el resultado va como JSON por el Dispatcher. Las respuestas del rep viven en un sealed class escrito a mano (SurveyAnswerValue) y se convierten directo a JSON en el builder.

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 (pedido, price check, survey, etc.) 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 (order, price check, survey, etc.) 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 (pedido, price check, survey, etc.) usa este mismo sendTransaction; lo que cambia es el serviceName (discriminador) y el JSON dentro de message.

Para survey, resendMayDuplicate == true: um reenvio (ex.: recuperação de fila offline) pode duplicar o resultado no backend; a idempotência via tid é o que mitiga isso.For survey, resendMayDuplicate == true: a resend (e.g. offline-queue recovery) may duplicate the result on the backend; idempotency via tid is what mitigates it.Para survey, resendMayDuplicate == true: un reenvío (p. ej. recuperación de cola offline) puede duplicar el resultado en el backend; la idempotencia vía tid es lo que lo mitiga.

Uma única transação, sem variantes de tipo: o builder sempre emite DispatcherType.survey. O que se ramifica é o número de envelopes (por evidências) e o status do resultado (concluído vs. em andamento).A single transaction, with no type variants: the builder always emits DispatcherType.survey. What branches is the number of envelopes (by evidences) and the result status (complete vs. in progress).Una única transacción, sin variantes de tipo: el builder siempre emite DispatcherType.survey. Lo que se ramifica es el número de envelopes (por evidencias) y el status del resultado (completo vs. en curso).

A transação é orquestrada pelo fluxo de resposta de pesquisa (remote-first, §36). O notifier apenas reúne entities cruas e valores injetados; o builder é o dono único de todo join, rename, formatação de data e derivação wire. A cascata:The transaction is orchestrated by the survey-answering flow (remote-first, §36). The notifier only gathers raw entities and injected values; the builder is the sole owner of every join, rename, date formatting and wire derivation. The cascade:La transacción se orquesta desde el flujo de respuesta de encuesta (remote-first, §36). El notifier solo reúne entities crudas y valores inyectados; el builder es el dueño único de todo join, rename, formateo de fecha y derivación wire. La cascada:

• SurveyAnswerNotifiersubmit()
  • reúne entities cruas + injetadosgathers raw entities + injectedreúne entities crudas + inyectadosSurveyResultUploadDispatcherPayloadInput
    • buildAll()BuildSurveyResultUploadDispatcherPayloadUseCasemonta o wireassembles the wirearma el wire
      • devolve ≤3 evid./envelopereturns ≤3 evid./envelopedevuelve ≤3 evid./envelopeList<DispatcherEnvelope>
        • SubmitSurveyResultUploadUseCaseDispatcherOrchestrator
          • serializa + authserialize + authserializa + authDispatcherGateway
            • sendTransactionBackendgRPC

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

SurveyResultUploadDispatcherPayloadInput (Freezed). Carrega o dado como existe no domínio; nada de formato wire. O relógio chega como submittedAt (via DateTimeUtils.now()); as evidências chegam com o arquivo já lido em base64.SurveyResultUploadDispatcherPayloadInput (Freezed). Carries data as it exists in the domain; no wire shaping. The clock arrives as submittedAt (via DateTimeUtils.now()); evidences arrive with the file already read as base64.SurveyResultUploadDispatcherPayloadInput (Freezed). Lleva el dato como existe en el dominio; nada de formato wire. El reloj llega como submittedAt (vía DateTimeUtils.now()); las evidencias llegan con el archivo ya leído en base64.

SurveyResultUploadEvidence (Freezed, aninhado): questionSfid · base64 · fileName — todos String.SurveyResultUploadEvidence (Freezed, nested): questionSfid · base64 · fileName — all String.SurveyResultUploadEvidence (Freezed, anidado): questionSfid · base64 · fileName — todos String.

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

Raiz do payloadPayload rootRaíz del payload

• surveyResult objeto únicosingle objectobjeto único 5 camposfieldscampos

  Campo JSON	TipoTypeTipo	Origem do DadoData sourceOrigen del Dato	RegraRuleRegla
  surveyCode	string	input.surveyCode	—
  surveyID	string	input.survey.sfid	—
  storeID	string	input.visit.accountData.sfid	sfid do varejo da visitavisit retail's sfidsfid del punto de venta de la visita
  visitID	string	input.visit.sfid	—
  surveyStatus	string	status.value	completesResultOnUpload ? "Complete" : "In Progress"completesResultOnUpload ? "Complete" : "In Progress"completesResultOnUpload ? "Complete" : "In Progress"

  • surveyResultdetails por respostaper answerpor respuesta 6 camposfieldscampos

    Uma entrada por resposta em input.answers — exceto SurveyOptionAnswer, que gera uma entrada por opção selecionada. Todas as entradas vêm de _detailRow.One entry per answer in input.answers — except SurveyOptionAnswer, which yields one entry per selected option. All entries come from _detailRow.Una entrada por respuesta en input.answers — excepto SurveyOptionAnswer, que genera una entrada por opción seleccionada. Todas las entradas vienen de _detailRow.

    Campo JSON	TipoTypeTipo	Origem do DadoData sourceOrigen del Dato	RegraRuleRegla
    surveyCode	string	input.surveyCode	—
    surveyQuestion	string	questionSfid	a chave da entrada em input.answersthe entry key in input.answersla clave de la entrada en input.answers
    questionAnswerOption	string	Calculado	opção → optionsBySfid[optionSfid].questionAnswerOptionSfid ?? ""; texto/número/data → _firstOptionSfid (1ª opção da pergunta) (ver Regras)option → optionsBySfid[optionSfid].questionAnswerOptionSfid ?? ""; text/number/date → _firstOptionSfid (question's 1st option) (see Rules)opción → optionsBySfid[optionSfid].questionAnswerOptionSfid ?? ""; texto/número/fecha → _firstOptionSfid (1ª opción de la pregunta) (ver Reglas)
    score	string	Fixo: "0"	contrato · inertecontract · inertcontrato · inerte
    surveyResult	string	Fixo: ""	contrato · inertecontract · inertcontrato · inerte
    actualAnswer	string	Calculado	opção → ""; texto → answer.text; número → answer.value.toString(); data → answer.date em dd/MM/yyyyoption → ""; text → answer.text; number → answer.value.toString(); date → answer.date as dd/MM/yyyyopción → ""; texto → answer.text; número → answer.value.toString(); fecha → answer.date en dd/MM/yyyy

  • evidenceList por evidênciaper evidencepor evidencia 3 camposfieldscampos

    Uma entrada por SurveyResultUploadEvidence em input.evidences (já fatiado em ≤ 3 pelo buildAll).One entry per SurveyResultUploadEvidence in input.evidences (already sliced to ≤ 3 by buildAll).Una entrada por SurveyResultUploadEvidence en input.evidences (ya cortado a ≤ 3 por buildAll).

    Campo JSON	TipoTypeTipo	Origem do DadoData sourceOrigen del Dato	RegraRuleRegla
    base64	string	evidence.base64	arquivo (foto/documento) já lido em base64 pelo notifierfile (photo/document) already read as base64 by the notifierarchivo (foto/documento) ya leído en base64 por el notifier
    questionSfid	string	evidence.questionSfid	pergunta a que a evidência pertencequestion the evidence belongs topregunta a la que pertenece la evidencia
    fileName	string	evidence.fileName	.replaceAll("'", "") — apóstrofos removidos do nome.replaceAll("'", "") — apostrophes stripped from the name.replaceAll("'", "") — apóstrofos removidos del nombre

O que o builder ainda não preenche ou envia inerte, documentado fiel ao estado atual do código (nunca descrito como se já existisse):What the builder does not yet fill, or ships inert, documented faithfully to the current code state (never described as already existing):Lo que el builder aún no completa, o envía inerte, documentado fiel al estado actual del código (nunca descrito como si ya existiera):