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,33 @@
+# `view_cart`
+
+**Archivo:** `tienda/views.py`  
+**URL:** `/tienda/carrito/`  
+**Tipo:** Vista pública
+
+## Descripción
+
+Muestra el contenido actual del carrito de compra junto con los posibles problemas de stock. Excluye del cálculo de stock las reservas activas del propio usuario para no mostrar falsos avisos durante el checkout.
+
+## Firma
+
+```python
+def view_cart(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 sus productos relacionados precargados.  |
+| `stock_issues` | lista de `dict` | Lista de conflictos de stock (vacía si no hay problemas).      |
+
+## Template
+
+`tienda/cart.html`