# pankajpandey0001/multi-ventor-inventory-management architecture

> Architecture diagram of the GitHub repository pankajpandey0001/multi-ventor-inventory-management, 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/pankajpandey0001/multi-ventor-inventory-management
- Repository: https://github.com/pankajpandey0001/multi-ventor-inventory-management

## Overview

MVM is a multi-vendor inventory web application: users register and verify by OTP, admins govern accounts and maintain an approved global catalog, and vendors manage their own stock and prices within admin-defined limits. Stock changes are recorded in a ledger; governance actions are auditable. The map includes the documented browser portals and authentication/security layers. Some frontend-to-backend wiring and unsampled service internals are described only at capability level, so edges there cite the README rather than implying inspected implementation details.

Main entry points: [`src/main/resources/static/js/api.js`](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/resources/static/js/api.js) (API client), [`src/main/java/com/pankaj/mvm/service/VendorInventoryService.java`](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/service/VendorInventoryService.java) (Inventory service), [`src/main/java/com/pankaj/mvm/service/AuthService.java`](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/service/AuthService.java) (Authentication), [`src/main/java/com/pankaj/mvm/service/CatalogService.java`](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/service/CatalogService.java) (Catalog service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web portals"]
  node_authui["Auth interface<br/>[auth.js]"]
  node_catalogui["Catalog interface<br/>[catalog.js]"]
  node_adminui["Admin portal<br/>[governance.js]"]
  node_vendorui["Vendor portal<br/>[operations.js]"]
  node_apiui["API client<br/>[api.js]"]
end

subgraph group_identity["Identity and access"]
  node_authctrl["Authentication API"]
  node_authsvc["Authentication<br/>[AuthService.java]"]
  node_otp["OTP verification<br/>[OtpService.java]"]
  node_jwt["JWT utilities<br/>[JwtUtils.java]"]
  node_jwtfilter["JWT request filter"]
  node_security["Access control"]
  node_userentity["User accounts<br/>[User.java]"]
  node_userrepo["User repository"]
end

subgraph group_catalog["Catalog management"]
  node_catalogctrl["Catalog API"]
  node_catalogsvc["Catalog service"]
  node_category["Category model<br/>[Category.java]"]
  node_product["Master product<br/>[MasterProduct.java]"]
  node_catalogrepo["Catalog repositories"]
end

subgraph group_inventory["Inventory and governance"]
  node_vendorctrl["Vendor operations API"]
  node_inventorysvc["Inventory service"]
  node_inventory["Vendor inventory"]
  node_ledger["Stock ledger<br/>[StockLedger.java]"]
  node_inventoryrepo["Inventory repositories"]
  node_governancectrl["Governance API"]
  node_governance["User governance"]
  node_auditrepo["Audit log repository"]
end

node_user(("User"))
node_mysql[("MySQL")]
node_redis[("Redis OTP store")]
node_email["Email delivery"]

node_user -->|"registers or logs in"| node_authui
node_user -->|"browses catalog"| node_catalogui
node_user -->|"uses admin portal"| node_adminui
node_user -->|"uses vendor portal"| node_vendorui
node_authui -.->|"uses API client"| node_apiui
node_catalogui -.->|"uses API client"| node_apiui
node_adminui -.->|"uses API client"| node_apiui
node_vendorui -.->|"uses API client"| node_apiui
node_apiui -.->|"calls backend"| node_authctrl
node_apiui -->|"calls backend"| node_catalogctrl
node_apiui -->|"calls backend"| node_vendorctrl
node_apiui -->|"calls backend"| node_governancectrl
node_authctrl -->|"delegates to"| node_authsvc
node_authsvc -->|"verifies OTP"| node_otp
node_authsvc -->|"reads and saves users"| node_userrepo
node_authsvc -->|"generates token"| node_jwt
node_otp -->|"stores OTP temporarily"| node_redis
node_otp -->|"sends OTP"| node_email
node_jwtfilter -->|"validates token"| node_jwt
node_jwtfilter -->|"loads user"| node_userrepo
node_security -.->|"registers filter"| node_jwtfilter
node_catalogctrl -->|"delegates to"| node_catalogsvc
node_catalogsvc -->|"accesses categories"| node_catalogrepo
node_catalogsvc -->|"creates and reviews"| node_product
node_catalogsvc -->|"adds vendor stock"| node_inventoryrepo
node_catalogrepo -->|"persists"| node_category
node_vendorctrl -->|"delegates to"| node_inventorysvc
node_inventorysvc -->|"reads and saves stock"| node_inventoryrepo
node_inventorysvc -->|"checks price limits"| node_product
node_inventorysvc -->|"records stock movements"| node_ledger
node_inventoryrepo -->|"persists"| node_inventory
node_governancectrl -->|"delegates to"| node_governance
node_governancectrl -->|"requests valuation"| node_inventorysvc
node_governance -->|"reads and updates accounts"| node_userrepo
node_governance -->|"writes audit trail"| node_auditrepo
node_governance -->|"changes account status"| node_userentity
node_userrepo -->|"persists accounts"| node_mysql
node_catalogrepo -->|"persists catalog"| node_mysql
node_inventoryrepo -->|"persists inventory"| node_mysql
node_auditrepo -->|"persists audit history"| node_mysql

click node_authui "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/resources/static/js/auth.js"
click node_catalogui "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/resources/static/js/catalog.js"
click node_adminui "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/resources/static/js/governance.js"
click node_vendorui "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/resources/static/js/operations.js"
click node_apiui "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/resources/static/js/api.js"
click node_authctrl "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/controller/AuthController.java"
click node_authsvc "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/service/AuthService.java"
click node_otp "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/service/OtpService.java"
click node_jwt "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/security/JwtUtils.java"
click node_jwtfilter "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/security/JwtAuthenticationFilter.java"
click node_security "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/security/SecurityConfig.java"
click node_catalogctrl "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/controller/CatalogController.java"
click node_catalogsvc "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/service/CatalogService.java"
click node_category "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/entity/Category.java"
click node_product "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/entity/MasterProduct.java"
click node_catalogrepo "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/repository/CategoryRepository.java"
click node_vendorctrl "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/controller/VendorOperationsController.java"
click node_inventorysvc "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/service/VendorInventoryService.java"
click node_inventory "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/entity/VendorInventory.java"
click node_ledger "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/entity/StockLedger.java"
click node_inventoryrepo "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/repository/VendorInventoryRepository.java"
click node_governancectrl "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/controller/SuperAdminGovernanceController.java"
click node_governance "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/service/UserGovernanceService.java"
click node_userentity "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/entity/User.java"
click node_userrepo "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/repository/UserRepository.java"
click node_auditrepo "https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/repository/UserAuditLogRepository.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_authui,node_catalogui,node_adminui,node_vendorui,node_apiui,node_user toneBlue
class node_authctrl,node_authsvc,node_otp,node_jwt,node_jwtfilter,node_security,node_userentity,node_userrepo,node_mysql,node_redis toneAmber
class node_catalogctrl,node_catalogsvc,node_category,node_product,node_catalogrepo toneMint
class node_vendorctrl,node_inventorysvc,node_inventory,node_ledger,node_inventoryrepo,node_governancectrl,node_governance,node_auditrepo toneRose
class node_email toneIndigo
```

## Components

### Web portals

- [Auth interface](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/resources/static/js/auth.js): `src/main/resources/static/js/auth.js`
- [Catalog interface](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/resources/static/js/catalog.js): `src/main/resources/static/js/catalog.js`
- [Admin portal](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/resources/static/js/governance.js): `src/main/resources/static/js/governance.js`
- [Vendor portal](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/resources/static/js/operations.js): `src/main/resources/static/js/operations.js`
- [API client](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/resources/static/js/api.js): `src/main/resources/static/js/api.js`

### Identity and access

- [Authentication API](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/controller/AuthController.java): `src/main/java/com/pankaj/mvm/controller/AuthController.java`
- [Authentication](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/service/AuthService.java): `src/main/java/com/pankaj/mvm/service/AuthService.java`
- [OTP verification](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/service/OtpService.java): `src/main/java/com/pankaj/mvm/service/OtpService.java`
- [JWT utilities](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/security/JwtUtils.java): `src/main/java/com/pankaj/mvm/security/JwtUtils.java`
- [JWT request filter](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/security/JwtAuthenticationFilter.java): `src/main/java/com/pankaj/mvm/security/JwtAuthenticationFilter.java`
- [Access control](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/security/SecurityConfig.java): `src/main/java/com/pankaj/mvm/security/SecurityConfig.java`
- [User accounts](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/entity/User.java): `src/main/java/com/pankaj/mvm/entity/User.java`
- [User repository](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/repository/UserRepository.java): `src/main/java/com/pankaj/mvm/repository/UserRepository.java`

### Catalog management

- [Catalog API](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/controller/CatalogController.java): `src/main/java/com/pankaj/mvm/controller/CatalogController.java`
- [Catalog service](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/service/CatalogService.java): `src/main/java/com/pankaj/mvm/service/CatalogService.java`
- [Category model](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/entity/Category.java): `src/main/java/com/pankaj/mvm/entity/Category.java`
- [Master product](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/entity/MasterProduct.java): `src/main/java/com/pankaj/mvm/entity/MasterProduct.java`
- [Catalog repositories](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/repository/CategoryRepository.java): `src/main/java/com/pankaj/mvm/repository/CategoryRepository.java`

### Inventory and governance

- [Vendor operations API](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/controller/VendorOperationsController.java): `src/main/java/com/pankaj/mvm/controller/VendorOperationsController.java`
- [Inventory service](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/service/VendorInventoryService.java): `src/main/java/com/pankaj/mvm/service/VendorInventoryService.java`
- [Vendor inventory](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/entity/VendorInventory.java): `src/main/java/com/pankaj/mvm/entity/VendorInventory.java`
- [Stock ledger](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/entity/StockLedger.java): `src/main/java/com/pankaj/mvm/entity/StockLedger.java`
- [Inventory repositories](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/repository/VendorInventoryRepository.java): `src/main/java/com/pankaj/mvm/repository/VendorInventoryRepository.java`
- [Governance API](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/controller/SuperAdminGovernanceController.java): `src/main/java/com/pankaj/mvm/controller/SuperAdminGovernanceController.java`
- [User governance](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/service/UserGovernanceService.java): `src/main/java/com/pankaj/mvm/service/UserGovernanceService.java`
- [Audit log repository](https://github.com/pankajpandey0001/multi-ventor-inventory-management/blob/main/src/main/java/com/pankaj/mvm/repository/UserAuditLogRepository.java): `src/main/java/com/pankaj/mvm/repository/UserAuditLogRepository.java`

### Other components

- **User**
- **MySQL**
- **Redis OTP store**
- **Email delivery**

## Connections

- User → Auth interface: registers or logs in
- User → Catalog interface: browses catalog
- User → Admin portal: uses admin portal
- User → Vendor portal: uses vendor portal
- Auth interface → API client: uses API client
- Catalog interface → API client: uses API client
- Admin portal → API client: uses API client
- Vendor portal → API client: uses API client
- API client → Authentication API: calls backend
- API client → Catalog API: calls backend
- API client → Vendor operations API: calls backend
- API client → Governance API: calls backend
- Authentication API → Authentication: delegates to (evidence: `src/main/java/com/pankaj/mvm/controller/AuthController.java`)
- Authentication → OTP verification: verifies OTP (evidence: `src/main/java/com/pankaj/mvm/service/AuthService.java`)
- Authentication → User repository: reads and saves users (evidence: `src/main/java/com/pankaj/mvm/service/AuthService.java`)
- Authentication → JWT utilities: generates token (evidence: `src/main/java/com/pankaj/mvm/service/AuthService.java`)
- OTP verification → Redis OTP store: stores OTP temporarily
- OTP verification → Email delivery: sends OTP
- JWT request filter → JWT utilities: validates token (evidence: `src/main/java/com/pankaj/mvm/security/JwtAuthenticationFilter.java`)
- JWT request filter → User repository: loads user (evidence: `src/main/java/com/pankaj/mvm/security/JwtAuthenticationFilter.java`)
- Access control → JWT request filter: registers filter
- Catalog API → Catalog service: delegates to (evidence: `src/main/java/com/pankaj/mvm/controller/CatalogController.java`)
- Catalog service → Catalog repositories: accesses categories (evidence: `src/main/java/com/pankaj/mvm/service/CatalogService.java`)
- Catalog service → Master product: creates and reviews (evidence: `src/main/java/com/pankaj/mvm/service/CatalogService.java`)
- Catalog service → Inventory repositories: adds vendor stock (evidence: `src/main/java/com/pankaj/mvm/service/CatalogService.java`)
- Catalog repositories → Category model: persists (evidence: `src/main/java/com/pankaj/mvm/repository/CategoryRepository.java`)
- Vendor operations API → Inventory service: delegates to (evidence: `src/main/java/com/pankaj/mvm/controller/VendorOperationsController.java`)
- Inventory service → Inventory repositories: reads and saves stock (evidence: `src/main/java/com/pankaj/mvm/service/VendorInventoryService.java`)
- Inventory service → Master product: checks price limits (evidence: `src/main/java/com/pankaj/mvm/service/VendorInventoryService.java`)
- Inventory service → Stock ledger: records stock movements (evidence: `src/main/java/com/pankaj/mvm/service/VendorInventoryService.java`)
- Inventory repositories → Vendor inventory: persists (evidence: `src/main/java/com/pankaj/mvm/repository/VendorInventoryRepository.java`)
- Governance API → User governance: delegates to (evidence: `src/main/java/com/pankaj/mvm/controller/SuperAdminGovernanceController.java`)
- Governance API → Inventory service: requests valuation (evidence: `src/main/java/com/pankaj/mvm/controller/SuperAdminGovernanceController.java`)
- User governance → User repository: reads and updates accounts (evidence: `src/main/java/com/pankaj/mvm/service/UserGovernanceService.java`)
- User governance → Audit log repository: writes audit trail (evidence: `src/main/java/com/pankaj/mvm/service/UserGovernanceService.java`)
- User governance → User accounts: changes account status (evidence: `src/main/java/com/pankaj/mvm/service/UserGovernanceService.java`)
- User repository → MySQL: persists accounts
- Catalog repositories → MySQL: persists catalog
- Inventory repositories → MySQL: persists inventory
- Audit log repository → MySQL: persists audit history
