Документация СОНИКС Клиента¶
Клиент наземной станции для портала sonik.space.
Клиент опрашивает портал на предмет запланированных проходов спутников, во время
каждого прохода управляет SDR-приёмником, трансивером и поворотным устройством
через потоковые графы GNU Radio (gr-satnogs / gr-satellites), а затем
загружает на портал аудио, водопад и демодулированные кадры.
Поставляется Docker-образом, станции запускают его через docker compose.
Куда идти¶
- Я оператор станции — подключаю и настраиваю железо.
Начните с требований к системе, затем установка и конфигурация. Дальше — эксплуатация и полный справочник переменных окружения.
- Я разработчик — хочу дорабатывать клиент.
Начните с архитектуры — там жизненный цикл наблюдения целиком. Затем разделы по подсистемам: потоковый граф, скрипты и декодеры, загрузка данных, водопад. Проверка правки на живом железе — стенд. Правила участия — в contributing. Что известно сломанным и в каком порядке чинится — дорожная карта.
- Мне нужен справочник по коду.
Справочник API — автоматически сгенерирован из исходников.
- Я ИИ-агент.
Начинайте с Контекст экосистемы для ИИ-агента — устройство соседних проектов, контракты между ними и подтверждённые дефекты на их стороне. Затем Дорожная карта: надёжность сети — принятые решения и план работ по всей сети.
Станция
- Требования к системе
- Установка
- Конфигурация станции
- Переменные окружения
- STATION — параметры станции
- URL — адреса портала
- MQTT — живой канал с порталом
- API — таймауты HTTP
- ANTENNA — поворотное устройство и трансивер
- OBSERVATION — параметры наблюдения
- FLOWGRAPH — потоковый граф SDR
- WATERFALL — водопад
- LOG — логирование
- SCHEDULER — планировщик заданий
- SDR — обследование приёмника
- HEALTH — состояние станции
- AGENT — агент обновлений
- PATHS — размещение файлов
- JOBS
- Переменные уровня скриптов
- Поворотное устройство
- Эксплуатация
- Агент обновлений
- Поддерживаемые спутники
Разработка
- Архитектура
- Потоковый граф
- Скрипты и декодеры
- Загрузка данных
- Водопад
- Стенд
- Участие в разработке
- Дорожная карта: закрытие техдолга
- Дорожная карта: надёжность сети
- Где мы на 2026-09-10
- Зачем
- Состояние на входе
- Принятые решения
- Правило 21 на практике
- Целевая архитектура
- Фаза 0 — остановить кровотечение
- Фаза 1 — надёжность обмена
- Фаза 2 — агент и управление парком
- Фаза 3 — тракт приёма
- Фаза 4 — качество приёма
- Фаза 5 — монитор
- Новые контракты API
- Стенд
- Наследование от дорожной карты техдолга
- Разбор
origin/soniks-update(решение 19) - Сознательно отложено
- Верификация
- Открытые вопросы
- Контекст экосистемы для ИИ-агента
Справочник API
Проект¶
Исходники: gitlab.com/space-education-development/soniks/client/soniks-client
Определения спутников: soniks-satyaml
Портал: sonik.space, Telegram: @sonikspace
Лицензия: AGPL-3.0