f7cloud_mobile/docs/app-map/talk.md

Карта: Конференции (Talk)

Приложение «Конференции» (/apps/spreed/) на forbion.f7cloud.ru. Структура кнопок/меню/переходов снята из кода (метод mail/078): апстрим nextcloud/spreed v22.0.12 (src/**/*.vue — точная версия с forbion, совпадает с серверным форком f7_talk 22.0.12-f7.N) + мобильная тема forbion (design-reference/forbion-theme/css/pages/pages-mobile/_mobile-spreed.css, 4495 строк; css/pages/app-spreed/). Натив-эталон для сверки — мой vendor/talk-android v23 + feature/talk. Живой мобильный web (Browser 1, cloude, mail/079) — только визуальная сверка «как выглядит/порядок»; строго read-only (mail/073): ничего не создаётся/не меняется/не удаляется, звонки не инициируются (mail/073 п.4). Приватность: реальные имена собеседников/содержимое чатов не фиксируются — только структура UI и дерево переходов.

Статус визуальной сверки на живом forbion: левый сайдбар (список обсуждений) пройден 2026-07-13 (Browser 1, cloude, same-origin iframe 390px, read-only — ни одной пишущей операции). Реальные русские подписи forbion внесены (сверено:). Экран беседы/чата live НЕ проходился намеренно: открытие комнаты выставляет read-marker на сервере (запись, аналог \Seen у почты — см. mail.md) → узлы «Беседа», «Звонок», «Детали беседы», меню сообщения достроены из кода апстрима, помечены не-пройдено-live.

Компоненты-источники (nextcloud/spreed v22.0.12)

Левый сайдбар (список): LeftSidebar/LeftSidebar.vue (+ ConversationsList/, SearchConversationsResults/, OpenConversationsList/, InvitationHandler.vue, CallPhoneDialog/). Создание: NewConversationDialog/ (NewConversationDialog.vue, NewConversationContactsPage.vue, NewConversationSetupPage.vue). Топбар беседы/звонка: TopBar/TopBar.vue (+ CallButton.vue, CallTime.vue, TopBarMenu.vue, TopBarMediaControls.vue, ReactionMenu.vue, TasksCounter.vue). Чат: ChatView.vue, MessagesList/ (+ MessagesGroup/Message/…/MessageButtonsBar.vue — меню сообщения). Композер: NewMessage/. Звонок: CallView/, MediaSettings/. Правый сайдбар (детали): RightSidebar/RightSidebar.vue (+ Participants/, SharedItems/, Threads/, SearchMessages/, BreakoutRooms/, LobbyStatus.vue, SipSettings.vue). Настройки беседы: ConversationSettings/ConversationSettingsDialog.vue. Личные настройки: SettingsDialog/SettingsDialog.vue. Пусто-состояние: EmptyView.vue.

Вход

Нижняя плавающая панель оболочки → «Конференции», либо шторка приложений («три полоски»), либо прямой URL /apps/spreed/. Оболочку (нижняя панель, шторка, бургер) описывает shell.md (зона лида) — здесь только специфика приложения. На мобильном (узкий вьюпорт ~390px) тема (_mobile-spreed.css) показывает сначала левый сайдбар на весь экран (список обсуждений); выбор беседы разворачивает беседу на весь экран, правый сайдбар (детали) и модалки — тоже height:100%, «назад» возвращает к списку.

Экран: Список обсуждений (левый сайдбар — LeftSidebar)

Лендинг приложения на мобильном. Шапка:

• Поле «Поиск …» (Search) → фильтрация списка + поиск людей/открытых обсуждений (SearchConversationsResults, OpenConversationsList).
• Иконка-фильтр (ползунки, Filter conversations by) → меню фильтров: «Непрочитанные» (Unread), «Упоминания» (Mentions), «Встречи» (Meetings/Meeting conversations), «Очистить фильтр» (Clear filter/Clear filters). сверено: на forbion рядом с полем поиска.
• Зелёная кнопка «+» → меню создания (см. ниже). сверено: FAB зелёный, справа от поиска.
• (Над сайдбаром — общий NC-хедер оболочки: «Объединённый поиск», «Меню настроек», «Уведомления» — это shell.md, не Talk.)

