263 lines
9.7 KiB
Markdown
263 lines
9.7 KiB
Markdown
# 🎓 Academic Management Platform - Sistema Universitario Inteligente
|
||
|
||
**Una plataforma integral de gestión académica universitaria con inteligencia artificial integrada, diseñada para modernizar y optimizar la administración educativa superior.**
|
||
|
||
---
|
||
|
||
## 🚀 **¿Qué hace esta aplicación?**
|
||
|
||
Esta es una **plataforma completa de gestión académica universitaria** que automatiza y digitaliza todos los procesos de administración educativa, desde la planificación curricular hasta la gestión de contenidos académicos, con **inteligencia artificial integrada** para optimizar la creación y mejora de planes de estudio.
|
||
|
||
### 🎯 **Capacidades Principales**
|
||
|
||
#### 📋 **Gestión Curricular Avanzada**
|
||
- **Planes de Estudio Inteligentes**: Creación, edición y gestión completa de planes curriculares
|
||
- **Generación con IA**: Creación automática de planes de estudio mediante prompts de IA
|
||
- **Ajustes Inteligentes**: Mejoras y modificaciones de planes existentes usando IA
|
||
- **Métricas de Calidad**: Análisis automático de completitud y calidad de planes académicos
|
||
|
||
#### 🏫 **Estructura Organizacional Completa**
|
||
- **Facultades**: Gestión de facultades con colores e iconos personalizados
|
||
- **Carreras**: Administración de programas académicos por facultad
|
||
- **Planes de Estudio**: Vinculación jerárquica de planes con carreras y facultades
|
||
- **Jerarquía Completa**: Navegación fluida entre todos los niveles organizacionales
|
||
|
||
#### 📚 **Gestión de Asignaturas Detallada**
|
||
- **Información Completa**: Nombre, clave, tipo, semestre, créditos, horas teóricas/prácticas
|
||
- **Contenidos Estructurados**: Gestión de contenidos temáticos organizados por unidades
|
||
- **Bibliografía Dinámica**: Listas de referencias bibliográficas editables
|
||
- **Criterios de Evaluación**: Definición de métodos y criterios de evaluación
|
||
- **Objetivos Académicos**: Gestión de objetivos de aprendizaje por asignatura
|
||
|
||
#### <20> **Sistema de Usuarios Multi-Rol**
|
||
- **Roles Jerárquicos**: LCI, Vicerrectoría, Director de Facultad, Secretario Académico, Jefe de Carrera, Planeación
|
||
- **Permisos Granulares**: Acceso controlado según rol y nivel organizacional
|
||
- **Nombramientos**: Sistema de asignación de cargos administrativos
|
||
- **Autenticación Segura**: Integración completa con Supabase Auth
|
||
|
||
#### 📊 **Dashboard Ejecutivo con Métricas**
|
||
- **KPIs Institucionales**: Contadores de facultades, carreras, planes y asignaturas
|
||
- **Indicadores de Calidad**: Porcentajes de completitud de planes de estudio
|
||
- **Salud Académica**: Métricas de asignaturas sin bibliografía, criterios o contenidos
|
||
- **Actividad Reciente**: Timeline de planes y asignaturas creados recientemente
|
||
|
||
#### 📁 **Gestión de Archivos de Referencia**
|
||
- **Biblioteca Digital**: Repositorio de documentos académicos de referencia
|
||
- **Integración Curricular**: Vinculación de archivos con planes y asignaturas
|
||
|
||
---
|
||
|
||
## 🔥 **El Verdadero Poder de la Plataforma**
|
||
|
||
### 🤖 **Inteligencia Artificial Integrada**
|
||
- **Generación Automática**: Crea planes de estudio completos desde cero usando IA
|
||
- **Optimización Inteligente**: Mejora planes existentes con sugerencias de IA
|
||
- **Asistente de Contenidos**: Ayuda en la creación de contenidos y criterios académicos
|
||
|
||
### <20> **Analytics y Calidad Académica**
|
||
- **Métricas de Completitud**: Evaluación automática de la calidad de planes académicos
|
||
- **Indicadores de Salud**: Monitoreo de la completitud de asignaturas
|
||
- **Dashboards Ejecutivos**: Visualización de KPIs para toma de decisiones
|
||
|
||
### 🔄 **Flujos de Trabajo Inteligentes**
|
||
- **Navegación Contextual**: Acceso directo entre elementos relacionados
|
||
- **Búsquedas Avanzadas**: Filtrado por facultad, carrera, plan o asignatura
|
||
- **Edición en Contexto**: Modificación inline de elementos académicos
|
||
|
||
### 🎨 **Experiencia de Usuario Premium**
|
||
- **Interfaz Moderna**: Diseño con Tailwind CSS y componentes Radix UI
|
||
- **Temas Personalizables**: Modo claro/oscuro con persistencia
|
||
- **Responsive Design**: Funciona perfectamente en móviles y escritorio
|
||
- **Efectos Visuales**: Animaciones y efectos (Aurora, confetti) para mejor UX
|
||
|
||
---
|
||
|
||
## 🛠️ **Stack Tecnológico Avanzado**
|
||
|
||
### **Frontend & UI**
|
||
- **React 19** con TypeScript para máximo rendimiento
|
||
- **TanStack Router** para routing type-safe y code-splitting
|
||
- **TanStack Query** para gestión de estado servidor optimizada
|
||
- **Tailwind CSS v4** para styling moderno y eficiente
|
||
- **Radix UI + shadcn/ui** para componentes accesibles y consistentes
|
||
|
||
### **Backend & Base de Datos**
|
||
- **Supabase** como backend-as-a-service completo
|
||
- **PostgreSQL** con Row Level Security para datos seguros
|
||
- **Realtime subscriptions** para actualizaciones en tiempo real
|
||
- **Funciones serverless** para lógica de negocio
|
||
|
||
### **Inteligencia Artificial**
|
||
- **API de IA propia** para generación y mejora de contenidos
|
||
- **Integración seamless** con el flujo de trabajo académico
|
||
|
||
### **Herramientas de Desarrollo**
|
||
- **Vite** para desarrollo ultra-rápido y HMR
|
||
- **Bun** como package manager y runtime optimizado
|
||
- **Vitest** para testing unitario y de integración
|
||
- **TypeScript** para type safety completo
|
||
|
||
---
|
||
|
||
## 📊 **Arquitectura de Base de Datos**
|
||
|
||
### **Entidades Principales**
|
||
- **`facultades`**: Gestión de facultades universitarias
|
||
- **`carreras`**: Programas académicos por facultad
|
||
- **`plan_estudios`**: Planes curriculares con metadatos completos
|
||
- **`asignaturas`**: Materias con contenidos, bibliografía y criterios
|
||
- **`usuarios`**: Sistema de usuarios con roles jerárquicos
|
||
- **`nombramientos`**: Asignaciones de cargos administrativos
|
||
- **`criterios_carrera`**: Criterios específicos por programa
|
||
- **`archivos_referencia`**: Biblioteca digital institucional
|
||
|
||
### **Relaciones Jerárquicas**
|
||
```
|
||
Facultades → Carreras → Planes de Estudio → Asignaturas
|
||
↓ ↓ ↓ ↓
|
||
Usuarios → Nombramientos → Criterios → Contenidos
|
||
```
|
||
|
||
---
|
||
|
||
## 🚀 **Instalación y Configuración**
|
||
|
||
### **Prerequisitos**
|
||
- Node.js 18+ (recomendado 20+)
|
||
- [Bun](https://bun.sh/) (package manager optimizado)
|
||
- Cuenta [Supabase](https://supabase.com/) configurada
|
||
- Variables de entorno configuradas
|
||
|
||
### **Setup Rápido**
|
||
```bash
|
||
# Clonar repositorio
|
||
git clone <url-del-repositorio>
|
||
cd tanstack-router
|
||
|
||
# Instalar dependencias
|
||
bun install
|
||
|
||
# Configurar variables de entorno
|
||
cp .env.example .env.local
|
||
# Editar .env.local con tus credenciales de Supabase
|
||
|
||
# Ejecutar en desarrollo
|
||
bun dev
|
||
```
|
||
|
||
### **Variables de Entorno Requeridas**
|
||
```env
|
||
VITE_SUPABASE_URL=tu_supabase_project_url
|
||
VITE_SUPABASE_ANON_KEY=tu_supabase_anon_key
|
||
VITE_API_BASE=tu_backend_api_url
|
||
VITE_BACK_ORIGIN=tu_ia_service_url
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 **Scripts Disponibles**
|
||
|
||
```bash
|
||
bun dev # Servidor de desarrollo (puerto 3000)
|
||
bun build # Build de producción optimizado
|
||
bun serve # Preview del build de producción
|
||
bun test # Ejecutar suite de tests
|
||
```
|
||
|
||
---
|
||
|
||
## <20> **Casos de Uso Principales**
|
||
|
||
### **Para Administradores Académicos**
|
||
- Crear y gestionar estructura organizacional completa
|
||
- Monitorear calidad académica mediante métricas automatizadas
|
||
- Generar reportes ejecutivos de estado institucional
|
||
|
||
### **Para Coordinadores Curriculares**
|
||
- Diseñar planes de estudio con asistencia de IA
|
||
- Gestionar contenidos académicos de manera eficiente
|
||
- Mantener actualizados criterios y bibliografías
|
||
|
||
### **Para Directivos Institucionales**
|
||
- Acceder a dashboards ejecutivos con KPIs en tiempo real
|
||
- Supervisar calidad y completitud académica
|
||
- Tomar decisiones basadas en datos concretos
|
||
|
||
---
|
||
|
||
## <20> **Seguridad y Roles**
|
||
|
||
### **Roles del Sistema**
|
||
- **`lci`**: Acceso global a toda la plataforma
|
||
- **`vicerrectoria`**: Supervisión académica institucional
|
||
- **`director_facultad`**: Gestión de facultad específica
|
||
- **`secretario_academico`**: Administración académica
|
||
- **`jefe_carrera`**: Gestión de carrera específica
|
||
- **`planeacion`**: Planificación curricular
|
||
|
||
### **Seguridad Implementada**
|
||
- Row Level Security (RLS) en Supabase
|
||
- Autenticación JWT con refresh tokens
|
||
- Permisos granulares por rol y contexto
|
||
- Validación de datos tanto cliente como servidor
|
||
|
||
---
|
||
|
||
## 🌟 **Características Avanzadas**
|
||
|
||
### **Performance & UX**
|
||
- Code splitting automático por ruta
|
||
- Lazy loading de componentes pesados
|
||
- Cache inteligente con TanStack Query
|
||
- Optimistic updates para mejor responsividad
|
||
|
||
### **Accesibilidad**
|
||
- Componentes Radix UI totalmente accesibles
|
||
- Navegación por teclado completa
|
||
- Soporte para lectores de pantalla
|
||
- Contraste optimizado en ambos temas
|
||
|
||
### **Internacionalización**
|
||
- Interfaz completamente en español
|
||
- Formatos de fecha y número localizados
|
||
- Soporte para múltiples idiomas preparado
|
||
|
||
---
|
||
|
||
## 🤝 **Contribución y Desarrollo**
|
||
|
||
### **Guías de Contribución**
|
||
1. Fork del repositorio
|
||
2. Crear branch descriptivo (`feature/nueva-funcionalidad`)
|
||
3. Commits semánticos con scope claro
|
||
4. Tests para nuevas funcionalidades
|
||
5. Pull Request con descripción detallada
|
||
|
||
### **Estándares de Código**
|
||
- TypeScript strict mode
|
||
- ESLint y Prettier configurados
|
||
- Convenciones de naming consistentes
|
||
- Documentación JSDoc para funciones complejas
|
||
|
||
---
|
||
|
||
## 📄 **Licencia**
|
||
|
||
MIT License - Ver archivo `LICENSE` para detalles completos.
|
||
|
||
---
|
||
|
||
## 🎯 **Roadmap y Futuro**
|
||
|
||
- [ ] **Mobile App**: Aplicación nativa con React Native
|
||
- [ ] **Reportes Avanzados**: PDFs automáticos de planes de estudio
|
||
- [ ] **Integración LMS**: Conexión con plataformas educativas
|
||
- [ ] **Analytics Predictivos**: ML para predicción de rendimiento
|
||
- [ ] **API Pública**: REST API para integraciones externas
|
||
|
||
---
|
||
|
||
**🏆 Una plataforma que transforma la gestión académica universitaria mediante tecnología moderna e inteligencia artificial.**
|
||
|
||
*Desarrollado con pasión por la educación superior y la innovación tecnológica.*
|