Como Entregar tus Trabajos‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‍‌‌‌‍‌‌‌‌‍‌‌‍‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌¶

Esta guia te explica paso a paso como entregar. No necesitas saber Git avanzado.‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‍‌‌‌‍‌‌‌‌‍‌‌‍‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌

Resumen en 30 segundos¶

1. Haces fork del repo (solo una vez)
2. Trabajas en TU fork
3. Subes tus cambios a TU fork
4. El profesor revisa TU fork automaticamente (sin PR)

NO necesitas crear Pull Request. El sistema automatico evalua tu archivo PROMPTS.md directamente en tu fork.

Diagrama del Flujo¶

flowchart TB
    subgraph Profesor["REPOSITORIO DEL PROFESOR"]
        P1["github.com/TodoEconometria/ejercicios-bigdata<br/><br/>Aqui estan los ejercicios<br/>NO modificas nada aqui"]
    end

    subgraph Alumno["TU FORK (tu copia)"]
        A1["github.com/TU_USUARIO/ejercicios-bigdata<br/><br/>Aqui trabajas y subes tu codigo"]
    end

    subgraph Local["TU PC"]
        L1["Carpeta ejercicios-bigdata/<br/><br/>Aqui programas"]
    end

    subgraph Sistema["SISTEMA AUTOMATICO"]
        S1["Script del profesor<br/><br/>Revisa todos los forks<br/>Genera notas automaticas"]
    end

    Profesor -->|"1. Fork (copiar)"| Alumno
    Alumno -->|"2. Clone (descargar)"| Local
    Local -->|"3. Push (subir)"| Alumno
    Alumno -->|"4. Revision automatica"| Sistema

    style Profesor fill:#e3f2fd,stroke:#1976d2,stroke-width:2px
    style Alumno fill:#e8f5e9,stroke:#388e3c,stroke-width:2px
    style Local fill:#fff3e0,stroke:#f57c00,stroke-width:2px
    style Sistema fill:#f3e5f5,stroke:#7b1fa2,stroke-width:2px

Paso 1: Crear tu Fork (solo una vez)¶

Un "fork" es tu copia personal del repositorio.

Ve a: github.com/TodoEconometria/ejercicios-bigdata
Click en el boton "Fork" (arriba a la derecha)
Click en "Create fork"
Listo! Ahora tienes github.com/TU_USUARIO/ejercicios-bigdata

Solo haces esto UNA VEZ

Tu fork es tuyo para siempre. Todos tus trabajos van ahi.

Paso 2: Descargar a tu PC (solo una vez)¶

# En tu terminal (CMD, PowerShell, o Terminal)
cd Documentos
git clone https://github.com/TU_USUARIO/ejercicios-bigdata.git
cd ejercicios-bigdata

Cambia TU_USUARIO por tu nombre de usuario de GitHub.

Ahora tienes la carpeta

Busca en Documentos/ejercicios-bigdata/. Ahi trabajaras siempre.

Paso 3: Crear tu carpeta de entrega¶

Dentro de tu carpeta del repositorio, crea tu carpeta personal:

Para Trabajo Final:
entregas/trabajo_final/apellido_nombre/

Para ejercicios de BD:
entregas/01_bases_de_datos/1.1_sqlite/apellido_nombre/

Formato del nombre

Todo en minusculas
Sin tildes ni espacios
Formato: apellido_nombre
Ejemplo: garcia_maria, lopez_juan

Para el Trabajo Final, copia la plantilla:¶

# Desde la carpeta del repositorio:
cp -r trabajo_final/plantilla/ entregas/trabajo_final/tu_apellido_nombre/

Esto te crea todos los archivos que necesitas completar.

Paso 4: Trabajar y documentar tus prompts¶

El archivo mas importante: PROMPTS.md¶

Dentro de tu carpeta encontraras PROMPTS.md. Este archivo es LO QUE SE EVALUA.

entregas/trabajo_final/garcia_maria/
├── PROMPTS.md          ← OBLIGATORIO - Tus prompts de IA
├── docker-compose.yml  ← Tu infraestructura
├── pipeline.py         ← Tu codigo
└── ... otros archivos

Que va en PROMPTS.md¶

Seccion	Que poner
Prompt A, B, C	Tus prompts REALES copiados tal cual (con errores y todo)
Blueprint	Al final, pedirle a la IA un resumen profesional

MUY IMPORTANTE

NO corrijas tus prompts. Si escribiste "como ago q sparck lea el csv" con errores, pega ESO. El sistema detecta si "limpiaste" tus prompts.

Los prompts perfectos en la Parte 1 = SOSPECHOSO.

Paso 5: Subir tu trabajo¶

Cuando termines (o quieras guardar avances):

# Desde la carpeta del repositorio
git add .
git commit -m "Entrega Trabajo Final - Garcia Maria"
git push

Que hace cada comando

git add . → Prepara todos tus archivos
git commit -m "..." → Guarda con un mensaje
git push → Sube a tu fork en GitHub

Paso 6: Verificar tu entrega¶

Ve a tu fork: github.com/TU_USUARIO/ejercicios-bigdata
Navega a entregas/trabajo_final/tu_apellido_nombre/
Verifica que estan todos tus archivos

Listo!

No necesitas hacer nada mas. El sistema automatico revisa tu archivo PROMPTS.md y genera notas basado en tu proceso de aprendizaje.

Mantener tu Fork Actualizado¶

