keepercheky

Resumen: Actualización de Funciones Radarr

Objetivos Completados ✅

Esta implementación agrega soporte completo para funciones avanzadas de la API de Radarr v3 en KeeperCheky.

Funcionalidades Implementadas

1. Nuevas Funciones del Cliente Radarr

GetSystemInfo()

• Obtiene información completa del sistema Radarr
• Devuelve versión, OS, runtime, configuración
• Ya integrado en Settings (test de conexión)

GetQueue()

• Recupera cola de descargas activas
• Calcula progreso automáticamente
• Muestra estado, cliente, protocolo, indexer
• Integrado en Dashboard con actualización automática

GetHistory()

• Obtiene historial de eventos con paginación
• Configurable hasta 100 items por página
• Incluye tipo de evento, calidad, fechas

GetCalendar()

• Lista próximos estrenos en rango de fechas
• Configurable start/end date
• Muestra fecha de cine, física y digital
• Indica si está monitoreado y si tiene archivo

GetQualityProfiles()

• Lista perfiles de calidad configurados
• ID y nombre de cada perfil
• Útil para categorización futura

2. Endpoints API REST

Todos los endpoints implementan manejo de errores robusto:

GET /api/radarr/system          - Información del sistema
GET /api/radarr/queue           - Cola de descargas
GET /api/radarr/history         - Historial (pageSize opcional)
GET /api/radarr/calendar        - Próximos estrenos (start/end opcional)
GET /api/radarr/quality-profiles - Perfiles de calidad

3. Integración en UI

Dashboard

• Nueva sección: “Radarr Download Queue”
• Muestra items en descarga con:
  • Barra de progreso visual
  • Tamaño descargado/total
  • Estado de descarga
  • Cliente, protocolo, indexer
• Actualización automática cada 30 segundos
• Se oculta si Radarr no está configurado
• Limpieza de intervalos para prevenir memory leaks

Settings

• Ya estaba integrado GetSystemInfo
• Muestra información completa al probar conexión

Files

• Ya tiene buena integración con Radarr
• Botones de importar a Radarr
• Indicadores de gestión

4. Testing

7 tests unitarios completos:

• ✅ GetSystemInfo con datos completos
• ✅ GetQueue con múltiples items
• ✅ GetQueue con cola vacía
• ✅ GetHistory con eventos
• ✅ GetCalendar con rango de fechas
• ✅ GetQualityProfiles
• ✅ Manejo de errores (401, 500, timeout)

Todos los tests pasan exitosamente.

5. Seguridad

• ✅ CodeQL: 0 vulnerabilidades encontradas
• ✅ Retry logic con backoff exponencial
• ✅ Timeouts configurables
• ✅ Manejo robusto de errores
• ✅ Validación de entrada
• ✅ No se exponen credenciales

6. Documentación

docs/RADARR_API.md - Documentación completa:

• Descripción de cada endpoint
• Ejemplos de uso
• Formato de respuestas
• Casos de error
• Instrucciones de configuración
• Referencias a documentación oficial

Calidad del Código

Code Review

• ✅ Sin duplicación de código (formatBytes compartido)
• ✅ Manejo de memory leaks (limpieza de intervalos)
• ✅ Manejo de casos edge (NaN, división por cero)
• ✅ Código limpio y bien estructurado

Estándares

• ✅ Sigue las convenciones del proyecto
• ✅ Comentarios en español para usuarios
• ✅ Código en inglés
• ✅ Commits convencionales

Próximas Mejoras Sugeridas

1. Dashboard:
   • Agregar sección de historial reciente
   • Mostrar eventos importantes de las últimas 24h
   • Estadísticas de descargas exitosas vs. fallidas
2. Calendar:
   • Nueva página o sección para próximos estrenos
   • Filtro por monitored/no monitored
   • Indicador de días hasta estreno
3. Quality Profiles:
   • Selector en Files para cambiar perfil de calidad
   • Filtrado por perfil de calidad
   • Estadísticas por perfil
4. History:
   • Página dedicada al historial
   • Filtros por tipo de evento
   • Búsqueda por título

Archivos Modificados

internal/service/clients/radarr.go          (+360 líneas)
internal/service/clients/radarr_test.go     (+350 líneas) NEW
internal/handler/radarr.go                  (+180 líneas) NEW
internal/handler/handler.go                 (+5 líneas)
cmd/server/main.go                          (+6 líneas)
web/templates/pages/dashboard.html          (+90 líneas)
docs/RADARR_API.md                          (+280 líneas) NEW

Estadísticas

• Líneas agregadas: ~1,271
• Tests: 7 nuevos
• Endpoints: 5 nuevos
• Documentación: 1 archivo completo
• Vulnerabilidades: 0

Conclusión

✅ Todos los objetivos del issue completados exitosamente ✅ Código revisado y optimizado ✅ Tests completos y pasando ✅ Documentación exhaustiva ✅ Sin vulnerabilidades de seguridad ✅ Listo para merge

La implementación mejora significativamente la integración con Radarr, proporcionando visibilidad en tiempo real de las descargas y acceso a información del sistema que ayudará en el mantenimiento y debugging.

This site is open source. Improve this page.