El entorno del laboratorio

Haz esto antes de la primera sesión. Si algo no funciona, avisa al instructor con antelación y no el día de la clase.

Tus credenciales

El instructor te entrega un usuario con esta forma:

usuario:  studentNN            (NN es tu número, con dos dígitos: 01, 02, …)
email:    studentNN@theproject.ec
password: (te lo entregan por canal privado)

Esas mismas credenciales sirven para tres sitios: la aplicación web, la consola de base de datos y el repositorio de código.

WARNING

Es un laboratorio de práctica: no metas datos personales reales en ningún formulario, ni reutilices contraseñas que uses en otros sitios.

Comprueba que puedes entrar

1. La aplicación

Abre web.theproject.ec e inicia sesión. Deberías ver tu listado de citas con algunas ya creadas.

2. La API

Abre api.theproject.ec/docs. Es la documentación interactiva (Swagger): la lista de todo lo que la aplicación sabe hacer. No necesitas iniciar sesión para verla.

Prueba el endpoint GET /health: debe responder "estado": "ok".

3. La base de datos

Abre db.theproject.ec y entra con:

Campo	Valor
Motor	PostgreSQL
Servidor	postgres-lab
Usuario	student_ro
Contraseña	lectura-qa-2026
Base de datos	reservalab

Es un usuario de solo lectura: puedes consultar todo, pero cualquier intento de modificar datos va a fallar. Es a propósito.

4. El repositorio

Abre gitea.theproject.ec, entra con tu usuario y verifica que ves un repositorio llamado studentNN-qa. Ahí trabajas los módulos 2 y 3.

Qué instalar en tu máquina

Para los módulos 2 y 5 necesitas:

Herramienta	Para qué	Dónde
Git	Clonar tu repositorio y versionar tu trabajo	git-scm.com
Node.js 20 o superior	Ejecutar las pruebas automatizadas	nodejs.org
Bruno	Probar la API a mano	usebruno.com
Un editor	Escribir código (recomendado: VS Code)	code.visualstudio.com

Comprueba que quedaron bien instalados:

git --version      # debe decir 2.x
node --version     # debe decir v20 o superior

Reglas de uso

El laboratorio es compartido con el resto del grupo. Tres cosas a tener en cuenta:

1. Trabaja solo con tu usuario. Cada quien tiene sus propias citas y su propio repositorio. Si tocas los de otro, le rompes el ejercicio.
2. Las pruebas de carga las lanza el instructor. Si todos lanzamos carga a la vez, nadie puede trabajar.
3. El pipeline procesa un trabajo a la vez. Si haces push y tu ejecución queda en espera, es normal: hay alguien delante. Cada corrida tarda 1-3 minutos.

Si algo se rompe del todo

El instructor puede devolver el laboratorio a su estado inicial en unos segundos. No tengas miedo de experimentar: para eso está.