Prctica propuesta para la evaluacin del Laboratorio de Tecnologa de la Programacin.

Septiembre 2006 (Las variaciones respecto del enunciado de Febrero de 2006 figuran en azul)
Publicado: 22-Marzo-2006

Agencia Inmobiliaria Alcal

Una agencia inmobiliaria que va a abrir una oficina en Alcal, nos ha encargado una aplicacin informtica para que sus clientes puedan realizar consultas sobre la oferta de inmuebles que tienen para alquilar o vender. Los elementos a tener en cuenta por la aplicacin, son los siguientes: Empleados Son los empleados de la agencia. La aplicacin debe ofrecer un mdulo (protegido por una contrasea) donde poder dar de alta los inmuebles con todos los datos requeridos, y consultar las transacciones (ventas o alquileres) que han efectuado los clientes. Clientes Son los clientes de la agencia, que podrn utilizar un ordenador con la aplicacin arrancada, realizar bsquedas de pisos, locales, etc. para alquilar o comprar, aplicando filtros por provincia o por precio y en caso de encontrar lo que buscan, llevar a cabo la transaccin. Cada cliente deber identificarse mediante un cdigo de usuario y una contrasea. Si es la primera vez que accede a la aplicacin, el cliente podr registrarse cumplimentando un formulario donde se le pedirn los siguientes datos: Nombre y Apellidos, DNI, Domicilio, Telfono y Contrasea que desea usar. El sistema le asignar un Cdigo de Cliente que estar formado por la letra C y un nmero correlativo empezando en 1001. (Por ejemplo: C1034). Inmuebles La agencia inmobiliaria Alcal ofrecer en venta o en alquiler los siguientes tipos de inmuebles: Locales comerciales: Destinados a una actividad comercial, pueden ser a su vez de dos tipos: Tiendas/Negocios: Destinados a la venta al pblico de productos. Oficinas/Despachos: Destinados a una actividad comercial o profesional. Viviendas: Destinadas a uso residencial. Dependiendo de sus caractersticas, pueden ser: Pisos/Apartamentos: Viviendas construidas en bloques comunitarios.
-1-

 Casas/Chalets: Viviendas unifamilares. ticos/Lofts: Viviendas con caractersticas especiales. Parcelas: Dependiendo de sus caractersticas, pueden ser: Rsticas: Destinadas a explotaciones agrcolas o ganaderas. Urbanas: Para la construccin de viviendas unifamilares.

Los datos a guardar para cada inmueble, dependen del tipo del mismo. Los datos comunes para todos los inmuebles son: Referencia: Es un nmero nico asignado por la aplicacin cuando se da de alta un inmueble. Debe ser un nmero correlativo comenzando por el 1001. Consultas: Nmero de veces que algn cliente ha seleccionado este inmueble visualizando su ficha completa. Alquiler o Venta: Cmo se oferta el inmueble. Fecha de alta: La fecha en que se da de alta el inmueble en la aplicacin. Activo: Booleano para indicar si se ofrece a la venta/alquiler o ya ha sido comprado/alquilado. Fecha de baja: Fecha en que ha sido alquilado o comprado. (Solo si no est activo) Cliente: Cdigo del cliente que ha adquirido o comprado el inmueble. (Solo si no est activo). Direccin: Calle y nmero donde se encuentra el inmueble. Poblacin: Donde radica el inmueble. Cdigo Postal: Del que obtendremos la provincia para acotar las bsquedas. Fotografa: Representativa del inmueble (exterior o interior). Superficie: Nmero de metros cuadrados. Precio: En euros de venta o cuota mensual del alquiler. Antigedad: Nmero de aos desde su construccin (no aplicable en parcelas). Observaciones: Texto libre para indicar caractersticas a destacar del inmueble. Viviendas En el caso de que se trate de una vivienda, tambin se guardarn los siguientes datos: A estrenar: Si va a ser la primera ocupacin o es de segunda mano. Nmero de dormitorios: Nmero de dormitorios. Nmero de baos: Nmero de baos. Piscina: Si tiene o no piscina. Para los pisos y apartamentos, se deben aadir: Calefaccin: Si tiene o no y si es individual o central. Planta: La planta en que est el piso (baja, 1, 2, etc.). Portera: Si tiene o no portero. Y en el caso de ticos y lofts, adems de todos los datos correspondientes a los pisos, se guardar: Superficie de terraza: En metros cuadrados.
-2-

 Superficie del saln: En metros cuadrados. Altura de techos: En metros. Para las casas y chalets, adems de los datos generales de las viviendas, se registrarn: Superficie de la parcela: En metros cuadrados. Nmero de plantas: Las que tenga construidas. Adosado: Si es adosado o no.

