Skip to main content

EST02: Estándar de versionamiento

Última edición: August 31, 2025 11:51 AM Propietario: Daniel Queijeiro Albo Etiquetas: Estándar Fecha de creación: August 18, 2025 8:21 AM

Este estándar define cómo se deben asignar versiones a los proyectos de software dentro de la organización, usando un formato consistente que facilite la comunicación, el control de cambios y la trazabilidad de entregas.

🎯 Objetivo​

  • Establecer reglas claras para asignar versiones en el formato vMAJOR.MINOR.PATCH.
  • Garantizar que los cambios en los proyectos estén alineados con la magnitud del ajuste (grande, mediano o pequeño).
  • Mejorar la colaboración y la comprensión entre equipos sobre qué tipo de actualización se realizó.

📑 Artefactos en los que aplica​

  • Código fuente en todos los proyectos.
  • Documentación de despliegues.
  • Entregas a clientes o usuarios finales.

📋 Estándares​

Convenciones generales​

  • El formato de versión será siempre vMAJOR.MINOR.PATCH.
  • Ejemplos válidos: v1.0.0, v1.3.5, v2.0.0.

Reglas de incremento​

  • MAJOR (X) — Cambios grandes
    • Se lanza una nueva etapa del sistema.
    • Se modifican procesos o flujos clave del negocio.
    • Se introducen cambios que hacen obsoleta la versión anterior.
    • Generalmente coincide con entregas importantes a producción o nuevos módulos.
    • Ejemplo: v2.0.0 → Se añade el módulo de facturación.
  • MINOR (Y) — Mejoras y nuevas funciones
    • Se agregan funciones nuevas, pero el sistema sigue siendo compatible con la versión anterior.
    • Incluye mejoras visibles para el usuario (reportes, pantallas nuevas, permisos, etc.).
    • Ejemplo: v1.3.0 → Se agrega exportación a Excel en reportes.
  • PATCH (Z) — Correcciones
    • Ajustes pequeños, correcciones de errores y mejoras internas.
    • No agregan funciones nuevas ni cambian procesos del usuario.
    • Ejemplo: v1.3.2 → Se corrige un error en el módulo de usuarios.

Regla rápida​

  • ¿El cliente necesita aprender un proceso nuevo o cambia la forma de trabajar? → MAJOR
  • ¿El cliente ve una nueva función pero lo viejo sigue igual? → MINOR
  • ¿El cliente no ve cambios, solo se arregló algo? → PATCH

📝 Ejemplos​

✅ Correcto​

  • v1.0.0 → Primera entrega al cliente.
  • v1.1.0 → Se añade módulo de reportes.
  • v1.1.3 → Se corrige un error en el login.
  • v2.0.0 → Nueva etapa con integración a inventarios.

❌ Incorrecto​

  • v1.0 → Falta PATCH.
  • version 2 → No respeta el formato definido.
  • 1.2.3 → Falta prefijo v.

📎 Recursos relacionados​