Programación Orientada a Objetos en WordPress: Declaración de Trabajo
Antes de entrar en el tema del análisis y diseño orientado a objetos (que es cuando la mayoría de nosotros nos divertimos más con lo que hacemos además de escribir código), es importante hacer un seguimiento de algunas cosas más relacionadas con la comprensión de los requisitos del cliente. .
En el post anterior mencioné:
Si se toma el tiempo para comprender lo que quieren desde el principio, entonces los requisitos no tienen que ser un documento de 50 páginas que describa cómo debe funcionar cada módulo.
Por ejemplo, cada vez que preparo requisitos (o una Declaración de trabajo), como suelo llamarlos cuando los envío a los clientes, rara vez excedo las diez páginas y, a menudo, es menos.
Y aunque hay momentos en que es más largo, creo que parte de la razón por la que desarrollar un conjunto breve de requisitos viene con las discusiones preliminares para asegurarse de que usted y los clientes hayan desarrollado un lenguaje común con el que puedan trabajar.
Cuando hace eso, los requisitos y la declaración de trabajo, como quiera llamarlos, no tienen que ser tan largos.
Escribir una declaración de trabajo
Primero, me gustaría diferenciar entre una Declaración de trabajo y Requisitos en el contexto de esta publicación.
- Los requisitos son lo que el cliente quiere que se construya.
- La Declaración de trabajo detalla lo que va a hacer, cómo lo hará y por cuánto.
Cubriré esto último con más detalle en esta publicación. Pero baste decir que los requisitos pueden venir en forma de discusiones, documentación o ambos en lo que respecta al cliente.
Antes de saltar a las diferentes partes de lo que incluyo en una declaración de trabajo, hay algunas cosas que creo que vale la pena mencionar:
- No escriba una declaración de trabajo hasta que tenga todos los requisitos del cliente.
- Asegúrese de que el cliente sepa qué esperar de una declaración de trabajo.
- Si va a tomarse el tiempo para escribir una Declaración de trabajo, decida si va a cobrar por el tiempo o no, y asegúrese de que el cliente sepa que tendrá que pagarlo o no.
Esta es una de esas cosas que se realizan de autónomo a autónomo o de agencia a agencia. Dicho esto, aquí están las partes de una Declaración de trabajo que suelo incluir.
Preparación de una declaración de trabajo
Cada vez que preparo una declaración de trabajo, tengo una plantilla que uso. Voy a proporcionar un desglose que cubre gran parte de esto aquí.
Así es como funciona cada sección:
1 Declaración de trabajo
El propósito de este documento es [definir una propuesta de solución para EL PROYECTO].
Los requisitos del proyecto han sido proporcionados por [NOMBRE DEL CLIENTE], [FUNCIÓN DEL NOMBRE DEL CLIENTE EN EL NOMBRE DE SU EMPRESA]. Los términos del acuerdo son una combinación de los acordados por [NOMBRE DEL CLIENTE] y [SU NOMBRE o NOMBRE DE LA AGENCIA].
2 Descripción general de los requisitos
El propósito de este documento es [definir una propuesta de solución para EL PROYECTO].
Los requisitos del proyecto han sido proporcionados por [NOMBRE DEL CLIENTE], [FUNCIÓN DEL NOMBRE DEL CLIENTE EN EL NOMBRE DE SU EMPRESA]. Los términos del acuerdo son una combinación de los acordados por [NOMBRE DEL CLIENTE] y [SU NOMBRE o NOMBRE DE LA AGENCIA].
3 Idiomas y Tecnología
El servidor web, el software, las herramientas y el enfoque que se utilizará para crear la solución.
Si se trata de un proyecto basado en la web, cubra los navegadores compatibles, si habrá o no una funcionalidad receptiva y cómo se probarán los puntos anteriores.
5 Idiomas y Tecnología
El servidor web, el software, las herramientas y el enfoque que se utilizará para crear la solución.
6 Requisitos e hitos del proyecto
Por lo general, la sección más larga del documento. Resume:
- Los requisitos,
- Cómo se construirá y entregará cada requisito,
- Cualquier nota adicional que el cliente deba conocer.
7 Cronograma propuesto
Esto se basa en los hitos descritos en la sección anterior y los comentarios del cliente.
8 Otros factores
Cosas misceláneas que opta por incluir, como lo que usted o su agencia optan por aportar al proyecto, cómo la retroalimentación retrasada puede afectar el proyecto, etc.
9 Costo estimado
Esto incluye el costo total del proyecto y un desglose opcional del calendario de pagos.
Es necesario
Lo sé: he dicho esto antes en publicaciones anteriores de esta serie. Esta no es la parte más glamorosa de lo que hacemos. En su lugar, saltaríamos directamente a la programación.
Pero, ¿cómo sabes qué construir (y construirlo bien) si no hemos tratado adecuadamente el problema que estamos tratando de resolver?
Y eso es lo que nos da todo lo que conduce al análisis y diseño orientado a objetos.
Análisis orientado a objetos
Ahora que hemos eliminado el papeleo (o incluso las "cosas comerciales", como algunos pueden llamarlo) fuera del camino, es hora de comenzar a trabajar en la programación.
Sin embargo, antes de hacer eso, es importante analizar los requisitos y determinar qué partes del proyecto servirán para qué propósito. Por ejemplo:
- ¿Necesitamos algún software preexistente?
- ¿Necesitamos escribir algún adaptador o código de capa de datos?
- ¿Cómo construiremos la capa de aplicación y las entidades dentro de ella?
- ¿Qué pasa con la parte delantera?
Y para muchos, aquí es donde comienza la diversión. Así que estoy ansioso por comenzar a hablar sobre esto también. Comenzaremos en la siguiente publicación.