PiperNotes

Resumen

PiperNotes convierte una forma de escritura musical específica en una herramienta visual y fácil de instalar en Windows, con vista previa, guardado de partituras, personalización y exportación a PDF.

Problema

La escritura y preparación de partituras para determinados instrumentos tradicionales se realizaba mediante métodos manuales o documentos poco adaptados a su notación. Era necesario disponer de una aplicación sencilla, instalable en varios equipos Windows, capaz de generar una representación clara y preparar documentos listos para imprimir.

Objetivos

• Facilitar la escritura de partituras mediante una notación específica.
• Mostrar una vista previa antes de imprimir.
• Permitir varias partituras o temas en una misma página.
• Guardar y recuperar trabajos.
• Personalizar títulos, agrupación, logotipo y formato de impresión.
• Exportar a PDF y distribuir la aplicación mediante instalador de Windows.

Solución

Área	Funciones
Edición	Entrada de notas o símbolos según la notación del instrumento y generación visual de la partitura.
Organización	Gestión de uno o varios temas, títulos y datos de la agrupación.
Vista previa	Comprobación del resultado antes de guardar o imprimir.
Persistencia	Guardado y carga de partituras y preferencias locales.
Personalización	Nombre de agrupación, tema, logo y opciones de impresión.
Salida	Exportación a PDF y guardado mediante diálogo del sistema.
Distribución	Aplicación empaquetada como ejecutable e instalador para Windows.

Mi aportación

Definición funcional, diseño de la experiencia, desarrollo, empaquetado, pruebas y evolución del producto.

Arquitectura

Capa	Tecnologías
Interfaz	React y Vite.
Escritorio	Electron, electron-builder y preload seguro para comunicación con el sistema.
Persistencia	electron-store y almacenamiento local.
Documentos	jsPDF e impresión/exportación desde Electron.
Distribución	Instalador NSIS, icono propio y configuración de producto PiperNotes.
Control de instalación	Identificación de máquina mediante node-machine-id, cuando corresponda a la versión publicada.

Decisiones y dificultades

• Convertir una notación musical específica en reglas visuales reproducibles.
• Combinar una interfaz web con capacidades de escritorio y acceso controlado al sistema de archivos.
• Evitar pantallas en blanco o errores derivados de la comunicación entre Electron, preload y React.
• Mantener la información del usuario entre sesiones sin depender de conexión a internet.
• Empaquetar la aplicación, gestionar iconos, archivos incluidos y permisos de instalación en Windows.
• Conseguir que la exportación y la impresión mantengan la composición prevista.

IA aplicada

Claude Code y ChatGPT se han utilizado como apoyo para revisar la estructura del proyecto, solucionar errores de integración entre Electron y React, depurar el proceso de empaquetado, preparar configuraciones de compilación y documentar cambios. La definición de la notación, el comportamiento esperado y la validación del resultado dependen del conocimiento funcional aportado por Manuel y de las pruebas realizadas con el uso previsto.

Resultado

PiperNotes demuestra capacidad para convertir un problema muy específico en un producto de escritorio utilizable, combinando interfaz, reglas de negocio, persistencia local, generación documental y distribución mediante instalador.