06 — Aplicativo Offline-First e Realtime

Status: DECIDIDO

Decisão

O Aplicativo é offline-first com sincronia de dados e com atualização em realtime quando há conexão.

• Offline-first: o atleta registra resultados sem internet (na quadra, no tatame, no ginásio com sinal ruim), e o dado sincroniza quando a conexão volta.
• Realtime: quando conectado, ranking e feed atualizam ao vivo.

Porquê

O uso real do app acontece exatamente nos lugares de pior sinal — quadras, tatames, ginásios de evento. Um app que exige conexão para registrar um resultado falharia no momento crítico. Offline-first não é um luxo, é requisito do cenário de uso.

Implicações (pesam na escolha da stack — Fase 1)

Offline-first com sincronia é tecnicamente exigente e toca o schema. Decisões a fechar no scaffold:

• Tipo de ID — gerados no cliente (uuid) para permitir criação offline sem colisão.
• Fila de operações pendentes — registrar ações offline e reproduzi-las na sincronia.
• Resolução de conflitos — política para quando o mesmo dado muda em dois lugares.

Por isso a escolha da tecnologia de frontend/sincronia é a primeira decisão técnica da Fase 1 — ela influencia o modelo de dados antes de o schema ser cravado.