Cards

Um Card reúne regras que preparam ou ajustam um deck NEWAVE ou DECOMP. Use Cards para reaproveitar premissas, como uma alteração de carga ou uma restrição operativa, e para deixar registrada a configuração de cada estudo.

Você escolhe Cards no catálogo sem escrever YAML. Para criar um Card, use + Novo Card e descreva o ajuste ao assistente, que monta o Card e mostra a prévia, em qualquer nível (global, estudo ou rodada). Esta página explica o uso no Portal. Para escrever ou revisar o YAML de um Card, consulte a referência do YAML e os exemplos das famílias. Para usar Cards pela API, consulte Regras de deck pela API.

Base e ajustes

Cada composição tem exatamente uma base, na primeira posição, seguida de zero ou mais ajustes:

• a base monta o deck: define as restrições, a política do gerenciador de PLs e as formações recorrentes de NEWAVE e DECOMP;
• cada ajuste altera o resultado do Card anterior.

A base oficial do Myria vem selecionada por padrão e aparece como Base Myria nos três níveis, no topo da sequência, sem número e com o selo BASE; os Cards seguintes são numerados de 1 a N. A Base Myria não sai da sequência: você pode trocá-la por outra base completa, publicada pela sua organização, e voltar a ela com Voltar à Base Myria.

Os Cards são aplicados de cima para baixo. Um Card posterior pode sobrescrever o que um anterior definiu. Nos ajustes, definir substitui o valor, somar acrescenta um delta e multiplicar aplica um fator. Para aumentar 5% em YAML, use multiplicar: 1.05; em uma planilha Excel de ajustes, use TIP=1 com o valor 5. Não misture as duas convenções.

Onde abrir os Cards

Há três pontos de entrada:

Onde	Como abrir	O que você configura
Organização	Na página Estudos, ícone de cartas antes de Importar estudo	O padrão Global, copiado para cada estudo novo
Estudo	Ícone de cartas do estudo, antes do ícone do Git	A sequência do estudo, herdada pelas suas rodadas
Rodada	Engrenagem da rodada, aba Montagem do deck, seção Cards	A sequência usada somente nessa rodada

Os três níveis usam a mesma tela. À esquerda fica o Catálogo, com busca e o menu Filtrar catálogo. À direita fica a sequência do nível (Sequência global, Sequência do estudo ou Sequência desta rodada): a base em primeiro lugar e os Cards numerados na ordem em que são aplicados. A coluna da sequência fica fixa ao lado do catálogo enquanto você rola a tela. Arraste um Card do catálogo para a sequência pela alça de seis pontos; durante o arraste, a carta indica a posição em que ele vai entrar (por exemplo, Entra como 3º), e solto no espaço livre da coluna ele vai para o fim. Arraste um Card da sequência de volta ao catálogo para retirá-lo. Os botões Adicionar, Remover, ↑, ↓ e × fazem o mesmo pelo teclado. No catálogo, a carta de um Card já em uso mostra Na sequência · 2º com o mesmo número da sequência. Enquanto houver mudanças não gravadas, o topo da sequência mostra Alterações não salvas. No celular, as abas Catálogo e Sequência alternam as duas colunas; a tela abre na sequência. O botão + Novo Card (no topo do painel Cards; na rodada, ao lado do título do catálogo) abre o Novo Card no lugar do catálogo.

No painel do estudo, o seletor Global | Estudo troca o nível sem fechar a janela. O nível escolhido define o catálogo, o cadastro, a sequência e a opção de ajustes condicionais. No nível Estudo, o título da sequência traz o nome do estudo (Sequência do estudo · nome). Se houver alterações não salvas, a troca pede confirmação. Aberto pela página Estudos, o painel funciona só no nível Global.

Cada nível herda do anterior no momento da criação. Um estudo novo recebe uma cópia da revisão atual do padrão global; uma rodada recebe a sequência do seu estudo; uma rodada criada como continuação herda a configuração da rodada de origem. Mudar o padrão global afeta estudos novos, mas não altera estudos e rodadas que já existem.

Cards com vigência mensal também se aplicam às revisões DECOMP. Meses civis ou relativos (mes_1, mes_2 etc.) selecionam os estágios do calendário da própria rodada; meses fora do horizonte não acrescentam estágios. Se o deck não comprova esse calendário, a preparação é bloqueada até a correção da fonte.

Escolher Cards no catálogo

