# 📂 MAPA DE LA APLICACIÓN — GESTIÓN DOCUMENTAL

> **Documento Canónico de Arquitectura y Navegación**  
> **Sistema**: Servicio Desatendido de Captura, Clasificación y Archivo Documental Automatizado  
> **Directorio**: `c:\fuentes\proyectos delphi\GESTION DOCUMENTAL`  
> **Entorno**: Delphi • Monitor de Sistema de Archivos (Watchdog) • MariaDB / FireDAC  
> **Mapeado por**: Agente [`mapeador`](file:///c:/fuentes/proyectos%20delphi/.agents/agents/mapeador.md)  

---

## 1. Visión General del Sistema

El módulo de Gestión Documental actúa como un agente desatendido en segundo plano (Tray Application) que vigila carpetas compartidas de red donde los escáneres multifunción depositan albaranes, facturas y contratos en PDF. El sistema clasifica, renombra, indexa y archiva cada documento en el repositorio central del ERP sin intervención humana.

```mermaid
graph LR
    Scanner[Escáner Multifunción\nPDF en Bandeja Red] --> Watchdog[uWatchdog\nMonitor de Carpetas]
    Watchdog --> Processor[uProcessor\nMotor de Análisis y Reglas]
    Processor --> Rules[uReglasArchivadoForm\nPatrones por Empresa / Tipo]
    Processor --> DB[uDM\nVinculación con ERP]
    Processor --> Archivo[Repositorio Digital\nEstructurado por Cliente / Año]
    Processor --> Envio[uEmailWhatsApp\nNotificación Automática]
```

---

## 2. Inventario de Proyectos y Unidades

### A. Servicio General — GestionDocumentalTray
* **Proyecto**: [`GESTION DOCUMENTAL\GestionDocumentalTray.dpr`](file:///c:/fuentes/proyectos%20delphi/GESTION%20DOCUMENTAL/GestionDocumentalTray.dpr) | [`GestionDocumentalTray.dproj`](file:///c:/fuentes/proyectos%20delphi/GESTION%20DOCUMENTAL/GestionDocumentalTray.dproj)
* **Volumen**: 12 unidades Pascal, 8 formularios visuales.
* **Componentes Clave**:
  * `uWatchdog.pas`: Hilo de monitorización continua de carpetas mediante APIs de Windows (`ReadDirectoryChangesW`).
  * `uProcessor.pas`: Motor de extracción y parseo. Analiza el nombre de archivo o contenido, detecta identificadores y aplica reglas de clasificación.
  * `uReglasArchivadoForm.pas`: Formulario de configuración de reglas dinámicas de archivado (rutas destino, patrones de nombrado y tags).
  * `uMain.pas` / `uLogForm.pas` / `uLogProcesos.pas`: Interfaz de bandeja del sistema con visualizador de eventos, documentos procesados y alertas en tiempo real.
  * `uConfigEmail.pas` / `uEmailWhatsApp.pas`: Notificación automática a clientes o departamentos tras el archivo de un documento.

### B. Versión Raúl Asencio — GestionDocRA
* **Proyecto**: [`GESTION DOCUMENTAL\RAUL_ASENCIO\GestionDocRA.dpr`](file:///c:/fuentes/proyectos%20delphi/GESTION%20DOCUMENTAL/RAUL_ASENCIO/GestionDocRA.dpr)
* **Misión**: Especialización directa para el ERP de Raúl Asencio que detecta códigos de albarán de compra escaneados por los almaceneros e inserta automáticamente el enlace al PDF en la tabla `ge_provalbaranes.documento_pdf`.