Conecta PrimeConecta PrimeConecta Prime

Clean Architecture + Riverpod + Freezed + gRPC + ObjectBox. As três telas compartilham uma única base de dados (o agregado PrimeManagement) e um único repository. Há dois fluxos: a leitura (um RPC getPrimeManagement, com cache write-through) e a escrita pontual da troca de forma de pagamento (RPC dedicado changePrimePaymentMethod — não passa pelo Dispatcher).Clean Architecture + Riverpod + Freezed + gRPC + ObjectBox. The three screens share a single data backbone (the PrimeManagement aggregate) and one repository. There are two flows: the read (one RPC getPrimeManagement, with cache write-through) and the targeted write of the payment-method switch (a dedicated RPC changePrimePaymentMethod — it does not go through the Dispatcher).Clean Architecture + Riverpod + Freezed + gRPC + ObjectBox. Las tres pantallas comparten una única base de datos (el agregado PrimeManagement) y un único repository. Hay dos flujos: la lectura (un RPC getPrimeManagement, con cache write-through) y la escritura puntual del cambio de forma de pago (un RPC dedicado changePrimePaymentMethod — no pasa por el Dispatcher).

Leitura · cache + fallback remotoRead · cache + remote fallbackLectura · caché + fallback remoto

O agregado atravessa quatro representações ligadas por mappers, com cache write-through (todo fetch grava no ObjectBox). Os notifiers leem por varejo (getCachedByAccountSfid) ou o agregado inteiro (execute):The aggregate crosses four representations linked by mappers, with cache write-through (every fetch writes to ObjectBox). Notifiers read per retail (getCachedByAccountSfid) or the whole aggregate (execute):El agregado atraviesa cuatro representaciones unidas por mappers, con cache write-through (todo fetch graba en ObjectBox). Los notifiers leen por punto de venta (getCachedByAccountSfid) o el agregado entero (execute):

• PrimeManagementReplygRPC proto
  • toDTOPrimeManagementDTODTO · Freezed
    • toEntityPrimeManagementEntitydomain
      • toModelPrimeManagementModelObjectBox · write-through
        • toEntityPrimeManagementEntitydomain · cache
          • get*GetPrimeManagementUseCase
            • build / _load3 Notifiers + State
              • → UIManagement · Payments · Simulator

Escrita · troca de pagamento (RPC dedicado)Write · payment switch (dedicated RPC)Escritura · cambio de pago (RPC dedicado)

A troca Pix ⇄ boleto chama um RPC dedicado (changePrimePaymentMethod), recebe de volta o PrimePayment atualizado e faz um merge cirúrgico desse único pagamento no cache (não regrava o agregado inteiro); depois o notifier relê o cache:The Pix ⇄ bank slip switch calls a dedicated RPC (changePrimePaymentMethod), gets back the updated PrimePayment and does a surgical merge of that single payment into the cache (it does not rewrite the whole aggregate); then the notifier re-reads the cache:El cambio Pix ⇄ boleto llama un RPC dedicado (changePrimePaymentMethod), recibe de vuelta el PrimePayment actualizado y hace un merge quirúrgico de ese único pago en el caché (no reescribe el agregado entero); luego el notifier relee el caché:

• PrimePaymentCardWidgetUI
  • switchPaymentMethodPrimePaymentsNotifier
    • executeChangePrimePaymentMethodUseCase
      • changePrimePaymentMethodPrimeManagementRepositoryImpl
        • RPCchangePrimePaymentMethodPrimeManagementConectaRepService
          • merge + re-readObjectBox cache → _load→ UI

