Auditoria de imagem de merchandisingMerchandising image auditAuditoría de imagen de merchandising

Auditoria de imagem de merchandising é a transação de saída que envia as fotos das peças do PDV ao backend, via o Dispatcher. É disparada pelo fluxo de merchandising quando o representante de vendas conclui e envia uma auditoria de imagem. As fotos são a fonte; o resultado é uma auditoria que passa a aparecer na feature de Merchandising. Merchandising image audit is the outbound transaction that sends the store's piece photos to the backend, through the Dispatcher. It's fired by the merchandising flow when the sales rep finishes and submits an image audit. The photos are the source; the result is an audit that then shows up in the Merchandising feature. Auditoría de imagen de merchandising es la transacción de salida que envía las fotos de las piezas del PDV al backend, vía el Dispatcher. Se dispara desde el flujo de merchandising cuando el representante de ventas termina y envía una auditoría de imagen. Las fotos son la fuente; el resultado es una auditoría que luego aparece en la feature de Merchandising.

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.

Envio bloqueado offline (NetworkException) e reautenticação automática numa falha unauthenticated (reenvia uma vez com token renovado). Com mock ligado, o gateway devolve um ack simulado sem tocar a rede.Send is blocked offline (NetworkException) and re-authentication is automatic on an unauthenticated failure (resends once with a refreshed token). With mock on, the gateway returns a simulated ack without hitting the network.Envío bloqueado offline (NetworkException) y reautenticación automática ante un fallo unauthenticated (reenvía una vez con token renovado). Con mock activo, el gateway devuelve un ack simulado sin tocar la red.

Esta transação tem uma única variante: um DispatcherType → um serviceName, sem split e sem prefixo Promo_ (resolveServiceName(hasPromotion: false)). O ponto de atenção é a nomenclatura em três nomes diferentes para a mesma coisa:This transaction has a single variant: one DispatcherType → one serviceName, no split and no Promo_ prefix (resolveServiceName(hasPromotion: false)). The thing to watch is the three different names for the same thing:Esta transacción tiene una única variante: un DispatcherType → un serviceName, sin split y sin prefijo Promo_ (resolveServiceName(hasPromotion: false)). El punto de atención es la nomenclatura en tres nombres distintos para lo mismo:

A transação é orquestrada pelo notifier da tela de auditoria de imagem (remote-first, §36). O notifier reúne entities cruas e valores injetados; o builder é o dono único de todo rename, formatação e derivação wire. A cascata:The transaction is orchestrated by the image-audit screen's notifier (remote-first, §36). The notifier gathers raw entities and injected values; the builder is the sole owner of every rename, formatting and wire derivation. The cascade:La transacción se orquesta desde el notifier de la pantalla de auditoría de imagen (remote-first, §36). El notifier reúne entities crudas y valores inyectados; el builder es el dueño único de todo rename, formateo y derivación wire. La cascada:

• MerchandisingImageAuditNotifiersubmit()
  • reúne entities cruas + injetadosgathers raw entities + injectedreúne entities crudas + inyectadosRetailAuditUploadDispatcherPayloadInput
    • build()BuildRetailAuditUploadDispatcherPayloadUseCasemonta o wireassembles the wirearma el wire
      • devolvereturnsdevuelveDispatcherEnvelope
        • SubmitRetailAuditUploadUseCaseDispatcherOrchestrator+ histórico+ history+ historial
          • send()DispatcherRepository
            • serializa + authserialize + authserializa + authDispatcherGateway
              • sendTransactionBackendgRPC

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

RetailAuditUploadDispatcherPayloadInput (Freezed). Carrega o dado como existe no domínio; nada de formato wire. O relógio chega como submittedAt (DateTimeUtils.now()) e o transactionReference como REF-{uuid}, ambos injetados pelo notifier; as fotos já chegam como base64 (I/O resolvido no notifier via captureService.readAsBase64).RetailAuditUploadDispatcherPayloadInput (Freezed). Carries data as it exists in the domain; no wire shaping. The clock arrives as submittedAt (DateTimeUtils.now()) and the transactionReference as REF-{uuid}, both injected by the notifier; the photos arrive already as base64 (I/O resolved in the notifier via captureService.readAsBase64).RetailAuditUploadDispatcherPayloadInput (Freezed). Lleva el dato como existe en el dominio; nada de formato wire. El reloj llega como submittedAt (DateTimeUtils.now()) y el transactionReference como REF-{uuid}, ambos inyectados por el notifier; las fotos llegan ya como base64 (I/O resuelto en el notifier vía captureService.readAsBase64).

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 (4 na raiz + 5 por peça = 9 no total). 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. Each table below has 4 columns — JSON field · Type · Data source · Rule — and lists every key that build() emits (4 at the root + 5 per piece = 9 total). 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. Cada tabla abajo tiene 4 columnas — Campo JSON · Tipo · Origen del Dato · Regla — y lista toda clave que build() emite (4 en la raíz + 5 por pieza = 9 en total). 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

• pieces[] por fotoper photopor foto 5 camposfieldscampos

  Para cada RetailAuditPieceInput, o builder emite uma entrada de frente (frontImageBase64, sempre) e — só se backImageBase64 != null — uma de tras. Ambas repetem id e pieceType; diferem em type, filename e imageBase64.For each RetailAuditPieceInput, the builder emits one frente entry (frontImageBase64, always) and — only if backImageBase64 != null — one tras. Both repeat id and pieceType; they differ in type, filename and imageBase64.Para cada RetailAuditPieceInput, el builder emite una entrada frente (frontImageBase64, siempre) y — solo si backImageBase64 != null — una tras. Ambas repiten id y pieceType; difieren en type, filename e imageBase64.

  Campo JSON	TipoTypeTipo	Origem do DadoData sourceOrigen del Dato	RegraRuleRegla
  id	int	piece.id	id da peça (mesmo valor na frente e no verso da mesma peça)piece id (same value on a piece's front and back)id de la pieza (mismo valor en el frente y el dorso de la misma pieza)
  type	string	Fixo: "frente" / "tras"	face da foto — literais wire em português (_frontType / _backType)photo face — Portuguese wire literals (_frontType / _backType)cara de la foto — literales wire en portugués (_frontType / _backType)
  filename	string	Calculado	"peca_{id}_{type}.jpg" (extensão fixa jpg)"peca_{id}_{type}.jpg" (fixed jpg extension)"peca_{id}_{type}.jpg" (extensión fija jpg)
  imageBase64	string	piece.frontImageBase64 / backImageBase64	conteúdo base64 da foto (resolvido no notifier)the photo's base64 content (resolved in the notifier)contenido base64 de la foto (resuelto en el notifier)
  pieceType	string	piece.brand?.value ?? ""	marca (MerchandisingPieceBrand.value): BAT/PMI/JTI/Peça própria; "" quando sem marcabrand (MerchandisingPieceBrand.value): BAT/PMI/JTI/Peça própria; "" when no brandmarca (MerchandisingPieceBrand.value): BAT/PMI/JTI/Peça própria; "" cuando sin marca

O que o builder/transporte ainda envia inerte ou provisório, documentado fiel ao estado atual do código (nunca descrito como se já existisse):What the builder/transport still ships inert or provisional, documented faithfully to the current code state (never described as already existing):Lo que el builder/transporte aún envía inerte o provisional, documentado fiel al estado actual del código (nunca descrito como si ya existiera):