Oportunidades são editais, chamadas públicas, residências e prêmios para os quais agentes culturais podem se candidatar.

Uma oportunidade (edital) é uma chamada pública para inscrições. Ela define regras, cronograma e critérios de avaliação para agentes culturais que buscam financiamento, reconhecimento ou participação em um programa. Oportunidades pertencem a agentes e podem se vincular a outras entidades, como projetos, eventos ou espaços.

Campos principais

Entidade proprietária da oportunidade

Uma oportunidade está sempre associada a uma entidade proprietária: agente, espaço, evento ou projeto. Essa associação determina quais gestores dessa entidade têm controle sobre a oportunidade. O tipo de entidade é capturado pelo discriminador de herança do Doctrine:

Período de inscrição

A janela de inscrição é definida por registrationFrom e registrationTo. O método isRegistrationOpen() verifica se as inscrições estão abertas no momento.

if ($opportunity->isRegistrationOpen()) {
    // exibe o botão de inscrição
}

Fluxo contínuo

Oportunidades podem operar em modo de fluxo contínuo, no qual inscrições são aceitas indefinidamente, ou até uma data final definida. A constante CONTINUOUS_FLOW_DATE ("2111-01-01 00:00") é usada como valor sentinela para registrationTo quando não há uma data real de encerramento.

Métodos de avaliação

Cada oportunidade pode ser configurada com um método de avaliação. Esse método determina como as inscrições enviadas são pontuadas e ranqueadas.

Comissão de avaliação

Uma oportunidade pode ter uma comissão de avaliação composta por múltiplos avaliadores. Os avaliadores são adicionados por EvaluationMethodConfigurationAgentRelation. A comissão é responsável por enviar registros RegistrationEvaluation para cada inscrição.

// Obtém a comissão de avaliação de uma oportunidade
$committee = $opportunity->getEvaluationCommittee();

Cada avaliador envia sua própria avaliação. A plataforma consolida essas avaliações em um resultado final usando o método de avaliação configurado.

Fases da oportunidade

O módulo Opportunities suporta chamadas multifásicas. As fases são oportunidades filhas vinculadas à oportunidade pai pelo sistema de entidades aninhadas (parent / _children). Cada fase pode ter seus próprios:

• campos de inscrição e exigências de arquivo
• método de avaliação e comissão
• período de inscrição

As inscrições são carregadas de uma fase para outra usando os ponteiros de metadados nextPhaseRegistrationId e previousPhaseRegistrationId.

Campos de inscrição e exigências de arquivo

Administradores configuram os campos e uploads exigidos para cada inscrição por meio de:

• RegistrationFieldConfiguration — campos de formulário, como texto, seleção, checkbox, data e outros tipos de entrada.
• RegistrationFileConfiguration — slots de upload de arquivo, com templates opcionais.
• RegistrationStep — agrupamento de campos em etapas nomeadas para formulários de múltiplas páginas.

Os campos podem ser condicionais, isto é, visíveis apenas quando outro campo possui um valor específico, e também podem ser limitados a categorias, tipos de proponente ou faixas específicas.

Módulos adicionais

Publicação de resultados

Quando a avaliação termina, administradores publicam os resultados chamando publishRegistrations(). Essa ação:

1. Define publishedRegistrations = true na oportunidade.
2. Aplica os selos configurados aos agentes proprietários das inscrições aprovadas.
3. Dispara hooks que módulos podem usar para processamento adicional após a publicação.

$opportunity->publishRegistrations();

Os resultados também podem ser despublicados por unPublishRegistrations(), que reverte a atribuição dos selos.

Ciclo de status

Criando uma oportunidade