Por Thomas Cohen, fundador de Maestro
Documento de requisitos de una aplicación: guía, ejemplo y plantilla gratuita
Un ejemplo de reservas para describir quién utiliza tu aplicación, qué debe hacer y cómo comprobar el resultado. Incluye una plantilla de texto gratuita en francés para adaptar.
Tus clientes llaman para reservar una cita y te gustaría que eligieran una hora disponible por internet. El documento de requisitos describe esa necesidad, las personas implicadas y el resultado esperado. Sirve para comentar el proyecto, comparar propuestas y comprobar lo construido, sin empezar por el código.
Descarga o copia la plantilla gratuita de requisitos. Este archivo de texto en francés se abre en un navegador o editor y se puede copiar en Word o Google Docs. Incluye apartados para completar, una lista de comprobaciones y un ejemplo ficticio. No se pide ningún correo electrónico.
Empieza por el problema, no por las pantallas
Escribe la necesidad en una frase: «Mis clientes deben poder reservar una hora sin llamarme». Es más preciso que «quiero un calendario moderno». Describe la situación actual: quién atiende las llamadas, dónde se anotan las citas y qué errores ocurren.
Indica cómo reconocerás una mejora. En nuestro ejemplo ficticio, los clientes eligen entre los horarios publicados y el responsable encuentra todas las reservas en el mismo lugar. Si fijas un objetivo numérico, parte de tu situación real.
Describe los usuarios y sus recorridos
Nombra a cada persona y lo que puede hacer. El cliente consulta y reserva. El responsable abre horarios y cancela reservas. Un compañero puede leer el calendario sin cambiar las horas. Aclara si hace falta una cuenta y cómo recuperar el acceso.
Cuenta el recorrido completo: una clienta abre la página, elige una hora, introduce sus datos, confirma y recibe un resumen. ¿Qué pasa si la hora acaba de ocuparse, falla el correo o quiere cancelar? Anota estas preguntas antes de la entrega.
Escribe las reglas y los límites de la primera versión
En este ejemplo, cada cita dura treinta minutos y admite una reserva. El cliente puede cancelar hasta veinticuatro horas antes; después contacta con el responsable. Son reglas ficticias: sustitúyelas por las de tu actividad.
Enumera lo que esperará: pago por internet, recordatorios por SMS, suscripciones o una aplicación móvil. Un sitio utilizable en el teléfono puede cubrir la primera necesidad. Guarda las ideas adicionales en una lista separada, con la razón para añadirlas.
Haz que cada petición se pueda comprobar
Un criterio de validación explica cómo reconocer un resultado correcto. Primer ejemplo: cuando una clienta confirma una hora libre, aparece una sola reserva en el calendario y esa hora deja de ofrecerse.
Segundo ejemplo: si dos clientes confirman la misma hora, solo uno consigue la reserva. El otro recibe una explicación y puede elegir otra hora. Tercer ejemplo: el compañero autorizado a consultar no puede modificar el calendario, ni siquiera intentando acceder mediante un enlace directo.
Para comprobar la rapidez, acuerda con quien desarrolla la aplicación qué página se probará, en qué dispositivo y en qué condiciones. «Rápido» no basta para ponerse de acuerdo. Anota quién hará cada comprobación y cómo se conservará su resultado.
No olvides los datos y el funcionamiento diario
Describe qué información se guarda, quién puede verla y cuándo debe borrarse. Anota los archivos que trasladar y las herramientas con las que debe conectarse la aplicación. Antes de sustituir Excel por una aplicación, identifica los cálculos y las costumbres escondidos en tu hoja.
Aclara quién controlará el alojamiento, el servicio que ejecuta la aplicación, además del dominio y los archivos de código. ¿Quién recibe avisos y corrige incidencias? ¿Cómo se recuperan datos, se restaura una copia o se transmite el trabajo? Estas respuestas también influyen en el coste del proyecto.
Mantén el documento útil sin complicarlo
Pon fecha a las versiones y deja visibles las preguntas pendientes. Antes de un cambio importante, pregunta por su efecto en los plazos, el presupuesto y las comprobaciones previstas. Pide a las personas que usarán la aplicación que revisen sus recorridos.
Completa la plantilla descargable a medida que lleguen las respuestas. Con un proveedor o en el recorrido de Maestro, tendrás una base para conversar y validar. Las decisiones técnicas podrán explicarse después a partir de esa necesidad.
