From 8313b44b9db79b167751cae1df8714c233374bd2 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=D0=92=D0=B8=D0=BA=D1=82=D0=BE=D1=80?=
 <78488229+viktor138irk@users.noreply.github.com>
Date: Mon, 18 May 2026 05:53:12 +0900
Subject: [PATCH] =?UTF-8?q?=D0=A1=D0=BE=D0=B7=D0=B4=D0=B0=D0=BD=20=D1=81?=
 =?UTF-8?q?=D1=82=D0=B0=D1=80=D1=82=D0=BE=D0=B2=D1=8B=D0=B9=20README=20?=
 =?UTF-8?q?=D0=BF=D1=80=D0=BE=D0=B5=D0=BA=D1=82=D0=B0=20XLX?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..de7108c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,60 @@
+# XLX Server
+
+Собственный XLX/DMR-сервер для пользователей Pi-Star с платной регистрацией, автоматической выдачей ID, проверкой позывного по внешней базе и персональным доступом по логину/паролю.
+
+## Цель проекта
+
+Сделать управляемую платформу для DMR-пользователей:
+
+- регистрация пользователя по позывному;
+- автоматическая проверка позывного;
+- платная активация аккаунта;
+- автоматическая выдача внутреннего XLX/DMR ID;
+- генерация данных подключения для Pi-Star;
+- управление доступом к XLX-серверу;
+- админ-панель пользователей, оплат, ID, логов и подключений;
+- автообновление сервера и веб-панели.
+
+## Базовая архитектура
+
+Проект делится на несколько частей:
+
+1. **XLX Core** — установленный и управляемый XLX reflector.
+2. **Access Gateway** — слой контроля доступа пользователей, паролей и разрешённых подключений.
+3. **Web Panel** — личный кабинет и админка.
+4. **Billing** — платная регистрация и продление доступа.
+5. **Callsign Verifier** — проверка позывных по базе радиолюбителей.
+6. **ID Allocator** — автоматическая выдача уникального ID.
+7. **Installer/Updater** — установка, обновления, бэкапы и восстановление.
+
+## Статус
+
+v0.1.0 — проектирование и стартовый каркас.
+
+## Предполагаемый стек
+
+- Ubuntu 22.04/24.04 LTS;
+- XLX reflector;
+- PHP 8.3 или Python/FastAPI для панели/API;
+- MariaDB/MySQL;
+- Nginx;
+- systemd services;
+- YooKassa/ЮMoney/ручное подтверждение оплаты на первом этапе;
+- автоустановщик shell + миграции БД.
+
+## Pi-Star сценарий
+
+Пользователь после оплаты получает:
+
+- адрес сервера;
+- порт;
+- логин/позывной;
+- пароль;
+- назначенный ID;
+- инструкцию подключения Pi-Star.
+
+## Версионирование
+
+- малые фиксы: `+0.0.1`;
+- заметные функции: `+0.1.0`;
+- архитектурные изменения: `+1.0.0`.