O2C Deployment Workbench

Полное, явно синтетическое внедрение для клиента в области дебиторской задолженности ERP: загрузка источников, канонические данные, разнесение денежных средств, удержания, инкассация, контроли, бенчмаркинг KPI, доступ через MCP, мультиагентная проверка исключений, наблюдаемость, UAT, переход на новую систему и гиперподдержка.

Все файлы в этом репозитории, стилизованные под SAP S/4HANA, Oracle Fusion и NetSuite, являются сгенерированными симуляциями. Они не являются настоящими выгрузками или реальными интеграциями. Изменение KPI — это контролируемый бенчмарк внедрения на синтетических данных, а не реальное влияние на клиента.

Почему это проект внедрения

Workbench начинается с конфигурации клиента и трёх несовместимых форматов источников, а не с чистой аналитической таблицы. Он применяет контрольные точки валидации, сохраняет остатки платежей, направляет исключения по маршрутам, расставляет приоритеты для инкассации, показывает недостигнутые цели и формирует артефакты, которые команда внедрения использует от обнаружения требований до запуска в эксплуатацию.

Архитектура намеренно делает финансовое сопоставление детерминированным и аудируемым. Агенты выполняют работу, требующую суждений: расследование исключений, диагностику качества данных, планирование инкассации и мониторинг запуска. Они не могут проводить проводки в ERP, создавать возвраты, списывать долги или изменять основные данные.

flowchart LR
    A["Three simulated ERP export sets"] --> B["Configuration-driven adapters"]
    B --> C["Seven canonical receivables tables"]
    C --> D["Validation control gate"]
    D --> E["Deterministic cash matching"]
    E --> F["Exception and collections queues"]
    F --> G["MCP evidence tools"]
    G --> H["Supervisor agent"]
    H --> I["Cash Application Agent"]
    H --> J["Data Quality Agent"]
    H --> K["Collections Agent"]
    I --> L["Human approval gate"]
    J --> L
    K --> L
    E --> M["Controlled KPI benchmark"]
    M --> N["Go Live Monitor Agent"]
    O["OpenTelemetry traces"] -.-> B
    O -.-> E
    O -.-> H
    O -.-> N

Запуск

python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
o2c-workbench --project-root .
streamlit run app.py

Воспроизводимый прогон с seed-42 создаёт 1 908 канонических записей, обнаруживает 18 намеренных дублирующихся банковских операций как предупреждения и оставляет ноль ошибок валидации. Откройте статический дашборд или используйте приложение Streamlit.

MCP-сервер

Сервер использует актуальный MCP Python SDK и предоставляет структурированные инструменты, ресурсы и промпты. Локальные клиенты должны использовать stdio; развёрнутые клиенты могут использовать Streamable HTTP.

o2c-mcp --transport stdio
o2c-mcp --transport streamable-http --port 8000

Инструменты: get_implementation_summary, investigate_payment, get_collection_priority и run_controlled_benchmark. Ресурсы: o2c://configuration, o2c://benchmark и o2c://observability.

Мультиагентные пути

Путь по умолчанию работает офлайн и детерминированно, чтобы рецензент мог воспроизвести передачи управления и контроли без учётной записи или API-ключа. Он создаёт output/agent_decisions.csv, output/agent_control_summary.json и спаны OpenTelemetry.

Дополнительный вариант проверки с поддержкой модели использует OpenAI Agents SDK со специализированными передачами управления и структурированным выводом:

pip install -e ".[ai]"
export OPENAI_API_KEY="..."
o2c-agent-review SAP-P001-09 --project-root .

Путь с моделью намеренно не требуется для бенчмарк-показателей KPI. Он может рекомендовать, но не может выполнять контролируемые финансовые операции.

Карта репозитория

• config/ — конфигурация внедрения, сопоставления, допуски, веса, маршруты, контроли, целевые KPI, лимиты агентов.

• data/raw/ — сгенерированные, с явными пометками симулированные выгрузки из ERP.

• data/canonical/ — нормализованные клиенты, счета, платежи, ремитансы, удержания, обещания и активности.

• src/o2c_workbench/ — адаптеры, сопоставление, инкассация, контроли, агенты, MCP, наблюдаемость, логика KPI.

• output/ — результаты бенчмарка, очереди, трейсы и дашборды.

• docs/ — проектирование процессов, сопоставление, контроли, RTM, 28 UAT-сценариев, переход, мониторинг, обучение и исследовательская база.

• deliverables/ — рабочая тетрадь внедрения.

• demo/ — пятиминутное озвученное демонстрационное прохождение внедрения и сценарий.

Бенчмарк Seed-42

Четыре амбициозные целевые показателя остаются недостигнутыми, поэтому монитор рекомендует условный запуск, а не празднование победы. Это намеренный реализм внедрения: продолжать работу только с контролем утверждения человеком и целенаправленной гиперподдержкой по неразнесённым денежным средствам и остаточным переплатам.

Проверка

pytest -q

Смотрите исследовательскую базу — первоисточники, которые легли в основу платёжных сценариев, выбора транспорта MCP, передач управления агентам и соглашений о телеметрии.