How odegaa/practice-project works
This is a Spring Boot ERP application for HR, CRM, and advertising operations, with JWT-based access control and management dashboards. Users authenticate to obtain a token, then use role-restricted APIs to manage employees, customers, locations, and campaigns; directors can access customer and advertising analytics. The shown customer and advertising controllers delegate to services, and the shown authentication service queries employees and issues JWTs. Other subsystem paths and connections are represented from the README and tree; their implementation wiring was not sampled.
Main entry points: AuthService.java Authentication · AuthController.java Auth API · EmployeeController.java Employee API · EmployeeRepository.java Employee records
Components 21
Identity and access
- Auth API
src/main/java/com/odegaa/practiceproject/configurations/auth/AuthController.java - Authentication
src/main/java/com/odegaa/practiceproject/configurations/auth/AuthService.java - JWT security
src/main/java/com/odegaa/practiceproject/configurations/security/JwtProvider.java - Access control
src/main/java/com/odegaa/practiceproject/configurations/WebSecurityConfig.java
HR and directory
- Employee API
src/main/java/com/odegaa/practiceproject/controllers/EmployeeController.java - Employee services
src/main/java/com/odegaa/practiceproject/services/impls/EmployeeServiceImpl.java - Location APIs
src/main/java/com/odegaa/practiceproject/controllers/RegionController.java - Address APIs
src/main/java/com/odegaa/practiceproject/controllers/AddressController.java - Passport API
src/main/java/com/odegaa/practiceproject/controllers/PassportController.java - Employee records
src/main/java/com/odegaa/practiceproject/repositories/EmployeeRepository.java
Customer management
- Customer API
src/main/java/com/odegaa/practiceproject/controllers/CustomerController.java - Customer services
src/main/java/com/odegaa/practiceproject/services/impls/CustomerServiceImpl.java - Customer records
src/main/java/com/odegaa/practiceproject/repositories/CustomerRepository.java
Advertising
- Campaign API
src/main/java/com/odegaa/practiceproject/controllers/AdvertisingController.java - Campaign services
src/main/java/com/odegaa/practiceproject/services/impls/AdvertisingServiceImpl.java - Campaign types
src/main/java/com/odegaa/practiceproject/controllers/AdsTypesController.java
Management analytics
- Customer analytics
src/main/java/com/odegaa/practiceproject/controllers/CustomersDashboardController.java - Advertising analytics
src/main/java/com/odegaa/practiceproject/controllers/AdsDashboardController.java - Employee dashboard
src/main/java/com/odegaa/practiceproject/controllers/EmployeeDashboardController.java
Other components
- API user
- PostgreSQL
Connections 20
- API user → Auth API: requests token
- Auth API → Authentication: delegates login
src/main/java/com/odegaa/practiceproject/configurations/auth/AuthController.java - Authentication → Employee records: loads account
src/main/java/com/odegaa/practiceproject/configurations/auth/AuthService.java - Authentication → JWT security: issues token
src/main/java/com/odegaa/practiceproject/configurations/auth/AuthService.java - API user → Employee API: uses APIs
- Employee API → Employee services: delegates
- API user → Location APIs: uses APIs
- API user → Address APIs: uses APIs
- API user → Passport API: uses APIs
- API user → Customer API: manages customers
src/main/java/com/odegaa/practiceproject/controllers/CustomerController.java - Customer API → Customer services: delegates
src/main/java/com/odegaa/practiceproject/controllers/CustomerController.java - Customer services → Customer records: persists records
src/main/java/com/odegaa/practiceproject/services/impls/CustomerServiceImpl.java - API user → Campaign API: manages campaigns
src/main/java/com/odegaa/practiceproject/controllers/AdvertisingController.java - Campaign API → Campaign services: delegates
src/main/java/com/odegaa/practiceproject/controllers/AdvertisingController.java - API user → Campaign types: uses APIs
- API user → Customer analytics: views metrics
- API user → Advertising analytics: views metrics
- API user → Employee dashboard: views metrics
- Employee records → PostgreSQL: stores employee data
- Customer records → PostgreSQL: stores customer data