ConfiguraçõesSettingsConfiguración

Clean Architecture + Riverpod + Freezed. A tela não tem proto próprio: ela compõe cinco fontes já existentes (nenhum RPC é disparado aqui) e tem uma única escrita — a placa, que vai pelo Dispatcher. Por isso há dois grafos distintos: leitura (composição) e escrita (transação).Clean Architecture + Riverpod + Freezed. The screen has no proto of its own: it composes five existing sources (no RPC is fired here) and has a single write — the plate, which goes through the Dispatcher. Hence two distinct graphs: read (composition) and write (transaction).Clean Architecture + Riverpod + Freezed. La pantalla no tiene proto propio: compone cinco fuentes existentes (no se dispara ningún RPC aquí) y tiene una única escritura — la matrícula, que va por el Dispatcher. De ahí dos grafos distintos: lectura (composición) y escritura (transacción).

Leitura — composição no build()Read — composition in build()Lectura — composición en build()

• GetResourcesUseCaseresource · cache
  • DeviceInfoServicedevice_info_plus
    • PackageInfopackage_info_plus
      • marketConfigurationProviderEMC · journeyConfig
        • GetVehicleInfoUseCaseObjectBox local
          • await (paralelo)SettingsNotifier + State
            • → UISettingsPage

Escrita — salvar a placaWrite — saving the plateEscritura — guardar la matrícula

• SettingsCarPlateEditModalContentonSave
  • saveCarLicensePlateSettingsNotifier
    • build(input)BuildCarLicensePlate…UseCaseDispatcherEnvelope
      • submit(envelope)SubmitCarLicensePlateUseCase→ DispatcherOrchestrator
        • on SuccessSaveVehicleInfoUseCaseObjectBox local
          • state.copyWithSettingsState

A escrita é remote-first (§36): dispara a transação primeiro, grava no cache local só depois do sucesso.The write is remote-first (§36): fires the transaction first, writes to local cache only after success.La escritura es remote-first (§36): dispara la transacción primero, graba en caché local solo tras el éxito.

Settings não tem uma entidade única nem um proto próprio: o SettingsState é uma composição de dados de cinco origens diferentes, montada no build() do Notifier. Só uma dessas origens — a placa (VehicleInfo) — atravessa camadas de dados (Entity ↔ Model, ObjectBox local); as demais chegam prontas de subsistemas já documentados (resource, EMC) ou de plugins de plataforma (device info, package info).Settings has no single entity and no proto of its own: SettingsState is a composition of data from five different sources, assembled in the Notifier's build(). Only one of those sources — the plate (VehicleInfo) — crosses data layers (Entity ↔ Model, local ObjectBox); the rest arrive ready from already-documented subsystems (resource, EMC) or platform plugins (device info, package info).Settings no tiene una entidad única ni un proto propio: SettingsState es una composición de datos de cinco orígenes distintos, armada en el build() del Notifier. Solo uno de esos orígenes — la matrícula (VehicleInfo) — atraviesa capas de datos (Entity ↔ Model, ObjectBox local); el resto llega listo de subsistemas ya documentados (resource, EMC) o de plugins de plataforma (device info, package info).

Fontes de dadosData sourcesFuentes de datos

Cada campo do SettingsState e de onde vem — não há RPC próprio da tela:Each SettingsState field and where it comes from — there's no screen-owned RPC:Cada campo del SettingsState y de dónde viene — no hay RPC propio de la pantalla:

Estruturas de dadosData structuresEstructuras de datos

Um dropdown por estrutura. VehicleInfo é a única que persiste localmente (Entity ↔ Model, sem DTO nem proto); DeviceInfo e JourneyFieldConfig são só Entity (montadas de plugin/EMC). A ResourceEntity pertence ao subsistema de sessão — documentada à parte.One dropdown per structure. VehicleInfo is the only one that persists locally (Entity ↔ Model, no DTO or proto); DeviceInfo and JourneyFieldConfig are Entity-only (built from plugin/EMC). ResourceEntity belongs to the session subsystem — documented separately.Un dropdown por estructura. VehicleInfo es la única que persiste localmente (Entity ↔ Model, sin DTO ni proto); DeviceInfo y JourneyFieldConfig son solo Entity (armadas de plugin/EMC). La ResourceEntity pertenece al subsistema de sesión — documentada aparte.

