rckrdmrd/workspace
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
e13c709cab
workspace/projects/gamilit/orchestration/analisis/ANALISIS-REDEFINICION-PORTALES-2025-12.md
rckrdmrd 608e1e2a2e
Some checks are pending
CI Pipeline / changes (push) Waiting to run
Details
CI Pipeline / core (push) Blocked by required conditions
Details
CI Pipeline / trading-backend (push) Blocked by required conditions
Details
CI Pipeline / trading-data-service (push) Blocked by required conditions
Details
CI Pipeline / trading-frontend (push) Blocked by required conditions
Details
CI Pipeline / erp-core (push) Blocked by required conditions
Details
CI Pipeline / erp-mecanicas (push) Blocked by required conditions
Details
CI Pipeline / gamilit-backend (push) Blocked by required conditions
Details
CI Pipeline / gamilit-frontend (push) Blocked by required conditions
Details
Multi-project update: gamilit, orchestration, trading-platform 
Gamilit:
- Backend: Teacher services, assignments, gamification, exercise submissions
- Frontend: Admin/Teacher/Student portals, module 4-5 mechanics, monitoring
- Database: DDL functions, seeds for dev/prod, auth/gamification schemas
- Docs: Architecture, features, guides cleanup and reorganization

Core/Orchestration:
- New workspace directives index
- Documentation directive

Trading-platform:
- Database seeds and inventory updates
- Tech leader validation report

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-18 07:17:46 -06:00

396 lines
13 KiB
Markdown
Raw Blame History

