MOJ: Manual do organizador (o painel .admin do contest)

Este manual é para quem opera um contest: o dono da conta .admin. Ele explica cada aba do painel de administração, cada opção de configuração, como habilitar os papéis especiais (.judge, .cjudge, .staff, .cstaff, .mon), e como ligar a correção validada por juízes — incluindo quantas pessoas você precisa.

Criar o contest (wizard, problemas, contas) é o outro guia: o tutorial do organizador. Aqui é a OPERAÇÃO, do dia da prova.

Você chega ao painel logando com a conta .admin do contest e clicando em Administração na barra do topo.

1. O painel: a Central, os grupos e os MÓDULOS

O painel abre na 🏁 Central. A barra de cima tem os quatro grupos comuns, que todo contest tem, e — depois de um separador — os grupos de evento, que só aparecem quando o contest liga o módulo correspondente (seção 1½). Cada grupo tem seus painéis na segunda linha. O endereço guarda o painel (#grupo/painel), então dá para salvar o link — os links antigos (#settings, #users, #machines, #prova/rodadas…) continuam funcionando, redirecionados. Um link para um painel de módulo desligado cai em Central › Módulos com um aviso dizendo qual módulo ligar.

[🏁 Central] [🧩 Prova] [👥 Pessoas] [🎛️ Operação] │ [🏟️ Evento] [🖥️ Máquinas]        📖 Manual
                                                    └── só com módulo ligado ──┘

🏁 Central — o que falta e o que gerar

🧩 Prova — o conteúdo

🌐 Idiomas do enunciado. Um problema do banco pode ter o enunciado em português, inglês e espanhol (o autor escreve docs/enunciado.en.md e docs/enunciado.es.md no pacote). O painel 🌐 Idiomas do enunciado (Prova › Problemas; o juiz-chefe tem o mesmo na aba 🌐 Idiomas do painel dele) tem dois modos:

• Automático (o padrão, sem configurar nada): cada problema oferece na sanfona todos os idiomas que ele tem. Um problema só em português não mostra chips.
• Só estes idiomas: marque a lista. Só PT marcado = prova só em português, mesmo que o problema tenha tradução.
• A sanfona abre no idioma do contest (LOCALE) se ele for oferecido; senão, no primeiro. O competidor troca com os chips PT · EN · ES e o MOJ lembra a escolha dele.
• Um idioma oferecido sem tradução em um problema mostra o português nesse problema. A tabela do painel mostra, por letra, o que existe.
• Enviar um HTML ou PDF próprio para um idioma: escolha o idioma no seletor ao lado dos botões Enviar HTML / Enviar PDF. O arquivo vale só para aquele idioma.
• O caderno e o editorial em EN/ES usam a tradução de cada problema. Um problema sem tradução sai em português no caderno. O título do problema também sai traduzido.

Nome do problema no contest. O nome que aparece na lista de problemas, nas clarifications, nas submissões e no relatório é UM nome por problema. Ao inserir um problema sem digitar o nome, o MOJ usa o título do banco no idioma em que a sanfona abre (o LOCALE, se for oferecido). Se o problema não tem título nesse idioma, o MOJ usa o título em português.

• Quando o problema tem título em mais de um idioma, a busca do banco mostra os títulos (🌐) e o campo do nome mostra os botões PT · EN · ES. Clique em um botão para usar o título daquele idioma. Isto vale no assistente de criação, em Renomear (Prova › Problemas) e em Problemas da rodada.
• No assistente, o nome vazio é automático: a Revisão mostra o título que será usado com o idioma escolhido no passo 5.
• A Central avisa (Nome de problema em outro idioma que o da prova) quando o nome é o título do banco em outro idioma e existe o título no idioma da prova. Isto acontece em contest criado antes desta regra ou em contest que trocou de idioma depois de inserir os problemas. O botão 🌐 Usar os títulos no idioma da prova troca só esses nomes. Nome personalizado não muda. Se você quer o nome em outro idioma, salve-o em Renomear e o aviso some.
• Na CLI: moj-contest -c <cid> problems titles mostra os títulos de cada problema, e problems apply-titles faz o mesmo que o botão da Central.

👥 Pessoas — quem entra, quem é quem

🎛️ Operação — o dia da prova

🏟️ Evento — o que uma prova de várias sedes tem a mais

🖥️ Máquinas — quando a prova roda em Maratona Linux (módulo maquinas)

Balão e o freeze. Por padrão, acerto feito com o placar congelado não gera tarefa de balão — e esses balões não são entregues depois: a tarefa não existe. É a regra de competição (o balão andando pela sala revela o que o freeze esconde), e vale só para o balão: pedido de impressão continua livre. Se você quiser o clássico do ICPC — balão circulando durante o freeze, plateia adivinhando — marque Entregar balão durante o freeze em Central › Regras; marcar também libera os que já ficaram retidos. O checklist pré-prova mostra qual política está valendo, e Operação › Situação mostra quantos balões estão retidos.

Como o placar marca quem resolveu. Por padrão a célula de quem resolveu é sempre igual (verde) e a cor do balão vai numa bolinha ao lado. É de propósito: a paleta ICPC dá o problema A branco, e branco sobre o fundo branco do placar é o mesmo pixel — quem resolvia o A parecia não ter resolvido (a queixa que originou a mudança veio de um estudante). Se você preferir o clássico — a célula inteira pintada com a cor do balão — marque em Central › Regras › Célula "resolveu" no placar; as cores claras ganham contorno para não sumirem. Vale para o placar, a cerimônia de revelação e o relatório.

Fora do painel, mas linkadas da Central: etiquetas de credenciais, cerimônia de revelação, jplag, fila do staff e placar.

1½. Módulos do contest — ligue só o que a sua prova usa

Um módulo é um grupo de recursos que o contest usa. Uma prova de disciplina não liga nenhum: o painel mostra só o comum (problemas, contas, sessões, placar, staff, juízes). Uma prova de disciplina em laboratório com Maratona Linux liga maquinas (gate de máquina, sessão única, anomalias). A Maratona liga todos. Ligar mostra os painéis, as checagens da Central e os cartões correspondentes; desligar esconde, sem apagar nada — religar restaura tudo.

Desligado, a regra do módulo NÃO vale, mesmo com a configuração gravada: Máquinas desliga o gate de navegador, a sessão única e a trava de sede (os IPs presos são soltos na hora); Sedes desliga a prorrogação por sede; Inscrições deixa entrar quem não se inscreveu (o membro de time continua entrando como o time), tira o botão Inscreva-se da página inicial e ninguém consegue se inscrever; Coortes põe todo mundo no placar público; Balões para de criar tarefas de balão (religar cria as que faltaram). Antes de desligar um módulo de uma prova em andamento, confira se é isso mesmo que você quer.

Onde se liga: Central › Módulos (presets que só pré-marcam), o passo 7 · Módulos do criar contest, moj-contest -c <cid> modules on|off ou a seção modules{} do spec de criação. E sozinho, ao usar o recurso: criar uma rodada, uma coorte, ligar o gate, gerar um documento, ligar a inscrição, definir uma cor de balão, uma sede ou uma chave de webcast — pela web ou pela CLI — liga o módulo correspondente na hora (o audit registra modules-auto). Só desligar é manual. Também vale para o spec de criação — um só JSON levanta o contest inteiro, com os dados de cada módulo (sedes, cores, coortes, gate, rodadas, documentos, janela de inscrição, telão, classificação); o export devolve a mesma seção, sem segredos. Contests criados antes dos módulos são detectados uma vez pelos arquivos que já têm (server/bin/contest-modules-detect.sh).

Pré-requisitos. Dois módulos só funcionam com outra configuração do contest, e por isso só ligam com ela (a participação virtual tem as condições dela, na §6¾; a cola abaixo junta tudo): inscricoes precisa das contas do Treino Livre (contest criado com usuários compartilhados): o aluno se inscreve com a conta dele no treino. Num contest de contas próprias, a inscrição barraria todo aluno, então ela não liga (nem pelo painel, nem ao gravar a janela de inscrição, nem na criação, ao duplicar ou por template). Com contas próprias, distribua as credenciais em Pessoas › Contas. esqueletos precisa do editor de código no browser (Regras). O cartão do módulo mostra o cadeado e o que falta. Se um contest já estava com o módulo ligado sem o pré-requisito, a Central avisa (e, sem as contas do treino, a regra "só inscrito entra" não vale). Converter as contas compartilhadas em próprias (seção 8¾) desliga a inscrição junto.

Cola: o que cada módulo precisa. À esquerda, o que o MOJ exige para ligar o módulo (↔︎ = vale nos dois sentidos); à direita, o que ele precisa, já ligado, para fazer alguma coisa.

Esqueletos de código (módulo esqueletos)

No contest, o editor de código do time abre vazio: o time escreve o código dele por completo. Com o módulo esqueletos, o editor abre com o esqueleto da linguagem (o main e as leituras de costume). Use em lista ou prova de disciplina, quando o esqueleto ajuda o aluno.

• Precisa do editor de código no browser ligado (Central › Regras). Ligar o módulo com o editor desligado é recusado. Desligar o editor com o módulo ligado também é recusado: desligue o módulo antes.
• Em Prova › Esqueletos, cada linguagem tem três escolhas:
  • padrão do MOJ: o mesmo esqueleto do treino;
  • personalizado: o esqueleto que você escrever para este contest;
  • sem esqueleto: aquela linguagem abre vazia.
• Ao trocar de linguagem, o texto só muda enquanto ele ainda é o esqueleto intacto. O código que o time digitou fica.
• Enviar o esqueleto sem mudar nada é recusado na tela ("Você ainda não alterou o esqueleto"). A trava de editor vazio continua valendo.
• Problema de submissão de função (o pacote declara FUNCTION_LANGS) abre vazio nas linguagens do driver: o main do esqueleto daria Compilation Error.
• Atenção: o editor envia o arquivo como solution.<extensão>. Em Java, não declare a classe como public (o javac exige que uma classe pública tenha o nome do arquivo). A Central avisa.
• O módulo fica fora do preset "Maratona / ICPC": na maratona o time espera o editor vazio. Em contest ICPC a Central avisa.
• O esqueleto personalizado vai junto no export, no template e no duplicar. Pela CLI: moj-contest -c <cid> esqueletos ls|show|set|off|reset.

2. Regras (Central › Regras) — opção por opção

Identidade e janela

• Nome — o título exibido; o id (que vira o subdomínio) não muda.
• Início / Fim — a janela da prova. Antes do início: contagem regressiva; depois do fim: ninguém mais submete (exceto papéis de juiz). Prorrogação fina é na seção ⏱ (por regex de login — ex.: só uma sala que ficou sem luz).
• Abertura do login — a partir de quando o aluno consegue LOGAR (antes disso, contagem regressiva na tela de login). Útil p/ liberar o login minutos antes da largada. A API também barra o time antes desse horário (o organizador entra sempre). Trocar de rodada não muda este campo: com aquecimento e prova oficial, ponha a abertura antes do início do aquecimento. A 🏁 Central avisa quando a abertura cai depois do início (aviso) ou depois do fim (crítico) da rodada no ar. Esvaziar o campo e salvar apaga a abertura: o login volta a abrir no início da rodada.
• Freeze — congela o placar público a partir deste horário (estilo ICPC). Juízes e admin seguem vendo tudo; a revelação acontece na cerimônia. Antes de o freeze começar, você muda ou apaga o campo à vontade. Depois que ele começou, o placar só descongela a partir do fim da prova para todas as sedes + 1 minuto.
• Idioma — Automático (cada pessoa vê a tela no idioma do próprio navegador; é o padrão de um contest sem idioma gravado), português, inglês ou espanhol. Um idioma escolhido fixa o idioma das telas de todo mundo no contest (sem seletor) e também o do papel impresso (folha de rosto da impressão e folha de balão), do relatório final e das mensagens de convite no Telegram (em inglês ou espanhol, a mensagem leva o português junto). Os enunciados e documentos têm idioma próprio (🌐 Idiomas do enunciado, Evento › Documentos).

👁 O que o time vê durante a prova

• Login habilitado — desliga p/ trancar a porta (quem já está dentro continua).
• Ver log de execução — o relatório teste-a-teste. ⚠ Em prova valendo nota, deixar o log visível pode vazar os testes (o aluno vê entrada/saída) — o clássico "SHOWLOG" — desligue.
• Editor no browser — o editor lado a lado com o enunciado.
• Mostrar time-limit — exibe os TLs por linguagem no enunciado.
• Backup / Impressão — habilitam o upload de backup pelo aluno e os pedidos de impressão (que caem na fila do staff).
• Placar anônimo — esconde o desempenho individual: quem não é da organização recebe do MOJ só o resumo (quantos resolveram quantos problemas, resolvedores por problema, quartis), sem nome nem nota de ninguém. A organização (admin, juiz-chefe, juízes, .mon, .animeitor) vê o placar completo. Ligado, o relatório não pode ser publicado, o site da rodada arquivada fica fechado, a classificação não aparece e a participação virtual não abre.
• Gate de login por UA — só navegadores cuja identificação contém a substring conseguem logar (máquina de prova travada). Papéis privilegiados são isentos.
• 🕵️ SUPER SECRETO — o contest some da home/arquivo/status e até o placar exige login. Para provas que não podem nem constar que existem.

⚖️ Julgamento (linguagens, pool, veredicto manual)

• Linguagens — a lista permitida no contest. Um problema pode ter a lista própria, em Prova › Problemas: ela vale NO LUGAR desta.
• Pool de juízes (máquinas) — quais MÁQUINAS de julgamento atendem este contest (vazio = qualquer juiz online). Não confundir com juízes HUMANOS (seção 4).
• Prioridade no julgamento e envios na fila — decide a vez da prova na fila de julgamento e a regra de envios. Escolhe-se na criação — obrigatória no assistente, que não tem padrão (no TCP 2026 a prova oficial nasceu Lista pública sem ninguém escolher; pela API ou CLI, sem o campo, vale Lista pública) — e muda-se aqui, a qualquer hora, no fim da seção ⚖️ Julgamento. Com Lista pública ou Lista privada, cada time tem no máximo 3 envios esperando veredicto: o 4º é recusado até sair um resultado. Isso protege o juiz de quem reenvia sem parar. Com Prova, o contest é julgado antes das listas e não há limite: a partir do 6º envio esperando veredicto, os seguintes daquele time entram mais atrás na fila (como se chegassem 2 minutos depois), sem recusar nada. Envio segurado no veredicto manual não conta. A mudança vale para os próximos envios. A Super (passa na frente de toda fila) só o super-admin do treino dá ou tira, no Painel do treino › Contests: aqui ela não aparece, e um contest em Super fica com o campo travado. Toda mudança de prioridade vai para a Auditoria do contest e para a trilha do treino, com quem mudou, de qual para qual e por onde. A 🏁 Central mostra a regra que vale (item "Envios na fila") e avisa quando um contest ICPC ficou sem prioridade escolhida. O teto de 3 muda no conf, pelo operador do MOJ: SUBMIT_MAX_INFLIGHT=<n> (0 desliga).
• Veredicto manual — liga a correção validada por juízes humanos (seção 4).
• Nº de juízes que validam cada veredicto — o quórum da correção manual: 1 a 5, padrão 2. Com 1, um único voto decide (revisão simples); com N≥2, o veredicto só sai com N votos unânimes — qualquer divergência vira conflito p/ o juiz-chefe.
• Penalidade (ICPC) — minutos somados por tentativa não aceita antes do Accepted (padrão 20) e QUAIS veredictos penalizam (padrão wa/tle/mle/rte — Compilation Error fica de FORA por padrão; vazio = nada penaliza).
• Placar completo p/ logins — allowlist de logins que veem o placar sem freeze (além de admin/juízes).

Salvar grava só o que mudou (a Auditoria registra só isso). Se uma opção estiver errada (por exemplo, um fuso que não existe), nada é gravado e a mensagem diz qual opção corrigir.

Pela CLI, tudo isso é moj contest -c <cid> settings set chave=valor (ex.: settings set manual_verdict=true review_judges=3).

3. Papéis especiais — o que são e como habilitar

Habilitar um papel é só criar a conta com o sufixo certo no login — no painel Pessoas › Contas (ou moj contest -c <cid> users add fulano.judge). Não há caixinha de permissão: o sufixo É o papel. O auto-cadastro público nunca cria conta com esses sufixos (reservados), e operações em massa (reset de senha, desabilitar) pulam contas privilegiadas de propósito.

Regra de ouro: nenhuma conta com sufixo de papel entra no placar ou nas estatísticas — crie quantas precisar sem medo de sujar o resultado.

Aviso da organização em qualquer página. Admin, juiz-chefe, juiz e .mon recebem, em qualquer página do contest, uma faixa no topo com som: 💬 clarification sem resposta (todos esses papéis), ⚖ veredicto esperando o seu voto (admin, chefe e juiz, com a correção manual ligada) e ⚠ conflito (admin e chefe). A contagem aparece também no título da aba. O som se repete a cada 2 minutos enquanto houver pendência; a faixa tem os botões para ativar ou silenciar o som e para pedir a notificação do sistema. A revelação do placar, o telão do Animeitor e a janela de editor não mostram a faixa. Detalhes em MANUAL-JUIZ.md.

Contest com usuários compartilhados do Treino Livre: uma conta de papel do treino não entra com o papel aqui. Só entram o .admin de quem criou o contest e os superadmins do treino. Juiz, staff e co-organizador = conta criada neste contest (seção 8¾).

4. Correção validada por juízes (veredicto manual)

Com Veredicto manual ligado, o julgamento automático continua rodando, mas o veredicto fica retido: o aluno vê a submissão pendente até juízes humanos validarem.

O fluxo, na aba Avaliar (página do .judge):

1. O juiz pega uma submissão da fila (reserva com prazo; máx. N juízes na mesma).
2. Vê o veredicto computado, o log e o código, e vota (confirmar ou trocar o rótulo).
3. Quando N votos unânimes se acumulam (N = Nº de juízes que validam, padrão 2), o veredicto é liberado: entra no histórico do aluno e no placar na hora.
4. Votos divergentes viram conflito: o juiz-chefe (.cjudge) decide no painel dele (um alerta global avisa).

Opções de veredicto. O juiz-chefe ou o admin edita a lista em 🏷️ Opções (painel do juiz-chefe ou Operação › Juízes). Cada opção tem três campos:

1. O texto que o juiz vê e escolhe. Exemplo: 5 - NO - Wrong answer.
2. A classe: uma das seis classes canônicas. A classe define a pontuação, a penalidade e a cor no placar. Exemplo: Wrong Answer.
3. O texto que o time vê. Exemplo: Formato de saída errado. Deixe vazio para mostrar a classe. A classe Accepted não tem texto próprio.

Assim cada contest personaliza o que o time lê sem mudar como o placar pontua.

Quantas pessoas você precisa? No mínimo N contas .judge (o quórum) + 1 .cjudge para conflitos — e recomendo N+1 juízes para a fila não travar quando alguém pausa. O .admin também vota (conta como juiz), mas em prova grande deixe o admin livre p/ operar. Com N=1 um único juiz revisa tudo (bom p/ prova pequena); N=2 é o padrão equilibrado; N≥3 é para finais onde o veredicto precisa de banca.

5. Documentos da prova (Evento › Documentos — módulo documentos)

A aba existe para o .admin e para o juiz-chefe (.cjudge), e produz os documentos da prova — cada um em PDF e HTML, em português, inglês e espanhol:

Fluxo, do começo ao fim

1. Preencha os dados (⚙️ Dados dos documentos): versão do caderno (v1.0), nota da capa e errata. Salve.

2. Ajuste a capa, se quiser (🎨 Capa do caderno). São dois modos, nesta ordem de precedência: PDF enviado › texto. O texto já abre com a capa padrão do MOJ — é ela, escrita em Markdown —, então você edita só o que quiser mudar. Os marcadores são substituídos na geração: {{CONTEST_NAME}}, {{DATE}}, {{N_PROBLEMS}}, {{N_PAGES}}, {{SITES}}, {{VERSION}} e {{NOTE}} (a nota da capa). {{N_PAGES}}, {{SITES}} e {{NOTE}} são opcionais: o bloco em que um deles fica vazio some. Envie um PDF quando a capa for arte pronta do evento — ela entra como está e o resto do caderno é anexado depois dela.

   Logo (🏷️ Logo do cabeçalho, opcional): uma faixa com os logos do evento (PNG, JPEG, WebP ou SVG, até 5 MB) que sai no topo de cada página do caderno e do editorial e na capa gerada, como nos cadernos da Maratona SBC. Vale para os três idiomas; remover tira.

3. Ajuste o texto do info sheet, se quiser (📝): também Markdown, com os marcadores {{TOOLCHAIN}}, {{TL_TABLE}}, {{LANGS_TABLE}}, {{MEMLIMIT}}, {{STACK}}, {{CONTEST_NAME}} e {{DATE}}.

   Os dois textos usam o editor do MOJ (cores do Markdown e números de linha) com uma aba por idioma (PT · EN · ES), como na gestão de problemas. Salvar grava todos os idiomas alterados; voltar ao padrão devolve o idioma da aba ao texto do MOJ.

4. Gere (botão de cada linha, ou Gerar todos (pt+en+es)), ou envie um PDF pronto (botão subir PDF da linha). O PDF enviado é um documento completo: ele vence o gerado em tudo que o MOJ serve e pode ser publicado sem gerar. Voltar ao gerado apaga só o enviado (num documento publicado sem PDF gerado, o MOJ recusa: gere antes ou despublique). Converter os PDFs leva alguns segundos — o caderno é o mais demorado, porque junta um PDF por problema. Se a conversão para PDF falhar, a mensagem diz qual documento falhou e o PDF anterior (se havia) continua o que todos baixam.

5. Confira: cada linha tem PDF, HTML e abrir. Reveja antes de publicar. Algo torto no PDF gerado — espaço demais ou de menos entre os elementos, uma imagem grande — que o Markdown do enunciado causou? Cada documento gerado tem também o ✎ .odt, o arquivo editável que deu origem ao PDF. Baixe, ajuste no LibreOffice (ou Word), exporte em PDF e suba em subir PDF: o enviado vence o gerado e é ele que todo mundo baixa. O .odt do caderno traz a capa como página editável seguida dos enunciados; se a capa é um PDF enviado, ou um problema tem enunciado em PDF próprio, o .odt marca o lugar e você junta o PDF ao exportar. Só o admin e o juiz-chefe baixam o .odt.

6. Publique (só documento com PDF — gerado ou enviado). Publicar faz duas coisas: o documento passa a aparecer na seção Prova da página do contest e em Documentos. Quem vê o quê:

   • Ambiente de julgamento: publicado = visível para todos os papéis (é logística).
   • Caderno e folha de time limits: antes do INÍCIO da prova só .admin, .cjudge e .judge baixam. A sede (.staff, .cstaff), o .mon e os times só a partir do início — o caderno na mão de alguém antes da prova é a prova vazada, não importa o papel. A sede imprime a partir do início (o + notícia desses dois é recusado antes do início, porque a notícia anexa o PDF).
   • Editorial: só publica depois do fim, e só os juízes o baixam antes de a prova acabar para TODAS as sedes. Marcando + notícia, o MOJ ainda cria uma notícia com o PDF anexado (o PDF que todos baixam: o enviado, se houver). Despublicar desfaz: o link some e a notícia com o anexo daquele documento também.

Regenerou? Publique de novo não é preciso — o link publicado aponta para o documento atual, então gerar de novo já entrega a versão nova a quem baixar. Mas avise a sede: quem já imprimiu ficou com a versão velha (é para isso que serve o campo versão do caderno na capa).

🌐 O caderno e o editorial saem no idioma do documento. O caderno em inglês usa o enunciado.en.md de cada problema (ou o HTML/PDF em inglês que você enviou no painel de Problemas), e o editorial em inglês usa o solucao.en.md. Um problema sem tradução sai em português no meio do caderno — o documento nunca fica só com a capa traduzida. O título do problema sai traduzido quando o pacote tem o título naquele idioma. Prova bilíngue com enunciado pronto por fora continua entrando pelo PDF enviado.

∑ As fórmulas saem no PDF como no enunciado da página, inclusive a barra vertical (|x|, a | b) — o autor não precisa escapar nada. Se algum símbolo de fórmula sair com um ¿ vermelho no PDF, é defeito do gerador, não do enunciado: reporte (com o problema) e, enquanto isso, envie o PDF pronto daquele caderno. Um caderno gerado antes de um conserto não se refaz sozinho — gere de novo.

🖼 Imagens do enunciado cabem na página. No PDF, cada imagem sai no máximo do tamanho que tem na página web e nunca maior que a área útil (imagem grande é reduzida, mantendo a proporção). A largura que o autor pediu no enunciado (![](figura.png){width=50%}) vale também no PDF.

🔒 O caderno é conteúdo de prova. Antes de publicar, só .admin e .cjudge o baixam. Publicado, antes do início só os juízes (.judge) somam-se a eles. Para a sede e os times a API responde 404 até o início — não é uma trava de interface.

6. Rodadas: aquecimento e prova oficial (Evento › Rodadas — módulo rodadas)

Toda maratona roda um aquecimento (dress rehearsal) antes da prova: dois ou três problemas fáceis, no dia anterior ou na manhã do dia, para o time ligar a máquina, testar o login, o editor, a impressão e o balão — e para a sua equipe de juízes e staff ensaiar. Depois disso a prova começa no mesmo contest, porque é a configuração dele (contas, senhas, sedes, cores de balão, time limits, linguagens, pool de juízes) que você quer garantir.

No MOJ isso são rodadas. A rodada no ar é a que aparece em Central › Regras e em Prova › Problemas; as demais ficam planejadas até você promover.

O roteiro (repare na ordem: o aquecimento vem PRIMEIRO)

1. Monte o contest normalmente, com os problemas do aquecimento e a janela do aquecimento.
2. Em Evento › Rodadas, dê o nome certo à rodada no ar (aquecimento, tipo aquecimento) e crie a próxima (oficial): janela, freeze e a lista de problemas da prova de verdade. A lista fica guardada e só entra no ar na promoção — ninguém vê os problemas da prova antes. Você pode usar qualquer problema que o dono do contest pode ver: público, seu, de colaborador ou da sua org. A regra é a mesma de Prova › Problemas, na rodada no ar e na planejada. Cada rodada pode ter as suas cores de balão. Abra a rodada, vá em "🎈 Cores dos balões desta rodada" e salve. As cores entram no ar quando a rodada for promovida. Uma rodada sem cores próprias herda as cores em vigor. Na rodada no ar, esta seção e Evento › Balões editam a mesma coisa.
3. Rode o aquecimento. O time vê uma faixa fixa dizendo que é aquecimento e que aquele placar não é o da prova. Trate-o como ensaio geral da operação inteira: se o login abre no minuto do início (modelo ICPC), esse é o único momento em que cada papel toca as telas de verdade sem nada em jogo. Entregue antes a cada pessoa o tutorial do papel dela (/contest/ajuda/) e peça que rode a própria lista: o time (entrar, abrir problema, enviar de propósito, clarification, impressão, backup, placar), a equipe de sala (impressora, o pop-up liberado, kiosk, o trajeto), o chefe de sede (todo time da sede entrou pelo menos uma vez), os juízes (opções de veredicto, log/código, a dupla lendo igual), o chefe (nº de juízes, o que vai para revisão, alarme de conflito) e o telão (projetor, conexão com o Animeitor — publicar os placares e ligar o alimentador —, fotos e músicas).
4. Quando terminar, clique 🚀 Promover agora. O MOJ confere o checklist e, se estiver tudo pronto:
   • arquiva a rodada — submissões (com código-fonte), veredictos, log do juiz, placar, estatísticas, clarifications, notícias, tarefas do staff e os logs de acesso ficam guardados em rounds/<rodada>/, mais um relatório navegável da rodada;
   • zera o placar e o histórico dos times, reinicia a numeração da impressão e limpa as prorrogações por sede;
   • aplica a janela e os problemas da prova oficial, e as cores de balão dela, se ela tiver. Atenção: com o placar congelado, a promoção só é aceita a partir do fim da prova para todas as sedes + 1 minuto. O checklist mostra freeze_locked com a hora. A opção "ignorar os bloqueadores" não passa por cima desta regra. Você digita o id do contest para confirmar. Tudo é auditado.

Registrei a PROVA primeiro — e agora? Aconteceu de montar o contest já com a prova e só depois criar a rodada de aquecimento? Não promova — promover arquiva a rodada no ar (a sua prova, vazia), e arquivo é imutável. O certo é inverter editando as duas rodadas ali mesmo (o painel avisa quando detecta uma planejada começando antes da que está no ar):

1. Edite a rodada planejada: renomeie para prova, tipo prova oficial, e dê a ela a janela + freeze da prova; em Problemas da rodada, coloque a lista da prova (fica guardada, ninguém vê).
2. Edite a rodada no ar: renomeie para aquecimento, tipo aquecimento, janela do aquecimento (sem freeze) e troque os problemas pelos do aquecimento — na rodada no ar, salvar aplica na hora.
3. Confira em Central › Regras que a janela vigente é a do aquecimento — e siga o roteiro normal a partir do passo 3.
4. Depois: o placar e as submissões do aquecimento continuam legíveis em Rodadas (e você pode publicar a rodada para os times verem). O arquivo bruto em .tar.gz — com código-fonte — sai por um clique, para a auditoria posterior.

O checklist é sério. A promoção RECUSA enquanto houver:

Há um --force (checkbox "ignorar os bloqueadores"), para emergência: ele não desfaz o risco, só assume que você sabe o que está fazendo. O único que o --force não ignora é o no_next_round (sem rodada planejada não há para onde promover).

Promoveu sem querer? Desfaça. Em Evento › Rodadas, o cartão ↩︎ Desfazer a última promoção (ou moj-contest rounds undo) volta a rodada arquivada para o ar com tudo o que ela tinha — submissões, veredictos, clarifications, impressões, placar — e a rodada que entrou volta a planejada. Só funciona enquanto a rodada que entrou não teve nenhuma atividade (nenhuma submissão, clarification, impressão ou aviso); senão o cartão diz o que aconteceu nela. Você digita o id do contest para confirmar, e fica no audit. Foi o caso do TCP 2026: depois da prova, o organizador criou uma rodada extra e a promoveu, e o placar zerou.

Contest que usa as contas de outro (USERS_FROM) promove normalmente — o arquivamento só mexe no users/ local. Já foi bloqueador; deixou de ser, porque é justamente o caso de uso real (aquecimento + prova com as contas do treino).

O que NÃO muda na promoção: contas e senhas, times/sedes/bandeiras, escopo do staff, cores de balão, regiões, time limits calibrados, linguagens, pool de juízes, a tabela do que vai para revisão e os textos/capa dos documentos. O que zera: placar, histórico e submissões dos times (arquivados, não perdidos), balões, numeração de impressão, prorrogações, e a lista de documentos publicados.

⚠️ Cores de balão são por LETRA. Se o problema A do aquecimento e o A da prova são diferentes, a cor do balão A é a mesma nas duas rodadas. Confira em Evento › Balões antes da prova.

Na CLI: moj contest -c <cid> rounds ls | add | set | problems | promote | publish | archive.

6½. Depois da prova: encerrar o evento

Quando a prova acaba, o placar continua congelado e os documentos seguem não publicados até alguém mandar liberar — nada disso vira automático com o relógio. A Central passa a mostrar o bloco "Depois da prova" com o checklist do que ainda está fechado e o botão 🏁 Encerrar evento, que faz de uma vez as duas coisas que todo mundo esquece:

1. abre o placar — tira o congelamento (FREEZE_TIME=0), então o resultado final fica público (é o mesmo efeito do botão "🔓 Descongelar tudo (público)" da cerimônia de revelação). O MOJ só aceita descongelar a partir do fim da prova para todas as sedes + 1 minuto. A prorrogação de uma sede conta. A regra vale para todos os caminhos: este botão, a cerimônia, o campo de freeze na Central e a promoção de rodada. A tela mostra a hora a partir da qual o botão fica disponível;
2. publica os documentos já gerados que ainda não estavam publicados — caderno, folha de limites de tempo, info sheet e editorial passam a aparecer em "Arquivos & Recursos" para os times. (O editorial só pode ser publicado depois do fim; por isso ele entra aqui.)

O botão não mexe no resto: liberar o relatório de correção para os times (SHOWLOG), mostrar os limites de tempo e liberar as coortes (convidados) continuam sendo escolha sua — cada um aparece no checklist com o atalho "resolver →" para a tela certa. Só roda depois que a prova terminou para todas as sedes (prorrogação por sede conta) e pode ser repetido à vontade: na segunda vez ele não faz nada.

Fecha o ciclo com o relatório final (Prova › Relatório): o tar.gz navegável leva o placar aberto, as submissões, as estatísticas completas, os enunciados e os documentos publicados — é o pacote que se manda para os participantes e para o arquivo do evento. Ao lado do download há 📢 Publicar como histórico: o mesmo site passa a existir em https://moj…/relatorio/<contest>/ e o card do contest na página inicial e no /contests/ ganha o botão 📑 Relatório — é o histórico do evento. A geração roda em segundo plano (~1–2 min numa prova grande; o painel mostra "publicando…" e troca sozinho quando termina). É público: o relatório não carrega código-fonte, log de juiz nem senha, e as clarifications saem anônimas, mas mostra nomes de times, runs e estatísticas — publique quando tudo já foi divulgado. 🔄 Republicar gera de novo e troca o site inteiro de uma vez (quem estiver lendo não vê meio-caminho); Despublicar apaga o endereço e o botão dos cards. As rodadas arquivadas (aquecimento, por exemplo) têm o próprio botão em Prova › Relatório: 🌐 publicar coloca o relatório gerado na promoção em /relatorio/<contest>/rodada/<slug>/ — e a página inicial do relatório principal, ao ser (re)publicada, passa a linkar as rodadas públicas em "Rodadas anteriores deste evento".

O MOJ recusa publicar o relatório quando ele mostraria o que ainda não é público:

• Antes do início da prova. O relatório traz os enunciados.
• Com o placar congelado, até o fim da prova para todas as sedes + 1 minuto. O relatório mostra o placar completo. Depois disso, se o placar ainda estiver congelado (a revelação não aconteceu), o painel pede confirmação.
• Com coorte PRIVADA e os resultados não liberados. O relatório mostra todos os times. Vale também para o relatório de uma rodada arquivada. Libere os resultados em Evento › Coortes.

6¾. Participação virtual (Evento › Virtual — módulo virtual)

Com a prova encerrada, qualquer conta do Treino Livre pode refazer o contest uma vez, no próprio tempo, contra o placar oficial. O placar oficial não muda. Referência completa: docs/VIRTUAL.md.

Para ligar: Central › Módulos › Participação virtual. O módulo só liga quando:

1. o contest não é secreto;
2. o modo é ICPC;
3. o placar não é anônimo;
4. o contest tem início e fim;
5. todos os problemas já são públicos no treino. Se algum não for, a resposta é um erro que diz quantos faltam. Publique os problemas primeiro (gestão de problemas) e ligue de novo.

O cartão do módulo mostra o cadeado e o que falta, e a Central avisa quem já está ligado sem isso. Na criação (spec, template ou cópia), um contest que não cumpre essas condições nasce com o módulo desligado, e a tela do resultado (ou a CLI) diz por quê: ligue depois, em Central › Módulos.

Você pode ligar o módulo antes do fim da prova (com os problemas já públicos). Ele fica inerte e abre sozinho quando a prova termina para todas as sedes e o placar é descongelado (botão Encerrar evento). O botão Virtual no card do contest e o aviso no placar só aparecem quando a participação virtual pode ser feita.

Atenção: ligar este módulo torna o placar final e a lista de problemas visíveis para contas do treino. Um contest que não pode ser visto por fora não deve ligar o módulo.

O painel Evento › Virtual mostra:

• as condições, uma por linha, com ✅ ou ⛔ — o público só vê "indisponível"; você vê o que falta;
• o link da página (/treino/virtual/?c=<contest>);
• as participações gravadas, com resolvidos e penalidade. O botão tirar do placar remove uma linha do placar virtual (o registro fica guardado; devolver desfaz). A ação é auditada. O botão devolver tentativa apaga a linha e deixa aquela conta largar de novo neste contest. Use para um testador, ou para quem teve problema durante a prova. A ação também é auditada.

Regra do participante (ele a lê antes de largar): uma participação por conta; pode desistir sem gravar nos primeiros 15 minutos ou enquanto não tiver nenhum aceito, no máximo 2 vezes; a 3ª largada é definitiva.

7. Máquinas dos times (Máquinas › Gate & trava — módulo maquinas)

É no aquecimento que os times ligam de fato os computadores — e é dali que o MOJ tira o mapa time × IP × navegador da sala (do log de acessos do contest, recortado pela janela da rodada: nada novo é capturado). A aba mostra, por rodada:

• por time: nome, sede, IPs e navegadores usados, primeiro login e um alerta quando o time usou mais de um IP;
• por IP: quais times vieram de cada máquina — e marca IP compartilhado (dois times na mesma máquina é sinal de mesa trocada ou conta emprestada);
• quem trocou de máquina: na prova oficial, o time que loga de IP/navegador diferente do que usou no aquecimento aparece marcado em vermelho;
• ⇣ CSV de tudo, para conferir com a planilha da sede.

Duas ações saem daqui e escrevem no lugar de sempre:

• aplicar sede: na visão por IP, digitar o nome da sede e clicar grava a sede dos times daquele IP (o mesmo campo de Evento › Times) — o placar, as etiquetas e o escopo do staff passam a respeitá-la;
• configurar o gate de navegador: a seção 🔒 no topo da aba (logo abaixo) — os navegadores realmente vistos na rodada ficam listados lá, e cada um pode virar o fallback com um clique.

O gate POR SEDE (o caso da maratona)

Quando cada sede roda a sua imagem, o UA de cada máquina carrega um pedaço do próprio login do time: teambrspso001 (Brasil/BR, São Paulo/SP, Sorocaba/SO) roda numa imagem cujo UA contém brspso. Uma substring única não serve — então o MOJ deriva o esperado do login.

Na web (seção 🔒 de Máquinas › Gate & trava): o modo — Desligado, Observar (mostra o esperado × visto e o "UA fora da sede" nas Anomalias, sem barrar ninguém nem derrubar sessão: dá para ligar no meio da prova e conferir a sala) ou Barrar (o login devolve 403); abaixo vão a regex do login com captura e o UA esperado (\1), com um testador ao vivo ("testar com o login" → UA precisa conter brspso · sede Sorocaba), e três listas dobráveis — overrides por sede, regras por regex de login e isentos. Salvar já vale para o próximo login. Sem nenhuma regra o gate não faz nada: o painel diz "nenhuma regra: ninguém é barrado nem observado", salvar Barrar ou Observar sem regra é recusado, e a 🏁 Central avisa quando o módulo maquinas está ligado sem nenhum gate gravado (grave Desligado se for de propósito). Foi o que aconteceu no TCP 2026: o painel antigo marcava "ativo" sem regra nenhuma.

Na CLI, o mesmo:

moj contest -c <cid> ua-gate set --from-login '^team([a-z]{6})[0-9]{3}$' --expect '\1'
moj contest -c <cid> ua-gate set --region 'Sorocaba=brspso-v2'     # sede fora do padrão
moj contest -c <cid> ua-gate set --exempt '^ccl' --exempt time-reserva-07
moj contest -c <cid> ua-gate set --mode observe                     # olhar sem barrar (enforce = barrar, off = desligar)
moj contest -c <cid> ua-gate check teambrspso001                   # o que se espera dele
moj contest -c <cid> ua-gate show

Uma regra cobre todas as sedes de uma vez. A ordem de resolução é: isentos › conta de papel (sempre entra) › regra por regex › override da sede › captura no login › substring única (o login_ua_substring de sempre, que continua valendo como último recurso).

• No modo Barrar, quem não casa é barrado no login (403), com a lista de isentos como margem. No modo Observar ninguém é barrado: quem entra fora do padrão aparece em Máquinas › Anomalias. Um caminho seguro é Observar no aquecimento (conferir a sala) e Barrar na prova. --mode off desliga sem apagar a configuração.
• O painel Máquinas › Gate & trava mostra UA esperado × UA visto por time e conta quantos estão fora da imagem da sede: é assim que se conserta a sala no aquecimento, antes de o gate barrar alguém na prova. O ✓ quer dizer que TODOS os navegadores vistos daquele time são o da imagem; com algum de fora aparece "parte fora do padrão".
• Com inscrição por times, o membro é cobrado pelo esperado do time (a sede e o padrão de login são da conta do time).
• Quem já está logado com o navegador errado sai com "Deslogar UA divergente" (Máquinas › Anomalias), que compara cada sessão com o esperado daquele time.
• Trava de sede por IP (chave na mesma seção 🔒, DESLIGADA por padrão — ligue na prova): o gate e o isolamento por subdomínio não seguram curl --resolve moj…:443:<IP> da máquina de prova ao site base (treino, backups que o aluno subiu antes, outro contest). Com a trava, cada login de competidor prende o IP de origem (a saída da sede) a esta prova até o fim + folga (com rodadas, até o fim da última rodada planejada: o IP preso no aquecimento segue preso na oficial); daquele IP qualquer outro alvo responde 403 site_locked, inclusive sessão do treino aberta antes. Contas de papel são isentas. Toda reivindicação e todo bloqueio vão ao audit (site-lock-claim, site-lock-block) e aparecem em Máquinas › Gate & trava (trava de sede), com "soltar" por IP e "prender IPs já vistos" (útil na manhã da prova). Efeito colateral aceito: durante a janela, todo mundo atrás daquele IP público perde o treino.
• Sessão única por time (chave na mesma seção 🔒, ligada por padrão): com o gate em Barrar, um login novo em outra máquina derruba a sessão anterior do time. Trocar de máquina por defeito continua funcionando (o time loga na nova e a velha perde a sessão); recarregar a página na mesma máquina não derruba nada. Cada queda vira um evento em Máquinas › Anomalias.

7¼. Sedes (Evento › Sedes & escolas — módulo sedes)

A sede de cada time alimenta o filtro do placar, o escopo do staff (region:<nome>), as etiquetas, o gate de navegador por sede, a estatística, a classificação e o telão. Todos usam a mesma regra:

1. a sede gravada no time vence (o nome, sem diferenciar maiúsculas);
2. senão, a regex mais funda que casa o login (sem diferenciar maiúsculas);
3. um grupo/país soma as sedes abaixo dele; um nó com o mesmo nome da sede também a conta;
4. uma sede gravada que não existe na árvore aparece como "fora da árvore" e conta no nó que a regex daria;
5. um recorte (view: supersede, times femininos) agrupa times que já estão nas sedes e nunca é a sede de ninguém.

O painel tem três modos. Escolha o que der conta do seu contest; dá para subir de modo a qualquer momento. Um modo que não cabe na árvore atual fica desabilitado e diz por quê.

• Simples — uma lista de sedes. Cada sede tem "logins que começam com" (vírgula separa). Para atribuir times, cole a lista de logins e escolha a sede, ou escolha a sede de cada time sem sede. Renomear uma sede leva junto os times gravados com o nome velho (a prévia mostra quantos antes de salvar), o escopo do staff (region:), o gate de navegador da sede e a sede do telão. Ao salvar, a tela avisa se algo ainda aponta para uma sede que não existe mais. Por IP da máquina da prova: Máquinas › Gate.
• Intermediário — grupos (país, região) › sedes. Cada sede tem regras: começa com, contém, termina com, ou é um destes (lista).
• Avançado — a árvore inteira: subregiões, recortes view e regex livre.

A prévia embaixo mostra o que o placar, as etiquetas e o escopo do staff vão ver: quantos times cada sede tem, quem ficou sem sede, quem parou num grupo/país (a regex casou o grupo e nenhuma sede dele), quem casa em duas sedes e as sedes gravadas fora da árvore. "A salvar" resume a mudança. Se outra aba ou a CLI mudou as sedes depois que você abriu a tela, o salvar recusa: recarregue e refaça.

Time inscrito guarda a sede na inscrição: ela não some quando o time muda. A Central mostra o item Sedes quando há algo a conferir.

A regex segue um subconjunto que casa igual no navegador e no servidor: \d \w \s e (?: servem; \b, (?=, [[:classe:]], quantificador preguiçoso, hífen ambíguo dentro de [ ] e acento não servem (o login não tem acento). O salvar diz qual sede e por quê.

Na CLI: moj-contest -c <id> regions show|who|assign|set|map.

7½. Anomalias de máquina (Máquinas › Anomalias) e Sessões (Pessoas › Sessões)

Na Maratona 2026 só deu para responder "algum time usou duas máquinas?" depois da prova, cruzando logs à mão. O painel Máquinas › Anomalias responde durante a prova (as sessões ativas, o sair em massa e o log de acessos, que valem para QUALQUER contest, ficam em Pessoas › Sessões). Quem identifica a máquina é o navegador da imagem do mlinux (machine_id/boot_id) — com ou sem gate. Login de navegador comum só tem o IP, e atrás de NAT o IP é a sede inteira: esses logins ficam fora das anomalias de máquina (aparecem só em "UA fora da sede" e na lista de sessões). O "UA fora da sede" precisa do esperado de cada time, isto é, do gate em Barrar ou Observar. Sem nenhuma máquina identificada o painel avisa e mostra só as sessões e o log de acessos.

• Cartões (clique = filtro): sessões ativas, 👥 2 sessões vivas (o mesmo time em duas máquinas — com a sessão única ligada isso só acontece por token copiado), 🖥 máquina compartilhada (2+ times logaram na mesma máquina na prova; grave se os dois estão vivos nela), 📤 submissão de outra máquina (a submissão veio de uma máquina diferente da que fez o login; mesma máquina reiniciada aparece como info), 🧭 UA fora da sede, 🏫 sede sem máquina por time (da última coleta do nutellaboot), 🔁 trocou de máquina (info: normal quando a máquina falha) e as revogações da sessão única.
• Linha do tempo: cada evento com hora, tipo, time, máquina e detalhe; filtros por tipo e texto; CSV; botão deslogar o time.
• Explicar (admin e juiz-chefe): um caso já esclarecido (ex.: "trocou de máquina por defeito, confirmado pela sede") recebe o motivo, sai das contagens e fica na lista, apagado, com quem explicou, quando e por quê (cartão ✓ explicadas; desfazer volta a contar). Se o caso mudar (o time vai para uma terceira máquina), ele volta. Cada marca vai ao audit.
• Times: só os com alguma anomalia (ou todos com sessão): sessões vivas e em quantas máquinas, as máquinas usadas na prova em ordem, a última submissão (✓ veio da máquina da sessão; ✗ não) e as anomalias como etiquetas.
• 🚪 Sair em massa e trava de login: a troca de rodada em três cliques — fechar o login (competidor recebe 403 login_disabled; a organização entra), deslogar competidores, staff e chefes de sede ou os dois (nunca admin, juízes, chefe, monitor nem telão), promover a rodada em Evento › Rodadas, e reabrir o login quando os times puderem entrar. Cada sessão derrubada vira evento na linha do tempo; a ação vai ao audit (logout-all).
• 🔒 Trava de sede: os IPs presos a esta prova (logins, bloqueios, até quando), os bloqueios registrados (quando, IP, alvo, rota, sessão) e os botões soltar e prender IPs já vistos. O cartão "bloqueios da trava" e os eventos 🔒 da linha do tempo vêm do audit. A seção 7 explica.
• Canal dos pedidos na prova: quantos logins e submissões da prova vieram da web, da CLI (moj-comp) e de pacotes offline. Vale mesmo sem gate. A CLI se identifica no User-Agent (moj-comp/<build>) e, na máquina de prova, manda na frente o mesmo User-Agent do navegador da imagem (lido de /etc/moj/user-agent, gravado pela imagem): é assim que ela passa no gate por sede e fica com a mesma chave de máquina do browser — usar as duas na mesma máquina não derruba a sessão. Fora da máquina de prova a CLI é barrada pelo gate (403), de propósito.
• Atualiza sozinho a cada 30 s. A submissão grava a origem (IP, navegador e a sessão usada) em var/submit-origin.log; os logins em var/access.log; as quedas de sessão em var/session-events.log — os três atravessam as rodadas e entram no arquivo.

8. Times convidados (coortes de placar — Evento › Coortes, módulo coortes)

Maratona convida times que competem sem entrar na disputa oficial — o pessoal chama de convidado, extra-oficial, "CCL". O MOJ trata isso como coorte: um grupo de times com política de visibilidade própria.

O que uma coorte privada garante

• os times dela não aparecem no placar público;
• os times regulares não sabem que ela existe — nem no placar, nem no diretório de times (/contest/teams, que é público e listava todo login);
• os próprios convidados veem todos (o placar deles traz oficiais + convidados);
• quando você libera os resultados, todo mundo passa a ver todos, e o convidado aparece intercalado pelo desempenho mas sem consumir posição oficial — o pódio combinado continua batendo com o oficial.

Como configurar (Evento › Coortes)

Uma linha por coorte, com o que decide o comportamento: id, nome, regex do login, pública (aparece no placar público), extra-oficial (entra sem consumir posição), padrão (quem não casa nada cai nela) e vê — as caixas que dizem quais coortes aquela visão enxerga (a coorte sempre vê a si mesma). A coluna times conta quantos estão em cada uma.

• + criar coorte: nasce privada e extra-oficial vendo todas — que é o caso do CCL.
• Numerar os convidados numa sequência própria: por padrão o convidado mostra – no lugar da posição. Com a opção ligada, ele mostra a posição entre os convidados, em itálico, no placar, na revelação e no relatório. A numeração oficial não muda.
• atribuir: escolhe um time e a coorte dele (o campo vence a regex); "— pela regra —" solta o time de volta para o regex.
• 📌 Materializar (N): carimba a coorte de quem hoje só casa por regex — depois disso, mudar o regex não remaneja ninguém. O contador diz quantos times estão nessa situação.
• 🔓 Liberar resultados: pede o id do contest digitado para confirmar (é irreversível na prática — o placar público passa a mostrar todos).
• Placares gerados: as visões que o build.sh mantém (uma por coorte que vê um conjunto diferente, mais a pública).

Para mudar a coorte padrão, marque o rádio da outra linha e salve aquela linha. Remover uma coorte exige que ela esteja vazia (e a padrão nunca é removível).

A mesma coisa na CLI:

moj contest -c <cid> cohorts ls
moj contest -c <cid> cohorts add ccl --name "Café com Leite" --regex ccl --private --unranked
moj contest -c <cid> cohorts assign timeconvidado07 ccl     # convidado sem 'ccl' no login
moj contest -c <cid> cohorts materialize                    # carimba a regra em campo por time
moj contest -c <cid> cohorts release                        # o "liberamos tudo" (pede o id)

A coorte casa por regex no login e/ou pelo campo .team.cohort de cada time (o campo vence). materialize transforma a regra em dado: depois disso, mudar o regex não remaneja ninguém. Quem não casa nada cai na coorte default (a dos oficiais).

O que continua completo, de propósito — são papéis privilegiados, e você precisa deles: Todas as Submissões, Estatísticas (inclusive quem resolveu primeiro), a fila do staff (o balão do convidado tem de ser entregue) e o relatório final. Duas consequências práticas:

• o código de uma submissão é visto só pelo time que a enviou e por juiz/admin. A opção antiga "mostrar o código das submissões a todos" (SHOWCODE) foi removida em 2026-09-18;
• publicar o arquivo de uma rodada (Evento › Rodadas) exige os resultados liberados quando há coorte privada — o relatório da rodada traz o placar aberto com todos.

ℹ️ Sobram dois canais numéricos que não escondem identidade mas existem: a página de status pública conta as submissões pendentes de todos os times, e a numeração de tarefas de impressão é única por contest (saltos indicam atividade que o time não vê).

8½. Inscrição prévia e times de 3 contas do treino

Vale para contest criado com "usuários compartilhados do Treino Livre". Ligando a inscrição (Pessoas › Inscrições → Ligar inscrição), o contest passa a ter uma porta: quem não se inscreveu não entra (a API recusa o login, não é só a tela).

Como a pessoa se inscreve: no site principal, logada no treino, em /contests/inscricao/?c=<id> (o cartão do contest na home ganha o botão 📝 Inscreva-se). Ela escolhe individual ou criar um time: dá um nome e convida até 2 logins do treino; cada convidado precisa aceitar. Enquanto a janela estiver aberta dá para sair, renomear e desfazer. Participação é exclusiva — aceitar convite desfaz a inscrição individual.

O convite avisa sozinho. No instante em que o capitão convida, o mojinho manda uma DM ao convidado com o link de aceitar/recusar; e na véspera do fechamento (24 h antes) manda um único último aviso para quem ainda não respondeu (a mensagem sai em português; se o contest estiver com LOCALE=en, vai em inglês e português no mesmo texto — DM não tem seletor de idioma). Só alcança quem tem Telegram vinculado (perfil do treino → 📨 Telegram) — por isso a lista de convites mostra 📨 (alcançável) ou ⚠️ (sem canal), e o resumo conta quantos ficaram sem. Na tabela de times, cada convite pendente tem o botão 🔔 para cutucar na hora, e o cabeçalho tem 🔔 Lembrar todos; cutucar à mão não cancela o aviso automático da véspera. Para desligar o automático neste contest, desmarque lembrete automático na caixa da janela (grava REG_REMIND=n). Isso importa porque quem não aceita o convite não entra no time — e às vezes nem está inscrito.

Na prova, cada membro entra com o PRÓPRIO login e senha do treino e a sessão vira a do time: o placar, os balões e a impressão veem uma linha só. Quem estava no teclado fica registrado (var/actor-log e a 5ª coluna do var/access.log) — útil para conferir depois.

A janela (Pessoas › Inscrições → Janela de inscrição): abre (vazio = já aberta), fecha (vazio = o início da prova) e atraso (min) — minutos após o início em que ainda dá para entrar, mas na coorte …-atrasado, que aparece no placar sem ocupar posição (é a extra registration do Codeforces). Passou disso, a porta fecha.

Em que relógio estão esses campos: no do seu navegador — a caixa mostra qual é, logo abaixo. Já as horas que o MOJ escreve para as pessoas (a DM do mojinho, o checklist pré-prova, a data do caderno, o relatório final) saem no fuso da prova, que você define em Central › Regras → 🕒 Identidade e janela → Fuso horário da prova (vazio = America/Sao_Paulo). Quando os dois relógios diferem, a caixa da janela mostra também o horário no fuso da prova, para não haver dúvida. Digite o nome de qualquer fuso (America/Santiago, America/Mexico_City…). A lista sugere todos, começando pelo do seu navegador. Use o fuso da sua cidade, e não outro que tenha a mesma hora hoje: o horário de verão muda em datas diferentes em cada país, e os textos sairiam com 1 h de diferença depois da troca. O fuso também pode ser escolhido no assistente de criação, e vai junto ao exportar, duplicar ou salvar um template. Pela CLI: moj-contest -c <cid> settings set tz=America/Santiago.

Placar: a inscrição semeia as coortes individual e times, cada uma com placar próprio — o seletor "Placar: Geral | Times | Individual" aparece sozinho na página do placar. Se o contest já tinha coortes configuradas, o checklist pré-prova avisa que faltam essas duas.

Com AQUECIMENTO (o esquenta que fica dias no ar): planeje as duas rodadas em Evento › Rodadas (aquecimento agora, prova oficial na data real). Por padrão o aquecimento também exige inscrição — é nele que o competidor resolve login, submissão e placar; deixar entrar sem inscrição só empurra o problema para o dia da prova. A inscrição fecha sozinha no início da prova oficial (é essa data que o "fecha" herda, não a do aquecimento). Se você preferir o aquecimento de porta aberta (qualquer conta da fonte entra sem inscrição), ligue REG_WARMUP_OPEN=y no conf — nesse caso a promoção derruba a sessão de quem não se inscreveu e o placar da prova nasce só com os inscritos; o painel mostra o selo 🔥 aquecimento: entrada livre enquanto isso vale.

O modo de participação é definitivo: depois de inscrito (individual ou em time), o competidor não cancela nem troca de modo sozinho — a página de inscrição deixa isso claro antes da escolha, e qualquer mudança passa por você (Pessoas › Inscrições: remover, dissolver, inscrever à mão).

O time também declara na inscrição: a universidade (vira o prefixo [SIGLA] Nome do Time no placar e a coluna/filtro de escola), o uso de IA (aparece como 🤖 ao lado do nome — é transparência, não julgamento), a bandeira (país ou estado do Brasil — a bandeirinha do placar) e uma foto do time (a que vai ao telão; reprocessada no servidor, sem metadados). Tudo editável pelo capitão enquanto a janela estiver aberta, e visível no seu painel e no CSV. O inscrito INDIVIDUAL declara as mesmas coisas (menos a foto): universidade, IA e bandeira, na inscrição ou depois, pela mesma página. A organização ajusta qualquer um pelas ações team-meta/individual-meta do painel — sem regra regex no teams-meta.json (o mecanismo legado continua valendo só como sobreposição visual).

Dica de dia de prova: o checklist da Central mostra quantos se inscreveram e quantos convites ficaram pendentes — convite não aceito significa gente achando que está no time e que, na hora, não entra.

8¾. Contas compartilhadas com o Treino Livre: escolher e desfazer

Na criação (passo 3 do wizard) você escolhe entre contas próprias do contest e usuários compartilhados do Treino Livre. No compartilhado, cada pessoa entra com a conta e a senha do treino. É prático para lista de exercícios. Numa prova, saiba o que isso implica:

1. Login e senha são os do Treino Livre. Você não os vê nem os redefine, e as etiquetas saem sem senha.
2. Qualquer conta do Treino Livre entra. Para limitar, ligue o módulo Inscrições (seção 8½).
3. Só o seu .admin (o de quem criou o contest) e os superadmins do treino entram com papel. Juiz, staff e co-organizador precisam de conta própria do contest (Pessoas › Contas, seção 3).
4. Não existe troca de senha geral da prova: quem sabe a senha do treino de alguém entra como essa pessoa aqui também.
5. Dá para desfazer, convertendo em contas próprias (abaixo). A conversão não tem volta.

O wizard só cria o contest compartilhado depois do ☐ Entendi. A Central mostra o item Contas compartilhadas enquanto o contest estiver assim.

Agir num participante compartilhado. Em Pessoas › Contas, quem entra pela conta do treino aparece com 🔗 treino. Desabilitar barra a pessoa neste contest (a conta do treino continua valendo lá) e reabilitar desfaz. Desclassificar tira do placar. Remover barra de vez: a pessoa não volta pela conta do treino. Uma conta que você criou ou resetou aqui passa a valer com a senha daqui: a do treino deixa de abrir essa conta neste contest.

Converter em contas próprias (Pessoas › Contas › cartão 🔗 Contas compartilhadas):

1. Ver prévia da conversão. Nada é gravado. A prévia conta quem ganha conta (quem tem pasta no contest, sessão aberta, registro no log de acessos ou inscrição), os times, os membros de time que perdem o login e os avisos.
2. Confirme. Antes da prova, marque ☐ Entendi. Com a prova já começada, digite o id do contest. Se a lista mudou entre a prévia e a confirmação (alguém entrou), a tela mostra a prévia nova e pede a confirmação de novo.
3. Baixe o CSV das credenciais na hora. As senhas novas só aparecem ali e nas Etiquetas.

O que a conversão faz:

• cada participante ganha conta própria com senha nova (do treino só vem o nome);
• cada time vira uma conta (login time-…) com senha única, e os membros deixam de entrar com as contas deles; membro que já submeteu vira conta desabilitada, e a linha dele no placar fica;
• o seu .admin do treino vira .admin próprio do contest com senha nova (a tela mostra);
• a inscrição é encerrada e o roster fica arquivado;
• o histórico e o placar ficam. Quem entrou sem submeter passa a aparecer zerado;
• quem nunca entrou no contest não ganha conta (acrescente em ➕ Adicionar);
• os superadmins do treino deixam de entrar neste contest;
• as sessões abertas continuam. A opção derrubar as sessões faz todos entrarem de novo com a senha nova.

Na CLI: moj-contest -c <id> users convert (prévia) e users convert --apply --csv creds.csv.

9. Template de usuários (habilita todas as funções)

Cole na carga em lote de Pessoas › Contas (uma linha por conta: login nome), ou crie um a um com moj contest -c <cid> users add <login> --name "<nome>":

juiz1.judge      Juiz Um
juiz2.judge      Juiz Dois
juiz3.judge      Juiz Três (reserva do quórum de 2)
chefe.cjudge     Juiz Chefe
apoio1.staff     Staff de impressão e balões
sede1.cstaff     Chefe da Sede 1 (etiquetas + revelação)
monitor1.mon     Monitor (responde clarifications)

Depois: ligue Veredicto manual (e ajuste o Nº de juízes) em Central › Regras; distribua as senhas geradas; cada pessoa loga na MESMA tela do contest e vê os botões do seu papel.

9½. Painel do treino › Contests e quem pode criar

O painel administrativo do Treino Livre (/treino/admin/, conta .admin) tem a aba 🏆 Contests. Ela lista os contests criados pela interface e controla quem pode criar contests e problemas.

Quem vê o quê. A regra vale na API, não só na tela.

• Super-admin vê e opera os contests de todos. Super-admin é uma conta .admin listada em SUPERADMINS no arquivo contests/treino/conf (logins separados por espaço). Só quem tem acesso ao servidor edita essa lista. Não há tela para isso.
• Admin comum vê os próprios contests e os contests de criadores sem papel de admin (alunos e monitores liberados). Não vê o contest de outro administrador. Remover, duplicar e exportar seguem a mesma regra: um contest fora do seu escopo responde "não encontrado".

Filtros da lista. Busque por nome, id ou dono. Filtre por dono, modo e situação (por vir, em andamento, encerrado). Ordene por data de criação, início, nome ou dono. Marque só os meus para ver apenas o que você criou. O dono aparece com foto, nome e link para o perfil.

Id reservado. Um id que começa por icpc é da organização da Maratona. Só um super-admin cria um contest com esse id. O assistente avisa antes e a API recusa.

Prioridade (coluna Prioridade). O super-admin muda a prioridade de qualquer contest direto na tabela, inclusive Super, que passa na frente de toda fila. Este é o único lugar para dar ou tirar Super. O assistente só oferece Super ao super-admin, e uma cópia (duplicar) de um contest Super feita por outra conta nasce como Prova. Os demais administradores só veem a coluna: o admin de cada contest muda as outras prioridades em Central › Regras. Toda mudança fica na Auditoria do contest e na trilha do treino (feed 📜 Atividade, ação contest-priority). Pela CLI: moj contest priority <cid> <prioridade>.

Quem pode criar contests e problemas. A mesma permissão vale para criar contests e para criar problemas e coleções na Gestão de Problemas. Contas .admin sempre podem. Para as demais:

• ✅ Liberados: digite o login e uma nota opcional e clique em ✅ Liberar. A conta precisa existir no treino. Cada linha mostra a pessoa, quem liberou e quando.
• ⛔ Bloqueados: mesma coisa com ⛔ Bloquear. Um bloqueio vence o limite automático.
• Limite automático: quem resolveu pelo menos N problemas pode criar. Zero desativa.

10. Referências

• Manual do juiz humano — a operação da aba Avaliar e do juiz-chefe.
• Manual do staff — impressão, balões, etiquetas, revelação por sede.
• Manual do competidor — o que o aluno vê (distribua com as senhas).
• Tutorial do organizador — criar o contest (wizard e CLI).
• CLI do competidor — envio pelo terminal, com modo sem-Internet.