RelatóriosReportsReportes

Clean Architecture + Riverpod + Freezed + ObjectBox. Feature somente leitura (nenhuma escrita/Dispatcher). Duas frentes: a tela-índice (dirigida por End Market Configuration) e as duas telas de relatório (cada uma com Notifier próprio que agrega dados cruzando Report + Pedidos).Clean Architecture + Riverpod + Freezed + ObjectBox. Read-only feature (no write/Dispatcher). Two fronts: the index screen (driven by End Market Configuration) and the two report screens (each with its own Notifier aggregating data by joining Report + Orders).Clean Architecture + Riverpod + Freezed + ObjectBox. Feature solo lectura (sin escritura/Dispatcher). Dos frentes: la pantalla-índice (dirigida por End Market Configuration) y las dos pantallas de reporte (cada una con su Notifier que agrega datos cruzando Report + Pedidos).

Índice · dirigido por EMCIndex · EMC-drivenÍndice · dirigido por EMC

A ReportsPage não tem Notifier. Lê o MarketConfiguration (com o reportsConfig) e o currentResourceProvider (tipo do representante), e chama reportsConfig.visibleOptionsFor(repType:) para decidir os cartões:ReportsPage has no Notifier. It reads the MarketConfiguration (with reportsConfig) and currentResourceProvider (rep type), and calls reportsConfig.visibleOptionsFor(repType:) to decide the cards:ReportsPage no tiene Notifier. Lee el MarketConfiguration (con reportsConfig) y el currentResourceProvider (tipo de representante), y llama reportsConfig.visibleOptionsFor(repType:) para decidir las tarjetas:

• MarketConfigurationreportsConfig · EMC
  • + currentResource.resourceTypevisibleOptionsFor(repType:)→ List<ReportType>
    • optionsReportsOptionsListWidget
      • → UIReportsPage

Relatório · agregação Report + PedidosReport · Report + Orders aggregationReporte · agregación Report + Pedidos

Cada tela de relatório tem seu Notifier. O UseCase busca o Report (referências) no ReportRepository e os Pedidos no OrderRepository, cruza notas fiscais por invoiceSfid e produz uma entity derivada (lista ou contagens). Origem padrão = cache local; o refresh() força source: remote:Each report screen has its Notifier. The UseCase fetches the Report (references) from ReportRepository and Orders from OrderRepository, joins invoices by invoiceSfid and produces a derived entity (list or counts). Default origin = local cache; refresh() forces source: remote:Cada pantalla de reporte tiene su Notifier. El UseCase busca el Report (referencias) en ReportRepository y los Pedidos en OrderRepository, cruza facturas por invoiceSfid y produce una entity derivada (lista o conteos). Origen por defecto = caché local; el refresh() fuerza source: remote:

• ReportRepositoryReport · cache/remote
  • getReport + OrderRepository.getOrdersGetDeliveryStatusReportUseCase
    · GetDailySummaryReportUseCasejoin por invoiceSfid
    • execute(source)DeliveryStatusReportEntity
      · DailySummaryReportEntityderivada
      • _load / guardedBuildReportDeliveryStatusNotifier
        · ReportDailySummaryNotifier
        • → UIReportDeliveryStatusPage
          · ReportDailySummaryPage

O dado persistido — o Report — existe em quatro representações ligadas por mappers, com cache write-through: Proto (wire gRPC) → DTO (Freezed) → Model (ObjectBox) → Entity (domínio). Mas o Report guarda apenas listas de referência (sfids de notas fiscais, pedidos e pagamentos), não os números que a tela mostra.The persisted data — the Report — exists in four representations linked by mappers, with write-through cache: Proto (gRPC wire) → DTO (Freezed) → Model (ObjectBox) → Entity (domain). But Report holds only reference lists (invoice, order and payment sfids), not the numbers the screen shows.El dato persistido — el Report — existe en cuatro representaciones unidas por mappers, con caché write-through: Proto (wire gRPC) → DTO (Freezed) → Model (ObjectBox) → Entity (dominio). Pero Report guarda solo listas de referencia (sfids de facturas, pedidos y pagos), no los números que la pantalla muestra.

Os números vêm de duas entities derivadas — DeliveryStatusReport e DailySummaryReport — calculadas nos UseCases a partir do Report + Pedidos em cache. Elas não têm proto/DTO/Model e não são persistidas. A seguir, na ordem: o proto de origem, as estruturas persistidas campo-a-campo por camada, as estruturas derivadas, os mappers e os deltas.The numbers come from two derived entities — DeliveryStatusReport and DailySummaryReport — computed in the UseCases from the Report + cached Orders. They have no proto/DTO/Model and are not persisted. Next, in order: the origin proto, the persisted structures field-by-field per layer, the derived structures, the mappers and the deltas.Los números vienen de dos entities derivadas — DeliveryStatusReport y DailySummaryReport — calculadas en los UseCases a partir del Report + Pedidos en caché. No tienen proto/DTO/Model y no se persisten. A continuación, en orden: el proto de origen, las estructuras persistidas campo a campo por capa, las estructuras derivadas, los mappers y los deltas.