# ANALISIS DE REDEFINICION DE PORTALES - GAMILIT
**Version:** 2.0
**Fecha:** 2025-12-15
**Autor:** Requirements-Analyst Agent
**Estado:** FASE 3 - PLANEACION DE IMPLEMENTACION
---
## RESUMEN EJECUTIVO
Este documento consolida el analisis detallado para redefinir los alcances, paginas y desarrollos de la plataforma Gamilit, con enfasis en los portales de **Teacher** y **Admin**.
### Hallazgos Principales
```yaml
Portal_Teacher:
paginas_actuales: 15
paginas_propuestas: 8
reduccion: 47%
problemas_detectados:
- TeacherStudents REDUNDANTE con Dashboard > Monitoring tab
- TeacherAnalytics REDUNDANTE con TeacherProgress
- TeacherCommunication BLOQUEADA por feature flag
- TeacherResources ES STUB sin implementacion
- TeacherContent BLOQUEADA por feature flag
Portal_Admin:
paginas_actuales: 15 (11 en sidebar + 4 ocultas)
paginas_propuestas: 10
reduccion: 33%
problemas_detectados:
- Estructura solida pero algunas rutas ocultas
- AdminAdvanced parcialmente implementada
- Classroom-Teachers puede integrarse en Usuarios
```
---
## FASE 2: RESULTADOS DEL ANALISIS DETALLADO
### 2.1 PORTAL TEACHER - ANALISIS COMPLETO
#### BLOQUE 1: PAGINAS CORE
| Pagina | Estado | Datos | Solapamiento | Recomendacion |
|--------|--------|-------|--------------|---------------|
| **TeacherDashboard** | COMPLETO | Reales | Hub con 10 tabs integradas | MANTENER |
| **TeacherClasses** | COMPLETO | Reales | CRUD unico - complementario | MANTENER |
| **TeacherStudents** | COMPLETO | Reales | CRITICO con Dashboard>Monitoring | ELIMINAR |
**Detalle TeacherDashboard:**
- Contiene 10 pestanas: Vista General, Monitoreo, Asignaciones, Progreso, Alertas, Analiticas, Insights, Reportes, Comunicacion, Recursos
- Ya integra StudentMonitoringPanel que hace lo mismo que TeacherStudents
- Es el hub central que deberia mantenerse
**Detalle TeacherStudents:**
- Tabla global de TODOS los estudiantes de todas las clases
- Funcionalidad ya existe en Dashboard > tab "monitoring"
- La unica diferencia es vista agregada vs por clase
- **DECISION:** Eliminar como pagina independiente
#### BLOQUE 2: PAGINAS PEDAGOGICAS
| Pagina | Estado | Datos | Solapamiento | Recomendacion |
|--------|--------|-------|--------------|---------------|
| **TeacherExerciseResponses** | COMPLETO | Reales | Analisis automatico - unico | MANTENER |
| **ReviewPanel** | COMPLETO | Reales | Revision manual M3-M5 - unico | MANTENER |
| **TeacherAssignments** | COMPLETO | Reales | Wizard CRUD tareas - unico | MANTENER |
| **TeacherContent** | PARCIAL | Bloqueado | Feature flag activo | DEPRIORITIZAR |
**Detalle TeacherContent:**
- Bloqueada por SHOW_UNDER_CONSTRUCTION=true
- La logica existe pero esta deshabilitada deliberadamente
- Usar cuando se requiera creacion de contenido personalizado
#### BLOQUE 3: PAGINAS ANALYTICS
| Pagina | Estado | Datos | Solapamiento | Recomendacion |
|--------|--------|-------|--------------|---------------|
| **TeacherProgress** | COMPLETO | Reales | Stats, modulos, exportacion | MANTENER |
| **TeacherAnalytics** | COMPLETO | Reales | ALTO con Progress | FUSIONAR |
| **TeacherReports** | PARCIAL | Mixtos | Exportacion unica | MANTENER |
| **TeacherAlerts** | COMPLETO | Reales | Sistema alertas unico | MANTENER |
| **TeacherMonitoring** | COMPLETO | Reales | Real-time unico | MANTENER |
**Detalle solapamiento Progress vs Analytics:**
- Progress: Progreso academico, estudiantes rezagados, modulos
- Analytics: Puntuacion, engagement, graficos temporales
- **DECISION:** Fusionar Analytics INTO Progress como tab adicional "Engagement"
#### BLOQUE 4: PAGINAS SECUNDARIAS
| Pagina | Estado | Datos | Esencial | Recomendacion |
|--------|--------|-------|----------|---------------|
| **TeacherCommunication** | PARCIAL | Bloqueado | No | ELIMINAR (Fase 2+) |
| **TeacherResources** | STUB | Mock | No | ELIMINAR |
| **TeacherGamification** | COMPLETO | Reales | Si | MANTENER |
**Detalle TeacherCommunication:**
- Completa en codigo pero bloqueada por feature flag
- Descartada para Fase 2 segun comentarios
- Conservar codigo para futuras fases
**Detalle TeacherResources:**
- Solo placeholder "Under Construction"
- Sin implementacion real
- Eliminar del sidebar hasta que se implemente
---
### 2.2 PORTAL ADMIN - ANALISIS COMPLETO
| Pagina | Estado | Datos | Diferencia vs Teacher | Recomendacion |
|--------|--------|-------|----------------------|---------------|
| **AdminDashboard** | COMPLETO | Reales | Sistema global vs aulas | MANTENER |
| **AdminUsers** | COMPLETO | Reales | Todos usuarios vs solo alumnos | MANTENER |
| **AdminInstitutions** | COMPLETO | Reales | Solo Admin | MANTENER |
| **AdminRoles** | COMPLETO | Reales | Solo Admin | MANTENER |
| **AdminContent** | COMPLETO | Reales | Moderacion global | MANTENER |
| **AdminGamification** | COMPLETO | Reales | Configuracion global | MANTENER |
| **AdminMonitoring** | COMPLETO | Reales | Logs sistema global | MANTENER |
| **AdminAlerts** | COMPLETO | Reales | Alertas sistema global | MANTENER |
| **AdminReports** | COMPLETO | Mixtos | Reportes admin | MANTENER |
| **AdminSettings** | PARCIAL | Mixtos | Solo Admin | MANTENER |
| **AdminClassroomTeacher** | COMPLETO | Reales | Asignacion bidireccional | EVALUAR |
| **AdminAnalytics** | COMPLETO | Reales | Analytics global | MANTENER (no en sidebar) |
| **AdminProgress** | COMPLETO | Reales | Progreso global | MANTENER (no en sidebar) |
| **AdminAssignments** | COMPLETO | Reales | Tareas global | MANTENER (no en sidebar) |
| **AdminAdvanced** | PARCIAL | Reales | Feature flags, A/B tests | MANTENER (oculto) |
**Observaciones Portal Admin:**
- Estructura mas solida que Teacher
- Paginas ocultas del sidebar pero funcionales via rutas
- AdminClassroomTeacher podria integrarse en AdminUsers
---
## FASE 3: PLAN DE IMPLEMENTACION
### 3.1 PROPUESTA NUEVA ESTRUCTURA - PORTAL TEACHER
```yaml
NAVEGACION_PROPUESTA:
seccion_principal:
- Dashboard: /teacher/dashboard # Hub central con tabs
- Mis Aulas: /teacher/classes # CRUD aulas
seccion_pedagogica:
- Asignaciones: /teacher/assignments # Crear/gestionar tareas
- Respuestas: /teacher/responses # Analisis automatico
- Revisiones: /teacher/reviews # Revision manual M3-M5
seccion_analitica:
- Progreso: /teacher/progress # Stats + Engagement (fusionado)
- Alertas: /teacher/alerts # Sistema alertas
- Monitoreo: /teacher/monitoring # Real-time
seccion_gamificacion:
- Gamificacion: /teacher/gamification # ML Coins, logros, bonus
PAGINAS_A_ELIMINAR:
- TeacherStudents: Funcionalidad en Dashboard > Monitoring
- TeacherAnalytics: Fusionar con Progress
- TeacherCommunication: Bloqueada, no en sidebar
- TeacherResources: Stub sin implementacion
- TeacherContent: Bloqueada, no en sidebar
PAGINAS_A_FUSIONAR:
- TeacherAnalytics -> TeacherProgress (agregar tab "Engagement")
TOTAL: 15 -> 8 paginas (reduccion 47%)
```
### 3.2 PROPUESTA NUEVA ESTRUCTURA - PORTAL ADMIN
```yaml
NAVEGACION_PROPUESTA:
seccion_organizacion:
- Dashboard: /admin/dashboard # Hub central
- Instituciones: /admin/institutions # CRUD escuelas
- Usuarios: /admin/users # Gestion usuarios
- Roles: /admin/roles # RBAC
seccion_contenido:
- Contenido: /admin/content # Moderacion
- Gamificacion: /admin/gamification # Configuracion global
seccion_sistema:
- Monitoreo: /admin/monitoring # Logs + Alertas (fusionado)
- Reportes: /admin/reports # Generacion
- Configuracion: /admin/settings # System settings
rutas_auxiliares: # No en sidebar, accesibles via Dashboard
- /admin/analytics
- /admin/progress
- /admin/assignments
- /admin/classroom-teachers
- /admin/advanced
PAGINAS_A_FUSIONAR:
- AdminAlerts -> AdminMonitoring (como tab adicional)
TOTAL: 11 -> 9 en sidebar (reduccion 18%)
```
---
### 3.3 LISTA DE CAMBIOS REQUERIDOS
```yaml
TEACHER_PORTAL:
ELIMINAR_DEL_SIDEBAR:
1. item: "Estudiantes"
path: "/teacher/students"
componente: "TeacherStudentsPage"
accion: "Remover del array teacherItems en GamilitSidebar.tsx"
2. item: "Analiticas"
path: "/teacher/analytics"
componente: "TeacherAnalyticsPage"
accion: "Remover del array teacherItems, fusionar con Progress"
3. item: "Comunicacion"
path: "/teacher/communication"
componente: "TeacherCommunicationPage"
accion: "Remover del array teacherItems"
4. item: "Contenido"
path: "/teacher/content"
componente: "TeacherContentPage"
accion: "Remover del array teacherItems"
5. item: "Recursos"
path: "/teacher/resources"
componente: "TeacherResourcesPage"
accion: "Remover del array teacherItems"
MANTENER_RUTAS_SIN_SIDEBAR:
- /teacher/students: Redirigir a /teacher/dashboard#monitoring
- /teacher/analytics: Redirigir a /teacher/progress#engagement
- /teacher/communication: Mantener para futura fase
- /teacher/content: Mantener para futura fase
FUSIONAR:
- TeacherAnalytics engagement data -> TeacherProgress
- Agregar tab "Engagement" a TeacherProgressPage
ADMIN_PORTAL:
FUSIONAR:
- AdminAlerts -> AdminMonitoring como tab "Alertas"
REMOVER_DEL_SIDEBAR:
1. item: "Alertas"
path: "/admin/alerts"
accion: "Remover, integrar en Monitoreo"
2. item: "Classrooms-Teachers"
path: "/admin/classroom-teachers"
accion: "Mover a acceso desde AdminUsers"
```
---
### 3.4 ARCHIVOS A MODIFICAR
```yaml
SIDEBAR_NAVIGATION:
archivo: "/home/isem/workspace/projects/gamilit/apps/frontend/src/shared/components/layout/GamilitSidebar.tsx"
cambios:
- Linea 192-276: Modificar teacherItems array
- Linea 279-351: Modificar adminItems array
ROUTER:
archivo: "/home/isem/workspace/projects/gamilit/apps/frontend/src/App.tsx"
cambios:
- Agregar redirects para rutas eliminadas
- Mantener rutas pero sin navegacion directa
TEACHER_PROGRESS_PAGE:
archivo: "/home/isem/workspace/projects/gamilit/apps/frontend/src/apps/teacher/pages/TeacherProgressPage.tsx"
cambios:
- Importar componentes de TeacherAnalytics
- Agregar tab "Engagement" con metricas de engagement
ADMIN_MONITORING_PAGE:
archivo: "/home/isem/workspace/projects/gamilit/apps/frontend/src/apps/admin/pages/AdminMonitoringPage.tsx"
cambios:
- Importar componentes de AdminAlerts
- Agregar tab "Alertas" con funcionalidad completa
```
---
## FASE 4: VALIDACION (PENDIENTE)
### 4.1 MATRIZ DE DEPENDENCIAS A VALIDAR
```yaml
TeacherStudents_Dependencias:
importado_por:
- App.tsx (ruta)
- GamilitSidebar.tsx (navegacion)
componentes_usados:
- TeacherLayout
- TeacherStudents (interno)
- useClassrooms
endpoints:
- GET /teacher/classrooms
- GET /teacher/classrooms/:id/students
impacto: BAJO - Funcionalidad existe en Dashboard
TeacherAnalytics_Dependencias:
importado_por:
- App.tsx (ruta)
- GamilitSidebar.tsx (navegacion)
componentes_usados:
- TeacherLayout
- TeacherAnalytics (interno)
- useAnalytics
- useClassrooms
endpoints:
- GET /teacher/analytics
- GET /teacher/analytics/engagement
impacto: MEDIO - Mover engagement a Progress
AdminAlerts_Dependencias:
importado_por:
- App.tsx (ruta)
- GamilitSidebar.tsx (navegacion)
componentes_usados:
- AdminLayout
- useAlerts
- AlertsStats, AlertFilters, AlertsList
endpoints:
- 7 endpoints de alertas
impacto: MEDIO - Integrar en Monitoring
```
### 4.2 CHECKLIST DE VALIDACION
```yaml
PRE_IMPLEMENTACION:
- [ ] Verificar que Dashboard tiene todas las funcionalidades de Students
- [ ] Verificar que Progress puede absorber Analytics engagement
- [ ] Verificar que Monitoring puede absorber Alerts
- [ ] Revisar tests existentes para paginas a eliminar
- [ ] Documentar cambios en rutas para usuarios
POST_IMPLEMENTACION:
- [ ] Sidebar muestra solo paginas definidas
- [ ] Rutas antiguas redirigen correctamente
- [ ] Funcionalidad fusionada es accesible
- [ ] No hay enlaces rotos
- [ ] Tests pasan
```
---
## PROXIMOS PASOS
1. **FASE 4 - Validacion:** Ejecutar checklist de pre-implementacion
2. **FASE 5 - Ejecucion:** Implementar cambios en orden:
- Primero: Sidebar (bajo riesgo)
- Segundo: Fusiones (medio riesgo)
- Tercero: Redirects (bajo riesgo)
3. **Testing:** Validar flujos de usuario
4. **Documentacion:** Actualizar guias de usuario
---
## RESUMEN DE DECISION
| Portal | Paginas Actuales | Propuestas | Accion Principal |
|--------|------------------|------------|------------------|
| Student | ~15 | ~15 | Sin cambios |
| Teacher | 15 | 8 | Eliminar 5, fusionar 2 |
| Admin | 15 | 10 | Fusionar 1, reorganizar 4 |
**Beneficios esperados:**
- Navegacion simplificada para maestros
- Menor confusio entre paginas similares
- Mantenimiento mas facil del codigo
- UX mas enfocada en tareas principales
---
**Documento generado:** 2025-12-15
**Por:** Requirements-Analyst Agent
**Estado:** LISTO PARA VALIDACION (FASE 4)
Reference in New Issue View Git Blame Copy Permalink