De una política en PDF a una regla con trazabilidad.

La distancia entre la política y el código

Una política exige que los proveedores aprobados tengan una certificación vigente. Operaciones añade una casilla a una hoja de cálculo. Un desarrollador comprueba que el campo de certificación no esté vacío. Más tarde, un revisor descubre que un documento caducado sigue pasando. Cada uno hizo una interpretación razonable, pero nadie registró una interpretación compartida.

El problema empieza antes del código. «Certificación vigente» necesita una definición: qué certificación, qué reglas de caducidad, qué excepciones y qué evidencia. Una regla con trazabilidad hace visibles esas decisiones.

Da una identidad estable a la regla

Empieza con un identificador como SUP-014 y un título breve: «Los proveedores aprobados deben tener una certificación vigente». Conserva el identificador aunque cambie el texto. Un nombre de archivo o un número de fila es un sustituto frágil porque puede cambiar independientemente del significado de la regla.

Registra el responsable y el estado actual. Borrador, en revisión, aprobada y retirada representan compromisos diferentes. Un borrador es una propuesta; la versión aprobada es la que debe referenciar una implementación. Sustituirla en silencio destruye esa distinción.

Enlaza una fuente precisa

«Política de proveedores» es un comienzo, pero no una referencia completa. Añade versión, sección, párrafo y fecha de vigencia cuando existan. Conserva contexto suficiente para que otra persona entienda el requisito sin repetir tu investigación.

Si la regla procede de una decisión de negocio, enlaza esa decisión y quién la aprobó. No inventes una fuente oficial para rellenar un campo. Un vacío reconocido es más fácil de resolver que una referencia que sugiere una certeza sin respaldo.

Resuelve la interpretación antes de aprobar

Pregunta qué significa «vigente» cuando se ejecuta la comprobación. ¿Cuenta una certificación que caduca hoy? ¿Qué zona horaria se aplica? ¿Qué pasa si el emisor la retira antes de la fecha impresa? Distintos procesos pueden necesitar respuestas distintas.

Escribe la interpretación acordada y ejemplos representativos. El responsable de negocio debe revisarlos. Después, los revisores técnicos pueden comprobar si la implementación conserva ese significado. La aprobación humana registra una decisión; una prueba en verde no la sustituye.

Conecta la regla con una implementación

Una vez aprobada, conecta su versión con la consulta SQL, el validador de API, la prueba local o la revisión manual que la aplica. El enlace es útil aunque la implementación no se genere automáticamente.

Política versión 2 · sección 4.2
  → SUP-014 · versión 1.2 · aprobada
  → comprobación de certificación del proveedor
  → resultado para una entrega concreta

Es una cadena ilustrativa, no una afirmación de que un producto concreto ya la gestione. El objetivo práctico es responder: ¿qué regla se pretendía aplicar y qué comprobación se ejecutó realmente?

Vincula la evidencia con la versión

Un resultado que solo dice «correcto» carece de contexto. Registra qué entrada se comprobó, cuándo y con qué versiones de regla e implementación. Conserva únicamente la evidencia necesaria para tu proceso y limita el acceso según los datos que contenga.

Cuando cambie la política, compara las versiones aprobadas e identifica las comprobaciones afectadas. El cambio puede exigir ejemplos nuevos, otra gravedad o un periodo de transición. Retira explícitamente la versión anterior para que los resultados históricos sigan siendo comprensibles.

Empieza con una política y pocas reglas

Elige un documento y un conjunto manejable de requisitos. Da a cada uno identidad, fuente, responsable, estado de revisión y enlace de implementación. Pronto descubrirás términos ambiguos, comprobaciones duplicadas y requisitos sin cobertura operativa.

Ese es el problema que impulsa la proyecto RuleGenius: un lugar compartido para las reglas, su contexto y su camino hacia la ejecución. El proyecto está en desarrollo, con revisión humana y trazabilidad como prioridades. Para hablar sobre un proceso real, contacta con Minibota Labs.