Saltar al contenido principal

Nomenclatura Silstech

Este documento define la nomenclatura estándar para los documentos de requerimientos y las tarjetas de gestión en la plataforma ClickUp, con el objetivo de garantizar una identificación, organización y gestión eficiente de la documentación generada para los proyectos; y de la gestión utilizadas en ClickUp. Se espera que todos los miembros de los equipos utilicen esta nomenclatura de manera consistente, para mantener el orden y la claridad de las gestiones.

1. Nomenclatura para tarjetas de gestión en ClickUp​

Las tarjetas de gestión se clasifican en tres categorías principales:

  1. REQ: Requerimiento

  2. MJR: Mejora

  3. BUG: Bug

Estas categorías permiten identificar el tipo de tarea correspondiente. Además, se utilizan subcategorías para especificar el área o entidad que realiza el pedido:

  1. SILS: Silstech
  2. YPF: YPF
  3. GAS: YPF GAS
  4. AGR: YPF AGRO
  5. LOG: YPF Logística
  6. SF: YPF Seguridad Física
  7. SP: YPF Seguridad Patrimonial
  8. GCP: Google Cloud Platform
  9. TEC: Tecnología YPF
  10. QA: Área de QA Silstech (AUT)

A cada tarjeta se le asignará un número de identificación único que, en conjunto con la categoría y subcategoría, formará un código único. Ejemplos:

REQ SILS000 – xxxx (ejemplo de un caso de requerimiento solicitado de manera interna)

MJR YPF000 - xxxx (ejemplo de una mejora en el caso de que sea solicitado por YPF)

Por lo que el formato de nomenclatura será: Categoría principal + subcategoría area + número de identificación + (guión medio - ) + Título

En el caso de cargar un bug en el backlog, es necesario utilizar las subcategorías de módulos, para identificar cual es el módulo implicado.

Subcategorías para ambientes:

  1. [PROD]: Producción
  2. [DES]: Desarrollo
  3. [TEST]: Staging

Subcategorías para módulos:

  1. PF: Posición de flota
  2. GE: Gestión de eventos
  3. RPT: Reportes
  4. AV: Avisos
  5. IJL: Índice de Jornada laboral
  6. ISF: Índice seguridad física
  7. ISP: Índice de seguridad patrimonial
  8. ICM: Índice de conducta de manejo
  9. MANT: mantenimiento
  10. MT: monitoreo técnico
  11. HDR: Hoja de ruta
  12. ABM: Configuración

A cada tarjeta se le asignará un número de identificación único que, en conjunto con la subcategoría, formará un código único. Ejemplos:

BUG PF001 - xxxx (ejemplo de un Bug en posición de flota)

BUG AV001 - xxxx (ejemplo de un Bug en Avisos)

BUG MT002 - xxxx (ejemplo de un Bug en Monitoreo técnico)

Categoría principal + subcategoría módulo + número de identificación + (guión medio - ) + Título

Para el caso de las subcategorías para ambientes, ejemplos:

BUG[PROD] PF001 - xxxx (ejemplo de un Bug Producción en posición de flota)

BUG[DES] PF001 - xxxx (ejemplo de un Bug Desarrollo en posición de flota)

BUG[TES] PF001 - xxxx (ejemplo de un Bug Staging en posición de flota)

2. Nomenclatura para documentos de requerimientos​

Los documentos de requerimientos técnicos creados en Google Drive deberán seguir el siguiente formato de nomenclatura:

  1. REQUERIMIENTO - SILS000: Título del requerimiento

  2. REQUERIMIENTO - YPF000: Título del requerimiento

  3. REQUERIMIENTO - GAS000: Título del requerimiento

  4. REQUERIMIENTO - QA000: Título de la mejora

Por lo que el formato de nomenclatura en este caso será: REQUERIMIENTO + (guión medio - ) + subcategoría + número de identificación + (dos puntos : ) + Título

3. Ubicación de las tarjetas en ClickUp​

Al momento de generar y nomenclar las tarjetas, las mismas quedarán alojadas según corresponda, en los siguientes espacios del gestor en ClickUp:

  1. BACKLOG NUEVOS REQUERIMIENTOS

  2. BACKLOG MEJORAS INTERNAS

  3. BACKLOG BUGS KEEPER

4. Ubicación de los documentos de requerimientos​

Los documentos de requerimientos se alojarán en las siguientes carpetas dentro del Sistema de Gestión, según las unidades de negocio y/o área interna de Silstech:

  1. YPF COMERCIALIZACIÓN

  2. YPF AGRO

  3. YPF GAS

  4. YPF LOGÍSTICA

  5. SILSTECH