Тело: список обсуждений (ConversationsList → Conversation). Каждая строка: аватар/иконка, имя, превью последнего сообщения, бейдж непрочитанных, индикатор звонка «Call in progress». сверено: на forbion у cloude видны «Личные заметки» (Note to self, создано системой), «Давайте начнём!» (группа, бейдж 7), «Обновления приложения "Конференции"» (бейдж 57).

Действия строки (свайп/⋯ — Conversation actions):

• «Отметить как прочитанное / непрочитанное» (Mark as read / unread).
• «Добавить в избранное / Убрать из избранного» (Add to / Remove from favorites).
• «Уведомления» (Notifications) → подменю: «Уведомлять о звонках» (Notify about calls), «@-упоминания» (@-mentions only), «Все сообщения» (All messages), «Выкл» (Off), «Игнорировать "Не беспокоить"» (Ignore "Do not disturb").
• «Настройки обсуждения» (Conversation settings) → диалог настроек беседы (см. ниже).
• «Скрыть текст сообщения» (Hide message text — приватность превью).
• «Архивировать / Разархивировать обсуждение» (Archive / Unarchive conversation).
• «Копировать ссылку» (Copy link).
• «Покинуть обсуждение» (Leave conversation) → подтверждение «Do you really want to leave…»; предупреждение «You need to promote a new moderator before you can leave».
• «Удалить обсуждение» (Delete conversation) → подтверждение «Do you really want to delete…».
• Метки: «Важное обсуждение» (Important), «Чувствительное обсуждение» (Sensitive conversation). (Все перечисленные — потенциально write; на live НЕ жму.)

Прочие пункты сайдбара (навигация/TopBarMenu списка): «Архивные обсуждения» (Archived conversations / «You have no archived conversations»), «Обсуждения-встречи» (Meeting conversations), «Треды» (Threads / «No followed threads» / «Show more threads»), «Ожидающие приглашения» (Pending invitations, InvitationHandler), «Настройки приложения» (App settings) → личные настройки (см. «Настройки Talk»).

Пусто-состояния: «Обсуждения не найдены» (No conversations found), «Нет совпадений» (No matches found), «У вас нет непрочитанных упоминаний/сообщений».

Экран: Меню «+» (создание) — NewConversationDialog + пункты

Открывается зелёной «+». Пункты (сверено: порядок с live forbion):

• «Начать встречу сейчас» (Start meeting now) → создаёт беседу и сразу входит в звонок. (write — не жму.)
• «Создать новое обсуждение» (Create a new conversation) → мастер создания (см. ниже).
• «Присоединиться к открытым обсуждениям» (Join open conversations) → список открытых (OpenConversationsList) → «Присоединиться к обсуждению» (Join conversation).
• «Проверить устройства» (Check devices) → MediaSettings (превью камеры/микрофона, выбор устройств, размытие фона) — read-only-превью, без входа в звонок.
• (Также доступно) «Позвонить на телефонный номер» (Call a phone number, CallPhoneDialog), «Новая личная заметка» (New personal note).

Подэкран: Мастер «Создать новое обсуждение» (NewConversationDialog)

Два шага:

1. Contacts page (NewConversationContactsPage): «Найти участников или телефонные номера» (Search participants or phone numbers), «Добавить участников» (Add participants), «Добавить телефонный номер» (Add a phone number).
2. Setup page (NewConversationSetupPage): поля «Имя» (Name / «Enter a name…»), «Описание» (Description), «Изображение» (Picture — аватар беседы); переключатели «Видимость обсуждения» (Conversation visibility), «Разрешить гостям вход по ссылке» (Allow guests to join via link → «Копировать ссылку»), «Защита паролем» (Password protection → «Ввести пароль»/«Копировать пароль»). Кнопки: «Назад», «Создать обсуждение» (Create conversation). (write — мастер открываю без сохранения / на live не прохожу.)

