# odegaa/practice-project architecture

> Architecture diagram of the GitHub repository odegaa/practice-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-08). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/odegaa/practice-project
- Repository: https://github.com/odegaa/practice-project

## Overview

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: [`src/main/java/com/odegaa/practiceproject/configurations/auth/AuthService.java`](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/configurations/auth/AuthService.java) (Authentication), [`src/main/java/com/odegaa/practiceproject/configurations/auth/AuthController.java`](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/configurations/auth/AuthController.java) (Auth API), [`src/main/java/com/odegaa/practiceproject/controllers/EmployeeController.java`](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/EmployeeController.java) (Employee API), [`src/main/java/com/odegaa/practiceproject/repositories/EmployeeRepository.java`](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/repositories/EmployeeRepository.java) (Employee records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_security["Identity and access"]
  node_auth_api["Auth API"]
  node_auth_service["Authentication<br/>[AuthService.java]"]
  node_jwt["JWT security<br/>[JwtProvider.java]"]
  node_security_config["Access control"]
end

subgraph group_hr["HR and directory"]
  node_employee_api["Employee API"]
  node_employee_service["Employee services"]
  node_directory_api["Location APIs"]
  node_address_api["Address APIs"]
  node_passport_api["Passport API"]
  node_employee_store[("Employee records")]
end

subgraph group_crm["Customer management"]
  node_crm_api["Customer API"]
  node_crm_service["Customer services"]
  node_customer_store[("Customer records")]
end

subgraph group_advertising["Advertising"]
  node_ads_api["Campaign API"]
  node_ads_service["Campaign services"]
  node_ads_types["Campaign types"]
end

subgraph group_analytics["Management analytics"]
  node_customer_dash["Customer analytics"]
  node_ads_dash["Advertising analytics"]
  node_employee_dash["Employee dashboard"]
end

node_user(("API user"))
node_postgres[("PostgreSQL")]

node_user -->|"requests token"| node_auth_api
node_auth_api -->|"delegates login"| node_auth_service
node_auth_service -->|"loads account"| node_employee_store
node_auth_service -->|"issues token"| node_jwt
node_user -.->|"uses APIs"| node_employee_api
node_employee_api -.->|"delegates"| node_employee_service
node_user -.->|"uses APIs"| node_directory_api
node_user -.->|"uses APIs"| node_address_api
node_user -.->|"uses APIs"| node_passport_api
node_user -->|"manages customers"| node_crm_api
node_crm_api -->|"delegates"| node_crm_service
node_crm_service -.->|"persists records"| node_customer_store
node_user -->|"manages campaigns"| node_ads_api
node_ads_api -->|"delegates"| node_ads_service
node_user -.->|"uses APIs"| node_ads_types
node_user -.->|"views metrics"| node_customer_dash
node_user -.->|"views metrics"| node_ads_dash
node_user -.->|"views metrics"| node_employee_dash
node_employee_store -.->|"stores employee data"| node_postgres
node_customer_store -.->|"stores customer data"| node_postgres

click node_auth_api "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/configurations/auth/AuthController.java"
click node_auth_service "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/configurations/auth/AuthService.java"
click node_jwt "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/configurations/security/JwtProvider.java"
click node_security_config "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/configurations/WebSecurityConfig.java"
click node_employee_api "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/EmployeeController.java"
click node_employee_service "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/services/impls/EmployeeServiceImpl.java"
click node_directory_api "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/RegionController.java"
click node_address_api "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/AddressController.java"
click node_passport_api "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/PassportController.java"
click node_crm_api "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/CustomerController.java"
click node_crm_service "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/services/impls/CustomerServiceImpl.java"
click node_customer_store "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/repositories/CustomerRepository.java"
click node_ads_api "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/AdvertisingController.java"
click node_ads_service "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/services/impls/AdvertisingServiceImpl.java"
click node_ads_types "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/AdsTypesController.java"
click node_customer_dash "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/CustomersDashboardController.java"
click node_ads_dash "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/AdsDashboardController.java"
click node_employee_dash "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/EmployeeDashboardController.java"
click node_employee_store "https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/repositories/EmployeeRepository.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_auth_api,node_auth_service,node_jwt,node_security_config,node_user toneBlue
class node_employee_api,node_employee_service,node_directory_api,node_address_api,node_passport_api,node_employee_store,node_postgres toneAmber
class node_crm_api,node_crm_service,node_customer_store toneMint
class node_ads_api,node_ads_service,node_ads_types toneRose
class node_customer_dash,node_ads_dash,node_employee_dash toneIndigo
```

## Components

### Identity and access

- [Auth API](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/configurations/auth/AuthController.java): `src/main/java/com/odegaa/practiceproject/configurations/auth/AuthController.java`
- [Authentication](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/configurations/auth/AuthService.java): `src/main/java/com/odegaa/practiceproject/configurations/auth/AuthService.java`
- [JWT security](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/configurations/security/JwtProvider.java): `src/main/java/com/odegaa/practiceproject/configurations/security/JwtProvider.java`
- [Access control](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/configurations/WebSecurityConfig.java): `src/main/java/com/odegaa/practiceproject/configurations/WebSecurityConfig.java`

### HR and directory

- [Employee API](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/EmployeeController.java): `src/main/java/com/odegaa/practiceproject/controllers/EmployeeController.java`
- [Employee services](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/services/impls/EmployeeServiceImpl.java): `src/main/java/com/odegaa/practiceproject/services/impls/EmployeeServiceImpl.java`
- [Location APIs](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/RegionController.java): `src/main/java/com/odegaa/practiceproject/controllers/RegionController.java`
- [Address APIs](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/AddressController.java): `src/main/java/com/odegaa/practiceproject/controllers/AddressController.java`
- [Passport API](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/PassportController.java): `src/main/java/com/odegaa/practiceproject/controllers/PassportController.java`
- [Employee records](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/repositories/EmployeeRepository.java): `src/main/java/com/odegaa/practiceproject/repositories/EmployeeRepository.java`

### Customer management

- [Customer API](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/CustomerController.java): `src/main/java/com/odegaa/practiceproject/controllers/CustomerController.java`
- [Customer services](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/services/impls/CustomerServiceImpl.java): `src/main/java/com/odegaa/practiceproject/services/impls/CustomerServiceImpl.java`
- [Customer records](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/repositories/CustomerRepository.java): `src/main/java/com/odegaa/practiceproject/repositories/CustomerRepository.java`

### Advertising

- [Campaign API](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/AdvertisingController.java): `src/main/java/com/odegaa/practiceproject/controllers/AdvertisingController.java`
- [Campaign services](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/services/impls/AdvertisingServiceImpl.java): `src/main/java/com/odegaa/practiceproject/services/impls/AdvertisingServiceImpl.java`
- [Campaign types](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/AdsTypesController.java): `src/main/java/com/odegaa/practiceproject/controllers/AdsTypesController.java`

### Management analytics

- [Customer analytics](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/CustomersDashboardController.java): `src/main/java/com/odegaa/practiceproject/controllers/CustomersDashboardController.java`
- [Advertising analytics](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/AdsDashboardController.java): `src/main/java/com/odegaa/practiceproject/controllers/AdsDashboardController.java`
- [Employee dashboard](https://github.com/odegaa/practice-project/blob/odegaa/src/main/java/com/odegaa/practiceproject/controllers/EmployeeDashboardController.java): `src/main/java/com/odegaa/practiceproject/controllers/EmployeeDashboardController.java`

### Other components

- **API user**
- **PostgreSQL**

## Connections

- API user → Auth API: requests token
- Auth API → Authentication: delegates login (evidence: `src/main/java/com/odegaa/practiceproject/configurations/auth/AuthController.java`)
- Authentication → Employee records: loads account (evidence: `src/main/java/com/odegaa/practiceproject/configurations/auth/AuthService.java`)
- Authentication → JWT security: issues token (evidence: `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 (evidence: `src/main/java/com/odegaa/practiceproject/controllers/CustomerController.java`)
- Customer API → Customer services: delegates (evidence: `src/main/java/com/odegaa/practiceproject/controllers/CustomerController.java`)
- Customer services → Customer records: persists records (evidence: `src/main/java/com/odegaa/practiceproject/services/impls/CustomerServiceImpl.java`)
- API user → Campaign API: manages campaigns (evidence: `src/main/java/com/odegaa/practiceproject/controllers/AdvertisingController.java`)
- Campaign API → Campaign services: delegates (evidence: `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
