feriados-dev-oss
API REST de código abierto para consultar festivos nacionales, estatales y municipales en Brasil. Arquitectura autoalojada con soporte Docker, sin límites comerciales ni claves de API, optimizada para integración con flujos de trabajo asistidos por IA.
Ficha actualizada 25 sept 2026, 10:57 · upstream 25 sept 2026, 10:45 · release sin release detectada
Qué es feriados-dev-oss
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Este repositorio ofrece una API REST completa para consultar datos de festivos en Brasil a nivel nacional, estatal y municipal. Está diseñada para ser desplegada de forma autoalojada (self-hosted), eliminando la necesidad de claves de API, facturación o límites comerciales, lo que garantiza privacidad y control total sobre los datos. La solución utiliza un stack moderno basado en Node.js con TypeScript y Express.js, almacenando información persistente en una base de datos PostgreSQL.
- Integración en aplicaciones web o móviles para mostrar calendarios de festivos locales.
- Herramientas de planificación logística que requieren conocer días no laborables en Brasil.
- Sistemas de gestión de recursos humanos para calcular vacaciones y jornada laboral.
- Dashboards de análisis de impacto económico basados en fechas clave del país.
- Automatización de notificaciones o envíos programados evitando festivos oficiales.
- Código abierto bajo licencia MIT sin restricciones comerciales ni claves de API.
- Arquitectura contenedorizada lista para despliegue con Docker y Docker Compose.
- Base de datos PostgreSQL versionada con seeds y migraciones incluidas en el repositorio.
- Optimizado para flujos de trabajo asistidos por IA con documentación específica y playbooks.
- Endpoints REST públicos sin necesidad de autenticación compleja para consultas estándar.
- Soporte para generación de calendarios iCal y cálculo de días hábiles específicos.
- Restringido exclusivamente a datos geográficos y administrativos del Brasil.
- Requiere despliegue propio (self-hosted) sin soporte de infraestructura gestionada por el proveedor.
- Dependencia de una base de datos externa (PostgreSQL) para persistencia de datos.
- No incluye funcionalidades de autenticación ni gestión de usuarios en la capa API pública.
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.
Recomendado usar Docker Compose para levantar PostgreSQL y la API simultáneamente. Copiar .env.example antes de iniciar. Validar instalación con npm run smoke o curl al endpoint /health. Asegurar que el puerto 3000 esté disponible en el firewall. Para producción, considerar variables de entorno seguras fuera del código fuente.
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.