add prehook for commit, move "docs" files

docs/server.md

@@ -0,0 +1,50 @@
+# Server
+
+TODO:
+- описать формально все API
+- добавить сами команды, возможно сделать их в виде пресетов для платформы
+
+## Основная суть
+
+- API ручки. Доступ чисто по ssl (но это уже зона ответственности nginx)
+- клиенты по своему некоторому ключу будут авторизовываться.
+  - проблема ручной настройки (но она тут будто минимальная, не так плохо)
+- когда клиент что-либо присылает, в ответ ему надо кинуть команды на исполнение, если есть
+- со стороны клиента должен быть настроен trust к серверу
+
+Для сервера необходимо несколько настроек
+
+- лимит на кол-во запросов (от одного клиента, условно)
+- лимит на хранение инфо (и хранить ли старое? да, логи)
+  - лимит на одного юзера
+  - общий лимит
+- кастомные команды
+- отслеживание получения/выполнение команды сервером, повторные попытки, лимит попыток
+
+## Возможности (API ручки)
+
+'Понятия не имею, как описывать эти ручки (точнее, нет желания правильно их описывать)'
+
+### Ручки для админа
+
+Все пользователи будут считаться админами для удобства. Остальных нет
+
+1. получить список всех клиентов
+  - с отдельным параметром "только активированные"
+2. получить данные по клиенту
+  - сюда включается вся инфа о его показателях, когда был в сети + какие команды на него доступны (да, будем их ограничивать, возможно по модели zero-trust)
+3. выполнить какую-то команду
+  - тут вопрос в том, будем ли мы ждать ответа от нашего клиента (вряд ли)
+4. получить токен, авторизация
+5. добавить кастомную команду (для клиента)
+  - проблема в системах, если хочется универсального добавления. Выход - добавлять только для одного клиента (лучше во всём будет)
+
+### Ручки для клиентов
+
+Не уверен даже, что больше одной нужно будет
+
+1. Прислать информацию
+  - просто стучится со своим uuid и кидает, что знает
+2. Инфо о сервере?
+  - возможно фетчить айпи (чтобы стучаться, если сертификат на месте), другие домены
+  - какие-то особые "правила", если пакет с их установкой потеряется (сам то пакет вряд ли потеряется, мы об этом узнаем сразу)