Juego de estudio de voicings de guitarra y rutas II-V-I para móvil y ordenador.
La versión móvil está publicada como PWA instalable en Drop Route. Se abre y se instala desde el navegador, siguiendo el manual de instalación.
No hay un APK ni un AAB de Android generado o subido al repositorio, ni un paquete móvil descargable en Releases. El código, el manifest, los iconos y el service worker de la PWA sí forman parte del proyecto.
- Instrucciones de desarrollo en CLAUDE.md y AGENTS.md.
- Requisitos, apariencia, contrato musical y decisiones.
- Plantilla HTML y dos guías PDF originales en references.
- 112 posiciones evaluables, 12 disminuidas de referencia y 16 rutas completas.
- Aplicación React, TypeScript y Vite en
src/, separada en datos, música, sesión, progreso e interfaz. - Reconocimiento de voicings en fácil, medio y difícil, y rutas II-V-I de Drop 2.
- Modo estudio sin examen para consultar voicings y rutas, transponerlos a las 12 tonalidades y ver la conducción de voces.
- Variante C6 de la fuente reproducida en estudio, revisión y preguntas de reconocimiento sobre copias derivadas: sexta activa y séptima gris de referencia al revelar la solución.
- Diseño responsive: flujo compacto en móvil y distribución horizontal en escritorio para menú, juego, rutas y estudio.
- Progreso local por dispositivo y PWA con actualización controlada y recarga sin conexión.
- Pruebas con node:test, Vitest y Playwright.
- DTS principal, PDF y LaTeX.
- Manual de uso y manual de instalación, con sus PDF en
docs/latex/. - Plan de pruebas, órdenes de trabajo y registros de validación.
Requisitos para desarrollar o probar el proyecto:
- Node.js 22.13 o superior;
.nvmrcpropone Node 24. - Git.
- Python 3.10 o superior para
data:checky la generación documental. - Chromium de Playwright para E2E y capturas:
npx playwright install chromium. - Pandoc y LuaLaTeX completo o XeLaTeX para regenerar DTS y manuales.
npm ci --ignore-scripts
npm run validateClonar el repositorio:
git clone https://github.com/a01653/Drop_Route.git
cd Drop_Routenpm run dev # servidor de desarrollo de Vite
npm run build # typecheck y build en dist/
npm run preview # sirve el build existente
npm run typecheck
npm run lint
npm test # node:test + Vitest
npm run test:unit
npm run test:base
npm run test:e2e # Playwright sobre un build nuevo
npm run icon:export
npm run audit:music
npm run data:check
npm run docs:build # DTS y manuales en LaTeX/PDF
npm run docs:check
npm run docs:check:finalnpm run build genera también dist/sw.js y empaqueta el manifest y los iconos de la PWA. npm run test:e2e crea un build nuevo, lo sirve durante la prueba y detiene el servidor al terminar.
La política de docs/documentation-policy.json está en required: docs:check y docs:check:final exigen que el DTS y los manuales coincidan con sus fuentes y capturas registradas.
En reconocimiento eliges Drop, set de cuerdas y dificultad. Fácil pide el acorde; medio añade la inversión; difícil añade los cuatro grados sobre la tarjeta mediante arrastre, dos toques, teclado o los controles de colocación sin arrastre. Durante el test puedes volver a preguntas anteriores, avanzar restaurando tus respuestas y terminar para revisar los errores y la solución de cada pregunta.
La opción mayor se llama Cmaj7 / C6 en todas las preguntas. Las formas que llevan sexta en la plantilla se preguntan con esa sexta, también en tercera inversión; al corregir aparecen la sexta dorada y la séptima gris de referencia. En Difícil se coloca 6, no 7, en el círculo de la sexta. El banco ofrece siempre ambos grados. La etiqueta agrupa las dos variantes de la familia mayor y no afirma que C6 y Cmaj7 tengan las mismas notas.
Las tarjetas salen al azar entre las que quedan por mostrar: se recorre todo el set antes de repetir. Después empieza otra ronda, evitando repetir seguidas la última tarjeta y la primera de la ronda nueva. La versión instalada aparece arriba, en una etiqueta pequeña.
Cada pregunta indica Tónica: C. La inversión y los grados se interpretan respecto a esa referencia, aunque las mismas notas admitan otro nombre. Tras verificar, la corrección localiza la tónica por cuerda y traste y explica las lecturas equivalentes C6/Am7 y Cm7/E♭6, con su inversión calculada desde el bajo real. Durante la pregunta, los círculos permanecen neutros. Al pie aparece «Creado por Jesús Quevedo Rodríguez».
En rutas II-V-I se usa Drop 2, sets 1 y 2. Puedes practicar II → V, V → I o la secuencia completa, en mayor o menor. La partida permanece visible y eliges una de cuatro posiciones candidatas. Durante el test puedes volver a preguntas anteriores con tu selección y resultado conservados, y terminarlo para revisar cada respuesta junto a la posición que corresponde a la ruta, incluidas las que quedaron pendientes.
Los juegos evaluables se practican en C.
Desde el menú principal se abre #/study. No hay preguntas, verificación ni puntuación.
Voicings: eliges Drop, set, calidad e inversión y ves la solución completa. El selector de tonalidad transpone la forma a cualquiera de las 12 tónicas cromáticas sin modificar los datos fuente. Cuando la plantilla original muestra la variante de sexta de un Cmaj7, el estudio reproduce Cmaj7 – C6: la 7ª mayor baja dos trastes y pasa a 6. La séptima original permanece como círculo gris de referencia. Las dos posiciones se transponen juntas (Dmaj7 – D6, etc.); la referencia gris no cuenta como una quinta voz.
Rutas II-V-I: eliges set, mayor o menor y una de las cuatro rutas. Se muestran II, V e I juntos y Ver movimiento detalla cuánto se desplaza cada voz en cada cuerda entre II → V y V → I. Las rutas que citan C6 en la fuente muestran también esa variante, por lo que el movimiento se calcula sobre la forma que realmente se ve.
Cada tarjeta de ruta señala el mismo traste ancla que la plantilla: la raíz del acorde II. La banda sombreada y el número en negrita se desplazan al cambiar de tonalidad.
La transposición usa el desplazamiento cromático más corto que no produzca trastes negativos. Si hace falta se coloca la forma una octava más arriba. En una ruta completa se aplica el mismo desplazamiento a los tres acordes para conservar la conducción de voces de la fuente.
La pantalla interna #/revision permite revisar las 112 tarjetas y el icono. En su vista de solución aparecen también las nueve variantes C6 de la fuente, con la sexta dorada y la séptima gris.
En móvil se mantiene el flujo vertical y los controles táctiles existentes. En escritorio, a partir de 960 px, la aplicación aprovecha el ancho disponible: el menú separa configuración y progreso, el reconocimiento coloca tarjeta y respuesta en paralelo, las rutas distribuyen partida y candidato/resultado en columnas y el modo estudio deja los controles a un lado del contenido. El mástil conserva su ventana corta; no se estira para llenar el monitor.
Cada pregunta verificada suma un intento. En reconocimiento se cuenta por set y dificultad; en rutas, por set, modo y tramo. Solo hay acierto cuando la respuesta completa coincide con la solución del ejercicio. El modo estudio no suma intentos ni aciertos.
La configuración y los contadores se guardan en localStorage en el navegador y dispositivo actuales. No hay cuentas ni sincronización. Si el almacenamiento falla, la aplicación lo avisa y permite continuar en memoria.
El build genera un service worker con precaché de los recursos de la aplicación. Una versión nueva queda esperando hasta que el usuario acepta actualizar desde el menú. Si otra pestaña ya la activó, «Actualizar ahora» recarga con esa versión aunque ya no haya un worker en espera. Las otras pestañas no se recargan automáticamente. La actualización no borra el progreso guardado.
El repositorio incluye .github/workflows/deploy-pages.yml: un trabajo construye la aplicación y otro despliega el artefacto con GitHub Pages.
Drop Route se construye para la subruta /Drop_Route/:
DROP_ROUTE_BASE=/Drop_Route/ npm run buildEn PowerShell:
$env:DROP_ROUTE_BASE = '/Drop_Route/'
npm run buildLa aplicación está publicada en:
https://a01653.github.io/Drop_Route/
Consulta las ejecuciones de GitHub Actions para el estado remoto de validación y publicación. Este README describe el estado publicado; los resultados detallados de cada entrega se registran en docs/validation/.
.github/workflows/validate-foundation.yml ejecuta dos trabajos. foundation valida datos, auditoría musical, tests de base y documentación estricta. app ejecuta typecheck, lint, unitarias, build, E2E y genera las capturas de los manuales como artefacto.
No hay audio, metrónomo, cuentas, backend, sincronización entre dispositivos ni notificaciones. La transposición se limita al modo estudio; los juegos evaluables permanecen en C. Las rutas evaluables y de estudio se limitan a Drop 2, sets 1 y 2. La instalación PWA y el comportamiento en dispositivos físicos, Safari y Firefox no están cubiertos por la batería actual de Chromium.