Sprint 0 · Hito 1 · 13 Mayo 2026

Scrum + DevOps
aplicado a Koel

Implementación de un proceso ágil completo sobre Koel, un servidor de streaming musical open source con licencia MIT. Pipeline CI/CD automatizado, sprints reales y despliegue en GitHub Pages.

Repositorio del Proyecto Tablero Kanban Ver documentación
120K+
Líneas de código
5
Subsistemas
4
Sprints
MIT
Licencia
ips-2026-koel · sprint-0
# Sprint 0 — Análisis y configuración inicial
 
$ git clone github.com/koel/koel
  Cloning into 'koel'...
  ✓ Done — 120,465 LOC detected
 
$ cloc --include-lang=PHP,Vue,TS .
  PHP: 1079 files · 41,670 loc
  TypeScript: 538 files · 27,565 loc
  Vue: 307 files · 18,574 loc
  ✓ SUM: 2376 files · 120,465 lines
 
$ cat LICENSE | head -1
  ✓ MIT License — Free to use
 
$ docker compose up -d
  ✓ koel-db Up (mysql:8)
  ✓ koel-app Up (port 80)
 
$ gh project list
  ✓ Sprint 0 board — 12 issues
 
$ ▶ gh workflow run deploy.yml
Autores

Equipo de Trabajo

Estudiantes de Ingeniería de Sistemas e Informática — UNSA 2026-A · Ingeniería y Procesos de Software.

RC
Romina Giuliana
Camargo Hilachoque
Integrante 1
Scrum Member
JH
José León Enrique
Hatches Curo
Integrante 2
Scrum Member
PM
Paola Adamari
Mayta Quispe
Integrante 3
Scrum Member
KC
Keneth Sebastian
Cutimbo Quispe
Integrante 4
Scrum Member
JM
Jose Manuel
Morocco Saico
Integrante 5
Scrum Member
Proyecto

¿Por qué Koel?

Seleccionamos Koel como base del proyecto por cumplir todos los criterios técnicos y académicos: licencia MIT, stack moderno, complejidad real y soporte Docker nativo.

Objetivo Académico

Implementar un proceso de desarrollo de software que integre la metodología ágil Scrum con prácticas DevOps automatizadas, aplicado sobre Koel, un proyecto open source con licencia MIT.

El equipo analizará el estado actual del proyecto, identificará funcionalidades y arquitectura, definirá un alcance de mejora y aplicará un modelo de proceso que integre Scrum con CI/CD automatizado.

Curso
Ingeniería y Procesos de Software · UNSA 2026-A

koel/koel · Ficha técnica
projectKoel Music Server
licenseMIT ✓
domainPersonal Media Server
backendLaravel (PHP 8)
frontendVue.js 3 + Vite
loc120,465 líneas
modules5 subsistemas
infraDocker Compose ✓
repogithub.com/koel/koel
Licencia MIT verificada
Permite fork, modificación y uso libre sin restricciones académicas. Verificado en el repositorio oficial de GitHub.
Dominio conocido
Personal Media Server y gestión de bibliotecas musicales. Subcategoría de Media Asset Management con APIs bien documentadas.
Stack moderno
Laravel + Vue.js 3 + TypeScript + Docker. Tecnologías open source vigentes y ampliamente usadas en la industria actual.
Alta complejidad
5 subsistemas identificados y más de 120,000 líneas de código fuente medidas con la herramienta cloc.
Infraestructura DevOps
Repositorio oficial koel/docker con Docker Compose para levantar la app con MySQL, MariaDB o PostgreSQL.
APIs externas
Integración con Last.fm, YouTube, Spotify e iTunes para enriquecer metadatos y mejorar la experiencia del usuario.
Tecnologías

Stack Tecnológico

Koel utiliza tecnologías modernas y open source estándar en la industria. El stack integra backend robusto, frontend reactivo e infraestructura DevOps completa.

Backend
Laravel PHP Framework
PHP 8.x Servidor
Composer Dependencias
REST API Protocolo
Queue Workers Async jobs
Frontend
Vue.js 3 Framework JS
TypeScript Tipado estático
Vite Build tool
Node.js Runtime
Pinia State management
Base de datos
MySQL 8 Principal
MariaDB Alternativa PostgreSQL Alternativa SQLite Desarrollo
DevOps & CI/CD
Docker Contenedores GitHub Actions CI/CD GitHub Pages Despliegue GitHub Issues Backlog
GitHub Projects Kanban/Scrum
Arquitectura

