Construyendo el CRUD para las Piezas del Almacén - Episodio 11

La próxima aventura es construir un CRUD para las piezas de Almacén.

Así que vamos a seguir con esta aventura de construir un SaaS apoyándome con la IA como copiloto.

📅 Diario de un SaaS: Construyendo el CRUD para las Piezas del Almacén

Venga va!

A por el primer desafío.

🔄 El Desafío de Gestionar Datos: Crear, Leer, Actualizar, Eliminar

Una vez que conseguí conectar Flask con PostgreSQL, pensé que lo peor había pasado.

“Ahora solo queda hacer el CRUD”, me dije ingenuamente.

¡Ja!

Qué equivocado estaba. 😅

Crear, Leer, Actualizar y Eliminar datos suena fácil en teoría.

Pero cuando empecé a escribir el código, me di cuenta de que cada operación traía sus propios problemas y frustraciones.

Parecía que el CRUD tenía vida propia y decidía cuándo funcionar y cuándo no. 😤

🔍 ¿Qué es un CRUD y por qué lo Necesito?

Antes de seguir adelante, aclaremos algo importante:

¿Qué es un CRUD?

Un CRUD es un conjunto de operaciones básicas que se utilizan para gestionar datos en una base de datos.

O sea, CRUD son las siglas de:

• Create (Crear): Añadir nuevos registros o datos. En este caso, crear piezas en el almacén digital.
• Read (Leer): Obtener o ver registros existentes. Por ejemplo, listar todas las piezas disponibles.
• Update (Actualizar): Modificar datos existentes. Como cambiar el precio o el estado de una pieza.
• Delete (Eliminar): Borrar registros que ya no son necesarios. Como eliminar piezas que ya no están disponibles.

En otras palabras, el CRUD es el corazón de cualquier aplicación que maneje datos.

Sin CRUD, no puedes gestionar información, y el SaaS se convertiría en una web estática y aburrida.

Por eso era tan importante implementarlo correctamente.

🔍 Problema: La Ilusión de la Simplicidad

Empecé con optimismo, pensando que el CRUD sería cuestión de unas pocas líneas de código.

De hecho, parezco nuevo o muy optimista.

A cada cosa pienso que será fácil y luego la realidad me golpea en la cara con crueldad y sin piedad.

Y claro...

Al nada ya me enfrenté a una serie de desafíos inesperados:

GET /parts

Lo que parecía una simple consulta para obtener todas las piezas, se convirtió en una pesadilla de rendimiento.

La primera vez que probé la ruta, la API tardó casi 10 segundos en devolver los datos.

¿Cómo era posible?

Resulta que no estaba manejando bien las relaciones en la consulta.

(Menudo genio estoy hecho)

POST /parts

Aquí me enfrenté a otro monstruo: la validación de datos.

Si no verificas que el título, el precio y otros campos sean correctos, corres el riesgo de almacenar basura en la base de datos.

Casi como convertirte en el diógenes de los datos.

La primera vez que probé la ruta, agregué un producto con el precio en letras… y PostgreSQL me lanzó un error que parecía un poema maldito. 😵

PUT /parts/

Actualizar una pieza parecía sencillo...

Como todo lo que se imagina mi mente, vaya.

Y qué pasó?

Pues hasta que me di cuenta de que podía sobreescribir todo el registro con un solo campo mal escrito.

La primera vez, actualicé el precio… y el título desapareció.

¡Yupi!

DELETE /parts/:

Eliminar una pieza suena a borrar un archivo, ¿verdad? Pues no.

En una base de datos, si eliminas un registro que tiene relaciones con otras tablas, puedes romper toda la estructura.

Casi lo hago. 🙈

En conclusión:

Cada ruta CRUD fue una batalla contra problemas que ni siquiera sabía que existían.

Y la mayoría de las soluciones no estaban en StackOverflow…

Creo que estresé a ChatGPT a consultas...

Pero... lo logré!

Te lo cuento:

🛠️ La Solución: CRUD con Protección JWT

Después de pelearme con errores y consultar más documentación de la que me gustaría admitir, logré implementar el CRUD para gestionar piezas en el almacén digital.

Pero no solo eso...

También añadí protección con JWT (JSON Web Tokens) para que solo los usuarios autenticados pudieran crear, actualizar o eliminar piezas.

• GET /parts: Optimicé la consulta usando relaciones correctamente y agregué paginación para que no cargara miles de registros a la vez. Esto mejoró el rendimiento y la velocidad de la API.
• POST /parts: Añadí validaciones estrictas para asegurarme de que solo se aceptaran datos correctos. Ahora, si intentas enviar un precio en letras, la API te devuelve un error claro y específico.
• PUT /parts/: Implementé una lógica de actualización parcial, lo que significa que solo se actualizan los campos que envías, sin sobreescribir el resto del registro.
• DELETE /parts/: Antes de eliminar una pieza, la API verifica si tiene relaciones con otras tablas. Si las tiene, devuelve un error explicando que no se puede eliminar sin afectar a otros registros.

🔑 Protegiendo el CRUD con JWT

Cada ruta está protegida con JWT para que solo los usuarios autenticados puedan hacer cambios en las piezas.

Esto fue un desafío extra, porque requería gestionar tokens, manejar expiraciones y devolver errores específicos cuando un token no era válido o había expirado.

💡 Lecciones Aprendidas

• CRUD no es tan fácil como parece: Cada operación CRUD tiene sus propios desafíos, y si no tienes cuidado, puedes terminar rompiendo la base de datos.
• Valida los datos como si tu vida dependiera de ello: Especialmente en POST y PUT. Un solo campo incorrecto puede crear problemas difíciles de rastrear.
• JWT es poderoso, pero complicado: Al principio me pareció innecesario, pero una vez implementado, me di cuenta de que es indispensable para proteger rutas sensibles.
• El orden en Flask importa: Si colocas el middleware de JWT en el lugar equivocado, puede bloquear todas las rutas, incluso las que no necesitan autenticación. Me pasó… varias veces. 😅

🚀 Próximo Paso: Optimizando Búsquedas con Filtros Avanzados

Ahora que el CRUD está funcionando, es momento de mejorar la experiencia de usuario con filtros avanzados.

La idea es permitir búsquedas específicas por marca, modelo, estado o precio.

¿Sonará sencillo?

Seguro que no. 🤔

Auguro ya otro drama al canto!

➡️ ¿Alguna vez pensaste que CRUD era fácil y terminaste rompiendo todo?

¡Lloremos juntos en los comentarios!

Si quieres conocer otros artículos parecidos a Construyendo el CRUD para las Piezas del Almacén - Episodio 11 puedes visitar la categoría Proyecto-IA.