# vinayyx/git-plexigenius architecture

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

- Interactive diagram: https://gitdiagram.com/vinayyx/git-plexigenius
- Repository: https://github.com/vinayyx/git-plexigenius

## Overview

This is a CRM-style employee and lead management application with login and session handling. Users enter through the frontend login, then navigate a protected dashboard to view and manage employees and leads; backend routes dispatch requests to controllers, which persist records through models. Lead creation and updates also accept images through upload middleware. The supplied excerpts show backend routing and controller-to-model calls, but do not establish the frontend’s authentication or API-client wiring to those routes, so those connections are omitted.

Main entry points: [`Frontend/src/App.jsx`](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/App.jsx) (Route shell), [`Frontend/src/Pages/Leads.jsx`](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Pages/Leads.jsx) (Lead page), [`Frontend/src/Pages/Employee.jsx`](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Pages/Employee.jsx) (Employee page), [`Backend/app.js`](https://github.com/vinayyx/git-plexigenius/blob/master/Backend/app.js) (Express server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Frontend experience"]
  node_app["Route shell<br/>[App.jsx]"]
  node_login["Login page<br/>[Login.jsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_sidebar["Navigation<br/>[Sidebar.jsx]"]
  node_shared_state["Shared UI state<br/>[Context.jsx]"]
end

subgraph group_identity["Authentication"]
  node_auth_routes["Auth endpoints<br/>[authRoutes.js]"]
  node_auth_controller["Auth controller<br/>[authController.js]"]
  node_user_model[("User records<br/>[User.js]")]
  node_jwt["Token utilities<br/>[jwt.js]"]
end

subgraph group_leads["Lead management"]
  node_lead_ui["Lead page<br/>[Leads.jsx]"]
  node_lead_add["Lead creation<br/>[AddLeadModal.jsx]"]
  node_lead_edit["Lead editor<br/>[EditLead.jsx]"]
  node_lead_delete["Lead deletion<br/>[DeleteLead.jsx]"]
  node_lead_routes["Lead endpoints<br/>[LeadsRoutes.js]"]
  node_lead_controller["Lead controller<br/>[LeadController.js]"]
  node_lead_model[("Lead records<br/>[Lead.js]")]
  node_upload["Image upload<br/>[multer.js]"]
end

subgraph group_employees["Employee management"]
  node_employee_ui["Employee page<br/>[Employee.jsx]"]
  node_employee_forms["Employee forms"]
  node_employee_edit["Employee editor<br/>[EditEmployee.jsx]"]
  node_employee_delete["Employee deletion"]
  node_employee_routes["Employee endpoints<br/>[employeeRoutes.js]"]
  node_employee_controller["Employee controller"]
  node_employee_model[("Employee records<br/>[employee.js]")]
end

subgraph group_backend["Backend services"]
  node_server["Express server<br/>[app.js]"]
  node_db[("Database connection<br/>[db.js]")]
end

node_user(("CRM user"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_dashboard
node_app -->|"renders"| node_sidebar
node_app -->|"routes to"| node_employee_ui
node_app -->|"routes to"| node_lead_ui
node_employee_ui -->|"renders"| node_employee_forms
node_employee_ui -->|"renders"| node_employee_edit
node_employee_ui -->|"renders"| node_employee_delete
node_employee_ui -->|"reads state"| node_shared_state
node_lead_ui -->|"renders"| node_lead_add
node_lead_ui -->|"renders"| node_lead_edit
node_lead_ui -->|"renders"| node_lead_delete
node_lead_ui -->|"reads state"| node_shared_state
node_server -->|"mounts"| node_auth_routes
node_server -->|"mounts"| node_lead_routes
node_server -->|"mounts"| node_employee_routes
node_server -->|"connects"| node_db
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_controller -->|"reads and writes"| node_user_model
node_auth_controller -->|"signs tokens"| node_jwt
node_lead_routes -->|"dispatches"| node_lead_controller
node_lead_routes -->|"handles images"| node_upload
node_lead_controller -->|"reads and writes"| node_lead_model
node_employee_routes -->|"dispatches"| node_employee_controller
node_employee_controller -->|"reads and writes"| node_employee_model

click node_app "https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/App.jsx"
click node_login "https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Pages/Login.jsx"
click node_dashboard "https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Pages/Dashboard.jsx"
click node_sidebar "https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Pages/Sidebar.jsx"
click node_employee_ui "https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Pages/Employee.jsx"
click node_employee_forms "https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Components/AddEmployeeModal.jsx"
click node_employee_edit "https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Components/EditEmployee.jsx"
click node_employee_delete "https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Components/DeleteConfirmModal%20.jsx"
click node_lead_ui "https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Pages/Leads.jsx"
click node_lead_add "https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Components/AddLeadModal.jsx"
click node_lead_edit "https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Components/EditLead.jsx"
click node_lead_delete "https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Components/DeleteLead.jsx"
click node_shared_state "https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Context/Context.jsx"
click node_auth_routes "https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Routes/authRoutes.js"
click node_auth_controller "https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Controlers/authController.js"
click node_user_model "https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Models/User.js"
click node_jwt "https://github.com/vinayyx/git-plexigenius/blob/master/Backend/utils/jwt.js"
click node_lead_routes "https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Routes/LeadsRoutes.js"
click node_lead_controller "https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Controlers/LeadController.js"
click node_lead_model "https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Models/Lead.js"
click node_upload "https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Config/multer.js"
click node_employee_routes "https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Routes/employeeRoutes.js"
click node_employee_controller "https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Controlers/employeeController.js"
click node_employee_model "https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Models/employee.js"
click node_server "https://github.com/vinayyx/git-plexigenius/blob/master/Backend/app.js"
click node_db "https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Config/db.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_login,node_dashboard,node_sidebar,node_shared_state,node_user toneBlue
class node_auth_routes,node_auth_controller,node_user_model,node_jwt toneAmber
class node_lead_ui,node_lead_add,node_lead_edit,node_lead_delete,node_lead_routes,node_lead_controller,node_lead_model,node_upload toneMint
class node_employee_ui,node_employee_forms,node_employee_edit,node_employee_delete,node_employee_routes,node_employee_controller,node_employee_model toneRose
class node_server,node_db toneIndigo
```

## Components

### Frontend experience

- [Route shell](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Login page](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Pages/Login.jsx): `Frontend/src/Pages/Login.jsx`
- [Dashboard](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Pages/Dashboard.jsx): `Frontend/src/Pages/Dashboard.jsx`
- [Navigation](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Pages/Sidebar.jsx): `Frontend/src/Pages/Sidebar.jsx`
- [Shared UI state](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Context/Context.jsx): `Frontend/src/Context/Context.jsx`

### Authentication

- [Auth endpoints](https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Routes/authRoutes.js): `Backend/Routes/authRoutes.js`
- [Auth controller](https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Controlers/authController.js): `Backend/Controlers/authController.js`
- [User records](https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Models/User.js): `Backend/Models/User.js`
- [Token utilities](https://github.com/vinayyx/git-plexigenius/blob/master/Backend/utils/jwt.js): `Backend/utils/jwt.js`

### Lead management

- [Lead page](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Pages/Leads.jsx): `Frontend/src/Pages/Leads.jsx`
- [Lead creation](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Components/AddLeadModal.jsx): `Frontend/src/Components/AddLeadModal.jsx`
- [Lead editor](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Components/EditLead.jsx): `Frontend/src/Components/EditLead.jsx`
- [Lead deletion](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Components/DeleteLead.jsx): `Frontend/src/Components/DeleteLead.jsx`
- [Lead endpoints](https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Routes/LeadsRoutes.js): `Backend/Routes/LeadsRoutes.js`
- [Lead controller](https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Controlers/LeadController.js): `Backend/Controlers/LeadController.js`
- [Lead records](https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Models/Lead.js): `Backend/Models/Lead.js`
- [Image upload](https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Config/multer.js): `Backend/Config/multer.js`

### Employee management

- [Employee page](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Pages/Employee.jsx): `Frontend/src/Pages/Employee.jsx`
- [Employee forms](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Components/AddEmployeeModal.jsx): `Frontend/src/Components/AddEmployeeModal.jsx`
- [Employee editor](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Components/EditEmployee.jsx): `Frontend/src/Components/EditEmployee.jsx`
- [Employee deletion](https://github.com/vinayyx/git-plexigenius/blob/master/Frontend/src/Components/DeleteConfirmModal%20.jsx): `Frontend/src/Components/DeleteConfirmModal .jsx`
- [Employee endpoints](https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Routes/employeeRoutes.js): `Backend/Routes/employeeRoutes.js`
- [Employee controller](https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Controlers/employeeController.js): `Backend/Controlers/employeeController.js`
- [Employee records](https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Models/employee.js): `Backend/Models/employee.js`

### Backend services

- [Express server](https://github.com/vinayyx/git-plexigenius/blob/master/Backend/app.js): `Backend/app.js`
- [Database connection](https://github.com/vinayyx/git-plexigenius/blob/master/Backend/Config/db.js): `Backend/Config/db.js`

### Other components

- **CRM user**

## Connections

- CRM user → Route shell: uses
- Route shell → Login page: routes to (evidence: `Frontend/src/App.jsx`)
- Route shell → Dashboard: routes to (evidence: `Frontend/src/App.jsx`)
- Route shell → Navigation: renders (evidence: `Frontend/src/App.jsx`)
- Route shell → Employee page: routes to (evidence: `Frontend/src/App.jsx`)
- Route shell → Lead page: routes to (evidence: `Frontend/src/App.jsx`)
- Employee page → Employee forms: renders (evidence: `Frontend/src/Pages/Employee.jsx`)
- Employee page → Employee editor: renders (evidence: `Frontend/src/Pages/Employee.jsx`)
- Employee page → Employee deletion: renders (evidence: `Frontend/src/Pages/Employee.jsx`)
- Employee page → Shared UI state: reads state (evidence: `Frontend/src/Pages/Employee.jsx`)
- Lead page → Lead creation: renders (evidence: `Frontend/src/Pages/Leads.jsx`)
- Lead page → Lead editor: renders (evidence: `Frontend/src/Pages/Leads.jsx`)
- Lead page → Lead deletion: renders (evidence: `Frontend/src/Pages/Leads.jsx`)
- Lead page → Shared UI state: reads state (evidence: `Frontend/src/Pages/Leads.jsx`)
- Express server → Auth endpoints: mounts (evidence: `Backend/app.js`)
- Express server → Lead endpoints: mounts (evidence: `Backend/app.js`)
- Express server → Employee endpoints: mounts (evidence: `Backend/app.js`)
- Express server → Database connection: connects (evidence: `Backend/app.js`)
- Auth endpoints → Auth controller: dispatches (evidence: `Backend/Routes/authRoutes.js`)
- Auth controller → User records: reads and writes (evidence: `Backend/Controlers/authController.js`)
- Auth controller → Token utilities: signs tokens (evidence: `Backend/Controlers/authController.js`)
- Lead endpoints → Lead controller: dispatches (evidence: `Backend/Routes/LeadsRoutes.js`)
- Lead endpoints → Image upload: handles images (evidence: `Backend/Routes/LeadsRoutes.js`)
- Lead controller → Lead records: reads and writes (evidence: `Backend/Controlers/LeadController.js`)
- Employee endpoints → Employee controller: dispatches (evidence: `Backend/Routes/employeeRoutes.js`)
- Employee controller → Employee records: reads and writes (evidence: `Backend/Controlers/employeeController.js`)
