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,36 @@
+# `checkout`
+
+**Archivo:** `tienda/views.py`  
+**URL:** `/tienda/checkout/`  
+**Tipo:** Vista privada (requiere autenticación)  
+**Decorador:** `@login_required`
+
+## Descripción
+
+Renderiza la página de checkout con el resumen del carrito, las direcciones de envío del usuario y los posibles problemas de stock. Desde esta página el usuario puede iniciar el pago con Stripe o PayPal.
+
+## Firma
+
+```python
+def checkout(request: HttpRequest):
+```
+
+## Parámetros
+
+| Nombre    | Tipo          | Descripción           |
+|-----------|---------------|-----------------------|
+| `request` | `HttpRequest` | Petición HTTP de Django. |
+
+## Contexto del template
+
+| Variable              | Tipo            | Descripción                                                     |
+|-----------------------|-----------------|-----------------------------------------------------------------|
+| `cart`                | `Cart`          | Carrito actual del usuario.                                     |
+| `cart_items`          | lista           | Ítems del carrito con productos precargados.                    |
+| `addresses`           | QuerySet        | Direcciones de envío registradas por el usuario.               |
+| `stock_issues`        | lista de `dict` | Conflictos de stock (vacía si no hay problemas).                |
+| `reservation_minutes` | `int`           | Minutos de validez de la reserva de stock.                      |
+
+## Template
+
+`tienda/checkout.html`