agentik-android/design/PRINCIPLES.md

Принципы Android-клиента

Коротко: принципы те же, что у десктопного клиента. Меняется не смысл, а обёртка — телефон всегда узкий, у него своя кнопка «Назад», нет курсора и есть клавиатура со шторками. Ниже: что берём как есть, что своё.

Обговорённые принципы лежат в репозитории десктопного клиента (он — эталон требований и макетов):

• https://git.binom.pw/subochev/agentik-desktop — файл REQUIREMENTS.md (требования R1…, разделы «Общее», «Раскладка и адаптивность», «Список диалогов» и далее), плюс approved/README.md (что одобрено и почему), THEMES.md (тема и имена цветов), STORAGE.md, CACHE.md. Ссылки даны на main; для точного среза — коммит 2c5b3f9.

Мы не копируем эти документы себе: один источник правды лучше двух копий, которые разъедутся. Здесь только список того, что для телефона иначе.

---

ЧАСТЬ 1. Берём как есть

1. Состав экрана. Что видно в любой момент: список диалогов и открытый диалог с полем ввода. Больше обязательного нет (R2).
2. Список диалогов. Лента папок («Все чаты», группы, «＋»), поиск, список со значком, названием, последней строкой, временем, кружком непрочитанных.
3. Группы. «Все чаты» — встроенная: не удаляется и не переименовывается. Удаление группы диалоги не удаляет — они возвращаются в «Все чаты». У группы только название.
4. Ассистенты. Имя придумывает человек (сервер своего имени не сообщает), адрес целиком вместе с путём /agentik, отличие в списке — цветом или картинкой, что-то одно. Картинка копируется внутрь клиента, не берётся по исходному адресу.
5. Проверка связи. Отдельным экраном поверх: идёт → отвечает → не отвечает, внизу «Проверить снова»; добавление доступно только при успехе. Запросы — из исходников агента, оба ничего не меняют.
6. Цвета. Берём из схемы по смыслу, не числом в коде (R1.1). Имена по смыслу, а не по виду: «фон», «панель», «акцент», «ошибка», «успех» (R1.2). Цвета различения ассистентов — не из схемы: они пользовательские и в другой теме остаются собой (R1.5).
7. «Нет данных — нет цифры». Не показываем счётчик, которого нет в источниках.
8. Сообщения — единственный источник правды. События от агента — только «будильник»; после сигнала догоняем сообщения запросом «что после такого-то».

ЧАСТЬ 2. На телефоне иначе

9. Узких и широких окон нет. Десктопные R3–R6 (две панели рядом, порог ширины, кнопка «Назад» внутри узкого окна) к нам не относятся: телефон всегда узкий. Вместо них — системная кнопка и жест «Назад» (предсказуемый переход), и он же закрывает открытый диалог.
10. Модальные окна → шторки снизу. Где на десктопе два окна друг над другом (настройки + проверка связи) — на телефоне полноэкранный экран или шторка снизу. Одно действие — один экран.
11. Курсора нет — нет «наведения». Вместо него отклик на нажатие (подсветка/рябь). Десктопное требование про цвета наведения (R1.4) на телефоне превращается в проверку цвета нажатия.
12. Клавиатура. Поле ввода поднимается над клавиатурой, список сообщений сдвигается, а не перекрывается. Открытая клавиатура — обычное состояние, а не край.
13. Запись голоса — с разрешением. На десктопе микрофон доступен без спроса, на телефоне нужно системное разрешение; отказ — состояние экрана, а не ошибка.
14. Файлы. Картинки ассистентов и вложения — во внутреннем каталоге приложения (на телефоне свои правила доступа к файлам). Пользователь выбирает файл системным диалогом.
15. Экран и поворот. Края экрана (строка состояния, «подбородок» с жестами) учитываем; при повороте и смене размера ничего не теряется.
16. Тёмная тема — стартовая, не единственная. Как и на десктопе, схем несколько (R1.1).

ЧАСТЬ 3. Что решаем позже

• Порог, с которого телефон считать «широким» (планшет, разворот) — пока не нужен: рисуем узкий вид.
• Системная цветовая схема телефона: следовать за ней или держать свою.

---

Кода в этих документах нет намеренно — здесь поведение. Реализация — по задачам, через правки в этом репозитории.