PolyField Server

O servidor de controlo de provas de campo. Uma aplicação de ambiente de trabalho gere a competição na rede do seu recinto: guarda as provas e os atletas, recebe resultados em direto da aplicação de campo PolyField, comanda os ecrãs de apresentação em direto, regista o vento, produz estatísticas e visuais para redes sociais e (opcionalmente) publica resultados na nuvem. Funciona em Windows e Mac; opera numa rede local.

Transferir a partir de polyfield.co.uk

• PolyField Server
  • Visão geral
  • Como funciona
  • Primeiros passos
    • 1. Carregar uma competição
    • 2. Ligar a aplicação de campo
    • 3. Abrir os ecrãs
  • O painel
  • Importar provas
  • Resultados e a aplicação de campo
  • Ecrãs de apresentação
    • Painel de resultados
    • Classificações das provas
    • Locutor
    • Classificações RAZA
  • Anemómetros
  • Estatísticas e mapas de calor
  • Visuais para redes sociais
  • Resultados na nuvem - Em Teste
  • Ligação à competição
  • Definições, tamanho de apresentação e idioma
  • Rede
  • Diagnóstico
  • Resolução de problemas
  • Transferência e apoio
  • Integração da API
    • Lista de provas
    • Detalhe completo da prova
    • Fluxo dos últimos resultados
    • Classificações
    • Saltador horizontal atual
    • Atualizações em direto (stream)
    • Enviar dados

Visão geral

O PolyField Server é o centro de uma competição de provas de campo. Corre num único computador na rede do recinto e faz quatro coisas em simultâneo:

• Guarda a competição — as provas, os escalões etários, os atletas e cada tentativa, tudo armazenado localmente no computador anfitrião.
• Recebe resultados — os oficiais medem no círculo ou na pista de balanço com a aplicação de campo PolyField (num dispositivo Android ligado a uma estação total EDM, ou introduzidos à mão), e a aplicação envia cada marca diretamente para o servidor.
• Comanda os ecrãs — disponibiliza um conjunto de páginas web que qualquer ecrã na rede abre num navegador: um painel de resultados em direto, os classificações das provas, um fluxo para o locutor e as classificações de para-atletismo RAZA.
• Acrescenta análise — captura de vento, estatísticas por prova e mapas de calor das quedas, visuais para redes sociais e publicação opcional na nuvem PolyField.

Tudo funciona na rede local — não é necessária ligação à Internet para gerir uma competição, mas é necessária para transferir as listas de partida dos fornecedores de gestão de competições e para reenviar os resultados em tempo real para os seus sistemas. É possível uma sincronização após o concurso para enviar todos os resultados de uma só vez.

Validação positiva. O servidor nunca inventa resultados — cada marca provém de um oficial através da aplicação de campo. Isto garante uma cadeia clara, da medição no círculo até ao que aparece no painel.

Como funciona

• Executa uma instância da aplicação de ambiente de trabalho num computador da rede da competição.
• A aplicação de campo (uma por prova) liga-se ao servidor, transfere os atletas da sua prova e envia cada tentativa à medida que é medida.
• Cada ecrã de apresentação abre uma das páginas web do servidor num navegador; os resultados atualizam-se instantaneamente, sem necessidade de recarregar.
• O operador trabalha a partir do painel de ambiente de trabalho — importando provas, acompanhando o progresso, exportando estatísticas e visuais e gerindo ecrãs e anemómetros. Geralmente são configurados uma vez no início da competição, sem necessidade de interação ao longo do dia.

Primeiros passos

1. Carregar uma competição

Abra a aplicação; o Painel é a base do operador. Inicie uma competição de uma de três formas:

• Importar do OpenTrack ou do Athletics.app — obtenha a lista de provas e as listas de partida diretamente (ver Importar provas). Este é o caminho habitual e preserva a ordem publicada da lista de partida.
• Criar provas manualmente — utilize + Criar Nova Prova e adicione atletas.
• Nova Competição — limpa os dados atuais para começar de novo.

Depois de carregada, cada prova surge como um cartão no painel, mostrando o seu estado (Não Iniciada, Em Curso, Terminada).

2. Ligar a aplicação de campo

