Salesforce-to-Glider Nexus Prototype

Контрактный мок-прототип, демонстрирующий управляемый конвейер изменений активов с поддержкой ИИ:

Natural-language request
-> controlled asset discovery
-> user review
-> immutable request manifest
-> deterministic manager routing
-> mandatory approval
-> execution-time revalidation
-> mock authoritative update
-> complete reconciliation and audit

Этот прототип использует только предполагаемые контракты и синтетические данные. Он не представляет собой рабочую интеграцию с реальными системами Salesforce или Glider Nexus. См. docs/scope.md и docs/assumptions.md, прежде чем полагаться на что-либо здесь.

Текущий статус: Phase 0 (скелет)

Пока существуют только скелет репозитория, общие контракты и проверки работоспособности сервисов. См. docs/scope.md о том, что входит и не входит в рамки на этом этапе, и план этапов сборки в исходной спецификации о том, что будет дальше.

Related MCP server: Harness Engineering MCP

Локальная настройка

python3.11 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
cp .env.example .env

Запуск тестов

pytest

Запуск сервиса локально (Phase 0: только проверки работоспособности)

uvicorn mock_glider.app.main:app --reload --port 8001
uvicorn mock_salesforce.app.main:app --reload --port 8002
uvicorn integration.app.main:app --reload --port 8003

Затем проверьте, например:

curl http://localhost:8001/health

Docker

Оркестрация Docker Compose добавляется, когда отдельные сервисы получат реальную функциональность (начиная с Phase 1). Пока недоступно в Phase 0.

Структура репозитория

Полный план этапов см. в docs/scope.md. Каталоги верхнего уровня:

• shared/ - контракты (перечисления, схемы, ошибки, корреляция), используемые всеми сервисами

• mock_glider/ - мок-система авторитетных данных об активах

• mock_salesforce/ - мок-система запросов/утверждений

• integration/ - детерминированный рабочий процесс, валидация, маршрутизация утверждений, выполнение

• assistant/ - диалоговый парсер и опциональный LLM-адаптер

• frontend/ - UI для операций/менеджеров/статусов

• mcp_server/ - управляемые MCP-инструменты (опционально, добавляется последним)

• config/ - правила утверждений, карты ответственности, переходы статусов

• scripts/ - скрипты начальных данных, демо, сброса, тестов производительности

• docs/ - рамки, допущения, архитектура, контракты, план тестирования, сценарий демо