How pankajpandey0001/multi-ventor-inventory-management works
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: api.js API client · VendorInventoryService.java Inventory service · AuthService.java Authentication · CatalogService.java Catalog service
Components 30
Web portals
- Auth interface
src/main/resources/static/js/auth.js - Catalog interface
src/main/resources/static/js/catalog.js - Admin portal
src/main/resources/static/js/governance.js - Vendor portal
src/main/resources/static/js/operations.js - API client
src/main/resources/static/js/api.js
Identity and access
- Authentication API
src/main/java/com/pankaj/mvm/controller/AuthController.java - Authentication
src/main/java/com/pankaj/mvm/service/AuthService.java - OTP verification
src/main/java/com/pankaj/mvm/service/OtpService.java - JWT utilities
src/main/java/com/pankaj/mvm/security/JwtUtils.java - JWT request filter
src/main/java/com/pankaj/mvm/security/JwtAuthenticationFilter.java - Access control
src/main/java/com/pankaj/mvm/security/SecurityConfig.java - User accounts
src/main/java/com/pankaj/mvm/entity/User.java - User repository
src/main/java/com/pankaj/mvm/repository/UserRepository.java
Catalog management
- Catalog API
src/main/java/com/pankaj/mvm/controller/CatalogController.java - Catalog service
src/main/java/com/pankaj/mvm/service/CatalogService.java - Category model
src/main/java/com/pankaj/mvm/entity/Category.java - Master product
src/main/java/com/pankaj/mvm/entity/MasterProduct.java - Catalog repositories
src/main/java/com/pankaj/mvm/repository/CategoryRepository.java
Inventory and governance
- Vendor operations API
src/main/java/com/pankaj/mvm/controller/VendorOperationsController.java - Inventory service
src/main/java/com/pankaj/mvm/service/VendorInventoryService.java - Vendor inventory
src/main/java/com/pankaj/mvm/entity/VendorInventory.java - Stock ledger
src/main/java/com/pankaj/mvm/entity/StockLedger.java - Inventory repositories
src/main/java/com/pankaj/mvm/repository/VendorInventoryRepository.java - Governance API
src/main/java/com/pankaj/mvm/controller/SuperAdminGovernanceController.java - User governance
src/main/java/com/pankaj/mvm/service/UserGovernanceService.java - Audit log repository
src/main/java/com/pankaj/mvm/repository/UserAuditLogRepository.java
Other components
- User
- MySQL
- Redis OTP store
- Email delivery
Connections 40
- 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
src/main/java/com/pankaj/mvm/controller/AuthController.java - Authentication → OTP verification: verifies OTP
src/main/java/com/pankaj/mvm/service/AuthService.java - Authentication → User repository: reads and saves users
src/main/java/com/pankaj/mvm/service/AuthService.java - Authentication → JWT utilities: generates token
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
src/main/java/com/pankaj/mvm/security/JwtAuthenticationFilter.java - JWT request filter → User repository: loads user
src/main/java/com/pankaj/mvm/security/JwtAuthenticationFilter.java - Access control → JWT request filter: registers filter
- Catalog API → Catalog service: delegates to
src/main/java/com/pankaj/mvm/controller/CatalogController.java - Catalog service → Catalog repositories: accesses categories
src/main/java/com/pankaj/mvm/service/CatalogService.java - Catalog service → Master product: creates and reviews
src/main/java/com/pankaj/mvm/service/CatalogService.java - Catalog service → Inventory repositories: adds vendor stock
src/main/java/com/pankaj/mvm/service/CatalogService.java - Catalog repositories → Category model: persists
src/main/java/com/pankaj/mvm/repository/CategoryRepository.java - Vendor operations API → Inventory service: delegates to
src/main/java/com/pankaj/mvm/controller/VendorOperationsController.java - Inventory service → Inventory repositories: reads and saves stock
src/main/java/com/pankaj/mvm/service/VendorInventoryService.java - Inventory service → Master product: checks price limits
src/main/java/com/pankaj/mvm/service/VendorInventoryService.java - Inventory service → Stock ledger: records stock movements
src/main/java/com/pankaj/mvm/service/VendorInventoryService.java - Inventory repositories → Vendor inventory: persists
src/main/java/com/pankaj/mvm/repository/VendorInventoryRepository.java - Governance API → User governance: delegates to
src/main/java/com/pankaj/mvm/controller/SuperAdminGovernanceController.java - Governance API → Inventory service: requests valuation
src/main/java/com/pankaj/mvm/controller/SuperAdminGovernanceController.java - User governance → User repository: reads and updates accounts
src/main/java/com/pankaj/mvm/service/UserGovernanceService.java - User governance → Audit log repository: writes audit trail
src/main/java/com/pankaj/mvm/service/UserGovernanceService.java - User governance → User accounts: changes account status
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