xlx/README.md

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.