workspace/projects/gamilit/orchestration/analisis/PLAN-AUDITORIA-PORTALES-2025-12.md

PLAN DE AUDITORIA - PORTALES ADMIN Y TEACHER

Fecha: 2025-12-15 Version: 1.0 Estado: EN EJECUCION

---

1. OBJETIVO DE LA AUDITORIA

Realizar un analisis exhaustivo de los portales Admin y Teacher para:

1. Verificar consumos de API: Que cada pagina tenga endpoints reales implementados
2. Verificar datos de BD: Que los datos mostrados provengan de la base de datos
3. Verificar componentes funcionales: Que todos los componentes internos funcionen
4. Identificar dependencias faltantes: Hooks, APIs, tipos sin implementar
5. Verificar integracion con Student: Que las acciones del estudiante actualicen datos en Admin/Teacher

---

2. INVENTARIO DE PAGINAS

2.1 Portal ADMIN (15 paginas)

#	Pagina	Archivo	Prioridad Auditoria
1	Dashboard	AdminDashboardPage.tsx	CRITICA
2	Users	AdminUsersPage.tsx	CRITICA
3	Institutions	AdminInstitutionsPage.tsx	ALTA
4	Roles	AdminRolesPage.tsx	ALTA
5	Content	AdminContentPage.tsx	ALTA
6	Gamification	AdminGamificationPage.tsx	CRITICA
7	Monitoring	AdminMonitoringPage.tsx	ALTA
8	Alerts	AdminAlertsPage.tsx	ALTA
9	Analytics	AdminAnalyticsPage.tsx	MEDIA
10	Progress	AdminProgressPage.tsx	ALTA
11	Reports	AdminReportsPage.tsx	MEDIA
12	Settings	AdminSettingsPage.tsx	MEDIA
13	Advanced	AdminAdvancedPage.tsx	BAJA
14	Assignments	AdminAssignmentsPage.tsx	ALTA
15	ClassroomTeacher	AdminClassroomTeacherPage.tsx	MEDIA

2.2 Portal TEACHER (Paginas Activas - excluir legacy/duplicados)

#	Pagina	Archivo	Prioridad Auditoria
1	Dashboard	TeacherDashboardPage.tsx	CRITICA
2	Classes	TeacherClassesPage.tsx	CRITICA
3	Monitoring	TeacherMonitoringPage.tsx	CRITICA
4	Assignments	TeacherAssignmentsPage.tsx	ALTA
5	Responses	TeacherExerciseResponsesPage.tsx	CRITICA
6	Progress	TeacherProgressPage.tsx	ALTA
7	Alerts	TeacherAlertsPage.tsx	ALTA
8	Reports	TeacherReportsPage.tsx	MEDIA
9	Gamification	TeacherGamificationPage.tsx	ALTA
10	Analytics	TeacherAnalyticsPage.tsx	MEDIA
11	Settings	TeacherSettingsPage.tsx	BAJA
12	Communication	TeacherCommunicationPage.tsx	BAJA (feature flag)
13	Content	TeacherContentPage.tsx	BAJA (feature flag)

2.3 Archivos Legacy/Duplicados (NO AUDITAR)

Teacher_Legacy:
  - TeacherDashboard.tsx (usa TeacherDashboardPage)
  - TeacherClasses.tsx (usa TeacherClassesPage)
  - TeacherAssignments.tsx (usa TeacherAssignmentsPage)
  - TeacherAnalytics.tsx (usa TeacherAnalyticsPage)
  - TeacherGamification.tsx (usa TeacherGamificationPage)
  - TeacherStudents.tsx (usa TeacherStudentsPage)
  - TeacherContentManagement.tsx (usa TeacherContentPage)
  - TeacherResourcesPage.tsx (REDIRECT en FASE 6A)
  - TeacherStudentsPage.tsx (legacy, funcionalidad en Monitoring)

---

3. CRITERIOS DE AUDITORIA

3.1 Por Cada Pagina Verificar

API_Integration:
  - [ ] Tiene hook(s) para consumir API
  - [ ] Hook llama endpoints reales (no mock data)
  - [ ] Maneja estados: loading, error, success
  - [ ] Tiene refresh/refetch capability

