# rudrasalokhe/flowdesk architecture

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

- Interactive diagram: https://gitdiagram.com/rudrasalokhe/flowdesk
- Repository: https://github.com/rudrasalokhe/flowdesk

## Overview

LaunchPad is a frontend client for B2B sales and RevOps workflows. Users enter through the routed application and, after authentication, work with leads, follow-up tasks, imports, team capacity, notifications, and revenue analytics. Domain behavior such as scoring, assignment, CSV processing, and aggregation belongs to the FastAPI backend; the client supplies REST services and an offline mock fallback. Several page and component relationships are based on the SOURCE INDEX or README rather than inspected implementation excerpts.

Main entry points: [`src/App.jsx`](https://github.com/rudrasalokhe/flowdesk/blob/main/src/App.jsx) (Routes and guards), [`src/api/client.js`](https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/client.js) (HTTP client), [`src/api/leads.js`](https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/leads.js) (Lead service), [`src/api/imports.js`](https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/imports.js) (Import service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and session"]
  node_app["Routes and guards<br/>[App.jsx]"]
  node_auth["Session lifecycle<br/>[AuthContext.jsx]"]
  node_login["Sign-in<br/>[Login.jsx]"]
end

subgraph group_leads["Lead operations"]
  node_lead_list["Lead directory<br/>[Leads.jsx]"]
  node_lead_create["Lead intake<br/>[CreateLead.jsx]"]
  node_lead_detail["Lead profile<br/>[LeadDetails.jsx]"]
end

subgraph group_work["Sales operations"]
  node_task_page["Task management<br/>[Tasks.jsx]"]
  node_import_page["Bulk lead import<br/>[ImportLeads.jsx]"]
  node_csv_upload["CSV upload UI<br/>[CsvUploader.jsx]"]
  node_import_progress["Import progress UI<br/>[ImportProgress.jsx]"]
  node_team["Team capacity<br/>[Team.jsx]"]
  node_notifications["Alerts center<br/>[Notifications.jsx]"]
end

subgraph group_insights["Revenue insights"]
  node_dashboard["RevOps overview<br/>[Dashboard.jsx]"]
  node_analytics["Analytics reports<br/>[Analytics.jsx]"]
end

subgraph group_services["Client data services"]
  node_lead_api["Lead service<br/>[leads.js]"]
  node_task_api["Task service<br/>[tasks.js]"]
  node_import_api["Import service<br/>[imports.js]"]
  node_users_api["User service<br/>[users.js]"]
  node_analytics_api["Analytics service<br/>[analytics.js]"]
  node_notifications_api["Notification service<br/>[notifications.js]"]
  node_api_client["HTTP client<br/>[client.js]"]
  node_mock_data[("Preview fallback data<br/>[mockData.js]")]
  node_api_hook["Request state hook<br/>[useApi.js]"]
end

node_user(("Sales user"))
node_api_backend["FastAPI backend"]

node_user -->|"opens"| node_app
node_app -->|"provides session"| node_auth
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_lead_list
node_app -->|"routes to"| node_lead_create
node_app -->|"routes to"| node_lead_detail
node_app -->|"routes to"| node_task_page
node_app -->|"routes to"| node_import_page
node_app -->|"routes to"| node_team
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_analytics
node_app -->|"routes to"| node_notifications
node_login -->|"signs in"| node_auth
node_auth -->|"uses auth service"| node_api_client
node_lead_list -->|"requests leads"| node_lead_api
node_lead_create -->|"submits lead"| node_lead_api
node_lead_detail -->|"requests lead data"| node_lead_api
node_task_page -->|"manages tasks"| node_task_api
node_import_page -->|"requests import"| node_import_api
node_csv_upload -->|"uploads CSV"| node_import_api
node_import_progress -->|"polls status"| node_import_api
node_import_progress -->|"uses request state"| node_api_hook
node_team -->|"requests users"| node_users_api
node_dashboard -->|"requests metrics"| node_analytics_api
node_dashboard -->|"requests lead data"| node_lead_api
node_notifications -.->|"requests alerts"| node_notifications_api
node_lead_api -->|"sends requests"| node_api_client
node_task_api -->|"sends requests"| node_api_client
node_import_api -->|"sends requests"| node_api_client
node_users_api -->|"sends requests"| node_api_client
node_analytics_api -->|"sends requests"| node_api_client
node_notifications_api -->|"sends requests"| node_api_client
node_api_client -->|"calls REST API"| node_api_backend
node_lead_api -->|"falls back to"| node_mock_data
node_task_api -->|"falls back to"| node_mock_data
node_import_api -->|"falls back to"| node_mock_data
node_analytics_api -->|"falls back to"| node_mock_data

click node_app "https://github.com/rudrasalokhe/flowdesk/blob/main/src/App.jsx"
click node_auth "https://github.com/rudrasalokhe/flowdesk/blob/main/src/context/AuthContext.jsx"
click node_login "https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/Login.jsx"
click node_lead_list "https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/Leads.jsx"
click node_lead_create "https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/CreateLead.jsx"
click node_lead_detail "https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/LeadDetails.jsx"
click node_lead_api "https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/leads.js"
click node_task_page "https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/Tasks.jsx"
click node_task_api "https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/tasks.js"
click node_import_page "https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/ImportLeads.jsx"
click node_csv_upload "https://github.com/rudrasalokhe/flowdesk/blob/main/src/components/imports/CsvUploader.jsx"
click node_import_progress "https://github.com/rudrasalokhe/flowdesk/blob/main/src/components/imports/ImportProgress.jsx"
click node_import_api "https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/imports.js"
click node_team "https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/Team.jsx"
click node_users_api "https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/users.js"
click node_dashboard "https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/Dashboard.jsx"
click node_analytics "https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/Analytics.jsx"
click node_analytics_api "https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/analytics.js"
click node_notifications "https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/Notifications.jsx"
click node_notifications_api "https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/notifications.js"
click node_api_client "https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/client.js"
click node_mock_data "https://github.com/rudrasalokhe/flowdesk/blob/main/src/mock/mockData.js"
click node_api_hook "https://github.com/rudrasalokhe/flowdesk/blob/main/src/hooks/useApi.js"

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_auth,node_login,node_user toneBlue
class node_lead_list,node_lead_create,node_lead_detail toneAmber
class node_task_page,node_import_page,node_csv_upload,node_import_progress,node_team,node_notifications,node_api_backend toneMint
class node_dashboard,node_analytics toneRose
class node_lead_api,node_task_api,node_import_api,node_users_api,node_analytics_api,node_notifications_api,node_api_client,node_mock_data,node_api_hook toneIndigo
```

## Components

### Application and session

- [Routes and guards](https://github.com/rudrasalokhe/flowdesk/blob/main/src/App.jsx): `src/App.jsx`
- [Session lifecycle](https://github.com/rudrasalokhe/flowdesk/blob/main/src/context/AuthContext.jsx): `src/context/AuthContext.jsx`
- [Sign-in](https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/Login.jsx): `src/pages/Login.jsx`

### Lead operations

- [Lead directory](https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/Leads.jsx): `src/pages/Leads.jsx`
- [Lead intake](https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/CreateLead.jsx): `src/pages/CreateLead.jsx`
- [Lead profile](https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/LeadDetails.jsx): `src/pages/LeadDetails.jsx`

### Sales operations

- [Task management](https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/Tasks.jsx): `src/pages/Tasks.jsx`
- [Bulk lead import](https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/ImportLeads.jsx): `src/pages/ImportLeads.jsx`
- [CSV upload UI](https://github.com/rudrasalokhe/flowdesk/blob/main/src/components/imports/CsvUploader.jsx): `src/components/imports/CsvUploader.jsx`
- [Import progress UI](https://github.com/rudrasalokhe/flowdesk/blob/main/src/components/imports/ImportProgress.jsx): `src/components/imports/ImportProgress.jsx`
- [Team capacity](https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/Team.jsx): `src/pages/Team.jsx`
- [Alerts center](https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/Notifications.jsx): `src/pages/Notifications.jsx`

### Revenue insights

- [RevOps overview](https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/Dashboard.jsx): `src/pages/Dashboard.jsx`
- [Analytics reports](https://github.com/rudrasalokhe/flowdesk/blob/main/src/pages/Analytics.jsx): `src/pages/Analytics.jsx`

### Client data services

- [Lead service](https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/leads.js): `src/api/leads.js`
- [Task service](https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/tasks.js): `src/api/tasks.js`
- [Import service](https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/imports.js): `src/api/imports.js`
- [User service](https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/users.js): `src/api/users.js`
- [Analytics service](https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/analytics.js): `src/api/analytics.js`
- [Notification service](https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/notifications.js): `src/api/notifications.js`
- [HTTP client](https://github.com/rudrasalokhe/flowdesk/blob/main/src/api/client.js): `src/api/client.js`
- [Preview fallback data](https://github.com/rudrasalokhe/flowdesk/blob/main/src/mock/mockData.js): `src/mock/mockData.js`
- [Request state hook](https://github.com/rudrasalokhe/flowdesk/blob/main/src/hooks/useApi.js): `src/hooks/useApi.js`

### Other components

- **Sales user**
- **FastAPI backend**

## Connections

- Sales user → Routes and guards: opens (evidence: `src/App.jsx`)
- Routes and guards → Session lifecycle: provides session (evidence: `src/App.jsx`)
- Routes and guards → Sign-in: routes to (evidence: `src/App.jsx`)
- Routes and guards → Lead directory: routes to (evidence: `src/App.jsx`)
- Routes and guards → Lead intake: routes to (evidence: `src/App.jsx`)
- Routes and guards → Lead profile: routes to (evidence: `src/App.jsx`)
- Routes and guards → Task management: routes to (evidence: `src/App.jsx`)
- Routes and guards → Bulk lead import: routes to (evidence: `src/App.jsx`)
- Routes and guards → Team capacity: routes to (evidence: `src/App.jsx`)
- Routes and guards → RevOps overview: routes to (evidence: `src/App.jsx`)
- Routes and guards → Analytics reports: routes to (evidence: `src/App.jsx`)
- Routes and guards → Alerts center: routes to (evidence: `src/App.jsx`)
- Sign-in → Session lifecycle: signs in (evidence: `src/pages/Login.jsx`)
- Session lifecycle → HTTP client: uses auth service (evidence: `src/context/AuthContext.jsx`)
- Lead directory → Lead service: requests leads (evidence: `src/pages/Leads.jsx`)
- Lead intake → Lead service: submits lead (evidence: `src/pages/CreateLead.jsx`)
- Lead profile → Lead service: requests lead data (evidence: `src/pages/LeadDetails.jsx`)
- Task management → Task service: manages tasks (evidence: `src/pages/Tasks.jsx`)
- Bulk lead import → Import service: requests import (evidence: `src/pages/ImportLeads.jsx`)
- CSV upload UI → Import service: uploads CSV (evidence: `src/components/imports/CsvUploader.jsx`)
- Import progress UI → Import service: polls status (evidence: `src/components/imports/ImportProgress.jsx`)
- Import progress UI → Request state hook: uses request state (evidence: `src/components/imports/ImportProgress.jsx`)
- Team capacity → User service: requests users (evidence: `src/pages/Team.jsx`)
- RevOps overview → Analytics service: requests metrics (evidence: `src/pages/Dashboard.jsx`)
- RevOps overview → Lead service: requests lead data (evidence: `src/pages/Dashboard.jsx`)
- Alerts center → Notification service: requests alerts
- Lead service → HTTP client: sends requests (evidence: `src/api/leads.js`)
- Task service → HTTP client: sends requests (evidence: `src/api/tasks.js`)
- Import service → HTTP client: sends requests (evidence: `src/api/imports.js`)
- User service → HTTP client: sends requests (evidence: `src/api/users.js`)
- Analytics service → HTTP client: sends requests (evidence: `src/api/analytics.js`)
- Notification service → HTTP client: sends requests (evidence: `src/api/notifications.js`)
- HTTP client → FastAPI backend: calls REST API (evidence: `README.md`)
- Lead service → Preview fallback data: falls back to (evidence: `src/api/leads.js`)
- Task service → Preview fallback data: falls back to (evidence: `src/api/tasks.js`)
- Import service → Preview fallback data: falls back to (evidence: `src/api/imports.js`)
- Analytics service → Preview fallback data: falls back to (evidence: `src/api/analytics.js`)
