f7cloud_mobile/docs/app-map/mail.md

Карта: Почта

Снята по мобильной веб-версии forbion.f7cloud.ru (вьюпорт ~400px, плавающая нижняя панель — мобильная тема), аккаунт cloude / почтовый ящик cloude@forbion.ru, строго read-only (mail/073). Живой UI — полный Nextcloud Mail 5.7.15.

Источники узлов: [live] — пройдено в браузере; [src] — достроено по читаемому исходнику design-reference/forbion-apps/f7mail/src (форк f7mail) + nextcloud/mail 5.7.15, т.к. узел требует записи и live не проходился; [mockup] — сверено с design/screens/mail/*.png.

⚠️ Ограничение read-only для Почты. В NC Mail пометкой \Seen является само открытие непрочитанного письма — это запись на сервер. У cloude все 3 письма во «Входящих» — непрочитанные, «Отправленные»/«Черновики» пусты, прочитанных писем нет. Поэтому экран открытого письма live не проходился; его дерево дано по [src]/[mockup] и помечено не-пройдено-live: \Seen. Composer открывался пустым и закрывался без ввода (черновик не создавался). Ни одно пишущее действие (отправка/удаление/спам/перемещение/пометки) не нажималось.

---

Вход

Нижняя плавающая панель оболочки → иконка «конверт» (раздел «Почта», активна) → открывается Список писем текущей папки (по умолчанию «Приоритетные входящие», /apps/mail/box/priority). Оболочку панели/шторки описывает shell.md (зона лида).

---

Экран: Список писем (папка) [live]

URL: /apps/mail/box/<id> (напр. priority, 517=Входящие).

Шапка:

• Поле «Искать в папке» → фокус строки поиска в текущей папке.
• Иконка-слайдеры (справа в поле) → открывает модалку «Параметры поиска» (расширенный поиск).
• Круглая зелёная «+» → открывает Композер (сворачивается в плашку «Сообщение без названия»).

Тело: вертикальный список карточек-писем. Пустая папка → центр-заглушка «В этой папке нет сообщений» + логотип F7 [live] (наблюдалось в «Отправленных»).

Карточка письма (строка):

• Аватар/инициалы отправителя (цветной кружок).
• Имя отправителя (жирным) + строка-превью темы/начала письма.
• Справа: относительное время («1:00», «вс») + зелёная точка = непрочитано.
• Тап по карточке → Экран открытого письма/треда (/box/<id>/thread/<tid>). ⚠️ помечает \Seen — live не нажималось.

Быстрые действия строки (появляются при наведении/выборе) [live]:

• ✉ конверт → пометить прочитанным/непрочитанным (запись).
• 🌿 лист → важное/снять важность (запись).
• 🗑 корзина → удалить ветку (запись).
• ⋯ → контекстное меню (ниже).

Контекстное меню письма (⋯ «Больше действий») [live]

Верхний ряд иконок: В избранное (звезда) · Прочитать (конверт) · Снять важность (лист). Далее пункты:

• 🕐 <дата и время письма> (инфо-строка, напр. «13 июля 2026 г., 1:00»).
• ⓘ Пометить как спам (запись).
• 🏷 Изменить метки → диалог выбора/назначения меток (запись при сохранении).
• ⏰ Запланированная отправка (в native — открывает composer-ответ с выбором времени).
• Переместить ветку → выбор папки назначения (запись).
• 🗑 Удалить ветку (запись).
• ⋯ Больше действий → подменю:
  • Редактировать как новое сообщение → Композер с телом письма.
  • Ответить встречей → создание события-приглашения (CalDAV).
  • Создать задачу → создание задачи из письма (Tasks).
  • Скачать письмо → выгрузка .eml.

---

Экран: Параметры поиска (расширенный поиск) [live]

Открывается иконкой-слайдерами в поле поиска. Модалка «Параметры поиска», крестик ✕ (закрыть). Поля:

• Тема (строка).
• Тело — «Найти» (строка).
• Дата: «Дата начала» и «Дата окончания» — два пикера даты (иконка календаря).
• От — «Выберите отправителей» (мультиселект).
• Кому — «Выберите получателей».
• Коп — получатели CC.
• СкрКоп — получатели BCC.
• Метки — «Выбор меток».
• Отмечено как (чекбоксы): Важное · В избранное · Непрочитанное · Имеет вложения · Упоминания меня.

Низ: «Очистить» (сброс) · «Поиск» (зелёная).

---

Экран: Композер (новое сообщение) [live]

Открытие: «+» в шапке списка. Сначала свёрнутая плашка снизу «Сообщение без названия» с иконками ⤢ (развернуть) и ✕ (закрыть/отменить). Развёрнутый вид — полноэкранная форма:

Шапка: заголовок «Новое сообщение», под ним отправитель «cloude cloude@forbion.ru»; справа — («свернуть») и ✕ («закрыть»). Поля:

• Кому: с шевроном-раскрытием → раскрывает Копия: (Cc) и Ск: (Bcc).
• Тема сообщения.
• Текст (тело, шеврон сворачивания); в правом нижнем углу тела — 📎 скрепка (вложения). Низ-панель:
• ≡A → панель форматирования текста (rich-text: жирный/курсив/списки и т.п.) [src].
• ⋯ → меню: Умный подборщик · Текстовые шаблоны · Отправить позже · ☐ Запросить подтверждение прочтения.
• ▷ Отправить (зелёная, неактивна при пустых получателях) (запись — не нажималось).

расхождение: native-композер «⋯» содержит только «Отправить позже» + «Запросить подтверждение прочтения» (MailComposeScreen.kt:758,767) — нет «Умного подборщика» и «Текстовых шаблонов» (см. Расхождения п.2–3). Запланированная отправка, подтверждение прочтения, вложения, rich-text (≡A) — совпадают.

---

Экран: Открытое письмо / тред [src] [mockup] — не-пройдено-live: \Seen

URL: /apps/mail/box/<id>/thread/<tid>. Структура по MessageView.vue + макетам Почта _ Окно сообщения*.png, Сообщение с перепиской *.png:

Шапка: тема письма (заголовок h2). Для локального (черновик/исходящее) — метка статуса. Панель действий над письмом:

• Обычное письмо: Ответить · Переслать · В избранное (toggle) · Отметить непрочитанным (если \Seen) · Архивировать · В спам · В корзину · Удалить.
• Черновик/исходящее: Отправить (если можно) · Изменить черновик · Удалить. Мета-строки: Кому (to), Копия (cc), «Отправить в» (sendAt — для запланированных). Перемещение: выпадающий выбор папки + кнопка «Переместить». Вложения: список карточек вложений (если есть). Тело: HTML-письмо в WebView-контейнере, либо текстовое в Compose (в native). Тред: несколько писем переписки — сворачиваемые карточки (закрытые/открытое), см. Сообщение с перепиской закрытые.png / ... открытое.png. Плавающая кнопка «↩ Ответить» (native MailReplyFab) — сверено ранее, [mockup].

---

Навигация папок (шторка «Открыть навигацию») [live]

Кнопка-гамбургер почты → выезжает список папок ящика. Сверху: «Создать сообщение» и «Обновить». Далее:

• Приоритетные входящие (/box/priority).
• Аккаунт cloude@forbion.ru + кнопка «Действия» (⋯ по аккаунту).
• Входящие (/box/517) · Непрочитанное (/box/unread/517) · Избранные (/box/starred/517) · Черновики (/box/516) · Отправленные (/box/515) · Спам (/box/513) · Корзина (/box/514).
• У каждой папки — кнопка «Действия» (⋯: переименование/очистка/подписка и т.п. [src]).

---

Экран: Параметры эл. почты (настройки) [live] вход / [src] глубина

Точка входа: пункт «Параметры эл. почты» (в меню настроек шапки; JS-модалка, href="#"). Глубину подтверждает native MailSettingsScreens.kt + макеты Параметры электронной почты.png, Параметры учётной записи.png:

• Основные (общие параметры почты).
• Учётные записи (аккаунты; форма AccountForm.vue [src]).
• Внешний вид.
• Текстовые шаблоны / подписи.
• Конфиденциальность.
• Безопасность.
• Фильтры (sieve) — FiltersSettingsView.vue [src]; в native — общий официальный API /apps/mail/api/filter (список/вкл/выкл/удаление/правка простых; сложные — долг v1).

расхождение(?): live-модалку «Параметры эл. почты» не раскрывал по пунктам (JS-диалог) — при сверке на устройстве пройти каждый подраздел и сверить состав с native.

---

Пустые/особые состояния [live]

• Пустая папка: «В этой папке нет сообщений» + логотип F7 по центру.
• Свёрнутый композер: плашка «Сообщение без названия» (⤢ / ✕) поверх списка.

---

Расхождения с нативным feature/mail

Сверка карты (живой forbion) с кодом модуля на 91aaaba. Нативный клиент оказался функционально богат — расширенный поиск, подтверждение прочтения, важность/спам/метки/ создать задачу/создать событие/запланированная отправка уже есть и совпадают. Ниже — только то, где native отстаёт или отличается от живого web (это бэклог на добивку).

Функциональные (native отстаёт) — бэклог

1. Черновики не сохраняются [приоритет]. Live: папка «Черновики» + композер сохраняет/ восстанавливает черновик. Native: MailComposeViewModel не пишет и не восстанавливает черновик — набранное теряется. (Совпадает с долгом №1 представления mail/070; план п.2.)
2. Композер «⋯» → «Текстовые шаблоны» — вставки в тело нет. Live: пункт есть. Native: текстовые блоки только в настройках (MailRepository), в композере не вставляются (MailComposeScreen.kt меню «⋯» = только «Отправить позже» + «Запросить подтверждение прочтения»).
3. Композер «⋯» → «Умный подборщик» (NC smart picker) — в native отсутствует.
4. Меню письма → «Ответить встречей» — в native нет (есть смежное «Создать событие» MailComponents.kt:1254, но это не invite-reply).
5. Меню письма → «Скачать письмо» (.eml) — в native отсутствует.
6. Меню письма → «Редактировать как новое сообщение» — в native отсутствует.
7. Действие «Архивировать» над письмом — в native нет отдельного пункта (папка «Архив» и archiveMailboxId есть, но архивирование только через «Переместить сообщение» MailComponents.kt:1259).

Косметические / вёрстка (для попиксельной сверки)

8. Подписи виртуальных папок. Live: «Непрочитанное», «Избранные». Native: «Непрочитанные», «Избранное» (MailRepository.kt:672-673) — число/форма слова расходятся.
9. Порядок папок. Live: Приоритетные → Входящие → Непрочитанное → Избранные → Черновики → Отправленные → Спам → Корзина. Native: Входящие → Непрочитанные → Избранное → Отправленные → Черновики → Архив → Корзина → Спам (MailRepository.kt:671-680). Порядок отличается.
10. Быстрые действия строки списка. Live-web (даже в узком вьюпорте): inline-иконки при наведении (✉ прочитать / 🌿 важность / 🗑 удалить / ⋯). Native: свайп справа-налево (f7SwipeFromRightToDismiss). ⚠️ вероятно артефакт desktop-web на узком экране, а не мобильный паттерн — проверить на реальном мобильном web/устройстве прежде чем считать расхождением.

Открытые вопросы (добить при сверке на устройстве)

1. Экран открытого письма/треда — пройти live, когда будет прочитанное письмо или write-ОК на \Seen; там же сверить панель действий и расхождения (архив/скачать/редактировать-как-новое).
2. Модалка «Параметры эл. почты» — раскрыть каждый подраздел live (native — 6 разделов).
3. Действия «⋯» по папке и по аккаунту — раскрыть состав live.
4. Диалоги «Изменить метки», «Переместить», «Запланированная отправка» — раскрыть формы live.
5. Проверить п.10 (быстрые действия строки) на реальном мобильном — hover-иконки vs свайп.