Database_Connection:
  - [ ] Datos vienen de endpoints backend
  - [ ] Backend tiene queries a BD implementadas
  - [ ] Datos se actualizan con acciones del usuario

Component_Functionality:
  - [ ] Todos los botones tienen handlers
  - [ ] Formularios tienen validacion
  - [ ] Modales abren/cierran correctamente
  - [ ] Tablas tienen sorting/filtering si aplica
  - [ ] Paginacion funciona si aplica

Dependencies:
  - [ ] Imports resuelven correctamente
  - [ ] Tipos estan definidos
  - [ ] Hooks exportan todas las funciones usadas
  - [ ] APIs tienen todos los endpoints necesarios

Student_Integration:
  - [ ] Acciones del estudiante actualizan datos
  - [ ] Progreso del estudiante se refleja
  - [ ] Estadisticas son calculadas correctamente

3.2 Clasificacion de Issues

CRITICO:
  - API no implementada (datos mock hardcoded)
  - Backend endpoint no existe
  - Componente crashea

ALTO:
  - Funcion no implementada (TODO en codigo)
  - Datos no se actualizan en tiempo real
  - Validaciones faltantes

MEDIO:
  - UI inconsistente
  - Performance issues
  - Falta paginacion

BAJO:
  - Mejoras de UX
  - Documentacion faltante
  - Estilos menores

---

4. ESTRATEGIA DE EJECUCION

4.1 FASE 2: Ejecucion de Analisis

Usar 4 subagentes en paralelo:

Agente_1_Admin_Core:
  paginas:
    - AdminDashboardPage
    - AdminUsersPage
    - AdminRolesPage
    - AdminInstitutionsPage
  foco: Gestion de usuarios y permisos

Agente_2_Admin_Operations:
  paginas:
    - AdminGamificationPage
    - AdminContentPage
    - AdminMonitoringPage
    - AdminAlertsPage
  foco: Operaciones y contenido

Agente_3_Admin_Analytics:
  paginas:
    - AdminAnalyticsPage
    - AdminProgressPage
    - AdminReportsPage
    - AdminSettingsPage
    - AdminAdvancedPage
    - AdminAssignmentsPage
    - AdminClassroomTeacherPage
  foco: Analitica y configuracion

Agente_4_Teacher_All:
  paginas:
    - TeacherDashboardPage
    - TeacherClassesPage
    - TeacherMonitoringPage
    - TeacherAssignmentsPage
    - TeacherExerciseResponsesPage
    - TeacherProgressPage
    - TeacherAlertsPage
    - TeacherReportsPage
    - TeacherGamificationPage
    - TeacherAnalyticsPage
  foco: Todo el portal Teacher

4.2 Formato de Reporte por Agente

Pagina: [NombrePagina]
Archivo: [ruta/archivo.tsx]
Hooks_Usados: [lista de hooks]
APIs_Consumidas: [lista de endpoints]
Estado_General: [COMPLETO | PARCIAL | MOCK | PLACEHOLDER]

Checklist:
  API_Integration:
    tiene_hook: [SI/NO]
    endpoints_reales: [SI/NO/PARCIAL]
    maneja_loading: [SI/NO]
    maneja_error: [SI/NO]
    tiene_refresh: [SI/NO]

  Components:
    botones_funcionales: [SI/NO/PARCIAL]
    formularios_validan: [SI/NO/NA]
    modales_funcionan: [SI/NO/NA]
    tablas_sorting: [SI/NO/NA]
    paginacion: [SI/NO/NA]

  Issues_Encontrados:
    - severity: [CRITICO|ALTO|MEDIO|BAJO]
      descripcion: [descripcion del issue]
      archivo: [archivo afectado]
      linea: [numero de linea si aplica]
      solucion_propuesta: [como corregirlo]

  Dependencies_Faltantes:
    - tipo: [HOOK|API|TYPE|COMPONENT]
      nombre: [nombre del objeto faltante]
      usado_en: [donde se usa]

---

5. HOOKS Y APIS A AUDITAR

