NotificaçõesNotificationsNotificaciones

Clean Architecture + Riverpod + Freezed + gRPC + ObjectBox. Há dois fluxos distintos: uma leitura da lista (um RPC getNotifications, com cache write-through) e uma escrita — marcar como lido — que passa pelo Dispatcher (transação NotificationRead) e só então grava no cache local.Clean Architecture + Riverpod + Freezed + gRPC + ObjectBox. There are two distinct flows: a read of the list (one getNotifications RPC, with cache write-through) and a write — mark as read — that goes through the Dispatcher (the NotificationRead transaction) and only then writes to the local cache.Clean Architecture + Riverpod + Freezed + gRPC + ObjectBox. Hay dos flujos distintos: una lectura de la lista (un RPC getNotifications, con cache write-through) y una escritura — marcar como leído — que pasa por el Dispatcher (la transacción NotificationRead) y solo entonces graba en el caché local.

Leitura — a lista atravessa quatro representações ligadas por mappers:Read — the list crosses four representations linked by mappers:Lectura — la lista atraviesa cuatro representaciones unidas por mappers:

• NotificationsReplygRPC proto
  • toNotificationsDTONotificationsDTODTO · Freezed
    • toDomainNotificationsEntitydomain
      • toModelNotificationsModelObjectBox
        • toDomainNotificationsEntitydomain · cache
          • watchNotificationsNotifier + State
            • → UINotificationsPage

Escrita (marcar como lido) — disparada ao expandir um card não lido; o cache local só é atualizado após o retorno positivo do servidor (remote-first, §36):Write (mark as read) — triggered when expanding an unread card; the local cache is updated only after the server's positive reply (remote-first, §36):Escritura (marcar como leído) — disparada al expandir una tarjeta no leída; el caché local solo se actualiza tras la respuesta positiva del servidor (remote-first, §36):

• NotificationCardWidgettap (não lido / unread)
  • toggleExpandNotificationsNotifier
    • buildBuildNotificationReadDispatcherPayloadUseCase→ DispatcherEnvelope
      • submitSubmitNotificationReadUseCase
        • dispatchDispatcherOrchestratorsendTransaction · NotificationRead
          • DispatcherAck okmarkAsReadlocal · dateRead = now
            • getCached → invalidateState + unreadNotificationsCountProvider→ sino / bell

A mesma notificação existe em quatro representações quase idênticas ao longo das camadas — Proto (wire gRPC) → DTO (Freezed) → Model (ObjectBox) → Entity (domínio) — e cada fronteira é atravessada por um mapper. Os nomes dos campos se mantêm em todas as camadas; muda muito pouco. Diferente de Pedidos, aqui a conversão de data (String→DateTime) acontece já no DTO (o DTO Freezed carrega DateTime), não no Model. O fetch é write-through: todo retorno é gravado no ObjectBox e a UI passa a ler do cache.The same notification exists in four near-identical representations across the layers — Proto (gRPC wire) → DTO (Freezed) → Model (ObjectBox) → Entity (domain) — and each boundary is crossed by a mapper. Field names stay the same across layers; very little changes. Unlike Orders, here the date conversion (String→DateTime) happens already at the DTO (the Freezed DTO carries DateTime), not at the Model. Fetch is write-through: every response is written to ObjectBox and the UI then reads from cache.La misma notificación existe en cuatro representaciones casi idénticas a lo largo de las capas — Proto (wire gRPC) → DTO (Freezed) → Model (ObjectBox) → Entity (dominio) — y cada frontera se cruza con un mapper. Los nombres se mantienen en todas las capas; cambia muy poco. A diferencia de Pedidos, aquí la conversión de fecha (String→DateTime) ocurre ya en el DTO (el DTO Freezed lleva DateTime), no en el Model. El fetch es write-through: toda respuesta se graba en ObjectBox y la UI lee del caché.

