Standard Operating Procedure · SOP 1.1

Operación de Milestone Studio

Guía visual para crear hitos, construir planes, personalizar reglas por cliente y comprobar decisiones con señales reales.

Aplicaciónms.handymanny.cloud
PropietarioCargonaut
EstadoOperativo
Revisión26 agosto 2026
Milestone Studio · Manual operativo

1. Propósito y límites

Milestone Studio define qué hitos existen, cómo se agrupan en planes y bajo qué condiciones aplican. Durante la etapa de paridad, WF‑5 sigue siendo la autoridad. Milestone Studio conserva la señal, calcula su resultado y compara ambos motores cuando WF‑5 entrega su callback.

Hito
Evento estable identificado por event_type.
Plan
Secuencia ordenada de hitos con un solo grain.
Ámbito
Global para todos; organización para un cliente.
Variante
Combinación de modo que activa u omite planes.
No confundir. Grain indica el sujeto —embarque, contenedor, tramo o pedimento—; ámbito indica quién posee la configuración.

2. Acceso y selección de ámbito

  1. Abra ms.handymanny.cloud e inicie sesión.
  2. Seleccione idioma y organización en la barra lateral.
  3. Use Global únicamente cuando el cambio deba afectar a todos.
  4. Use SANHUA, TRACSA u otra organización para personalizaciones exclusivas.
Catálogo de hitos123
Catálogo principal
1Seleccione la organización.2Abra Catálogo, Planes o Corridas.3Use “Nuevo hito” para crear.

3. Crear y administrar hitos

  1. Entre a Catálogo y confirme el ámbito.
  2. Pulse Nuevo hito.
  3. Defina un event_type estable, en minúsculas y con puntos.
  4. Capture etiquetas ES/EN, visibilidad, audiencia y adjuntos.
  5. Agregue campos de captura sólo cuando el evento requiera datos adicionales.
  6. Guarde y compruebe el indicador de origen: global, propio o anulación.
Formulario de nuevo hito1234
Formulario completo del hito
1Confirme el ámbito.2Defina identidad y etiquetas.3Configure adjuntos y captura.4Cree sólo después de revisar.
Regla. No cambie el event_type de un hito ya utilizado. Cree uno nuevo y migre las membresías.

4. Crear un plan completo

  1. Cambie el ámbito a Global; los planes son globales en el MVP.
  2. Abra Planes y pulse Nuevo plan.
  3. Defina slug, etiquetas, propósito y grain.
  4. Guarde el borrador. Un plan nuevo nace inactivo.
  5. Abra Composición y agregue al menos un hito.
  6. Ordene los hitos y marque Required o Preferred cuando corresponda.
  7. Abra Variantes: cada modo debe activarlo o registrar por qué lo omite.
  8. Pruebe señales antes de activar.
Lista de planes123
Lista de planes
1Confirme Global.2Cree un borrador.3Abra un plan para administrarlo.
Formulario de nuevo plan123
Nuevo plan
1Slug y etiquetas.2Grain correcto.3Crear como borrador.
Composición del plan123
Composición
1Navegue entre Composición, Personalización y Variantes.2Revise Required y Preferred.3Agregue hitos al plan.

5. Preferred, filtros y condiciones IF / AND / OR

Preferred pertenece a la membresía del hito dentro del plan. No convierte el hito en preferido para todos los planes. Esto permite que el mismo evento sea preferido en una secuencia y normal en otra.

  1. Abra un plan y seleccione Personalización.
  2. Seleccione el hito en la columna izquierda.
  3. Marque Preferred cuando sea la vía recomendada dentro de ese plan.
  4. Use únicamente los campos ofrecidos para el grain mostrado.
  5. Seleccione all (AND) para exigir todas las reglas o any (OR) para aceptar cualquiera.
  6. Compruebe la etiqueta de compatibilidad con WF‑5.
  7. Guarde y pruebe un caso positivo, uno negativo y uno sin el dato.
Personalización del hito1234
Personalización del hito en el plan
1Seleccione el hito.2Marque Preferred.3Construya IF/AND/OR.4Guarde la personalización.
Compatibilidad. Una regla “Sólo laboratorio” puede probarse con el plan inactivo, pero no debe activarse mientras WF‑5 no pueda representarla.

