Guía para la sesión presencial o remota con el cliente. El objetivo: que quede corriendo dos veces por día (08:00 y 18:00) sin que el cliente tenga que tocar nada más.
Antes de sentarte con el cliente, pedile que tenga a mano: su Gmail (con verificación en 2 pasos activable), y usuario/clave de cada portal que use (PJN, EJE/CUIT, MEV). Sin eso no se puede avanzar en la sesión.
01 Requisitos en la máquina del cliente
Node.js LTS instalado — verificar con node -v
Carpeta del programa copiada en la PC (repo monitor-judicial)
npm install corrido sin errores dentro de la carpeta
02 Contraseña de aplicación de Gmail
Una sola vez. Gmail no deja mandar correos automáticos con la clave normal.
Entrar a myaccount.google.com/security y activar "Verificación en 2 pasos"
Entrar a myaccount.google.com/apppasswords, crear una con nombre "Parte Judicial"
Copiar la clave de 16 letras (los espacios no importan)
03 Configurar y probar PJN
Frente obligatorio si el cliente litiga en la Nación.
Doble clic en configurar.bat — contestar: Gmail, contraseña de aplicación, mail destinatario, usuario y clave del PJN, ventana en días, adjuntar/guardar PDF
Al final, aceptar que agende la tarea automática (08:00 y 18:00)
Probar con run-parte-pjn.bat — confirmar que el log diga "Email enviado"
Necesita del cliente: usuario y clave del Portal PJN
04 Frente EJE / JusCABA (Ciudad) si litiga en CABA
Copiar variables de .env.eje.example al final del .env
Completar EJE_USUARIO (CUIT) y EJE_CLAVE
Correr node descubrir-eje.mjs — siembra "Mis Causas" en cartera-eje.xlsx
Abrir el Excel y marcar "NO" en la columna Vigilar para homónimos que no son del cliente
Probar con node parte-diario-eje.mjs
Agendar run-parte-eje.bat en el Programador de tareas (08:00 y 18:00)
Necesita del cliente: CUIT y clave del Portal del Litigante (EJE)
05 Frente MEV / SCBA (Provincia) si litiga en PBA
Copiar variables de .env.mev.example al final del .env
Completar MEV_USUARIO, MEV_CLAVE, MEV_DEPTO_REGISTRADO y MEV_JURISDICCIONES
Correr node descubrir-mev.mjs — recorre los sets de cada jurisdicción configurada
Depurar homónimos con la columna Vigilar, igual que en EJE
Opcional: cargar "Fecha Impulso Real" (causas civiles) y datos penales para que los plazos pasen de estimados a exactos
Probar con node parte-diario-mev.mjs
Agendar run-parte-mev.bat en el Programador de tareas (08:00 y 18:00)
Necesita del cliente: usuario y clave de la Mesa de Entradas Virtual (MEV)
06 Verificación final
Llegó el mail de prueba de cada frente activado, con el Excel adjunto o accesible
Las tareas programadas quedaron agendadas a las 08:00 y 18:00
El cliente sabe dónde está el Excel de cartera en su PC
Avisarle al cliente que la primera semana conviene revisar que los mails lleguen bien
Solución de problemas rápida
No llega el mail
Abrir parte-pjn.log (o el del frente que falle) — ahí queda el error.
"Cannot find package..."
Faltan dependencias — correr npm install de nuevo en la carpeta.
El envío se cuelga o da error de certificado
Suele ser el antivirus/firewall. Desactivarlo un momento o cambiar el puerto SMTP a 587 en el .env.
Se traba en el login del PJN la primera vez
Poner HEADLESS=false en el .env, correr, loguearse a mano una vez, y volver a poner HEADLESS=true.
MEV avisa clave vencida
Actualizar MEV_CLAVE en el .env — el bot reintenta solo, pero no puede generar una clave nueva.
Nota de seguridad: el .env guarda las claves del cliente en texto plano en su disco. No lo copies fuera de esa PC, no lo subas a ningún repositorio ni lo mandes por mail.