fixes

fedora/calendar-mail-popup-notes.md

@@ -0,0 +1,191 @@
+# Calendar + Mail Popup Notes
+
+Заметка по идее компактного календарно-почтового инструмента для Fedora + Niri +
+Waybar.
+
+## Цель
+
+Нужны две связанные поверхности:
+
+1. Понятное решение в `waybar`, откуда можно быстро открыть календарь и увидеть
+   нужную информацию.
+2. Отдельное компактное `tool-window` / popup-окно с календарем и мини-почтой.
+
+Это не должен быть полноценный тяжелый PIM-комбайн на первом этапе. Основной
+приоритет — быстрый обзор и быстрые действия.
+
+## Что нужно уметь
+
+### В Waybar
+
+- Кликнуть по модулю.
+- Увидеть календарную информацию без переключения в большой клиент.
+- Быстро понять:
+  - что сегодня;
+  - что дальше по неделе;
+  - есть ли ближайшие события;
+  - есть ли непрочитанная почта.
+
+### В popup/tool-window
+
+- Посмотреть календарь на неделю и месяц.
+- Увидеть список ближайших событий.
+- Создать событие.
+- Иметь мини-почту как обзор, а не как полноценный mail client.
+
+## Ограничения текущего Waybar
+
+Встроенный `clock` модуль Waybar умеет:
+
+- показывать месяц/год;
+- переключать режимы;
+- листать календарь;
+- запускать команды по клику.
+
+Но встроенный календарь Waybar — только display layer:
+
+- он не показывает реальные CalDAV / Nextcloud / Google события;
+- он не умеет создавать события;
+- он не является полноценным event-aware календарем.
+
+Следствие: Waybar должен быть entry point, а не местом, где живет вся
+календарная логика.
+
+## Вывод по архитектуре
+
+Нужна связка из двух частей:
+
+1. `waybar` как обзор и кнопка входа;
+2. отдельное маленькое приложение/окно как рабочая поверхность.
+
+Рекомендованный подход:
+
+- hover в `waybar` показывает компактный календарный overview;
+- click открывает собственный popup/tool-window;
+- popup уже работает с реальными данными календаря и почты.
+
+## Предлагаемый UX
+
+### 1. Waybar popover / overview
+
+Минимальный состав:
+
+- верх: дата, `Today`, кнопка `+ Event`;
+- слева: мини-месяц;
+- справа или снизу: блок `Today / Tomorrow / This Week`;
+- отдельный короткий блок `Unread mail`.
+
+Роль этого слоя:
+
+- быстрое чтение;
+- быстрый переход;
+- минимум действий;
+- без тяжелой навигации.
+
+### 2. Tool-window / popup
+
+Форма окна:
+
+- не полноценное большое desktop app окно;
+- не полноразмерный почтовый клиент;
+- компактное floating window, открываемое по клику из `waybar`.
+
+Предпочтительная компоновка:
+
+- левая колонка: мини-месяц + список календарей;
+- центральная зона: week view или month-agenda;
+- правая колонка: `Upcoming`, `Reminders`, `Unread mail`.
+
+Верхняя строка:
+
+- `Today`
+- `New event`
+- `Search`
+- переключение `Week / Month`
+
+## Мини-почта: что это значит
+
+Почта в этом окне должна быть не отдельным MUA, а summary layer:
+
+- unread messages;
+- flagged / important;
+- письма за сегодня;
+- клик по письму открывает внешний клиент.
+
+Нежелательно на первом этапе:
+
+- полноценный composing;
+- threading;
+- archive/reply прямо в popup;
+- попытка заменить Thunderbird или другой почтовик.
+
+Идея: calendar-first окно с mail summary, а не равноправный split mail/calendar
+комбайн.
+
+## Референсы по форме и UX
+
+### Основной референс по форме
+
+`Fantastical Mini Window`
+
+- маленькое окно поверх рабочего контекста;
+- быстрый обзор событий;
+- быстрый add/search;
+- ощущается как utility window, а не как полноразмерное приложение.
+
+Ссылка:
+
+- https://flexibits.com/blog/2022/04/mini-window-big-productivity-getting-the-most-from-fantastical-for-macs-mini-window/
+
+### Референс по базовым календарным экранам
+
+`GNOME Calendar`
+
+- чистый month/week view;
+- отдельный event editor;
+- понятная структура desktop calendar без перегруза.
+
+Ссылка:
+
+- https://apps.gnome.org/Calendar/
+
+### Референс по плотной рабочей компоновке
+
+`Notion Calendar`
+
+- маленький месяц + основной agenda/week layout;
+- показывает, как совместить overview и рабочую область.
+
+Ссылка:
+
+- https://habr.com/ru/news/787144/
+
+### Референс по идее mail+calendar продукта
+
+`Thunderbird`
+
+- полезен не как popup reference, а как пример того, что почтовый summary и
+  календарь могут жить рядом;
+- для нашего UX слишком тяжел как direct reference.
+
+Ссылка:
+
+- https://www.thunderbird.net/en-US/
+
+## Практический вывод
+
+Лучшее направление для реализации:
+
+- брать `Fantastical Mini Window` как референс формы;
+- брать `GNOME Calendar` как референс календарных экранов;
+- делать calendar-first popup;
+- оставлять почту в формате короткого summary.
+
+## Следующий логический шаг
+
+Перед реализацией нужно решить:
+
+1. popup должен быть очень маленьким overview-окном или уже почти полноценным
+   mini-organizer;
+2. mini-mail нужен только для чтения summary или уже с действиями вроде
+   `mark read`, `archive`, `open`.