Экран: Беседа (чат) — ChatView + TopBar + NewMessage (не-пройдено-live)

Шапка беседы (TopBar):

• «Назад» (Back) → список обсуждений (мобильный).
• Имя беседы/аватар → «Настройки обсуждения» / «Детали» (правый сайдбар).
• «Начать звонок» / «Присоединиться к звонку» (Start call / Join call, CallButton; «Start call silently» — тихий старт). При обновлении сервера: «Nextcloud Talk was updated, you cannot start or join a call».
• «Ещё действия» (More actions, TopBarMenu): «Настройки обсуждения», «Действия обсуждения», «Проверить устройства», «Открыть чат» (Open chat), полноэкранный режим (Full screen / F). Тело: лента сообщений (MessagesList); «Нет сообщений» (No messages), «Все сообщения истекли или были удалены», «Это обсуждение только для чтения» (read-only conversation), «Прокрутить вниз» (Scroll to bottom), «Кто-то печатает…» (Someone is typing…). Композер (NewMessage):
• Поле «Отправить сообщение» (Post message / Send message); «Отправить» (Send).
• «Добавить эмодзи» (Add emoji).
• «Поделиться файлами в обсуждении» (Share files): «Поделиться из Файлов» (Share from Files), «Загрузить» (Add more files), «Создать и поделиться новым файлом» (Create and share a new file).
• «Умный подборщик» (Smart picker).
• «Создать опрос» (Create new poll, PollViewer).
• «Записать голосовое сообщение» (Record voice message → «Завершить и отправить»/«Отменить»).
• «Создать тред» (Create a thread / silently).
• Тихая отправка: «Отправить без уведомления» (Send without notification / Send message silently).
• Редактирование: «Изменить сообщение» (Edit message), «Отменить редактирование».

Меню сообщения (MessageButtonsBar) (не-пройдено-live)

Долгое нажатие/⋯ на сообщении:

• «Ответить» (Reply) / «Ответить лично» (Reply privately).
• «Добавить реакцию» (Add a reaction; «React with {emoji}», меню реакций).
• «Переслать сообщение» (Forward message / «в "Личные заметки"» — Note to self).
• «Копировать сообщение» / «Копировать ссылку на сообщение» (Copy message / message link).
• «Напоминание» (Set reminder): «Сегодня позже», «Завтра», «В выходные», «На следующей неделе», «Задать своё…»; «Очистить напоминание».
• «Отметить как непрочитанное» (Mark as unread).
• «Перейти к файлу» (Go to file) / «Перейти к треду» (Go to thread).
• «Изменить сообщение» (Edit message) / «Изменить детали треда».
• «Перевести» (Translate).
• «Скачать файл» (Download file).
• «Удалить» (Delete).

Экран: Активный звонок — CallView + TopBar/bottom-bar (не-пройдено-live, звонки запрещены)

Нижняя панель звонка (тема .bottom-bar-call-controls, .buttons-bar):

• «Микрофон вкл/выкл», «Видео вкл/выкл» (Disable video), «Размытие фона» (Disable background blur / Select virtual background).
• «Показать экран» (Show your screen / Enable screensharing / Screensharing options).
• «Отправить реакцию» (Send a reaction).
• «Поднять руку» (Raise/lower hand).
• «Добавить участников» (Add participants to this call).
• «Запись» (Start/Stop recording; «Starting the recording», согласие на запись).
• «Комнаты обсуждения» (Set up breakout rooms; «Back to main room»).
• «Полный экран» (Full screen / Exit full screen).
• «Покинуть звонок» (Leave call) / «Завершить звонок для всех» (End call for everyone).
• «Скачать список присутствия» (Download attendance list).

Экран: Детали беседы (правый сайдбар — RightSidebar) (частично не-пройдено-live)

Табы (RightSidebarContent):