5.1 Admin Hooks

Hook	Usado Por	Endpoints
useAdminDashboard	AdminDashboardPage	/admin/dashboard/*
useUserManagement	AdminUsersPage	/admin/users/*
useOrganizations	AdminInstitutionsPage	/admin/organizations/*
useRoles	AdminRolesPage	/admin/roles/*
useContentManagement	AdminContentPage	/admin/content/*
useGamificationConfig	AdminGamificationPage	/admin/gamification/*
useMonitoring	AdminMonitoringPage	/admin/monitoring/*
useAlerts	AdminAlertsPage	/admin/alerts/*
useAnalytics	AdminAnalyticsPage	/admin/analytics/*
useProgress	AdminProgressPage	/admin/progress/*
useReports	AdminReportsPage	/admin/reports/*
useSettings	AdminSettingsPage	/admin/settings/*
useFeatureFlags	AdminAdvancedPage	/admin/feature-flags/*
useAdminAssignments	AdminAssignmentsPage	/admin/assignments/*
useClassroomTeacher	AdminClassroomTeacherPage	/admin/classroom-teachers/*

5.2 Teacher Hooks

Hook	Usado Por	Endpoints
useTeacherDashboard	TeacherDashboardPage	/teacher/dashboard/*
useClassrooms	TeacherClassesPage	/classrooms/*
useStudentMonitoring	TeacherMonitoringPage	/teacher/monitoring/*
useAssignments	TeacherAssignmentsPage	/teacher/assignments/*
useExerciseResponses	TeacherExerciseResponsesPage	/teacher/responses/*
useStudentProgress	TeacherProgressPage	/progress/*
useInterventionAlerts	TeacherAlertsPage	/teacher/alerts/*
useAnalytics	TeacherAnalyticsPage	/teacher/analytics/*
useAchievementsStats	TeacherGamificationPage	/teacher/gamification/*

---

6. INTEGRACION CON STUDENT PORTAL

6.1 Flujos a Verificar

Ejercicios_Completados:
  student_action: Completar ejercicio
  expected_update:
    - Teacher: TeacherMonitoringPage (estudiante activo)
    - Teacher: TeacherProgressPage (progreso actualizado)
    - Teacher: TeacherExerciseResponsesPage (nueva respuesta)
    - Admin: AdminProgressPage (estadisticas)

Logros_Desbloqueados:
  student_action: Desbloquear achievement
  expected_update:
    - Teacher: TeacherGamificationPage (logros de clase)
    - Admin: AdminGamificationPage (estadisticas globales)

Compras_Tienda:
  student_action: Comprar item en tienda
  expected_update:
    - Teacher: TeacherGamificationPage (economia de clase)
    - Admin: AdminGamificationPage (transacciones)

Progreso_Modulo:
  student_action: Avanzar en modulo
  expected_update:
    - Teacher: TeacherProgressPage (progreso individual)
    - Teacher: TeacherMonitoringPage (estado actual)
    - Admin: AdminProgressPage (metricas agregadas)

---

7. ENTREGABLES POR FASE

FASE 2: Analisis

• 4 reportes de auditoria (1 por agente)
• Lista consolidada de issues encontrados
• Matriz de dependencias faltantes

FASE 3: Planeacion

• SPEC de correcciones priorizadas
• Estimacion de impacto por correccion
• Orden de implementacion

FASE 4: Validacion

• Verificacion de dependencias cruzadas
• Validacion de no regresiones
• Checklist de componentes afectados

FASE 5: Ejecucion

• Implementacion de correcciones CRITICAS
• Implementacion de correcciones ALTAS
• Verificacion post-implementacion

---

8. CRITERIOS DE EXITO

Minimo_Aceptable:
  - 0 issues CRITICOS sin resolver
  - 90% de APIs con endpoints reales
  - 100% de paginas sin crashes

Objetivo:
  - 0 issues CRITICOS y ALTOS
  - 100% de APIs con endpoints reales
  - Todas las paginas con datos de BD
  - Integracion Student verificada

---

Documento generado: 2025-12-15 Estado: LISTO PARA FASE 2