Em cada dispositivo de campo, verifique o endereço do servidor na aplicação de campo PolyField para o ligar ao servidor. O oficial seleciona então a sua prova, calibra o EDM ao círculo ou à pista de balanço e começa a medir. Ver Resultados e a aplicação de campo.

3. Abrir os ecrãs

Em cada dispositivo de apresentação, abra um navegador no endereço do servidor e adicione a página que pretende — por exemplo http://polyfieldserver.local:8080/tables. Utilize Ecrãs no painel para obter ligações num clique e códigos QR de leitura rápida para cada ecrã. Ver Ecrãs de apresentação.

Dica. Deixe a aplicação de ambiente de trabalho no painel e comande tudo a partir daí. Os resultados chegam automaticamente da aplicação de campo enquanto acompanha o progresso e os ecrãs.

O painel

O painel lista todas as provas e disponibiliza os controlos principais. No topo está o endereço do servidor (com um seletor de rede em máquinas com vários adaptadores) e qualquer estado pendente de envio ou sincronização. As ações principais:

Ao selecionar uma prova abre-se a sua vista de Resultados em Direto, onde pode ver a série de cada atleta, acompanhar a chegada das tentativas e rever a classificação.

Importar provas

Utilize Ligação à Competição / importar para trazer uma competição em vez de a digitar:

• OpenTrack — inicie sessão e escolha a sua competição; o servidor transfere as provas de campo e as respetivas inscrições. A ordem da lista de partida publicada pelo OpenTrack é preservada exatamente.
• Athletics.app — introduza o código de ligação da competição para criar as provas e os atletas. A ordem da lista de partida publicada pelo Athletics.app é preservada exatamente.

As provas importadas mantêm a numeração e os códigos de origem, pelo que ficam alinhadas com o programa publicado e com a exportação de resultados.

Resultados e a aplicação de campo

Os resultados são registados no campo, não no servidor. Cada prova utiliza a aplicação de campo PolyField num dispositivo Android:

• O dispositivo liga-se ao servidor e transfere os atletas da prova escolhida.
• Para lançamentos e saltos horizontais, a aplicação pode ser emparelhada com uma estação total EDM ou correr diretamente numa PolyField Total Station (PolyField APEKS AM02i); o oficial calibra ao círculo/pista/tábuas e cada marca medida (com a coordenada de queda) é enviada para o servidor. As marcas também podem ser introduzidas à mão.
• Os saltos verticais (salto em altura, salto com vara) são totalmente suportados — as alturas, as transposições (O/X) e a progressão da fasquia são registadas e enviadas.
• Cada tentativa tem a sua própria marca temporal, pelo que o servidor mostra os resultados pela verdadeira ordem em que ocorreram e pode produzir estatísticas de tempo rigorosas.

À medida que os resultados chegam, o cartão da prova atualiza-se, as classificações são recalculadas e qualquer ecrã ligado atualiza-se instantaneamente.

Ecrãs de apresentação

O servidor disponibiliza quatro páginas de apresentação em direto. Cada uma é uma página web normal — abra-a em qualquer navegador na rede; nada é instalado no ecrã. Todas se atualizam automaticamente: os novos resultados são enviados no momento em que chegam, com uma sondagem periódica como rede de segurança, pelo que um ecrã nunca precisa de ser recarregado manualmente.

Painel de resultados

Um painel de grande ecrã com os desempenhos mais recentes, com o atleta, a prova, a marca e — para lançamentos — uma visualização da queda. Ideal como ecrã principal de resultados para os espetadores.

Classificações das provas

Classificações em direto, várias provas de cada vez, cada uma ordenada com destaques de ouro/prata/bronze. O esquema adapta-se à altura: preenche o ecrã, empilha mais provas em ecrãs altos ou verticais e, quando uma prova tem muitos atletas, percorre-os página a página. As provas também rodam para que todas as provas do programa tenham tempo de ecrã.

Locutor

Um fluxo contínuo de resultados à medida que chegam — o mais recente no topo, com posição, atleta, clube, prova e marca — dimensionado para um locutor ou posição de comentário ler num relance.

Classificações RAZA

Classificações de para-atletismo pontuadas com o sistema de pontos World Para Athletics (RAZA), para que atletas de diferentes classificações possam ser comparados num só painel. Os atletas precisam de uma classificação e de género definidos para que uma pontuação RAZA seja calculada.

