Escolar Documentos
Profissional Documentos
Cultura Documentos
Elaborado por:
Álvaro Fernández
Javier Vásquez
Carlos Andrés Méndez Rodríguez
Versión 01-02-2012
HISTORIA DE VERSIONES
CONTENIDOS
PREFACIO
Propósito
Audiencia
Participantes en el desarrollo del diseño conceptual
Documentos relacionados
Siglas y abreviaturas
I INTRODUCCIÓN
Propósito del sistema
Alcance del sistema
Objetivos y criterios de éxito
Panorama
II REQUERIMIENTOS FUNCIONALES
III REQUERIMIENTOS MÍNIMOS Y DESEABLES PARA EL SAEP SIRZEE
IV REQUERIMIENTOS NO FUNCIONALES
Documentación
Consideraciones de hardware
Características de desempeño
Manejo de errores y condiciones extremas
Cuestiones de calidad
Modificaciones al sistema
Seguridad
Usabilidad e Interfaz de usuario
Seudorequerimientos
Modelos del sistema
Escenarios
Modelo de caso de uso
Modelo de objetos
Interfaz de usuario
COLABORADORES
Muchas personas han formado parte del desarrollo conceptual, educativo y especificación de
requerimientos del SAEP-PitA SIRZEE. A continuación se detallan los participantes y la
organización a las que tales participantes formaban parte en aquel momento.
Académicos participantes
Colaboradores institucionales
UCR
Javier Vásquez, Escuela de Computación e Informática (ECCI)
Carlos Andrés Méndez Rodríguez, Escuela de Computación e Informática (ECCI)
Emma Tuk, consultora en gestión de residuos y educación.
ITCR
Andrés Guzmán, SIRZEE
Rocío Quirós: práctica de especialidad, Escuela de Computación, Sede Santa Clara.
Oscar Lopez, SIRZEE
MEP
Andrés Rodríguez, asesor nacional, Programa Nacional de Informática Educativa
Karla Quesada, asesora regional, Programa Nacional de Informática Educativa, Dirección
Regional de Educación de San Carlos.
Walter Mora, Jefe de Asesoría Pedagógica de la Regional de Educación de San Carlos.
Natalia Rojas, profesora de Informática Educativa, Colegio Teodoro Picado, Alajuelita.
PREFACIO
Propósito
Audiencia
Como mencionamos en el propósito, este documento sirve como una base contractual entre el
cliente y los desarrolladores de software.
Documentos relacionados
1
http://code.google.com Modelos para el Es un documento que
/p/saep- análisis espacial de describe un modelo
pita/downloads/detail? problemas-ODD-MEP- para el análisis espacial
name=Modelos%20par FO_D-SIRZEE de problemas. Utilizado
a%20el%20an%C3%A1li para requerimientos
sis%20espacial%20de% del sistema (SAEP SIR-
20problemas-ODD- ZEE en San Carlos)
MEP-FO_D-
SIRZEE.doc&can=2&q=
2
San Carlos 2010 v2 Requerimientos del
http://code.google.com SAEP-PitA en una
/p/saep- versión siguiente.
pita/downloads/detail?
name=San%20Carlos%2
02010v2.docx&can=2&
q=
Siglas y abreviaturas
CRUD Crear, leer, actualizar y eliminar (Create, Read, Update and Delete).
El sistema está concebido para ser usado en procesos de toma de decisiones respecto a datos
geolocalizables y en la educación ambiental de estudiantes de octavo año del sistema
educativo costarricense. Sin embargo su concepción de implementación incremental, y su
facilidad de integración le permite crecer en sofisticación y complejidad, permitiendo su uso en
contextos más amplios.
El diseño del Saep se asienta en la Internet y por lo tanto posee las facilidades de
comunicación que brinda esta red. Podrá funcionar tanto auto-contenido localmente en un
computador, como en diálogo dinámico entre usuarios o comunidades de usuarios.
Por ese motivo se propone una primera implementación prototipo en un servidor central,
específicamente en el SIR/ZEE, que garantice la privacidad y seguridad de conexión entre
usuarios.
Lo anterior establece una primera etapa en que se atenderá la región Norte y aquellas
instituciones de esa región que tengan conexión vía Internet.
Antecedentes
Para la concepción del SAEP han confluido dos intereses, en primera instancia se ha buscado
una manera de fortalecer la percepción de que la informática es una herramienta a disposición
de otras disciplinas, cuya incorporación en las actividades cotidianas depende de las afinidades
y destrezas de los usuarios, así como también se ha procurado fomentar el uso de
herramientas de carácter libre que soporten la toma de decisiones, sea en la gestión pública o
en la docencia.
Esta estrategia parte del supuesto de que si se brinda una capacitación en la acción, el usuario
de la herramienta no solo tendrá una mejor formación, sino que tendrá una mejor actitud hacia
el análisis poliaxial de problemas espaciales y hacia la solución colaborativa de los mismos.
El SAEP se ha diseñado para ser una herramienta útil en el análisis y evaluación de soluciones
de problemas urbanos, que requieren un ambiente donde se puedan simular posibles
escenarios.
Podemos decir que el SAEP viene a complementar otros esfuerzos hechos por universidades,
gobiernos locales y entes privados para el análisis de problemas urbanos, usando para ello
herramientas de análisis y de simulación. Ejemplos de antecedentes se enumeran a
continuación.
● La empresa Maxis ofrece desde fines de los ochentas e inicios de los 90 un juego
denominado “Sim City” que ha tenido mucho éxito entre sus jugadores, pero que
también ha recibido diversas críticas de los planificadores urbanos por delegar
en una sola persona la decisión de las acciones a tomar, sean de un tipo u otro,
e.g. expansión comercial, destrucción de tierras y designación de la vocación del
terreno.
Como puede verse las simulaciones han sido objeto de estudio y de incorporación en juegos
desde los años setentas, pero no es sino a partir de los años noventas en que su uso se
potencia en mayor medida.
El sistema PitA no es un sistema integral, sino que toda nueva aplicación debe programarse
completamente, i.e. no se simplificaría la reutilización de solución o modelos ya desarrollados.
Por otro lado, Pita propone la integración con una mesa electrónica donde se sitúan
geográficamente objetos, que representan estructuras u objetos físicos de interacción entre
partes. Estos son componentes electrónicos que deben de implementarse e integrar su
identificación espacialmente en la mesa.
PitA pretende establecer un medio físico donde se puedan localizar geográficamente objetos, y
definir relaciones entre esos objetos con el medio ambiente, y en conjunto con un proyector
digital establecer una representación geográfica de referencia.
PitA es un sistema poco práctico en el contexto educativo: habría que implementar una mesa y
usar un proyector para dar una localización espacial, además de un sistema computacional de
alto rendimiento por cada centro educativo, o bien procurar comunicar vía Internet con un
sistema que no ofrece esas posibilidades, es decir reprogramarlo para tales efectos.
Misión
Coadyuvar en el análisis de problemas comunales y permitir que usuarios generen propuestas
de solución.
Se va a permitir que los usuarios trabajen tanto aisladamente como en conjunto, durante la fase
de modelado y la fase de análisis de los datos. Dado que los productos de una fase son
insumos de otras, y que grupos de usuarios pueden participar solo en alguna de dichas fases,
se ha realizado una separación de roles de usuario (como se ve en la figura #1), posibilitando
de esta manera que los usuarios puedan emplear los modelos creados y validados por otros.
Posibles roles de los usuarios son:
1. Modelador de entorno, el usuario que desempeñe este rol se encarga de crear el
ambiente geográfico, i.e. mapa, ubicación de actores, ubicación de canales de
comunicación (carreteras, cuerpos de agua). Específicamente se crearían capas que
luego se pueden visualizar en asocio de otras mediante un servidor de mapas
geográficos, al que se denominará SIG.
2. Sensor ambiental, será aquel encargado de medir tipo y cantidad de datos en el medio
ambiente en un momento dado, e.g. pluviosidad, radiación solar, temperatura, turbidez
de agua, cantidad y tipo de residuos.
Con respecto a los componentes el usuario puede diseñar e implementar una jerarquía de
categorías que pueden interactuar entre si simplificando y ordenando su manejo.
II REQUERIMIENTOS FUNCIONALES
Funciones (métricas)
Las métricas son fórmulas que relacionan los atributos de una categoría (Base de datos
SIRZEE).
En la realización de la métrica se pueden incluir números constantes (enteros y decimales).
Las métricas empleadas quedan registradas en el sistema.
Los atributos de una métrica son: Nombre (cadena), descripción (archivo html o pdf),
autorNombre (cadena), autorFecha (cadena), autorURL(cadena).
Permitir operaciones como sumar, multiplicar, dividir, restar, promedio, porcentaje, mínimo y
máximo.
Contenedores - Transformadores
La creación de un contenedor implica la inclusión una lista de insumos (producidos por otros
contenedores o no), una o más funciones de transformación (métricas) y un producto.
El contenedor puede estar compuesto de otros contenedores.
Los contenedores tienen un atributo icono (el icono tiene coordenadas) por lo que pueden ser
espacialmente georeferenciados.
Al hacer click en el icono, deben visualizarse los atributos del componente de transformación
asociado.
Algunas operaciones que los usuarios pueden requerir para administrar las métricas y
contenedores de cada equipo son:
Modificar contenedor, eliminar métrica, modificar métrica, editar (subir) descripción (archivo pdf)
para métrica y contenedor.
Componentes de Datos
Una categoría (Entidad) representa un tipo de dato almacenado en la base de datos del
SIRZEE.
Una categoría puede tener varios atributos. (Las métricas realizan operaciones con los
atributos)
Las categorías y sus atributos son editables sólo por los profesores. Asimismo, el creador de la
categoría debe otorgar el permiso.
La inserción de datos puede realizarse subiendo un archivo de Excel (también requiere
permiso).
El administrador de la base de datos del SIRZEE debe incluir este proyecto en la base de
datos. Es importante que siempre se conozca si un dato pertenece al proyecto o no.
Además, los componentes de datos tienen un atributo “veracidad” que indica si los datos son
reales o no.
Usuarios y equipos
Los permisos del uso del sistema son otorgados a usuarios que pueden ser estudiantes o
profesores.
Un equipo está conformado por al menos un usuario.
Los permisos de modificación de categorías son otorgados únicamente a usuarios (de
profesores).
Buscador
Dirección URL
Es importante una dirección URL concisa, corta, fácil de recordar y que funcione sin el www.
Metadatos
Sería conveniente el uso de etiquetas que describen el contenido del sitio e incorporan
palabras claves que facilitarán a los motores de búsqueda encontrarlo en sus resultados.
Noticias
Debe tener una sección de noticias recientes para dar a conocer componentes (de
transformación y de datos) que los equipos han incorporado.
Formulario de Contacto
Guía de usuario
En el menú de ayuda mostrar los objetivos del SAEP, sugerencias para alcanzarlos y una
sección de preguntas frecuentes. Lo ideal es contar con un personaje guía interactivo (con
opción de ocultar-mostrar) que ofrezca sugerencias, pasos o “tips” al usuario.
Foro y Sistema de Comentarios
Sistema de Puntuación
1. Noticiero
2. Sistema de puntuación
3. Tener operadores básicos de edición de métricas y contenedores. Los equipos sólo pueden
editar sus propias métricas o contenedores.
4. Comentarios: Equipos pueden ver y comentar contenedores de otros equipos.
5. Facilitar un link para ingreso al sitio más usable.
6. Encargado de evaluación: Revisa si las métricas y contenedores agregados al sitio cumplen
con los requerimientos mínimos. (El resultado de la evaluación final lo puede dar un encargado
de evaluación o mediante un “sistema de mayoría de votos de los profesores”, para esta última
opción habría que crear el usuario tipo profesor).
7. Diferenciar el tipo de usuario estudiante/profesor.
IV REQUERIMIENTOS NO FUNCIONALES
Documentación
El sistema debe ofrecer un manual de usuario para estudiantes y otro para profesores.
Consideraciones de hardware
Se estará utilizando computadoras de los centros educativos y del SIRZEE. Las computadoras
con las que se cuenta pueden tener las siguientes características de hardware o mejores:
Características de desempeño
La siguiente imagen muestra que existen categorías y subcategorías que no tienen Tema o
Características a seleccionar. Esto puede ser un poco incómodo para el usuario por lo que se
espera que se maneje estos errores.
Modificaciones al sistema
Seguridad
Sólo los usuarios registrados y autenticados podrán crear, editar o eliminar (según
corresponda) documentos. Usuarios no autenticados podrán hacer sólo lectura.
Seudorequerimientos
Hola Marlen
Disculpas por la tardanza con esto; la semana pasada tuve que salir de San José, y además hemos
tenido que hablar mucho con doña Anabelle Ulate, mi directora en el Observatorio, con Minor Cordero
en la VAS y con Javier y Carlos Andrés en la ECCI para madurar una respuesta.
Un requerimiento fundamental de mi directora para continuar con nuestra parte en el proyecto es tener
el código del SIRZEE en php. Minor me dijo que habló la semana antepasada con Oscar López sobre
esto, y que Oscar está de acuerdo.
El otro requerimiento es que Andrés termine lo acordado en enero, ya que es indispensable para la
inducción y prueba piloto que tenemos pendientes con los profesores de informática.
Saludos
Fuente: Álvaro Fernández 25 de octubre de 2011 (por correo)
Interfaz de usuario
Creación de métricas
La siguiente métrica calcula la producción de tinte verde que cada distrito podría tener dado su
cultivo de azul de mata.
Se selecciona en Categoría: distritos, subcategoría: distritos, Tema: distritos y Características:
Producción azul de mata. Luego multiplicamos por 563/63 el cuál es un factor que corresponde
al modelo de transformación de papel reciclado de banano.
Resultado esperado al ejecutar la métrica
operadores requeridos
GLOSARIO