Módulo FileMailer-FM #
Lleva cada mensaje a FileMaker — automáticamente, con seguridad y en tiempo real.
Un servicio Spring Boot que mantiene los buzones IMAP permanentemente sincronizados con una base de datos FileMaker, archiva los adjuntos y expone una API REST limpia para leer, redactar y enviar correo — convirtiendo cualquier solución FileMaker en un back-office completo de correo electrónico.
Visión general #
FileMailer-FM conecta servidores IMAP/SMTP estándar con una base de datos FileMaker. Los correos, las carpetas y los adjuntos entran automáticamente en FileMaker; el correo saliente, los borradores y las respuestas vuelven a salir por SMTP — todo gestionado mediante una API REST documentada.
Está pensado para organizaciones que necesitan centralizar la gestión del correo, crear archivos buscables dentro de FileMaker y automatizar flujos de trabajo basados en email sin tener que programar la capa IMAP por su cuenta.
Características principales #
Sincronización IMAP #
- Sincronización incremental basada en UID — sólo se descargan los mensajes nuevos en cada ciclo
- Notificaciones push IMAP IDLE para entrega en tiempo real (por cuenta, con detección de capacidades del servidor)
- Reconciliación programada como red de seguridad frente a actualizaciones perdidas
- Soporte multi-carpeta con detección automática, exclusiones configurables (Papelera, Spam, Junk…) y restauración automática de carpetas que reaparecen en el servidor
Gestión y archivado de adjuntos #
- Extracción automática de adjuntos durante la sincronización
- Almacenamiento híbrido: árbol en el sistema de ficheros y campos contenedor de FileMaker
- Límites de tamaño configurables y estructura de directorios anidada
- Acceso HTTP a los ficheros almacenados mediante el endpoint
/mailbox/{cuenta}/{carpeta}/{email}/{fichero}
Correo saliente #
- Creación y edición de borradores con redacción completa de mensajes
- Posibilidad de añadir adjuntos a los borradores antes del envío
- Envío, reenvío y forwarding de mensajes por SMTP (SSL 465 / STARTTLS 587)
- Varias configuraciones SMTP por cuenta
Gestión multi-cuenta #
- Cuentas de correo ilimitadas gestionadas en paralelo
- Configuración IMAP y SMTP independiente por cuenta
- Borrado lógico con retención configurable — los correos nunca se destruyen en silencio
Seguridad #
- Credenciales IMAP y SMTP cifradas con AES-256-GCM antes de almacenarse
- Autenticación HTTP Basic en todos los endpoints de la API (Spring Security)
- Escrituras transaccionales para garantizar la integridad de los datos
Integración #
- API REST JSON con documentación completa Swagger / OpenAPI
- Interfaz RapiDoc junto a Swagger UI
- Configuración externa tipada (no requiere recompilar el JAR)
Casos de uso #
- Archivado de correo y cumplimiento — cada mensaje entrante conservado en FileMaker
- Historial de comunicación con clientes — vincula los correos a las fichas de cliente en FileMaker
- Automatización de flujos — dispara scripts de FileMaker a partir de mensajes entrantes
- Operativa multi-buzón — unifica direcciones corporativas, de soporte y de ventas
- Procesado de adjuntos — extracción y almacenamiento automáticos de documentos
Especificaciones técnicas #
Stack #
- Java 17+
- Spring Boot 3.4.x
- Jakarta Mail (Eclipse Angus) para IMAP / SMTP
- FileMaker por JDBC con un dialecto Hibernate propio
- Spring Security, Spring Data JPA
Requisitos #
- FileMaker Server con acceso JDBC
- Runtime Java 17~21
- Acceso de red a los servidores IMAP y SMTP
- 512 MB de RAM mínimo (1 GB+ recomendado)
Despliegue #
Se distribuye como un JAR ejecutable de Spring Boot con config/application.properties externo. Se incluye un despliegue macOS launchd (plist) para ejecutarlo como servicio en segundo plano.