Anemómetros

O PolyField Server lê anemómetros através da rede e regista o vento durante todo o dia de competição. Suporta o Gill WindSonic 75 e o PolyField Wind Mini, e deteta automaticamente o tipo de anemómetro a partir do seu fluxo de dados — não há protocolo a escolher. Adicione um anemómetro com o seu endereço de rede; assim que transmitir, o servidor mostra o modelo detetado e começa a registar.

• O vento é captado continuamente e guardado por dia, ficando disponível para a legalidade dos saltos horizontais, as estatísticas e os gráficos de vento.
• A página Anemómetros mostra cada anemómetro em direto e permite exportar um gráfico de vento de dia completo.
• Os anemómetros podem ser ocultados da seleção de atletas (por exemplo, um anemómetro geral de pista mantido apenas para registo).

Estatísticas e mapas de calor

A página Estatísticas transforma os dados da competição em análise:

• Gráficos por prova — desempenho ao longo do tempo, comparação ronda a ronda, taxa de nulos e de sucesso e tempo entre tentativas.
• Mapas de calor das quedas — para provas de lançamento, cada queda representada no setor, colorida por ronda, com o ângulo médio de queda relativo à linha central do setor, dispersão e variância.
• Vento — média, legalidade e a tendência ao longo da sessão para cada anemómetro.
• Exportar Estatísticas — um PDF completo da competição com os gráficos, mapas de calor e resumos por prova, datado do dia da competição.

Os gráficos e mapas de calor ajustam-se à definição de tamanho de apresentação, mantendo-se legíveis no ecrã do operador.

Visuais para redes sociais

Exportar Gráficos produz um conjunto de imagens quadradas (1080×1080) prontas a publicar, todas num estilo PolyField consistente:

• Resumo da competição — totais principais do encontro, com o lançamento e o salto mais longos.
• Cartões por prova — os três primeiros, as condições e os totais da prova. Os cartões de salto vertical mostram a série de transposições de cada atleta na sua melhor altura e uma repartição da taxa de sucesso à 1.ª/2.ª/3.ª tentativa; os cartões de salto horizontal mostram o vento.
• Mapas de calor detalhados — a dispersão completa das quedas de cada prova de lançamento.
• Gráficos de vento — a tendência do vento de dia completo para cada anemómetro, com legalidade e rajadas.

Os visuais são produzidos apenas para as provas que decorreram, e cada cartão inclui a data da competição e a identidade visual PolyField.

Resultados na nuvem - Em Teste

Opcionalmente, o servidor publica os resultados na nuvem PolyField para que os espetadores possam acompanhar online em results.polyfield.co.uk. Podem ser enviados dois elementos, cada um alternável nas Definições:

• Resultados e mapas de calor dos atletas — páginas individuais de atletas anonimizadas para reduzir a informação identificável guardada com as suas marcas, e um mapa de calor das quedas. Estas serão eliminadas automaticamente após 90 dias.
• Mapa de calor global — uma imagem agregada das quedas de toda a competição. É anonimizada, sem dados individuais dos atletas, e é mantida indefinidamente.

Os envios são colocados em fila e repetidos, pelo que uma breve perda de Internet não perde dados — a própria competição continua a funcionar na rede local independentemente disso.

Ligação à competição

Ligação à Competição é onde liga os fornecedores de gestão de competições ao servidor. Os controlos de importação do OpenTrack / Athletics.app para carregar as provas.

Definições, tamanho de apresentação e idioma

• Tamanho de apresentação — ajusta a interface do operador, os gráficos de estatísticas e os mapas de calor ao ecrã em que corre o servidor.
• Idioma — a interface está disponível em inglês, francês, espanhol, neerlandês e português.
• Envio para a nuvem — ative ou desative a publicação de atletas e de mapas de calor.
• Diretorias — defina as pastas usadas para a importação de provas, as pastas de cópia de segurança no PC local e a exportação de resultados e visuais.

Rede

• A aplicação serve na porta 8080 e anuncia polyfieldserver.local, pelo que os dispositivos de campo e os ecrãs podem usar http://polyfieldserver.local:8080 sem o endereço IP. Alguns dispositivos Android exigem o endereço IP completo, pelo que também pode usar http://192.168.0.10:8080, substituindo 192.168.0.10 pelo endereço do servidor anunciado no Painel.
• Em computadores com mais do que um adaptador de rede (comum no Windows), escolha o adaptador correto no topo do painel para que o endereço certo seja anunciado.
• Todos os dispositivos — aplicações de campo e ecrãs — devem estar na mesma rede que o computador anfitrião.

