📚 Gestor de Lecturas

Aplicación web desarrollada con Django y MariaDB para la gestión de lecturas, libros y metas de lectura.
Permite a los usuarios registrar libros, seguir el progreso de sus lecturas, crear y asignar metas, tomar notas y visualizar estadísticas.
Incluye funcionalidades para usuarios administradores y usuarios normales, control de permisos, y una interfaz moderna y responsiva desarrollada con HTML, CSS y JavaScript.

---

✨ Características principales

• Registro y autenticación de usuarios personalizados.
• Gestión de libros y progreso de lectura.
• Creación y asignación de metas de lectura a usuarios.
• Notas asociadas a libros y metas.
• Panel de estadísticas con gráficos.
• Permisos diferenciados para administradores y usuarios normales.
• Interfaz responsiva y moderna.

Ideal para clubes de lectura, bibliotecas personales o instituciones educativas.

---

🚀 Instalación en Windows

1️⃣ Requisitos previos

• Python 3.10 o superior instalado. Descargar aquí
• MariaDB 10.x instalado y configurado. Descargar aquí
• Git instalado. Descargar aquí

Durante la instalación de Python en Windows, marca la opción "Add Python to PATH".

---

2️⃣ Clonar el repositorio

Abre PowerShell o CMD y ejecuta:

git clone https://github.com/AnnGeliux/sistemaGestorLecturas.git
cd sistemaGestorLecturas

---

3️⃣ Crear y activar el entorno virtual

python -m venv venv
venv\Scripts\activate

---

4️⃣ Instalar dependencias

pip install -r requirements.txt

---

5️⃣ Configurar la base de datos MariaDB

1. Abre HeidiSQL, MySQL Workbench o la consola de MariaDB.
2. Crea la base de datos:

   CREATE DATABASE gestor_lecturas CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

3. En el archivo settings.py de Django, configura las credenciales:

   DATABASES = {
       'default': {
           'ENGINE': 'django.db.backends.mysql',
           'NAME': 'gestor_lecturas',
           'USER': 'root',  # O tu usuario de MariaDB
           'PASSWORD': 'tu_contraseña',
           'HOST': 'localhost',
           'PORT': '3306',
       }
   }

---

6️⃣ Aplicar migraciones

python manage.py migrate

---

7️⃣ Iniciar el servidor

python manage.py runserver

Accede a la aplicación en: http://127.0.0.1:8000/

---

🧩 Tecnologías utilizadas

• Python 3.10+
• Django 5.2.4
• MariaDB 10.x
• mysqlclient 2.2.7
• PyMySQL 1.1.1
• Pillow 11.3.0
• asgiref 3.9.1
• sqlparse 0.5.3
• tzdata 2025.2
• HTML5
• CSS3
• JavaScript
• Chart.js (para las estadísticas)

---

📄 Licencia

Este proyecto está bajo la licencia MIT - mira el archivo LICENSE para más detalles.

---