14 · Source Systems

The external systems that feed and are fed by SpineWorkspace.

Source Systems are the external applications and tools that SpineWorkspace connects to. They are both inputs (providing data) and outputs (receiving actions).

---

Supported Systems

Category	Systems
CRM	Salesforce, HubSpot, Dynamics 365
ERP	NetSuite, QuickBooks
Support	ServiceNow, Zendesk
Communication	Slack, Teams, Google Workspace, Microsoft 365
Databases	Any SQL/NoSQL database via API
Custom	Files, Events, Webhooks, Any System

---

Bidirectional Flow

SOURCE SYSTEMS ←→ BRIDGE LAYER ←→ SPINE FABRIC

The same systems that provide data can also be acted upon. The Bridge Layer is bidirectional.

---

Ingestion Flow

Source System → Connector → Adapter → Transformer → Normalization → Spine Event → Spine Store

Execution Flow

Spine Decision → Governance Check → Execution Token → Adapter → Connector → Target System

---

Connector Contract

interface Connector {
  id: string;
  system: string;
  auth: AuthConfig;
  capabilities: Capability[];
  
  fetch(entity: string, params: QueryParams): Promise<Entity[]>;
  watch(entity: string, callback: EventCallback): Subscription;
  create(entity: string, data: EntityData): Promise<Entity>;
  update(entity: string, id: string, data: EntityData): Promise<Entity>;
  delete(entity: string, id: string): Promise<void>;
  health(): Promise<HealthStatus>;
}

---

Sync Rules

Rule	Description
Real-time	Webhooks and event streaming for live data
Polling	Configurable polling for systems without webhooks
Batch	Scheduled batch sync for large datasets
On-demand	Pull data when requested
Conflict resolution	Spine wins, log discrepancy

---

Fallback Rules

Failure	Fallback
Connector timeout	Retry with exponential backoff
Auth failure	Re-authenticate, notify admin
Rate limit	Queue and retry after cooldown
System down	Circuit breaker, serve cached data
Data conflict	Spine wins, log for reconciliation

---

Source Systems Connect to

Layer	Relationship
Spine Fabric	Data flows to and from the Spine
Communication Bridge	Connectivity via Bridge Layer
Execution	Actions executed in source systems
Reconciliation	Results reconciled from source systems