API FastAPI para usuarios, perfiles, autenticacion, proveedores e inventario. TinyDB conserva la persistencia existente; SQLModel conecta con PostgreSQL en Supabase para activos y movimientos. Resend envia enlaces de recuperacion de contrasena. Las entidades de inventario siguen BRIEFING.md.
El comando predeterminado desde la raíz levanta la API para desarrollo junto con ambas UIs:
docker compose up
Compose inyecta JWT_SECRET y DATABASE_URL desde el .env raíz, monta el
código y ejecuta Uvicorn con --reload. TinyDB se guarda en el volumen
api-development-data, aislado de services/data/db.json. PostgreSQL sigue
siendo el servidor indicado por DATABASE_URL; el arranque puede crear las
tablas que falten.
Para producción, la configuración se conserva en compose.prod.yaml:
docker compose -f compose.prod.yaml up --build
Al ejecutar FastAPI directamente en el host, la API carga services/.env.
Necesitas uv y Python 3.12 o superior. Si no tienes uv, sigue las
instrucciones oficiales.
Comprueba que esta disponible:
uv --version
Desde la raiz del repositorio:
cd services
Ejecuta los siguientes comandos desde este directorio, no desde los backends
archivados legacy-api/api/ o services-1/api/.
uv sync --python 3.12
uv sync crea el entorno .venv/ del workspace e instala las dependencias
declaradas en pyproject.toml. En este monorepo, el entorno
compartido puede estar en la raiz, no dentro del servicio. Si Python 3.12 no esta disponible, uv puede
descargarlo automaticamente. La primera instalacion necesita acceso a internet.
El stack de autenticacion incluye tinydb, bcrypt, python-jose[cryptography],
python-dotenv y resend. email-validator se instala mediante
pydantic[email]; el hash de contrasenas se utiliza a traves de Passlib.
El inventario usa sqlmodel y psycopg2-binary, incluidos en las dependencias;
no necesitas instalarlos por separado despues de uv sync.
No necesitas activar manualmente el entorno: uv run ejecuta los comandos
dentro de .venv/. No uses el Python global para arrancar esta API.
Crea un archivo .env en este directorio con las siguientes variables.
Sustituye los valores de ejemplo antes de iniciar la API:
JWT_SECRET=reemplazar_por_un_secreto_aleatorio
ACCESS_TOKEN_EXPIRE_MINUTES=30
FRONTEND_URL=http://localhost:3000
RESEND_API_KEY=reemplazar_por_la_clave_de_resend
RESEND_FROM_EMAIL=Acceso <no-reply@tu-dominio-verificado.com>
DATABASE_URL="postgresql+psycopg2://postgres.PROJECT_REF:DB_PASSWORD@POOLER_HOST:6543/postgres?sslmode=require"
La URI anterior es un ejemplo, no una conexion valida. Para inventario necesitas
DATABASE_URL y JWT_SECRET; Resend y FRONTEND_URL son necesarios para los
flujos de recuperacion por correo, no para registrar movimientos.
Puedes generar un secreto para JWT_SECRET localmente:
uv run python -c "import secrets; print(secrets.token_urlsafe(48))"
JWT_SECRET entre CodespacesJWT_SECRET firma los tokens de acceso. Debe permanecer igual en todos los
Codespaces que usan esta API; si cambia, los tokens emitidos con el valor
anterior dejaran de ser validos. No generes uno nuevo cada vez que crees un
Codespace.
Para compartirlo de forma segura entre Codespaces:
JWT_SECRET como
nombre y pega el valor generado como secreto.La aplicacion carga .env y luego lee JWT_SECRET del entorno. En Codespaces,
la variable inyectada como secreto tiene prioridad sobre el valor local de
.env. Para desarrollo fuera de Codespaces, configura el valor localmente en
.env, que esta excluido de Git.
.env a Git. Guarda las claves solo en la configuracion
local o en el gestor de secretos del despliegue.FRONTEND_URL debe ser la URL accesible del backoffice, sin incluir
/reset-password. El correo dirige al usuario a esa pagina con un token.RESEND_FROM_EMAIL debe usar un dominio verificado en Resend para enviar a
usuarios reales. onboarding@resend.dev es un remitente de prueba restringido
al correo asociado a la cuenta de Resend.database.py carga explicitamente el .env de este directorio; otras partes
de la API tambien utilizan load_dotenv(). Ejecutar desde este directorio
mantiene la configuracion local consistente. Las variables ya exportadas
en el proceso tienen prioridad sobre .env.| Base | Datos | Como se pone en marcha |
|---|---|---|
| TinyDB | Usuarios, perfiles, tokens de recuperacion y proveedores | database.py abre data/db.json dentro del servicio y crea el archivo si falta. No requiere servidor, Docker ni comando de arranque propio. |
| Supabase PostgreSQL | asset, assetentry y assetexit |
Crea o utiliza un proyecto de desarrollo activo en Supabase y configura DATABASE_URL. PostgreSQL se ejecuta en Supabase, no en el Codespace. |
Para configurar Supabase:
[YOUR-PASSWORD] por la contrasena de la base de datos, sin los
corchetes; no uses una API key ni la contrasena de tu cuenta de Supabase.
Codifica para URI los caracteres especiales de la contrasena.DATABASE_URL dentro del .env local. El
motor selecciona psycopg2 explicitamente tanto para postgresql:// como
para postgresql+psycopg2://. Usa SSL, por ejemplo sslmode=require en la
query de la URI, conservando los parametros que ya tenga.DATABASE_URL
como secreto Codespaces del repositorio, igual que JWT_SECRET.
Reinicia Codespaces existentes para recibir el secreto. Nunca publiques
la URI ni la copies en codigo, capturas o commits.No se usa Supabase Auth ni se replica una tabla de usuarios. user_uuid de cada
orden es una cadena con el ID del usuario de TinyDB, sin FK entre bases.
No borres ni sustituyas data/db.json: contiene las cuentas locales y no se
recupera automaticamente desde Supabase. Crear otro Codespace no replica ese
archivo; los secretos solo conservan configuracion, no los registros de TinyDB.
uv run uvicorn main:app --reload --host 127.0.0.1 --port 8000
Este comando levanta una sola API con ambas conexiones. Al arrancar, el
lifespan de main.py ejecuta SQLModel.metadata.create_all(engine)
para crear las tablas de inventario que falten y sus FK en Supabase. La
conexion debe tener permiso para crear el esquema; si falta DATABASE_URL
o Supabase no esta disponible, el servicio no puede arrancar correctamente.
No hay un segundo backend ni un PostgreSQL local que debas iniciar.
create_all no migra tablas existentes ni siembra registros. Una modificacion
posterior del modelo que requiera cambiar una tabla necesita una migracion
planificada, no borrar la tabla y volver a arrancar. database.py
mantiene el motor compartido, mientras get_db() crea y cierra una sesion
SQLModel por peticion; no hay sesiones globales.
--reload reinicia el servidor cuando modificas codigo y es solo para
desarrollo. Para permitir conexiones externas en un contenedor o Codespace,
puedes cambiar el host a 0.0.0.0 y configurar el reenvio del puerto. No
expongas la API publicamente sin la configuracion de seguridad del despliegue.
Si ya instalaste uv en este Codespace, no necesitas reinstalarlo ni activar
manualmente el entorno virtual. Abre una terminal de VS Code y ejecuta:
cd /workspaces/camiladev-company/services
uv run uvicorn main:app --reload --host 0.0.0.0 --port 8000
uv run utiliza el entorno .venv/ del proyecto y sincroniza las dependencias
si hace falta. Deja esta terminal abierta mientras utilizas la API.
Para acceder desde el navegador:
8000./docs para acceder a Swagger.
La URL tendra una forma similar a
https://<nombre-del-codespace>-8000.app.github.dev/docs.Ctrl+C en la terminal donde la iniciaste.Para login y recuperacion, configura primero las variables del paso 4.
En Codespaces, FRONTEND_URL debe ser la URL HTTPS reenviada del frontend
del backoffice, no la del puerto 8000 ni http://localhost:3000. Copiala
desde la pestana Puertos, usando el puerto donde arrancaste ese frontend.
Por ejemplo, si usa el puerto 3000:
FRONTEND_URL=https://<nombre-del-codespace>-3000.app.github.dev
Sustituye el nombre de ejemplo por la direccion real, sin /reset-password.
Con un puerto privado, el navegador debe tener acceso autenticado al Codespace
para abrir el enlace del correo. Reinicia la API despues de modificar .env.
No ejecutes el backend antiguo en el mismo puerto. El frontend del backoffice
usa http://127.0.0.1:8000 por defecto; si cambias el puerto, configura
AUTH_API_BASE_URL y SUPPLIERS_API_BASE_URL en el entorno del frontend y
reinicialo.
Con el servidor activo, abre otra terminal:
curl --fail http://127.0.0.1:8000/
La respuesta esperada es:
{"message":"API funcionando"}
Tambien puedes abrir:
Deten el servidor con Ctrl+C en la terminal donde lo iniciaste.
Gestiona equipos y materiales de Nexova en Valencia y Miami: compras o
entregas recibidas (AssetEntry), asignaciones a empleados y consumos
(AssetExit). Los endpoints conservan el nombre /products, pero la entidad
de negocio se llama Asset.
Las lecturas son publicas; las escrituras requieren Bearer JWT de un usuario activo de TinyDB. Los datos de inventario se guardan en Supabase y el UUID del creador de cada orden se toma de la sesion autenticada, no del request.
| Metodo y ruta | Operacion |
|---|---|
GET /inventory/products |
Listar activos con current_stock. Admite office=Valencia o office=Miami. |
POST /inventory/products |
Crear un Asset con stock inicial calculado de cero. SKU duplicado devuelve 409. |
GET /inventory/products/{id} |
Consultar un activo con su stock; devuelve 404 si no existe. |
POST /inventory/orders/inbound |
Registrar un AssetEntry con cantidad positiva. |
POST /inventory/orders/outbound |
Registrar un AssetExit; exige assigned_to en asignaciones y nulo en consumos. |
GET /inventory/orders |
Listar entradas y salidas con order_type, user_uuid y asset anidado. Admite filtro office. |
current_stock es la suma de entradas menos salidas; no se acepta en requests
ni se guarda como columna. Una salida superior al stock devuelve 400 antes
de insertar. Ambas clases de orden bloquean el activo durante su transaccion
para serializar movimientos concurrentes. Las listas usan agregaciones y joins,
sin consultas adicionales por cada orden.
Las respuestas son schemas Pydantic, no objetos ORM. Los campos extra, las
cantidades invalidas y las asignaciones incompletas devuelven 422; un activo
inexistente en una orden devuelve 404. La oficina de cada orden debe coincidir
con la del activo; en caso contrario devuelve 400 sin registrar el movimiento.
Las escrituras deben probarse solo
con datos de desarrollo autorizados. El arranque no siembra activos; consulta
la seccion de semillas de inventario para preparar la base de desarrollo.
| Entidad | Campos de request | Campos adicionales de respuesta |
|---|---|---|
Asset |
name, sku, category, office |
id, current_stock |
AssetEntry |
asset_id, quantity, supplier, office |
id, created_at, user_uuid |
AssetExit |
asset_id, quantity, exit_type, assigned_to, office |
id, created_at, user_uuid |
Categorias permitidas: hardware, peripherals, office_supplies y
training_materials. Oficinas: Valencia y Miami. Los nombres y SKU no
pueden estar vacios y sku es unico. quantity debe ser un entero positivo.
created_at se genera automaticamente en UTC; el cliente no puede enviar
ID de orden, fecha, user_uuid ni stock. asset_id debe referenciar un activo
existente; ambas tablas de ordenes tienen FK hacia asset.id.
Los modelos de tabla estan en models.py, los requests y responses Pydantic en schemas.py, y las rutas en routers/inventory.py. Los endpoints convierten sus resultados a schemas Pydantic; no devuelven objetos ORM directamente.
Con la API activa, abre http://127.0.0.1:8000/docs o la URL privada reenviada en Codespaces:
POST /users.POST /auth/login: username contiene tu email y
password tu contrasena, en formato application/x-www-form-urlencoded.
En Swagger puedes usar Authorize con ese flujo. Para otros clientes,
envia Authorization: Bearer <access_token> en cada escritura. No publiques
tokens ni captures la respuesta del login.Crea un activo con POST /inventory/products; empieza con stock cero:
{"name":"Equipo de demostracion","sku":"DEMO-IT-001","category":"hardware","office":"Valencia"}
Usa el id devuelto como asset_id en POST /inventory/orders/inbound.
El siguiente ejemplo supone que el activo creado tiene ID 1; sustituyelo
por el ID real:
{"asset_id":1,"quantity":5,"supplier":"Proveedor Demo","office":"Valencia"}
Registra una salida con POST /inventory/orders/outbound:
{"asset_id":1,"quantity":2,"exit_type":"allocation","assigned_to":"Empleado Demo","office":"Valencia"}
Para consumo, usa "exit_type":"consumption" y "assigned_to":null.
Tras estos movimientos, el stock de ese activo sera 5 - 2 = 3.
order_type (inbound o outbound), datos del activo en asset
y el UUID de su creador; el stock anidado es el actual, no una instantanea
del momento de la orden.curl --fail http://127.0.0.1:8000/inventory/products
curl --fail 'http://127.0.0.1:8000/inventory/products?office=Valencia'
curl --fail http://127.0.0.1:8000/inventory/orders
curl --fail 'http://127.0.0.1:8000/inventory/orders?office=Miami'
Los POST anteriores escriben en la base configurada: no los ejecutes antes de la semilla si quieres usarla en tablas vacias, ni sobre una base de produccion. No hay rutas para editar stock ni modificar o borrar ordenes.
| Estado | Causa |
|---|---|
401 |
Escritura sin token o con token invalido o expirado. |
403 |
Usuario inactivo o ID del usuario sin formato UUID valido. |
404 |
El activo consultado o referenciado por la orden no existe. |
409 |
SKU ya registrado. |
422 |
Campos extra, cantidad invalida, categoria/oficina invalida o asignacion inconsistente. |
400 |
Oficina de la orden distinta de la del activo, o salida superior al stock. |
En sobregiro el mensaje es:
Insufficient stock for asset '{name}'. Available: {available}, requested: {quantity}.
Ante un fallo de conexion, comprueba que el proyecto Supabase este activo, la
URI y contrasena sean correctas y que la red permita llegar al pooler. Revisa
los logs sin publicar credenciales. GET / solo confirma que FastAPI responde;
un GET de inventario exitoso tambien comprueba el acceso a las tablas Supabase.
La API del backoffice expone las siguientes rutas bajo /suppliers:
| Metodo y ruta | Operacion |
|---|---|
GET /suppliers |
Listar proveedores. Admite filtros opcionales country y category, que se pueden combinar. |
GET /suppliers/by-category?category=... |
Alias compatible para filtrar por categoria; para nuevas integraciones, usa GET /suppliers?category=.... |
POST /suppliers |
Crear un proveedor con el modelo Suppliers. |
PATCH /suppliers/{supplier_id}/status |
Cambiar el estado (active o suspended). |
PATCH /suppliers/{supplier_id}/rate |
Cambiar la tarifa mensual; debe ser mayor que cero. |
DELETE /suppliers/{supplier_id} |
Eliminar un proveedor por su ID numerico de TinyDB. |
Paises permitidos para el filtro: Spain y USA. Categorias: job_boards,
ats_software, assessment_tools, training_platforms,
payroll_and_hr_software, video_interview, background_check,
office_and_facilities e it_and_software_licenses. GET /suppliers
devuelve todos los proveedores si no se indican filtros.
Ejemplos de lectura seguros:
curl --fail http://127.0.0.1:8000/suppliers
curl --fail 'http://127.0.0.1:8000/suppliers?country=Spain'
curl --fail 'http://127.0.0.1:8000/suppliers?category=job_boards'
curl --fail 'http://127.0.0.1:8000/suppliers?country=USA&category=job_boards'
curl --fail 'http://127.0.0.1:8000/suppliers/by-category?category=job_boards'
Consulta /docs para ver los campos requeridos de creacion y los esquemas de
las solicitudes. POST, PATCH y DELETE escriben en la base activa.
DELETE elimina el documento de la base; respalda los datos antes y limita las
pruebas de escritura a proveedores de prueba autorizados.
| Metodo y ruta | Uso |
|---|---|
GET / |
Comprobar que la API responde; devuelve {"message":"API funcionando"}. No requiere sesion. |
| Metodo y ruta | Uso y acceso |
|---|---|
POST /auth/login |
Iniciar sesion con application/x-www-form-urlencoded; el campo username contiene el email. No requiere sesion. |
GET /auth/me |
Consultar la cuenta autenticada; requiere sesion Bearer. |
POST /auth/forgot-password |
Solicitar un enlace por email; la respuesta es uniforme y no confirma la entrega. No requiere sesion. |
POST /auth/reset-password |
Cambiar la contrasena con token y new_password; el enlace caduca a los 30 minutos y solo sirve una vez. No requiere sesion. |
POST /auth/change-password |
Cambiar la contrasena con current_password y new_password; requiere sesion Bearer. |
Un login invalido devuelve 401. Un token de restablecimiento invalido,
caducado o ya utilizado devuelve 400. Las contrasenas nuevas de mas de
72 bytes UTF-8 tambien se rechazan con 400.
Las rutas siguientes usan el prefijo /users. Salvo POST /users, requieren
sesion Bearer:
| Metodo y ruta | Uso y permisos |
|---|---|
POST /users |
Registrar una cuenta y su perfil; email valido y unico. No requiere sesion. |
GET /users |
Listar los datos publicos de todos los usuarios autenticados. |
GET /users/{user_id} |
Consultar los datos publicos del usuario propio o de cualquier usuario si quien consulta es admin. |
PUT /users/{user_id} |
Actualizar email, contrasena o estado de la cuenta propia; un admin tambien puede cambiar el rol. |
DELETE /users/{user_id} |
Eliminar la cuenta propia o cualquier cuenta si quien la elimina es admin. Es una operacion destructiva. |
La respuesta publica del usuario no incluye el hash de contrasena. Un email
duplicado al registrar o actualizar devuelve 400; un usuario inexistente
devuelve 404; intentar consultar, editar o eliminar la cuenta de otra
persona sin rol admin devuelve 403. El endpoint de lista requiere
autenticacion, pero no filtra por rol admin.
Ambas rutas requieren sesion Bearer y operan sobre el perfil de la cuenta
autenticada; no aceptan un user_id en la URL:
| Metodo y ruta | Uso |
|---|---|
GET /profiles/me |
Consultar el propio perfil. |
PUT /profiles/me |
Actualizar los campos enviados de nombre, telefono o direccion; los campos omitidos no se modifican. |
Si la cuenta no tiene perfil, ambas operaciones devuelven 404.
El frontend ofrece /register, /login, /forgot-password y
/account/change-password. El formulario enlazado desde el correo abre
/reset-password?token=.... Usa cuentas autorizadas y no compartas tokens,
contrasenas ni cabeceras de autenticacion. La recuperacion por correo y el
cambio de contrasena autenticado son flujos distintos.
seed_inventory.py inserta los seis activos, cuatro entradas y tres salidas
del briefing en Supabase. Requiere las tablas inicializadas por el arranque
de la API y un usuario activo existente en TinyDB; todas las ordenes llevan
su UUID. No modifica usuarios ni proveedores.
Para una instalacion nueva: configura ambas bases, arranca la API hasta que
complete el startup y crea una cuenta con POST /users si no tienes ninguna.
Puedes obtener tu UUID mediante GET /auth/me con sesion autenticada. Antes
de crear activos o movimientos manuales, ejecuta la semilla en otra terminal.
Usa seed_inventory.py, no seed.py: este ultimo es la
semilla destructiva de proveedores, no la de inventario.
Desde services/, solo sobre una base de desarrollo autorizada:
uv run python seed_inventory.py
Si hay exactamente un usuario activo, se usa como creador. Si hay varios, selecciona uno explicitamente:
uv run python seed_inventory.py --user-uuid UUID_DEL_USUARIO_ACTIVO
La semilla exige las tres tablas de inventario vacias. Bloquea esas tablas y confirma todos los registros en una sola transaccion, comprobando el stock antes del commit. Si hay datos existentes, se niega a ejecutarse sin borrar ni sobrescribir nada. No elimines registros para repetirla sobre una base real.
| SKU | Entradas | Salidas | Stock calculado |
|---|---|---|---|
| NXV-IT-001 | 15 | 3 | 12 |
| NXV-IT-002 | 8 | 2 | 6 |
| NXV-PER-001 | 0 | 0 | 0 |
| NXV-PER-002 | 0 | 0 | 0 |
| NXV-OFF-001 | 20 | 4 | 16 |
| NXV-TRN-001 | 0 | 0 | 0 |
Las asignaciones usan empleados ficticios y el consumo tiene assigned_to
nulo. GET /inventory/products y GET /inventory/orders permiten comprobar
los resultados sin nuevas escrituras.
ADVERTENCIA: este comando sobrescribe los datos de proveedores de la base
de datos. El script borra toda la tabla suppliers e inserta 15 proveedores
de ejemplo. No conserva los proveedores creados o editados anteriormente.
No borra las tablas de usuarios, perfiles ni tokens de recuperacion.
Usalo solo para preparar datos de prueba, no sobre datos reales que quieras conservar. No es necesario ejecutarlo cada vez que inicias la aplicacion.
Ctrl+C para evitar escrituras simultaneas en TinyDB.Desde el directorio del backend, respalda la base existente antes de sembrar. El siguiente comando crea una copia y se niega a sobrescribir un respaldo que ya tenga ese nombre:
cd /workspaces/camiladev-company/services
cp --no-clobber data/db.json data/db.before-seed.json
Comprueba que el respaldo corresponde a la base actual. Si ya existe
uno anterior, utiliza otro nombre. Si aun no existe data/db.json, no hay
una base que respaldar; el script la creara. Los respaldos pueden contener
datos sensibles: no los compartas ni los subas a Git.
Ejecuta el script de semillas:
uv run python seed.py
La salida esperada es Inserted 15 suppliers. El script valida los
ejemplos con Pydantic antes de reemplazar la tabla.
Reinicia la API:
uv run uvicorn main:app --reload --host 0.0.0.0 --port 8000
Desde otra terminal, comprueba los proveedores y un filtro:
curl --fail http://127.0.0.1:8000/suppliers
curl --fail 'http://127.0.0.1:8000/suppliers?country=Spain&category=job_boards'
/suppliers. Recarga la pagina para ver los ejemplos y comprobar el
listado y los filtros. Los cambios que hagas desde la aplicacion se
guardaran en la base; otra ejecucion de la semilla los reemplazara.Ejecuta siempre el script de este backend, no el de legacy-api/api/.
No copies una base antigua completa sobre la base unificada.
La API utiliza data/db.json, relativo a este directorio, para las tablas
users, profiles, password_reset_tokens y suppliers. No comparte
automaticamente los datos con services-1/api/data/db.json. No borres ni
sobrescribas la base existente al iniciar el servidor.
Ante un fallo de envio, el log de recuperacion incluye una categoria segura:
missing_api_key: falta RESEND_API_KEY.credentials_rejected: Resend rechazo las credenciales.connection_failed: fallo del cliente HTTP al contactar con Resend.provider_unavailable: Resend o un intermediario no esta disponible.provider_rejected: otro rechazo del proveedor, como validacion o limites.La respuesta de /auth/forgot-password sigue siendo generica para no revelar
si una cuenta existe. Un 200 no garantiza que el correo se haya enviado;
consulta los logs de la API y el estado del envio en Resend.
.app.github.dev, no localhost. Si se
copia una direccion local, usa Abrir en navegador y copia la URL HTTPS
de la barra de direcciones.Configura FRONTEND_URL en .env con esa direccion base, sin /login,
/reset-password ni parametros. Por ejemplo:
FRONTEND_URL=https://<nombre-del-codespace>-3000.app.github.dev
Usa el puerto real del frontend, no el 8000 de la API. localhost en el
enlace del correo apunta al ordenador del destinatario, no al Codespace.
Comprueba que has configurado un JWT_SECRET aleatorio y estable,
RESEND_API_KEY y RESEND_FROM_EMAIL. Si aun no tienes un dominio
verificado, puedes probar con:
RESEND_FROM_EMAIL=onboarding@resend.dev
En ese caso, solicita la recuperacion para una cuenta del backoffice cuyo email sea el asociado a la cuenta de Resend de esa clave. Para enviar a otros usuarios necesitas un dominio verificado.
Reinicia la API despues de modificar .env: detenla con Ctrl+C y
ejecuta desde este directorio:
uv run uvicorn main:app --reload --host 0.0.0.0 --port 8000
/forgot-password en el frontend del backoffice, introduce el email
de tu cuenta y selecciona Enviar enlace./login e inicia sesion con tu email y la nueva
contrasena.Manten el frontend y la API activos durante todo el proceso. El puerto del frontend puede permanecer Privado si abres el enlace en un navegador con acceso autenticado al Codespace; no necesitas hacerlo publico para generar una URL HTTPS correcta.
Si el correo no llega, revisa spam y los logs de la API y de Resend. Si el
enlace sigue apuntando a localhost, revisa FRONTEND_URL, reinicia la API
y solicita otro correo. Si ha caducado o ya se utilizo, solicita uno nuevo.
No compartas enlaces completos ni capturas que muestren el token. Si uno queda expuesto, solicita otra recuperacion para invalidarlo.
El registro, la actualizacion y la recuperacion validan el formato del email
con EmailStr y email-validator. El registro y la actualizacion guardan el
email normalizado, sin espacios externos y en minusculas. El login utiliza la
misma normalizacion y mantiene el error generico de credenciales para un email
invalido. No se comprueba la existencia del buzon ni se realizan consultas DNS.
La busqueda tambien normaliza los emails antiguos en memoria: no modifica
data/db.json ni fusiona cuentas. Un email antiguo invalido no coincide y
genera una advertencia sin datos personales. Si varias cuentas comparten el
mismo email normalizado, la operacion devuelve un error generico y registra
el conflicto; un administrador debe revisar y corregir esos registros antes
de utilizarlos. El registro y la actualizacion impiden nuevos duplicados por
diferencias de mayusculas o espacios.
Instala las dependencias opcionales de desarrollo:
uv sync --python 3.12 --extra dev
Para comprobar solo la solicitud de recuperacion:
uv run --extra dev pytest tests/test_forgot_password.py --no-cov
--no-cov evita aplicar el umbral de cobertura global de autenticacion a una
ejecucion parcial. Para trabajar con las dependencias opcionales instaladas,
conserva --extra dev en los comandos uv run correspondientes.