🎓 Aula Virtual - Sistema de Gestión Educativa

Un sistema web completo para la gestión educativa que permite administrar estudiantes, profesores, materias, notas, asistencia y actividades académicas de manera eficiente y moderna.

📋 Descripción

Aula Virtual es una plataforma web desarrollada en PHP que facilita la gestión integral de instituciones educativas. El sistema permite a administradores, profesores y estudiantes interactuar de manera organizada, ofreciendo herramientas para el seguimiento académico, control de asistencia, gestión de tareas y comunicación entre usuarios.

✨ Características Principales

• Gestión de Usuarios: Administración completa de estudiantes, profesores y administradores
• Control de Asistencia: Registro y seguimiento de asistencia por materia y curso
• Sistema de Notas: Gestión de calificaciones por lapsos con cálculo automático de promedios
• Gestión de Materias: Organización de materias por cursos y profesores
• Tareas y Actividades: Subida y gestión de tareas, guías y material educativo
• Sistema de Reportes: Generación de reportes académicos y de asistencia
• Eventos y Publicaciones: Sistema de noticias y eventos institucionales
• Interfaz Personalizable: Colores y logo personalizables por institución
• Sistema de Roles: Diferentes niveles de acceso (Admin, Profesor, Estudiante, Coordinador)

🛠️ Requisitos del Sistema

Software Requerido

• XAMPP (Apache + MySQL + PHP)
  • PHP 7.4 o superior
  • MySQL 5.7 o superior
  • Apache 2.4 o superior
• Editor de Código (recomendado: Visual Studio Code)
• Navegador Web moderno (Chrome, Firefox, Safari, Edge)

Dependencias del Proyecto

• Bootstrap 4.x - Framework CSS para diseño responsivo
• jQuery 3.3.1 - Biblioteca JavaScript
• SweetAlert2 - Alertas y notificaciones elegantes
• Material Design Iconic Font - Iconografía
• Popper.js - Posicionamiento de elementos

🚀 Instalación y Configuración

Paso 1: Preparar el Entorno

1. Instalar XAMPP:

   • Descargar desde https://www.apachefriends.org/
   • Instalar y ejecutar Apache y MySQL

2. Clonar o Descargar el Proyecto:

   git clone https://github.com/maxondmdo/Aula-Virtual.git
   # o descargar y extraer el ZIP

3. Ubicar el Proyecto:

   • Copiar la carpeta del proyecto a C:\xampp\htdocs\ (Windows)
   • O a /opt/lampp/htdocs/ (Linux)

Paso 2: Configurar la Base de Datos

1. Acceder a phpMyAdmin:

   • Abrir navegador y ir a http://localhost/phpmyadmin

2. Crear la Base de Datos:

   • Crear nueva base de datos llamada aula_virtual
   • Importar el archivo bd/aula_virtual.sql

3. Configurar Conexión (si es necesario):

   • Editar bd/conexion.php y dashboard/bd.php
   • Ajustar credenciales de base de datos:

   $servidor = "localhost";
   $usuario = "root";
   $password = "";
   $basededatos = "aula_virtual";

Paso 3: Configurar Permisos

1. Permisos de Carpetas:
   • Asegurar permisos de escritura en:
     • dashboard/files/
     • dashboard/img/
     • dashboard/action/imagenes/

📖 Guía de Uso Básico

Acceso al Sistema

1. URL de Acceso: http://localhost/Aula-Virtual/
2. Credenciales por Defecto:
   • Administrador:
     • Usuario: Maxon
     • Contraseña: [Ver en base de datos]

Funcionalidades por Rol

👨‍💼 Administrador

• Gestión completa de usuarios (estudiantes, profesores)
• Configuración de cursos y materias
• Gestión de períodos académicos
• Reportes y estadísticas
• Personalización del sistema (colores, logo)
• Gestión de eventos y publicaciones

👨‍🏫 Profesor

• Gestión de materias asignadas
• Registro de asistencia
• Carga de notas y evaluaciones
• Subida de material educativo
• Gestión de tareas y actividades
• Comunicación con estudiantes

👨‍🎓 Estudiante

• Visualización de notas y promedios
• Consulta de asistencia
• Descarga de material educativo
• Envío de tareas (si está habilitado)
• Visualización de horarios

Navegación Principal

• Dashboard: Página principal con eventos y noticias
• Usuarios: Gestión de estudiantes y profesores
• Cursos: Administración de secciones
• Materias: Gestión de asignaturas
• Notas: Sistema de calificaciones
• Asistencia: Control de asistencia
• Reportes: Generación de informes

