TarefasTasksTareas

Clean Architecture + Riverpod + Freezed + gRPC + ObjectBox. Há dois fluxos distintos: a leitura da lista (um RPC getTasksGtv, com cache write-through) e a escrita (concluir uma tarefa, via Dispatcher). A lista e o detalhe leem a mesma TasksEntity do cache.Clean Architecture + Riverpod + Freezed + gRPC + ObjectBox. There are two distinct flows: the list read (a single getTasksGtv RPC, with cache write-through) and the write (completing a task, via the Dispatcher). List and detail both read the same cached TasksEntity.Clean Architecture + Riverpod + Freezed + gRPC + ObjectBox. Hay dos flujos distintos: la lectura de la lista (un RPC getTasksGtv, con cache write-through) y la escritura (completar una tarea, vía Dispatcher). La lista y el detalle leen la misma TasksEntity del caché.

Leitura · lista (write-through)Read · list (write-through)Lectura · lista (write-through)

• TasksGtvReplygRPC proto
  • toTasksDTOTasksDTODTO · Freezed
    • toDomainTasksEntitydomain
      • toModelTasksModelObjectBox
        • toDomainTasksEntitydomain · cache
          • watchTasksNotifier / TaskDetailNotifier
            • → UITasksPage · TaskDetailPage

Escrita · concluir via DispatcherWrite · complete via DispatcherEscritura · completar vía Dispatcher

O envio é remote-first: monta-se o envelope, despacha-se pelo Dispatcher e só após o ack de sucesso o cache local é atualizado (status → concluída).The write is remote-first: the envelope is built, dispatched through the Dispatcher, and only after the success ack is the local cache updated (status → completed).La escritura es remote-first: se arma el sobre, se despacha por el Dispatcher y solo tras el ack de éxito se actualiza el caché local (estado → completada).

• TaskDetailActionsWidgetUI
  • submitCompletionTaskDetailNotifier
    • build(input)BuildAnswerTaskDispatcherPayloadUseCase→ DispatcherEnvelope
      • submit(envelope)SubmitAnswerTaskUseCase
        • dispatchDispatcherOrchestratorAnswerTaskAPI · batchApi
          • ack ok →ack ok →ack ok →SubmitTaskDetailsUseCasecache local: status → completedlocal cache: status → completedcaché local: status → completed

