Documentación que genera un proyecto

• Evidentemente no todos los proyectos generaran la misma documentación.
• Realizaremos la siguiente clasificación

1. Documentación en la gestión del proyecto.
2. Documentación de la .realización del proyecto.

Forma de desarrollar un proyecto

Desarrollando un proyecto

• En la imagen vemos el desarrollo de un proyecto se va a organizar o dividir en fases
• En cada fase realizaremos una serie de actividades que a su vez se pueden descomponer en tareas
• La idea es proponer una METODOLOGÍA de trabajo que se pueda adaptar a los diferentes tipos de proyectos.
• Cada proyecto según su naturaleza se hace de una manera u otra, no obstante existe cierta parte común que pretendemos extraer y exponer.

Metodología

• La metodología es la forma de llevar a cabo un trabajo.
• Metodología para nosotros será la manera de gestionar y realizar el proyecto.

Definición

Metodología' conjunto de procedimientos (actividades y tareas), herramientas y técnicas utilizadas con el objetivo de llegar a la realización correcta de un proyecto planteado

Metodología

• Ténicas; diagramas y documentos de texto explicativos.
• Herramientas; editor de texto, Diagramadores como Dia y herramientas de gestor de proyectos como ProjectLibre Microsoft Project
• Procedimientos o métodos: dividir el proceso en fases

Ciclo de vida de desarrollo del proyecto

• Seguiremos un ciclo de vida secuencial

• Este vacío es especialmente peligros en proyecto de naturaleza lógica como de software

Ciclo de vida

• La metodología nos va a permitir organizar ese ciclo de vida del proyecto

Definición

Ciclo de vida tiempo que transcurre desde que se plantea el proyecto hasta que éste se entrega de forma correcta (cumpliendo las especificaciones planteadas)

• Objetivo: aplicar una metodología a ese tiempo

Definición

El ciclo de vida son las diferentes etapas o fases por las que va pasar el proyecto desde su concepción hasta su implantación o entrega al cliente

Fases

• En cada fase realizaremos actividades que van a darnos un determinado producto dentro del desarrollo del proyecto.
• Este producto puede constar de uno o varios documentos que lo constituyen.
• Una fase termina en un momento determinado y permite verificar el producto obtenido
• Cada fase ha de ser identificada con un hito
• Hito: fecha concreta marcada en la planificación.

Hito

• Fechas importantes marcadas en la planificacion temporal del proyecto

Los Hitos

• Es muy importante establecer los hitos en la planificacion del proyecto
• Estas fechas establecidas no deben de ser muchas
• En ellas el cliente y la empresa se juntan y evaluan el proyecto, tanto la marcha del mismo como la calidad
• Esto implica que en esa fecha se ha de poder evaluar parte del producto, prototipo o documentación que verifique la marcha y calidad del mismo
• Lo que se le enseñe al cliente ha de ser tangible para él.
• Puede haber hitos en los que no intervenga el cliente

• Un hito implica una reunión de evaluación del proyecto
• La reunión se ha de preparar, planificar y realizar
• El alumno nos pueden enseñar el proyecto y ellos mismo pueden ver como van
• Al menos un hito por fase debería de ser obligatorio.

Estableciendo fases

• Cada metodología establece una serie de fases, nosotros proponemos las siguientes

1. FASE INICIAL
2. FASE ACUERDO DEL PROYECTO
3. FASE DE ANÁLISIS Y DISEёO
4. FASE DE IMPLEMENTACIÃÓN
5. FASE DE PRUEBAS
6. FASE DE CIERRE O FINALIZACIÓN

Desarrollando un proyecto

1. El contexto
2. La documentación

Antes de empezar el proyecto: El contexto

• Antes de empezar a analizar las fases propuesta y los productos a obtener unas consideraciones
• Pueden ser interesantes para dotar al proyecto de un contexto mas real
• El alumno representa una empresa, por lo que sería interesante especificar

Nombre de la empresa

Logotipo de la empresa

• Quizás pueda parecer una pérdida de tiempo, pero la experiencia demuestra el alumno se mete más en el papel de empresario desarrollador.

Creación de la empresa

• Puede coordinarse esta acción con el docente de EIE

	Idea
	En el módulo e Empresa e Iniciativa Emprendedora puede crear su empresa Después usar esa empresa para el proyecto que quiran o vayan a realizar

La documentación

