# Prompt: Migración de Vistas de Estudiantes a SB Admin 2

Eres un desarrollador PHP experto. Debes migrar el módulo de vistas de estudiantes de una plataforma académica desarrollada en **PHP 7.4 puro, MySQL y Bootstrap** al template **SB Admin 2**.

## Contexto del proyecto

- Backend: PHP 7.4 puro (sin framework)
- Base de datos: MySQL
- Frontend actual: Bootstrap genérico
- Nuevo template: SB Admin 2 (https://startbootstrap.com/theme/sb-admin-2)
- El proyecto sirve un portal de acceso para estudiantes

---

## Carpeta de trabajo

Todos los archivos nuevos o modificados deben crearse dentro de la carpeta `admin_alumnos/`.
La estructura interna debe respetarse tal como se define en cada tarea (ej: `admin_alumnos/layout/base.php`, `admin_alumnos/documentacion/modulos/`, etc.).
No modificar archivos fuera de esta carpeta salvo el botón en `index.php` indicado en la Tarea 1.

## Tareas a ejecutar en orden

### TAREA 1 — Página principal (index)

Modifica el botón "Ingresar" de la página `index.php` para que redirija al nuevo login.
- El destino debe ser `login.php` (o la ruta que ya existe)
- No modificar ninguna otra funcionalidad del index actual

---

### TAREA 2 — Vista de Login
Migra el login actual al diseño del template SB Admin 2 (`login.html` del template).

Reglas:
- Mantener **toda la lógica PHP** actual: variables de sesión, validaciones, manejo de errores, conexión a BD
- Reemplazar el fondo actual por una imagen: usar como placeholder `assets/img/bg-login.jpg` (la imagen será provista luego)
- No agregar ni quitar campos del formulario
- El archivo resultante debe ser un `.php` con el HTML del template de login incrustado

---

### TAREA 3 — Layout base con Sidebar
Crea un archivo `layout/base.php` que sea la plantilla base de todas las páginas internas del estudiante usando SB Admin 2.

El **Sidebar** debe contener exactamente estas opciones (respeta jerarquía):

```
- Manual de Usuario
- Administrativo
    - Registrar Pago
    - Historial de Pagos
- Documentos
    - Horario de Clases
    - Lista de Útiles
    - Carnet de Estudio
    - Planilla de Inscripción
    - Constancia de Inscripción
    - Constancia de Estudio
    - Constancia de Asistencia
    - Constancia de Promedio
- Calificaciones
    - Corte de Notas
    - Boletín de Calificaciones
- Encuestas [mostrar variable $periodo_actual dinámicamente]
- Calendario de Actividades
- Evaluaciones
    - Planificación Escolar
    - Calendario de Evaluaciones
- Aula Virtual
    - Video Aula
    - Material de Clases
    - Chat con Docentes
```

Requisitos del layout:
- Incluir topbar con nombre del estudiante y botón de logout
- Usar `include` o `require` para el sidebar y el footer
- Aceptar un bloque de contenido dinámico (`$content` o mediante `include $page`)
- Mantener las variables de sesión actuales del sistema

---

### TAREA 4 — Migración de páginas internas

Para **cada opción del sidebar**, migra la página correspondiente al nuevo diseño.

Por cada página:
1. Envuelve el contenido en el layout `base.php`
2. Adapta el HTML al estilo SB Admin 2 (cards, tablas con DataTables si aplica, formularios con clases del template)
3. **No modificar la lógica PHP, queries SQL, ni las variables** — solo el HTML/CSS
4. Si la página usa formularios, mantener los mismos `name`, `action` y `method`
5. Si la página genera PDFs u otras salidas especiales, no modificar esa lógica

---

### TAREA 5 — Documentación por módulo

Por cada opción del sidebar, crea un archivo `.md` en la carpeta `documentacion/modulos/` con el siguiente formato:

**Nombre del archivo:** `[nombre-opcion-kebab-case].md`
**Ejemplo:** `documentacion/modulos/constancia-de-estudio.md`

**Estructura del archivo:**

```markdown
# [Nombre del Módulo]

## Descripción
Breve descripción de qué hace esta sección.

## Acceso
Ruta del archivo PHP y URL relativa.

## Funcionalidades
- Lista de lo que puede hacer el estudiante en esta sección

## Variables de sesión utilizadas
- `$_SESSION['...']` — descripción

## Archivos relacionados
- `ruta/archivo.php` — descripción

## Notas técnicas
Cualquier particularidad del módulo (generación de PDF, consultas especiales, etc.)
```

---

## Instrucciones generales

- Procesa una tarea a la vez. Confirma cada tarea antes de continuar con la siguiente.
- Si un archivo PHP original no existe todavía, crea un placeholder con la estructura correcta y un comentario `// TODO: lógica original aquí`.
- Usa rutas relativas consistentes.
- Si encuentras lógica duplicada entre páginas, mencionarlo pero NO refactorizar — solo migrar.
- Ante cualquier ambigüedad sobre la lógica de negocio, pregunta antes de asumir.

Comienza con la **TAREA 1**.