Mòdul FileMailer-Web #
FileMailer-Web — l’experiència de correu que la teva solució FileMaker estava esperant. Nativa on importa, estàndard web on compta.

Un client web modern en React i TypeScript per al backend FileMailer-PG. FileMailer-Web està dissenyat específicament per executar-se dins d’un Visualitzador Web de FileMaker, oferint una integració de correu fluida i potent per a qualsevol CRM, ERP o solució FileMaker existent — i funcionant perfectament també com a aplicació de navegador independent.
Visió General #
FileMailer-Web és el company frontend de FileMailer-PG. Mentre FileMailer-PG gestiona la sincronització IMAP/SMTP, les metadades a PostgreSQL i l’emmagatzematge adreçable per contingut a Minio, FileMailer-Web ofereix una interfície neta i responsiva per navegar, cercar, llegir, redactar, respondre i organitzar el correu — tot a través d’APIs REST.
El que el fa únic és la profunda integració amb FileMaker per disseny. Un sistema integrat de capçaleres de correu vincula cada email a qualsevol objecte FileMaker que necessitis — clients, proveïdors, operacions, articles, factures, tiquets, altres correus — mitjançant capçaleres de metadades i enllaços per API REST. No cal inflar els teus arxius FileMaker amb còpies del contingut del correu: la còpia autoritativa viu a FileMailer-PG, FileMaker només guarda les referències.
Característiques Principals #
Disseny Orientat al Visualitzador Web de FileMaker #
- Construït per incrustar-se en un Visualitzador Web de FileMaker amb integració bidireccional fluida
- Contracte d’arrencada net: l’API key i el context es lliuren des de FileMaker
- Dissenys responsius i compactes que es veuen natius dins d’una presentació FileMaker
- Funciona igualment bé com a aplicació web de navegador independent
Sistema Integrat de Capçaleres de Correu #
- Cada email porta capçaleres personalitzades estructurades que el vinculen a objectes FileMaker
- Vincula missatges a clients, proveïdors, operacions, articles, correus — o a qualsevol entitat que la teva solució necessiti
- Enllaç només per metadades: els arxius FileMaker es mantenen lleugers, el contingut del correu viu a FileMailer-PG
- Patrons de capçaleres personalitzables per compte i per flux de treball
Gestió Moderna de Correu #
- Scroll virtual per a bústies amb desenes de milers de missatges
- Gestió multi-compte IMAP/SMTP amb ordenació alfabètica de comptes
- Renderitzat enriquit de correu HTML amb sanitització (DOMPurify)
- Compositor complet amb editor rich-text Quill
- Respondre, respondre a tothom, reenviar, esborranys amb autoguardat
- Pujada, previsualització i descàrrega d’adjunts mitjançant emmagatzematge CAS
Actualitzacions en Temps Real #
- Estat de sincronització en viu impulsat per les notificacions IMAP IDLE del backend
- Indicadors de sincronització a nivell de compte i de carpeta
- Refresc en línia sense recarregar l’aplicació
Canalització de Contingut Preparada per IA #
- El backend company FileMailer-PG incrusta i indexa cossos i adjunts de correu per a immersió en IA
- FileMailer-Web exposa aquest contingut indexat a l’usuari i ofereix punts d’enllaç per a cerca i recuperació amb IA
- El teu CRM/ERP guanya context de correu potenciat per IA sense sortir de FileMaker
Stack de Nivell Professional #
- React 19 amb hooks i funcionalitats concurrents
- TypeScript d’extrem a extrem — tipus compartits amb l’esquema OpenAPI de FileMailer-PG
- Vite per a servidor de desenvolupament instantani i builds de producció ràpids
- Tailwind CSS utility-first
- shadcn/ui biblioteca de components accessibles
- Icones Lucide
- Axios amb interceptors per a autenticació per API key, gestió d’errors i logging
Temes i UX #
- Mode clar i fosc integrats
- Disseny responsiu — escriptori, tauleta i mòbil
- Optimitzat per incrustar-se en viewports restringits (Visualitzador Web de FileMaker)
Arquitectura #
Solució FileMaker
└── Visualitzador Web
└── FileMailer-Web (React SPA)
└── API REST (X-API-Key)
└── FileMailer-PG (Spring Boot)
├── PostgreSQL (metadades, cerca de text complet)
└── Minio / S3 (emmagatzematge CAS, deduplicació SHA-256)
- Stateless — sense backend propi; tot l’estat viu a FileMailer-PG
- Desplegable a qualsevol lloc — carpeta estàtica
dist/a Vercel, Netlify, GitHub Pages, S3+CloudFront, nginx o servida directament per FileMaker Server - Autenticació per API key — sense sessions, sense cookies, compatible amb el Visualitzador Web
Integració amb FileMaker #
- Configura l’URL base de l’API de FileMailer-PG i l’API key al primer arrencat (o injecta-les des de FileMaker en carregar el Visualitzador Web)
- Utilitza scripts FileMaker per obrir el visualitzador web en un compte, carpeta o context de cerca concrets
- Utilitza el sistema de capçaleres de correu per navegar des d’un registre FileMaker (un client, una comanda, un tiquet) directament al fil de correu relacionat
- Redacta missatges nous precarregats amb capçaleres que enllacen al registre FileMaker origen
Casos d’Ús #
- Integració de correu en CRM — adjunta l’històric de comunicació directament a les fitxes de client
- Seguiment d’operacions en ERP — vincula la correspondència amb proveïdors a comandes i operacions
- Ticketing i helpdesk — enllaça missatges entrants a tiquets, casos o incidències
- Fluxos documentals — els adjunts passen pel motor de deduplicació i queden enllaçats a l’objecte de negoci origen
- Bústies potenciades per IA — cerca semàntica, resum i recuperació sobre tot el teu corpus de correu
Especificacions Tècniques #
Stack #
- React 19 + TypeScript
- Vite 7
- Tailwind CSS 3 + shadcn/ui
- Primitius Radix UI
- Editor rich-text Quill
- Client HTTP Axios
- React Router v7
Requisits #
- Node.js 18+ per a desenvolupament
- Un backend FileMailer-PG en execució
- Una API key vàlida de FileMailer-PG
- Qualsevol navegador modern o un Visualitzador Web de FileMaker (recomanat FileMaker Pro 19+)
Desplegament #
npm install
npm run build
Desplega la carpeta dist/ generada a qualsevol proveïdor d’allotjament estàtic o serveix-la directament des de la capa de publicació web de FileMaker Server. Un únic artefacte de build serveix tant per a ús en navegador estàndard com per a incrustat en Visualitzador Web.