Locales comerciales Adems de los datos comunes ya expuestos, se debern registrar los siguientes: Actividad anterior: A qu actividad se dedic anteriormente el local. Traspaso: Precio a pagar por el traspaso (slo en el caso de alquileres). Cuando se trate de una tienda o negocio, se aadirn: Centro comercial: El nombre del centro comercial en que est ubicado en caso de estarlo en uno. Escaparate: Superficie en metros cuadrados de escaparate. Y si es una oficina o un despacho: Servicios comunes: Si dispone o no de servicios comunes y un texto describiendo los mismos (recepcin, correo, secretariado, informacin, etc.) Parcelas Adems de los datos comunes ya expuestos, se debern registrar los siguientes: Actividad anterior: A qu actividad se dedic anteriormente la parcela. Cuando se trate de una parcela rstica, se aadirn: Secano/regado: Qu tipo de cultivo admite. Y si es una parcela urbana: Edificabilidad: Nmero de metros cuadrados que se pueden construir. Numero de plantas: Nmero de plantas que se pueden construir.

Requisitos funcionales Mdulo de Empleados Al arrancar la aplicacin, ofrecer dos mdulos diferentes: Empleados y Clientes. Para acceder al mdulo de empleados, la aplicacin requerir una contrasea que no deber ser visualizada en la pantalla. Una vez dentro de este mdulo, los empleados de la agencia tendrn tres opciones:
-3-

 Altas de inmuebles: La aplicacin ofrecer las ventanas adecuadas para que el empleado cumplimente todos los datos referentes al inmueble, adaptndose al tipo de inmueble que se est dando de alta. Una vez cumplimentados todos los datos, la aplicacin le asignar un nmero de referencia y lo introducir en su archivo de inmuebles en oferta. Consulta de cartera de inmuebles: La aplicacin mostrar una lista con todos los inmuebles que se ofertan en la agencia indicando Contrato (alquiler o venta), Tipo de inmueble, Poblacin, Nmero de das que ha estado en oferta, Precio y Nmero de consultas. Listados de contrataciones: La aplicacin producir dos listados: uno con todos los inmuebles vendidos en un archivo de nombre ventas.txt y otro con todos los inmuebles alquilados en el archivo alquileres.txt en los que deben figurar, como mnimo, los siguientes datos: Tipo de inmueble, Poblacin, Nmero de das que ha estado en oferta,Precio (Pueden aadirse los que se consideren oportunos). Ambos archivos debern llevar una lnea de cabecera con el ttulo Alquileres (o Ventas) de la agencia Alcal a fecha: aaaa/mm/dd.

Mdulo de Clientes Los clientes pueden arrancar la aplicacin e ir directamente al mdulo Clientes sin necesidad de introducir contrasea deben identificarse mediante su cdigo de cliente y su contrasea. La aplicacin ofrecer, en esta misma ventana, la posibilidad de registrarse como nuevo cliente a los usuarios que no dispongan de cdigo de cliente. Una vez registrado, ya podr usar la aplicacin identificndose. Los datos de registro de clientes, debern guardarse indefinidamente. La aplicacin les ofrecer dos opciones: Bsqueda: Para que pueda consultar las ofertas de inmuebles que tiene la agencia y en su caso, poder elegir el que se adecua a sus necesidades y posibilidades. Contratacin: Para que en el caso de haber encontrado lo que estaba buscando, pueda llevar a cabo la operacin de compra o alquiler. Bsqueda La aplicacin ofrecer una primera ventana donde el cliente pueda acotar su bsqueda por los siguientes campos: Tipo de operacin: Alquiler o compra de inmueble. Tipo de inmueble: Un desplegable le permitir elegir entre los distintos tipos de inmuebles que se ofertan en la agencia. Provincia: Un desplegable con todas las provincias le permitir elegir la que desee. Precio mximo: Un cuadro de texto le permitir introducir el precio mximo que est dispuesto a pagar. En todos los desplegables, la aplicacin deber ofrecer una opcin con la denominacin de Cualquiera, para permitir que no se tenga que aplicar el filtro correspondiente (por
-4-

ejemplo un cliente que busca una oficina y no le importa en qu provincia est) y en el caso del precio mximo, si el cliente lo deja en blanco es porque no tiene limitacin de presupuesto (que suerte!). Un botn siguiente en esa ventana llevar a producir una lista con todos los inmuebles que satisfacen los criterios de bsqueda aplicados. De esa lista se deber poder seleccionar un elemento ya sea por su referencia o pinchando sobre el elemento con el ratn y la aplicacin mostrar entonces la ficha completa del inmueble con todos sus datos incluyendo la fotografa. En el caso de que el inmueble mostrado en la ficha sea el que estaba buscando nuestro cliente, un botn contratar le llevar a la opcin de contratacin. Si se cierra la ficha, la aplicacin volver a la lista de inmuebles para poder seguir viendo los datos completos de otro. Si se cierra la lista, la aplicacin volver a la ventana de filtros para que el cliente pueda modificar sus criterios de bsqueda (por ejemplo al ver los precios cambia su idea de comprar y se decide a alquilar). Si se cierra esta ventana se volver al men inicial de buscar o contratar. Contratacin En el caso de que el cliente haya encontrado lo que buscaba, la aplicacin le ofrecer una ventana en la que deber cumplimentar sus datos (nombre y apellidos) y aceptar. La aplicacin marcar entonces el inmueble como no activo (por lo que ya no volver a salir como resultado de ninguna bsqueda posterior) y rellenar automticamente los datos de Cliente y Fecha de baja. A la ventana de contratacin se podr tambin entrar directamente utilizando la referencia del inmueble. Almacenamiento de los datos Cada vez que se arranque la aplicacin, tendr disponibles todos los datos almacenados desde la ltima vez que se utiliz, incluidos los de registro de clientes. Del mismo modo, al terminar la sesin, debern guardarse todos los datos actualizados. Se utilizarn para ello los archivos que sean precisos.

