{%hackmd kQ7o7WjiQlaSGhk-6g3Jjw %}

MTI-2023 Trabajo Ingeniería de Requisitos
===
*Matías Bobadilla / Angelo Cabrera / Cristian Orellana*

## Introducción
Este informe de Ingeniería de Requisitos tiene como objetivo identificar los requisitos clave para el desarrollo del Sistema Integral de Gestión y Experiencia del Visitante para Museos, a través de la elicitación de requisitos de los stakeholders involucrados en el proyecto definición de casos de uso, especificación de requisitos y definición de la validación y gestión de los mismos.

## Elicitación
### Visión y ámbito de la aplicación
La visión del proyecto es modernizar y enriquecer la experiencia de los visitantes al museo a través de una plataforma digital que integra diversas funcionalidades para facilitar la interacción con los artefactos históricos, proporcionar información detallada sobre ellos y recopilar datos de las visitas para mejorar futuras experiencias. Esta modernización también conlleva la implementación de un portal de datos abiertos que permita exponer a desarrolladores externos la información de los artefactos del museo.

El ámbito del proyecto es el desarrollo de un sistema de software integral para museos que optimice la gestión interna del museo, mejore la experiencia del visitante y promueva la accesibilidad de datos para el desarrollo de aplicaciones externas.

### Identificar Stakeholders
Consideremos un organigrama tipo para un museo:


Los stakeholders involucrados en el proyecto se describen a continuación:

| Posición / Título | Rol Proyecto | Clasificación | Expectativas | Influencia | Interés |
| -------------------------------------------- | ------------------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | ------- |
| Director del Museo | Sponsor | Interno | Quiere que se cumplan todos los requisitos en plazo y costos acordados | Alta | Alto |
| Jefe de administración y finanzas | Encargado del presupuesto | Interno | Primero quiere que el proyecto cumpla los presupuestos financieros. Segundo, como responsable de los recursos físicos, lógisticos, seguridad e infraestructura del museo quiere participar en las decisiones del proyecto relacionadas a estos temas y poder actualizar , si es necesario, los procesos que serán impactados por el proyecto. | Alta | Alto |
| Jefatura de colecciones y publicaciones | Usuario | Interno | Como organizador de exposiciones espera que el nuevo sistema permita brindar una experiencia única a los usuarios y que la administración de los contenidos sea facil de realizar. | Alta | Alto |
| Encargada de Comunicaciones | Usuario | Interno | Como coordina la comunicación con socios estrategicos espera que la plataforma de datos abiertos permita generar nuevas alianzas y oportunidades de generar nuevos contenidos. | Media | Alto |
| Jefe de educación, mediación y ciudadanía | Usuario | Interno | Que la plataforma permita generar contenido didactico y multimedia que permita tener una mejor experiencia a los visitantes. Por otro lado, que la plataforma de datos abiertos permita educar de otras formas a la ciudadania. | Alta | Alto |
| Jefe de TI | Usuario | Interno | Que el sistema sea implementado en los plazos, que sea posteriormente fácil de administrar, que sea seguro, mantenible y flexlible a cambios. | Alta | Alto |
| Guias | Usuario | Interno | Que el sistema permita brindar una mejor experiencia al visitante | Media | Alto |
| Visitante del museo | Usuario | Externo | Mejorar su experiencia en el museo, personalizando sus recorridos, accediendo a información detallada sobre los artefactos y participando en actividades interactivas. | Media | Medio |
| Usuarios de API | Usuario | Externo | Poder utilizar facilmente los datos abiertos proporcionados por el museo para crear aplicaciones innovadoras basadas en la información del museo, promoviendo la accesibilidad de datos para el desarrollo de aplicaciones externas. | Baja | Alto |
| Jefe de proyecto | Jefe de proyecto | Interno | Encargado de liderar al equipo de desarrollo externo, gestionar el proyecto para que el producto sea de calidad y que se cumplan los plazosy presupuestos | Alta | Alto |
| Desarrollador | Desarrollador | Interno | Tener requerimientos claros para poder desarrollar el sofware y comunicación fluida con los usuarios | Baja | Alto |
| Arquitecto TI | Arquitecto TI | Interno | Poder definir una arquitectura que satisfaga los criterios de calidad definidos con los recursos establecidos y en los plazos determinados | Media | Alto |
| Ingeniero de software | Ingeniero de Software | Interno | Que el sistema cumpla las expectativas y requerimientos definidos | Media | Alto |
| Subsecretaria de las Culturas y de las Artes | Sponsor | Externo | Que este proyecto sea éxitoso para luego poder implementar sistemas similares en otros museos y con ello mejorar la cultura del país | Bajo | Medio |
| Subsecretaria del Patrimonio Cultural | Sponsor | Externo | Que este proyecto sea éxitoso para luego poder implementar sistemas similares en otros museos y con ello mejorar la cultura del país | Bajo | Medio |
| Subdirección de Patrimonio Digital | Sponsor | Externo | Que este proyecto sea éxitoso para luego poder implementar sistemas similares en otros museos. Que la plataforma de datos abiertos permita generar nuevos contenidos digitales. | Medio | Alto |
| Subdirección Nacional de Museos | Sponsor | Externo | Mejorar la interoperabilidad entre museos, la colaboración y el intercambio de recursos, así como en la exposición de colecciones o eventos conjuntos entre instituciones. | Medio | Alto |

