{"slug":"development/platform/integration-discovery","title":"SpineWorkspace — Integration Discovery Architecture","section":"development","sectionLabel":"Development","status":"unclassified","type":"document","path":"development/platform/integration-discovery.md","bytes":1529,"description":null,"updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"<!-- DOCUMENT CLASS: DEVELOPMENT | SOURCE: 42_INTEGRATION_DISCOVERY_ARCHITECTURE.md -->\n\n# SpineWorkspace — Integration Discovery Architecture\n\n## Purpose\n\nIntegration Discovery determines what external systems and capabilities are available and how they may participate in Business Context and Work.\n\n## Integration states\n\n```text\nDiscovered\n→ Selected\n→ Configured\n→ Connected\n→ Authorized\n→ Active\n→ Healthy\n→ Disabled / Deprecated\n```\n\nThese states are distinct.\n\n## Integration object\n\n```text\nIntegration\n├── Provider\n├── Product\n├── Version\n├── Connector Type\n├── Authentication\n├── Capabilities\n├── Data Domains\n├── Read Scope\n├── Write Scope\n├── Permissions\n├── Health\n├── Dependencies\n└── Lifecycle\n```\n\n## Discovery flow\n\n```text\nTenant / User / Host / Work\n→ Discover Providers\n→ Match Need / Business Domain\n→ Find Compatible Connectors\n→ Check Policy / Security\n→ Check Credentials\n→ Check Scope\n→ Present Integration\n→ Connect\n→ Register Capabilities\n```\n\n## Contextual discovery\n\nDiscovery should be work-aware:\n\n```text\nCurrent Work\n+ Role\n+ Domain\n+ Required Capability\n+ Host\n        ↓\nRelevant Integrations\n```\n\nExample:\n\n```text\nPayment Failure\n→ payment capability\n→ Finance user\n→ Stripe / Billing / ERP integrations\n```\n\n## Canonical rule\n\n> **Discovery exposes possibility; Governance determines permission; Connectivity establishes access; Capability determines what can be done.**\n"}