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,40 @@
+# `editar_direccion`
+
+**Archivo:** `tienda/views.py`  
+**URL:** `/tienda/usuario/direcciones/editar/<id>/`  
+**Tipo:** Vista privada (requiere autenticación)  
+**Decorador:** `@login_required`
+
+## Descripción
+
+Muestra el formulario para editar una dirección de entrega existente y procesa sus cambios. Solo el propietario de la dirección puede editarla; intentar acceder a una dirección ajena lanza un error 404.
+
+Aplica las mismas validaciones de zona de envío que [`crear_direccion`](./crear_direccion.md).
+
+## Firma
+
+```python
+def editar_direccion(request: HttpRequest, id: int):
+```
+
+## Parámetros
+
+| Nombre    | Tipo          | Descripción                      |
+|-----------|---------------|----------------------------------|
+| `request` | `HttpRequest` | Petición HTTP de Django.         |
+| `id`      | `int`         | ID de la dirección a editar.     |
+
+## Campos del formulario POST
+
+Idénticos a [`crear_direccion`](./crear_direccion.md).
+
+## Redirecciones
+
+| Caso   | Destino               |
+|--------|-----------------------|
+| Éxito  | `direcciones_usuario` |
+| Error  | Mismo formulario      |
+
+## Template
+
+`tienda/editar_direccion.html`