+ Tesseras
+ Fase 3: Memórias nas Suas Mãos
+2026-02-14
+As pessoas agora podem segurar suas memórias nas próprias mãos. A Fase 3 entrega +o que as fases anteriores construíram: um app mobile onde alguém baixa o +Tesseras, cria uma identidade, tira uma foto, e aquela memória entra na rede de +preservação. Sem contas na nuvem, sem assinaturas, sem nenhuma empresa entre +você e suas memórias.
+O que foi construído
+tesseras-embedded — Um nó P2P completo que roda dentro de um app mobile. A
+struct EmbeddedNode é dona de um runtime Tokio, banco SQLite, transporte QUIC,
+engine Kademlia DHT, serviço de replicação e serviço de tessera — a mesma stack
+do daemon desktop, compilada como biblioteca compartilhada. Um padrão singleton
+global (Mutex<Option<EmbeddedNode>>) garante um único nó por ciclo de vida do
+app. Ao iniciar, ele abre o banco de dados, executa migrações, carrega ou gera
+uma identidade Ed25519 com proof-of-work para o node ID, faz bind QUIC numa
+porta efêmera, conecta DHT e replicação, e inicia o loop de reparo. Ao parar,
+envia um sinal de shutdown e drena graciosamente.
Onze funções FFI são expostas para Dart via flutter_rust_bridge: ciclo de vida
+(node_start, node_stop, node_is_running), identidade (create_identity,
+get_identity), memórias (create_memory, get_timeline, get_memory) e
+status da rede (get_network_stats, get_replication_status). Todos os tipos
+que cruzam a fronteira FFI são structs planas com apenas String,
+Option<String>, Vec<String> e primitivos — sem trait objects, sem generics,
+sem lifetimes.
Quatro módulos adaptadores fazem a ponte entre as ports do core e as
+implementações concretas: Blake3HasherAdapter,
+Ed25519SignerAdapter/Ed25519VerifierAdapter para criptografia,
+DhtPortAdapter para operações DHT, e ReplicationHandlerAdapter para RPCs de
+fragmentos e atestação recebidos.
A feature flag bundled-sqlite compila o SQLite a partir do código-fonte,
+necessário para Android e iOS onde a biblioteca do sistema pode não estar
+disponível. A configuração do Cargokit passa essa flag automaticamente em builds
+de debug e release.
App Flutter — Uma aplicação Material Design 3 com gerenciamento de estado +Riverpod, direcionada para Android, iOS, Linux, macOS e Windows a partir de uma +única base de código.
+O fluxo de onboarding são três telas: uma tela de boas-vindas explicando o +projeto em uma frase ("Preserve suas memórias através dos milênios. Sem nuvem. +Sem empresa."), uma tela de criação de identidade que dispara a geração do par +de chaves Ed25519 em Rust, e uma tela de confirmação mostrando o nome do usuário +e a identidade criptográfica.
+A tela de timeline exibe memórias em ordem cronológica reversa com previews de
+imagem, texto de contexto e chips para tipo de memória e visibilidade.
+Pull-to-refresh recarrega a partir do nó Rust. Um floating action button abre a
+tela de criação de memória, que suporta seleção de foto da galeria ou câmera
+via image_picker, texto de contexto opcional, dropdowns de tipo de memória e
+visibilidade, e tags separadas por vírgula. Criar uma memória chama o FFI Rust
+sincronamente, depois retorna à timeline.
A tela de rede mostra dois cards: status do nó (contagem de peers, tamanho da +DHT, estado de bootstrap, uptime) e saúde da replicação (total de fragmentos, +fragmentos saudáveis, fragmentos em reparo, fator de replicação). A tela de +configurações exibe a identidade do usuário — nome, node ID truncado, chave +pública truncada e data de criação.
+Três providers Riverpod gerenciam o estado: nodeProvider inicia o nó embarcado
+ao abrir o app usando o diretório de documentos e para ao fazer dispose;
+identityProvider carrega o perfil existente ou cria um novo;
+timelineProvider busca a lista de memórias com paginação.
Testes — 9 testes unitários Rust em tesseras-embedded cobrindo ciclo de vida +do nó (start/stop sem panic), persistência de identidade entre reinícios, ciclos +de reinício sem corrupção do SQLite, streaming de eventos de rede, recuperação +de estatísticas, criação de memória e recuperação da timeline, e busca de +memória individual por hash. 2 testes Flutter: um teste de integração +verificando inicialização do Rust e startup do app, e um smoke test de widget.
+Decisões de arquitetura
+-
+
- Nó embarcado, não cliente-servidor: o celular roda a stack P2P completa, +não um thin client conversando com um daemon remoto. Isso significa que +memórias são preservadas mesmo sem internet. Usuários com um Raspberry Pi ou +VPS podem opcionalmente conectar o app ao seu daemon via GraphQL para maior +disponibilidade, mas não é obrigatório. +
- FFI síncrono: todas as funções flutter_rust_bridge são marcadas como
+
#[frb(sync)]e bloqueiam no runtime Tokio interno. Isso simplifica o lado +Dart (sem complexidade de bridge assíncrono) enquanto o lado Rust lida com +concorrência internamente. A UI thread do Flutter permanece responsiva porque +o Riverpod envolve as chamadas em providers assíncronos.
+ - Singleton global: um global
Mutex<Option<EmbeddedNode>>garante que o +ciclo de vida do nó seja previsível — um start, um stop, sem race conditions. +Plataformas mobile matam processos agressivamente, então simplicidade no +gerenciamento de ciclo de vida é uma feature.
+ - Tipos FFI planos: nenhuma abstração Rust vaza pela fronteira FFI. Todo +tipo é uma struct plana com strings e números. Isso torna os bindings Dart +auto-gerados confiáveis e fáceis de debugar. +
- Onboarding de três telas: a criação de identidade é o único passo +obrigatório. Sem email, sem senha, sem registro em servidor. O app gera uma +identidade criptográfica localmente e está pronto para uso. +
O que vem a seguir
+-
+
- Fase 4: Resiliência e Escala — NAT traversal avançado (STUN/TURN), +Shamir's Secret Sharing para herdeiros, tesseras seladas com criptografia +temporal, ajuste de performance, auditorias de segurança, empacotamento para +Alpine/Arch/Debian/FreeBSD/OpenBSD +
- Fase 5: Exploração e Cultura — Navegador público de tesseras por +era/localização/tema/idioma, curadoria institucional, integração com +genealogia, exportação para mídia física (M-DISC, microfilme, papel livre de +ácido com QR) +
A infraestrutura está completa. A rede existe, a replicação funciona, e agora +qualquer pessoa com um celular pode participar. O que resta é fortalecer o que +temos e abrir para o mundo.
+ +