Mock de Integrações do PIM
Visão geral

Mock dos sistemas externos consumidos pelo PIM.

Esta aplicação simula as integrações que o Way2Pim faz contra sistemas de terceiros, devolvendo respostas mockadas para que cada cenário (sucesso, erro, rate-limit) possa ser exercitado sem depender dos serviços reais.

Funcionalidades implementadas

20 casos de uso disponíveis

46 endpoints no total
2 front-end 4 API

Coleta Integrada CCEE (APP-16)

Simulador de resposta da CCEE: recebe o envio SOAP, parseia e persiste o arquivo de coleta, registra ticket, dispara webhook de retorno ao PIM e replica o DS-9 nas grandezas SCDE (com divergência controlada opcional). Evidência do CU-03 da PoC Energisa — nenhum tráfego sai do ambiente.

Front-end
  • POST
    Enviar Coleta de Medição /coleta-integrada-ccee/ws/v2/ColetaMedicaoBSv2
  • POST
    Consultar Situação da Coleta /coleta-integrada-ccee/ws/v2/SituacaoColetaMedicaoBSv2
  • POST
    Login Integraflow (PSP) /integraflow/login
  • GET
    Tela Resumo da Coleta Simplificada (PSP) /integraflow/tela
2 front-end 5 API

Abertura de Mercado CCEE

Simula a API REST da CCEE para o fluxo de Abertura de Mercado, com autenticação OAuth 2.0 via client credentials e consulta paginada de migrações de unidades consumidoras.

Front-end
  • POST
    Emitir Token OAuth /sso/oauth/token
  • GET
    Consultar Migrações /v1/concessionaria/migracoes
  • POST
    Enviar Medições /medidas/v1/medicao
  • GET
    Status de Processamento das Medições /v1/concessionaria/consumo/medicoes/status-processamento-medicao
  • GET
    Consultar Medições Enviadas /v1/concessionaria/consumo/medicoes
1 front-end

Rate-limit

Configura cotas por endpoint e por valores de cabeçalho. As alterações refletem imediatamente na API, sem reinício, e os contadores ativos são exibidos ao vivo.

Front-end
1 front-end

Probabilidade de erro

Configura a chance de falha simulada por chave: endpoints HTTP respondem 500, o webhook do ColetaIntegradaCcee pode ser pulado ou responder com Codigo=422, e as medições do AberturaDeMercadoCcee podem vir como REJEITADA.

Front-end
1 front-end

Monitor de tráfego

Captura sob demanda as interações HTTP recebidas — URL completa, método, status, cabeçalhos e (no modo Completo) corpos de request e response. As capturas vivem em memória (ring buffer) e podem ser filtradas por chave, método e status.

Front-end
1 front-end

Endpoints dinâmicos

Cadastra rotas arbitrárias com resposta definida pelo usuário. Cada definição tem matchers de header opcionais e uma lista de cenários (200, 500, 429, latência, corpo inválido…) sorteados por probabilidade. Endpoints reais sempre vencem.

Front-end
1 front-end

Simulação de Coleta

Mock ativo que age como coletor/PdC: consome a API de comandos do PIM, fabrica medições periódicas e as envia ao DataIn 2.0, emitindo os eventos de coleta. Dirigido por um worker configurável em tela (liga/desliga, intervalo, execução manual).

Front-end
1 front-end

Reprocessamento (APP-02)

Loop automático alarme → releitura (dataset B) → DataIn → reconhecimento. Evidência do CU-01 da PoC Energisa (timeline + comparativo de inconsistências antes/depois).

Front-end
1 front-end

Registradores de Verificação (APP-09)

Atende o comando nativo de Leitura de Registradores Totalizadores (Verificação) lendo o DS-5 e devolvendo pelo DataIn, com conferência no Data-Out antes do reporte Ok/Parcial/Erro. Evidência do CU-01 (coleta sob demanda, KPI ≤ 2 min) e do CU-10 passo 3 (leitura pré-troca) da PoC Energisa.

Front-end
1 front-end

Parâmetros elétricos — DS-7 (APP-22)

Atende o comando nativo de Leitura de Parâmetros Elétricos Gerais devolvendo os parâmetros DAQUELE medidor (nº de série lido, relógio interno, relação de TP e de TC) pelo DataIn 2.0, com dataset versionado, valores determinísticos e guarda de envio (reexecução não duplica). Evidência do CU-07 (4) — atendimento ao cliente — e do CU-10 (troca de medidor) da PoC Energisa.

Front-end
1 front-end

Estimativas (APP-03)

Motor externo de estimativa de inconsistências do VEE: lê as inconsistências identificadas (PIM-6982), classifica pela matriz condição→método com precedência (zero → retaguarda → interpolação → média histórica → perfil) e grava as estimativas automáticas (PIM-7407). Contingência do CU-02/08 da PoC Energisa.

Front-end
1 front-end 3 API

Ajuste de constante (APP-07)

