- Configure workspace Git repository with comprehensive .gitignore - Add Odoo as submodule for ERP reference code - Include documentation: SETUP.md, GIT-STRUCTURE.md - Add gitignore templates for projects (backend, frontend, database) - Structure supports independent repos per project/subproject level Workspace includes: - core/ - Reusable patterns, modules, orchestration system - projects/ - Active projects (erp-suite, gamilit, trading-platform, etc.) - knowledge-base/ - Reference code and patterns (includes Odoo submodule) - devtools/ - Development tools and templates - customers/ - Client implementations template 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
93 lines
3.6 KiB
Markdown
93 lines
3.6 KiB
Markdown
# EAI-005: Administración y Escalabilidad
|
|
|
|
**Proyecto:** GAMILIT
|
|
**Versión:** 2.0 (RFC-0001)
|
|
**Última actualización:** 2025-11-24
|
|
**Estado:** ✅ Completada (Fase 1 - Mes 1)
|
|
|
|
---
|
|
|
|
## ⚠️ NOTA IMPORTANTE SOBRE IMPLEMENTACIÓN REAL (2025-11-24)
|
|
|
|
**Discrepancia Alcance vs Implementación:**
|
|
|
|
El alcance definido en este documento (EAI-005) describe funcionalidades básicas de gestión de aulas que fueron **implementadas en el Portal de Maestros** (`/teacher/*`), NO en el Portal Admin (`/admin/*`).
|
|
|
|
El **Portal de Administración** implementado (`/admin/*`) es un **sistema avanzado de Fase 2-3** que excede significativamente el alcance inicial documentado aquí. Incluye:
|
|
- Dashboard ejecutivo con métricas del sistema
|
|
- Gestión completa de usuarios y organizaciones (multi-tenant)
|
|
- Aprobación de contenido y moderación
|
|
- Configuración de gamificación
|
|
- Sistema de reportes y auditoría
|
|
- Monitoreo del sistema
|
|
|
|
**Para más detalles:**
|
|
- Ver: `docs/97-adr/ADR-017-admin-portal-avanzado-vs-alcance-inicial.md`
|
|
- Ver: `orchestration/agentes/architecture-analyst/analisis-portal-admin-alcances-2025-11-24/`
|
|
- Ver: `docs/90-transversal/inventarios/INVENTARIO-ADMIN-PORTAL-EXT-002.md`
|
|
|
|
**Funcionalidades de EAI-005 (este documento) implementadas en:**
|
|
- Portal de Maestros: `/teacher/classrooms/*` (US-ADM-001, US-ADM-002, US-ADM-004)
|
|
- Portal Admin: Dashboard de actividad (US-ADM-007 parcial)
|
|
|
|
Este documento se mantiene como referencia histórica del **alcance inicial planeado**.
|
|
|
|
---
|
|
|
|
## 📋 Información de la Épica
|
|
|
|
| Atributo | Valor |
|
|
|----------|-------|
|
|
| **Código** | EAI-005 |
|
|
| **Fase** | Alcance Inicial |
|
|
| **Presupuesto** | $16,800 MXN |
|
|
| **Story Points** | 42 SP |
|
|
| **User Stories** | 6 historias (US-ADM-001, US-ADM-002, US-ADM-004, US-ADM-005, US-ADM-006, US-ADM-007) |
|
|
| **Sprint** | Mes 1 (Semanas 1-4) |
|
|
| **Estado** | ✅ Completada |
|
|
|
|
**NOTA IMPORTANTE:** US-ADM-003 (Dashboard Maestro) fue reclasificada y movida a EXT-001 como US-PM-000, ya que pertenece al alcance v2 (Portal Maestros) y no al alcance inicial v1.
|
|
|
|
---
|
|
|
|
## 🎯 Objetivo
|
|
|
|
Crear la infraestructura administrativa y de escalabilidad que permite a educadores y administradores gestionar efectivamente el sistema GAMILIT. Esta épica proporciona herramientas de configuración, gestión de usuarios y validación de calidad para asegurar una plataforma robusta y confiable.
|
|
|
|
---
|
|
|
|
## 📦 Módulos Incluidos (Alcance v1)
|
|
|
|
- **Gestión de Aulas Básica (CRUD)**: Creación y gestión básica de classrooms/aulas virtuales (sin maestros)
|
|
- **Gestión de Estudiantes en Aulas**: Inscripción y gestión de estudiantes dentro de aulas
|
|
- **Asignación de Módulos**: Asignación de módulos educativos a aulas
|
|
- **Configuración Básica de Aulas**: Ajustes básicos de configuración por aula
|
|
- **Vista de Actividad de Aula**: Monitoreo de actividad reciente de estudiantes
|
|
|
|
**NOTA v1:** En el alcance inicial, las aulas NO tienen maestros asignados. Los grupos existen pero son gestionados por el super admin. La funcionalidad de Portal Maestros (asignación de maestros a aulas, dashboard de maestros, etc.) pertenece al alcance v2 (EXT-001).
|
|
|
|
---
|
|
|
|
## 📁 Estructura
|
|
|
|
```
|
|
EAI-005-admin-base/
|
|
├── README.md (este archivo)
|
|
├── historias/ (User stories)
|
|
├── documentacion/ (Docs técnicas si aplica)
|
|
└── criterios-aceptacion.md
|
|
```
|
|
|
|
---
|
|
|
|
## 🔗 Referencias
|
|
|
|
- **Alcance inicial:** Ver `/docs-analysis/.../ANALISIS-ALCANCE-Y-COSTOS.md`
|
|
- **Roadmap:** Ver `../roadmap/ROADMAP-GENERAL.md`
|
|
- **Métricas:** Ver `../metricas/`
|
|
|
|
---
|
|
|
|
**Última actualización:** 2025-11-02
|
|
**Generado por:** HERMES (Agente Principal)
|