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.