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,34 @@
+# `home`
+
+**Archivo:** `tienda/views.py`  
+**URL:** `/tienda/`  
+**Tipo:** Vista pública
+
+## Descripción
+
+Renderiza la página de inicio de la tienda. Muestra una selección de productos destacados (los 8 más recientes por ID), todas las categorías disponibles y estadísticas generales como el total de productos y el número de vendedores activos.
+
+## Firma
+
+```python
+def home(request: HttpRequest):
+```
+
+## Parámetros
+
+| Nombre    | Tipo          | Descripción           |
+|-----------|---------------|-----------------------|
+| `request` | `HttpRequest` | Petición HTTP de Django. |
+
+## Contexto del template
+
+| Variable           | Tipo        | Descripción                                              |
+|--------------------|-------------|----------------------------------------------------------|
+| `featured_products` | QuerySet   | Últimos 8 productos ordenados por ID descendente.        |
+| `categories`        | QuerySet   | Todas las categorías disponibles.                        |
+| `total_products`    | `int`      | Número total de productos en la tienda.                  |
+| `total_sellers`     | `int`      | Número de usuarios que tienen al menos un producto creado. |
+
+## Template
+
+`tienda/home.html`