O agregado Prime existe em quatro representações ao longo das camadas — Proto (wire gRPC) → DTO (Freezed) → Model (ObjectBox) → Entity (domínio) — e cada fronteira é atravessada por um mapper. O fetch é write-through: todo retorno é gravado no ObjectBox e a UI lê do cache. Diferente do modelo de Pedidos, aqui há três particularidades: as datas são parseadas já no DTO (não no Model), dois wrappers de proto (PrimeHub, PrimePerformance) são achatados na conversão, e a lista raiz é renomeada (primeDataByAccount → accountsData).The Prime aggregate exists in four representations across the layers — Proto (gRPC wire) → DTO (Freezed) → Model (ObjectBox) → Entity (domain) — and each boundary is crossed by a mapper. Fetch is write-through: every response is written to ObjectBox and the UI reads from cache. Unlike the Orders model, here there are three quirks: dates are parsed at the DTO (not the Model), two proto wrappers (PrimeHub, PrimePerformance) are flattened in the conversion, and the root list is renamed (primeDataByAccount → accountsData).El agregado Prime existe en cuatro representaciones a lo largo de las capas — Proto (wire gRPC) → DTO (Freezed) → Model (ObjectBox) → Entity (dominio) — y cada frontera se cruza con un mapper. El fetch es write-through: toda respuesta se graba en ObjectBox y la UI lee del caché. A diferencia del modelo de Pedidos, aquí hay tres particularidades: las fechas se parsean ya en el DTO (no en el Model), dos wrappers de proto (PrimeHub, PrimePerformance) se aplanan en la conversión, y la lista raíz se renombra (primeDataByAccount → accountsData).

O container raiz é PrimeManagement (lastSyncAt gerado no mapper + simulator global + accountsData[]). Cada PrimeAccountData carrega o que aquele varejo tem: config do simulador, pagamentos, calendário e períodos de performance (com faixas). Os enums só existem tipados na Entity (PaymentStatus, PaymentMethod); em Proto/DTO/Model trafegam como String. A seguir, na ordem: o proto, as estruturas de dados campo-a-campo por camada, e os mappers.The root container is PrimeManagement (lastSyncAt generated in the mapper + global simulator + accountsData[]). Each PrimeAccountData carries what that retail has: simulator config, payments, calendar and performance periods (with slabs). Enums are only typed in the Entity (PaymentStatus, PaymentMethod); in Proto/DTO/Model they travel as String. Next, in order: the proto, the field-by-field data structures per layer, and the mappers.El container raíz es PrimeManagement (lastSyncAt generado en el mapper + simulator global + accountsData[]). Cada PrimeAccountData lleva lo que ese punto de venta tiene: config del simulador, pagos, calendario y períodos de performance (con franjas). Los enums solo están tipados en la Entity (PaymentStatus, PaymentMethod); en Proto/DTO/Model viajan como String. A continuación, en orden: el proto, las estructuras de datos campo a campo por capa, y los mappers.

Proto

PrimeManagementConectaRep.proto · proto3 · package mn.bat.conectarep.streambridge. Um serviço (PrimeManagementConectaRepService), dois métodos unários — um lê o agregado, o outro troca a forma de pagamento:One service (PrimeManagementConectaRepService), two unary methods — one reads the aggregate, the other switches the payment method:Un servicio (PrimeManagementConectaRepService), dos métodos unarios — uno lee el agregado, el otro cambia la forma de pago:

Estruturas de dadosData structuresEstructuras de datos

Um dropdown por estrutura, aninhados pela hierarquia. Cada tabela tem uma coluna por camada — Proto · DTO · Model · Entity; o texto em destaque marca onde o tipo/nome primeiro muda (parse de data no DTO, achatamento/rename no Proto, relação no Model, enum na Entity).One dropdown per structure, nested by hierarchy. Each table has one column per layer — Proto · DTO · Model · Entity; the accent text marks where the type/name first changes (date parse at the DTO, flatten/rename at the Proto, relation at the Model, enum at the Entity).Un dropdown por estructura, anidados por jerarquía. Cada tabla tiene una columna por capa — Proto · DTO · Model · Entity; el texto destacado marca dónde primero cambia el tipo/nombre (parse de fecha en el DTO, aplanamiento/rename en el Proto, relación en el Model, enum en la Entity).

