11 KiB
Одобренные макеты
Здесь только принятое. Это не «вариант для сравнения» и не черновик — это
решение, на которое опираемся в реализации. Правило простое: одобренный макет
живёт здесь, а не остаётся «выбранным» среди вариантов в sketches/.
| Файл | Что это | Одобрено |
|---|---|---|
001-sidebar-utility.html |
Основа дизайна: привычный мессенджер | 2026-09-18 |
004-settings-agents.html |
Настройки агентов: список, форма, проверка связи | 2026-09-19 |
005-new-chat-picker.html |
Модалка «Новый диалог»: выбор ассистента | 2026-09-19 |
006-groups-manage/ |
Управление группами — 4 файла по состояниям | 2026-09-19 |
sketches/ — предложения: 002-rail-voice-first, 003-three-pane-command,
004-settings-agents, 005-new-chat-picker (черновики, из них выросли одобренные).
001-sidebar-utility.html — основа дизайна
Это база всего клиента. Привычный мессенджер: список диалогов слева (320 px), чат справа. Узкое окно — как в Телеграме: на экране что-то одно, у открытого диалога сверху кнопка «Назад».
Что в нём есть:
- лента папок — «Все чаты / Работа / Дом / +», со счётчиком непрочитанных;
- поиск диалога;
- список диалогов: значок, название, последняя строка, время, кружок непрочитанных;
- шапка чата со значком, именем и состоянием связи;
- сообщения: пользователь справа, ассистент слева;
- поле ввода с кнопкой отправки и круглой кнопкой записи голоса.
Из него убрано при одобрении:
- подсказка под полем ввода;
- кольцо токенов — в библиотеке
clientтаких данных нет, а «нет данных — нет цифры».
Стиль: фон #121218, панели #17212B, акцент #6AB2F2, текст #EBEBEB.
005-new-chat-picker.html — Новый диалог
Модалка появляется по «+» (новый диалог), когда ассистентов больше одного. Состоит из одного окна 480 px и больше ничего: заголовок «Новый диалог», подсказка-вопрос, список ассистентов, две кнопки внизу.
Что в карточке ассистента:
- значок — цвет или картинка (как настроено в настройках агентов);
- имя;
- адрес сервера;
- состояние связи: «на связи» зелёным, «не отвечает» красным;
- кружок отметки справа.
Поведение:
- первый отмечен сразу — создать диалог можно одним нажатием;
- выбран ассистент без связи → под списком появляется предупреждение, но выбор не запрещается (связь может пропасть на секунду);
- окно маленькое и без вкладок: одно действие — один выбор.
Когда этой модалки не должно быть:
- ассистент один — диалог создаётся сразу в нём, спрашивать не о чем;
- ассистентов ноль — кнопки «+» нет вообще (создавать диалог не в ком), вместо списка диалогов подсказка «добавьте ассистента в настройках».
Отвергнуто при одобрении: пояснительная панель над окном клиента — она попала в макет случайно, это была заметка для проверки, а не часть интерфейса. В одобренном файле её нет и быть не должно.
004-settings-agents.html — Настройки агентов
Два окна друг над другом. Первое — настройки (620 px): список агентов и форма нового. Второе, поверх — проверка связи (480 px).
Окно 1, список агентов. У каждого: знак (цвет или картинка), имя, адрес, состояние — «на связи» зелёным, «не отвечает» красным, «не проверялся» серым. Кнопки в строке: проверить связь (⇄), изменить (✎), удалить (🗑). Внизу пунктирная «+ Добавить агента».
Окно 1, форма нового — три поля:
- Название. Пояснение: имя придумывает пользователь, сервер своего имени не сообщает (это из исходников, не догадка).
- Адрес сервера — целиком, вместе с путём
/agentik. Прямо в строке адреса кнопка «Проверить связь». - Как отличать в списке — вкладки Цвет / Картинка, выбирается что-то одно. Цвет — из пяти. Картинка — файл с диска, круглый превью, «Выбрать файл…» и «Убрать». ⚠️ Картинка копируется внутрь клиента, не берётся по исходному адресу.
Окно 2, проверка связи — отдельное окно поверх настроек, три состояния в одном окне: идёт (крутится кольцо) → отвечает (зелёная галочка, подробности: ответ, адрес, число диалогов, отклик) → не отвечает (красный крестик, подсказка что проверить). Внизу всегда «Проверить снова». Кнопка «Добавить агента» доступна только при успехе. Работает и для добавленных агентов — кнопкой «⇄».
Почему проверка отдельным окном: места больше, основную форму не дёргает, одно окно годится и для новой формы, и для уже добавленного агента.
Честно о непроверенном: живого агента на момент макета не поднято — на порту
8080 отвечал чужой сервер. Адреса запросов взяты из исходников (GET /agentik/health
и список диалогов, оба ничего не меняют), но замеры времени и число диалогов
в макете условные. На настоящем агенте проверка ещё не гонялась.
006-groups-manage/ — Управление группами
Четыре файла, по одному состоянию в каждом. Интерактивности нет намеренно: вместо неё отдельный файл на каждое состояние.
| Файл | Что показывает |
|---|---|
1-list.html |
список групп: «изменить» и «удалить» у каждой, внизу «+ Добавить группу» |
2-add.html |
новая группа: только название |
3-edit.html |
изменение: переименование, удаление отдельным блоком «ОПАСНОЕ» |
4-delete.html |
подтверждение: диалоги не удаляются, вернутся в «Все чаты» |
Как открывается: кнопкой-карандашом (✎) в ленте групп над списком диалогов — справа, отдельно от чипов. Прежний «+» на этом месте убран: рядом стоят чипы самих групп, и всё похожее на «+» читается как «добавить группу», хотя диалог создаётся кнопкой в шапке списка.
Решения внутри:
- «Все чаты» — встроенная группа, не удаляется и не переименовывается (пунктирная рамка, пометка «встроенная»). Нужна как надёжное место, где виден весь список.
- Удаление группы диалоги не удаляет — в подтверждении это сказано первым делом. Диалоги останутся и будут видны в «Все чаты», «корзины» у них нет.
- У группы только название. Цвет, значок, порядок — не делаем, пока не попросили.
- Пустая группа допустима — можно создать заранее, диалоги разложить потом.
- Подсказка при создании: диалоги в группу попадают позже, из самого диалога.
Про цвета в макетах
Цвета в макетах стоят числами — так и надо, иначе макет не будет выглядеть
задуманным. В коде так нельзя: цвет берётся из цветовой схемы по смыслу,
потому что тем будет несколько. Разбор — THEMES.md.
Как смотреть
Открыть файл в браузере — самодостаточный, без сборки и без зависимостей.
- в
001переключается узкий/широкий вид и видны состояния сообщений; - в
004переключаются список/форма, вкладки Цвет/Картинка; кнопкой «⇄» или «Проверить связь» открывается окно проверки (оба состояния — успех и отказ); - в
005кликом по карточке меняется выбор и появляется предупреждение; 006— четыре файла, открывать по одному, по состоянию.