bugfixes

BACKOFFICE_REST_CHANNEL_PATCH_SUMMARY.md

@@ -0,0 +1,53 @@
+# 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
+
+```text
+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:
+
+```text
+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
+```