Entregas do diaDeliveries of the dayEntregas del día

Clean Architecture + Riverpod + Freezed. A feature tem leitura e escrita distintas, em dois grafos. A leitura é derivada e cache-first: não há RPC próprio — o GetDeliveriesOfTheDayUseCase chama o OrderRepository.getOrders e filtra os pedidos com invoice.isPickListed == true.Clean Architecture + Riverpod + Freezed. The feature has distinct read and write paths, in two graphs. The read is derived and cache-first: there's no dedicated RPC — GetDeliveriesOfTheDayUseCase calls OrderRepository.getOrders and filters orders with invoice.isPickListed == true.Clean Architecture + Riverpod + Freezed. La feature tiene lectura y escritura distintas, en dos grafos. La lectura es derivada y cache-first: no hay RPC propio — GetDeliveriesOfTheDayUseCase llama a OrderRepository.getOrders y filtra los pedidos con invoice.isPickListed == true.

Leitura — deriva do cache de pedidos:Read — derives from the orders cache:Lectura — deriva del caché de pedidos:

• OrderRepository.getOrderscache-first (§ Orders)
  • OrdersEntityGetDeliveriesOfTheDayUseCasefilter isPickListed
    • DeliveriesOfTheDayEntityDeliveriesOfTheDayNotifier + State
      • → UIDeliveriesOfTheDayPage

Escrita — confirmar/rejeitar/reagendar via DeliveryOrchestrator + Dispatcher, com update otimista no cache de pedidos:Write — confirm/reject/reschedule via DeliveryOrchestrator + Dispatcher, with an optimistic update to the orders cache:Escritura — confirmar/rechazar/reagendar vía DeliveryOrchestrator + Dispatcher, con update optimista al caché de pedidos:

• Notifier.confirm / reject / reschedule
  • updateDeliveryDeliveryOrchestratorbuilds envelope(s)
    • Build…PayloadUseCaseDispatcherEnvelopestatus update (+ trip sheet)
      • SubmitDeliveryUseCaseDispatcherOrchestrator.dispatchgRPC sendTransaction
        • on ackoptimistic updateOrderRepository.saveOrders
          • stateNotifier _applyUpdatedOrder

Entregas do dia não tem proto, DTO nem Model próprios. Ela reusa o modelo de Order (as quatro camadas Proto→DTO→Model→Entity estão documentadas na Lista de pedidos) e monta, em tempo de execução, estruturas de domínio por cima: um container e um agrupamento de produtos calculado. As transações de escrita têm seus próprios inputs Freezed. A seguir: de onde vem cada estrutura, e o detalhe campo-a-campo de cada uma.Deliveries of the day has no own proto, DTO or Model. It reuses the Order model (the four layers Proto→DTO→Model→Entity are documented in the Order list) and builds, at runtime, domain structures on top: a container and a computed product grouping. The write transactions have their own Freezed inputs. Next: where each structure comes from, and the field-by-field detail of each.Entregas del día no tiene proto, DTO ni Model propios. Reusa el modelo de Order (las cuatro capas Proto→DTO→Model→Entity están documentadas en la Lista de pedidos) y arma, en tiempo de ejecución, estructuras de dominio encima: un container y una agrupación de productos calculada. Las transacciones de escritura tienen sus propios inputs Freezed. A continuación: de dónde viene cada estructura, y el detalle campo a campo de cada una.

Fontes de dadosData sourcesFuentes de datos

Estruturas de dadosData structuresEstructuras de datos

Estruturas de domínio (Freezed) — uma coluna de tipo, pois não cruzam as quatro camadas. As sub-estruturas de Order (OrderInvoice, InvoiceLineItem…) estão na doc de Orders.Domain structures (Freezed) — a single type column, since they don't cross the four layers. Order's sub-structures (OrderInvoice, InvoiceLineItem…) are in the Orders doc.Estructuras de dominio (Freezed) — una columna de tipo, pues no cruzan las cuatro capas. Las sub-estructuras de Order (OrderInvoice, InvoiceLineItem…) están en la doc de Orders.

