Guia visual interactiva — 5 minutos para entender todo el flujo
Resultado esperado:
🔎 No sabes el nombre de tu repo? → Buscalo en la Tabla de Homologacion
develop y sigue el patron feature/descripcion. Nunca trabajes directamente sobre develop.develop. Puedes hacerlo desde la web de GitHub (recomendado) o con gh pr create en la terminal. Ver seccion "Crear un PR desde GitHub Web" mas abajo.Solo llega codigo probado y aprobado.
Aqui convergen todas las features del equipo.
Aqui desarrollas tranquilo, sin afectar a nadie.
gitGraph
commit id: "v1.0"
branch develop
checkout develop
commit id: "base"
branch feature/citas
commit id: "feat: endpoint"
commit id: "test: tests"
checkout develop
merge feature/citas id: "PR #1"
branch release/v1.1
commit id: "bump version"
checkout main
merge release/v1.1 id: "v1.1" tag: "v1.1"
release/ y hotfix/. Cada merge genera un tag con la version.
feature/nombre-descriptivo.
| Tipo | Formato | Ejemplo | Desde → Hacia |
|---|---|---|---|
| feature | feature/ID-descripcion |
feature/3456-endpoint-citas |
develop → develop |
| hotfix | hotfix/descripcion |
hotfix/timeout-db |
main → main + develop |
| release | release/vX.Y.Z |
release/v2.5.0 |
develop → main + develop |
| bugfix | bugfix/descripcion |
bugfix/validacion-cedula |
develop → develop |
feat — Nueva funcionalidad visible para el usuario. Algo que antes no existia.
fix — Correccion de un bug. Algo que antes funcionaba mal y ahora funciona bien.
docs — Cambios en documentacion. README, comentarios en codigo, OpenAPI specs.
refactor — Reestructuracion de codigo sin cambiar comportamiento externo. Ni agrega funcionalidad ni corrige bugs.
test — Agregar o modificar tests. No cambia codigo de produccion.
chore — Tareas de mantenimiento. Actualizar dependencias, configuraciones, herramientas internas.
ci — Cambios en pipelines de CI/CD. GitHub Actions, workflows, Dockerfiles de build.
perf — Mejora de rendimiento. El comportamiento no cambia pero es mas rapido o usa menos recursos.
tipo(scope): descripcion en minuscula sin punto
Los checks automaticos se ejecutan solos. Tu solo necesitas esperar la revision de un compañero.
flowchart LR
PUSH["🔀 Push / Merge"] --> BUILD["🔨 Build"]
BUILD --> TEST["🧪 Test"]
TEST --> STAGING["🟡 Staging"]
STAGING --> APPROVAL{"👤 Approval"}
APPROVAL -->|Aprobado| PROD["🟢 Produccion"]
APPROVAL -->|Rechazado| FIX["🔧 Corregir"]
FIX --> PUSH
| Etapa | Que pasa | Quien lo hace |
|---|---|---|
| Build | Se compila tu codigo y se crea una imagen Docker | Robot (GitHub Actions) |
| Test | Se ejecutan pruebas automaticas (unit + integration) | Robot |
| Staging | Se despliega en un ambiente de pruebas | Robot |
| Approval | Alguien revisa que todo funcione en staging | Humano (tu lead) |
| Produccion | Tu codigo esta live para los usuarios | Robot |
Implementa el endpoint POST /api/v1/export/pdf que genera reportes en PDF a partir de los datos de citas del paciente. Incluye validacion de parametros, tests unitarios y documentacion OpenAPI.
Reglas de aprobacion segun tipo de cambio:
/Users/tu-usuario/Documents/GOE/his-api
| Accion | Terminal | GitHub Desktop |
|---|---|---|
| Actualizar develop | git checkout develop && git pull |
Current Branch → develop → Fetch origin |
| Crear branch | git checkout -b feature/x |
Branch → New Branch |
| Commit | git add . && git commit -m "feat: ..." |
Check files → Write message → Commit |
| Push | git push -u origin feature/x |
Push origin |
| Crear PR | gh pr create |
Create Pull Request (abre web) |
# Actualizar develop y crear tu branch
git checkout develop
git pull origin develop
git checkout -b feature/mi-tarea
# Agregar archivos y hacer commit con formato correcto
git add src/mi-archivo.ts
git commit -m "feat(modulo): descripcion del cambio AB#1234"
# Subir tu branch y crear el PR
git push -u origin feature/mi-tarea
gh pr create --base develop --title "feat: mi cambio AB#1234" --fill
# Volver a develop y limpiar tu branch local
git checkout develop
git pull origin develop
git branch -d feature/mi-tarea
No necesitas estos comandos si prefieres la interfaz grafica. Consulta la seccion GitHub Desktop — Guia Rapida mas arriba para ver el equivalente visual de cada accion.