Árbol de Dependencias y Relaciones de Scripts

Este documento visualiza cómo los scripts de gestión de alumnos y profesores se interconectan dentro del sistema OTEC y con las tablas de la base de datos.

Módulo de Gestión de Alumnos

listado_alumnos.php

Punto central para visualizar y acceder a la gestión de alumnos.
Tablas Leídas: alumnos, cursos_sence (para filtro), inscripciones_curso (para conteo y modal).

Vincula a:
- form_alumno.php (para crear nuevo alumno y para editar existente).
- ver_alumno.php (para ver ficha detallada).
- inscribir_alumno.php (para inscribir alumno en curso).
- cambiar_estado_alumno.php (para activar/desactivar alumno).
- subir_foto_alumno.php (a través de un modal para cambio rápido de foto).
- admin.php (enlace de retorno).
- buscar_alumno.php (enlace, aunque la funcionalidad de búsqueda está integrada).
Lógica Principal: Filtrado, paginación y presentación de lista de alumnos. Muestra información de completitud y conteo de cursos activos. Modal para ver cursos del alumno.
- form_alumno.php
  Creación y edición de datos de alumnos.
  
  Tablas Leídas/Escritas: alumnos.
  
  Lógica Principal: Validación de datos (RUT), manejo de subida/eliminación de `foto_perfil` (en `alumno/ID_NOMBRE_APELLIDO/foto/`), inserción y actualización de registros. Gestiona `alumnos.estado` y `alumnos.modo`.
  
  Redirige a: listado_alumnos.php (tras creación o cancelación).
- ver_alumno.php
  Ficha detallada de un alumno.
  
  Tablas Leídas: alumnos, inscripciones_curso, cursos_sence.
  
  Lógica Principal: Muestra datos personales, `foto_perfil`, `alumnos.estado`, `alumnos.modo`. Lista los cursos en los que está inscrito el alumno mostrando `inscripciones_curso.modo` (estado operacional de la inscripción) y estadísticas agregadas.
  
  Vincula a: listado_alumnos.php, form_alumno.php (editar), inscribir_alumno.php.
- registrar_alumno_en_curso.php
  Registra un nuevo alumno y lo inscribe directamente en un curso específico.
  
  Tablas Leídas/Escritas: alumnos (INSERT), cursos_sence (lectura info curso), inscripciones_curso (INSERT).
  
  Lógica Principal: Validación de datos (RUT), creación de alumno con `estado = 'activo'` y `modo = 'nuevo'`. Creación de inscripción con `estado = 'activo'` y `modo = 'inscrito'`. Manejo de subida de `foto_perfil`.
  
  Redirige a: listado_alumnos.php.
- inscribir_alumno.php
  Inscribe un alumno existente en un curso.
  
  Tablas Leídas/Escritas: alumnos (lectura), cursos_sence (lectura para selección), inscripciones_curso (INSERT).
  
  Lógica Principal: Verifica que el alumno esté activo. Permite seleccionar un curso activo y un `modo_inscripcion` (`'inscrito'`, `'preinscrito'`, `'confirmado'`). Crea el registro en `inscripciones_curso` con `estado = 'activo'`.
  
  Redirige a: ver_alumno.php.
- cambiar_estado_alumno.php
  Activa o desactiva la cuenta de un alumno.
  
  Tablas Leídas/Escritas: alumnos (UPDATE `estado`). Realiza UPDATE en cascada sobre los campos `estado` de: inscripciones_curso, notas_alumno, asistencias_alumno, pagos_alumno, documentos_alumno, mensajes_alumno_profesor, acceso_alumnos_contenido.
  
  Lógica Principal: Cambia `alumnos.estado` a `'activo'` o `'inactivo'`. Actualiza el `estado` de las entidades relacionadas para reflejar el borrado lógico.
  
  Redirige a: listado_alumnos.php.
- subir_foto_alumno.php
  Procesa la subida de foto de perfil (generalmente desde un modal).
  
  Tablas Leídas/Escritas: alumnos (UPDATE `foto_perfil`).
  
  Lógica Principal: Manejo de archivo subido, validación, creación de directorios (`alumno/ID_NOMBRE_APELLIDO/foto/`), y guardado de la ruta de la imagen.
  
  Redirige a: listado_alumnos.php.

Módulo de Gestión de Profesores

listado_profesores.php

Punto central para visualizar y acceder a la gestión de profesores.
Tablas Leídas: profesores, profesor_documentos (para completitud), cursos_profesores (para conteo y modal), cursos_sence (para modal).

Vincula a:
- form_profesor.php (para crear nuevo profesor y para editar existente).
- ver_profesor.php (para ver ficha detallada).
- asignar_cursos.php (para gestionar asignaciones de cursos al profesor).
- profesor_cursos.php (para ver cursos y subtemas que imparte).
- alumno_profesor_cursos.php (para ver alumnos relacionados con el profesor en sus cursos).
- cambiar_estado_profesor.php (para activar/desactivar profesor).
- admin.php (enlace de retorno).
Lógica Principal: Filtrado, paginación y presentación de lista de profesores. Muestra `profesores.estado`, completitud de perfil. Modal para ver cursos asignados (basado en `cursos_profesores.modo` y filtrando por `cursos_profesores.estado = 'activo'`).
- form_profesor.php
  Creación y edición de datos de profesores y sus documentos.
  
  Tablas Leídas/Escritas: profesores (CRUD), profesor_documentos (CRUD).
  
  Lógica Principal: Validación de datos (RUT), manejo de `foto_perfil` (en `profesor/ID_NOMBRE_APELLIDO/foto/`), gestión de documentos (en `profesor/ID_NOMBRE_APELLIDO/documentos/`) incluyendo `tipo_documento`. Gestiona `profesores.estado`.
  
  Redirige a: listado_profesores.php (tras creación o cancelación).