Validacin de Cdigos Cuando la aplicacin solicite la introduccin del cdigo postal, deber comprobar que se trata de uno vlido antes de continuar procesando. Para ello, dispondr de una clase especial cuyo nombre deber ser CodigoPostal donde estarn los mtodos estticos para comprobar cdigos postales y para obtener el nombre de provincia a partir del cdigo postal. Cdigos Postales

-5-

Tienen la forma a1a2a3a4a5 donde a1a2 es un cdigo de provincia y los otros tres son dgitos decimales. Cdigos de Provincia Estn formados por dos dgitos decimales con arreglo a la siguiente tabla:
Cdigos de provincia 01 lava 02 Albacete 03 Alicante 04 Almera 05 vila 06 Badajoz 07 Islas Baleares 08 Barcelona 09 Burgos 10 Cceres 11 Cdiz 12 Castelln 13 Ciudad Real 14 Crdoba 15 La Corua 16 Cuenca 17 Girona 18 Granada 19 Guadalajara 20 Guipzcoa 21 Huelva 22 Huesca 23 Jan 24 Len 25 Lleida 26 La Rioja 27 Lugo 28 Madrid 29 Mlaga 30 Murcia 31 Navarra 32 Orense 33 Oviedo 34 Palencia 35 Palmas, Las 36 Pontevedra 37 Salamanca 38 Sta. Cruz de Tenerife 39 Cantabria 40 Segovia 41 Sevilla 42 Soria 43 Tarragona 44 Teruel 45 Toledo 46 Valencia 47 Valladolid 48 Vizcaya 49 Zamora 50 Zaragoza 51 Ceuta 52 Melilla

Requisitos generales Todo el diseo de la interfaz grfica, deber realizarse utilizando NetBeans. La aplicacin deber presentar una interfaz grfica de usuario, intuitiva y fcil de utilizar por los clientes de la agencia inmobiliaria. En todas las ventanas debern visualizarse el anagrama de ALCALA - se admiten ideas para su diseo - en el margen superior izquierdo y el cdigo de cliente y la fecha en el derecho. Para poder comprobar el buen funcionamiento de la aplicacin, se deber poder arrancar con un conjunto amplio y variado de inmuebles en la cartera de la agencia, almacenados de sesiones anteriores. Dicho conjunto deber incluir los tipos necesarios para probar el mayor nmero posible de casos. Por ejemplo: Listar todos los inmuebles que se ofrecen en la agencia. Listar todos los inmuebles que ya han sido contratados.

-6-

 Buscar un piso en Madrid para comprar por menos de 100000 euros (que salgan varios ya que se trata de una simulacin!). Todo aquello que se considere oportuno para mostrar casos de prueba que permitan resaltar la calidad de la aplicacin desarrollada. El sistema debe ser robusto frente a fallos y no abortar por circunstancias imprevistas. La aplicacin estar escrita en lenguaje Java, compatible con Java2. No debern utilizarse clases o mtodos obsoletos (deprecated). Los programas fuente debern ser fciles de mantener por cualquier programador experto en Java. Debern estar bien estructurados y contendrn los comentarios necesarios para un fcil seguimiento del cdigo. Los requerimientos recogidos en el presente documento, deben entenderse como mnimos que debe cumplir el sistema, pudiendo ser presentadas cuantas mejoras crea convenientes el equipo de diseo.

