{"slug":"developers/V0_PROMPT_ONE_ACCESS_NETWORK","title":"v0 Prompt: IntegrateWise One Access Network — Universal Identity, Connection, Discovery, Capability & Spine","section":"developers","sectionLabel":"Developers","status":"unclassified","type":"document","path":"developers/V0_PROMPT_ONE_ACCESS_NETWORK.mdx","bytes":18451,"description":null,"updated":null,"source":"integratewise/Integratewise-docs-wiki","content":"\n## Context Summary\n\nThis prompt builds the **One Access Network** frontend UI surfaces (`apps/one-access`) — the universal identity, connection, discovery, capability, and semantic Spine layer that is consumed by all IntegrateWise applications, agents, hosts, plugins, and MCP clients.\n\n### What Already Exists (Backend APIs Ready)\n\n- **API Routes** in `apps/one-access/src/app/api/v1/`:\n  - `/auth` — Universal identity, tenant, consent, delegation\n  - `/marketplace/connectors` — Universal marketplace catalog\n  - `/connectors` — Universal connection management\n  - `/discovery` — Universal discovery engine\n  - `/capabilities` — Effective access view\n  - `/spine` — Tenant Spine (schema, business context, KPIs, knowledge, capability bindings)\n  - `/connected-tools` — Connected tool matrix (hosts/tenants/agents/tools)\n  - `/tool-capabilities` — Tool capability matrix (actions and permissions)\n\n### What This Prompt Builds\n\nThe **One Access Network UI** — a host-neutral control surface with these routes:\n\n```\n/auth                           → Universal identity, consent, shared-access management\n/marketplace                    → Public & authenticated universal marketplace\n/connectors                     → Universal connection-management workspace\n/discovery                      → Universal discovery engine UI\n/capabilities                   → Complete capability explorer\n/capability-matrix              → Effective access comparison matrix\n/connected-tool-matrix          → Who connects to which tools\n/tool-capability-matrix         → What each connected tool can do\n/spine                          → Semantic & operational Spine network view\n/spine/business-context         → Business Context Studio\n/spine/kpis                     → KPI Studio\n/spine/knowledge                → Business Knowledge workspace\n/spine/schema                   → Schema Studio (generic tenant schema)\n/spine/mappings                 → Schema Mappings (source → tenant)\n/spine/lineage                  → Lineage graph/timeline/table\n/hosts                          → Host registry & capability projection\n/grants                         → Grant management\n/activity                       → Unified activity & audit\n/settings                       → Platform settings\n```\n\n---\n\n## Design Direction\n\nUse the existing IntegrateWise design identity:\n\n**Quiet enterprise** — Paper and forest — Neutral light and dark surfaces — Forest green accent (#1a3a2a) — Dense but highly readable operational layouts — Strong information hierarchy — Minimal decorative gradients — Subtle borders and restrained shadows — Desktop-first, responsive down to tablet and mobile — Accessible keyboard navigation\n\nUse existing design-system tokens where possible. The UI should feel like one connected product, not a collection of unrelated dashboards.\n\n---\n\n## Global Application Shell\n\nCreate a complete shell with:\n\n- Product logo and product name (\"IntegrateWise One Access\")\n- **Tenant selector** (multi-tenant)\n- **Workspace selector** (workbench context)\n- **Host selector** (IntegrateWise Web, IntegrateWise Platform, ChatGPT, Claude, MCP Client, Agent Runtime, External Application)\n- **Environment selector** (development, staging, production)\n- Global search (Cmd+K)\n- Command palette button\n- Notifications\n- Help\n- User profile menu\n- Collapsible left navigation\n- Context-sensitive right inspector\n- Breadcrumbs\n- Page title and page actions\n- Global status banner\n- Connection health indicator\n- Mock current user, tenant, workspace, and host context\n\n**Changing the host should visually update capability and access states using mock data.**\n\n---\n\n## 1. Auth UI Surfaces (`/auth`)\n\nUniversal identity, consent, and shared-access management experience.\n\n### Tabs/Subpages:\n\n- **Sign In** — Hosted login screen with IntegrateWise branding, email input, Continue button, SSO options, Passkey option, Trust/privacy message, Approved client card, Requested scopes summary, Redirect destination summary\n- **Client Applications** — List + detail: Client name, Client ID, Redirect URIs, Allowed scopes, Allowed hosts, Environment, Status, Last activity, Active grants, Edit/Disable actions\n- **Sessions** — Active sessions table with revoke action\n- **Consent** — Granted consents, scopes, expiry, revoke\n- **Grants** — Issued grants to hosts/agents/apps\n- **Connected Providers** — Provider connections with status\n- **Security** — MFA, passkeys, security keys\n- **Audit** — Auth audit log\n\n### Mock Flows Only\n\nButtons move between mocked states. No real login/OAuth/token exchange.\n\n---\n\n## 2. Marketplace (`/marketplace`)\n\nPublic and authenticated universal marketplace.\n\n### Artifact Types:\n\nConnectors | MCP Servers | Plugins | Agents | Models | Workbench Templates | Automation Templates\n\n### Features:\n\n- Search, Categories, Featured, Popular, Installed, Available\n- Publisher filters, Host compatibility filters, Capability filters, Auth method filters, Risk-level filters\n\n### Marketplace Card:\n\nName, Icon, Type, Publisher, Description, Supported hosts, Capability count, Authentication type, Installation status, Health, Trust/verification badge\n\n### Detail Page (Tabs):\n\nOverview | Capabilities | Authentication | Required Scopes | Host Compatibility | Schema | Business Context | KPI Relevance | Versions | Activity | Publisher\n\n### Actions (Mocked):\n\nConnect Provider | Grant to Application | Assign to Agent | Add to Workbench | View Capabilities | Install | Request Approval\n\n---\n\n## 3. Connectors (`/connectors`)\n\nUniversal connection-management workspace.\n\n### Views (Tabs):\n\nAll Connections | Connected | Configuration Required | Authorization Expired | Degraded | Suspended | Available to Connect\n\n### Table & Card Toggle\n\n### Connector Row:\n\nProvider, Connection name, Tenant, Connected account, Authentication method, Granted scopes, Authorized hosts, Used by agents, Health, Last sync, Status, Expiry, Actions\n\n### Connector Detail Workspace (Tabs):\n\nOverview | Authorization | Configuration | Capabilities | Source Schema | Tenant Schema | Schema Mappings | Business Context | KPI Impact | Activation | Executions | Health | Lineage | Audit\n\n### Mock Flows:\n\nReconnect flow, Scope review flow, Host assignment flow\n\n---\n\n## 4. Discovery (`/discovery`)\n\nUniversal discovery engine UI.\n\n### Discovery Source Types:\n\nHost platforms | Workspace connections | Connector catalog | MCP servers | OpenAPI specs | GraphQL schemas | Databases | Plugins | Agents | Knowledge sources\n\n### Three-Pane Layout:\n\n**Discovery Sources** (left) | **Discovered Resources** (center) | **Discovery Inspector** (right)\n\n### Features:\n\nStart discovery button | Discovery progress | Live discovery events | Source health | Deduplication status | Confidence scores | Proposed mappings | Conflicts | Import status | Activation status\n\n### Discovered Resource Types:\n\nConnector | Tool | Capability | Entity | Schema | Event | Prompt | Resource | Knowledge source | Agent\n\n### Inspector:\n\nTechnical metadata | Authentication requirements | Input/output schemas | Source authority | Duplicate matches | Proposed tenant mapping | Business-context relationships | KPI relationships | Risk | Approval state\n\n### Mock Discovery Run Detail:\n\nTimeline view\n\n---\n\n## 5. Capability Explorer (`/capabilities`)\n\nComplete capability explorer.\n\n### Sections:\n\nAvailable to me | Installed | Connector capabilities | MCP tools | Plugin capabilities | Agent capabilities | AI capabilities | Native platform capabilities | Recently used | Recommended\n\n### Capability Card:\n\nName, Provider, Capability type, Read/Write status, Risk level, Approval requirement, Connected state, Host availability, Agent availability, Input schema summary, Output schema summary, Health, Last used\n\n### Detail View (Tabs):\n\nOverview | Input Schema | Output Schema | Permissions | Required Scopes | Hosts | Agents | Connections | Business Context | KPI Impact | Execution History | Policies | Versions | Audit\n\n### Actions:\n\nRun | Add to Workbench | Assign to Agent | Grant to Host | Add to Automation | Ask Twin | Inspect Schema | View Lineage\n\n### Schema-Driven Invocation Form:\n\nMock JSON schema form with validation\n\n---\n\n## 6. Capability Matrix (`/capability-matrix`)\n\nCompares effective access across:\n\n### Rows:\n\nConnectors | Tools | Agents | Hosts | Roles | Workspaces\n\n### Columns:\n\nCapabilities | Permissions | Environments | Providers | Host platforms\n\n### Cell States (10):\n\nAvailable | Connected | Missing authorization | Missing permission | Approval required | Policy denied | Provider degraded | Not installed | Unsupported by host | Configuration required\n\n### Features:\n\nFreeze rows/columns | Search | Filters | Grouping | Column selection | Density toggle | Export | Compare mode | Cell inspector | Mock bulk assignment\n\n**Distinct icons, labels, tooltips — not color-only.**\n\n---\n\n## 7. Connected Tool Matrix (`/connected-tool-matrix`)\n\nShows which tenants, workspaces, hosts, applications, agents connect to which tools.\n\n### Rows (Switchable):\n\nHosts | Applications | Agents | Workspaces | Tenants\n\n### Columns (Tools/Providers):\n\nSlack, GitHub, Stripe, Salesforce, Notion, Snowflake, OpenAI, Anthropic, Custom MCP Server, etc.\n\n### Cell States:\n\nConnected | Shared | Authorized | Expired | Revoked | Configuration required | Policy denied | Available but unassigned\n\n### Cell Click → Right Inspector:\n\nConnection, Granted scopes, Authorized capabilities, Assigned host/agent, Environment, Last use, Grant expiry, Policy, Audit events\n\n---\n\n## 8. Tool Capability Matrix (`/tool-capability-matrix`)\n\nShows what each connected tool can actually do.\n\n### Rows:\n\nTools/Providers (nested groups)\n\n### Columns:\n\nRead | Create | Update | Delete | Search | Trigger | Subscribe | Execute | Export | Administrative\n\n### Example GitHub:\n\n- Repository: read, create, update, delete, search\n- Issue: read, create, update, delete\n- Pull Request: read, create, update, merge\n- Workflow: trigger\n\n### Example Stripe:\n\n- Customer: read, create, update\n- Invoice: read, create\n- Subscription: read, create, update, cancel\n- Refund: create\n\n### Cell States:\n\nSupported | Unsupported | Scope missing | Approval required | Restricted | Host incompatible | Agent restricted\n\n### Detailed Capability Inspector on click\n\n---\n\n## 9. Spine Overview (`/spine`)\n\nSemantic and operational network view.\n\n### Node Types (16):\n\nTenant, Workspace, Host, User, Agent, Connector, Tool, Capability, Entity Type, Entity, Business Process, Business Objective, KPI, Knowledge Source, Memory, Policy, Execution, Deployment\n\n### Edge Types (15):\n\nProvides, Uses, Reads, Writes, Triggers, Calls, Shares data with, Authorized by, Governed by, Affects KPI, Participates in process, Mapped from, Deployed to, Depends on\n\n### Graph Canvas Controls:\n\nZoom, Pan, Fit view, Minimap, Filters, Grouping, Expand neighbors, Collapse groups, Time-window selector, Live-event toggle, Layout selector, Search, Path tracing, Upstream/downstream tracing\n\n### Node Inspector:\n\nMetadata, Business meaning, Related capabilities, Related KPIs, Related hosts, Related agents, Source mappings, Activity, Health, Policies, Lineage\n\n### Mock Graph Data\n\n---\n\n## 10. Business Context (`/spine/business-context`)\n\nBusiness-context studio for arbitrary tenants.\n\n### Three-Pane Layout:\n\n**Context Tree** (left) | **Context Canvas** (center) | **Context Inspector** (right)\n\n### Sections:\n\nOrganization, Industry, Departments, Functions, Business Objectives, Processes, Terminology, Policies, Roles, Owners, Related KPIs, Related Entities, Related Capabilities, Related Knowledge\n\n### Actions:\n\nCreate context, Link entity, Link KPI, Link capability, Link process, Link knowledge, Version history, Compare versions, Publish draft\n\n### Mock Examples:\n\nSoftware development, Sales, Finance, Operations — but UI is generic\n\n---\n\n## 11. KPI Studio (`/spine/kpis`)\n\n### Views:\n\nKPI Catalog | KPI Definitions | Targets | Dimensions | Data Sources | Related Processes | Related Capabilities | Owners | Calculation History\n\n### Visual Differentiation:\n\nRaw metric (neutral) | Derived metric (blue) | Business KPI (green) | Operational indicator (amber) | Agent metric (purple) | Platform health metric (red)\n\n### KPI Cards + Detailed Editor\n\n### KPI Detail:\n\nName, Business purpose, Formula, Unit, Current value, Target, Warning threshold, Critical threshold, Trend, Data sources, Related entities, Related processes, Related capabilities, Owners, Agent influence, Version, Last calculated\n\n---\n\n## 12. Business Knowledge (`/spine/knowledge`)\n\n### Knowledge Types:\n\nPolicy, SOP, Runbook, Playbook, Contract, Product documentation, Process documentation, Decision, Meeting outcome, Exception, Lesson learned\n\n### Workspace:\n\nSource list, Document viewer, Provenance, Related business context, Related entities, Related capabilities, Related KPIs, Related agents, Freshness, Sensitivity, Retention, Version\n\n---\n\n## 13. Schema Studio (`/spine/schema`)\n\nGeneric tenant schema studio.\n\n### Three-Pane Layout:\n\n**Schema Navigator** (left) | **Schema Canvas/Table** (center) | **Schema Inspector** (right)\n\n### Navigator Tree:\n\nGeneric Spine Schema → Tenant Schema → Source Schemas → Entity Types → Fields → Relationships → Events → Domain Packs → Versions\n\n### Per Entity Type:\n\nTechnical name, Business name, Description, Fields, Relationships, Source mappings, Business contexts, KPIs, Capabilities (read/write), Agents, Policies, Lineage\n\n### Schema-Driven Mock Data (not hardcoded layouts)\n\n---\n\n## 14. Schema Mappings (`/spine/mappings`)\n\nSource-to-tenant schema mappings.\n\n### Table Columns:\n\nSource system, Source object, Tenant entity type, Field mappings, Transformations, Confidence, Mapping status, Reviewer, Version, Last sync, Conflicts, Validation errors\n\n### Visual Mapper:\n\nDrag-and-drop mapping lines, Suggested mappings, Conflict resolution, Mapping inspector\n\n### States:\n\nDraft, Review, Approve, Activate\n\n---\n\n## 15. Lineage (`/spine/lineage`)\n\n### Columns:\n\nSource system → Source object → Transformation → Tenant entity → Capability → Agent → Workbench → KPI → Destination → Memory write\n\n### Modes:\n\nGraph mode | Timeline mode | Table mode\n\n### Features:\n\nUpstream trace, Downstream trace, Sensitive-data filter, Export, Impact analysis\n\n---\n\n## 16. Hosts (`/hosts`)\n\n### List:\n\nIntegrateWise Web, IntegrateWise Platform, ChatGPT, Claude, MCP Clients, Agent Runtimes, Plugins, External Applications\n\n### Host Detail:\n\nHost type, Client ID, Status, Allowed scopes, Granted connections, Available capabilities, Unsupported capabilities, Active sessions, Grants, Last activity, Environment, Policies, Audit\n\n### Capability Projection Preview:\n\nWhat that host would receive (MCP tool list, scopes, entity access)\n\n---\n\n## 17. Grants (`/grants`)\n\n### Fields:\n\nGrant ID, Subject, Audience, Tenant, Workspace, Host, Connection, Capability scopes, Purpose, Environment, Issued at, Expires at, Status, Policy version, Last used\n\n### Actions:\n\nRevoke, Extend, Duplicate, Inspect\n\n### Filter:\n\nExpiring soon\n\n### Grant Creation Drawer:\n\nMock state\n\n---\n\n## 18. Activity & Audit (`/activity`)\n\n### Unified Event Types:\n\nLogin, Consent, Connection created, Connection revoked, Discovery started, Capability discovered, Schema mapped, Grant issued, Tool invoked, Approval requested, Policy denied, Data shared, KPI updated, Host projection generated\n\n### Views:\n\nTimeline, Table\n\n### Filters:\n\nSearch, Actor, Tenant, Host, Agent, Tool, Outcome, Risk, Correlation ID\n\n### Trace Inspector:\n\nActor, Tenant, Host, Agent, Tool, Outcome, Risk, Correlation ID\n\n---\n\n## Shared Reusable Components\n\nCreate reusable components for:\n\n- Status badges, Risk badges, Host badges, Provider logos\n- Capability cards, Connection cards, Matrix cells\n- Schema viewers, JSON schema forms, Timeline events\n- Graph node inspector, Filter toolbar, Search command\n- Empty states, Loading states, Error states\n- Unauthorized state, Forbidden state, Offline state\n- Stale-data banner, Approval banner, Mock notifications\n\n---\n\n## Mock Data Requirements\n\nRich mock datasets for:\n\n- Multiple tenants (4+)\n- Multiple workspaces per tenant\n- Multiple hosts (all 7 types)\n- 12+ connectors\n- 30+ capabilities\n- 8+ agents\n- 15+ business entities\n- 10+ KPIs\n- 10+ knowledge sources\n- 50+ activity events\n- Multiple schema mappings\n- Multiple grant states\n- Multiple connection states\n\n**UI demonstrates:** Healthy, empty, loading, partial data, degraded providers, expired auth, policy denial, approval required, unsupported host capability, schema conflict, stale business context\n\n---\n\n## Technical Constraints\n\n**Frontend Only**\n\n- React + TypeScript\n- Next.js App Router conventions\n- Tailwind CSS\n- Reusable components\n- Local mock data\n- Local component state\n\n**No Backend Implementation**\n\n- No real authentication, OAuth, API calls, database, secrets, provider credentials, token creation, MCP connection, provider SDKs\n- No hardcoded business-domain assumptions in reusable components\n\n**Production-quality UI shells** with realistic data density, navigation, detail pages, inspectors, tables, matrices, graphs, drawers, dialogs, filters, responsive states\n\n---\n\n## Integration with Platform App Shell\n\nThe One Access Network UI (`apps/one-access`) is **inherited** by the Platform App Shell (`apps/platform`):\n\n```\napps/platform (Platform App Shell)\n├── Inherits from apps/one-access:\n│   ├── /auth → One Auth\n│   ├── /marketplace → Marketplace\n│   ├── /connectors → Connection Management\n│   ├── /discovery → Discovery Engine\n│   ├── /capabilities → Capability Registry\n│   ├── /connected-tool-matrix → Connected Tool Matrix\n│   ├── /tool-capability-matrix → Tool Capability Matrix\n│   └── /spine → Tenant Spine (schema, business context, KPIs, knowledge, mappings, lineage)\n│\n└── Owns Platform UI:\n    ├── Twin Orchestrator, 5 Platform Agents\n    ├── 12 Department Workbenches\n    ├── Configuration, Activation, Governance\n    ├── Memory, Deployments, Observability\n    ├── Hosts, Grants, Activity\n    └── Settings\n```\n\nThe Platform App Shell **extends** One Access with privileged control-plane surfaces.\n"}