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,32 @@
+# `verify`
+
+**Archivo:** `tienda/views.py`  
+**URL:** `/tienda/verificar/<code>/`  
+**Tipo:** Vista pública
+
+## Descripción
+
+Verifica la cuenta de un usuario a partir de un código de verificación enviado por correo electrónico. Cuando el código es válido y corresponde al modo `VERIFY_ACCOUNT`, actualiza el estado de registro del usuario a `ACTIVE` y elimina el código usado.
+
+## Firma
+
+```python
+def verify(request: HttpRequest, code: str):
+```
+
+## Parámetros
+
+| Nombre    | Tipo          | Descripción                             |
+|-----------|---------------|-----------------------------------------|
+| `request` | `HttpRequest` | Petición HTTP de Django.                |
+| `code`    | `str`         | Código de verificación único del email. |
+
+## Redirecciones
+
+| Caso                        | Destino / Respuesta                                         |
+|-----------------------------|-------------------------------------------------------------|
+| Verificación exitosa        | `index`                                                     |
+| Código no encontrado        | `HttpResponse` con mensaje de error HTML                    |
+
+> [!NOTE]
+> El código de verificación se elimina de la base de datos tras ser utilizado, por lo que no puede usarse dos veces.