Skip to content

FRANK17d/gestor_tareas

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📋 Gestor de Tareas Personales

Java JavaFX Maven License

Una aplicación de escritorio moderna para gestionar tus tareas diarias

Desarrollado con Java 17, JavaFX y Maven


🚀 Características Principales

✨ Funcionalidades Core

  • ➕ Agregar Tareas: Crea nuevas tareas con descripción personalizada
  • ✅ Marcar Completadas: Cambia el estado de las tareas a completadas
  • 🗑️ Eliminar Tareas: Remueve tareas no necesarias (con confirmación)
  • 👁️ Visualizar Lista: Muestra todas las tareas en una tabla organizada

🎨 Experiencia de Usuario

  • 🎯 Interfaz Moderna: Diseño atractivo y profesional con JavaFX
  • 📊 Contador en Tiempo Real: Estadísticas de tareas totales, completadas y pendientes
  • 🎨 Estilos Visuales: Tareas completadas se ven diferentes (tachadas, colores)
  • ⌨️ Atajos de Teclado: Presiona Enter para agregar tareas rápidamente
  • 🔄 Selección Múltiple: Operaciones en lote para mayor eficiencia

💾 Persistencia de Datos

  • 💾 Guardado Automático: Las tareas se guardan automáticamente
  • 🔄 Carga Automática: Al abrir la app, carga tus tareas guardadas
  • 📁 Archivo Local: Datos almacenados en tareas.dat

🛠️ Requisitos del Sistema

Componente Versión Requerida
Java 17 o superior
Maven 3.6 o superior
JavaFX 17 (incluido en dependencias)
Sistema Operativo Windows, macOS, Linux

📦 Instalación y Configuración

1️⃣ Clonar/Descargar el Proyecto

# Si tienes el proyecto en Git
git clone [URL_DEL_REPOSITORIO]

# O simplemente descarga y extrae el archivo ZIP

2️⃣ Navegar al Directorio

cd gestor_tareas

3️⃣ Verificar Requisitos

# Verificar Java
java -version

# Verificar Maven
mvn -version

🚀 Cómo Ejecutar la Aplicación

Opción 1: Ejecutar con Maven (Recomendado) ⭐

mvn clean javafx:run

Opción 2: Compilar y Ejecutar Manualmente

# Compilar el proyecto
mvn clean compile

# Ejecutar la aplicación
mvn exec:java -Dexec.mainClass="com.lab08.Main"

Opción 3: Crear JAR Ejecutable

# Crear el JAR
mvn clean package

# Ejecutar el JAR (requiere JavaFX en el classpath)
java --module-path /path/to/javafx/lib --add-modules javafx.controls,javafx.fxml -jar target/gestor_tareas-1.0-SNAPSHOT.jar

📖 Guía de Uso

🎯 Interfaz Principal

La aplicación se divide en tres secciones principales:

  1. 📊 Panel Superior: Contador de estadísticas en tiempo real
  2. ⚡ Panel de Acciones: Formulario para agregar tareas y botones de acción
  3. 📋 Tabla de Tareas: Lista completa de todas las tareas

📝 Cómo Usar las Funcionalidades

➕ Agregar una Nueva Tarea

  1. Escribe la descripción en el campo de texto
  2. Haz clic en "Agregar" o presiona Enter
  3. La tarea aparecerá en la tabla con estado "Pendiente"

✅ Marcar Tareas como Completadas

  1. Selecciona una o más tareas en la tabla (Ctrl+Click para múltiple)
  2. Haz clic en "Marcar como Completada"
  3. Las tareas cambiarán su estilo visual y estado

🗑️ Eliminar Tareas

  1. Selecciona las tareas que quieres eliminar
  2. Haz clic en "Eliminar"
  3. Confirma la eliminación en el diálogo

👁️ Interpretar la Tabla

Columna Descripción
ID Identificador único de la tarea
Descripción Texto de la tarea (tachado si está completada)
Estado "Completada" (verde) o "Pendiente" (naranja)
Fecha de Creación Cuándo fue creada la tarea

🏗️ Arquitectura del Proyecto

