Especificación técnica profesional para aplicaciones web
Define arquitectura, API, criterios de aceptación y requisitos técnicos para una aplicación web.
¿Qué hace este prompt?
• Define de forma precisa la arquitectura, tecnología y diagrama de la aplicación. • Especifica APIs RESTful completas con manejo de errores profesional. • Genera user stories testeables en formato Given-When-Then. • Detalla medidas de seguridad y protocolos robustos para incidencias.
Especificación técnica para aplicación web completa
ROL
Ingeniero de software senior con 10 años de experiencia en arquitectura de aplicaciones web, aplicando metodologías Agile, Domain-Driven Design (DDD) y documentación API RESTful.
OBJETIVO
Obtendrás una especificación técnica completa y profesional para una aplicación web o funcionalidad concreta, lista para desarrollo.
INFORMACIÓN DEL USUARIO
[RESUMEN_FUNCIONALIDAD]
[USUARIOS_OBJETIVO]
[MÓDULOS_REQUERIDOS]
[REQUISITOS_TÉCNICOS_ESPECIALES]
[RESTRICCIONES_NORMATIVAS]
[TECNOLOGÍAS_PREFERIDAS]
PROCESO
1. Resume la funcionalidad y los objetivos principales de [RESUMEN_FUNCIONALIDAD] en una introducción técnica concisa.
2. Define la arquitectura del sistema utilizando DDD. Indica elección de tech stack, diagrama de alto nivel, y justifica cada componente (frontend, backend, base de datos, autenticación).
3. Especifica el modelo de datos y el esquema de la base de datos principal (tablas/colecciones, claves primarias/foráneas, relaciones).
4. Diseña la API RESTful: enumera todos los endpoints (ruta, método, parámetros, respuesta, códigos de error estandarizados).
5. Detalla el flujo de autenticación y autorización, especificando el protocolo y el ciclo de vida de sesión/token.
6. Redacta al menos 3 user stories clave siguiendo el formato Given-When-Then, cada una con sus criterios de aceptación medibles.
7. Crea un diagrama de flujo de datos (data flow diagram) describiendo interacciones usuario-sistema y entre sistemas internos.
8. Enumera requisitos de seguridad (OWASP Top 10), fallback de errores críticos, y protocolos de gestión de incidencias.
FORMATO DE ENTREGA
Devuelve el resultado en formato Markdown, siguiendo esta estructura y ejemplo:
## 1. Introducción técnica
Breve resumen.
## 2. Arquitectura del sistema y tech stack
- Diagrama escrito o ASCII
- Justificación componentes
## 3. Modelo de datos y esquema
- Tabla Markdown con nombre, tipo, relaciones
## 4. Endpoints API RESTful
| Endpoint | Método | Parámetros | Respuesta | Códigos de error |
|---|---|---|---|---|
## 5. Autenticación y autorización
Explicación técnica, pasos.
## 6. User Stories y criterios de aceptación
- Given... When... Then...
## 7. Diagrama de flujo de datos
ASCII/Markdown (ejemplo)
## 8. Requisitos de seguridad y protocolos de error
- Listado detallado
Cómo usar este prompt
1. Reúne toda la información relevante sobre la funcionalidad y requisitos clave de tu aplicación web. 2. Completa los campos: por ejemplo, [RESUMEN_FUNCIONALIDAD]: 'Gestión de inventario online', [USUARIOS_OBJETIVO]: 'Administradores de almacén', [MÓDULOS_REQUERIDOS]: 'Catálogo, Pedidos, Reportes', etc. 3. Copia el prompt completo en ChatGPT y rellena los campos entre corchetes con tu caso específico. 4. Ejecuta el prompt y revisa la especificación técnica generada. Puedes solicitar ampliación de alguna sección si lo necesitas. Ejemplo: 'Quiero especificar una aplicación para gestión de reservas en restaurantes para clientes y empleados. Módulos requeridos: reservas, gestión de mesas, notificaciones. Preferencias tecnológicas: Node.js, PostgreSQL.'
Tips y recomendaciones
• Haz el resumen funcional lo más conciso y concreto posible para evitar resultados genéricos. • Aporta todas las restricciones regulatorias y de seguridad desde el inicio. • Indica tecnologías preferidas para una arquitectura alineada a tu stack actual. • Revisa en detalle los endpoints para evitar lagunas funcionales. • Si necesitas un formato gráfico, pide que los diagramas se entreguen en ASCII.