diff --git a/docs/app-map/calendar.md b/docs/app-map/calendar.md new file mode 100644 index 0000000..5ac709b --- /dev/null +++ b/docs/app-map/calendar.md @@ -0,0 +1,159 @@ +# Карта: Календарь + +Приложение «Календарь» (`/apps/calendar/`) на forbion.f7cloud.ru. Структура кнопок/меню снята +**из кода** (метод mail/078): апстрим `nextcloud/calendar` **v6.4.0** (`src/**/*.vue` — точная +версия с forbion, канон README) + мобильная тема forbion +(`design-reference/forbion-theme/css/pages/pages-mobile/_mobile-calendar.css`, +`css/pages/app-calendar/`). Живой мобильный web (Browser 1, `cloude`, mail/079) — только для +визуальной сверки «как выглядит/порядок»; **строго read-only** (mail/073): ничего не +создаётся/не меняется/не удаляется, приглашения не отправляются, free/busy-запросы не шлются. +Приватность: реальные названия/участники событий не фиксируются — только структура UI. + +> Статус визуальной сверки на живом forbion: **ожидает** — для выбора конкретной Chrome-сессии +> (`Browser 1 c9284989`) нужен шаг владельца (в сессии видно 2 браузера, инструмент требует +> выбор владельцем). Дерево ниже построено из кода и валидно; отметки `визуал(?)` = требуют +> финального взгляда на экран (в первую очередь — порядок пунктов и мобильная модель месяца). + +> **F7-форк**: окно события на forbion кастомизировано (тема адресует `.f7-calendar-event-view`, +> `.f7-invitee-status-row`, `.f7-location-talk-row`, `.property-add-talk`) — набор кнопок тот же, +> что в апстрим-компонентах `Editor/*`, отличается вёрстка/порядок (предмет попиксельной сверки). + +## Компоненты-источники (nextcloud/calendar v6.4.0) +`views/Calendar.vue` (шелл: навигация + сетка) · `components/CalendarGrid.vue` (сетка) · +`AppNavigation/AppNavigationHeader.vue` (шапка: навигация периодов, «Создать», переключатель +вида) · `AppNavigation/CalendarList/*` (список календарей, действия, корзина) · +`AppNavigation/EditCalendarModal.vue` + `EditCalendarModal/ShareItem.vue` (правка/шаринг +календаря) · `AppNavigation/Settings.vue` (настройки) · `views/EditSimple.vue`/`EditFull.vue` +(окно события) · `Editor/Properties/*` (поля) · `Editor/Repeat/*` (повторение) · +`Editor/Alarm/*` (напоминания) · `Editor/Invitees/*` + `InvitationResponseButtons.vue` +(участники/ответы) · `Editor/Attachments/*` (вложения) · `Editor/AddTalkModal.vue` (беседа +Talk) · `Editor/FreeBusy/*` (занятость). + +## Вход +Нижняя плавающая панель / шторка приложений (по «трём полоскам») → «Календарь», или прямой URL +`/apps/calendar/`. Оболочку описывает `shell.md` (зона лида) — здесь только специфика приложения. + +## Экран: Календарь (главный, сетка) +**Шапка (`AppNavigationHeader`):** +- «**‹**» (Предыдущий период) → сдвиг диапазона назад. +- «**Сегодня**» → текущая дата. +- «**›**» (Следующий период) → сдвиг вперёд. +- Заголовок периода (месяц/неделя/…) → выпадающий выбор даты (date-picker). +- «**Переключатель вида**» → меню: «День», «Неделя», «Месяц», «Год», «Список». + - `расхождение:` в нативе есть только День/Неделя/Месяц; «Год» и «Список» отсутствуют. +- «**+ Создать событие**» → окно события (см. «Экран: Событие»); write — на forbion не сохраняю. + +**Тело:** сетка календаря. На мобильном (узкий вьюпорт) модель компактная — месяц сверху + +список событий выбранного дня снизу `визуал(?)` (сверить порядок/скролл на экране). + +**Действия в теле:** +- Тап по ячейке дня → выбор дня (список событий этого дня внизу). +- Тап по пилюле события → открыть событие (просмотр/редактор). + +## Экран: Навигация календарей (сайдбар / бургер) +**Тело:** список «**Мои календари**», ниже — «Корзина» и «Настройки». + +**Строка календаря:** +- Чекбокс видимости → включить/выключить показ календаря. +- Название + счётчик. +- «**⋯**» (действия) → меню: + - «**Изменить**» / «**Изменить и поделиться**» → модалка правки календаря (ниже). write. + - «**Копировать публичную ссылку**» / «**Копировать ссылку подписки**». + - «**Экспорт**» → скачивание `.ics`. + - «**Удалить**» → подтверждение. write. + +**Действия списка:** +- «**+ Добавить новый**» → меню: + - «**Новый календарь**» / «**Новый календарь со списком задач**». write. + - «**Новая подписка по ссылке (только чтение)**». write. + - «**Добавить календарь праздников**» / «**Добавить произвольный публичный календарь**». write. + +### Подэкран: Корзина +**Тело:** список удалённых календарей/событий. +**Действия:** «**Восстановить**» (write) · «**Удалить навсегда**» (write) · +«**Очистить корзину**» → подтверждение «Действительно очистить корзину?» (write). + +### Подэкран: Изменить календарь (модалка `EditCalendarModal`) +**Тело/действия:** +- «**Имя календаря**» + выбор цвета. write. +- «**Поделиться календарём**» → поиск «Share with users or groups» → строка получателя: + право «может редактировать и видеть конфиденциальные события», снять доступ. write. +- «**Напоминания по умолчанию**» для полнодневных/частичных событий этого календаря. +- «**Не показывать меня занятым**» (сделать календарь прозрачным). +- «**Экспорт**» · «**Удалить**» (write) · «**Убрать у меня**» (для расшаренных, write). + +### Подэкран: Настройки (`Settings.vue`) +**Тело (тумблеры/пункты):** «Номера недель», «Выходные», «Задачи в календаре», «Плотность в +День/Неделя», «Лимит событий в Месяце», «Простой редактор событий» («"Подробнее" открывает +детальный редактор»), «Календарь дней рождения», «Напоминание по умолчанию» (полнодневные/ +частичные), «Календарь по умолчанию для входящих приглашений», «Настройки доступности» (write), +«Импорт календарей» (write). +- Блок «**CalDAV**»: «CalDAV URL», «Адрес сервера для iOS и macOS» — информационные (копирование). + +## Экран: Событие (окно, `EditSimple`/`EditFull`, форк `.f7-calendar-event-view`) +Открытие: пилюля события или «Создать событие». Переключение простой↔полный: «**Подробнее**». + +**Шапка:** +- «**×**» (Закрыть) → при несохранённых правках диалог «Отменить изменения?» + («Точно отменить изменения этого события?»). +- «**✓ Сохранить**» (write). У повторяющегося события → выбор «Обновить это повторение» / + «Обновить это и все будущие» (write). +- «**⋯**» (действия) → меню: «Дублировать» (write), «Экспорт», «Удалить» (write); + у серии — «Удалить это повторение» / «Удалить это и все будущие». + +**Тело — поля (`Editor/Properties`):** +- «**Заголовок**» события. write. +- «**Весь день**» (тумблер). +- «**С**» / «**По**» — нативные пикеры даты/времени (в нативе совпадает). +- Выбор «**Календаря**» (коллекции). +- «Местоположение», «Описание», «Категории». +- Выбор «**Цвета**» / «Убрать цвет». + +**Тело — Повторение (`Editor/Repeat`):** +- «**Повтор**» («Не повторяется») → меню пресетов + «**Настроить повторение**»: + - «Повторять каждые» N + частота (день/неделя/месяц/год). + - Неделя: кружки дней недели (Пн…Вс). + - Месяц: «В конкретный день» / «В N-й» (первый… / будний / выходной / день). + - «Окончание»: «никогда» / «на дату» / «после» N «повторений». + - Предупреждение о неполной поддержке rrule (часть повторений может быть потеряна при правке). + - `расхождение (бэклог, mail/072):` натив НЕ разворачивает оккуренции в сетке (долг №2) и не + поддерживает EXDATE/RECURRENCE-ID (долг №3); `toRrule` не сериализует «первый понедельник» + (`BYDAY=1MO`). + +**Тело — Напоминания (`Editor/Alarm`):** +- «**Добавить напоминание**» (write) → тип (Уведомление/Email/Аудио), смещение + («за … минут/часов/дней/недель до») или «На дату»; «Удалить напоминание». + +**Тело — Участники / приглашения (`Editor/Invitees`, форк `.f7-invitee-status-row`):** +- «**Участники**» («Пока нет участников») → поиск «эл. почты, пользователи, контакты, группы, + команды». write. +- Роль участника: «Обязательный»/«Необязательный»/«Председатель»/«Не участвует»; «Запросить + ответ»; «Удалить участника». +- «**Найти время**» → сетка занятости (ниже). +- Настройка ответов: «Только приглашённые могут отвечать» / «Любой с приглашением может + отвечать», «Разрешить пересылку». +- «**Кнопки ответа на приглашение**» (входящее событие, `InvitationResponseButtons`): + «**Принять**» / «**Отклонить**» / «**Под вопросом**». write (iTIP REPLY). + - `расхождение (бэклог, mail/072, долг №4):` экрана accept/decline входящих приглашений в + нативе нет. + +**Тело — Беседа Talk (`AddTalkModal`, форк `.property-add-talk`):** +- «**Добавить беседу Talk**» → модалка: выбрать существующую беседу или создать + публичную/приватную. write при создании. + +**Тело — Вложения (`Editor/Attachments`):** +- «**Из файлов**» → навигация по WebDAV (добавить файл / поделиться ссылкой). +- «**Загрузить с устройства**» (write). +- Пункт вложения → «Удалить файл» (write); пусто — «Нет вложений». + +**Тело — Занятость (`Editor/FreeBusy`):** +- «**Проверить доступность / Найти время**» → сетка Free/Busy: «Свободен»/«Занят»/«Занят + (под вопросом)»/«Нет на месте», навигация «Пред./След. дата», легенда. + write (POST в DAV outbox — на forbion НЕ выполняю), `визуал(?)`. + +## Расхождения натив ↔ forbion (сводный бэклог, приоритет по mail/072) +1. Повторения не разворачиваются в сетке (долг №2, подтверждён лидом) — «Событие: Повторение» / сетка. +2. EXDATE / RECURRENCE-ID не поддержаны (долг №3) — «Событие: шапка / Повторение». +3. Входящие приглашения без «Принять/Отклонить» (долг №4) — «Событие: Участники». +4. Виды «Год» / «Список» отсутствуют в нативе — «Календарь: шапка». +5. `toRrule` не сериализует `BYDAY=1MO` («первый понедельник») — вскроется на развёртке повторений.