gestor_tareas/
├── 📁 src/
│   └── 📁 main/
│       ├── 📁 java/
│       │   └── 📁 com/lab08/
│       │       ├── 🎯 Main.java                    # Punto de entrada
│       │       ├── 📁 controller/
│       │       │   └── 🎮 GestorTareasController.java  # Lógica de la interfaz
│       │       └── 📁 model/
│       │           └── 📋 Tarea.java               # Modelo de datos
│       └── 📁 resources/
│           └── 🎨 vista_principal.fxml             # Interfaz gráfica
├── 📄 pom.xml                                      # Configuración Maven
├── 💾 tareas.dat                                   # Archivo de datos
└── 📖 README.md                                    # Esta documentación

🏛️ Patrón de Arquitectura: MVC

  • Model: Tarea.java - Representa los datos
  • View: vista_principal.fxml - Interfaz de usuario
  • Controller: GestorTareasController.java - Lógica de negocio

🔧 Tecnologías Utilizadas

Tecnología Propósito Versión
Java Lenguaje de programación 17+
JavaFX Framework de interfaz gráfica 17.0.2
FXML Diseño de interfaces 17.0.2
Maven Gestión de dependencias 3.6+
Serialización Persistencia de datos Java nativo

🎨 Características Visuales

🎯 Estilos de Tareas

  • Tareas Pendientes: Texto normal, fondo naranja claro
  • Tareas Completadas: Texto tachado e itálica, fondo verde claro

🎨 Paleta de Colores

  • Primario: #2c3e50 (Azul oscuro)
  • Secundario: #34495e (Gris azulado)
  • Éxito: #27ae60 (Verde)
  • Advertencia: #f39c12 (Naranja)
  • Peligro: #e74c3c (Rojo)

🧪 Cómo Probar la Aplicación

✅ Lista de Verificación de Funcionalidades

  1. ✅ Agregar Tareas

    • Escribir descripción y presionar "Agregar"
    • Probar atajo de teclado (Enter)
    • Verificar validación de campos vacíos
    • Verificar validación de longitud máxima
  2. ✅ Marcar como Completadas

    • Seleccionar tarea pendiente
    • Presionar "Marcar como Completada"
    • Verificar cambio visual (texto tachado)
    • Verificar cambio de estado a "Completada"
  3. ✅ Eliminar Tareas

    • Seleccionar tarea(s)
    • Presionar "Eliminar"
    • Confirmar en el diálogo
    • Verificar eliminación
  4. ✅ Persistencia de Datos

    • Agregar algunas tareas
    • Marcar algunas como completadas
    • Cerrar la aplicación
    • Reabrir y verificar que las tareas se mantienen
  5. ✅ Interfaz y UX

    • Verificar contador en tiempo real
    • Probar selección múltiple
    • Verificar estilos visuales
    • Probar redimensionamiento de ventana

🐛 Solución de Problemas

❌ Error: "JavaFX runtime components are missing"

# Solución: Usar el plugin de Maven
mvn clean javafx:run

❌ Error: "No se pudieron guardar las tareas"

  • Verificar permisos de escritura en el directorio
  • Asegurarse de que no hay otro proceso usando el archivo

❌ Error: "Module not found"

# Recompilar el proyecto
mvn clean compile

🚀 Funcionalidades Futuras (Ideas)

  • 📅 Fechas de Vencimiento: Agregar deadlines a las tareas
  • 🏷️ Categorías: Organizar tareas por categorías
  • 🔍 Filtros: Filtrar por estado, fecha, categoría
  • 📊 Estadísticas: Gráficos de productividad
  • 🌙 Modo Oscuro: Tema alternativo
  • 📱 Exportar: Exportar tareas a CSV/PDF
  • 🔄 Sincronización: Sincronizar con servicios en la nube

👨‍💻 Autor

Desarrollado por: [Frank Castro]
Proyecto: Laboratorio 08 - Java + Maven
Fecha: 2025


🌟 ¡Disfruta organizando tus tareas! 🌟

Si te gusta este proyecto, ¡dale una ⭐!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages