Publicación del repositorio y configuración de ramas

1.gitignore y .gitattributes

Se crean antes del primer commit, para no llegar a subir nunca lo que no debe subirse.

# .gitignore
target/
build/
.idea/
.vscode/
.DS_Store
.env
*.local.yml
application-secrets.yml
datos/
logs/

# .gitattributes
* text=auto eol=lf
*.cmd text eol=crlf
*.bat text eol=crlf
*.jar binary
*.png binary

• Crear .gitignore ANTES del primer commit, sin excluir mvnw, pom.xml, compose.yaml ni .env.example
• Crear .gitattributes con * text=auto eol=lf

2Repositorio remoto y SSH

Repositorio privado, con el profesorado como colaborador.

cd multagal
git init
git branch -M main
git remote add origin git@github.com:usuario/multagal-apellido.git

ssh-keygen -t ed25519 -C "correo@ejemplo.com"
cat ~/.ssh/id_ed25519.pub    # pega en Settings → SSH keys
ssh -T git@github.com        # verificación

• Inicializar el repositorio, crear el remoto privado y añadir al profesorado como colaborador
• Generar y registrar una clave SSH, y verificarla con ssh -T

3README y reorganización de commits

El README.md debe permitir a alguien que clona el repositorio por primera vez arrancar el proyecto sin ayuda.

# multagal

Sistema de gestión de sanciones de tráfico (módulo Acceso a Datos, UD0).

## Requisitos previos
- JDK 25
- Maven 3.9+
- Docker + Docker Compose v2

## Cómo levantar los servicios de datos
docker compose up -d
docker compose ps

## Cómo arrancar la aplicación
./mvnw spring-boot:run

## Cómo ejecutar las pruebas
./mvnw test

## Decisiones técnicas
Ver docs/adr/

feat(dominio): añade los records Expediente, Denuncia e Infraccion
fix(jdbc): cierra el ResultSet en el bloque try-with-resources
refactor(service): extrae el cálculo de la bonificación a un método propio
test(repository): cubre el caso de expediente inexistente
docs(adr): registra la decisión de usar JdbcTemplate sobre JDBC puro
chore(docker): fija la versión de la imagen de PostgreSQL a 16-3.4

• Redactar README.md con descripción, requisitos previos, cómo levantar los servicios, arrancar la aplicación y ejecutar las pruebas
• Reorganizar el trabajo de A0.2 a A0.5 en commits con sentido siguiendo Conventional Commits

4Rama de hito, Pull Request y fusión

--no-ff fuerza un commit de fusión, dejando constancia en el historial de que existió un hito con su propio conjunto de commits.

git switch -c hito/ud0-arranque
# ... varios commits ...
git push -u origin hito/ud0-arranque
# → abrir Pull Request hacia main
# → autorrevisión y revisión entre iguales
git switch main
git merge --no-ff hito/ud0-arranque
git push

• Trabajar en la rama hito/ud0-arranque y hacer push con -u origin hito/ud0-arranque
• Abrir el Pull Request hacia main y autorrevisarlo con la checklist de arriba
• Fusionar con git merge --no-ff (o el equivalente del PR) para dejar constancia del hito en el historial

5Etiqueta de entrega

La etiqueta fija el commit exacto que se evalúa: se pone antes del plazo, no en el minuto final.

git tag -a ud0-completado -m "UD0: arranque del entorno y esqueleto de MULTAGAL"
git push origin ud0-completado
git tag -n              # listar
git show ud0-completado # ver a qué commit apunta
git log --oneline --graph --all

• Etiquetar el resultado como ud0-completado y subirlo con git push origin ud0-completado
• Comprobar con git log --oneline --graph --all que hay mínimo 8 commits con mensajes convencionales y que la etiqueta apunta al commit correcto en main

!Errores frecuentes

git switch -c hito/ud0-arranque
git switch main
git reset --hard origin/main

git pull --rebase
git push

✓Criterios de aceptación

• El repositorio no contiene target/, .idea/ ni .env
• Historial con mínimo 8 commits con mensajes convencionales
• Cada commit compila y las pruebas pasan
• PR fusionado con --no-ff; la etiqueta ud0-completado apunta a main
• README.md permite arrancar a alguien que clona el repositorio por primera vez
• docs/adr/ contiene mínimo dos decisiones registradas