# nochn0i/backend-news-portal---v1 architecture

> Architecture diagram of the GitHub repository nochn0i/backend-news-portal---v1, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nochn0i/backend-news-portal---v1
- Repository: https://github.com/nochn0i/backend-news-portal---v1

## Overview

Backend News Portal is a Node.js/MongoDB API for user accounts, role-specific profiles, and news content. A client request enters the Express API, is routed to a controller, and—where shown—delegates to services that validate or process domain operations and use repositories for persistence. Authentication includes password checks and JWT support; user creation persists user, role profile, and permissions transactionally. The README identifies MongoDB as the database. Some route-handler wiring and profile/content operations are represented only by the source index, so uncertain links are omitted or dashed.

Main entry points: [`src/repository/user.repository.ts`](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/repository/user.repository.ts) (User repository), [`src/api.router.ts`](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/api.router.ts) (API router), [`src/config/class/app.class.ts`](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/config/class/app.class.ts) (Express app), [`src/controllers/content/blog.controller.ts`](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/controllers/content/blog.controller.ts) (Blog controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["HTTP runtime"]
  node_app["Express app<br/>[app.class.ts]"]
  node_api["API router<br/>[api.router.ts]"]
  node_user_routes["User routes<br/>[user.route.ts]"]
  node_profile_routes["Profile routes<br/>[profile.route.ts]"]
  node_content_routes["Content routes<br/>[content.route.ts]"]
  node_user_controller["User controller<br/>[user.controller.ts]"]
  node_auth_controller["Auth controller<br/>[auth.controller.ts]"]
  node_blog_controller["Blog controller<br/>[blog.controller.ts]"]
  node_profile_controller["Profile controller"]
end

subgraph group_identity["Identity and access"]
  node_auth_service["Authentication<br/>[auth.service.ts]"]
  node_user_service["User operations<br/>[user.service.ts]"]
  node_profile_service["Profile operations<br/>[profile.service.ts]"]
  node_role_profiles["Role profiles"]
  node_permissions["Permission rules"]
end

subgraph group_editorial["Editorial content"]
  node_blog_service["Blog operations<br/>[blog.service.ts]"]
  node_blog_query["Blog search"]
end

subgraph group_persistence["Domain persistence"]
  node_user_repository["User repository<br/>[user.repository.ts]"]
  node_profile_repository["Profile repository"]
  node_blog_repository["Blog repository<br/>[blog.repository.ts]"]
  node_blog_query_repository["Blog query repository"]
  node_user_model[("User model<br/>[user.model.ts]")]
  node_profile_models[("Role profile models")]
  node_blog_model[("Blog model<br/>[blog.model.ts]")]
  node_permission_model[("Permission model")]
end

node_client(("API client"))
node_mongo[("MongoDB")]

node_client -->|"sends request"| node_app
node_app -->|"mounts API"| node_api
node_api -->|"registers routes"| node_user_routes
node_api -->|"registers routes"| node_profile_routes
node_api -->|"registers routes"| node_content_routes
node_user_routes -.->|"dispatches to"| node_user_controller
node_profile_routes -.->|"dispatches to"| node_profile_controller
node_content_routes -.->|"dispatches to"| node_blog_controller
node_user_controller -->|"calls"| node_user_service
node_auth_controller -->|"calls"| node_auth_service
node_blog_controller -->|"calls"| node_blog_service
node_blog_controller -->|"calls"| node_blog_query
node_profile_controller -->|"calls"| node_profile_service
node_profile_controller -->|"calls role services"| node_role_profiles
node_auth_service -->|"looks up user"| node_user_repository
node_user_service -->|"uses"| node_user_repository
node_user_service -->|"uses"| node_profile_repository
node_user_repository -->|"queries and writes"| node_user_model
node_user_repository -->|"creates role profile"| node_profile_models
node_user_repository -->|"creates permissions"| node_permission_model
node_blog_service -->|"uses"| node_blog_repository
node_blog_query -->|"queries"| node_blog_query_repository
node_blog_query_repository -->|"queries"| node_blog_model
node_blog_repository -.->|"uses"| node_blog_model
node_profile_repository -.->|"uses"| node_profile_models
node_app -->|"connects through database config"| node_mongo

click node_app "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/config/class/app.class.ts"
click node_api "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/api.router.ts"
click node_user_routes "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/routes/user.route.ts"
click node_profile_routes "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/routes/profile.route.ts"
click node_content_routes "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/routes/content.route.ts"
click node_user_controller "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/controllers/user.controller.ts"
click node_auth_controller "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/controllers/auth.controller.ts"
click node_blog_controller "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/controllers/content/blog.controller.ts"
click node_profile_controller "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/controllers/profile.controller.ts"
click node_auth_service "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/services/auth.service.ts"
click node_user_service "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/services/user.service.ts"
click node_profile_service "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/services/profile.service.ts"
click node_role_profiles "https://github.com/nochn0i/backend-news-portal---v1/tree/main/src/services/profile"
click node_permissions "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/core/permissions.core.ts"
click node_blog_service "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/services/content/blog.service.ts"
click node_blog_query "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/services/content-query/blog.query.service.ts"
click node_user_repository "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/repository/user.repository.ts"
click node_profile_repository "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/repository/profile.repository.ts"
click node_blog_repository "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/repository/content/blog.repository.ts"
click node_blog_query_repository "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/repository/content-query/blog.query.repository.ts"
click node_user_model "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/models/user.model.ts"
click node_profile_models "https://github.com/nochn0i/backend-news-portal---v1/tree/main/src/models/profile"
click node_blog_model "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/models/content/blog.model.ts"
click node_permission_model "https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/models/permission.model.ts"

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_app,node_api,node_user_routes,node_profile_routes,node_content_routes,node_user_controller,node_auth_controller,node_blog_controller,node_profile_controller,node_client toneBlue
class node_auth_service,node_user_service,node_profile_service,node_role_profiles,node_permissions,node_mongo toneAmber
class node_blog_service,node_blog_query toneMint
class node_user_repository,node_profile_repository,node_blog_repository,node_blog_query_repository,node_user_model,node_profile_models,node_blog_model,node_permission_model toneRose
```

## Components

### HTTP runtime

- [Express app](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/config/class/app.class.ts): `src/config/class/app.class.ts`
- [API router](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/api.router.ts): `src/api.router.ts`
- [User routes](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/routes/user.route.ts): `src/routes/user.route.ts`
- [Profile routes](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/routes/profile.route.ts): `src/routes/profile.route.ts`
- [Content routes](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/routes/content.route.ts): `src/routes/content.route.ts`
- [User controller](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/controllers/user.controller.ts): `src/controllers/user.controller.ts`
- [Auth controller](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/controllers/auth.controller.ts): `src/controllers/auth.controller.ts`
- [Blog controller](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/controllers/content/blog.controller.ts): `src/controllers/content/blog.controller.ts`
- [Profile controller](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/controllers/profile.controller.ts): `src/controllers/profile.controller.ts`

### Identity and access

- [Authentication](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/services/auth.service.ts): `src/services/auth.service.ts`
- [User operations](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/services/user.service.ts): `src/services/user.service.ts`
- [Profile operations](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/services/profile.service.ts): `src/services/profile.service.ts`
- [Role profiles](https://github.com/nochn0i/backend-news-portal---v1/tree/main/src/services/profile): `src/services/profile`
- [Permission rules](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/core/permissions.core.ts): `src/core/permissions.core.ts`

### Editorial content

- [Blog operations](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/services/content/blog.service.ts): `src/services/content/blog.service.ts`
- [Blog search](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/services/content-query/blog.query.service.ts): `src/services/content-query/blog.query.service.ts`

### Domain persistence

- [User repository](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/repository/user.repository.ts): `src/repository/user.repository.ts`
- [Profile repository](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/repository/profile.repository.ts): `src/repository/profile.repository.ts`
- [Blog repository](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/repository/content/blog.repository.ts): `src/repository/content/blog.repository.ts`
- [Blog query repository](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/repository/content-query/blog.query.repository.ts): `src/repository/content-query/blog.query.repository.ts`
- [User model](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/models/user.model.ts): `src/models/user.model.ts`
- [Role profile models](https://github.com/nochn0i/backend-news-portal---v1/tree/main/src/models/profile): `src/models/profile`
- [Blog model](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/models/content/blog.model.ts): `src/models/content/blog.model.ts`
- [Permission model](https://github.com/nochn0i/backend-news-portal---v1/blob/main/src/models/permission.model.ts): `src/models/permission.model.ts`

### Other components

- **API client**
- **MongoDB**

## Connections

- API client → Express app: sends request (evidence: `src/config/class/app.class.ts`)
- Express app → API router: mounts API (evidence: `src/config/class/app.class.ts`)
- API router → User routes: registers routes (evidence: `src/api.router.ts`)
- API router → Profile routes: registers routes (evidence: `src/api.router.ts`)
- API router → Content routes: registers routes (evidence: `src/api.router.ts`)
- User routes → User controller: dispatches to
- Profile routes → Profile controller: dispatches to
- Content routes → Blog controller: dispatches to
- User controller → User operations: calls (evidence: `src/controllers/user.controller.ts`)
- Auth controller → Authentication: calls (evidence: `src/controllers/auth.controller.ts`)
- Blog controller → Blog operations: calls (evidence: `src/controllers/content/blog.controller.ts`)
- Blog controller → Blog search: calls (evidence: `src/controllers/content/blog.controller.ts`)
- Profile controller → Profile operations: calls (evidence: `src/controllers/profile.controller.ts`)
- Profile controller → Role profiles: calls role services (evidence: `src/controllers/profile.controller.ts`)
- Authentication → User repository: looks up user (evidence: `src/services/auth.service.ts`)
- User operations → User repository: uses (evidence: `src/services/user.service.ts`)
- User operations → Profile repository: uses (evidence: `src/services/user.service.ts`)
- User repository → User model: queries and writes (evidence: `src/repository/user.repository.ts`)
- User repository → Role profile models: creates role profile (evidence: `src/repository/user.repository.ts`)
- User repository → Permission model: creates permissions (evidence: `src/repository/user.repository.ts`)
- Blog operations → Blog repository: uses (evidence: `src/services/content/blog.service.ts`)
- Blog search → Blog query repository: queries (evidence: `src/services/content-query/blog.query.service.ts`)
- Blog query repository → Blog model: queries (evidence: `src/repository/content-query/blog.query.repository.ts`)
- Blog repository → Blog model: uses
- Profile repository → Role profile models: uses
- Express app → MongoDB: connects through database config
