# blueantfinserv/blueant-crm-erp_frontend architecture

> Architecture diagram of the GitHub repository blueantfinserv/blueant-crm-erp_frontend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/blueantfinserv/blueant-crm-erp_frontend
- Repository: https://github.com/blueantfinserv/blueant-crm-erp_frontend

## Overview

BlueAnt CRM ERP is a cross-platform, role-based CRM frontend. Users authenticate, then enter role-specific workspaces: Sales Persons manage assigned leads and update existing meetings; Sales Coordinators review and verify meetings, manage assignments and workload, and export operational data. The documented meeting workflow submits an update for the current meeting; backend follow-up creation is outside this repository. The graph shows the app/authentication layers and the main lead, meeting, and coordinator stages. Some screen implementations are unsampled, so their internal relationships are omitted.

Main entry points: [`App.tsx`](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/App.tsx) (Role App Routing), [`src/screens/SalesCoordinatorScreen.tsx`](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/screens/SalesCoordinatorScreen.tsx) (Coordinator Workspace), [`src/modules/salesManager/tasks/SalesManagerTasksScreen.tsx`](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/modules/salesManager/tasks/SalesManagerTasksScreen.tsx) (Sales Task List), [`src/services/MeetingService.ts`](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/services/MeetingService.ts) (Meeting Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application Shell"]
  node_app["Role App Routing<br/>[App.tsx]"]
  node_dashboard["Role Dashboards"]
end

subgraph group_identity["Identity"]
  node_authui["Login Screens<br/>[LoginScreen.tsx]"]
  node_authprovider["Auth Provider<br/>[AuthProvider.tsx]"]
  node_authservice["Auth Service<br/>[AuthService.ts]"]
  node_authapi["Auth API<br/>[auth.ts]"]
  node_storage["Secure Storage"]
end

subgraph group_sales["Sales Workflows"]
  node_leads["Lead Workspace<br/>[LeadScreen.tsx]"]
  node_workflow["Meeting Update Form"]
  node_meetings["Meeting Service<br/>[MeetingService.ts]"]
  node_meetingapi["Meeting API<br/>[meeting.ts]"]
  node_tasks["Sales Task List"]
  node_leadsearch["Lead Search Service"]
  node_leadservice["Lead Service<br/>[LeadService.ts]"]
  node_leadapi["Lead API<br/>[lead.ts]"]
  node_searchapi["Lead Search API<br/>[leadSearch.ts]"]
end

subgraph group_coord["Coordinator Operations"]
  node_coordinator["Coordinator Workspace"]
  node_verification["Verification Form Data"]
end

node_user(("CRM User"))
node_backend{{"CRM Backend"}}

node_user -->|"opens"| node_app
node_app -->|"routes to"| node_authui
node_app -->|"wraps"| node_authprovider
node_authprovider -->|"uses"| node_authservice
node_authservice -->|"calls"| node_authapi
node_authservice -->|"persists session"| node_storage
node_app -->|"routes by role"| node_dashboard
node_app -->|"routes to"| node_coordinator
node_app -->|"routes to"| node_leads
node_app -->|"routes to"| node_tasks
node_tasks -->|"loads leads"| node_leadsearch
node_tasks -->|"uses"| node_leadservice
node_tasks -->|"loads meetings"| node_meetings
node_leadsearch -->|"searches"| node_searchapi
node_leadservice -->|"calls"| node_leadapi
node_meetings -->|"calls"| node_meetingapi
node_coordinator -->|"uses"| node_leadservice
node_coordinator -->|"uses"| node_leadsearch
node_coordinator -->|"uses"| node_meetings
node_coordinator -->|"uses form data"| node_verification
node_workflow -.->|"submits update"| node_meetings
node_meetingapi -.->|"workflow update"| node_backend

click node_app "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/App.tsx"
click node_authui "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/screens/auth/LoginScreen.tsx"
click node_authprovider "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/context/AuthProvider.tsx"
click node_authservice "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/services/AuthService.ts"
click node_authapi "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/api/auth.ts"
click node_storage "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/services/SecureStorageService.ts"
click node_dashboard "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/screens/DashboardScreen.tsx"
click node_leads "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/modules/leads/LeadScreen.tsx"
click node_workflow "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/modules/salesManager/forms/LeadWorkflowForm.jsx"
click node_meetings "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/services/MeetingService.ts"
click node_meetingapi "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/api/meeting.ts"
click node_coordinator "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/screens/SalesCoordinatorScreen.tsx"
click node_tasks "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/modules/salesManager/tasks/SalesManagerTasksScreen.tsx"
click node_leadsearch "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/services/LeadSearchService.ts"
click node_leadservice "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/services/LeadService.ts"
click node_leadapi "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/api/lead.ts"
click node_searchapi "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/api/leadSearch.ts"
click node_verification "https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/screens/meetingVerificationForm.ts"

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_dashboard,node_user toneBlue
class node_authui,node_authprovider,node_authservice,node_authapi,node_storage toneAmber
class node_leads,node_workflow,node_meetings,node_meetingapi,node_tasks,node_leadsearch,node_leadservice,node_leadapi,node_searchapi toneMint
class node_coordinator,node_verification toneRose
class node_backend toneIndigo
```

## Components

### Application Shell

- [Role App Routing](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/App.tsx): `App.tsx`
- [Role Dashboards](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/screens/DashboardScreen.tsx): `src/screens/DashboardScreen.tsx`

### Identity

- [Login Screens](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/screens/auth/LoginScreen.tsx): `src/screens/auth/LoginScreen.tsx`
- [Auth Provider](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/context/AuthProvider.tsx): `src/context/AuthProvider.tsx`
- [Auth Service](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/services/AuthService.ts): `src/services/AuthService.ts`
- [Auth API](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/api/auth.ts): `src/api/auth.ts`
- [Secure Storage](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/services/SecureStorageService.ts): `src/services/SecureStorageService.ts`

### Sales Workflows

- [Lead Workspace](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/modules/leads/LeadScreen.tsx): `src/modules/leads/LeadScreen.tsx`
- [Meeting Update Form](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/modules/salesManager/forms/LeadWorkflowForm.jsx): `src/modules/salesManager/forms/LeadWorkflowForm.jsx`
- [Meeting Service](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/services/MeetingService.ts): `src/services/MeetingService.ts`
- [Meeting API](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/api/meeting.ts): `src/api/meeting.ts`
- [Sales Task List](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/modules/salesManager/tasks/SalesManagerTasksScreen.tsx): `src/modules/salesManager/tasks/SalesManagerTasksScreen.tsx`
- [Lead Search Service](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/services/LeadSearchService.ts): `src/services/LeadSearchService.ts`
- [Lead Service](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/services/LeadService.ts): `src/services/LeadService.ts`
- [Lead API](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/api/lead.ts): `src/api/lead.ts`
- [Lead Search API](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/api/leadSearch.ts): `src/api/leadSearch.ts`

### Coordinator Operations

- [Coordinator Workspace](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/screens/SalesCoordinatorScreen.tsx): `src/screens/SalesCoordinatorScreen.tsx`
- [Verification Form Data](https://github.com/blueantfinserv/blueant-crm-erp_frontend/blob/main/src/screens/meetingVerificationForm.ts): `src/screens/meetingVerificationForm.ts`

### Other components

- **CRM User**
- **CRM Backend**

## Connections

- CRM User → Role App Routing: opens (evidence: `App.tsx`)
- Role App Routing → Login Screens: routes to (evidence: `App.tsx`)
- Role App Routing → Auth Provider: wraps (evidence: `App.tsx`)
- Auth Provider → Auth Service: uses (evidence: `src/context/AuthProvider.tsx`)
- Auth Service → Auth API: calls (evidence: `src/services/AuthService.ts`)
- Auth Service → Secure Storage: persists session (evidence: `src/services/AuthService.ts`)
- Role App Routing → Role Dashboards: routes by role (evidence: `App.tsx`)
- Role App Routing → Coordinator Workspace: routes to (evidence: `App.tsx`)
- Role App Routing → Lead Workspace: routes to (evidence: `App.tsx`)
- Role App Routing → Sales Task List: routes to (evidence: `App.tsx`)
- Sales Task List → Lead Search Service: loads leads (evidence: `src/modules/salesManager/tasks/SalesManagerTasksScreen.tsx`)
- Sales Task List → Lead Service: uses (evidence: `src/modules/salesManager/tasks/SalesManagerTasksScreen.tsx`)
- Sales Task List → Meeting Service: loads meetings (evidence: `src/modules/salesManager/tasks/SalesManagerTasksScreen.tsx`)
- Lead Search Service → Lead Search API: searches (evidence: `src/services/LeadSearchService.ts`)
- Lead Service → Lead API: calls (evidence: `src/services/LeadService.ts`)
- Meeting Service → Meeting API: calls (evidence: `src/services/MeetingService.ts`)
- Coordinator Workspace → Lead Service: uses (evidence: `src/screens/SalesCoordinatorScreen.tsx`)
- Coordinator Workspace → Lead Search Service: uses (evidence: `src/screens/SalesCoordinatorScreen.tsx`)
- Coordinator Workspace → Meeting Service: uses (evidence: `src/screens/SalesCoordinatorScreen.tsx`)
- Coordinator Workspace → Verification Form Data: uses form data (evidence: `src/screens/SalesCoordinatorScreen.tsx`)
- Meeting Update Form → Meeting Service: submits update
- Meeting API → CRM Backend: workflow update (evidence: `README.md`)
