Guruh (Ring Group)

Guruh — bu bir nechta foydalanuvchini bitta modul ostida birlashtiruvchi modul. Guruh raqamiga qo'ng'iroq kelganda, guruhga kiruvchi barcha foydalanuvchilar bir vaqtda (yoki tartib bilan) chalinadi. Kim birinchi javob bersa, qo'ng'iroq o'sha foydalanuvchiga ulanadi.

Misol: Savdo bo'limi uchun 5200 raqam, ushbu guruhga 101, 102, 103 foydalanuvchilar kiradi.

Modul diapazoni

Guruh raqamlari 5200 dan 5399 gacha bo'lishi mumkin.

Asosiy tushunchalar

Atama	Izoh
Foydalanuvchilar (users)	Guruhga kiritilgan foydalanuvchilar ro'yxati (vergul bilan ajratilgan modullar)
Kechikish (delay)	Guruh chalinish vaqti (soniya). Shu vaqt ichida hech kim javob bermasa, output ga o'tiladi
Standart chiqish (output)	Javob berilmaganda yo'naltiriladigan modul raqami

users maydoni formati

users maydoni foydalanuvchi modullarini vergul bilan ajratilgan matn sifatida yuboriladi:

"101,102,103"

---

API

Ogohlantirish

Barcha endpointlar Bearer token talab qiladi. Batafsil: Auth

Ro'yxat olish

Endpoint

GET /ats/group

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi
result	array of GroupResource	Guruhlar ro'yxati
message	string	Xabar

Example

{
  "status": "success",
  "code": 200,
  "result": [
    {
      "id": 5200,
      "title": "Savdo bo'limi",
      "users": "101,102,103",
      "delay": 30,
      "output": 5000
    }
  ],
  "message": "Ok"
}

---

Yaratish

Endpoint

POST /ats/group

Request

Field	Type	Required	Description
id	integer	Yes	Guruh raqami (5200–5399, unikal)
title	string|null	No	Guruh nomi (max 255 belgi)
users	string|null	No	Foydalanuvchilar (vergul bilan, max 4095 belgi)
delay	integer|null	No	Chalinish vaqti (soniya, min: 1)
output	integer|null	No	Javob yo'q bo'lganda yo'naltirish moduli

Example

{
  "id": 5200,
  "title": "Savdo bo'limi",
  "users": "101,102,103",
  "delay": 30,
  "output": 5000
}

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi
result	GroupResource	Yaratilgan guruh
message	string	Group created successfully.

---

Yangilash

Endpoint

PUT /ats/group/{id}

Request

Store bilan bir xil maydonlar.

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi
result	GroupResource	Yangilangan guruh

---

O'chirish

Endpoint

DELETE /ats/group/{id}

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi
result	array	Bo'sh array
message	string	Group deleted successfully.