# jonik2909/jobland-server architecture

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

- Interactive diagram: https://gitdiagram.com/jonik2909/jobland-server
- Repository: https://github.com/jonik2909/jobland-server

## Overview

Jobland is a job-marketplace backend for candidates, companies, and administrators. Its central workflow is that users submit requests to API controllers, services apply role-aware business rules, and repositories persist or retrieve member, job, application, and profile-background data. Candidate authentication produces JWTs that the request filter can parse; company and administrator workflows manage listings and applications. The tree and excerpts establish these domains, but the README is empty and several controller and integration details are unsampled, so uncertain routing and upload-storage links are omitted or marked unverified.

Main entry points: [`src/main/java/com/backend/jobland/service/JobService.java`](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/JobService.java) (Job service), [`src/main/java/com/backend/jobland/service/MemberService.java`](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/MemberService.java) (Member service), [`src/main/java/com/backend/jobland/service/ApplicationService.java`](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/ApplicationService.java) (Application service), [`src/main/java/com/backend/jobland/service/ViewService.java`](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/ViewService.java) (View service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and access"]
  node_member_api["Member API"]
  node_job_api["Job API<br/>[JobController.java]"]
  node_application_api["Application API"]
  node_background_api["Background API"]
  node_admin_api["Admin API"]
  node_upload_api["Upload API"]
  node_auth["JWT auth<br/>[AuthService.java]"]
  node_jwt_filter["JWT filter<br/>[JwtAuthFilter.java]"]
  node_security["Security context<br/>[SecurityUtils.java]"]
end

subgraph group_accounts["Member profiles"]
  node_member_service["Member service<br/>[MemberService.java]"]
  node_background_service["Background service"]
end

subgraph group_market["Jobs and applications"]
  node_job_service["Job service<br/>[JobService.java]"]
  node_application_service["Application service"]
  node_view_service["View service<br/>[ViewService.java]"]
end

subgraph group_persistence["Persistence and domain"]
  node_member_repo["Member repository"]
  node_background_repo["Background repository"]
  node_job_repo["Job repository<br/>[JobRepository.java]"]
  node_application_repo["Application repository"]
  node_view_repo["View repository"]
  node_member_entity["Member record<br/>[Member.java]"]
  node_background_entity["Background record<br/>[Background.java]"]
  node_job_entity["Job record<br/>[Job.java]"]
  node_application_entity["Application record<br/>[Application.java]"]
  node_view_entity["View record<br/>[View.java]"]
  node_errors["Domain errors<br/>[AppErrors.java]"]
  node_enums["Domain enums"]
end

node_client(("API user"))

node_client -.->|"sends requests"| node_member_api
node_client -.->|"sends requests"| node_job_api
node_client -.->|"sends requests"| node_application_api
node_client -.->|"sends requests"| node_background_api
node_client -.->|"sends requests"| node_admin_api
node_client -.->|"sends requests"| node_upload_api
node_member_api -->|"delegates"| node_member_service
node_member_api -->|"uses tokens"| node_auth
node_job_api -->|"delegates"| node_job_service
node_application_api -->|"delegates"| node_application_service
node_background_api -->|"delegates"| node_background_service
node_admin_api -->|"delegates"| node_job_service
node_admin_api -->|"delegates"| node_member_service
node_jwt_filter -->|"parses tokens"| node_auth
node_member_service -->|"reads and writes"| node_member_repo
node_member_service -->|"loads backgrounds"| node_background_service
node_background_service -->|"reads and writes"| node_background_repo
node_job_service -->|"queries and saves"| node_job_repo
node_job_service -->|"counts applications"| node_application_service
node_job_service -->|"updates counts"| node_member_service
node_job_service -->|"records views"| node_view_service
node_application_service -->|"finds job"| node_job_service
node_application_service -->|"reads and writes"| node_application_repo
node_view_service -->|"records views"| node_view_repo
node_view_service -->|"updates member views"| node_member_service
node_view_service -->|"updates job views"| node_job_service
node_member_repo -->|"persists"| node_member_entity
node_background_repo -->|"persists"| node_background_entity
node_job_repo -->|"persists"| node_job_entity
node_application_repo -->|"persists"| node_application_entity
node_view_repo -->|"persists"| node_view_entity
node_job_entity -->|"uses statuses and types"| node_enums
node_member_entity -->|"uses member types"| node_enums
node_application_entity -->|"uses application status"| node_enums
node_application_service -->|"raises domain errors"| node_errors
node_background_service -->|"raises domain errors"| node_errors
node_member_service -->|"raises domain errors"| node_errors
node_job_service -->|"raises domain errors"| node_errors

click node_member_api "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/controller/MemberController.java"
click node_job_api "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/controller/JobController.java"
click node_application_api "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/controller/ApplicationController.java"
click node_background_api "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/controller/BackgroundController.java"
click node_admin_api "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/controller/AdminController.java"
click node_upload_api "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/controller/UploadController.java"
click node_auth "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/AuthService.java"
click node_jwt_filter "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/security/JwtAuthFilter.java"
click node_security "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/security/SecurityUtils.java"
click node_member_service "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/MemberService.java"
click node_background_service "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/BackgroundService.java"
click node_member_repo "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/repository/MemberRepository.java"
click node_background_repo "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/repository/BackgroundRepository.java"
click node_job_service "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/JobService.java"
click node_application_service "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/ApplicationService.java"
click node_view_service "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/ViewService.java"
click node_job_repo "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/repository/JobRepository.java"
click node_application_repo "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/repository/ApplicationRepository.java"
click node_view_repo "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/repository/ViewRepository.java"
click node_member_entity "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/entity/Member.java"
click node_background_entity "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/entity/Background.java"
click node_job_entity "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/entity/Job.java"
click node_application_entity "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/entity/Application.java"
click node_view_entity "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/entity/View.java"
click node_errors "https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/lib/AppErrors.java"
click node_enums "https://github.com/jonik2909/jobland-server/tree/master/src/main/java/com/backend/jobland/lib/enums"

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_member_api,node_job_api,node_application_api,node_background_api,node_admin_api,node_upload_api,node_auth,node_jwt_filter,node_security,node_client toneBlue
class node_member_service,node_background_service toneAmber
class node_job_service,node_application_service,node_view_service toneMint
class node_member_repo,node_background_repo,node_job_repo,node_application_repo,node_view_repo,node_member_entity,node_background_entity,node_job_entity,node_application_entity,node_view_entity,node_errors,node_enums toneRose
```

## Components

### API and access

- [Member API](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/controller/MemberController.java): `src/main/java/com/backend/jobland/controller/MemberController.java`
- [Job API](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/controller/JobController.java): `src/main/java/com/backend/jobland/controller/JobController.java`
- [Application API](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/controller/ApplicationController.java): `src/main/java/com/backend/jobland/controller/ApplicationController.java`
- [Background API](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/controller/BackgroundController.java): `src/main/java/com/backend/jobland/controller/BackgroundController.java`
- [Admin API](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/controller/AdminController.java): `src/main/java/com/backend/jobland/controller/AdminController.java`
- [Upload API](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/controller/UploadController.java): `src/main/java/com/backend/jobland/controller/UploadController.java`
- [JWT auth](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/AuthService.java): `src/main/java/com/backend/jobland/service/AuthService.java`
- [JWT filter](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/security/JwtAuthFilter.java): `src/main/java/com/backend/jobland/security/JwtAuthFilter.java`
- [Security context](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/security/SecurityUtils.java): `src/main/java/com/backend/jobland/security/SecurityUtils.java`

### Member profiles

- [Member service](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/MemberService.java): `src/main/java/com/backend/jobland/service/MemberService.java`
- [Background service](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/BackgroundService.java): `src/main/java/com/backend/jobland/service/BackgroundService.java`

### Jobs and applications

- [Job service](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/JobService.java): `src/main/java/com/backend/jobland/service/JobService.java`
- [Application service](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/ApplicationService.java): `src/main/java/com/backend/jobland/service/ApplicationService.java`
- [View service](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/service/ViewService.java): `src/main/java/com/backend/jobland/service/ViewService.java`

### Persistence and domain

- [Member repository](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/repository/MemberRepository.java): `src/main/java/com/backend/jobland/repository/MemberRepository.java`
- [Background repository](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/repository/BackgroundRepository.java): `src/main/java/com/backend/jobland/repository/BackgroundRepository.java`
- [Job repository](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/repository/JobRepository.java): `src/main/java/com/backend/jobland/repository/JobRepository.java`
- [Application repository](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/repository/ApplicationRepository.java): `src/main/java/com/backend/jobland/repository/ApplicationRepository.java`
- [View repository](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/repository/ViewRepository.java): `src/main/java/com/backend/jobland/repository/ViewRepository.java`
- [Member record](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/entity/Member.java): `src/main/java/com/backend/jobland/entity/Member.java`
- [Background record](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/entity/Background.java): `src/main/java/com/backend/jobland/entity/Background.java`
- [Job record](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/entity/Job.java): `src/main/java/com/backend/jobland/entity/Job.java`
- [Application record](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/entity/Application.java): `src/main/java/com/backend/jobland/entity/Application.java`
- [View record](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/entity/View.java): `src/main/java/com/backend/jobland/entity/View.java`
- [Domain errors](https://github.com/jonik2909/jobland-server/blob/master/src/main/java/com/backend/jobland/lib/AppErrors.java): `src/main/java/com/backend/jobland/lib/AppErrors.java`
- [Domain enums](https://github.com/jonik2909/jobland-server/tree/master/src/main/java/com/backend/jobland/lib/enums): `src/main/java/com/backend/jobland/lib/enums`

### Other components

- **API user**

## Connections

- API user → Member API: sends requests
- API user → Job API: sends requests
- API user → Application API: sends requests
- API user → Background API: sends requests
- API user → Admin API: sends requests
- API user → Upload API: sends requests
- Member API → Member service: delegates (evidence: `src/main/java/com/backend/jobland/controller/MemberController.java`)
- Member API → JWT auth: uses tokens (evidence: `src/main/java/com/backend/jobland/controller/MemberController.java`)
- Job API → Job service: delegates (evidence: `src/main/java/com/backend/jobland/controller/JobController.java`)
- Application API → Application service: delegates (evidence: `src/main/java/com/backend/jobland/controller/ApplicationController.java`)
- Background API → Background service: delegates (evidence: `src/main/java/com/backend/jobland/controller/BackgroundController.java`)
- Admin API → Job service: delegates (evidence: `src/main/java/com/backend/jobland/controller/AdminController.java`)
- Admin API → Member service: delegates (evidence: `src/main/java/com/backend/jobland/controller/AdminController.java`)
- JWT filter → JWT auth: parses tokens (evidence: `src/main/java/com/backend/jobland/security/JwtAuthFilter.java`)
- Member service → Member repository: reads and writes (evidence: `src/main/java/com/backend/jobland/service/MemberService.java`)
- Member service → Background service: loads backgrounds (evidence: `src/main/java/com/backend/jobland/service/MemberService.java`)
- Background service → Background repository: reads and writes (evidence: `src/main/java/com/backend/jobland/service/BackgroundService.java`)
- Job service → Job repository: queries and saves (evidence: `src/main/java/com/backend/jobland/service/JobService.java`)
- Job service → Application service: counts applications (evidence: `src/main/java/com/backend/jobland/service/JobService.java`)
- Job service → Member service: updates counts (evidence: `src/main/java/com/backend/jobland/service/JobService.java`)
- Job service → View service: records views (evidence: `src/main/java/com/backend/jobland/service/JobService.java`)
- Application service → Job service: finds job (evidence: `src/main/java/com/backend/jobland/service/ApplicationService.java`)
- Application service → Application repository: reads and writes (evidence: `src/main/java/com/backend/jobland/service/ApplicationService.java`)
- View service → View repository: records views (evidence: `src/main/java/com/backend/jobland/service/ViewService.java`)
- View service → Member service: updates member views (evidence: `src/main/java/com/backend/jobland/service/ViewService.java`)
- View service → Job service: updates job views (evidence: `src/main/java/com/backend/jobland/service/ViewService.java`)
- Member repository → Member record: persists (evidence: `src/main/java/com/backend/jobland/repository/MemberRepository.java`)
- Background repository → Background record: persists (evidence: `src/main/java/com/backend/jobland/repository/BackgroundRepository.java`)
- Job repository → Job record: persists (evidence: `src/main/java/com/backend/jobland/repository/JobRepository.java`)
- Application repository → Application record: persists (evidence: `src/main/java/com/backend/jobland/repository/ApplicationRepository.java`)
- View repository → View record: persists (evidence: `src/main/java/com/backend/jobland/repository/ViewRepository.java`)
- Job record → Domain enums: uses statuses and types (evidence: `src/main/java/com/backend/jobland/entity/Job.java`)
- Member record → Domain enums: uses member types (evidence: `src/main/java/com/backend/jobland/entity/Member.java`)
- Application record → Domain enums: uses application status (evidence: `src/main/java/com/backend/jobland/entity/Application.java`)
- Application service → Domain errors: raises domain errors (evidence: `src/main/java/com/backend/jobland/service/ApplicationService.java`)
- Background service → Domain errors: raises domain errors (evidence: `src/main/java/com/backend/jobland/service/BackgroundService.java`)
- Member service → Domain errors: raises domain errors (evidence: `src/main/java/com/backend/jobland/service/MemberService.java`)
- Job service → Domain errors: raises domain errors (evidence: `src/main/java/com/backend/jobland/service/JobService.java`)
