Arquitetura

Como Android, Desktop, Relay e as libs compartilhadas se conectam, e como a sincronização entre dispositivos funciona.

O Acerola é um monorepo: cada plataforma vive isolada, com sua própria stack, e nenhuma depende diretamente de outra. Todas consomem as bibliotecas compartilhadas em lib/ via dependência de caminho local — uma mudança em lib/p2p/ já reflete direto nos consumidores.

acerola/android

Kotlin + Jetpack Compose

acerola/desktop

Rust + Tauri + Svelte 5

acerola/relay

Serviço de acesso remoto (Rust) — ainda não iniciado

lib/p2p

Biblioteca P2P compartilhada (iroh / QUIC)

lib/relay

Código do relay iroh vendorizado

Como as peças se conectam

acerola/android/ e acerola/desktop/ nunca se enxergam diretamente — cada um implementa sua própria FFI/binding para consumir lib/p2p/. Toda comunicação entre dispositivos é P2P direta (LAN via mDNS) ou via relay quando fora da mesma rede.

flowchart LR Android["Android"] --> P2P["lib/p2p biblioteca compartilhada"] Desktop["Desktop"] --> P2P P2P --> Relay["Relay acesso remoto, sem abrir portas"]

Como a sincronização funciona

A biblioteca, o histórico e o progresso de leitura sincronizam diretamente entre os dispositivos do usuário — sem conta e sem banco de dados central. A forma como a conexão acontece depende de onde os dispositivos estão e do que foi configurado:

flowchart TD Start["Dois dispositivos querem sincronizar"] --> LAN{"Mesma rede local?"} LAN -->|Sim| MDNS["Descoberta via mDNS gratuito, 100% local"] LAN -->|Não| Relay{"Relay configurado?"} Relay -->|Nenhum| NoSync["Sem sincronização remota"] Relay -->|Público do iroh| IrohRelay["Relay público do iroh NAT traversal, gratuito"] Relay -->|Do usuário| UserRelay["acerola-relay próprio self-hosted, MPL-2.0"] Relay -->|Hospedado pelo Acerola| PaidRelay["Relay do Acerola tier pago"]

Os quatro formatos de conexão:

Descoberta local (mDNS)

Padrão e gratuito. Os dispositivos se encontram sozinhos na mesma rede Wi-Fi/LAN — nenhum tráfego sai da rede local.

Relay público do iroh

Quando os dispositivos não estão na mesma rede, a infraestrutura pública do iroh viabiliza a conexão (NAT traversal). Só retransmite tráfego QUIC criptografado ponta a ponta — nunca vê o conteúdo.

Relay do próprio usuário

Qualquer um pode rodar sua própria instância do acerola-relay (open source, MPL-2.0) numa VPS própria. Nenhuma infraestrutura de terceiros entra na jogada.

Relay hospedado pelo Acerola

Alternativa paga em que a infraestrutura de relay é operada pelo time do Acerola — mesma garantia de criptografia ponta a ponta dos outros modos.

Nos quatro casos o handshake e o transporte são os mesmos (QUIC + TLS 1.3 via iroh) — só muda quem intermedeia a conexão quando os dispositivos não estão na mesma rede. Detalhes sobre quais metadados cada modo expõe estão na Política de Privacidade.