Entregable1_fisw Pcs - Egi - Ao

Universidad Técnica Federico Santa María Campus Santiago San Joaquín

Análisis y diseño de software

Entregable 1

Paolo Caviedes

Rol: 2011735706

Esteban González

Rol: 2010047458

Alonso Orellana

Rol: 2010735516

Ingeniería Civil en Informática

Santiago 3 de noviembre del 2015

Índice Introducción pág. 2 Especificación de requerimientos pág. 3 Diagrama de casos de uso pág. 5 Casos de uso detallados y diagramas de secuencia pág. 6 Conclusión pág. 32

1

Introducción El siguiente documento tiene por motivo dar a conocer los procesos que se llevan a cabo para el desarrollo de un proyecto, esto es a partir de la toma de requerimientos que se realizó en conjunto con la cliente hasta el producto final. Lo anterior se hará de manera iterativa por lo que se debe destacar que este es el primer entregable de un total de tres. En particular, en este informe se entregará una especificación de requerimientos, un diagrama de casos de usos, los casos de uso detallados con sus respectivas narrativas y diagramas de secuencia del sistema. Para una mayor claridad del proyecto a desarrollar y el contexto que lo envuelve, se destaca que el objetivo principal buscado es difundir y promocionar, a través de una página web, la exposición que la Biblioteca Nacional tiene en celebración de los 40 años del archivo de música de esta institución.

2

Especificación de requerimientos A continuación se especifican datos relevantes al proyecto: Cliente: Cecilia Astudillo Cargo: Jefa archivo de música Biblioteca Nacional de Chile. Objetivo (principal del proyecto): Difundir, mostrar y promocionar la exposición que en estos momentos está en muestra en la Biblioteca Nacional para, además, dar a conocer el archivo de música de la Biblioteca. Contexto: Celebración de los 40 años del archivo de música de la Biblioteca Nacional de Chile, donde se muestran, en 6 secciones, distintos tipos de documentos que posee este archivo. Toma de requerimientos:

1. Mostrar la exposición en una página web, donde se retrate, lo más fielmente posible, la exposición física.

2. La exposición no es sólo gráfica. Dentro de la exposición es posible escuchar música y “llevarse” documentos de esta misma. Es necesario que los visitantes puedan descargar y ver estos contenidos.

3. La exposición cuenta con 6 secciones y cada una con su contexto. 4. Sección de noticias y foro. Las noticias provienen de una página de Facebook

(Amigos archivo de música) donde son informadas. Algunas actividades son: cine,conciertos, charlas, entre otras. El foro se realiza al final de cada visita donde se habla de un tema en particular.

5. La exposición tiene visitas guiadas. 6. Público objetivo: persona, a nivel mundial, entre 12 y 100 años. 7. Accesibilidad para distintos idiomas, como mínimo inglés y español. 8. Personas relacionadas con el entorno del archivo de música: investigadores,

bibliotecólogos. 9. Los visitantes se pueden registrar a la página web y esto les dará la posibilidad de

recibir noticias y postular al uso de la sala del archivo de música para hacer charlas. Los investigadores registrados podrán gestionar cartas de presentación que ellos necesiten.

10. Los visitantes podrán realizar donaciones si es que ellos estiman pertinente. La gestión de la donación es parte del bibliotecólogo que podrá catalogarla debidamente.

11. Los visitantes podrán hacer sugerencias al archivo de música a través de la página.

3

Dada la toma de requerimientos anterior y considerando que el proyecto es un sitio web con el objetivo deseado, se tiene la siguiente especificación de requerimientos:

Requerimientos funcionales:

Permitir el ingreso a secciones para los visitantes y ver, escuchar, descargar y agregar comentarios de esta sección.

Permitir ver noticias del archivo de música a visitantes. Permitir el ingreso a una visita guiada. Permitir ver el foro que se realiza y agregar comentarios. Permitir a los visitantes realizar donaciones. Permitir el ingreso de sugerencias hacia el archivo de música. Permitir el registro al sitio web para recibir noticias y postular al uso de una sala para

charlas. Permitir a los investigadores gestionar cartas de presentaciones y el registro al sitio

web. Permitir al bibliotecólogo agregar catálogos del material del archivo de música de la

Biblioteca Nacional de Chile. Permitir al bibliotecólogo gestionar las donaciones realizadas por los visitantes.

Especificaciones:

1. Para el requerimiento de “ingreso a secciones”, una sección se entiende como una parte de la exposición la cual posee su propio contenido, material descargable y contexto que la envuelve. Son 6 secciones en total que corresponden directamente a la exposición.