Diagnóstico

Se algo correr mal, utilize o relatório de diagnóstico. Ele reúne a competição atual (que o apoio pode reproduzir), os registos e os dados de vento do dia num único ficheiro zip, e preenche previamente um e-mail para support@polyfield.co.uk. Anexe o ficheiro guardado antes de enviar. O mesmo pacote pode ser usado para recuperar uma competição se for necessário trocar de máquina a meio do encontro.

Resolução de problemas

Transferência e apoio

Transfira a versão mais recente em www.polyfield.co.uk ou na página de versões. A aplicação verifica se há atualizações no arranque e mostra um aviso quando está disponível uma versão mais recente. Apoio: support@polyfield.co.uk.

Integração da API

O PolyField Server disponibiliza uma API simples em HTTP + JSON para que outro software na rede do recinto — placares, gráficos de transmissão, widgets de apresentação personalizados ou um arquivo de resultados — possa ler a competição em direto e, quando apropriado, enviar dados. Foi concebida apenas para a rede local (LAN): o servidor escuta na porta 8080 em http://polyfieldserver.local:8080 (ou no IP do anfitrião, ex.: http://192.168.0.10:8080), em HTTP simples, sem autenticação — confia em todos os dispositivos da rede do recinto. Mantenha essa rede privada; não exponha a porta 8080 à Internet. Qualquer integração virada para a WAN / Internet (aceder ao servidor a partir de fora do recinto, ou publicar para além dos resultados na nuvem já incorporados) exige um caminho seguro e autenticado e deve ser discutida connosco primeiro — contacte support@polyfield.co.uk antes de desenvolver contra um endereço público.

Todos os pontos de acesso abaixo têm o prefixo /api/v1. As leituras são GET, devolvem application/json e atualizam-se no momento em que os resultados chegam. Para se manter em direto, abra o fluxo de Server-Sent Events GET /api/v1/stream e releia o fluxo que lhe interessa sempre que este emitir um evento update (ou sonde a cada um ou dois segundos).

As marcas são cadeias de texto para poderem conter resultados não numéricos: uma distância/altura como "54.37", ou "NM" (sem marca / nulo), "X" (altura falhada), "P"/"-" (passe). wind é uma cadeia em metros por segundo (ex.: "+1.2") ou ausente. As coordinates dos lançamentos incluem tanto a queda em bruto (x, y) como a rx/ry rodada e relativa ao centro do círculo, em metros.

Lista de provas

GET /api/v1/events

[
  { "id": "T01", "name": "F09 O Discus Throw", "type": "Throws" },
  { "id": "T02", "name": "F03 O Long Jump", "type": "Horizontal Jumps" }
]

type é um de Throws, Horizontal Jumps ou Vertical Jumps.

Detalhe completo da prova

GET /api/v1/events/{id}

{
  "id": "T01",
  "name": "F09 O Discus Throw",
  "type": "Throws",
  "status": "In Progress",
  "rules": { "attempts": 6, "cutEnabled": false, "cutQualifiers": 0 },
  "signedOff": true,
  "signedOffBy": "A. Referee",
  "signedOffAt": "2026-09-24T17:55:00+01:00",
  "calibrationMetadata": {
    "circleType": "DISCUS",
    "circleRadius": 1.25,
    "sectorLines": { "rightLine": { "x": 6.18, "y": 19.64 }, "leftLine": { "x": -6.18, "y": 19.64 }, "sectorAngle": 34.92 }
  },
  "athletes": [
    {
      "bib": "1", "order": 1, "name": "Dillon Claydon", "club": "Blackheath & Bromley HAC",
      "series": [
        {
          "attempt": 1, "mark": "54.37", "unit": "m", "valid": true, "wind": null,
          "coordinates": { "x": -1.54, "y": 19.08, "distance": 54.37, "round": 1, "attempt": 1, "valid": true, "rx": 1.68, "ry": 55.61 }
        }
      ]
    }
  ]
}

Fluxo dos últimos resultados

