# vishnu-manalan/branch_manager architecture

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

- Interactive diagram: https://gitdiagram.com/vishnu-manalan/branch_manager
- Repository: https://github.com/vishnu-manalan/branch_manager

## Overview

Branch Manager is a role-scoped branch operations system: users sign in, then manage branch staff and clients, record employee-client sales, and view role-specific dashboards or manager reports. The React application routes users to role-specific screens and calls a Spring REST API; backend services apply business rules and data scoping over JPA repositories. The README documents the broader supplier, employee, and reporting capabilities, but their implementation details were not sampled, so those links are shown only where the documentation supports them.

Main entry points: [`frontend/src/services/endpoints.js`](https://github.com/vishnu-manalan/branch_manager/blob/main/frontend/src/services/endpoints.js) (API endpoints), [`frontend/src/App.jsx`](https://github.com/vishnu-manalan/branch_manager/blob/main/frontend/src/App.jsx) (Role routes), [`backend/src/main/java/com/company/branchmanager/repository/WorksWithRepository.java`](https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/repository/WorksWithRepository.java) (Employee-client sales links), [`backend/src/main/java/com/company/branchmanager/service/ClientService.java`](https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/service/ClientService.java) (Client assignment and scope)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Role-based web app"]
  node_app_routes["Role routes<br/>[App.jsx]"]
  node_auth_state["Auth state<br/>[AuthContext.jsx]"]
  node_login_screen["Login screen<br/>[Login.jsx]"]
  node_admin_pages["Admin operations"]
  node_manager_pages["Manager dashboard and reports"]
  node_employee_pages["Employee sales and clients"]
  node_api_client["API endpoints<br/>[endpoints.js]"]
end

subgraph group_operations["Branch operations API"]
  node_auth_api["Authentication<br/>[AuthService.java]"]
  node_branch_api["Branch management"]
  node_client_api["Client management"]
  node_employee_api["Employee management"]
  node_supplier_api["Supplier management"]
  node_sales_api["Sales tracking"]
  node_dashboard_api["Role dashboards"]
  node_report_api["Sales reports"]
  node_branch_service["Branch rules<br/>[BranchService.java]"]
  node_client_service["Client assignment and scope<br/>[ClientService.java]"]
end

subgraph group_data_security["Persistence and security"]
  node_security["JWT and access control"]
  node_repositories["JPA repositories"]
  node_sales_store[("Employee-client sales links")]
  node_database[("H2 or MySQL")]
end

node_user(("Admin, manager, employee"))

node_user -->|"signs in"| node_login_screen
node_login_screen -.->|"submits credentials"| node_auth_state
node_auth_state -->|"calls login"| node_api_client
node_app_routes -->|"checks session"| node_auth_state
node_app_routes -->|"routes admin"| node_admin_pages
node_app_routes -->|"routes manager"| node_manager_pages
node_app_routes -->|"routes employee"| node_employee_pages
node_admin_pages -->|"calls client API"| node_api_client
node_manager_pages -->|"loads dashboard"| node_api_client
node_employee_pages -->|"uses endpoints"| node_api_client
node_api_client -->|"REST requests"| node_auth_api
node_api_client -->|"REST requests"| node_branch_api
node_api_client -->|"REST requests"| node_client_api
node_api_client -->|"REST requests"| node_employee_api
node_api_client -->|"REST requests"| node_supplier_api
node_api_client -->|"REST requests"| node_sales_api
node_api_client -->|"REST requests"| node_dashboard_api
node_api_client -->|"REST requests"| node_report_api
node_branch_api -->|"delegates"| node_branch_service
node_client_api -->|"delegates"| node_client_service
node_branch_service -->|"reads and writes"| node_repositories
node_client_service -->|"reads and writes"| node_repositories
node_client_service -->|"checks assignments"| node_sales_store
node_sales_api -.->|"records and queries"| node_sales_store
node_dashboard_api -.->|"aggregates totals"| node_sales_store
node_report_api -.->|"groups sales"| node_sales_store
node_auth_api -->|"issues JWT"| node_security
node_repositories -->|"persists entities"| node_database

click node_app_routes "https://github.com/vishnu-manalan/branch_manager/blob/main/frontend/src/App.jsx"
click node_auth_state "https://github.com/vishnu-manalan/branch_manager/blob/main/frontend/src/context/AuthContext.jsx"
click node_login_screen "https://github.com/vishnu-manalan/branch_manager/blob/main/frontend/src/pages/Login.jsx"
click node_admin_pages "https://github.com/vishnu-manalan/branch_manager/tree/main/frontend/src/pages/admin"
click node_manager_pages "https://github.com/vishnu-manalan/branch_manager/tree/main/frontend/src/pages/manager"
click node_employee_pages "https://github.com/vishnu-manalan/branch_manager/tree/main/frontend/src/pages/employee"
click node_api_client "https://github.com/vishnu-manalan/branch_manager/blob/main/frontend/src/services/endpoints.js"
click node_auth_api "https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/service/AuthService.java"
click node_branch_api "https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/controller/BranchController.java"
click node_client_api "https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/controller/ClientController.java"
click node_employee_api "https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/controller/EmployeeController.java"
click node_supplier_api "https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/controller/SupplierController.java"
click node_sales_api "https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/controller/SalesController.java"
click node_dashboard_api "https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/controller/DashboardController.java"
click node_report_api "https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/controller/ReportController.java"
click node_branch_service "https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/service/BranchService.java"
click node_client_service "https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/service/ClientService.java"
click node_security "https://github.com/vishnu-manalan/branch_manager/tree/main/backend/src/main/java/com/company/branchmanager/security"
click node_repositories "https://github.com/vishnu-manalan/branch_manager/tree/main/backend/src/main/java/com/company/branchmanager/repository"
click node_sales_store "https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/repository/WorksWithRepository.java"

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_routes,node_auth_state,node_login_screen,node_admin_pages,node_manager_pages,node_employee_pages,node_api_client toneBlue
class node_auth_api,node_branch_api,node_client_api,node_employee_api,node_supplier_api,node_sales_api,node_dashboard_api,node_report_api,node_branch_service,node_client_service toneAmber
class node_security,node_repositories,node_sales_store,node_database toneMint
class node_user toneIndigo
```

## Components

### Role-based web app

- [Role routes](https://github.com/vishnu-manalan/branch_manager/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Auth state](https://github.com/vishnu-manalan/branch_manager/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Login screen](https://github.com/vishnu-manalan/branch_manager/blob/main/frontend/src/pages/Login.jsx): `frontend/src/pages/Login.jsx`
- [Admin operations](https://github.com/vishnu-manalan/branch_manager/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`
- [Manager dashboard and reports](https://github.com/vishnu-manalan/branch_manager/tree/main/frontend/src/pages/manager): `frontend/src/pages/manager`
- [Employee sales and clients](https://github.com/vishnu-manalan/branch_manager/tree/main/frontend/src/pages/employee): `frontend/src/pages/employee`
- [API endpoints](https://github.com/vishnu-manalan/branch_manager/blob/main/frontend/src/services/endpoints.js): `frontend/src/services/endpoints.js`

### Branch operations API

- [Authentication](https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/service/AuthService.java): `backend/src/main/java/com/company/branchmanager/service/AuthService.java`
- [Branch management](https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/controller/BranchController.java): `backend/src/main/java/com/company/branchmanager/controller/BranchController.java`
- [Client management](https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/controller/ClientController.java): `backend/src/main/java/com/company/branchmanager/controller/ClientController.java`
- [Employee management](https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/controller/EmployeeController.java): `backend/src/main/java/com/company/branchmanager/controller/EmployeeController.java`
- [Supplier management](https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/controller/SupplierController.java): `backend/src/main/java/com/company/branchmanager/controller/SupplierController.java`
- [Sales tracking](https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/controller/SalesController.java): `backend/src/main/java/com/company/branchmanager/controller/SalesController.java`
- [Role dashboards](https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/controller/DashboardController.java): `backend/src/main/java/com/company/branchmanager/controller/DashboardController.java`
- [Sales reports](https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/controller/ReportController.java): `backend/src/main/java/com/company/branchmanager/controller/ReportController.java`
- [Branch rules](https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/service/BranchService.java): `backend/src/main/java/com/company/branchmanager/service/BranchService.java`
- [Client assignment and scope](https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/service/ClientService.java): `backend/src/main/java/com/company/branchmanager/service/ClientService.java`

### Persistence and security

- [JWT and access control](https://github.com/vishnu-manalan/branch_manager/tree/main/backend/src/main/java/com/company/branchmanager/security): `backend/src/main/java/com/company/branchmanager/security`
- [JPA repositories](https://github.com/vishnu-manalan/branch_manager/tree/main/backend/src/main/java/com/company/branchmanager/repository): `backend/src/main/java/com/company/branchmanager/repository`
- [Employee-client sales links](https://github.com/vishnu-manalan/branch_manager/blob/main/backend/src/main/java/com/company/branchmanager/repository/WorksWithRepository.java): `backend/src/main/java/com/company/branchmanager/repository/WorksWithRepository.java`
- **H2 or MySQL**

### Other components

- **Admin, manager, employee**

## Connections

- Admin, manager, employee → Login screen: signs in (evidence: `README.md`)
- Login screen → Auth state: submits credentials (evidence: `frontend/src/pages/Login.jsx`)
- Auth state → API endpoints: calls login (evidence: `frontend/src/context/AuthContext.jsx`)
- Role routes → Auth state: checks session (evidence: `frontend/src/App.jsx`)
- Role routes → Admin operations: routes admin (evidence: `frontend/src/App.jsx`)
- Role routes → Manager dashboard and reports: routes manager (evidence: `frontend/src/App.jsx`)
- Role routes → Employee sales and clients: routes employee (evidence: `frontend/src/App.jsx`)
- Admin operations → API endpoints: calls client API (evidence: `frontend/src/pages/admin/Clients.jsx`)
- Manager dashboard and reports → API endpoints: loads dashboard (evidence: `frontend/src/pages/manager/ManagerDashboard.jsx`)
- Employee sales and clients → API endpoints: uses endpoints (evidence: `frontend/src/services/endpoints.js`)
- API endpoints → Authentication: REST requests (evidence: `README.md`)
- API endpoints → Branch management: REST requests (evidence: `README.md`)
- API endpoints → Client management: REST requests (evidence: `README.md`)
- API endpoints → Employee management: REST requests (evidence: `README.md`)
- API endpoints → Supplier management: REST requests (evidence: `README.md`)
- API endpoints → Sales tracking: REST requests (evidence: `README.md`)
- API endpoints → Role dashboards: REST requests (evidence: `README.md`)
- API endpoints → Sales reports: REST requests (evidence: `README.md`)
- Branch management → Branch rules: delegates (evidence: `backend/src/main/java/com/company/branchmanager/controller/BranchController.java`)
- Client management → Client assignment and scope: delegates (evidence: `backend/src/main/java/com/company/branchmanager/controller/ClientController.java`)
- Branch rules → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/company/branchmanager/service/BranchService.java`)
- Client assignment and scope → JPA repositories: reads and writes (evidence: `backend/src/main/java/com/company/branchmanager/service/ClientService.java`)
- Client assignment and scope → Employee-client sales links: checks assignments (evidence: `backend/src/main/java/com/company/branchmanager/service/ClientService.java`)
- Sales tracking → Employee-client sales links: records and queries
- Role dashboards → Employee-client sales links: aggregates totals
- Sales reports → Employee-client sales links: groups sales
- Authentication → JWT and access control: issues JWT (evidence: `backend/src/main/java/com/company/branchmanager/service/AuthService.java`)
- JPA repositories → H2 or MySQL: persists entities (evidence: `README.md`)