2. Para el requerimiento “ver noticias”, este se entiende como una nueva sección de la página web en donde se podrán observar las noticias referentes al archivo de música, las cuales serán obtenidos a partir de su página de Facebook. Además, el usuario registrado en la página web, podrá recibir noticias a modo de recordatorios o de información agregada a alguna sección.

3. Para el requerimiento de “ingreso a visita guiada”, se entiende como una vista por las secciones que componen a la exposición de manera guiada. Lo anterior, mantendrá las funcionalidades de “ingresar a secciones”.

4. Al final de cada sección existe un foro donde se comentan cosas vistas en las secciones por los visitantes. Cada persona que logró entrar a una sección, podrá ver este foro y agregar sus propios comentarios.

5. Para el requerimiento de “realizar donaciones”, se entiende como el archivo de música podrá recepcionar donaciones que quieran hacer los visitantes de la página, tales como obras de algún grupo (chileno o extranjero), colecciones relacionadas a la música chilena, entre otras.

6. Para el requerimiento “ingreso de sugerencias”, se entiende como una vista de la página la cual tendrá la opción de agregar sugerencias hacia la exposición en sí.

4

7. Para el requerimiento de “registro al sitio web”, se entiende como que los visitantes

tendrán la opción de registrarse a la página web para recibir noticias, hacer comentarios de manera más formal (no anonimamente) o postular a realizar alguna charla en la sala del archivo de música.

8. Las funcionalidades de los bibliotecólogos e investigadores de la Biblioteca Nacional, se entienden como procesos internos que ellos deben hacer para corroborar el trabajo realizado o las donaciones enviadas. Se solicitará mayor información al momento de la construcción de la página web.

Requerimientos no funcionales: Tiempos de respuesta menores a 15 segundos. Accesibilidad de idiomas (Inglés Español). Disponibilidad de página web 99% del tiempo. (Uptime 99%)

Diagrama de casos de uso A partir de los requerimientos anteriores, se realiza el diagrama de casos de uso pertinente a estos requerimientos. Se tiene:

5

Casos de uso detallados y diagramas de secuencia Se integran los casos de uso detallados y su respectivo diagrama de secuencia. Cabe destacar que los diagramas de secuencia son a un alto nivel dado que aún no se tiene el modelo de dominio o clases realizado.

Caso de uso Ingresar a sección

Descripción El sistema permite el ingreso a las distintas secciones que tiene el sitio web.

Actores Visitante (primario)

Precondiciones Deben existir secciones

Postcondiciones

Curso normal de eventos

Acción de actores Respuesta del sistema

1. Visitante hace click en la pestaña “Secciones”

2. Se despliega un listado con las secciones disponibles

3. El visitante escoge la sección que desea visitar

4. Se actualiza la vista y se muestra la sección deseada.

Curso alternativo de eventos


2. No se despliega un listado con las secciones

2.1. Se envía un mensaje al visitante de error. Se actualiza la vista al “home”.



4. No se actualiza vista con las sección deseada.

4.1. Se solicita volver a elegir opción de sección.

4.2. El caso de uso vuelve al segmento 3. del curso normal.

6

Caso de uso Ver contenido

Descripción Al estar en una sección, se puede ver el contenido multimedia de la sección.


Precondiciones Debe existir una sección, haber ingresado correctamente a sección.

Postcondiciones



1. Visitante hace click en la pestaña “Ver contenido”

2. Se despliega un listado con los contenidos disponibles.

3. El visitante escoge el contenido deseado haciendo click.

4. Se actualiza la vista y se muestra la información del contenido deseado.



2. No se despliega un listado con el contenido disponible.

2.1. Se envía un mensaje al visitante de error. Se actualiza la vista al “home”.


4. No se actualiza vista con el contenido deseado.

4.1. Se solicita volver a elegir opción de contenido.

4.2. El caso de uso vuelve al segmento 3. del curso normal.

8

Caso de uso Descargar contenido

Descripción Al final de cada sección, se permitirá al visitante descargar el contenido multimedia de dicha sección


Precondiciones Debe existir sección, existir contenido, haber ingresado correctamente, existir contenido descargable

Postcondiciones



1. Visitante hace click en la pestaña “Ver contenido descargable”

2. Se despliega un listado con los contenidos descargables disponibles.

3. El visitante escoge el contenido deseado para descargar haciendo click.

4. Se envía un mensaje al visitante de éxito y comienza la descarga del contenido.



2. No se despliega un listado con el contenido descargable disponible.

