====== Tienda online ======
**Borrador inicial de requisitos.** La tienda permite consultar un catálogo, preparar un carrito y solicitar el pago de una compra mediante el proyecto VISA del profesorado. Los productos, precios y ejemplos concretos se elegirán más adelante.
===== Actores =====
^ Actor ^ Qué necesita hacer ^
| Cliente | Consultar productos, preparar una carrito, confirmar una compra y revisar su resultado. |
| Administrador/a de la tienda | Mantener el catálogo y consultar los pedidos recibidos. |
| VISA | Recibir solicitudes de pago de prueba y devolver el resultado según el contrato docente. |
===== Entidades iniciales =====
* **Producto**: identificador, nombre, descripción, precio y disponibilidad.
* **Carrito**: productos elegidos y sus cantidades antes de confirmar la compra.
* **Pedido**: copia de los productos, cantidades y precios acordados al confirmar.
* **Pago**: solicitud enviada a VISA y resultado recibido, asociado al pedido.
Los campos definitivos se acordarán al diseñar el modelo de datos.
===== Cliente: procesos y reglas =====
==== Consultar el catálogo y un producto ====
El cliente puede recorrer el catálogo y consultar el detalle de un producto antes de añadirlo al carrito.
* Solo se muestran como disponibles los productos que la tienda haya habilitado para la venta.
* El precio que se muestra debe ser el mismo que se utiliza al confirmar la compra.
==== Preparar el carrito ====
El cliente añade productos, cambia cantidades o los quita antes de confirmar.
* La cantidad de cada línea debe ser un número entero positivo.
* Un carrito vacío no se puede confirmar.
* El total se calcula a partir de los precios vigentes y las cantidades; el servidor debe volver a comprobarlo al crear el pedido.
==== Confirmar y pagar un pedido ====
La tienda envía a VISA la solicitud de pago siguiendo el contrato facilitado por el profesorado.
* El pedido guarda los productos, cantidades y precios aplicados al confirmarlo; un cambio posterior del catálogo no altera compras anteriores.
* El pedido solo pasa a **Pagado** cuando VISA devuelve una autorización válida.
* Si VISA deniega el pago o no está disponible, la tienda informa del resultado y no lo presenta como pagado.
* El identificador y los datos de tarjeta se tratarán según el contrato docente. Se usarán únicamente datos de prueba; la tienda no debe guardar el CVV.
==== Consultar pedidos ====
El cliente puede revisar los pedidos que le pertenecen y su estado. No debe poder consultar pedidos de otras personas.
===== Administrador/a: procesos y reglas =====
* **Mantener el catálogo**: crear, editar, activar o desactivar productos.
* **Consultar pedidos**: localizar pedidos y comprobar su estado de pago.
* Los cambios de catálogo no deben modificar los datos históricos de los pedidos ya confirmados.
* Las acciones de administración deben estar reservadas al perfil autorizado que se defina para la aplicación.
===== Ciclo de vida provisional del pedido =====
@startuml
title Estados del pedido tras el pago
left to right direction
skinparam backgroundColor #FFFFFF
skinparam shadowing false
skinparam defaultFontName Arial
skinparam defaultFontSize 14
skinparam state {
BackgroundColor #EAF2F8
BorderColor #49647B
FontColor #25384B
FontSize 14
}
skinparam ArrowColor #49647B
skinparam ArrowFontColor #526273
skinparam ArrowFontSize 12
state "Pendiente de pago" as Pendiente
state "Pagado" as Pagado
state "Pago denegado" as Denegado
state "Cancelado" as Cancelado
[*] --> Pendiente : confirmar pedido
Pendiente --> Pagado : VISA autoriza
Pendiente --> Denegado : VISA deniega
Pendiente --> Cancelado : cancelar
Pagado --> [*]
Denegado --> [*]
Cancelado --> [*]
scale max 850 width
@enduml
===== Pantallas iniciales =====
Estas son composiciones de trabajo con datos ficticios; el diseño definitivo se ajustará durante el proyecto.
@startsalt
skinparam backgroundColor #F5F7FA
skinparam dpi 160
{
{+ Tienda de prueba | Inicio | Catálogo | Carrito | Entrar }
== Catálogo de productos ==
{ "Buscar productos..." | ^Todas las categorías^ | [Filtrar] }
.
{+
Producto | Descripción | Precio | Acción
Cafetera | Preparación sencilla | 29,90 € | [Ver] [Añadir]
Taza cerámica | Para bebidas calientes | 6,50 € | [Ver] [Añadir]
Molino manual | Muele café | 18,75 € | [Ver] [Añadir]
}
}
@endsalt
@startsalt
skinparam backgroundColor #F5F7FA
skinparam dpi 160
{
{+ Tienda de prueba | Inicio | Catálogo | Carrito | Mis pedidos }
== Carrito ==
{+
Producto | Cantidad | Precio
Cafetera de prueba | 1 | 29,90 €
Taza cerámica | 1 | 6,50 €
}
{+
Resumen del pedido
Subtotal | 36,40 €
Total | 36,40 €
[Pagar con VISA de prueba]
}
"Entorno educativo: no se realizará ningún cargo real."
}
@endsalt
===== Integración con VISA =====
La definición de los campos, respuestas, seguridad y errores de pago queda pendiente del contrato oficial del proyecto VISA. Hasta entonces, esta página describe el proceso a nivel funcional y no constituye una especificación de API.
Los estados y los reintentos se ajustarán al contrato que publique el profesorado.