El flujo de trabajo profesional
- IssueDefinición atómica con título explícito y criterios de aceptación verificables.
- RamaNomenclatura
id-descripcion-corta, bifurcada a partir demainsincronizada. - CommitConfirmación atómica con mensaje claro en modo imperativo.
- Pull requestDocumentación del cambio técnico y vinculación formal con
Closes #id. - ChecksComprobaciones automatizadas que deben culminar en estado favorable previo a la integración.
- RevisiónAuditoría por pares basada en la ejecución local y la verificación de criterios.
- MergeFusión mediante Squash and merge, eliminación de la rama y despliegue automático.
Principios metodológicos fundamentales:
| Principio de ingeniería | Justificación metodológica |
|---|---|
| Despliegue continuo desde el inicio del proyecto | Los defectos de configuración e infraestructura deben detectarse de forma temprana, cuando el coste de corrección es mínimo. |
| Restricciones formales y reglas de protección | La calidad del software debe garantizarse mediante políticas del sistema (rulesets y checks) y no mediante acuerdos informales. |
| Trazabilidad integral del historial | El registro temporal de issues, confirmaciones, revisiones e integraciones constituye la evidencia auditable del trabajo desarrollado. |
Glosario técnico de la unidad
| Concepto | Significado |
|---|---|
| Issue | Unidad de trabajo atómica con criterios de aceptación verificables. Se clausura de forma automática desde la pull request vinculada. |
| Rama (Branch) | Línea de desarrollo independiente que aísla los cambios de código respecto a la rama principal productiva. |
| Pull request | Solicitud formal de integración de una rama secundaria en una base. Espacio central donde concurren la validación automatizada y la revisión humana. |
| Workflow | Archivo de configuración YAML ubicado en .github/workflows/ que define tareas automatizadas en GitHub Actions, versionado conjuntamente con el código. |
| Check | Estado resultante de una comprobación automatizada en CI ejecutada sobre una pull request, configurable como condición de bloqueo de fusión. |
| Entorno de vista previa (Preview Deployment) | Instancia efímera generada automáticamente para evaluar una rama en un entorno idéntico a producción durante la vigencia de una pull request. En entornos estáticos estándar, se replica localmente mediante git fetch y git switch. |
| Secreto (Secret) | Parámetro confidencial almacenado de forma segura en el repositorio, accesible únicamente durante la ejecución de workflows autenticados. |
| Ruleset | Conjunto normativo aplicado a ramas en GitHub para hacer cumplir de manera ineludible las políticas de integración del proyecto. |
| Definición de terminado (Definition of Done) | Conjunto de criterios de calidad objetivos y estandarizados que todo entregable debe satisfacer antes de considerarse completado. |
Ya deberías ser capaz de
- Explicar qué evalúa este módulo y qué evalúa Desarrollo Web en Entorno Servidor sobre el mismo código.
- Publicar un sitio estático con GitHub Pages y el workflow de GitHub Actions que lo despliega.
- Leer el workflow de GitHub Actions que genera el despliegue y decir qué lo dispara.
- Trabajar el ciclo completo: issue, rama, commit, pull request, revisión, fusión y despliegue.
- Proteger la rama principal y demostrar que el flujo de integración no se puede eludir.