2.1. Se envía un mensaje al visitante de error. Se actualiza la vista a la sección del contenido.

Respuesta del sistema

4. No comienza la descarga de contenido.

4.1. Se envía un mensaje de advertencia. Se vuelve a iniciar la descarga.

9

Caso de uso Agregar comentario

Descripción El visitante puede escribir comentarios en cada sección, en el foro y en el sitio web.


Precondiciones Debe haber ingresado correctamente, existir sección o existir foro.

Postcondiciones Nueva instancia de comentario.



1. Visitante hace click en “escribir comentario”

2. Se despliega una cuadrícula para escribir el mensaje.

3. Se hace click en “enviar comentario”

4. Se valida el mensaje.

5. Se envía mensaje de éxito.



2. No se despliega cuadricula.

2.1. Se envía un mensaje al visitante de error. Se solicita volver a escribir comentario.

10

Caso de uso Ver foro

Descripción El visitante puede ver alguno de los foros de la página


Precondiciones Debe haber ingresado correctamente, existir al menos un foro.

Postcondiciones



1. Visitante hace click en “foro”

2. Se actualiza la vista. Se muestran los temas disponibles en el foro.

3. Se hace click en algún tema deseado.

4. Se actualiza página y se muestra el tema escogido.



2. No se despliegan los temas disponibles.

2.1. Se envía un mensaje de error por pantalla. Se actualiza la página a sección del foro.



4. No se despliega el tema escogido.

11

4.1. Se envía un mensaje de error por pantalla. Se actualiza la página al punto 2. del flujo normal.

Caso de uso Ingreso a visita guiada

Descripción El visitante puede recibir una visita guiada por las distintas secciones que componen la exposición.


Precondiciones Debe haber ingresado correctamente, existir secciones.

Postcondiciones



1. Visitante hace click en “realizar visita guiada”.

2. Se actualiza la vista. Se muestra mensaje de bienvenida.

3. Se comienzan a revisar las secciones de la exposición. Se da tiempo para realizar todas las funcionalidades de una sección.

4. Al terminar de ver la última sección. Se muestra mensaje de despedida.

5. Se actualiza página al “home”

12



1.1 Visitante desea terminar visita guiada. Hace click en “terminar visita guiada”

1.1.1 Se envía un mensaje de despedida. Se actualiza página al “home”.



3. Fallan secciones.

3.1. Se referencian a los cursos de eventos correspondientes a secciones.

Caso de uso Realizar donación

Descripción El visitante puede realizar un tipo de donación en específico.


Precondiciones .

Postcondiciones Nueva instancia de donación.

13



1. Visitante hace click en “realizar donación”

2. Se actualiza la vista. Se muestra opciones de donación.

3. Se selecciona un tipo de donación.

4. Se despliega formulario de datos. Se solicita seleccionar archivo a donar.

5. Se selecciona archivo a subir.

6. Se valida y se envía mensaje de agradecimiento.



2. No se muestran opciones de donación.

2.1 Se envía mensaje de advertencia. Se despliega nuevamente las opciones de donación.



4. No se muestran formulario.

4.1 Se envía mensaje de error. Se actualiza vista al punto 2. del flujo normal.



4. Archivo seleccionado sobrepasa el límite de espacio

4.1 Se envía mensaje de error. Se actualiza la vista al punto 2. del flujo normal.

14

Caso de uso Ingresar sugerencias.

Descripción El visitante puede enviar sugerencias al sitio.


Precondiciones Deben existir secciones. Debe haber ingresado correctamente.

Postcondiciones Nueva instancia de sugerencia.



1. Visitante hace click en “realizar sugerencia”

2. Se despliega una cuadrícula para escribir el mensaje.

3. Se hace click en “enviar sugerencia”


5. Se envía mensaje de éxito. Curso alternativo de eventos


2. No se despliega cuadricula.

2.1. Se envía un mensaje al visitante de error. Se solicita volver a escribir la sugerencia.

15

Caso de uso Registrarse a sitio web

Descripción El visitante y el investigador pueden registrarse en el sitio web, para tener acceso a más opciones en la página

Actores Visitante (primario) , investigador (secundario)

Precondiciones

Postcondiciones



1. Hacer click en “registrarse”

2. Se despliega una formulario.

3. Se envía formulario al presionar “enviar”

4. Se valida el formulario.

5. Se envía mensaje de éxito.

Curso alternativo de eventos Acción de actores Respuesta del sistema

2. No se despliega formulario.