• Normalmente les entregamos en la normativa de la forma de entregar el proyecto como han de documentar (tipo de letra etc....)
• También se les puede proponer que entregue un documento especificando este hecho
• Está claro que todos los documentos que entreguen han de tener un formato similar
• Tendrá que tener un Ãíndice, una cabecera con nombre de la empresa y logotipo, nombre del docuemnto, numeración ...

El documento de formato

• La empresa tendrá un formato concreto de cómo para hacer los proyectos.
• Es un documento que se puede pedir como parte de la gestión del proyecto
• Parte serán requisitos que se les pida a los alumnos, los cuales pueden incluir en el documento
• Es bueno que se configuren las herramientas para adaptar el proyecto con el mismo formato.
• Por ejemplo el openoffice o word, incluir índices de forma aútomática, teclas para especificar formatos, estilo de títulos, ....

	Ejemplo
	documento de formato

Archivo:Formato.pdf

Fase Inicial

• Es la primera fase.

Objetivo

el alumno/a propone/selecciona un proyecto

• En esta fase suele haber mucha incertidumbre
• A veces es difícil proponer proyectos (será largo, corto, fácil, difícil)
• La experiencia nos irá eneñando en este aspecto
• Es posible que se asignen proyectos y durante su realización se tengan que acortar

El Calendario en la Fase inicial, cuando realizarla.

• Para nuestro proyecto sería bueno que esta fase la cubriera la alumna en una fecha concreta.
• Según legislación en enero los alumnos deben conocer la lista de posibles proyectos a realizar.
• El alumno ha de presentar la propuesta de su proyecto.
• Es posible que un alumno/a tenga una idea de proyecto incluso empezado y cuando va a la empresa cambia de proyecto.
• Es una realidad frecuente.

El Calendario en la Fase inicial

• Se debe poner una fecha para que el alumno haga su propuesta de proyecto al departamento de informática por medio del tutor.

Entrada a esta fase

1. Lista de posibles proyectos que el departamento proponga
2. Lista de posibles proyectos de empresas donde se realicen las FCT's
3. Propuesta directo de alumnos/as del ciclo

Actividad

Consiste en la elección de un proyecto

Salida

La propuesta del proyecto: Título y objetivo principal

• El siguiente es un documento que se entrega a los alumnos y podemos analizar en él diferentes apartados
• Lo podemos ver para ver títulos de proyectos

Archivo:EjemploListadoProyectos.pdf

El título del proyecto

• El título no ha de ser muy largo, el título no son los objetivos, Representa lo qué queremos realizar.
• Debe ser conciso y expresar de la manera más precisa posible el trabajo a realizar.
• Debe ser válido durante todo el ciclo de vida del proyecto.

Pregunta

El título del proyecto

• Propuesta de MIDEPLAN

Ejemplos de títulos

Objtivo general

• Es un resumen de todos los objetivos específicos que puediera haber y guardará una relación directo con el título del proyecto.
• Consiste en reflejar la meta a la que deeamos llegar con la realización del proyecto
• Objetivo una descripción un poco más larga del título. Podríamos pensar en uno o dos párrafos de no más de 4 o 5 líneas cada uno, aunque dependiendo del tipo de proyecto y forma de expresarse de la alumna podría alargarse más.

Fase inicial: Documento de propuesta

La salida de la fase inicial es un documento de propuesta dle proyecto

• En una hoja o bien la primera hoja de dosier del proyecto debe ser la propuesta del mismo
• Debe de especificar el título del proyecto y el objetivo general
• Debe de ir fechado.

Archivo:PropuestaProyecto.pdf

Fase de Acuerdo

• Esta es la fase qué más nos interesa
• Es una fase común para todos los proyectos
• Culmina en el documento de contrato entre cliente y desarrollador

Actividades en la fase de Acuerdo

Presupuesto

Planificacion

Lista de requisitos

Pliego de condiciones

Contrato firmado

Lista de Requisitos

• Consite en establecer los requisitos del sistema

Entradas

• Son muchas la técnicas para obetener información
• Esta es una actividad primordial
• De ella depende todo el proyecto
• Debe de haber entendimiento y compresión.
• Es mejor repetir los puntos importantes para asegurar la comprensión del problema
• Muchos problemas no se pueden resolver por que no se entiende bien el planteamiento, no por que no se sepan resolver

Aparecen problemas de comunicación

Se que tu crees que yo entiendo lo que tu dices pero de lo que no estoy tan seguro es de que lo que tú has querido decir es lo que yo he creído entender

Entrevistas