Aplicação externa e reativa: observa as execuções do comando de alteração de RTP/RTC emitido na tela nativa do PIM e recalcula a série do período afetado na camada de ponto, sem tocar na camada de medidor. Detecta a reincidência do alarme sobre o mesmo ponto e para de corrigir sozinha, para não entrar em laço. Evidência do CU-03 da PoC Energisa.

Front-end
  • GET
    Listar correções /app07/correcoes
  • GET
    Detalhe da correção /app07/correcoes/{idEvento}
  • POST
    Reprocessar correção /app07/reprocessamentos
1 front-end

Injetor de inconsistências (APP-10)

Bancada que cria, de forma seletiva e reversível, as condições anômalas sobre as quais os demais aplicativos demonstram tratamento. Amostra por tag nativa do PIM, prévia probatória antes de qualquer escrita, conferência de isolamento e desfazer completo. Insumo do CU-01 (falha de comunicação) e precede APP-01, APP-06 e APP-07.

Front-end
1 front-end

RESP-MDC — Respondedor de Comandos

Fundação compartilhada do "medidor" que responde comandos nativos do PIM no ciclo da Simulação de Coleta: latência e modo de falha por código, gate global (fechado, os comandos permanecem na fila do PIM sem nenhum PUT) e log unificado das respostas. Base dos handlers do APP-20 (relógio) e APP-14 (corte/religa).

Front-end
1 front-end 4 API

Faturamento pós-VEE (APP-11)

Orquestra a simulação de fatura NATIVA do PIM por camada (ponto × medidor principal) sobre o lote do ciclo e entrega os XLSX nativos mais relatório, manifesto e rastreabilidade em CSV. Classifica cada UC pela tabela de estimativas e pela trilha do VEE, mede os tempos de faturas e de relatório separadamente e projeta o throughput para 200.000 UCs. Evidência do CU-02 e do CU-03.

Front-end
  • POST
    Disparar execução /api/faturamento-pos-vee/executar
  • GET
    Status da execução /api/faturamento-pos-vee/status
  • POST
    Cancelar execução /api/faturamento-pos-vee/cancelar
  • GET
    Artefatos do ciclo /api/faturamento-pos-vee/artefatos/{ciclo}
1 front-end 6 API

Respondedor de Comandos (APP-14)

Responde, dentro do ciclo da Simulação de Coleta, os comandos nativos de corte, religamento e consulta de status de fornecimento agendados na tela do PIM: aplica a latência configurada, transita o estado de conexão do medidor simulado e espelha o resultado no cadastro nativo. Evidência do CU-03 (corte/religa do Grupo B) da PoC Energisa.

Front-end
  • GET
    Consultar estados /api/respondedor-de-comandos/estados
  • GET
    Consultar log /api/respondedor-de-comandos/log
  • GET
    Consultar configuração /api/respondedor-de-comandos/config
  • PUT
    Atualizar configuração /api/respondedor-de-comandos/config
  • PUT
    Semear estado /api/respondedor-de-comandos/estados/{numeroDeSerie}
  • POST
    Zerar estados (teardown) /api/respondedor-de-comandos/reset
1 front-end

APP-18 — Parametrização e Firmware

Responde os comandos de parametrização e de atualização de firmware que o PIM envia na gestão de dispositivos (CU-05, passos 3 e 4), ecoando a configuração vigente para que o comando não termine "bem-sucedido sem nada mudar". Inquilino do RESP-MDC: latência e log vêm de lá; aqui ficam o conjunto de códigos por família e a falha controlada percentual, com reenvio que normaliza. RTC/RTP pertencem ao APP-07 e são recusados.

Front-end
1 front-end

APP-19 — Grandezas Instantâneas (cadência)

Simulador do comando de grandezas instantâneas (CU-04 passo 7): responde Ok e instala uma cadência persistida — o DS-4 determinístico (com perfis de anomalia por medidor) entra no PIM via POST /api/PaginasFiscais a cada tick da grade t0 + k×cadência (default 15 min), com janela de encerramento automático (default 6 h), parada manual, reemissão sem duplicar e sobrevivência a reinício.

Front-end
1 front-end 2 API

Injetor de eventos programados (APP-21)

Produz a avalanche do CU-06 e o histórico de eventos do CU-07 em três modos: falhas e last gasp, restabelecimento e ruído. Distribui os eventos por uma topologia DS-13 sintética para que a correlação do APP-17 tenha o que agrupar, anuncia na prévia o desfecho esperado por entidade e conclui acionando o APP-17.

Front-end
  • GET
    Resumo da execução /api/app21/execucoes/{cdExecucao}
  • GET
    Topologia em CSV /api/app21/topologia/csv
1 API

Dataset B

Segunda fonte de leitura do medidor simulado (releitura de memória de massa). Determinística: a mesma janela devolve sempre os mesmos valores da coleta original.

  • GET
    Consultar leituras /dataset-b/medidores/{numeroDeSerie}/leituras