Merge pull request #19 from rtmelsov/rtmelsov-patch-6

Update README.md

Author: rtmelsov

README.md

@@ -1,79 +1,86 @@
 # ADV Keeper (CLI/TUI)
 
-Лёгкий офлайн-клиент для загрузки и скачивания файлов через gRPC с удобным TUI-интерфейсом на Bubble Tea.  
+Лёгкий клиент/сервер для загрузки и скачивания файлов по gRPC с TUI-интерфейсом на Bubble Tea.  
 **Ничего ставить не нужно, кроме `make` и вашей ОС.**
 
+> **Просьба:** для корректного отображения интерфейса **всегда разворачивайте терминал на полный экран** (fullscreen).
+>
+> **Мышь:** пока **не поддерживается** — работаю над этим. Используйте клавиатуру (см. ниже).
+
+---
+
 ## Быстрый старт
 
-```bash
-# 1) Запуск сервера
-make server   # или make run-server / make run — смотрите цели в Makefile
-```
 # 2) В другом терминале — запуск TUI-клиента
-make tui      # или make run-tui / make client — по Makefile
-Если в вашем Makefile другие имена целей — используйте их. Смысл простой: одна цель стартует сервер, другая — клиент.
-
-Учётная запись (демо)
+make tui      # (или make run-tui — см. Makefile)
 Войти можно тестовым аккаунтом:
 
 makefile
 Copy code
-Логин:    admin
-Пароль:   admin
+Логин:  admin
+Пароль: admin
 Как пользоваться
 Загрузка файла (Upload)
-В главном меню выберите Upload (стрелки ↑/↓, Enter).
-
-Выберите файл через встроенный файловый диалог.
-
-Во время загрузки увидите:
+В главном меню выберите Upload (↑/↓ и Enter).
 
-прогресс-бар, проценты,
+Укажите файл во встроенном файловом диалоге.
 
-скорость передачи и ETA,
+Во время загрузки видно прогресс-бар, скорость и ETA; ESC — отмена.
 
-подсказку ESC — отмена.
-
-По завершении вернёт в список файлов (FileList).
+После завершения вы вернётесь к списку файлов (FileList).
 
 Скачивание файла (Download)
 Откройте FileList.
 
-Стрелками выберите нужный файл, Enter → Download.
+Выберите файл, Enter → Download.
 
-Прогресс отображается так же, как при upload.
+Прогресс отображается так же, как при загрузке.
 
-Готовый файл сохраняется рядом с приложением (в текущей папке, где запущен клиент/бинарь).
+Файл сохраняется рядом с приложением (в текущей директории запуска клиента).
 
-Если не уверены, где окажется файл — посмотрите текущую директорию (pwd на macOS/Linux или cd без аргументов в Windows).
+Где окажется файл: это текущая папка процесса (pwd на macOS/Linux или просто cd в Windows).
 
-Клавиши
-↑ / ↓ / j / k — навигация по меню/таблицам
+Управление (клавиатура)
+↑ / ↓ / j / k — навигация
 
-Enter — выбрать
+Enter — выбрать/подтвердить
 
 ESC — назад/отмена/снять фокус
 
 Ctrl+C — выход
 
-Во время загрузки/скачивания:
+Во время upload/download: ESC — отменить операцию
 
-ESC — отменить операцию
+Мышь временно не работает — поддержка в разработке.
 
-Что внутри (коротко)
-gRPC сервер и TUI-клиент.
+Сборка под платформы
+Цели Makefile для сборки бинарей:
 
-Передача файлов чанками, с расчётом прогресса/скорости/ETA.
+make
+Copy code
+linux-amd64:    build-linux_amd64
+linux-arm64:    build-linux_arm64
+windows-amd64:  build-windows_amd64
+darwin-arm64:   build-darwin_arm64
+Примеры:
 
-Сессия сохраняется и очищается при Logout.
+bash
+Copy code
+make linux-amd64     # Linux x86_64
+make linux-arm64     # Linux ARM64
+make windows-amd64   # Windows x86_64
+make darwin-arm64    # macOS Apple Silicon
+(Имена файлов артефактов и папка вывода смотрите в Makefile.)
 
 Демо-видео
-В качестве примера можно взять видео с Дуэйном Джонсоном (The Rock):
+В качестве тестового файла можно взять видео с Дуэйном Джонсоном (The Rock):
 https://www.youtube.com/watch?v=skeQ9C7JuG4
 
 Траблшутинг
-“Висит загрузка” — убедитесь, что сервер запущен до старта клиента.
+“Загрузка/скачивание висит” — убедитесь, что сервер запущен до клиента.
+
+“Не логинится” — проверьте демо-учётку admin/admin.
 
-“Не логинится” — проверьте демо-логин/пароль admin/admin.
+“Не вижу скачанный файл” — проверьте текущую директорию клиента; файл сохраняется рядом с бинарём.
 
-“Не вижу скачанного файла” — проверьте текущую директорию клиента; файл сохраняется рядом с бинарём.
+“TUI едет/обрезается” — разверните терминал на полный экран.