MCI Telemetry

A plataforma de dados

O MCI Telemetry é a API de ingestão na nuvem e o painel web de 2026 que acompanham o estudo em realidade virtual do Project MCI. Ele recebe os registros comportamentais das sessões do jogo, armazena esses dados e oferece aos pesquisadores uma interface controlada para revisar sessões e questionários.

Construí a plataforma como um sistema full stack com Next.js, PostgreSQL no Neon, armazenamento privado de objetos no Cloudflare R2 e deploy na Vercel. A aplicação ainda está em evolução, e o fluxo de trabalho foi desenhado em torno do processo da pesquisa piloto.

Ingestão e acesso

Implementei a ingestão autenticada por chave de API separada da autenticação do navegador, para que o jogo possa enviar uma sessão sem receber permissões do painel. Novas tentativas de envio reutilizam um identificador canônico de sessão e uma chave de objeto estável, e depois reconciliam os metadados no PostgreSQL com o NDJSON armazenado no próximo upsert bem-sucedido.

Uma camada de armazenamento grava arquivos locais em desenvolvimento e objetos privados no Cloudflare R2 em produção. As exportações filtradas em CSV e JSON transmitem as sessões em ordem determinística em vez de carregar o conjunto completo na memória, e as migrações de produção usam uma conexão separada sem pool no Neon, com novas tentativas limitadas.

O painel tem um administrador inicial e contas de envio guardadas no banco. Administradores podem consultar, filtrar e exportar sessões ou gerenciar usuários, enquanto as contas de envio ficam restritas ao fluxo de upload de questionários; redefinir a senha ou desativar uma conta invalida as sessões ativas por meio do versionamento de credenciais.

Vínculo com os questionários

O serviço de upload aceita dois formatos de CSV do REDCap, identifica cada um pelo cabeçalho e remove nomes e telefones antes de salvar os registros. Ele calcula uma janela de tempo a partir das atividades antes e depois do jogo, ou do horário do registro quando só há uma exportação de dados, e então vincula automaticamente exatamente uma sessão de jogo elegível.

Quando não há correspondência, o registro fica sem vínculo, e várias correspondências são guardadas como ambiguidade para um administrador resolver. Vínculos manuais sobrevivem a novos uploads e à revinculação automática, e a visualização da sessão reúne as respostas brutas, os rótulos do dicionário e as pontuações calculadas de SBSOD, SUS, VRSQ, VIMSSQ-short, EVA e IPQ.