From 671619f2eddb7af9d037cbd5028ab411a66df652 Mon Sep 17 00:00:00 2001 From: omarsalinas3 Date: Mon, 1 Jun 2026 19:19:28 -0600 Subject: [PATCH 1/3] docs: improve project documentation --- README.md | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 68 insertions(+) diff --git a/README.md b/README.md index 1b9f5f3..03ae26e 100644 --- a/README.md +++ b/README.md @@ -134,3 +134,71 @@ You have made it till the end. Kudos to you!!
+ + +# Student Contribution + +## Developer Information + +- Name: Omar Salinas +- University: UNIVERSIDAD TECNOLOGICA DEL NORTE DE GUANAJUATO +- Date: 01/06/2026 + +## Proposed Improvements + +1. +2. +3. + +## Observations + +Lorem ipsum... + +## Project Strengths + +1. **Amigable para principiantes:** Es un proyecto excelente para personas que inician en Open Source. +2. **Colaborativo:** Permite agrupar múltiples proyectos web en un solo lugar. +3. **Instrucciones claras:** Cuenta con una guía detallada de contribución (`CONTRIBUTING.md`). +4. **Organizado:** Fomenta un buen flujo de trabajo al requerir la asignación de *issues* antes de un Pull Request. +5. **Fácil configuración:** El proceso de *fork* y clonación es muy sencillo de seguir localmente. + +## Improvement Opportunities + +1. **Agregar pruebas automatizadas:** Implementar GitHub Actions para validar el código de las contribuciones. +2. **Plantillas de Issues:** Crear *templates* específicos para reportar bugs o proponer mejoras. +3. **Soporte Multilingüe:** Traducir el `README.md` a español u otros idiomas para atraer más desarrolladores. +4. **Demo en vivo:** Alojar la página principal (por ejemplo en Vercel o GitHub Pages) para ver los proyectos. +5. **Estandarización de código:** Requerir el uso de herramientas como Prettier para mantener el código uniforme. + +## Technologies Used + +| Tecnología | Propósito | +|------------|---------| +| HTML5 | Estructura de los proyectos web | +| CSS3 | Estilos y diseño visual | +| JavaScript | Interactividad de los proyectos | +| Git | Control de versiones | +| GitHub | Alojamiento y colaboración de código | + +## Architecture Diagram + +```mermaid +graph LR +A[Desarrollador] -->|Hace Fork| B[Repositorio Personal] +B -->|Clona| C[Entorno Local] +C -->|Push a Rama Dev| B +B -->|Pull Request| D[WebArena Principal] +``` + +## Functional Requirements + +- **RF-01** El repositorio deberá permitir visualizar la lista de proyectos web contribuidos. +- **RF-02** El sistema deberá requerir que los usuarios tengan un *issue* asignado antes de contribuir. +- **RF-03** El sistema deberá permitir a los desarrolladores agregar nuevas carpetas de proyectos. +- **RF-04** El sistema deberá requerir que cada carpeta nueva contenga su propio archivo `README.md`. +- **RF-05** El sistema deberá aislar el proyecto de cada usuario en su propio directorio. +- **RF-06** El repositorio deberá proveer una guía de contribución accesible para todos. +- **RF-07** El sistema no deberá permitir commits directos a la rama principal (main). +- **RF-08** El sistema deberá soportar proyectos desarrollados con tecnologías web estándar (HTML/CSS/JS). +- **RF-09** El sistema deberá mostrar badges actualizados del estado del proyecto. +- **RF-10** El sistema deberá mantener una lista actualizada de los mantenedores del repositorio. \ No newline at end of file From 167cf9dec58b00742ebdc170b1e8875813433fb8 Mon Sep 17 00:00:00 2001 From: omarsalinas3 Date: Mon, 1 Jun 2026 19:29:55 -0600 Subject: [PATCH 2/3] docs: improve project documentation --- README.md | 78 +++++++++++++++++++++++++++++-------------------------- 1 file changed, 41 insertions(+), 37 deletions(-) diff --git a/README.md b/README.md index 03ae26e..e8b9f36 100644 --- a/README.md +++ b/README.md @@ -146,59 +146,63 @@ You have made it till the end. Kudos to you!! ## Proposed Improvements -1. -2. -3. +1. Diseñar e implementar las vistas de navegación explícitas para la plataforma SmartTV, las cuales quedaron documentadas pero pendientes de diagramar. +2. Ampliar las características del chat interactivo durante la transmisión en vivo para mejorar la interacción de la comunidad. +3. Integrar un sistema de alertas personalizadas para que el usuario elija qué eventos disparan notificaciones en su reloj inteligente. ## Observations -Lorem ipsum... +El proyecto FestivalTrack cuenta con un diseño de sistema robusto y bien estructurado. Se destaca la clara coherencia entre el modelo de dominio y la navegación, donde cada pantalla responde de manera directa a los atributos y métodos de entidades clave como Evento, Boleto y Transmision. ## Project Strengths -1. **Amigable para principiantes:** Es un proyecto excelente para personas que inician en Open Source. -2. **Colaborativo:** Permite agrupar múltiples proyectos web en un solo lugar. -3. **Instrucciones claras:** Cuenta con una guía detallada de contribución (`CONTRIBUTING.md`). -4. **Organizado:** Fomenta un buen flujo de trabajo al requerir la asignación de *issues* antes de un Pull Request. -5. **Fácil configuración:** El proceso de *fork* y clonación es muy sencillo de seguir localmente. +1. **Arquitectura Multiplataforma:** El diseño del sistema abarca entornos web, aplicaciones móviles y dispositivos wearables para acompañar al usuario antes y durante el evento. +2. **Separación de Roles:** Implementa flujos de navegación completamente independientes para los roles de Usuario y Administrador, evitando exponer funciones de gestión al consumidor. +3. **Gestión Integral:** El sistema unifica exitosamente la exploración cultural (galerías, canciones, biografías) con los procesos transaccionales como la compra de boletos. +4. **Interactividad en Vivo:** Soporta transmisiones de eventos digitales (streaming) en tiempo real, acompañadas de un chat interactivo. +5. **Notificaciones Contextuales:** Aprovecha el uso de relojes inteligentes para enviar alertas inminentes e indicaciones de navegación mediante mapas interactivos cuando un acto está por comenzar. ## Improvement Opportunities -1. **Agregar pruebas automatizadas:** Implementar GitHub Actions para validar el código de las contribuciones. -2. **Plantillas de Issues:** Crear *templates* específicos para reportar bugs o proponer mejoras. -3. **Soporte Multilingüe:** Traducir el `README.md` a español u otros idiomas para atraer más desarrolladores. -4. **Demo en vivo:** Alojar la página principal (por ejemplo en Vercel o GitHub Pages) para ver los proyectos. -5. **Estandarización de código:** Requerir el uso de herramientas como Prettier para mantener el código uniforme. +1. **Desarrollo de Vistas SmartTV:** Crear los diagramas de interfaz para la entidad SmartTV, ya que sus métodos para reproducir streaming y mostrar galería aún no tienen una representación visual[cite: 1]. +2. **Recuperación de Transacciones:** Implementar un guardado temporal durante el proceso de compra de boletos y generación del Pago para evitar pérdidas si el usuario interrumpe el flujo[cite: 1]. +3. **Soporte Multilingüe:** Permitir la traducción de la información biográfica y el catálogo cultural para atraer a visitantes de distintos países[cite: 1]. +4. **Optimización de Servidores de Streaming:** Asegurar que la entidad Transmision escale eficientemente ante un alto volumen de espectadores en vivo[cite: 1]. +5. **Métricas Avanzadas:** Expandir el panel administrativo para ofrecer analíticas más profundas más allá de la vista general de vistas y porcentajes de ventas de boletos[cite: 1]. ## Technologies Used -| Tecnología | Propósito | -|------------|---------| -| HTML5 | Estructura de los proyectos web | -| CSS3 | Estilos y diseño visual | -| JavaScript | Interactividad de los proyectos | -| Git | Control de versiones | -| GitHub | Alojamiento y colaboración de código | +| Tecnología/Entidad | Propósito | +|--------------------|-----------| +| Aplicación Web | Punto de entrada único para descubrimiento cultural y compra de boletos[cite: 1] | +| App Móvil (Roles) | Plataforma para el usuario final y panel de gestión para el administrador[cite: 1] | +| Smartwatch | Dispositivo wearable para alertas contextuales y rutas de mapas[cite: 1] | +| Módulo Transaccional | Procesamiento de pagos, selección de asientos VIP/General y generación de código QR[cite: 1] | +| Sistema de Streaming | Gestión de emisiones en vivo de los conciertos con chat incorporado[cite: 1] | ## Architecture Diagram ```mermaid -graph LR -A[Desarrollador] -->|Hace Fork| B[Repositorio Personal] -B -->|Clona| C[Entorno Local] -C -->|Push a Rama Dev| B -B -->|Pull Request| D[WebArena Principal] -``` +graph TD + A[Usuario] -->|Consulta / Compra| B[App Web / Móvil] + C[Administrador] -->|Gestiona Contenido| D[App Móvil Admin] + D -->|Crea| E[Evento / Catálogo] + B -->|Requiere| E + B -->|Genera| F[Boleto / Pago] + E -->|Transmite| G[Streaming en Vivo] + E -->|Dispara Alerta| H[Dispositivo Wearable] + ## Functional Requirements -- **RF-01** El repositorio deberá permitir visualizar la lista de proyectos web contribuidos. -- **RF-02** El sistema deberá requerir que los usuarios tengan un *issue* asignado antes de contribuir. -- **RF-03** El sistema deberá permitir a los desarrolladores agregar nuevas carpetas de proyectos. -- **RF-04** El sistema deberá requerir que cada carpeta nueva contenga su propio archivo `README.md`. -- **RF-05** El sistema deberá aislar el proyecto de cada usuario en su propio directorio. -- **RF-06** El repositorio deberá proveer una guía de contribución accesible para todos. -- **RF-07** El sistema no deberá permitir commits directos a la rama principal (main). -- **RF-08** El sistema deberá soportar proyectos desarrollados con tecnologías web estándar (HTML/CSS/JS). -- **RF-09** El sistema deberá mostrar badges actualizados del estado del proyecto. -- **RF-10** El sistema deberá mantener una lista actualizada de los mantenedores del repositorio. \ No newline at end of file +- **RF-01** El sistema deberá permitir al Administrador subir canciones (MP3, WAV) e imágenes al catálogo cultural[cite: 1]. + +- **RF-02** El sistema deberá permitir la publicación de eventos con detalles como ubicación, capacidad y fecha[cite: 1]. +- **RF-03** El sistema deberá incluir un flujo transaccional que genere un Boleto tras la validación de un Pago[cite: 1]. +- **RF-04** El sistema deberá generar un código QR único para cada boleto adquirido[cite: 1]. +- **RF-05** El sistema deberá soportar la transmisión en vivo de los eventos e integrar un chat activo para los espectadores[cite: 1]. +- **RF-06** El sistema deberá enviar notificaciones a los dispositivos wearables cuando un acto programado esté por comenzar[cite: 1]. +- **RF-07** El sistema deberá trazar y mostrar en un mapa interactivo la ruta de acceso al recinto desde la ubicación del usuario[cite: 1]. +- **RF-08** El sistema deberá permitir a los usuarios explorar galerías históricas y leer las biografías de los artistas[cite: 1]. +- **RF-09** El sistema deberá bifurcar la navegación inicial basándose en el rol autenticado (Usuario o Administrador)[cite: 1]. +- **RF-10** El sistema deberá proveer al Administrador un dashboard con estadísticas de contenido y resumen de ventas[cite: 1]. \ No newline at end of file From 01a84900064c9214ebaabcab7b6c6e755635036e Mon Sep 17 00:00:00 2001 From: omarsalinas3 Date: Mon, 1 Jun 2026 19:40:03 -0600 Subject: [PATCH 3/3] feat: add team members section --- README.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index e8b9f36..f5ec582 100644 --- a/README.md +++ b/README.md @@ -191,7 +191,8 @@ graph TD B -->|Genera| F[Boleto / Pago] E -->|Transmite| G[Streaming en Vivo] E -->|Dispara Alerta| H[Dispositivo Wearable] - + + ## Functional Requirements @@ -205,4 +206,9 @@ graph TD - **RF-07** El sistema deberá trazar y mostrar en un mapa interactivo la ruta de acceso al recinto desde la ubicación del usuario[cite: 1]. - **RF-08** El sistema deberá permitir a los usuarios explorar galerías históricas y leer las biografías de los artistas[cite: 1]. - **RF-09** El sistema deberá bifurcar la navegación inicial basándose en el rol autenticado (Usuario o Administrador)[cite: 1]. -- **RF-10** El sistema deberá proveer al Administrador un dashboard con estadísticas de contenido y resumen de ventas[cite: 1]. \ No newline at end of file +- **RF-10** El sistema deberá proveer al Administrador un dashboard con estadísticas de contenido y resumen de ventas[cite: 1]. + +## Team Members +*NOE CHAVERO MARTINEZ** +**JUAN GUSTAVO ANGEL CRUZ MENDEZ** +**OMAR SALINAS SALINAS ** \ No newline at end of file