# gleblv/nestcourse architecture

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

- Interactive diagram: https://gitdiagram.com/gleblv/nestcourse
- Repository: https://github.com/gleblv/nestcourse

## Overview

This is a NestJS starter application with user and role domains backed by PostgreSQL. The visible user workflow accepts a create-user or list-users HTTP request, routes it through the users controller and service, and persists or reads user records. Role endpoints and service are currently empty; the models nevertheless define roles and a many-to-many user-role association. The source excerpts show user request handling and model relationships; wiring for startup is supported by the source index, while role behavior beyond its declarations is not evidenced.

Main entry points: [`src/app.module.ts`](https://github.com/gleblv/nestcourse/blob/main/src/app.module.ts) (App configuration), [`src/roles/roles.module.ts`](https://github.com/gleblv/nestcourse/blob/main/src/roles/roles.module.ts) (Roles module), [`src/users/users.module.ts`](https://github.com/gleblv/nestcourse/blob/main/src/users/users.module.ts) (Users module), [`src/users/users.controller.ts`](https://github.com/gleblv/nestcourse/blob/main/src/users/users.controller.ts) (Users API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application runtime"]
  node_bootstrap["Nest bootstrap<br/>[main.ts]"]
  node_app["App configuration<br/>[app.module.ts]"]
end

subgraph group_user["User management"]
  node_users_module["Users module<br/>[users.module.ts]"]
  node_users_controller["Users API"]
  node_create_dto["Create-user input<br/>[create-user.dto.ts]"]
  node_users_service["Users service<br/>[users.service.ts]"]
  node_user_model["User record<br/>[users.model.ts]"]
end

subgraph group_roles["Role domain"]
  node_roles_module["Roles module<br/>[roles.module.ts]"]
  node_roles_controller["Roles API"]
  node_roles_service["Roles service<br/>[roles.service.ts]"]
  node_role_model["Role record<br/>[roles.model.ts]"]
  node_user_roles_model["User-role link"]
end

node_client(("HTTP client"))
node_postgres[("PostgreSQL")]

node_client -->|"sends HTTP"| node_users_controller
node_users_controller -->|"accepts input"| node_create_dto
node_users_controller -->|"calls"| node_users_service
node_users_service -->|"creates and queries"| node_user_model
node_bootstrap -->|"loads"| node_app
node_app -->|"imports"| node_users_module
node_app -->|"imports"| node_roles_module
node_app -->|"configures connection"| node_postgres
node_app -->|"registers models"| node_user_model
node_app -->|"registers models"| node_role_model
node_app -->|"registers models"| node_user_roles_model
node_role_model -->|"associates through"| node_user_roles_model
node_user_model -->|"associates through"| node_user_roles_model
node_roles_module -->|"registers"| node_roles_controller
node_roles_module -->|"provides"| node_roles_service
node_roles_module -->|"registers model"| node_role_model
node_roles_module -->|"registers model"| node_user_roles_model
node_users_module -->|"registers"| node_users_controller
node_users_module -->|"provides"| node_users_service
node_users_module -->|"registers model"| node_user_model

click node_bootstrap "https://github.com/gleblv/nestcourse/blob/main/src/main.ts"
click node_app "https://github.com/gleblv/nestcourse/blob/main/src/app.module.ts"
click node_users_module "https://github.com/gleblv/nestcourse/blob/main/src/users/users.module.ts"
click node_users_controller "https://github.com/gleblv/nestcourse/blob/main/src/users/users.controller.ts"
click node_create_dto "https://github.com/gleblv/nestcourse/blob/main/src/users/dto/create-user.dto.ts"
click node_users_service "https://github.com/gleblv/nestcourse/blob/main/src/users/users.service.ts"
click node_user_model "https://github.com/gleblv/nestcourse/blob/main/src/users/users.model.ts"
click node_roles_module "https://github.com/gleblv/nestcourse/blob/main/src/roles/roles.module.ts"
click node_roles_controller "https://github.com/gleblv/nestcourse/blob/main/src/roles/roles.controller.ts"
click node_roles_service "https://github.com/gleblv/nestcourse/blob/main/src/roles/roles.service.ts"
click node_role_model "https://github.com/gleblv/nestcourse/blob/main/src/roles/roles.model.ts"
click node_user_roles_model "https://github.com/gleblv/nestcourse/blob/main/src/roles/user-roles.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_bootstrap,node_app,node_client toneBlue
class node_users_module,node_users_controller,node_create_dto,node_users_service,node_user_model,node_postgres toneAmber
class node_roles_module,node_roles_controller,node_roles_service,node_role_model,node_user_roles_model toneMint
```

## Components

### Application runtime

- [Nest bootstrap](https://github.com/gleblv/nestcourse/blob/main/src/main.ts): `src/main.ts`
- [App configuration](https://github.com/gleblv/nestcourse/blob/main/src/app.module.ts): `src/app.module.ts`

### User management

- [Users module](https://github.com/gleblv/nestcourse/blob/main/src/users/users.module.ts): `src/users/users.module.ts`
- [Users API](https://github.com/gleblv/nestcourse/blob/main/src/users/users.controller.ts): `src/users/users.controller.ts`
- [Create-user input](https://github.com/gleblv/nestcourse/blob/main/src/users/dto/create-user.dto.ts): `src/users/dto/create-user.dto.ts`
- [Users service](https://github.com/gleblv/nestcourse/blob/main/src/users/users.service.ts): `src/users/users.service.ts`
- [User record](https://github.com/gleblv/nestcourse/blob/main/src/users/users.model.ts): `src/users/users.model.ts`

### Role domain

- [Roles module](https://github.com/gleblv/nestcourse/blob/main/src/roles/roles.module.ts): `src/roles/roles.module.ts`
- [Roles API](https://github.com/gleblv/nestcourse/blob/main/src/roles/roles.controller.ts): `src/roles/roles.controller.ts`
- [Roles service](https://github.com/gleblv/nestcourse/blob/main/src/roles/roles.service.ts): `src/roles/roles.service.ts`
- [Role record](https://github.com/gleblv/nestcourse/blob/main/src/roles/roles.model.ts): `src/roles/roles.model.ts`
- [User-role link](https://github.com/gleblv/nestcourse/blob/main/src/roles/user-roles.model.ts): `src/roles/user-roles.model.ts`

### Other components

- **HTTP client**
- **PostgreSQL**

## Connections

- HTTP client → Users API: sends HTTP (evidence: `src/users/users.controller.ts`)
- Users API → Create-user input: accepts input (evidence: `src/users/users.controller.ts`)
- Users API → Users service: calls (evidence: `src/users/users.controller.ts`)
- Users service → User record: creates and queries (evidence: `src/users/users.service.ts`)
- Nest bootstrap → App configuration: loads (evidence: `src/main.ts`)
- App configuration → Users module: imports (evidence: `src/app.module.ts`)
- App configuration → Roles module: imports (evidence: `src/app.module.ts`)
- App configuration → PostgreSQL: configures connection (evidence: `src/app.module.ts`)
- App configuration → User record: registers models (evidence: `src/app.module.ts`)
- App configuration → Role record: registers models (evidence: `src/app.module.ts`)
- App configuration → User-role link: registers models (evidence: `src/app.module.ts`)
- Role record → User-role link: associates through (evidence: `src/roles/roles.model.ts`)
- User record → User-role link: associates through (evidence: `src/users/users.model.ts`)
- Roles module → Roles API: registers (evidence: `src/roles/roles.module.ts`)
- Roles module → Roles service: provides (evidence: `src/roles/roles.module.ts`)
- Roles module → Role record: registers model (evidence: `src/roles/roles.module.ts`)
- Roles module → User-role link: registers model (evidence: `src/roles/roles.module.ts`)
- Users module → Users API: registers (evidence: `src/users/users.module.ts`)
- Users module → Users service: provides (evidence: `src/users/users.module.ts`)
- Users module → User record: registers model (evidence: `src/users/users.module.ts`)
