🏷️ Nomenclatura QA
📘 Control del documento
Gobierno de QA
Versión: 1.0
Nomenclatura
Fecha: 14/07/2026
La nomenclatura estandarizada permite garantizar trazabilidad, orden, control y medición dentro del proceso de calidad.
Un esquema de nombres consistente:
- Mejora la comunicación.
- Reduce ambigüedades.
- Facilita auditorías.
- Permite análisis métricos.
- Alinea el trabajo con modelos de madurez (TMMI / CMMI).
1. Estructura General Recomendada
Formato base:
🧩 Fórmula de nomenclatura
TIPO-ID-Secuencia-Descripción
Según el tipo de elemento, puede incluir:
- ID de la Historia de Usuario (cuando aplique).
- Secuencia numérica (solo para casos de prueba).
- Sprint o Release (cuando aplique).
Ejemplos generales
EP-Vales Despensa
TS-123-Comercialización de vales
TC-123-01-Validar creación de vale
BG-Vales Despensa-No guarda después de 1 minuto
🎨 Vista visual de la estructura
Reglas de construcción
📏 Reglas obligatorias
- El prefijo debe escribirse sin espacios (EP-, TS-, TC-, RK-, BG-, etc.).
- El ID y la secuencia deben ir sin espacios.
- El separador oficial es el guion (-).
- Solo la descripción puede contener espacios.
- No utilizar guiones bajos (_).
- No utilizar caracteres especiales innecesarios (&, %, #, etc.).
- Mantener consistencia en mayúsculas y minúsculas.
- No modificar nombres históricos después de liberación.
2. Nomenclatura de Elementos
| N° | Elemento | Prefijo | Formato de Nomenclatura | Ejemplo |
|---|---|---|---|---|
| 1 | Epic | EP | EP-Descripción | EP-Vales Despensa |
| 2 | Feature | FT | FT-Descripción | FT-Administración de vales |
| 3 | User Story | US | US-Descripción | US-Comercialización de vales |
| 4 | Test Plan | TP | TP-SprintXX | TP-Sprint10 |
| 5 | Test Suite | TS | TS-ID(US)-Descripción | TS-123-Comercialización de vales |
| 6 | Test Case | TC | TC-ID(US)-Secuencia-Descripción | TC-123-01-Validar creación de vale |
| 7 | Mitigation Plan | MP | MP-SprintXX | MP-Sprint10 |
| 8 | Task | TK | TK-ID(US)-Descripción | TK-123-Diseño de casos de prueba |
| 9 | Bug | BG | BG-Módulo-Problema | BG-Vales Despensa-No guarda después de 1 minuto |
| 10 | Improvement | IM | IM-Módulo-Descripción | IM-Vales Despensa-Mejora diseño UX |
| 11 | Risk | RK | RK-Descripción | RK-Accesos no autorizados |
| 12 | Ticket (Incident) | IN | IN-Módulo-Problema | IN-Pagos-No registra compra |
🚦 Mapa rápido de prefijos
3. Relación Jerárquica
La estructura debe permitir trazabilidad completa:
Épica → Feature → Historia de Usuario → Caso de Prueba → Ejecución → Defecto
Esto permite:
- Medir cobertura por feature.
- Analizar defectos por épica.
- Medir estabilidad por módulo.
- Evaluar riesgo por funcionalidad.
4. Buenas Prácticas de Nomenclatura
✅ Buenas prácticas
- Usar guion (-) como único separador estructural.
- Permitir espacios únicamente en la descripción.
- Mantener prefijos estandarizados.
- Incluir ID de US cuando exista relación directa.
- Usar secuencia numérica en casos de prueba (01, 02, 03…).
- No reutilizar identificadores eliminados.
- No modificar nomenclatura histórica.
- Validar el formato antes de crear nuevos elementos.
- Mantener consistencia entre herramientas (Azure DevOps, documentación, repositorios).
5. Errores Comunes
🚫 Errores que deben evitarse
- Usar nombres genéricos como "Test1".
- Mezclar idiomas sin criterio.
- Usar espacios que rompen integraciones.
- No incluir referencia jerárquica.
- Cambiar nombres después de liberación.
- Duplicar identificadores.
🔍 Comparación visual
6. Relación con Métricas
Una nomenclatura bien estructurada permite:
- Medir defectos por módulo.
- Medir cobertura por feature.
- Analizar tendencia por sprint.
- Identificar áreas de mayor riesgo.
- Generar dashboards automáticos.
📊 Importante
Sin nomenclatura consistente, las métricas pierden confiabilidad.
7. Relación con TMMi y CMMI
La estandarización de nomenclatura contribuye a:
- Nivel 2 (Gestionado): Procesos repetibles.
- Nivel 3 (Definido): Procesos documentados y estandarizados.
- Nivel 4 (Medido): Análisis cuantitativo.
- Nivel 5 (Optimizado): Mejora continua basada en datos.
📈 Evolución de madurez
8. Enfoque Profesional
La nomenclatura no es solo orden visual. Es una herramienta estratégica para:
- Control organizacional.
- Trazabilidad.
- Medición.
- Auditoría.
- Escalabilidad.
🎯 Idea central
La nomenclatura estandarizada permite garantizar trazabilidad, orden, control y medición dentro del proceso de calidad.