El profesor agrega ejercicios nuevos. Tu fork NO se actualiza solo.

Metodo Facil (desde GitHub)¶

Ve a tu fork en GitHub
Si ves un banner amarillo "This branch is X commits behind", haz click
Click en "Sync fork" → "Update branch"
En tu PC: git pull

Metodo Terminal¶

# Agregar el repo del profesor como "upstream" (solo una vez)
git remote add upstream https://github.com/TodoEconometria/ejercicios-bigdata.git

# Actualizar
git fetch upstream
git merge upstream/main
git push

Cuando sincronizar

Hazlo cada lunes antes de clase para tener los ejercicios nuevos.

Estructura de Entrega - Trabajo Final¶

entregas/trabajo_final/apellido_nombre/
│
├── PROMPTS.md              ← LO MAS IMPORTANTE (se evalua esto)
│
├── 01_README.md            ← Tu pregunta de investigacion
├── 02_INFRAESTRUCTURA.md   ← Explicacion de tu Docker
├── 03_RESULTADOS.md        ← Graficos e interpretacion
├── 04_REFLEXION_IA.md      ← 3 momentos clave
├── 05_RESPUESTAS.md        ← Preguntas de comprension
│
├── docker-compose.yml      ← Tu YAML funcional
├── pipeline.py             ← Tu codigo ETL + analisis
├── requirements.txt        ← Dependencias
│
└── .gitignore              ← Excluir datos grandes

Que NO Subir¶

El .gitignore ya protege esto, pero recuerda:

❌ Archivos de datos (.csv, .parquet, .db)
❌ Carpeta venv/ o .venv/
❌ Carpeta __pycache__/
❌ Archivos .env con credenciales
❌ Archivos mayores a 10MB

Como se Evalua (Sistema por PROMPTS)¶

LO MAS IMPORTANTE: PROMPTS.md

El archivo PROMPTS.md es lo que se evalua. No el codigo, no el YAML, sino TUS PROMPTS de IA documentados.

El sistema automatico revisa:

1. Lee la lista de alumnos (forks registrados)
2. Para cada fork:
   - Verifica que existe PROMPTS.md (OBLIGATORIO)
   - Analiza calidad y autenticidad de los prompts
   - Detecta si los prompts fueron "limpiados" por IA
   - Revisa coherencia entre prompts y codigo entregado
   - Calcula nota automatica basada en proceso de aprendizaje
3. Genera reporte con:
   - Ranking de todos
   - Destacados (posible bonus)
   - Sospechosos (requieren verificacion)

Alertas Automaticas¶

Alerta	Significado
⭐ DESTACADO	Trabajo excepcional, revisar para bonus
✅ NORMAL	Cumple requisitos, nota automatica
⚠️ REVISAR	Algo no cuadra, el profesor verificara
❌ RECHAZADO	Copia detectada o requisitos no cumplidos

Problemas Comunes¶

"No tengo la plantilla"¶

# Actualiza tu fork primero
git fetch upstream
git merge upstream/main

# Ahora copia la plantilla
cp -r trabajo_final/plantilla/ entregas/trabajo_final/tu_apellido/

"Git me pide usuario y contrasena"¶

Usa tu cuenta de GitHub. Si falla, configura:

git config --global user.email "tu@email.com"
git config --global user.name "Tu Nombre"

"Mis cambios no aparecen en GitHub"¶

Verifica que hiciste los 3 pasos:

git add .                    # 1. Preparar
git commit -m "mensaje"      # 2. Guardar
git push                     # 3. Subir  ← Este es el que sube

"Quiero empezar de nuevo"¶

# Borrar tu carpeta y copiar plantilla de nuevo
rm -rf entregas/trabajo_final/tu_apellido/
cp -r trabajo_final/plantilla/ entregas/trabajo_final/tu_apellido/

Fechas y Plazos¶

Entrega	Fecha limite
Trabajo Final	[Ver calendario del curso]

Entregas tardias

El sistema revisa en la fecha indicada. Lo que no este en tu fork para esa fecha, no se evalua.

Resumen Visual¶

┌─────────────────────────────────────────────────────────────────┐
│                    TU FLUJO DE TRABAJO                          │
├─────────────────────────────────────────────────────────────────┤
│                                                                 │
│  1. Fork (una vez)                                              │
│     └── Creas tu copia en GitHub                                │
│                                                                 │
│  2. Clone (una vez)                                             │
│     └── Descargas a tu PC                                       │
│                                                                 │
│  3. Copias plantilla                                            │
│     └── cp -r trabajo_final/plantilla/ entregas/.../tu_nombre/  │
│                                                                 │
│  4. Trabajas con IA                                             │
│     └── Guardas prompts en PROMPTS.md (con errores y todo)      │
│                                                                 │
│  5. Subes cambios                                               │
│     └── git add . && git commit -m "..." && git push            │
│                                                                 │
│  6. Verificas en GitHub                                         │
│     └── Confirmas que tus archivos estan ahi                    │
│                                                                 │
│  7. Evaluacion automatica                                       │
│     └── El profesor revisa todos los forks sin que hagas nada   │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Ayuda¶

Si tienes problemas:

Revisa esta guia de nuevo
Pregunta a un companero
Pregunta al profesor en clase
Revisa la guia de sincronizacion

‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‍‌‌‌‍‌‌‌‌‍‌‌‍‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‌‍‌‌‌‍‌‌‌‍‌‌‌---

Ultima actualizacion: 2026-02-04