# apetrovic2/diplomski-recruitment-app architecture

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

- Interactive diagram: https://gitdiagram.com/apetrovic2/diplomski-recruitment-app
- Repository: https://github.com/apetrovic2/diplomski-recruitment-app

## Overview

This is a job marketplace for candidates and recruiters: users browse listings, register or sign in, submit applications with a profile or new CV, and recruiters manage listings and review applications through interviews, ratings, and status changes. The browser UI calls an Express API; controllers dispatch to use cases and MongoDB repositories. The graph preserves the documented route and capability branches, but some frontend routes and backend use cases were not sampled, so their internal connections are omitted where not evidenced.

Main entry points: [`frontend/src/routes/jobs_.$jobId.tsx`](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/routes/jobs_.%24jobId.tsx) (Job detail), [`backend/src/infrastructure/web/routes`](https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/backend/src/infrastructure/web/routes) (API routes), [`backend/src/infrastructure/web/controllers/applicationController.js`](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/src/infrastructure/web/controllers/applicationController.js) (Application controller), [`frontend/src/api/client.ts`](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/api/client.ts) (HTTP client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_ui["Marketplace screens"]
  node_jobdetail["Job detail<br/>[jobs_.$jobId.tsx]"]
  node_authstate["Auth state<br/>[AuthContext.tsx]"]
  node_theme["Theme state<br/>[ThemeContext.tsx]"]
  node_jobapi["Jobs API client<br/>[jobs.ts]"]
  node_appapi["Applications API client<br/>[applications.ts]"]
  node_authapi["Auth API client<br/>[auth.ts]"]
  node_httpclient["HTTP client<br/>[client.ts]"]
end

subgraph group_api["API boundary"]
  node_server["Express server<br/>[server.js]"]
  node_routes["API routes"]
  node_middleware["Auth and upload"]
  node_jobcontroller["Job controller<br/>[jobController.js]"]
  node_authcontroller["Auth controller<br/>[authController.js]"]
  node_appcontroller["Application controller"]
end

subgraph group_domain["Application logic"]
  node_jobcases["Job use cases"]
  node_authcases["Account and CV use cases"]
  node_appcases["Application use cases"]
  node_entities["Domain entities"]
end

subgraph group_storage["Mongo persistence"]
  node_jobrepo["Job repository"]
  node_userrepo["User repository"]
  node_apprepo["Application repository"]
  node_mongodb[("MongoDB")]
end

node_candidate(("Candidate"))
node_recruiter(("Recruiter"))

node_candidate -.->|"uses"| node_ui
node_recruiter -.->|"uses"| node_ui
node_ui -.->|"opens listings"| node_jobdetail
node_jobdetail -->|"loads jobs"| node_jobapi
node_jobdetail -->|"manages applications"| node_appapi
node_jobdetail -->|"loads candidate"| node_authapi
node_jobdetail -->|"reads and updates"| node_authstate
node_jobdetail -->|"reads theme"| node_theme
node_jobapi -->|"sends requests"| node_httpclient
node_appapi -->|"sends requests"| node_httpclient
node_authapi -->|"sends requests"| node_httpclient
node_httpclient -.->|"calls API"| node_server
node_server -->|"mounts routes"| node_routes
node_routes -->|"runs middleware"| node_middleware
node_routes -.->|"routes job requests"| node_jobcontroller
node_routes -->|"routes account requests"| node_authcontroller
node_routes -->|"routes applications"| node_appcontroller
node_jobcontroller -->|"executes"| node_jobcases
node_authcontroller -->|"executes"| node_authcases
node_appcontroller -->|"executes"| node_appcases
node_jobcontroller -->|"constructs repository"| node_jobrepo
node_appcontroller -->|"constructs repository"| node_apprepo
node_appcontroller -->|"constructs repository"| node_jobrepo
node_authcontroller -->|"constructs repository"| node_userrepo
node_jobcases -->|"creates listings"| node_entities
node_appcases -->|"creates applications"| node_entities
node_jobrepo -->|"reads and writes"| node_mongodb
node_userrepo -.->|"reads and writes"| node_mongodb
node_apprepo -.->|"reads and writes"| node_mongodb

click node_ui "https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/frontend/src/routes"
click node_jobdetail "https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/routes/jobs_.%24jobId.tsx"
click node_authstate "https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/context/AuthContext.tsx"
click node_theme "https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/context/ThemeContext.tsx"
click node_jobapi "https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/api/jobs.ts"
click node_appapi "https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/api/applications.ts"
click node_authapi "https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/api/auth.ts"
click node_httpclient "https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/api/client.ts"
click node_server "https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/server.js"
click node_routes "https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/backend/src/infrastructure/web/routes"
click node_middleware "https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/backend/src/infrastructure/web/middleware"
click node_jobcontroller "https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/src/infrastructure/web/controllers/jobController.js"
click node_authcontroller "https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/src/infrastructure/web/controllers/authController.js"
click node_appcontroller "https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/src/infrastructure/web/controllers/applicationController.js"
click node_jobcases "https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/backend/src/application/use-cases"
click node_authcases "https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/backend/src/application/use-cases"
click node_appcases "https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/backend/src/application/use-cases"
click node_entities "https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/backend/src/domain/entities"
click node_jobrepo "https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/src/infrastructure/database/mongoose/repositories/MongoJobRepository.js"
click node_userrepo "https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/src/infrastructure/database/mongoose/repositories/MongoUserRepository.js"
click node_apprepo "https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/src/infrastructure/database/mongoose/repositories/MongoApplicationRepository.js"

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_ui,node_jobdetail,node_authstate,node_theme,node_jobapi,node_appapi,node_authapi,node_httpclient toneBlue
class node_server,node_routes,node_middleware,node_jobcontroller,node_authcontroller,node_appcontroller toneAmber
class node_jobcases,node_authcases,node_appcases,node_entities toneMint
class node_jobrepo,node_userrepo,node_apprepo,node_mongodb toneRose
class node_candidate,node_recruiter toneIndigo
```

## Components

### Web interface

- [Marketplace screens](https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/frontend/src/routes): `frontend/src/routes`
- [Job detail](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/routes/jobs_.%24jobId.tsx): `frontend/src/routes/jobs_.$jobId.tsx`
- [Auth state](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/context/AuthContext.tsx): `frontend/src/context/AuthContext.tsx`
- [Theme state](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/context/ThemeContext.tsx): `frontend/src/context/ThemeContext.tsx`
- [Jobs API client](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/api/jobs.ts): `frontend/src/api/jobs.ts`
- [Applications API client](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/api/applications.ts): `frontend/src/api/applications.ts`
- [Auth API client](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/api/auth.ts): `frontend/src/api/auth.ts`
- [HTTP client](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/frontend/src/api/client.ts): `frontend/src/api/client.ts`

### API boundary

- [Express server](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/server.js): `backend/server.js`
- [API routes](https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/backend/src/infrastructure/web/routes): `backend/src/infrastructure/web/routes`
- [Auth and upload](https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/backend/src/infrastructure/web/middleware): `backend/src/infrastructure/web/middleware`
- [Job controller](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/src/infrastructure/web/controllers/jobController.js): `backend/src/infrastructure/web/controllers/jobController.js`
- [Auth controller](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/src/infrastructure/web/controllers/authController.js): `backend/src/infrastructure/web/controllers/authController.js`
- [Application controller](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/src/infrastructure/web/controllers/applicationController.js): `backend/src/infrastructure/web/controllers/applicationController.js`

### Application logic

- [Job use cases](https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/backend/src/application/use-cases): `backend/src/application/use-cases`
- [Account and CV use cases](https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/backend/src/application/use-cases): `backend/src/application/use-cases`
- [Application use cases](https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/backend/src/application/use-cases): `backend/src/application/use-cases`
- [Domain entities](https://github.com/apetrovic2/diplomski-recruitment-app/tree/main/backend/src/domain/entities): `backend/src/domain/entities`

### Mongo persistence

- [Job repository](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/src/infrastructure/database/mongoose/repositories/MongoJobRepository.js): `backend/src/infrastructure/database/mongoose/repositories/MongoJobRepository.js`
- [User repository](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/src/infrastructure/database/mongoose/repositories/MongoUserRepository.js): `backend/src/infrastructure/database/mongoose/repositories/MongoUserRepository.js`
- [Application repository](https://github.com/apetrovic2/diplomski-recruitment-app/blob/main/backend/src/infrastructure/database/mongoose/repositories/MongoApplicationRepository.js): `backend/src/infrastructure/database/mongoose/repositories/MongoApplicationRepository.js`
- **MongoDB**

### Other components

- **Candidate**
- **Recruiter**

## Connections

- Candidate → Marketplace screens: uses
- Recruiter → Marketplace screens: uses
- Marketplace screens → Job detail: opens listings
- Job detail → Jobs API client: loads jobs (evidence: `frontend/src/routes/jobs_.$jobId.tsx`)
- Job detail → Applications API client: manages applications (evidence: `frontend/src/routes/jobs_.$jobId.tsx`)
- Job detail → Auth API client: loads candidate (evidence: `frontend/src/routes/jobs_.$jobId.tsx`)
- Job detail → Auth state: reads and updates (evidence: `frontend/src/routes/jobs_.$jobId.tsx`)
- Job detail → Theme state: reads theme (evidence: `frontend/src/routes/jobs_.$jobId.tsx`)
- Jobs API client → HTTP client: sends requests (evidence: `frontend/src/api/jobs.ts`)
- Applications API client → HTTP client: sends requests (evidence: `frontend/src/api/applications.ts`)
- Auth API client → HTTP client: sends requests (evidence: `frontend/src/api/auth.ts`)
- HTTP client → Express server: calls API
- Express server → API routes: mounts routes (evidence: `backend/server.js`)
- API routes → Auth and upload: runs middleware (evidence: `backend/src/infrastructure/web/routes/applicationRoutes.js`)
- API routes → Job controller: routes job requests (evidence: `backend/src/infrastructure/web/routes/jobRoutes.js`)
- API routes → Auth controller: routes account requests (evidence: `backend/src/infrastructure/web/routes/authRoutes.js`)
- API routes → Application controller: routes applications (evidence: `backend/src/infrastructure/web/routes/applicationRoutes.js`)
- Job controller → Job use cases: executes (evidence: `backend/src/infrastructure/web/controllers/jobController.js`)
- Auth controller → Account and CV use cases: executes (evidence: `backend/src/infrastructure/web/controllers/authController.js`)
- Application controller → Application use cases: executes (evidence: `backend/src/infrastructure/web/controllers/applicationController.js`)
- Job controller → Job repository: constructs repository (evidence: `backend/src/infrastructure/web/controllers/jobController.js`)
- Application controller → Application repository: constructs repository (evidence: `backend/src/infrastructure/web/controllers/applicationController.js`)
- Application controller → Job repository: constructs repository (evidence: `backend/src/infrastructure/web/controllers/applicationController.js`)
- Auth controller → User repository: constructs repository (evidence: `backend/src/infrastructure/web/controllers/authController.js`)
- Job use cases → Domain entities: creates listings (evidence: `backend/src/application/use-cases/CreateJobListing.js`)
- Application use cases → Domain entities: creates applications (evidence: `backend/src/application/use-cases/ApplyToJob.js`)
- Job repository → MongoDB: reads and writes (evidence: `backend/src/infrastructure/database/mongoose/repositories/MongoJobRepository.js`)
- User repository → MongoDB: reads and writes
- Application repository → MongoDB: reads and writes
