compass_backoffice/BACKOFFICE_REST_CHANNEL_PATCH_SUMMARY.md

Patch Summary — Backoffice REST as Channel

Goal

Adapt the Backoffice project so legacy REST endpoints behave as framework channel entrypoints instead of directly invoking BackofficeWorkflowExecutor from FastAPI routes.

Added

• app/channels/__init__.py
• app/channels/backoffice_rest_adapter.py
• app/workflows/backoffice_workflow_dispatcher.py
• docs/BACKOFFICE_REST_AS_CHANNEL_ARCHITECTURE.md

Modified

• app/main.py

  • Instantiates BackofficeRestChannelAdapter and BackofficeWorkflowDispatcher.
  • Updates /agent/* routes to create a BackofficeChannelEnvelope and dispatch through the channel path.
  • Updates response metadata with framework_entrypoint=channel_gateway and source_channel=backoffice_rest.
  • Updates readiness/debug metadata to show the channel gateway entrypoint.

• app/agents/backoffice_agent.py

  • Removes guidance that operational checklist should be called through direct BackofficeWorkflowExecutor usage.
  • Documents that operational ticket/emulator flows enter through the channel adapter and dispatcher.

• app/workflows/backoffice_workflow_executor.py

  • Repositioned as the workflow execution engine behind the dispatcher, not the REST entrypoint.

• src/api/LEGACY_ROUTES_DISABLED.md

  • Updated to describe the new REST → ChannelGateway → dispatcher → workflow path.

New execution chain

Legacy REST route
  → BackofficeRestChannelAdapter
  → ChannelGateway.normalize(...)
  → BackofficeWorkflowDispatcher
  → BackofficeWorkflowExecutor / LangGraph workflow
  → Response builder preserving legacy contract

Validation done

Python syntax compilation succeeded for the changed Python files:

app/main.py
app/agents/backoffice_agent.py
app/channels/backoffice_rest_adapter.py
app/workflows/backoffice_workflow_dispatcher.py
app/workflows/backoffice_workflow_executor.py