2.1. Se envía un mensaje de error. Se despliega nuevamente un formulario a llenar.

2.2 Se continúa el flujo normal de eventos desde el punto 2.

16

Caso de uso Postular uso sala archivo música

Descripción El visitante puede postular a una visita a sala archivo música


Precondiciones Existir al menos una sala para postular. El visitante debe estar registrado y con sesión iniciada.

Postcondiciones



1. Visitante hace click en “postular a sala archivo de música”

2. Se despliega un formulario de postulación.

3. Visitante hace click en “enviar postulación”


5. Se envía mensaje de postulación exitosa.




2.1 Se envía un mensaje de error. Se despliega nuevamente un formulario a llenar.


17

Caso de uso Recibir noticias

Descripción El visitante puede solicitar recibir noticias de eventos o nuevos contenidos referentes a la exposición.


Precondiciones El visitante debe estar registrado y con sesión iniciada.

Postcondiciones



1. Visitante presiona el botón “recibir noticias” posicionado en el “home”

2. Se despliega un listado de opciones.

3. Visitante hace click en todos los tipos de noticias que desea recibir

4. Se validan datos. Se despliega un formulario de llenado para ingresar un correo a donde recibir las noticias.

5. Se envía formulario con correo electrónico

6. Se validan datos. Se envía mensaje de éxito



2. No se muestran opciones.

18

2.1 Se envía mensaje de error. Se vuelve al punto 2. del flujo normal de eventos.




4.1 Se envía un mensaje de error. Se despliega nuevamente un formulario a llenar.


Caso de uso Ver noticias

Descripción El visitante puede ver las noticias que ofrece la página


Precondiciones Existir noticias.

Postcondiciones



1. Visitante presiona pestaña “ver noticias”

2. Se despliega un listado con las noticias disponibles.

3. Visitante escoge noticia que desea ver

19

4. Se actualiza página y se muestra noticia seleccionada.



2. No se despliegan las noticias disponibles.

2.1. Se envía un mensaje de error por pantalla. Se actualiza la página a “home”.



4. No se despliega la noticia escogida.

4.1. Se envía un mensaje de error por pantalla. Se actualiza la página al punto 2. del flujo normal.

20

Caso de uso Gestionar cartas de presentación

Descripción El investigador podrá ver, emitir, editar, agregar y eliminar cartas de presentación (hacer CRUD).

Actores Investigador (secundario)

Precondiciones Existir investigador, Investigador registrado y con sesión iniciada.

Postcondiciones



1. Investigador hace click en “cartas de presentación”

2. Se despliega un listado con las cartas de presentación que estén disponibles.

3. Investigador selecciona carta de presentación.

4. Se actualiza página y se muestran opciones disponibles (agregar, eliminar, ver, editar y emitir).

5.1 Se selecciona una opción (ver).

5.1.1 Sistema despliega información de la carta de presentación.

5.2 Se selecciona una opción (emitir)

5.2.1 Sistema despliega formulario de envío. Se valida y se envía al destinatario escrito.

5.3 Se selecciona una opción (agregar).

5.3.1 Sistema despliega formulario de agregación. Luego de agregar, se valida y se guarda.

5.4 Se selecciona una opción (editar).

5.4.1 Sistema despliega la carta de presentación y permite edición. Luega de la edición, se guarda la carta de presentación.

5.5 Se selecciona una opción (eliminar).

5.5.1 Sistema elimina la carta de presentación designada.

21



2. No se despliega el listado con las cartas de presentación.




4. No se despliega el listado con las opciones disponibles.

4.1. Se envía un mensaje de error. Se vuelve al punto 2. del flujo normal.



2. No se despliega el listado con las cartas de presentación.



Acción frente a no desplegar formularios: Volver al punto anterior. De no poder hacerlo, volver

al “home”

Acción frente a no realizar agregación, edición o eliminación:

Enviar mensaje de error. Para agregación, solicitar nuevamente el ingreso de datos. Para edición, volver

al estado anterior antes de la edición. Para eliminación, volver al estado anterior antes de la

eliminación. Para todos estos casos, solicitar realizar nuevamente la acción.

22

Caso de uso Gestionar sección.

Descripción CRUD, el administrador podrá realizar la edición completa de una sección

Actores Administrador (secundario)

Precondiciones Sesión iniciada como administrador.

Postcondiciones



1. Administrador hace click en “gestionar secciones”

2. Se actualiza página y se muestran opciones disponibles (agregar, eliminar,editar).




3.2.1 Sistema despliega la sección y permite edición. Luega de la edición, se guarda la sección.