• VehicleInfo persistida (local)persisted (local)persistida (local) 1 campofieldcampo

  Campo	Model	Entity
  id	@Id int	—
  carLicensePlate	String	String

  Linha única no ObjectBox: o id existe só no Model (chave da box) e é reaproveitado a cada save. A Entity carrega apenas a placa.Single row in ObjectBox: id exists only in the Model (box key) and is reused on every save. The Entity carries just the plate.Fila única en ObjectBox: el id existe solo en el Model (clave de la box) y se reutiliza en cada save. La Entity lleva solo la matrícula.

• DeviceInfo Entity-only 4 camposfieldscampos

  Campo	Entity	Origem (plugin)Origin (plugin)Origen (plugin)
  manufacturer	String	androidInfo.manufacturer
  model	String	androidInfo.model
  sdkInt	int	androidInfo.version.sdkInt
  systemVersion	String	androidInfo.version.release

• JourneyFieldConfig EMC 4 camposfieldscampos

  Campo	Entity	default
  field	JourneyFieldType	unknown
  isVisible	bool	true
  requiresValidation	bool	false
  allowedResourceTypes	List<ResourceTypeItem>	[]

  Getter isEnabledFor(repType): isVisible e (allowedResourceTypes vazio ou contém o tipo). Filtra quais campos da jornada aparecem em Settings.Getter isEnabledFor(repType): isVisible and (allowedResourceTypes empty or contains the type). Filters which journey fields appear in Settings.Getter isEnabledFor(repType): isVisible y (allowedResourceTypes vacío o contiene el tipo). Filtra qué campos de la jornada aparecen en Settings.

• CarLicensePlateDispatcherPayloadInput entrada de escritawrite inputentrada de escritura 4 camposfieldscampos

  Campo	Entity	default
  carLicensePlate	String	—
  resource	ResourceEntity	—
  submittedAt	DateTime	—
  isTradePlate	bool	false

  Input cru (entities de domínio) — toda construção wire (normalizar placa, extrair resourceSfid/username, formatar data, isTradePlate) mora no build() do builder (§36). O Notifier injeta submittedAt: DateTimeUtils.now() e isTradePlate: true.A raw input (domain entities) — all wire construction (normalize the plate, extract resourceSfid/username, format the date, isTradePlate) lives in the builder's build() (§36). The Notifier injects submittedAt: DateTimeUtils.now() and isTradePlate: true.Input crudo (entities de dominio) — toda construcción wire (normalizar matrícula, extraer resourceSfid/username, formatear fecha, isTradePlate) vive en el build() del builder (§36). El Notifier inyecta submittedAt: DateTimeUtils.now() e isTradePlate: true.

Mappers