A lista chega num container NotificationsEntity (lastSyncAt gerado no mapper + items[]); cada item é uma Notification de 5 campos, sem sub-estruturas. Não há enums tipados — "lido/não lido" é derivado do campo dateRead (getter isRead). A seguir, na ordem: o proto, a estrutura de dados campo-a-campo por camada, e os mappers.The list arrives in a NotificationsEntity container (lastSyncAt generated in the mapper + items[]); each item is a 5-field Notification, with no sub-structures. There are no typed enums — "read/unread" is derived from the dateRead field (isRead getter). Next, in order: the proto, the field-by-field data structure per layer, and the mappers.La lista llega en un container NotificationsEntity (lastSyncAt generado en el mapper + items[]); cada ítem es una Notification de 5 campos, sin sub-estructuras. No hay enums tipados — "leído/no leído" se deriva del campo dateRead (getter isRead). A continuación, en orden: el proto, la estructura de datos campo a campo por capa, y los mappers.

Proto

NotificationsConectaRep.proto · proto3 · package mn.bat.conectarep.streambridge. Um serviço (NotificationsConectaRepService), um método unário:One service (NotificationsConectaRepService), a single unary method:Un servicio (NotificationsConectaRepService), un método unario:

Estruturas de dadosData structuresEstructuras de datos

Uma estrutura única — Notification, dentro do container NotificationsEntity.items[]. A tabela tem uma coluna por camada — Proto · DTO · Model · Entity; a célula com borda marca onde o tipo primeiro muda (aqui, o parse de data já no DTO).A single structure — Notification, inside the NotificationsEntity.items[] container. The table has one column per layer — Proto · DTO · Model · Entity; the bordered cell marks where the type first changes (here, the date parse already at the DTO).Una estructura única — Notification, dentro del container NotificationsEntity.items[]. La tabla tiene una columna por capa — Proto · DTO · Model · Entity; la celda con borde marca dónde primero cambia el tipo (aquí, el parse de fecha ya en el DTO).

• Notification raiz · NotificationsEntity.items[] 5 campos

  Campo	Proto	DTO	Model	Entity
  sfid	string	String	String	String
  name	string	String	String	String
  description	string	String	String	String
  startDate	string	DateTime	DateTime	DateTime
  dateRead	string	DateTime?	DateTime?	DateTime?

Mappers

As conversões entre as camadas, todas como extension (5 direções). O container (Notifications*) e o item (Notification*) têm mappers próprios; o container itera os itens.The conversions between layers, all as extensions (5 directions). Container (Notifications*) and item (Notification*) have their own mappers; the container iterates the items.Las conversiones entre capas, todas como extension (5 direcciones). El container (Notifications*) y el ítem (Notification*) tienen mappers propios; el container itera los ítems.

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

Um dropdown por método — assinatura, retorno e comportamento. O getNotifications() traz a árvore de decisão de fonte dentro do próprio detalhe.One dropdown per method — signature, return and behavior. getNotifications() carries the source decision tree inside its own detail.Un dropdown por método — firma, retorno y comportamiento. getNotifications() trae el árbol de decisión de fuente dentro de su propio detalle.

Um card por datasource (dropdown). No corpo: método, envio, retorno, fluxo de uso e tratamento de erro.One card per datasource (dropdown). In the body: method, what it sends, return, usage flow and error handling.Un card por datasource (dropdown). En el cuerpo: método, envío, retorno, flujo de uso y manejo de errores.

Esta feature não define enums de domínio. Uma notificação tem só dois estados, derivados de um campo — não de um enum:This feature defines no domain enums. A notification has just two states, derived from a field — not from an enum:Esta feature no define enums de dominio. Una notificación tiene solo dos estados, derivados de un campo — no de un enum:

NotificationEntity.isRead

bool — getter puro = dateRead != null. É toda a lógica de "lido/não lido".pure getter = dateRead != null. This is the entire "read/unread" logic.getter puro = dateRead != null. Es toda la lógica de "leído/no leído".

DataSourceType

enum de infra compartilhado (mock / local / remote), usado como parâmetro de fonte no repository — não é próprio de Notificações.shared infra enum (mock / local / remote), used as the source parameter in the repository — not specific to Notifications.enum de infra compartido (mock / local / remote), usado como parámetro de fuente en el repository — no propio de Notificaciones.

