emailService
Plataforma auto-alojada de Homix Realty para campañas de correo inmobiliario con integración OneKey/BBO, React/Node.js y PostgreSQL. Incluye roles web/worker/migrate, RBAC, controles de seguridad avanzados y despliegue en Azure.
Ficha actualizada 22 sept 2026, 18:08 · upstream 22 sept 2026, 16:16 · release sin release detectada
Qué es emailService
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
emailService es una solución auto-alojada diseñada específicamente para el marketing inmobiliario de Homix Realty. Integra capacidades de análisis de mercado mediante OneKey/BBO, permitiendo búsqueda por MLS o dirección, importación automática de propiedades y gestión de agentes locales. El sistema gestiona contactos, listas, campañas y reportes en un flujo auditado con PostgreSQL como base de datos principal.
La arquitectura separa responsabilidades en tres roles (web, worker, migrate) que comparten el mismo Dockerfile pero ejecutan funciones distintas: la capa web maneja la SPA React con API Express v2, el worker procesa jobs y webhooks, y el migrate gestiona migraciones de base de datos. Soporta integración con Resend para envío de correos y Azure para despliegue en la nube con Container Apps, Blob Storage y Key Vault.
El sistema implementa controles de seguridad robustos incluyendo RBAC (ADMIN/MARKETER/VIEWER), CSRF protection, rate limiting, validación de firmas para webhooks y gestión de unsubscribe visible/RFC 8058. Incluye herramientas de análisis de código, tests unitarios/integración/E2E y documentación completa para operaciones y despliegue.
- Crear campañas de correo inmobiliario con propiedades importadas desde OneKey/BBO
- Gestionar listas de contactos y segmentos personalizados con supresión automática
- Analizar mercado local mediante búsqueda por MLS o dirección con datos de agentes
- Desplegar plataforma auto-alojada en Azure con CI/CD automatizado
- Arquitectura modular con roles web/worker/migrate compartiendo Dockerfile
- Integración OneKey/BBO para búsqueda MLS, datos de agentes y propiedades
- Controles de seguridad avanzados: RBAC, CSRF, rate limiting, validación de firmas
- Gestión de unsubscribe visible/RFC 8058 con rotación de secretos
- Tests unitarios/integración/E2E con cobertura >80% en servicios clave
- Dependencia de servicios externos: BBO para datos inmobiliarios, Resend para envío
- Requiere infraestructura Azure para despliegue completo (Container Apps, Blob, Key Vault)
- Necesita Node.js 22 y Docker/Docker Compose para desarrollo local
- Webhooks requieren configuración de retry manual para dead letters inciertos
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue inicial con scripts/provision-azure.sh (bootstrap, ACR build, recursos). Release posterior: scripts/deploy-release.sh (Migration → Web readiness → Worker). GitHub Actions usa Azure OIDC sin secretos persistentes. Producción requiere EMAIL_DELIVERY_MODE=disabled hasta configurar Entra/Resend/DNS/correo válido.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.