Update README.md

Author: rtmelsov

README.md

@@ -1,87 +1,59 @@
-# ADV Keeper (CLI/TUI)
+# Adv Keeper TUI
 
-Лёгкий клиент/сервер для загрузки и скачивания файлов по gRPC с TUI-интерфейсом на Bubble Tea.  
-**Ничего ставить не нужно, кроме `make` и вашей ОС.**
+Минимальные требования: **OS + make**. Ничего больше ставить не нужно.
 
-> **Просьба:** для корректного отображения интерфейса **всегда разворачивайте терминал на полный экран** (fullscreen).
->
-> **Мышь:** пока **не поддерживается** — работаю над этим. Используйте клавиатуру (см. ниже).
+> Просьба: **разворачивайте терминал на весь экран** — так интерфейс выглядит корректнее.
 
----
+## Сборка (Make)
 
-## Быстрый старт
+```bash
+# основные таргеты
+make linux-amd64     # → build-linux_amd64
+make linux-arm64     # → build-linux_arm64
+make windows-amd64   # → build-windows_amd64
+make darwin-arm64    # → build-darwin_arm64 (Apple Silicon)
+```
+Запуск
 
-# 2) В другом терминале — запуск TUI-клиента
-make tui      # (или make run-tui — см. Makefile)
-Войти можно тестовым аккаунтом:
+Сделайте бинарник исполняемым и запустите из текущей директории:
 
-makefile
-Copy code
-Логин:  admin
-Пароль: admin
-Как пользоваться
-Загрузка файла (Upload)
-В главном меню выберите Upload (↑/↓ и Enter).
-
-Укажите файл во встроенном файловом диалоге.
-
-Во время загрузки видно прогресс-бар, скорость и ETA; ESC — отмена.
-
-После завершения вы вернётесь к списку файлов (FileList).
-
-Скачивание файла (Download)
-Откройте FileList.
-
-Выберите файл, Enter → Download.
+chmod +x ./tui_darwin_arm64   # пример для macOS ARM
+./tui_darwin_arm64            # обратите внимание на ./ перед именем файла
 
-Прогресс отображается так же, как при загрузке.
 
-Файл сохраняется рядом с приложением (в текущей директории запуска клиента).
+Если в zsh видите command not found: tui_darwin_arm64, добавьте ./ и/или выполните chmod +x.
 
-Где окажется файл: это текущая папка процесса (pwd на macOS/Linux или просто cd в Windows).
+Логин по умолчанию
+admin / admin
 
-Управление (клавиатура)
-↑ / ↓ / j / k — навигация
-
-Enter — выбрать/подтвердить
-
-ESC — назад/отмена/снять фокус
-
-Ctrl+C — выход
-
-Во время upload/download: ESC — отменить операцию
-
-Мышь временно не работает — поддержка в разработке.
+Как пользоваться
 
-Сборка под платформы
-Цели Makefile для сборки бинарей:
+Запустите программу.
 
-make
-Copy code
-linux-amd64:    build-linux_amd64
-linux-arm64:    build-linux_arm64
-windows-amd64:  build-windows_amd64
-darwin-arm64:   build-darwin_arm64
-Примеры:
+Загрузите файл.
 
-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.)
+Скачайте его — файл сохранится рядом с бинарником (в той же папке, где лежит софт).
 
-Демо-видео
-[![Смотреть демо](https://img.youtube.com/vi/skeQ9C7JuG4/hqdefault.jpg)](https://youtu.be/cjn5upkgUdY "Открыть видео")
+Для демонстрации на сервере уже есть пример (видео с Дуэйном Джонсоном).
 
+Мышь: пока не поддерживается, работаем над этим. Управление — клавиатурой (стрелки, Enter, Esc).
 
-Траблшутинг
-“Загрузка/скачивание висит” — убедитесь, что сервер запущен до клиента.
+## 🎬 Видео-туториал
+▶️ [Смотреть туториал](https://youtu.be/cjn5upkgUdY)
 
-“Не логинится” — проверьте демо-учётку admin/admin.
+## Почему часть фич не успел(а)
 
-“Не вижу скачанный файл” — проверьте текущую директорию клиента; файл сохраняется рядом с бинарём.
+Параллельно с основной работой и настройкой инфраструктуры/деплоя времени на функционал не хватило. Цель была — довести «сквозной путь» (регистрация → вход → загрузка/список/удаление файла) и показать рабочую демо-сборку. Остальное добью в скоро.
 
-“TUI едет/обрезается” — разверните терминал на полный экран.
+### Что планирую добавить дальше
+- TLS для gRPC (и опция mTLS).
+- Refresh-токены и автообновление доступа.
+- Роли/RBAC и базовые политики доступа.
+- Докачка (resume) при обрывах, контроль размера и checksums.
+- Лимиты/квоты и rate-limit на API.
+- Метрики/трейсинг (Prometheus + OpenTelemetry).
+- Более надёжные миграции (включая rollback).
+- Полировка TUI (стабильная работа в Windows-терминале, прогресс-бар, улучшенная навигация).
+- Публичный домен и «чистая» внешняя точка входа.
 
+Сроки намеренно не обещаю — доделаю по мере силы и времени. Если важно ускорить конкретный пункт, дайте знать — приоритизирую.