O catálogo reúne os Cards publicados pela Myria e pela sua organização. Use a busca e o menu Filtrar catálogo para filtrar por origem (Myria, Sua organização, Neste estudo), modelo (NEWAVE, DECOMP) e formato (YAML, Excel). A busca e os filtros consultam o catálogo inteiro; use Carregar mais para ver os próximos resultados. As cartas do catálogo têm as mesmas ações nos três níveis: Detalhes e Adicionar (ou Remover, quando o Card já está na sequência; Usar como base, para uma base).

Um Card criado dentro de um estudo ou de uma rodada fica exclusivo daquele estudo. No nível Global, a origem Exclusivos de estudos lista esses Cards com o estudo e, quando conhecida, a rodada onde foram criados. Ali eles ficam só para leitura: para usá-los, abra os Cards pela entrada do estudo ou clique em Tornar da organização no detalhe do Card. A partir daí o Card aparece no catálogo de todos os estudos da organização; as sequências que já o usam não mudam.

Em Detalhes, cada Card mostra título, descrição, tutorial, origem e as versões publicadas. Use Ver no Git para abrir o arquivo versionado ou baixe o YAML de qualquer versão em Versões publicadas.

O catálogo Myria inclui, por exemplo:

• +1 GW de carga no primeiro mês, que atua no Sudeste/Centro-Oeste em NEWAVE e DECOMP;
• Porto Primavera · vazão mínima de 1.900 m³/s, que aplica VAZMINT à UHE 46 no NEWAVE e o limite inferior da HQ 87 no DECOMP, entre outubro e dezembro de 2026.

No detalhe do Card, Duplicar cria uma cópia independente do Card para você editar, com o título seguido de "(cópia)". Um Card oficial da Myria é copiado em YAML para a sua organização; a cópia de um Card exclusivo de um estudo fica nesse mesmo estudo. O original e as sequências que já o usam não mudam, e a cópia não entra em nenhuma sequência até você adicioná-la.

A cópia de um Card da Myria, inclusive da Base Myria, vira um arquivo próprio em regras/cards/ no repositório arquivos da sua organização. No detalhe da cópia, Editar no Gitea abre esse arquivo para edição. Depois de salvar no Gitea, volte ao Card e use Atualizar arquivo do Git para publicar a nova versão; sequências já salvas continuam na versão anterior. Para montar seus decks com uma base própria, abra a cópia da base e clique em Usar como base na sequência global, do estudo ou da rodada.

Um Card cadastrado no nível Estudo é exclusivo desse estudo: aparece somente quando o catálogo é aberto nele ou em uma de suas rodadas e não pode ser usado em outro estudo nem no padrão global. Os Cards da Myria e os Cards globais da organização aparecem nos dois níveis.

Montar a sequência

1. Clique em Adicionar em um Card do catálogo. No computador, você também pode arrastar o Card para a coluna de sequência; ele entra no final.
2. Reordene arrastando os Cards ou usando as setas.
3. Na linha de origem de cada ajuste, ligue ou desligue NEWAVE e DECOMP para dizer em qual modelo ele vale. Pelo menos um precisa ficar ligado; o aviso aparece na própria carta.
4. Para retirar um Card, use o botão de remover ou arraste-o de volta ao catálogo.
5. Clique em Salvar e fechar.

Adicionar outra base substitui a base atual. Voltar à Base Myria, na carta de uma base da sua organização, restaura a Base Myria. Buscar, cadastrar, adicionar e remover não fecham a janela: a composição só é gravada em Salvar e fechar, no nível que estiver ativo. As mensagens de cada ação aparecem no rodapé, ao lado dos botões.

Criar um Card

1. Abra o painel Cards e confira o nível: em Global, o Card fica disponível para toda a organização; em Estudo, somente para o estudo aberto. Nos Cards de uma rodada, o Card novo vai para o catálogo do estudo.
2. Clique em + Novo Card e descreva o ajuste ao assistente, por exemplo vazão mínima de Porto Primavera em 3.900 m³/s de setembro a abril. A prévia do Card aparece ao lado; em Texto do Card (YAML) você confere ou edita o texto. Veja Criar um Card com o assistente.
3. Para trazer um Card que você já tem, use Importar Card existente: Do computador (texto do Card ou planilha Excel de ajustes) ou Do repositório Git.
4. Confira o Título. Em Mais opções, ajuste descrição, tutorial e tags; descrição e tutorial aceitam Markdown, que aparece no detalhe do Card.
5. Clique em Salvar no catálogo ou em Salvar e adicionar à sequência do nível em que você está.

