Documenti di Didattica
Documenti di Professioni
Documenti di Cultura
Pág.1
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
Pág.2
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
1 PROPÓSITO
El propósito de este documento, es especificar el aplicativo de software para registrar la verificación
de ejecución de contenidos programáticos en la Universidad de San Buenaventura, Bogotá. Este
documento busca detallar los requerimientos funcionales (RF) y requerimientos no funcionales
(RNF) de acuerdo a los tiempos asignados a las profesoras a cargo del proyecto teniendo en cuenta
como tiempo de ejecución para el proyecto un período de once meses del año 2018.
2 ALCANCE
1. Módulo de profesores. Una aplicación web que permite que los profesores registren los
contenidos programáticos de cada uno de los cursos que se le asignaron en la carga
académica, generando un registro por cada una de las sesiones de clase; cada curso puede
tener 2, 3 o 4 créditos distribuidos en una o dos sesiones de clase por semana.
2. Módulo de estudiantes. Una aplicación con acceso para dispositivos móviles que permite
al estudiante registrar la verificación de ejecución de contenidos programáticos en cada una
de los cursos y cada una de las sesiones de clases.
Aunque se propone importar información de ASIS, no se pretende sincronizar dicha información con
la base de datos de ASIS ni modificar en su estructura la misma. Es decir sólo se carga la
información desde un archivo plano separado por comas que se genera de la consulta de la base de
datos de ASIS.
Buscando no generar SPAM y tampoco generar costos adicionales por mensajería de texto con
mensajes cortos de celular, se limitan los informes a consultas o reportes generados a partir de la
aplicación Web publicada.
Pág.3
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
El servicio web y móvil debe servir como herramienta a estudiantes, profesores y directivos
brindando un histórico de contenidos, que representen información exacta de fácil obtención y
oportuna para realización de equivalencias.
Adición de contenidos académicos en forma fácil, al repositorio central el cual mantiene la versión
oficial de cada uno de ellos.
Obtención de informes de cursos de acuerdo a una búsqueda y sus contenidos académicos con
información adicional como semestre en que es ofrecido, profesor quien dirige el curso, y otros.
Un requerimiento no funcional de la decanatura de la facultad de Ciencias Básicas e Ingeniería,
define que la aplicación se debe acceder desde un dispositivo móvil.
5 GLOSARIO DE TÉRMINOS
Modelo del mundo:
Pág.4
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
Sesión: Sesión de clase comprendida por hora de inicio y hora de finalización que debe cumplir con
un contenido que el profesor debe enseñar a los estudiantes.
Pág.5
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
6 REQUERIMIENTOS FUNCIONALES
Pág.6
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
D ESCRIPCIÓN :
Precondición (rango de variables de entrada)
Usuario ()
Contraseña ()
Id_
Descripción
Se extraen y validarán los datos del perfil de administrador.
Se hará la carga a la base de datos de acuerdo al Modelo Entidad Relación propuesto en WEBCONTEUSB.
C RITERIOS DE ACEPTACIÓN
Se supondrá por defecto que hay al menos dos criterios de aceptación:
1. Los datos ingresados por el usuario deben ser válidos (definidos en la precondición)
2. Poder verificar que se hizo lo especificado de manera persistente. Esto es, que la información efectivamente se
guardó de manera correcta en la base de datos propuesta.
3. Poder verificar que se cumplen las restricciones de desempeño, utilización de recursos y seguridad asociadas al
requerimiento.
Pág.8
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
D ESCRIPCIÓN :
Precondición (rango de variables de entrada)
Usuario ()
Contraseña ()
Descripción
Se extraen y validarán los datos del perfil de administrador.
Se hará la carga a la base de datos de acuerdo al Modelo Entidad Relación propuesto en WEBCONTEUSB.
Pág.9
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
C RITERIOS DE ACEPTACIÓN
Se supondrá por defecto que hay al menos dos criterios de aceptación:
4. Los datos ingresados por el usuario deben ser válidos (definidos en la precondición)
5. Poder verificar que se hizo lo especificado de manera persistente. Esto es, que la información efectivamente se
guardó de manera correcta en la base de datos propuesta.
6. Poder verificar que se cumplen las restricciones de desempeño, utilización de recursos y seguridad asociadas al
requerimiento.
D ESCRIPCIÓN :
Precondición (rango de variables de entrada)
Usuario ()
Contraseña ()
Descripción
Pág.10
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
C RITERIOS DE ACEPTACIÓN
SELECT NombreNombre_programa
FROM `Facultad` , `Programa`
WHERE Facultad.Id_facultad = Programa.Id_facultades
AND Facultad.Id_facultad =1
LIMIT 0 , 30
Pág.11
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
E NTRADA : S ALIDA :
El usuario digita el ID del curso. Registro en la base de datos del aplicativo WebConteUSB”.
El usuario puede seleccionar el botón Nuevo para El campo Id_tema es un consecutivo de auto-numeración,
crear un registro: relacionado con los temas.
- Se genera el consecutivo de la sesión
de clase. Según las sesiones que haya
guardado en RF03.
- El usuario digita el contenido del tema o
contenidos de los temas propuestos
referentes a esa sesión.
D ESCRIPCIÓN :
Precondición (rango de variables de entrada)
Id del curso: (código identificador del curso asignado en el pensum del programa académico, número entero)
Número de sesión (número entero, auto incrementado), de acuerdo a las sesiones programadas por curso.
Descripción del tema (cadena de caracteres máximo 200) este campo puede ser editado solo por el profesor.
Descripción
Se digita el identificador del curso y luego se carga desde la base de datos en la página web:
- El nombre completo del curso (cadena de caracteres longitud propuesta máximo 50).
- La facultad, el programa académico, el nombre del curso y semestre académico.
Se capturarán y validarán los datos de la interfaz de usuario.
Post-condición (relacionado con variables de salida)
Se hará el registro en la base de datos de acuerdo al Modelo Entidad Relación propuesto, del contenido académico del
curso.
M ANEJO DE S ITUACIONES ANORMALES
1. Violaciones a la precondición
En caso de que el usuario ingrese datos de entrada inválidos en la validación se le enviará un mensaje de error al
usuario y no se le dejará completar el registro hasta que los datos estén en el formato válido.
2. Usuario sin conexión a internet
Se genera un error al usuario avisando que se requiere de conexión a internet para hacer uso del aplicativo.
C RITERIOS DE ACEPTACIÓN
Se supondrá por defecto que hay al menos dos criterios de aceptación:
Los datos ingresados por el usuario deben ser válidos (definidos en la precondición)
Poder verificar que se hizo el registro del contenido de un curso de manera persistente. Esto es, que la información
efectivamente se guardó de manera correcta en la base de datos propuesta.
Poder verificar que se cumplen las restricciones de desempeño, utilización de recursos y seguridad asociada al
requerimiento.
Pág.12
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
E NTRADA : S ALIDA :
El usuario digita el ID del curso. Generar un PDF con las sesiones de clase verificadas, se
El usuario puede ver en pantalla las sesiones de clase incluye las observaciones del estudiante.
que han sido verificadas por los estudiantes:
- Se genera el consecutivo de la sesiones
de clase que ya han sido verificadas
- Se genera el contenido del tema o
contenidos de los temas verificados.
- Se genera el estado de la clase
verificada.
Pág.13
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
D ESCRIPCIÓN :
Precondición (rango de variables de entrada)
Id del curso: (código identificador del curso asignado en el pensum del programa académico, número entero)
Número de sesión (número entero, auto incrementado), de acuerdo a las sesiones programadas por curso.
Descripción del tema (cadena de caracteres máximo 200) este campo puede ser editado solo por el profesor.
Estado (cadena de caracteres máximo 10) este campo puede ser editado solo por el profesor.
Descripción
El usuario que tiene el rol de profesor o directivo se autentica digitando su usuario y contraseña.
Se digita el identificador del curso y luego se carga desde la base de datos en la página web:
- El nombre completo del curso (cadena de caracteres longitud propuesta máximo 50).
- La facultad, el programa académico, el nombre del curso y semestre académico.
Se capturarán y validarán los datos de la interfaz de usuario.
Post-condición (relacionado con variables de salida)
Se hará la consulta en la base de datos de acuerdo al Modelo Entidad Relación propuesto, del contenido académico del
curso y su estado.
M ANEJO DE S ITUACIONES ANORMALES
3. Violaciones a la precondición
En caso de que el usuario ingrese datos de entrada inválidos en la validación se le enviará un mensaje de error al
usuario y no se le dejará completar el registro hasta que los datos estén en el formato válido.
4. Usuario sin conexión a internet
Se genera un error al usuario avisando que se requiere de conexión a internet para hacer uso del aplicativo.
C RITERIOS DE ACEPTACIÓN
Se supondrá por defecto que hay al menos dos criterios de aceptación:
Los datos ingresados por el usuario deben ser válidos (definidos en la precondición)
Poder consultar las sesiones de clase verificadas manera persistente. Esto es, que la información efectivamente se
guardó de manera correcta en la base de datos propuesta.
Poder verificar que se cumplen las restricciones de desempeño, utilización de recursos y seguridad asociada al
requerimiento.
Profesor Ninguno
Pág.14
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
E NTRADA : S ALIDA :
El usuario digita el ID del curso. Registro en la base de datos del aplicativo WebConteUSB”.
El usuario puede seleccionar el botón Nuevo para El campo Id tema es un consecutivo de auto-numeración,
crear un registro: relacionado con los temas.
- Se genera el No. de sesión de clase.
- Se genera la descripción del tema de la
clase.
- Se genera el estado de la clase.
- El usuario digita las observaciones de
los temas vistos referentes a esa sesión.
Pág.15
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
D ESCRIPCIÓN :
Precondición (rango de variables de entrada)
Se genera un espacio para registrar las observaciones del profesor.
Solo se puede ver las sesiones de clase que se hayan realizado a la fecha
Id del curso: (código identificador del curso asignado en el pensum del programa académico, número entero)
Número de sesión (número entero, auto incrementado), de acuerdo a las sesiones programadas por curso.
Descripción del tema (cadena de caracteres máximo 200) este campo puede ser editado solo por el profesor.
Observaciones del profesor (cadena de caracteres máximo 200) este campo puede ser editado solo por el profesor.
Descripción
Se digita el identificador del curso y luego se carga desde la base de datos en la página web:
- El nombre completo del curso (cadena de caracteres longitud propuesta máximo 50).
- La facultad, el programa académico, el nombre del curso y semestre académico.
Se capturarán y validarán los datos de la interfaz de usuario.
Post-condición (relacionado con variables de salida)
Se hará el registro en la base de datos de acuerdo al Modelo Entidad Relación propuesto, de las observaciones del
profesor en la tabla verificación.
M ANEJO DE S ITUACIONES ANORMALES
1. Violaciones a la precondición
En caso de que el usuario ingrese datos de entrada inválidos en la validación se le enviará un mensaje de error al
usuario y no se le dejará completar el registro hasta que los datos estén en el formato válido.
2. Usuario sin conexión a internet
Se genera un error al usuario avisando que se requiere de conexión a internet para hacer uso del aplicativo.
C RITERIOS DE ACEPTACIÓN
Se supondrá por defecto que hay al menos dos criterios de aceptación:
Los datos ingresados por el usuario deben ser válidos (definidos en la precondición)
Poder verificar que se hizo el registro de las observaciones del profesor de la última sesión de manera persistente. Esto
es, que la información efectivamente se guardó de manera correcta en la base de datos propuesta.
Poder verificar que se cumplen las restricciones de desempeño, utilización de recursos y seguridad asociada al
requerimiento.
I DENTIFICADOR : N OMBRE :
RF07 – Consultar contenido académico por curso
R OLES QUE LO UTILIZAN : R EQUERIMIENTO QUE LO UTILIZA O ESPECIALIZA :
Todos Ninguno
Pág.16
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
Pág.17
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
C RITERIOS DE ACEPTACIÓN
Los datos ingresados por el usuario deben ser válidos (definidos en la precondición)
Poder verificar que se consulta el contenido de un curso de manera correcta. Si se digita un identificador de curso valido
se debe presentar la información registrada en la base de datos.
Todos Ninguno
D OCUMENTOS DE VISUALIZACIÓN ASOCIADOS :
E NTRADA : S ALIDA :
El usuario digita el ID del curso. Se consulta en la base de datos del aplicativo WebConteUSB
Y se presenta en una página Web el contenido del curso
consultado, el número de sesiones que tiene, el total de las
sesiones que han sido verificadas y un porcentaje de
verificación.
De igual manera se carga información del nombre del curso.
Pág.18
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
D ESCRIPCIÓN :
Precondición (rango de variables de entrada)
Id del curso: (código identificador del curso asignado en el pensum del programa académico, número entero).
Descripción
Se digita el identificador del curso y luego se carga desde la base de datos en la página web:
- El nombre completo del curso (cadena de caracteres longitud propuesta máximo 50).
- El identificador de la clase
- El nombre de la clase
- El número de sesiones totales que tiene la clase.
- El número de sesiones que ya han sido verificadas.
- Porcentaje de verificación
Se presentan tantas sesiones de clases verificadas como se encuentre registrados en la base de datos adscritas a ese
curso.
- Número de sesión (número entero, auto incrementado), de acuerdo a las sesiones programadas por curso.
Post-condición (relacionado con variables de salida)
Se despliega una pantalla con los contenidos que han sido cubiertos por cada sesión de clase.
M ANEJO DE S ITUACIONES ANORMALES
1. Violaciones a la precondición
En caso de que el usuario ingrese un identificador de un curso que no existe en la validación se le enviará un
mensaje de error al usuario “Identificador de curso no valido” y se devuelve a solicitar otro código de curso valido.
2. Usuario sin conexión a internet
Se genera un error al usuario con el siguiente texto: “Se requiere de conexión a internet para hacer uso del
aplicativo”.
C RITERIOS DE ACEPTACIÓN
Los datos ingresados por el usuario deben ser válidos (definidos en la precondición)
Poder verificar que se consulta el contenido de un curso de manera correcta. Si se digita un identificador de curso valido
se debe presentar la información registrada en la base de datos.
I DENTIFICADOR : N OMBRE :
RF10 – Consultar los cursos asignados por cada profesor
R OLES QUE LO UTILIZAN : R EQUERIMIENTO QUE LO UTILIZA O ESPECIALIZA :
Pág.19
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
E NTRADA : S ALIDA :
El usuario digita la cédula del profesor. Se consulta en la base de datos del aplicativo WebConteUSB
Y se presenta en una página Web los cursos (las clases)
asignados a cada profesor.
D ESCRIPCIÓN :
Precondición (rango de variables de entrada)
Id del profesor: (número identificador del profesor, número entero).
Descripción
Se digita el identificador del profesor y luego se carga desde la base de datos en la página web:
- El nombre completo del profesor (cadena de caracteres longitud propuesta máximo 50).
- El identificador de la clase
- El nombre de las clases que tiene asignado el profesor
Post-condición (relacionado con variables de salida)
Se despliega una pantalla los cursos que tiene asignado el profesor.
M ANEJO DE S ITUACIONES ANORMALES
1. Violaciones a la precondición
En caso de que el usuario ingrese un identificador de un profesor que no existe en la validación se le enviará un
mensaje de error al usuario “Identificador del profesor no valido” y se devuelve a solicitar otra cédula del profesor
valida.
2. Usuario sin conexión a internet
Se genera un error al usuario con el siguiente texto: “Se requiere de conexión a internet para hacer uso del
aplicativo”.
Pág.20
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
C RITERIOS DE ACEPTACIÓN
Los datos ingresados por el usuario deben ser válidos (definidos en la precondición)
Poder verificar que se consulta el contenido de un curso de manera correcta. Si se digita un identificador de curso valido
se debe presentar la información registrada en la base de datos.
I DENTIFICADOR : N OMBRE :
RF12 – Consultar cursos por estudiante
R OLES QUE LO UTILIZAN : R EQUERIMIENTO QUE LO U TILIZA O E SPECIALIZA :
Estudiante RF13
D OCUMENTOS DE VISUALIZACIÓN ASOCIADOS :
E NTRADA : S ALIDA :
El usuario digita el Id del Estudiante (o código del Se despliega en una página web el listado de cursos inscritos
estudiante). a nombre del estudiante.
D ESCRIPCIÓN :
Precondición
El usuario digita el Id del Estudiante (o código del estudiante).
Descripción
Se consulta en la base de datos del aplicativo WebConteUSB, que cursos tiene inscritos el estudiante.
Post-condición
Se despliega en una página web o en una lista dependiendo el lugar de consulta los cursos que tiene inscritos el
estudiante.
C RITERIOS DE ACEPTACIÓN
Los datos ingresados por el usuario deben ser válidos (definidos en la precondición)
Poder verificar que se realiza la consulta de los cursos para un estudiante valido (con código de estudiante correcto).
Poder verificar que se cumple la validación del estudiante (usuario) de forma correcta, se prueba con uno que existe
y uno que no existe.
Pág.21
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
I DENTIFICADOR : N OMBRE :
RF13 - Registrar verificación de sesión de clase
R OLES QUE LO UTILIZAN : R EQUERIMIENTO QUE LO UTILIZA O ESPECIALIZA :
Estudiante NINGUNO
Pág.22
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
E NTRADA : S ALIDA :
El usuario digita el ID del curso. Registro en la base de datos del aplicativo WEBCONTEUSB.
Se carga en pantalla desde la base de datos del
aplicativo los siguientes datos:
La facultad, el programa académico, el nombre del
curso, el profesor y el horario asignado y el tema o
contenido propuesto para esta sesión.
Documento de identidad del estudiante.
Consecutivo de la sesión de clase.
Fecha actual.
Hora de inicio y hora finalización.
Observaciones del estudiante (este campo puede ser
editado solo por el estudiante no por el profesor).
Observaciones del profesor (este campo puede ser
editado solo por el profesor no por el estudiante).
Pág.23
Elaborado por: Laura Victoria Medina Sánchez
Universidad de San Buenaventura, Bogotá - Formato de Especificación de proyectos de Software
D ESCRIPCIÓN :
Precondición (rango de variables de entrada)
Documento de identidad del estudiante (número entero)
Curso (cadena de caracteres longitud propuesta máximo 25)
Sesión (número entero, auto incrementado dependiendo de la fecha )
Fecha Actual (en formato año-mes-día)
Hora de inicio y hora finalización (en formato hora-minuto-segundo)
Observaciones del estudiante (cadena de caracteres) este campo puede ser editado solo por el estudiante no por el
profesor.
Observaciones del profesor (cadena de caracteres) este campo puede ser editado solo por el profesor no por el
estudiante.
Descripción
Se capturarán y validarán los datos de la interfaz de usuario.
Se tendrá una flexibilidad de 8 días calendario para realizar la verificación de una sesión de clase.
Post-condición (relacionado con variables de salida)
Se hará el registro en la base de datos de acuerdo al Modelo Entidad Relación propuesto.
Pág.24
Elaborado por: Laura Victoria Medina Sánchez