Pular para conteúdo

Gerenciamento de Arquivos

A feature de Gerenciamento de Arquivos é responsável por expor e organizar os dados disponíveis na API PLDPro, bem como os mecanismos de aplicação desses dados sobre um Caso. Ela atua como um elo entre os repositórios de dados compartilhados do sistema (por exemplo, cortes, conjuntos padronizados ou outros insumos reutilizáveis) e os Casos, onde esses dados efetivamente são consumidos durante o processamento.

No SDK, essa funcionalidade é disponibilizada pela classe Data.

Visão geral

A feature Gerenciamento de Arquivos permite que a aplicação:

  • Descubra quais tipos de dados estão disponíveis na plataforma
  • Liste os itens de dados pertencentes a cada tipo
  • Consulte as estratégias de dados suportadas pelo backend
  • Execute uma estratégia de dados sobre um Caso específico
  • Fazer download do caso, dos arquivos de entrada ou somente de arquivos específicos

Essas operações são particularmente relevantes no contexto de upload e preparação de arquivos em Casos, pois muitos insumos utilizados nos estudos (como cortes ou dados padronizados) podem ser referenciados, copiados ou aplicados dinamicamente a partir dos dados já disponíveis no sistema, evitando uploads manuais redundantes.

Relação com a feature Casos

A feature Data complementa diretamente a feature Casos. Enquanto Casos é responsável pelo gerenciamento do estudo e pelo upload direto de arquivos, a feature Data permite reaproveitar dados já existentes na plataforma e aplicá-los a um caso por meio de estratégias definidas no backend.

Na prática, isso significa que parte do fluxo de preparação de arquivos de um Caso pode ocorrer de duas formas: - Upload direto de arquivos (via feature Casos) - Aplicação de dados existentes (via feature Data), utilizando estratégias pré-definidas

Essa integração reduz duplicação de dados, padroniza insumos e facilita a reprodutibilidade dos estudos.

Upload de arquivos (via Casos)

Embora a classe Data não faça upload diretamente, ela se integra ao fluxo de preparação de casos junto com a feature Casos, que fornece métodos especializados para envio dos principais insumos utilizados pelos modelos do PLDPro, incluindo:

  • Arquivos de entrada do caso
  • Previsões
  • Cenários do DESSEM
  • Decks de partida (simples e semanal)
  • Arquivos ENA-REE
  • Regras ANA
  • Volumes finais e de partida do DECOMP

Na prática, o fluxo comum é: primeiro realizar o upload (quando necessário) pelo módulo de Casos; em seguida, utilizar a feature Data para aplicar/reaproveitar dados existentes (por exemplo, cortes) através de estratégias, evitando reuploads e garantindo padronização.

Responsabilidades da classe Data

A classe Data centraliza e padroniza o acesso aos dados disponíveis na API PLDPro, cuidando de tratamento de exceções, logging e conversão de tipos (como str para UUID).

Tipos de dados disponíveis

Permite consultar os tipos de dados expostos pela API, que funcionam como categorias lógicas de dados reutilizáveis.

  • Listar tipos de dados disponíveis
    get_available_data_types()

Itens de dados por tipo

Após identificar um tipo de dado, é possível listar os itens disponíveis dentro dessa categoria.

  • Listar itens de um tipo específico
    get_available_data_items(type: str)

Estratégias de dados

A API PLDPro define estratégias de dados, que representam as formas como um dado pode ser aplicado a um Caso.

  • Listar estratégias disponíveis
    list_data_strategies()

Execução de estratégias sobre Casos

O principal ponto de integração entre Data e Casos ocorre na execução de estratégias.

  • Executar uma estratégia de dados
    execute_data_strategy(data_type, item_name, caso_uuid, strategy_name)

Essa operação aplica um item de dado específico a um Caso, utilizando a estratégia escolhida. Internamente, o backend pode: - Copiar arquivos para o diretório do caso - Atualizar arquivos de entrada - Ajustar caminhos ou referências - Preparar automaticamente insumos necessários para a execução

Do ponto de vista do usuário da SDK, essa chamada equivale a uma preparação automatizada de arquivos do caso, sem a necessidade de upload manual.

Papel no fluxo de preparação de casos

No fluxo típico de uso da plataforma, a feature Data atua como um mecanismo de apoio à preparação dos Casos:

  1. O usuário cria ou seleciona um Caso (feature Casos)
  2. Consulta os tipos e itens de dados disponíveis (feature Data)
  3. Escolhe uma estratégia adequada para aplicar esses dados
  4. Executa a estratégia sobre o Caso
  5. O Caso passa a conter os arquivos e referências necessárias para execução

Resumo

A classe Data fornece uma camada de abstração clara e reutilizável para o acesso a dados compartilhados da plataforma PLDPro. Em conjunto com a feature Casos, ela viabiliza um fluxo mais eficiente, padronizado e seguro de preparação de insumos, reduzindo uploads redundantes e promovendo a reutilização consistente de dados entre diferentes estudos.