Reconhecimento de imagem de merchandisingMerchandising image recognitionReconocimiento de imagen de merchandising

Reconhecimento de imagem de merchandising é a transação de saída que envia as fotos capturadas na visita para o backend, sob o serviceName ServiceMerchanAudit. É disparada pelo notifier da tela de reconhecimento de imagem quando o rep confirma o envio. O payload é enxuto: identificação do rep e da conta, mais um array de fotos (contagem, data, rótulo, base64). Merchandising image recognition is the outbound transaction that sends the photos captured on the visit to the backend, under the ServiceMerchanAudit serviceName. It's fired by the image-recognition screen's notifier when the rep confirms the send. The payload is lean: rep and account identification, plus an array of photos (count, date, label, base64). Reconocimiento de imagen de merchandising es la transacción de salida que envía las fotos capturadas en la visita al backend, bajo el serviceName ServiceMerchanAudit. Se dispara desde el notifier de la pantalla de reconocimiento de imagen cuando el rep confirma el envío. El payload es escueto: identificación del rep y de la cuenta, más un array de fotos (conteo, fecha, etiqueta, base64).

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.

Esta transação tem um único serviceName e não tem variantes. O DispatcherType.imageRecognitionAudit resolve para ServiceMerchanAudit; como a transação nunca carrega promoção, o builder chama resolveServiceName(hasPromotion: false) — nunca há prefixo Promo_. O destination do tipo é none (sem roteamento de destino downstream no app).This transaction has a single serviceName and no variants. DispatcherType.imageRecognitionAudit resolves to ServiceMerchanAudit; since the transaction never carries a promotion, the builder calls resolveServiceName(hasPromotion: false) — there's never a Promo_ prefix. The type's destination is none (no downstream destination routing in the app).Esta transacción tiene un único serviceName y no tiene variantes. DispatcherType.imageRecognitionAudit resuelve a ServiceMerchanAudit; como la transacción nunca lleva promoción, el builder llama resolveServiceName(hasPromotion: false) — nunca hay prefijo Promo_. El destination del tipo es none (sin ruteo de destino downstream en la app).

A transação é orquestrada pelo MerchandisingImageRecognitionNotifier.submit(). O notifier apenas reúne entities cruas e valores injetados (resource, sfid/código da conta, relógio, fotos + base64 já lidos); o builder é o dono único da derivação do repSfid, formatação de data e montagem do array de itens. A cascata:The transaction is orchestrated by MerchandisingImageRecognitionNotifier.submit(). The notifier only gathers raw entities and injected values (resource, account sfid/code, clock, photos + base64 already read); the builder is the sole owner of the repSfid derivation, date formatting and item-array assembly. The cascade:La transacción se orquesta desde MerchandisingImageRecognitionNotifier.submit(). El notifier solo reúne entities crudas y valores inyectados (resource, sfid/código de la cuenta, reloj, fotos + base64 ya leídos); el builder es el dueño único de la derivación del repSfid, formateo de fecha y armado del array de ítems. La cascada:

• MerchandisingImageRecognitionNotifiersubmit()
  • lê base64 + reúne entities cruasreads base64 + gathers raw entitieslee base64 + reúne entities crudasMerchandisingImageRecognitionDispatcherPayloadInput
    • build()BuildMerchandisingImageRecognitionDispatcherPayloadUseCasemonta o wireassembles the wirearma el wire
      • devolvereturnsdevuelveDispatcherEnvelope
        • SubmitMerchandisingImageRecognitionUseCaseDispatcherOrchestrator
          • serializa + authserialize + authserializa + authDispatcherGateway
            • sendTransactionBackendgRPC

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

MerchandisingImageRecognitionDispatcherPayloadInput (Freezed). Carrega o dado como existe no domínio; nada de formato wire. O relógio chega como submittedAt (via DateTimeUtils.now()); os bytes de imagem chegam já lidos como photosBase64, na mesma ordem de photos.MerchandisingImageRecognitionDispatcherPayloadInput (Freezed). Carries data as it exists in the domain; no wire shaping. The clock arrives as submittedAt (via DateTimeUtils.now()); the image bytes arrive already read as photosBase64, in the same order as photos.MerchandisingImageRecognitionDispatcherPayloadInput (Freezed). Lleva el dato como existe en el dominio; nada de formato wire. El reloj llega como submittedAt (vía DateTimeUtils.now()); los bytes de imagen llegan ya leídos como photosBase64, en el mismo orden que photos.

O JSON serializado no campo message do request. As tabelas abaixo têm 4 colunas — Campo JSON · Tipo · Origem do Dado · Regra — e listam toda chave que o build() emite (4 na raiz + 4 por item = 8 no total). 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. The tables below have 4 columns — JSON field · Type · Data source · Rule — and list every key that build() emits (4 at the root + 4 per item = 8 total). 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. Las tablas abajo tienen 4 columnas — Campo JSON · Tipo · Origen del Dato · Regla — y listan toda clave que build() emite (4 en la raíz + 4 por ítem = 8 en total). 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

