====== 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.