Proto

ReportConectaRep.proto · proto3 · package mn.bat.conectarep.streambridge. Um único método unário. O Reply é rico, mas só parte é mapeada (ver Estruturas abaixo e as Pendências acima).ReportConectaRep.proto · proto3 · package mn.bat.conectarep.streambridge. A single unary method. The Reply is rich, but only part is mapped (see Structures below and Pending above).ReportConectaRep.proto · proto3 · package mn.bat.conectarep.streambridge. Un único método unario. El Reply es rico, pero solo parte se mapea (ver Estructuras abajo y Pendientes arriba).

Estruturas de dadosData structuresEstructuras de datos

Um dropdown por estrutura persistida. Colunas Proto · DTO · Model · Entity; o delta (texto azul) marca onde o tipo primeiro muda. ¹ = optional/injetado no proto.One dropdown per persisted structure. Columns Proto · DTO · Model · Entity; the delta (blue text) marks where the type first changes. ¹ = optional/injected in the proto.Un dropdown por estructura persistida. Columnas Proto · DTO · Model · Entity; el delta (texto azul) marca dónde primero cambia el tipo. ¹ = optional/inyectado en el proto.

• Report raiz 5 campos

  Campo	Proto	DTO	Model	Entity
  lastSyncAt	—	DateTime¹	DateTime	DateTime
  issuedInvoices	repeated ReportInvoiceReference	List<…DTO>	ToMany<…Model>	List<…Entity>
  orders	repeated ReportOrderReference	List<…DTO>	ToMany<…Model>	List<…Entity>
  digitalOrders	repeated ReportOrderReference	List<…DTO>	ToMany<…Model>	List<…Entity>
  paymentSfids	payments.paymentSfids	List<String>	List<String>	List<String>

  • ReportInvoiceReference Report.issuedInvoices[] 2 campos

    Campo	Proto	DTO	Model	Entity
    invoiceSfid	string	String	String	String
    invoiceLineSfids	repeated string	List<String>	List<String>	List<String>

  • ReportOrderReference Report.orders[] · digitalOrders[] 2 campos

    Campo	Proto	DTO	Model	Entity
    orderSfid	string	String	String	String
    orderLineSfids	repeated string	List<String>	List<String>	List<String>

Estruturas derivadas (só domínio)Derived structures (domain-only)Estructuras derivadas (solo dominio)

Montadas nos UseCases; sem proto/DTO/Model. Uma coluna só (Entity).Built in the UseCases; no proto/DTO/Model. Single column (Entity).Construidas en los UseCases; sin proto/DTO/Model. Una sola columna (Entity).

• DeliveryStatusReport GetDeliveryStatusReportUseCase 2 campos

  Campo	Entity	OrigemSourceOrigen
  lastSyncAt	DateTime	report.lastSyncAt
  items	List<DeliveryStatusReportItemEntity>	um item por nota fiscal com pedido em cacheone item per invoice with a cached orderun ítem por factura con pedido en caché

  • DeliveryStatusReportItem DeliveryStatusReport.items[] 5 campos

    Campo	Entity	OrigemSourceOrigen
    invoiceSfid	String	reference.invoiceSfid
    invoiceNumber	String	order.invoice.invoiceNumber
    legalNumber	String	order.invoice.legalNumber ?? ""
    deliveryStatus	DeliveryStatus	order.deliveryStatusType
    accountName	String	order.accountName

• DailySummaryReport GetDailySummaryReportUseCase 8 campos

  Campo	Entity	Como é calculadoHow it's computedCómo se calcula
  lastSyncAt	DateTime	report.lastSyncAt
  issuedCount	int	notas com status pending/not deliveredinvoices with pending/not deliveredfacturas con pending/not delivered
  deliveredCount	int	notas com deliveredinvoices with deliveredfacturas con delivered
  returnedCount	int	notas com rejectedinvoices with rejectedfacturas con rejected
  rescheduledCount	int	notas com rescheduledinvoices with rescheduledfacturas con rescheduled
  totalCount	int	total de notas com pedido em cachetotal invoices with a cached ordertotal de facturas con pedido en caché
  totalValue	double	soma de invoice.total das entreguessum of delivered invoice.totalsuma de invoice.total de las entregadas
  ticketInstallmentsCount	int	parcelas PaymentMode.bankSlip das entreguesPaymentMode.bankSlip installments of deliveredcuotas PaymentMode.bankSlip de las entregadas

Mappers

ReportRepositoryInterface / ReportRepositoryImpl. Só leitura de dado da feature (o save* é cache-writer após fetch). O getReport escolhe a origem por uma árvore de decisão embutida.ReportRepositoryInterface / ReportRepositoryImpl. Feature-data reads only (the save* is a cache-writer after fetch). getReport picks the origin via an embedded decision tree.ReportRepositoryInterface / ReportRepositoryImpl. Solo lectura de dato de la feature (el save* es cache-writer tras el fetch). getReport elige el origen por un árbol de decisión embebido.