- ver_profesor.php
  Ficha detallada de un profesor.
  
  Tablas Leídas: profesores, profesor_documentos (filtrando por `estado='activo'`), cursos_profesores (filtrando por `estado='activo'`), cursos_sence.
  
  Lógica Principal: Muestra datos personales, `foto_perfil`, `profesores.estado`. Lista documentos activos (mostrando `profesor_documentos.modo`). Lista asignaciones de cursos activas (mostrando `cursos_profesores.modo`) y calcula estadísticas basadas en el `modo` de estas asignaciones.
  
  Vincula a: listado_profesores.php, form_profesor.php (editar), asignar_cursos.php, profesor_subtemas.php.
- cambiar_estado_profesor.php
  Activa o desactiva la cuenta de un profesor.
  
  Tablas Leídas/Escritas: profesores (UPDATE `estado`). Realiza UPDATE en cascada sobre los campos `estado` (`activo`/`inactivo`) de: cursos_profesores, profesor_documentos, subtemas_curso, mensajes_alumno_profesor, pizarra_curso. No modifica los campos `modo` de `cursos_profesores` ni `profesor_documentos`.
  
  Redirige a: listado_profesores.php.
- asignar_cursos.php
  Asigna cursos a un profesor y gestiona detalles de la asignación.
  
  Tablas Leídas/Escritas: profesores (lectura), cursos_sence (lectura para selección), cursos_profesores (CRUD).
  
  Lógica Principal: Permite crear y editar registros en `cursos_profesores`. Gestiona el `estado` (`activo`/`inactivo`) y el `modo` (`'asignado'`, `'finalizado'`, `'cancelado'`) de la asignación, así como campos administrativos y financieros detallados.
  
  Redirige a: ver_profesor.php.
- profesor_cursos.php
  Muestra los cursos y los subtemas que un profesor imparte directamente.
  
  Tablas Leídas: profesores, cursos_profesores, cursos_sence, subtemas_curso, temas_curso, inscripciones_curso (para fechas y conteo de alumnos).
  
  Lógica Principal: Lista cursos donde el profesor tiene una asignación en `cursos_profesores`. Para cada uno de estos cursos, muestra los `subtemas_curso` donde `subtemas_curso.profesor_id` es el profesor actual.
  
  Vincula a: ver_curso.php, profesor_subtemas.php.
- profesor_subtemas.php
  Vista detallada de temas y subtemas que un profesor imparte en un curso específico.
  
  Tablas Leídas: profesores, cursos_sence, inscripciones_curso, cursos_profesores, temas_curso, subtemas_curso, documentos_subtema.
  
  Lógica Principal: Para un `curso_id` y `profesor_id` dados, lista todos los temas del curso y, dentro de cada tema, los subtemas donde `subtemas_curso.profesor_id` coincide. Muestra detalles del subtema (video, zoom, documentos).
  
  Vincula a: ver_subtema.php, form_subtema.php, profesor_cursos.php (volver).
- alumno_profesor_cursos.php
  Muestra alumnos asociados a un profesor en el contexto de los subtemas que este imparte en cursos específicos.
  
  Tablas Leídas: profesores, cursos_profesores, cursos_sence, subtemas_curso, subtemas_alumno, alumnos, temas_curso, inscripciones_curso.
  
  Lógica Principal: Permite seleccionar un curso donde el profesor tiene asignados subtemas y hay alumnos interactuando. Luego lista esos alumnos y los subtemas que han visto/completado. Si no se selecciona curso, lista los cursos elegibles.
  
  Vincula a: ver_alumno.php, gestionar_inscripcion.php.

Panel de Administración General

admin.php

Dashboard principal del sistema OTEC.
Tablas Leídas: alumnos, cursos_sence, inscripciones_curso, profesores, cursos_profesores, temas_curso, subtemas_curso.

Vincula a Múltiples Módulos:
- Gestión de Alumnos (listado_alumnos.php, form_alumno.php, etc.).
- Gestión de Cursos (lista_cursos.php, form_crea_curso_ppp.php).
- Gestión de Profesores (listado_profesores.php, form_profesor.php, asignar_curso_profesor.php).
- Gestión de Temas y Subtemas (enlaces a subdirectorio `admin/`).
- Gestión de Inscripciones y Finanzas.
- Herramientas de Monitoreo y Auditoría.
- Enlaces a páginas web públicas del sistema.
Lógica Principal: Muestra estadísticas agregadas de las principales entidades del sistema. Actúa como un concentrador de acceso a las diferentes funcionalidades administrativas.

Nota sobre Interconexiones

Este árbol representa las principales interacciones directas (ej. un script que enlaza a otro o que modifica/lee directamente una tabla relevante para otro script). No se detallan todas las inclusiones de archivos comunes (como `conecta_mysql_otec.php`) ni todas las posibles interacciones indirectas a través de la base de datos.

La estructura de la base de datos con sus relaciones de clave foránea (FK) es fundamental para entender la interconexión completa de los datos entre los módulos.

Árbol de Dependencias y Relaciones de Scripts

Módulo de Gestión de Alumnos

listado_alumnos.php

Módulo de Gestión de Profesores

listado_profesores.php

Panel de Administración General

admin.php

Nota sobre Interconexiones