How vishnu-manalan/branch_manager works
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: endpoints.js API endpoints · App.jsx Role routes · WorksWithRepository.java Employee-client sales links · ClientService.java Client assignment and scope
Components 22
Role-based web app
- Role routes
frontend/src/App.jsx - Auth state
frontend/src/context/AuthContext.jsx - Login screen
frontend/src/pages/Login.jsx - Admin operations
frontend/src/pages/admin - Manager dashboard and reports
frontend/src/pages/manager - Employee sales and clients
frontend/src/pages/employee - API endpoints
frontend/src/services/endpoints.js
Branch operations API
- Authentication
backend/src/main/java/com/company/branchmanager/service/AuthService.java - Branch management
backend/src/main/java/com/company/branchmanager/controller/BranchController.java - Client management
backend/src/main/java/com/company/branchmanager/controller/ClientController.java - Employee management
backend/src/main/java/com/company/branchmanager/controller/EmployeeController.java - Supplier management
backend/src/main/java/com/company/branchmanager/controller/SupplierController.java - Sales tracking
backend/src/main/java/com/company/branchmanager/controller/SalesController.java - Role dashboards
backend/src/main/java/com/company/branchmanager/controller/DashboardController.java - Sales reports
backend/src/main/java/com/company/branchmanager/controller/ReportController.java - Branch rules
backend/src/main/java/com/company/branchmanager/service/BranchService.java - Client assignment and scope
backend/src/main/java/com/company/branchmanager/service/ClientService.java
Persistence and security
- JWT and access control
backend/src/main/java/com/company/branchmanager/security - JPA repositories
backend/src/main/java/com/company/branchmanager/repository - Employee-client sales links
backend/src/main/java/com/company/branchmanager/repository/WorksWithRepository.java - H2 or MySQL
Other components
- Admin, manager, employee
Connections 28
- Admin, manager, employee → Login screen: signs in
README.md - Login screen → Auth state: submits credentials
frontend/src/pages/Login.jsx - Auth state → API endpoints: calls login
frontend/src/context/AuthContext.jsx - Role routes → Auth state: checks session
frontend/src/App.jsx - Role routes → Admin operations: routes admin
frontend/src/App.jsx - Role routes → Manager dashboard and reports: routes manager
frontend/src/App.jsx - Role routes → Employee sales and clients: routes employee
frontend/src/App.jsx - Admin operations → API endpoints: calls client API
frontend/src/pages/admin/Clients.jsx - Manager dashboard and reports → API endpoints: loads dashboard
frontend/src/pages/manager/ManagerDashboard.jsx - Employee sales and clients → API endpoints: uses endpoints
frontend/src/services/endpoints.js - API endpoints → Authentication: REST requests
README.md - API endpoints → Branch management: REST requests
README.md - API endpoints → Client management: REST requests
README.md - API endpoints → Employee management: REST requests
README.md - API endpoints → Supplier management: REST requests
README.md - API endpoints → Sales tracking: REST requests
README.md - API endpoints → Role dashboards: REST requests
README.md - API endpoints → Sales reports: REST requests
README.md - Branch management → Branch rules: delegates
backend/src/main/java/com/company/branchmanager/controller/BranchController.java - Client management → Client assignment and scope: delegates
backend/src/main/java/com/company/branchmanager/controller/ClientController.java - Branch rules → JPA repositories: reads and writes
backend/src/main/java/com/company/branchmanager/service/BranchService.java - Client assignment and scope → JPA repositories: reads and writes
backend/src/main/java/com/company/branchmanager/service/ClientService.java - Client assignment and scope → Employee-client sales links: checks assignments
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
backend/src/main/java/com/company/branchmanager/service/AuthService.java - JPA repositories → H2 or MySQL: persists entities
README.md