Gestión de Notas

Calculadora de Promedio de Notas es una aplicación web diseñada para calcular promedios ponderados de calificaciones, con almacenamiento local persistente y una interfaz moderna con soporte para modo claro y oscuro.

📋 Requisitos Previos

Antes de comenzar, asegúrate de tener lo siguiente:

• Navegador Web Moderno: Chrome, Firefox, Edge o Safari (versión reciente).
• Editor de Código (opcional): VS Code o cualquier editor de texto.
• Servidor Local (opcional): Para desarrollo, puedes usar Live Server o cualquier servidor HTTP local.

🚀 Instalación y Configuración

1. Clonar el Repositorio

git clone <url-del-repositorio>cd notemanagement

2. Abrir la Aplicación

Puedes abrir la aplicación de las siguientes maneras:

Opción A - Directamente en el navegador:

# Windows
start index.html
# macOS
open index.html
# Linux
xdg-open index.html

Opción B - Con Live Server (VS Code):

1. Abre el proyecto en VS Code.
2. Instala la extensión Live Server si no la tienes.
3. Haz clic derecho en index.html y selecciona "Open with Live Server".

Opción C - Con servidor HTTP local:

# Con Python 3
python -m http.server 8080
# Con Node.js (http-server)
npx http-server -p 8080

Luego abre tu navegador en http://localhost:8080.

📱 Características

Funcionalidades Principales

• Cálculo de Promedios Ponderados: Ingresa porcentajes y notas para obtener el promedio final automáticamente.
• Indicadores Visuales: El promedio final se muestra en verde (aprobado ≥13) o rojo (reprobado <13).
• Almacenamiento Local: Guarda tus cálculos en el navegador usando localStorage.
• Gestión de Cálculos: Edita o elimina cálculos guardados.
• Paginación: Navega entre múltiples cálculos guardados (4 por página).
• Modo Oscuro: Soporte automático para tema claro y oscuro.
• Diseño Responsivo: Funciona en dispositivos móviles, tablets y escritorio.

Estructura de Notas

La aplicación permite ingresar hasta 4 evaluaciones con:

Campo	Descripción
Porcentaje	Peso de la evaluación (ej: 25%)
Nota	Calificación obtenida (ej: 8.5)
Resultado	Cálculo automático (Porcentaje × Nota ÷ 100)

🎨 Tecnologías Utilizadas

Tecnología	Propósito
HTML5	Estructura del documento
JavaScript (ES6+)	Lógica de cálculo y almacenamiento
TailwindCSS (CDN)	Estilos y diseño responsivo
Google Fonts (Lexend)	Tipografía personalizada
Material Symbols	Íconos de interfaz

📂 Estructura del Proyecto

notemanagement/
├── index.html # Aplicación principal (HTML + CSS + JS)
└── README.md # Documentación del proyecto

🔧 Uso de la Aplicación

Calcular Promedio

1. Ingresa el nombre del curso en el campo superior.
2. Para cada fila, ingresa el porcentaje y la nota correspondiente.
3. El resultado y el promedio final se calculan automáticamente.

Guardar Cálculo

1. Haz clic en el botón "Guardar Cálculo".
2. El cálculo aparecerá en la lista de la derecha con:
   • Nombre del curso
   • Promedio final
   • Fecha y hora

Editar Cálculo

1. Haz clic en el ícono de editar (✏️) del cálculo deseado.
2. Los datos se cargarán en el formulario.
3. Realiza los cambios necesarios.
4. Haz clic en "Actualizar Cálculo".

Eliminar Cálculo

1. Haz clic en el ícono de eliminar (🗑️) del cálculo.
2. Confirma la eliminación en el diálogo.

🌙 Modo Oscuro

La aplicación detecta automáticamente la preferencia del sistema operativo para el tema. Para alternar manualmente:

1. En Windows: Configuración → Personalización → Colores → Modo oscuro.
2. En macOS: Preferencias del Sistema → General → Apariencia.
3. En Linux: Depende del entorno de escritorio.

💾 Persistencia de Datos

Los datos se almacenan en el localStorage del navegador bajo la clave calculations. Esto significa que:

• ✅ Los datos persisten al cerrar el navegador.
• ✅ Los datos persisten al recargar la página.
• ⚠️ Los datos se borran si limpias el caché del navegador.
• ⚠️ Los datos son específicos del navegador (no se sincronizan).

📄 Licencia

Este proyecto está bajo la licencia MIT. Siéntete libre de usar, modificar y distribuir.

---

Desarrollado con ❤️ por Carlos