Salesforce-to-Glider Nexus Prototype

Un prototipo simulado basado en contratos que demuestra un pipeline controlado de cambios de activos asistido por IA:

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

Este prototipo utiliza contratos asumidos y datos sintéticos únicamente. No representa una integración funcional con sistemas reales de Salesforce o Glider Nexus. Consulte docs/scope.md y docs/assumptions.md antes de confiar en cualquier cosa de aquí.

Estado actual: Fase 0 (esqueleto)

Hasta ahora solo existen el esqueleto del repositorio, los contratos compartidos y las comprobaciones de salud de los servicios. Consulte docs/scope.md para saber qué está incluido y qué queda fuera del alcance en esta fase, y el plan de fases de construcción en la especificación fuente para saber qué viene después.

Related MCP server: Harness Engineering MCP

Configuración local

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

Ejecución de pruebas

pytest

Ejecutar un servicio localmente (Fase 0: solo comprobaciones de salud)

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

Luego compruebe, por ejemplo:

curl http://localhost:8001/health

Docker

La orquestación con Docker Compose se añade cuando los servicios individuales tienen funcionalidad real (a partir de la Fase 1). Aún no está disponible en la Fase 0.

Estructura del repositorio

Consulte docs/scope.md para el plan completo de fases. Directorios de nivel superior:

• shared/ - contratos (enums, esquemas, errores, correlación) utilizados por todos los servicios

• mock_glider/ - sistema simulado de activos autoritativo

• mock_salesforce/ - sistema simulado de solicitudes/aprobaciones

• integration/ - flujo de trabajo determinista, validación, enrutamiento de aprobaciones, ejecución

• assistant/ - analizador conversacional y adaptador LLM opcional

• frontend/ - interfaz de operaciones/gestión/estado

• mcp_server/ - herramientas MCP gobernadas (opcional, se añade al final)

• config/ - reglas de aprobación, mapeos de responsabilidades, transiciones de estado

• scripts/ - datos semilla, demo, reinicio, scripts de prueba de rendimiento

• docs/ - alcance, supuestos, arquitectura, contratos, plan de pruebas, guion de demo