Перейти к содержанию

Рекомендуемые сообщения

Опубликовано

Хочу поделиться проектом, которым я занимаюсь в свободное время: mndw.
 

⚠️ --------------------------------------------------------------------------------- ⚠️
При работе над проектом я активно использую ИИ-инструменты.
Если для вас такой подход неприемлем, пожалуйста, не читайте эту тему.
 
⚠️ --------------------------------------------------------------------------------- ⚠️



Общее описание

mndw — это модульный веб-интерфейс для наших устройств, расширяемый за счет плагинов. Он работает в Entware.

image.png

image.png

mndw состоит из двух основных частей: фронтенд (хост-приложение) и бэкенд (mndwd).

Хост-приложение написано на Svelte 5. Оно предоставляет:
- общий лэйаут, расширяемый новыми "страницами" интерфейса
- настраиваемый дашборд с плитками, которые можно перетаскивать (набор плиток также расширяем)
- страницу "Entware" (установка, обновление и удаление opkg-пакетов, управление сервисами)
- страницу с настройками (управление mndwd, установка и удаление плагинов)

mndwd — это демон, работающий в окружении Entware. Его задачи:
- выступать в роли HTTP-сервера для хост-приложения и плагинов
- проксировать запросы к API роутера (/rci, /auth, /ci)
- хранить состояние плагинов, проверять их манифесты при загрузке
- запускаеть и контролировать бэкенд-процессы плагинов
- собирать системные события через хук-скрипты
 

Плагины

Плагин — это небольшое JS-приложение с манифестом и опциональным бэкендом. Плагин реализует либо карточку для дашборда, либо отдельную страницу. Хост-приложение предоставляет плагину контекст — объект, через который можно:
- обращаться к API роутера (rci/)
- общаться со своим бэкендом по HTTP или WebSocket
- работать с локализацией, телеметрией mndwd, и пр.

Сторонний плагин загружается zip-архивом через веб-интерфейс. Для плагина с бэкендом при загрузке будут видны
эндпоинты бэкенда и дополнительные разрешения, которые плагину могут потребоваться.

mndw содержит небольшой набор встроенных плагинов, иллюстрирующий различные возможности пакета.

Карточки на дашборде

Спойлер



MWS — плагин-страница, несколько расширяющий соответствующую страницу основного веб-интерфейса:
- реализовано графическое отображение узлов MWS и подключений между ними
- реализовано управление tx-power на экстендерах (требует настроенной постоянной сессии связи mndwd с контроллером)

Спойлер


 

Разработка плагинов

Для авторов плагинов доступен набор npm-пакетов:
- @mndw/sdk — типы, контракт манифеста, токены дизайна, клиент к хосту;
- @mndw/ui — UI-кит на веб-компонентах (таблицы, графики, формы) с обёртками для Svelte, Vue и Angular;
- @mndw/cli — создание проекта из шаблона, локальный запуск с проксированием на роутер (mndw dev), валидация, сборка и упаковка.

Более подробная документация доступна тут: https://eralde.github.io/mndw/

Работу над своим собственным плагином можно начать вот так:

Спойлер



 


Установка mndw

opkg update && \
  opkg install wget-ssl ca-bundle && \
  wget -qO- https://eralde.github.io/mndw-opkg-feed/add_repo.sh | sh

После установки mndw будет доступен по адресу <IP_роутера>:1189. Если порт 1189 занят, скрипт запуска подберет и выведет другой. Используйте те же логин и пароль, которые вы используете для входа в основной веб-интерфейс, чтобы войти в веб-интерфейс mndw.

Ссылки
Репозиторий проекта: https://github.com/Eralde/mndw
Документация: https://eralde.github.io/mndw/



Благодарности

Хочу сказать спасибо 🙂
- @dimon27254, @PriSonerS61 и @KYTECHNGAMING за помощь в тестировании ранних версий mndw
- @vasek00 за идею с графическим отображением узлов MWS
- @Di1r1
 за идею со сбором данных о температуре CPU (из неё получилась система "телеметрии" в mndw, которая ещё дорабатывается)

 

 

Присоединяйтесь к обсуждению

Вы можете написать сейчас и зарегистрироваться позже. Если у вас есть аккаунт, авторизуйтесь, чтобы опубликовать от имени своего аккаунта.
Примечание: Ваш пост будет проверен модератором, прежде чем станет видимым.

Гость
Ответить в этой теме...

×   Вставлено с форматированием.   Вставить как обычный текст

  Разрешено использовать не более 75 эмодзи.

×   Ваша ссылка была автоматически встроена.   Отображать как обычную ссылку

×   Ваш предыдущий контент был восстановлен.   Очистить редактор

×   Вы не можете вставлять изображения напрямую. Загружайте или вставляйте изображения по ссылке.

  • Последние посетители   0 пользователей онлайн

    • Ни одного зарегистрированного пользователя не просматривает данную страницу
×
×
  • Создать...

Важная информация

На этом сайте используются файлы cookie. Нажимая "Я принимаю" или продолжая просмотр сайта, вы разрешаете их использование: Политика конфиденциальности.