Repository navigation
Como funciona
Esta página explica, em linguagem técnica, o que o programa faz por dentro.
Cada instalação do PJe-Calc Cidadão roda um servidor Tomcat local com um banco H2 em .dados\pjecalc.h2.db, dentro da pasta da versão. Por isso, uma versão nova instalada em outra pasta começa vazia.
O programa procura nas unidades do computador pastas com a estrutura do PJe-Calc (bin\pjecalc.jar, tomcat\conf\server.xml, .dados). Do server.xml ele lê as portas e, do context.xml, os dados de acesso ao banco.
Uma cópia temporária do banco é aberta com o Java e o H2 que já vêm no PJe-Calc. Para ler, o banco original nunca é aberto nem alterado. A consulta exporta para CSV: número, partes, processo, datas e situação de cada cálculo. É assim que funcionam a lista de cálculos, a planilha, a conferência e a detecção de duplicados.
Se a versão estiver aberta, o programa envia ao Java do PJe-Calc o mesmo aviso que o Windows envia ao desligar o computador. O PJe-Calc desliga o Tomcat e fecha o banco de forma ordenada, igual ao Sair do ícone na bandeja. O programa nunca encerra à força. No final, ele reabre a versão.
O programa liga o PJe-Calc em segundo plano, sem janela e sem abrir o Firefox, com os mesmos parâmetros do iniciarPjeCalc.bat. Depois controla o Edge ou o Chrome em modo invisível e faz o mesmo caminho da tela:
- exportar: Buscar → Abrir → Exportar → Fechar;
- importar: Importar → escolher o arquivo → Confirmar.
No fim, desliga o PJe-Calc pelo comando oficial do Tomcat, que fecha o banco corretamente.
Depois da exportação, cada .PJC (um .zip com um XML) é lido e o número do cálculo é comparado com a lista tirada do banco: "12 de 12 conferidos". A cópia do banco também é aberta, para provar que está íntegra.
O PJe-Calc mantém um contador de versão (IIDVERSAO) que aumenta a cada gravação. Para cada cálculo, o programa junta:
- a versão e o código de liquidação do próprio cálculo (
TBCALCULO); - a quantidade de linhas e a soma das versões em todas as tabelas ligadas a ele: verbas, histórico salarial, FGTS, INSS, faltas, férias etc. A lista é descoberta automaticamente no banco.
O resultado vira um código (SHA-1). Se o código for igual ao do backup anterior e o .PJC guardado lá for do mesmo cálculo (mesmo número, reclamante, reclamado, processo e datas), o arquivo é copiado de lá; se não, o cálculo é exportado. Os códigos ficam no backup.json de cada backup.
O número do cálculo é a chave IIDCALCULO da tabela TBCALCULO, gerada pela sequência SQCALCULO do H2. O PJe-Calc cria essa sequência com CACHE 32: o H2 reserva 32 números de uma vez e só grava o valor real quando o banco fecha direito. Num fechamento anormal, o que estava reservado se perde, e a numeração pula de 32 em 32.
-
Reserva de 1 número: o H2 1.3 não muda o
CACHEde uma sequência existente, então ela é recriada comCACHE 1, começando no maior número existente + 1. -
Mudar o número: as colunas que guardam o número do cálculo são lidas do próprio banco (chaves estrangeiras que apontam para
TBCALCULOe colunasIIDCALCULOdas outras tabelas). Primeiro todos os números que mudam vão para valores temporários negativos, depois para os definitivos; assim trocas como 5 ↔ 7 nunca colidem. - Segurança: o banco é copiado para a pasta de backups e conferido byte a byte; a mudança roda numa cópia; a cópia é conferida (mesma quantidade de registros por tabela e por cálculo, nenhum registro solto, contador certo) e só então substitui o original, que também é lido de novo.
-
Versões conferidas: o código de validação do cálculo (
calcularHashCodeDaLiquidacaoecalcularHashCodeExpandidoDoCalculo) não usa o número do cálculo no PJe-Calc 2.13.0, 2.14.0 e 2.16.0. Em outras versões, a mudança de número fica bloqueada.
Detalhes de uso: Numeração dos cálculos.
O .zip do backup é conferido, o PJe-Calc é fechado, uma cópia de segurança do banco atual é guardada e o arquivo é trocado. Depois, o novo banco é aberto e a quantidade de cálculos é conferida.
O instalador do TRT8 deixa na pasta um banco vazio e o arquivo persistence.xml.tmp. Na primeira abertura, o PJe-Calc só renomeia esse arquivo para persistence.xml, com o mesmo conteúdo (conferido na 2.16.0, comparando a pasta antes e depois). Quando encontra exatamente esse estado, o programa faz esse mesmo passo antes de importar. Em qualquer outro estado, ele não mexe na pasta e pede para abrir a versão uma vez pelo atalho oficial.
Ao abrir, o programa lê a página de instalação do PJe-Calc no site do TRT da 8ª Região e procura o número da versão, o link do instalador e o código MD5 publicado. O download vem só desse endereço oficial e é conferido pelo MD5 antes de ser oferecido para abrir. Se a página mudar de formato e esses dados não forem encontrados, o aviso não aparece. O MD5 é o código que o TRT8 publica; ele confirma que o arquivo chegou inteiro, igual ao da página.
Antes do backup, o programa estima o espaço necessário e compara com o espaço livre do destino (funciona também com pendrive e pasta de rede). A conta é folgada de propósito: o tamanho de cada banco, mais 200 KB por cálculo a exportar em .PJC (um .PJC costuma ter dezenas de KB), mais 20 MB de margem. No backup rápido, o uso real costuma ser bem menor.
O texto técnico é montado no computador. Antes de mostrar, o programa troca por marcadores os nomes das partes e os números de processo que ele lê do banco, além de qualquer CPF, CNPJ ou número de processo no formato do CNJ, a pasta do usuário do Windows e o nome do usuário. Nada é enviado pelo programa: ele só abre o e-mail ou a página do GitHub com o texto, e a pessoa confere antes de mandar.
C# com WPF, compilado com o compilador que já vem no .NET Framework 4.8 do Windows (app\compilar.ps1). Sem bibliotecas externas: o leitor do banco, o QR Code PIX, a planilha .xlsx e o GIF do README foram escritos no próprio projeto.
PJe-Calc Backup · projeto independente e não oficial, sem vínculo com o TRT da 8ª Região (que desenvolve o PJe-Calc), com o CSJT ou com a equipe do PJe-Calc · Licença MIT · Baixar · Apoie o projeto