Especificação da fronteira entre o núcleo e o motor de pontuação. Define a forma da caixa — o que entra, o que sai, quando — sem descrever o que acontece lá dentro. É o entregável da Fase 1 que destrava as três trilhas para o paralelismo.
O motor é caixa preta (ver decisoes/03-motor-caixa-preta.md). O núcleo nunca calcula; só recebe e acumula. A pontuação de avaliação enviada pela organização é insumo de entrada da caixa, não conta do núcleo.
Atenção: este spec define apenas o contrato. A lógica interna do motor é adiada e fora de escopo aqui. Não documentar fórmula neste arquivo.
A definição abaixo é o esqueleto a fechar — os campos exatos saem do scaffold, mas o formato é este.
O núcleo entrega ao motor um resultado validado de uma partida, contendo ao menos:
O motor devolve, para cada atleta da partida, um número (+/-) a ser acumulado como score_evento.
Em F2 o motor é substituÃdo por um stub que apenas repassa um número informado à mão (ou fixo provisório). O contrato é o mesmo — só a implementação interna muda quando o motor v1 entrar (Marco 2).
Adiar o contrato junto travaria as três trilhas de uma vez — o oposto de separá-las. Com o contrato acordado, Plataforma, Aplicativo e Motor trabalham em paralelo sem esperar uns aos outros.
decisoes/03-motor-caixa-preta.mdcronograma/frente-motor.md