Salvar no catálogo não coloca o Card em nenhuma sequência: volte ao catálogo e use Adicionar quando quiser usá-lo.

Formatos aceitos

O Myria reconhece o formato pelo conteúdo do arquivo e confere se ele combina com a extensão:

Formato	Selo no catálogo	Uso
.yaml ou .yml	YAML	Formato nativo dos Cards (versao: 5, tipo: card).
.xlsx ou .xls	Planilha Excel	Importação de uma planilha de ajustes existente no modelo suportado, convertida para um Card YAML ao salvar.

O limite é de 2 MiB por arquivo. O Myria não distribui modelo de planilha de ajustes: o formato serve apenas para importar planilhas que você já tem. Arquivos Excel Myria são recusados; use YAML.

Escrever o texto do Card

No Novo Card, a vista Texto do Card (YAML) aceita texto escrito ou colado à mão. Clique em Conferir texto (ou Ctrl+Enter): o Myria valida o documento com as mesmas regras da montagem, atualiza a prévia e mostra os problemas com o número da linha. Os exemplos de cada família estão em Exemplos das famílias YAML.

Versões e atualizações do Git

Ao importar um Card Do repositório Git e salvá-lo sem alterar o texto, o Myria lê a versão atual do arquivo e fixa o commit. Para ver o histórico ou comparar versões, use o Gitea. Se você editar o texto ou pedir ajustes ao assistente antes de salvar, o Card é salvo como um Card novo, sem vínculo com o arquivo.

Um commit novo no mesmo arquivo não altera o Card cadastrado nem os estudos que já o usam. O detalhe do Card passa a mostrar Atualização disponível:

1. Um usuário da organização que publicou o Card clica em Atualizar arquivo do Git para publicar a nova versão no catálogo. As composições que já usam o Card continuam na versão anterior.
2. Para adotar a nova versão em uma composição, escolha Usar versão mais recente na sequência e salve. Cancelar ou fechar sem salvar mantém a versão anterior.

Aplicar mudanças a rodadas existentes

Salvar a sequência do estudo altera apenas o padrão do estudo. As rodadas que já existem continuam com os arquivos montados. Para levar a nova composição a elas:

1. No painel Cards do estudo, clique em Aplicar às rodadas selecionadas.
2. Escolha as rodadas. O Portal mostra uma prévia e aplica a mudança somente às rodadas cuja composição efetiva muda.

Rodadas com uma sequência própria não são sobrescritas. Para que uma rodada volte a seguir o estudo, abra os Cards da rodada e clique em Voltar à sequência do estudo: a sequência da rodada é substituída e a troca é salva na hora. Se a rodada já tiver resultados ou tentativas, o Portal pede confirmação antes de invalidar os resultados e montar o deck de novo; os resultados e as tentativas anteriores continuam no histórico. Enquanto houver uma montagem ou execução em andamento, a edição fica bloqueada.

Na rodada, Salvar alterações, no rodapé da configuração da rodada, grava a sequência sem executar a rodada. Se a rodada já tinha sido preparada para execução, o pé da sequência mostra Versão N salva · deck ainda não regenerado até o deck ser montado com a nova sequência. Enquanto a rodada está somente leitura, os Cards continuam à vista, sem os controles de mudança, e um aviso explica o motivo, por exemplo Somente leitura: a rodada está em execução ou na fila. Os Cards voltam a ser editáveis quando ela terminar. A configuração da rodada como um todo (fontes, hidrologia, EARM e execução) está em Configuração da rodada.

Ajustes condicionais dos Cards

Alguns Cards têm uma seção antes_de_rodar, com ajustes que dependem do estado de partida da rodada, como o armazenamento herdado da rodada anterior. Esses ajustes são aplicados logo antes de executar o modelo. Veja Antes de rodar.

O interruptor Ajustes condicionais (antes de rodar), ao pé da sequência, liga ou desliga somente a seção antes_de_rodar dos Cards. O antes_de_rodar da base (Base Myria ou base própria) sempre roda. Desligá-lo também não desliga a montagem obrigatória do deck, a preparação da hidrologia, a EARM nem as validações.

Se um Card cria uma restrição em montar e liga a ela condições em antes_de_rodar, essas condições fazem parte da criação: com o interruptor desligado, a montagem é recusada com source_declared_preflight_required_for_creation. Retire o Card da sequência ou ligue o interruptor.