### Listado de requisitos
#### Requisitos Funcionales:
1. **Recorrido Guiado Mejorado:** La aplicación permitirá a los visitantes acceder a recorridos personalizados basados en sus intereses y preferencias.
> * Selección de intereses: La aplicación ofrece una lista de intereses predefinidos (por ejemplo, historia, arte, ciencia) o permite al usuario ingresar sus propios intereses.
> * Recomendación de recorridos: Basado en los intereses del usuario, la aplicación recomienda recorridos por el museo con diferentes duraciones y puntos de interés.
> * Navegación por el museo: La aplicación utiliza la ubicación del usuario en el museo para mostrar la ruta del recorrido seleccionado y guiar al usuario a cada punto de interés.
> * Información contextual: En cada punto de interés, la aplicación ofrece información relevante sobre la ubicación, como su historia, significado cultural y datos adicionales.
2. **Descripciones Detalladas de Artefactos:** Cada artefacto histórico exhibido en el museo estará acompañado de una descripción detallada, imágenes de alta calidad y contenido multimedia que contextualice su importancia histórica y cultural.
> * Identificación de artefactos: El usuario puede escanear el código QR o seleccionar un artefacto de una lista para acceder a su información.
> * Descripción multimedia: La aplicación ofrece una descripción detallada del artefacto, incluyendo imágenes de alta calidad, videos y audio.
> * Contexto histórico y cultural: La aplicación explica la importancia histórica y cultural del artefacto, su relación con otras piezas del museo y su contexto en la época en que fue creado.
> * Contenido interactivo: La aplicación puede incluir contenido interactivo como galerías de fotos 360°, modelos 3D y realidad aumentada para ofrecer una experiencia más rica e inmersiva.
3. **Identificación y Análisis de Visitantes:** Se implementará tecnología de reconocimiento visual para recopilar datos anónimos sobre el flujo de visitantes, rutas más frecuentes y tiempo dedicado a cada exhibición.
4. **Plataforma de Datos Abiertos:** La base de datos del museo estará disponible como datos abiertos y públicos, facilitando el acceso a desarrolladores externos para la creación de aplicaciones innovadoras basadas en la información proporcionada por el museo.
5. **Interoperabilidad entre Museos:** El sistema permitirá compartir información relevante y recursos digitales con otros museos y entidades culturales.
6. **Dashboard para administradores del museo:** Panel intuitivo y personalizable con metricas clave, datos de visitantes, tendencias de recorridos, información sonbre las interacción con los artefactos y la efectividad de las exposiciones. Permitirá la gestiñon de contenido, visualizaciòn de análisis y generación de informes detallados.

#### Requisitos No Funcionales:
1. **Usabilidad:** La aplicación debe ser fácil de usar y comprender para los visitantes del museo.
2. **Fiabilidad:** La aplicación debe ser confiable y estar disponible en todo momento para los visitantes del museo.
3. **Seguridad:** La aplicación debe garantizar la privacidad y seguridad de los datos de los visitantes del museo.
4. **Escalabilidad:** La aplicación debe ser escalable para manejar un gran número de visitantes y datos.
5. **Adaptabilidad:** La aplicación debe ser adaptable a medida que se recopilen y analicen datos sobre el uso y las preferencias de los visitantes.

