# vikram2409-eng/lanesra-os architecture

> Architecture diagram of the GitHub repository vikram2409-eng/lanesra-os, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vikram2409-eng/lanesra-os
- Repository: https://github.com/vikram2409-eng/lanesra-os

## Overview

Lanesra OS is a desktop-first business application platform combining a CRM, configurable no-code workspace, AI agent runtime, and integration interfaces. The principal user workflow runs from the desktop UI through its API bridge to a backend command and domain service, where business data is processed and persisted. The README also documents MCP/CLI access, workflow automation, voice, access control, deployment packages, and integrations. Several subsystems are represented from documented capabilities and tree paths; their internal calls were not sampled, so unsupported links are omitted.

Main entry points: [`desktop/core/src/services`](https://github.com/vikram2409-eng/lanesra-os/tree/main/desktop/core/src/services) (CRM lifecycle), [`desktop/src/lib/api.ts`](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/src/lib/api.ts) (Frontend API), [`desktop/server/src/routes.rs`](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/server/src/routes.rs) (Team HTTP server), [`desktop/src/App.tsx`](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/src/App.tsx) (App shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop experience"]
  node_app["App shell<br/>[App.tsx]"]
  node_crm["CRM screens"]
  node_admin["Admin screens"]
end

subgraph group_entry["Access interfaces"]
  node_api["Frontend API<br/>[api.ts]"]
  node_tauri["Desktop commands"]
  node_http["Team HTTP server<br/>[routes.rs]"]
  node_cli["CLI client<br/>[client.rs]"]
  node_mcp["MCP server<br/>[mcp.rs]"]
  node_dispatch["Command dispatch<br/>[dispatch.rs]"]
end

subgraph group_business["Business platform"]
  node_crm_domain["CRM lifecycle"]
  node_customize["Workspace customization"]
  node_automation["Workflow automation"]
  node_access["Access and ownership<br/>[access_service.rs]"]
  node_voice["Voice operations"]
  node_industry["Industry packages"]
end

subgraph group_ai["AI and integrations"]
  node_agent["AI agents<br/>[ai_service.rs]"]
  node_orchestration["Agent orchestration"]
  node_gateway["AI gateway"]
  node_integrations["Integration hub"]
end

subgraph group_data["Domain and persistence"]
  node_db[("SQLite database<br/>[connection.rs]")]
  node_pipeline_model["Pipeline model"]
  node_pipeline_repo["Pipeline repository"]
end

node_user(("Workspace user"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_crm
node_app -->|"renders"| node_admin
node_crm -->|"requests data"| node_api
node_admin -->|"configures"| node_api
node_api -->|"invokes"| node_tauri
node_api -->|"uses browser fallback"| node_http
node_http -->|"dispatches commands"| node_dispatch
node_cli -->|"uses REST API"| node_http
node_mcp -->|"serves MCP clients"| node_user
node_tauri -.->|"runs business operations"| node_crm_domain
node_crm_domain -.->|"persists records"| node_db
node_customize -.->|"stores workspace schema"| node_db
node_automation -.->|"acts on records"| node_crm_domain
node_access -.->|"restricts operations"| node_crm_domain
node_voice -->|"executes record actions"| node_crm_domain
node_agent -->|"uses model routing"| node_gateway
node_orchestration -->|"runs agents"| node_agent
node_orchestration -->|"reads and writes"| node_pipeline_repo
node_pipeline_repo -->|"maps pipeline data"| node_pipeline_model
node_integrations -.->|"connects external systems"| node_http
node_industry -->|"installs industry apps"| node_customize

click node_app "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/src/App.tsx"
click node_crm "https://github.com/vikram2409-eng/lanesra-os/tree/main/desktop/src/features"
click node_admin "https://github.com/vikram2409-eng/lanesra-os/tree/main/desktop/src/features/settings"
click node_api "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/src/lib/api.ts"
click node_tauri "https://github.com/vikram2409-eng/lanesra-os/tree/main/desktop/src-tauri/src/commands"
click node_http "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/server/src/routes.rs"
click node_cli "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/cli/src/client.rs"
click node_mcp "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/server/src/mcp.rs"
click node_dispatch "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/server/src/dispatch.rs"
click node_crm_domain "https://github.com/vikram2409-eng/lanesra-os/tree/main/desktop/core/src/services"
click node_customize "https://github.com/vikram2409-eng/lanesra-os/tree/main/desktop/core/src/services"
click node_automation "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/workflow_service.rs"
click node_access "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/access_service.rs"
click node_voice "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/voice_execution_service.rs"
click node_agent "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/ai_service.rs"
click node_orchestration "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/ai_orchestration_service.rs"
click node_gateway "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/ai_gateway_service.rs"
click node_integrations "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/connector_execution_service.rs"
click node_industry "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/industry_package_service.rs"
click node_db "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/db/connection.rs"
click node_pipeline_model "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/models/ai_agent_pipeline.rs"
click node_pipeline_repo "https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/repositories/ai_agent_pipeline_repo.rs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_crm,node_admin,node_user toneBlue
class node_api,node_tauri,node_http,node_cli,node_mcp,node_dispatch toneAmber
class node_crm_domain,node_customize,node_automation,node_access,node_voice,node_industry toneMint
class node_agent,node_orchestration,node_gateway,node_integrations toneRose
class node_db,node_pipeline_model,node_pipeline_repo toneIndigo
```

## Components

### Desktop experience

- [App shell](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/src/App.tsx): `desktop/src/App.tsx`
- [CRM screens](https://github.com/vikram2409-eng/lanesra-os/tree/main/desktop/src/features): `desktop/src/features`
- [Admin screens](https://github.com/vikram2409-eng/lanesra-os/tree/main/desktop/src/features/settings): `desktop/src/features/settings`

### Access interfaces

- [Frontend API](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/src/lib/api.ts): `desktop/src/lib/api.ts`
- [Desktop commands](https://github.com/vikram2409-eng/lanesra-os/tree/main/desktop/src-tauri/src/commands): `desktop/src-tauri/src/commands`
- [Team HTTP server](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/server/src/routes.rs): `desktop/server/src/routes.rs`
- [CLI client](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/cli/src/client.rs): `desktop/cli/src/client.rs`
- [MCP server](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/server/src/mcp.rs): `desktop/server/src/mcp.rs`
- [Command dispatch](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/server/src/dispatch.rs): `desktop/server/src/dispatch.rs`

### Business platform

- [CRM lifecycle](https://github.com/vikram2409-eng/lanesra-os/tree/main/desktop/core/src/services): `desktop/core/src/services`
- [Workspace customization](https://github.com/vikram2409-eng/lanesra-os/tree/main/desktop/core/src/services): `desktop/core/src/services`
- [Workflow automation](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/workflow_service.rs): `desktop/core/src/services/workflow_service.rs`
- [Access and ownership](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/access_service.rs): `desktop/core/src/services/access_service.rs`
- [Voice operations](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/voice_execution_service.rs): `desktop/core/src/services/voice_execution_service.rs`
- [Industry packages](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/industry_package_service.rs): `desktop/core/src/services/industry_package_service.rs`

### AI and integrations

- [AI agents](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/ai_service.rs): `desktop/core/src/services/ai_service.rs`
- [Agent orchestration](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/ai_orchestration_service.rs): `desktop/core/src/services/ai_orchestration_service.rs`
- [AI gateway](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/ai_gateway_service.rs): `desktop/core/src/services/ai_gateway_service.rs`
- [Integration hub](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/services/connector_execution_service.rs): `desktop/core/src/services/connector_execution_service.rs`

### Domain and persistence

- [SQLite database](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/db/connection.rs): `desktop/core/src/db/connection.rs`
- [Pipeline model](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/models/ai_agent_pipeline.rs): `desktop/core/src/models/ai_agent_pipeline.rs`
- [Pipeline repository](https://github.com/vikram2409-eng/lanesra-os/blob/main/desktop/core/src/repositories/ai_agent_pipeline_repo.rs): `desktop/core/src/repositories/ai_agent_pipeline_repo.rs`

### Other components

- **Workspace user**

## Connections

- Workspace user → App shell: uses (evidence: `desktop/src/App.tsx`)
- App shell → CRM screens: renders (evidence: `desktop/src/App.tsx`)
- App shell → Admin screens: renders (evidence: `desktop/src/App.tsx`)
- CRM screens → Frontend API: requests data (evidence: `desktop/src/features/tasks/Tasks.tsx`)
- Admin screens → Frontend API: configures (evidence: `desktop/src/features/settings/AiAgentPipelinesAdmin.tsx`)
- Frontend API → Desktop commands: invokes (evidence: `desktop/src/lib/api.ts`)
- Frontend API → Team HTTP server: uses browser fallback (evidence: `desktop/src/lib/api.ts`)
- Team HTTP server → Command dispatch: dispatches commands (evidence: `desktop/server/src/routes.rs`)
- CLI client → Team HTTP server: uses REST API
- MCP server → Workspace user: serves MCP clients
- Desktop commands → CRM lifecycle: runs business operations
- CRM lifecycle → SQLite database: persists records
- Workspace customization → SQLite database: stores workspace schema
- Workflow automation → CRM lifecycle: acts on records
- Access and ownership → CRM lifecycle: restricts operations
- Voice operations → CRM lifecycle: executes record actions
- AI agents → AI gateway: uses model routing
- Agent orchestration → AI agents: runs agents (evidence: `desktop/core/src/services/ai_orchestration_service.rs`)
- Agent orchestration → Pipeline repository: reads and writes (evidence: `desktop/core/src/services/ai_orchestration_service.rs`)
- Pipeline repository → Pipeline model: maps pipeline data (evidence: `desktop/core/src/repositories/ai_agent_pipeline_repo.rs`)
- Integration hub → Team HTTP server: connects external systems
- Industry packages → Workspace customization: installs industry apps