• «Детали» (Details) — инфо о беседе, «Предстоящие встречи» (Upcoming meetings, CalendarEventsDialog).
• «Участники ({count})» (Participants) — список; действия участника (ParticipantItem): «Повысить/понизить модератора» (Promote/Demote moderator), «Изменить права» (Edit permissions: Grant all / Remove all / default), «Переместить в лобби» (Move back to lobby), «Переместить в обсуждение» (Move to conversation), «Удалить участника» (Remove participant), «Забанить» (Also ban…), телефонные (Dial out / Mute / Hold / Hang up / Copy phone number). Строка поиска «Добавить участников».
• «Чат» (Chat / Open chat) — на узком экране.
• «Общие ресурсы» (Shared items, SharedItems) — файлы/медиа/ссылки беседы.
• «Треды» (Threads in {name}).
• «Поиск сообщений» (Search messages / Search in {name}).
• «Комнаты обсуждения» (Breakout rooms), «Лобби» (LobbyStatus), «SIP» (SipSettings) — когда включены.

Экран: Настройки обсуждения (ConversationSettingsDialog) (write-разделы — не жму)

Секции (модалка на весь экран): «Основная информация» (Basic Info + ConversationAvatarEditor), «Обзор настройки» (Setup overview), «Личное» (Personal), «Модерация» (Moderation), «Права» (Permissions), «Встреча» (Meeting), «Комнаты обсуждения» (Breakout Rooms), «Живая транскрипция» (Live transcription), «Боты» (Bots), «Matterbridge», «Опасная зона» (Danger zone: «Архивировать обсуждение», удаление/покидание).

Контрактно важно: разделы «Боты» и «Живая транскрипция» завязаны на серверный форк f7_talk 22.0.12-f7.N (bot API /api/v1, транскрипция ячейки A) — предмет моей сверки, не вёрстки.

Экран: Настройки Talk (личные — SettingsDialog)

Открывается «Настройки приложения» (App settings) из сайдбара. Секции:

• «Внешний вид и звуки» (Appearance & Sounds): «Компактный список обсуждений» (Compact conversations list), «Звуки уведомлений чата и звонков», «Проигрывать звуки при входе/выходе».
• «Устройства» (Devices): «Проверить устройства» (Check devices), «Размывать фон камеры по умолчанию» (Blur camera background by default), «Пропускать предпросмотр устройства перед звонком» (Skip device preview), «Камера вкл/выкл», «Микрофон вкл/выкл».
• «Приватность» (Privacy): «Отправлять уведомления о прочтении» (Send read receipts), «Делиться статусом набора» (Share typing status).
• «Вложения» (Attachments): «Папка вложений» (Attachments folder → «Выбрать расположение»).
• «Уведомления» (Notification settings).
• «Горячие клавиши» (Shortcuts while in a call / in a chat) — не актуально на мобильном.

Расхождения / бэклог (натив feature/talk ↔ живой forbion)

Заполняется при функциональной сверке нативного клиента (задача №1 после карты). Кандидаты из беглого сопоставления кода feature/talk (Compose-UI на spreed OCS /api/v4) с апстримом v22:

• расхождение: проверить наличие в нативе: тредов (Threads), напоминаний по сообщению (Set reminder), опросов (Poll), умного подборщика (Smart picker), пересылки (Forward), комнат обсуждения (Breakout rooms), живой транскрипции.
• расхождение: состав меню создания «+» (в нативе — есть ли «Начать встречу сейчас» / «Присоединиться к открытым» / «Позвонить на номер»).
• расхождение: секции «Настройки обсуждения» (модерация/права/лобби/SIP) — покрытие в нативе.
• Звонок (натив = vendor/talk-android v23 CallActivity): сверить панель управления звонком (реакции, поднятая рука, запись, breakout, шаринг экрана) — отдельно от Compose-UI чата.
• EOL-баннер «server almost EOL» (порог мажора 26 у v23 против сервера 22) — гасим в vendor (решение лида, mail/071); зафиксировать в vendor/talk-android/README.F7CLOUD.md.

Открытые (?) (доберу при функциональной сверке на устройстве / доп. live-проходе без записи): точные подписи меню сообщения и действий участника на forbion; поведение фильтра списка; состав правого сайдбара на узком вьюпорте (какие табы прячет тема).