sereni-base
Plataforma backend autoalojada open-source que genera APIs REST automáticamente desde PostgreSQL, incluye autenticación JWT, almacenamiento S3/RustFS con escaneo ClamAV, envío SMTP y arquitectura de microservicios lista para producción bajo Apache 2.0.
Ficha actualizada 24 sept 2026, 8:38 · upstream 24 sept 2026, 8:04 · release v0.1.0
Qué es sereni-base
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
SereniBase es una plataforma backend completa diseñada para autoalojamiento, que unifica base de datos, APIs REST, autenticación, almacenamiento, email y seguridad en una sola infraestructura modular. Construida sobre PostgreSQL como sistema principal, genera automáticamente APIs REST documentadas con Swagger/OpenAPI para cada tabla creada, eliminando la necesidad de escribir código repetitivo para exponer endpoints.
La arquitectura se basa en microservicios desacoplados: JWT Provider para autenticación, Email Service con cola Redis y reintentos SMTP, Storage Provider (RustFS/S3) para archivos, Antivirus Service con ClamAV integrado que escanea cada subida antes del almacenamiento, y PostgreSQL como base de datos principal. También incluye MongoDB como opción adicional según el análisis técnico.
Destaca por soberanía de datos completa al permitir despliegue propio sin vendor lock-in, licenciamiento Apache 2.0 para uso comercial libre, y soporte multiinquilino con gestión dinámica de esquemas que no requiere migraciones manuales. Incluye SDK TypeScript para integración frontend y UI React para equipos técnicos.
La plataforma está orientada a producción con CI/CD en GitHub Actions, escaneo CodeQL para seguridad, calidad SonarCloud y badges de FOSSA para verificación de licencias y vulnerabilidades. Requiere Docker 20.10+ y Docker Compose 2.0+ para despliegue estándar.
- Generación automática de APIs REST a partir de esquemas PostgreSQL sin escribir código backend
- Implementación de autenticación JWT centralizada para múltiples servicios o aplicaciones cliente
- Almacenamiento seguro de archivos con escaneo antivirus ClamAV integrado antes del guardado en S3/RustFS
- Envío de notificaciones por email SMTP con cola en Redis y reintentos automáticos gestionados internamente
- Desarrollo de aplicaciones multiinquilino con gestión dinámica de esquemas sin migraciones manuales
- Integración con sistemas legacy mediante consumo directo de APIs REST documentadas en Swagger/OpenAPI
- Generación automática de APIs REST a partir de tablas PostgreSQL con documentación Swagger/OpenAPI integrada
- Arquitectura de microservicios desacoplados (JWT, Email, Storage, Antivirus) para escalabilidad y mantenimiento independiente
- Escaneo antivirus ClamAV integrado que analiza cada archivo subido antes de almacenarlo en RustFS/S3
- Soporte multiinquilino con gestión dinámica de esquemas sin necesidad de migraciones manuales
- Licencia Apache 2.0 que permite uso comercial, modificación y redistribución sin restricciones de propiedad intelectual
- Infraestructura lista para producción con CI/CD en GitHub Actions, escaneo CodeQL y calidad SonarCloud
- Estado Beta indicado en los badges del README sugiere posible inestabilidad en versiones recientes o cambios no documentados
- Dependencia de Docker y Docker Compose que limita despliegues sin contenedores o en entornos restringidos
- Configuración inicial requiere wizard interactivo o scripts que pueden ser complejos para usuarios no técnicos
- No incluye frontend completo por defecto (se menciona base-ui separado con licencia MIT, no integrado automáticamente)
- Requiere configuración manual de variables de entorno para credenciales seguras en producción sin valores por defecto
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.
Usar `make setup` o `make setup-y` para inicializar correctamente el entorno `.env`. Nunca usar credenciales por defecto en producción; configurar variables de entorno seguras. Asegurar acceso SMTP válido (Gmail, SendGrid, Mailgun) antes de iniciar servicios de email. Verificar que Docker 20.10+ y Docker Compose 2.0+ estén instalados antes del despliegue. Considerar separar volúmenes de datos para facilitar copias de seguridad independientes.
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.