# ananyaaa171/retailmax-crm architecture

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

- Interactive diagram: https://gitdiagram.com/ananyaaa171/retailmax-crm
- Repository: https://github.com/ananyaaa171/retailmax-crm

## Overview

Retailmax is a CRM and sales-management application: users work with leads, customers, deals, campaigns, tasks, notifications, and user accounts, with dashboards and reports summarizing activity. The frontend is a React app; its shown API helper sends requests to a local backend, whose Spring controllers and services organize the server-side product. Lead scoring and conversion are explicit domain stages. Source excerpts show only parts of this system, so unverified controller-to-service links are dashed; no README capability list was provided.

Main entry points: [`backend/retailmax-backend/src/main/java/retailmax_backend/repository`](https://github.com/ananyaaa171/retailmax-crm/tree/main/backend/retailmax-backend/src/main/java/retailmax_backend/repository) (Data repositories), [`frontend/src/App.tsx`](https://github.com/ananyaaa171/retailmax-crm/blob/main/frontend/src/App.tsx) (CRM interface), [`frontend/src/main.tsx`](https://github.com/ananyaaa171/retailmax-crm/blob/main/frontend/src/main.tsx) (Frontend entry), [`frontend/src/components/AuthPage.tsx`](https://github.com/ananyaaa171/retailmax-crm/blob/main/frontend/src/components/AuthPage.tsx) (Sign-in page)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend"]
  node_app["CRM interface<br/>[App.tsx]"]
  node_authpage["Sign-in page<br/>[AuthPage.tsx]"]
  node_frontendboot["Frontend entry<br/>[main.tsx]"]
end

subgraph group_api["API layer"]
  node_authapi["Authentication API"]
  node_campaignapi["Campaign API"]
  node_leadapi["Lead API"]
  node_notificationapi["Notification API"]
  node_taskapi["Task API"]
  node_userapi["User account API"]
  node_customerapi["Customer API"]
  node_dealapi["Deal API"]
  node_dashboardapi["Dashboard API"]
end

subgraph group_domain["CRM services"]
  node_authservice["Authentication"]
  node_campaignservice["Campaign management"]
  node_leadservice["Lead scoring<br/>[LeadService.java]"]
  node_customerservice["Customer management"]
  node_dealservice["Deal management<br/>[DealService.java]"]
  node_taskservice["Task management<br/>[TaskService.java]"]
  node_notificationservice["Notifications"]
  node_userservice["User accounts"]
  node_dashboardservice["Dashboard reports"]
end

subgraph group_persistence["Persistence"]
  node_entities["CRM records"]
  node_repositories[("Data repositories")]
end

node_user(("CRM user"))

node_user -->|"uses"| node_app
node_frontendboot -->|"renders"| node_app
node_frontendboot -->|"renders"| node_authpage
node_app -->|"requests leads"| node_leadapi
node_app -->|"requests users"| node_userapi
node_authpage -.->|"submits credentials"| node_authapi
node_leadapi -.->|"delegates"| node_leadservice
node_campaignapi -.->|"delegates"| node_campaignservice
node_notificationapi -.->|"delegates"| node_notificationservice
node_taskapi -.->|"delegates"| node_taskservice
node_userapi -.->|"delegates"| node_userservice
node_customerapi -.->|"delegates"| node_customerservice
node_dealapi -.->|"delegates"| node_dealservice
node_dashboardapi -.->|"delegates"| node_dashboardservice
node_authservice -.->|"queries"| node_repositories
node_campaignservice -.->|"reads and writes"| node_repositories
node_leadservice -.->|"scores and converts"| node_repositories
node_customerservice -.->|"reads and writes"| node_repositories
node_dealservice -.->|"reads and writes"| node_repositories
node_taskservice -.->|"reads and writes"| node_repositories
node_notificationservice -.->|"reads and writes"| node_repositories
node_userservice -.->|"reads and writes"| node_repositories
node_dashboardservice -->|"aggregates data"| node_repositories

click node_app "https://github.com/ananyaaa171/retailmax-crm/blob/main/frontend/src/App.tsx"
click node_authpage "https://github.com/ananyaaa171/retailmax-crm/blob/main/frontend/src/components/AuthPage.tsx"
click node_frontendboot "https://github.com/ananyaaa171/retailmax-crm/blob/main/frontend/src/main.tsx"
click node_authapi "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller/AuthController.java"
click node_campaignapi "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller/CampaignController.java"
click node_leadapi "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller/LeadController.java"
click node_notificationapi "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller/NotificationController.java"
click node_taskapi "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller/TaskController.java"
click node_userapi "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller/UserAccountController.java"
click node_customerapi "https://github.com/ananyaaa171/retailmax-crm/tree/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller"
click node_dealapi "https://github.com/ananyaaa171/retailmax-crm/tree/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller"
click node_dashboardapi "https://github.com/ananyaaa171/retailmax-crm/tree/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller"
click node_authservice "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller/AuthController.java"
click node_campaignservice "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/CampaignService.java"
click node_leadservice "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/LeadService.java"
click node_customerservice "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/CustomerService.java"
click node_dealservice "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/DealService.java"
click node_taskservice "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/TaskService.java"
click node_notificationservice "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/NotificationService.java"
click node_userservice "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/UserAccountService.java"
click node_dashboardservice "https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/DashboardService.java"
click node_entities "https://github.com/ananyaaa171/retailmax-crm/tree/main/backend/retailmax-backend/src/main/java/retailmax_backend/entity"
click node_repositories "https://github.com/ananyaaa171/retailmax-crm/tree/main/backend/retailmax-backend/src/main/java/retailmax_backend/repository"

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_authpage,node_frontendboot,node_user toneBlue
class node_authapi,node_campaignapi,node_leadapi,node_notificationapi,node_taskapi,node_userapi,node_customerapi,node_dealapi,node_dashboardapi toneAmber
class node_authservice,node_campaignservice,node_leadservice,node_customerservice,node_dealservice,node_taskservice,node_notificationservice,node_userservice,node_dashboardservice toneMint
class node_entities,node_repositories toneRose
```

## Components

### Frontend

- [CRM interface](https://github.com/ananyaaa171/retailmax-crm/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Sign-in page](https://github.com/ananyaaa171/retailmax-crm/blob/main/frontend/src/components/AuthPage.tsx): `frontend/src/components/AuthPage.tsx`
- [Frontend entry](https://github.com/ananyaaa171/retailmax-crm/blob/main/frontend/src/main.tsx): `frontend/src/main.tsx`

### API layer

- [Authentication API](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller/AuthController.java): `backend/retailmax-backend/src/main/java/retailmax_backend/controller/AuthController.java`
- [Campaign API](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller/CampaignController.java): `backend/retailmax-backend/src/main/java/retailmax_backend/controller/CampaignController.java`
- [Lead API](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller/LeadController.java): `backend/retailmax-backend/src/main/java/retailmax_backend/controller/LeadController.java`
- [Notification API](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller/NotificationController.java): `backend/retailmax-backend/src/main/java/retailmax_backend/controller/NotificationController.java`
- [Task API](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller/TaskController.java): `backend/retailmax-backend/src/main/java/retailmax_backend/controller/TaskController.java`
- [User account API](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller/UserAccountController.java): `backend/retailmax-backend/src/main/java/retailmax_backend/controller/UserAccountController.java`
- [Customer API](https://github.com/ananyaaa171/retailmax-crm/tree/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller): `backend/retailmax-backend/src/main/java/retailmax_backend/controller`
- [Deal API](https://github.com/ananyaaa171/retailmax-crm/tree/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller): `backend/retailmax-backend/src/main/java/retailmax_backend/controller`
- [Dashboard API](https://github.com/ananyaaa171/retailmax-crm/tree/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller): `backend/retailmax-backend/src/main/java/retailmax_backend/controller`

### CRM services

- [Authentication](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/controller/AuthController.java): `backend/retailmax-backend/src/main/java/retailmax_backend/controller/AuthController.java`
- [Campaign management](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/CampaignService.java): `backend/retailmax-backend/src/main/java/retailmax_backend/service/CampaignService.java`
- [Lead scoring](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/LeadService.java): `backend/retailmax-backend/src/main/java/retailmax_backend/service/LeadService.java`
- [Customer management](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/CustomerService.java): `backend/retailmax-backend/src/main/java/retailmax_backend/service/CustomerService.java`
- [Deal management](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/DealService.java): `backend/retailmax-backend/src/main/java/retailmax_backend/service/DealService.java`
- [Task management](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/TaskService.java): `backend/retailmax-backend/src/main/java/retailmax_backend/service/TaskService.java`
- [Notifications](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/NotificationService.java): `backend/retailmax-backend/src/main/java/retailmax_backend/service/NotificationService.java`
- [User accounts](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/UserAccountService.java): `backend/retailmax-backend/src/main/java/retailmax_backend/service/UserAccountService.java`
- [Dashboard reports](https://github.com/ananyaaa171/retailmax-crm/blob/main/backend/retailmax-backend/src/main/java/retailmax_backend/service/DashboardService.java): `backend/retailmax-backend/src/main/java/retailmax_backend/service/DashboardService.java`

### Persistence

- [CRM records](https://github.com/ananyaaa171/retailmax-crm/tree/main/backend/retailmax-backend/src/main/java/retailmax_backend/entity): `backend/retailmax-backend/src/main/java/retailmax_backend/entity`
- [Data repositories](https://github.com/ananyaaa171/retailmax-crm/tree/main/backend/retailmax-backend/src/main/java/retailmax_backend/repository): `backend/retailmax-backend/src/main/java/retailmax_backend/repository`

### Other components

- **CRM user**

## Connections

- CRM user → CRM interface: uses
- Frontend entry → CRM interface: renders (evidence: `frontend/src/main.tsx`)
- Frontend entry → Sign-in page: renders (evidence: `frontend/src/main.tsx`)
- CRM interface → Lead API: requests leads (evidence: `frontend/src/App.tsx`)
- CRM interface → User account API: requests users (evidence: `frontend/src/App.tsx`)
- Sign-in page → Authentication API: submits credentials
- Lead API → Lead scoring: delegates (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/controller/LeadController.java`)
- Campaign API → Campaign management: delegates (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/controller/CampaignController.java`)
- Notification API → Notifications: delegates (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/controller/NotificationController.java`)
- Task API → Task management: delegates (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/controller/TaskController.java`)
- User account API → User accounts: delegates (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/controller/UserAccountController.java`)
- Customer API → Customer management: delegates (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/controller/CustomerController.java`)
- Deal API → Deal management: delegates (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/controller/DealController.java`)
- Dashboard API → Dashboard reports: delegates (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/controller/DashboardController.java`)
- Authentication → Data repositories: queries (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/controller/AuthController.java`)
- Campaign management → Data repositories: reads and writes (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/service/CampaignService.java`)
- Lead scoring → Data repositories: scores and converts (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/service/LeadService.java`)
- Customer management → Data repositories: reads and writes (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/service/CustomerService.java`)
- Deal management → Data repositories: reads and writes (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/service/DealService.java`)
- Task management → Data repositories: reads and writes (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/service/TaskService.java`)
- Notifications → Data repositories: reads and writes (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/service/NotificationService.java`)
- User accounts → Data repositories: reads and writes (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/service/UserAccountService.java`)
- Dashboard reports → Data repositories: aggregates data (evidence: `backend/retailmax-backend/src/main/java/retailmax_backend/service/DashboardService.java`)
