Project

General

Profile

Edit History

Architecture » History » Version 1

Hardelele User, 02/18/2026 11:33 AM
Initial content — architecture overview

1 1 Hardelele User 
h1. Architecture
2 





    3
    
    
    
h2. Компоненты системы





    4
    
    
    





    5
    
    
    
Система делится на две основные части:





    6
    
    
    





    7
    
    
    
h3. Control Plane (серверная инфраструктура)





    8
    
    
    





    9
    
    
    
|_. Компонент |_. Технология |_. Описание |





    10
    
    
    
| API | NestJS (TypeScript) | REST + WebSocket сервер, бизнес-логика, управление агентами |





    11
    
    
    
| Web | Next.js (TypeScript) | Веб-интерфейс для пользователей, дашборд, терминал |





    12
    
    
    
| Database | PostgreSQL | Хранение данных: пользователи, агенты, сессии, логи |





    13
    
    
    





    14
    
    
    
h3. Agent (клиентская часть)





    15
    
    
    





    16
    
    
    
|_. Компонент |_. Технология |_. Описание |





    17
    
    
    
| Agent | Rust (.exe) | Запускается на Windows-машинах, подключается к API по WebSocket |





    18
    
    
    





    19
    
    
    
h2. Схема взаимодействия





    20
    
    
    





    21
    
    
    
<pre>





    22
    
    
    
  Browser                Next.js Web              NestJS API              Rust Agent





    23
    
    
    
    |                   (app.reckue.com)                |                     |





    24
    
    
    
    |  ---- HTTPS ---->      |                         |                     |





    25
    
    
    
    |  <--- HTML/JS ---      |                         |                     |





    26
    
    
    
    |                        |  ---- REST/WS ---->     |                     |





    27
    
    
    
    |                        |  <--- JSON --------     |                     |





    28
    
    
    
    |                        |                         |  <--- WebSocket --- |





    29
    
    
    
    |                        |                         |  ---- Commands ---> |





    30
    
    
    
    |                        |                         |                     |





    31
    
    
    
    |                        |                         |  ---- PostgreSQL    |





    32
    
    
    
    |                        |                         |       (72.56.119.162)





    33
    
    
    
</pre>





    34
    
    
    





    35
    
    
    
* *Browser* <-> *Next.js Web* (@app.reckue.com@) — HTTPS, отрисовка интерфейса





    36
    
    
    
* *Next.js Web* <-> *NestJS API* — REST (данные) + WebSocket (реалтайм)





    37
    
    
    
* *NestJS API* <-> *Rust Agent* — WebSocket (управление сессиями, команды, вывод)





    38
    
    
    
* *NestJS API* <-> *PostgreSQL* — ORM (TypeORM/Prisma), хранение данных





    39
    
    
    





    40
    
    
    
h2. Серверы





    41
    
    
    





    42
    
    
    
|_. IP |_. Роль |_. Домен |_. ОС |





    43
    
    
    
| @176.53.162.120@ | Git (Gitea) | "git.reckue.com":https://git.reckue.com | Ubuntu 24.04 |





    44
    
    
    
| @72.56.119.246@ | Deploy (API + Web) | "app.reckue.com":https://app.reckue.com | Ubuntu |





    45
    
    
    
| @72.56.119.162@ | PostgreSQL | — | Ubuntu |





    46
    
    
    





    47
    
    
    
h2. Стек технологий





    48
    
    
    





    49
    
    
    
|_. Слой |_. Технология |





    50
    
    
    
| Frontend | Next.js (React, TypeScript) |





    51
    
    
    
| Backend | NestJS (TypeScript) |





    52
    
    
    
| Agent | Rust |





    53
    
    
    
| Database | PostgreSQL |





    54
    
    
    
| Контейнеризация | Docker, Docker Compose |





    55
    
    
    
| Git-хостинг | Gitea |





    56
    
    
    
| CI/CD | Gitea Actions (планируется) |