Só VehicleInfo tem mapper — duas direções (sem JSON/Proto/DTO, é local puro):Only VehicleInfo has a mapper — two directions (no JSON/Proto/DTO, it's local-only):Solo VehicleInfo tiene mapper — dos direcciones (sin JSON/Proto/DTO, es local puro):

A tela consome vários repositórios, mas o único que ela possui é o VehicleInfoRepositoryImpl (implements VehicleInfoRepositoryInterface), que injeta só o datasource local — é local puro, sem rede. Os demais (resource, EMC, updater) são de subsistemas próprios. Método a método:The screen consumes several repositories, but the only one it owns is VehicleInfoRepositoryImpl (implements VehicleInfoRepositoryInterface), which injects only the local datasource — it's local-only, no network. The rest (resource, EMC, updater) belong to their own subsystems. Method by method:La pantalla consume varios repositorios, pero el único que posee es VehicleInfoRepositoryImpl (implements VehicleInfoRepositoryInterface), que inyecta solo el datasource local — es local puro, sin red. Los demás (resource, EMC, updater) son de subsistemas propios. Método a método:

Um card por fonte. A tela usa um datasource ObjectBox próprio (placa) e dois serviços de plataforma (aparelho, versão) — sem datasource remoto de leitura.One card per source. The screen uses its own ObjectBox datasource (plate) and two platform services (device, version) — no remote read datasource.Un card por fuente. La pantalla usa un datasource ObjectBox propio (matrícula) y dos servicios de plataforma (dispositivo, versión) — sin datasource remoto de lectura.

Um dropdown por enum, todos os valores. AppUpdateSeverity (usado pelo card de atualização) pertence ao subsistema de update — não listado aqui.One dropdown per enum, all values. AppUpdateSeverity (used by the update card) belongs to the update subsystem — not listed here.Un dropdown por enum, todos los valores. AppUpdateSeverity (usado por la tarjeta de actualización) pertenece al subsistema de actualización — no listado aquí.

Um dropdown por UseCase, com tipos de retorno exatos.One dropdown per UseCase, with exact return types.Un dropdown por UseCase, con tipos de retorno exactos.

O SettingsNotifier (@riverpod, FutureOr<SettingsState> build()) monta a tela. O build() dispara as cinco leituras em paralelo (resource, device info, package info, market config, vehicle info) e faz await de todas; resolve o tipo de representante e filtra os campos da jornada visíveis em Settings. O State (SettingsState, Freezed) é a fonte única de verdade da page. Diferente das telas de lista, aqui não há refresh() de pull-to-refresh — a page não tem esse gesto; o erro é recuperado via ref.invalidate na tela de falha.The SettingsNotifier (@riverpod, FutureOr<SettingsState> build()) assembles the screen. build() fires the five reads in parallel (resource, device info, package info, market config, vehicle info) and awaits them all; resolves the rep type and filters journey fields visible in Settings. The State (SettingsState, Freezed) is the page's single source of truth. Unlike list screens, there's no pull-to-refresh refresh() here — the page has no such gesture; errors recover via ref.invalidate on the failure view.El SettingsNotifier (@riverpod, FutureOr<SettingsState> build()) arma la pantalla. El build() dispara las cinco lecturas en paralelo (resource, device info, package info, market config, vehicle info) y hace await de todas; resuelve el tipo de representante y filtra los campos de la jornada visibles en Settings. El State (SettingsState, Freezed) es la fuente única de verdad de la page. A diferencia de las pantallas de lista, aquí no hay refresh() de pull-to-refresh — la page no tiene ese gesto; el error se recupera vía ref.invalidate en la vista de fallo.

MétodosMethodsMétodos

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

A SettingsPage (ConsumerWidget) observa o settingsProvider. Loading e erro são globais (stateAsync.when); o conteúdo existe só no ramo data. Cada card decide sozinho se aparece (early-return SizedBox.shrink()). Todos os cards usam o container compartilhado SettingsCardWidget (raio xxl30). Árvore de composição:SettingsPage (ConsumerWidget) watches settingsProvider. Loading and error are global (stateAsync.when); content exists only in the data branch. Each card decides on its own whether to render (early-return SizedBox.shrink()). All cards use the shared SettingsCardWidget container (radius xxl30). Composition tree:La SettingsPage (ConsumerWidget) observa el settingsProvider. Loading y error son globales (stateAsync.when); el contenido existe solo en la rama data. Cada tarjeta decide por sí sola si aparece (early-return SizedBox.shrink()). Todas usan el container compartido SettingsCardWidget (radio xxl30). Árbol de composición:

• SettingsPage
  • AppPageShell displayBackButton
    • CustomLoadingIndicator loading
    • FailureStateView error → invalidate
    • SingleChildScrollView data
      • DataLoadInfo lastSyncAt
      • SettingsHeaderWidget gear + título
      • SettingsUpdateAvailableCardWidget Android + severity.requiresPrompt → showAppUpdateModal
      • SettingsAccountCardWidget version · user · type · primary
      • SettingsCarPlateCardWidget showField(carLicensePlate) → CustomInput readOnly
        • SettingsCarPlateEditModalContent modal · input + validação → saveCarLicensePlate → ConectaNotice.success
      • SettingsSystemInfoCardWidget Android · manufacturer · model · SDK · versão