🎓 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

<EFBFBD> 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

<EFBFBD> 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 (package manager optimizado)
• Cuenta Supabase configurada
• Variables de entorno configuradas

Setup Rápido

# 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

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

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

---

<EFBFBD> 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

---

<EFBFBD> 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.