• items[] um por fotoone per photouno por foto 4 camposfieldscampos

  Campo JSON	TipoTypeTipo	Origem do DadoData sourceOrigen del Dato	RegraRuleRegla
  count	int	Calculado	index + 1 — sequencial 1-based na ordem de capturaindex + 1 — 1-based sequence in capture orderindex + 1 — secuencial 1-based en orden de captura
  datePhotoTaken	string	photo.takenAt	formato dd/MM/yyyy - HH'h'mm (ex.: 17/08/2026 - 14h05)dd/MM/yyyy - HH'h'mm format (e.g. 17/08/2026 - 14h05)formato dd/MM/yyyy - HH'h'mm (p. ej. 17/08/2026 - 14h05)
  label	string	photo.label	.trim() aplicado; "" quando sem rótulo.trim() applied; "" when unlabeled.trim() aplicado; "" cuando sin etiqueta
  imageBase64	string	input.photosBase64[index]	index < photosBase64.length ? photosBase64[index] : "" — guarda de índice; "" se faltarindex < photosBase64.length ? photosBase64[index] : "" — index guard; "" if missingindex < photosBase64.length ? photosBase64[index] : "" — guarda de índice; "" si falta

• Derivação do repSfidrepSfid derivationDerivación del repSfid isPrimaryResource

  • O repSfid é derivado no build() a partir da ResourceEntity crua: rep primário → primaryResourceSfid; secundário → secondaryResourceSfid. O notifier passa a entity inteira; a derivação nunca vive no notifier (CLAUDE.md §36).The repSfid is derived in build() from the raw ResourceEntity: primary rep → primaryResourceSfid; secondary → secondaryResourceSfid. The notifier passes the whole entity; the derivation never lives in the notifier (CLAUDE.md §36).El repSfid se deriva en build() desde la ResourceEntity cruda: rep primario → primaryResourceSfid; secundario → secondaryResourceSfid. El notifier pasa la entity entera; la derivación nunca vive en el notifier (CLAUDE.md §36).
• Alinhamento fotos ↔ base64photos ↔ base64 alignmentAlineación fotos ↔ base64 index guard

  • O loop percorre input.photos por índice; o imageBase64 é pareado por índice com input.photosBase64. Se, por qualquer razão, faltar um base64 no índice (index >= photosBase64.length), o item sai com imageBase64: "" em vez de estourar.The loop walks input.photos by index; imageBase64 is paired by index with input.photosBase64. If, for any reason, a base64 is missing at the index (index >= photosBase64.length), the item ships imageBase64: "" instead of throwing.El loop recorre input.photos por índice; el imageBase64 se empareja por índice con input.photosBase64. Si, por cualquier razón, falta un base64 en el índice (index >= photosBase64.length), el ítem sale con imageBase64: "" en vez de estallar.
  • O count é sempre index + 1 — sequencial 1-based, na ordem em que as fotos foram capturadas (a mesma ordem de photos).The count is always index + 1 — 1-based sequence, in the order the photos were captured (the same order as photos).El count es siempre index + 1 — secuencial 1-based, en el orden en que se capturaron las fotos (el mismo orden que photos).
• Formatação de dataDate formattingFormateo de fecha datePhotoTaken · dateReference

  • datePhotoTaken (por foto): DateTimeUtils.formatDate com DateFormatType.dayMonthYearDashHourLabel → dd/MM/yyyy - HH'h'mm. Data legível da captura (dado do item).datePhotoTaken (per photo): DateTimeUtils.formatDate with DateFormatType.dayMonthYearDashHourLabel → dd/MM/yyyy - HH'h'mm. Human-readable capture date (item data).datePhotoTaken (por foto): DateTimeUtils.formatDate con DateFormatType.dayMonthYearDashHourLabel → dd/MM/yyyy - HH'h'mm. Fecha legible de la captura (dato del ítem).
  • dateReference (do envelope, não do payload): DateTimeUtils.formatDate(dateTime: input.submittedAt) com o formato default isoDate → yyyy-MM-dd. Data wire do envio.dateReference (from the envelope, not the payload): DateTimeUtils.formatDate(dateTime: input.submittedAt) with the default isoDate format → yyyy-MM-dd. Wire submission date.dateReference (del envelope, no del payload): DateTimeUtils.formatDate(dateTime: input.submittedAt) con el formato default isoDate → yyyy-MM-dd. Fecha wire del envío.
• transactionReference accountSfid

  • O transactionReference do envelope é o input.accountSfid — correlaciona o despacho à conta visitada. Não há campo account populado no envelope (fica default null).The envelope's transactionReference is input.accountSfid — it correlates the dispatch to the visited account. There's no account field populated on the envelope (stays default null).El transactionReference del envelope es input.accountSfid — correlaciona el despacho con la cuenta visitada. No hay campo account poblado en el envelope (queda default null).

Estado atual do código, documentado fiel (nunca descrito como se fosse além do que já existe):Current code state, documented faithfully (never described beyond what already exists):Estado actual del código, documentado fiel (nunca descrito más allá de lo que ya existe):