• DeliveriesOfTheDay container 2 campos2 fields2 campos

  Campo	Entity	notanotenota
  lastSyncAt	DateTime	herdado de OrdersEntity.lastSyncAt; DateTimeUtils.now() se o cache está vazioinherited from OrdersEntity.lastSyncAt; DateTimeUtils.now() if cache is emptyheredado de OrdersEntity.lastSyncAt; DateTimeUtils.now() si el caché está vacío
  deliveries	List<OrderEntity>	os pedidos pick-listed; default []the pick-listed orders; default []los pedidos pick-listed; default []

  • DeliveryProductGroup calculado por cardcomputed per cardcalculado por tarjeta 3 campos3 fields3 campos

    Campo	Entity	notanotenota
    category	CategoryGroup	grupo da categoria; default unknowncategory group; default unknowngrupo de categoría; default unknown
    isBonification	bool	true no grupo de itens isFreeOfCharge; default falsetrue for the isFreeOfCharge items group; default falsetrue en el grupo de ítems isFreeOfCharge; default false
    items	List<InvoiceLineItemEntity>	itens da nota daquele grupo; default []that group's invoice items; default []ítems de factura de ese grupo; default []

  • DeliveryCancelReason reference_data 2 campos2 fields2 campos

    Campo	Entity	notanotenota
    code	String	vai para delResCode no payload de rejeiçãogoes to delResCode in the reject payloadva a delResCode en el payload de rechazo
    reason	String	label exibido no dropdownlabel shown in the dropdownlabel mostrado en el dropdown

  • DeliveryStatusUpdateDispatcherPayloadInput input de escritawrite inputinput de escritura 5 campos5 fields5 campos

    Campo	Entity	notanotenota
    order	OrderEntity	a entrega cruathe raw deliveryla entrega cruda
    action	DeliveryAction	confirm / reject / reschedule
    submittedAt	DateTime	relógio (DateTimeUtils.now())clock (DateTimeUtils.now())reloj (DateTimeUtils.now())
    rescheduleDate	DateTime?	só no reschedulereschedule onlysolo en reschedule
    rejectionReason	DeliveryCancelReasonEntity?	só no rejectreject onlysolo en reject

  • DeliveryTripSheetDispatcherPayloadInput input de escrita · reschedulewrite input · rescheduleinput de escritura · reschedule 4 campos4 fields4 campos

    Campo	Entity	notanotenota
    order	OrderEntity	—
    resource	ResourceEntity	representante (vai como ResID)rep (goes as ResID)representante (va como ResID)
    rescheduleDate	DateTime	nova datanew datenueva fecha
    submittedAt	DateTime	relógioclockreloj

A feature não tem repository próprio. Consome dois repositórios existentes: o OrderRepository (leitura das entregas + persistência do update otimista) e o ReferenceDataRepository (motivos de rejeição). Os métodos usados:The feature has no own repository. It consumes two existing repositories: OrderRepository (reading deliveries + persisting the optimistic update) and ReferenceDataRepository (rejection reasons). The methods used:La feature no tiene repository propio. Consume dos repositorios existentes: OrderRepository (lectura de entregas + persistencia del update optimista) y ReferenceDataRepository (motivos de rechazo). Los métodos usados:

A feature não tem datasources próprios. A leitura passa pelos datasources de Order (Mock JSON / Local ObjectBox / Remote gRPC) e a escrita pelo transporte do Dispatcher. Resumo do que ela toca:The feature has no own datasources. Reads go through Order's datasources (Mock JSON / Local ObjectBox / Remote gRPC) and writes go through the Dispatcher transport. Summary of what it touches:La feature no tiene datasources propios. La lectura pasa por los datasources de Order (Mock JSON / Local ObjectBox / Remote gRPC) y la escritura por el transporte del Dispatcher. Resumen de lo que toca:

Enums próprios da feature (em core/enums/delivery/) mais o CategoryGroup usado no agrupamento de produtos. Lista completa:The feature's own enums (in core/enums/delivery/) plus the CategoryGroup used in product grouping. Full list:Los enums propios de la feature (en core/enums/delivery/) más el CategoryGroup usado en el agrupamiento de productos. Lista completa:

A leitura tem um UseCase próprio; a escrita passa por um orchestrator de domínio (DeliveryOrchestrator) que monta payloads com dois builders e submete via SubmitDeliveryUseCase. Um dropdown por peça, com método · retorna · uso.The read has its own UseCase; the write goes through a domain orchestrator (DeliveryOrchestrator) that builds payloads with two builders and submits via SubmitDeliveryUseCase. One dropdown per piece, with method · returns · use.La lectura tiene su propio UseCase; la escritura pasa por un orchestrator de dominio (DeliveryOrchestrator) que arma payloads con dos builders y envía vía SubmitDeliveryUseCase. Un dropdown por pieza, con método · devuelve · uso.

O DeliveriesOfTheDayNotifier (@riverpod, with AsyncGuard<DeliveriesOfTheDayState>) é o cérebro da tela. O build() observa o GetDeliveriesOfTheDayUseCase e o DeliveryOrchestrator e retorna guardedBuild(_load). O State (Freezed) é a fonte única de verdade: guarda o container de entregas e o estado de cliente (aba, seleção). A filtragem/ordenação por aba é client-side, em getters do State. As ações de escrita delegam ao orchestrator e aplicam o resultado no State.The DeliveriesOfTheDayNotifier (@riverpod, with AsyncGuard<DeliveriesOfTheDayState>) is the screen's brain. build() watches GetDeliveriesOfTheDayUseCase and DeliveryOrchestrator and returns guardedBuild(_load). The State (Freezed) is the single source of truth: it holds the delivery container and client state (tab, selection). Filtering/sorting per tab is client-side, in State getters. Write actions delegate to the orchestrator and apply the result to the State.El DeliveriesOfTheDayNotifier (@riverpod, with AsyncGuard<DeliveriesOfTheDayState>) es el cerebro de la pantalla. build() observa GetDeliveriesOfTheDayUseCase y DeliveryOrchestrator y retorna guardedBuild(_load). El State (Freezed) es la fuente única de verdad: guarda el container de entregas y el estado de cliente (pestaña, selección). El filtrado/orden por pestaña es client-side, en getters del State. Las acciones de escritura delegan al orchestrator y aplican el resultado en el State.

MétodosMethodsMétodos

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

A DeliveriesOfTheDayPage (ConsumerWidget) observa o deliveriesOfTheDayProvider dentro de um AppPageShell (com voltar, sem drawer). Loading e erro são globais (when); o conteúdo vive num _DeliveriesBody statefull que controla o TabController. Árvore de composição (modais aninhados sob quem os abre):DeliveriesOfTheDayPage (ConsumerWidget) watches deliveriesOfTheDayProvider inside an AppPageShell (with back, no drawer). Loading and error are global (when); content lives in a stateful _DeliveriesBody that drives the TabController. Composition tree (modals nested under what opens them):DeliveriesOfTheDayPage (ConsumerWidget) observa deliveriesOfTheDayProvider dentro de un AppPageShell (con volver, sin drawer). Loading y error son globales (when); el contenido vive en un _DeliveriesBody stateful que controla el TabController. Árbol de composición (modales anidados bajo quien los abre):

• DeliveriesOfTheDayPage
  • AppPageShell back · no drawer
    • CustomLoadingIndicator loading
    • FailureStateView error → invalidate
    • _DeliveriesBody data · TabController
      • NestedScrollView header
        • DataLoadInfo lastSyncAt
        • DeliveriesOfTheDayTitleRow ícone + título
        • DeliveryTabBarWidget CustomTabBar → selectTab
      • TabBarView 1 por DeliveryTab
        • _DeliveriesListSection deliveriesForTab(tab)
          • CustomEmptyState lista vazia
          • DeliveryCardWidget por entrega
            • SwipeToRevealReschedule só pending → _openReschedule
              • CustomCalendarModalContent modal · próximo dia útil, 60d, sem fim de semana → rescheduleDelivery
            • _DeliveryCardHeader
              • CustomRadio só pending → toggleSelection
              • _DeliveryStatusPill tag por status
            • _DeliveryCardDetails expandido
              • DeliveryProductGroupWidget por grupo · SKU/preço/qty
              • total de itens deliveryTotalItems
      • DeliveryActionButtonsWidget Rejeitar (outlined) · Confirmar (filled) · enable = hasSelection
        • DeliveryConfirmModalContent modal → confirmSelected
        • DeliveryRejectReasonModalContent modal · dropdown de motivos → rejectSelected