> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://naturgy-comer-documentation-p5mde.vercel.app/api/mcp` to find what you need.

# Inventario de workflows

Este inventario separa los workflows lógicos que participan en la experiencia
Super App. Es una referencia de lectura, no una orden de publicación. El estado
live de la plataforma debe comprobarse de nuevo antes de tratar una versión como
baseline.

## Workflows de primer nivel

| Componente | Canal | Estado documentado | Responsabilidad |
|---|---|---|---|
| Dispatcher | Entrada de Super App | Existe, pero la versión observada es voice-only; multicanal es objetivo | Clasificar intención, urgencia y canal, y enrutar al especialista. |
| [Caso de Operaciones](/use-cases/operations/reference/workflow) | Voz | Conectado y descrito como producción; live/latest temporales | Autodiagnóstico, cobertura, técnico, citas, CI/CG, escalado y transferencia. |
| [Caso de Operaciones - Texto](/use-cases/operations/explanations/text-flow) | Texto | Conectado; baseline y dependencias de entorno requieren validación | Resolver el dominio por chat, crear/actualizar casos y escalar a TeLeo. |
| ATC | Voz | Workflow relacionado y descrito como producción | Autenticación, triaje y gestiones de facturas, pagos, contratos y productos. |
| Operaciones SuperApp Modular | Voz | 8 drafts no publicados, basados en Operaciones v545 | Parent callable, adapter Auth, triaje, cuatro children de dominio y Post-call; no conectado al Dispatcher. |
| ATC SuperApp Modular | Voz | 12 drafts no publicados, basados en ATC v496 | Parent callable, triaje, nueve especialistas y Post-call; reutiliza Auth v12 y no está conectado al Dispatcher. |
| ATC | Texto | No implementado | No existe un destino que el Dispatcher pueda ofrecer como disponible. |

Una rama de encuesta post-llamada puede existir separada de la resolución de
negocio. No se cuenta como un especialista adicional del dominio.

## Niveles que no se deben mezclar

* **Workflow:** contenedor versionado que recibe una entrada y produce una
  ejecución.
* **Agente lógico:** componente conversacional que mantiene el diálogo.
* **Módulo prompt:** cambio de responsabilidad dentro de un agente, como el
  triaje o un especialista de ATC.
* **Tool:** acción determinista con parámetros y permisos propios.
* **Workflow Function:** llamada estructurada entre un workflow padre y uno hijo.

ATC voz contiene autenticación, triaje y módulos de facturas, pagos,
fraccionamiento, tarifas, datos, lecturas, duplicados, suministro y titularidad.
Son módulos de un workflow, no identidades independientes por defecto.

## Propuesta modular de ATC

La arquitectura propuesta para Super App separa un shell callable, Auth, Triaje,
nueve especialistas y Post-call. Cada child conversacional recibe solo las
tools de su capacidad y devuelve un estado estructurado. `transfer_chain` sigue
siendo compartido. La [referencia de implementaciones modulares](/use-cases/super-app/reference/modular-implementations)
compara este conjunto con los ocho drafts de Operaciones y conserva sus IDs y
gates de verificación.

| Capa | Función | Estado |
|---|---|---|
| Shell ATC | Recibir el route handoff y coordinar el recorrido | To-be en draft no publicado |
| Auth | Reutilizar autenticación y devolver contexto saneado | Child existente; baseline de prueba por confirmar |
| Triaje | Elegir especialista, sin resolver negocio | To-be callable |
| Especialistas | Facturas, pagos, fraccionamiento, productos, datos, lecturas, duplicados, suministro y titularidad | To-be callable |
| Post-call | Cerrar, escribir el caso y la observabilidad | To-be callable |

La sustitución de `module-change` por Workflow Functions no cambia el workflow
telefónico live. El plan completo, incluidos `parent_run_id`, response nodes,
retornos a triaje y gates, está en [Arquitectura modular de ATC para Super App](/use-cases/super-app/reference/atc-modular-plan).

## Dependencias y fronteras

| Frontera | Mecanismo | Nota |
|---|---|---|
| Super App → Dispatcher | Trigger de voz o texto + Workflow Function | Contrato multicanal pendiente; la entrada tradicional de teléfono puede saltarlo. |
| Dispatcher → especialista | `Call Workflow` / `Workflow Function Request` | El payload debe declarar canal, intención, resumen y correlación. |
| ATC → autenticación | Subworkflow o tools de identidad | El especialista conserva la responsabilidad de autenticación de negocio. |
| Operaciones texto → humano | Handoff de texto | TeLeo recibe el caso y el contexto mínimo. |
| Operaciones voz → humano | Transferencia de voz | Connect gestiona la cola y la transferencia. |
| Especialista → backend | Tools deterministas | El backend es la fuente de verdad del resultado. |

## Cómo leer un estado

Antes de citar un workflow o una versión:

1. confirma organización, entorno y canal;
2. distingue workflow ID de version ID;
3. diferencia latest, published y live;
4. comprueba el trigger y el target de handoff;
5. registra el alcance de la lectura y las limitaciones;
6. no uses un borrador como evidencia de producción.

El inventario no conserva identificadores temporales, exports de plataforma ni
credenciales. Para evaluar una ruta, consulta la [matriz de canales y handoff](/use-cases/super-app/reference/channel-matrix)
y la [evidencia UAT](/use-cases/super-app/reference/evidence).