📁 Estructura del Proyecto

Aula-Virtual/
├── 📁 bd/                     # Base de datos y conexiones
│   ├── aula_virtual.sql       # Script de base de datos
│   ├── conexion.php          # Conexión PDO
│   ├── login.php             # Autenticación
│   └── logout.php            # Cerrar sesión
├── 📁 bootstrap/              # Framework Bootstrap
│   ├── css/                  # Estilos Bootstrap
│   └── js/                   # Scripts Bootstrap
├── 📁 dashboard/              # Panel administrativo
│   ├── 📁 action/            # Acciones del sistema
│   ├── 📁 css/               # Estilos personalizados
│   ├── 📁 files/             # Archivos subidos
│   ├── 📁 img/               # Imágenes del sistema
│   ├── 📁 js/                # Scripts JavaScript
│   ├── 📁 vistas/            # Plantillas PHP
│   ├── index.php             # Dashboard principal
│   ├── usuarios.php          # Gestión de usuarios
│   ├── materias.php          # Gestión de materias
│   ├── notas.php             # Sistema de notas
│   ├── asistencia.php        # Control de asistencia
│   └── [otros módulos]       # Funcionalidades adicionales
├── 📁 fuentes/               # Tipografías
│   ├── iconic/               # Iconos Material Design
│   └── poppins/              # Fuente Poppins
├── 📁 jquery/                # Biblioteca jQuery
├── 📁 plugins/               # Plugins adicionales
│   └── sweetalert2/          # Alertas elegantes
├── 📁 popper/                # Popper.js
├── index.php                 # Página de login
├── estilos.php               # Estilos dinámicos
├── codigo.js                 # JavaScript principal
├── package.json              # Configuración del proyecto
└── README.md                 # Documentación

Módulos Principales

🔐 Autenticación

• Login seguro con encriptación de contraseñas
• Sesiones de usuario con control de tiempo
• Roles y permisos diferenciados

👥 Gestión de Usuarios

• CRUD completo de estudiantes y profesores
• Asignación de cursos y materias
• Control de estados (activo/inactivo)

📚 Sistema Académico

• Gestión de materias por curso
• Sistema de notas por lapsos
• Control de asistencia detallado
• Cálculo automático de promedios

📋 Gestión de Contenido

• Subida de archivos (documentos, imágenes, videos)
• Gestión de tareas y actividades
• Sistema de eventos y publicaciones

🔧 Configuración Avanzada

Personalización Visual

1. Cambiar Colores:

   • Acceder como administrador
   • Ir a "Personalizar"
   • Modificar color principal

2. Cambiar Logo:

   • Subir imagen en "Personalizar"
   • Formatos soportados: JPG, PNG, GIF

Configuración de Email

• Configurar SMTP en dashboard/action/email.php
• Usar PHPMailer para notificaciones

🐛 Solución de Problemas

Problemas Comunes

1. Error de Conexión a Base de Datos:

   • Verificar que MySQL esté ejecutándose
   • Comprobar credenciales en archivos de configuración

2. Problemas de Permisos:

   • Verificar permisos de escritura en carpetas
   • En Linux: chmod 755 dashboard/files/

3. Estilos no Cargan:

   • Verificar rutas de archivos CSS
   • Limpiar caché del navegador

4. Errores de JavaScript:

   • Verificar consola del navegador
   • Comprobar carga de bibliotecas jQuery

📄 Licencia

Este proyecto está bajo la Licencia ISC. Ver el archivo package.json para más detalles.

👥 Créditos

• Desarrollado por: Estudiantes de 6to Año "U"
• Institución: Colegio Madre Emilia
• Tecnologías: PHP, MySQL, Bootstrap, jQuery
• Año: 2025

🤝 Contribuciones

Las contribuciones son bienvenidas. Para contribuir:

1. Fork el proyecto
2. Crear una rama para tu feature (git checkout -b feature/AmazingFeature)
3. Commit tus cambios (git commit -m 'Add some AmazingFeature')
4. Push a la rama (git push origin feature/AmazingFeature)
5. Abrir un Pull Request

📞 Soporte

Para soporte técnico o consultas:

• Email: maxondmdo@gmail.com
• Teléfono: 04242022924

---

Nota: Este sistema fue desarrollado como proyecto educativo por estudiantes del Colegio Madre Emilia, demostrando la aplicación práctica de conocimientos en desarrollo web y gestión de bases de datos.