> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lerian.studio/llms.txt
> Use this file to discover all available pages before exploring further.
# Mapa de conceptos
> Comprende cómo se relacionan las Plantillas, los Informes, las fuentes de datos y las descargas en Reporter antes de usar el módulo en la Lerian Console para la generación de informes regulatorios.
El módulo Reporter usa un pequeño conjunto de objetos centrales. Se conectan entre sí, pero el operador no siempre empieza creando una fuente de datos. En algunos entornos, las fuentes de datos internas para productos Lerian como Midaz o CRM ya están configuradas.
## Flujo principal
***
Reporter tiene dos rutas de entrada comunes:
* **Datos de producto interno ya configurados:** `Template → Report → Download`
* **Conexión de datos externa o ausente:** `Data Source → Template → Report → Download`
* La **Plantilla** indica *cómo debe verse el informe y en qué formato*.
* La **fuente de datos** indica *de dónde provienen los datos*. Puede ya existir para productos internos. Para bases de datos externas, la agregas manualmente.
* El **Informe** es el archivo que Reporter produce cuando ejecuta una Plantilla contra los datos conectados. Los filtros pueden acotar el resultado.
* La **descarga** es la acción del operador que saca el archivo terminado de la Console.
### Qué significa cada objeto
| Objeto | Qué representa | Por qué existe antes o después |
| ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `Data Source` | Una conexión de datos configurada. Puede ser una conexión de producto interno ya creada para el entorno, o una conexión de base de datos externa como PostgreSQL o MongoDB. | Existe antes de la generación, pero el operador solo necesita crear una manualmente cuando la conexión necesaria no está ya configurada. |
| `Template` | Una definición reutilizable de estructura y formato de salida (CSV, XML, HTML, TXT o PDF), subida como archivo `.tpl` o construida de forma visual con Template Builder. | Describe *cómo* debe verse el informe. No ejecuta nada por sí sola. |
| `Filter` | Una regla opcional aplicada en el momento de la generación (Database + Table + Field + Operator + Value). | Acota los datos usados en una sola ejecución de Informe, sin cambiar la Plantilla. |
| `Report` | La salida producida cuando se ejecuta una Plantilla contra los datos. Tiene un estado (`Processing`, `Finished`, `Partial`, `Error`). | Es el artefacto real que entrega el operador. |
| `Preview` | La vista dentro de la Console de un informe `Finished`, adaptada a su formato de salida. | Permite al operador validar el resultado antes de enviarlo. |
| `Download` | La acción que saca el archivo del informe terminado de la Console en su formato configurado. | Es el punto final operativo de todo el flujo. |
| `Reminder` | Un plazo de entrega opcional rastreado desde la página Overview (Once, Daily, Weekly, Monthly, Semiannual, Annual). | Se usa cuando un Informe tiene una cadencia de entrega recurrente que hay que gestionar operativamente. |
## Cuándo una Plantilla se convierte en un Informe
***
Una Plantilla por sí sola es solo una definición. Se convierte en un Informe cuando haces clic en **Generate Report** en el asistente de 4 pasos de la página **Reports**.
En ese momento:
1. Reporter toma la Plantilla seleccionada.
2. Aplica los filtros que configuraste.
3. Lee desde las fuentes de datos referenciadas por la Plantilla.
4. Produce un archivo en el formato de salida de la Plantilla y lo agrega a la lista de Reports con estado `Processing`.
5. Cuando la generación termina, el estado pasa a `Finished` y el archivo se vuelve descargable.
## Qué campos realmente importan
***
Cuando los operadores se atascan, suele ser por el mismo puñado de campos.
### Al revisar o agregar una fuente de datos
* **Connection Name**: Cómo aparece la conexión en el resto de lugares (en plantillas, en filtros de informes). Para fuentes de datos externas, elige algo que identifique el entorno, no solo el motor (por ejemplo, `production-db`, no solo `postgres`).
* **Database Type**: Selecciona PostgreSQL o MongoDB. Determina el puerto predeterminado y el controlador de conexión.
* **Host / Port / Database Name / Username / Password**: Lo mínimo necesario para alcanzar la base de datos.
* **Schemas** (PostgreSQL): Limita a qué esquemas puede acceder Reporter. Déjalo vacío para usar el valor predeterminado (`public`).
* **SSL Configuration**: Opcional, pero úsala siempre que no confíes completamente en la ruta de red.
### Al agregar una plantilla
* **Archivo `.tpl`** (modo de carga): La definición real de la plantilla. Obligatorio.
* **Template Name**: Cómo aparece la Plantilla en las listas y los selectores.
* **Output Format**: Fija el tipo de archivo final (CSV, XML, HTML, TXT o PDF). Cuando seleccionas PDF en Template Builder, el código generado es HTML, renderizado como PDF en el momento de la generación.
### Al generar un informe
* **Template**: La Plantilla que quieres ejecutar.
* **Filters** (opcional): Cada fila es `Database + Table + Field + Operator + Value(s)`. Usa los filtros para producir un subconjunto más acotado sin editar la Plantilla.
## Lectura práctica de la UI
***
Usa esta interpretación cuando guíes a los usuarios:
* `Templates` define *cómo debe verse la salida*.
* `Reports` es donde la estructura y los datos se combinan y producen un archivo.
* `Data Sources` define *qué puede leer Reporter*. Úsala para inspeccionar conexiones existentes, probar la conectividad o agregar bases de datos externas.
* `Overview` es el panel operativo: KPI, el calendario de entregas y los recordatorios de entregas próximas o vencidas.
## Cuándo suelen perderse los usuarios
***
Una Plantilla es una definición. Un Informe es un archivo generado. Puedes generar muchos Informes a partir de la misma Plantilla a lo largo del tiempo (cada uno con sus propios filtros, fecha de ejecución y estado).
La fuente de datos es la conexión que usa Reporter para leer datos. Un Filtro es una restricción por ejecución que no cambia la Plantilla ni la fuente de datos, solo los datos que incluye el Informe actual.
Template Builder genera código `.tpl` a partir de los bloques que ensamblas en la Console. Subir un `.tpl` omite el constructor y usa un archivo preparado externamente. Ambos terminan siendo el mismo tipo de Plantilla, pero solo las plantillas creadas con el constructor pueden volver a editarse en el editor visual.
Cuando un Informe llega a `Finished`, Reporter ya produjo el archivo y puedes descargarlo. Los recordatorios de la página Overview rastrean la entrega por separado, como enviar el archivo a un regulador o archivarlo.
Combina esta página con [Ruta de configuración](/es/products/reporter/console/reporter-setup-path) al incorporar nuevos usuarios. Una página explica el modelo. La otra explica el orden.