### Encuesta plataforma datos abiertos

**Contexto:**
El proyecto sistema integral de gestión y experiencia del visitante para museos quiere realizar una Plataforma de datos abiertos.

**Descripción General del Proyecto:** El Sistema Integral de Gestión y Experiencia del Visitante para Museos es una plataforma digital diseñada para modernizar y enriquecer la experiencia de los visitantes al museo. La aplicación integrará diversas funcionalidades para facilitar la interacción con los artefactos históricos, proporcionar información detallada sobre ellos y recopilar datos de las visitas para mejorar futuras experiencias.

**Objetivo del Proyecto:** Desarrollar un sistema de software integral que optimice la gestión interna del museo, mejore la experiencia del visitante y promueva la accesibilidad de datos para el desarrollo de aplicaciones externas.

En este contexto la **plataforma de datos abiertos** tiene como alcance que la base de datos del museo esté disponible como datos abiertos y públicos, facilitando el acceso a desarrolladores externos para la creación de aplicaciones innovadoras basadas en la información proporcionada por el museo.

La siguiente encuesta guarda relación específica con la plataforma de datos abiertos.

> **<span style="text-decoration:underline;">Información del entrevistado</span>**
> * Nombre:
> * Apellido:
> * Email:
> * Funcionario interno o externo al museo
> * Rol que desempeña:
> * Relación con la base de datos del museo:
> * Administra Datos
> * Usa o usará los datos
> * No tiene relación
> * Otro: especifique
>
> **<span style="text-decoration:underline;">Encuesta:</span>**
>
> Respecto del alcance e impactos de la plataforma de datos abiertos:
> 1. ¿Considera importante el acceso a datos abiertos proporcionados por el museo para el desarrollo de aplicaciones externas relacionadas con la experiencia del visitante en el museo?
> 2. ¿Qué beneficios percibe en el acceso a datos abiertos proporcionados por el museo para el desarrollo de aplicaciones externas relacionadas con la experiencia del visitante en el museo?
> 3. ¿Considera que la disponibilidad de datos abiertos del museo podría fomentar la innovación y la creación de nuevas aplicaciones relacionadas con la experiencia del visitante en el museo?
> 4. ¿Quien o quienes a su juicio serían posibles usuarios de la plataforma de datos abiertos?
>
> Respecto de la información y funcionalidades que debe tener la plataforma de datos abiertos:
>
> 5. ¿Qué tipo de información es relevante disponibilizar como datos abiertos para el desarrollo de aplicaciones externas relacionadas con la experiencia del visitante en el museo? (Por ejemplo, información sobre artefactos, métricas de visitantes, contenido multimedia, etc.)
> 6. ¿Qué tipo de funcionalidades le gustaría ver en una plataforma de datos abiertos para facilitar el desarrollo de aplicaciones externas relacionadas con la experiencia del visitante en el museo?
>
## Análisis
### Diagrama de Contexto
> Ver imagen completa: [Aquí](https://i.imgur.com/9qOehnQ.png)

### Diagramas de Casos de Uso

#### Aplicación Móvil Museo
| Actor | Caso de uso | Descripción |
| ------------------ | -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Visitante | Crear cuenta usuario | El visitante puede crear usuario de la app museo, así guardar sus preferencias e intereses para próximas visitas |
| Visitante | Definir intereses y preferencias | El visitante puede definir y editar sus intereses y preferencias, el sistema central podrá recomendar recorridos en base a estas preferencias. |
| Visitante | Acceso a recorridos | El usuario accede a recorridos personalizados si tiene sus intereses y preferencias definidos. También puede acceder a recomendación de rutas y artefactos con la lectura de un código QR o por el reconocimiento visual de su posición en el museo. |
| Sistema de Gestión | Recomendar rutas personalizadas | El sistema recomienda recorridos personalizados en base a intereses y preferencias definidos por el visitante |
| Sistema de Gestión | Recomendar rutas y artefactos | El usuario al escanear codigo QR o identificando su posición con el sistema visual accede a recomendaciones de recorridos o artefactos |
| Visitante | Seguir recorrido | Visitante puede seleccionar un recorrido, se mostrará un mapa del museo donde ir y qué artefactos debe mirar. El mapa debe mostrar la posición actual del visitante. |


#### Sistema de Gestión
| Actor | Caso de uso | Descripción |
| ---------------------------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Administrador de contenidos | Gestionar artefactos | Puede crear, editar, eliminar y publicar artefactos. Administrar los atributos del artefacto como descripciones, imagenes, contenido multimedia, posición en el mapa del museo. |
| Administrador de contenidos | Exponer atributos de artefacto | Extensión de Gestionar artefactos. Despliega en pantalla los atributos actualizados de artefactos |
| Administrador de contenidos | Gestionar Exposiciones | Gestionar un conjunto de artefactos que tiene un propósito común. Permite Crear, editar y eliminar Exposiciones. |
| Administrador de contenidos | Gestionar Mapa del Museo | Permite editar el mapa del museo, poder visualizar dónde está cada artefacto o exposición. |
| Administrador de contenidos | Gestionar Rutas | Permite crear rutas recomendadas o artefactos recomendados. Puede generar un QR por cada elemento para que luego sea accedido por el visitante. Tambien se puede asociar ubicaciones en el mapa para recomendar automaticamente según la posición del visitante en el museo. |
| Administrador de museo | Visualizar métricas claves | Visualizar de métricas clave: datos de visitantes, tendencias de recorridas, interacción con los artefactos y efectividad de las exposiciones. |
| Administrador de museo | Generar informes | Personalizar informes en base a datos del sistema para la toma de decisiones estratégicas |
| Administrador de museo | Visualizar informes | Poder visualizar los informes Generados |
| Sistema de posicionamiento de visitantes | Recopilar datos | Recopila y envía al sistema de gestión información de flujo de visitantes, rutas más frecuentes y tiempo dedicados a cada exhibición. Entrega información que permite mejorar las rutas más efectivas. |


#### Plataforma Datos Abiertos

| Actor | Caso de uso | Descripción |
| ------------------------------------ | ------------------------------ | ---------------------------------------------------------- |
| Consultor externo, Sistemas Externos | Acceso a información del museo | Acceso a datos, información y recursos degitales del museo |


### Prototipo
El siguiente propotipo describe en forma gráfica el requisito
“Dashboard para administradores del Museo”.

#### Ingreso


#### Reporte Visitantes

#### Gestión de Artefactos


#### Gestión de Exhibiciones

De forma adicional, se presenta un prototipo para la aplicación móvil que utilizaría el visitante:

#### Registro

#### Home

#### Buscador

#### Información Exhibición

#### Información Artefacto

#### Detalle Perfil

### Diccionario de Datos

| Termino | Definición |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Recorrido | Ruta o itinerario que sigue un visitante mientras explora las exhibiciones y colecciones de un museo. Este recorrido está diseñado para guiar a los visitantes a través de las diversas salas y áreas del museo, permitiéndoles experimentar de manera organizada y educativa las diferentes obras de arte, objetos históricos o cualquier otro tipo de exhibición que el museo albergue. |
| Recomendación | La recomendación personalizada al visitante de un recorrido en un museo, en base a sus preferencias o desde el sistema de visualización o desde código QR |
| Visitante | Persona que acude a un museo con el propósito de explorar sus colecciones, exhibiciones y actividades. Los visitantes de un museo pueden tener diversos objetivos al realizar su visita, como aprender sobre la historia, el arte, la ciencia o la cultura representados en las exhibiciones |
| Código QR | Significa "Quick Response" o "Respuesta Rápida" en inglés, es un tipo de código de barras bidimensional cuadrado que almacena información de manera cifrada. Los códigos QR pueden contener diversos tipos de datos, como texto, enlaces URL, información de contacto, coordenadas geográficas, eventos de calendario, entre otros. |
| Artefacto | Un artefacto es un objeto físico que forma parte de la colección del museo y que se exhibe para su estudio, disfrute y educación. Estos objetos suelen tener un valor cultural, histórico, artístico, científico o antropológico, y son preservados y mostrados con el fin de transmitir conocimientos y preservar la memoria colectiva. |
| Atributos del Artefacto | Información asociada al artefacto como imagenes de alta calidad, contenido multimedia, descripciones de importancia historica y cultural. |
| Museo App | Aplicativo que utilizará el visitante para personalizar preferencias y acceder a recorridos guiados. |
| Sistema de posicionamiento de visitantes | Sistema de reconocimiento visual y de dispositivos, recopila datos sobre flujo de visitantes, rutas y tiempos. |
| Sistema de gestión | Visualización de KPIs e Informes. Gestión de contenido de artefactos, generación de informes y rutas. |
| Administrador de contenidos | Encargado de gestionar el contenido del museo. |
| Administrador Museo | Fucionario que necesitan acceso a KPI e informes. |
| Plataforma museo datos abiertos | Sistema que permite el acceso a la base de datos del museo y recursos digitales. |
| Sistemas externos | Sistemas de otras instituciones pueden acceder a la información de nuestro museo |
| Consultor externo | Persona que puede crear aplicaciones con la información proporcionada por el museo. |

### Componentes de la aplicación

> Ver imagen completa: [Aquí](https://i.imgur.com/efNJyzp.jpeg)

## Especificación

Se genera un documento de especificación de requisitos en base a la planilla SRS. Además, en este documento se identifica el origen de cada requisito, se etiqueta cada requisito forma única y se justifican los requisitos no funcionales.

El documento de especificación de requisitos se puede encontrar en el siguiente enlace:

[Documento de Especificación de Requisitos (SRS)](https://hackmd.io/ZFUQJIPSQLmY1UvX3IDDGA)

:::info
Se utilizó como plantilla el documento SRS propuesto por Asana: [Ver template](https://asana.com/es/resources/software-requirement-document-template)
:::

## Validación
> A continuación se propone un procedimiento para validar los requisitos, considerado el grupo de trabajo.


> Ver imagen completa: [Aquí](https://i.imgur.com/LIR6vzR.png)

**1. Proponer versión del documento de especificación de requisitos.** Debe contener todos los puntos de la plantilla seleccionada.

>_Responsable_: Matías Bobadilla.

**2. Revisar el documento de especificación de requisitos.**

**a. Revisión general del documento:** asegurar consistencia total al alcance del proyecto y que se cumpla con la plantilla seleccionada.
**b. Revisión individual de requisitos para validar:** origen y fundamentos, evaluación de calidad y reglas de negocio.
**c. Revisión del conjunto de requisitos:** asegurar la relación entre ellos, validando: lagunas, conflictos e incoherencias, solapamiento y duplicaciones y dependencias.
**d. Entregar Feedback** para generar las correcciones en la versión del documento de requisitos.

>_Responsable_: Ángelo Cabrera y Cristian Orellana

**3. Diseñar Prototipo.** Se diseña prototipo de los sistemas involucrados para un mayor entendimiento.

>_Responsable_: Ángelo Cabrera

**4. Validar Prototipo.** Hay que asegurar que sea consistente con los requerimientos del documento de especificación de requisitos. Si algo cambia a partir de la revisión del prototipo debe actualizar y validar el documento de requisitos.

>_Responsable_: Matías Bobadilla y Cristian Orellana.

**5. Actualizar versión del documento de requisitos.**

>_Responsable_: Matías Bobadilla

**6. Aprobar versión del documento de requisitos. **

>_Responsable_: Ángelo Cabrera.

**7. Planificar y diseñar las pruebas de aceptación.** Para asegurar que el producto satisface las necesidades del cliente y se logran los objetivos de negocio.

>_Responsable_: Ángelo Cabrera y Cristian Orellana

## Gestión de Requisitos
A continuación se presenta la Matriz de Trazabilidad de Requisitos:


> Ver imagen completa: [Aquí](https://i.imgur.com/3oMx9UM.png)

## Conclusiones
La correcta gestión de los requisitos de software es fundamental para el éxito de cualquier proyecto de desarrollo de software. Al dedicar tiempo y esfuerzo a gestionar los requisitos de manera efectiva, se puede asegurar que el software se desarrolle de acuerdo a las necesidades de los usuarios, se reduzca el riesgo de errores y cambios costosos, se mejore la comunicación entre las partes interesadas y se facilite la planificación y el seguimiento del proyecto.

Este trabajo nos ha servido para confirmar la importancia de desarrollar estas tareas de gestión, ya que permiten documentar y revisar en detalle todo lo que el cliente espera antes de comenzar a desarrollar la solución lo cual mejora la comunicación, alinea las expectativas y reduce el retrabajo al permitir discutir y revisar los requisitos de forma clara y oportuna.