El proyecto final

Treinta y un capítulos después, toca juntarlo. Y no en un resumen: en un repositorio que puedas mandar por WhatsApp y que hable bien de ti 🏆

Las siete piezas

Paso 1: la base

mkdir ventas-miss-yera
cd ventas-miss-yera
git init -q
printf 'ciudad,monto\nLima,1200\nArequipa,890\nCusco,760\n' > ventas.csv
printf 'API_KEY=no-deberia-estar-aqui\n' > .env
printf '.env\n__pycache__/\n' > .gitignore
git add ventas.csv .gitignore
git commit -q -m "Primeras ventas por ciudad"
git status --short
git ls-files

.gitignore
ventas.csv

Fíjate en que el .env existe en la carpeta y no está en la lista. Primera pieza colocada 🚫

Paso 2: el README y la licencia

cat > README.md <<'FIN'
# Ventas Miss Yera

Calcula el total de ventas por ciudad a partir de un CSV.

## Necesitas
- Bash

## Usar
```
bash total.sh ventas.csv
```

Devuelve el monto total de todas las ciudades.
FIN
printf 'MIT License\n\nCopyright (c) 2026 Gera Flores\n' > LICENSE
git add README.md LICENSE
git commit -q -m "Se agregan el README y la licencia MIT"
git ls-files

.gitignore
LICENSE
README.md
ventas.csv

Paso 3: el trabajo, en su rama

git switch -q -c calcula-el-total
cat > total.sh <<'FIN'
tail -n +2 "$1" | cut -d, -f2 | paste -sd+ | bc
FIN
git add total.sh
git commit -q -m "Se agrega el calculo del total por ciudad

Lee el CSV, se salta la cabecera y suma la segunda columna."
bash total.sh ventas.csv
git log --oneline

2850
409858b Se agrega el calculo del total por ciudad
75bc321 Se agregan el README y la licencia MIT
533e566 Primeras ventas por ciudad

Funciona. Y el commit tiene cuerpo, que es lo que va a leer quien mire tu historia dentro de un año 📖

Paso 4: fusionar dejando rastro

git switch -q main
git merge -q --no-ff -m "Entra el calculo del total por ciudad" calcula-el-total
git branch -d calcula-el-total
git log --oneline
git branch

Deleted branch calcula-el-total (was 409858b).
276beee Entra el calculo del total por ciudad
75bc321 Se agregan el README y la licencia MIT
409858b Se agrega el calculo del total por ciudad
533e566 Primeras ventas por ciudad
* main

El --no-ff deja escrito que hubo una rama, y borrarla después deja la lista limpia. Así se ve un repositorio donde alguien trabajó ordenado 🌿

Paso 5: la revisión automática

mkdir -p .github/workflows
cat > .github/workflows/revisa.yml <<'FIN'
name: Revisa el CSV de ventas

on:
  push:
  pull_request:

jobs:
  revisar:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: |
          tail -n +2 ventas.csv | cut -d, -f2 | grep -q '^$' && exit 1
          echo "CSV correcto"
FIN
git add .github
git commit -q -m "Se revisa el CSV en cada push"
tail -n +2 ventas.csv | cut -d, -f2 | grep -q '^$' && exit 1
echo "la revision pasa"

la revision pasa

Paso 6: la primera versión

git tag -a v1.0 -m "Primera version del reporte por ciudad"
git tag
git describe --tags
git log --oneline --decorate -1

v1.0
v1.0
a518f4e (HEAD -> main, tag: v1.0) Se revisa el CSV en cada push

Paso 7: publicarlo

cd ..
git init -q --bare servidor.git
cd ventas-miss-yera
git remote add origin ../servidor.git
git push -q -u origin main
git push -q origin --tags
git ls-remote origin

a518f4e618f8c79df5dee7b9adf0920e4534f523	HEAD
a518f4e618f8c79df5dee7b9adf0920e4534f523	refs/heads/main
b5770ff08550961371f61e0bdd160c1b9d8cb470	refs/tags/v1.0
a518f4e618f8c79df5dee7b9adf0920e4534f523	refs/tags/v1.0^{}

Con GitHub la única diferencia es la dirección, y ahí lo que sigue es entrar a la web, comprobar que el repositorio esté como quieres y decidir si va público o privado. Todo lo demás ya está hecho 🚀

La revisión final

