Práctica final · u4p3

Tu repositorio de entrega u4p3

Todo lo que entregas de la práctica final vive en un solo repositorio público de GitHub: tu código, tus 13 commits, las capturas y EVIDENCIAS.md con los minutos del video. Esta guía te da un kit con esos archivos ya listos y un verificador que te dice, antes de entregar, si tu repositorio pasa la revisión.

Es complemento de la guía de la práctica u4p3; no la sustituye. Límite: martes 10 de noviembre, 6:00 am.

1Cómo debe quedar tu repositorio

Es la misma carpeta de tu proyecto Django (la que tiene manage.py), subida a un repositorio nuevo llamado u4p3-apellidopaterno-apellidomaterno-nombres. Lo marcado con ★ viene en el kit.

u4p3-prado-diaz-bernardo/ ├── manage.py ├── requirements.txt ├── .gitignore ← debe incluir .env y venv/ ├── miproyecto/ ← la carpeta de tu settings.py ├── core/ │ ├── migrations/ ← las de los pasos 02 a 05 │ ├── management/commands/cargar_demo.py │ ├── reportes.py ← las 6 consultas SQL │ └── templates/core/ ← reportes.html, reporte.html, factura_form.html… ├── evidencias/ ★ aquí van tus 13 capturas .png │ └── LEEME.md ★ lista con el nombre exacto de cada captura ├── EVIDENCIAS.md ★ minutos del video y enlace de Drive └── verificar_entrega.py ★ revisa tu repo antes de entregar

Nunca se suben: .env (tus contraseñas de Aiven), venv/, staticfiles/ ni el video. El video va en Google Drive.

2Copia el kit a tu proyecto (antes del paso 02)

⬇ Descargar kit-u4p3.zip

En el Explorador de Windows: clic derecho en kit-u4p3.zip → Extraer todo… → Extraer.
Abre tu proyecto en VS Code. Arrastra EVIDENCIAS.md, verificar_entrega.py y la carpeta evidencias de la carpeta extraída al explorador de VS Code, al mismo nivel que manage.py.
Abre EVIDENCIAS.md y cambia el nombre, el grupo y la URL de Render de ejemplo por los tuyos. Los minutos se llenan hasta el final.

Confirma tu .gitignore

Abre la terminal de VS Code con Ctrl + ñ y revisa que tu .gitignore tenga estas líneas:

TERMINAL DE VS CODE — PowerShell · en la carpeta que tiene manage.py

# Muestra el contenido de tu .gitignore; deben aparecer .env, venv/ y staticfiles/
Get-Content .gitignore
# Si falta alguna, la agrega al final del archivo (cambia .env por la que falte)
Add-Content .gitignore ".env"

No hagas commit todavía: los archivos del kit entran solos en tu commit del paso 02, junto con core/models.py.

3Mientras haces la práctica

Un commit al terminar cada paso del 02 al 12, con el mensaje exacto de la sección C de la guía: empieza con paso NN: y termina con - paterno-materno-nombres.
Cada captura en el momento: Win + Shift + S, pega en Paint y guárdala en evidencias/ con el nombre exacto de evidencias/LEEME.md.
Puedes correr el verificador cuando quieras para ver qué te falta; al principio saldrá casi todo en ❌ y es normal.

TERMINAL DE VS CODE — ejemplo, al terminar el paso 02

# Prepara todos los archivos cambiados (incluye el kit la primera vez)
git add .
# Commit del paso 02 con tu firma al final
git commit -m "paso 02: tabla Categoria y llave foranea temporal - prado-diaz-bernardo"

4Crea el repositorio u4p3-… y súbelo (paso 15)

Entra a github.com y confirma que es tu cuenta (arriba a la derecha, tu foto → tu usuario).
Clic en + → New repository. Repository name: u4p3-prado-diaz-bernardo con tus datos (minúsculas, sin acentos, la ñ como n).
Elige Public. No marques README, .gitignore ni license: el repositorio debe nacer vacío.
Clic en Create repository y copia la URL que termina en .git.

TERMINAL DE VS CODE — PowerShell · en la carpeta que tiene manage.py

# Muestra a qué repo apunta hoy tu proyecto (seguramente al de la Semana 8)
git remote -v
# Cambia origin al repo nuevo de esta práctica (pega TU URL)
git remote set-url origin https://github.com/TU_USUARIO/u4p3-prado-diaz-bernardo.git
# Revisa lo que se va a subir: NO deben aparecer .env, venv/ ni staticfiles/
git status
# Agrega las capturas y lo que falte
git add .
# Commit 12 de 13, el del paso 15
git commit -m "paso 15: capturas y subida a GitHub para Render - prado-diaz-bernardo"
# Sube la rama main al repo nuevo, con todo tu historial de commits
git push -u origin main