A mesma tarefa 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 se mantêm; muda muito pouco (dois enums tipados, duas datas parseadas, e o id renomeado no Model). O fetch é write-through: todo retorno é gravado no ObjectBox e a UI passa a ler do cache.The same task 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. Names stay the same; very little changes (two typed enums, two parsed dates, and id renamed in the Model). Fetch is write-through: every response is written to ObjectBox and the UI then reads from cache.La misma tarea 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; cambia muy poco (dos enums tipados, dos fechas parseadas, y el id renombrado 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 TasksEntity (lastSyncAt gerado no mapper + tasks[]); cada item é um Task de 10 campos, plano (sem sub-estruturas). Os enums só existem tipados na Entity (TaskType, TaskStatus); 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 list arrives in a TasksEntity container (lastSyncAt generated in the mapper + tasks[]); each item is a 10-field, flat Task (no sub-structures). Enums are only typed in the Entity (TaskType, TaskStatus); in Proto/DTO/Model they travel as String. Next, in order: the proto, the field-by-field data structures per layer, and the mappers.La lista llega en un container TasksEntity (lastSyncAt generado en el mapper + tasks[]); cada ítem es un Task de 10 campos, plano (sin sub-estructuras). Los enums solo están tipados en la Entity (TaskType, TaskStatus); 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

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

Estruturas de dadosData structuresEstructuras de datos

Um dropdown por estrutura. Cada tabela tem uma coluna por camada — Proto · DTO · Model · Entity; o texto azul marca onde o tipo primeiro muda (enum na Entity, parse de data e rename de id no Model). ¹ = optional no proto.One dropdown per structure. Each table has one column per layer — Proto · DTO · Model · Entity; the blue text marks where the type first changes (enum in the Entity, date parse and id rename in the Model). ¹ = optional in the proto.Un dropdown por estructura. Cada tabla tiene una columna por capa — Proto · DTO · Model · Entity; el texto azul marca dónde primero cambia el tipo (enum en la Entity, parse de fecha y rename de id en el Model). ¹ = optional en el proto.

• Tasks container 2 camposfieldscampos

  Campo	Proto	DTO	Model	Entity
  tasks	repeated TaskGtv	List<TaskDTO>	ToMany<TaskModel>	List<TaskEntity>
  lastSyncAt	—	DateTime?	DateTime	DateTime?

  • Task Tasks.tasks[] 10 camposfieldscampos

    Campo	Proto	DTO	Model	Entity
    id	string	String	taskId	String
    taskType	string	String	String	TaskType
    taskTitle	string	String	String	String
    description	string	String	String	String
    accountSfid	string	String	String	String
    accountCode	string	String	String	String
    accountName	string	String	String	String
    startDate	string	String	DateTime?	DateTime?
    endDate	string	String	DateTime?	DateTime?
    status	string	String	String	TaskStatus

Mappers

As conversões entre as camadas, todas como extension (5 direções, no par container/item):The conversions between layers, all as extensions (5 directions, over the container/item pair):Las conversiones entre capas, todas como extension (5 direcciones, sobre el par container/ítem):

TaskRepositoryImpl implementaimplementsimplementa TaskRepositoryInterface 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 getTasks() traz a árvore de decisão de fonte dentro do próprio detalhe.One dropdown per method — signature, return and behavior. getTasks() carries the source decision tree inside its own detail.Un dropdown por método — firma, retorno y comportamiento. getTasks() trae el árbol de decisión de fuente dentro de su propio detalle.

Três datasources. A escrita das ações não passa por eles — vai pelo Dispatcher (ver UseCases); o único write local é updateTaskStatus.Three datasources. Action writes don't go through them — they go via the Dispatcher (see UseCases); the only local write is updateTaskStatus.Tres datasources. La escritura de las acciones no pasa por ellos — va por el Dispatcher (ver UseCases); el único write local es updateTaskStatus.

Dois enums de dado (tipados na Entity a partir da String de wire, via fromValue), dois enums de filtro (client-side) e um enum de estado de envio. Um dropdown por enum, todos os valores:Two data enums (typed in the Entity from the wire String, via fromValue), two filter enums (client-side) and one submission-status enum. One dropdown per enum, every value:Dos enums de dato (tipados en la Entity desde el String de wire, vía fromValue), dos enums de filtro (client-side) y un enum de estado de envío. Un dropdown por enum, todos los valores:

LeituraReadLectura

Escrita · concluirWrite · completeEscritura · completar

O trio de escrita segue o padrão §36 (builder puro) + §39 (disparo no Notifier). Ver a transação completa em Answer Task.The write trio follows §36 (pure builder) + §39 (dispatch in the Notifier). See the full transaction in Answer Task.El trío de escritura sigue §36 (builder puro) + §39 (disparo en el Notifier). Ver la transacción completa en Answer Task.

Dois notifiers: TasksNotifier (lista) e TaskDetailNotifier (detalhe, família por taskId). Cada um expõe seu State Freezed como fonte única de verdade; a Page só lê via ref.watch.Two notifiers: TasksNotifier (list) and TaskDetailNotifier (detail, family by taskId). Each exposes its Freezed State as the single source of truth; the Page only reads via ref.watch.Dos notifiers: TasksNotifier (lista) y TaskDetailNotifier (detalle, familia por taskId). Cada uno expone su State Freezed como fuente única de verdad; la Page solo lee vía ref.watch.

ListaListLista

MétodosMethodsMétodos · TasksNotifier

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

DetalheDetailDetalle

MétodosMethodsMétodos · TaskDetailNotifier(taskId)

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

Duas Pages, ambas AppPageShell com .when(data/error/loading) (loading = CustomLoadingIndicator; erro = FailureStateView). Árvore de composição:Two Pages, both AppPageShell with .when(data/error/loading) (loading = CustomLoadingIndicator; error = FailureStateView). Composition tree:Dos Pages, ambas AppPageShell con .when(data/error/loading) (loading = CustomLoadingIndicator; error = FailureStateView). Árbol de composición:

TasksPage

• TasksPage
  • CustomPullToRefresh → refresh()→ refresh()→ refresh()
    • DataLoadInfo lastSyncAt
    • TasksHeaderWidget ícone + títuloicon + titleícono + título
    • TasksFiltersRowWidget 2 dropdowns (status/escopo)2 dropdowns (status/scope)2 dropdowns (status/alcance)
    • TasksListWidget
      • CustomEmptyState se vazioif emptysi vacío
      • InfiniteScrollListView<TaskEntity>
        • TaskCardWidget tipo · status · varejo/zona · prazo → goToTaskDetailtype · status · retail/zone · deadline → goToTaskDetailtipo · status · PDV/zona · plazo → goToTaskDetail
      • PaginationCountIndicator "X / Y"

TaskDetailPage

• TaskDetailPage(taskId) ref.listen → ConectaNotice em success/failureref.listen → ConectaNotice on success/failureref.listen → ConectaNotice en success/failure
  • SingleChildScrollView
    • DataLoadInfo
    • TaskDetailHeaderWidget
    • TaskDetailCardWidget repete o card da listarepeats the list cardrepite la tarjeta de la lista
    • TaskDetailGtvDescriptionWidget descrição do gerente de territórioarea manager's descriptiondescripción del gerente de territorio
    • TaskDetailDescriptionInputWidget textarea + contador ≥50 (readOnly se concluída)textarea + ≥50 counter (readOnly if completed)textarea + contador ≥50 (readOnly si completada)
    • TaskDetailActionsWidget Sair (outlined) · Finalizar (filled) → submitCompletionExit (outlined) · End (filled) → submitCompletionSalir (outlined) · Finalizar (filled) → submitCompletion

A Page do detalhe orquestra a UI (mostra ConectaNotice, chama resetSubmissionStatus, "Sair" via AppRouter.back); o disparo do envio vive no Notifier (§39).The detail Page orchestrates the UI (shows ConectaNotice, calls resetSubmissionStatus, "Exit" via AppRouter.back); the submit trigger lives in the Notifier (§39).La Page del detalle orquesta la UI (muestra ConectaNotice, llama resetSubmissionStatus, "Salir" vía AppRouter.back); el disparo del envío vive en el Notifier (§39).