Package br.com.vantroba.bi.transporte.powersync

package br.com.vantroba.bi.transporte.powersync

Reset da replicação PowerSync — orquestra os steps que pausam a replicação, derrubam o estado no MongoDB do PowerSync, recriam o slot no PostgreSQL e sinalizam os clientes Dart a refazerem o bootstrap (disconnectAndClear).

É uma operação administrativa sensível: roda num pool single-thread dedicado, exige token de confirmação e preserva contratos congelados (powersync.nuke.*, header X-Confirm-Nuke, dado ultimo_nuke) lidos por clientes externos.

Related Packages

Package	Description
br.com.vantroba.bi.transporte	Raiz do bi-transporte-xls: serviço Micronaut que recebe a planilha XLS de transporte, processa as abas em registros bi_*/xls_* no PostgreSQL e expõe o resultado por API REST e views server-rendered, sincronizando para clientes Dart via PowerSync.
br.com.vantroba.bi.transporte.configuracao	Configuração global de runtime do app, editável pelo admin e persistida em banco — distinta da configuração estática de deploy (application.yml/env).
br.com.vantroba.bi.transporte.processamento	Pipeline de processamento da planilha XLS — a feature central do app.
br.com.vantroba.bi.transporte.seguranca	Camada de segurança específica do app (decisão 0011 / etapa 07): a policy de proteção das views e o fluxo de login Google.

Class	Description
AdminController	Endpoints administrativos: hoje, apenas o "reset" da replicação PowerSync.
AdminViewController	Tela de administração JTE do reset da replicação PowerSync.
MongoAdminService	Operações administrativas no MongoDB do PowerSync.
MongoAdminServiceImpl	Implementação real de MongoAdminService usando mongodb-driver-sync.
MongoAdminServiceStub	Stub de MongoAdminService ativo quando powersync.mongodb.uri está vazio (default em dev).
PostgresReplicationAdmin	Operações administrativas em slots de replicação lógica do PostgreSQL.
PostgresReplicationAdmin.ResetSlotResult	Resultado do PostgresReplicationAdmin.resetSlot(String, String).
PowerSyncProcessControl	Controla pause/resume do PowerSync Service durante o reset.
PowerSyncProcessControlCoolify	Estratégia coolify de PowerSyncProcessControl: reinicia o recurso PowerSync pela API REST do Coolify ao final do reset.
PowerSyncProcessControlNone	Implementação no-op de PowerSyncProcessControl: loga warning e reporta no progresso que o restart do PowerSync é manual.
ResetarPowersync	Auditoria de execuções do "reset" da replicação PowerSync.
ResetarPowersyncAlreadyInProgressException	Sinal do ResetarPowersyncRepository.iniciar(String, String) de que já existe um reset EM_ANDAMENTO (violação do partial unique index).
ResetarPowersyncDetalheView	View-model do reset para a tela de detalhe (admin/resetar-powersync-detalhe) — projeção dos campos que o template exibe.
ResetarPowersyncNotificador	Formata e dispara as notificações Telegram do reset da replicação.
ResetarPowersyncRecovery	Instruções de recuperação manual por step do reset — espelha a matriz de recovery do runbook (docs/resetar-powersync.md).
ResetarPowersyncRepository	Persistência da auditoria de resets em xls_resetar_powersync.
ResetarPowersyncRequest	Body opcional do POST /api/transporte/admin/resetar-powersync.
ResetarPowersyncResponse	Resposta 202 do POST /api/transporte/admin/resetar-powersync.
ResetarPowersyncResumo	View-model do reset para a listagem da tela admin — projeção dos campos que o template admin/powersync exibe.
ResetarPowersyncService	Orquestra os 9 steps do reset da replicação PowerSync.
ResetarPowersyncStatusResponse	Resposta 200 do GET /api/transporte/admin/resetar-powersync/{id}.
ResetStatus	Estados de uma execução de reset da replicação (xls_resetar_powersync.status).
StartupRecoveryService	Recuperação ao subir a aplicação: Processamentos órfãos em PROCESSANDO viram ERRO; Processamentos em PENDENTE são re-enfileirados; Resets órfãos em EM_ANDAMENTO (pool reset- morreu junto com a JVM) viram ERRO — desbloqueia o partial unique index pra novos resets.