• getReport({DataSourceType source = local}) Result<ReportEntity, Failure>

  Decide a origem e resolve o locationHierarchySfid via currentResourceProvider (§25):Decides the origin and resolves locationHierarchySfid via currentResourceProvider (§25):Decide el origen y resuelve locationHierarchySfid vía currentResourceProvider (§25):

  • useMock ou source == mock → _fetchFromMock (mock → salva cache).useMock or source == mock → _fetchFromMock (mock → save cache).useMock o source == mock → _fetchFromMock (mock → guarda caché).
  • source == local ou offline → _fetchFromCacheOrFail (cache; NetworkFailure se vazio).source == local or offline → _fetchFromCacheOrFail (cache; NetworkFailure if empty).source == local u offline → _fetchFromCacheOrFail (caché; NetworkFailure si vacío).
  • senão → _fetchFromRemoteWithFallback (remote → salva cache; em erro, cai pro cache).else → _fetchFromRemoteWithFallback (remote → save cache; on error, falls back to cache).si no → _fetchFromRemoteWithFallback (remote → guarda caché; en error, cae al caché).
• getCachedReport() Result<ReportEntity?, Failure>

  Lê o Report do ObjectBox (pode ser null).Reads the Report from ObjectBox (may be null).Lee el Report de ObjectBox (puede ser null).

• getCachedReportLastSyncAt() DateTime?

  Só o lastSyncAt em cache (sem falhar — retorna null em erro).Just the cached lastSyncAt (never fails — returns null on error).Solo el lastSyncAt en caché (sin fallar — retorna null en error).

• saveReport({required ReportEntity entity}) Result<void, Failure>

  Cache-writer: limpa e regrava o Report local após um fetch bem-sucedido.Cache-writer: clears and rewrites the local Report after a successful fetch.Cache-writer: limpia y regraba el Report local tras un fetch exitoso.

Três datasources. Remote e Mock são de método único; Local é CRUD de cache.Three datasources. Remote and Mock are single-method; Local is cache CRUD.Tres datasources. Remote y Mock son de método único; Local es CRUD de caché.

A tela-índice (ReportsPage) não tem Notifier — lê providers direto (marketConfigurationProvider, currentResourceProvider e um FutureProvider privado só para o lastSyncAt). As duas telas de relatório têm um Notifier cada, ambos AsyncNotifier com o mixin AsyncGuard (§37): build chama guardedBuild(_load); refresh() re-roda _load(source: remote) via runGuarded, sem AsyncValue.loading (o pull-to-refresh tem indicador próprio).The index screen (ReportsPage) has no Notifier — it reads providers directly (marketConfigurationProvider, currentResourceProvider and a private FutureProvider just for lastSyncAt). The two report screens have one Notifier each, both AsyncNotifier with the AsyncGuard mixin (§37): build calls guardedBuild(_load); refresh() re-runs _load(source: remote) via runGuarded, without AsyncValue.loading (pull-to-refresh has its own indicator).La pantalla-índice (ReportsPage) no tiene Notifier — lee providers directamente (marketConfigurationProvider, currentResourceProvider y un FutureProvider privado solo para el lastSyncAt). Las dos pantallas de reporte tienen un Notifier cada una, ambos AsyncNotifier con el mixin AsyncGuard (§37): build llama guardedBuild(_load); refresh() re-ejecuta _load(source: remote) vía runGuarded, sin AsyncValue.loading (el pull-to-refresh tiene su propio indicador).

MétodosMethodsMétodos

State disponível para a PageState available to the PageState disponible para la Page

Três pages, todas em AppPageShell com displayBackButton e sem drawer. Não há modais.Three pages, all in AppPageShell with displayBackButton and no drawer. No modals.Tres pages, todas en AppPageShell con displayBackButton y sin drawer. No hay modales.

• ReportsPage índiceindexíndice
  • DataLoadInfo
  • ReportsHeaderWidget ícone + títuloicon + titleícono + título
  • ReportsOptionsListWidget
    • CustomNavigationCard um por opção; toca → AppRouter.goToReport*one per option; tap → AppRouter.goToReport*uno por opción; toca → AppRouter.goToReport*
• ReportDeliveryStatusPage
  • CustomPullToRefresh
    • DataLoadInfo
    • ReportsHeaderWidget
    • ReportSectionTitleWidget
    • ReportInfoHeaderCard Usuário + DataUser + DateUsuario + Fecha
    • ReportDeliveryItemCardWidget um por item, ou CustomEmptyStateone per item, or CustomEmptyStateuno por ítem, o CustomEmptyState
• ReportDailySummaryPage
  • CustomPullToRefresh
    • DataLoadInfo
    • ReportsHeaderWidget
    • ReportSectionTitleWidget
    • ReportInfoHeaderCard
    • ReportDailySummaryCardWidget 7 linhas de contagem7 count rows7 filas de conteo