Documentación

Topaz – Versión 25.9.1-SNAPSHOT

Topaz es una aplicación de diario personal que combina Spring Boot, Thymeleaf y JavaFX para ofrecerte una experiencia fluida de registro de emociones, hábitos y reflexiones diarias.


Novedades de esta versión

  • Dashboard “Inicio”: Información general de tu progreso, rachas y recordatorios.
  • Diario “Diario”: Diario guiado para hacer introspección sobre todas las áreas de la vida.
  • Diario “Revisión”: Registro avanzado con:
    • Estado emocional
    • Emociones seleccionables (Alegría, Serenidad, Tristeza, etc)
    • Valoraciones personales (Disciplina, Constancia, Honestidad, Impulsividad, etc)
  • Estadísticas: Visualiza métricas de tus entradas con gráficos interactivos.
  • Trabajo Interno: Escribe ensayos sobre temas importantes para ti, como la asertividad, autoestima, perseverancia, gratitud, etc. Organízalos con etiquetas.
  • Meditación: Guarda y reproduce audios de meditación directamente en la app.
  • Interfaz moderna: Tailwind CSS y JavaFX WebView para una experiencia tipo “nativa” en Windows.

Detalles técnicos

  • Backend: Java 21, Spring Boot 3.4.1
  • Frontend: Thymeleaf + Tailwind CSS
  • UI Desktop: JavaFX WebView
  • Base de datos: SQLite
  • Distribución: Fat JAR

Guía de instalación

Requisitos previos

  • Sistema operativo: Windows. Topaz solo funciona en Windows porque la base de datos se guarda en la ruta fija C:\Topaz\data.
  • Java: Se recomienda tener instalada la versión Java 23 (JDK 23). Comprueba la instalación con:
java -version

Ejecución

Para ejecutar Topaz, abre cmd, navega al directorio donde está el .jar y ejecuta:

cd C:\ruta\del\jar
java -jar topaz-25.9.1-SNAPSHOT.jar
Notas adicionales
  • Asegúrate de que el usuario de Windows que ejecute Topaz tenga permisos de lectura/escritura en C:\Topaz\data.
  • Si tienes problemas con la versión de Java, instala JDK 21 desde la web oficial de Oracle.