Entregables En papel La documentacin debe redactarse para ser leda por un hipottico tcnico informtico que tuviese que evaluar nuestro sistema informtico y recomendar a la agencia inmobiliaria que lo adquiera o no. La documentacin del sistema propuesto por el equipo de diseo, deber incluir: Portada En la portada de la memoria, se incluir: Ingeniera Tcnica en Informtica de _________ Laboratorio de Tecnologa de la Programacin. Curso 2005/06 Prctica: AGENCIA INMOBILIARIA (Septiembre) Autor(es): DNI Apellidos, Nombre DNI Apellidos, Nombre (si se hace entre 2) Especificacin de requisitos. Se deben especificar las secuencias de acciones que se realizan con el sistema desde la perspectiva del usuario. Se describen mediante los denominados diagramas de casos de uso. Anlisis de alto nivel. En este apartado se debe explicar el anlisis de la solucin de la prctica, es decir, una explicacin general de cmo se ha desarrollado la aplicacin y qu elementos principales intervienen en la misma. Para realizarlo se

-7-

construye el Modelo de Objetos Conceptual o Modelo de Anlisis mediante un diagrama de clases sencillo, identificando las clases de negocio. Diseo del sistema. En este apartado se deben explicar cada una de las clases del sistema con sus relaciones correspondientes. Para realizarlo se utiliza un diagrama de clases detallado mostrando cada una de las clases con sus atributos y mtodos as como las relaciones con otras clases. Implementacin. En este apartado se puede detallar el cdigo fuente de las clases principales de la aplicacin (clases de negocio), as como las estructuras de datos utilizadas para almacenar la informacin que maneja el sistema. Si se considera que el cdigo de alguna clase no es del todo relevante o que no aporta mucha informacin no es necesario incluirlo (por ejemplo las clases de la interfaz grfica de usuario). Construccin del sistema. Este apartado incluye la documentacin generada automticamente por Java con JavaDoc de cada una de las clases del sistema. Esta documentacin no es necesaria incluirla en papel, tan solo en algn directorio especfico en el disco. Para generarla utilizar el comando javadoc desde el directorio donde se encuentran las clases del proyecto. Manual de usuario. En este apartado se explicar como interacta un usuario con la aplicacin. Es conveniente capturar las pantallas de la aplicacin (se hace con las teclas Alt + Impr Pant y luego se pegan en el texto) y hacer un seguimiento de las distintas opciones. Manual de administracin. En este apartado se explicar cmo se puede implantar el sistema, es decir cmo instalarlo y mantenerlo. Se debe indicar cul es la estructura de directorios utilizada y cul es la clase principal que debemos ejecutar. Tambin se debe indicar de qu ficheros habra que hacer copias de seguridad para poder recuperar los datos que maneja la aplicacin en caso de desastre. Casos de prueba. En este apartado se explicarn las distintas pruebas a las que se ha sometido a la aplicacin as como la informacin que tiene almacenado el sistema actualmente.

La calidad de la documentacin presentacin, estructura, contenido ser un elemento bsico en la evaluacin de la prctica, representando el 40% de la calificacin final.

En disquete o CD Acompaando a la memoria del proyecto, se incluir un disquete o CD libre de virus y de errores , etiquetado con los nombres de los autores y que contendr: - Fichero word con la documentacin impresa - Todos los archivos con los programas fuente (.java) de la aplicacin as como el proyecto en NetBeans (guardando la carpeta del proyecto es suficiente).
-8-

Los archivos necesarios para arrancar el sistema simulando un estado no inicial de funcionamiento (con clientes y productos dados de alta anteriormente), que permita comprobar que se cumplen las especificaciones formuladas.

Consideraciones Los equipos de diseo estarn formados por una o dos personas. En el caso de dos integrantes, ambos debern conocer todos los detalles del diseo y el funcionamiento de los programas. Con el objetivo de verificar la autora de la prctica, el profesor podr solicitar a los diseadores, la implementacin de cdigo no recogido en el presente enunciado o la modificacin de algn aspecto de la aplicacin. Los alumnos que no sepan introducir adecuadamente las modificaciones solicitadas sern evaluados como SUSPENSO, independientemente del contenido y calidad de la prctica entregada. La prctica deber ser realizada ntegramente por los alumnos que la entregan y no podr, por tanto, basarse en prcticas realizadas y entregadas por otros alumnos en convocatorias anteriores. Si se detectan prcticas realizadas de acuerdo a este sistema sern calificadas como SUSPENSO. La fecha de entrega ser el da designado por la Escuela para el examen de Septiembre del Laboratorio de Tecnologa de la Programacin. Cada profesor establecer una lista para poder reservar las horas exactas de entrevistas para cada grupo y evitar esperas. La falta de alguno de los elementos entregables, supone la imposibilidad de presentarse al examen. La evaluacin de la prctica se llevar a cabo mediante una entrevista en la que el grupo de diseo deber mostrar el funcionamiento de su aplicacin y someterse a las preguntas individuales que se consideren necesarias. Sugerencia: Buscar en Internet agencias inmobiliarias que ofrezcan servicios de alquiler y venta on-line para ver cmo estn diseadas y obtener ideas acerca del funcionamiento de las aplicaciones y de las interfaces de usuario.

-9-