Para los que le sale el error: "NODE_ENV" no se reconoce como un comando interno o externo, programa o archivo por lotes ejecutable. Solo deben instalar la dependencia:
npm install -g win-node-env
¿Cómo iniciamos con el proyecto base que integra GradQL?
Empezamos nuestra jornada con un proyecto base que ya cuenta con una arquitectura y conecta a una base de datos empleando varias tecnologías esenciales. Este proyecto no solo utiliza una API REST, sino que también se le añadirá GradQL, permitiendo así la coexistencia de ambas arquitecturas. La metodología que veremos a continuación es fruto de un proceso de aprendizaje estructurado a través de varios cursos.
¿Cómo clonamos e instalamos el proyecto base?
Para comenzar, es vital descargar el proyecto desde el repositorio alojado en platzi/platzi.curso.nodejs.gradql. Esto puede hacerse de dos maneras:
Una vez elegida la opción deseada, dirígete a un espacio personal de tu computadora donde desees guardar el proyecto. Desde allí ejecuta el siguiente comando para clonar el proyecto:
git clone <URL_del_repositorio>
Luego de la clonación, entra a la carpeta del proyecto y procede a instalar las dependencias requeridas. Esto se realiza comúnmente con un gestor de paquetes como npm.
¿Cómo configuramos las variables de entorno?
Uno de los pasos cruciales en la configuración de cualquier proyecto es establecer las variables de entorno. Este proyecto previo exige que recursos como contraseñas y claves de API se definan en el archivo .env, que no se sube al repositorio por razones de seguridad. Para facilitar esta tarea, se ofrece un archivo de ejemplo .env.example que debes personalizar:
.env y copia el contenido de .env.example.DATABASE_USER=Nico DATABASE_PASSWORD=admin123 JWT_SECRET=MyCat
¿Cómo levantamos el contenedor de Postgres?
El proyecto utiliza Docker para gestionar el entorno de la base de datos. Para poner en marcha el contenedor ejecuta:
docker-compose up -d postgres
Para verificar que Postgres está operativa, utiliza:
docker-compose ps
¿Cómo ejecutamos las migraciones y poblamos la base de datos?
Para que la base de datos funcione correctamente, es necesario ejecutar las migraciones que crean la estructura de las tablas. Detén tu servidor de desarrollo y ejecuta las migraciones con:
npm run migrations:run
Para poblar la base de datos con datos iniciales, ejecuta:
npm run migrations:set:auth
Después de estos pasos, reinicia tu servidor de desarrollo para empezar a interactuar con la API.
¿Cómo exploramos la API REST y GradQL?
Una herramienta útil para interactuar con la API REST es Insomnia o Postman. Dentro del repositorio, encontrarás archivos como insomnia.json y postman.json, que facilitan esta tarea:
GET /api/v1/users para probar el funcionamiento.En el caso de endpoints protegidos, se requiere un access token. Esto se genera normalmente a través del login, por ejemplo:
POST /api/v1/auth/login
Una vez obtengas el token, utilízalo para acceder a endpoints seguros como GET /api/v1/categories.
Explorar este proyecto te permitirá entender su estructura y capacidad, fomentando la interacción y aprendizaje continuo en el desarrollo con GradQL. Al avanzar, profundizaremos en la organización del código, lo que facilitará su implementación práctica.
Empezamos nuestra jornada con un proyecto base que ya cuenta con una arquitectura y conecta a una base de datos empleando varias tecnologías esenciales. Este proyecto no solo utiliza una API REST, sino que también se le añadirá GradQL, permitiendo así la coexistencia de ambas arquitecturas. La metodología que veremos a continuación es fruto de un proceso de aprendizaje estructurado a través de varios cursos.
Para comenzar, es vital descargar el proyecto desde el repositorio alojado en platzi/platzi.curso.nodejs.gradql. Esto puede hacerse de dos maneras:
Una vez elegida la opción deseada, dirígete a un espacio personal de tu computadora donde desees guardar el proyecto. Desde allí ejecuta el siguiente comando para clonar el proyecto:
git clone <URL_del_repositorio>
Luego de la clonación, entra a la carpeta del proyecto y procede a instalar las dependencias requeridas. Esto se realiza comúnmente con un gestor de paquetes como npm.
Uno de los pasos cruciales en la configuración de cualquier proyecto es establecer las variables de entorno. Este proyecto previo exige que recursos como contraseñas y claves de API se definan en el archivo .env, que no se sube al repositorio por razones de seguridad. Para facilitar esta tarea, se ofrece un archivo de ejemplo .env.example que debes personalizar:
.env y copia el contenido de .env.example.DATABASE_USER=Nico
DATABASE_PASSWORD=admin123
JWT_SECRET=MyCat
El proyecto utiliza Docker para gestionar el entorno de la base de datos. Para poner en marcha el contenedor ejecuta:
docker-compose up -d postgres
Para verificar que Postgres está operativa, utiliza:
docker-compose ps
Para que la base de datos funcione correctamente, es necesario ejecutar las migraciones que crean la estructura de las tablas. Detén tu servidor de desarrollo y ejecuta las migraciones con:
npm run migrations:run
Para poblar la base de datos con datos iniciales, ejecuta:
npm run migrations:set:auth
Después de estos pasos, reinicia tu servidor de desarrollo para empezar a interactuar con la API.
Una herramienta útil para interactuar con la API REST es Insomnia o Postman. Dentro del repositorio, encontrarás archivos como insomnia.json y postman.json, que facilitan esta tarea:
GET /api/v1/users para probar el funcionamiento.En el caso de endpoints protegidos, se requiere un access token. Esto se genera normalmente a través del login, por ejemplo:
POST /api/v1/auth/login
Una vez obtengas el token, utilízalo para acceder a endpoints seguros como GET /api/v1/categories.
Explorar este proyecto te permitirá entender su estructura y capacidad, fomentando la interacción y aprendizaje continuo en el desarrollo con GradQL. Al avanzar, profundizaremos en la organización del código, lo que facilitará su implementación práctica.
Para los que le sale el error: "NODE_ENV" no se reconoce como un comando interno o externo, programa o archivo por lotes ejecutable. Solo deben instalar la dependencia:
npm install -g win-node-env
Para los que prefieran usar postman, aqui les comparto el archivo .json con las peticiones.
Hasta aquí llegué con este curso. Yo solo necesitaba aprender GraphQL en NodeJS y resulta que necesito saber más cosas. El curso debería llamarse Curso de GraphQL con NodeJs con Docker con Postgres.
No está aun disponible el archivo de peticiones API para postman.
Regreso luego de tomar 2 cursos previos, hasta más tarde :'v
y como lo hacemos si el proyecto del curso anterior no nos funciono? O para quienes no han hecho los cursos o que no saben docker? Creo que deberían haber hecho este curso con un proyecto desde cero. Perdí media tarde tratando de instalar docker en windows y no se como crear el servicio postgres para continuar con el curso...
y donde esta el archivo de postman que no lo puedo encontrar en el repositorio ?
Al ejecutar migrations:run obtengo error de autenticación... Alguna idea ?

Hace tiempo que deje de usar insomnia o postman y empece a usar una herramienta de terminal, se llama HTTPie: https://httpie.io/
Una vez instalado, para hacer una petición GET y consultar los usuarios de la API ejecutas el comando:
http :3000/api/v1/users/
Deberían añadir un .npmrc para saber con qué versión de Node trabajar