A opção segue a mesma herança da sequência. No estudo, Usar padrão global volta a herdar o padrão da organização. Na rodada, Herdar do estudo volta a herdar a opção do estudo, e o controle indica se ela está Herdado do estudo ou Definido nesta rodada. Mudar o padrão global não altera estudos que já existem.

Prévia do deck

Nos Cards da rodada, a área Prévia do deck, abaixo do catálogo e da sequência, mostra o estado da prévia; clique no título para abrir o detalhe. Gerar prévia do deck monta o deck com a sequência salva e compara os arquivos antes e depois dos Cards. A prévia usa a mesma montagem da execução, mas não executa NEWAVE nem DECOMP e não grava nada no repositório do estudo. Salve a sequência antes de gerar a prévia.

A prévia mostra, nesta ordem:

• o Efeito consolidado de cada Card, com alvo, período, valor de entrada e valor final, inclusive os efeitos derivados que um Card provoca em outros blocos;
• os Arquivos alterados, com os blocos de cada arquivo e o estado (alterado, novo ou removido);
• os diagnósticos do montador;
• Detalhes técnicos, recolhido: modelo, hashes, fontes e proveniência;
• os Cards desta versão, na ordem de aplicação, com a mesma numeração da sequência (a base com o selo BASE, os Cards de 1 a N);
• o Deck base desta rodada: o deck depois da montagem e antes dos Cards.

Cada efeito recebe um destes estados:

Estado	Significado
Aplicado	O Card alterou o deck.
Substituído pelo comando direto	O Card também define diretamente o mesmo bloco, e o valor direto prevalece sobre o efeito derivado.
Fora do horizonte	O período do Card não cai no horizonte desta rodada.
Sem alteração	O Card não mudou nenhum valor, por exemplo porque o alvo não existe ou o valor já era o mesmo.

Se você mudar a sequência depois de gerar a prévia, salve e gere outra.

Antes de usar um Card novo em estudos de produção, gere a prévia em alguns decks representativos, confira os diagnósticos e rode uma rodada de teste.

Erros comuns

Situação	O que fazer
Arquivo Excel recusado com myria_workbook_disabled	O arquivo é um Excel Myria, que não é aceito. Envie o conteúdo em YAML.
Planilha recusada com spreadsheet_dialect_ambiguous	A planilha não é reconhecida como uma planilha de ajustes no modelo suportado. Confira se ela segue o modelo original, sem alterações de estrutura.
Arquivo recusado com deck_rules_document_type_mismatch	O documento declara um tipo diferente do esperado. Uma base usa tipo: base; um Card usa tipo: card.
Arquivo recusado por tamanho	Reduza o documento para até 2 MiB ou divida os ajustes em mais de um Card.
Sequência recusada ao salvar	Uma composição aceita até 20 ajustes, e cada Card pode aparecer uma vez. Para repetir um efeito, escreva-o em outro Card.
Base própria recusada	A base precisa declarar politicas.newave.gerenciador_pls e as seis listas de restrições do DECOMP. Veja Base própria.
Base própria bloqueada na montagem	A base precisa declarar todas as políticas de construção e o bloco cadastros, com os arquivos presentes no repositório arquivos da sua organização. Veja Base própria.
Card recusado com legacy_spelling	O YAML usa uma grafia antiga, como restricao:, ativo, estagios, alvo ou patamar_1. Reescreva a entrada na forma da referência do YAML.
Card recusado com state_in_build	volume_inicial(...) ou mes_pmo apareceu em montar. Mova a condição para antes_de_rodar.
Montagem recusada com source_declared_preflight_required_for_creation	O interruptor Ajustes condicionais está desligado e um Card cria uma restrição que depende do próprio antes_de_rodar. Ligue o interruptor ou retire o Card.
Montagem bloqueada com SRC001 a SRC005	O erro está no YAML (SRC001) ou nos arquivos do deck (SRC002 a SRC005). Veja Erros que bloqueiam a rodada.
Card não aparece no catálogo	Confira os filtros e o nível. Um Card exclusivo de outro estudo não aparece aqui.
Commit novo no Git não foi usado	Abra o detalhe do Card, clique em Atualizar arquivo do Git e depois em Usar versão mais recente na sequência.
A rodada não mudou depois de salvar o estudo	Salvar o estudo não altera rodadas existentes. Use Aplicar às rodadas selecionadas.

Referência do YAML

O formato completo dos Cards, com base, ajustes, operações, formações e erros, está na referência do YAML. Há um exemplo pronto para cada uma das 33 famílias em Exemplos das famílias YAML.