Definición del alcance en proyectos de desarrollo de APIs

Clase 3 de 22 • Curso de Introducción a DevOps

Resumen

La definición clara del alcance de un proyecto es fundamental para asegurar el éxito en cualquier desarrollo, especialmente en aplicaciones para gestión de contactos. Planificar correctamente ayuda a evitar confusiones con clientes y facilita el manejo eficiente de recursos y tiempos de trabajo.

¿Por qué es importante definir claramente el alcance del proyecto?

La etapa de planeación suele ser extensa y, en algunos casos, demasiado burocrática. Mantener una propuesta sencilla facilita la comunicación con clientes o usuarios finales, permitiendo acordar qué funcionalidades estarán incluidas y cuáles no.

¿Cómo usar sticky notes para comunicar el alcance del proyecto?

Las sticky notes o notas adhesivas ofrecen una herramienta práctica y ágil, ayudando a aclarar visualmente el alcance del proyecto. Algunas recomendaciones al utilizarlas incluyen:

Especificar claramente funcionalidades pactadas.
Indicar explícitamente lo que quedará fuera de alcance.
Usar herramientas digitales en caso de equipos remotos.

¿Qué incluirá una API básica de gestión de contactos?

Para una API que gestiona contactos, algunas funcionalidades esenciales serían:

Método para agregar nuevos contactos.
Funcionalidades para modificar contactos existentes.
Capacidad para eliminar contactos antiguos.

Por contraparte, aspectos como la agrupación o categorización de contactos estarían excluidos de este alcance inicial.

¿Cómo manejar peticiones adicionales de clientes durante la iteración?

Es común enfrentar solicitudes inesperadas, como la implementación urgente de seguridad por tokens durante una iteración. Frente a esta situación recomendamos:

Explicar al cliente que modificaciones adicionales deben esperar a una siguiente versión.
Guardar propuestas para futuras iteraciones o versiones incrementales.

¿Cuándo avanzar hacia la creación del backlog?

Luego de concretar todas las funcionalidades y límites del proyecto, recomendamos:

Elaborar un documento formal que refleje claramente acuerdos tomados.
Asegurar aprobación y entendimiento pleno del cliente.

Esto ofrece la base para avanzar efectivamente a la creación del backlog, facilitando el desarrollo posterior del proyecto con claridad y consenso.

¿Te ha tocado enfrentar cambios inesperados durante un proyecto? Comparte cómo manejaste esa situación.

Juan Carlos Quishpe

student•

Etapa de Planeación: la más larga y burocrática

Suele ser la etapa más extensa y con mayor carga burocrática.
Se recomienda mantenerla lo más simple posible.
Es clave mejorar la comunicación con los stakeholders del proyecto.

Definición de alcance del sistema

Es esencial aclarar lo que el sistema va a hacer y lo que no cubrirá.
Esto evita malentendidos y cambios no planificados en el futuro.
Se sugiere usar herramientas visuales como sticky notes (físicas o digitales) para organizar ideas.

Ejemplo de alcance en el proyecto

Proyecto: una API para gestión de contactos (agregar, modificar, eliminar contactos).
Alcance confirmado: incluir un método para agregar contactos.
Alcance excluido: no incluir agrupaciones por tipo (familia, trabajo, etc.).

Importancia de limitar el alcance desde el inicio

Evita cambios repentinos a mitad del sprint por nuevas ideas del cliente.
Los cambios deben planificarse para futuras versiones del producto (v2, v1.5, etc.).
El equipo debe explicar al cliente por qué los cambios no se implementan inmediatamente.

Formalización del acuerdo del alcance

Se recomienda crear un documento que resuma el alcance acordado.
Debe estar validado por ambas partes para evitar confusiones.

Preparación para la siguiente etapa

Una vez definido el alcance y formalizada la comunicación, se puede crear el backlog.
Esto marcará el inicio de la siguiente fase del proyecto.

Diego Mauricio Zuluaga Rodríguez

student•

Para crear una API de gestión de contactos, sigue estos pasos:

Definir el alcance: Decide qué funciones incluirá la API (agregar, modificar, eliminar contactos) y qué no cubrirá (por ejemplo, agrupación de contactos).
Diseñar el modelo de datos: Define cómo se estructurarán los datos (nombre, número de teléfono, correo electrónico).
Elegir la tecnología: Selecciona el lenguaje y framework (Node.js con Express, Python con Flask, etc.).
Configurar el entorno: Prepara tu entorno de desarrollo e instala las dependencias necesarias.
Implementar la lógica: Crea las rutas para manejar las solicitudes (GET, POST, PUT, DELETE).
Conectar a la base de datos: Utiliza una base de datos (como PostgreSQL) para almacenar los contactos.
Probar la API: Usa herramientas como Postman para asegurarte de que las funcionalidades funcionen como se espera.
Documentar la API: Crea documentación que explique cómo usarla, lo cual es fundamental para los usuarios.
Implementar medidas de seguridad: Asegúrate de que tu API esté protegida, por ejemplo, implementando autenticación.
Desplegar la API: Lanza tu API en un servicio de hosting adecuado.

Estos pasos te guiarán en el desarrollo de tu API de gestión de contactos.

Bruno Orozco Mejía

student•

El enfoque de Scrum promueve la adaptabilidad al cambio, pero también señala la importancia de mantener un alcance definido durante un sprint. Si bien es ideal ser receptivo a nuevas ideas, incluir cambios significativos en medio de un sprint puede desestabilizar el progreso y afectar la calidad del trabajo entregado. Por eso, lo recomendable es registrar las nuevas funcionalidades como mejoras para futuras versiones, asegurando así un proceso más controlado y eficiente. La planificación y gestión adecuada del proyecto son claves para el éxito en este contexto.

David Ramirez

student•

Mi estimado Amin soy tu fan! Me considero tu humilde saltamontes 🦗

Amin Espinoza

teacher•

Awww muchas gracias!!!

Diego Mauricio Zuluaga Rodríguez

student•

Una API (Interfaz de Programación de Aplicaciones) es un conjunto de reglas y protocolos que permite a diferentes aplicaciones comunicarse entre sí. Por ejemplo, una API de un servicio de clima permite a una aplicación acceder a datos meteorológicos sin necesidad de conocer la lógica interna del servicio.

Un caso real de uso sería una aplicación móvil de viajes que usa la API de un servicio de mapas para mostrar la ubicación de los hoteles disponibles en tiempo real. Esto permite a los usuarios ver dónde están ubicados sin que la aplicación tenga que almacenar todos los datos de los mapas.

Diego Mauricio Zuluaga Rodríguez

student•

La etapa de planeación se realiza correctamente al definir claramente el alcance del proyecto. Primero, identifica lo que el sistema hará y lo que no cubrirá, comunicándote efectivamente con los clientes. Utiliza herramientas como notas adhesivas para organizar ideas. Es fundamental documentar los acuerdos alcanzados y establecer un backlog para gestionar futuras solicitudes. Mantén la comunicación abierta, evitando cambios repentinos durante la ejecución del proyecto. Esto ayuda a mantener el enfoque y la eficiencia en el desarrollo de la API.

Domingo Ramírez

student•

Tengo una duda. Si la funcionalidad que pide el cliente a medio spring es algo que esta relacionado de algún modo a algo que se esté haciendo en ese spring no se debería al menos tomar en cuenta para que dicha funcionalidad esté preparada para ese posible cambio a futuro? o como se maneja eso?

Amin Espinoza

teacher•

Es una excelente pregunta! Mira, aún si en medio de un sprint un cliente sugiere la introducción de un cambio que no refleje grandes consecuencias para tu planeación de ese periodo sucederán varias cosas.

Tu cliente tendrá presente que puede hacerlo sin grandes consecuencias.
Tu equipo podrá asimilar el cambio en ese sprint pero no sabemos si estará de acuerdo en los siguientes cambios.
La razón para la cual se planea un sprint es justamente para controlar que todo salga a tiempo, agregar más tareas es forzar a tu equipo a trabajar más sin haberlo consultado antes.
Una metodología ágil te indicará que para eso existe un backlog, para estar consciente de que las nuevas ideas se transformen en Features que resulten en User Stories con tareas bien especificadas, no se trata de simplemente sugerir cambios, estos cambios se consultan, estructuran y diseñan de acuerdo a un plan.