Devoluciones - bootcamp-uchile-2026/grupo-2-backend GitHub Wiki

Devoluciones

Funcionalidad

Permite al usuario autenticado consultar el historial de devoluciones asociadas a su cuenta.


Objetivo

Proporcionar al usuario la información correspondiente a las devoluciones realizadas previamente y asociadas a su cuenta.


Responsabilidad del Backend

El backend deberá:

  1. Recibir las solicitudes de consulta de devoluciones.
  2. Identificar al usuario autenticado que realiza la solicitud.
  3. Consultar las devoluciones asociadas al usuario autenticado.
  4. Proporcionar la información de las devoluciones solicitadas, sin exponer información perteneciente a otros usuarios.

Contrato de API

Endpoint asociado:

GET /devoluciones

DTO de salida:

DevolucionDto[]

La definición completa del método HTTP, query parameters y respuestas se encuentra centralizada en Endpoints.

La estructura completa de los datos devueltos se encuentra centralizada en DTOs.


Reglas de negocio

  • El usuario debe estar autenticado para consultar sus devoluciones.
  • Un usuario solo podrá consultar las devoluciones asociadas a su propia cuenta.
  • Cada devolución debe contar con un identificador único.
  • Cada devolución debe estar asociada a un usuario y, cuando corresponda, a la compra relacionada.
  • Este servicio permite únicamente la consulta de devoluciones previamente registradas.
  • Las devoluciones no podrán ser modificadas mediante este servicio.

Relación con Página de Mi Cuenta

flowchart TD
    A[Mi Cuenta] --> B[Devoluciones]
    B --> C[Consultar devoluciones]
    C --> D["GET /devoluciones"]
    D --> E[Identificar usuario autenticado]
    E --> F[Consultar devoluciones del usuario]
    F --> G[DevolucionDto]
    G --> B