ManuelRomero/proyectos/Documentacion

De WikiEducator
Saltar a: navegación, buscar
Road Works.svg Trabajo en proceso, espera cambios frecuentes. Tu ayuda y retroalimentación son bienvenidos.
Ver página de charlas.
Road Works.svg




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

Documentación que genera un proyecto

ProyectoFuncionActividad.png


  • Vamos a intentar exponer la idea de información a nivel general en la gestión de un proyecto

Metodología

  • Qué es una metodología
  • Se ha de seg

Herramientas a utilizar

Un proyecto de software a nivel general


Fases Conjunto de 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 Fecha concreta marcada en la planificación En cada hito el cliente puede ver como va el desarrollo del proyecto que ha contratado Ejemplo de fases Software: Los diagramas que muestran el análisis del proyecto Diagramas de casos de uso Diagramas de clases a nivel de análisis o diagrama E/R para ver el modelo de datos Electricidad Se suelen hablar de forma explícita o implícita de tres fases, aunque no se identifiquen con esos nombres FASE DE ANÁLISIS todo 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. 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: Una vez que sabemos qué queremos hacer pasamos a un segundo estado en el que vemos cómo lo vamos a hacer. Esta fase puede conllevar FASE DE DESARROLLO FASE DE PRUEBAS Y MANTENIMIENTO Las actividades y tareas que realizamos en cada fase lógicamente será propia del tipo de proyecto que vayamos a realizar. Se trata de evitar ir directamente a la fase de desarrollo, lo que más saben hacer los estudiante y a lo que nosotros mismos vamos es a hacer directamente las cosas. En el proyecto se intenta que antes de empezar a hacer las cosas sepamos lo que vamos a hacer u cómo, garantizando de esta forma en gran medida el éxito del proyecto, o viendo su viabilidad. Pudiento proponer modificaciones que lo hagan viable si se detectan sitiaciones inviables.

alumnos 

qué es una actividades Qué es una tarea metodología uso de herramientas técnicas y métodos para la realización un determinado proyecto Una metodología nos va a guiar en la forma de realizar y llevar la gestión de un proyecto concreto Cualquiera que sea su naturaleza la metodología se adaptará Existen metodologías estándar, como es métrica en España. Cada empresa tendrá su propia metodología. Es muy habitual la frase de “ En esta empresa las cosas se hacen así …..”. Siguiendo esta metodología. Es importante seguirla, garantiza la calidad de los productos, así como la forma de trabajar y intenta limitar los tiempos muertos en la comunicación optimizando los recursos de la empresa. Vamos a proponer una metodología muy básica para los proyectos. Podríamos llamarla MeProCiFo Metodología para Proyectos de Ciclos Formativos.

Antes de empezar El alumno representa una empresa que tenga nombre y logo suele ser interesante, pues hace el proyecto más real, y la experiencia demuestra que el alumno/a se mete más en el papel de empresario desarrollador. El proyecto ha de tener un título. Este no ha de ser muy largo, el título no son los objetivos, Representa lo que queremos realizar 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. Todos los documentos deberán de tener la misma estructura, debería de haber un documento llamado gestor de presentación donde se espedifique esta información, si bien se suele proponer desde el departamento (tamaño de letra, forma de viñetas, numeración, logotipo, cabecera , ...) Acuerdo del proyecto o contrato Documento común para cualquier tipo de proyecto. Planificación Diagrama de Gant Pert como diagrama de prelaciones Lista de tareas Calendario de hitos Presupuesto Desglose de los diferentes roles a realizar horas prevista para cada rol Amortización del material/recursos/inmovilizado/seguros a utilizar en el proyecto Impuestos según corresponda Cantidad total neta/bruto del proyecto Lista de requisitos Cada requisito ha de estar perfectamente identificado Mejor con siglas Requisitos cortos y concretos no ambiguos Cada requisito a de ser verificable. Esto aportará la calidad del proyecto. El proyecto tendrá la calidad acordada si cumple satisfactoriamente cada uno de los requisitos 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. Entrevistas(personales, colectivas, lluvia de ideas, ...), cuestionarios o diferentes formas en las que podemos aclarar qué es lo que realmente tiene que hacer el proyecto 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. Pliego de condiciones Determina parte de la calidad del producto sobre todo para la fase de mantenimiento En el acuerdo todos somos muy positivos y cedemos mucho, pero luego hay que acarrear con las consecuencias de lo que hayamos decidido 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 el nombre del proyecto el nombre de la empresa con su representante legal que en este caso es el alumno, Nombre del cliente con su represnetante que sería el tutor del ciclo El importe total al que asiciende el presupuesto tanto en neto como en bruto La fecha de comienzo y de finalización, así como la fecha de entrega Es recomendado que esté firmado, constituyendo la fecha de la firma del proyecto el primer hito importante para la realización del proyecto. Documento de análisis Es este un documento propio del producto. Depende de su naturaleza la forma de realizarlo Normalmente se recomienda de el uso de diagramas acompañados de aclaraciones narrativas para su aclaración Por ejemplo diagrama de casos de uso cuando un producto sea para ser utilizado (como el software) Ejemplo de caso de uso Insertar algún diagrama más de análisis en otras especialidades Documento de diseño Debe de usarse los diagramas generados anteriormente para ver la evolución El proyecto ha de ser un proceso uniforme y continuo, es decir, los diagramas que se van generando son una evolución o indagar en mayor detalle, cuestiones planteadas y aclaradas en diagramas anteriores Documento de implementación Se trata de utilizar las herramientas necesarias para generar el producto según se haya analizado y diseñado previamente. Es importante insistir en que ha de ser una evolución de toda la documentación generada anteriormente. Puede ser que uno diga uff!!! por fin he terminado el royo de la documentación, ahora voy a poder empezar a hacer el proyecto!!!!!! Grave error. Puede que no hayamos realizado un buen análisis y diseño de nuestro proyecto, o que no sepamos usarlo. Tanto el análisis como el diseño es un medio para poder conseguir un fin. En si mismo no son un producto, son parte de él. No son el producto, pero es un camino para conseguirlo de forma satisfactoriaç Plan de pruebas de prototipo o producto final Diario de bitácora

Documento de postmorten