Jumbox
Sistema privado e local-first de transferência de arquivos, com streaming retomável e integridade ponta a ponta.
O desafio
Compartilhar arquivos na mesma rede local ou Wi-Fi ainda costuma significar rotear tudo por um serviço de nuvem de terceiros, e quando uma transferência grande é interrompida, é preciso recomeçar do zero — não existe uma forma direta e privada de simplesmente enviar arquivos de uma máquina para outra na rede com resiliência embutida.
Entrega de engenharia
O Jumbox foi construído como um serviço FastAPI self-hosted com um modelo de domínio em camadas (um agregado TransferSession que gerencia entidades TransferItem), expondo sessões de transferência multi-arquivo sob um código de 8 dígitos ou QR code que outros dispositivos na rede local podem escanear. Os uploads usam um protocolo de chunks retomável (PATCH .../chunks com sondagem via Upload-Offset) que sobrevive a quedas de rede sem retransmitir bytes já aceitos, com novas tentativas automáticas usando backoff exponencial. Cada transferência é verificada ponta a ponta via SHA-256 com headers de checksum e ETag, os downloads fazem streaming direto para o disco com suporte a Accept-Ranges para evitar buffer de arquivos grandes em memória, e um modo efêmero opcional apaga os arquivos do disco assim que o destinatário faz o download. Roda sem configuração em SQLite para uso standalone ou em Postgres via Docker Compose para uma stack de produção, com SQLAlchemy 2.0 e migrações Alembic por baixo.