Salesforce-to-Glider Nexus Prototype

一个基于合约的 mock 原型，演示受控的、AI 辅助的资产变更流水线：

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

Then check, for example：

curl http://localhost:8001/health

Docker

一旦各个服务具备实际功能（从 Phase 1 起），便会加入 Docker Compose 编排。Phase 0 中尚不可用。

仓库布局

完整的分阶段计划请参阅 docs/scope.md。顶层目录：

• shared/ - 所有服务共用的合约（枚举、schema、错误、关联）

• mock_glider/ - 模拟的权威资产系统

• mock_salesforce/ - 模拟的请求/审批系统

• integration/ - 确定性工作流、校验、审批路由、执行

• assistant/ - 对话式解析器和可选的 LLM 适配器

• frontend/ - 运维/经理/状态 UI

• mcp_server/ - 受管控的 MCP 工具（可选，最后添加）

• config/ - 审批规则、职责映射、状态转换

• scripts/ - 种子数据、演示、重置、性能测试脚本

• docs/ - 范围、假设、架构、合约、测试计划、演示脚本