Configuración de procesos¶

Todo lo que se describe acá se hace manualmente, desde la interfaz de escritorio, por personal de soporte técnico. No hay ningún endpoint HTTP para configurar esto — es justamente lo que diferencia a esta app del servicio de documentos.

Certificados¶

Un certificado digital se registra desde uno de dos repositorios posibles:

Cada certificado guarda su alias, serial, commonName, y sus fechas de emisión y expiración. Un proceso en segundo plano (cada 60 segundos) revisa la vigencia de todos los certificados y pausa automáticamente (activo = false) cualquier proceso cuyo certificado ya venció — antes de que llegue un documento que no se podría firmar.

Procesos¶

Un "proceso de firma" es la configuración completa de un flujo de firma: qué certificado usar, en qué carpetas buscar/dejar archivos, y cómo se ve la firma en el documento. El id de un proceso es el mismo idProcesoFirma que usan los clientes del servicio de documentos para elegir a dónde mandar cada PDF.

Campos principales: - Nombre, activo/inactivo, cliente asociado (opcional — combo de solo lectura, ver Arquitectura y flujo). - Certificado a usar. - Rutas: carpeta de entrada, de salida, y de error (opcional). - Perfil de firma (ej. PAdES-B, PAdES-T, PAdES-LTA) y algoritmo de hash (SHA-256/384/512).

Apariencia de la firma¶

Cada proceso define cómo se ve la firma insertada en el PDF:

• Estilo: solo texto, solo imagen, o combinaciones de texto e imagen (a la derecha, izquierda, arriba, abajo, de fondo, o un reparto personalizado en porcentaje).
• Texto: una plantilla con placeholders ([CN], [FECHA], etc.), fuente, tamaño, alineación horizontal/vertical.
• Imagen (si el estilo la incluye): ruta del archivo, tamaño, si mantiene proporción, alineación.
• Metadatos de firma: motivo, locación, si exige no repudio, fecha/hora personalizada, creador.
• Sello de tiempo (TSA): URL, usuario, contraseña (cifrada) de una autoridad de sellado de tiempo externa.
• Glosa (opcional): un texto adicional insertado en una hoja nueva, con la posibilidad de incluir código QR y/o de barras.

Posición de la firma: perfil vertical y horizontal¶

Cada proceso guarda dos perfiles de posición independientes para el recuadro de la firma: uno para cuando el documento que llega es vertical, y otro para cuando es horizontal. Esto existe porque un mismo proceso puede recibir, con el tiempo, documentos de ambas orientaciones — y una sola posición fija no sirve para las dos.

Cómo se configura: el visor de posición (un PDF de muestra, renderizado en pantalla) tiene dos botones separados — "configurar posición vertical" y "configurar posición horizontal" — cada uno abre el mismo selector, pero guarda el resultado en un par de columnas distinto (firma_x/firma_y/firma_ancho/firma_alto para el vertical, firma_x_horizontal/etc. para el horizontal). Si el perfil horizontal nunca se configura, el proceso simplemente sigue usando siempre el vertical, sin importar la orientación real del documento.

Cómo se decide cuál usar, documento por documento: al detectar un archivo nuevo, esta app abre esa página del PDF y calcula su orientación real — considerando tanto el tamaño de la página como su rotación (la bandera interna de un PDF que indica "mostrar esta página girada", muy común en documentos escaneados). Un documento cuya página mide más de ancho que de alto, ya sea porque la hoja es horizontal de fábrica o porque está rotada 90°/270°, se clasifica como horizontal — y si el proceso tiene un perfil horizontal configurado, se usa ese; si no, se usa siempre el vertical.

La posición guardada es "relativa a lo que se ve en pantalla" al configurarla — no a las coordenadas internas específicas del PDF de muestra usado. Esto permite que la misma posición configurada una sola vez se aplique correctamente sin importar si un documento futuro logra su orientación horizontal por tener una hoja realmente ancha, o por venir rotado.

Página y alcance de la firma¶

• Página: un número fijo, o "todas las páginas" (para firmar cada página del documento, no solo una).