pjecalc-transformacao

Files (7)

• SKILL.md
• ambiente-deploy.md · references/
• automacao-playwright.md · references/
• contrato-json.md · references/
• exportacao-pjc.md · references/
• extracao-ia.md · references/
• validacao-hitl.md · references/

SKILL.md (first lines)

# PJe-Calc Agente — Guia de Transformação Baseado no CalcMACHINE

## Por que esta skill existe

O CalcMACHINE v1.6.1 (SuitePlus/EnsinoPlus) é a prova de que automatizar o PJe-Calc Cidadão
de ponta a ponta funciona em produção. Esta skill documenta **como transformar o pjecalc-agente**
para replicar essa arquitetura e esse sucesso, baseando-se na análise completa do CalcMACHINE
feita em abril/2026.

O pjecalc-agente precisa deixar de ser um conjunto de scripts avulsos e se tornar um sistema
com a mesma disciplina do CalcMACHINE: separação clara de camadas, validação antes de
automação, ordem estrita de preenchimento, e tratamento robusto de erros JSF.

---

## ⛔ REGRA INVIOLÁVEL: Geração de .PJC

**O arquivo .PJC só pode ser gerado pelo PJe-Calc Cidadão, executado via automação Playwright.**

Gerar .PJC de forma nativa (Python gerando ZIP+XML) é **PROIBIDO** neste projeto. O motivo é
prático e definitivo: o PJe-Calc Institucional (sistema do TRT para inserção do cálculo no
processo judicial) **somente aceita importação de arquivos gerados pelo próprio PJe-Calc ou
PJe-Calc Cidadão**, marcando como inválidos quaisquer outros — independentemente de o XML
estar sintaticamente correto.

Portanto:

- **NUNCA** implemente, sugira ou use a skill `pjc-file-generator` neste contexto
- **NUNCA** gere ZIP+XML ISO-8859-1 como fallback para .PJC
- **NUNCA** tente replicar o formato interno do .PJC para bypass
- Se a automação Playwright falhar na fase de exportação, **corrija a automação** — não tente
  contornar gerando o arquivo por fora
- O único caminho válido: Playwright abre PJe-Calc → preenche campos → clica Calcular →
  clica Exportar → coleta o .PJC gerado pelo PJe-Calc

Esta regra não tem exceções. Código que gere .PJC fora do PJe-Calc é código morto — o
arquivo resultante será rejeitado na importação.

---

## Arquitetura-Alvo: 3 Camadas

O pjecalc-agente deve adotar a mesma separação de responsabilidades do CalcMACHINE:

```
┌──────────────────────────────────────────────────────────┐
│  CAMADA 1 — FRONTEND                                     │
│  Responsabilidades:                                      │
│  • Receber sentença (texto/PDF upload)                   │
│  • Exibir formulário de revisão do JSON (HITL)           │
│  • Validação client-side (espelha backend)               │
│  • Monitor SSE de progresso em tempo real                │
│  • NÃO executa automação — apenas observa               │
│  Tecnologias sugeridas: React/Next.js ou HTML+JS simples │
└────────────────────────┬─────────────────────────────────┘
                         │ REST API (JSON)
                         ▼
┌──────────────────────────────────────────────────────────┐
│  CAMADA 2 — BACKEND                                      │
│  Responsabilidades:                                      │
│  • Extração com IA (Claude API, temperature=0)           │
│  • Validação completa do JSON                            │
│  • Persistência (banco de dados)                         │
│  • Automação SERVER-SIDE (Playwright → PJe-Calc)         │
│  • Streaming de progresso via SSE                        │
│  • Coleta e entrega do .PJC gerado pelo PJe-Calc        │
│  Tecnologia sugerida: FastAPI (Python) ou Flask          │
└────────────────────────┬─────────────────────────────────┘
                         │ HTTP (Playwright → localhost:9257)
                         ▼
┌──────────────────────────────────────────────────────────┐
│  CAMADA 3 — PJe-Calc Cidadão (JSF/Tomcat porta 9257)    │
│  • JavaServer Faces com ViewState + AJAX                 │
│  • IDs dinâmicos (j_idt42, javax.faces.ViewState)        │
│  • PrimeFaces para dropdowns e calendários               │
│  • Única fonte autorizada para geração de .PJC           │
└──────────────────────────────────────────────────────────┘
```

**Princípio central:** a automação roda no servidor, nunca no navegador do usuário. O frontend
é apenas interface de revisão e monitoramento.

---

## Pipeline Completo: 6 Fases

O pipeline transforma uma sentença trabalhista em arquivo .PJC pronto para importação:

```
Sentença (PDF/texto)
    │
    ▼
Fase 1 — Ingestão ............... Extrair texto do PDF/receber texto colado
    │
    ▼
Fase 2 — Extração com IA ........ Claude API → JSON estruturado
    │
    ▼
Fase 3 — Validação + HITL ....... Validar JSON + revisão humana obrigatória
    │
    ▼
Fase 4 — Pré-verificações ....... 6 checks antes de iniciar automação
    │
    ▼
Fase 5 — Automação Playwright ... 9 fases contra PJe-Calc (server-side)
    │
    ▼
Fase 6 — Exportação ............. PJe-Calc gera .PJC → backend coleta e entrega
```

Cada fase tem seu próprio arquivo de referência detalhado. Consulte-os conforme a
necessidade:

| Fase | Referência | Quando consultar |
|------|-----------|-----------------|
| 1-2 | `references/extracao-ia.md` | Implementar/corrigir extração de sentença com IA |
| 3 | `references/validacao-hitl.md` | Implementar validação ou interface de revisão |
| 4-5 | `references/automacao-playwright.md` | Implementar/depurar automação do PJe-Calc |
| 6 | `references/exportacao-pjc.md` | Entender como coletar o .PJC e entregar ao usuário |

From bragabarreto/pjecalc-agente, MIT.

More from bragabarreto/pjecalc-agente