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,39 @@
+# `categoria`
+
+**Archivo:** `tienda/views.py`  
+**URL:** `/tienda/categoria/<id>/`  
+**Tipo:** Vista pública
+
+## Descripción
+
+Muestra el catálogo paginado de productos filtrados por categoría. Reutiliza el template `tienda/index.html` para mostrar los resultados.
+
+## Firma
+
+```python
+def categoria(request: HttpRequest, id: int):
+```
+
+## Parámetros
+
+| Nombre    | Tipo          | Descripción                    |
+|-----------|---------------|--------------------------------|
+| `request` | `HttpRequest` | Petición HTTP de Django.       |
+| `id`      | `int`         | Identificador de la categoría. |
+
+## Parámetros GET
+
+| Parámetro | Tipo  | Por defecto | Descripción                 |
+|-----------|-------|-------------|-----------------------------|
+| `page`    | `int` | `1`         | Número de página a mostrar. |
+
+## Contexto del template
+
+| Variable     | Tipo      | Descripción                                          |
+|--------------|-----------|------------------------------------------------------|
+| `products`   | QuerySet  | Productos de la categoría en la página actual.       |
+| `categories` | QuerySet  | Todas las categorías para el menú de navegación.     |
+
+## Template
+
+`tienda/index.html`