Salesforce-to-Glider Nexus Prototype

계약 기반 모의 프로토타입으로, 통제된 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

그런 다음 예를 들어 다음을 확인하세요:

curl http://localhost:8001/health

Docker

Docker Compose 오케스트레이션은 개별 서비스에 실제 기능이 추가된 후(Phase 1부터) 도입됩니다. Phase 0에서는 아직 사용할 수 없습니다.

저장소 구조

전체 단계 계획은 docs/scope.md를 참조하세요. 최상위 디렉터리:

• shared/ - 모든 서비스에서 사용하는 계약(enum, 스키마, 오류, 상관관계)

• mock_glider/ - 모의 권위 자산 시스템

• mock_salesforce/ - 모의 요청/승인 시스템

• integration/ - 결정적 워크플로, 검증, 승인 라우팅, 실행

• assistant/ - 대화형 파서 및 선택적 LLM 어댑터

• frontend/ - 운영/관리자/상태 UI

• mcp_server/ - 관리되는 MCP 도구(선택 사항, 마지막에 추가)

• config/ - 승인 규칙, 책임 매핑, 상태 전환

• scripts/ - 시드 데이터, 데모, 리셋, 성능 테스트 스크립트

• docs/ - 범위, 가정, 아키텍처, 계약, 테스트 계획, 데모 스크립트