echo "== que se publica ==" && git ls-files
echo "== historia ==" && git log --oneline
echo "== versiones ==" && git tag
echo "== nada suelto ==" && git status --short && echo "limpio"

== que se publica ==
.github/workflows/revisa.yml
.gitignore
LICENSE
README.md
total.sh
ventas.csv
== historia ==
a518f4e Se revisa el CSV en cada push
276beee Entra el calculo del total por ciudad
75bc321 Se agregan el README y la licencia MIT
409858b Se agrega el calculo del total por ciudad
533e566 Primeras ventas por ciudad
== versiones ==
v1.0
== nada suelto ==
limpio

Siete archivos, historia legible, una versión marcada y nada pendiente. Eso es un repositorio que se puede enseñar 🎓

$ git ls-files
analisis.py
datos.csv
notebook.ipynb
prueba2.py
prueba_final.py
prueba_final_v2.py

Comprueba que se entendió

Ejercicios

cd ..
mkdir catalogo-bodegas
cd catalogo-bodegas
git init -q
printf 'bodega,ciudad,monto\nBodega Inti,Cusco,760\n' > bodegas.csv
printf 'API_KEY=fuera\n' > .env
printf '.env\n' > .gitignore
git add bodegas.csv .gitignore
git commit -q -m "Catalogo inicial de bodegas"
git ls-files
git status --short

.gitignore
bodegas.csv

cat > README.md <<'FIN'
# Catalogo de bodegas

Lista de bodegas por ciudad con su venta mensual.

## Usar
```
bash total.sh bodegas.csv
```
FIN
printf 'MIT License\n\nCopyright (c) 2026 Gera Flores\n' > LICENSE
git add README.md LICENSE
git commit -q -m "Se agregan el README y la licencia MIT"
git ls-files

.gitignore
LICENSE
README.md
bodegas.csv

git switch -q -c calcula-el-total
cat > total.sh <<'FIN'
tail -n +2 "$1" | cut -d, -f3 | paste -sd+ | bc
FIN
git add total.sh
git commit -q -m "Se agrega el calculo del total por bodega

Suma la tercera columna del CSV, saltandose la cabecera."
bash total.sh bodegas.csv
git log --oneline

760
ac5fc3a Se agrega el calculo del total por bodega
1c6ca9e Se agregan el README y la licencia MIT
d16ab35 Catalogo inicial de bodegas

git switch -q main
git merge -q --no-ff -m "Entra el calculo del total" calcula-el-total
git branch -d calcula-el-total
git log --oneline
git branch

Deleted branch calcula-el-total (was ac5fc3a).
c8f9270 Entra el calculo del total
1c6ca9e Se agregan el README y la licencia MIT
ac5fc3a Se agrega el calculo del total por bodega
d16ab35 Catalogo inicial de bodegas
* main

git tag -a v1.0 -m "Primera version del catalogo"
git tag
git describe --tags
git log --oneline --decorate -1

v1.0
v1.0
c8f9270 (HEAD -> main, tag: v1.0) Entra el calculo del total

cd ..
git init -q --bare catalogo-servidor.git
cd catalogo-bodegas
git remote add origin ../catalogo-servidor.git
git push -q -u origin main
git push -q origin --tags
git ls-remote origin

c8f9270f3a39746c8bffd44a28cd18bd4f3cbab5	HEAD
c8f9270f3a39746c8bffd44a28cd18bd4f3cbab5	refs/heads/main
6cc816b146b13f45ae2b3a534cb1e1191fa8781a	refs/tags/v1.0
c8f9270f3a39746c8bffd44a28cd18bd4f3cbab5	refs/tags/v1.0^{}

echo "== que se publica ==" && git ls-files
echo "== historia ==" && git log --oneline
echo "== versiones ==" && git tag
echo "== nada suelto ==" && git status --short && echo "limpio"

== que se publica ==
.gitignore
LICENSE
README.md
bodegas.csv
total.sh
== historia ==
c8f9270 Entra el calculo del total
1c6ca9e Se agregan el README y la licencia MIT
ac5fc3a Se agrega el calculo del total por bodega
d16ab35 Catalogo inicial de bodegas
== versiones ==
v1.0
== nada suelto ==
limpio

git commit -m "Un commit mas"

On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

Lo que te llevas

README, gitignore, licencia, commits legibles, una rama, una versión y una revisión. Eso es un repositorio que habla bien de ti.