
Un documento de requisitos de una app, o especificación de la app, es un plan breve y por escrito de una app antes de que nadie la construya: quién la usará, las pantallas que ve cada uno, la información que guarda, los servicios con los que se conecta, lo que queda fuera por ahora y lo máximo que puede costar la compilación. Lo lees, lo cuestionas y lo cambias, y solo cuando describe la app que de verdad quieres lo apruebas.
Lo apruebas primero porque una especificación es el lugar más barato para encontrar un error. Mover una línea en una página no cuesta nada. Descubrir después de la construcción que los tutores pueden ver el teléfono de todos los padres, o que las cuotas no se pueden pagar a plazos, obliga a reconstruir.
¿Qué es una especificación de software, en palabras sencillas?
En software, una especificación (en proyectos más grandes suele llamarse documento de requisitos, o SRS, por las siglas en inglés de especificación de requisitos de software) es el acuerdo entre la persona que necesita la app y quien la construye. Dice lo que debe hacer la app, no cómo lo hace el código. Para una tienda, un club o una escuela, una página suele bastar, siempre que sea concreta y esté en palabras sencillas.
La prueba de una especificación es simple: ¿podrían dos constructores distintos leerla y hacer más o menos la misma app? Si la página dice los estudiantes pueden ver sus resultados, eso es un deseo. Si dice un estudiante inicia sesión con un número de teléfono y ve las notas de sus propios exámenes, por materia, junto a la media del grupo, eso es un requisito que alguien puede construir y tú puedes comprobar.
¿Qué incluye un documento de requisitos de una app de una página?
Imagina una academia de clases particulares que quiere una app para clases, asistencia y cuotas. Una especificación útil de una página para ella tiene estas partes:
| Parte de la especificación | Qué dice | Ejemplo para una academia de clases particulares |
|---|---|---|
| Quién la usa | Cada tipo de persona que inicia sesión y lo que puede hacer | Dueño, tutores, estudiantes y padres; solo el dueño ve los totales de las cuotas |
| Pantallas por rol | Las páginas que ve cada rol y lo que hace en ellas | Tutor: clases de hoy, pasar lista, introducir notas de exámenes. Padre o madre: asistencia, notas, cuotas pendientes |
| Datos que guarda | Los registros que almacena la app y lo que contiene cada uno | Estudiantes, clases, asistencia por sesión, exámenes y notas, plazos de las cuotas y recibos |
| Integraciones | Servicios externos con los que se conecta, y cómo | Pago de cuotas en línea mediante una pasarela de pago, con un recibo por cada plazo |
| Fuera por ahora | Lo que esta versión no hará | Sin comprobación de choques de horarios; sin importación de los registros del año pasado |
| Tope de costo | Lo máximo que puede costar la compilación | Un máximo que se muestra antes de la aprobación, no una estimación después del trabajo |
Las pantallas por rol son la parte que la gente lee por encima, y es la que más importa. Una app es en realidad varias apps que comparten un mismo conjunto de datos: la vista del dueño, la del tutor y la de los padres. Leer las pantallas rol por rol es como te das cuenta de que un tutor puede pasar lista, pero nadie puede corregir un error en ella.
La línea de fuera por ahora es igual de importante. Te dice lo que no vas a recibir, que es la causa habitual de decepción después de una construcción. Una lista breve y honesta de exclusiones es señal de una buena especificación, no de una floja.
Cuando describes una app a Deployflix, la especificación que escribe sigue esta forma: quién usa la app, sus pantallas, los datos que guarda, lo que queda fuera por ahora y lo máximo que puede costar la compilación, en el idioma en que escribiste. Si algo de tu descripción no está claro, pregunta antes de planificar. Cómo funciona muestra dónde encaja la especificación entre los pasos.
¿Cómo se lee y se cuestiona una especificación de app?
No leas una especificación como un contrato, de arriba abajo. Léela como un día en tu negocio.
- Recorre un día real en el papel de cada rol. ¿Qué toca, qué ve, qué introduce? Luego haz lo mismo con cada uno de los demás roles.
- Sigue un registro de principio a fin. Elige un solo estudiante, pedido o reserva. ¿Quién lo crea, quién lo cambia, quién puede eliminarlo y dónde termina?
- Busca los casos en que algo sale mal. Una reserva cancelada, un reembolso, una entrada equivocada, un pago que falla, un socio que se va. Si la especificación solo describe las cosas cuando salen bien, pregunta qué pasa cuando no.
- Revisa cada número y cada palabra que imprimirías. Los formatos de factura, los plazos de las cuotas, las líneas de impuestos y los números de recibo deben coincidir con tu forma de trabajar actual. Si tus facturas deben mostrar un impuesto como el GST, el IVA o el impuesto sobre las ventas, revisa los detalles con tu contador.
- Pregunta por todo lo que sea vago. Palabras como gestionar, controlar, fácil e informes esconden decisiones. Pregunta: ¿qué informe, que muestre qué y para quién?
¿Qué huecos deberías buscar antes de aprobar?
La mayoría de las especificaciones que salen mal no están equivocadas; están incompletas. Estos son los huecos que aparecen con más frecuencia.
Quién puede ver qué
Los roles son fáciles de nombrar y fáciles de dejar en el aire. Comprueba lo que cada rol puede ver, no solo lo que puede hacer. ¿Puede un tutor ver las cuotas? ¿Puede un padre ver las notas del hijo de otra persona? ¿Puede un empleado descargar la lista de clientes? Si la app guarda información personal, decide ahora quién puede verla.
Editar, cancelar y deshacer
Todo registro necesitará corregirse algún día. Comprueba que la especificación diga quién puede editar o cancelar una entrada y si se conserva el valor anterior.
Dinero
Si la app acepta pagos, la especificación debe mostrar los pasos del pago: cómo pueden pagar los clientes (tarjetas y métodos de pago locales), qué se paga, si se permiten pagos parciales, qué recibe el cliente después y qué ocurre si un pago queda pendiente o falla. Las reglas de reembolso son una decisión del negocio, así que deja las tuyas por escrito. Las pasarelas suelen cobrar un porcentaje por transacción, más una comisión fija en muchos países, así que consulta la página de precios de tu pasarela. Las apps de Deployflix aceptan pagos a través de pasarelas como Razorpay o Cashfree; las pasarelas internacionales estarán disponibles próximamente. Nuestra página de integraciones muestra las conexiones disponibles hoy.
Mensajes y recordatorios
Si esperas recordatorios, di cómo deben llegar a las personas: por correo electrónico, dentro de la app o de otra forma. Si la especificación no menciona un canal, da por hecho que no existe.
Tus datos actuales
Las hojas de cálculo y los registros antiguos a menudo tienen que pasarse a la nueva app. Pregunta si traerlos forma parte de la especificación o está en la lista de fuera por ahora.
Dispositivos e idiomas
¿Las personas la usarán en un teléfono, en la computadora del mostrador de una tienda o en ambos? ¿También debe estar en español, árabe, francés u otro idioma, además del inglés? Estas decisiones determinan las pantallas, así que tómalas antes de construir. Deployflix escribe los textos de tu app en el idioma que solicites y está disponible en 41 idiomas.
¿Por qué aprobar la especificación antes de construir nada?
Porque cambiar una frase es más barato que cambiar una app. Antes de la construcción, añadir un rol para los padres o un plazo de la cuota es una edición en una página. Después de la construcción, el mismo cambio puede afectar a pantallas, datos y permisos que ya estaban terminados.
Aprobarla también te da algo con lo que comparar la app terminada. Cuando la construcción esté hecha, abre la especificación y repásala punto por punto: cada rol, cada pantalla, cada dato. Todo lo que falte es un punto justo que plantear.
La especificación también deja claro el coste antes de que te comprometas. Cuando el coste máximo de una compilación figura en la especificación, puedes decidir con la cifra delante. En Deployflix, ese límite se muestra antes de que des tu aprobación y solo pagas por lo que la compilación haya consumido realmente, como se explica en la página de precios.
¿Cómo se planifican los cambios después de construir la app?
Una app rara vez está terminada. Un curso nuevo, una segunda ubicación, una nueva forma de cobrar las cuotas: cada uno merece el mismo cuidado que la primera construcción.
Planifica un cambio como una pequeña especificación propia: qué cambia, a qué roles y pantallas afecta, qué datos se añaden o modifican, qué sigue igual y cuánto puede costar. Léela con las mismas preguntas y apruébala antes de que empiece el trabajo. Guarda la versión anterior, para que, si el cambio sale mal, puedas volver a una que funcionaba.
Así es como Deployflix gestiona los cambios: dices qué cambiar, planifica el cambio como la siguiente versión y no se construye nada hasta que se aprueba. Todas las versiones anteriores se guardan. En una organización, solo pueden aprobar las personas cuyo rol lo permite, como describe la página de seguridad.
Una plantilla de especificación de app que puedes usar
Si vas a escribir tu propia especificación, copia estos encabezados y rellena cada uno con frases sencillas:
- La app en una frase: para quién es y qué tarea hace.
- Roles: cada tipo de usuario y lo que puede ver y hacer.
- Pantallas por rol: para cada rol, las pantallas y lo que ocurre en cada una.
- Datos que guarda: cada tipo de registro y los datos que contiene.
- Integraciones: pagos, tu dominio, tiendas de apps, dónde se guarda el código y cualquier otra cosa con la que se conecte.
- Reglas: cuotas, límites, plazos, cancelaciones y reembolsos.
- Fuera por ahora: lo que esta versión no hará.
- Tope de costo y aprobación: lo máximo que puede costar y quién da el visto bueno.
Para ver ejemplos prácticos de roles, pantallas y datos, mira un sistema de gestión de grupos para academiasEN o una app de reserva de citas para clínicasEN. Un fundador que está probando una idea puede hacer la especificación aún más corta, con un rol, unas pocas pantallas y una lista firme de lo que queda fuera, como en una app web MVP para una startupEN.
Preguntas
¿Cuál es la diferencia entre una especificación de app y un documento de requisitos?
Sobre todo la extensión y la formalidad. Un documento de requisitos para un proyecto grande puede ocupar muchas páginas de requisitos numerados. Una especificación de app para un pequeño negocio cubre lo mismo (quién la usa, qué hace, qué guarda) en una página y con palabras sencillas.
¿Quién debe escribir la especificación de la app?
La persona que conoce el negocio aporta el contenido: los roles, el trabajo diario y las reglas. Un constructor puede convertir eso en una especificación estructurada, pero solo tú puedes saber si es correcta.
¿Puedo cambiar la especificación después de aprobarla?
Sí. Trátalo como un cambio: describe qué es distinto, lee el plan actualizado y vuelve a aprobarlo. Guarda la versión anterior para poder comparar o volver atrás.
¿Qué extensión debe tener una especificación de app?
La suficiente para que nada importante quede a la imaginación, y lo bastante corta para que la leas entera. Para la mayoría de las apps de pequeños negocios, una página es lo adecuado; si se alarga mucho más, plantéate construir por etapas.
Describe tu app
Escribe lo que necesitas con tus propias palabras. Deployflix escribe un plan de una página con su costo y solo construye después de que lo apruebes.
Copiado. Pégalo en Deployflix cuando hayas iniciado sesión.