mirror of
https://github.com/hoshikawa2/compass_backoffice.git
synced 2026-07-09 13:54:20 +00:00
42 lines
1.5 KiB
Markdown
42 lines
1.5 KiB
Markdown
# Backoffice framework-native migration notes
|
|
|
|
This package reduces direct legacy dependencies in the active runtime.
|
|
|
|
Main changes:
|
|
|
|
- Domain nodes call framework services through `src.compat.framework_services`.
|
|
- IMDB enrichment uses MCP tool `consultar_imdb_cliente` first.
|
|
- Speech enrichment uses MCP tool `consultar_speech_analytics` first.
|
|
- TAIS KB enrichment uses MCP tool `consultar_tais_kb` first.
|
|
- Direct TIM clients are disabled by default and only available behind `BACKOFFICE_ALLOW_LEGACY_CLIENTS=true` for parity tests.
|
|
- Legacy model aliases such as `bo_gptoss20b_dev` are mapped to the framework model, defaulting to `openai.gpt-4.1`.
|
|
- Non-serializable progress producers are no longer stored inside LangGraph state, reducing checkpoint hash corruption risk.
|
|
- MCP server defaults to mock mode for local development.
|
|
|
|
Recommended local execution:
|
|
|
|
```bash
|
|
# Terminal 1: MCP mock server
|
|
uvicorn mcp_servers.backoffice_mcp_server.main:app --host 0.0.0.0 --port 8010 --reload
|
|
|
|
# Terminal 2: backend
|
|
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
|
|
```
|
|
|
|
Optional standalone IMDB mock, only if you intentionally enable legacy direct clients:
|
|
|
|
```bash
|
|
uvicorn mock_servers.mock_imdb_server:app --host 0.0.0.0 --port 8011 --reload
|
|
```
|
|
|
|
For a fully framework-native local test, keep:
|
|
|
|
```env
|
|
BACKOFFICE_ALLOW_LEGACY_CLIENTS=false
|
|
BACKOFFICE_MCP_USE_MOCK=true
|
|
BACKOFFICE_MCP_BACKEND_TYPE=mock
|
|
CLASSIFICATION_LLM_MODEL=openai.gpt-4.1
|
|
CLASSIFICATION_LARGE_LLM_MODEL=openai.gpt-4.1
|
|
TAIS_KB_LLM_MODEL=openai.gpt-4.1
|
|
```
|