From 24cfaecf79c2072580743ae9cf6afd1b29ebb06a Mon Sep 17 00:00:00 2001
From: Dmitrii Krosh <gudovdo@my.msu.ru>
Date: Wed, 6 May 2026 17:01:42 +0300
Subject: [PATCH] edit readme.md

---
 README.md | 18 ++++++------------
 client.md | 22 ++++++++++++++++++++++
 2 files changed, 28 insertions(+), 12 deletions(-)

diff --git a/README.md b/README.md
index d050249..8885c2a 100644
--- a/README.md
+++ b/README.md
@@ -1,27 +1,21 @@
 # nexus-sync
 
-a utility that allows you to manage access to your computers.
+a utility that allows you to manage your computers.
 
 ## Planned features
 
-- ask for ipv6 of machine
-- enable forward proxy via Server
-- clipboard manage
-- power managment
-- **top**-statistic
-- virt disk mounting (?)
 
 ## Server-side
 
-- works in docker container
-- accept connections on _some_ port
+- (to future) works in docker container
+- accept connections on _some_ port with correct uuid from client
 - works via API requests
 - use _some_ database
 
 ## Client-side
 
 - with _some_ period of time, send info to the server
-- if server need some data
+- if server want client to execute some command
   - decrease fetch time period
-  - send this data
-  - or execute smth
+  - execute command
+  - send result back to the server
diff --git a/client.md b/client.md
index 5450608..1500821 100644
--- a/client.md
+++ b/client.md
@@ -7,3 +7,25 @@
 Запросы на сервер будет кидать с некоторой частотой, постепенно возрастающей, но резко снижающейся при получении команды в ответе (вдруг надо ещё что-то выполнить)
 
 Есть установление нижнего предела на частоту (условная 1/минута)
+
+Пример работы
+
+```
+...
+client -> server: hello!, i'm $(hostname), uuid= , ts=
+server -> client: ok, 200
+*waits 45s*
+client -> server: hello!, i'm $(hostname), uuid= , ts=
+server -> client: ok, 200
+*waits 46s*
+client -> server: hello!, i'm $(hostname), uuid= , ts=
+server -> client: ok, execute "ip a", 200
+client: *execute*
+client -> server: hello!, i'm $(hostname), uuid= , ts=, stdout= , stderr= , ...
+*waits 23s*
+```
+
+Возможно нужна доп инфа о работе команды (код ошибки как минимум)
+
++ возможно на клиенте стоит ограничить набор допустимых команд
++ стоит явно задуматься о шифровании/идентификации сервера