La herramienta definitiva para estudiantes de Ingeniería USAC que te ayuda a planificar tu carrera de manera inteligente y eficiente.
Semestrix elimina el dolor de cabeza de organizar horarios, gestionar prerrequisitos y hacer seguimiento a tu progreso académico. Todo en una interfaz moderna y fácil de usar.
🎯 Planificación sin estrés
Organiza tus horarios con arrastrar y soltar, evitando automáticamente traslapes y considerando tiempos de traslado entre edificios del campus.
📊 Control total de tu progreso
Visualiza claramente cuántos créditos has completado, cuáles te faltan y tu proyección de graduación.
🔍 Inteligencia de prerrequisitos
El sistema analiza automáticamente qué cursos puedes inscribir cada semestre basándose en tu historial académico.
📱 Experiencia moderna
Interfaz responsive con modo oscuro/claro que se adapta a tus preferencias y dispositivo.
- Arrastrar y soltar: Organiza cursos de forma visual e intuitiva
- Detección de conflictos: Previene automáticamente traslapes de horarios
- Tiempo de traslado: Considera distancias entre edificios del campus
- Vista múltiple: Horarios por día, semana o vista general
- Contador de créditos: Suma automática de créditos cursados, aprobados y pendientes
- Progreso visual: Gráficos y barras de progreso para visualizar tu avance
- Proyección de graduación: Estima cuándo terminarás tu carrera
- Historial académico: Mantén registro completo de todos tus cursos
- Análisis automático: Evalúa tu historial para determinar elegibilidad
- Sugerencias inteligentes: Recomienda cursos óptimos para cada semestre
- Alertas tempranas: Te avisa sobre prerrequisitos que debes completar
- Planificación a futuro: Visualiza el camino hacia tu graduación
- Modo oscuro/claro: Se adapta automáticamente a tus preferencias del sistema
- Responsive design: Funciona perfectamente en móvil, tablet y desktop
- Exportación flexible: Descarga horarios en PDF o compártelos como imagen
- Sincronización en la nube: Accede a tus datos desde cualquier dispositivo
Frontend moderno
- React 18 + Vite: Desarrollo rápido con Hot Module Replacement
- TypeScript: Código más seguro y mantenible
- Tailwind CSS: Estilos utilitarios con soporte completo para dark mode
Backend confiable
- Firebase Authentication: Inicio de sesión seguro y sin fricciones
- Firestore: Base de datos NoSQL en tiempo real
- Firebase Hosting: Despliegue global y rápido
💡 Completamente gratuito: Utilizamos exclusivamente los servicios gratuitos de Firebase para mantener Semestrix accesible para todos los estudiantes.
¿Solo quieres usar Semestrix?
Visita directamente: semestrix.usac.edu.gt
No necesitas instalar nada. La aplicación funciona completamente en tu navegador con sincronización automática en la nube.
Para desarrolladores y contribuidores
- Node.js 18 o superior
- npm, yarn o pnpm
-
Clona el repositorio
git clone https://github.com/ricardious/semestrix.git cd semestrix -
Instala dependencias
npm install # o alternativamente: # yarn install # pnpm install
-
Configura variables de entorno
cp .env.example .env # Edita .env con tus credenciales de Firebase -
Inicia el servidor de desarrollo
npm run dev
-
Abre la aplicación
Navega a http://localhost:5173
| Comando | Descripción |
|---|---|
npm run dev |
Inicia servidor de desarrollo con hot reload |
npm run build |
Construye la aplicación para producción |
npm run preview |
Sirve la build de producción localmente |
npm run lint |
Ejecuta ESLint para revisar el código |
npm run lint:fix |
Corrige automáticamente problemas de linting |
npm run format |
Formatea el código con Prettier |
npm run test |
Ejecuta las pruebas unitarias |
npm run test:coverage |
Ejecuta pruebas con reporte de cobertura |
Política de datos transparente
Semestrix utiliza el plan gratuito de Firebase, lo que nos permite ofrecer el servicio sin costo. Para mantener la sostenibilidad:
- Retención: Las cuentas inactivas por más de 90 días serán eliminadas automáticamente
- Notificación: Recibirás un aviso por correo 7 días antes de la eliminación
- Reactivación: Simplemente inicia sesión para mantener tu cuenta activa
- Exportación: Siempre puedes exportar tus datos antes de la eliminación
Tu privacidad es importante: Solo almacenamos la información académica necesaria para el funcionamiento de la aplicación.
¡Tu ayuda es bienvenida!
-
Fork del proyecto
git fork https://github.com/ricardious/semestrix.git
-
Crea una rama para tu feature
git checkout -b feature/mi-nueva-funcionalidad
-
Sigue las convenciones
- Código: ESLint + Prettier configurados
- Commits: Conventional Commits (
feat:,fix:,docs:, etc.) - TypeScript: Tipado estricto habilitado
-
Pruebas
npm run test npm run lint -
Pull Request
- Descripción clara de los cambios
- Screenshots si afecta la UI
- Tests que cubran nuevas funcionalidades
- 🐛 Reportar bugs o problemas
- 💡 Sugerir nuevas funcionalidades
- 📖 Mejorar documentación
- 🌐 Agregar soporte para otras carreras
- 🎨 Mejorar el diseño y UX
Si Semestrix te ha sido útil, considera apoyar su desarrollo
Tu contribución ayuda a:
- Mantener los servidores funcionando
- Desarrollar nuevas funcionalidades
- Mejorar la experiencia de usuario
- Mantener el proyecto completamente gratuito
Otras formas de apoyar:
- ⭐ Dale una estrella al repositorio
- 🐦 Comparte Semestrix en redes sociales
- 📝 Escribe una reseña o testimonio
- 🤝 Recomienda la app a otros estudiantes
¿Necesitas ayuda o tienes sugerencias?
- 🐛 Reportar bugs: GitHub Issues
- 💬 Discusiones: GitHub Discussions
Este proyecto está licenciado bajo la Licencia MIT - ve el archivo LICENSE para más detalles.
MIT License - Puedes usar, modificar y distribuir libremente
Gracias a toda la comunidad que hace posible Semestrix:
- Los estudiantes de Ingeniería USAC que han probado y dado feedback
- La comunidad open source de herramientas que utilizamos
- Firebase por proporcionar infraestructura gratuita
Desarrollado con ❤️ para estudiantes de la USAC
"Porque tu tiempo es valioso y tu educación es importante"