# dhia-eddine/cobot_control_backend architecture

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

- Interactive diagram: https://gitdiagram.com/dhia-eddine/cobot_control_backend
- Repository: https://github.com/dhia-eddine/cobot_control_backend

## Overview

This is a NestJS API for users and authentication, cobot management, trajectory records, and KPI generation and summaries. The principal workflow is an authenticated client request routed through a controller to a service, which reads or writes relational entities; KPI routes also generate periodic records and summaries. Authentication issues JWTs and guards protected endpoints. The README is only the generic Nest starter description, so product capabilities are inferred from the source index and excerpts; unsampled module wiring and persistence configuration are not detailed here.

Main entry points: [`src/app.module.ts`](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/app.module.ts) (Application modules), [`src/users/users.service.ts`](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/users/users.service.ts) (User management), [`src/auth/guards/auth.guard.ts`](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/auth/guards/auth.guard.ts) (JWT access guard), [`src/cobots/cobots.service.ts`](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/cobots/cobots.service.ts) (Cobot management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API runtime"]
  node_bootstrap["Server bootstrap<br/>[main.ts]"]
  node_app["Application modules<br/>[app.module.ts]"]
end

subgraph group_identity["Identity and access"]
  node_auth_routes["Auth routes<br/>[auth.controller.ts]"]
  node_auth_logic["Token and login logic<br/>[auth.service.ts]"]
  node_auth_guard["JWT access guard<br/>[auth.guard.ts]"]
  node_jwt_strategy["JWT strategy<br/>[jwt.strategy.ts]"]
  node_users_routes["User routes"]
  node_users_logic["User management<br/>[users.service.ts]"]
  node_user_entity["User record<br/>[user.entity.ts]"]
end

subgraph group_cobot_domain["Cobot management"]
  node_cobot_routes["Cobot routes"]
  node_cobot_logic["Cobot management<br/>[cobots.service.ts]"]
  node_cobot_entity["Cobot record<br/>[cobot.entity.ts]"]
end

subgraph group_operations["Operations data"]
  node_trajectory_routes["Trajectory routes"]
  node_trajectory_logic["Trajectory management"]
  node_trajectory_entity["Trajectory record"]
  node_kpi_routes["KPI routes<br/>[kpis.controller.ts]"]
  node_kpi_logic["KPI generation and summaries<br/>[kpis.service.ts]"]
  node_kpi_entity["KPI record<br/>[kpi.entity.ts]"]
end

node_client(("API client"))
node_database[("Relational database")]

node_client -->|"sends requests"| node_bootstrap
node_bootstrap -->|"starts"| node_app
node_app -->|"registers"| node_auth_routes
node_app -->|"registers"| node_users_routes
node_app -->|"registers"| node_cobot_routes
node_app -->|"registers"| node_trajectory_routes
node_app -->|"registers"| node_kpi_routes
node_auth_routes -->|"delegates to"| node_auth_logic
node_auth_logic -->|"looks up users"| node_users_logic
node_auth_logic -->|"validates credentials"| node_user_entity
node_auth_routes -->|"guards signup"| node_auth_guard
node_cobot_routes -->|"guards routes"| node_auth_guard
node_trajectory_routes -->|"guards routes"| node_auth_guard
node_users_routes -->|"guards routes"| node_auth_guard
node_auth_guard -.->|"uses strategy"| node_jwt_strategy
node_jwt_strategy -->|"loads user"| node_users_logic
node_users_routes -->|"delegates to"| node_users_logic
node_users_logic -->|"persists users"| node_user_entity
node_cobot_routes -->|"delegates to"| node_cobot_logic
node_cobot_logic -->|"resolves creator"| node_users_logic
node_cobot_logic -->|"persists cobots"| node_cobot_entity
node_trajectory_routes -->|"delegates to"| node_trajectory_logic
node_trajectory_logic -->|"persists trajectories"| node_trajectory_entity
node_trajectory_logic -->|"looks up cobot"| node_cobot_entity
node_kpi_routes -->|"delegates to"| node_kpi_logic
node_kpi_logic -->|"persists KPIs"| node_kpi_entity
node_kpi_logic -->|"looks up cobot"| node_cobot_entity
node_users_logic -->|"reads and writes"| node_database
node_cobot_logic -->|"reads and writes"| node_database
node_trajectory_logic -->|"reads and writes"| node_database
node_kpi_logic -->|"reads and writes"| node_database

click node_bootstrap "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/main.ts"
click node_app "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/app.module.ts"
click node_auth_routes "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/auth/auth.controller.ts"
click node_auth_logic "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/auth/auth.service.ts"
click node_auth_guard "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/auth/guards/auth.guard.ts"
click node_jwt_strategy "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/auth/jwt.strategy.ts"
click node_users_routes "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/users/users.controller.ts"
click node_users_logic "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/users/users.service.ts"
click node_user_entity "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/users/user.entity.ts"
click node_cobot_routes "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/cobots/cobots.controller.ts"
click node_cobot_logic "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/cobots/cobots.service.ts"
click node_cobot_entity "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/cobots/cobot.entity.ts"
click node_trajectory_routes "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/trajectories/trajectories.controller.ts"
click node_trajectory_logic "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/trajectories/trajectories.service.ts"
click node_trajectory_entity "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/trajectories/trajectory.entity.ts"
click node_kpi_routes "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/kpi/kpis.controller.ts"
click node_kpi_logic "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/kpi/kpis.service.ts"
click node_kpi_entity "https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/kpi/kpi.entity.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_auth_routes,node_auth_logic,node_auth_guard,node_jwt_strategy,node_users_routes,node_users_logic,node_user_entity,node_database toneAmber
class node_cobot_routes,node_cobot_logic,node_cobot_entity toneMint
class node_trajectory_routes,node_trajectory_logic,node_trajectory_entity,node_kpi_routes,node_kpi_logic,node_kpi_entity toneRose
```

## Components

### API runtime

- [Server bootstrap](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/main.ts): `src/main.ts`
- [Application modules](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/app.module.ts): `src/app.module.ts`

### Identity and access

- [Auth routes](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/auth/auth.controller.ts): `src/auth/auth.controller.ts`
- [Token and login logic](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/auth/auth.service.ts): `src/auth/auth.service.ts`
- [JWT access guard](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/auth/guards/auth.guard.ts): `src/auth/guards/auth.guard.ts`
- [JWT strategy](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/auth/jwt.strategy.ts): `src/auth/jwt.strategy.ts`
- [User routes](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/users/users.controller.ts): `src/users/users.controller.ts`
- [User management](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/users/users.service.ts): `src/users/users.service.ts`
- [User record](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/users/user.entity.ts): `src/users/user.entity.ts`

### Cobot management

- [Cobot routes](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/cobots/cobots.controller.ts): `src/cobots/cobots.controller.ts`
- [Cobot management](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/cobots/cobots.service.ts): `src/cobots/cobots.service.ts`
- [Cobot record](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/cobots/cobot.entity.ts): `src/cobots/cobot.entity.ts`

### Operations data

- [Trajectory routes](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/trajectories/trajectories.controller.ts): `src/trajectories/trajectories.controller.ts`
- [Trajectory management](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/trajectories/trajectories.service.ts): `src/trajectories/trajectories.service.ts`
- [Trajectory record](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/trajectories/trajectory.entity.ts): `src/trajectories/trajectory.entity.ts`
- [KPI routes](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/kpi/kpis.controller.ts): `src/kpi/kpis.controller.ts`
- [KPI generation and summaries](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/kpi/kpis.service.ts): `src/kpi/kpis.service.ts`
- [KPI record](https://github.com/dhia-eddine/cobot_control_backend/blob/main/src/kpi/kpi.entity.ts): `src/kpi/kpi.entity.ts`

### Other components

- **API client**
- **Relational database**

## Connections

- API client → Server bootstrap: sends requests (evidence: `src/main.ts`)
- Server bootstrap → Application modules: starts (evidence: `src/main.ts`)
- Application modules → Auth routes: registers (evidence: `src/app.module.ts`)
- Application modules → User routes: registers (evidence: `src/app.module.ts`)
- Application modules → Cobot routes: registers (evidence: `src/app.module.ts`)
- Application modules → Trajectory routes: registers (evidence: `src/app.module.ts`)
- Application modules → KPI routes: registers (evidence: `src/app.module.ts`)
- Auth routes → Token and login logic: delegates to (evidence: `src/auth/auth.controller.ts`)
- Token and login logic → User management: looks up users (evidence: `src/auth/auth.service.ts`)
- Token and login logic → User record: validates credentials (evidence: `src/auth/auth.service.ts`)
- Auth routes → JWT access guard: guards signup (evidence: `src/auth/auth.controller.ts`)
- Cobot routes → JWT access guard: guards routes (evidence: `src/cobots/cobots.controller.ts`)
- Trajectory routes → JWT access guard: guards routes (evidence: `src/trajectories/trajectories.controller.ts`)
- User routes → JWT access guard: guards routes (evidence: `src/users/users.controller.ts`)
- JWT access guard → JWT strategy: uses strategy
- JWT strategy → User management: loads user (evidence: `src/auth/jwt.strategy.ts`)
- User routes → User management: delegates to (evidence: `src/users/users.controller.ts`)
- User management → User record: persists users (evidence: `src/users/users.service.ts`)
- Cobot routes → Cobot management: delegates to (evidence: `src/cobots/cobots.controller.ts`)
- Cobot management → User management: resolves creator (evidence: `src/cobots/cobots.service.ts`)
- Cobot management → Cobot record: persists cobots (evidence: `src/cobots/cobots.service.ts`)
- Trajectory routes → Trajectory management: delegates to (evidence: `src/trajectories/trajectories.controller.ts`)
- Trajectory management → Trajectory record: persists trajectories (evidence: `src/trajectories/trajectories.service.ts`)
- Trajectory management → Cobot record: looks up cobot (evidence: `src/trajectories/trajectories.service.ts`)
- KPI routes → KPI generation and summaries: delegates to (evidence: `src/kpi/kpis.controller.ts`)
- KPI generation and summaries → KPI record: persists KPIs (evidence: `src/kpi/kpis.service.ts`)
- KPI generation and summaries → Cobot record: looks up cobot (evidence: `src/kpi/kpis.service.ts`)
- User management → Relational database: reads and writes (evidence: `src/users/users.service.ts`)
- Cobot management → Relational database: reads and writes (evidence: `src/cobots/cobots.service.ts`)
- Trajectory management → Relational database: reads and writes (evidence: `src/trajectories/trajectories.service.ts`)
- KPI generation and summaries → Relational database: reads and writes (evidence: `src/kpi/kpis.service.ts`)