• En nuestro caso son reuniones con el alumno/profesor o el alumno en su centro de trabajo con la empresa
• Es importante que las entrevistas estén preparadas
• Debería de quedar documentado el resultado de cada una de ellas por escrito

Salida

Lista de requisitos

• En un documento de texto detallamos una tabla cada requisito perfectamente identificado
• Un requisito a de responder a un objetivo claro del producto
• Ha de ser perfectamente evaluable con el producto final
• No puede haber ambiguedades

Los requisitos

• Evitar los condicionales y verbos imprecisos

El sistema debería de ....

El producto debe de ser amigable

• • Amigable para quién, cuanto de amigable ????
• No puede haber requisitos ambiguos o incompletos, no se pueden dejar cosas abiertas

Los requistos

• Los requisitos no son el pedido del cliente, no es el objetivo que pretende del proyecto.
• Los requisitos los determina el desarrollador a partir de la información que obtiene del cliente.

1. Entrevistas(personales, colectivas, lluvia de ideas, ...)
2. cuestionarios
3. En general cualquier técnica que nos aclarare qué es lo que realmente tiene que hacer el proyecto.

Los requisitos

• Al determinar los requisitos el desarrollador a veces abre los ojos al cliente de qué es lo que quiere
• En muchas ocasiones se verifica la viabilidad/inviabilidad de determinadas pretensiones.

Ejemplo de lista de requisitos

Lista de tareas

Lista de tareas entradas

• A partir de la lista de requisitos identificamos cada tarea.
• Cada tarea estará identificada con un nombre de sigla por ejemplo T1, .. Tn.
• Cada tarea tendrá de una pequeña descripción.
• Tendrá un tiempo de realización que hay que asignar.
• El tiempo que determinemos estará basado.
  • En nuestra experiencia.
  • En registros de tiempos que tengamos.
• Hay que intentar asignar cada tiempo de forma real y lo mas aproximado posible.

Dependencia entre tareas

• Normalmente las tareas son dependientes
• Esto implica que hasta que no terminemos una determinada tarea, no podremos empezar otra
• En la lista de tareas es importante especificar esta dependencia de prelaciones entre tareas
• También es importante tener en cuenta los recursos necesarios para cada tarea
• Este recurso también se asociará a la tarea que lo necesite

Ejemplo donde podemos ver tareas

El Pert

• Este método es una técnica gráfica de grafo dirigido, el cual permite establecer la dependencia de las tareas y marcar el tiempo que se tarda en realizar el proyecto planificado.
• En este método los cículos del grafo representan la etapa en la que se encuentra el proyecto habiendo terminado en una etapa un número determinado de tareas
• El arco con nombre representa una tarea que me lleva de una etapa a otra

Archivo:EjemploPert.pdf

El pert

• Podemos ver el siguiente fichero para entender esta sencilla técnica
• Para hacer el pert necesitaremos una tabla de prelaciones de las tareas o matriz de encadenamientos
• Para ver estos conceptos miramos el siguiente fichero

https://docs.google.com/document/d/12e3_JwQKaQICz-y0Y5Xg4RVgHGPfgLNTqwlOe_h9vqI/edit?hl=en

La planifiacion:Diagrama de Gantt

• Es otro forma de represnetar el espacio temporal en hacer el proyecto
• en este caso no se represnetan la prelaciones aunque lógicamente hay que respetarlas

El diagrama de Gantt

http://es.wikipedia.org/wiki/Diagrama_de_Gantt

• Es una herramienta gráfica soportada por casi todos los gestores de proyectos que permite establecer el espacio temporal del desarrollo del mimos
• A partir de él se establece el calendario de hitos
• Al finalizar determinadas tareas es conveniente establecer una verificación del producto

El diagrama de Gantt y el calendario de hitos

Ralizar revisiones durante la realización del proyecto es importante y necesario

• Permite ver si el proyecto va marchando según lo establecido
• Permite establecer momentos en los que se verifica la calidad del producto.
• Un hito debería de implicar una reunión con el cliente, en este caso con el profesor
• Esa reunión debería de estar preparada y generar un acta o registro de dicha reunión
• Esto se pude recoger en un documento de reuniones

Registro de reuniones

• De la siguiente url podemos sacar ideas para las plantillas de las reuniones

http://wiki.es.it-processmaps.com/index.php/Gesti%C3%B3n_de_proyectos_-_plantillas,_listas_de_control_y_recomendaciones

El presupuesto

El presupuesto