Al hacer push se sube todo tu historial, también los commits de las semanas anteriores. Así el profesor ve cada paso NN con su fecha y hora.

5Después de grabar: EVIDENCIAS.md y último push

Sube el video a Google Drive (carpeta u4p3-pradodiaz), clic derecho → Compartir → Cualquier persona con el enlace. Pruébalo en una ventana de incógnito.
En EVIDENCIAS.md pega el enlace en Video: y escribe el minuto exacto (hh:mm:ss) de cada fila.

TERMINAL DE VS CODE — PowerShell · ya fuera de la grabación

# Agrega EVIDENCIAS.md (y cualquier captura que falte)
git add .
# Commit 13 de 13: los minutos del video
git commit -m "evidencias: minutos del video - prado-diaz-bernardo"
# Sube el último commit
git push

6Verifica tu repositorio antes de entregar

El verificador usa las mismas reglas con las que se revisa tu entrega. No cambia nada de tu proyecto: solo lee y te dice qué falta.

TERMINAL DE VS CODE — PowerShell · con (venv) activo

# Revisa nombre, archivos, migraciones, SQL, .env, commits, EVIDENCIAS.md y push
python verificar_entrega.py

SALIDA ESPERADA — así se ve cuando está todo listo

✅ Nombre del repo  u4p3-prado-diaz-bernardo
✅ Archivos         completos
✅ Migraciones      datos, quitar, renombrar e índices
✅ SQL              6 consultas con %(uid)s
✅ .env             no está en el repo y está en .gitignore
✅ Commits          13 de 13 commits con tu firma
✅ EVIDENCIAS.md    video, Render, minutos y capturas completos
✅ Subido a GitHub  todo está en GitHub
8/8 ✅  Tu repositorio está listo. Envía el correo de entrega.

Si algo sale en ❌ o ⚠️

Mensaje	Qué hacer
origin apunta a '…'	Aún apunta al repo de la Semana 8. Haz la sección 4: `git remote set-url origin …`
no sigue u4p3-paterno-materno-nombres	En GitHub: tu repo → Settings → Repository name, corrígelo y vuelve a correr `git remote set-url` con la URL nueva. Tu Web Service de Render también debe llamarse igual.
.env está en el repo	`git rm --cached .env`, agrega `.env` al `.gitignore`, commit y push. Luego cambia tu contraseña de Aiven: ya quedó publicada en el historial.
sin commit: paso NN	Ese paso no tiene commit que empiece con `paso NN`. No inventes commits al final: la revisión compara fechas contra tu video.
sin tu firma	Si todavía no haces push: `git commit --amend -m "mensaje correcto"` (solo corrige el último). Si ya subiste, déjalo así y avísalo en el correo.
sin minuto / faltan capturas	Llena el minuto de cada fila y guarda las capturas en `evidencias/` con el nombre exacto.
sin commit / sin push	`git add .`, `git commit -m "…"` y `git push`.

7Envía el correo

A Tenor_Prado@yahoo.com.mx con el asunto Apellido Paterno Apellido Materno Nombres Grupo u4p3 (ejemplo: Prado Diaz Bernardo DSM4-1 u4p3). En el cuerpo: el mismo asunto, el enlace del repositorio u4p3-…, la URL de Render y el enlace de Drive.

8Cómo se revisa tu repositorio

Tu repositorio se clona tal cual está en GitHub y se coteja automáticamente:

Se revisa	Pasa cuando…
Repositorio	Es público, se llama `u4p3-paterno-materno-nombres` y no tiene `.env`.
Código	Están los archivos nuevos, las migraciones con `RunPython`, `RemoveField`, `RenameField` e índices, y las 6 consultas con `%(uid)s`.
Commits	Hay un `paso NN` del 02 al 12, repartidos en el tiempo y antes del límite.
EVIDENCIAS.md	Cada minuto muestra en el video lo que dice su fila, y cada captura existe.
Render	`https://u4p3-….onrender.com/reportes/` responde.
Video	Se oye "Paso NN" al empezar cada paso, la presentación y la despedida.

Si tu repositorio es privado o lo borras, no se puede clonar y la entrega cuenta como no recibida. No lo modifiques después de la fecha límite.