• PrimeManagement raiz 3 campos

  Campo	Proto	DTO	Model	Entity
  lastSyncAt	— gerado	DateTime	DateTime	DateTime
  simulator	PrimeSimulatorConfig	…DTO?	ToOne<…Model>	…Entity?
  accountsData	repeated primeDataByAccount	List<…DTO>	ToMany<…Model>	List<…Entity>

  • PrimeSimulatorConfig PrimeManagement.simulator · PrimeAccountData.simulatorConfig 5 campos

    Campo	Proto	DTO	Model	Entity
    rangeName	string	String	String	String
    monthlyPayment	double	double	double	double
    factor	double	double	double	double
    limitPercentage	double	double	double	double
    maxPackages	int32	int	int	int

  • PrimeAccountData PrimeManagement.accountsData[] 7 campos

    Campo	Proto	DTO	Model	Entity
    accountSfid	string	String	String	String
    displayPrimePayment	hub.displayPrimePayment	bool	bool	bool
    displayPrimeSimulator	hub.displayPrimeSimulator	bool	bool	bool
    simulatorConfig	PrimeSimulatorConfig	…DTO?	ToOne<…Model>	…Entity?
    payments	repeated PrimePayment	List<…DTO>	ToMany<…Model>	List<…Entity>
    calendar	PrimeCalendar	…DTO?	ToOne<…Model>	…Entity?
    performancePeriods	performance.periods	List<…DTO>	ToMany<…Model>	List<…Entity>

    • PrimePayment PrimeAccountData.payments[] 13 campos

      Campo	Proto	DTO	Model	Entity
      id	string	String	paymentId	String
      dateReference	string	DateTime?	DateTime?	DateTime?
      dateDue	string	DateTime?	DateTime?	DateTime?
      paymentAmount	double	double	double	double
      paymentStatus	string	String	String	PaymentStatus (status)
      paymentMethod	string	String	String	PaymentMethod (method)
      linkTicket	string	String?	String?	String?
      pixKey	string	String?	String?	String?
      qrCodePix	string	String?	String?	String?
      canDownloadBoleto	bool	bool	bool	bool
      canSwitchToPix	bool	bool	bool	bool
      canSwitchToBoleto	bool	bool	bool	bool
      canCopyPixKey	bool	bool	bool	bool

    • PrimeCalendar PrimeAccountData.calendar 2 campos

      Campo	Proto	DTO	Model	Entity
      firstAccessDate	string	DateTime?	DateTime?	DateTime?
      bonusTotalAmount	double	double	double	double

    • PrimePerformancePeriod PrimeAccountData.performancePeriods[] 11 campos

      Campo	Proto	DTO	Model	Entity
      monthReference	string	String	String	String
      monthDescription	string	String	String	String
      realized	int32	int	int	int
      inTransit	int32	int	int	int
      target	int32	int	int	int
      maxPercent	int32	int	int	int
      rewardAtTarget	int32	int	int	int
      rewardAtMax	int32	int	int	int
      slabs	repeated PrimeSlab	List<…DTO>	ToMany<…Model>	List<…Entity>
      lastUpdated	string	DateTime?	DateTime?	DateTime?
      rewardProductName	string	String	String	String

      • PrimeSlab PrimePerformancePeriod.slabs[] 3 campos

        Campo	Proto	DTO	Model	Entity
        minValue	double	double	double	double
        maxValue	double	double	double	double
        rewardValue	double	double	double	double

Wrappers só-proto (somem no DTO): PrimeHub {displayPrimePayment, displayPrimeSimulator} é achatado em PrimeAccountData; PrimePerformance {periods} é desembrulhado em performancePeriods.Proto-only wrappers (gone at the DTO): PrimeHub {displayPrimePayment, displayPrimeSimulator} is flattened into PrimeAccountData; PrimePerformance {periods} is unwrapped into performancePeriods.Wrappers solo-proto (desaparecen en el DTO): PrimeHub {displayPrimePayment, displayPrimeSimulator} se aplana en PrimeAccountData; PrimePerformance {periods} se desenvuelve en performancePeriods.

Mappers

As conversões entre camadas, como extension (5 direções por tipo). No Prime, DTO→Entity e Model→Entity usam toEntity() (não toDomain()):The conversions between layers, as extensions (5 directions per type). In Prime, DTO→Entity and Model→Entity use toEntity() (not toDomain()):Las conversiones entre capas, como extension (5 direcciones por tipo). En Prime, DTO→Entity y Model→Entity usan toEntity() (no toDomain()):

PrimeManagementRepositoryImpl implementaimplementsimplementa PrimeManagementRepositoryInterface e injeta os 3 datasources (mock/local/remote) + ConnectivityService + a flag useMock + Ref. Método a método:and injects the 3 datasources (mock/local/remote) + ConnectivityService + the useMock flag + Ref. Method by method:e inyecta los 3 datasources (mock/local/remote) + ConnectivityService + la flag useMock + Ref. Método a método:

Três datasources, um provider cada. O fundo interno é a cor da página.Three datasources, one provider each. The inner background is the page color.Tres datasources, un provider cada uno. El fondo interno es el color de la página.

Dois UseCases sobre o mesmo repository. O de leitura é compartilhado pelas três telas.Two UseCases over the same repository. The read one is shared by all three screens.Dos UseCases sobre el mismo repository. El de lectura es compartido por las tres pantallas.

O Prime tem três notifiers — um por tela — todos family e com o mixin AsyncGuard (guardedBuild/runGuarded). O build() é magro (injeta useCases + _load()); refresh() re-executa o remoto e recarrega. Nenhum deles usa o Dispatcher. Métodos e State de cada um:Prime has three notifiers — one per screen — all family and with the AsyncGuard mixin (guardedBuild/runGuarded). build() is thin (injects useCases + _load()); refresh() re-runs the remote fetch and reloads. None uses the Dispatcher. Methods and State of each:Prime tiene tres notifiers — uno por pantalla — todos family y con el mixin AsyncGuard (guardedBuild/runGuarded). El build() es magro (inyecta useCases + _load()); refresh() re-ejecuta el remoto y recarga. Ninguno usa el Dispatcher. Métodos y State de cada uno:

MétodosMethodsMétodos

State disponível para as PagesState available to the PagesState disponible para las Pages

Três pages, todas AppPageShell com CustomPullToRefresh + DataLoadInfo + AccountHeaderCard, e widgets auto-suficientes (§27). Árvore de composição de cada uma (modais aninhados sob o widget que os abre):Three pages, all AppPageShell with CustomPullToRefresh + DataLoadInfo + AccountHeaderCard, and self-sufficient widgets (§27). Composition tree of each (modals nested under the widget that opens them):Tres pages, todas AppPageShell con CustomPullToRefresh + DataLoadInfo + AccountHeaderCard, y widgets auto-suficientes (§27). Árbol de composición de cada una (modales anidados bajo el widget que los abre):

Hub de gestãoManagement hubHub de gestión

• PrimeManagementPage
  • DataLoadInfo
  • AccountHeaderCard
  • PrimeManagementHeaderWidget
  • PrimeManagementActionsWidget grade de atalhos (MenuActionGrid); some se vaziashortcuts grid (MenuActionGrid); hides if emptygrilla de atajos (MenuActionGrid); se oculta si está vacía

PagamentosPaymentsPagos

• PrimePaymentsPage
  • DataLoadInfo
  • AccountHeaderCard
  • PrimePaymentsHeaderWidget
  • PrimePaymentsListWidget CustomEmptyState se sem pagamentosCustomEmptyState if no paymentsCustomEmptyState si no hay pagos
    • PrimePaymentCardWidget um por mensalidade; botões trocar / baixarone per fee; switch / download buttonsuno por mensualidad; botones cambiar / descargar
      • PrimePaymentSwitchModalContent modal de confirmação da troca (ConectaModal)switch confirmation modal (ConectaModal)modal de confirmación del cambio (ConectaModal)

SimuladorSimulatorSimulador

• PrimeSimulatorPage
  • DataLoadInfo
  • AccountHeaderCard só quando aberto por um varejoonly when opened from a retailsolo cuando se abre desde un punto de venta
  • PrimeSimulatorHeaderWidget ícone só no modo avulsoicon only in standalone modeícono solo en modo suelto
  • PrimeSimulatorRetailFramingCardWidget parâmetros da faixatier parametersparámetros de la franja
    • PrimeSimulatorMetricCell
  • PrimeSimulatorMonthlyTargetWidget input + botão Calcular → notifier.calculateinput + Calculate button → notifier.calculateinput + botón Calcular → notifier.calculate
  • PrimeSimulatorBonusCardWidget estimativa 1 / 12 / 24 meses1 / 12 / 24 month estimateestimación 1 / 12 / 24 meses
    • PrimeSimulatorMetricCell
  • PrimeSimulatorImportantNoteWidget notas de elegibilidade / ressalvaeligibility / caveat notesnotas de elegibilidad / salvedad