====== Flujo P2P y ejemplos de sincronización ======

===== Flujo general de P2P =====

El flujo central de sincronización P2P en ''RutaPAE'' es:

  - Inicializar ''DomainManager''.
  - Iniciar ''P2PManager.start()''.
  - Detectar peers y hotspots.
  - Conectar con la máquina deseada.
  - Descargar entregas pendientes.
  - Confirmar entregas sincronizadas al dispositivo remoto.

===== Diagrama de conexión P2P =====

<code>
flowchart TD
    A[RutaPAE inicia] --> B[DomainManager.init()]
    B --> C[P2PManager.start()]
    C --> D[Descubrir peers y hotspots]
    D --> E{Máquina conocida?}
    E -->|Sí| F[connectMachine]
    E -->|No| G[connectDiscoveredMachine]
    G --> H[resolveConnectedPeerAddress]
    F --> H
    H --> I[SyncDeliveriesFromMachine]
    I --> J[GET /p2p/machine/deliveries/<page>/<size>]
    I --> K[GET /p2p/machine/delivery/<id>]
    I --> L[GET /p2p/machine/delivery/synchronized/<id>]
    L --> M[Eliminar entrega local sincronizada]
</code>

===== Ejemplo 1: conectar una máquina conocida =====

  - El usuario elige una máquina de la lista.
  - ''RutaPAE'' llama ''P2PManager.connectMachine(machineDatabaseId)''.
  - ''P2PManager'' intenta resolver la dirección del peer conectado.
  - Si no hay peer conectado, busca en ''discoveredPeers''.
  - Si hay hotspot, intenta ''connectHotspot''.
  - Una vez conectado, ''syncDeliveriesFromMachine()'' puede iniciar.

===== Ejemplo 2: conectar una máquina descubierta =====

  - Aparece un peer desconocido en ''discoveredPeers''.
  - Se muestra como candidato en la UI.
  - El usuario solicita conexión.
  - Se invoca ''P2PManager.connectDiscoveredMachine(address)''.
  - El gestor intenta conectar y espera que el peer pase a ''machines''.

===== Ejemplo 3: unir a un hotspot de máquina =====

  - El sistema detecta ''hotspotCandidates''.
  - Si el hotspot es abierto, o tiene passphrase, se intenta conectar automáticamente.
  - Si no puede auto-unir, busca un peer descubierto como fallback.
  - Tras unirse, espera que aparezca el peer en ''machines''.

===== Tipos de descubrimiento =====

  * ''discoveredPeers'': peers P2P que han sido detectados pero no necesariamente conectados.
  * ''machines'': peers ya reconocidos como máquinas (''MACHINE-...'').
  * ''operators'': peers reconocidos como operadores (''OPERATOR-...'').
  * ''hotspotCandidates'': redes Wi-Fi creadas por una máquina.

===== Sincronización de entregas =====

==== Iteración de páginas ====

  * ''P2PManager'' solicita ''DELIVERIES_PAGE(page, size)''.
  * En el proyecto actual, ''pageSize'' se fija en ''1''.
  * Obtiene ''deliveryIds'' y procesa cada ''DELIVERY(id)''.

==== Creación local ====

Para cada entrega remota:

  * Si no existe localmente, se descarga ''P2PDeliveryData''.
  * Se crea un ''Delivery'' local con ''idLocalDeliveryT = remoteDeliveryId''.
  * Si ya existe, se marca como ''alreadyPresent''.

==== Confirmación de entrega sincronizada ====

Una vez que ''RutaPAE'' confirma una entrega remota sincronizada:

  * Llama ''notifyDeliverySynchronized(machineDatabaseId, remoteDeliveryId)''.
  * Esto invoca ''DELIVERY_SYNCHRONIZED(id)''.
  * Si la máquina responde ''deleted: true'', la entidad local puede borrarse.

===== Resiliencia de flujo =====

  * El proceso monitorea la conexión con ''monitorMachineSyncConnection()''.
  * Si se pierde la conexión, se pausa la sincronización y mantiene el estado de UI.
  * Los mensajes de estado se muestran en la UI usando ''DeliverySyncUiEmitter''.

===== Ejemplo de actualización de configuración =====

  - El operador solicita la configuración de la máquina.
  - ''getMachineConfiguration(machineDatabaseId)'' llama a ''GET /p2p/machine/configuration''.
  - El operador modifica valores locales.
  - ''updateMachineConfiguration(machineDatabaseId, configuration)'' hace ''PUT /p2p/machine/configuration''.
  - La máquina responde con ''P2PMachineConfigurationUpdateResponse''.