GET /api/v1/broadcast/recent — as 10 tentativas mais recentes, mais recentes primeiro.

{
  "results": [
    {
      "eventId": "T01", "eventName": "F09 O Discus Throw", "eventType": "Throws",
      "athleteBib": "1", "athleteName": "Dillon Claydon", "athleteClub": "Blackheath & Bromley HAC",
      "athleteBest": "55.80", "attempt": 3, "mark": "55.80", "unit": "m", "wind": null, "valid": true,
      "timestamp": "2026-09-24T17:54:44+01:00",
      "sectorLines": { "rightLine": { "x": 6.18, "y": 19.64 }, "leftLine": { "x": -6.18, "y": 19.64 }, "sectorAngle": 34.92 },
      "coordinates": { "x": 41.7, "y": -36.5, "distance": 55.80, "round": 3, "attempt": 3, "valid": true, "rx": 0.90, "ry": 57.04 }
    }
  ]
}

Os saltos verticais usam height e attemptsAtHeight (ex.: "XXO") em vez de uma distância; os saltos horizontais incluem wind; os lançamentos incluem sectorLines + coordinates.

Classificações

GET /api/v1/display/standings

{
  "events": [
    {
      "id": "T01", "name": "F09 O Discus Throw", "type": "Throws",
      "athletes": [
        { "position": 1, "name": "Dillon Claydon", "club": "…", "bestMark": "55.80", "unit": "m", "wind": null }
      ]
    }
  ]
}

Saltador horizontal atual

GET /api/v1/athlete/active/{eventId} — quem está a saltar agora numa prova de salto em comprimento/triplo salto, para um ecrã de régua de tábua de chamada. Devolve {"active": null} entre atletas.

{
  "active": {
    "eventId": "T02", "athleteBib": "11", "athleteName": "Jack Gunnell",
    "board": 0, "topPerformances": [7.34, 7.28, 7.12],
    "updatedAt": "2026-09-24T17:39:40+01:00"
  }
}

board é a tábua de chamada em metros — 7, 9, 11 ou 13 no triplo salto; 0 é a tábua de salto em comprimento. topPerformances são as melhores marcas legais do atleta até ao momento nessa prova, melhor primeiro, no máximo três.

Atualizações em direto (stream)

GET /api/v1/stream é um fluxo de Server-Sent Events, não um corpo JSON. Ao ligar, envia uma linha de comentário e, em seguida, uma mensagem simples update sempre que os dados da competição mudam, além de pings de manutenção numa ligação inativa. Trate qualquer update como “algo mudou — releia o fluxo que apresenta”.

: connected

data: update

: ping

Consuma-o com um EventSource padrão (navegador) ou qualquer cliente SSE; não há conteúdo a analisar — o token update é todo o sinal.

Enviar dados

Dois pontos de acesso POST aceitam JSON. A aplicação de campo utiliza ambos; a ingestão por terceiros deve ser acordada connosco primeiro.

POST /api/v1/results — as tentativas de um atleta (toda a série atual desse atleta; substitui o que o servidor guarda):

{
  "eventId": "T01",
  "athleteBib": "1",
  "series": [
    { "attempt": 1, "mark": "54.37", "unit": "m", "valid": true, "wind": null }
  ],
  "heatmapCoordinates": [
    { "x": -1.54, "y": 19.08, "distance": 54.37, "round": 1, "attempt": 1, "valid": true }
  ],
  "calibrationMetadata": { "circleType": "DISCUS", "circleRadius": 1.25, "sectorLines": { "rightLine": { "x": 6.18, "y": 19.64 }, "leftLine": { "x": -6.18, "y": 19.64 }, "sectorAngle": 34.92 } }
}

POST /api/v1/athlete/active — um sinal de “a saltar agora”, enviado sem espera de resposta (tábua em metros, 0 = tábua de salto em comprimento; topPerformances melhor primeiro, ≤3):

{ "eventId": "T02", "athleteBib": "11", "athleteName": "Jack Gunnell", "board": 11.0, "topPerformances": [7.65, 7.42, 7.30] }

Ambos devolvem 200 com uma pequena confirmação em JSON. O estado do atleta ativo é transitório (apenas em memória, apagado ao reiniciar); tudo o resto é suportado pela competição guardada.