6. Configurar API IN, API OUT y rutas

  1. Abra Integraciones. La credencial de entrada se administra fuera del portal y nunca se muestra aquí.
  2. Use el endpoint de API IN para enviar señales autenticadas a Milestone Studio.
  3. En API OUT, capture una URL HTTPS, timeout y referencia de credencial; active callbacks sólo cuando el receptor esté listo.
  4. Revise la ruta efectiva de cada cliente: WF‑5 o Shadow.
  5. Use Shadow para comparar sin cambiar la respuesta del cliente.
  6. Milestone Studio permanece bloqueado como autoridad hasta que exista la ruta directa de respuesta.
Integraciones, API y rutas por cliente123
Integraciones y rutas
1Copie el endpoint API IN.2Configure un único destino global de API OUT.3Confirme una sola ruta efectiva por cliente.
Garantía. Cada cliente resuelve exactamente una ruta efectiva; un override puede volver a heredar la ruta global sin crear dos ejecuciones.

7. Probar señales y comparar resultados

Estado actual. Milestone Studio procesa inmediatamente. WF‑5 permanece pending mientras la rama sombra esté apagada; al habilitarla, el callback completa su columna y la comparación cambia a Coincide o Diferencia.
  1. Abra Corridas.
  2. Pulse Señal de prueba.
  3. Pegue JSON válido y use una clave de idempotencia nueva.
  4. Guarde la señal; el crudo debe persistir aunque un motor no responda.
  5. Abra la corrida y revise por separado Milestone Studio y WF‑5.
  6. Lea la comparación: Pending, Coincide o Diferencia; nunca interprete pending como éxito.
  7. Confirme modo, variante, planes activados, hitos y datos faltantes.
Lista de corridas123
Corridas
1Cree una señal.2Abra el registro.3Lea estados y comparación independientes.
Formulario de señal12
Señal de prueba
1Pegue el JSON exacto.2Guarde sin asumir que ambos motores responderán.
Processed
El motor terminó.
Pending
Aún no cerró.
Coincide
Ambos resultados son equivalentes.
Diferencia
Revise planes, hitos y sujetos.

8. Secuencia de activación segura

  1. Defina objetivo y organización afectada.
  2. Trabaje en borrador o con el plan inactivo.
  3. Complete hitos, composición, variantes y condiciones.
  4. Resuelva errores de salud.
  5. Ejecute pruebas positiva, negativa y con dato faltante.
  6. Compare contra WF‑5 sólo cuando Operaciones confirme que la rama sombra está habilitada y autenticada.
  7. Obtenga revisión independiente para cambios globales.
  8. Active y vigile Corridas.
n8n. El parche evita la publicación implícita y publica una versión identificada. Los seis nodos se instalan apagados; habilitarlos requiere una prueba controlada y autorización operacional.

9. Solución de problemas

No puedo guardar

Revise los hallazgos completos, el rol y el ámbito. Los errores bloquean; los avisos no.

El plan no activa

Debe tener hitos activos, una decisión por cada modo y una variante predeterminada por modo.

El cambio aparece en otro cliente

Probablemente se guardó en Global. Cree la personalización desde la organización correcta.

Falta un dato de condición

El motor conserva el hito y reporta el dato desconocido para no eliminar silenciosamente una obligación.

WF‑5 permanece pending

La rama de copia puede estar apagada o no conectada. No altere planes para corregir un problema de transporte.

10. Criterio de finalización

  • El cambio quedó en el ámbito correcto.
  • No quedan errores de salud.
  • Pasó caso positivo, negativo y sin dato en Milestone Studio.
  • No modificó otra organización.
  • Preferred está configurado en la membresía correcta.
  • La ruta efectiva del cliente es única y la comparación con WF‑5 se revisó cuando estuvo disponible.
  • Corridas conserva la señal cruda y estados independientes.
  • Existe revisión para cualquier cambio global.

Control documental

Fuente canónica: este archivo HTML. Estado: operativo. Aprobador: pendiente de designación. Próxima revisión: al habilitar la rama WF‑5 o cambiar el contrato de señales.