Um dropdown por UseCase; dentro, cada método com assinatura, o que retorna e uso. Os UseCases de leitura delegam ao repository (sem lógica extra); os dois da pasta dispatcher/notifications/ montam e enviam a transação de escrita. Todos os providers são keepAlive.One dropdown per UseCase; inside, each method with its signature, what it returns and use. The read UseCases delegate to the repository (no extra logic); the two in dispatcher/notifications/ build and send the write transaction. All providers are keepAlive.Un dropdown por UseCase; dentro, cada método con su firma, qué devuelve y uso. Los UseCases de lectura delegan al repository (sin lógica extra); los dos de la carpeta dispatcher/notifications/ arman y envían la transacción de escritura. Todos los providers son keepAlive.

O NotificationsNotifier (@riverpod, with AsyncGuard<NotificationsState>) é o cérebro da tela. O build() observa os UseCases (leitura + os dois do Dispatcher) e retorna _load(). O State (NotificationsState, Freezed) é a fonte única de verdade da page: guarda o AsyncValue das notificações, o expandedSfid (qual card está aberto) e o visibleCount (paginação visual). Contagens e recortes são getters — client-side.The NotificationsNotifier (@riverpod, with AsyncGuard<NotificationsState>) is the screen's brain. build() watches the UseCases (read + the two Dispatcher ones) and returns _load(). The State (NotificationsState, Freezed) is the page's single source of truth: it holds the notifications AsyncValue, the expandedSfid (which card is open) and visibleCount (visual pagination). Counts and slices are getters — client-side.El NotificationsNotifier (@riverpod, with AsyncGuard<NotificationsState>) es el cerebro de la pantalla. build() observa los UseCases (lectura + los dos del Dispatcher) y retorna _load(). El State (NotificationsState, Freezed) es la fuente única de verdad de la page: guarda el AsyncValue de las notificaciones, el expandedSfid (qué card está abierto) y el visibleCount (paginación visual). Conteos y recortes son getters — client-side.

MétodosMethodsMétodos

Selector compartilhado do sinoShared bell selectorSelector compartido de la campana

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

A NotificationsPage (ConsumerWidget) observa o notificationsProvider e monta os widgets filhos. Loading e erro são globais (notificationsAsync.when); o conteúdo existe só no ramo data. O AppBarBellButton — porta de entrada e selo — vive na barra superior das telas principais, não nesta árvore. Árvore de composição:NotificationsPage (ConsumerWidget) watches notificationsProvider and composes the child widgets. Loading and error are global (notificationsAsync.when); content exists only in the data branch. The AppBarBellButton — entry point and badge — lives in the top bar of the main screens, not in this tree. Composition tree:NotificationsPage (ConsumerWidget) observa notificationsProvider y compone los widgets hijos. Loading y error son globales (notificationsAsync.when); el contenido existe solo en la rama data. El AppBarBellButton — puerta de entrada y sello — vive en la barra superior de las pantallas principales, no en este árbol. Árbol de composición:

• NotificationsPage
  • AppPageShell displayBackButton · background
    • CustomLoadingIndicator loading
    • FailureStateView error → invalidate
    • CustomPullToRefresh data → refresh()
      • DataLoadInfo lastSyncAt
      • NotificationsHeaderWidget sino + título
      • NotificationsListWidget
        • CustomEmptyState totalItems == 0
        • InfiniteScrollListView → loadMore()
          • NotificationCardWidget tap → toggleExpand · ponto azul (não lido) · chevron · expand → descrição
        • PaginationCountIndicator X de Y

O scroll infinito também é apoiado por um ScrollController no corpo da page, que chama loadMore() ao aproximar do fim. Não há modais nesta feature.Infinite scroll is also backed by a ScrollController in the page body, calling loadMore() near the end. There are no modals in this feature.El scroll infinito también se apoya en un ScrollController en el cuerpo de la page, que llama loadMore() al acercarse al final. No hay modales en esta feature.