https://github.com/andaran/appex-system
Система удаленного управления с открытым исходным кодом для самодельных проектов.
https://github.com/andaran/appex-system
arduino esp8266 home-automation http iot js mongodb nodejs raspberry-pi remote-control smart-home websockets
Last synced: 2 days ago
JSON representation
Система удаленного управления с открытым исходным кодом для самодельных проектов.
- Host: GitHub
- URL: https://github.com/andaran/appex-system
- Owner: andaran
- License: gpl-3.0
- Created: 2020-11-11T16:29:18.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2022-05-09T14:20:03.000Z (almost 3 years ago)
- Last Synced: 2023-09-15T11:37:21.738Z (over 1 year ago)
- Topics: arduino, esp8266, home-automation, http, iot, js, mongodb, nodejs, raspberry-pi, remote-control, smart-home, websockets
- Language: JavaScript
- Homepage: https://www.appex-system.ru
- Size: 92.2 MB
- Stars: 13
- Watchers: 2
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Appex system
## Описание:
Система удаленного управления с открытым исходным кодом для самодельных проектов.
Для каждого устройства в системе создается приложение на html/css/js.
Для упрощения процесса разработки имеется встроенный шаблонизатор с готовыми
модулями.
Взаимодействие устройств происходит по протоколу wss. Приложение и все устройства, относящиеся к этому
приложению помещаются в одну комнату. В этой комнате находится объект состояния, в котором указаны все
необходимые данные о работе устройства. Про работу с ним можно почитать в документации.
https://www.appex-system.ru/doc#class-app, https://www.appex-system.ru/doc#C-plus-plus-code
Плюсы и особенности:
1. Работает быстрее за счёт использования протокола wss по сравнению
c многими другими сервисами.
2. Доступно 600 запросов на сервер в минуту - можно управлять роботами.
3. Любые устройства из разных групп могут взаимодействовать между собой, имеется удобное api для этого.
4. Кроме ws api есть также http api для привязывания умных устройств к другим сервисам, например голосовым
ассистентам.
5. Можно удобно делиться своими приложениями и давать другим людям доступ к некоторым компонентам
своего умного дома.
6. Интерфейс для приложений делается самостоятельно. Это сложнее, но не приходится ограничиваться
готовыми блоками, хотя они тоже есть. Также имеется возможность добавлять иконки fontawesome,
делать любые запросы в интернет.
7. Можно подключать не только esp8266, но и малину, компьютер, и т.д. Главное, чтобы выход в интернет был.
## Локальная установка:
!!! Перед локальной установкой следует установить nodejs, npm, mongodb.
1. Клонируем репозиторий. `git clone https://github.com/andaran/appex-system`
2. Скачиваем необходимые пакеты. `npm i`
3. Создаем конфиг окружения. Прописываем туда пароли для сессий, базу данных, порт, настройки для smtp почты. `nano .env`
```
# .env
# application
sessionSecretKey1=**********
sessionSecretKey2=**********
database=mongodb://127.0.0.1/appex
port=3001
# smtp mailer
[email protected]
mailPass=**********
mailPort=465
mailHost=smtp.yandex.ru
```
4. Собираем приложение. `npm run build`
5. Запускаем! `node appex`