ninerlog-api
API RESTful en Go para NinerLog, libro de vuelo digital EASA/FAA. Gestiona licencias, aviones, vuelos y exportación PDF. Usa PostgreSQL, JWT, TOTP 2FA y OpenAPI-first. Autoalojable con Docker Compose.
Ficha actualizada 24 sept 2026, 9:08 · upstream 24 sept 2026, 9:01 · release v1.3.7
Qué es ninerlog-api
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
NinerLog API es el backend RESTful en Go (Gin) para NinerLog, un libro de vuelo digital gratuito y de código abierto que cumple con las normativas EASA y FAA. Proporciona la lógica de negocio para gestionar licencias, calificaciones de aeronaves, registros de vuelos y cálculos de tiempo de vuelo, incluyendo evaluaciones de recurrencia de moneda (currency evaluation) según regulaciones aéreas.
La arquitectura utiliza una base de datos PostgreSQL persistente, autenticación segura con JWT y TOTP 2FA, y soporte para exportación a PDF mediante librerías nativas. Incluye un sistema de migraciones SQL robusto y generación automática de tipos desde la especificación OpenAPI. El proyecto está diseñado para ser autoalojado, ofreciendo documentación completa sobre arquitectura, modelo de datos y guías de desarrollo en su repositorio.
Soporta integración con proveedores externos de identidad (OIDC) para autenticación centralizada y cuenta con herramientas completas para pruebas unitarias, de integración y end-to-end. La gestión de archivos se realiza mediante servicios compatibles con S3/MinIO, permitiendo el almacenamiento escalable de documentos y reportes generados.
- Gestión integral del libro de vuelo digital (vuelos, aviones, tripulación).
- Cumplimiento normativo EASA y FAA (licencias, ratings, currency evaluation).
- Exportación de registros a PDF para auditoría o presentación.
- Autenticación segura con JWT, TOTP 2FA y soporte OIDC.
- Importación de datos desde archivos CSV para migraciones.
- Búsqueda y gestión de aeropuertos (OurAirports).
- Cumplimiento regulatorio EASA/FAA integrado en la lógica de negocio.
- Arquitectura OpenAPI-first con generación automática de código.
- Seguridad robusta con JWT, TOTP 2FA y WebAuthn.
- Exportación nativa a PDF para logbooks impresos o digitales.
- Base de datos PostgreSQL con soporte para migraciones SQL.
- Autoalojable con Docker Compose y configuración flexible.
- Requiere infraestructura propia (Docker/PostgreSQL) sin versión SaaS gratuita.
- Migraciones de base de datos requieren intervención manual o scripts específicos.
- Dependencia de servicios externos para almacenamiento de archivos (S3/MinIO).
- Configuración inicial compleja para entornos de producción (variables de entorno).
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 recomendado con Docker Compose (`docker compose up -d`). Asegurar migraciones SQL antes de iniciar la API. Configurar variables de entorno para PostgreSQL, JWT y CORS. Para SSO, habilitar OIDC siguiendo la documentación. Escalar recursos según carga (CPU/RAM recomendados: 2 núcleos/2GB RAM).
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.