# arben-djokovic/radnik-app-backend-api architecture

> Architecture diagram of the GitHub repository arben-djokovic/radnik-app-backend-api, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/arben-djokovic/radnik-app-backend-api
- Repository: https://github.com/arben-djokovic/radnik-app-backend-api

## Overview

DoRadnika.me is a REST marketplace API for clients and local tradespeople. Its main workflow is: a client posts a job, workers apply, the client selects a worker, and the parties complete the job and review one another. The API also supports accounts, worker portfolios, notifications, moderation, and public discovery. The graph uses README-documented workflow links and source-index references; unsampled modules are represented only where the tree or index supports them, so some internal call details are omitted.

Main entry points: [`controllers/application.controller.js`](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/application.controller.js) (Application handling), [`app.js`](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/app.js) (Express API), [`controllers/review.controller.js`](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/review.controller.js) (Review handling), [`controllers/job.controller.js`](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/job.controller.js) (Job handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts and access"]
  node_user_routes["Account routes<br/>[user.routes.js]"]
  node_user_controller["Account handling<br/>[user.controller.js]"]
  node_user_model[("User records<br/>[user.model.js]")]
  node_auth_helpers["Session and email helpers<br/>[index.js]"]
end

subgraph group_marketplace["Jobs and applications"]
  node_job_routes["Job routes<br/>[job.routes.js]"]
  node_job_controller["Job handling<br/>[job.controller.js]"]
  node_job_model[("Job records<br/>[job.model.js]")]
  node_application_routes["Application routes"]
  node_application_controller["Application handling"]
  node_application_model[("Application records")]
  node_category_controller["Category handling"]
  node_category_model[("Category records<br/>[category.model.js]")]
end

subgraph group_reputation["Reviews and portfolio"]
  node_review_routes["Review routes<br/>[review.routes.js]"]
  node_review_controller["Review handling"]
  node_review_model[("Review records<br/>[review.model.js]")]
  node_rating["Rating calculations<br/>[rating.js]"]
  node_portfolio_controller["Work portfolio handling"]
  node_portfolio_model[("Portfolio records<br/>[workImage.model.js]")]
  node_image_storage["Image processing and storage<br/>[images.js]"]
end

subgraph group_operations["Notifications and moderation"]
  node_notification_controller["Notification handling"]
  node_notification_helpers["Push and email delivery<br/>[index.js]"]
  node_report_controller["Report moderation"]
  node_report_model[("Report records<br/>[report.model.js]")]
  node_expiry["Expiry and reminders<br/>[expiry.js]"]
end

subgraph group_discovery["Public discovery"]
  node_public_endpoints["Public listings and metadata"]
end

node_visitor(("Client or worker"))
node_api["Express API<br/>[app.js]"]

node_visitor -->|"sends requests"| node_api
node_api -->|"mounts routes"| node_user_routes
node_api -->|"mounts routes"| node_job_routes
node_api -->|"mounts routes"| node_application_routes
node_api -->|"mounts routes"| node_review_routes
node_user_routes -->|"dispatches to"| node_user_controller
node_user_controller -->|"uses records"| node_user_model
node_user_controller -->|"uses helpers"| node_auth_helpers
node_job_routes -->|"dispatches to"| node_job_controller
node_job_controller -->|"reads and writes"| node_job_model
node_job_controller -->|"looks up categories"| node_category_model
node_job_controller -->|"uploads job images"| node_image_storage
node_application_routes -->|"dispatches to"| node_application_controller
node_application_controller -->|"reads and writes"| node_application_model
node_application_controller -->|"creates reviews"| node_review_model
node_application_controller -->|"updates worker rating"| node_rating
node_application_controller -->|"uploads review images"| node_image_storage
node_application_controller -->|"notifies users"| node_auth_helpers
node_review_routes -->|"dispatches to"| node_review_controller
node_review_controller -->|"updates reviews"| node_review_model
node_review_controller -->|"adjusts worker rating"| node_rating
node_review_controller -->|"uploads review images"| node_image_storage
node_review_controller -->|"notifies reviewer"| node_auth_helpers
node_portfolio_controller -->|"stores portfolio entries"| node_portfolio_model
node_portfolio_controller -->|"manages images"| node_image_storage
node_notification_controller -->|"uses delivery helpers"| node_notification_helpers
node_report_controller -->|"records reports"| node_report_model
node_api -->|"serves public endpoints"| node_public_endpoints
node_visitor -->|"posts and searches jobs"| node_job_controller
node_visitor -->|"applies and selects"| node_application_controller
node_visitor -->|"rates after jobs"| node_review_controller

click node_api "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/app.js"
click node_user_routes "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/routes/user.routes.js"
click node_user_controller "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/user.controller.js"
click node_user_model "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/models/user.model.js"
click node_auth_helpers "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/config/index.js"
click node_job_routes "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/routes/job.routes.js"
click node_job_controller "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/job.controller.js"
click node_job_model "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/models/job.model.js"
click node_application_routes "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/routes/application.routes.js"
click node_application_controller "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/application.controller.js"
click node_application_model "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/models/application.model.js"
click node_category_controller "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/category.controller.js"
click node_category_model "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/models/category.model.js"
click node_review_routes "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/routes/review.routes.js"
click node_review_controller "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/review.controller.js"
click node_review_model "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/models/review.model.js"
click node_rating "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/config/rating.js"
click node_portfolio_controller "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/workImage.controller.js"
click node_portfolio_model "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/models/workImage.model.js"
click node_image_storage "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/config/images.js"
click node_notification_controller "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/notification.controller.js"
click node_notification_helpers "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/config/index.js"
click node_report_controller "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/report.controller.js"
click node_report_model "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/models/report.model.js"
click node_expiry "https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/config/expiry.js"
click node_public_endpoints "https://github.com/arben-djokovic/radnik-app-backend-api/tree/main/controllers"

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_user_routes,node_user_controller,node_user_model,node_auth_helpers toneBlue
class node_job_routes,node_job_controller,node_job_model,node_application_routes,node_application_controller,node_application_model,node_category_controller,node_category_model toneAmber
class node_review_routes,node_review_controller,node_review_model,node_rating,node_portfolio_controller,node_portfolio_model,node_image_storage,node_api toneMint
class node_notification_controller,node_notification_helpers,node_report_controller,node_report_model,node_expiry,node_visitor toneRose
class node_public_endpoints toneIndigo
```

## Components

### Accounts and access

- [Account routes](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/routes/user.routes.js): `routes/user.routes.js`
- [Account handling](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/user.controller.js): `controllers/user.controller.js`
- [User records](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/models/user.model.js): `models/user.model.js`
- [Session and email helpers](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/config/index.js): `config/index.js`

### Jobs and applications

- [Job routes](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/routes/job.routes.js): `routes/job.routes.js`
- [Job handling](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/job.controller.js): `controllers/job.controller.js`
- [Job records](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/models/job.model.js): `models/job.model.js`
- [Application routes](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/routes/application.routes.js): `routes/application.routes.js`
- [Application handling](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/application.controller.js): `controllers/application.controller.js`
- [Application records](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/models/application.model.js): `models/application.model.js`
- [Category handling](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/category.controller.js): `controllers/category.controller.js`
- [Category records](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/models/category.model.js): `models/category.model.js`

### Reviews and portfolio

- [Review routes](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/routes/review.routes.js): `routes/review.routes.js`
- [Review handling](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/review.controller.js): `controllers/review.controller.js`
- [Review records](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/models/review.model.js): `models/review.model.js`
- [Rating calculations](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/config/rating.js): `config/rating.js`
- [Work portfolio handling](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/workImage.controller.js): `controllers/workImage.controller.js`
- [Portfolio records](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/models/workImage.model.js): `models/workImage.model.js`
- [Image processing and storage](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/config/images.js): `config/images.js`

### Notifications and moderation

- [Notification handling](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/notification.controller.js): `controllers/notification.controller.js`
- [Push and email delivery](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/config/index.js): `config/index.js`
- [Report moderation](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/controllers/report.controller.js): `controllers/report.controller.js`
- [Report records](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/models/report.model.js): `models/report.model.js`
- [Expiry and reminders](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/config/expiry.js): `config/expiry.js`

### Public discovery

- [Public listings and metadata](https://github.com/arben-djokovic/radnik-app-backend-api/tree/main/controllers): `controllers`

### Other components

- **Client or worker**
- [Express API](https://github.com/arben-djokovic/radnik-app-backend-api/blob/main/app.js): `app.js`

## Connections

- Client or worker → Express API: sends requests (evidence: `README.md`)
- Express API → Account routes: mounts routes (evidence: `app.js`)
- Express API → Job routes: mounts routes (evidence: `app.js`)
- Express API → Application routes: mounts routes (evidence: `app.js`)
- Express API → Review routes: mounts routes (evidence: `app.js`)
- Account routes → Account handling: dispatches to (evidence: `routes/user.routes.js`)
- Account handling → User records: uses records (evidence: `controllers/user.controller.js`)
- Account handling → Session and email helpers: uses helpers (evidence: `controllers/user.controller.js`)
- Job routes → Job handling: dispatches to (evidence: `routes/job.routes.js`)
- Job handling → Job records: reads and writes (evidence: `controllers/job.controller.js`)
- Job handling → Category records: looks up categories (evidence: `controllers/job.controller.js`)
- Job handling → Image processing and storage: uploads job images (evidence: `controllers/job.controller.js`)
- Application routes → Application handling: dispatches to (evidence: `routes/application.routes.js`)
- Application handling → Application records: reads and writes (evidence: `controllers/application.controller.js`)
- Application handling → Review records: creates reviews (evidence: `controllers/application.controller.js`)
- Application handling → Rating calculations: updates worker rating (evidence: `controllers/application.controller.js`)
- Application handling → Image processing and storage: uploads review images (evidence: `controllers/application.controller.js`)
- Application handling → Session and email helpers: notifies users (evidence: `controllers/application.controller.js`)
- Review routes → Review handling: dispatches to (evidence: `routes/review.routes.js`)
- Review handling → Review records: updates reviews (evidence: `controllers/review.controller.js`)
- Review handling → Rating calculations: adjusts worker rating (evidence: `controllers/review.controller.js`)
- Review handling → Image processing and storage: uploads review images (evidence: `controllers/review.controller.js`)
- Review handling → Session and email helpers: notifies reviewer (evidence: `controllers/review.controller.js`)
- Work portfolio handling → Portfolio records: stores portfolio entries (evidence: `controllers/workImage.controller.js`)
- Work portfolio handling → Image processing and storage: manages images (evidence: `controllers/workImage.controller.js`)
- Notification handling → Push and email delivery: uses delivery helpers (evidence: `controllers/notification.controller.js`)
- Report moderation → Report records: records reports (evidence: `controllers/report.controller.js`)
- Express API → Public listings and metadata: serves public endpoints (evidence: `app.js`)
- Client or worker → Job handling: posts and searches jobs (evidence: `README.md`)
- Client or worker → Application handling: applies and selects (evidence: `README.md`)
- Client or worker → Review handling: rates after jobs (evidence: `README.md`)