Arquitectura del Sistema

Koel sigue una arquitectura cliente-servidor con separación clara de capas: frontend SPA, backend Laravel API, capa de datos y APIs externas de enriquecimiento.

koel · component-diagram
Frontend (Vue.js) Enrutador Vue Componentes Vue Gestión de Estado Servicios de Cliente Llamadas a la API Backend (Laravel) Controladores Servicios Repositorios Adaptadores de Almacenamiento APIs Externas Last.fm / YouTube / Spotify / iTunes Base de Datos Modelos MySQL / SQLite / PostgreSQL Archivos Multimedia Archivos de Audio
Frontend — Vue.js SPA

Aplicación de página única con componentes como App.vue, MainWrapper, AudioPlayer y AppFooter. Gestión de estado con stores de Pinia: songStore, albumStore, artistStore, queueStore.

Vue.js 3 Pinia TypeScript Vite AudioPlayer
Backend — Laravel REST API

Gestiona lógica de negocio, autenticación, rutas API y procesamiento de metadatos. Expone endpoints para canciones, álbumes y artistas. Queue workers para tareas asíncronas.

Laravel 10 PHP 8 Auth service Media Scanner Queue
Datos y Almacenamiento

Archivos multimedia en local o Dropbox. La BD almacena usuarios, canciones, artistas, álbumes, playlists y favoritos. Compatible con MySQL, MariaDB, PostgreSQL y SQLite.

MySQL 8 MariaDB PostgreSQL SQLite Dropbox
cloc · koel/koel · v1.98
Languagefilesblankcommentcode
PHP10799746442441670
TypeScript538644053927565
Vuejs Component307344620618574
JavaScript23236710513293
YAML12166517962
JSON40307060
Markdown4193952421
SVG363741226
XML363247
Blade9280148
HTML17074106136
CSS720072
Bourne Shell310341
TOML15240
INI21010
SUM:2376234009398120465
GitHub Projects

Tablero Scrum · Sprint 0

Sprint 0 gestionado en GitHub Projects con tablero Kanban. 12 historias de usuario distribuidas en cinco columnas de estado.

Backlog 2/5
IPS-2026-koel #5
HU09 - Crear Product Backlog inicial
IPS-2026-koel #6
HU10 - Crear página informativa en GitHub Pages
Ready 2
IPS-2026-koel #7
HU08 - Elaborar cronograma general de sprints
IPS-2026-koel #8
HU12 - Revisar evidencias y capturas del Sprint 0
In progress 4/3
IPS-2026-koel #12
HU11 - Redactar informe del Hito 1
IPS-2026-koel #11
HU07 - Revisar infraestructura Docker del proyecto
IPS-2026-koel #9
HU04 - Analizar el stack tecnológico de Koel
IPS-2026-koel #10
HU05 - Identificar módulos o subsistemas principales
In review 1/5
IPS-2026-koel #13
HU03 - Identificar el dominio del sistema
Done 3
IPS-2026-koel #15
HU02 - Verificar licencia MIT del repositorio
IPS-2026-koel #16
HU06 - Medir complejidad del proyecto con CLOC
IPS-2026-koel #14
HU01 - Seleccionar el producto open source Koel
Ver tablero completo en GitHub Projects →
Metodología

Scrum + DevOps

Integramos el marco ágil Scrum con automatización DevOps usando las herramientas nativas de GitHub para un flujo de trabajo moderno y trazable.

Herramientas del Proyecto

GitHub Projects

Tablero Kanban para gestionar Product Backlog, armar Sprints, asignar historias de usuario y ver el progreso en tiempo real.

GitHub Actions

Automatización CI/CD. Compila código, corre pruebas, detecta errores y despliega a staging de forma automática en cada push.

GitHub Pages

Publica el entorno de staging, documentación técnica y el burndown chart generado automáticamente por GitHub Actions.

GitHub Issues

Sistema de tickets para registrar historias de usuario del Product Backlog, reportar bugs y documentar decisiones técnicas.

