Skip to content

MyCSW/MyCS_FrontEnd

MyCSW – Frontend (React)

MyCSW es un sistema web académico para la gestión de eventos, inscripciones, pagos y certificados, desarrollado en equipo como parte del Proyecto Integrador del 2do Parcial.
Su propósito es permitir que administradores, organizadores y participantes gestionen de forma eficiente todo el ciclo de los eventos desde una interfaz moderna y responsiva.


🚀 Tecnologías principales

  • React (Vite) – Framework principal para la interfaz.
  • Tailwind CSS – Framework de estilos utilitario.
  • React Router – Sistema de enrutamiento.
  • Axios – Conexión con la API del backend (NestJS).
  • React Toastify – Notificaciones y mensajes.
  • Recharts – Gráficos y visualizaciones.
  • Framer Motion – Animaciones y transiciones.
  • GitHub Actions – Automatización de CI/CD.

📁 Estructura del proyecto


src/
│
├── assets/           # Recursos estáticos (imágenes, íconos)
├── components/       # Componentes reutilizables (formularios, tablas, modales)
├── pages/            # Páginas principales (Home, Login, Dashboard, etc.)
├── context/          # Contextos globales (auth, estado general)
├── services/         # Conexiones a la API (Axios)
├── styles/           # Archivos de estilo globales
└── main.jsx          # Punto de entrada de la aplicación


⚙️ Instalación y ejecución

1. Clonar el repositorio

git clone https://github.com/MyCSW/MyCS_FrontEnd.git
cd MyCS_FrontEnd

2. Instalar dependencias

npm install

3. Ejecutar en modo desarrollo

npm run dev

4. Crear build de producción

npm run build

5. Ejecutar linters o formato

npm run lint
npm run format

🔐 Roles del sistema

  • Admin: Gestiona organizadores y contenido del landing page.

  • Organizador: Crea y administra eventos, inscripciones, asistencia y notas.

  • Participante: Se inscribe, carga comprobantes, consulta certificados y reportes.


🧩 Módulos principales (frontend)

Público

  • Home / Landing
  • Catálogo de eventos (lista + filtros + búsqueda)
  • Detalle de evento
  • Página de login y registro

Autenticado – Participante

  • Perfil (editar datos personales)
  • Mis inscripciones (seguimiento de estado)
  • Wizard inscripción/pago (flujo guiado con comprobante)
  • Mis certificados (descarga y visualización)

Autenticado – Admin

  • Gestión de Organizadores (crear, editar, activar/desactivar)
  • Constructor de Landing (imágenes, textos, secciones, meta/SEO)

Autenticado – Organizador

  • Dashboard con métricas
  • Gestión de Eventos (CRUD)
  • Inscripciones (aprobación/rechazo)
  • Asistencia y Notas
  • Reportes y Certificados

🧠 Buenas prácticas

  • Estructura modular y reutilizable.
  • Componentes en PascalCase; funciones y variables en camelCase.
  • Linter activo (ESLint + Prettier) para mantener el formato.
  • PRs revisados por el reviewer del área (Maria Belen).
  • Cambios aprobados mediante checks automáticos (CI/CD) y aprobacion del reviewer.
  • Para poder contribuir de una mejor manera revisar las reglas de contribucion CONTRIBUTING.

⚙️ CI/CD

El repositorio utiliza GitHub Actions para verificar cada Pull Request:

  • Build del proyecto.
  • Ejecución de linters.
  • Tests automáticos.
  • Validación de integraciones.

Solo se permite hacer merge si todos los checks pasan correctamente.


👥 Equipo Frontend

Rol Nombre
Líder / Reviewer Maria Belen
Desarrolladores Xabier Perez, Santiago Mora

📅 Planificación por sprints

Sprint Objetivo principal Entregable
1 Fundaciones + Catálogo Login, lista y detalle de eventos
2 Inscripciones y pagos Flujo completo de inscripción y aprobación
3 Asistencia y reportes Registro de asistencia y reportes exportables
4 Certificados + optimización Sistema completo con demo final

🪪 Licencia

Este proyecto se distribuye bajo la licencia MIT. Consulta el archivo LICENSE para más información.


📞 Comunicación del equipo

Cualquier cambio importante en la estructura, estilos o flujo será notificado en las reuniones semanales del equipo. Las decisiones de diseño, dependencias y revisiones se documentan antes de integrarse a la rama principal.


About

No description, website, or topics provided.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 6