# 🎓 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 #### � **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 ### � **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 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 ``` --- ## � **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 --- ## � **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.*