# madhanaskeva/askeva-internal-crm architecture

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

- Interactive diagram: https://gitdiagram.com/madhanaskeva/askeva-internal-crm
- Repository: https://github.com/madhanaskeva/askeva-internal-crm

## Overview

Askeva CRM is a role-aware, browser-based CRM for managing projects and their operational work. Users enter through role-protected routes, open a workspace, inspect scoped CRM data, and perform actions that update datasets and UI state. Its product areas span project delivery, task workflows, client approvals, QA, finance, releases, team administration, and audit. The excerpts show routing, task-board behavior, client-portal actions, and local persistence; other capabilities are represented from the source tree, so their internal connections are not asserted.

Main entry points: [`frontend/src/routes/AppRoutes.jsx`](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/routes/AppRoutes.jsx) (Role-based routing), [`frontend/src/app/useCrm.js`](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/app/useCrm.js) (CRM application hooks), [`frontend/src/pages/Tasks/Tasks.jsx`](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/pages/Tasks/Tasks.jsx) (Task board), [`frontend/src/pages/ClientPortal/ClientPortal.jsx`](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/pages/ClientPortal/ClientPortal.jsx) (Client portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app["Application entry<br/>[App.jsx]"]
  node_routes["Role-based routing<br/>[AppRoutes.jsx]"]
  node_layout["Main layout<br/>[MainLayout.jsx]"]
end

subgraph group_delivery["Project delivery"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_projects["Project workspaces<br/>[ProjectDetail.jsx]"]
  node_tasks["Task board<br/>[Tasks.jsx]"]
  node_client["Client portal<br/>[ClientPortal.jsx]"]
  node_milestones["Deadlines and milestones"]
  node_changes["Change requests<br/>[ChangeRequests.jsx]"]
end

subgraph group_operations["Operations"]
  node_qa["QA workspace"]
  node_communications["Inbox and follow-ups"]
  node_finance["Finance and payroll"]
  node_releases["Release management"]
  node_team["Team and settings"]
  node_audit["Audit and reporting"]
end

subgraph group_core["Data and domain"]
  node_crmhook["CRM application hooks<br/>[useCrm.js]"]
  node_crmdata["Scoped CRM data<br/>[crmData.js]"]
  node_storageinit["Storage initialization<br/>[crmStorage.js]"]
  node_browserstore[("Browser storage<br/>[storage.js]")]
  node_taskrules["Task workflow rules<br/>[tasks.js]"]
  node_clientlogic["Client portal logic<br/>[clientPortal.js]"]
  node_datasets["CRM datasets<br/>[index.js]"]
  node_taskactions["Task actions<br/>[taskActions.js]"]
  node_ui["UI state<br/>[uiSlice.js]"]
end

node_user(("CRM user"))

node_user -->|"opens"| node_app
node_app -->|"renders"| node_routes
node_routes -->|"wraps routes"| node_layout
node_routes -->|"routes to"| node_dashboard
node_routes -->|"routes to"| node_projects
node_routes -->|"routes to"| node_tasks
node_routes -->|"routes to"| node_client
node_routes -->|"routes to"| node_changes
node_routes -->|"routes to"| node_finance
node_routes -->|"routes to"| node_releases
node_routes -->|"routes to"| node_team
node_routes -->|"routes to"| node_qa
node_routes -->|"routes to"| node_milestones
node_routes -.->|"routes to"| node_communications
node_routes -.->|"routes to"| node_audit
node_dashboard -->|"reads CRM data"| node_crmhook
node_tasks -->|"reads and acts"| node_crmhook
node_tasks -->|"checks transitions"| node_taskrules
node_tasks -->|"runs task action"| node_taskactions
node_client -->|"reads and acts"| node_crmhook
node_client -->|"builds portal view"| node_clientlogic
node_crmhook -->|"uses data hooks"| node_crmdata
node_crmhook -->|"dispatches UI state"| node_ui
node_crmdata -.->|"initializes storage"| node_storageinit
node_storageinit -->|"reads and writes"| node_browserstore
node_storageinit -->|"loads defaults"| node_datasets
node_taskrules -->|"uses workflow data"| node_datasets
node_clientlogic -->|"uses CRM data"| node_datasets

click node_app "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/App.jsx"
click node_routes "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/routes/AppRoutes.jsx"
click node_layout "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/components/layout/MainLayout.jsx"
click node_dashboard "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/pages/Dashboard/Dashboard.jsx"
click node_projects "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/pages/ProjectDetail/ProjectDetail.jsx"
click node_tasks "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/pages/Tasks/Tasks.jsx"
click node_client "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/pages/ClientPortal/ClientPortal.jsx"
click node_milestones "https://github.com/madhanaskeva/askeva-internal-crm/tree/main/frontend/src/pages/Deadlines"
click node_changes "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/pages/ChangeRequests/ChangeRequests.jsx"
click node_qa "https://github.com/madhanaskeva/askeva-internal-crm/tree/main/frontend/src/pages/QaWorkspace"
click node_communications "https://github.com/madhanaskeva/askeva-internal-crm/tree/main/frontend/src/pages/Inbox"
click node_finance "https://github.com/madhanaskeva/askeva-internal-crm/tree/main/frontend/src/pages/Finance"
click node_releases "https://github.com/madhanaskeva/askeva-internal-crm/tree/main/frontend/src/pages/Deploy"
click node_team "https://github.com/madhanaskeva/askeva-internal-crm/tree/main/frontend/src/pages/Team"
click node_audit "https://github.com/madhanaskeva/askeva-internal-crm/tree/main/frontend/src/pages/DailyAudit"
click node_crmhook "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/app/useCrm.js"
click node_crmdata "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/utils/storage/crmData.js"
click node_storageinit "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/utils/storage/crmStorage.js"
click node_browserstore "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/utils/storage/storage.js"
click node_taskrules "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/utils/domain/tasks.js"
click node_clientlogic "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/domain/clientPortal/clientPortal.js"
click node_datasets "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/data/index.js"
click node_taskactions "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/utils/actions/taskActions.js"
click node_ui "https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/redux/slices/uiSlice.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_routes,node_layout,node_user toneBlue
class node_dashboard,node_projects,node_tasks,node_client,node_milestones,node_changes toneAmber
class node_qa,node_communications,node_finance,node_releases,node_team,node_audit toneMint
class node_crmhook,node_crmdata,node_storageinit,node_browserstore,node_taskrules,node_clientlogic,node_datasets,node_taskactions,node_ui toneRose
```

## Components

### Application shell

- [Application entry](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Role-based routing](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/routes/AppRoutes.jsx): `frontend/src/routes/AppRoutes.jsx`
- [Main layout](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/components/layout/MainLayout.jsx): `frontend/src/components/layout/MainLayout.jsx`

### Project delivery

- [Dashboard](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/pages/Dashboard/Dashboard.jsx): `frontend/src/pages/Dashboard/Dashboard.jsx`
- [Project workspaces](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/pages/ProjectDetail/ProjectDetail.jsx): `frontend/src/pages/ProjectDetail/ProjectDetail.jsx`
- [Task board](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/pages/Tasks/Tasks.jsx): `frontend/src/pages/Tasks/Tasks.jsx`
- [Client portal](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/pages/ClientPortal/ClientPortal.jsx): `frontend/src/pages/ClientPortal/ClientPortal.jsx`
- [Deadlines and milestones](https://github.com/madhanaskeva/askeva-internal-crm/tree/main/frontend/src/pages/Deadlines): `frontend/src/pages/Deadlines`
- [Change requests](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/pages/ChangeRequests/ChangeRequests.jsx): `frontend/src/pages/ChangeRequests/ChangeRequests.jsx`

### Operations

- [QA workspace](https://github.com/madhanaskeva/askeva-internal-crm/tree/main/frontend/src/pages/QaWorkspace): `frontend/src/pages/QaWorkspace`
- [Inbox and follow-ups](https://github.com/madhanaskeva/askeva-internal-crm/tree/main/frontend/src/pages/Inbox): `frontend/src/pages/Inbox`
- [Finance and payroll](https://github.com/madhanaskeva/askeva-internal-crm/tree/main/frontend/src/pages/Finance): `frontend/src/pages/Finance`
- [Release management](https://github.com/madhanaskeva/askeva-internal-crm/tree/main/frontend/src/pages/Deploy): `frontend/src/pages/Deploy`
- [Team and settings](https://github.com/madhanaskeva/askeva-internal-crm/tree/main/frontend/src/pages/Team): `frontend/src/pages/Team`
- [Audit and reporting](https://github.com/madhanaskeva/askeva-internal-crm/tree/main/frontend/src/pages/DailyAudit): `frontend/src/pages/DailyAudit`

### Data and domain

- [CRM application hooks](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/app/useCrm.js): `frontend/src/app/useCrm.js`
- [Scoped CRM data](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/utils/storage/crmData.js): `frontend/src/utils/storage/crmData.js`
- [Storage initialization](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/utils/storage/crmStorage.js): `frontend/src/utils/storage/crmStorage.js`
- [Browser storage](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/utils/storage/storage.js): `frontend/src/utils/storage/storage.js`
- [Task workflow rules](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/utils/domain/tasks.js): `frontend/src/utils/domain/tasks.js`
- [Client portal logic](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/domain/clientPortal/clientPortal.js): `frontend/src/domain/clientPortal/clientPortal.js`
- [CRM datasets](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/data/index.js): `frontend/src/data/index.js`
- [Task actions](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/utils/actions/taskActions.js): `frontend/src/utils/actions/taskActions.js`
- [UI state](https://github.com/madhanaskeva/askeva-internal-crm/blob/main/frontend/src/redux/slices/uiSlice.js): `frontend/src/redux/slices/uiSlice.js`

### Other components

- **CRM user**

## Connections

- CRM user → Application entry: opens (evidence: `frontend/src/App.jsx`)
- Application entry → Role-based routing: renders (evidence: `frontend/src/App.jsx`)
- Role-based routing → Main layout: wraps routes (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routing → Dashboard: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routing → Project workspaces: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routing → Task board: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routing → Client portal: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routing → Change requests: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routing → Finance and payroll: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routing → Release management: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routing → Team and settings: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routing → QA workspace: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routing → Deadlines and milestones: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routing → Inbox and follow-ups: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Role-based routing → Audit and reporting: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Dashboard → CRM application hooks: reads CRM data
- Task board → CRM application hooks: reads and acts (evidence: `frontend/src/pages/Tasks/Tasks.jsx`)
- Task board → Task workflow rules: checks transitions (evidence: `frontend/src/pages/Tasks/Tasks.jsx`)
- Task board → Task actions: runs task action (evidence: `frontend/src/pages/Tasks/Tasks.jsx`)
- Client portal → CRM application hooks: reads and acts (evidence: `frontend/src/pages/ClientPortal/ClientPortal.jsx`)
- Client portal → Client portal logic: builds portal view (evidence: `frontend/src/pages/ClientPortal/ClientPortal.jsx`)
- CRM application hooks → Scoped CRM data: uses data hooks (evidence: `frontend/src/app/useCrm.js`)
- CRM application hooks → UI state: dispatches UI state (evidence: `frontend/src/app/useCrm.js`)
- Scoped CRM data → Storage initialization: initializes storage
- Storage initialization → Browser storage: reads and writes (evidence: `frontend/src/utils/storage/crmStorage.js`)
- Storage initialization → CRM datasets: loads defaults (evidence: `frontend/src/utils/storage/crmStorage.js`)
- Task workflow rules → CRM datasets: uses workflow data (evidence: `frontend/src/utils/domain/tasks.js`)
- Client portal logic → CRM datasets: uses CRM data (evidence: `frontend/src/domain/clientPortal/clientPortal.js`)
