# Manual de uso

Aplicación: **IRPF**

Tipo: `plugin`

Documento generado a partir del código, metadatos y estructura actual de la aplicación. Conviene validarlo funcionalmente con el área responsable.

## Finalidad

Sistema de envio de certificados IRPF automatizado. Esta revision refuerza la privacidad de PDFs, limita consultas y descargas al propietario salvo administradores y aisla la vista previa HTML de las campanas. Revision tecnica: se excluyen los ficheros .htaccess del paquete publicado.

## Usuarios previstos

- Usuarios con rol `administradores`
- Usuarios con rol `app_afiliacion`

## Acceso

- Directorio raíz de la aplicación: `plugins/irpf-certificados/apps/irpf-certificados`
- Roles autorizados detectados: `administradores`, `app_afiliacion`.

## Uso habitual

1. Acceder a la aplicación desde la intranet con un usuario autorizado.
2. Revisar el contexto inicial de trabajo, filtros, datos de entrada o configuración visible en la pantalla principal.
3. Ejecutar la operación principal de la aplicación y validar el resultado mostrado o generado.
4. Si la app depende de procesos en segundo plano, verificar que las tareas programadas asociadas estén configuradas y operativas.
5. Comprobar mensajes de confirmación, salidas descargables o cambios persistidos antes de finalizar la sesión.

## Funciones principales

- Gestiona generación o envío automatizado de certificados IRPF.
- Controla privacidad, distribución y trazabilidad documental.
- Sistema de envio de certificados IRPF automatizado. Esta revision refuerza la privacidad de PDFs, limita consultas y descargas al propietario salvo administradores y aisla la vista previa HTML de las campanas. Revision tecnica: se excluyen los ficheros .htaccess del paquete publicado.
- Gestiona persistencia en base de datos y requiere mantener coherencia entre pantallas, procesos y scripts SQL.
- Incluye procesos batch, workers o tareas programadas que deben revisarse en despliegue y operación.
- Puede producir salidas descargables o exportaciones para el usuario final.

## Ficheros y puntos de entrada relevantes

- `app.php`
- `config.php`
- `download.php`
- `download_sent.php`
- `index.php`
- `job.php`
- `manual.php`
- `nuevo.php`
- `opcache_reset.php`
- `pdfs.php`
- `_intranet_root.php`

## Procesos programados o batch

- `api/job_cancel.php`
- `api/job_status.php`
- `job.php`
- `worker/cleanup.php`
- `worker/process_jobs.php`

## Observaciones operativas

- Validar permisos, datos y resultados antes de usar la aplicación en entornos de producción.
- Revisar el análisis funcional y el análisis de requisitos asociados para cambios o ampliaciones.