3.3.1 Sistema elimina la sección designada y todo su contenido.



2. No se despliega el listado con las opciones posibles.






eliminación. Para todos estos casos, solicitar realizar nuevamente la acción y volver al flujo normal.

24

Caso de uso Gestionar donación

Descripción El administrador y el bibliotecólogo podrán gestionar las donaciones hechas.

Actores Administrador (secundario), Bibliotecólogo (secundario)

Precondiciones Sesión iniciada como administrador y/o bibliotecólogo.

Postcondiciones



1. Se hace click en “gestionar donaciones”

2. Se actualiza página y se muestran las donaciones realizadas por los visitantes.

3. Se selecciona una donación.

4. Sistema despliega información de la donación y despliega opciones de eliminado o guardado.


5.1.1 Sistema elimina la donación designada y todo su contenido.

5.2 Se selecciona una opción (guardar)

25

5.2.1 Sistema guarda la donación en su base de datos.



2. No se despliega el listado con las donaciones realizadas.




2. No se despliega información de la donación designada.

2.1. Se envía un mensaje de error por pantalla. Se vuelve al punto 2. del flujo normal.


Acción frente a no realizar guardado o eliminación:

Enviar mensaje de error. Para guardado, se vuelve a intentar el guardado de manera automática y de no poder realizarlo, se envía mensaje y se vuelve a “home”.Para eliminación, volver al estado anterior antes de la eliminación; luego se solicita volver a

realizar la acción. Se vuelve al flujo normal.

26

Caso de uso Gestionar noticias

Descripción CRUD. El administrador podrá realizar la edición completa de noticias.


Precondiciones Sesión iniciada como administrador

Postcondiciones



1. Administrador hace click en “gestionar noticias”





3.2.1 Sistema despliega la noticia y permite edición. Luego de la edición, se guarda la noticia.


3.3.1 Sistema elimina la noticia designada y todo su contenido.









eliminación. Para todos estos casos, solicitar realizar nuevamente la acción. Luego de alguna opción, se

vuelve al flujo normal.

27

Caso de uso Gestionar registro de usuarios.

Descripción CRUD. El administrador podrá realizar la edición completa de usuarios.


Precondiciones Sesión iniciada como administrador.

Postcondiciones



1. Administrador hace click en “gestionar registro de usuarios”





28

3.2.1 Sistema despliega la información completa del usuario y permite edición. Luega de la edición, se guarda al usuario con sus nuevos valores..


3.3.1 Sistema elimina el registro completo del usuario.









eliminación. Para todos estos casos, solicitar realizar nuevamente la acción. Luego de alguna opción, se

vuelve al flujo normal.

29

Caso de uso Agregar catálogo

Descripción El administrador o bibliotecólogo puede agregar un catálogo guía de los contenidos entregados por sección.

Actores Administrador (secundario), bibliotecólogo (secundario)

Precondiciones Sesión iniciada como administrador o bibliotecólogo.

Postcondiciones Nueva instancia de catálogo.



1.Se hace click en “agregar catálogo”

2. Se despliega formulario con la información necesaria para categorizar el contenido de una sección.

3. Se llena el catálogo con la información necesaria.

4. Se valida el catálogo

5. Se envía mensaje de éxito y se agrega.

30




2.1. Se envía un mensaje de error. Se vuelve al punto 2. del flujo normal de eventos.

31

Conclusiones Como equipo, encontramos algunas dificultades clásicas en el desarrollo de este informe, por ejemplo la falta de comunicación con el cliente y la falta de definición de acciones realizadas por parte de actores que se presentan en los casos de uso (por ejemplo el bibliotecólogo). En este sentido, se necesita que el feedback con el cliente sea más directo con el equipo y más continuo para así enfatizar las funcionalidades que realmente se esperan y desarrollar un proyecto de alto nivel. Por otra parte, la experiencia en sí es muy grata en el sentido de que es un proyecto real que concluye con el producto en sí. Como un punto bajo a la realización de la experiencia, y en consenso como equipo, se tiene que el poco tiempo para la hacer este informe fue bastante decisivo y concluyente. Dado lo anterior, se espera que para próximas iteraciones del informe, la holgura de tiempo sea mayor. Finalmente, se da una visión clara y de fácil comprensión al proyecto que se está realizando, procurando mantener siempre el alcance real, los costos y tiempos necesarios para así asegurar un software de calidad.

32

Entregable1_fisw Pcs - Egi - Ao

Documents

Transcript of Entregable1_fisw Pcs - Egi - Ao