Pipeline CI/CD
✓
Push to GitHubdone
El equipo sube cambios al repositorio usando ramas por feature o sprint.
✓
Actions Triggerdone
Workflow en .github/workflows/ activado automáticamente.
▶
Build & Testen curso
Instalación de dependencias, compilación con Vite y ejecución de pruebas unitarias PHP.
○
Deploy Stagingsprint 1
Despliegue automático a GitHub Pages o entorno Docker para revisión del equipo.
○
Sprint Reviewsprint 1
Revisión de resultados, burndown chart y planificación del siguiente sprint.
Planificación

Cronograma de Sprints

Cuatro sprints de 15 días calendario cada uno, con tres hitos de entrega evaluados a lo largo del semestre 2026-A.

Hasta
13 MAY
2026
Sprint 0 — Análisis y Planificación Hito 1 · 15%
Selección y análisis del software Koel, configuración de herramientas GitHub, cronograma general y publicación en GitHub Pages.
✓ Software seleccionado ✓ Licencia MIT verificada ✓ Stack analizado ✓ GitHub Projects ✓ 12 Issues creados ✓ GitHub Pages
14–29
MAY
2026
Sprint 1 — Configuración e Integración
Configuración del entorno Docker, GitHub Actions inicial, pruebas básicas funcionales y CI/CD operativo.
Docker Compose GitHub Actions workflow Pruebas de instalación CI/CD inicial
30 MAY–
10 JUN
2026
Sprint 2 — Producto Funcional Hito 2 · 60%
Producto funcionando con integración CI/CD completa, implementación del marco Scrum con todos sus artefactos.
Koel desplegado Pipeline completo Pruebas funcionales Burndown chart
JUN
2026
Sprint 3 — Mejoras y Automatización
Mejoras al producto, automatización avanzada del pipeline CI/CD y documentación técnica del proceso completo.
Refactorización Deploy automatizado Documentación técnica
Hasta
13 JUL
2026
Sprint 4 — Documentación y Entrega Final Hito 3 · 100%
Documentación técnica completa del proceso ágil Scrum + DevOps, artículo formato IEEE y presentación final del proyecto.
Artículo IEEE Informe completo Presentación final GitHub Pages final
Resultados

Sprint 0 — Entregables

Resultados obtenidos tras la ejecución del Sprint 0, enfocados en el establecimiento de la infraestructura de gestión ágil y el análisis técnico del proyecto.

GitHub Projects · Product Backlog
12 HU
Tablero Kanban implementado con GitHub Projects. Todas las historias de usuario del Sprint 0 registradas como Issues con etiquetas, hitos y asignación de responsables.
Complejidad del proyecto
120K
Líneas de código medidas con cloc sobre el repositorio principal.
GitHub Pages
Live ✓
Página del proyecto desplegada y accesible públicamente desde GitHub Pages.
Docker Infrastructure
Ready ✓
Infraestructura Docker identificada. koel/docker con soporte MySQL y PostgreSQL.
Subsistemas identificados
5
Diagrama de componentes elaborado con 5 capas bien definidas.
Issues registrados
12
Todas las HU registradas con etiquetas y responsables asignados.
Código
Historia de Usuario
Responsable
HU01
Seleccionar el producto open source Koel
Equipo
HU02
Verificar licencia MIT del repositorio
Integrante 1
HU03
Identificar el dominio del sistema
Integrante 2
HU04
Analizar el stack tecnológico de Koel
Integrante 3
HU05
Identificar módulos o subsistemas principales
Integrante 4
HU06
Medir complejidad del proyecto con CLOC
Integrante 5
HU07
Revisar infraestructura Docker del proyecto
Integrante 1
HU08
Elaborar cronograma general de sprints
Integrante 2
HU09
Crear Product Backlog inicial
Equipo
HU10
Crear página informativa en GitHub Pages
Equipo
HU11
Redactar informe del Hito 1
Equipo
HU12
Revisar evidencias y capturas del Sprint 0
Equipo
Referencias

Enlaces del Proyecto

Repositorio del Proyecto
Código fuente del proyecto académico IPS-2026-koel con GitHub Actions y Pages configurados.
JoseMorocco/IPS-2026-koel →
Repositorio Koel
Código fuente original de Koel Music Server con licencia MIT.
koel/koel →
GitHub Projects
Tablero Scrum/Kanban del equipo con Sprint Backlog y estado de cada HU.
Tablero Sprint 0 →
Docker Image
Imagen oficial Docker con Compose para desplegar Koel con MySQL o PostgreSQL.
koel/docker →