docs: add full documentation for all functions in tienda/views.py

Agent-Logs-Url: https://github.com/dsaub/proyecto-final/sessions/49df17c8-213a-4e23-adfe-465a0104f6a3 Co-authored-by: dsaub <54474838+dsaub@users.noreply.github.com>
2026-04-09 10:35:28 +00:00
parent 47ea00c822
commit ed92991872
66 changed files with 2580 additions and 0 deletions
@@ -0,0 +1,32 @@
+# `_get_session_stock_reservation`
+
+**Archivo:** `tienda/views.py`  
+**Tipo:** Función auxiliar privada
+
+## Descripción
+
+Recupera la reserva de stock almacenada en la sesión del usuario, validando que siga activa, no haya caducado y corresponda al método de pago indicado.
+
+## Firma
+
+```python
+def _get_session_stock_reservation(
+    request: HttpRequest,
+    payment_method: str
+) -> StockReservation | None:
+```
+
+## Parámetros
+
+| Nombre           | Tipo          | Descripción                                        |
+|------------------|---------------|----------------------------------------------------|
+| `request`        | `HttpRequest` | Petición HTTP de Django.                           |
+| `payment_method` | `str`         | Método de pago esperado (`stripe` o `paypal`).     |
+
+## Retorno
+
+La instancia `StockReservation` activa si existe y es válida, o `None` si la sesión no tiene reserva, el método de pago no coincide o la reserva ha caducado.
+
+## Uso interno
+
+Llamada desde [`checkout_success`](./checkout_success.md) y [`paypal_execute`](./paypal_execute.md) para recuperar la reserva antes de confirmar el pedido.