Objetivo de esta guia

Al terminar esta guia vas a poder:

• ejecutar Java 21 y un proyecto Kotlin con Gradle;
• abrir, ejecutar y probar el proyecto en IntelliJ IDEA;
• identificarte ante GitHub desde la terminal;
• unirte al classroom, aceptar un assignment y clonar tu repositorio;
• realizar un cambio, crear un commit y entregarlo con gh student submit;
• de forma opcional, verificarte como estudiante y usar GitHub Copilot gratis;
• iniciar OpenCode y conectarlo con un proveedor de IA.

La instalacion termina cuando verificamos el flujo completo, no cuando desaparece el instalador.

Mapa del entorno

No instalaremos Gradle ni el compilador de Kotlin globalmente: el proyecto proveera el Gradle Wrapper.

Preparar la cuenta de GitHub

1. Inicia sesion en https://github.com/.
2. Verifica el correo de la cuenta.
3. Activa autenticacion de dos factores, 2FA.
4. Acepta la invitacion de GitHub al classroom, cuando la catedra la envie.
5. Configura una forma de recuperar la cuenta.
6. Ejecuta gh --version en la terminal.

Classroom 50 corre enteramente sobre GitHub. La invitacion llega por correo; tambien se puede aceptar desde classroom50.org o al abrir el link del assignment.

GitHub ya no acepta la contraseña de la cuenta para operaciones Git por HTTPS. No pegues tokens ni claves en comandos, README o Prompt Log.

GitHub Copilot gratis para estudiantes

1. Aplica a GitHub Education. En https://github.com/settings/education/benefits pulsa Start an application (correo academico o constancia de alumno).
2. Activa Copilot. Cuando te aprueben, volve a https://github.com/settings/education/benefits y pulsa Learn more. Puede tardar unos dias; si solo ves opciones pagas, no compres: espera y reintenta.
3. Usa Copilot en cualquier repo. Con Copilot activo, podes usarlo en cualquier repositorio, incluidos los de Classroom 50.

Opcional, pero muy recomendado: te deja usar Copilot Student sin pagar mientras GitHub te mantenga verificado.

Instalar IntelliJ IDEA

Metodo recomendado para los tres sistemas:

1. Descarga JetBrains Toolbox App desde https://www.jetbrains.com/toolbox/app/.
2. Instala y abri Toolbox.
3. Instala la version estable de IntelliJ IDEA.
4. Inicia IntelliJ y conserva habilitado el plugin Kotlin incluido.

No hace falta una suscripcion para las funciones esenciales del curso.

En el primer proyecto comprobaremos:

File → Project Structure → Project SDK → JDK 21
Settings → Build Tools → Gradle → Gradle JVM → JDK 21

Conectar un proveedor

OpenCode no incluye automaticamente acceso a un modelo. Vas a usar un proveedor compatible de tu eleccion.

1. Ejecuta opencode.
2. Escribi /connect.
3. Elegi el proveedor.
4. Segui el flujo de autenticacion o ingresa tu API key.
5. Selecciona un modelo disponible.

Las claves deben permanecer fuera de Git:

• no las escribas en el codigo, README o Prompt Log;
• no las agregues a opencode.json si el archivo se versiona;
• si una clave se publica, revocarla inmediatamente.

Primera verificacion de OpenCode

En este paso solo se comprueba instalacion y conexion. La consulta sobre el proyecto Kotlin se hace en el Paso 4, una vez clonado el assignment.

opencode

Confirma que arranca y que un modelo esta disponible. Si falta el proveedor, ejecuta /connect.

Registra proveedor, prompt, respuesta, evaluacion y decision en el Prompt Log. Nunca incluyas la API key.

¿Que es Classroom 50?

Los TPs se entregan con Classroom 50. Corre enteramente sobre GitHub: aceptar un assignment crea un repositorio privado; entregar es commitear, pushear y (cuando corresponda) ejecutar gh student submit.

Hay dos caminos equivalentes:

La catedra invita al classroom (organizacion de GitHub) y comparte el link o los slugs del assignment. No crees otro repositorio ni hagas fork.

Documentacion: https://classroom50.org

Unirse al classroom

El classroom pertenece a una organizacion de GitHub. La catedra invita y GitHub envia un correo.

Acepta la invitacion de cualquiera de estas formas:

• segui el link del correo;
• inicia sesion en classroom50.org: la home lista invitaciones pendientes → Accept and open;
• abri el link del assignment que comparte la catedra: la pagina acepta la invitacion antes de mostrar el TP.

Si el link dice Not a member yet, pedi a la catedra que agregue el usuario al roster y reenvie la invitacion. Cuando llegue, acepta y pulsa Check again.

gh student accept tambien acepta la invitacion pendiente de la organizacion.

Iniciar sesion en la web

En https://classroom50.org pulsa Sign in with GitHub y autoriza Classroom 50.

Si el navegador falla:

1. expandi Other sign-in methods;
2. elegi Use a device code instead;
3. copia el codigo de un solo uso;
4. pegalo en la pagina de verificacion de GitHub.

Classroom 50 detecta la autorizacion en unos segundos.

Clonar y trabajar

Anda a la carpeta code y ejecuta el git clone que imprime accept (o el de My submission en la web). Un solo clone:

cd <carpeta-code>
git clone <url-del-repositorio>
cd <carpeta-del-assignment>
git remote -v

Edita, commitea y pushea a la rama por defecto como siempre.

1. En IntelliJ elegi Open y selecciona la carpeta clonada.
2. Confia en el proyecto solo porque proviene de la catedra.
3. Espera la sincronizacion de Gradle y elegi JDK 21 si lo pide.
4. No abras solo src/: la raiz debe contener settings.gradle.kts y gradlew.

Submit-only y puntaje

Algunos assignments son submit-only: el push guarda el trabajo pero no califica. Ejecuta gh student submit o pushea un tag submit/:

git tag submit/final && git push origin submit/final

Si la catedra define milestones (phase1, etc.), pushear ese tag califica ese commit.

Las notas viven en Releases del repositorio: cada entrega calificada publica un Release con el puntaje y el detalle por test. En Classroom 50, View autograder details y View score abren ese Release.