El proyecto de partida

Consigue el proyecto y arráncalo:

git clone https://github.com/webreactiva-devs/chiquito-api-ai-flow.git
cd chiquito-api-ai-flow
npm install
npm run db:init
npm run dev

Para ver la documentación de la API en Swagger UI, en otra terminal:

npx swagger-ui-watcher spec/openapi.yaml

📂 El resultado final del flujo está en la rama feature/admin-panel del mismo repositorio. Para verlo en local: git switch feature/admin-panel. Ahí tienes todos los documentos que se generan en la guía, en la carpeta docs/.

¿Qué haremos en este paso? ¶

Vas a poner en marcha el proyecto de partida: una API de chistes de Chiquito de la Calzada. Y vas a conocer el requisito que construimos en la guía: un panel de administración para gestionar los chistes.

¿Qué necesitas? ¶

El proyecto de partida clonado y en marcha, con los comandos de arriba. Si trabajas con tu propio proyecto, ten claro el requisito que quieres cumplir.

Acción ¶

Arranca la API con los comandos del principio. npm run db:init crea la base de datos SQLite con los chistes.

Abre Swagger UI para probar la API. La API no tiene interfaz visual, así que pruebas los endpoints desde ahí.

Prueba dos endpoints:

• El de estado: debe devolver ok.
• El de chistes aleatorios: pulsa Try it out y Execute. No tiene parámetros. Debe devolver un chiste.

Mira de dónde salen los chistes. Están en un fichero JSON. Al inicializar la base de datos, el proyecto copia ese contenido en ella.

El requisito que vamos a construir es un panel de administración para gestionar esos chistes.

💡 Si no sabes poner en marcha el proyecto o no conoces Swagger UI, pregúntale a tu agente de IA cómo se hace.

🧠 Cuanto mejor es el modelo que usas, mejores son los resultados. En el vídeo uso un modelo concreto, pero el flujo debe servir durante meses, incluso años.