• Para su elaboración contamos con el diagrama de tareas
• Obtener el precio/hora según la labor realizada
• Debemos saber los recursos que utilizamos
• Este tema es importante elaborarlo teniendo en cuenta los contenidos impartidos en EIE
• No olvidar precio/hora en difernetes roles
• Aplicar los impuestos
• Obtener el total neto (Sin impuestos) y el total bruto (aplicando impuestos)

Pliego de condiciones y contrato

• En los proyectos de empresas el pliego de condiciones normalmente siempre existe
• Para nosostros sería interesante añadir alguna condición
• Por ejemplo que el desarrollador no se hace cargo del mantenimiento si no se realiza un uso correcto del producto o si manipula los fuentes o la maquinaria , ...
• Tampoco interesa mucho extenderse, pero sí que exista y haya algún punto.presencia

En el acuerdo todos somos muy positivos y cedemos mucho, pero luego hay que acarrear con las consecuencias de lo que hayamos pactado

El contrato

• Puede parecer un poco frívolo, pero es interesante realizarlo
• En él debe de aparecer el nombre de la empresa ficticia que representa el alumno, y el nombre del cliente, en este caso el ciclo formativo que está cursando y módulo del proyecto
• Debe aparecer explícitamente

1. Nombre del proyecto
2. Nombre de la empresa con su representante legal que en este caso es el alumno,
3. Nombre del cliente con su represnetante que sería el tutor del ciclo
4. El importe total al que asiciende el presupuesto tanto en neto como en bruto
5. La fecha de comienzo y de finalización
6. Fecha y lugar de entrega
7. Es recomendado que esté firmado, constituyendo la fecha de la firma del proyecto el primer hito importante para la realización del proyecto.

Fase de análisis

• Todos los documentos generados que van encaminados a dejar claro qué es lo que se pretende hacer con el proyecto.
• Hay proyectos que esto está claro con el pedido que hace el cliente
• Hay proyectos como en el caso del software que esto hay que refinarlo y hacerlo, acercando las pretensiones del cliente al mundo real para su elaborción

Quiero un sistema de automatización en mi casa con control de presencia para alarmas

• Está claro qué es lo que quiere el cliente
• Pero no está tan claro que es lo que tiene qu hacer el proyecto.

Fase de análisis y diseño

La fase de análisis

	Idea
	Todo aquello encaminado a aclarar y planificar qué es lo que queremos hacer correspondería a hacer un análisis del mismo. Los prototipos pueden ayudar de forma clara esta fase.

Fase de diseño

• El diseño puede considerarse otra fase o estar dentro de la fase anterior
• Esta fase sería una evolución de la parte anterior
• Una vez que sabemos qué queremos hacer pasamos a un segundo estado en el que vemos cómo lo vamos a hacer.
• Usar diagramadores es una técnica muy buena para estos casos

Fase de implementación o desarrollo y pruebas

Implementacion

• Consiste en el desarrollo del proyecto
• Se lleva a cabo la implementación de sus partes
• Debe de ser una continuación de la fase anterior
• Normalmente las fase de implementación va fluyendo en espiral con las anteriores
• Es decir no es muy habitual hacer un análisis y diseño completo y luego la implementación

Las pruebas

• La fase de pruebas debe de estar presente en todo el proyecto
• En cada uno de los hitos del mismo
• Deben de analizarse y verificarse los requisitos planteados
• Al final ha de verificarse de forma satisfactoria cada uno de los requisitos pactados

Fase de entrega

La entrega

• El sitio y la forma son importantes
• Esta información se le debe de entregar al alumno
• Normalmente queda establecido previamente

Lista de documentos a entregar

1. Acuerdo del proyecto o contrato
   1. Planificación
      1. Diagrama de Gantt
      2. Pert como diagrama de prelaciones
      3. Calendario de hitos
   2. Lista de tareas
      1. Diagrama Pert
   3. Presupuesto
      1. Amortización del material/recursos/inmovilizado/seguros a utilizar en el proyecto
      2. Impuestos según corresponda
      3. Cantidad total neta/bruto del proyecto
   4. Lista de requisitos (concretos y verificables)
   5. Pliego de condiciones
   6. Contrato
2. Documentos de análisis y diseño
3. Documento de implementación y manuales de uso según proceda
4. Documento de pruebas (Plan de pruebas y realización de la mismas
5. Otros documentos de la gestión
   1. Diario de bitácora
   2. Documento de reuniones (de cada hito debería haber una especie de acta)
   3. Documento de formato
   4. Documento de postmorten