Historial de Módulos

Todo módulo en Darwin lleva su propio historial: de dónde vino y cómo evolucionó. Siempre puedes ver si un módulo se creó desde cero, se clonó de otro, se fusionó a partir de varios, o se actualizó por lo que un proyecto te enseñó. Internamente, cada módulo lleva un campo ProvenanceType que registra cómo fue creado.

Tipos de Historial

Tipo	Significado
ORIGINAL	Primera creación
REVISION	Creado a partir de una revisión de un módulo fuente
CLONED	Copiado de un módulo fuente
MERGED	Creado al fusionar múltiples módulos fuente
AI_SUGGESTED	Creado por un flujo de trabajo asistido por IA
LEARNING_APPLIED	Cambio de módulo realizado en respuesta a un hallazgo de varianza resuelto

Códigos de Visualización

Cada módulo recibe un código de visualización legible generado mediante una secuencia de códigos. Los códigos de visualización usan contadores específicos por tipo de entidad con prefijos de año opcionales:

Entidad	Prefijo de Código	Ejemplo
Módulo	MOD	MOD-0042
Estimación	EST	EST-2026-0042
Proyecto	PRJ	PRJ-2026-0017

Los códigos con prefijo de año usan el año actual como parte de la clave de secuencia, habilitando referencias externamente significativas sin exponer los IDs de la base de datos.

Por Qué Importa

Si los módulos son la expresión del ADN de Costos, los equipos necesitan entender si un módulo es original, clonado de otro módulo o fusionado a partir de múltiples fuentes. Este historial preserva la confianza, la trazabilidad, el aprendizaje a lo largo del tiempo y la responsabilidad sobre la evolución del módulo.

Aprendizaje Aplicado

Cuando un módulo se actualiza en respuesta a un hallazgo de varianza resuelto, su historial registra una entrada de tipo LEARNING_APPLIED con una referencia al hallazgo de varianza. Esto conecta la realidad de ejecución directamente con la lógica de costos reutilizable.